@gajae-code/coding-agent 0.5.4 → 0.6.1

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 ## [Unreleased]
 
+## [0.6.1] - 2026-06-18
+
+### Fixed
+
+- Fixed the `computer` tool (and any other `z.union`/discriminated-union tool) shipping a bare top-level `anyOf`/`oneOf`/`allOf` `input_schema` root that strict providers (Amazon Bedrock Converse incl. Kiro/CodeWhisperer relays, OpenAI strict mode, Gemini) reject. Tool schema roots are now flattened to a single `type: "object"` across all providers via the shared `flattenToolRootCombinators`. See `@gajae-code/ai` 0.6.1.
+
+## [0.6.0] - 2026-06-18
+### Added
+
+- Exposed the existing goal-pause capability through the `goal` tool as `goal({op:"pause"})`. The runtime `pauseGoal()` method and `paused` status already existed and were reachable via the `/goal pause` slash command and the goal menu, but the agent-facing `goal` tool only enumerated `create | get | complete | resume | drop` — so an agent could not park a goal whose remaining work was blocked on human input. It was forced to either `drop` (clearing the goal) or leave the goal `active`, which re-fired the hidden autonomous-continuation steer every turn with no exit condition. `pause` reuses the existing `paused` status and continuation gate (`buildContinuationPrompt` already returns `undefined` when `enabled=false`), parks the goal without dropping it, persists as `goal_paused`, and is resumable via the existing `resume` op. The active-goal and continuation prompts now instruct the agent to pause when every outstanding deliverable is genuinely human-blocked. `pauseGoal()` now rejects any goal whose status is not `active`, so a completed or dropped goal cannot be driven into a paused-mode lifecycle when paused through the tool.
+
+### Fixed
+
+- Restored steer-by-default while the agent is busy: `busyPromptMode` now defaults to `steer`, so Enter on a normal prompt interrupts the active turn. Queueing for the next turn is reserved for the explicit Ctrl+Enter follow-up keystroke (or `busyPromptMode: "queue"`); existing steer/cancel plus explicit queue/dequeue controls remain separate (#829).
+- Fixed `gjc rlm "<question>"` consuming the seeded question as a one-shot autonomous run that exited immediately; a seeded prompt now lands in the interactive composer so the research session stays interactive.
+
+### Added
+
+- Added an opt-in `gjc rlm` research mode (v1, interactive): a Jupyter-notebook-style research session over the existing agent loop, backed by the shared persistent Python kernel. It loads a distinct research system prompt, restricts the toolset to a hard-gated allowlist (`python` + `read` + `web_search`, asserted after tool-registry assembly — no `bash`/edit/arbitrary mutation), optionally loads a project-root `DATA.md` (overridable via `--data <path>`), aggregates every executed cell live into `.gjc/rlm/<session>/notebook.ipynb` (single-queue atomic temp-rename writes with post-write validation), and synthesizes `.gjc/rlm/<session>/report.md` on session exit. Autonomous goal-arg runs, `--resume`, managed per-workspace venv provisioning, and the optional `>=N` completion gate are deferred follow-ups.
+- Added an experimental opt-in `computer` desktop-control tool surface for local macOS screenshot/input coordination, backed by native `ComputerController`/`computerScreenshot` bindings and gated through settings/tool registration so it can continue stabilizing on `dev` outside the 0.5.4 patch release.
+- Dropped deprecated GitHub Actions Intel macOS (`macos-13` / `darwin-x64`) release-binary coverage after the runner pool repeatedly blocked v0.6.0 publish; Intel macOS users should install through npm/Bun or build from source.
+
 ## [0.5.4] - 2026-06-17
 
 ### Fixed
@@ -10,6 +32,7 @@
 - `AgentSession` now forwards the live provider session state (`providerSessionState`), session affinity id (`providerSessionId ?? sessionId`), and configured WebSocket transport preference (`preferWebsockets`) into local maintenance one-shot calls — manual/automatic compaction summaries, handoff generation, and tree branch summaries — via a shared `#maintenanceProviderTransport()` helper. Previously these Codex/OpenAI-compatible maintenance calls could fall back to HTTP/SSE and lose `session_id` affinity even when `providers.openaiWebsockets: "on"` routed live turns over WebSocket (#736).
 - Fixed `ollama-cloud` first-event timeouts driving an unbounded, usage-spiking retry loop. The ollama-chat backend (exclusively `ollama-cloud`; local Ollama uses the `openai-responses` API) can stall before its first token even for tiny prompts, surfacing `Provider stream timed out while waiting for the first event`. That message matched the generic transient classifier, which retries forever (capped only on delay), so every continuation re-issued the full request to a billable backend and silently spiked usage — disabling retries was the only workaround. First-event timeouts on the ollama-chat API are now a distinct fail-closed class bounded by `retry.maxRetries`: they still retry transient cold starts a few times, then surface instead of looping. First-party providers keep their existing unbounded first-event-timeout retry behavior (#713).
 - Interactive sessions no longer orphan the `browser` tool's headless/spawned Chrome (and the Python eval kernel) to PID 1 when killed by a signal. The interactive entry now registers a bounded, idempotent `postmortem` cleanup (`session-subprocess-teardown`) that runs `AgentSession.disposeChildSubprocesses()` on `SIGINT`/`SIGTERM`/`SIGHUP`, force-releasing the session's browser tabs (`kill:true`) and disposing its Python/JS kernels — the teardown the graceful `/quit` (`dispose()`) path already performs but that an external `kill`/terminal-close used to bypass. Headless `disposeBrowserHandle` now also SIGTERM/SIGKILLs the captured Chrome process tree as a fallback when forced, so a wedged renderer can't survive a bounded CDP `close()`; graceful release behavior is unchanged. The teardown is time-boxed (5s) so a stuck subprocess can't hang process exit (#698).
+- Added first-class xAI search provider support for the `web_search` tool and `gjc q`, including OAuth/API-key auth, web/X/combined search modes, xAI web/X filters, image/video options, citation controls, usage reporting, Settings provider selection, CLI flags, config schema wiring, and edge-case coverage.
 
 ## [0.5.3] - 2026-06-16
 

package/dist/types/cli/web-search-cli.d.ts

@@ -3,6 +3,7 @@
  *
  * Handles `gjc q`/`gjc web-search` subcommands for testing web search providers.
  */
+import { type SearchQueryParams } from "../web/search/index";
 import type { SearchProviderId } from "../web/search/types";
 export interface SearchCommandArgs {
     query: string;
@@ -10,6 +11,17 @@ export interface SearchCommandArgs {
     recency?: "day" | "week" | "month" | "year";
     limit?: number;
     expanded: boolean;
+    xaiSearchMode?: SearchQueryParams["xai_search_mode"];
+    allowedDomains?: string[];
+    excludedDomains?: string[];
+    allowedXHandles?: string[];
+    excludedXHandles?: string[];
+    fromDate?: string;
+    toDate?: string;
+    enableImageUnderstanding?: boolean;
+    enableImageSearch?: boolean;
+    enableVideoUnderstanding?: boolean;
+    noInlineCitations?: boolean;
 }
 /**
  * Parse web search subcommand arguments.

package/dist/types/commands/rlm.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `gjc rlm` — opt-in Jupyter-style research session with a persistent Python kernel.
+ */
+import { Command } from "@gajae-code/utils/cli";
+export default class Rlm extends Command {
+    static description: string;
+    static strict: boolean;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/types/commands/web-search.d.ts

@@ -25,6 +25,60 @@ export default class Search extends Command {
             char: string;
             description: string;
         };
+        "xai-mode": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            options: string[];
+        };
+        "allowed-domain": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            multiple: true;
+        };
+        "allowed-domains": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            multiple: true;
+        };
+        "excluded-domain": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            multiple: true;
+        };
+        "excluded-domains": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            multiple: true;
+        };
+        "allowed-x-handle": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            multiple: true;
+        };
+        "allowed-x-handles": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            multiple: true;
+        };
+        "excluded-x-handle": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            multiple: true;
+        };
+        "excluded-x-handles": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            multiple: true;
+        };
+        "from-date": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "to-date": import("@gajae-code/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "image-understanding": import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "image-search": import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "video-understanding": import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "no-inline-citations": import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
         compact: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
             description: string;
         };

package/dist/types/config/keybindings.d.ts

@@ -15,8 +15,10 @@ interface AppKeybindings {
     "app.model.select": true;
     "app.model.selectTemporary": true;
     "app.tools.expand": true;
+    "app.tool.backgroundFold": true;
     "app.editor.external": true;
     "app.message.followUp": true;
+    "app.message.queue": true;
     "app.message.dequeue": true;
     "app.clipboard.pasteImage": true;
     "app.clipboard.copyLine": true;
@@ -215,6 +217,10 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+o";
         readonly description: "Expand tools";
     };
+    readonly "app.tool.backgroundFold": {
+        readonly defaultKeys: "ctrl+b";
+        readonly description: "Fold/background supported foreground tool";
+    };
     readonly "app.editor.external": {
         readonly defaultKeys: "ctrl+g";
         readonly description: "Open external editor";
@@ -223,6 +229,10 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+enter";
         readonly description: "Send follow-up message";
     };
+    readonly "app.message.queue": {
+        readonly defaultKeys: "alt+enter";
+        readonly description: "Queue message for next turn";
+    };
     readonly "app.message.dequeue": {
         readonly defaultKeys: "alt+up";
         readonly description: "Dequeue message";

package/dist/types/config/model-profiles.d.ts

@@ -4,6 +4,7 @@ export type ModelProfileRole = GjcModelAssignmentTargetId;
 export interface ModelProfileDefinition {
     name: string;
     requiredProviders: string[];
+    displayName?: string;
     /**
      * Optional groups of providers that are interchangeable fallbacks.
      * Each group is an array of provider ids where at least one must be
@@ -28,7 +29,7 @@ export interface ModelProfilePresentation {
     displayName: string;
     providerGroup: string;
 }
-export declare function getModelProfilePresentation(name: string): ModelProfilePresentation;
+export declare function getModelProfilePresentation(profile: string | Pick<ModelProfileDefinition, "name" | "displayName">): ModelProfilePresentation;
 export declare function groupModelProfilesForPresetLanding(profiles: ReadonlyMap<string, ModelProfileDefinition>): Map<string, ModelProfileDefinition[]>;
 export declare function recommendModelProfileForProvider(providerId: string, profiles: ReadonlyMap<string, ModelProfileDefinition>): ModelProfileDefinition | undefined;
 export declare function mergeModelProfiles(userProfiles?: ModelsConfig["profiles"]): Map<string, ModelProfileDefinition>;

package/dist/types/config/model-registry.d.ts

@@ -6,6 +6,7 @@ import type { ActiveSearchModelContext, WebSearchMode } from "../web/search/type
 import { type ConfigError, ConfigFile } from "./config-file";
 import { type CanonicalModelIndex, type CanonicalModelRecord, type CanonicalModelVariant, type ModelEquivalenceConfig } from "./model-equivalence";
 import { type ModelProfileDefinition } from "./model-profiles";
+import { type ModelProfileConfig } from "./models-config-schema";
 import { type Settings } from "./settings";
 export type { CanonicalModelIndex, CanonicalModelRecord, CanonicalModelVariant, ModelEquivalenceConfig };
 export declare const kNoAuth = "N/A";
@@ -263,6 +264,7 @@ export declare const ModelsConfigFile: ConfigFile<{
     } | undefined;
     profiles?: Record<string, {
         required_providers: string[];
+        display_name?: string | undefined;
         model_mapping: Partial<Record<"architect" | "critic" | "default" | "executor" | "planner", string>>;
     }> | undefined;
 }>;
@@ -331,6 +333,7 @@ export declare class ModelRegistry {
     getModelProfiles(): Map<string, ModelProfileDefinition>;
     getModelProfile(name: string): ModelProfileDefinition | undefined;
     getAvailableModelProfileNames(): string[];
+    saveCustomModelProfile(name: string, definition: ModelProfileConfig): Promise<ModelProfileDefinition>;
     applyConfiguredModelBindings(targetSettings: Settings): void;
     /**
      * Get all models (built-in + custom).

package/dist/types/config/models-config-schema.d.ts

@@ -78,6 +78,7 @@ export declare const ProfileModelMappingSchema: z.ZodRecord<z.ZodEnum<{
 }> & z.core.$partial, z.ZodString>;
 export declare const ProfileDefinitionSchema: z.ZodObject<{
     required_providers: z.ZodArray<z.ZodString>;
+    display_name: z.ZodOptional<z.ZodString>;
     model_mapping: z.ZodRecord<z.ZodEnum<{
         architect: "architect";
         critic: "critic";
@@ -88,6 +89,7 @@ export declare const ProfileDefinitionSchema: z.ZodObject<{
 }, z.core.$strict>;
 export declare const ProfilesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
     required_providers: z.ZodArray<z.ZodString>;
+    display_name: z.ZodOptional<z.ZodString>;
     model_mapping: z.ZodRecord<z.ZodEnum<{
         architect: "architect";
         critic: "critic";
@@ -673,6 +675,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
     profiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         required_providers: z.ZodArray<z.ZodString>;
+        display_name: z.ZodOptional<z.ZodString>;
         model_mapping: z.ZodRecord<z.ZodEnum<{
             architect: "architect";
             critic: "critic";

package/dist/types/config/settings-schema.d.ts

@@ -1126,7 +1126,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly ui: {
             readonly tab: "interaction";
             readonly label: "Busy Prompt Mode";
-            readonly description: "What a submitted prompt does while the agent is busy: steer (interrupt the active turn) or queue (run after the active turn completes)";
+            readonly description: "What a submitted prompt does while the agent is busy: queue normal chat for the next turn, or steer to interrupt the active turn";
         };
     };
     readonly doubleEscapeAction: {
@@ -2465,7 +2465,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "array";
         readonly default: string[];
         readonly items: {
-            readonly enum: readonly ["duckduckgo", "exa", "brave", "jina", "kimi", "zai", "anthropic", "perplexity", "gemini", "codex", "tavily", "parallel", "kagi", "synthetic", "searxng"];
+            readonly enum: readonly ["duckduckgo", "exa", "brave", "jina", "kimi", "zai", "anthropic", "perplexity", "gemini", "codex", "xai", "tavily", "parallel", "kagi", "synthetic", "searxng"];
         };
         readonly ui: {
             readonly tab: "tools";
@@ -2500,6 +2500,60 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Directory to save screenshots. If unset, screenshots go to a temp file. Supports ~. Examples: ~/Downloads, ~/Desktop, /sdcard/Download (Android)";
         };
     };
+    readonly "computer.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Computer";
+            readonly description: "Enable the macOS computer tool for this session. Off by default.";
+        };
+    };
+    readonly "computer.alwaysOn": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Computer Always On";
+            readonly description: "Keep the macOS computer tool callable without per-session enablement.";
+        };
+    };
+    readonly "computer.autoScreenshot": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Computer Auto Screenshot";
+            readonly description: "Automatically request bounded screenshots after computer actions when supported.";
+        };
+    };
+    readonly "computer.screenshotMaxBytes": {
+        readonly type: "number";
+        readonly default: 5000000;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Computer Screenshot Max Bytes";
+            readonly description: "Maximum screenshot payload size for computer action results.";
+        };
+    };
+    readonly "computer.killSwitchHotkey": {
+        readonly type: "string";
+        readonly default: "Control+Option+Command+Escape";
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Computer Kill Switch Hotkey";
+            readonly description: "Native stop/suspend hotkey shown to users for computer-use sessions.";
+        };
+    };
+    readonly "computer.auditLog.enabled": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Computer Audit Log";
+            readonly description: "Persist audit records for enabled computer-use actions.";
+        };
+    };
     readonly "tools.intentTracing": {
         readonly type: "boolean";
         readonly default: true;
@@ -3014,7 +3068,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "providers.webSearch": {
         readonly type: "enum";
-        readonly values: readonly ["auto", "duckduckgo", "exa", "brave", "jina", "kimi", "zai", "perplexity", "anthropic", "gemini", "codex", "tavily", "kagi", "synthetic", "parallel", "searxng"];
+        readonly values: readonly ["auto", "duckduckgo", "exa", "brave", "jina", "kimi", "zai", "perplexity", "anthropic", "gemini", "codex", "xai", "tavily", "kagi", "synthetic", "parallel", "searxng"];
         readonly default: "auto";
         readonly ui: {
             readonly tab: "providers";
@@ -3056,6 +3110,10 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "codex";
                 readonly label: "OpenAI";
                 readonly description: "OpenAI's native web_search (uses ChatGPT OAuth via /login openai-codex)";
+            }, {
+                readonly value: "xai";
+                readonly label: "xAI";
+                readonly description: "xAI Responses web_search/x_search (uses xAI OAuth via /login xai or XAI_API_KEY)";
             }, {
                 readonly value: "gemini";
                 readonly label: "Gemini";

package/dist/types/edit/notebook.d.ts

@@ -16,6 +16,9 @@ export interface NotebookDocument {
 }
 export declare function isNotebookPath(filePath: string): boolean;
 export declare function splitNotebookSource(content: string): string[];
+export declare function createNotebookCell(cellType: NotebookCellType, source: string): NotebookCell;
+export declare function createEmptyNotebook(): NotebookDocument;
+export declare function serializeNotebookDocument(notebook: NotebookDocument): string;
 export declare function readNotebookDocument(absolutePath: string, displayPath: string): Promise<NotebookDocument>;
 export declare function notebookToEditableText(notebook: NotebookDocument): string;
 export declare function applyNotebookEditableText(notebook: NotebookDocument, text: string, displayPath: string): NotebookDocument;

package/dist/types/eval/py/executor.d.ts

@@ -2,6 +2,7 @@ import type { ToolSession } from "../../tools";
 import type { JsStatusEvent } from "../js/shared/types";
 import type { KernelDisplayOutput } from "./display";
 import { type KernelExecuteOptions, type KernelExecuteResult } from "./kernel";
+import type { PythonRuntimeOptions } from "./runtime";
 export type PythonKernelMode = "session" | "per-call";
 export interface PythonExecutorOptions {
     /** Working directory for command execution */
@@ -31,6 +32,8 @@ export interface PythonExecutorOptions {
      * preferred over `PI_SESSION_FILE`-derived paths.
      */
     artifactsDir?: string;
+    /** Runtime resolution/provisioning options (RLM managed workspace venv, package seeding). */
+    runtimeOptions?: PythonRuntimeOptions;
     /** Artifact path/id for full output storage */
     artifactPath?: string;
     artifactId?: string;

package/dist/types/eval/py/kernel.d.ts

@@ -1,4 +1,5 @@
 import { type KernelDisplayOutput } from "./display";
+import { type PythonRuntimeOptions } from "./runtime";
 export type { KernelDisplayOutput, PythonStatusEvent } from "./display";
 export { renderKernelDisplay } from "./display";
 export interface KernelExecuteOptions {
@@ -38,6 +39,7 @@ interface KernelLifecycleOptions {
 interface KernelStartOptions extends KernelLifecycleOptions {
     cwd: string;
     env?: Record<string, string | undefined>;
+    runtimeOptions?: PythonRuntimeOptions;
 }
 interface KernelShutdownOptions {
     signal?: AbortSignal;
@@ -48,7 +50,7 @@ export interface PythonKernelAvailability {
     pythonPath?: string;
     reason?: string;
 }
-export declare function checkPythonKernelAvailability(cwd: string): Promise<PythonKernelAvailability>;
+export declare function checkPythonKernelAvailability(cwd: string, runtimeOptions?: PythonRuntimeOptions): Promise<PythonKernelAvailability>;
 export declare class PythonKernel {
     #private;
     readonly id: string;

package/dist/types/eval/py/runtime.d.ts

@@ -1,3 +1,10 @@
+export declare const RLM_MANAGED_PYTHON_PACKAGES: readonly string[];
+export interface PythonRuntimeOptions {
+    /** Create/use <cwd>/.gjc/python-env when no BYO venv/conda env is present. */
+    managedWorkspaceVenv?: boolean;
+    /** Packages to seed into the managed workspace venv when provisioning it. */
+    seedPackages?: readonly string[];
+}
 export interface PythonRuntime {
     /** Path to python executable */
     pythonPath: string;
@@ -18,4 +25,5 @@ export declare function resolveVenvPath(cwd: string): string | undefined;
 /**
  * Resolve Python runtime including executable path, environment, and venv detection.
  */
-export declare function resolvePythonRuntime(cwd: string, baseEnv: Record<string, string | undefined>): PythonRuntime;
+export declare function resolvePythonRuntime(cwd: string, baseEnv: Record<string, string | undefined>, options?: PythonRuntimeOptions): PythonRuntime;
+export declare function ensurePythonRuntime(cwd: string, baseEnv: Record<string, string | undefined>, options?: PythonRuntimeOptions): Promise<PythonRuntime>;

package/dist/types/exec/bash-executor.d.ts

@@ -21,6 +21,10 @@ export interface BashExecutorOptions {
     artifactId?: string;
     /** Execute without retaining a native Shell in the persistent session registry. */
     oneShot?: boolean;
+    /** Ignore user-configured shell command prefixes. Used by constrained read-only shells. */
+    ignoreShellPrefix?: boolean;
+    /** Skip sourced shell snapshots. Used by constrained read-only shells. */
+    disableShellSnapshot?: boolean;
     /**
      * Invoked when the native minimizer rewrote the command's output, giving
      * the caller a chance to persist the lossless original capture (typically

package/dist/types/extensibility/custom-tools/types.d.ts

@@ -163,6 +163,8 @@ export interface CustomTool<TParams extends TSchema = TSchema, TDetails = any> {
     label: string;
     /** If true, tool is strictly typed and validated against the parameters schema before execution */
     strict?: boolean;
+    /** Tool scheduling mode; exclusive tools do not run in parallel with other tools in a model turn. */
+    concurrency?: "shared" | "exclusive";
     /** Description for LLM */
     description: string;
     /** Parameter schema (Zod or TypeBox; TypeBox is auto-lifted to Zod at registration). */

package/dist/types/extensibility/custom-tools/wrapper.d.ts

@@ -13,6 +13,7 @@ export declare class CustomToolAdapter<TParams extends TSchema = TSchema, TDetai
     description: string;
     parameters: TParams;
     readonly strict: boolean | undefined;
+    readonly concurrency: "shared" | "exclusive" | undefined;
     constructor(tool: CustomTool<TParams, TDetails>, getContext: () => CustomToolContext);
     execute(toolCallId: string, params: Static<TParams>, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback<TDetails, TParams>, context?: CustomToolContext): Promise<import("@gajae-code/agent-core").AgentToolResult<TDetails, TParams>>;
     /**

package/dist/types/extensibility/extensions/types.d.ts

@@ -270,6 +270,8 @@ export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = un
     description: string;
     /** Parameter schema (Zod, or TypeBox for legacy/extension compat). */
     parameters: TParams;
+    /** Tool scheduling mode; exclusive tools do not run in parallel with other tools in a model turn. */
+    concurrency?: "shared" | "exclusive";
     /** If true, tool is excluded unless explicitly listed in --tools or agent's tools field */
     hidden?: boolean;
     /** If true, tool is registered but not auto-included in the initial active set.

package/dist/types/extensibility/extensions/wrapper.d.ts

@@ -16,6 +16,7 @@ export declare class RegisteredToolAdapter implements AgentTool<any, any, any> {
     parameters: any;
     label: string;
     strict: boolean;
+    concurrency: "shared" | "exclusive" | undefined;
     renderCall?: (args: any, options: any, theme: any) => any;
     renderResult?: (result: any, options: any, theme: any, args?: any) => any;
     constructor(registeredTool: RegisteredTool, runner: ExtensionRunner);

package/dist/types/gjc-runtime/launch-tmux.d.ts

@@ -3,6 +3,7 @@ import { buildGjcTmuxProfileCommands, GJC_DEFAULT_TMUX_SESSION, GJC_TMUX_COMMAND
 export { buildGjcTmuxProfileCommands, GJC_DEFAULT_TMUX_SESSION, GJC_TMUX_COMMAND_ENV, GJC_TMUX_MOUSE_ENV, GJC_TMUX_PROFILE_ENV, GJC_TMUX_SESSION_PREFIX, };
 export declare const GJC_TMUX_LAUNCHED_ENV = "GJC_TMUX_LAUNCHED";
 export declare const GJC_LAUNCH_POLICY_ENV = "GJC_LAUNCH_POLICY";
+export declare const GJC_TMUX_WINDOW_LABEL_MAX_WIDTH = 48;
 interface TtyState {
     stdin: boolean;
     stdout: boolean;
@@ -46,6 +47,8 @@ export interface TmuxLaunchPlan {
     branch?: string | null;
     attachSessionName?: string;
     project?: string | null;
+    sessionId?: string | null;
+    sessionStateFile?: string | null;
 }
 export interface GjcTmuxProfileResult {
     skipped: boolean;
@@ -64,7 +67,10 @@ export interface GjcTmuxProfileContext {
     branch?: string | null;
     branchSlug?: string | null;
     project?: string | null;
+    sessionId?: string | null;
+    sessionStateFile?: string | null;
 }
 export declare function applyGjcTmuxProfile(context: GjcTmuxProfileContext): GjcTmuxProfileResult;
+export declare function buildGjcTmuxWindowTitle(cwd: string, branch: string | null | undefined): string;
 export declare function buildDefaultTmuxLaunchPlan(context: TmuxLaunchContext): TmuxLaunchPlan | undefined;
 export declare function launchDefaultTmuxIfNeeded(context: TmuxLaunchContext): boolean;

package/dist/types/gjc-runtime/session-state-sidecar.d.ts

@@ -1,5 +1,6 @@
 export declare const GJC_COORDINATOR_SESSION_STATE_FILE_ENV = "GJC_COORDINATOR_SESSION_STATE_FILE";
 export declare const GJC_COORDINATOR_SESSION_ID_ENV = "GJC_COORDINATOR_SESSION_ID";
+export type RuntimeState = "ready_for_input" | "running" | "needs_user_input" | "completed" | "errored";
 interface RuntimeStateEvent {
     type: string;
     messages?: unknown[];
@@ -9,5 +10,18 @@ interface RuntimeStateContext {
     cwd: string;
     sessionFile?: string | null;
 }
+export type TerminalRuntimeStateStatus = {
+    terminal: true;
+    state: "completed" | "errored";
+} | {
+    terminal: false;
+    reason: "missing_state_file" | "invalid_json" | "session_id_mismatch" | "cwd_mismatch" | "session_file_mismatch" | "non_terminal_state";
+};
+export declare function readTerminalRuntimeStateMarker(input: {
+    stateFile?: string | null;
+    sessionId?: string | null;
+    cwd?: string | null;
+    sessionFile?: string | null;
+}): Promise<TerminalRuntimeStateStatus>;
 export declare function persistCoordinatorRuntimeStateFromEvent(event: RuntimeStateEvent, context: RuntimeStateContext): Promise<void>;
 export {};

package/dist/types/gjc-runtime/tmux-common.d.ts

@@ -8,6 +8,8 @@ export declare const GJC_TMUX_PROFILE_VALUE = "1";
 export declare const GJC_TMUX_BRANCH_OPTION = "@gjc-branch";
 export declare const GJC_TMUX_BRANCH_SLUG_OPTION = "@gjc-branch-slug";
 export declare const GJC_TMUX_PROJECT_OPTION = "@gjc-project";
+export declare const GJC_TMUX_SESSION_ID_OPTION = "@gjc-session-id";
+export declare const GJC_TMUX_SESSION_STATE_FILE_OPTION = "@gjc-session-state-file";
 export interface GjcTmuxProfileCommand {
     description: string;
     args: string[];
@@ -46,10 +48,14 @@ export declare function buildGjcTmuxRequiredProfileCommands(target: string, meta
     branch?: string | null;
     branchSlug?: string | null;
     project?: string | null;
+    sessionId?: string | null;
+    sessionStateFile?: string | null;
 }): GjcTmuxProfileCommand[];
 export declare function buildGjcTmuxProfileCommands(target: string, env?: NodeJS.ProcessEnv, metadata?: {
     branch?: string | null;
     branchSlug?: string | null;
     project?: string | null;
+    sessionId?: string | null;
+    sessionStateFile?: string | null;
 }): GjcTmuxProfileCommand[];
 export declare function normalizeTmuxCreatedAt(raw: string): string;

package/dist/types/gjc-runtime/tmux-gc.d.ts

@@ -1,7 +1,7 @@
 /**
- * GC adapter for gjc-tagged tmux sessions. Stale iff `@gjc-project` path is gone
- * OR `@gjc-branch` has no live git worktree. Removal is a spec-authorized
- * destructive `kill-session`, gated by exact-target re-read + revalidation.
+ * GC adapter for gjc-tagged tmux sessions. Destructive cleanup is authorized
+ * only for detached pane-less sessions whose exact runtime marker revalidates a
+ * terminal state. Project/branch/orphan heuristics are discovery signals only.
  */
 import type { GcStoreAdapter } from "./gc-runtime";
 export declare const tmuxSessionsGcAdapter: GcStoreAdapter;

package/dist/types/gjc-runtime/tmux-sessions.d.ts

@@ -8,6 +8,8 @@ export interface GjcTmuxSessionStatus {
     branch?: string;
     branchSlug?: string;
     project?: string;
+    sessionId?: string;
+    sessionStateFile?: string;
     panePids: number[];
     profile?: string;
 }
@@ -16,6 +18,8 @@ export interface GjcTmuxSessionTagsForGc {
     project?: string;
     branch?: string;
     branchSlug?: string;
+    sessionId?: string;
+    sessionStateFile?: string;
     createdAt?: string;
     attached?: boolean;
     panePids?: number[];

package/dist/types/gjc-runtime/ultragoal-runtime.d.ts

@@ -121,6 +121,23 @@ export declare function startNextUltragoalGoal(input: {
     allComplete: boolean;
 }>;
 type SurfaceFamily = "web" | "cli" | "native" | "api-package" | "algorithm-math" | "unknown";
+type UltragoalChangeStatus = "added" | "modified" | "deleted" | "renamed" | "copied" | "unknown";
+type UltragoalChangeCategory = "code" | "generated-binding" | "tool" | "settings-registry" | "prompt-doc-behavior" | "docs-static" | "other";
+interface UltragoalChangeSetPath extends JsonObject {
+    path: string;
+    status: UltragoalChangeStatus;
+    oldPath?: string;
+    category?: UltragoalChangeCategory;
+}
+interface UltragoalChangeSet extends JsonObject {
+    source: "checkpoint-git" | "review-pr" | "review-branch" | "review-worktree" | "review-spec";
+    baseRef?: string;
+    headRef?: string;
+    mergeBase?: string;
+    paths: UltragoalChangeSetPath[];
+    rawDiffStat?: string;
+    trusted: true;
+}
 export declare function normalizeSurfaceToken(value: string): string;
 export declare function surfaceFamily(value: string): SurfaceFamily;
 export interface ReplayProcessHandle {
@@ -130,6 +147,7 @@ export interface ReplayProcessHandle {
 export declare function waitForReplayProcessWithTimeout(process: ReplayProcessHandle, timeoutMs: number, graceMs?: number): Promise<number>;
 export declare function validateExecutorQaRedTeamEvidenceForReview(cwd: string, executorQa: Record<string, unknown>, options?: {
     mode?: "review";
+    changeSet?: UltragoalChangeSet;
 }): Promise<void>;
 export declare function checkpointUltragoalGoal(input: {
     cwd: string;

package/dist/types/goals/state.d.ts

@@ -16,7 +16,7 @@ export interface GoalModeState {
     goal: Goal;
 }
 export interface GoalToolDetails {
-    op: "create" | "get" | "complete" | "resume" | "drop";
+    op: "create" | "get" | "complete" | "resume" | "drop" | "pause";
     goal?: Goal | null;
 }
 export type GoalRuntimeEvent = {

package/dist/types/goals/tools/goal-tool.d.ts

@@ -11,6 +11,7 @@ declare const goalSchema: z.ZodObject<{
         create: "create";
         drop: "drop";
         get: "get";
+        pause: "pause";
         resume: "resume";
     }>;
     objective: z.ZodOptional<z.ZodString>;
@@ -32,6 +33,7 @@ export declare class GoalTool implements AgentTool<typeof goalSchema, GoalToolDe
             create: "create";
             drop: "drop";
             get: "get";
+            pause: "pause";
             resume: "resume";
         }>;
         objective: z.ZodOptional<z.ZodString>;