Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,14 @@ trace, study, receipt, API and database schema versions.

## [Unreleased]

### Documentation

- The README points to the Codex and Claude Code runners, and its standalone
executable download examples use 0.2.5.
- npm release instructions require allowing direct `npm publish` for the
trusted publisher and explain the `E404` that npm returns when no trusted
publisher matches the workflow run.

## [0.2.5] - 2026-11-18

### Added
Expand Down
10 changes: 7 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,10 @@ baseline, the frozen session, an interleaved before/after capture and the
verdict in one command. Pass the unchanged runner as repeated `--before-arg`
values and the changed runner after `--`. See
[comparing two versions in one command](https://dipeshbabu.github.io/agentloop/GUIDED_OPTIMIZATION/#compare-two-versions-in-one-command).
Example runners for [OpenAI Codex CLI](https://dipeshbabu.github.io/agentloop/CODEX/)
and [Claude Code](https://dipeshbabu.github.io/agentloop/CLAUDE_CODE/) turn each
coding-agent run into a native trace, so the same workflow compares models,
instructions or settings for those agents.

To connect your application, run `agentloop improve init --agent my_agent:answer`
in its project directory. The generated adapter supports synchronous and async
Expand Down Expand Up @@ -397,13 +401,13 @@ where the examples show `agentloop`.
<summary>Download and verify a standalone executable</summary>

Download the executable and `SHA256SUMS` from the same release. These examples use
version 0.2.0. Change the version when choosing another release.
version 0.2.5. Change the version when choosing another release.

Linux (Bash):

```bash
set -euo pipefail
version=0.2.0
version=0.2.5
asset="agentloop-v${version}-linux-x86_64"
curl --fail --location --remote-name "https://github.com/dipeshbabu/agentloop/releases/download/v${version}/${asset}"
curl --fail --location --remote-name "https://github.com/dipeshbabu/agentloop/releases/download/v${version}/SHA256SUMS"
Expand All @@ -420,7 +424,7 @@ chmod +x "$asset"
Windows PowerShell:

```powershell
$Version = "0.2.0"
$Version = "0.2.5"
$Asset = "agentloop-v$Version-windows-x86_64.exe"
Invoke-WebRequest "https://github.com/dipeshbabu/agentloop/releases/download/v$Version/$Asset" -OutFile agentloop.exe
Invoke-WebRequest "https://github.com/dipeshbabu/agentloop/releases/download/v$Version/SHA256SUMS" -OutFile SHA256SUMS
Expand Down
12 changes: 11 additions & 1 deletion docs/RELEASING.md
Original file line number Diff line number Diff line change
Expand Up @@ -150,7 +150,11 @@ One-time setup, after the first publish exists on npm:

1. On npmjs.com, open the package's **Settings → Trusted publishing** and add
GitHub Actions with repository `dipeshbabu/agentloop`, workflow
`release-npm.yml` and environment `npm`.
`release-npm.yml` and environment `npm`. Tick **Allow npm publish**: without
it the publisher may only stage versions, and the workflow's direct
`npm publish` is refused. Saving asks for two-factor authentication; if npm
asks partway through, the form is discarded, so check that the publisher is
listed afterwards. It shows **Pending validation** until the first publish.
2. In the GitHub repository, create the `npm` environment and set the
repository variable `NPM_PUBLISH_ENABLED` to `true`.

Expand All @@ -165,6 +169,12 @@ npm pack --dry-run
npm publish --access public
```

If the workflow signs provenance and then fails with `E404 Not Found - PUT
https://registry.npmjs.org/agentloop-profiler`, npm found no trusted publisher
matching the run. Check the repository, workflow filename and environment on
the package's settings page, then re-run the failed job; the tag does not need
to change.

npm versions are immutable: a published version cannot be re-uploaded, and
unpublishing is restricted after 72 hours. Fix mistakes with a new patch version.
Verify publication in a fresh directory:
Expand Down
4 changes: 4 additions & 0 deletions docs/TYPESCRIPT_RELEASE_PROPOSAL.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# TypeScript SDK: first npm release proposal

> **Status:** completed. `agentloop-profiler@0.1.0` was first published on
> 2026-11-14, and 0.1.1 was published on 2026-11-19 by `release-npm.yml` through
> npm trusted publishing with provenance. This page is kept as the review record.

Proposed package: `agentloop-profiler@0.1.0`. This proposal does not publish it.
The maintainer approved the first publication on 2026-11-14; see
[Releasing](RELEASING.md#typescript-sdk-on-npm) for the npm release flow.
Expand Down
Loading