@alpacakit/agents 0.1.0-beta.37 → 0.2.0-beta.2

package/dist/agents/claude-stream.js

@@ -0,0 +1,111 @@
+/**
+ * Claude CLI stream-json vocabulary and line readers, shared by the
+ * one-shot run adapter (`claude.ts`) and the long-lived session adapter
+ * (`claude-session.ts`): one place spells the CLI's flags and the NDJSON
+ * field names both of them read.
+ */
+import { readJsonRecord, readNumber, readRecord, readString, readUnknownRecord, } from "../core/json.js";
+import { AGENT_EVENT_TYPE } from "../core/run.js";
+export const CLAUDE = {
+    id: "claude",
+    command: "claude",
+    cli: {
+        prompt: "-p",
+        model: "--model",
+        effort: "--effort",
+        outputFormat: "--output-format",
+        streamJson: "stream-json",
+        permissionMode: "--permission-mode",
+        bypassPermissions: "bypassPermissions",
+        defaultPermissionMode: "default",
+        verbose: "--verbose",
+        tools: "--tools",
+        allowedTools: "--allowedTools",
+        safeMode: "--safe-mode",
+        strictMcpConfig: "--strict-mcp-config",
+        noSessionPersistence: "--no-session-persistence",
+    },
+    auth: {
+        statusArgs: ["auth", "status", "--json"],
+        loginArgs: ["auth", "login", "--claudeai"],
+    },
+    mcp: {
+        addJson: "add-json",
+        mcp: "mcp",
+        remove: "remove",
+        scope: "--scope",
+    },
+    plugin: {
+        plugin: "plugin",
+        install: "install",
+    },
+    json: {
+        field: {
+            type: "type",
+            message: "message",
+            content: "content",
+            text: "text",
+            name: "name",
+            usage: "usage",
+            result: "result",
+            inputTokens: "input_tokens",
+            outputTokens: "output_tokens",
+            totalCost: "total_cost_usd",
+        },
+        type: {
+            assistant: "assistant",
+            result: "result",
+            text: "text",
+            toolUse: "tool_use",
+        },
+    },
+};
+export function parseClaudeLine(line) {
+    const record = readJsonRecord(line);
+    if (record === null ||
+        readString(record, CLAUDE.json.field.type) !== CLAUDE.json.type.assistant) {
+        return [];
+    }
+    const message = readRecord(record, CLAUDE.json.field.message);
+    const content = message?.[CLAUDE.json.field.content];
+    if (!Array.isArray(content)) {
+        return [{ type: AGENT_EVENT_TYPE.turn }];
+    }
+    const events = [{ type: AGENT_EVENT_TYPE.turn }];
+    for (const block of content) {
+        const blockRecord = readUnknownRecord(block);
+        if (blockRecord === null) {
+            continue;
+        }
+        const blockType = readString(blockRecord, CLAUDE.json.field.type);
+        if (blockType === CLAUDE.json.type.text) {
+            const text = readString(blockRecord, CLAUDE.json.field.text);
+            if (text !== null) {
+                events.push({ type: AGENT_EVENT_TYPE.message, text });
+            }
+        }
+        if (blockType === CLAUDE.json.type.toolUse) {
+            const name = readString(blockRecord, CLAUDE.json.field.name);
+            if (name !== null) {
+                events.push({ type: AGENT_EVENT_TYPE.tool, name });
+            }
+        }
+    }
+    return events;
+}
+export function parseClaudeResult(line) {
+    const record = readJsonRecord(line);
+    if (record === null ||
+        readString(record, CLAUDE.json.field.type) !== CLAUDE.json.type.result) {
+        return null;
+    }
+    const usageRecord = readRecord(record, CLAUDE.json.field.usage);
+    const usage = usageRecord === null
+        ? null
+        : {
+            inputTokens: readNumber(usageRecord, CLAUDE.json.field.inputTokens),
+            outputTokens: readNumber(usageRecord, CLAUDE.json.field.outputTokens),
+            costUsd: readNumber(record, CLAUDE.json.field.totalCost),
+        };
+    return { text: readString(record, CLAUDE.json.field.result), usage };
+}

package/dist/agents/claude.d.ts

@@ -7,6 +7,7 @@
  */
 import { type FailureMatcher } from "../kernel/classify.js";
 import type { AgentDefinition } from "../kernel/definition.js";
+import { type ClaudeSessionPermissions } from "./claude-session.js";
 export declare const CLAUDE_CONFIG_DIR_ENV_VAR = "CLAUDE_CONFIG_DIR";
 export declare const CLAUDE_API_KEY_ENV_VAR = "ANTHROPIC_API_KEY";
 /**
@@ -23,5 +24,5 @@ export type ClaudeOptions = {
      */
     readonly customizations?: "inherit" | "disabled";
 };
-export declare function claude(options?: ClaudeOptions): AgentDefinition<"claude">;
+export declare function claude(options?: ClaudeOptions): AgentDefinition<"claude", ClaudeSessionPermissions>;
 //# sourceMappingURL=claude.d.ts.map

package/dist/agents/claude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/agents/claude.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+CH,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG/D,eAAO,MAAM,yBAAyB,sBAAsB,CAAC;AAC7D,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAsK1D;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,cAAc,CA0CvD;AA6TD,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;CAClD,CAAC;AAEF,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,eAAe,CAAC,QAAQ,CAAC,CAgF7E"}
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/agents/claude.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4CH,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,qBAAqB,CAAC;AAG7B,eAAO,MAAM,yBAAyB,sBAAsB,CAAC;AAC7D,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAwD1D;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,cAAc,CA0CvD;AA6TD,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;CAClD,CAAC;AAEF,wBAAgB,MAAM,CACpB,OAAO,GAAE,aAAkB,GAC1B,eAAe,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAiFrD"}

package/dist/agents/claude.js

@@ -13,8 +13,7 @@ import { AUTH_MATERIAL_KIND, envVarAuthMaterial } from "../auth/material.js";
 import { requireSecret } from "../auth/secrets.js";
 import { AGENT_ERROR_CODE, AgentError } from "../core/error.js";
 import { isErrnoCode } from "../core/fs.js";
-import { readBoolean, readJsonRecord, readNumber, readRecord, readString, readUnknownRecord, } from "../core/json.js";
-import { AGENT_EVENT_TYPE } from "../core/run.js";
+import { readBoolean, readJsonRecord, readNumber, readRecord, readString, } from "../core/json.js";
 import { TEXT_ENCODING } from "../core/values.js";
 import { cliAvailability } from "../host/availability.js";
 import { INSTALL_STATUS, MCP_TRANSPORT, SKILL_SOURCE_KIND, } from "../host/capabilities.js";
@@ -22,65 +21,13 @@ import { withStagedGithubDirectory, } from "../host/github-dir.js";
 import { listMcpServersViaCli } from "../host/mcp-list.js";
 import { hostCommandFailedError, runHostCommand, runHostCommandResult, } from "../host/run-command.js";
 import { parseEpochTimestamp, } from "../kernel/classify.js";
-import { defineCliAgent, } from "../kernel/cli-agent.js";
+import { defineCliAgent } from "../kernel/cli-agent.js";
 import { cliLoginCommand } from "../kernel/cli-login.js";
 import { GRANT_KIND, SANDBOX_MODE } from "../kernel/options.js";
+import { claudeSessions, } from "./claude-session.js";
+import { CLAUDE, parseClaudeLine, parseClaudeResult } from "./claude-stream.js";
 export const CLAUDE_CONFIG_DIR_ENV_VAR = "CLAUDE_CONFIG_DIR";
 export const CLAUDE_API_KEY_ENV_VAR = "ANTHROPIC_API_KEY";
-const CLAUDE = {
-    id: "claude",
-    command: "claude",
-    cli: {
-        prompt: "-p",
-        model: "--model",
-        effort: "--effort",
-        outputFormat: "--output-format",
-        streamJson: "stream-json",
-        permissionMode: "--permission-mode",
-        bypassPermissions: "bypassPermissions",
-        defaultPermissionMode: "default",
-        verbose: "--verbose",
-        tools: "--tools",
-        allowedTools: "--allowedTools",
-        safeMode: "--safe-mode",
-        strictMcpConfig: "--strict-mcp-config",
-        noSessionPersistence: "--no-session-persistence",
-    },
-    auth: {
-        statusArgs: ["auth", "status", "--json"],
-        loginArgs: ["auth", "login", "--claudeai"],
-    },
-    mcp: {
-        addJson: "add-json",
-        mcp: "mcp",
-        remove: "remove",
-        scope: "--scope",
-    },
-    plugin: {
-        plugin: "plugin",
-        install: "install",
-    },
-    json: {
-        field: {
-            type: "type",
-            message: "message",
-            content: "content",
-            text: "text",
-            name: "name",
-            usage: "usage",
-            result: "result",
-            inputTokens: "input_tokens",
-            outputTokens: "output_tokens",
-            totalCost: "total_cost_usd",
-        },
-        type: {
-            assistant: "assistant",
-            result: "result",
-            text: "text",
-            toolUse: "tool_use",
-        },
-    },
-};
 const COMPETING_TOKEN_VARS = [
     "ANTHROPIC_API_KEY",
     "ANTHROPIC_AUTH_TOKEN",
@@ -120,55 +67,6 @@ function sharedArgs(ctx, customizations) {
             : []),
     ];
 }
-function parseClaudeLine(line) {
-    const record = readJsonRecord(line);
-    if (record === null ||
-        readString(record, CLAUDE.json.field.type) !== CLAUDE.json.type.assistant) {
-        return [];
-    }
-    const message = readRecord(record, CLAUDE.json.field.message);
-    const content = message?.[CLAUDE.json.field.content];
-    if (!Array.isArray(content)) {
-        return [{ type: AGENT_EVENT_TYPE.turn }];
-    }
-    const events = [{ type: AGENT_EVENT_TYPE.turn }];
-    for (const block of content) {
-        const blockRecord = readUnknownRecord(block);
-        if (blockRecord === null) {
-            continue;
-        }
-        const blockType = readString(blockRecord, CLAUDE.json.field.type);
-        if (blockType === CLAUDE.json.type.text) {
-            const text = readString(blockRecord, CLAUDE.json.field.text);
-            if (text !== null) {
-                events.push({ type: AGENT_EVENT_TYPE.message, text });
-            }
-        }
-        if (blockType === CLAUDE.json.type.toolUse) {
-            const name = readString(blockRecord, CLAUDE.json.field.name);
-            if (name !== null) {
-                events.push({ type: AGENT_EVENT_TYPE.tool, name });
-            }
-        }
-    }
-    return events;
-}
-function parseClaudeResult(line) {
-    const record = readJsonRecord(line);
-    if (record === null ||
-        readString(record, CLAUDE.json.field.type) !== CLAUDE.json.type.result) {
-        return null;
-    }
-    const usageRecord = readRecord(record, CLAUDE.json.field.usage);
-    const usage = usageRecord === null
-        ? null
-        : {
-            inputTokens: readNumber(usageRecord, CLAUDE.json.field.inputTokens),
-            outputTokens: readNumber(usageRecord, CLAUDE.json.field.outputTokens),
-            costUsd: readNumber(record, CLAUDE.json.field.totalCost),
-        };
-    return { text: readString(record, CLAUDE.json.field.result), usage };
-}
 /**
  * Structured quota signals in Claude CLI NDJSON output (v1 F2), scanned
  * per line: rate_limit_event rejected (with resetsAt), api_error_status
@@ -465,7 +363,7 @@ async function listClaudeMcp(ctx) {
 }
 export function claude(options = {}) {
     const customizations = options.customizations ?? "inherit";
-    return defineCliAgent({
+    const definition = defineCliAgent({
         id: CLAUDE.id,
         command: CLAUDE.command,
         args: {
@@ -540,4 +438,5 @@ export function claude(options = {}) {
             remove: removeClaudeMcp,
         },
     });
+    return { ...definition, session: claudeSessions({ customizations }) };
 }

package/dist/agents/codex-session.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Codex session adapter: one `codex app-server` process holding one thread.
+ *
+ * Protocol facts (codex 0.153.4, T53 / T57 / T61 lab runs):
+ * - `thread/start {cwd, sandbox, approvalPolicy, approvalsReviewer}` creates
+ *   the thread and takes its writer lock; with a writable sandbox Codex also
+ *   appends a `trust_level` entry for `cwd` to `~/.codex/config.toml`;
+ * - `thread/resume` must repeat the permissions — without `sandbox` the
+ *   resumed turns ran as danger-full-access; it answers -32600 "already has
+ *   an active writer" while another process holds the thread and -32600
+ *   "… is archived" for an archived one (`thread/unarchive` first, opt-in);
+ * - `turn/start` answers the turn id at once; `turn/steer {expectedTurnId}`
+ *   appends to it; `turn/interrupt` ends it with `turn/completed`
+ *   status `interrupted` (the command's own `item/completed` may trail by ~36 s);
+ * - `item/commandExecution/requestApproval` is a server request answered by
+ *   `{"decision": "accept" | "decline"}`; closing stdin releases the lock.
+ */
+import { CODEX_SANDBOX_MODE } from "../codex/protocol.js";
+export type { CodexSandboxMode } from "../codex/protocol.js";
+import { type SessionCapability } from "../kernel/session.js";
+/** `approval_policy` words (codex 0.153.4 `AskForApproval`; the granular object form is not modeled). */
+export declare const CODEX_APPROVAL_POLICY: {
+    readonly untrusted: "untrusted";
+    readonly onRequest: "on-request";
+    readonly never: "never";
+};
+export type CodexApprovalPolicy = (typeof CODEX_APPROVAL_POLICY)[keyof typeof CODEX_APPROVAL_POLICY];
+export declare const CODEX_APPROVALS_REVIEWER: {
+    readonly user: "user";
+    readonly autoReview: "auto_review";
+    readonly guardianSubagent: "guardian_subagent";
+};
+export type CodexApprovalsReviewer = (typeof CODEX_APPROVALS_REVIEWER)[keyof typeof CODEX_APPROVALS_REVIEWER];
+/** Spelled as the rollout's `turn_context.sandbox_policy` records it. */
+export type CodexSandboxPolicy = {
+    readonly type: typeof CODEX_SANDBOX_MODE.readOnly;
+} | {
+    readonly type: typeof CODEX_SANDBOX_MODE.dangerFullAccess;
+} | {
+    readonly type: typeof CODEX_SANDBOX_MODE.workspaceWrite;
+    readonly writableRoots: readonly string[];
+    readonly networkAccess: boolean;
+    readonly excludeTmpdirEnvVar: boolean;
+    readonly excludeSlashTmp: boolean;
+};
+export type CodexSessionPermissions = {
+    readonly approvalPolicy: CodexApprovalPolicy;
+    readonly approvalsReviewer: CodexApprovalsReviewer;
+    readonly sandbox: CodexSandboxPolicy;
+};
+export declare function codexSessions(): SessionCapability<CodexSessionPermissions>;
+//# sourceMappingURL=codex-session.d.ts.map

package/dist/agents/codex-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-session.d.ts","sourceRoot":"","sources":["../../src/agents/codex-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,OAAO,EAGL,kBAAkB,EAGnB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA2B7D,OAAO,EAIL,KAAK,iBAAiB,EAIvB,MAAM,sBAAsB,CAAC;AAK9B,yGAAyG;AACzG,eAAO,MAAM,qBAAqB;;;;CAIxB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC;AAErE,eAAO,MAAM,wBAAwB;;;;CAI3B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E,yEAAyE;AACzE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,kBAAkB,CAAC,QAAQ,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,kBAAkB,CAAC,gBAAgB,CAAA;CAAE,GAC7D;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,kBAAkB,CAAC,cAAc,CAAC;IACxD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC,CAAC;AAEN,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,cAAc,EAAE,mBAAmB,CAAC;IAC7C,QAAQ,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC,CAAC;AAkkBF,wBAAgB,aAAa,IAAI,iBAAiB,CAAC,uBAAuB,CAAC,CAM1E"}