@gajae-code/coding-agent 0.3.0 → 0.3.1

package/dist/types/task/types.d.ts

@@ -1,11 +1,14 @@
 import type { ThinkingLevel } from "@gajae-code/agent-core";
 import type { Usage } from "@gajae-code/ai";
 import * as z from "zod/v4";
+import type { TaskResultReceipt } from "./receipt";
 import { type TaskSimpleMode } from "./simple-mode";
+import type { SpawnPlanReceipt } from "./spawn-gate";
 import type { NestedRepoPatch } from "./worktree";
 /** Source of an agent definition */
 export type AgentSource = "bundled" | "user" | "project";
 export type ForkContextPolicy = "forbidden" | "allowed";
+export type ForkContextMode = "none" | "receipt" | "last-turn" | "bounded" | "full";
 /** Maximum output bytes per agent */
 export declare const MAX_OUTPUT_BYTES: number;
 /** Maximum output lines per agent */
@@ -41,7 +44,13 @@ export declare const taskItemSchema: z.ZodObject<{
     id: z.ZodString;
     description: z.ZodString;
     assignment: z.ZodString;
-    inheritContext: z.ZodOptional<z.ZodBoolean>;
+    inheritContext: z.ZodOptional<z.ZodEnum<{
+        bounded: "bounded";
+        full: "full";
+        "last-turn": "last-turn";
+        none: "none";
+        receipt: "receipt";
+    }>>;
 }, z.core.$strip>;
 export type TaskItem = z.infer<typeof taskItemSchema>;
 export declare const taskSchema: z.ZodObject<{
@@ -50,7 +59,20 @@ export declare const taskSchema: z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
-        inheritContext: z.ZodOptional<z.ZodBoolean>;
+        inheritContext: z.ZodOptional<z.ZodEnum<{
+            bounded: "bounded";
+            full: "full";
+            "last-turn": "last-turn";
+            none: "none";
+            receipt: "receipt";
+        }>>;
+    }, z.core.$strip>>;
+    spawnPlan: z.ZodOptional<z.ZodObject<{
+        whyParallel: z.ZodString;
+        whyNotLocal: z.ZodString;
+        independence: z.ZodString;
+        expectedReceiptShape: z.ZodString;
+        maxInlineTokens: z.ZodNumber;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const taskSchemaNoIsolation: z.ZodObject<{
@@ -59,7 +81,20 @@ export declare const taskSchemaNoIsolation: z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
-        inheritContext: z.ZodOptional<z.ZodBoolean>;
+        inheritContext: z.ZodOptional<z.ZodEnum<{
+            bounded: "bounded";
+            full: "full";
+            "last-turn": "last-turn";
+            none: "none";
+            receipt: "receipt";
+        }>>;
+    }, z.core.$strip>>;
+    spawnPlan: z.ZodOptional<z.ZodObject<{
+        whyParallel: z.ZodString;
+        whyNotLocal: z.ZodString;
+        independence: z.ZodString;
+        expectedReceiptShape: z.ZodString;
+        maxInlineTokens: z.ZodNumber;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const ALL_TASK_SCHEMAS: readonly [z.ZodObject<{
@@ -68,7 +103,20 @@ declare const ALL_TASK_SCHEMAS: readonly [z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
-        inheritContext: z.ZodOptional<z.ZodBoolean>;
+        inheritContext: z.ZodOptional<z.ZodEnum<{
+            bounded: "bounded";
+            full: "full";
+            "last-turn": "last-turn";
+            none: "none";
+            receipt: "receipt";
+        }>>;
+    }, z.core.$strip>>;
+    spawnPlan: z.ZodOptional<z.ZodObject<{
+        whyParallel: z.ZodString;
+        whyNotLocal: z.ZodString;
+        independence: z.ZodString;
+        expectedReceiptShape: z.ZodString;
+        maxInlineTokens: z.ZodNumber;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     agent: z.ZodString;
@@ -76,7 +124,20 @@ declare const ALL_TASK_SCHEMAS: readonly [z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
-        inheritContext: z.ZodOptional<z.ZodBoolean>;
+        inheritContext: z.ZodOptional<z.ZodEnum<{
+            bounded: "bounded";
+            full: "full";
+            "last-turn": "last-turn";
+            none: "none";
+            receipt: "receipt";
+        }>>;
+    }, z.core.$strip>>;
+    spawnPlan: z.ZodOptional<z.ZodObject<{
+        whyParallel: z.ZodString;
+        whyNotLocal: z.ZodString;
+        independence: z.ZodString;
+        expectedReceiptShape: z.ZodString;
+        maxInlineTokens: z.ZodNumber;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     agent: z.ZodString;
@@ -84,7 +145,20 @@ declare const ALL_TASK_SCHEMAS: readonly [z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
-        inheritContext: z.ZodOptional<z.ZodBoolean>;
+        inheritContext: z.ZodOptional<z.ZodEnum<{
+            bounded: "bounded";
+            full: "full";
+            "last-turn": "last-turn";
+            none: "none";
+            receipt: "receipt";
+        }>>;
+    }, z.core.$strip>>;
+    spawnPlan: z.ZodOptional<z.ZodObject<{
+        whyParallel: z.ZodString;
+        whyNotLocal: z.ZodString;
+        independence: z.ZodString;
+        expectedReceiptShape: z.ZodString;
+        maxInlineTokens: z.ZodNumber;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     agent: z.ZodString;
@@ -92,7 +166,20 @@ declare const ALL_TASK_SCHEMAS: readonly [z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
-        inheritContext: z.ZodOptional<z.ZodBoolean>;
+        inheritContext: z.ZodOptional<z.ZodEnum<{
+            bounded: "bounded";
+            full: "full";
+            "last-turn": "last-turn";
+            none: "none";
+            receipt: "receipt";
+        }>>;
+    }, z.core.$strip>>;
+    spawnPlan: z.ZodOptional<z.ZodObject<{
+        whyParallel: z.ZodString;
+        whyNotLocal: z.ZodString;
+        independence: z.ZodString;
+        expectedReceiptShape: z.ZodString;
+        maxInlineTokens: z.ZodNumber;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     agent: z.ZodString;
@@ -100,7 +187,20 @@ declare const ALL_TASK_SCHEMAS: readonly [z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
-        inheritContext: z.ZodOptional<z.ZodBoolean>;
+        inheritContext: z.ZodOptional<z.ZodEnum<{
+            bounded: "bounded";
+            full: "full";
+            "last-turn": "last-turn";
+            none: "none";
+            receipt: "receipt";
+        }>>;
+    }, z.core.$strip>>;
+    spawnPlan: z.ZodOptional<z.ZodObject<{
+        whyParallel: z.ZodString;
+        whyNotLocal: z.ZodString;
+        independence: z.ZodString;
+        expectedReceiptShape: z.ZodString;
+        maxInlineTokens: z.ZodNumber;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     agent: z.ZodString;
@@ -108,7 +208,20 @@ declare const ALL_TASK_SCHEMAS: readonly [z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
-        inheritContext: z.ZodOptional<z.ZodBoolean>;
+        inheritContext: z.ZodOptional<z.ZodEnum<{
+            bounded: "bounded";
+            full: "full";
+            "last-turn": "last-turn";
+            none: "none";
+            receipt: "receipt";
+        }>>;
+    }, z.core.$strip>>;
+    spawnPlan: z.ZodOptional<z.ZodObject<{
+        whyParallel: z.ZodString;
+        whyNotLocal: z.ZodString;
+        independence: z.ZodString;
+        expectedReceiptShape: z.ZodString;
+        maxInlineTokens: z.ZodNumber;
     }, z.core.$strip>>;
 }, z.core.$strip>];
 type DynamicTaskSchema = (typeof ALL_TASK_SCHEMAS)[number];
@@ -123,6 +236,7 @@ export interface TaskParams {
     agent: string;
     context?: string;
     schema?: string;
+    spawnPlan?: SpawnPlanReceipt;
     tasks: TaskItem[];
     isolated?: boolean;
 }
@@ -273,6 +387,8 @@ export interface SingleResult {
     branchName?: string;
     /** Nested repo patches to apply after parent merge */
     nestedPatches?: NestedRepoPatch[];
+    /** Whether isolated execution produced a non-empty root or nested patch. */
+    producedChanges?: boolean;
     /** Data extracted by registered subprocess tool handlers (keyed by tool name) */
     extractedToolData?: Record<string, unknown[]>;
     /**
@@ -289,16 +405,32 @@ export interface SingleResult {
     outputMeta?: {
         lineCount: number;
         charCount: number;
+        byteSize?: number;
+        sha256?: string;
+    };
+    /** Fork-context seed accounting for this subagent, when inherited parent context was cloned. */
+    forkContext?: {
+        mode: ForkContextMode;
+        clonedTokens: number;
     };
 }
 /** Tool details for TUI rendering */
 export interface TaskToolDetails {
     projectAgentsDir: string | null;
-    results: SingleResult[];
+    results: TaskResultReceipt[];
     totalDurationMs: number;
     /** Aggregated usage across all subagents. */
     usage?: Usage;
-    outputPaths?: string[];
+    /** Aggregate cloned tokens copied into fork-context seeds across subagents. */
+    forkContextClonedTokens?: number;
+    roiSummary?: {
+        childCount: number;
+        totalTokens: number;
+        totalCostTotal?: number;
+        totalClonedTokens?: number;
+        /** Advisory ids for terminal children that spent tokens without detectable output/review/changes. */
+        lowRoiChildIds: string[];
+    };
     progress?: AgentProgress[];
     async?: {
         state: "running" | "paused" | "queued" | "completed" | "failed";

package/dist/types/tools/cron.d.ts

@@ -52,6 +52,12 @@ export interface CronDeleteToolDetails {
 export declare function clearOwnerSchedules(ownerId: string | undefined): void;
 /** Reset every owner's schedule store. Test-only. */
 export declare function resetCronRegistryForTests(): void;
+/** Subscribe to cron schedule-set changes. Returns an unsubscribe function. */
+export declare function onCronChange(cb: () => void): () => void;
+/** Snapshot the scheduled cron jobs for an owner (or all owners when omitted). */
+export declare function listCronSnapshots(ownerId?: string): CronJobSnapshot[];
+/** Delete a scheduled cron job by owner-scoped id. Returns true when removed. */
+export declare function deleteCronJobById(ownerId: string | undefined, id: string): boolean;
 export declare function validateCronExpression(expression: string): void;
 export declare function findNextCronMatchMs(expression: string, afterMs: number, deadlineMs?: number): number | undefined;
 export declare function calculateCronFireTimeMs(params: {

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

@@ -102,6 +102,8 @@ export interface ToolSession {
     requireYieldTool?: boolean;
     /** Task recursion depth (0 = top-level, 1 = first child, etc.) */
     taskDepth?: number;
+    /** Current role-agent type/name for nested task sessions. */
+    currentAgentType?: string;
     /** Get session file */
     getSessionFile: () => string | null;
     /** Get eval kernel owner ID for session-scoped retained-kernel cleanup. */

package/dist/types/tools/path-utils.d.ts

@@ -116,6 +116,7 @@ export declare function resolveReadPath(filePath: string, cwd: string): string;
 export interface ToolScopeOptions {
     rawPaths: string[];
     cwd: string;
+    getArtifactsDir?: () => string | null;
     /** Verb used in the "Cannot {action} internal URL without a backing file: …" message. */
     internalUrlAction: string;
     /** Collect absolute paths flagged immutable by their internal-URL handler. */

package/dist/types/tools/subagent.d.ts

@@ -13,10 +13,16 @@ declare const subagentSchema: z.ZodObject<{
         steer: "steer";
     }>;
     ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    id: z.ZodOptional<z.ZodString>;
     message: z.ZodOptional<z.ZodString>;
     pause: z.ZodOptional<z.ZodBoolean>;
     timeout_ms: z.ZodOptional<z.ZodNumber>;
     limit: z.ZodOptional<z.ZodNumber>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        preview: "preview";
+        receipt: "receipt";
+    }>>;
 }, z.core.$strip>;
 type SubagentParams = z.infer<typeof subagentSchema>;
 type SubagentStatus = "running" | "paused" | "queued" | "completed" | "failed" | "cancelled" | "not_found" | "already_completed";
@@ -32,6 +38,9 @@ export interface SubagentSnapshot {
     durationMs: number;
     resultText?: string;
     errorText?: string;
+    resultPreview?: string;
+    outputRef?: string;
+    truncated?: boolean;
     guidance?: string;
 }
 export interface SubagentToolDetails {
@@ -55,10 +64,16 @@ export declare class SubagentTool implements AgentTool<typeof subagentSchema, Su
             steer: "steer";
         }>;
         ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        id: z.ZodOptional<z.ZodString>;
         message: z.ZodOptional<z.ZodString>;
         pause: z.ZodOptional<z.ZodBoolean>;
         timeout_ms: z.ZodOptional<z.ZodNumber>;
         limit: z.ZodOptional<z.ZodNumber>;
+        verbosity: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            preview: "preview";
+            receipt: "receipt";
+        }>>;
     }, z.core.$strip>;
     readonly strict = true;
     readonly loadMode = "discoverable";

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/coding-agent",
-	"version": "0.3.0",
+	"version": "0.3.1",
 	"description": "Gajae Code CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://gaebal-gajae.dev",
 	"author": "Yeachan-Heo",
@@ -48,12 +48,12 @@
 		"@agentclientprotocol/sdk": "0.21.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@gajae-code/stats": "0.3.0",
-		"@gajae-code/agent-core": "0.3.0",
-		"@gajae-code/ai": "0.3.0",
-		"@gajae-code/natives": "0.3.0",
-		"@gajae-code/tui": "0.3.0",
-		"@gajae-code/utils": "0.3.0",
+		"@gajae-code/stats": "0.3.1",
+		"@gajae-code/agent-core": "0.3.1",
+		"@gajae-code/ai": "0.3.1",
+		"@gajae-code/natives": "0.3.1",
+		"@gajae-code/tui": "0.3.1",
+		"@gajae-code/utils": "0.3.1",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/scripts/build-binary.ts

@@ -4,6 +4,7 @@ import * as path from "node:path";
 
 const packageDir = path.join(import.meta.dir, "..");
 const outputPath = path.join(packageDir, "dist", "gjc");
+const nativeDir = path.join(packageDir, "..", "natives", "native");
 
 function shouldAdhocSignDarwinBinary(): boolean {
 	return process.platform === "darwin";
@@ -21,6 +22,11 @@ async function runCommand(command: string[], env: NodeJS.ProcessEnv = Bun.env):
 		throw new Error(`Command failed with exit code ${exitCode}: ${command.join(" ")}`);
 	}
 }
+async function stageWorkspaceNativeAddons(): Promise<void> {
+	await Array.fromAsync(new Bun.Glob("pi_natives.*.node").scan({ cwd: nativeDir }), async filename => {
+		await Bun.write(path.join(packageDir, "dist", filename), Bun.file(path.join(nativeDir, filename)));
+	});
+}
 
 async function main(): Promise<void> {
 	await runCommand(["bun", "--cwd=../stats", "scripts/generate-client-bundle.ts", "--generate"]);
@@ -62,6 +68,7 @@ async function main(): Promise<void> {
 				buildEnv,
 			);
 
+			await stageWorkspaceNativeAddons();
 			// Bun 1.3.12 emits a truncated Mach-O signature on darwin builds.
 			if (shouldAdhocSignDarwinBinary()) {
 				await runCommand(["codesign", "--force", "--sign", "-", outputPath]);

package/src/async/job-manager.ts

@@ -35,6 +35,8 @@ export interface AsyncJobMetadata {
 		description?: string;
 		assignment?: string;
 	};
+	/** True when this bash job was started by the `monitor` tool (vs plain async bash). */
+	monitor?: boolean;
 }
 
 /**
@@ -224,6 +226,12 @@ export class AsyncJobManager {
 	#resumeSeq = 0;
 	#resumeRunner?: (subagentId: string, message?: string, descriptor?: ResumeDescriptor) => string | undefined;
 	readonly #resumeDescriptors = new Map<string, ResumeDescriptor>();
+	/**
+	 * Change listeners notified on any mutation that can alter the live job set
+	 * (register, terminal/eviction transitions, dispose). Used by the status-line
+	 * jobs widget / overlay to refresh event-driven without polling.
+	 */
+	readonly #changeListeners = new Set<() => void>();
 
 	#filterJobs(jobs: Iterable<AsyncJob>, filter?: AsyncJobFilter): AsyncJob[] {
 		const ownerId = filter?.ownerId;
@@ -241,6 +249,29 @@ export class AsyncJobManager {
 		this.#retentionMs = Math.max(0, Math.floor(options.retentionMs ?? DEFAULT_RETENTION_MS));
 	}
 
+	/**
+	 * Subscribe to live-job-set change events. Returns an unsubscribe function.
+	 * Listener errors are isolated so one bad subscriber cannot break others.
+	 */
+	onChange(cb: () => void): () => void {
+		this.#changeListeners.add(cb);
+		return () => {
+			this.#changeListeners.delete(cb);
+		};
+	}
+
+	#notifyChange(): void {
+		for (const cb of this.#changeListeners) {
+			try {
+				cb();
+			} catch (error) {
+				logger.warn("Async job change listener failed", {
+					error: error instanceof Error ? error.message : String(error),
+				});
+			}
+		}
+	}
+
 	register(
 		type: "bash" | "task",
 		label: string,
@@ -336,6 +367,7 @@ export class AsyncJobManager {
 		})();
 
 		this.#jobs.set(id, job);
+		this.#notifyChange();
 		return id;
 	}
 
@@ -880,6 +912,8 @@ export class AsyncJobManager {
 		this.#liveHandles.clear();
 		this.#resumeDescriptors.clear();
 		this.#resumeQueue.length = 0;
+		this.#notifyChange();
+		this.#changeListeners.clear();
 		return drained;
 	}
 
@@ -909,6 +943,7 @@ export class AsyncJobManager {
 	}
 
 	#scheduleEviction(jobId: string): void {
+		this.#notifyChange();
 		if (this.#retentionMs <= 0) {
 			this.#jobs.delete(jobId);
 			this.#suppressedDeliveries.delete(jobId);
@@ -926,6 +961,7 @@ export class AsyncJobManager {
 			this.#suppressedDeliveries.delete(jobId);
 			this.#watchedJobs.delete(jobId);
 			this.#outputState.delete(jobId);
+			this.#notifyChange();
 		}, this.#retentionMs);
 		timer.unref();
 		this.#evictionTimers.set(jobId, timer);

package/src/cli/args.ts

@@ -7,7 +7,7 @@ import chalk from "chalk";
 import { parseEffort } from "../thinking";
 import { BUILTIN_TOOLS } from "../tools";
 
-export type Mode = "text" | "json" | "rpc" | "acp" | "rpc-ui";
+export type Mode = "text" | "json" | "rpc" | "acp" | "rpc-ui" | "bridge";
 
 export interface Args {
 	cwd?: string;
@@ -96,7 +96,14 @@ export function parseArgs(args: string[]): Args {
 			result.allowHome = true;
 		} else if (arg === "--mode" && i + 1 < args.length) {
 			const mode = args[++i];
-			if (mode === "text" || mode === "json" || mode === "rpc" || mode === "acp" || mode === "rpc-ui") {
+			if (
+				mode === "text" ||
+				mode === "json" ||
+				mode === "rpc" ||
+				mode === "acp" ||
+				mode === "rpc-ui" ||
+				mode === "bridge"
+			) {
 				result.mode = mode;
 			}
 		} else if (arg === "--continue" || arg === "-c") {

package/src/commands/deep-interview.ts

@@ -21,6 +21,7 @@ export default class DeepInterview extends Command {
 		deliberate: Flags.boolean({
 			description: "Shortcut for --write handoff to ralplan in deliberate consensus mode",
 		}),
+		force: Flags.boolean({ description: "Overwrite corrupt existing deep-interview state during --write" }),
 		json: Flags.boolean({ description: "Output JSON" }),
 	};
 	static examples = [