@astralyn/pi 0.87.6 → 0.99.0

package/dist/core/{background → tasks}/types.d.ts

@@ -1,71 +1,78 @@
 import type { AgentToolResult } from "@earendil-works/pi-agent-core";
 import type { Usage } from "@earendil-works/pi-ai/compat";
-export type BackgroundKind = "bash" | "subagent";
-export type BackgroundMode = "foreground" | "background";
-export type BackgroundTerminalStatus = "completed" | "partial" | "failed" | "cancelled" | "timeout";
-export type BackgroundStatus = "queued" | "running" | "stopping" | BackgroundTerminalStatus;
+import type { TaskViewRegistry } from "./view.ts";
+import type { TaskViewData } from "./view-data.ts";
+/** An executor-owned source label, never a dispatch key for the runtime. */
+export type TaskKind = string;
+export type TaskMode = "foreground" | "background";
+export type TaskTerminalStatus = "completed" | "partial" | "failed" | "cancelled" | "timeout";
+export type TaskStatus = "queued" | "running" | "stopping" | TaskTerminalStatus;
 /** A bounded snapshot; truncation is recorded at the source, never inferred from text. */
-export interface BackgroundText {
+export interface TaskText {
     text: string;
     truncated: boolean;
 }
-export interface BackgroundWorkerReport {
+export interface TaskItemReport {
     id: string;
     label: string;
-    profile: string;
+    category: string;
     description: string;
     status: string;
-    report: BackgroundText;
+    report: TaskText;
     error?: string;
 }
 /** A serializable, domain-owned projection. No extension-private renderer imports. */
-export interface BackgroundWorker extends BackgroundWorkerReport {
-    prompt: string;
+export interface TaskItem extends TaskItemReport {
+    input: string;
     activity: string;
-    model?: string;
+    context?: string;
     usage?: string;
 }
-export interface BackgroundProjection {
+export interface TaskProjection {
+    nextStep?: string;
     text?: string;
     shell?: {
         name: string;
-        output: BackgroundText;
+        output: TaskText;
     };
-    workers?: BackgroundWorker[];
+    items?: TaskItem[];
 }
-interface BackgroundCompletionBase {
+interface TaskCompletionBase {
+    kind: string;
     version: 1;
     taskId: string;
     title: string;
-    status: BackgroundTerminalStatus;
+    status: TaskTerminalStatus;
     startedAt: number;
     endedAt: number;
     error?: string;
+    nextStep?: string;
 }
 /** Self-contained completion-message details. No live handles, tool-private details or accounting. */
-export type BackgroundCompletionSnapshot = BackgroundCompletionBase & ({
-    kind: "bash";
+export type TaskCompletionSnapshot = TaskCompletionBase & ({
+    format: "log";
     shell?: string;
-    command?: BackgroundText;
+    command?: TaskText;
     cwd?: string;
     outputPath?: string;
     /** Process exit code: a number, or null when signal-reaped. */
     exitCode?: number | null;
-    output: BackgroundText;
+    output: TaskText;
 } | {
-    kind: "subagent";
-    workers: BackgroundWorkerReport[];
+    format: "report";
+    items: TaskItemReport[];
     /** Plain fallback when an executor has no worker projection. */
-    output?: BackgroundText;
+    output?: TaskText;
 });
-export interface BackgroundTask {
+export interface TaskSnapshot {
     id: string;
-    kind: BackgroundKind;
+    kind: TaskKind;
+    format?: "log" | "report";
     title: string;
     toolCallId: string;
     anchorId: string | null;
-    mode: BackgroundMode;
-    status: BackgroundStatus;
+    mode: TaskMode;
+    status: TaskStatus;
     startedAt: number;
     endedAt?: number;
     command?: string;
@@ -74,14 +81,15 @@ export interface BackgroundTask {
     /** Process exit code (bash): a number, or null when signal-reaped. Absent while running or unreported. */
     exitCode?: number | null;
     outputPath?: string;
-    projection?: BackgroundProjection;
+    projection?: TaskProjection;
+    viewData?: TaskViewData;
     result?: AgentToolResult<unknown>;
     resultTruncated?: boolean;
     error?: string;
 }
-export interface BackgroundCompletion<T> {
+export interface TaskCompletion<T> {
     result: AgentToolResult<T>;
-    status?: BackgroundTerminalStatus;
+    status?: TaskTerminalStatus;
     /** Terminal diagnostic, stored independently of log slices and bounded to 4096 bytes. */
     error?: string;
     /** Process exit code (bash): a number, or null when signal-reaped. */
@@ -89,10 +97,12 @@ export interface BackgroundCompletion<T> {
     /** Authoritative cumulative usage; overrides result.usage and any published snapshot. */
     usage?: Usage;
 }
-export interface BackgroundControl<T> {
+export interface TaskControl<T> {
     readonly id: string;
     readonly signal: AbortSignal;
-    readonly mode: BackgroundMode;
+    readonly mode: TaskMode;
+    onModeChange(listener: (mode: TaskMode) => void): () => void;
+    requestCancel(): boolean;
     /** Accept only after whole-invocation preflight; required before returning a handoff. */
     accept(): void;
     /**
@@ -100,12 +110,15 @@ export interface BackgroundControl<T> {
      * published usage is settled once on rejection (never inferred from details).
      * Final completion.usage, then completion.result.usage, override that snapshot.
      */
-    publish(result: AgentToolResult<T>, projection?: BackgroundProjection): void;
+    publish(result: AgentToolResult<T>, projection?: TaskProjection): void;
+    /** Publish bounded, versioned display data without changing tool results or completion delivery. */
+    publishView(data: TaskViewData): void;
     /** Register once; cleanup must own only this exclusively-created file and close its writer first. */
     setOutputPath(path: string, cleanup?: () => void | Promise<void>): void;
 }
-export interface BackgroundExecution<T> {
-    kind: BackgroundKind;
+export interface TaskExecution<T> {
+    kind: TaskKind;
+    format?: "log" | "report";
     title: string;
     toolCallId: string;
     command?: string;
@@ -113,19 +126,19 @@ export interface BackgroundExecution<T> {
     background?: boolean;
     signal?: AbortSignal;
     onUpdate?: (result: AgentToolResult<T>) => void;
-    run(control: BackgroundControl<T>): Promise<BackgroundCompletion<T>>;
+    run(control: TaskControl<T>): Promise<TaskCompletion<T>>;
 }
-export type BackgroundToolOutcome<T> = {
+export type TaskToolOutcome<T> = {
     kind: "result";
     result: AgentToolResult<T>;
-    status?: BackgroundTerminalStatus;
+    status?: TaskTerminalStatus;
     error?: string;
 } | {
     kind: "background";
-    task: BackgroundTask;
+    task: TaskSnapshot;
 };
-export interface BackgroundRead {
-    task: BackgroundTask;
+export interface TaskRead {
+    task: TaskSnapshot;
     text: string;
     /** Bounded log-read/expiry diagnostic, independent of text slicing and byte offsets. */
     readError?: string;
@@ -134,45 +147,50 @@ export interface BackgroundRead {
     fromByte?: number;
 }
 /** Session-bound public capability. Captured instances close on runtime replacement. */
-export interface BackgroundContext {
+export interface TasksContext {
+    readonly views: TaskViewRegistry;
     readonly enabled: boolean;
     readonly closed?: boolean;
-    execute<T>(execution: BackgroundExecution<T>): Promise<BackgroundToolOutcome<T>>;
-    list(): BackgroundTask[];
-    get(id: string): BackgroundTask;
+    execute<T>(execution: TaskExecution<T>): Promise<TaskToolOutcome<T>>;
+    list(): TaskSnapshot[];
+    get(id: string): TaskSnapshot;
     read(id: string, options?: {
         mode?: "head" | "tail";
         bytes?: number;
         sinceBytes?: number;
-    }): Promise<BackgroundRead>;
+    }): Promise<TaskRead>;
     /** Observation only: terminal delivery is acknowledged by the host via markDelivered after result persistence. */
-    wait(id: string, timeoutMs?: number, signal?: AbortSignal): Promise<BackgroundTask>;
+    wait(id: string, timeoutMs?: number, signal?: AbortSignal): Promise<TaskSnapshot>;
     kill(id: string): boolean;
     /** Move every running foreground execution to the background; returns how many moved. */
     detachForeground(): number;
+    detach(id: string): boolean;
     subscribe(listener: () => void): () => void;
-    pin(id: string): () => void;
+    /** Keep retained output available without delaying completion delivery. */
+    retain(id: string): () => void;
+    /** Hold automatic delivery while preparing a result for the host to persist. */
+    holdDelivery(id: string): () => void;
 }
-export interface BackgroundServiceOptions {
+export interface TaskRuntimeOptions {
     enabled?: boolean;
-    role?: "main" | "subagent";
+    backgroundAllowed?: boolean;
     anchor?: () => string | null;
     maxActive?: number;
-    /** Per-history limit: foreground shells and background tasks/all subagents each get this allowance. */
+    /** Per-history limit: foreground logs and other managed tasks each get this allowance. */
     maxHistory?: number;
     /** Best-effort cleanup errors, bounded to 4096 bytes; no retries or execution failure. */
     onCleanupError?: (message: string) => void;
     /** Synchronous persistence before terminal observers or notifications. */
-    onSettled?: (task: BackgroundTask, usage: Usage | undefined) => void;
+    onSettled?: (task: TaskSnapshot, usage: Usage | undefined) => void;
 }
-export declare const SUBAGENT_BACKGROUND_REJECTION = "Background execution is not available inside subagents. Run this command with background: false (or omit background). Only the parent agent or the user can background the entire subagent invocation. No command was started.";
-export declare function isBackgroundTerminal(status: BackgroundStatus): boolean;
-/** Foreground shell logs have their own history; subagent groups remain inspectable in either mode. */
-export declare function isForegroundShellTask(task: Pick<BackgroundTask, "kind" | "mode">): boolean;
+export declare const TASK_BACKGROUND_REJECTION = "Background execution is not permitted in this host. Run with background: false or omit background. No work was started.";
+export declare function isTaskTerminal(status: TaskStatus): boolean;
+/** Foreground logs have their own history; reports remain inspectable in either mode. */
+export declare function isInlineLogTask(task: Pick<TaskSnapshot, "format" | "mode">): boolean;
 /** Preserve the foreground throwing contract without guessing status from output text. */
-export declare class BackgroundExecutionError extends Error {
-    readonly status: BackgroundTerminalStatus;
-    constructor(message: string, status: BackgroundTerminalStatus);
+export declare class TaskExecutionError extends Error {
+    readonly status: TaskTerminalStatus;
+    constructor(message: string, status: TaskTerminalStatus);
 }
 /**
  * A failed id lookup, typed so hosts can enrich the message without matching
@@ -180,10 +198,10 @@ export declare class BackgroundExecutionError extends Error {
  * resolved against — including records outside the current branch, which
  * list() hides but prefix matching still collides with.
  */
-export declare class BackgroundLookupError extends Error {
+export declare class TaskLookupError extends Error {
     readonly kind: "unknown" | "ambiguous";
-    readonly matches: BackgroundTask[];
-    constructor(kind: "unknown" | "ambiguous", matches: BackgroundTask[]);
+    readonly matches: TaskSnapshot[];
+    constructor(kind: "unknown" | "ambiguous", matches: TaskSnapshot[]);
 }
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/core/tasks/types.d.ts.map

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

package/dist/core/{background → tasks}/types.js

@@ -1,16 +1,16 @@
-export const SUBAGENT_BACKGROUND_REJECTION = "Background execution is not available inside subagents. Run this command with background: false (or omit background). Only the parent agent or the user can background the entire subagent invocation. No command was started.";
-export function isBackgroundTerminal(status) {
+export const TASK_BACKGROUND_REJECTION = "Background execution is not permitted in this host. Run with background: false or omit background. No work was started.";
+export function isTaskTerminal(status) {
     return status !== "queued" && status !== "running" && status !== "stopping";
 }
-/** Foreground shell logs have their own history; subagent groups remain inspectable in either mode. */
-export function isForegroundShellTask(task) {
-    return task.kind === "bash" && task.mode === "foreground";
+/** Foreground logs have their own history; reports remain inspectable in either mode. */
+export function isInlineLogTask(task) {
+    return task.format === "log" && task.mode === "foreground";
 }
 /** Preserve the foreground throwing contract without guessing status from output text. */
-export class BackgroundExecutionError extends Error {
+export class TaskExecutionError extends Error {
     constructor(message, status) {
         super(message);
-        this.name = "BackgroundExecutionError";
+        this.name = "TaskExecutionError";
         this.status = status;
     }
 }
@@ -20,10 +20,10 @@ export class BackgroundExecutionError extends Error {
  * resolved against — including records outside the current branch, which
  * list() hides but prefix matching still collides with.
  */
-export class BackgroundLookupError extends Error {
+export class TaskLookupError extends Error {
     constructor(kind, matches) {
         super(kind === "ambiguous" ? "Ambiguous background task ID" : "Unknown background task ID");
-        this.name = "BackgroundLookupError";
+        this.name = "TaskLookupError";
         this.kind = kind;
         this.matches = matches;
     }

package/dist/core/tasks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/tasks/types.ts"],"names":[],"mappings":"AAgMA,MAAM,CAAC,MAAM,yBAAyB,GACrC,yHAAyH,CAAC;AAE3H,MAAM,UAAU,cAAc,CAAC,MAAkB;IAChD,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,UAAU,CAAC;AAC7E,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,eAAe,CAAC,IAA2C;IAC1E,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC;AAC5D,CAAC;AAED,0FAA0F;AAC1F,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAE5C,YAAY,OAAe,EAAE,MAA0B;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;CACD;AAED;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAGzC,YAAY,IAA6B,EAAE,OAAuB;QACjE,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC;QAC5F,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;CACD","sourcesContent":["import type { AgentToolResult } from \"@earendil-works/pi-agent-core\";\nimport type { Usage } from \"@earendil-works/pi-ai/compat\";\nimport type { TaskViewRegistry } from \"./view.ts\";\nimport type { TaskViewData } from \"./view-data.ts\";\n\n/** An executor-owned source label, never a dispatch key for the runtime. */\nexport type TaskKind = string;\nexport type TaskMode = \"foreground\" | \"background\";\nexport type TaskTerminalStatus = \"completed\" | \"partial\" | \"failed\" | \"cancelled\" | \"timeout\";\nexport type TaskStatus = \"queued\" | \"running\" | \"stopping\" | TaskTerminalStatus;\n\n/** A bounded snapshot; truncation is recorded at the source, never inferred from text. */\nexport interface TaskText {\n\ttext: string;\n\ttruncated: boolean;\n}\n\nexport interface TaskItemReport {\n\tid: string;\n\tlabel: string;\n\tcategory: string;\n\tdescription: string;\n\tstatus: string;\n\treport: TaskText;\n\terror?: string;\n}\n\n/** A serializable, domain-owned projection. No extension-private renderer imports. */\nexport interface TaskItem extends TaskItemReport {\n\tinput: string;\n\tactivity: string;\n\tcontext?: string;\n\tusage?: string;\n}\n\nexport interface TaskProjection {\n\tnextStep?: string;\n\ttext?: string;\n\tshell?: { name: string; output: TaskText };\n\titems?: TaskItem[];\n}\n\ninterface TaskCompletionBase {\n\tkind: string;\n\tversion: 1;\n\ttaskId: string;\n\ttitle: string;\n\tstatus: TaskTerminalStatus;\n\tstartedAt: number;\n\tendedAt: number;\n\terror?: string;\n\tnextStep?: string;\n}\n\n/** Self-contained completion-message details. No live handles, tool-private details or accounting. */\nexport type TaskCompletionSnapshot = TaskCompletionBase &\n\t(\n\t\t| {\n\t\t\t\tformat: \"log\";\n\t\t\t\tshell?: string;\n\t\t\t\tcommand?: TaskText;\n\t\t\t\tcwd?: string;\n\t\t\t\toutputPath?: string;\n\t\t\t\t/** Process exit code: a number, or null when signal-reaped. */\n\t\t\t\texitCode?: number | null;\n\t\t\t\toutput: TaskText;\n\t\t  }\n\t\t| {\n\t\t\t\tformat: \"report\";\n\t\t\t\titems: TaskItemReport[];\n\t\t\t\t/** Plain fallback when an executor has no worker projection. */\n\t\t\t\toutput?: TaskText;\n\t\t  }\n\t);\n\nexport interface TaskSnapshot {\n\tid: string;\n\tkind: TaskKind;\n\tformat?: \"log\" | \"report\";\n\ttitle: string;\n\ttoolCallId: string;\n\tanchorId: string | null;\n\tmode: TaskMode;\n\tstatus: TaskStatus;\n\tstartedAt: number;\n\tendedAt?: number;\n\tcommand?: string;\n\tcommandTruncated?: boolean;\n\tcwd?: string;\n\t/** Process exit code (bash): a number, or null when signal-reaped. Absent while running or unreported. */\n\texitCode?: number | null;\n\toutputPath?: string;\n\tprojection?: TaskProjection;\n\tviewData?: TaskViewData;\n\tresult?: AgentToolResult<unknown>;\n\tresultTruncated?: boolean;\n\terror?: string;\n}\n\nexport interface TaskCompletion<T> {\n\tresult: AgentToolResult<T>;\n\tstatus?: TaskTerminalStatus;\n\t/** Terminal diagnostic, stored independently of log slices and bounded to 4096 bytes. */\n\terror?: string;\n\t/** Process exit code (bash): a number, or null when signal-reaped. */\n\texitCode?: number | null;\n\t/** Authoritative cumulative usage; overrides result.usage and any published snapshot. */\n\tusage?: Usage;\n}\n\nexport interface TaskControl<T> {\n\treadonly id: string;\n\treadonly signal: AbortSignal;\n\treadonly mode: TaskMode;\n\tonModeChange(listener: (mode: TaskMode) => void): () => void;\n\trequestCancel(): boolean;\n\t/** Accept only after whole-invocation preflight; required before returning a handoff. */\n\taccept(): void;\n\t/**\n\t * result.usage is a cumulative snapshot, never a delta. The most recent explicitly\n\t * published usage is settled once on rejection (never inferred from details).\n\t * Final completion.usage, then completion.result.usage, override that snapshot.\n\t */\n\tpublish(result: AgentToolResult<T>, projection?: TaskProjection): void;\n\t/** Publish bounded, versioned display data without changing tool results or completion delivery. */\n\tpublishView(data: TaskViewData): void;\n\t/** Register once; cleanup must own only this exclusively-created file and close its writer first. */\n\tsetOutputPath(path: string, cleanup?: () => void | Promise<void>): void;\n}\n\nexport interface TaskExecution<T> {\n\tkind: TaskKind;\n\tformat?: \"log\" | \"report\";\n\ttitle: string;\n\ttoolCallId: string;\n\tcommand?: string;\n\tcwd?: string;\n\tbackground?: boolean;\n\tsignal?: AbortSignal;\n\tonUpdate?: (result: AgentToolResult<T>) => void;\n\trun(control: TaskControl<T>): Promise<TaskCompletion<T>>;\n}\n\nexport type TaskToolOutcome<T> =\n\t| { kind: \"result\"; result: AgentToolResult<T>; status?: TaskTerminalStatus; error?: string }\n\t| { kind: \"background\"; task: TaskSnapshot };\n\nexport interface TaskRead {\n\ttask: TaskSnapshot;\n\ttext: string;\n\t/** Bounded log-read/expiry diagnostic, independent of text slicing and byte offsets. */\n\treadError?: string;\n\ttotalBytes: number;\n\ttruncated: boolean;\n\tfromByte?: number;\n}\n\n/** Session-bound public capability. Captured instances close on runtime replacement. */\nexport interface TasksContext {\n\treadonly views: TaskViewRegistry;\n\treadonly enabled: boolean;\n\treadonly closed?: boolean;\n\texecute<T>(execution: TaskExecution<T>): Promise<TaskToolOutcome<T>>;\n\tlist(): TaskSnapshot[];\n\tget(id: string): TaskSnapshot;\n\tread(id: string, options?: { mode?: \"head\" | \"tail\"; bytes?: number; sinceBytes?: number }): Promise<TaskRead>;\n\t/** Observation only: terminal delivery is acknowledged by the host via markDelivered after result persistence. */\n\twait(id: string, timeoutMs?: number, signal?: AbortSignal): Promise<TaskSnapshot>;\n\tkill(id: string): boolean;\n\t/** Move every running foreground execution to the background; returns how many moved. */\n\tdetachForeground(): number;\n\tdetach(id: string): boolean;\n\tsubscribe(listener: () => void): () => void;\n\t/** Keep retained output available without delaying completion delivery. */\n\tretain(id: string): () => void;\n\t/** Hold automatic delivery while preparing a result for the host to persist. */\n\tholdDelivery(id: string): () => void;\n}\n\nexport interface TaskRuntimeOptions {\n\tenabled?: boolean;\n\tbackgroundAllowed?: boolean;\n\tanchor?: () => string | null;\n\tmaxActive?: number;\n\t/** Per-history limit: foreground logs and other managed tasks each get this allowance. */\n\tmaxHistory?: number;\n\t/** Best-effort cleanup errors, bounded to 4096 bytes; no retries or execution failure. */\n\tonCleanupError?: (message: string) => void;\n\t/** Synchronous persistence before terminal observers or notifications. */\n\tonSettled?: (task: TaskSnapshot, usage: Usage | undefined) => void;\n}\n\nexport const TASK_BACKGROUND_REJECTION =\n\t\"Background execution is not permitted in this host. Run with background: false or omit background. No work was started.\";\n\nexport function isTaskTerminal(status: TaskStatus): boolean {\n\treturn status !== \"queued\" && status !== \"running\" && status !== \"stopping\";\n}\n\n/** Foreground logs have their own history; reports remain inspectable in either mode. */\nexport function isInlineLogTask(task: Pick<TaskSnapshot, \"format\" | \"mode\">): boolean {\n\treturn task.format === \"log\" && task.mode === \"foreground\";\n}\n\n/** Preserve the foreground throwing contract without guessing status from output text. */\nexport class TaskExecutionError extends Error {\n\treadonly status: TaskTerminalStatus;\n\tconstructor(message: string, status: TaskTerminalStatus) {\n\t\tsuper(message);\n\t\tthis.name = \"TaskExecutionError\";\n\t\tthis.status = status;\n\t}\n}\n\n/**\n * A failed id lookup, typed so hosts can enrich the message without matching\n * on message text. `matches` snapshots exactly the records the id or prefix\n * resolved against — including records outside the current branch, which\n * list() hides but prefix matching still collides with.\n */\nexport class TaskLookupError extends Error {\n\treadonly kind: \"unknown\" | \"ambiguous\";\n\treadonly matches: TaskSnapshot[];\n\tconstructor(kind: \"unknown\" | \"ambiguous\", matches: TaskSnapshot[]) {\n\t\tsuper(kind === \"ambiguous\" ? \"Ambiguous background task ID\" : \"Unknown background task ID\");\n\t\tthis.name = \"TaskLookupError\";\n\t\tthis.kind = kind;\n\t\tthis.matches = matches;\n\t}\n}\n"]}

package/dist/core/tasks/view-data.d.ts

@@ -0,0 +1,8 @@
+/** Executor-owned JSON data; the version belongs to its view provider. */
+export interface TaskViewData {
+    version: number;
+    data: unknown;
+}
+/** Strict, bounded JSON copy. Never invoke accessors, toJSON, or renderer callbacks. */
+export declare function readTaskViewData(source: unknown): TaskViewData;
+//# sourceMappingURL=view-data.d.ts.map

package/dist/core/tasks/view-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-data.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/view-data.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACd;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,CA+C9D"}

package/dist/core/tasks/view-data.js

@@ -0,0 +1,61 @@
+/** Strict, bounded JSON copy. Never invoke accessors, toJSON, or renderer callbacks. */
+export function readTaskViewData(source) {
+    let budget = 120 * 1024;
+    const copy = (value, depth) => {
+        if (depth > 32 || --budget < 0)
+            throw new Error("Task view data exceeds storage limits");
+        if (value === null || typeof value === "boolean")
+            return value;
+        if (typeof value === "string") {
+            if (value.length > budget)
+                throw new Error("Task view data exceeds storage limits");
+            budget -= Buffer.byteLength(JSON.stringify(value));
+            if (budget < 0)
+                throw new Error("Task view data exceeds storage limits");
+            return value;
+        }
+        if (typeof value === "number" && Number.isFinite(value)) {
+            budget -= 24;
+            return value;
+        }
+        if (typeof value !== "object" || value === null)
+            throw new Error("Task view data must be JSON");
+        const array = Array.isArray(value);
+        if (!array && Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)
+            throw new Error("Task view data must contain plain objects");
+        const output = {};
+        const entries = [];
+        for (const key of Object.keys(value)) {
+            if (array && key !== String(entries.length))
+                throw new Error("Task view arrays must be dense JSON arrays");
+            const field = Object.getOwnPropertyDescriptor(value, key);
+            if (!("value" in field))
+                throw new Error("Task view data cannot contain accessors");
+            if (field.value === undefined && !array)
+                continue;
+            copy(key, depth + 1);
+            const next = copy(field.value, depth + 1);
+            if (array)
+                entries.push(next);
+            else
+                Object.defineProperty(output, key, { value: next, enumerable: true, writable: true, configurable: true });
+        }
+        if (array && entries.length !== value.length)
+            throw new Error("Task view arrays must be dense JSON arrays");
+        return array ? entries : output;
+    };
+    const result = copy(source, 0);
+    if (budget < 0)
+        throw new Error("Task view data exceeds storage limits");
+    if (!result ||
+        typeof result.version !== "number" ||
+        !Number.isSafeInteger(result.version) ||
+        result.version < 1 ||
+        !Object.hasOwn(result, "data"))
+        throw new Error("Invalid task view data envelope");
+    // Traversal already bounds the allocation; enforce the exact serialized limit too.
+    if (Buffer.byteLength(JSON.stringify(result)) > 120 * 1024)
+        throw new Error("Task view data exceeds storage limits");
+    return { version: result.version, data: result.data };
+}
+//# sourceMappingURL=view-data.js.map

package/dist/core/tasks/view-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-data.js","sourceRoot":"","sources":["../../../src/core/tasks/view-data.ts"],"names":[],"mappings":"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","sourcesContent":["/** Executor-owned JSON data; the version belongs to its view provider. */\nexport interface TaskViewData {\n\tversion: number;\n\tdata: unknown;\n}\n\n/** Strict, bounded JSON copy. Never invoke accessors, toJSON, or renderer callbacks. */\nexport function readTaskViewData(source: unknown): TaskViewData {\n\tlet budget = 120 * 1024;\n\tconst copy = (value: unknown, depth: number): unknown => {\n\t\tif (depth > 32 || --budget < 0) throw new Error(\"Task view data exceeds storage limits\");\n\t\tif (value === null || typeof value === \"boolean\") return value;\n\t\tif (typeof value === \"string\") {\n\t\t\tif (value.length > budget) throw new Error(\"Task view data exceeds storage limits\");\n\t\t\tbudget -= Buffer.byteLength(JSON.stringify(value));\n\t\t\tif (budget < 0) throw new Error(\"Task view data exceeds storage limits\");\n\t\t\treturn value;\n\t\t}\n\t\tif (typeof value === \"number\" && Number.isFinite(value)) {\n\t\t\tbudget -= 24;\n\t\t\treturn value;\n\t\t}\n\t\tif (typeof value !== \"object\" || value === null) throw new Error(\"Task view data must be JSON\");\n\t\tconst array = Array.isArray(value);\n\t\tif (!array && Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)\n\t\t\tthrow new Error(\"Task view data must contain plain objects\");\n\t\tconst output: Record<string, unknown> = {};\n\t\tconst entries: unknown[] = [];\n\t\tfor (const key of Object.keys(value)) {\n\t\t\tif (array && key !== String(entries.length)) throw new Error(\"Task view arrays must be dense JSON arrays\");\n\t\t\tconst field = Object.getOwnPropertyDescriptor(value, key)!;\n\t\t\tif (!(\"value\" in field)) throw new Error(\"Task view data cannot contain accessors\");\n\t\t\tif (field.value === undefined && !array) continue;\n\t\t\tcopy(key, depth + 1);\n\t\t\tconst next = copy(field.value, depth + 1);\n\t\t\tif (array) entries.push(next);\n\t\t\telse Object.defineProperty(output, key, { value: next, enumerable: true, writable: true, configurable: true });\n\t\t}\n\t\tif (array && entries.length !== value.length) throw new Error(\"Task view arrays must be dense JSON arrays\");\n\t\treturn array ? entries : output;\n\t};\n\tconst result = copy(source, 0) as Partial<TaskViewData> | null;\n\tif (budget < 0) throw new Error(\"Task view data exceeds storage limits\");\n\tif (\n\t\t!result ||\n\t\ttypeof result.version !== \"number\" ||\n\t\t!Number.isSafeInteger(result.version) ||\n\t\tresult.version < 1 ||\n\t\t!Object.hasOwn(result, \"data\")\n\t)\n\t\tthrow new Error(\"Invalid task view data envelope\");\n\t// Traversal already bounds the allocation; enforce the exact serialized limit too.\n\tif (Buffer.byteLength(JSON.stringify(result)) > 120 * 1024) throw new Error(\"Task view data exceeds storage limits\");\n\treturn { version: result.version, data: result.data };\n}\n"]}

package/dist/core/tasks/view.d.ts

@@ -0,0 +1,30 @@
+import type { Component } from "@earendil-works/pi-tui";
+import type { Theme } from "../../modes/interactive/theme/theme.ts";
+import type { TaskRead, TaskSnapshot } from "./types.ts";
+/** A panel-local view. Components own their content; the panel owns scrolling. */
+export interface TaskView {
+    info: Component;
+    output: Component;
+    update(task: TaskSnapshot, output?: TaskRead): void;
+    dispose?(): void;
+}
+export interface TaskViewProvider {
+    /** Tail views receive bounded output reads and initially follow the bottom. */
+    outputMode: "tail" | "snapshot";
+    create(context: {
+        theme: Theme;
+        requestRender(): void;
+    }): TaskView;
+}
+/** Session-local renderer registrations, never part of a persisted task snapshot. */
+export declare class TaskViewRegistry {
+    private readonly providers;
+    private readonly listeners;
+    private closed;
+    register(kind: string, provider: TaskViewProvider): () => void;
+    get(kind: string): TaskViewProvider | undefined;
+    subscribe(listener: () => void): () => void;
+    close(): void;
+    private emit;
+}
+//# sourceMappingURL=view.d.ts.map

package/dist/core/tasks/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzD,kFAAkF;AAClF,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACpD,OAAO,CAAC,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAChC,+EAA+E;IAC/E,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC;IAChC,MAAM,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,aAAa,IAAI,IAAI,CAAA;KAAE,GAAG,QAAQ,CAAC;CACnE;AAED,qFAAqF;AACrF,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,MAAM,CAAS;IAEvB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAY9D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/C,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAQ3C,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,IAAI;CASZ"}

package/dist/core/tasks/view.js

@@ -0,0 +1,50 @@
+/** Session-local renderer registrations, never part of a persisted task snapshot. */
+export class TaskViewRegistry {
+    constructor() {
+        this.providers = new Map();
+        this.listeners = new Set();
+        this.closed = false;
+    }
+    register(kind, provider) {
+        if (this.closed)
+            throw new Error("Task views are closed");
+        if (this.providers.has(kind))
+            throw new Error(`Task view already registered: ${kind}`);
+        this.providers.set(kind, provider);
+        this.emit();
+        return () => {
+            if (this.providers.get(kind) !== provider)
+                return;
+            this.providers.delete(kind);
+            this.emit();
+        };
+    }
+    get(kind) {
+        return this.providers.get(kind);
+    }
+    subscribe(listener) {
+        if (this.closed)
+            return () => { };
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    close() {
+        this.closed = true;
+        this.providers.clear();
+        this.emit();
+        this.listeners.clear();
+    }
+    emit() {
+        for (const listener of this.listeners) {
+            try {
+                listener();
+            }
+            catch {
+                /* A view cannot interrupt registration or execution. */
+            }
+        }
+    }
+}
+//# sourceMappingURL=view.js.map

package/dist/core/tasks/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/core/tasks/view.ts"],"names":[],"mappings":"AAkBA,qFAAqF;AACrF,MAAM,OAAO,gBAAgB;IAA7B;QACkB,cAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;QAChD,cAAS,GAAG,IAAI,GAAG,EAAc,CAAC;QAC3C,WAAM,GAAG,KAAK,CAAC;IA0CxB,CAAC;IAxCA,QAAQ,CAAC,IAAY,EAAE,QAA0B;QAChD,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC1D,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,OAAO,GAAG,EAAE;YACX,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,QAAQ;gBAAE,OAAO;YAClD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;QACb,CAAC,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,SAAS,CAAC,QAAoB;QAC7B,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QACjC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE;YACX,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC,CAAC;IACH,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAEO,IAAI;QACX,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC;gBACJ,QAAQ,EAAE,CAAC;YACZ,CAAC;YAAC,MAAM,CAAC;gBACR,wDAAwD;YACzD,CAAC;QACF,CAAC;IACF,CAAC;CACD","sourcesContent":["import type { Component } from \"@earendil-works/pi-tui\";\nimport type { Theme } from \"../../modes/interactive/theme/theme.ts\";\nimport type { TaskRead, TaskSnapshot } from \"./types.ts\";\n\n/** A panel-local view. Components own their content; the panel owns scrolling. */\nexport interface TaskView {\n\tinfo: Component;\n\toutput: Component;\n\tupdate(task: TaskSnapshot, output?: TaskRead): void;\n\tdispose?(): void;\n}\n\nexport interface TaskViewProvider {\n\t/** Tail views receive bounded output reads and initially follow the bottom. */\n\toutputMode: \"tail\" | \"snapshot\";\n\tcreate(context: { theme: Theme; requestRender(): void }): TaskView;\n}\n\n/** Session-local renderer registrations, never part of a persisted task snapshot. */\nexport class TaskViewRegistry {\n\tprivate readonly providers = new Map<string, TaskViewProvider>();\n\tprivate readonly listeners = new Set<() => void>();\n\tprivate closed = false;\n\n\tregister(kind: string, provider: TaskViewProvider): () => void {\n\t\tif (this.closed) throw new Error(\"Task views are closed\");\n\t\tif (this.providers.has(kind)) throw new Error(`Task view already registered: ${kind}`);\n\t\tthis.providers.set(kind, provider);\n\t\tthis.emit();\n\t\treturn () => {\n\t\t\tif (this.providers.get(kind) !== provider) return;\n\t\t\tthis.providers.delete(kind);\n\t\t\tthis.emit();\n\t\t};\n\t}\n\n\tget(kind: string): TaskViewProvider | undefined {\n\t\treturn this.providers.get(kind);\n\t}\n\n\tsubscribe(listener: () => void): () => void {\n\t\tif (this.closed) return () => {};\n\t\tthis.listeners.add(listener);\n\t\treturn () => {\n\t\t\tthis.listeners.delete(listener);\n\t\t};\n\t}\n\n\tclose(): void {\n\t\tthis.closed = true;\n\t\tthis.providers.clear();\n\t\tthis.emit();\n\t\tthis.listeners.clear();\n\t}\n\n\tprivate emit(): void {\n\t\tfor (const listener of this.listeners) {\n\t\t\ttry {\n\t\t\t\tlistener();\n\t\t\t} catch {\n\t\t\t\t/* A view cannot interrupt registration or execution. */\n\t\t\t}\n\t\t}\n\t}\n}\n"]}

package/dist/core/tools/bash.d.ts

@@ -1,98 +1,13 @@
-import type { AgentTool } from "@earendil-works/pi-agent-core";
-import { type Static, Type } from "typebox";
-import { type ShellConfig } from "../../utils/shell.ts";
-import type { ExtensionContext, ToolDefinition } from "../extensions/types.ts";
-import { type TruncationResult } from "./truncate.ts";
-declare const bashSchema: Type.TObject<{
-    command: Type.TString;
-    timeout: Type.TOptional<Type.TNumber>;
-    background: Type.TOptional<Type.TBoolean>;
-}>;
-export declare const bashToolSystemPromptContribution: {
-    readonly snippet: "Execute bash commands, foreground or background";
-    readonly guidelines: readonly ["You can inspect PI_* environment variables for current model and session details."];
-};
-export type BashToolInput = Static<typeof bashSchema>;
-export interface BashToolDetails {
-    truncation?: TruncationResult;
-    fullOutputPath?: string;
-    /** Settled handoff snapshot, not a command completion or exit code. */
-    background?: {
-        kind: "background";
-        taskId: string;
-    };
-}
-/**
- * Pluggable operations for the bash tool.
- * Override these to delegate command execution to remote systems (for example SSH).
- */
-export interface BashOperations {
-    /**
-     * Execute a command and stream output.
-     * @param command The command to execute
-     * @param cwd Working directory
-     * @param options Execution options
-     * @returns Promise resolving to the exit code. Report signal terminations as 128 + signal number;
-     * a null exit code is treated as a failed command.
-     *
-     * Error contract: reject with `new Error("aborted")` when aborted via `signal`,
-     * and `new Error("timeout:<seconds>")` on timeout expiry. The shared shell
-     * execution pipeline classifies outcomes from these exact markers.
-     */
-    exec: (command: string, cwd: string, options: {
-        onData: (data: Buffer) => void;
-        signal?: AbortSignal;
-        timeout?: number;
-        env?: NodeJS.ProcessEnv;
-    }) => Promise<{
-        exitCode: number | null;
-    }>;
-}
-/** Shared process execution used by the built-in shell tools. */
-export declare function createLocalShellOperations(shellName: string, resolveShellConfig: () => ShellConfig, normalizeCommand?: (command: string) => string): BashOperations;
-/**
- * Create bash operations using pi's built-in local shell execution backend.
- *
- * This is useful for extensions that intercept user_bash and still want pi's
- * standard local shell behavior while wrapping or rewriting commands.
- */
+import { type BashOperations, type BashToolOptions, createShellToolDefinition } from "./shell-tool.ts";
+export { type BashOperations, type BashRenderState, type BashSpawnContext, type BashSpawnHook, type BashToolDetails, type BashToolInput, type BashToolOptions, bashToolSystemPromptContribution, } from "./shell-tool.ts";
 export declare function normalizeLocalBashCommand(command: string, platform?: NodeJS.Platform): string;
 export declare function createLocalBashOperations(options?: {
     shellPath?: string;
 }): BashOperations;
-export interface BashSpawnContext {
-    command: string;
-    cwd: string;
-    env: NodeJS.ProcessEnv;
-}
-export type BashSpawnHook = (context: BashSpawnContext) => BashSpawnContext;
-export declare function resolveSpawnContext(command: string, cwd: string, spawnHook: BashSpawnHook | undefined, exposeSessionEnvironment: boolean, ctx: ExtensionContext | undefined): BashSpawnContext;
-export interface BashToolOptions {
-    /** Custom operations for command execution. Default: local shell */
-    operations?: BashOperations;
-    /** Command prefix prepended to every command (for example shell setup commands) */
-    commandPrefix?: string;
-    /** Optional explicit shell path from settings */
-    shellPath?: string;
-    /** Expose current Pi session metadata as PI_* environment variables. Default: true */
-    exposeSessionEnvironment?: boolean;
-    /** Hook to adjust command, cwd, or env before execution */
-    spawnHook?: BashSpawnHook;
-}
-export type BashRenderState = {
-    dispose?: () => void;
-};
-export interface ShellToolConfig {
-    name: string;
-    label: string;
-    shellName: string;
-    prompt: string;
-    promptSnippet: string;
-    promptGuidelines?: readonly string[];
-    tempFilePrefix: string;
-}
-export declare function createShellToolDefinition(cwd: string, config: ShellToolConfig, options?: BashToolOptions): ToolDefinition<typeof bashSchema, BashToolDetails | undefined, BashRenderState>;
-export declare function createBashToolDefinition(cwd: string, options?: BashToolOptions): ToolDefinition<typeof bashSchema, BashToolDetails | undefined, BashRenderState>;
-export declare function createBashTool(cwd: string, options?: BashToolOptions): AgentTool<typeof bashSchema>;
-export {};
+export declare function createBashToolDefinition(cwd: string, options?: BashToolOptions): ReturnType<typeof createShellToolDefinition>;
+export declare function createBashTool(cwd: string, options?: BashToolOptions): import("@earendil-works/pi-agent-core").AgentTool<import("typebox").TObject<{
+    command: import("typebox").TString;
+    timeout: import("typebox").TOptional<import("typebox").TNumber>;
+    background: import("typebox").TOptional<import("typebox").TBoolean>;
+}>, import("./shell-tool.ts").BashToolDetails | undefined>;
 //# sourceMappingURL=bash.d.ts.map