@cargo-ai/cli 1.0.94 → 1.0.96

package/build/commands/ask/localHarness.d.ts

@@ -1,278 +0,0 @@
-import type { Api } from "../../api.js";
-/**
- * Always-on local-copy rails, plus CDK rails only when `dir` is a CDK project.
- * Exported for tests.
- */
-export declare function localHarnessInstructions(dir: string): string;
-/** Exported for tests. */
-export declare function localHarnessSkills(dir: string): Array<{
-    name: string;
-    description: string;
-    content: string;
-}>;
-/**
- * A built-in tool Claude Code wants to run that `permissionMode` does not
- * auto-approve (anything that writes or shells out under `allow-reads`).
- */
-export type LocalToolApproval = {
-    approvalId: string;
-    toolCallId: string;
-    toolName: string;
-    /** Compact one-line rendering of the tool input, for the prompt. */
-    summary: string;
-    input: unknown;
-};
-/** A tool starting or finishing, so the caller can show what is happening. */
-export type LocalToolActivity = {
-    kind: "start";
-    toolCallId: string;
-    toolName: string;
-    summary: string;
-} | {
-    kind: "end";
-    toolCallId: string;
-    toolName: string;
-    isError: boolean;
-}
-/**
- * Announced, then never run — a tool whose input stopped mid-stream, one
- * that was refused, or a sibling whose approval request the harness lost.
- * None of them report a result, so `end` never comes: a caller tracking
- * what is live has to be told, or it shows that tool for the rest of the
- * turn. `retractAbandonedCalls` decides which calls qualify and when.
- */
- | {
-    kind: "dropped";
-    toolCallId: string;
-    toolName: string;
-};
-export type LocalStreamHandlers = {
-    onTextDelta?: (delta: string) => void;
-    /**
-     * Decide whether the tool may run. Omitted (`--print`, non-interactive)
-     * means deny — the turn continues and the model reports what it could not
-     * do rather than silently running commands on the user's machine.
-     */
-    onApproval?: (approval: LocalToolApproval) => Promise<boolean>;
-    onActivity?: (activity: LocalToolActivity) => void;
-    /** Path of a file the turn wrote or edited, as the tool named it. */
-    onFileTouched?: (path: string) => void;
-    /** Something worth saying that is not part of the reply. */
-    onNotice?: (message: string) => void;
-};
-export type LocalStreamOptions = LocalStreamHandlers & {
-    /** Aborts the turn; the harness interrupts Claude Code gracefully. */
-    abortSignal?: AbortSignal;
-    /**
-     * Fired when the stall watchdog gives up, before the turn is rejected.
-     * Should abort `abortSignal` so Claude Code stops rather than being torn
-     * down out from under a still-open bridge.
-     */
-    onStall?: () => void;
-};
-/**
- * What one turn spent upstream, summed over the streams a suspended turn is
- * made of. `costUsd` is Claude Code's own accounting; the API prices it into
- * credits so the CLI never states a credit count itself.
- */
-export type LocalTurnUsage = {
-    costUsd: number;
-    totalTokens: number;
-    inputTokens: number;
-    outputTokens: number;
-    cacheReadTokens: number;
-    cacheWriteTokens: number;
-    reasoningTokens: number;
-};
-/**
- * Text and usage of a turn in progress, owned by the caller rather than by
- * `runPromptTurn`: a cancelled or failed turn still spent those tokens, and
- * they have to reach the API anyway.
- */
-export type LocalTurnAccumulator = {
-    chunks: string[];
-    usage: LocalTurnUsage;
-};
-/** Exported for tests. */
-export declare function createTurnAccumulator(): LocalTurnAccumulator;
-export type LocalHarnessHandle = {
-    streamPrompt: (question: string, options?: LocalStreamOptions) => Promise<string>;
-    /**
-     * When a turn last reached Anthropic, or undefined if none has. The proxy
-     * token re-arms on every call it makes, so this — not the mint time — is
-     * what its real expiry runs from.
-     */
-    proxyLastUsedAtMs: () => number | undefined;
-    /** Stops Claude Code and its bridge; the session is not resumable. */
-    close: () => Promise<void>;
-};
-/**
- * The workspace half of local Ask: the hosted Cargo MCP server, reached
- * through this CLI's own `mcp` bridge.
- *
- * Going through the bridge rather than configuring the HTTP endpoint directly
- * is what keeps a long chat working — the bridge rebuilds the `Authorization`
- * header per request from the same credentials every other command uses, so an
- * OAuth session that expires mid-session renews instead of 401ing. `CARGO_BASE_URL`
- * is pinned so the bridge cannot end up on a different API than this session.
- *
- * Everything the workspace can do arrives this way: actions, runs, models and
- * SQL, the context, usage. That includes `execute_action`, which spends credits
- * and writes to connected systems — see the approval note on
- * `isAutoApproved`.
- */
-/**
- * What Claude Code mounts this server as, and so the `mcp__<server>__` prefix
- * its tools carry. Read by `isAutoApproved`, which trusts this server and no
- * other — see the note there.
- *
- * Exported for tests.
- */
-export declare const CARGO_MCP_SERVER_NAME = "cargo";
-type WorkspaceLayout = {
-    sandboxCwd: string;
-    /** `undefined` leaves the harness its per-session default. */
-    workDir: string | undefined;
-};
-/**
- * Where to root the sandbox, and which directory inside it the session works in.
- *
- * The harness gives every session a work directory under the sandbox root and
- * starts Claude Code there — `cwd: workdir` in the bridge — and it refuses to
- * use the root itself. Rooted at the project, that means the agent begins in an
- * empty `claude-code-<sessionId>` directory one level below the working copy it
- * was asked about. Rooting at the project's parent instead makes the session
- * work directory *be* the project, so the agent starts where the user is, and
- * the harness's own artifacts land beside the project rather than in it.
- *
- * Falls back to the project when the parent cannot serve — a project at a
- * filesystem root has no usable name, and a parent we cannot write to would
- * fail the session at startup. The per-session directory returns in that case,
- * and `pruneHarnessArtifacts` sweeps it once it is cold.
- */
-export declare function resolveWorkspaceLayout(dir: string): WorkspaceLayout;
-export declare function createLocalHarness(input: {
-    api: Api;
-    /**
-     * Cargo API origin (`config.baseUrl`). The Anthropic proxy is mounted on
-     * the API as `/sandbox/anthropic` — same host the backend uses via
-     * `config.app.url` (which is the API URL, not the web app).
-     */
-    apiBaseUrl: string;
-    dir: string;
-    chatUuid: string;
-    agentUuid?: string;
-    proxyToken: string;
-    /**
-     * Earlier turns of this chat, from `loadChatHistoryPreamble`. The session is
-     * always new, so this is the only thing that carries a `--continue` chat
-     * across CLI runs.
-     */
-    history?: string;
-    /**
-     * The id the caller claimed the chat with. Sent with the ingest so recording
-     * a turn releases this session's claim and not one taken after it.
-     */
-    turnOwnerId?: string;
-}): Promise<LocalHarnessHandle>;
-export type StreamLike = {
-    fullStream: AsyncIterable<unknown>;
-    text: PromiseLike<string>;
-};
-type ApprovalContinuation = {
-    approvalResponse: {
-        type: "tool-approval-response";
-        approvalId: string;
-        approved: boolean;
-        reason?: string;
-    };
-    toolCall: {
-        type: "tool-call";
-        toolCallId: string;
-        toolName: string;
-        input: unknown;
-    };
-};
-/** The two harness calls a turn needs. Split out so tests can fake them. */
-export type TurnDriver = {
-    start: () => Promise<StreamLike>;
-    continueWithApprovals: (continuations: readonly ApprovalContinuation[]) => Promise<StreamLike>;
-};
-/**
- * Run one turn to completion, answering approval requests along the way.
- *
- * A turn suspends whenever Claude Code wants a tool `permissionMode` does not
- * cover: the stream ends with the approvals still pending, and the turn only
- * finishes once decisions are fed back in. Exported for tests.
- */
-export declare function runPromptTurn(input: {
-    driver: TurnDriver;
-    handlers: LocalStreamHandlers | undefined;
-    accumulator?: LocalTurnAccumulator;
-    /**
-     * Filled with approvals the harness asked about and drained as each is
-     * answered, so a turn that ends mid-question leaves the unanswered ones
-     * behind for the caller to deny.
-     */
-    unanswered?: LocalToolApproval[];
-    /** Overridden by tests; `Infinity` waits forever. */
-    stallTimeoutMs?: number;
-    /** The same, for the stream while a tool is executing. */
-    toolStallTimeoutMs?: number;
-    /**
-     * Called when the stall watchdog fires, before the turn is rejected — abort
-     * the harness stream so Claude Code does not keep running after we give up.
-     */
-    onStall?: () => void;
-}): Promise<string>;
-/**
- * The previous turn could not be wound down, so this session cannot take
- * another prompt. Raised rather than pressed on with: the harness would either
- * refuse the prompt itself or run it alongside the turn we failed to finish.
- *
- * The caller's recovery is to replace the session — nothing about a wedged
- * runtime gets better by asking it again.
- */
-export declare class HarnessTurnStuck extends Error {
-    constructor();
-}
-/**
- * The turn produced nothing for `TURN_STALL_TIMEOUT_MS` while no tool was in
- * flight. Common causes: a step that asked to run several confirmable tools at
- * once (the harness only surfaces one approval), or the Claude Code bridge
- * going silent. Recoverable — replace the session and ask again.
- */
-export declare class HarnessTurnStalled extends Error {
-    constructor(timeoutMs: number, whileToolRunning?: boolean);
-}
-/**
- * The Claude Code bridge dropped mid-turn. Same recovery as a stall: the
- * process behind the session is gone, so the next question needs a new one.
- */
-export declare function isBridgeClosedError(error: unknown): boolean;
-/**
- * Wait for `work`, but give up after `timeoutMs` rather than blocking a
- * teardown forever. Resolves either way; the caller has already decided that
- * an unfinished result is better than waiting.
- *
- * Exported for tests.
- */
-export declare function settleWithin(work: Promise<unknown>, timeoutMs: number): Promise<void>;
-/** Exported for tests. */
-export declare function isAutoApproved(toolName: string): boolean;
-/** Exported for tests. */
-export declare function isAlwaysDenied(toolName: string): boolean;
-/**
- * What Claude Code says the turn cost, off the `finish` part.
- *
- * Two keys, because the value is renamed on its way here: the bridge emits
- * `harnessMetadata`, and `HarnessAgent` republishes the same object as
- * `providerMetadata` on the parts this code actually reads. Looking only for
- * the bridge's name found nothing, so every local turn was ingested at a cost
- * of zero and priced into no credits at all.
- *
- * Exported for tests.
- */
-export declare function readClaudeCodeCostUsd(part: Record<string, unknown>): number | undefined;
-export {};
-//# sourceMappingURL=localHarness.d.ts.map

package/build/commands/ask/localHarness.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"localHarness.d.ts","sourceRoot":"","sources":["../../../src/commands/ask/localHarness.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAiIxC;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED,0BAA0B;AAC1B,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAM/D;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AACH;;;;;;GAMG;GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACnD,qEAAqE;IACrE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG;IACrD,sEAAsE;IACtE,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,cAAc,CAAC;CACvB,CAAC;AAEF,0BAA0B;AAC1B,wBAAgB,qBAAqB,IAAI,oBAAoB,CAa5D;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,kBAAkB,KACzB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC5C,sEAAsE;IACtE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAmDF;;;;;;;;;;;;;;GAcG;AACH;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,UAAU,CAAC;AA4D7C,KAAK,eAAe,GAAG;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAenE;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,GAAG,EAAE,GAAG,CAAC;IACT;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoR9B;AAyDD,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC3B,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,gBAAgB,EAAE;QAChB,IAAI,EAAE,wBAAwB,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,EAAE;QACR,IAAI,EAAE,WAAW,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;CACH,CAAC;AAEF,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,qBAAqB,EAAE,CACrB,aAAa,EAAE,SAAS,oBAAoB,EAAE,KAC3C,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1B,CAAC;AASF;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE;IACzC,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC1C,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjC,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoIlB;AAiKD;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;;CAO1C;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,SAAS,EAAE,MAAM,EAAE,gBAAgB,UAAQ;CAUxD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK3D;AAsDD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,iBAe3E;AAwED,0BAA0B;AAC1B,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMxD;AAwBD,0BAA0B;AAC1B,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD;AAmUD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,SAAS,CA0BpB"}