@agent-deck/cli 2.0.0 → 2.1.1

package/dist/run.d.ts

@@ -0,0 +1,191 @@
+import { resolveMcpLaunchPlan } from './mcp-launcher';
+import { type RunClient, type RunToolsProfile } from './run-adapter';
+import { type ClaudeAdapterDeps, type RunQueryFn } from './run-claude';
+import { type CodexAdapterDeps } from './run-codex';
+import { type CursorAdapterDeps } from './run-cursor';
+import { type MuseAdapterDeps } from './run-muse';
+export { allowedToolsForProfile, RUN_EDIT_TOOLS, RUN_PERMISSION_MODE, RUN_READONLY_TOOLS, RUN_SETTING_SOURCES, RUN_TOOL_PROFILES, type RunToolsProfile, } from './run-adapter';
+export type { RunClient } from './run-adapter';
+export type { ClaudeAdapterDeps, RunQueryFn, RunQueryMessage, RunQueryOptions } from './run-claude';
+export type { CodexAdapterDeps } from './run-codex';
+export type { CursorAdapterDeps } from './run-cursor';
+export type { MuseAdapterDeps } from './run-muse';
+export type RunOptions = {
+    deckRef: string;
+    client: RunClient;
+    cwd: string;
+    prompt?: string;
+    promptFile?: string;
+    tools: RunToolsProfile;
+    log?: string;
+    resume?: string;
+    detach: boolean;
+    /** Internal: the starter passes the allocated run id so the child reuses it. */
+    runIdOverride?: string;
+};
+export declare function parseRunArgs(args: string[]): RunOptions | {
+    error: string;
+};
+export type RunLogLine = {
+    t: 'text';
+    ts: string;
+    text: string;
+} | {
+    t: 'tool';
+    ts: string;
+    name: string;
+} | {
+    t: 'result';
+    ts: string;
+    sessionId: string | null;
+    subtype: string;
+    result: unknown;
+} | {
+    t: 'end';
+    ts: string;
+    sessionId: string | null;
+} | {
+    t: 'notice';
+    ts: string;
+    message: string;
+    sessionId: string | null;
+} | {
+    t: 'error';
+    ts: string;
+    message: string;
+    sessionId: string | null;
+};
+export type RunMeta = {
+    runId: string;
+    deck: string;
+    client: RunClient;
+    tools: RunToolsProfile;
+    cwd: string;
+    pid: number;
+    startedAt: string;
+    state: 'running' | 'ended' | 'error';
+    sessionId?: string;
+    /** Present only when the launch bypassed a client workspace-trust guard. */
+    trustOverride?: true;
+};
+export type RunDeps = {
+    /** NOT-400 seam, kept for compatibility: injected `query()` for the Claude adapter. */
+    query?: RunQueryFn;
+    /** Injected in tests; production lazily requires the Claude Agent SDK. */
+    claude?: ClaudeAdapterDeps;
+    /** Injected in tests; production spawns the real `codex` binary. */
+    codex?: CodexAdapterDeps;
+    /** Injected in tests; production spawns the real `cursor-agent` binary. */
+    cursor?: CursorAdapterDeps;
+    /** Injected in tests; production spawns the real `muse` binary. */
+    muse?: MuseAdapterDeps;
+    resolveDeck?: (ref: string) => Promise<{
+        id: string;
+        name: string;
+    } | null>;
+    resolveLaunchPlan?: typeof resolveMcpLaunchPlan;
+    homeDir?: string;
+    /** Injected in tests; production probes the local Claude Code CLI (NOT-405). */
+    claudeProbe?: ClaudeClientProbe;
+};
+/** Outcome of the Claude Code client probe: installed and signed in, or why not. */
+export type ClaudeClientStatus = {
+    ok: true;
+} | {
+    ok: false;
+    reason: 'not-installed' | 'not-signed-in';
+};
+export type ClaudeClientProbe = () => Promise<ClaudeClientStatus> | ClaudeClientStatus;
+/** The one fix command both preflight remedies name. Verified against `claude auth --help`. */
+export declare const CLAUDE_AUTH_LOGIN_COMMAND = "claude auth login";
+export declare const RUN_CLAUDE_NOT_INSTALLED_ERROR = "Claude Code is not installed (no `claude` on PATH). Install Claude Code, then run `claude auth login` to sign in, then retry.";
+export declare const RUN_CLAUDE_NOT_SIGNED_IN_ERROR = "Claude Code is not signed in. Run `claude auth login` to sign in with your own account, then retry.";
+/** First executable `name` on `pathEnv`, or null. Pure apart from the fs check. */
+export declare function findExecutableOnPath(name: string, pathEnv?: string): string | null;
+/**
+ * True only when `claude auth status` JSON reports a login. Never throws:
+ * garbage, an empty string, or a logged-out report all read as signed out.
+ */
+export declare function claudeAuthStatusShowsLogin(stdout: string): boolean;
+/**
+ * Default Claude Code preflight: the `claude` CLI must be on PATH and
+ * `claude auth status` must report a login. Local only — no model call.
+ * An explicit ANTHROPIC_API_KEY passes without the OAuth check once the
+ * `claude` CLI is found on PATH (API-key onboarding stays out of scope;
+ * the friend path signs in via `claude auth login`). Any other failure —
+ * logged out, unparseable output, a hung or crashed `claude` — reads as
+ * not signed in; re-running the login is the remedy in every case.
+ */
+export declare function defaultClaudeClientProbe(): Promise<ClaudeClientStatus>;
+/**
+ * Test-only fake runner for the `run --detach` integration suite. The detached
+ * child is a real process, so dependency injection cannot reach it; instead the
+ * suite points AGENT_DECK_RUN_FAKE at a JSON behavior file and both the starter
+ * (deck lookup) and the child (deck lookup + model stream) honor it. Explicit
+ * `deps` always win, so unit tests are unaffected. Never set in production.
+ */
+export declare const RUN_FAKE_ENV = "AGENT_DECK_RUN_FAKE";
+export type RunFakeBehavior = {
+    deckId?: string;
+    deckName?: string;
+    /** success: yield text then a success result; fail: throw; crash: exit silently-ish. */
+    mode?: 'success' | 'fail' | 'crash';
+    lineDelayMs?: number;
+    endDelayMs?: number;
+    sessionId?: string;
+    text?: string;
+    error?: string;
+    exitCode?: number;
+    crashStderr?: string;
+    /** When set, the received { prompt, options } are recorded here as JSON. */
+    recordOptionsPath?: string;
+};
+export declare function loadRunFakeBehavior(): RunFakeBehavior | null;
+export type RunPrereqDeps = Pick<RunDeps, 'resolveDeck' | 'resolveLaunchPlan' | 'claudeProbe'>;
+export declare function newRunId(): string;
+/**
+ * Atomic run-record write: readers (`run status`, detach tests, orchestrators)
+ * poll meta.json while the run child rewrites it, and a plain writeFileSync
+ * truncates before writing — a concurrent read lands on empty/partial bytes
+ * and JSON.parse throws. Writing to a sibling temp file and renaming keeps
+ * every observed state a complete document (rename is atomic on POSIX and
+ * Windows). The pid suffix keeps the starter's and the child's temp files
+ * distinct when both target the same meta.json.
+ */
+export declare function writeRunMeta(metaPath: string, meta: RunMeta): void;
+/**
+ * Session receipt check: the agent harness prints the bound deck as one
+ * `get_session_context` receipt line rendering `display_summary`
+ * (e.g. `◆ dev · 2 MCP · 0 keys · 1 playbooks`). Returns the mismatching deck
+ * token when the log positively shows a deck other than the requested one;
+ * a missing receipt is not a mismatch (the pre-start assignment gate is the
+ * fail-closed check; this is a second net for a mis-bound session).
+ * The fragments are joined before scanning: real clients stream token-level
+ * deltas, so one receipt line can arrive split across many text events and a
+ * per-fragment scan would miss the mismatch.
+ */
+export declare function findReceiptDeckMismatch(texts: readonly string[], deck: {
+    id: string;
+    name: string;
+}): string | null;
+/**
+ * Everything a run must prove before it may start streaming: a readable brief,
+ * an existing cwd, a known deck, and a folder assignment already bound to that
+ * deck. Shared by the foreground run and the `--detach` starter so both fail
+ * closed on the same inputs with the same messages.
+ */
+export declare function validateRunPrereqs(options: RunOptions, deps?: RunPrereqDeps): Promise<{
+    promptText: string;
+    deck: {
+        id: string;
+        name: string;
+    };
+} | {
+    error: string;
+}>;
+export declare function printRunHelp(): void;
+export declare function runRun(options: RunOptions, deps?: RunDeps): Promise<number>;
+export declare function runRunCommand(args: string[], deps?: RunDeps & {
+    followPollMs?: number;
+}): Promise<number>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

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