Several guides and long-form recipes use APIs that do not exist in the current SDK. docs/guides/jobs.md:26 documents agent_version, resume_token, and resume_from_seq submit parameters that ARCPClient.submit does not accept, docs/guides/jobs.md:50 calls ctx.progress(0, 100) even though total is keyword-only, docs/guides/jobs.md:56 calls nonexistent ctx.report_cost, and docs/guides/jobs.md:88 calls nonexistent handle.cancel. docs/transports.md:40 imports ARCPMiddleware, docs/transports.md:51 imports arcp.transport.WebSocketClientTransport, and docs/transports.md:66 imports StdioClientTransport, but the current package exposes arcp.middleware.asgi.arcp_asgi_app, WebSocketTransport.connect, and StdioTransport. docs/recipes/mcp-skill.md:33 imports ARCPRuntime and JobContext from arcp, imports arcp.auth and arcp.transport, constructs ARCPRuntime(transport=..., auth=...), uses ctx.input_stream() and ctx.emit_event(), and reads event.kind and event.data; those names do not match the current public surface or event dictionaries.
Fix prompt: Audit docs/guides/*.md, docs/transports.md, and the narrative recipes for executable Python snippets, then rewrite them against the current APIs from arcp.client, arcp.runtime, arcp.middleware.asgi, WebSocketTransport, StdioTransport, JobContext, and JobHandle. Update event examples to use dictionaries yielded by handle.events() or the chunks() helper, document version pinning as agent="name@version", and replace old cost and lease examples with the current lease_request, LeaseConstraints, and ctx.metric behavior. Add a docs snippet test, even if it only imports and type-checks fenced Python blocks, so broken imports and missing methods are caught before release.
Several guides and long-form recipes use APIs that do not exist in the current SDK.
docs/guides/jobs.md:26documentsagent_version,resume_token, andresume_from_seqsubmit parameters thatARCPClient.submitdoes not accept,docs/guides/jobs.md:50callsctx.progress(0, 100)even thoughtotalis keyword-only,docs/guides/jobs.md:56calls nonexistentctx.report_cost, anddocs/guides/jobs.md:88calls nonexistenthandle.cancel.docs/transports.md:40importsARCPMiddleware,docs/transports.md:51importsarcp.transport.WebSocketClientTransport, anddocs/transports.md:66importsStdioClientTransport, but the current package exposesarcp.middleware.asgi.arcp_asgi_app,WebSocketTransport.connect, andStdioTransport.docs/recipes/mcp-skill.md:33importsARCPRuntimeandJobContextfromarcp, importsarcp.authandarcp.transport, constructsARCPRuntime(transport=..., auth=...), usesctx.input_stream()andctx.emit_event(), and readsevent.kindandevent.data; those names do not match the current public surface or event dictionaries.Fix prompt: Audit
docs/guides/*.md,docs/transports.md, and the narrative recipes for executable Python snippets, then rewrite them against the current APIs fromarcp.client,arcp.runtime,arcp.middleware.asgi,WebSocketTransport,StdioTransport,JobContext, andJobHandle. Update event examples to use dictionaries yielded byhandle.events()or thechunks()helper, document version pinning asagent="name@version", and replace old cost and lease examples with the currentlease_request,LeaseConstraints, andctx.metricbehavior. Add a docs snippet test, even if it only imports and type-checks fenced Python blocks, so broken imports and missing methods are caught before release.