@gajae-code/coding-agent 0.18.5 → 0.18.6

package/dist/types/session/agent-session.d.ts

@@ -1111,7 +1111,11 @@ export declare class AgentSession {
     get sessionWorkLease(): SessionWorkLease;
     /** Stable resource ownership identifier for the active prompt run. */
     get activePromptHandle(): string | undefined;
-    /** All messages including custom types like BashExecutionMessage */
+    /**
+     * All messages including custom types like BashExecutionMessage. Request-scoped
+     * ephemeral copies are retained only in `agent.state.messages` to keep the provider
+     * cache prefix stable; they are never part of this public view.
+     */
     get messages(): AgentMessage[];
     get transcriptPromptGeneration(): number;
     static restoreFromMemoryGuardCheckpoint(input: AgentSessionMemoryGuardRestoreInput): Promise<AgentMemoryGuardRestoreResult>;

package/dist/types/tools/ask-contract.d.ts

@@ -267,133 +267,6 @@ export declare const topologyAskSchema: z.ZodObject<{
         }, z.core.$strip>>;
         multi: z.ZodOptional<z.ZodBoolean>;
         recommended: z.ZodOptional<z.ZodNumber>;
-        deepInterview: z.ZodOptional<z.ZodType<{
-            round_id?: string | undefined;
-            ambiguity: number;
-            confused_terms?: string[] | undefined;
-            references?: {
-                reference_id: string;
-                label: string;
-                origin: string;
-                url?: string | undefined;
-                excerpt?: string | undefined;
-            }[] | undefined;
-            round: number;
-            component: "review-topology";
-            dimension: "topology";
-            intent_contract: {
-                items: {
-                    id: string;
-                    category: "artifact" | "constraint" | "integration" | "surface";
-                    statement: string;
-                }[];
-                confirmation_options: string[];
-            };
-        } | {
-            round_id?: string | undefined;
-            component: string;
-            dimension: string;
-            ambiguity: number;
-            confused_terms?: string[] | undefined;
-            references?: {
-                reference_id: string;
-                label: string;
-                origin: string;
-                url?: string | undefined;
-                excerpt?: string | undefined;
-            }[] | undefined;
-            round: number;
-        } | {
-            round_id?: string | undefined;
-            component: string;
-            dimension: string;
-            ambiguity: number;
-            confused_terms?: string[] | undefined;
-            references?: {
-                reference_id: string;
-                label: string;
-                origin: string;
-                url?: string | undefined;
-                excerpt?: string | undefined;
-            }[] | undefined;
-            round: number;
-            intent_review: {
-                observed_items: {
-                    id: string;
-                    category: "artifact" | "constraint" | "integration" | "surface";
-                    statement: string;
-                }[];
-                supporting_substitutions: {
-                    removed_id: string;
-                    replacement_ids: string[];
-                    rationale: string;
-                }[];
-                approval_options: string[];
-            };
-        }, unknown, z.core.$ZodTypeInternals<{
-            round_id?: string | undefined;
-            ambiguity: number;
-            confused_terms?: string[] | undefined;
-            references?: {
-                reference_id: string;
-                label: string;
-                origin: string;
-                url?: string | undefined;
-                excerpt?: string | undefined;
-            }[] | undefined;
-            round: number;
-            component: "review-topology";
-            dimension: "topology";
-            intent_contract: {
-                items: {
-                    id: string;
-                    category: "artifact" | "constraint" | "integration" | "surface";
-                    statement: string;
-                }[];
-                confirmation_options: string[];
-            };
-        } | {
-            round_id?: string | undefined;
-            component: string;
-            dimension: string;
-            ambiguity: number;
-            confused_terms?: string[] | undefined;
-            references?: {
-                reference_id: string;
-                label: string;
-                origin: string;
-                url?: string | undefined;
-                excerpt?: string | undefined;
-            }[] | undefined;
-            round: number;
-        } | {
-            round_id?: string | undefined;
-            component: string;
-            dimension: string;
-            ambiguity: number;
-            confused_terms?: string[] | undefined;
-            references?: {
-                reference_id: string;
-                label: string;
-                origin: string;
-                url?: string | undefined;
-                excerpt?: string | undefined;
-            }[] | undefined;
-            round: number;
-            intent_review: {
-                observed_items: {
-                    id: string;
-                    category: "artifact" | "constraint" | "integration" | "surface";
-                    statement: string;
-                }[];
-                supporting_substitutions: {
-                    removed_id: string;
-                    replacement_ids: string[];
-                    rationale: string;
-                }[];
-                approval_options: string[];
-            };
-        }, unknown>>>;
         workflowGate: z.ZodOptional<z.ZodObject<{
             stage: z.ZodEnum<{
                 "deep-interview": "deep-interview";
@@ -406,6 +279,34 @@ export declare const topologyAskSchema: z.ZodObject<{
                 question: "question";
             }>;
         }, z.core.$strip>>;
+        deepInterview: z.ZodObject<{
+            round_id: z.ZodOptional<z.ZodString>;
+            ambiguity: z.ZodNumber;
+            confused_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                reference_id: z.ZodString;
+                label: z.ZodString;
+                origin: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+                excerpt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            round: z.ZodNumber;
+            component: z.ZodLiteral<"review-topology">;
+            dimension: z.ZodLiteral<"topology">;
+            intent_contract: z.ZodObject<{
+                items: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    category: z.ZodEnum<{
+                        artifact: "artifact";
+                        constraint: "constraint";
+                        integration: "integration";
+                        surface: "surface";
+                    }>;
+                    statement: z.ZodString;
+                }, z.core.$strict>>;
+                confirmation_options: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const postTopologyAskSchema: z.ZodObject<{
@@ -417,133 +318,6 @@ export declare const postTopologyAskSchema: z.ZodObject<{
         }, z.core.$strip>>;
         multi: z.ZodOptional<z.ZodBoolean>;
         recommended: z.ZodOptional<z.ZodNumber>;
-        deepInterview: z.ZodOptional<z.ZodType<{
-            round_id?: string | undefined;
-            ambiguity: number;
-            confused_terms?: string[] | undefined;
-            references?: {
-                reference_id: string;
-                label: string;
-                origin: string;
-                url?: string | undefined;
-                excerpt?: string | undefined;
-            }[] | undefined;
-            round: number;
-            component: "review-topology";
-            dimension: "topology";
-            intent_contract: {
-                items: {
-                    id: string;
-                    category: "artifact" | "constraint" | "integration" | "surface";
-                    statement: string;
-                }[];
-                confirmation_options: string[];
-            };
-        } | {
-            round_id?: string | undefined;
-            component: string;
-            dimension: string;
-            ambiguity: number;
-            confused_terms?: string[] | undefined;
-            references?: {
-                reference_id: string;
-                label: string;
-                origin: string;
-                url?: string | undefined;
-                excerpt?: string | undefined;
-            }[] | undefined;
-            round: number;
-        } | {
-            round_id?: string | undefined;
-            component: string;
-            dimension: string;
-            ambiguity: number;
-            confused_terms?: string[] | undefined;
-            references?: {
-                reference_id: string;
-                label: string;
-                origin: string;
-                url?: string | undefined;
-                excerpt?: string | undefined;
-            }[] | undefined;
-            round: number;
-            intent_review: {
-                observed_items: {
-                    id: string;
-                    category: "artifact" | "constraint" | "integration" | "surface";
-                    statement: string;
-                }[];
-                supporting_substitutions: {
-                    removed_id: string;
-                    replacement_ids: string[];
-                    rationale: string;
-                }[];
-                approval_options: string[];
-            };
-        }, unknown, z.core.$ZodTypeInternals<{
-            round_id?: string | undefined;
-            ambiguity: number;
-            confused_terms?: string[] | undefined;
-            references?: {
-                reference_id: string;
-                label: string;
-                origin: string;
-                url?: string | undefined;
-                excerpt?: string | undefined;
-            }[] | undefined;
-            round: number;
-            component: "review-topology";
-            dimension: "topology";
-            intent_contract: {
-                items: {
-                    id: string;
-                    category: "artifact" | "constraint" | "integration" | "surface";
-                    statement: string;
-                }[];
-                confirmation_options: string[];
-            };
-        } | {
-            round_id?: string | undefined;
-            component: string;
-            dimension: string;
-            ambiguity: number;
-            confused_terms?: string[] | undefined;
-            references?: {
-                reference_id: string;
-                label: string;
-                origin: string;
-                url?: string | undefined;
-                excerpt?: string | undefined;
-            }[] | undefined;
-            round: number;
-        } | {
-            round_id?: string | undefined;
-            component: string;
-            dimension: string;
-            ambiguity: number;
-            confused_terms?: string[] | undefined;
-            references?: {
-                reference_id: string;
-                label: string;
-                origin: string;
-                url?: string | undefined;
-                excerpt?: string | undefined;
-            }[] | undefined;
-            round: number;
-            intent_review: {
-                observed_items: {
-                    id: string;
-                    category: "artifact" | "constraint" | "integration" | "surface";
-                    statement: string;
-                }[];
-                supporting_substitutions: {
-                    removed_id: string;
-                    replacement_ids: string[];
-                    rationale: string;
-                }[];
-                approval_options: string[];
-            };
-        }, unknown>>>;
         workflowGate: z.ZodOptional<z.ZodObject<{
             stage: z.ZodEnum<{
                 "deep-interview": "deep-interview";
@@ -556,6 +330,53 @@ export declare const postTopologyAskSchema: z.ZodObject<{
                 question: "question";
             }>;
         }, z.core.$strip>>;
+        deepInterview: z.ZodUnion<readonly [z.ZodObject<{
+            round_id: z.ZodOptional<z.ZodString>;
+            component: z.ZodString;
+            dimension: z.ZodString;
+            ambiguity: z.ZodNumber;
+            confused_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                reference_id: z.ZodString;
+                label: z.ZodString;
+                origin: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+                excerpt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            round: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            round_id: z.ZodOptional<z.ZodString>;
+            component: z.ZodString;
+            dimension: z.ZodString;
+            ambiguity: z.ZodNumber;
+            confused_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                reference_id: z.ZodString;
+                label: z.ZodString;
+                origin: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+                excerpt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            round: z.ZodNumber;
+            intent_review: z.ZodObject<{
+                observed_items: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    category: z.ZodEnum<{
+                        artifact: "artifact";
+                        constraint: "constraint";
+                        integration: "integration";
+                        surface: "surface";
+                    }>;
+                    statement: z.ZodString;
+                }, z.core.$strict>>;
+                supporting_substitutions: z.ZodArray<z.ZodObject<{
+                    removed_id: z.ZodString;
+                    replacement_ids: z.ZodArray<z.ZodString>;
+                    rationale: z.ZodString;
+                }, z.core.$strict>>;
+                approval_options: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>]>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const ordinaryAskSchema: z.ZodObject<{

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

@@ -10,7 +10,7 @@ import type { ToolSession } from ".";
 import { type OutputMeta } from "./output-meta";
 export { STEER_FOLD_GRACE_MS, steerFoldReasonLine } from "./steer-fold";
 export declare const BASH_DEFAULT_PREVIEW_LINES = 10;
-export declare const MANAGED_OWNER_BASH_ENV: readonly ["GJC_TMUX_OWNER_STATE_DIR", "GJC_TMUX_OWNER_GENERATION", "GJC_MANAGED_OWNER_RUN_ID", "GJC_MANAGED_OWNER_INCARNATION", "GJC_MANAGED_OWNER_CHILD_TOKEN", "GJC_MANAGED_OWNER_PREDECESSOR_TOKEN", "GJC_MANAGED_OWNER_PREDECESSOR_GENERATION", "GJC_MANAGED_OWNER_PREDECESSOR_RUN_ID", "GJC_MANAGED_OWNER_PREDECESSOR_INCARNATION", "GJC_MANAGED_OWNER_TRANSCRIPT_PATH", "GJC_TMUX_OWNER_SERVER_KEY", "GJC_TMUX_LAUNCHED"];
+export declare const MANAGED_OWNER_BASH_ENV: readonly ["GJC_TMUX_OWNER_STATE_DIR", "GJC_TMUX_OWNER_GENERATION", "GJC_MANAGED_OWNER_RUN_ID", "GJC_MANAGED_OWNER_INCARNATION", "GJC_MANAGED_OWNER_CHILD_TOKEN", "GJC_MANAGED_OWNER_COMMAND_JSON", "GJC_MANAGED_OWNER_REDACT_COMMAND", "GJC_MANAGED_OWNER_PREDECESSOR_TOKEN", "GJC_MANAGED_OWNER_PREDECESSOR_GENERATION", "GJC_MANAGED_OWNER_PREDECESSOR_RUN_ID", "GJC_MANAGED_OWNER_PREDECESSOR_INCARNATION", "GJC_MANAGED_OWNER_TRANSCRIPT_PATH", "GJC_TMUX_OWNER_SERVER_KEY", "GJC_TMUX_LAUNCHED"];
 export type BashOriginalArtifactSaveResult = BashArtifactSaveResult;
 /**
  * Lift a leading `cd <dir> &&` into the tool cwd only when `<dir>` is exactly

package/package.json

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

package/scripts/build-sdk-package-smoke.ts

@@ -12,6 +12,7 @@ const tuiPackageDir = path.resolve(packageDir, "../tui");
 const nativesPackageDir = path.resolve(packageDir, "../natives");
 const linuxX64PackageDir = path.resolve(packageDir, "../natives-linux-x64");
 const utilsPackageDir = path.resolve(packageDir, "../utils");
+const statsPackageDir = path.resolve(packageDir, "../stats");
 const manifestsDir = path.join(packageDir, "test/manifests");
 // v2 intentionally removes eager concrete-tool exports to preserve the SDK cold boundary.
 const baselineVersion = 2;
@@ -51,6 +52,7 @@ async function runSmoke(): Promise<Surface> {
 		const nativesTarball = run(["bun", "pm", "pack", "--destination", tempDir, "--quiet"], nativesPackageDir);
 		const linuxX64Tarball = run(["bun", "pm", "pack", "--destination", tempDir, "--quiet"], stagedLinuxX64Dir);
 		const utilsTarball = run(["bun", "pm", "pack", "--destination", tempDir, "--quiet"], utilsPackageDir);
+		const statsTarball = run(["bun", "pm", "pack", "--destination", tempDir, "--quiet"], statsPackageDir);
 		const codingAgentTarball = run(["bun", "pm", "pack", "--destination", tempDir, "--quiet"], packageDir);
 		const agentTarballPath = path.isAbsolute(agentTarball) ? agentTarball : path.join(agentPackageDir, agentTarball);
 		const aiTarballPath = path.isAbsolute(aiTarball) ? aiTarball : path.join(aiPackageDir, aiTarball);
@@ -62,6 +64,7 @@ async function runSmoke(): Promise<Surface> {
 			? linuxX64Tarball
 			: path.join(stagedLinuxX64Dir, linuxX64Tarball);
 		const utilsTarballPath = path.isAbsolute(utilsTarball) ? utilsTarball : path.join(utilsPackageDir, utilsTarball);
+		const statsTarballPath = path.isAbsolute(statsTarball) ? statsTarball : path.join(statsPackageDir, statsTarball);
 		const codingAgentTarballPath = path.isAbsolute(codingAgentTarball)
 			? codingAgentTarball
 			: path.join(packageDir, codingAgentTarball);
@@ -79,6 +82,7 @@ async function runSmoke(): Promise<Surface> {
 						"@gajae-code/natives": `file:${nativesTarballPath}`,
 						"@gajae-code/natives-linux-x64": `file:${linuxX64TarballPath}`,
 						"@gajae-code/utils": `file:${utilsTarballPath}`,
+						"@gajae-code/stats": `file:${statsTarballPath}`,
 					},
 					overrides: {
 						"@gajae-code/agent-core": `file:${agentTarballPath}`,
@@ -87,6 +91,7 @@ async function runSmoke(): Promise<Surface> {
 						"@gajae-code/natives": `file:${nativesTarballPath}`,
 						"@gajae-code/natives-linux-x64": `file:${linuxX64TarballPath}`,
 						"@gajae-code/utils": `file:${utilsTarballPath}`,
+						"@gajae-code/stats": `file:${statsTarballPath}`,
 					},
 				},
 				null,

package/src/cli/public-command-entry.ts

@@ -288,6 +288,11 @@ export function isSdkInternalArgv(argv: readonly string[]): boolean {
 	return (
 		(argv[0] === "session-host-internal" && argv.length === 1) ||
 		(argv[0] === "broker-internal" &&
+			argv.length === 3 &&
+			argv[1] === "--agent-dir" &&
+			typeof argv[2] === "string" &&
+			isSafeSdkInternalAgentDir(argv[2])) ||
+		(argv[0] === "broker-trampoline-internal" &&
 			argv.length === 3 &&
 			argv[1] === "--agent-dir" &&
 			typeof argv[2] === "string" &&

package/src/cli/ssh-cli.ts

@@ -74,9 +74,12 @@ async function handleAdd(cmd: SSHCommandArgs): Promise<void> {
 		return;
 	}
 
-	// Validate port if provided
+	// Validate port if provided. `Number.parseInt` accepts trailing garbage
+	// (parseInt("22oops") === 22, parseInt("2222.5") === 2222), so require
+	// the whole token to be digits before parsing.
+	let port: number | undefined;
 	if (cmd.flags.port !== undefined) {
-		const port = Number.parseInt(cmd.flags.port, 10);
+		port = /^\d+$/.test(cmd.flags.port) ? Number.parseInt(cmd.flags.port, 10) : Number.NaN;
 		if (Number.isNaN(port) || port < 1 || port > 65535) {
 			process.stdout.write(chalk.red("Error: Port must be an integer between 1 and 65535\n"));
 			process.exitCode = 1;
@@ -86,7 +89,7 @@ async function handleAdd(cmd: SSHCommandArgs): Promise<void> {
 
 	const hostConfig: SSHHostConfig = { host };
 	if (cmd.flags.user) hostConfig.username = cmd.flags.user;
-	if (cmd.flags.port) hostConfig.port = Number.parseInt(cmd.flags.port, 10);
+	if (port !== undefined) hostConfig.port = port;
 	if (cmd.flags.key) hostConfig.keyPath = cmd.flags.key;
 	if (cmd.flags.desc) hostConfig.description = cmd.flags.desc;
 	if (cmd.flags.compat) hostConfig.compat = true;

package/src/cli/web-search-cli.ts

@@ -95,7 +95,10 @@ export function parseSearchArgs(args: string[]): SearchCommandArgs | undefined {
 			result.recency = value() as SearchCommandArgs["recency"];
 			consumeSeparateValue();
 		} else if (arg === "--limit" || arg === "-l") {
-			result.limit = Number.parseInt(value(), 10);
+			const raw = value();
+			// `Number.parseInt` accepts trailing garbage ("5x" -> 5); leave
+			// anything that is not plain digits as NaN so it is rejected below.
+			result.limit = /^\d+$/.test(raw) ? Number.parseInt(raw, 10) : Number.NaN;
 			consumeSeparateValue();
 		} else if (arg === "--xai-mode") {
 			result.xaiSearchMode = value() as SearchCommandArgs["xaiSearchMode"];
@@ -164,8 +167,11 @@ export async function runSearchCommand(cmd: SearchCommandArgs): Promise<void> {
 		process.exit(1);
 	}
 
-	if (cmd.limit !== undefined && Number.isNaN(cmd.limit)) {
-		process.stderr.write(`${chalk.red("Error: --limit must be a number")}\n`);
+	// `Flags.integer` accepts `0` and negative values; providers forward them
+	// as `num_results` and several slice sources with them (`slice(0, -3)`
+	// silently drops the last three results).
+	if (cmd.limit !== undefined && (!Number.isSafeInteger(cmd.limit) || cmd.limit < 1)) {
+		process.stderr.write(`${chalk.red("Error: --limit must be a positive integer")}\n`);
 		process.exit(1);
 	}
 

package/src/cli-commands.ts

@@ -0,0 +1,14 @@
+import type { CommandEntry } from "@gajae-code/utils/cli";
+
+/**
+ * Public-family hooks kept available for private-worker tests without loading the
+ * full registry.
+ *
+ * This is the single shared array: the inert entry (`cli.ts`) and the ordinary
+ * dispatcher (`cli-ordinary.ts`) both re-export THIS object, so a test that
+ * mutates or injects an entry keeps affecting the dispatcher.
+ */
+export const commands: CommandEntry[] = [
+	{ name: "sdk", load: () => import("./commands/sdk").then(module => module.default) },
+	{ name: "daemon", load: () => import("./commands/daemon").then(module => module.default) },
+];