@slopus/rig 0.0.4 → 0.0.6

package/dist/tools/codex/write_stdin.js

@@ -1,29 +1,61 @@
 import { Type } from "@sinclair/typebox";
 import { defineTool } from "../../agent/types.js";
-import { singleLineText, textOutputSchema, toTextBlocks } from "../utils/index.js";
+import { createUnifiedExecOutput, formatUnifiedExecOutput, unifiedExecOutputSchema, } from "./unifiedExecOutput.js";
+import { readSessionWithProgress } from "../utils/readSessionWithProgress.js";
 export const codexWriteStdinTool = defineTool({
     name: "write_stdin",
     label: "write_stdin",
-    description: "Writes characters to an existing unified exec session and returns recent output.",
+    description: "Writes characters to an existing shell session and returns recent output.",
     arguments: Type.Object({
-        session_id: Type.Number({ description: "Identifier of the running unified exec session." }),
+        session_id: Type.Number({ description: "Identifier of the running shell session." }),
         chars: Type.Optional(Type.String({
             description: "Bytes to write to stdin. Defaults to empty, which polls without writing.",
         })),
         yield_time_ms: Type.Optional(Type.Number({
-            description: "Wait before yielding output. Non-empty writes default to 250 ms and cap at 30000 ms; empty polls wait 5000-300000 ms by default.",
+            description: "Wait before yielding output. Non-empty writes default to 250 ms; empty polls default to 5000 ms.",
         })),
         max_output_tokens: Type.Optional(Type.Number({
             description: "Output token budget. Defaults to 10000 tokens; larger requests may be capped by policy.",
         })),
     }),
-    returnType: textOutputSchema,
-    execute: ({ session_id }) => ({
-        text: `No active Codex unified exec session ${session_id}; this implementation runs exec_command to completion.`,
-    }),
-    toLLM: toTextBlocks,
-    toUI: (result, args) => singleLineText(args.chars === undefined || args.chars.length === 0
-        ? `Polled session ${args.session_id}: ${result.text}`
-        : `Sent input to session ${args.session_id}`),
+    returnType: unifiedExecOutputSchema,
+    execute: async ({ session_id, chars = "", yield_time_ms, max_output_tokens }, context, execution) => {
+        const startedAt = Date.now();
+        let interrupted = undefined;
+        if (chars.includes("\u0003")) {
+            interrupted = await context.bash.killSession(session_id);
+            if (interrupted === undefined)
+                throw new Error("The shell session was not found.");
+        }
+        else if (chars.length > 0) {
+            if (!context.bash.supportsSessionInput) {
+                throw new Error("This shell session does not support interactive input.");
+            }
+            const written = await context.bash.writeSession(session_id, chars);
+            if (!written)
+                throw new Error("The shell session is no longer accepting input.");
+        }
+        const defaultWaitMs = chars.length > 0 ? 250 : 5_000;
+        const maximumWaitMs = chars.length > 0 ? 30_000 : 300_000;
+        const snapshot = interrupted ??
+            (await readSessionWithProgress({
+                bash: context.bash,
+                ...(execution.onProgress === undefined ? {} : { onProgress: execution.onProgress }),
+                sessionId: session_id,
+                ...(execution.signal === undefined ? {} : { signal: execution.signal }),
+                waitMs: Math.max(0, Math.min(maximumWaitMs, yield_time_ms ?? defaultWaitMs)),
+            }));
+        if (snapshot === undefined)
+            throw new Error("The shell session was not found.");
+        return createUnifiedExecOutput(snapshot, (Date.now() - startedAt) / 1_000, max_output_tokens);
+    },
+    toLLM: (result) => [{ type: "text", text: formatUnifiedExecOutput(result) }],
+    toUI: (result, args) => args.chars === undefined || args.chars.length === 0
+        ? result.session_id === undefined
+            ? "The shell command has finished."
+            : "Checked the running shell command."
+        : result.session_id === undefined
+            ? "Sent input; the shell command has finished."
+            : "Sent input to the running shell command.",
     locks: [],
 });

package/dist/tools/goals/create_goal.d.ts

@@ -0,0 +1,11 @@
+export declare const createGoalTool: import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    objective: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    goal: import("@sinclair/typebox").TObject<{
+        createdAt: import("@sinclair/typebox").TNumber;
+        objective: import("@sinclair/typebox").TString;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"paused">, import("@sinclair/typebox").TLiteral<"blocked">, import("@sinclair/typebox").TLiteral<"complete">]>;
+        updatedAt: import("@sinclair/typebox").TNumber;
+    }>;
+}>>;
+//# sourceMappingURL=create_goal.d.ts.map

package/dist/tools/goals/create_goal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_goal.d.ts","sourceRoot":"","sources":["../../../sources/tools/goals/create_goal.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc;;;;;;;;;GA4BzB,CAAC"}

package/dist/tools/goals/create_goal.js

@@ -0,0 +1,29 @@
+import { Type } from "@sinclair/typebox";
+import { defineTool } from "../../agent/types.js";
+import { sessionGoalSchema } from "./goalSchemas.js";
+export const createGoalTool = defineTool({
+    name: "create_goal",
+    label: "create_goal",
+    description: `Create a persistent goal only when the user explicitly asks for long-running goal execution.
+Do not infer a goal from an ordinary task. A new goal cannot replace an unfinished goal.`,
+    arguments: Type.Object({
+        objective: Type.String({
+            description: "The concrete objective to pursue until it is complete or blocked.",
+        }),
+    }, { additionalProperties: false }),
+    returnType: Type.Object({ goal: sessionGoalSchema }),
+    execute({ objective }, context) {
+        if (context.goals === undefined) {
+            throw new Error("Goal tracking is unavailable in this session.");
+        }
+        return { goal: context.goals.create({ objective }) };
+    },
+    toLLM: ({ goal }) => [
+        {
+            type: "text",
+            text: `Goal created and active.\nObjective: ${goal.objective}`,
+        },
+    ],
+    toUI: ({ goal }) => `Started goal: ${goal.objective}`,
+    locks: ["goal"],
+});

package/dist/tools/goals/get_goal.d.ts

@@ -0,0 +1,9 @@
+export declare const getGoalTool: import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{}>, import("@sinclair/typebox").TObject<{
+    goal: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        createdAt: import("@sinclair/typebox").TNumber;
+        objective: import("@sinclair/typebox").TString;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"paused">, import("@sinclair/typebox").TLiteral<"blocked">, import("@sinclair/typebox").TLiteral<"complete">]>;
+        updatedAt: import("@sinclair/typebox").TNumber;
+    }>, import("@sinclair/typebox").TNull]>;
+}>>;
+//# sourceMappingURL=get_goal.d.ts.map

package/dist/tools/goals/get_goal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_goal.d.ts","sourceRoot":"","sources":["../../../sources/tools/goals/get_goal.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW;;;;;;;GAuBtB,CAAC"}

package/dist/tools/goals/get_goal.js

@@ -0,0 +1,26 @@
+import { Type } from "@sinclair/typebox";
+import { defineTool } from "../../agent/types.js";
+import { sessionGoalSchema } from "./goalSchemas.js";
+export const getGoalTool = defineTool({
+    name: "get_goal",
+    label: "get_goal",
+    description: "Get the persistent goal for this session, including its objective and status.",
+    arguments: Type.Object({}, { additionalProperties: false }),
+    returnType: Type.Object({ goal: Type.Union([sessionGoalSchema, Type.Null()]) }),
+    execute(_args, context) {
+        if (context.goals === undefined) {
+            throw new Error("Goal tracking is unavailable in this session.");
+        }
+        return { goal: context.goals.get() ?? null };
+    },
+    toLLM: ({ goal }) => [
+        {
+            type: "text",
+            text: goal === null
+                ? "This session has no goal."
+                : `Goal status: ${goal.status}\nObjective: ${goal.objective}`,
+        },
+    ],
+    toUI: ({ goal }) => (goal === null ? "No active goal" : `Read ${goal.status} goal`),
+    locks: [],
+});

package/dist/tools/goals/goalSchemas.d.ts

@@ -0,0 +1,8 @@
+export declare const goalStatusSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"paused">, import("@sinclair/typebox").TLiteral<"blocked">, import("@sinclair/typebox").TLiteral<"complete">]>;
+export declare const sessionGoalSchema: import("@sinclair/typebox").TObject<{
+    createdAt: import("@sinclair/typebox").TNumber;
+    objective: import("@sinclair/typebox").TString;
+    status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"paused">, import("@sinclair/typebox").TLiteral<"blocked">, import("@sinclair/typebox").TLiteral<"complete">]>;
+    updatedAt: import("@sinclair/typebox").TNumber;
+}>;
+//# sourceMappingURL=goalSchemas.d.ts.map

package/dist/tools/goals/goalSchemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goalSchemas.d.ts","sourceRoot":"","sources":["../../../sources/tools/goals/goalSchemas.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,yOAK3B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;EAQ7B,CAAC"}

package/dist/tools/goals/goalSchemas.js

@@ -0,0 +1,13 @@
+import { Type } from "@sinclair/typebox";
+export const goalStatusSchema = Type.Union([
+    Type.Literal("active"),
+    Type.Literal("paused"),
+    Type.Literal("blocked"),
+    Type.Literal("complete"),
+]);
+export const sessionGoalSchema = Type.Object({
+    createdAt: Type.Number(),
+    objective: Type.String(),
+    status: goalStatusSchema,
+    updatedAt: Type.Number(),
+}, { additionalProperties: false });

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

@@ -0,0 +1,30 @@
+export { createGoalTool } from "./create_goal.js";
+export { getGoalTool } from "./get_goal.js";
+export { updateGoalTool } from "./update_goal.js";
+export declare const goalTools: readonly [import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    objective: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    goal: import("@sinclair/typebox").TObject<{
+        createdAt: import("@sinclair/typebox").TNumber;
+        objective: import("@sinclair/typebox").TString;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"paused">, import("@sinclair/typebox").TLiteral<"blocked">, import("@sinclair/typebox").TLiteral<"complete">]>;
+        updatedAt: import("@sinclair/typebox").TNumber;
+    }>;
+}>>, import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{}>, import("@sinclair/typebox").TObject<{
+    goal: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        createdAt: import("@sinclair/typebox").TNumber;
+        objective: import("@sinclair/typebox").TString;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"paused">, import("@sinclair/typebox").TLiteral<"blocked">, import("@sinclair/typebox").TLiteral<"complete">]>;
+        updatedAt: import("@sinclair/typebox").TNumber;
+    }>, import("@sinclair/typebox").TNull]>;
+}>>, import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"complete">, import("@sinclair/typebox").TLiteral<"blocked">]>;
+}>, import("@sinclair/typebox").TObject<{
+    goal: import("@sinclair/typebox").TObject<{
+        createdAt: import("@sinclair/typebox").TNumber;
+        objective: import("@sinclair/typebox").TString;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"paused">, import("@sinclair/typebox").TLiteral<"blocked">, import("@sinclair/typebox").TLiteral<"complete">]>;
+        updatedAt: import("@sinclair/typebox").TNumber;
+    }>;
+}>>];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../sources/tools/goals/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMlD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;IAAyD,CAAC"}

package/dist/tools/goals/index.js

@@ -0,0 +1,7 @@
+export { createGoalTool } from "./create_goal.js";
+export { getGoalTool } from "./get_goal.js";
+export { updateGoalTool } from "./update_goal.js";
+import { createGoalTool } from "./create_goal.js";
+import { getGoalTool } from "./get_goal.js";
+import { updateGoalTool } from "./update_goal.js";
+export const goalTools = [createGoalTool, getGoalTool, updateGoalTool];

package/dist/tools/goals/update_goal.d.ts

@@ -0,0 +1,11 @@
+export declare const updateGoalTool: import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"complete">, import("@sinclair/typebox").TLiteral<"blocked">]>;
+}>, import("@sinclair/typebox").TObject<{
+    goal: import("@sinclair/typebox").TObject<{
+        createdAt: import("@sinclair/typebox").TNumber;
+        objective: import("@sinclair/typebox").TString;
+        status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"paused">, import("@sinclair/typebox").TLiteral<"blocked">, import("@sinclair/typebox").TLiteral<"complete">]>;
+        updatedAt: import("@sinclair/typebox").TNumber;
+    }>;
+}>>;
+//# sourceMappingURL=update_goal.d.ts.map

package/dist/tools/goals/update_goal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update_goal.d.ts","sourceRoot":"","sources":["../../../sources/tools/goals/update_goal.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc;;;;;;;;;GAiCzB,CAAC"}

package/dist/tools/goals/update_goal.js

@@ -0,0 +1,33 @@
+import { Type } from "@sinclair/typebox";
+import { defineTool } from "../../agent/types.js";
+import { sessionGoalSchema } from "./goalSchemas.js";
+export const updateGoalTool = defineTool({
+    name: "update_goal",
+    label: "update_goal",
+    description: `Mark the persistent goal complete or blocked.
+Use complete only when the full objective is achieved and verified with no required work remaining.
+Use blocked only when meaningful progress cannot continue without user input or an external state change.
+Pausing, resuming, and clearing a goal are controlled by the user.`,
+    arguments: Type.Object({
+        status: Type.Union([Type.Literal("complete"), Type.Literal("blocked")], {
+            description: "The terminal status for the current goal.",
+        }),
+    }, { additionalProperties: false }),
+    returnType: Type.Object({ goal: sessionGoalSchema }),
+    execute({ status }, context) {
+        if (context.goals === undefined) {
+            throw new Error("Goal tracking is unavailable in this session.");
+        }
+        return { goal: context.goals.update(status) };
+    },
+    toLLM: ({ goal }) => [
+        {
+            type: "text",
+            text: goal.status === "complete"
+                ? "Goal marked complete."
+                : "Goal marked blocked. Explain the blocker and what the user needs to provide or change.",
+        },
+    ],
+    toUI: ({ goal }) => (goal.status === "complete" ? "Completed goal" : "Blocked goal"),
+    locks: ["goal"],
+});

package/dist/tools/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./claude/index.js";
 export * from "./codex/index.js";
+export * from "./goals/index.js";
 export * from "./pi/index.js";
 export * from "./testing/createJustBashToolHarness.js";
 export * from "./utils/index.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../sources/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,wCAAwC,CAAC;AACvD,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../sources/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,wCAAwC,CAAC;AACvD,cAAc,kBAAkB,CAAC"}

package/dist/tools/index.js

@@ -1,5 +1,6 @@
 export * from "./claude/index.js";
 export * from "./codex/index.js";
+export * from "./goals/index.js";
 export * from "./pi/index.js";
 export * from "./testing/createJustBashToolHarness.js";
 export * from "./utils/index.js";

package/dist/tools/pi/bash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../sources/tools/pi/bash.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,UAAU;;;;;GAyBrB,CAAC"}
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../sources/tools/pi/bash.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,UAAU;;;;;GA0BrB,CAAC"}

package/dist/tools/pi/bash.js

@@ -16,6 +16,8 @@ export const piBashTool = defineTool({
         const options = { maxOutputBytes: 512_000 };
         if (timeout !== undefined)
             options.timeoutMs = timeout * 1000;
+        if (execution.onProgress !== undefined)
+            options.onProgress = execution.onProgress;
         if (execution.signal !== undefined)
             options.signal = execution.signal;
         const result = await runShellCommand(command, options, context);

package/dist/tools/utils/readSessionWithProgress.d.ts

@@ -0,0 +1,9 @@
+import type { BashContext, BashSessionSnapshot } from "../../agent/index.js";
+export declare function readSessionWithProgress(options: {
+    bash: BashContext;
+    onProgress?: (display: string) => void;
+    sessionId: number;
+    signal?: AbortSignal;
+    waitMs?: number;
+}): Promise<BashSessionSnapshot | undefined>;
+//# sourceMappingURL=readSessionWithProgress.d.ts.map

package/dist/tools/utils/readSessionWithProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readSessionWithProgress.d.ts","sourceRoot":"","sources":["../../../sources/tools/utils/readSessionWithProgress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAI7E,wBAAsB,uBAAuB,CAAC,OAAO,EAAE;IACnD,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CA4B3C"}

package/dist/tools/utils/readSessionWithProgress.js

@@ -0,0 +1,27 @@
+const PROGRESS_POLL_MS = 100;
+export async function readSessionWithProgress(options) {
+    const deadline = options.waitMs === undefined ? undefined : Date.now() + options.waitMs;
+    let stderrDelta = "";
+    let stdoutDelta = "";
+    let snapshot;
+    do {
+        const remaining = deadline === undefined ? PROGRESS_POLL_MS : Math.max(0, deadline - Date.now());
+        snapshot = await options.bash.readSession(options.sessionId, {
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+            waitMs: Math.min(PROGRESS_POLL_MS, remaining),
+        });
+        if (snapshot === undefined)
+            return undefined;
+        stdoutDelta += snapshot.stdoutDelta;
+        stderrDelta += snapshot.stderrDelta;
+        const progress = [stdoutDelta, stderrDelta].filter(Boolean).join("\n");
+        if (progress.length > 0)
+            options.onProgress?.(progress.slice(-2_000));
+        if (snapshot.status !== "running" ||
+            options.signal?.aborted ||
+            (deadline !== undefined && remaining === 0)) {
+            break;
+        }
+    } while (deadline === undefined || Date.now() < deadline);
+    return snapshot === undefined ? undefined : { ...snapshot, stderrDelta, stdoutDelta };
+}

package/dist/tools/utils/shell.d.ts

@@ -2,6 +2,7 @@ import { type Static } from "@sinclair/typebox";
 import type { AgentContext } from "../../agent/context/AgentContext.js";
 import type { ContentBlock } from "../../agent/types.js";
 export declare const shellToolOutputSchema: import("@sinclair/typebox").TObject<{
+    backgroundTaskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     stdout: import("@sinclair/typebox").TString;
     stderr: import("@sinclair/typebox").TString;
     exitCode: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
@@ -13,6 +14,7 @@ export interface RunCommandOptions {
     cwd?: string;
     timeoutMs?: number;
     maxOutputBytes?: number;
+    onProgress?: (display: string) => void;
     signal?: AbortSignal;
 }
 export interface RunCommandResult {

package/dist/tools/utils/shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../sources/tools/utils/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,eAAO,MAAM,qBAAqB;;;;;EAKhC,CAAC;AAEH,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,eAAe,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,MAAM,CAAC,YAAK,EACzD,OAAO,EAAE,YAAY,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAS3B;AAED,wBAAsB,UAAU,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,YAAY,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAS3B;AAUD,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,MAAM,CAAC,OAAO,qBAAqB,CAAC,GAC7C,SAAS,YAAY,EAAE,CAQzB"}
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../sources/tools/utils/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,eAAO,MAAM,qBAAqB;;;;;;EAMhC,CAAC;AAEH,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,eAAe,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,MAAM,CAAC,YAAK,EACzD,OAAO,EAAE,YAAY,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAiC3B;AAED,wBAAsB,UAAU,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,YAAY,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAS3B;AAUD,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,MAAM,CAAC,OAAO,qBAAqB,CAAC,GAC7C,SAAS,YAAY,EAAE,CAgBzB"}

package/dist/tools/utils/shell.js

@@ -1,5 +1,7 @@
 import { Type } from "@sinclair/typebox";
+import { readSessionWithProgress } from "./readSessionWithProgress.js";
 export const shellToolOutputSchema = Type.Object({
+    backgroundTaskId: Type.Optional(Type.String()),
     stdout: Type.String(),
     stderr: Type.String(),
     exitCode: Type.Union([Type.Number(), Type.Null()]),
@@ -16,6 +18,33 @@ export async function runShellCommand(command, options = {}, context) {
         runOptions.maxOutputBytes = options.maxOutputBytes;
     if (options.signal !== undefined)
         runOptions.signal = options.signal;
+    if (options.onProgress !== undefined) {
+        const { signal: _signal, ...sessionOptions } = runOptions;
+        const sessionId = await context.bash.startSession(sessionOptions);
+        const abort = () => void context.bash.killSession(sessionId);
+        options.signal?.addEventListener("abort", abort, { once: true });
+        if (options.signal?.aborted)
+            abort();
+        try {
+            const snapshot = await readSessionWithProgress({
+                bash: context.bash,
+                onProgress: options.onProgress,
+                sessionId,
+                ...(options.signal === undefined ? {} : { signal: options.signal }),
+            });
+            if (snapshot === undefined)
+                throw new Error("The shell session was not found.");
+            return {
+                stdout: snapshot.stdout,
+                stderr: snapshot.stderr,
+                exitCode: snapshot.exitCode,
+                timedOut: snapshot.timedOut,
+            };
+        }
+        finally {
+            options.signal?.removeEventListener("abort", abort);
+        }
+    }
     return context.bash.run(runOptions);
 }
 export async function runCommand(options, context) {
@@ -38,6 +67,14 @@ function shellQuote(value) {
     return `'${value.replaceAll("'", "'\\''")}'`;
 }
 export function shellOutputToText(result) {
+    if (result.backgroundTaskId !== undefined) {
+        return [
+            {
+                type: "text",
+                text: `Command running in background with task ID ${result.backgroundTaskId}. Use TaskOutput to read its output or TaskStop to stop it.`,
+            },
+        ];
+    }
     const chunks = [
         result.stdout ? `stdout:\n${result.stdout}` : "",
         result.stderr ? `stderr:\n${result.stderr}` : "",

package/dist/tools/utils/summarizeShellOutput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summarizeShellOutput.d.ts","sourceRoot":"","sources":["../../../sources/tools/utils/summarizeShellOutput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAIxD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,qBAAqB,CAAC,GAAG,MAAM,CAQzF"}
+{"version":3,"file":"summarizeShellOutput.d.ts","sourceRoot":"","sources":["../../../sources/tools/utils/summarizeShellOutput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAIxD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,qBAAqB,CAAC,GAAG,MAAM,CASzF"}

package/dist/tools/utils/summarizeShellOutput.js

@@ -1,6 +1,8 @@
 import { singleLineText } from "./singleLineText.js";
 import { summarizeTextOutput } from "./summarizeTextOutput.js";
 export function summarizeShellOutput(result) {
+    if (result.backgroundTaskId !== undefined)
+        return "Command started in the background.";
     const suffix = result.timedOut
         ? " (timed out)"
         : result.exitCode !== null && result.exitCode !== 0

package/dist/user-input/index.d.ts

@@ -0,0 +1,2 @@
+export type { UserInputOption, UserInputQuestion, UserInputRequest, UserInputResponse, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/user-input/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../sources/user-input/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GACpB,MAAM,YAAY,CAAC"}

package/dist/user-input/index.js

@@ -0,0 +1 @@
+export {};

package/dist/user-input/types.d.ts

@@ -0,0 +1,19 @@
+export interface UserInputOption {
+    description: string;
+    label: string;
+}
+export interface UserInputQuestion {
+    header: string;
+    id: string;
+    multiSelect: boolean;
+    options: readonly UserInputOption[];
+    question: string;
+}
+export interface UserInputRequest {
+    questions: readonly UserInputQuestion[];
+    requestId: string;
+}
+export interface UserInputResponse {
+    answers: Readonly<Record<string, readonly string[]>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/user-input/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../sources/user-input/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;CACxD"}

package/dist/user-input/types.js

@@ -0,0 +1 @@
+export {};

package/dist/web/assets/highlighted-body-OFNGDK62-BuJOCQJD.js

@@ -0,0 +1 @@
+import{r,R as x,L as d,j as f,A as p}from"./index-BC99-iZC.js";var N=({code:i,language:e,raw:a,className:u,startLine:n,lineNumbers:g,...m})=>{let{shikiTheme:l}=r.useContext(x),s=d(),[h,t]=r.useState(a);return r.useEffect(()=>{if(!s){t(a);return}let o=s.highlight({code:i,language:e,themes:l},c=>{t(c)});o&&t(o)},[i,e,l,s,a]),f.jsx(p,{className:u,language:e,lineNumbers:g,result:h,startLine:n,...m})};export{N as HighlightedCodeBlockBody};

package/dist/web/assets/highlighted-body-OFNGDK62-TwhCqUaJ.js

@@ -0,0 +1 @@
+import{r,R as x,L as d,j as f,A as p}from"./index-BZN9jSiw.js";var N=({code:i,language:e,raw:a,className:u,startLine:n,lineNumbers:g,...m})=>{let{shikiTheme:l}=r.useContext(x),s=d(),[h,t]=r.useState(a);return r.useEffect(()=>{if(!s){t(a);return}let o=s.highlight({code:i,language:e,themes:l},c=>{t(c)});o&&t(o)},[i,e,l,s,a]),f.jsx(p,{className:u,language:e,lineNumbers:g,result:h,startLine:n,...m})};export{N as HighlightedCodeBlockBody};