@gajae-code/coding-agent 0.5.1 → 0.5.3

package/dist/types/modes/rpc/rpc-mode.d.ts

@@ -12,7 +12,7 @@
  */
 import type { ExtensionUIContext, ExtensionUIDialogOptions } from "../../extensibility/extensions";
 import type { AgentSession } from "../../session/agent-session";
-import type { RpcExtensionUIRequest, RpcExtensionUIResponse, RpcHostToolCallRequest, RpcHostToolCancelRequest, RpcHostUriCancelRequest, RpcHostUriRequest, RpcResponse } from "./rpc-types";
+import type { RpcCommand, RpcExtensionUIRequest, RpcExtensionUIResponse, RpcHostToolCallRequest, RpcHostToolCancelRequest, RpcHostUriCancelRequest, RpcHostUriRequest, RpcResponse } from "./rpc-types";
 export type * from "./rpc-types";
 export type PendingExtensionRequest = {
     resolve: (response: RpcExtensionUIResponse) => void;
@@ -20,6 +20,61 @@ export type PendingExtensionRequest = {
 };
 type RpcOutput = (obj: RpcResponse | RpcExtensionUIRequest | RpcHostToolCallRequest | RpcHostToolCancelRequest | RpcHostUriRequest | RpcHostUriCancelRequest | object) => void;
 export declare function shouldEmitRpcTitlesForTest(): boolean;
+/**
+ * Cancellation commands bypass the ordered serial chain because they must
+ * interrupt in-flight work — they cannot wait behind the very command they are
+ * meant to abort.
+ */
+export declare const RPC_CANCELLATION_COMMANDS: ReadonlySet<RpcCommand["type"]>;
+/**
+ * Safe read-only commands that bypass the ordered serial chain so they never
+ * head-of-line-block behind a long-running ordered command like
+ * `bash`/`compact`/`handoff`/`login` (#606, issue 13 — the partial fix only
+ * fast-laned cancellation).
+ *
+ * Every command listed here has a dispatch handler that is **fully synchronous
+ * and side-effect-free**: on the single-threaded event loop it runs to
+ * completion between the await points of any in-flight ordered command, reading
+ * live state without mutating it. Because such a read performs no causal write,
+ * jumping ahead of an earlier *queued* ordered command is observably harmless —
+ * there is no state change to reorder. Read payloads are additionally
+ * snapshotted inside the handler (e.g. `get_messages` returns a shallow copy of
+ * `session.messages`) so a fast-lane read can never serialize a half-mutated
+ * array that an ordered turn/compaction is rewriting in place.
+ *
+ * Deliberately excluded (kept ordered): every async/long command and every
+ * mutating command. In particular the control-flag setters (`set_thinking_level`,
+ * `cycle_thinking_level`, `set_steering_mode`, `set_follow_up_mode`,
+ * `set_interrupt_mode`, `set_auto_compaction`, `set_auto_retry`) stay ordered.
+ * Their handlers are synchronous, so fast-laning one ahead of an already-queued
+ * `prompt`/`bash` would apply the new mode *before* that earlier command runs —
+ * the earlier command would then observe the later setter's value, a
+ * causal-order (arrival-order) regression. Mutations therefore stay on the
+ * chain, and new command types default to ordered (fail-safe).
+ */
+export declare const RPC_SAFE_READ_CONTROL_COMMANDS: ReadonlySet<RpcCommand["type"]>;
+/** True when a command may bypass the ordered serial chain and run immediately. */
+export declare function isFastLaneRpcCommand(type: RpcCommand["type"]): boolean;
+/**
+ * Schedules inbound RPC commands: fast-lane commands run immediately while
+ * everything else runs through a serial chain so causal order is preserved. The
+ * read loop never blocks, which is what lets a fast-lane command reach a
+ * long-running ordered command instead of being head-of-line-blocked behind it.
+ */
+export declare function createRpcCommandScheduler(run: (command: RpcCommand) => Promise<void>, track: (task: Promise<void>) => void): {
+    dispatch: (command: RpcCommand) => void;
+};
+export declare class RpcListenRefusedError extends Error {
+    constructor(socketPath: string);
+}
+/**
+ * Probe whether a unix-domain socket path has a live server accepting
+ * connections. Returns `true` when a connection succeeds (a previous owner is
+ * still alive), and returns `false` only for known missing/stale endpoints
+ * (ENOENT / ECONNREFUSED). Unexpected probe failures fail closed as "alive" so
+ * `--listen` startup refuses to unlink a path it could not safely classify.
+ */
+export declare function isUnixSocketAlive(socketPath: string): Promise<boolean>;
 export declare function requestRpcEditor(pendingRequests: Map<string, PendingExtensionRequest>, output: RpcOutput, title: string, prefill?: string, dialogOptions?: ExtensionUIDialogOptions, editorOptions?: {
     promptStyle?: boolean;
 }): Promise<string | undefined>;

package/dist/types/modes/shared/agent-wire/unattended-session.d.ts

@@ -14,10 +14,20 @@
  * Also implements the dispatch-facing {@link RpcUnattendedControlPlane} so the
  * RPC server can route `negotiate_unattended` + `workflow_gate_response` here.
  */
+import type { Model } from "@gajae-code/ai";
 import type { RpcCommand, RpcUnattendedAccepted, RpcUnattendedDeclaration, RpcWorkflowGate, RpcWorkflowGateResolution, RpcWorkflowGateResponse } from "../../rpc/rpc-types";
 import type { RpcUnattendedControlPlane } from "./command-dispatch";
 import { type UnattendedAbortHooks, type UnattendedAuditEvent, UnattendedRunController } from "./unattended-run-controller";
 import { type GateStore, type OpenGateInput } from "./workflow-gate-broker";
+/**
+ * Derive an explicit `providerSupportsTokenCostMetrics` capability from the
+ * active model so unattended negotiation fails closed when token/cost usage
+ * cannot be accounted for (#606). Callers that omit a model — or whose model is
+ * configured to suppress streaming usage (`compat.supportsUsageInStreaming:
+ * false`) — get `false`, which the controller refuses with
+ * `unsupported_budget_metric`.
+ */
+export declare function modelSupportsTokenCostMetrics(model: Model | undefined): boolean;
 /** Minimal surface a skill runtime / ask tool uses to emit a gate and await its answer. */
 export interface WorkflowGateEmitter {
     /** True only when unattended mode has been negotiated. */

package/dist/types/modes/theme/defaults/index.d.ts

@@ -125,6 +125,308 @@ export declare const defaultThemes: {
             };
         };
     };
+    "claude-code": {
+        $schema: string;
+        name: string;
+        vars: {
+            "bg": string;
+            "surface": string;
+            "surfaceSubtle": string;
+            "separator": string;
+            "fg": string;
+            "muted": string;
+            "dim": string;
+            "brandTerracotta": string;
+            "shimmerTerracotta": string;
+            "toolPink": string;
+            "lavender": string;
+            "autoAcceptPurple": string;
+            "successGreen": string;
+            "warningAmber": string;
+            "errorSoftRed": string;
+            "diffAddedBg": string;
+            "diffRemovedBg": string;
+            "diffRemovedFg": string;
+        };
+        colors: {
+            "accent": string;
+            "border": string;
+            "borderAccent": string;
+            "borderMuted": string;
+            "success": string;
+            "error": string;
+            "warning": string;
+            "muted": string;
+            "dim": string;
+            "text": string;
+            "thinkingText": string;
+            "selectedBg": string;
+            "userMessageBg": string;
+            "userMessageText": string;
+            "customMessageBg": string;
+            "customMessageText": string;
+            "customMessageLabel": string;
+            "toolPendingBg": string;
+            "toolSuccessBg": string;
+            "toolErrorBg": string;
+            "toolTitle": string;
+            "toolOutput": string;
+            "mdHeading": string;
+            "mdLink": string;
+            "mdLinkUrl": string;
+            "mdCode": string;
+            "mdCodeBlock": string;
+            "mdCodeBlockBorder": string;
+            "mdQuote": string;
+            "mdQuoteBorder": string;
+            "mdHr": string;
+            "mdListBullet": string;
+            "toolDiffAdded": string;
+            "toolDiffRemoved": string;
+            "toolDiffContext": string;
+            "syntaxComment": string;
+            "syntaxKeyword": string;
+            "syntaxFunction": string;
+            "syntaxVariable": string;
+            "syntaxString": string;
+            "syntaxNumber": string;
+            "syntaxType": string;
+            "syntaxOperator": string;
+            "syntaxPunctuation": string;
+            "thinkingOff": string;
+            "thinkingMinimal": string;
+            "thinkingLow": string;
+            "thinkingMedium": string;
+            "thinkingHigh": string;
+            "thinkingXhigh": string;
+            "bashMode": string;
+            "pythonMode": string;
+            "statusLineBg": string;
+            "statusLineSep": string;
+            "statusLineModel": string;
+            "statusLinePath": string;
+            "statusLineGitClean": string;
+            "statusLineGitDirty": string;
+            "statusLineContext": string;
+            "statusLineSpend": string;
+            "statusLineStaged": string;
+            "statusLineDirty": string;
+            "statusLineUntracked": string;
+            "statusLineOutput": string;
+            "statusLineCost": string;
+            "statusLineSubagents": string;
+        };
+        export: {
+            "pageBg": string;
+            "cardBg": string;
+            "infoBg": string;
+        };
+        symbols: {
+            "preset": string;
+        };
+    };
+    codex: {
+        $schema: string;
+        name: string;
+        vars: {
+            "bg": string;
+            "surface": string;
+            "surfaceBright": string;
+            "selection": string;
+            "fg": string;
+            "muted": string;
+            "dim": string;
+            "borderNeutral": string;
+            "ansiCyan": string;
+            "cyanSoft": string;
+            "brandMagenta": string;
+            "magentaSoft": string;
+            "successGreen": string;
+            "errorRed": string;
+            "warningOrange": string;
+            "diffRemovalRed": string;
+            "toolSuccessBg": string;
+            "toolErrorBg": string;
+        };
+        colors: {
+            "accent": string;
+            "border": string;
+            "borderAccent": string;
+            "borderMuted": string;
+            "success": string;
+            "error": string;
+            "warning": string;
+            "muted": string;
+            "dim": string;
+            "text": string;
+            "thinkingText": string;
+            "selectedBg": string;
+            "userMessageBg": string;
+            "userMessageText": string;
+            "customMessageBg": string;
+            "customMessageText": string;
+            "customMessageLabel": string;
+            "toolPendingBg": string;
+            "toolSuccessBg": string;
+            "toolErrorBg": string;
+            "toolTitle": string;
+            "toolOutput": string;
+            "mdHeading": string;
+            "mdLink": string;
+            "mdLinkUrl": string;
+            "mdCode": string;
+            "mdCodeBlock": string;
+            "mdCodeBlockBorder": string;
+            "mdQuote": string;
+            "mdQuoteBorder": string;
+            "mdHr": string;
+            "mdListBullet": string;
+            "toolDiffAdded": string;
+            "toolDiffRemoved": string;
+            "toolDiffContext": string;
+            "syntaxComment": string;
+            "syntaxKeyword": string;
+            "syntaxFunction": string;
+            "syntaxVariable": string;
+            "syntaxString": string;
+            "syntaxNumber": string;
+            "syntaxType": string;
+            "syntaxOperator": string;
+            "syntaxPunctuation": string;
+            "thinkingOff": string;
+            "thinkingMinimal": string;
+            "thinkingLow": string;
+            "thinkingMedium": string;
+            "thinkingHigh": string;
+            "thinkingXhigh": string;
+            "bashMode": string;
+            "pythonMode": string;
+            "statusLineBg": string;
+            "statusLineSep": string;
+            "statusLineModel": string;
+            "statusLinePath": string;
+            "statusLineGitClean": string;
+            "statusLineGitDirty": string;
+            "statusLineContext": string;
+            "statusLineSpend": string;
+            "statusLineStaged": string;
+            "statusLineDirty": string;
+            "statusLineUntracked": string;
+            "statusLineOutput": string;
+            "statusLineCost": string;
+            "statusLineSubagents": string;
+        };
+        export: {
+            "pageBg": string;
+            "cardBg": string;
+            "infoBg": string;
+        };
+        symbols: {
+            "preset": string;
+        };
+    };
+    opencode: {
+        $schema: string;
+        name: string;
+        vars: {
+            "background": string;
+            "currentLine": string;
+            "selection": string;
+            "backgroundDarker": string;
+            "foreground": string;
+            "comment": string;
+            "primary": string;
+            "secondary": string;
+            "accentPurple": string;
+            "errorRed": string;
+            "warningOrange": string;
+            "successGreen": string;
+            "infoCyan": string;
+            "emphasizedYellow": string;
+            "border": string;
+            "diffAdded": string;
+            "diffRemoved": string;
+            "diffContext": string;
+            "addedBg": string;
+            "removedBg": string;
+        };
+        colors: {
+            "accent": string;
+            "border": string;
+            "borderAccent": string;
+            "borderMuted": string;
+            "success": string;
+            "error": string;
+            "warning": string;
+            "muted": string;
+            "dim": string;
+            "text": string;
+            "thinkingText": string;
+            "selectedBg": string;
+            "userMessageBg": string;
+            "userMessageText": string;
+            "customMessageBg": string;
+            "customMessageText": string;
+            "customMessageLabel": string;
+            "toolPendingBg": string;
+            "toolSuccessBg": string;
+            "toolErrorBg": string;
+            "toolTitle": string;
+            "toolOutput": string;
+            "mdHeading": string;
+            "mdLink": string;
+            "mdLinkUrl": string;
+            "mdCode": string;
+            "mdCodeBlock": string;
+            "mdCodeBlockBorder": string;
+            "mdQuote": string;
+            "mdQuoteBorder": string;
+            "mdHr": string;
+            "mdListBullet": string;
+            "toolDiffAdded": string;
+            "toolDiffRemoved": string;
+            "toolDiffContext": string;
+            "syntaxComment": string;
+            "syntaxKeyword": string;
+            "syntaxFunction": string;
+            "syntaxVariable": string;
+            "syntaxString": string;
+            "syntaxNumber": string;
+            "syntaxType": string;
+            "syntaxOperator": string;
+            "syntaxPunctuation": string;
+            "thinkingOff": string;
+            "thinkingMinimal": string;
+            "thinkingLow": string;
+            "thinkingMedium": string;
+            "thinkingHigh": string;
+            "thinkingXhigh": string;
+            "bashMode": string;
+            "pythonMode": string;
+            "statusLineBg": string;
+            "statusLineSep": string;
+            "statusLineModel": string;
+            "statusLinePath": string;
+            "statusLineGitClean": string;
+            "statusLineGitDirty": string;
+            "statusLineContext": string;
+            "statusLineSpend": string;
+            "statusLineStaged": string;
+            "statusLineDirty": string;
+            "statusLineUntracked": string;
+            "statusLineOutput": string;
+            "statusLineCost": string;
+            "statusLineSubagents": string;
+        };
+        export: {
+            "pageBg": string;
+            "cardBg": string;
+            "infoBg": string;
+        };
+        symbols: {
+            "preset": string;
+        };
+    };
     "red-claw": {
         $schema: string;
         name: string;

package/dist/types/modes/theme/theme.d.ts

@@ -8,6 +8,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
  */
 export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.folder" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "checkbox.checked" | "checkbox.unchecked" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.editing" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers";
 export type SpinnerType = "status" | "activity";
+export declare const THEME_COLOR_KEYS: readonly ["accent", "border", "borderAccent", "borderMuted", "success", "error", "warning", "muted", "dim", "text", "thinkingText", "selectedBg", "userMessageBg", "userMessageText", "customMessageBg", "customMessageText", "customMessageLabel", "toolPendingBg", "toolSuccessBg", "toolErrorBg", "toolTitle", "toolOutput", "mdHeading", "mdLink", "mdLinkUrl", "mdCode", "mdCodeBlock", "mdCodeBlockBorder", "mdQuote", "mdQuoteBorder", "mdHr", "mdListBullet", "toolDiffAdded", "toolDiffRemoved", "toolDiffContext", "syntaxComment", "syntaxKeyword", "syntaxFunction", "syntaxVariable", "syntaxString", "syntaxNumber", "syntaxType", "syntaxOperator", "syntaxPunctuation", "thinkingOff", "thinkingMinimal", "thinkingLow", "thinkingMedium", "thinkingHigh", "thinkingXhigh", "bashMode", "pythonMode", "statusLineBg", "statusLineSep", "statusLineModel", "statusLinePath", "statusLineGitClean", "statusLineGitDirty", "statusLineContext", "statusLineSpend", "statusLineStaged", "statusLineDirty", "statusLineUntracked", "statusLineOutput", "statusLineCost", "statusLineSubagents"];
 export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
 /** Check if a string is a valid ThemeColor value */
 export declare function isValidThemeColor(color: string): color is ThemeColor;

package/dist/types/modes/types.d.ts

@@ -93,7 +93,7 @@ export interface InteractiveModeContext {
     retryLoader: Loader | undefined;
     autoCompactionEscapeHandler?: () => void;
     retryEscapeHandler?: () => void;
-    retryCountdownTimer?: ReturnType<typeof setInterval>;
+    retryCountdownTimer?: NodeJS.Timeout;
     unsubscribe?: () => void;
     onInputCallback?: (input: SubmittedUserInput) => void;
     optimisticUserMessageSignature: string | undefined;

package/dist/types/runtime/process-lifecycle.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Shared runtime lifecycle foundation.
+ *
+ * Two minimal, deliberately small primitives that subsystem runtimes
+ * (DAP/LSP/MCP stdio, eval workers, etc.) adopt so spawned children and
+ * non-process resources cannot outlive their owner:
+ *
+ *   F1(a) `spawnOwnedProcess` — wraps `ptree.spawn` with explicit
+ *         process-group ownership, escalating (SIGTERM -> grace -> SIGKILL)
+ *         tree termination, bounded `awaitExit`, abort-listener cleanup on
+ *         settle, idempotent `dispose`, and a single postmortem hook that
+ *         reaps every still-live owned process group on fatal/normal shutdown.
+ *
+ *   F1(b) `registerResourceOwner` — a generic, idempotent postmortem adapter
+ *         for non-process resources (Bun Workers, VM contexts, timers,
+ *         sockets) built on the existing `postmortem.register` facility.
+ *
+ * Ownership is keyed to the *process group*, not the root process. A root that
+ * exits after backgrounding descendants (`sh -c "worker & exit 0"`) keeps the
+ * owner registered until the group is actually gone, so the descendant tree is
+ * still reaped by `dispose()`/postmortem.
+ *
+ * This module intentionally owns only these primitives. It does not migrate
+ * existing call sites; subsystem PRs adopt it incrementally.
+ *
+ * Note: `ptree.spawn` always pipes stdout/stderr. Adopters that expect output
+ * (DAP/LSP/MCP protocol servers) must consume `owner.child.stdout`; F1 does not
+ * drain it, so a chatty child whose stdout is never read can still block on a
+ * full pipe. That draining is the adopter's responsibility.
+ */
+import { ptree } from "@gajae-code/utils";
+/** Options for {@link spawnOwnedProcess}. */
+export interface SpawnOwnedOptions {
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    /** stdin mode passed through to the child. Defaults to `"ignore"`. */
+    stdin?: "pipe" | "ignore";
+    /** When aborted, the owned process tree is disposed (escalating kill). */
+    signal?: AbortSignal;
+    /** Grace period (ms) between SIGTERM and SIGKILL on dispose. Default 2000. */
+    gracefulMs?: number;
+    /**
+     * Spawn the child as its own process-group leader so the whole descendant
+     * tree can be signalled on dispose. Defaults to `true` on POSIX. Has no
+     * effect on Windows, where teardown falls back to single-process kill.
+     */
+    processGroup?: boolean;
+    /** Label used in diagnostics. */
+    name?: string;
+}
+/** Result of a bounded {@link OwnedProcess.awaitExit}. */
+export interface AwaitExitResult {
+    /** `true` when the process has exited; `false` when the timeout fired first. */
+    exited: boolean;
+    /** Exit code if known, else `null`. */
+    code: number | null;
+}
+/** A spawned child process owned by the runtime with guaranteed teardown. */
+export interface OwnedProcess {
+    readonly child: ptree.ChildProcess;
+    readonly pid: number | undefined;
+    /** Resolves/rejects when the root child exits (mirrors ptree's `exited`). */
+    readonly exited: Promise<number>;
+    /** `true` once `dispose()` has started. */
+    readonly disposed: boolean;
+    /**
+     * Wait for the root child to exit, optionally bounded by `timeoutMs`. With no
+     * timeout it resolves only when the child exits. Never rejects.
+     */
+    awaitExit(opts?: {
+        timeoutMs?: number;
+    }): Promise<AwaitExitResult>;
+    /**
+     * Idempotently terminate the owned process *group*: SIGTERM the group, wait
+     * `gracefulMs`, then SIGKILL, polling group liveness throughout. Removes the
+     * abort listener and deregisters from the live-owner set only after teardown
+     * has completed. Repeated/concurrent calls return the same in-flight promise.
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Spawn a child process owned by the runtime. The returned {@link OwnedProcess}
+ * is registered for postmortem cleanup and tears down its whole process group
+ * on dispose/abort.
+ */
+export declare function spawnOwnedProcess(cmd: string[], opts?: SpawnOwnedOptions): OwnedProcess;
+/** Number of currently live owned processes. Exposed for leak assertions/tests. */
+export declare function liveOwnedProcessCount(): number;
+/** Dispose every live owned process. For owner-scoped teardown and tests. */
+export declare function disposeAllOwnedProcesses(): Promise<void>;
+type ResourceDisposer = () => void | Promise<void>;
+/**
+ * Register a non-process resource for postmortem/fatal-exit cleanup.
+ *
+ * Idempotent by `name`: re-registering the same name replaces the prior
+ * disposer (last wins). Returns an unregister function that removes the owner
+ * only while it is still the active registration for that name.
+ */
+export declare function registerResourceOwner(name: string, disposer: ResourceDisposer): () => void;
+/** Number of registered resource owners. Exposed for leak assertions/tests. */
+export declare function resourceOwnerCount(): number;
+/**
+ * Run and clear every registered resource disposer. Attempts all disposers even
+ * if some throw, then surfaces the failures as an `AggregateError` so callers
+ * can distinguish "all closed" from "a resource may still be alive".
+ */
+export declare function disposeAllResourceOwners(): Promise<void>;
+export {};

package/dist/types/runtime-mcp/transports/stdio.d.ts

@@ -14,6 +14,7 @@ export declare class StdioTransport implements MCPTransport {
     onRequest?: (method: string, params: unknown) => Promise<unknown>;
     constructor(config: MCPStdioServerConfig);
     get connected(): boolean;
+    get closeBeforeReconnect(): true;
     /**
      * Start the subprocess and begin reading.
      */

package/dist/types/runtime-mcp/types.d.ts

@@ -185,6 +185,8 @@ export interface MCPTransport {
     notify(method: string, params?: Record<string, unknown>): Promise<void>;
     /** Close the transport */
     close(): Promise<void>;
+    /** Whether close must finish before reconnect can safely spawn a replacement. */
+    readonly closeBeforeReconnect?: boolean;
     /** Whether the transport is connected */
     readonly connected: boolean;
     /** Event handlers */

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

@@ -13,7 +13,7 @@
  * Modes use this class and add their own I/O layer on top.
  */
 import { type Agent, type AgentEvent, type AgentMessage, type AgentState, type AgentTool, type StablePrefixSnapshot, ThinkingLevel } from "@gajae-code/agent-core";
-import { type CompactionResult } from "@gajae-code/agent-core/compaction";
+import { type CompactionResult, type EmergencyCompactionSample } from "@gajae-code/agent-core/compaction";
 import type { AssistantMessage, Effort, ImageContent, Message, MessageAttribution, Model, ProviderSessionState, ServiceTier, SimpleStreamOptions, TextContent, ToolChoice, UsageReport } from "@gajae-code/ai";
 export interface ForkContextSeedMetadata {
     sourceSessionId: string;
@@ -726,6 +726,20 @@ export declare class AgentSession {
      * {@link isFastModeActive} instead — that one respects the model's provider.
      */
     isFastModeEnabled(): boolean;
+    /**
+     * True when the configured `serviceTier` resolves to `"priority"` for the
+     * given model `provider`. Returns false for scoped tiers that don't match
+     * (e.g. `"openai-only"` on an anthropic provider) and when `provider` is
+     * undefined. This is the canonical provider-aware fast-mode predicate.
+     */
+    isFastForProvider(provider?: string): boolean;
+    /**
+     * Provider-aware fast-mode predicate for task-tool subagent roles, evaluated
+     * against the effective subagent tier (`task.serviceTier`) rather than the
+     * main session tier. Use this for `task.agentModelOverrides` role rows so the
+     * ⚡ glyph reflects the tier the subagent actually runs under.
+     */
+    isFastForSubagentProvider(provider?: string): boolean;
     /**
      * True when the configured `serviceTier` resolves to `"priority"` for the
      * *currently selected model's provider*. Returns false for scoped tiers
@@ -789,6 +803,8 @@ export declare class AgentSession {
      */
     handoff(customInstructions?: string, options?: SessionHandoffOptions): Promise<HandoffResult | undefined>;
     prepareContributionPrep(options?: ContributionPrepOptions): Promise<ContributionPrepResult>;
+    /** Test seam: override the emergency-compaction resource sampler so tests never read real RSS. */
+    setResourceSampler(sampler: () => EmergencyCompactionSample): void;
     /**
      * Toggle auto-compaction setting.
      */

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

@@ -1,3 +1,6 @@
+export interface ArtifactSaveOptions {
+    maxBytes?: number;
+}
 /**
  * Manages artifact storage for a session.
  *
@@ -40,7 +43,7 @@ export declare class ArtifactManager {
      * @param toolType Tool name for file extension (e.g., "bash", "read")
      * @returns Artifact ID (numeric string)
      */
-    save(content: string, toolType: string): Promise<string>;
+    save(content: string, toolType: string, options?: ArtifactSaveOptions): Promise<string>;
     /**
      * Check if an artifact exists.
      * @param id Artifact ID (numeric string)

package/dist/types/session/history-storage.d.ts

@@ -11,6 +11,6 @@ export declare class HistoryStorage {
     /** @internal Reset the singleton — test-only. */
     static resetInstance(): void;
     add(prompt: string, cwd?: string): Promise<void>;
-    getRecent(limit: number): HistoryEntry[];
-    search(query: string, limit: number): HistoryEntry[];
+    getRecent(limit: number, cwd?: string): HistoryEntry[];
+    search(query: string, limit: number, cwd?: string): HistoryEntry[];
 }

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

@@ -1,7 +1,7 @@
 import type { AgentMessage } from "@gajae-code/agent-core";
 import type { ImageContent, Message, MessageAttribution, ServiceTier, TextContent } from "@gajae-code/ai";
 import { ArtifactManager } from "./artifacts";
-import { type BlobPutResult } from "./blob-store";
+import { type BlobPutResult, BlobStore } from "./blob-store";
 import { type BashExecutionMessage, type CustomMessage, type FileMentionMessage, type HookMessage, type PythonExecutionMessage } from "./messages";
 import type { SessionStorage } from "./session-storage";
 export declare const CURRENT_SESSION_VERSION = 3;
@@ -234,6 +234,15 @@ declare class RecentSessionInfo {
 export declare function recoverOrphanedBackups(sessionDir: string, storage: SessionStorage): Promise<void>;
 /** Exported for testing */
 export declare function findMostRecentSession(sessionDir: string, storage?: SessionStorage): Promise<string | null>;
+declare const RESIDENT_BLOB_SENTINEL_KEY = "__gjcResidentBlob";
+type ResidentBlobKind = "text" | "imageUrl" | "imageData";
+interface ResidentBlobSentinel {
+    [RESIDENT_BLOB_SENTINEL_KEY]: true;
+    kind: ResidentBlobKind;
+    ref: string;
+}
+export declare function residentBlobSentinelForTests(kind: ResidentBlobKind, ref: string): ResidentBlobSentinel;
+export declare function materializeResidentEntriesForPersistenceForTests<T>(entries: T[], textStore: BlobStore, imageStore?: BlobStore): T[];
 /** Get recent sessions for display in welcome screen */
 export declare function getRecentSessions(sessionDir: string, limit?: number, storage?: SessionStorage): Promise<RecentSessionInfo[]>;
 /**