Skip to content

Commit b98c327

Browse files
Nick Ficanoclaude
andcommitted
refactor: rename npm scope @arcp/* -> @agentruntimecontrolprotocol/*
@arcp is already claimed on npm, so the workspace adopts the GitHub org name as its npm scope. 193 files updated in lockstep: package manifests + internal dependency references, source imports, test imports, the vitest alias map (including the regex-escaped form), .changeset/config.json linked array, the publish workflow's scope comment, README install snippets, docs, examples, diagram .dot sources and rendered SVGs, recipes. pnpm-lock.yaml regenerated. The `arcp` CLI binary name, the `ARCP*` symbol names, env vars (ARCP_TOKEN, ARCP_DEMO_URL), and the protocol name itself are unchanged — those refer to the protocol, not the npm scope. Also updates the Codecov badge URL to the tokenized form so the badge renders before the first upload lands. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 72d7ffc commit b98c327

193 files changed

Lines changed: 593 additions & 593 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.changeset/config.json

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -5,16 +5,16 @@
55
"fixed": [],
66
"linked": [
77
[
8-
"@arcp/core",
9-
"@arcp/client",
10-
"@arcp/runtime",
11-
"@arcp/sdk",
12-
"@arcp/node",
13-
"@arcp/express",
14-
"@arcp/fastify",
15-
"@arcp/hono",
16-
"@arcp/bun",
17-
"@arcp/middleware-otel"
8+
"@agentruntimecontrolprotocol/core",
9+
"@agentruntimecontrolprotocol/client",
10+
"@agentruntimecontrolprotocol/runtime",
11+
"@agentruntimecontrolprotocol/sdk",
12+
"@agentruntimecontrolprotocol/node",
13+
"@agentruntimecontrolprotocol/express",
14+
"@agentruntimecontrolprotocol/fastify",
15+
"@agentruntimecontrolprotocol/hono",
16+
"@agentruntimecontrolprotocol/bun",
17+
"@agentruntimecontrolprotocol/middleware-otel"
1818
]
1919
],
2020
"access": "public",

.github/workflows/publish.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
1-
# Publishes all @arcp/* workspace packages to npm after the `test` workflow
1+
# Publishes all @agentruntimecontrolprotocol/* workspace packages to npm after the `test` workflow
22
# succeeds on main, skipping any package whose local version is already on the
33
# registry. The workspace root (package.json `"private": true`) is never
44
# published.
55
#
66
# Required repo configuration:
77
# - Secret: NPM_TOKEN (npm automation token with publish rights to the
8-
# @arcp scope — create at npmjs.com → Access Tokens → Automation)
8+
# @agentruntimecontrolprotocol scope — create at npmjs.com → Access Tokens → Automation)
99
# - Settings > Actions > General > Workflow permissions: "Read and write"
1010
# is NOT required; this workflow only needs id-token:write (set below)
1111
# for npm provenance.

CONFORMANCE.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -159,10 +159,10 @@ Host integrations (one example per middleware):
159159

160160
| Directory | Middleware |
161161
| ---------- | ----------------------- |
162-
| `tracing/` | `@arcp/middleware-otel` |
163-
| `express/` | `@arcp/express` |
164-
| `fastify/` | `@arcp/fastify` |
165-
| `bun/` | `@arcp/bun` |
162+
| `tracing/` | `@agentruntimecontrolprotocol/middleware-otel` |
163+
| `express/` | `@agentruntimecontrolprotocol/express` |
164+
| `fastify/` | `@agentruntimecontrolprotocol/fastify` |
165+
| `bun/` | `@agentruntimecontrolprotocol/bun` |
166166

167167
## §14. Security Considerations
168168

@@ -413,13 +413,13 @@ The package set:
413413

414414
| Package | Status |
415415
| ----------------------- | ------------------------ |
416-
| `@arcp/core` | Implemented (v1.1) |
417-
| `@arcp/client` | Implemented (v1.1) |
418-
| `@arcp/runtime` | Implemented (v1.1) |
419-
| `@arcp/sdk` | Implemented (v1.1) |
420-
| `@arcp/node` | Implemented |
421-
| `@arcp/express` | Implemented |
422-
| `@arcp/fastify` | Implemented |
423-
| `@arcp/hono` | Implemented |
424-
| `@arcp/bun` | Implemented |
425-
| `@arcp/middleware-otel` | Implemented (v1.1 attrs) |
416+
| `@agentruntimecontrolprotocol/core` | Implemented (v1.1) |
417+
| `@agentruntimecontrolprotocol/client` | Implemented (v1.1) |
418+
| `@agentruntimecontrolprotocol/runtime` | Implemented (v1.1) |
419+
| `@agentruntimecontrolprotocol/sdk` | Implemented (v1.1) |
420+
| `@agentruntimecontrolprotocol/node` | Implemented |
421+
| `@agentruntimecontrolprotocol/express` | Implemented |
422+
| `@agentruntimecontrolprotocol/fastify` | Implemented |
423+
| `@agentruntimecontrolprotocol/hono` | Implemented |
424+
| `@agentruntimecontrolprotocol/bun` | Implemented |
425+
| `@agentruntimecontrolprotocol/middleware-otel` | Implemented (v1.1 attrs) |

README.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@
33
<p align="center"><strong>TypeScript SDK for the Agent Runtime Control Protocol (ARCP) — submit, observe, and control long-running agent jobs from TypeScript.</strong></p>
44

55
<p align="center">
6-
<a href="https://www.npmjs.com/package/@arcp/sdk"><img alt="npm" src="https://img.shields.io/npm/v/@arcp/sdk.svg"></a>
6+
<a href="https://www.npmjs.com/package/@agentruntimecontrolprotocol/sdk"><img alt="npm" src="https://img.shields.io/npm/v/@agentruntimecontrolprotocol/sdk.svg"></a>
77
<a href="https://github.com/agentruntimecontrolprotocol/typescript-sdk/actions/workflows/test.yml"><img alt="CI" src="https://github.com/agentruntimecontrolprotocol/typescript-sdk/actions/workflows/test.yml/badge.svg"></a>
8-
<a href="https://codecov.io/gh/agentruntimecontrolprotocol/typescript-sdk"><img alt="codecov" src="https://codecov.io/gh/agentruntimecontrolprotocol/typescript-sdk/branch/main/graph/badge.svg"></a>
8+
<a href="https://codecov.io/gh/agentruntimecontrolprotocol/typescript-sdk"><img alt="codecov" src="https://codecov.io/gh/agentruntimecontrolprotocol/typescript-sdk/graph/badge.svg?token=7AK1DZRWGZ"></a>
99
<a href="https://github.com/agentruntimecontrolprotocol/spec/blob/main/docs/draft-arcp-1.1.md"><img alt="ARCP" src="https://img.shields.io/badge/ARCP-v1.1%20draft-blue"></a>
1010
<a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-lightgrey"></a>
1111
</p>
@@ -21,7 +21,7 @@
2121

2222
---
2323

24-
`@arcp/sdk` is the TypeScript reference implementation of [ARCP](https://github.com/agentruntimecontrolprotocol/spec/blob/main/docs/draft-arcp-1.1.md), the Agent Runtime Control Protocol. It covers both sides of the wire — `@arcp/client` for submitting and observing jobs, `@arcp/runtime` for hosting agents — so either side can talk to any conformant peer in any language without hand-rolling the envelope, sequencing, or lease enforcement.
24+
`@agentruntimecontrolprotocol/sdk` is the TypeScript reference implementation of [ARCP](https://github.com/agentruntimecontrolprotocol/spec/blob/main/docs/draft-arcp-1.1.md), the Agent Runtime Control Protocol. It covers both sides of the wire — `@agentruntimecontrolprotocol/client` for submitting and observing jobs, `@agentruntimecontrolprotocol/runtime` for hosting agents — so either side can talk to any conformant peer in any language without hand-rolling the envelope, sequencing, or lease enforcement.
2525

2626
ARCP itself is a transport-agnostic wire protocol for long-running AI agent jobs. It owns the parts of agent infrastructure that don't change between products — sessions, durable event streams, capability leases, budgets, resume — and stays out of the parts that do. ARCP wraps the agent function; it does not define how agents are built, how tools are exposed (that's MCP), or how telemetry is exported (that's OpenTelemetry).
2727

@@ -30,20 +30,20 @@ ARCP itself is a transport-agnostic wire protocol for long-running AI agent jobs
3030
Requires Node.js 22 or later. The SDK is shipped as a pnpm workspace of independently-versioned, ESM-only packages. Install the meta-package for everything (client, runtime, core types, and the `arcp` CLI), or pick à la carte if you only need one side of the wire:
3131

3232
```sh
33-
npm install @arcp/sdk
33+
npm install @agentruntimecontrolprotocol/sdk
3434
# or, à la carte:
35-
npm install @arcp/client @arcp/core # client side
36-
npm install @arcp/runtime @arcp/core # runtime side
35+
npm install @agentruntimecontrolprotocol/client @agentruntimecontrolprotocol/core # client side
36+
npm install @agentruntimecontrolprotocol/runtime @agentruntimecontrolprotocol/core # runtime side
3737
```
3838

39-
Optional host integrations live in separate middleware packages: `@arcp/node`, `@arcp/express`, `@arcp/fastify`, `@arcp/hono`, `@arcp/bun`, and `@arcp/middleware-otel`.
39+
Optional host integrations live in separate middleware packages: `@agentruntimecontrolprotocol/node`, `@agentruntimecontrolprotocol/express`, `@agentruntimecontrolprotocol/fastify`, `@agentruntimecontrolprotocol/hono`, `@agentruntimecontrolprotocol/bun`, and `@agentruntimecontrolprotocol/middleware-otel`.
4040

4141
## Quick start
4242

4343
Connect to a runtime, submit a job, stream its events to completion:
4444

4545
```ts
46-
import { ARCPClient, WebSocketTransport } from "@arcp/sdk";
46+
import { ARCPClient, WebSocketTransport } from "@agentruntimecontrolprotocol/sdk";
4747

4848
const client = new ARCPClient({
4949
client: { name: "quickstart", version: "1.0.0" },
@@ -91,7 +91,7 @@ The SDK models each of these as first-class objects; the rest of this README sho
9191
Open a session, negotiate features, and reconnect transparently after a transport drop using the resume token — jobs keep running server-side while you're gone.
9292

9393
```ts
94-
import { ARCPClient, WebSocketTransport } from "@arcp/sdk";
94+
import { ARCPClient, WebSocketTransport } from "@agentruntimecontrolprotocol/sdk";
9595

9696
const client = new ARCPClient({
9797
client: { name: "resumable", version: "1.0.0" },
@@ -237,7 +237,7 @@ await sub.unsubscribe();
237237
Catch the typed error taxonomy and respect the `retryable` flag — `LEASE_EXPIRED` and `BUDGET_EXHAUSTED` are never retryable; a naive retry fails identically.
238238

239239
```ts
240-
import { ARCPError } from "@arcp/sdk";
240+
import { ARCPError } from "@agentruntimecontrolprotocol/sdk";
241241

242242
try {
243243
const handle = await client.submit({ agent: "flaky", input: {} });

diagrams/architecture-dark.dot

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ digraph ARCPTypescriptSDK {
3737
];
3838

3939
subgraph cluster_transport {
40-
label=<<TABLE BORDER="0" CELLBORDER="0" CELLPADDING="0" CELLSPACING="0"><TR><TD COLSPAN="3" HEIGHT="8"></TD></TR><TR><TD WIDTH="8"></TD><TD><FONT POINT-SIZE="12"><B>Transport (@arcp/core)</B></FONT></TD><TD WIDTH="8"></TD></TR></TABLE>>;
40+
label=<<TABLE BORDER="0" CELLBORDER="0" CELLPADDING="0" CELLSPACING="0"><TR><TD COLSPAN="3" HEIGHT="8"></TD></TR><TR><TD WIDTH="8"></TD><TD><FONT POINT-SIZE="12"><B>Transport (@agentruntimecontrolprotocol/core)</B></FONT></TD><TD WIDTH="8"></TD></TR></TABLE>>;
4141
style="rounded,filled";
4242
fillcolor="#0F172A";
4343
color="#334155";
@@ -56,7 +56,7 @@ digraph ARCPTypescriptSDK {
5656
}
5757

5858
subgraph cluster_runtime {
59-
label=<<TABLE BORDER="0" CELLBORDER="0" CELLPADDING="0" CELLSPACING="0"><TR><TD COLSPAN="3" HEIGHT="8"></TD></TR><TR><TD WIDTH="8"></TD><TD><FONT POINT-SIZE="12"><B>@arcp/runtime</B></FONT></TD><TD WIDTH="8"></TD></TR></TABLE>>;
59+
label=<<TABLE BORDER="0" CELLBORDER="0" CELLPADDING="0" CELLSPACING="0"><TR><TD COLSPAN="3" HEIGHT="8"></TD></TR><TR><TD WIDTH="8"></TD><TD><FONT POINT-SIZE="12"><B>@agentruntimecontrolprotocol/runtime</B></FONT></TD><TD WIDTH="8"></TD></TR></TABLE>>;
6060
style="rounded,filled";
6161
fillcolor="#1E293B";
6262
color="#334155";

diagrams/architecture-dark.svg

Lines changed: 2 additions & 2 deletions
Loading

diagrams/architecture-light.dot

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ digraph ARCPTypescriptSDK {
3939

4040
// Transport cluster
4141
subgraph cluster_transport {
42-
label=<<TABLE BORDER="0" CELLBORDER="0" CELLPADDING="0" CELLSPACING="0"><TR><TD COLSPAN="3" HEIGHT="8"></TD></TR><TR><TD WIDTH="8"></TD><TD><FONT POINT-SIZE="12"><B>Transport (@arcp/core)</B></FONT></TD><TD WIDTH="8"></TD></TR></TABLE>>;
42+
label=<<TABLE BORDER="0" CELLBORDER="0" CELLPADDING="0" CELLSPACING="0"><TR><TD COLSPAN="3" HEIGHT="8"></TD></TR><TR><TD WIDTH="8"></TD><TD><FONT POINT-SIZE="12"><B>Transport (@agentruntimecontrolprotocol/core)</B></FONT></TD><TD WIDTH="8"></TD></TR></TABLE>>;
4343
style="rounded,filled";
4444
fillcolor="#F1F5F9";
4545
color="#E2E8F0";
@@ -59,7 +59,7 @@ digraph ARCPTypescriptSDK {
5959

6060
// Runtime cluster
6161
subgraph cluster_runtime {
62-
label=<<TABLE BORDER="0" CELLBORDER="0" CELLPADDING="0" CELLSPACING="0"><TR><TD COLSPAN="3" HEIGHT="8"></TD></TR><TR><TD WIDTH="8"></TD><TD><FONT POINT-SIZE="12"><B>@arcp/runtime</B></FONT></TD><TD WIDTH="8"></TD></TR></TABLE>>;
62+
label=<<TABLE BORDER="0" CELLBORDER="0" CELLPADDING="0" CELLSPACING="0"><TR><TD COLSPAN="3" HEIGHT="8"></TD></TR><TR><TD WIDTH="8"></TD><TD><FONT POINT-SIZE="12"><B>@agentruntimecontrolprotocol/runtime</B></FONT></TD><TD WIDTH="8"></TD></TR></TABLE>>;
6363
style="rounded,filled";
6464
fillcolor="#F8FAFC";
6565
color="#E2E8F0";

diagrams/architecture-light.svg

Lines changed: 2 additions & 2 deletions
Loading

docs/README.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,9 @@ go deeper into each subsystem.
1212
## Start here
1313

1414
- [Getting started](./getting-started.md) — install, build a runtime + client, run the example.
15-
- [Architecture](./architecture.md) — how `@arcp/core`, `@arcp/client`, and `@arcp/runtime` fit together.
15+
- [Architecture](./architecture.md) — how `@agentruntimecontrolprotocol/core`, `@agentruntimecontrolprotocol/client`, and `@agentruntimecontrolprotocol/runtime` fit together.
1616
- [Transports](./transports.md) — WebSocket, stdio, in-memory; when to pick each.
17-
- [CLI](./cli.md) — the `arcp` binary shipped by `@arcp/sdk`.
17+
- [CLI](./cli.md) — the `arcp` binary shipped by `@agentruntimecontrolprotocol/sdk`.
1818

1919
## Guides (one per spec section)
2020

@@ -35,16 +35,16 @@ go deeper into each subsystem.
3535

3636
| Package | Page |
3737
| ----------------------- | --------------------------------------------------------- |
38-
| `@arcp/sdk` | [packages/sdk](./packages/sdk.md) |
39-
| `@arcp/core` | [packages/core](./packages/core.md) |
40-
| `@arcp/client` | [packages/client](./packages/client.md) |
41-
| `@arcp/runtime` | [packages/runtime](./packages/runtime.md) |
42-
| `@arcp/node` | [packages/node](./packages/node.md) |
43-
| `@arcp/express` | [packages/express](./packages/express.md) |
44-
| `@arcp/fastify` | [packages/fastify](./packages/fastify.md) |
45-
| `@arcp/hono` | [packages/hono](./packages/hono.md) |
46-
| `@arcp/bun` | [packages/bun](./packages/bun.md) |
47-
| `@arcp/middleware-otel` | [packages/middleware-otel](./packages/middleware-otel.md) |
38+
| `@agentruntimecontrolprotocol/sdk` | [packages/sdk](./packages/sdk.md) |
39+
| `@agentruntimecontrolprotocol/core` | [packages/core](./packages/core.md) |
40+
| `@agentruntimecontrolprotocol/client` | [packages/client](./packages/client.md) |
41+
| `@agentruntimecontrolprotocol/runtime` | [packages/runtime](./packages/runtime.md) |
42+
| `@agentruntimecontrolprotocol/node` | [packages/node](./packages/node.md) |
43+
| `@agentruntimecontrolprotocol/express` | [packages/express](./packages/express.md) |
44+
| `@agentruntimecontrolprotocol/fastify` | [packages/fastify](./packages/fastify.md) |
45+
| `@agentruntimecontrolprotocol/hono` | [packages/hono](./packages/hono.md) |
46+
| `@agentruntimecontrolprotocol/bun` | [packages/bun](./packages/bun.md) |
47+
| `@agentruntimecontrolprotocol/middleware-otel` | [packages/middleware-otel](./packages/middleware-otel.md) |
4848

4949
## Reference
5050

0 commit comments

Comments
 (0)