@cargo-ai/cli 1.0.77 → 1.0.80

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

@@ -0,0 +1,225 @@
+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";
+    toolName: string;
+    summary: string;
+} | {
+    kind: "end";
+    toolName: string;
+    isError: boolean;
+};
+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;
+};
+/**
+ * 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;
+}): 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();
+}
+/**
+ * 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;
+export {};
+//# sourceMappingURL=localHarness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"localHarness.d.ts","sourceRoot":"","sources":["../../../src/commands/ask/localHarness.ts"],"names":[],"mappings":"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"}