@devries-cameron20 / composio Mirror · read-only / commits / bccce3f2d
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 03:37 UTC

fix(cli): automate the stable release changelog (#5495)

## Summary - Run the CLI changelog updater on protected `next` after a successful stable binary promotion. The SDK release App opens or refreshes one PR restricted to the package changelog. - Use the published stable tags to file shipped notes by version, leaving later notes under Unreleased. Backfill 0.6.0 through 0.6.3 and document the login polling timeout in 0.6.3. - Generate GitHub release notes from the prior stable tag and authenticate the Windows installation job's release metadata requests after runner IP rate limits failed beta verification. - Keep CLI release versioning in the binary workflow and keep `@composio/cli` excluded from SDK Changesets. ## Verification - Changelog tests and a replay against the published stable tags. - Changesets and agent guidance validators, actionlint, ShellCheck on the release scripts, and the new workflow's zizmor audit. - POSIX installer tests, all six published archive checksums, and a downloaded macOS ARM64 binary reporting 0.6.3. [CLI 0.6.3](https://github.com/ComposioHQ/composio/releases/tag/%40composio/cli%400.6.3) · [Stable release run](https://github.com/ComposioHQ/composio/actions/runs/44794063245)

Alberto Schiabel committed Nov 21, 2026 at 00:43 UTC bccce3f2d703113cdf76b676885bf75aea563281
11 files changed +368 -22
.agents/skills/cli-release/references/release-workflow.md
+8 -1
@@ -17,6 +17,7 @@
17 - `.github/scripts/cli-release/resolve-release-target.sh` decides the tag and source commit.
18 - `.github/scripts/cli-release/verify-assets.sh` defines the required asset set.
19 - `.github/workflows/cli.test-installation.yml` validates installers after publication.
20 +- `.github/workflows/cli.changelog.yml` opens a changelog PR as the SDK release App after a successful promotion.
21 - `.changeset/config.json` ignores `@composio/cli`.
22
23 `sdk.release.yml` owns stable and beta Python/TypeScript publication from `next`; `ts.release.yml` retains the 1.0 prerelease train on `main`. CLI binary releases use their own workflow.
@@ -40,7 +41,13 @@ Never create a `.changeset/*.md` entry for `@composio/cli` while it remains in `
41
42 An ignored-package changeset makes `changesets/action` enter version-PR mode, while `changeset version` emits no commit. The action then fails with `No commits between next and changeset-release/next` and blocks unrelated SDK publishing.
43
43 -If a CLI change needs a human-facing note, update `ts/packages/cli/CHANGELOG.md` directly. Run this guard before handoff:
44 +Add human-facing CLI notes as bullets under `## Unreleased` in
45 +`ts/packages/cli/CHANGELOG.md`. The changelog workflow compares the changelog
46 +snapshots at published stable tags and opens or updates a PR that moves shipped
47 +notes into version sections. If that PR was missed, dispatch
48 +`cli.changelog.yml` on `next` to regenerate it.
49 +
50 +Run this guard before handoff:
51
52 ```bash
53 pnpm validate:changesets
.github/scripts/cli-release/create-or-resume-draft.sh
+3
@@ -8,6 +8,7 @@
8 # assets are attached and verified. The release is only flipped to published by a later step.
9 #
10 # Inputs (env): RELEASE_TAG, RELEASE_NAME, CHECKOUT_REF, PRERELEASE, GH_TOKEN
11 +# PREVIOUS_STABLE_TAG (optional, for stable release notes)
12 # BINARIES_DIR (optional, defaults to the CLI dist dir)
13 set -euo pipefail
14
@@ -22,6 +23,8 @@ flags=(
23 # Preserve prerelease status on the draft so betas stay prereleases once published.
24 if [[ "$PRERELEASE" == "true" ]]; then
25 flags+=(--prerelease)
26 +elif [[ -n "${PREVIOUS_STABLE_TAG:-}" ]]; then
27 + flags+=(--notes-start-tag "$PREVIOUS_STABLE_TAG")
28 fi
29
30 # Idempotent for re-runs of a not-yet-published release: reuse an existing draft and clobber
.github/scripts/cli-release/resolve-release-target.sh
+2
@@ -173,4 +173,6 @@ if [[ "$target_commitish" != "$COMMIT_SHA" ]]; then
173 exit 1
174 fi
175
176 +previous_stable_tag=$(latest_stable_tag)
177 +echo "previous_stable_tag=$previous_stable_tag" >>"$GITHUB_OUTPUT"
178 emit_stable_target "$stable_tag" "$stable_version"
.github/scripts/cli-release/update-changelog.test.ts new
+84
@@ -0,0 +1,84 @@
1 +import { expect, test } from 'bun:test';
2 +import { rollChangelog } from './update-changelog';
3 +
4 +const header = '# @composio/cli\n\n## Unreleased\n';
5 +const history = '\n## 0.5.0\n\n- Earlier release.\n';
6 +const repository = 'ComposioHQ/composio';
7 +
8 +test('files each note under the stable release that shipped it', () => {
9 + const baseline = {
10 + tag: '@composio/cli@0.5.0',
11 + markdown: header + history,
12 + };
13 + const first = {
14 + tag: '@composio/cli@0.6.0',
15 + markdown: header + '\n### Minor Changes\n\n- A feature.\n With more detail.\n' + history,
16 + };
17 + const second = {
18 + tag: '@composio/cli@0.6.1',
19 + markdown: first.markdown.replace(
20 + '### Minor Changes',
21 + '### Patch Changes\n\n- A fix.\n\n### Minor Changes'
22 + ),
23 + };
24 + const current = second.markdown.replace(
25 + '### Patch Changes',
26 + '### Patch Changes\n\n- Pending fix.'
27 + );
28 + const updated = rollChangelog(current, [baseline, first, second], repository);
29 +
30 + expect(updated).toStartWith(header + '\n### Patch Changes\n\n- Pending fix.\n\n## 0.6.1\n');
31 + expect(updated).toContain('## 0.6.1\n\n### Patch Changes\n\n- A fix.\n');
32 + expect(updated).toContain('## 0.6.0\n\n### Minor Changes\n\n- A feature.\n With more detail.\n');
33 + expect(updated.match(/- A feature\./g)).toHaveLength(1);
34 + expect(updated).toEndWith(history);
35 + expect(rollChangelog(updated, [second], repository)).toBe(updated);
36 +});
37 +
38 +test('uses released notes even after the prior release was rolled on next', () => {
39 + const first = {
40 + tag: '@composio/cli@0.6.0',
41 + markdown: header + '\n- Previously shipped.\n' + history,
42 + };
43 + const current = header + '\n- Pending fix.\n\n## 0.6.0\n\n- Previously shipped.\n' + history;
44 + const second = {
45 + tag: '@composio/cli@0.6.1',
46 + // A release branch can carry a note that has not landed on next.
47 + markdown:
48 + header +
49 + '\n- A fix from the release branch.\n\n## 0.6.0\n\n- Previously shipped.\n' +
50 + history,
51 + };
52 + const updated = rollChangelog(current, [first, second], repository);
53 +
54 + expect(updated).toStartWith(
55 + header + '\n- Pending fix.\n\n## 0.6.1\n\n- A fix from the release branch.\n'
56 + );
57 + expect(updated.match(/- Previously shipped\./g)).toHaveLength(1);
58 +});
59 +
60 +test('files only new notes when a stable release comes from a stale branch', () => {
61 + const firstNote = '- First fix.\n More detail.';
62 + const secondNote = '- Second fix.';
63 + const thirdNote = '- Third fix.';
64 + const firstHistory = `\n## 0.6.0\n\n${firstNote}\n\n[Compare with 0.5.0](https://example.com/compare)\n${history}`;
65 + const first = { tag: '@composio/cli@0.6.0', markdown: `${header}\n${firstNote}\n${history}` };
66 + const second = {
67 + tag: '@composio/cli@0.6.1',
68 + markdown: `${header}\n${secondNote}\n${firstHistory}`,
69 + };
70 + const third = {
71 + tag: '@composio/cli@0.6.2',
72 + markdown: `${header}\n${thirdNote}\n\n${secondNote}\n\n${firstNote}\n${history}`,
73 + };
74 + const current = `${header}\n- Still pending.\n\n${thirdNote}\n\n${secondNote}\n\n${firstNote}\n${firstHistory}`;
75 + const rolledThroughSecond = rollChangelog(current, [first, second], repository);
76 + const updated = rollChangelog(rolledThroughSecond, [second, third], repository);
77 +
78 + expect(updated).toStartWith(
79 + header + '\n- Still pending.\n\n## 0.6.2\n\n' + thirdNote + '\n\n[Compare'
80 + );
81 + expect(updated.match(/- First fix\./g)).toHaveLength(1);
82 + expect(updated.match(/- Second fix\./g)).toHaveLength(1);
83 + expect(rollChangelog(current, [first, second, third], repository)).toBe(updated);
84 +});
.github/scripts/cli-release/update-changelog.ts new
+126
@@ -0,0 +1,126 @@
1 +import { execFileSync } from 'node:child_process';
2 +import { readFileSync, writeFileSync } from 'node:fs';
3 +
4 +const path = 'ts/packages/cli/CHANGELOG.md';
5 +const tagPrefix = '@composio/cli@';
6 +const stableTag = /^@composio\/cli@(\d+\.\d+\.\d+)$/;
7 +const header = '# @composio/cli\n\n## Unreleased';
8 +
9 +type Note = { heading: string; text: string };
10 +
11 +function splitChangelog(markdown: string) {
12 + const boundary = markdown.indexOf('\n## ', header.length);
13 + return {
14 + unreleased: markdown.slice(header.length, boundary < 0 ? undefined : boundary),
15 + history: boundary < 0 ? '' : markdown.slice(boundary + 1),
16 + };
17 +}
18 +
19 +function pendingNotes(markdown: string): Note[] {
20 + // Older stable tags predate the Unreleased section.
21 + if (!markdown.startsWith(header + '\n')) return [];
22 +
23 + const notes: Note[] = [];
24 + let heading = '';
25 + const { unreleased } = splitChangelog(markdown);
26 + for (const block of unreleased.split(/(?=^### |^- )/m)) {
27 + const text = block.trimEnd();
28 + if (!text) continue;
29 + if (text.startsWith('### ') && !text.includes('\n')) {
30 + heading = text;
31 + } else if (text.startsWith('- ')) {
32 + notes.push({ heading, text });
33 + } else {
34 + throw new Error(`Unexpected Unreleased content: ${text}`);
35 + }
36 + }
37 + return notes;
38 +}
39 +
40 +function withoutNotes(notes: Note[], removed: Note[]): Note[] {
41 + const counts = new Map<string, number>();
42 + for (const { text } of removed) counts.set(text, (counts.get(text) ?? 0) + 1);
43 +
44 + return notes.filter(({ text }) => {
45 + const count = counts.get(text) ?? 0;
46 + if (count === 0) return true;
47 + counts.set(text, count - 1);
48 + return false;
49 + });
50 +}
51 +
52 +function renderNotes(notes: Note[]): string {
53 + const blocks: string[] = [];
54 + let previousHeading = '';
55 + for (const { heading, text } of notes) {
56 + if (heading && heading !== previousHeading) blocks.push(heading);
57 + blocks.push(text);
58 + previousHeading = heading;
59 + }
60 + return blocks.join('\n\n');
61 +}
62 +
63 +export function rollChangelog(
64 + current: string,
65 + releases: { tag: string; markdown: string }[],
66 + repository: string
67 +): string {
68 + if (!current.startsWith(header + '\n')) {
69 + throw new Error('CLI changelog is missing its Unreleased section');
70 + }
71 + if (releases.length < 2) return current;
72 +
73 + let { history } = splitChangelog(current);
74 + let pending = pendingNotes(current);
75 + // Version sections contain both notes and standalone text such as compare links.
76 + const previouslyShipped = new Set(
77 + history
78 + .split(/(?=^#{2,3} |^- |^\n\S)/m)
79 + .filter(block => block.startsWith('- '))
80 + .map(block => block.trimEnd())
81 + );
82 +
83 + for (let index = 1; index < releases.length; index++) {
84 + const previous = releases[index - 1];
85 + const release = releases[index];
86 + const version = release.tag.slice(tagPrefix.length);
87 + for (const { text } of pendingNotes(previous.markdown)) previouslyShipped.add(text);
88 + const releaseNotes = pendingNotes(release.markdown);
89 + const shipped = releaseNotes.filter(({ text }) => !previouslyShipped.has(text));
90 + pending = withoutNotes(pending, releaseNotes);
91 + const notes = renderNotes(shipped);
92 + const compare = `[Compare with ${previous.tag.slice(tagPrefix.length)}](https://github.com/${repository}/compare/${encodeURIComponent(previous.tag)}...${encodeURIComponent(release.tag)})`;
93 + history = [`## ${version}`, notes, compare, history].filter(Boolean).join('\n\n');
94 + }
95 +
96 + return [header, renderNotes(pending), history].filter(Boolean).join('\n\n');
97 +}
98 +
99 +function git(...args: string[]): string {
100 + return execFileSync('git', args, { encoding: 'utf8', maxBuffer: 4 * 1024 * 1024 });
101 +}
102 +
103 +if (import.meta.main) {
104 + const repository = process.env.GH_REPO ?? 'ComposioHQ/composio';
105 + const current = readFileSync(path, 'utf8');
106 + const version = splitChangelog(current).history.match(/^## (\d+\.\d+\.\d+)\n/)?.[1];
107 + if (!version) throw new Error('CLI changelog is missing its latest stable version');
108 +
109 + // gh supplies published stable releases. Sort the matching, checked-out tags
110 + // numerically and use only the releases after the last documented version.
111 + const published = new Set(process.argv.slice(2).filter(tag => stableTag.test(tag)));
112 + const tags = git('tag', '--list', '--sort=version:refname', '@composio/cli@*')
113 + .trim()
114 + .split('\n')
115 + .filter(tag => published.has(tag));
116 + if (tags.length !== published.size)
117 + throw new Error('Published CLI release tags are missing locally');
118 + const baseline = tags.indexOf(tagPrefix + version);
119 + if (baseline === -1) throw new Error(`No published CLI release found for ${version}`);
120 + // A manually built beta may come from a release branch outside next.
121 + const releases = tags.slice(baseline).map(tag => ({
122 + tag,
123 + markdown: git('show', `refs/tags/${tag}:${path}`),
124 + }));
125 + writeFileSync(path, rollChangelog(current, releases, repository));
126 +}
.github/workflows/build-cli-binaries.yml
+3
@@ -9,6 +9,7 @@ on:
9 - '.github/scripts/cli-release/**'
10 - '.github/workflows/build-cli-binaries.yml'
11 - '.github/workflows/cli.windows.yml'
12 + - '.github/workflows/cli.test-installation.yml'
13 - 'install.ps1'
14 - 'install.sh'
15 - 'install/**'
@@ -47,6 +48,7 @@ jobs:
48 release_version: ${{ steps.resolve.outputs.release_version }}
49 prerelease: ${{ steps.resolve.outputs.prerelease }}
50 make_latest: ${{ steps.resolve.outputs.make_latest }}
51 + previous_stable_tag: ${{ steps.resolve.outputs.previous_stable_tag }}
52
53 steps:
54 - name: Checkout
@@ -209,6 +211,7 @@ jobs:
211 RELEASE_NAME: ${{ needs.prepare.outputs.release_name }}
212 PRERELEASE: ${{ needs.prepare.outputs.prerelease }}
213 MAKE_LATEST: ${{ needs.prepare.outputs.make_latest }}
214 + PREVIOUS_STABLE_TAG: ${{ needs.prepare.outputs.previous_stable_tag }}
215 CHECKOUT_REF: ${{ github.sha }}
216 RELEASE_HELPERS_DIR: ${{ github.workspace }}/.release-workflow/.github/scripts/cli-release
217
.github/workflows/cli.changelog.yml new
+72
@@ -0,0 +1,72 @@
1 +name: Update CLI Changelog
2 +
3 +on:
4 + # The job uses only protected next code and published tag contents as data.
5 + # It does not download artifacts or use caches from the triggering workflow.
6 + workflow_run: # zizmor: ignore[dangerous-triggers]
7 + workflows: [Build CLI Binaries]
8 + types: [completed]
9 + workflow_dispatch:
10 +
11 +permissions:
12 + contents: read
13 +
14 +concurrency:
15 + group: cli-changelog
16 + cancel-in-progress: false
17 +
18 +jobs:
19 + changelog:
20 + # This runs on the protected default branch with the SDK release App's
21 + # environment. Read published tags as data and execute only code from next.
22 + if: >-
23 + github.repository == 'ComposioHQ/composio' && github.ref == 'refs/heads/next' &&
24 + (github.event_name == 'workflow_dispatch' ||
25 + (github.event.workflow_run.conclusion == 'success' &&
26 + github.event.workflow_run.event == 'workflow_dispatch' &&
27 + github.event.workflow_run.head_repository.full_name == github.repository &&
28 + startsWith(github.event.workflow_run.head_branch, '@composio/cli@')))
29 + runs-on: ubuntu-latest
30 + timeout-minutes: 10
31 + environment: sdk-release-control
32 + steps:
33 + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
34 + with:
35 + ref: next
36 + fetch-depth: 0
37 + persist-credentials: false
38 + - uses: ./.github/actions/setup-node-pnpm-bun
39 + with:
40 + enable-caching: 'false'
41 + - run: bun test ./.github/scripts/cli-release/update-changelog.test.ts
42 + - name: Update the changelog from published stable tags
43 + env:
44 + GH_TOKEN: ${{ github.token }}
45 + run: |
46 + published=$(gh release list --exclude-drafts --exclude-pre-releases --limit 1000 --json tagName --jq '.[].tagName')
47 + mapfile -t tags <<< "$published"
48 + bun .github/scripts/cli-release/update-changelog.ts "${tags[@]}"
49 + - uses: actions/create-github-app-token@64ab729a6294000f5aa4a4bc0b73d1f32bc45510 # v3.3.0
50 + id: app
51 + with:
52 + client-id: ${{ vars.SDK_RELEASE_APP_CLIENT_ID }}
53 + private-key: ${{ secrets.SDK_RELEASE_APP_PRIVATE_KEY }}
54 + owner: ComposioHQ
55 + repositories: composio
56 + permission-contents: write
57 + permission-pull-requests: write
58 + - name: Create or update the changelog PR
59 + uses: peter-evans/create-pull-request@3ffccacd46053766916f087ce41d627c0b8cf2d1 # v8.1.3
60 + with:
61 + token: ${{ steps.app.outputs.token }}
62 + base: next
63 + branch: chore/cli-release-changelog
64 + delete-branch: true
65 + commit-message: 'docs(cli): update the stable changelog'
66 + title: 'docs(cli): update the stable changelog'
67 + body: |
68 + Move the notes included in published stable binaries into their version sections.
69 + Notes added after those releases stay under Unreleased.
70 +
71 + [Changelog workflow run](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }})
72 + add-paths: ts/packages/cli/CHANGELOG.md
.github/workflows/cli.test-installation.yml
+2
@@ -601,6 +601,7 @@ jobs:
601 env:
602 VERSION_INPUT: ${{ inputs.version || github.ref_name }}
603 COMPOSIO_CLI_TELEMETRY_DISABLED: '1'
604 + COMPOSIO_GITHUB_API_TOKEN: ${{ github.token }}
605 run: |
606 $ErrorActionPreference = 'Stop'
607 if ($env:VERSION_INPUT -and $env:VERSION_INPUT -ne 'latest') {
@@ -608,6 +609,7 @@ jobs:
609 }
610 # The documented flow: pipe the script into Invoke-Expression.
611 Get-Content -Raw ./install.ps1 | Invoke-Expression
612 + Remove-Item Env:COMPOSIO_GITHUB_API_TOKEN
613 $expectedVersion = (Get-Content -LiteralPath "$HOME/.composio/release-tag.txt" -Raw).Trim() -replace '^@composio/cli@', ''
614 $actualVersion = (& composio --version | Out-String).Trim()
615 if ($LASTEXITCODE -ne 0 -or $actualVersion -ne $expectedVersion) {
install.ps1
+9 -2
@@ -35,6 +35,13 @@
35 # Find the release: the requested version, or the newest stable one that ships a Windows archive.
36 $api = if ($env:COMPOSIO_GITHUB_API_BASE_URL) { $env:COMPOSIO_GITHUB_API_BASE_URL.TrimEnd('/') } else { 'https://api.github.com' }
37 Assert-TrustedUrl $api
38 + # CI can authenticate metadata requests to avoid GitHub's shared runner-IP
39 + # limit. Never send the token to a custom API base or to asset hosts.
40 + $apiRequest = @{}
41 + if ($api -ceq 'https://api.github.com' -and $env:COMPOSIO_GITHUB_API_TOKEN) {
42 + $apiRequest.Headers = @{ Authorization = "Bearer $env:COMPOSIO_GITHUB_API_TOKEN" }
43 + $apiRequest.MaximumRedirection = 0
44 + }
45 $releasesUrl = "$api/repos/ComposioHQ/composio/releases"
46 $release = $null
47 if ($env:COMPOSIO_INSTALL_VERSION) {
@@ -42,12 +49,12 @@
49 if ($version -notmatch '^\d+\.\d+\.\d+(-beta\.\d+)?$') {
50 throw "Invalid Composio CLI version `"$env:COMPOSIO_INSTALL_VERSION`". Expected X.Y.Z or X.Y.Z-beta.N."
51 }
45 - $release = Invoke-RestMethod "$releasesUrl/tags/$([uri]::EscapeDataString("@composio/cli@$version"))"
52 + $release = Invoke-RestMethod "$releasesUrl/tags/$([uri]::EscapeDataString("@composio/cli@$version"))" @apiRequest
53 } else {
54 Write-Host 'Finding latest stable CLI release...'
55 for ($page = 1; $page -le 5 -and -not $release; $page++) {
56 # Assign before piping: Windows PowerShell emits the JSON array as a single object.
50 - $candidates = Invoke-RestMethod "${releasesUrl}?per_page=100&page=$page"
57 + $candidates = Invoke-RestMethod "${releasesUrl}?per_page=100&page=$page" @apiRequest
58 if (-not $candidates) { break }
59 $release = $candidates | Where-Object {
60 $_.tag_name -match '^@composio/cli@\d+\.\d+\.\d+$' -and -not $_.draft -and -not $_.prerelease -and
test/release-workflow.test.ts
+7
@@ -1842,6 +1842,10 @@ function runResolver({ env, releasesFixture, curlFixture, ghViewIsDraft }) {
1842 RUN_NUMBER: '1',
1843 COMMIT_SHA: 'abc123',
1844 },
1845 + releasesFixture: [
1846 + { tagName: '@composio/cli@0.2.33', isPrerelease: false },
1847 + { tagName: '@composio/cli@0.3.0-beta.5', isPrerelease: true },
1848 + ],
1849 curlFixture: { prerelease: true, target_commitish: 'abc123' },
1850 // ghViewIsDraft unset ⇒ `gh release view` exits non-zero ⇒ no existing release to refuse.
1851 });
@@ -1854,6 +1858,9 @@ function runResolver({ env, releasesFixture, curlFixture, ghViewIsDraft }) {
1858 if (r.outputs.prerelease !== 'false' || r.outputs.make_latest !== 'true') {
1859 throw new Error('promote-stable must emit prerelease=false and make_latest=true');
1860 }
1861 + if (r.outputs.previous_stable_tag !== '@composio/cli@0.2.33') {
1862 + throw new Error('promote-stable must start release notes at the previous published stable tag');
1863 + }
1864 if ('checkout_ref' in r.outputs) {
1865 throw new Error('promote-stable must not emit an input-derived checkout ref');
1866 }
ts/packages/cli/CHANGELOG.md
+52 -19
@@ -2,6 +2,8 @@
2
3 ## Unreleased
4
5 +## 0.6.3
6 +
7 ### Patch Changes
8
9 - Update @composio/client to 2.1.36 to include the latest API changes.
@@ -22,8 +24,16 @@
24
25 - `composio upgrade` on Windows now retries a busy executable rename for up to two seconds, allowing a brief file lock after a previous upgrade to clear before replacing the binary.
26
27 +- `composio login --poll` accepts `--timeout <seconds>` to bound how long it waits. If the login is still pending when the wait ends, the CLI prints the authorization URL and the command to resume polling. [#5431](https://github.com/ComposioHQ/composio/pull/5431)
28 +
29 - Update @composio/client to 2.1.33 to include the latest API changes.
30
31 +[Compare with 0.6.2](https://github.com/ComposioHQ/composio/compare/%40composio%2Fcli%400.6.2...%40composio%2Fcli%400.6.3)
32 +
33 +## 0.6.2
34 +
35 +### Patch Changes
36 +
37 - A failed request that is safe to send again now exits 75 (`EX_TEMPFAIL`) instead of 1 and says so on stderr: one the API refused with a 429, or a read that timed out, lost its connection, or got a 408 or 5xx. Scripts and agents can retry on 75 without guessing. A failed `composio execute` adds `"retry": "safe"`, or `"retry": "check-first"` when the tool may have run before the request failed, to its `{ "successful": false }` result, and the `composio-cli` skill tells agents what both mean. Every other failed request still exits 1.
38
39 - `composio dev toolkits list` and `info` now read a user's connection status in the resolved developer project. When no directory project applies, `--user-id` or the global test user can use the default developer project. A failed project lookup leaves the catalog available and warns when `--connected` cannot be applied.
@@ -79,6 +89,22 @@
89 The `composio-cli` skill's developer reference now lists `composio orgs list`
90 in place of `composio dev orgs list`, which does not exist.
91
92 +### Minor Changes
93 +
94 +- `composio dev logs tools` now searches and retrieves logs through the public
95 + tool execution logs API. Pages are capped at 100. Piped JSON uses the public
96 + `logs` / `next_cursor` envelope and unified log detail fields. The public API
97 + does not support `--case-sensitive` or the legacy `--session-id` filter;
98 + these now fail with an explanation. `--tool-router-session-id` remains supported.
99 + Each filter flag takes one value; a comma-separated list now fails instead of
100 + matching nothing.
101 +
102 +[Compare with 0.6.1](https://github.com/ComposioHQ/composio/compare/%40composio%2Fcli%400.6.1...%40composio%2Fcli%400.6.2)
103 +
104 +## 0.6.1
105 +
106 +### Patch Changes
107 +
108 - Update @composio/client to 2.1.32 to include the latest API changes.
109
110 - `composio dev connected-accounts link --help` now shows
@@ -120,6 +146,25 @@
146 workflows; other commands may not work yet. Windows requires Windows 10 1809
147 or newer and an SSE4.2-capable x64 CPU.
148
149 +### Patch Changes
150 +
151 +- `composio connections list` now prints every connection. The server serves
152 + at most 50 connected accounts per request and the CLI read only the first
153 + page, so a user with more than 50 saw a partial list with no sign it was cut
154 + off, and a connected toolkit (such as an active Slack account) looked
155 + disconnected. `composio connections remove` could not find an account past
156 + the first 50, and `composio execute` sessions left out toolkits whose
157 + accounts were past the first 50 active ones. All three now follow
158 + `next_cursor` through every page.
159 + `composio link --list` and alias-conflict checks when linking also read
160 + every page, including accounts filtered by an auth config.
161 +
162 +[Compare with 0.6.0](https://github.com/ComposioHQ/composio/compare/%40composio%2Fcli%400.6.0...%40composio%2Fcli%400.6.1)
163 +
164 +## 0.6.0
165 +
166 +### Minor Changes
167 +
168 - A signal now ends each command the way its work ends. A one-shot command,
169 `composio login` and `composio upgrade` stopped with Ctrl-C (SIGINT), SIGTERM
170 or a closed terminal (SIGHUP) exit 130, 143 or 129. They used to exit 0, so a
@@ -136,14 +181,6 @@
181 128 plus the signal's number, or, for `composio run`, the script's process
182 group is killed and the CLI is killed by that signal.
183
139 -- `composio dev logs tools` now searches and retrieves logs through the public
140 - tool execution logs API. Pages are capped at 100. Piped JSON uses the public
141 - `logs` / `next_cursor` envelope and unified log detail fields. The public API
142 - does not support `--case-sensitive` or the legacy `--session-id` filter;
143 - these now fail with an explanation. `--tool-router-session-id` remains supported.
144 - Each filter flag takes one value; a comma-separated list now fails instead of
145 - matching nothing.
146 -
184 - `composio dev connected-accounts link <toolkit>` (with or without `--list`)
185 now acts on your developer project, like the other `composio dev` commands:
186 the directory's project, or the one `--project-name` names. It links or lists
@@ -179,17 +216,6 @@
216 omit command input properties instead of reporting synthetic defaults, false
217 booleans, or zero counts for input that was never parsed.
218
182 -- `composio connections list` now prints every connection. The server serves
183 - at most 50 connected accounts per request and the CLI read only the first
184 - page, so a user with more than 50 saw a partial list with no sign it was cut
185 - off, and a connected toolkit (such as an active Slack account) looked
186 - disconnected. `composio connections remove` could not find an account past
187 - the first 50, and `composio execute` sessions left out toolkits whose
188 - accounts were past the first 50 active ones. All three now follow
189 - `next_cursor` through every page.
190 - `composio link --list` and alias-conflict checks when linking also read
191 - every page, including accounts filtered by an auth config.
192 -
219 - `composio dev triggers listen --toolkits` now matches toolkits whose slug
220 contains an underscore, such as `one_drive`, `launch_darkly` and
221 `agent_mail`. Events carry no toolkit slug, so the listener took the first
@@ -376,6 +402,7 @@
402 `--auth-config`. They used to exit 0, and printed the message only when
403 stderr was a terminal, so scripts, CI and agents saw no output and a
404 successful exit. The messages are unchanged.
405 +
406 - These commands now exit 1 and print their message on stderr. They used to
407 exit 0, and printed the message only when stderr was a terminal, so scripts,
408 CI and agents saw no output and a successful exit. The messages are
@@ -398,6 +425,7 @@
425 `composio link` and `composio dev connected-accounts link` when the link
426 request fails, the link response is incomplete, the `--alias` is already
427 taken, or an account already exists and no `--alias` was passed.
428 +
429 - These commands already exited 1 but printed their message only when stderr
430 was a terminal; they now print it on stderr either way:
431 `composio dev toolkits list` and `composio dev toolkits search` when the
@@ -405,6 +433,7 @@
433 `composio dev triggers listen` when the realtime subscription fails, and
434 the `composio agent` commands, `composio signup` and `composio login` when
435 the stored agent identity can't be used.
436 +
437 - `composio connections remove` gains `--yes` (`-y`) to remove without the
438 confirmation prompt, and `composio logout` accepts `--yes` (`-y`) next to
439 `--force` (`-f`). When not running interactively, both used to answer their
@@ -412,14 +441,18 @@
441 exit 1 with "needs --yes when not running interactively" on stderr, before
442 any request (for `logout`, only when logged in as an agent, the case that
443 asks). Declining the prompt on a terminal still removes nothing and exits 0.
444 +
445 - `composio listen`, `composio dev listen` and `composio dev triggers listen`
446 now print how many events they failed to save, forward, or append to `--out`
447 on stderr when they stop, including on Ctrl+C. The per-event warnings were
448 shown only when stderr was a terminal. One failed event still does not stop
449 the listener, and the exit code is unchanged.
450 +
451 - `composio listen --max-events N` now stops after N matching events even when
452 saving one of them fails. It used to keep listening until interrupted.
453
454 +[Compare with 0.5.0](https://github.com/ComposioHQ/composio/compare/%40composio%2Fcli%400.5.0...%40composio%2Fcli%400.6.0)
455 +
456 ## 0.5.0
457
458 ### Minor Changes