@anthropic-ai/sdk 0.96.0 → 0.97.1

package/lib/environments/worker.mjs

@@ -0,0 +1,261 @@
+var _EnvironmentWorker_instances, _EnvironmentWorker_signal, _EnvironmentWorker_handleItem;
+import { __classPrivateFieldGet, __classPrivateFieldSet } from "../../internal/tslib.mjs";
+import { AnthropicError } from "../../core/error.mjs";
+import { loggerFor } from "../../internal/utils/log.mjs";
+import { readEnv } from "../../internal/utils/env.mjs";
+import { sleep } from "../../internal/utils/sleep.mjs";
+import { isFatal4xx, isStatus } from "../../internal/utils/backoff.mjs";
+import { linkAbort } from "../../internal/utils/abort.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { SessionToolRunner } from "../tools/SessionToolRunner.mjs";
+import { WorkPoller } from "./poller.mjs";
+import { copyClientForHelper } from "../helper-client.mjs";
+const HEARTBEAT_DEFAULT_MS = 30000;
+const NO_HEARTBEAT_SENTINEL = 'NO_HEARTBEAT';
+/**
+ * The self-hosted environment runner, composed from the control-plane
+ * {@link WorkPoller} and the per-session {@link SessionToolRunner}.
+ *
+ * For each claimed `session` work item it: builds the per-session
+ * {@link AgentToolContext}, downloads the session agent's skills
+ * (`setupSkills`), then runs a {@link SessionToolRunner} for the session
+ * *while* heartbeating the work-item lease in parallel; on exit it force-stops
+ * the work item, cleans up the downloaded skills, and loops to the next one. The
+ * lease heartbeat reports `state === "stopping"` / a lost lease back into the run
+ * by aborting the session runner.
+ *
+ * Use {@link EnvironmentWorker.handleItem} if you already hold a claimed work
+ * item (e.g. a `worker poll --on-work` script handed one to a fresh process) and
+ * just want the per-item flow without the poll loop — with no arguments it reads
+ * the `ANTHROPIC_*` env vars that command sets.
+ *
+ * Construct it via `client.beta.environments.work.worker({ ... })` (or
+ * `new EnvironmentWorker({ client, ... })` directly).
+ *
+ * @example
+ * ```ts
+ * // Long-running daemon: poll for work, serve each session, loop.
+ * await client.beta.environments.work
+ *   .worker({ environmentId, environmentKey, workdir: '/workspace' })
+ *   .run(AbortSignal.timeout(60 * 60_000));
+ *
+ * // Already-claimed item (e.g. inside `ant worker poll --on-work ...`):
+ * await client.beta.environments.work.worker({ workdir: '/workspace' }).handleItem();
+ * ```
+ */
+export class EnvironmentWorker {
+    constructor(opts) {
+        _EnvironmentWorker_instances.add(this);
+        _EnvironmentWorker_signal.set(this, void 0);
+        this.client = opts.client;
+        this.environmentId = opts.environmentId;
+        this.environmentKey = opts.environmentKey;
+        this.tools = opts.tools;
+        this.workdir = opts.workdir ?? process.cwd();
+        this.unrestrictedPaths = opts.unrestrictedPaths;
+        this.maxIdleMs = opts.maxIdleMs;
+        this.workerId = opts.workerId;
+        this.requestOptions = opts.requestOptions;
+        __classPrivateFieldSet(this, _EnvironmentWorker_signal, opts.signal, "f");
+    }
+    /**
+     * Poll the environment and service each claimed session until the supplied
+     * signal (or the one passed to the constructor) aborts. Throws if
+     * `environmentId` / `environmentKey` were not provided to the constructor.
+     */
+    async run(signal) {
+        const { environmentId, environmentKey } = this;
+        if (environmentId === undefined || environmentKey === undefined) {
+            throw new AnthropicError('EnvironmentWorker.run: environmentId and environmentKey are required to poll for work');
+        }
+        const externalSignal = signal ?? __classPrivateFieldGet(this, _EnvironmentWorker_signal, "f");
+        const poller = new WorkPoller({
+            client: this.client,
+            environmentId,
+            environmentKey,
+            ...(this.workerId !== undefined ? { workerId: this.workerId } : {}),
+            ...(externalSignal ? { signal: externalSignal } : {}),
+            ...(this.requestOptions !== undefined ? { requestOptions: this.requestOptions } : {}),
+            // The per-item handler force-stops every work item on exit; let it be the
+            // single owner of `work.stop` rather than double-posting from the poller.
+            autoStop: false,
+        });
+        for await (const work of poller) {
+            await __classPrivateFieldGet(this, _EnvironmentWorker_instances, "m", _EnvironmentWorker_handleItem).call(this, work, environmentKey, poller.signal);
+        }
+    }
+    /**
+     * Service a single, already-claimed work item without the poll loop: build the
+     * per-session {@link AgentToolContext} (workdir from this worker's options),
+     * download the session agent's skills (`setupSkills`), run a
+     * {@link SessionToolRunner} for the session while heartbeating the work-item
+     * lease in parallel, and force-stop the work item on exit (whether the runner
+     * finishes normally, throws, or the heartbeat loop signals shutdown).
+     *
+     * Use this when something else does the claiming — e.g. a `worker poll
+     * --on-work` script that hands an already-claimed item to a fresh process. The
+     * work id / environment id / session id each fall back to `ANTHROPIC_WORK_ID` /
+     * `ANTHROPIC_ENVIRONMENT_ID` / `ANTHROPIC_SESSION_ID` (the env vars that
+     * command sets) when not passed; the environment key resolves from this
+     * option, then the worker's own `environmentKey`, then
+     * `ANTHROPIC_ENVIRONMENT_KEY`. With no arguments inside that command it just
+     * works. Throws a clear error naming the first of the four required values
+     * still missing after resolution.
+     */
+    async handleItem(opts) {
+        const workId = opts?.workId ?? readEnv('ANTHROPIC_WORK_ID');
+        const environmentId = opts?.environmentId ?? readEnv('ANTHROPIC_ENVIRONMENT_ID');
+        const sessionId = opts?.sessionId ?? readEnv('ANTHROPIC_SESSION_ID');
+        const environmentKey = opts?.environmentKey ?? this.environmentKey ?? readEnv('ANTHROPIC_ENVIRONMENT_KEY');
+        if (!workId) {
+            throw new AnthropicError('handleItem: workId is required — pass it or set ANTHROPIC_WORK_ID');
+        }
+        if (!environmentId) {
+            throw new AnthropicError('handleItem: environmentId is required — pass it or set ANTHROPIC_ENVIRONMENT_ID');
+        }
+        if (!sessionId) {
+            throw new AnthropicError('handleItem: sessionId is required — pass it or set ANTHROPIC_SESSION_ID');
+        }
+        if (!environmentKey) {
+            throw new AnthropicError('handleItem: environmentKey is required — pass it, construct the worker with it, or set ANTHROPIC_ENVIRONMENT_KEY');
+        }
+        const work = {
+            id: workId,
+            environment_id: environmentId,
+            data: { type: 'session', id: sessionId },
+        };
+        await __classPrivateFieldGet(this, _EnvironmentWorker_instances, "m", _EnvironmentWorker_handleItem).call(this, work, environmentKey, opts?.signal ?? __classPrivateFieldGet(this, _EnvironmentWorker_signal, "f"));
+    }
+}
+_EnvironmentWorker_signal = new WeakMap(), _EnvironmentWorker_instances = new WeakSet(), _EnvironmentWorker_handleItem = 
+/**
+ * The per-item body shared by {@link EnvironmentWorker.run}'s poll loop and
+ * {@link EnvironmentWorker.handleItem}: run a {@link SessionToolRunner} for the
+ * work item's session while heartbeating its lease, force-stopping on exit.
+ * Non-session work items are ignored.
+ */
+async function _EnvironmentWorker_handleItem(work, environmentKey, externalSignal) {
+    const log = loggerFor(this.client);
+    // Every per-session call — the SessionToolRunner event stream/list/send, the
+    // lease heartbeat, and the work force-stop — authenticates with the
+    // environment key. Scope a client to it once and thread that through.
+    // `copyClientForHelper` also clears the parent's `apiKey`, so the sub-client
+    // emits *only* the bearer credential on the wire (a plain
+    // `withOptions({authToken})` would leave `X-Api-Key` set as well).
+    const sessionClient = copyClientForHelper(this.client, {
+        authToken: environmentKey,
+        helper: 'environments-worker',
+    });
+    // The poller runs with `autoStop: false`, so the per-item handler is the
+    // single owner of `work.stop` for every claimed item.
+    const sessionId = work.data.id;
+    const ctx = {
+        workdir: this.workdir,
+        client: this.client,
+        sessionId,
+        ...(this.unrestrictedPaths !== undefined ? { unrestrictedPaths: this.unrestrictedPaths } : {}),
+    };
+    // Lazily load the Node-only toolset module — see the import note at the top.
+    const agentToolset = await import("../../tools/agent-toolset/node.mjs");
+    let cleanupSkills = async () => { };
+    try {
+        cleanupSkills = await agentToolset.setupSkills(ctx);
+    }
+    catch (e) {
+        log.warn('skill setup failed', { session_id: sessionId, work_id: work.id, error: String(e) });
+    }
+    const tools = typeof this.tools === 'function' ?
+        this.tools(ctx)
+        : this.tools ?? agentToolset.betaAgentToolset20260401(ctx);
+    // A per-session controller: aborts when the supplied signal aborts, when the
+    // session runner finishes, or when the lease heartbeat says to stop.
+    const ctrl = new AbortController();
+    const detachExternal = linkAbort(externalSignal, ctrl);
+    const heartbeatPromise = heartbeatLoop(sessionClient, work, ctrl, log, this.requestOptions).catch((e) => {
+        if (!ctrl.signal.aborted)
+            log.error('heartbeat loop failed', { work_id: work.id, error: String(e) });
+        ctrl.abort();
+    });
+    try {
+        const runner = new SessionToolRunner(sessionId, {
+            client: sessionClient,
+            tools,
+            ...(this.maxIdleMs !== undefined ? { maxIdleMs: this.maxIdleMs } : {}),
+            ...(this.requestOptions !== undefined ? { requestOptions: this.requestOptions } : {}),
+            signal: ctrl.signal,
+        });
+        for await (const _ of runner) {
+            // Drive the runner to completion; per-call observability is not part
+            // of this composition's surface — use `SessionToolRunner` directly
+            // (via `client.beta.sessions.events.toolRunner`) if you want it.
+        }
+    }
+    finally {
+        ctrl.abort();
+        detachExternal();
+        await heartbeatPromise;
+        await cleanupSkills().catch((e) => {
+            log.warn('skill cleanup failed', { session_id: sessionId, work_id: work.id, error: String(e) });
+        });
+        await forceStop(sessionClient, work, log, this.requestOptions);
+    }
+};
+/** Force-stop a claimed work item, swallowing the 409 that means it's already stopped. */
+async function forceStop(client, work, log, requestOptions) {
+    try {
+        await client.beta.environments.work.stop(work.id, { environment_id: work.environment_id, force: true }, 
+        // Caller's headers pass through; the helper-tag header is on the scoped
+        // sub-client's default_headers via copyClientForHelper, so no per-call
+        // re-stamping needed.
+        { ...requestOptions, headers: buildHeaders([requestOptions?.headers]) });
+    }
+    catch (e) {
+        if (!isStatus(e, 409)) {
+            log.error('force-stop on exit failed', { work_id: work.id, error: String(e) });
+        }
+    }
+}
+/**
+ * Keep the work-item lease alive while a session is being served. Aborts `ctrl`
+ * when the control plane reports the work is `stopping`/`stopped`, when the
+ * lease is no longer extended, or on a permanent heartbeat failure.
+ */
+async function heartbeatLoop(client, work, ctrl, logger, requestOptions) {
+    let intervalMs = HEARTBEAT_DEFAULT_MS;
+    let last = NO_HEARTBEAT_SENTINEL;
+    const beat = async () => {
+        try {
+            const resp = await client.beta.environments.work.heartbeat(work.id, { environment_id: work.environment_id, expected_last_heartbeat: last }, { ...requestOptions, headers: buildHeaders([requestOptions?.headers]), signal: ctrl.signal });
+            last = resp.last_heartbeat;
+            if (resp.ttl_seconds > 0) {
+                intervalMs = Math.max(1000, Math.min((resp.ttl_seconds * 1000) / 2, HEARTBEAT_DEFAULT_MS));
+            }
+            if (resp.state === 'stopping' || resp.state === 'stopped') {
+                logger.info('heartbeat signals shutdown', { work_id: work.id, state: resp.state });
+                ctrl.abort();
+            }
+            if (!resp.lease_extended) {
+                logger.warn('lease not extended, shutting down', { work_id: work.id });
+                ctrl.abort();
+            }
+        }
+        catch (e) {
+            // An abort throws to unwind the caller (the `heartbeatLoop(...).catch`
+            // in `#handleItem`) rather than returning early.
+            ctrl.signal.throwIfAborted();
+            if (isFatal4xx(e)) {
+                logger.error('permanent heartbeat failure', { work_id: work.id, error: String(e) });
+                ctrl.abort();
+                throw e;
+            }
+            logger.warn('transient heartbeat failure', { work_id: work.id, error: String(e) });
+        }
+    };
+    await beat();
+    while (!ctrl.signal.aborted) {
+        await sleep(intervalMs, ctrl.signal);
+        ctrl.signal.throwIfAborted();
+        await beat();
+    }
+}
+//# sourceMappingURL=worker.mjs.map

package/lib/environments/worker.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.mjs","sourceRoot":"","sources":["../../src/lib/environments/worker.ts"],"names":[],"mappings":"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"}

package/lib/helper-client.d.mts

@@ -0,0 +1,49 @@
+import type { Anthropic } from "../client.mjs";
+/**
+ * Shared util for building a runner-helper-bound sub-client.
+ *
+ * The work poller, the environment worker, and the session tool runner each
+ * need to issue requests authenticated by a per-helper credential (a
+ * self-hosted environment key, today) rather than the parent client's own
+ * `X-Api-Key`, *and* tagged with their own `x-stainless-helper` telemetry
+ * value. Each wants to inherit the parent's full configuration — `timeout`,
+ * `maxRetries`, `fetch`, `fetchOptions`, custom `defaultHeaders`,
+ * `defaultQuery` — and override only the auth + telemetry bits.
+ *
+ * {@link copyClientForHelper} is the one shared construction.
+ */
+/**
+ * The closed set of `x-stainless-helper` telemetry tags the runner helpers
+ * stamp on outgoing requests. Constrained as a string union so a typo at any
+ * call site is a type error rather than silently mistagged telemetry.
+ */
+export type HelperTag = 'environments-work-poller' | 'environments-worker' | 'session-tool-runner';
+/**
+ * Return a `withOptions()` clone of `client` set up for use *by* one of the
+ * runner helpers: authenticated with `authToken` as Bearer credentials, with
+ * the parent's `X-Api-Key` cleared, and tagged with the helper's
+ * `x-stainless-helper` value on every outgoing request.
+ *
+ * The returned sub-client inherits the parent's full configuration
+ * (`baseURL`, `timeout`, `maxRetries`, `fetch`, `fetchOptions`, custom
+ * `defaultHeaders`, `defaultQuery`). Overrides applied:
+ *
+ * - `authToken: authToken` — the new credential.
+ * - `apiKey: null` — the parent's `X-Api-Key` is cleared. `withOptions`
+ *   inherits the parent's `apiKey` by default; without this, both
+ *   `X-Api-Key` *and* `Authorization: Bearer …` would land on the wire.
+ *   `client.ts` only triggers the env-var fallback when `apiKey === undefined`,
+ *   so explicit `null` is honored.
+ * - `credentials: undefined` — opts the clone out of any inherited
+ *   credentials/config/profile so the explicit bearer is the unambiguous auth.
+ * - `baseURL: client.baseURL` — pins the parent's resolved host (auth override otherwise resets it).
+ * - `defaultHeaders` is rebuilt as `parent._authState.extraHeaders ⊕ parent.defaultHeaders ⊕
+ *   {'x-stainless-helper': helper}`. `withOptions` *replaces* (does not
+ *   merge) `defaultHeaders`, so we merge here so any custom headers the
+ *   caller set on the parent client survive on the sub-client.
+ */
+export declare function copyClientForHelper<T extends Anthropic>(client: T, { authToken, helper }: {
+    authToken: string;
+    helper: HelperTag;
+}): T;
+//# sourceMappingURL=helper-client.d.mts.map

package/lib/helper-client.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-client.d.mts","sourceRoot":"","sources":["../src/lib/helper-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAkB;AAG3C;;;;;;;;;;;;GAYG;AAEH;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,0BAA0B,GAAG,qBAAqB,GAAG,qBAAqB,CAAC;AAOnG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,SAAS,EACrD,MAAM,EAAE,CAAC,EACT,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAC9D,CAAC,CA+BH"}

package/lib/helper-client.d.ts

@@ -0,0 +1,49 @@
+import type { Anthropic } from "../client.js";
+/**
+ * Shared util for building a runner-helper-bound sub-client.
+ *
+ * The work poller, the environment worker, and the session tool runner each
+ * need to issue requests authenticated by a per-helper credential (a
+ * self-hosted environment key, today) rather than the parent client's own
+ * `X-Api-Key`, *and* tagged with their own `x-stainless-helper` telemetry
+ * value. Each wants to inherit the parent's full configuration — `timeout`,
+ * `maxRetries`, `fetch`, `fetchOptions`, custom `defaultHeaders`,
+ * `defaultQuery` — and override only the auth + telemetry bits.
+ *
+ * {@link copyClientForHelper} is the one shared construction.
+ */
+/**
+ * The closed set of `x-stainless-helper` telemetry tags the runner helpers
+ * stamp on outgoing requests. Constrained as a string union so a typo at any
+ * call site is a type error rather than silently mistagged telemetry.
+ */
+export type HelperTag = 'environments-work-poller' | 'environments-worker' | 'session-tool-runner';
+/**
+ * Return a `withOptions()` clone of `client` set up for use *by* one of the
+ * runner helpers: authenticated with `authToken` as Bearer credentials, with
+ * the parent's `X-Api-Key` cleared, and tagged with the helper's
+ * `x-stainless-helper` value on every outgoing request.
+ *
+ * The returned sub-client inherits the parent's full configuration
+ * (`baseURL`, `timeout`, `maxRetries`, `fetch`, `fetchOptions`, custom
+ * `defaultHeaders`, `defaultQuery`). Overrides applied:
+ *
+ * - `authToken: authToken` — the new credential.
+ * - `apiKey: null` — the parent's `X-Api-Key` is cleared. `withOptions`
+ *   inherits the parent's `apiKey` by default; without this, both
+ *   `X-Api-Key` *and* `Authorization: Bearer …` would land on the wire.
+ *   `client.ts` only triggers the env-var fallback when `apiKey === undefined`,
+ *   so explicit `null` is honored.
+ * - `credentials: undefined` — opts the clone out of any inherited
+ *   credentials/config/profile so the explicit bearer is the unambiguous auth.
+ * - `baseURL: client.baseURL` — pins the parent's resolved host (auth override otherwise resets it).
+ * - `defaultHeaders` is rebuilt as `parent._authState.extraHeaders ⊕ parent.defaultHeaders ⊕
+ *   {'x-stainless-helper': helper}`. `withOptions` *replaces* (does not
+ *   merge) `defaultHeaders`, so we merge here so any custom headers the
+ *   caller set on the parent client survive on the sub-client.
+ */
+export declare function copyClientForHelper<T extends Anthropic>(client: T, { authToken, helper }: {
+    authToken: string;
+    helper: HelperTag;
+}): T;
+//# sourceMappingURL=helper-client.d.ts.map

package/lib/helper-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-client.d.ts","sourceRoot":"","sources":["../src/lib/helper-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,qBAAkB;AAG3C;;;;;;;;;;;;GAYG;AAEH;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,0BAA0B,GAAG,qBAAqB,GAAG,qBAAqB,CAAC;AAOnG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,SAAS,EACrD,MAAM,EAAE,CAAC,EACT,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAC9D,CAAC,CA+BH"}

package/lib/helper-client.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyClientForHelper = copyClientForHelper;
+const error_1 = require("../core/error.js");
+const headers_1 = require("../internal/headers.js");
+/**
+ * Return a `withOptions()` clone of `client` set up for use *by* one of the
+ * runner helpers: authenticated with `authToken` as Bearer credentials, with
+ * the parent's `X-Api-Key` cleared, and tagged with the helper's
+ * `x-stainless-helper` value on every outgoing request.
+ *
+ * The returned sub-client inherits the parent's full configuration
+ * (`baseURL`, `timeout`, `maxRetries`, `fetch`, `fetchOptions`, custom
+ * `defaultHeaders`, `defaultQuery`). Overrides applied:
+ *
+ * - `authToken: authToken` — the new credential.
+ * - `apiKey: null` — the parent's `X-Api-Key` is cleared. `withOptions`
+ *   inherits the parent's `apiKey` by default; without this, both
+ *   `X-Api-Key` *and* `Authorization: Bearer …` would land on the wire.
+ *   `client.ts` only triggers the env-var fallback when `apiKey === undefined`,
+ *   so explicit `null` is honored.
+ * - `credentials: undefined` — opts the clone out of any inherited
+ *   credentials/config/profile so the explicit bearer is the unambiguous auth.
+ * - `baseURL: client.baseURL` — pins the parent's resolved host (auth override otherwise resets it).
+ * - `defaultHeaders` is rebuilt as `parent._authState.extraHeaders ⊕ parent.defaultHeaders ⊕
+ *   {'x-stainless-helper': helper}`. `withOptions` *replaces* (does not
+ *   merge) `defaultHeaders`, so we merge here so any custom headers the
+ *   caller set on the parent client survive on the sub-client.
+ */
+function copyClientForHelper(client, { authToken, helper }) {
+    if (!authToken) {
+        throw new error_1.AnthropicError(`copyClientForHelper: expected a non-empty authToken but received ${JSON.stringify(authToken)}`);
+    }
+    const internal = client;
+    const parentDefaults = internal._options.defaultHeaders;
+    // Carry the parent's credential/profile headers; strip the auth ones (we re-auth below).
+    const parentAuthExtraHeaders = internal._authState?.extraHeaders;
+    const inheritedAuthExtraHeaders = parentAuthExtraHeaders ?
+        Object.fromEntries(Object.entries(parentAuthExtraHeaders).filter(([name]) => {
+            const lower = name.toLowerCase();
+            return lower !== 'authorization' && lower !== 'x-api-key';
+        }))
+        : undefined;
+    const defaultHeaders = (0, headers_1.buildHeaders)([
+        inheritedAuthExtraHeaders,
+        parentDefaults,
+        { 'x-stainless-helper': helper },
+    ]);
+    return client.withOptions({
+        apiKey: null,
+        authToken,
+        baseURL: client.baseURL,
+        credentials: undefined,
+        defaultHeaders,
+    });
+}
+//# sourceMappingURL=helper-client.js.map

package/lib/helper-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-client.js","sourceRoot":"","sources":["../src/lib/helper-client.ts"],"names":[],"mappings":";;AAsDA,kDAkCC;AAxFD,4CAA+C;AAE/C,oDAA2F;AA4B3F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,mBAAmB,CACjC,MAAS,EACT,EAAE,SAAS,EAAE,MAAM,EAA4C;IAE/D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,sBAAc,CACtB,oEAAoE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAChG,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAyC,CAAC;IAC3D,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC;IACxD,yFAAyF;IACzF,MAAM,sBAAsB,GAAG,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IACjE,MAAM,yBAAyB,GAC7B,sBAAsB,CAAC,CAAC;QACtB,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE;YACvD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,OAAO,KAAK,KAAK,eAAe,IAAI,KAAK,KAAK,WAAW,CAAC;QAC5D,CAAC,CAAC,CACH;QACH,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,cAAc,GAAoB,IAAA,sBAAY,EAAC;QACnD,yBAAyB;QACzB,cAAc;QACd,EAAE,oBAAoB,EAAE,MAAM,EAAE;KACjC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,WAAW,CAAC;QACxB,MAAM,EAAE,IAAI;QACZ,SAAS;QACT,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,SAAS;QACtB,cAAc;KACf,CAAM,CAAC;AACV,CAAC"}

package/lib/helper-client.mjs

@@ -0,0 +1,54 @@
+import { AnthropicError } from "../core/error.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+/**
+ * Return a `withOptions()` clone of `client` set up for use *by* one of the
+ * runner helpers: authenticated with `authToken` as Bearer credentials, with
+ * the parent's `X-Api-Key` cleared, and tagged with the helper's
+ * `x-stainless-helper` value on every outgoing request.
+ *
+ * The returned sub-client inherits the parent's full configuration
+ * (`baseURL`, `timeout`, `maxRetries`, `fetch`, `fetchOptions`, custom
+ * `defaultHeaders`, `defaultQuery`). Overrides applied:
+ *
+ * - `authToken: authToken` — the new credential.
+ * - `apiKey: null` — the parent's `X-Api-Key` is cleared. `withOptions`
+ *   inherits the parent's `apiKey` by default; without this, both
+ *   `X-Api-Key` *and* `Authorization: Bearer …` would land on the wire.
+ *   `client.ts` only triggers the env-var fallback when `apiKey === undefined`,
+ *   so explicit `null` is honored.
+ * - `credentials: undefined` — opts the clone out of any inherited
+ *   credentials/config/profile so the explicit bearer is the unambiguous auth.
+ * - `baseURL: client.baseURL` — pins the parent's resolved host (auth override otherwise resets it).
+ * - `defaultHeaders` is rebuilt as `parent._authState.extraHeaders ⊕ parent.defaultHeaders ⊕
+ *   {'x-stainless-helper': helper}`. `withOptions` *replaces* (does not
+ *   merge) `defaultHeaders`, so we merge here so any custom headers the
+ *   caller set on the parent client survive on the sub-client.
+ */
+export function copyClientForHelper(client, { authToken, helper }) {
+    if (!authToken) {
+        throw new AnthropicError(`copyClientForHelper: expected a non-empty authToken but received ${JSON.stringify(authToken)}`);
+    }
+    const internal = client;
+    const parentDefaults = internal._options.defaultHeaders;
+    // Carry the parent's credential/profile headers; strip the auth ones (we re-auth below).
+    const parentAuthExtraHeaders = internal._authState?.extraHeaders;
+    const inheritedAuthExtraHeaders = parentAuthExtraHeaders ?
+        Object.fromEntries(Object.entries(parentAuthExtraHeaders).filter(([name]) => {
+            const lower = name.toLowerCase();
+            return lower !== 'authorization' && lower !== 'x-api-key';
+        }))
+        : undefined;
+    const defaultHeaders = buildHeaders([
+        inheritedAuthExtraHeaders,
+        parentDefaults,
+        { 'x-stainless-helper': helper },
+    ]);
+    return client.withOptions({
+        apiKey: null,
+        authToken,
+        baseURL: client.baseURL,
+        credentials: undefined,
+        defaultHeaders,
+    });
+}
+//# sourceMappingURL=helper-client.mjs.map

package/lib/helper-client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-client.mjs","sourceRoot":"","sources":["../src/lib/helper-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,0BAAsB;AAE/C,OAAO,EAAE,YAAY,EAA0C,gCAA4B;AA4B3F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAS,EACT,EAAE,SAAS,EAAE,MAAM,EAA4C;IAE/D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,cAAc,CACtB,oEAAoE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAChG,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAyC,CAAC;IAC3D,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC;IACxD,yFAAyF;IACzF,MAAM,sBAAsB,GAAG,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IACjE,MAAM,yBAAyB,GAC7B,sBAAsB,CAAC,CAAC;QACtB,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE;YACvD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,OAAO,KAAK,KAAK,eAAe,IAAI,KAAK,KAAK,WAAW,CAAC;QAC5D,CAAC,CAAC,CACH;QACH,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,cAAc,GAAoB,YAAY,CAAC;QACnD,yBAAyB;QACzB,cAAc;QACd,EAAE,oBAAoB,EAAE,MAAM,EAAE;KACjC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,WAAW,CAAC;QACxB,MAAM,EAAE,IAAI;QACZ,SAAS;QACT,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,SAAS;QACtB,cAAc;KACf,CAAM,CAAC;AACV,CAAC"}

package/lib/parser.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.mts","sourceRoot":"","sources":["../src/lib/parser.ts"],"names":[],"mappings":"OAAO,KAAK,EAAE,MAAM,EAAE;OAEf,EACL,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,SAAS,EACT,mBAAmB,EACpB;AAGD,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;CAAE,GAAG,EAAE,CAAC;AAE7D,KAAK,yBAAyB,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG;IAC9D,MAAM,CAAC,EAAE,gBAAgB,GAAG,yBAAyB,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CACjD,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,GAAG;IAC3C,aAAa,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAClD,CACF,CAAC;AAEF,MAAM,MAAM,8BAA8B,CAAC,MAAM,SAAS,4BAA4B,IACpF,MAAM,CAAC,eAAe,CAAC,SAAS;IAAE,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,IAAI,CAAC;AAE5F,MAAM,MAAM,yBAAyB,CAAC,OAAO,IAAI,gBAAgB,GAAG;IAClE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,OAAO,IAAI,OAAO,GAAG;IAC7C,OAAO,EAAE,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,OAAO,IAClC,CAAC,SAAS,GAAG;IAAE,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,CAAC,GAC/C,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AAQrC,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,4BAA4B,GAAG,IAAI,EAClF,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACvB,aAAa,CAAC,8BAA8B,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAqBpE;AAED,wBAAgB,YAAY,CAAC,MAAM,SAAS,4BAA4B,EACtE,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACvB,aAAa,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,CA2BvD"}
+{"version":3,"file":"parser.d.mts","sourceRoot":"","sources":["../src/lib/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,sBAAkB;AAExC,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,SAAS,EACT,mBAAmB,EACpB,2CAAuC;AAGxC,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;CAAE,GAAG,EAAE,CAAC;AAE7D,KAAK,yBAAyB,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG;IAC9D,MAAM,CAAC,EAAE,gBAAgB,GAAG,yBAAyB,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CACjD,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,GAAG;IAC3C,aAAa,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAClD,CACF,CAAC;AAEF,MAAM,MAAM,8BAA8B,CAAC,MAAM,SAAS,4BAA4B,IACpF,MAAM,CAAC,eAAe,CAAC,SAAS;IAAE,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,IAAI,CAAC;AAE5F,MAAM,MAAM,yBAAyB,CAAC,OAAO,IAAI,gBAAgB,GAAG;IAClE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,OAAO,IAAI,OAAO,GAAG;IAC7C,OAAO,EAAE,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,OAAO,IAClC,CAAC,SAAS,GAAG;IAAE,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,CAAC,GAC/C,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AAQrC,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,4BAA4B,GAAG,IAAI,EAClF,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACvB,aAAa,CAAC,8BAA8B,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAqBpE;AAED,wBAAgB,YAAY,CAAC,MAAM,SAAS,4BAA4B,EACtE,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACvB,aAAa,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,CA2BvD"}

package/lib/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/lib/parser.ts"],"names":[],"mappings":"OAAO,KAAK,EAAE,MAAM,EAAE;OAEf,EACL,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,SAAS,EACT,mBAAmB,EACpB;AAGD,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;CAAE,GAAG,EAAE,CAAC;AAE7D,KAAK,yBAAyB,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG;IAC9D,MAAM,CAAC,EAAE,gBAAgB,GAAG,yBAAyB,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CACjD,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,GAAG;IAC3C,aAAa,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAClD,CACF,CAAC;AAEF,MAAM,MAAM,8BAA8B,CAAC,MAAM,SAAS,4BAA4B,IACpF,MAAM,CAAC,eAAe,CAAC,SAAS;IAAE,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,IAAI,CAAC;AAE5F,MAAM,MAAM,yBAAyB,CAAC,OAAO,IAAI,gBAAgB,GAAG;IAClE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,OAAO,IAAI,OAAO,GAAG;IAC7C,OAAO,EAAE,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,OAAO,IAClC,CAAC,SAAS,GAAG;IAAE,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,CAAC,GAC/C,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AAQrC,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,4BAA4B,GAAG,IAAI,EAClF,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACvB,aAAa,CAAC,8BAA8B,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAqBpE;AAED,wBAAgB,YAAY,CAAC,MAAM,SAAS,4BAA4B,EACtE,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACvB,aAAa,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,CA2BvD"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/lib/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,qBAAkB;AAExC,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,SAAS,EACT,mBAAmB,EACpB,0CAAuC;AAGxC,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;CAAE,GAAG,EAAE,CAAC;AAE7D,KAAK,yBAAyB,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG;IAC9D,MAAM,CAAC,EAAE,gBAAgB,GAAG,yBAAyB,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CACjD,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,GAAG;IAC3C,aAAa,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAClD,CACF,CAAC;AAEF,MAAM,MAAM,8BAA8B,CAAC,MAAM,SAAS,4BAA4B,IACpF,MAAM,CAAC,eAAe,CAAC,SAAS;IAAE,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,IAAI,CAAC;AAE5F,MAAM,MAAM,yBAAyB,CAAC,OAAO,IAAI,gBAAgB,GAAG;IAClE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,OAAO,IAAI,OAAO,GAAG;IAC7C,OAAO,EAAE,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,OAAO,IAClC,CAAC,SAAS,GAAG;IAAE,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,CAAC,GAC/C,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AAQrC,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,4BAA4B,GAAG,IAAI,EAClF,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACvB,aAAa,CAAC,8BAA8B,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAqBpE;AAED,wBAAgB,YAAY,CAAC,MAAM,SAAS,4BAA4B,EACtE,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACvB,aAAa,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,CA2BvD"}

package/lib/parser.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"parser.mjs","sourceRoot":"","sources":["../src/lib/parser.ts"],"names":[],"mappings":"OACO,EAAE,cAAc,EAAE;AAuCzB,SAAS,eAAe,CACtB,MAA2C;IAE3C,OAAO,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAgB,EAChB,MAAc,EACd,IAAwB;IAExB,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAClD,OAAO;YACL,GAAG,OAAO;YACV,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBACrC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC1B,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,EAAE;wBACvE,KAAK,EAAE,IAAI;wBACX,UAAU,EAAE,KAAK;qBAClB,CAA4E,CAAC;oBAE9E,OAAO,WAAW,CAAC;gBACrB,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC,CAAC;YACF,aAAa,EAAE,IAAI;SACkD,CAAC;IAC1E,CAAC;IAED,OAAO,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,OAAgB,EAChB,MAAc,EACd,IAAwB;IAExB,IAAI,iBAAiB,GAAwD,IAAI,CAAC;IAElF,MAAM,OAAO,GAAsE,OAAO,CAAC,OAAO,CAAC,GAAG,CACpG,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAE3D,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;gBAC/B,iBAAiB,GAAG,YAAY,CAAC;YACnC,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,EAAE;gBACvE,KAAK,EAAE,YAAY;gBACnB,UAAU,EAAE,KAAK;aAClB,CAA+D,CAAC;YACjE,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CACF,CAAC;IAEF,OAAO;QACL,GAAG,OAAO;QACV,OAAO;QACP,aAAa,EAAE,iBAAiB;KACwB,CAAC;AAC7D,CAAC;AAED,SAAS,iBAAiB,CACxB,MAAc,EACd,OAAe;IAEf,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,YAAY,EAAE,IAAI,KAAK,aAAa,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,IAAI,OAAO,IAAI,YAAY,EAAE,CAAC;YAC5B,OAAO,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,cAAc,CAAC,sCAAsC,KAAK,EAAE,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}
+{"version":3,"file":"parser.mjs","sourceRoot":"","sources":["../src/lib/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,0BAAsB;AAuC/C,SAAS,eAAe,CACtB,MAA2C;IAE3C,OAAO,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAgB,EAChB,MAAc,EACd,IAAwB;IAExB,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAClD,OAAO;YACL,GAAG,OAAO;YACV,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBACrC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC1B,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,EAAE;wBACvE,KAAK,EAAE,IAAI;wBACX,UAAU,EAAE,KAAK;qBAClB,CAA4E,CAAC;oBAE9E,OAAO,WAAW,CAAC;gBACrB,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC,CAAC;YACF,aAAa,EAAE,IAAI;SACkD,CAAC;IAC1E,CAAC;IAED,OAAO,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,OAAgB,EAChB,MAAc,EACd,IAAwB;IAExB,IAAI,iBAAiB,GAAwD,IAAI,CAAC;IAElF,MAAM,OAAO,GAAsE,OAAO,CAAC,OAAO,CAAC,GAAG,CACpG,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAE3D,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;gBAC/B,iBAAiB,GAAG,YAAY,CAAC;YACnC,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,EAAE;gBACvE,KAAK,EAAE,YAAY;gBACnB,UAAU,EAAE,KAAK;aAClB,CAA+D,CAAC;YACjE,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CACF,CAAC;IAEF,OAAO;QACL,GAAG,OAAO;QACV,OAAO;QACP,aAAa,EAAE,iBAAiB;KACwB,CAAC;AAC7D,CAAC;AAED,SAAS,iBAAiB,CACxB,MAAc,EACd,OAAe;IAEf,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,YAAY,EAAE,IAAI,KAAK,aAAa,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,IAAI,OAAO,IAAI,YAAY,EAAE,CAAC;YAC5B,OAAO,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,cAAc,CAAC,sCAAsC,KAAK,EAAE,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/lib/stainless-helper-header.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"stainless-helper-header.d.mts","sourceRoot":"","sources":["../src/lib/stainless-helper-header.ts"],"names":[],"mappings":"AAAA;;GAEG;OAEI,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE;AAE/C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,eAA0C,CAAC;AAEzE,KAAK,qBAAqB,GAAG;IAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAE1F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,EAClC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,GACvC,MAAM,EAAE,CA8BV;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,EAClC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,GACvC;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,CAInC;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,CAK9F"}
+{"version":3,"file":"stainless-helper-header.d.mts","sourceRoot":"","sources":["../src/lib/stainless-helper-header.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,8BAA0B;AAEzE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,eAA0C,CAAC;AAEzE,KAAK,qBAAqB,GAAG;IAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAE1F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,EAClC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,GACvC,MAAM,EAAE,CA8BV;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,EAClC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,GACvC;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,CAInC;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,CAK9F"}

package/lib/stainless-helper-header.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stainless-helper-header.d.ts","sourceRoot":"","sources":["../src/lib/stainless-helper-header.ts"],"names":[],"mappings":"AAAA;;GAEG;OAEI,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE;AAE/C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,eAA0C,CAAC;AAEzE,KAAK,qBAAqB,GAAG;IAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAE1F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,EAClC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,GACvC,MAAM,EAAE,CA8BV;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,EAClC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,GACvC;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,CAInC;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,CAK9F"}
+{"version":3,"file":"stainless-helper-header.d.ts","sourceRoot":"","sources":["../src/lib/stainless-helper-header.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,6BAA0B;AAEzE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,eAA0C,CAAC;AAEzE,KAAK,qBAAqB,GAAG;IAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAE1F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,EAClC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,GACvC,MAAM,EAAE,CA8BV;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,EAClC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,GACvC;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,CAInC;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,CAK9F"}

package/lib/tools/BetaRunnableTool.d.mts

@@ -1,16 +1,68 @@
-import { BetaMemoryTool20250818, BetaTool, BetaToolBash20241022, BetaToolBash20250124, BetaToolComputerUse20241022, BetaToolComputerUse20250124, BetaToolComputerUse20251124, BetaToolResultContentBlockParam, BetaToolTextEditor20241022, BetaToolTextEditor20250124, BetaToolTextEditor20250429, BetaToolTextEditor20250728, BetaToolUseBlock } from "../../resources/beta.mjs";
+import { BetaMemoryTool20250818, BetaTool, BetaToolBash20241022, BetaToolBash20250124, BetaToolComputerUse20241022, BetaToolComputerUse20250124, BetaToolComputerUse20251124, BetaToolResultContentBlockParam, BetaToolTextEditor20241022, BetaToolTextEditor20250124, BetaToolTextEditor20250429, BetaToolTextEditor20250728, BetaToolUnion, BetaToolUseBlock } from "../../resources/beta.mjs";
+import type { BetaManagedAgentsAgentCustomToolUseEvent, BetaManagedAgentsAgentToolUseEvent } from "../../resources/beta/sessions/events.mjs";
 export type Promisable<T> = T | Promise<T>;
 /**
  * Tool types that can be implemented on the client.
  * Excludes server-side tools like code execution, web search, and MCP toolsets.
  */
 export type BetaClientRunnableToolType = BetaTool | BetaMemoryTool20250818 | BetaToolBash20241022 | BetaToolBash20250124 | BetaToolComputerUse20241022 | BetaToolComputerUse20250124 | BetaToolComputerUse20251124 | BetaToolTextEditor20241022 | BetaToolTextEditor20250124 | BetaToolTextEditor20250429 | BetaToolTextEditor20250728;
+/**
+ * The tool-use that triggered a {@link BetaRunnableTool.run}:
+ *
+ * - from `client.beta.messages.toolRunner`, a Messages `tool_use` content block;
+ * - from `client.beta.sessions.events.toolRunner`, the `agent.tool_use` /
+ *   `agent.custom_tool_use` session event.
+ *
+ * The shapes overlap on the common fields (`id`, `name`, `input`), so code that
+ * only reads those works without narrowing; narrow on the shape (e.g. `'type' in
+ * x`) when you need surface-specific properties.
+ */
+export type BetaToolUse = BetaToolUseBlock | BetaManagedAgentsAgentToolUseEvent | BetaManagedAgentsAgentCustomToolUseEvent;
 export type BetaToolRunContext = {
-    toolUseBlock: BetaToolUseBlock;
+    /** The tool-use that triggered this run. See {@link BetaToolUse}. */
+    toolUse: BetaToolUse;
+    /**
+     * @deprecated Renamed to `toolUse`. Also note that for
+     * `client.beta.sessions.events.toolRunner` this is the `agent.tool_use` /
+     * `agent.custom_tool_use` *event*, not a Messages content block, despite the
+     * name — which is why it was renamed.
+     */
+    toolUseBlock: BetaToolUse;
     signal?: AbortSignal | null | undefined;
 };
 export type BetaRunnableTool<Input = any> = BetaClientRunnableToolType & {
     run: (args: Input, context?: BetaToolRunContext) => Promisable<string | Array<BetaToolResultContentBlockParam>>;
     parse: (content: unknown) => Input;
+    /**
+     * Optional cleanup hook for tools that hold process-level resources (e.g. a
+     * persistent shell). `SessionToolRunner` (`client.beta.sessions.events.toolRunner`)
+     * calls it once when iteration ends.
+     */
+    close?: () => Promisable<void>;
 };
+/**
+ * Resolve the registry key for a tool — the name the model addresses it by.
+ * MCP toolsets are keyed on `mcp_server_name`; every other tool on `name`.
+ * Shared so the tool-name lookup is identical across `toolRunner()` surfaces.
+ */
+export declare function toolName(tool: BetaToolUnion | BetaRunnableTool): string;
+/**
+ * Format a thrown value into tool-result content: a {@link ToolError} carries
+ * its own structured content, anything else becomes an `Error: <message>`
+ * string. Shared so every `toolRunner()` surface reports tool failures the
+ * same way to the model.
+ */
+export declare function toolErrorContent(e: unknown): string | Array<BetaToolResultContentBlockParam>;
+/** Outcome of {@link runRunnableTool}: the content to post back and whether it is an error. */
+export interface RunnableToolOutcome {
+    content: string | Array<BetaToolResultContentBlockParam>;
+    isError: boolean;
+}
+/**
+ * Run a {@link BetaRunnableTool} end-to-end: parse the raw input, invoke `run`,
+ * and format any thrown value via {@link toolErrorContent}. Shared so the
+ * parse → run → catch → format pipeline is identical across `toolRunner()`
+ * surfaces.
+ */
+export declare function runRunnableTool(tool: BetaRunnableTool, rawInput: unknown, context: BetaToolRunContext): Promise<RunnableToolOutcome>;
 //# sourceMappingURL=BetaRunnableTool.d.mts.map

package/lib/tools/BetaRunnableTool.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"BetaRunnableTool.d.mts","sourceRoot":"","sources":["../../src/lib/tools/BetaRunnableTool.ts"],"names":[],"mappings":"OAAO,EACL,sBAAsB,EACtB,QAAQ,EACR,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,+BAA+B,EAC/B,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,gBAAgB,EACjB;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAClC,QAAQ,GACR,sBAAsB,GACtB,oBAAoB,GACpB,oBAAoB,GACpB,2BAA2B,GAC3B,2BAA2B,GAC3B,2BAA2B,GAC3B,0BAA0B,GAC1B,0BAA0B,GAC1B,0BAA0B,GAC1B,0BAA0B,CAAC;AAE/B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;CACzC,CAAC;AAIF,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,GAAG,IAAI,0BAA0B,GAAG;IACvE,GAAG,EAAE,CACH,IAAI,EAAE,KAAK,EACX,OAAO,CAAC,EAAE,kBAAkB,KACzB,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;IACjE,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,KAAK,CAAC;CACpC,CAAC"}
+{"version":3,"file":"BetaRunnableTool.d.mts","sourceRoot":"","sources":["../../src/lib/tools/BetaRunnableTool.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,QAAQ,EACR,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,+BAA+B,EAC/B,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,aAAa,EACb,gBAAgB,EACjB,iCAA6B;AAC9B,OAAO,KAAK,EACV,wCAAwC,EACxC,kCAAkC,EACnC,iDAA6C;AAG9C,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAClC,QAAQ,GACR,sBAAsB,GACtB,oBAAoB,GACpB,oBAAoB,GACpB,2BAA2B,GAC3B,2BAA2B,GAC3B,2BAA2B,GAC3B,0BAA0B,GAC1B,0BAA0B,GAC1B,0BAA0B,GAC1B,0BAA0B,CAAC;AAE/B;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GACnB,gBAAgB,GAChB,kCAAkC,GAClC,wCAAwC,CAAC;AAE7C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,qEAAqE;IACrE,OAAO,EAAE,WAAW,CAAC;IACrB;;;;;OAKG;IACH,YAAY,EAAE,WAAW,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;CACzC,CAAC;AAIF,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,GAAG,IAAI,0BAA0B,GAAG;IACvE,GAAG,EAAE,CACH,IAAI,EAAE,KAAK,EACX,OAAO,CAAC,EAAE,kBAAkB,KACzB,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;IACjE,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,KAAK,CAAC;IACnC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;CAChC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,gBAAgB,GAAG,MAAM,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,+BAA+B,CAAC,CAE5F;AAED,+FAA+F;AAC/F,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACzD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAQ9B"}