@slopus/rig 0.0.3 → 0.0.6

package/dist/agent/compaction/requestCompactionSummary.js

@@ -0,0 +1,43 @@
+import { formatMessagesForCompaction } from "./formatMessagesForCompaction.js";
+const COMPACTION_SYSTEM_PROMPT = `Create a detailed continuation brief for a coding agent that will continue this conversation without access to the original history.
+
+Preserve the user's requests and constraints, important technical facts, decisions and rationale, files examined or changed, concrete edits, commands and test results, errors and fixes, and all unfinished work. Distinguish completed work from pending work. Include exact identifiers, paths, and short code fragments when they are needed to continue accurately. Do not continue the work or address the user. Return only the continuation brief.`;
+export async function requestCompactionSummary(options) {
+    const streamOptions = {};
+    if (options.effort !== undefined)
+        streamOptions.thinking = options.effort;
+    if (options.signal !== undefined)
+        streamOptions.signal = options.signal;
+    const stream = options.provider.stream(options.model, {
+        systemPrompt: COMPACTION_SYSTEM_PROMPT,
+        messages: [
+            {
+                role: "user",
+                content: formatMessagesForCompaction(options.messages),
+                timestamp: options.now(),
+            },
+        ],
+        tools: [],
+    }, streamOptions);
+    for await (const _event of stream) {
+        if (options.signal?.aborted) {
+            throw new Error("Conversation compaction was stopped.");
+        }
+    }
+    const response = await stream.result();
+    if (response.stopReason === "aborted") {
+        throw new Error("Conversation compaction was stopped.");
+    }
+    if (response.stopReason === "error") {
+        throw new Error(response.errorMessage ?? "The model could not compact this conversation.");
+    }
+    const summary = response.content
+        .filter((block) => block.type === "text")
+        .map((block) => block.text)
+        .join("\n")
+        .trim();
+    if (summary.length === 0) {
+        throw new Error("The model returned an empty conversation summary.");
+    }
+    return summary;
+}

package/dist/agent/context/AgentContext.d.ts

@@ -1,9 +1,17 @@
 import type { BashContext } from "./BashContext.js";
 import type { FileSystemContext } from "./FileSystemContext.js";
+import type { GoalContext } from "./GoalContext.js";
 import type { SubagentContext } from "./SubagentContext.js";
+import type { UserInputContext } from "./UserInputContext.js";
+import type { TaskContext } from "./TaskContext.js";
+import type { PermissionContext } from "../../permissions/index.js";
 export interface AgentContext {
     fs: FileSystemContext;
     bash: BashContext;
+    goals?: GoalContext;
+    permissions?: PermissionContext;
     subagents?: SubagentContext;
+    tasks?: TaskContext;
+    userInput?: UserInputContext;
 }
 //# sourceMappingURL=AgentContext.d.ts.map

package/dist/agent/context/AgentContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/AgentContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,iBAAiB,CAAC;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B"}
+{"version":3,"file":"AgentContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/AgentContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,iBAAiB,CAAC;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAChC"}

package/dist/agent/context/BashContext.d.ts

@@ -3,6 +3,7 @@ export interface BashRunOptions {
     cwd?: string;
     timeoutMs?: number;
     maxOutputBytes?: number;
+    shell?: string;
     signal?: AbortSignal;
 }
 export interface BashRunResult {
@@ -11,8 +12,30 @@ export interface BashRunResult {
     exitCode: number | null;
     timedOut: boolean;
 }
+export type BashSessionStatus = "completed" | "killed" | "running";
+export interface BashSessionSnapshot {
+    command: string;
+    cwd: string;
+    exitCode: number | null;
+    sessionId: number;
+    status: BashSessionStatus;
+    stderr: string;
+    stderrDelta: string;
+    stdout: string;
+    stdoutDelta: string;
+    timedOut: boolean;
+}
+export interface BashSessionReadOptions {
+    signal?: AbortSignal;
+    waitMs?: number;
+}
 export interface BashContext {
     cwd: string;
+    killSession(sessionId: number): Promise<BashSessionSnapshot | undefined>;
+    readSession(sessionId: number, options?: BashSessionReadOptions): Promise<BashSessionSnapshot | undefined>;
     run(options: BashRunOptions): Promise<BashRunResult>;
+    startSession(options: Omit<BashRunOptions, "signal">): Promise<number>;
+    supportsSessionInput: boolean;
+    writeSession(sessionId: number, data: string | Uint8Array): Promise<boolean>;
 }
 //# sourceMappingURL=BashContext.d.ts.map

package/dist/agent/context/BashContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BashContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/BashContext.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,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,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACxD"}
+{"version":3,"file":"BashContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/BashContext.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IACzE,WAAW,CACP,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,sBAAsB,GACjC,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IAC5C,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACrD,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,oBAAoB,EAAE,OAAO,CAAC;IAC9B,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChF"}

package/dist/agent/context/GoalContext.d.ts

@@ -0,0 +1,7 @@
+import type { CreateGoalRequest, GoalStatus, SessionGoal } from "../../goals/index.js";
+export interface GoalContext {
+    create(request: CreateGoalRequest): SessionGoal;
+    get(): SessionGoal | undefined;
+    update(status: Extract<GoalStatus, "blocked" | "complete">): SessionGoal;
+}
+//# sourceMappingURL=GoalContext.d.ts.map

package/dist/agent/context/GoalContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoalContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/GoalContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEvF,MAAM,WAAW,WAAW;IACxB,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,WAAW,CAAC;IAChD,GAAG,IAAI,WAAW,GAAG,SAAS,CAAC;IAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC,GAAG,WAAW,CAAC;CAC5E"}

package/dist/agent/context/GoalContext.js

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

package/dist/agent/context/SubagentContext.d.ts

@@ -1,18 +1,37 @@
-export type SubagentRunStatus = "aborted" | "completed" | "error";
+export type SubagentRunStatus = "aborted" | "completed" | "error" | "running";
+export interface ManagedSubagent {
+    description: string;
+    path: string;
+    sessionId: string;
+    status: SubagentRunStatus;
+    taskName: string;
+}
 export interface SpawnSubagentRequest {
+    background?: boolean;
     description: string;
     parentToolCallId?: string;
     prompt: string;
+    taskName?: string;
 }
 export interface SpawnSubagentResult {
     output: string;
+    path: string;
     sessionId: string;
     status: SubagentRunStatus;
+    taskName: string;
+}
+export interface WaitForSubagentResult {
+    agents: readonly ManagedSubagent[];
+    timedOut: boolean;
 }
 export interface SubagentContext {
     canSpawn: boolean;
     depth: number;
+    followUp(target: string, message: string): ManagedSubagent;
+    interrupt(target: string): ManagedSubagent;
+    list(pathPrefix?: string): readonly ManagedSubagent[];
     maxDepth: number;
     spawn(request: SpawnSubagentRequest, signal?: AbortSignal): Promise<SpawnSubagentResult>;
+    wait(timeoutMs?: number, signal?: AbortSignal): Promise<WaitForSubagentResult>;
 }
 //# sourceMappingURL=SubagentContext.d.ts.map

package/dist/agent/context/SubagentContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SubagentContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/SubagentContext.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC5F"}
+{"version":3,"file":"SubagentContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/SubagentContext.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAAC;IAC3D,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,eAAe,EAAE,CAAC;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACzF,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAClF"}

package/dist/agent/context/TaskContext.d.ts

@@ -0,0 +1,8 @@
+import type { CreateTaskRequest, SessionTask, UpdateTaskRequest, UpdateTaskResult } from "../../tasks/index.js";
+export interface TaskContext {
+    create(request: CreateTaskRequest): SessionTask;
+    get(taskId: string): SessionTask | undefined;
+    list(): readonly SessionTask[];
+    update(taskId: string, request: UpdateTaskRequest): UpdateTaskResult;
+}
+//# sourceMappingURL=TaskContext.d.ts.map

package/dist/agent/context/TaskContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/TaskContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EACnB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,WAAW;IACxB,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,WAAW,CAAC;IAChD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAC7C,IAAI,IAAI,SAAS,WAAW,EAAE,CAAC;IAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAAC;CACxE"}

package/dist/agent/context/TaskContext.js

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

package/dist/agent/context/UserInputContext.d.ts

@@ -0,0 +1,7 @@
+import type { UserInputRequest, UserInputResponse } from "../../user-input/index.js";
+export interface UserInputContext {
+    request(request: UserInputRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<UserInputResponse>;
+}
+//# sourceMappingURL=UserInputContext.d.ts.map

package/dist/agent/context/UserInputContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserInputContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/UserInputContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAErF,MAAM,WAAW,gBAAgB;IAC7B,OAAO,CACH,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACjC"}

package/dist/agent/context/UserInputContext.js

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

package/dist/agent/context/assertCanWritePath.d.ts

@@ -0,0 +1,3 @@
+import type { PermissionMode } from "../../permissions/index.js";
+export declare function assertCanWritePath(cwd: string, targetPath: string, mode: PermissionMode): Promise<void>;
+//# sourceMappingURL=assertCanWritePath.d.ts.map

package/dist/agent/context/assertCanWritePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertCanWritePath.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/assertCanWritePath.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,wBAAsB,kBAAkB,CACpC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/agent/context/assertCanWritePath.js

@@ -0,0 +1,11 @@
+import { isPathInsideWorkspace } from "./isPathInsideWorkspace.js";
+export async function assertCanWritePath(cwd, targetPath, mode) {
+    if (mode === "full_access")
+        return;
+    if (mode === "read_only") {
+        throw new Error("File changes are disabled in read-only mode.");
+    }
+    if (!(await isPathInsideWorkspace(cwd, targetPath))) {
+        throw new Error(`Workspace write mode cannot modify files outside the working directory: ${cwd}.`);
+    }
+}

package/dist/agent/context/createJustBashBashContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createJustBashBashContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/createJustBashBashContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CA6B9E"}
+{"version":3,"file":"createJustBashBashContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/createJustBashBashContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAsC,MAAM,kBAAkB,CAAC;AAoBxF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CA0J9E"}

package/dist/agent/context/createJustBashBashContext.js

@@ -1,7 +1,73 @@
 import { capOutput } from "./capOutput.js";
+const MAX_RETAINED_SESSIONS = 64;
 export function createJustBashBashContext(bash, cwd) {
+    const sessions = new Map();
+    let nextSessionId = 1;
+    const trimSessions = () => {
+        while (sessions.size > MAX_RETAINED_SESSIONS) {
+            const completed = [...sessions.values()].find((session) => session.result !== undefined);
+            if (completed === undefined)
+                return;
+            sessions.delete(completed.sessionId);
+        }
+    };
+    const readSession = async (sessionId, readOptions = {}) => {
+        const session = sessions.get(sessionId);
+        if (session === undefined)
+            return undefined;
+        const waitMs = Math.max(0, readOptions.waitMs ?? 0);
+        if (session.result === undefined && waitMs > 0 && !readOptions.signal?.aborted) {
+            await new Promise((resolveWait) => {
+                let settled = false;
+                let timer;
+                const finish = () => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    if (timer !== undefined)
+                        clearTimeout(timer);
+                    readOptions.signal?.removeEventListener("abort", finish);
+                    resolveWait();
+                };
+                timer = setTimeout(finish, waitMs);
+                readOptions.signal?.addEventListener("abort", finish, { once: true });
+                void session.completion.then(finish);
+                if (readOptions.signal?.aborted)
+                    finish();
+            });
+        }
+        const result = session.result;
+        const stdout = result?.stdout ?? "";
+        const stderr = result?.stderr ?? "";
+        const stdoutDelta = stdout.slice(session.stdoutOffset);
+        const stderrDelta = stderr.slice(session.stderrOffset);
+        session.stdoutOffset = stdout.length;
+        session.stderrOffset = stderr.length;
+        return {
+            command: session.command,
+            cwd: session.cwd,
+            exitCode: result?.exitCode ?? null,
+            sessionId,
+            status: result === undefined ? "running" : session.killed ? "killed" : "completed",
+            stderr,
+            stderrDelta,
+            stdout,
+            stdoutDelta,
+            timedOut: session.timedOut,
+        };
+    };
     return {
         cwd,
+        async killSession(sessionId) {
+            const session = sessions.get(sessionId);
+            if (session === undefined)
+                return undefined;
+            session.killed = true;
+            session.controller.abort();
+            await session.completion;
+            return readSession(sessionId);
+        },
+        readSession,
         async run(runOptions) {
             const controller = new AbortController();
             const timeout = runOptions.timeoutMs === undefined
@@ -27,5 +93,66 @@ export function createJustBashBashContext(bash, cwd) {
                 runOptions.signal?.removeEventListener("abort", abort);
             }
         },
+        async startSession(runOptions) {
+            const controller = new AbortController();
+            const sessionId = nextSessionId;
+            nextSessionId += 1;
+            const session = {
+                command: runOptions.command,
+                completion: Promise.resolve({
+                    exitCode: null,
+                    stderr: "",
+                    stdout: "",
+                    timedOut: false,
+                }),
+                controller,
+                cwd: runOptions.cwd ?? cwd,
+                killed: false,
+                ...(runOptions.maxOutputBytes === undefined
+                    ? {}
+                    : { maxOutputBytes: runOptions.maxOutputBytes }),
+                sessionId,
+                stderrOffset: 0,
+                stdoutOffset: 0,
+                timedOut: false,
+            };
+            session.completion = bash
+                .exec(runOptions.command, {
+                cwd: session.cwd,
+                signal: controller.signal,
+            })
+                .then((result) => ({
+                stdout: capOutput(result.stdout, session.maxOutputBytes),
+                stderr: capOutput(result.stderr, session.maxOutputBytes),
+                exitCode: result.exitCode,
+                timedOut: session.timedOut,
+            }))
+                .catch((error) => ({
+                stdout: "",
+                stderr: error instanceof Error ? error.message : String(error),
+                exitCode: null,
+                timedOut: session.timedOut,
+            }));
+            sessions.set(sessionId, session);
+            if (runOptions.timeoutMs !== undefined) {
+                session.timeout = setTimeout(() => {
+                    session.timedOut = true;
+                    session.killed = true;
+                    controller.abort();
+                }, runOptions.timeoutMs);
+            }
+            void session.completion.then((result) => {
+                session.result = result;
+                if (session.timeout !== undefined)
+                    clearTimeout(session.timeout);
+                trimSessions();
+            });
+            trimSessions();
+            return sessionId;
+        },
+        supportsSessionInput: false,
+        async writeSession() {
+            return false;
+        },
     };
 }

package/dist/agent/context/createNodeAgentContext.d.ts

@@ -1,8 +1,16 @@
 import type { NativeProxessManager } from "../../processes/index.js";
 import type { AgentContext } from "./AgentContext.js";
+import type { GoalContext } from "./GoalContext.js";
+import type { UserInputContext } from "./UserInputContext.js";
+import type { TaskContext } from "./TaskContext.js";
+import { type PermissionMode } from "../../permissions/index.js";
 export interface CreateNodeAgentContextOptions {
     cwd: string;
+    goals?: GoalContext;
     processManager: NativeProxessManager;
+    permissionMode?: PermissionMode;
+    tasks?: TaskContext;
+    userInput?: UserInputContext;
 }
 export declare function createNodeAgentContext(options: CreateNodeAgentContextOptions): AgentContext;
 //# sourceMappingURL=createNodeAgentContext.d.ts.map

package/dist/agent/context/createNodeAgentContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createNodeAgentContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/createNodeAgentContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,MAAM,WAAW,6BAA6B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,oBAAoB,CAAC;CACxC;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,YAAY,CAQ3F"}
+{"version":3,"file":"createNodeAgentContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/createNodeAgentContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAGH,KAAK,cAAc,EACtB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,6BAA6B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,cAAc,EAAE,oBAAoB,CAAC;IACrC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,YAAY,CAiB3F"}

package/dist/agent/context/createNodeAgentContext.js

@@ -1,11 +1,24 @@
 import { createNodeBashContext } from "./createNodeBashContext.js";
 import { createNodeFileSystemContext } from "./createNodeFileSystemContext.js";
+import { createPermissionContext, DEFAULT_PERMISSION_MODE, } from "../../permissions/index.js";
 export function createNodeAgentContext(options) {
-    return {
-        fs: createNodeFileSystemContext(options.cwd),
+    const permissions = createPermissionContext(options.permissionMode ?? DEFAULT_PERMISSION_MODE);
+    const context = {
+        fs: createNodeFileSystemContext(options.cwd, {
+            permissionMode: () => permissions.mode,
+        }),
         bash: createNodeBashContext({
             cwd: options.cwd,
             processManager: options.processManager,
+            permissions,
         }),
+        permissions,
     };
+    if (options.userInput !== undefined)
+        context.userInput = options.userInput;
+    if (options.goals !== undefined)
+        context.goals = options.goals;
+    if (options.tasks !== undefined)
+        context.tasks = options.tasks;
+    return context;
 }

package/dist/agent/context/createNodeBashContext.d.ts

@@ -1,8 +1,10 @@
 import type { NativeProxessManager } from "../../processes/index.js";
+import type { PermissionContext } from "../../permissions/index.js";
 import type { BashContext } from "./BashContext.js";
 export interface CreateNodeBashContextOptions {
     cwd: string;
     processManager: NativeProxessManager;
+    permissions: PermissionContext;
 }
 export declare function createNodeBashContext(options: CreateNodeBashContextOptions): BashContext;
 //# sourceMappingURL=createNodeBashContext.d.ts.map

package/dist/agent/context/createNodeBashContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createNodeBashContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/createNodeBashContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,4BAA4B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,oBAAoB,CAAC;CACxC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,WAAW,CAuBxF"}
+{"version":3,"file":"createNodeBashContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/createNodeBashContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAER,oBAAoB,EAEvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,kBAAkB,CAAC;AAGzE,MAAM,WAAW,4BAA4B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,oBAAoB,CAAC;IACrC,WAAW,EAAE,iBAAiB,CAAC;CAClC;AAiBD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,WAAW,CA4IxF"}

package/dist/agent/context/createNodeBashContext.js

@@ -1,16 +1,84 @@
+import { isAbsolute, resolve } from "node:path";
+import { createSandboxedCommand } from "./createSandboxedCommand.js";
+const MAX_RETAINED_SESSIONS = 64;
 export function createNodeBashContext(options) {
+    const sessions = new Map();
+    let nextSessionId = 1;
+    const runCwd = (cwd) => cwd === undefined ? options.cwd : isAbsolute(cwd) ? cwd : resolve(options.cwd, cwd);
+    const readSession = async (sessionId, readOptions = {}) => {
+        const session = sessions.get(sessionId);
+        if (session === undefined)
+            return undefined;
+        const waitMs = Math.max(0, readOptions.waitMs ?? 0);
+        if (session.result === undefined && waitMs > 0 && !readOptions.signal?.aborted) {
+            await new Promise((resolveWait) => {
+                let settled = false;
+                let timer;
+                const finish = () => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    if (timer !== undefined)
+                        clearTimeout(timer);
+                    readOptions.signal?.removeEventListener("abort", finish);
+                    resolveWait();
+                };
+                timer = setTimeout(finish, waitMs);
+                readOptions.signal?.addEventListener("abort", finish, { once: true });
+                void session.completion.then(finish);
+                if (readOptions.signal?.aborted)
+                    finish();
+            });
+        }
+        const processSnapshot = session.result ?? session.process.snapshot();
+        const stdoutDelta = processSnapshot.stdout.slice(session.stdoutOffset);
+        const stderrDelta = processSnapshot.stderr.slice(session.stderrOffset);
+        session.stdoutOffset = processSnapshot.stdout.length;
+        session.stderrOffset = processSnapshot.stderr.length;
+        return {
+            command: session.command,
+            cwd: session.cwd,
+            exitCode: session.result?.exitCode ?? null,
+            sessionId,
+            status: session.result === undefined
+                ? "running"
+                : session.result.killed
+                    ? "killed"
+                    : "completed",
+            stderr: processSnapshot.stderr,
+            stderrDelta,
+            stdout: processSnapshot.stdout,
+            stdoutDelta,
+            timedOut: session.timedOut,
+        };
+    };
     return {
         cwd: options.cwd,
+        async killSession(sessionId) {
+            const session = sessions.get(sessionId);
+            if (session === undefined)
+                return undefined;
+            await session.process.kill("SIGTERM", { forceAfterMs: 500 });
+            return readSession(sessionId);
+        },
+        readSession,
         async run(runOptions) {
-            const processRunOptions = {
+            const cwd = runCwd(runOptions.cwd);
+            const command = await createSandboxedCommand({
                 command: runOptions.command,
-                cwd: runOptions.cwd ?? options.cwd,
+                cwd: options.cwd,
+                mode: options.permissions.mode,
+            });
+            const processRunOptions = {
+                command,
+                cwd,
                 timeoutMs: runOptions.timeoutMs ?? 120_000,
                 maxOutputBytes: runOptions.maxOutputBytes ?? 512_000,
             };
-            if (runOptions.signal !== undefined) {
+            if (runOptions.signal !== undefined)
                 processRunOptions.signal = runOptions.signal;
-            }
+            if (runOptions.shell !== undefined)
+                processRunOptions.shell = runOptions.shell;
             const result = await options.processManager.run(processRunOptions);
             return {
                 stdout: result.stdout,
@@ -19,5 +87,56 @@ export function createNodeBashContext(options) {
                 timedOut: result.timedOut,
             };
         },
+        async startSession(runOptions) {
+            const cwd = runCwd(runOptions.cwd);
+            const command = await createSandboxedCommand({
+                command: runOptions.command,
+                cwd: options.cwd,
+                mode: options.permissions.mode,
+            });
+            const process = options.processManager.start({
+                cleanupProcessGroupOnExit: true,
+                command,
+                cwd,
+                maxOutputBytes: runOptions.maxOutputBytes ?? 512_000,
+                ...(runOptions.shell === undefined ? {} : { shell: runOptions.shell }),
+            });
+            const sessionId = nextSessionId;
+            nextSessionId += 1;
+            const session = {
+                command: runOptions.command,
+                completion: process.wait(),
+                cwd,
+                process,
+                sessionId,
+                stderrOffset: 0,
+                stdoutOffset: 0,
+                timedOut: false,
+            };
+            sessions.set(sessionId, session);
+            if (runOptions.timeoutMs !== undefined) {
+                session.timeout = setTimeout(() => {
+                    session.timedOut = true;
+                    void process.kill("SIGTERM", { forceAfterMs: 500 });
+                }, runOptions.timeoutMs);
+                session.timeout.unref();
+            }
+            void session.completion.then((result) => {
+                session.result = result;
+                if (session.timeout !== undefined)
+                    clearTimeout(session.timeout);
+            });
+            if (sessions.size > MAX_RETAINED_SESSIONS) {
+                const completed = [...sessions.values()].find((candidate) => candidate.result !== undefined);
+                if (completed !== undefined)
+                    sessions.delete(completed.sessionId);
+            }
+            return sessionId;
+        },
+        supportsSessionInput: true,
+        async writeSession(sessionId, data) {
+            const session = sessions.get(sessionId);
+            return session?.process.writeStdin(data) ?? false;
+        },
     };
 }

package/dist/agent/context/createNodeFileSystemContext.d.ts

@@ -1,6 +1,8 @@
 import type { FileSystemContext } from "./FileSystemContext.js";
+import type { PermissionMode } from "../../permissions/index.js";
 export interface CreateNodeFileSystemContextOptions {
     home?: string;
+    permissionMode?: () => PermissionMode;
 }
 export declare function createNodeFileSystemContext(cwd: string, options?: CreateNodeFileSystemContextOptions): FileSystemContext;
 //# sourceMappingURL=createNodeFileSystemContext.d.ts.map

package/dist/agent/context/createNodeFileSystemContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createNodeFileSystemContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/createNodeFileSystemContext.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,WAAW,kCAAkC;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,2BAA2B,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kCAAuC,GACjD,iBAAiB,CAuCnB"}
+{"version":3,"file":"createNodeFileSystemContext.d.ts","sourceRoot":"","sources":["../../../sources/agent/context/createNodeFileSystemContext.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,WAAW,kCAAkC;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,cAAc,CAAC;CACzC;AAED,wBAAgB,2BAA2B,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kCAAuC,GACjD,iBAAiB,CA+CnB"}