chore: add TypeDoc API docs generation and satisfy strict lint

- add typedoc + typedoc-plugin-markdown with a docs:api script and typedoc.json config
- ignore generated docs/api/ output
- use bracketed process.env access across examples, docs, and recipes
- sort reserved-event re-exports in core execution.ts

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: Nick Ficano

.gitignore

@@ -10,3 +10,4 @@ coverage/
 .vitest/
 *.tgz
 .effect-migration/
+docs/api/

README.md

@@ -48,7 +48,7 @@ import { ARCPClient, WebSocketTransport } from "@agentruntimecontrolprotocol/sdk
 const client = new ARCPClient({
   client: { name: "quickstart", version: "1.0.0" },
   authScheme: "bearer",
-  token: process.env.ARCP_TOKEN,
+  token: process.env["ARCP_TOKEN"],
 });
 
 const transport = await WebSocketTransport.connect("wss://runtime.example.com/arcp");
@@ -96,7 +96,7 @@ import { ARCPClient, WebSocketTransport } from "@agentruntimecontrolprotocol/sdk
 const client = new ARCPClient({
   client: { name: "resumable", version: "1.0.0" },
   authScheme: "bearer",
-  token: process.env.ARCP_TOKEN,
+  token: process.env["ARCP_TOKEN"],
 });
 
 const welcome = await client.connect(
@@ -114,7 +114,7 @@ client.on("job.event", (env) => {
 const client2 = new ARCPClient({
   client: { name: "resumable", version: "1.0.0" },
   authScheme: "bearer",
-  token: process.env.ARCP_TOKEN,
+  token: process.env["ARCP_TOKEN"],
 });
 await client2.resume(
   await WebSocketTransport.connect("wss://runtime.example.com/arcp"),
@@ -150,7 +150,7 @@ Iterate the ordered event stream — `log`, `thought`, `tool_call`, `tool_result
 const client = new ARCPClient({
   client: { name: "ack-demo", version: "1.0.0" },
   authScheme: "bearer",
-  token: process.env.ARCP_TOKEN,
+  token: process.env["ARCP_TOKEN"],
   autoAck: { intervalMs: 250, minSeqDelta: 32 }, // coalesced session.ack
 });
 
@@ -215,7 +215,7 @@ Attach read-only to a job submitted elsewhere and observe its live stream (with
 const observer = new ARCPClient({
   client: { name: "dashboard", version: "1.0.0" },
   authScheme: "bearer",
-  token: process.env.ARCP_TOKEN,
+  token: process.env["ARCP_TOKEN"],
 });
 await observer.connect(await WebSocketTransport.connect("wss://runtime.example.com/arcp"));
 

docs/guides/auth.md

@@ -10,7 +10,7 @@ sends a token in `session.hello`; the runtime verifies it via a
 const client = new ARCPClient({
   client: { name: "my-client", version: "1.0.0" },
   authScheme: "bearer",
-  token: process.env.TOKEN,
+  token: process.env["TOKEN"],
 });
 ```
 

docs/guides/sessions.md

@@ -36,7 +36,7 @@ import { ARCPClient, WebSocketTransport } from "@agentruntimecontrolprotocol/sdk
 const client = new ARCPClient({
   client: { name: "my-client", version: "1.0.0" },
   authScheme: "bearer",
-  token: process.env.TOKEN,
+  token: process.env["TOKEN"],
   // optional v1.1 features the client wants enabled:
   features: ["heartbeat", "ack", "list_jobs", "subscribe"],
   handshakeTimeoutMs: 5000,

docs/packages/client.md

@@ -19,7 +19,7 @@ import { ARCPClient } from "@agentruntimecontrolprotocol/client";
 const client = new ARCPClient({
   client: { name: "my-client", version: "1.0.0" },
   authScheme: "bearer",
-  token: process.env.TOKEN,
+  token: process.env["TOKEN"],
 
   // optional:
   capabilities: { encodings: ["json"] },

examples/ack-backpressure/client.ts

@@ -9,8 +9,8 @@
 
 import { ARCPClient, WebSocketTransport } from "@agentruntimecontrolprotocol/sdk";
 
-const URL = process.env.ARCP_DEMO_URL ?? "ws://127.0.0.1:7886/arcp";
-const TOKEN = process.env.ARCP_DEMO_TOKEN ?? "demo-token";
+const URL = process.env["ARCP_DEMO_URL"] ?? "ws://127.0.0.1:7886/arcp";
+const TOKEN = process.env["ARCP_DEMO_TOKEN"] ?? "demo-token";
 
 async function main(): Promise<void> {
   const client = new ARCPClient({

examples/ack-backpressure/server.ts

@@ -14,8 +14,8 @@ import {
   startWebSocketServer,
 } from "@agentruntimecontrolprotocol/sdk";
 
-const PORT = Number(process.env.ARCP_DEMO_PORT ?? 7886);
-const TOKEN = process.env.ARCP_DEMO_TOKEN ?? "demo-token";
+const PORT = Number(process.env["ARCP_DEMO_PORT"] ?? 7886);
+const TOKEN = process.env["ARCP_DEMO_TOKEN"] ?? "demo-token";
 
 async function main(): Promise<void> {
   const server = new ARCPServer({

examples/agent-versions/client.ts

@@ -10,8 +10,8 @@
 
 import { ARCPClient, WebSocketTransport } from "@agentruntimecontrolprotocol/sdk";
 
-const URL = process.env.ARCP_DEMO_URL ?? "ws://127.0.0.1:7889/arcp";
-const TOKEN = process.env.ARCP_DEMO_TOKEN ?? "demo-token";
+const URL = process.env["ARCP_DEMO_URL"] ?? "ws://127.0.0.1:7889/arcp";
+const TOKEN = process.env["ARCP_DEMO_TOKEN"] ?? "demo-token";
 
 async function main(): Promise<void> {
   const client = new ARCPClient({

examples/agent-versions/server.ts

@@ -13,8 +13,8 @@ import {
   startWebSocketServer,
 } from "@agentruntimecontrolprotocol/sdk";
 
-const PORT = Number(process.env.ARCP_DEMO_PORT ?? 7889);
-const TOKEN = process.env.ARCP_DEMO_TOKEN ?? "demo-token";
+const PORT = Number(process.env["ARCP_DEMO_PORT"] ?? 7889);
+const TOKEN = process.env["ARCP_DEMO_TOKEN"] ?? "demo-token";
 
 async function main(): Promise<void> {
   const server = new ARCPServer({

examples/bun/client.ts

@@ -8,9 +8,9 @@
 
 import { ARCPClient, WebSocketTransport } from "@agentruntimecontrolprotocol/sdk";
 
-const PORT = Number(process.env.ARCP_DEMO_PORT ?? 7898);
-const URL = process.env.ARCP_DEMO_URL ?? `ws://127.0.0.1:${PORT}/arcp`;
-const TOKEN = process.env.ARCP_DEMO_TOKEN ?? "demo-token";
+const PORT = Number(process.env["ARCP_DEMO_PORT"] ?? 7898);
+const URL = process.env["ARCP_DEMO_URL"] ?? `ws://127.0.0.1:${PORT}/arcp`;
+const TOKEN = process.env["ARCP_DEMO_TOKEN"] ?? "demo-token";
 
 async function main(): Promise<void> {
   const client = new ARCPClient({