@slopus/rig 0.0.4 → 0.0.6

package/dist/tools/codex/index.d.ts

@@ -2,26 +2,41 @@ export { codexApplyPatchTool } from "./apply_patch.js";
 export { codexExecCommandTool } from "./exec_command.js";
 export { codexViewImageTool } from "./view_image.js";
 export { codexWriteStdinTool } from "./write_stdin.js";
+export { codexUpdatePlanTool } from "./update_plan.js";
+export { codexRequestUserInputTool } from "./request_user_input.js";
+export { codexSpawnAgentTool } from "./spawn_agent.js";
+export { codexFollowupTaskTool } from "./followup_task.js";
+export { codexInterruptAgentTool } from "./interrupt_agent.js";
+export { codexListAgentsTool } from "./list_agents.js";
+export { codexWaitAgentTool } from "./wait_agent.js";
+export { unifiedExecOutputSchema } from "./unifiedExecOutput.js";
 export declare const codexTools: readonly [import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
     cmd: import("@sinclair/typebox").TString;
     workdir: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    tty: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
     yield_time_ms: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
     max_output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
     shell: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    login: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    sandbox_permissions: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"use_default">, import("@sinclair/typebox").TLiteral<"require_escalated">]>>;
+    justification: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
 }>, import("@sinclair/typebox").TObject<{
-    stdout: import("@sinclair/typebox").TString;
-    stderr: import("@sinclair/typebox").TString;
-    exitCode: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
-    timedOut: import("@sinclair/typebox").TBoolean;
+    chunk_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    exit_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    original_token_count: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    output: import("@sinclair/typebox").TString;
+    session_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    wall_time_seconds: import("@sinclair/typebox").TNumber;
 }>>, import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
     session_id: import("@sinclair/typebox").TNumber;
     chars: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     yield_time_ms: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
     max_output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
 }>, import("@sinclair/typebox").TObject<{
-    text: import("@sinclair/typebox").TString;
+    chunk_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    exit_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    original_token_count: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    output: import("@sinclair/typebox").TString;
+    session_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    wall_time_seconds: import("@sinclair/typebox").TNumber;
 }>>, import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
     patch: import("@sinclair/typebox").TString;
     workdir: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -33,5 +48,73 @@ export declare const codexTools: readonly [import("../../agent/types.js").Define
 }>, import("@sinclair/typebox").TObject<{
     image_url: import("@sinclair/typebox").TString;
     detail: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"high">, import("@sinclair/typebox").TLiteral<"original">]>;
+}>>, import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    explanation: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    plan: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        step: import("@sinclair/typebox").TString;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"in_progress">, import("@sinclair/typebox").TLiteral<"completed">]>;
+    }>>;
+}>, import("@sinclair/typebox").TObject<{
+    text: import("@sinclair/typebox").TString;
+}>>, import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        id: import("@sinclair/typebox").TString;
+        header: import("@sinclair/typebox").TString;
+        question: import("@sinclair/typebox").TString;
+        options: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            label: import("@sinclair/typebox").TString;
+            description: import("@sinclair/typebox").TString;
+        }>>;
+    }>>;
+}>, import("@sinclair/typebox").TObject<{
+    answers: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TObject<{
+        answers: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    }>>;
+}>>];
+export declare const codexCollaborationTools: readonly [import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    task_name: import("@sinclair/typebox").TString;
+    message: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    agent_id: import("@sinclair/typebox").TString;
+    path: import("@sinclair/typebox").TString;
+    task_name: import("@sinclair/typebox").TString;
+}>>, import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    target: import("@sinclair/typebox").TString;
+    message: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    description: import("@sinclair/typebox").TString;
+    path: import("@sinclair/typebox").TString;
+    sessionId: import("@sinclair/typebox").TString;
+    status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"aborted">, import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"error">, import("@sinclair/typebox").TLiteral<"running">]>;
+    taskName: import("@sinclair/typebox").TString;
+}>>, import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    timeout_ms: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, import("@sinclair/typebox").TObject<{
+    agents: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        description: import("@sinclair/typebox").TString;
+        path: import("@sinclair/typebox").TString;
+        sessionId: import("@sinclair/typebox").TString;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"aborted">, import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"error">, import("@sinclair/typebox").TLiteral<"running">]>;
+        taskName: import("@sinclair/typebox").TString;
+    }>>;
+    timed_out: import("@sinclair/typebox").TBoolean;
+}>>, import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    path_prefix: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>, import("@sinclair/typebox").TObject<{
+    agents: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        description: import("@sinclair/typebox").TString;
+        path: import("@sinclair/typebox").TString;
+        sessionId: import("@sinclair/typebox").TString;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"aborted">, import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"error">, import("@sinclair/typebox").TLiteral<"running">]>;
+        taskName: import("@sinclair/typebox").TString;
+    }>>;
+}>>, import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    target: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    description: import("@sinclair/typebox").TString;
+    path: import("@sinclair/typebox").TString;
+    sessionId: import("@sinclair/typebox").TString;
+    status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"aborted">, import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"error">, import("@sinclair/typebox").TLiteral<"running">]>;
+    taskName: import("@sinclair/typebox").TString;
 }>>];
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/codex/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../sources/tools/codex/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAOvD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAKb,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../sources/tools/codex/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAcjE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOb,CAAC;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAM1B,CAAC"}

package/dist/tools/codex/index.js

@@ -2,13 +2,37 @@ export { codexApplyPatchTool } from "./apply_patch.js";
 export { codexExecCommandTool } from "./exec_command.js";
 export { codexViewImageTool } from "./view_image.js";
 export { codexWriteStdinTool } from "./write_stdin.js";
+export { codexUpdatePlanTool } from "./update_plan.js";
+export { codexRequestUserInputTool } from "./request_user_input.js";
+export { codexSpawnAgentTool } from "./spawn_agent.js";
+export { codexFollowupTaskTool } from "./followup_task.js";
+export { codexInterruptAgentTool } from "./interrupt_agent.js";
+export { codexListAgentsTool } from "./list_agents.js";
+export { codexWaitAgentTool } from "./wait_agent.js";
+export { unifiedExecOutputSchema } from "./unifiedExecOutput.js";
 import { codexApplyPatchTool } from "./apply_patch.js";
 import { codexExecCommandTool } from "./exec_command.js";
 import { codexViewImageTool } from "./view_image.js";
 import { codexWriteStdinTool } from "./write_stdin.js";
+import { codexUpdatePlanTool } from "./update_plan.js";
+import { codexRequestUserInputTool } from "./request_user_input.js";
+import { codexSpawnAgentTool } from "./spawn_agent.js";
+import { codexFollowupTaskTool } from "./followup_task.js";
+import { codexInterruptAgentTool } from "./interrupt_agent.js";
+import { codexListAgentsTool } from "./list_agents.js";
+import { codexWaitAgentTool } from "./wait_agent.js";
 export const codexTools = [
     codexExecCommandTool,
     codexWriteStdinTool,
     codexApplyPatchTool,
     codexViewImageTool,
+    codexUpdatePlanTool,
+    codexRequestUserInputTool,
+];
+export const codexCollaborationTools = [
+    codexSpawnAgentTool,
+    codexFollowupTaskTool,
+    codexWaitAgentTool,
+    codexListAgentsTool,
+    codexInterruptAgentTool,
 ];

package/dist/tools/codex/interrupt_agent.d.ts

@@ -0,0 +1,10 @@
+export declare const codexInterruptAgentTool: import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    target: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    description: import("@sinclair/typebox").TString;
+    path: import("@sinclair/typebox").TString;
+    sessionId: import("@sinclair/typebox").TString;
+    status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"aborted">, import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"error">, import("@sinclair/typebox").TLiteral<"running">]>;
+    taskName: import("@sinclair/typebox").TString;
+}>>;
+//# sourceMappingURL=interrupt_agent.d.ts.map

package/dist/tools/codex/interrupt_agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt_agent.d.ts","sourceRoot":"","sources":["../../../sources/tools/codex/interrupt_agent.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,uBAAuB;;;;;;;;GAalC,CAAC"}

package/dist/tools/codex/interrupt_agent.js

@@ -0,0 +1,17 @@
+import { Type } from "@sinclair/typebox";
+import { defineTool } from "../../agent/types.js";
+import { managedSubagentSchema } from "./subagentSchemas.js";
+import { requireSubagentContext } from "./requireSubagentContext.js";
+export const codexInterruptAgentTool = defineTool({
+    name: "interrupt_agent",
+    label: "interrupt_agent",
+    description: "Stop an existing subagent's current turn. The agent remains available for later follow-up work.",
+    arguments: Type.Object({
+        target: Type.String({ description: "Agent id, task name, or full task path." }),
+    }),
+    returnType: managedSubagentSchema,
+    execute: ({ target }, context) => requireSubagentContext(context).interrupt(target),
+    toLLM: (result) => [{ type: "text", text: JSON.stringify(result) }],
+    toUI: (result) => `Stopped the current turn for ${result.description}.`,
+    locks: [],
+});

package/dist/tools/codex/list_agents.d.ts

@@ -0,0 +1,12 @@
+export declare const codexListAgentsTool: import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    path_prefix: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>, import("@sinclair/typebox").TObject<{
+    agents: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        description: import("@sinclair/typebox").TString;
+        path: import("@sinclair/typebox").TString;
+        sessionId: import("@sinclair/typebox").TString;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"aborted">, import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"error">, import("@sinclair/typebox").TLiteral<"running">]>;
+        taskName: import("@sinclair/typebox").TString;
+    }>>;
+}>>;
+//# sourceMappingURL=list_agents.d.ts.map

package/dist/tools/codex/list_agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_agents.d.ts","sourceRoot":"","sources":["../../../sources/tools/codex/list_agents.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,mBAAmB;;;;;;;;;;GAqB9B,CAAC"}

package/dist/tools/codex/list_agents.js

@@ -0,0 +1,23 @@
+import { Type } from "@sinclair/typebox";
+import { defineTool } from "../../agent/types.js";
+import { managedSubagentSchema } from "./subagentSchemas.js";
+import { requireSubagentContext } from "./requireSubagentContext.js";
+export const codexListAgentsTool = defineTool({
+    name: "list_agents",
+    label: "list_agents",
+    description: "List subagents in the current session tree and their latest status.",
+    arguments: Type.Object({
+        path_prefix: Type.Optional(Type.String({ description: "Full task-path prefix used to filter the list." })),
+    }),
+    returnType: Type.Object({ agents: Type.Array(managedSubagentSchema) }),
+    execute: ({ path_prefix }, context) => ({
+        agents: Array.from(requireSubagentContext(context).list(path_prefix), (agent) => ({
+            ...agent,
+        })),
+    }),
+    toLLM: (result) => [{ type: "text", text: JSON.stringify(result) }],
+    toUI: (result) => result.agents.length === 0
+        ? "No subagents have been started."
+        : `${result.agents.length} subagent${result.agents.length === 1 ? "" : "s"}.`,
+    locks: [],
+});

package/dist/tools/codex/request_user_input.d.ts

@@ -0,0 +1,16 @@
+export declare const codexRequestUserInputTool: import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        id: import("@sinclair/typebox").TString;
+        header: import("@sinclair/typebox").TString;
+        question: import("@sinclair/typebox").TString;
+        options: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            label: import("@sinclair/typebox").TString;
+            description: import("@sinclair/typebox").TString;
+        }>>;
+    }>>;
+}>, import("@sinclair/typebox").TObject<{
+    answers: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TObject<{
+        answers: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    }>>;
+}>>;
+//# sourceMappingURL=request_user_input.d.ts.map

package/dist/tools/codex/request_user_input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request_user_input.d.ts","sourceRoot":"","sources":["../../../sources/tools/codex/request_user_input.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;GA4CpC,CAAC"}

package/dist/tools/codex/request_user_input.js

@@ -0,0 +1,58 @@
+import { Type } from "@sinclair/typebox";
+import { defineTool } from "../../agent/types.js";
+const optionSchema = Type.Object({
+    label: Type.String({ description: "User-facing label (1-5 words)." }),
+    description: Type.String({
+        description: "One short sentence explaining impact or tradeoff if selected.",
+    }),
+}, { additionalProperties: false });
+const questionSchema = Type.Object({
+    id: Type.String({ description: "Stable identifier for mapping answers." }),
+    header: Type.String({
+        maxLength: 12,
+        description: "Short header label shown in the interface, at most 12 characters.",
+    }),
+    question: Type.String({ description: "Single-sentence prompt shown to the user." }),
+    options: Type.Array(optionSchema, {
+        minItems: 2,
+        maxItems: 3,
+        description: "Provide two or three mutually exclusive choices. Do not add an Other option; the interface provides one.",
+    }),
+}, { additionalProperties: false });
+const answerSchema = Type.Object({ answers: Type.Array(Type.String()) });
+export const codexRequestUserInputTool = defineTool({
+    name: "request_user_input",
+    label: "request_user_input",
+    description: "Request user input for one to three short questions and wait for the response.",
+    arguments: Type.Object({
+        questions: Type.Array(questionSchema, { minItems: 1, maxItems: 3 }),
+    }, { additionalProperties: false }),
+    returnType: Type.Object({ answers: Type.Record(Type.String(), answerSchema) }),
+    async execute({ questions }, context, execution) {
+        if (context.userInput === undefined) {
+            throw new Error("Interactive user input is unavailable in this session.");
+        }
+        if (execution.toolCallId === undefined) {
+            throw new Error("Interactive user input requires a tool call identifier.");
+        }
+        if (new Set(questions.map((question) => question.id)).size !== questions.length) {
+            throw new Error("Interactive question identifiers must be unique.");
+        }
+        const response = await context.userInput.request({
+            requestId: execution.toolCallId,
+            questions: questions.map((question) => ({
+                ...question,
+                multiSelect: false,
+            })),
+        }, execution.signal === undefined ? undefined : { signal: execution.signal });
+        return {
+            answers: Object.fromEntries(Object.entries(response.answers).map(([id, answers]) => [
+                id,
+                { answers: [...answers] },
+            ])),
+        };
+    },
+    toLLM: (result) => [{ type: "text", text: JSON.stringify(result) }],
+    toUI: (_result, args) => `Answered ${args.questions.length} question${args.questions.length === 1 ? "" : "s"}`,
+    locks: ["user_input"],
+});

package/dist/tools/codex/requireSubagentContext.d.ts

@@ -0,0 +1,3 @@
+import type { AgentContext, SubagentContext } from "../../agent/index.js";
+export declare function requireSubagentContext(context: AgentContext): SubagentContext;
+//# sourceMappingURL=requireSubagentContext.d.ts.map

package/dist/tools/codex/requireSubagentContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requireSubagentContext.d.ts","sourceRoot":"","sources":["../../../sources/tools/codex/requireSubagentContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE1E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,eAAe,CAK7E"}

package/dist/tools/codex/requireSubagentContext.js

@@ -0,0 +1,6 @@
+export function requireSubagentContext(context) {
+    if (context.subagents === undefined) {
+        throw new Error("Subagent management is unavailable in this session.");
+    }
+    return context.subagents;
+}

package/dist/tools/codex/spawn_agent.d.ts

@@ -0,0 +1,9 @@
+export declare const codexSpawnAgentTool: import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    task_name: import("@sinclair/typebox").TString;
+    message: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    agent_id: import("@sinclair/typebox").TString;
+    path: import("@sinclair/typebox").TString;
+    task_name: import("@sinclair/typebox").TString;
+}>>;
+//# sourceMappingURL=spawn_agent.d.ts.map

package/dist/tools/codex/spawn_agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn_agent.d.ts","sourceRoot":"","sources":["../../../sources/tools/codex/spawn_agent.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,mBAAmB;;;;;;;GA+B9B,CAAC"}

package/dist/tools/codex/spawn_agent.js

@@ -0,0 +1,35 @@
+import { Type } from "@sinclair/typebox";
+import { defineTool } from "../../agent/types.js";
+import { humanizeTaskName } from "./humanizeTaskName.js";
+import { requireSubagentContext } from "./requireSubagentContext.js";
+export const codexSpawnAgentTool = defineTool({
+    name: "spawn_agent",
+    label: "spawn_agent",
+    description: "Spawn a background subagent for a concrete, bounded task. The new agent shares the workspace and reports back when it finishes.",
+    arguments: Type.Object({
+        task_name: Type.String({
+            description: "Lowercase task name using letters, numbers, and underscores.",
+        }),
+        message: Type.String({ description: "Complete instructions for the new agent." }),
+    }),
+    returnType: Type.Object({
+        agent_id: Type.String(),
+        path: Type.String(),
+        task_name: Type.String(),
+    }),
+    execute: async ({ message, task_name }, context, execution) => {
+        const result = await requireSubagentContext(context).spawn({
+            background: true,
+            description: humanizeTaskName(task_name),
+            ...(execution.toolCallId === undefined
+                ? {}
+                : { parentToolCallId: execution.toolCallId }),
+            prompt: message,
+            taskName: task_name,
+        });
+        return { agent_id: result.sessionId, path: result.path, task_name: result.taskName };
+    },
+    toLLM: (result) => [{ type: "text", text: JSON.stringify(result) }],
+    toUI: (result) => `Started background task ${humanizeTaskName(result.task_name)}.`,
+    locks: [],
+});

package/dist/tools/codex/subagentSchemas.d.ts

@@ -0,0 +1,8 @@
+export declare const managedSubagentSchema: import("@sinclair/typebox").TObject<{
+    description: import("@sinclair/typebox").TString;
+    path: import("@sinclair/typebox").TString;
+    sessionId: import("@sinclair/typebox").TString;
+    status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"aborted">, import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"error">, import("@sinclair/typebox").TLiteral<"running">]>;
+    taskName: import("@sinclair/typebox").TString;
+}>;
+//# sourceMappingURL=subagentSchemas.d.ts.map

package/dist/tools/codex/subagentSchemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagentSchemas.d.ts","sourceRoot":"","sources":["../../../sources/tools/codex/subagentSchemas.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB;;;;;;EAWhC,CAAC"}

package/dist/tools/codex/subagentSchemas.js

@@ -0,0 +1,13 @@
+import { Type } from "@sinclair/typebox";
+export const managedSubagentSchema = Type.Object({
+    description: Type.String(),
+    path: Type.String(),
+    sessionId: Type.String(),
+    status: Type.Union([
+        Type.Literal("aborted"),
+        Type.Literal("completed"),
+        Type.Literal("error"),
+        Type.Literal("running"),
+    ]),
+    taskName: Type.String(),
+});

package/dist/tools/codex/unifiedExecOutput.d.ts

@@ -0,0 +1,14 @@
+import { type Static } from "@sinclair/typebox";
+import type { BashSessionSnapshot } from "../../agent/index.js";
+export declare const unifiedExecOutputSchema: import("@sinclair/typebox").TObject<{
+    chunk_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    exit_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    original_token_count: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    output: import("@sinclair/typebox").TString;
+    session_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    wall_time_seconds: import("@sinclair/typebox").TNumber;
+}>;
+export type UnifiedExecOutput = Static<typeof unifiedExecOutputSchema>;
+export declare function formatUnifiedExecOutput(result: UnifiedExecOutput): string;
+export declare function createUnifiedExecOutput(snapshot: BashSessionSnapshot, wallTimeSeconds: number, maxOutputTokens?: number): UnifiedExecOutput;
+//# sourceMappingURL=unifiedExecOutput.d.ts.map

package/dist/tools/codex/unifiedExecOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unifiedExecOutput.d.ts","sourceRoot":"","sources":["../../../sources/tools/codex/unifiedExecOutput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,eAAO,MAAM,uBAAuB;;;;;;;EAOlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEvE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAezE;AAED,wBAAgB,uBAAuB,CACnC,QAAQ,EAAE,mBAAmB,EAC7B,eAAe,EAAE,MAAM,EACvB,eAAe,SAAS,GACzB,iBAAiB,CAkBnB"}

package/dist/tools/codex/unifiedExecOutput.js

@@ -0,0 +1,44 @@
+import { Type } from "@sinclair/typebox";
+export const unifiedExecOutputSchema = Type.Object({
+    chunk_id: Type.Optional(Type.String()),
+    exit_code: Type.Optional(Type.Number()),
+    original_token_count: Type.Optional(Type.Number()),
+    output: Type.String(),
+    session_id: Type.Optional(Type.Number()),
+    wall_time_seconds: Type.Number(),
+});
+export function formatUnifiedExecOutput(result) {
+    const sections = [];
+    if (result.chunk_id !== undefined)
+        sections.push(`Chunk ID: ${result.chunk_id}`);
+    sections.push(`Wall time: ${result.wall_time_seconds.toFixed(4)} seconds`);
+    if (result.exit_code !== undefined) {
+        sections.push(`Process exited with code ${result.exit_code}`);
+    }
+    if (result.session_id !== undefined) {
+        sections.push(`Process running with session ID ${result.session_id}`);
+    }
+    if (result.original_token_count !== undefined) {
+        sections.push(`Original token count: ${result.original_token_count}`);
+    }
+    sections.push("Output:", result.output);
+    return sections.join("\n");
+}
+export function createUnifiedExecOutput(snapshot, wallTimeSeconds, maxOutputTokens = 10_000) {
+    const rawOutput = [snapshot.stdoutDelta, snapshot.stderrDelta]
+        .filter((value) => value.length > 0)
+        .join("\n");
+    const maxCharacters = Math.max(4_000, maxOutputTokens * 4);
+    const output = rawOutput.length <= maxCharacters
+        ? rawOutput
+        : `${rawOutput.slice(0, maxCharacters)}\n[output truncated]`;
+    return {
+        ...(snapshot.status === "running" ? { session_id: snapshot.sessionId } : {}),
+        ...(snapshot.status !== "running" && snapshot.exitCode !== null
+            ? { exit_code: snapshot.exitCode }
+            : {}),
+        original_token_count: Math.ceil(rawOutput.length / 4),
+        output,
+        wall_time_seconds: wallTimeSeconds,
+    };
+}

package/dist/tools/codex/update_plan.d.ts

@@ -0,0 +1,10 @@
+export declare const codexUpdatePlanTool: import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    explanation: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    plan: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        step: import("@sinclair/typebox").TString;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"in_progress">, import("@sinclair/typebox").TLiteral<"completed">]>;
+    }>>;
+}>, import("@sinclair/typebox").TObject<{
+    text: import("@sinclair/typebox").TString;
+}>>;
+//# sourceMappingURL=update_plan.d.ts.map

package/dist/tools/codex/update_plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update_plan.d.ts","sourceRoot":"","sources":["../../../sources/tools/codex/update_plan.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,mBAAmB;;;;;;;;GA+B9B,CAAC"}

package/dist/tools/codex/update_plan.js

@@ -0,0 +1,34 @@
+import { Type } from "@sinclair/typebox";
+import { defineTool } from "../../agent/types.js";
+import { textOutputSchema, toTextBlocks } from "../utils/index.js";
+const planItemSchema = Type.Object({
+    step: Type.String({ description: "Task step text." }),
+    status: Type.Union([Type.Literal("pending"), Type.Literal("in_progress"), Type.Literal("completed")], { description: "Step status." }),
+}, { additionalProperties: false });
+export const codexUpdatePlanTool = defineTool({
+    name: "update_plan",
+    label: "update_plan",
+    description: `Updates the task plan.
+Provide an optional explanation and a list of plan items, each with a step and status.
+At most one step can be in_progress at a time.`,
+    arguments: Type.Object({
+        explanation: Type.Optional(Type.String({ description: "Optional explanation for this plan update." })),
+        plan: Type.Array(planItemSchema, { description: "The list of steps." }),
+    }, { additionalProperties: false }),
+    returnType: textOutputSchema,
+    execute: async ({ plan }) => {
+        const activeSteps = plan.filter((item) => item.status === "in_progress").length;
+        if (activeSteps > 1) {
+            throw new Error("A plan can have at most one step in progress.");
+        }
+        return { text: "Plan updated" };
+    },
+    toLLM: toTextBlocks,
+    toUI: (_result, { plan }) => {
+        const completed = plan.filter((item) => item.status === "completed").length;
+        const active = plan.filter((item) => item.status === "in_progress").length;
+        const pending = plan.filter((item) => item.status === "pending").length;
+        return `Plan updated: ${completed} completed, ${active} in progress, ${pending} pending`;
+    },
+    locks: ["update_plan"],
+});

package/dist/tools/codex/wait_agent.d.ts

@@ -0,0 +1,13 @@
+export declare const codexWaitAgentTool: import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    timeout_ms: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, import("@sinclair/typebox").TObject<{
+    agents: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        description: import("@sinclair/typebox").TString;
+        path: import("@sinclair/typebox").TString;
+        sessionId: import("@sinclair/typebox").TString;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"aborted">, import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"error">, import("@sinclair/typebox").TLiteral<"running">]>;
+        taskName: import("@sinclair/typebox").TString;
+    }>>;
+    timed_out: import("@sinclair/typebox").TBoolean;
+}>>;
+//# sourceMappingURL=wait_agent.d.ts.map

package/dist/tools/codex/wait_agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait_agent.d.ts","sourceRoot":"","sources":["../../../sources/tools/codex/wait_agent.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,kBAAkB;;;;;;;;;;;GA+B7B,CAAC"}

package/dist/tools/codex/wait_agent.js

@@ -0,0 +1,32 @@
+import { Type } from "@sinclair/typebox";
+import { defineTool } from "../../agent/types.js";
+import { managedSubagentSchema } from "./subagentSchemas.js";
+import { requireSubagentContext } from "./requireSubagentContext.js";
+export const codexWaitAgentTool = defineTool({
+    name: "wait_agent",
+    label: "wait_agent",
+    description: "Wait for a subagent status change or completion. Returns early when an agent updates or the wait is cancelled.",
+    arguments: Type.Object({
+        timeout_ms: Type.Optional(Type.Number({
+            description: "Maximum wait in milliseconds, from 0 to 60000.",
+            maximum: 60_000,
+            minimum: 0,
+        })),
+    }),
+    returnType: Type.Object({
+        agents: Type.Array(managedSubagentSchema),
+        timed_out: Type.Boolean(),
+    }),
+    execute: async ({ timeout_ms }, context, execution) => {
+        const result = await requireSubagentContext(context).wait(timeout_ms, execution.signal);
+        return {
+            agents: Array.from(result.agents, (agent) => ({ ...agent })),
+            timed_out: result.timedOut,
+        };
+    },
+    toLLM: (result) => [{ type: "text", text: JSON.stringify(result) }],
+    toUI: (result) => result.timed_out
+        ? "No subagent updates arrived before the wait ended."
+        : `${result.agents.length} subagent update${result.agents.length === 1 ? "" : "s"}.`,
+    locks: [],
+});

package/dist/tools/codex/write_stdin.d.ts

@@ -4,6 +4,11 @@ export declare const codexWriteStdinTool: import("../../agent/types.js").Defined
     yield_time_ms: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
     max_output_tokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
 }>, import("@sinclair/typebox").TObject<{
-    text: import("@sinclair/typebox").TString;
+    chunk_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    exit_code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    original_token_count: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    output: import("@sinclair/typebox").TString;
+    session_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    wall_time_seconds: import("@sinclair/typebox").TNumber;
 }>>;
 //# sourceMappingURL=write_stdin.d.ts.map

package/dist/tools/codex/write_stdin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write_stdin.d.ts","sourceRoot":"","sources":["../../../sources/tools/codex/write_stdin.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,mBAAmB;;;;;;;GAqC9B,CAAC"}
+{"version":3,"file":"write_stdin.d.ts","sourceRoot":"","sources":["../../../sources/tools/codex/write_stdin.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;GAuE9B,CAAC"}