@gajae-code/coding-agent 0.15.2 → 0.15.3

package/dist/types/sdk/lifecycle/service.d.ts

@@ -1,4 +1,4 @@
-export type SessionLifecycleOperation = "session.create" | "session.fork" | "session.resume" | "session.close" | "session.delete" | "session.list";
+export type SessionLifecycleOperation = "session.create" | "session.fork" | "session.resume" | "session.close" | "session.delete" | "session.reconcile_uncertain" | "session.list";
 export interface SessionLifecycleActor {
     readonly id: string;
     readonly namespace: string;
@@ -84,6 +84,17 @@ export interface SessionCloseTarget {
     readonly endpointGeneration?: number;
     readonly endpointIncarnation?: string;
 }
+export interface SessionReconcileUncertainTarget {
+    readonly sessionId: string;
+    readonly cwd: string;
+    readonly stateRoot: string;
+    readonly endpointGeneration: number;
+    readonly endpointMtimeMs: number;
+    readonly processIncarnation: string;
+    readonly hostIncarnation: string;
+    readonly lifecycleRequestId: string;
+    readonly remoteCreateKey: string;
+}
 export interface SessionDeleteTarget {
     readonly sessionId: string;
     readonly cwd?: string;
@@ -107,6 +118,7 @@ export type SessionForkRequest = SessionLifecycleMutationRequestBase<"session.fo
 export type SessionResumeRequest = SessionLifecycleMutationRequestBase<"session.resume", SessionResumeTarget>;
 export type SessionCloseRequest = SessionLifecycleMutationRequestBase<"session.close", SessionCloseTarget>;
 export type SessionDeleteRequest = SessionLifecycleMutationRequestBase<"session.delete", SessionDeleteTarget>;
+export type SessionReconcileUncertainRequest = SessionLifecycleMutationRequestBase<"session.reconcile_uncertain", SessionReconcileUncertainTarget>;
 export interface SessionListRequest {
     readonly operation: "session.list";
     readonly actor: SessionLifecycleActor;
@@ -115,7 +127,7 @@ export interface SessionListRequest {
     readonly timeoutMs?: number;
 }
 export type SessionLifecycleRequest = SessionLifecycleMutationRequest | SessionListRequest;
-export type SessionLifecycleMutationRequest = SessionCreateRequest | SessionForkRequest | SessionResumeRequest | SessionCloseRequest | SessionDeleteRequest;
+export type SessionLifecycleMutationRequest = SessionCreateRequest | SessionForkRequest | SessionResumeRequest | SessionCloseRequest | SessionDeleteRequest | SessionReconcileUncertainRequest;
 export type SessionLifecycleCertainty = "terminal" | "retryable" | "cleanup_pending" | "uncertain";
 export interface SessionLifecycleSessionResult {
     readonly sessionId: string;
@@ -162,6 +174,11 @@ export interface SessionDeleteResult {
     readonly operation: "session.delete";
     readonly result: SessionLifecycleSessionResult;
 }
+export interface SessionReconcileUncertainResult {
+    readonly ok: true;
+    readonly operation: "session.reconcile_uncertain";
+    readonly result: SessionLifecycleSessionResult;
+}
 export interface SessionListSuccessResult {
     readonly ok: true;
     readonly operation: "session.list";
@@ -201,6 +218,12 @@ export type SessionDeleteFailure = {
     readonly certainty: SessionLifecycleCertainty;
     readonly error: SessionLifecycleError;
 };
+export type SessionReconcileUncertainFailure = {
+    readonly ok: false;
+    readonly operation: "session.reconcile_uncertain";
+    readonly certainty: SessionLifecycleCertainty;
+    readonly error: SessionLifecycleError;
+};
 export type SessionListFailure = {
     readonly ok: false;
     readonly operation: "session.list";
@@ -212,8 +235,9 @@ export type SessionForkOutcome = SessionForkResult | SessionForkFailure;
 export type SessionResumeOutcome = SessionResumeResult | SessionResumeFailure;
 export type SessionCloseOutcome = SessionCloseResult | SessionCloseFailure;
 export type SessionDeleteOutcome = SessionDeleteResult | SessionDeleteFailure;
+export type SessionReconcileUncertainOutcome = SessionReconcileUncertainResult | SessionReconcileUncertainFailure;
 export type SessionListOutcome = SessionListSuccessResult | SessionListFailure;
-export type SessionLifecycleResult = SessionCreateOutcome | SessionForkOutcome | SessionResumeOutcome | SessionCloseOutcome | SessionDeleteOutcome | SessionListOutcome;
+export type SessionLifecycleResult = SessionCreateOutcome | SessionForkOutcome | SessionResumeOutcome | SessionCloseOutcome | SessionDeleteOutcome | SessionReconcileUncertainOutcome | SessionListOutcome;
 /** Shared, side-effect-free validation for lifecycle mutation requests. */
 export type SessionLifecycleMutationValidation = {
     readonly ok: true;
@@ -221,20 +245,23 @@ export type SessionLifecycleMutationValidation = {
     readonly actor: SessionLifecycleActor;
     readonly requestKey: string;
     readonly target: Readonly<Record<string, unknown>>;
-} | SessionCreateFailure | SessionForkFailure | SessionResumeFailure | SessionCloseFailure | SessionDeleteFailure;
+} | SessionCreateFailure | SessionForkFailure | SessionResumeFailure | SessionCloseFailure | SessionDeleteFailure | SessionReconcileUncertainFailure;
 /** Derives a stable Broker idempotency key without exposing caller identity to Broker inputs. */
 export declare function deriveSessionLifecycleIdempotencyKey(actor: SessionLifecycleActor, requestKey: string, operation: SessionLifecycleOperation): string;
+export declare function validateSessionReconcileUncertainTarget(value: unknown): value is SessionReconcileUncertainTarget;
 /** Validates lifecycle authority and shape without contacting the Broker. */
 export declare function validateSessionLifecycleMutationRequest(request: unknown): SessionLifecycleMutationValidation;
 export declare class SessionLifecycleService {
     #private;
     constructor(client: SessionLifecycleClient);
-    execute(request: SessionLifecycleMutationRequest): Promise<SessionCreateOutcome | SessionForkOutcome | SessionResumeOutcome | SessionCloseOutcome | SessionDeleteOutcome>;
+    execute(request: SessionLifecycleMutationRequest): Promise<SessionCreateOutcome | SessionForkOutcome | SessionResumeOutcome | SessionCloseOutcome | SessionDeleteOutcome | SessionReconcileUncertainOutcome>;
+    executeWithIdempotencyKey(request: SessionLifecycleMutationRequest, idempotencyKey: string): Promise<SessionCreateOutcome | SessionForkOutcome | SessionResumeOutcome | SessionCloseOutcome | SessionDeleteOutcome | SessionReconcileUncertainOutcome>;
     create(request: Omit<SessionCreateRequest, "operation">): Promise<SessionCreateOutcome>;
     fork(request: Omit<SessionForkRequest, "operation">): Promise<SessionForkOutcome>;
     resume(request: Omit<SessionResumeRequest, "operation">): Promise<SessionResumeOutcome>;
     close(request: Omit<SessionCloseRequest, "operation">): Promise<SessionCloseOutcome>;
     delete(request: Omit<SessionDeleteRequest, "operation">): Promise<SessionDeleteOutcome>;
+    reconcileUncertain(request: Omit<SessionReconcileUncertainRequest, "operation">): Promise<SessionReconcileUncertainOutcome>;
     list(request: Omit<SessionListRequest, "operation">): Promise<SessionListOutcome>;
 }
 export {};

package/dist/types/sdk/session.d.ts

@@ -67,6 +67,11 @@ export interface CreateAgentSessionOptions {
     authStorage?: AuthStorage;
     /** Model registry. Default: discoverModels(authStorage, agentDir) */
     modelRegistry?: ModelRegistry;
+    /** @internal Allows the first-party CLI root to mutate its own registry and observe an admission attempt. */
+    modelRegistryStartupMutation?: {
+        owner: "cli-root";
+        onAttempt(): void;
+    };
     /** Model to use. Default: from settings, else first available */
     model?: Model;
     /** Raw model pattern string (e.g. from --model CLI flag) to resolve after extensions load.

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

@@ -302,6 +302,8 @@ export interface AgentSessionConfig {
     initialMCPToolSelectionIsExplicit?: boolean;
     /** Whether a discoverable built-in selection was explicitly supplied to the constructor, including an empty selection. */
     initialDiscoveredBuiltinToolSelectionIsExplicit?: boolean;
+    /** Whether the caller explicitly disabled every built-in tool for this session. */
+    explicitEmptyToolSelection?: boolean;
     /** Whether constructor-provided MCP selections should be persisted immediately. */
     persistInitialMCPToolSelection?: boolean;
     /** Whether constructor-provided discovered-built-in selections should be persisted immediately. */
@@ -816,6 +818,8 @@ export declare class AgentSession {
      * Returns the names of tools currently set on the agent.
      */
     getActiveToolNames(): string[];
+    /** Whether this session explicitly requested zero built-in tools. */
+    isExplicitEmptyToolSelection(): boolean;
     /** Whether the edit tool is registered in this session. */
     get hasEditTool(): boolean;
     /**

package/dist/types/session/fallback-chain-controller.d.ts

@@ -60,6 +60,14 @@ export declare class FallbackChainController {
         reason: string;
     }>): void;
     onAttemptFailure(triggerClass: FallbackTriggerClass, reason: string): FallbackFailureResult;
+    /**
+     * Record one bounded escaped-argument exhaustion for the active model and
+     * advance immediately. The discarded wire attempts are intentionally not
+     * provider charges; this single policy charge prevents the same model from
+     * being retried forever while still allowing every eligible fallback model
+     * its own literal-UTF-8 recovery budget.
+     */
+    recordEscapedArgumentsFailure(reason: string, advance?: boolean): boolean;
     advance(): boolean;
     /**
      * Restore the entry that just advanced for one attempt with a rotated credential.

package/dist/types/slash-commands/helpers/aside.d.ts

@@ -0,0 +1,54 @@
+import { type ExecOptions, type ExecResult } from "../../exec/exec";
+import type { ParsedSlashCommand, SlashCommandResult, SlashCommandRuntime } from "../types";
+/**
+ * Aside CLI discovery and `/aside` dispatch.
+ *
+ * Probe-only: never runs the installer. Missing-CLI handling is the caller's
+ * decision. This is an explicit composer frontend, not a GJC browser backend.
+ */
+export declare const ASIDE_INSTALL_URL = "https://releases.aside.com/install.sh";
+export declare const ASIDE_INSTALL_COMMAND = "curl -fsSL https://releases.aside.com/install.sh | bash";
+export declare const ASIDE_USAGE: string;
+export type AsideCliProbe = {
+    ok: true;
+    path: string;
+} | {
+    ok: false;
+    searched: string[];
+    manualInstallCommand: string;
+    url: string;
+};
+export type AsideWhich = (command: string) => string | null | undefined;
+export type AsideIsExecutable = (filePath: string) => boolean;
+export type AsideExec = (command: string, args: string[], cwd: string, options?: ExecOptions) => Promise<ExecResult>;
+export interface AsideHandlerOptions {
+    homedir?: () => string;
+    which?: AsideWhich;
+    isExecutable?: AsideIsExecutable;
+    exec?: AsideExec;
+}
+/** Candidate absolute paths for the `aside` CLI, in priority order. */
+export declare function asideCliCandidates(home?: string): string[];
+/** Resolve the first executable Aside CLI path, or null when none is found. */
+export declare function resolveAsideCliPath(home?: string, options?: Pick<AsideHandlerOptions, "which" | "isExecutable">): string | null;
+/** Structured probe result for callers that need to guide installation. */
+export declare function probeAsideCli(home?: string, options?: Pick<AsideHandlerOptions, "which" | "isExecutable">): AsideCliProbe;
+export declare function posixQuote(value: string): string;
+/** Quote a path for the PowerShell command shown on native Windows. */
+export declare function windowsPowerShellQuote(value: string): string;
+type AsideArgvResult = {
+    ok: true;
+    args: string[];
+} | {
+    ok: false;
+    error: string;
+};
+/** Parse user-provided Aside argv without silently accepting malformed quoting. */
+export declare function parseAsideArgv(input: string): AsideArgvResult;
+export declare function formatAsideMissingCli(probe: Extract<AsideCliProbe, {
+    ok: false;
+}>): string;
+export declare function formatAsideMcpRegistration(cliPath: string, platform?: NodeJS.Platform): string;
+export declare function createAsideHandler(options?: AsideHandlerOptions): (command: ParsedSlashCommand, runtime: SlashCommandRuntime) => Promise<SlashCommandResult>;
+export declare const handleAsideAcp: (command: ParsedSlashCommand, runtime: SlashCommandRuntime) => Promise<SlashCommandResult>;
+export {};

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

@@ -86,6 +86,14 @@ export declare class AskTool implements AgentTool<AskParametersSchema, AskToolDe
     get parameters(): AskParametersSchema;
     readonly rawArgumentValidation: (arguments_: Record<string, unknown>) => RawArgumentValidationResult;
     readonly strict = true;
+    /**
+     * Display-only fields: question text and option labels render to the user
+     * and carry no executable or persisted meaning, so `\uXXXX`-escaped
+     * non-ASCII text inside them degrades to a warning instead of failing the
+     * run (issue #4983). Ids, workflow-gate metadata, and deep-interview
+     * records stay load-bearing and keep the fail-closed rejection.
+     */
+    readonly displaySafeEscapedArgFields: readonly ["questions.question", "questions.options.label"];
     readonly loadMode = "discoverable";
     constructor(session: ToolSession);
     static createIf(session: ToolSession): AskTool | null;

package/dist/types/utils/clipboard.d.ts

@@ -8,6 +8,14 @@ export declare class ClipboardTransportError extends Error {
     readonly context?: Record<string, unknown> | undefined;
     constructor(message: string, context?: Record<string, unknown> | undefined);
 }
+export type ClipboardDeliveryOutcome = {
+    status: "verified";
+    transport: "ssh";
+} | {
+    status: "attempted";
+    transport: "auto" | "native" | "osc52";
+    reason: string;
+};
 /**
  * Read text from the configured SSH clipboard host (`pbpaste`).
  *
@@ -31,7 +39,7 @@ export declare function pasteFromClipboardViaSsh(host: string): Promise<string>;
  *
  * @param text - UTF-8 text to place on the clipboard.
  */
-export declare function copyToClipboard(text: string): Promise<void>;
+export declare function copyToClipboard(text: string): Promise<ClipboardDeliveryOutcome>;
 /**
  * Paste text from the configured clipboard transport.
  *

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/coding-agent",
-	"version": "0.15.2",
+	"version": "0.15.3",
 	"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",
@@ -56,12 +56,12 @@
 		"@agentclientprotocol/sdk": "1.3.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@gajae-code/stats": "0.15.2",
-		"@gajae-code/agent-core": "0.15.2",
-		"@gajae-code/ai": "0.15.2",
-		"@gajae-code/natives": "0.15.2",
-		"@gajae-code/tui": "0.15.2",
-		"@gajae-code/utils": "0.15.2",
+		"@gajae-code/stats": "0.15.3",
+		"@gajae-code/agent-core": "0.15.3",
+		"@gajae-code/ai": "0.15.3",
+		"@gajae-code/natives": "0.15.3",
+		"@gajae-code/tui": "0.15.3",
+		"@gajae-code/utils": "0.15.3",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/scripts/generate-sdk-adapter-parity-manifest.ts

@@ -44,7 +44,8 @@ const required = [...commandFiles];
 const excluded: Manifest["excluded"] = [];
 const adapters = ["telegram", "discord", "slack", "mcp", "acp", "daemonCli"] as const;
 
-function expectedOutcome(disposition: AdapterDisposition): ManifestAdapterRow["expected"] {
+function expectedOutcome(disposition: AdapterDisposition, sdkId?: string): ManifestAdapterRow["expected"] {
+	if (sdkId === "session.reconcile_uncertain") return "rejected_before_send";
 	return disposition === "prohibited"
 		? "rejected_before_send"
 		: disposition === "machine_only" || disposition === "provider_only"
@@ -88,7 +89,9 @@ function row(adapter: Adapter, operation: (typeof OPERATIONS)[number], secret =
 			"--test-name-pattern",
 			`^AD-${adapterTestPrefix(adapter)}-${operation.id}${suffix}:`,
 		],
-		expected: secret ? "rejected_before_send" : expectedOutcome(operation.adapterDispositions[adapter]),
+		expected: secret
+			? "rejected_before_send"
+			: expectedOutcome(operation.adapterDispositions[adapter], operation.sdkId),
 	};
 }
 

package/scripts/generate-sdk-operation-inventory.ts

@@ -43,6 +43,7 @@ const LOCKED_EXCLUSIONS: Readonly<Record<string, string>> = {
 	"slash_command:exit": "visual/local-only command, not a user-facing SDK control seam",
 	"slash_command:notify":
 		"interactive diagnostics command; session on/off delegate to the notifications extension, not an SDK ingress seam",
+	"slash_command:aside": "explicit user-owned external CLI process launcher; not a credential-free SDK control seam",
 	"slash_command:extensions":
 		"interactive local customization dashboard mutates trusted local skill, hook, and MCP configuration (including filesystem import/removal); ACP and local headless cannot dispatch it, while SDK extension list/enable operations do not expose this dashboard authority",
 	"slash_command:credential":
@@ -78,6 +79,8 @@ const LOCKED_EXCLUSIONS: Readonly<Record<string, string>> = {
 	"agent_session:setForcedToolChoice": "internal accessor/plumbing, not a user-facing control seam",
 	"agent_session:getActiveSkillState": "internal accessor/plumbing, not a user-facing control seam",
 	"agent_session:getActiveSkillPhase": "internal accessor/plumbing, not a user-facing control seam",
+	"agent_session:isExplicitEmptyToolSelection":
+		"internal tool-selection predicate used to preserve the --no-tools boundary, not a user-facing SDK control seam",
 	"agent_session:getEffectiveActiveWorkflowSkillState":
 		"internal restored-or-live workflow guard for session rescope, not a user-facing SDK control seam",
 	"agent_session:replaceOwnedMcpManager":

package/src/commands/sdk.ts

@@ -816,12 +816,12 @@ class SdkServeHelp extends Command {
 
 class SdkSessionHelp extends Command {
 	static description =
-		"Manage SDK sessions: `gjc sdk session list|inspect|send|status|tail`, or the explicit raw hatch `gjc sdk session raw control|query|global`. The session CLI is broker-bound and credential-free.";
+		"Manage SDK sessions: `gjc sdk session list|inspect|send|status|tail|retire`, or the explicit raw hatch `gjc sdk session raw control|query|global`. The session CLI is broker-bound and credential-free.";
 	static args = {
 		verb: Args.string({
 			description: "Session verb",
 			required: false,
-			options: ["list", "inspect", "send", "status", "tail", "raw"],
+			options: ["list", "inspect", "send", "status", "tail", "retire", "raw"],
 		}),
 		target: Args.string({
 			description: "Session id (or the raw kind control|query|global for `raw`)",

package/src/config/autorouting-tier-map.ts

@@ -155,15 +155,6 @@ export const TIER_MAP_SKIP_LIST = {
 	"cursor/gemini-3.7-flash-medium": {
 		rationale: "post-rebase catalog addition from dev; not yet curated",
 	},
-	"google-antigravity/gemini-3.7-flash-high": {
-		rationale: "post-rebase catalog addition from dev; not yet curated",
-	},
-	"google-antigravity/gemini-3.7-flash-low": {
-		rationale: "post-rebase catalog addition from dev; not yet curated",
-	},
-	"google-antigravity/gemini-3.7-flash-medium": {
-		rationale: "post-rebase catalog addition from dev; not yet curated",
-	},
 	"google-antigravity/gemini-3.7-flash-tiered": {
 		rationale: "post-rebase catalog addition from dev; not yet curated",
 	},

package/src/config/file-lock.ts

@@ -3,6 +3,7 @@ import type { Stats } from "node:fs";
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import { hasFsCode, isEnoent } from "@gajae-code/utils/fs-error";
+import { nativeProcessBindings } from "@gajae-code/utils/native-process";
 
 export interface FileLockOptions {
 	staleMs?: number;
@@ -33,9 +34,22 @@ export const FileLockTestHooks: {
 /**
  * Returns the OS-provided process start timestamp for PID-reuse detection.
  * `ps` is available on the supported Unix hosts (macOS and Linux), unlike
- * Linux's `/proc/<pid>/stat` pseudo-file.
+ * Linux's `/proc/<pid>/stat` pseudo-file. Windows has no `ps`; there the
+ * kernel-derived process creation time exposed by the natives addon
+ * (`Process.incarnation`, the same identity evidence the SDK broker prefers)
+ * is used instead. Either way the value is only ever compared for equality
+ * against a value this same function produced on the same platform, and `null`
+ * stays fail-closed: an owner whose incarnation cannot be proved is never
+ * treated as reused.
  */
 export function processStartTime(pid: number): string | null {
+	if (process.platform === "win32") {
+		try {
+			return nativeProcessBindings().Process.fromPid(pid)?.incarnation ?? null;
+		} catch {
+			return null;
+		}
+	}
 	try {
 		const result = Bun.spawnSync(["ps", "-o", "lstart=", "-p", String(pid)], { stdout: "pipe", stderr: "ignore" });
 		if (result.exitCode !== 0) return null;

package/src/config/keybindings.ts

@@ -38,6 +38,7 @@ interface AppKeybindings {
 	"app.clipboard.pasteText": true;
 	"app.clipboard.copyLine": true;
 	"app.clipboard.copyPrompt": true;
+	"app.clipboard.copyOAuthUrl": true;
 	"app.session.new": true;
 	"app.session.tree": true;
 	"app.session.fork": true;
@@ -61,6 +62,7 @@ interface AppKeybindings {
 	"app.transcript.nextTurn": true;
 	"app.mode.cycle": true;
 	"app.tasks.toggle": true;
+	"app.todo.toggle": true;
 	"app.queue.togglePane": true;
 	"app.message.sendNow": true;
 }
@@ -171,20 +173,24 @@ export const KEYBINDINGS = {
 		defaultKeys: "alt+shift+c",
 		description: "Copy prompt",
 	},
+	"app.clipboard.copyOAuthUrl": {
+		defaultKeys: "alt+shift+u",
+		description: "Copy OAuth URL",
+	},
 	"app.session.new": {
 		defaultKeys: "ctrl+n",
 		description: "Start a new session",
 	},
 	"app.session.tree": {
-		defaultKeys: [],
+		defaultKeys: "alt+shift+s",
 		description: "Show session tree",
 	},
 	"app.session.fork": {
-		defaultKeys: [],
+		defaultKeys: "alt+shift+f",
 		description: "Branch from message",
 	},
 	"app.session.resume": {
-		defaultKeys: [],
+		defaultKeys: "alt+shift+r",
 		description: "Resume session",
 	},
 	"app.session.observe": {
@@ -264,6 +270,10 @@ export const KEYBINDINGS = {
 		defaultKeys: "alt+t",
 		description: "Toggle tasks pane",
 	},
+	"app.todo.toggle": {
+		defaultKeys: "alt+shift+t",
+		description: "Toggle todo list expansion",
+	},
 	"app.queue.togglePane": {
 		defaultKeys: [],
 		description: "Toggle message queue pane",