@gajae-code/coding-agent 0.11.1 → 0.11.3

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

@@ -22,6 +22,8 @@ export interface ScopedModelSelection {
 export interface ScopedModel extends ScopedModelSelection {
     explicitThinkingLevel: boolean;
 }
+export type { SelectorThinkingSuffix } from "../thinking";
+export { splitSelectorThinkingSuffix } from "../thinking";
 /**
  * Parse a model string in "provider/modelId" format.
  * Returns undefined if the format is invalid.
@@ -43,11 +45,11 @@ export interface ModelMatchPreferences {
     /** Providers to deprioritize when no recent usage is available. */
     deprioritizeProviders?: string[];
 }
-export type CanonicalModelRegistry = Partial<Pick<ModelRegistry, "resolveCanonicalModel" | "getCanonicalVariants" | "getCanonicalId">>;
+export type CanonicalModelRegistry = Partial<Pick<ModelRegistry, "resolveCanonicalModel" | "getCanonicalVariants" | "getCanonicalId" | "seedCanonicalVariant">>;
 export type ModelLookupRegistry = Pick<ModelRegistry, "getAvailable"> & Partial<CanonicalModelRegistry>;
 type CliModelRegistry = Pick<ModelRegistry, "getAll"> & Partial<CanonicalModelRegistry>;
-type InitialModelRegistry = Pick<ModelRegistry, "getAvailable" | "find">;
-type RestorableModelRegistry = Pick<ModelRegistry, "getAvailable" | "find" | "getApiKey">;
+type InitialModelRegistry = Pick<ModelRegistry, "getAvailable">;
+type RestorableModelRegistry = Pick<ModelRegistry, "getAvailable" | "getApiKey">;
 /**
  * Find an exact explicit provider/model match.
  * Bare model ids are handled separately so canonical ids can coalesce variants.
@@ -60,9 +62,23 @@ export interface ParsedModelResult {
     warning: string | undefined;
     explicitThinkingLevel: boolean;
 }
+export interface ResolveSelectorOptions {
+    allowInvalidThinkingSelectorFallback?: boolean;
+    modelRegistry?: CanonicalModelRegistry;
+    preferences?: ModelMatchPreferences;
+    sessionId?: string;
+}
+/**
+ * Resolve one selector through ordered exact, canonical, bare-id, provider-fuzzy,
+ * substring/alias, and glob stages. Thinking is split only after a full selector
+ * cannot resolve, which preserves OpenRouter route suffixes in concrete IDs.
+ */
+export declare function resolveSelector(selector: string, candidates: Model<Api>[], options?: ResolveSelectorOptions): ParsedModelResult;
+/** @internal Exported for testing and legacy adapters. */
 export declare function parseModelPattern(pattern: string, availableModels: Model<Api>[], preferences?: ModelMatchPreferences, options?: {
     allowInvalidThinkingSelectorFallback?: boolean;
     modelRegistry?: CanonicalModelRegistry;
+    sessionId?: string;
 }): ParsedModelResult;
 /**
  * Expand a role alias like "pi/default" to the configured model string.
@@ -90,6 +106,7 @@ export declare function resolveModelRoleValue(roleValue: ModelSelectorValue | un
     settings?: Settings;
     matchPreferences?: ModelMatchPreferences;
     modelRegistry?: CanonicalModelRegistry;
+    sessionId?: string;
 }): ResolvedModelRoleValue;
 export declare function extractExplicitThinkingSelector(value: ModelSelectorValue | undefined, settings?: Settings): ThinkingLevel | undefined;
 /**
@@ -109,7 +126,7 @@ export declare function resolveModelFromSettings(options: {
 /**
  * Resolve a list of override patterns to the first matching model.
  */
-export declare function resolveModelOverride(modelPatterns: string[], modelRegistry: ModelLookupRegistry, settings?: Settings): {
+export declare function resolveModelOverride(modelPatterns: string[], modelRegistry: ModelLookupRegistry, settings?: Settings, sessionId?: string): {
     model?: Model<Api>;
     thinkingLevel?: ThinkingLevel;
     explicitThinkingLevel: boolean;
@@ -155,7 +172,7 @@ export declare function resolveModelChainWithAuth(modelPatterns: readonly string
  * primary resolution unchanged so the existing error path still surfaces
  * a meaningful failure downstream.
  */
-export declare function resolveModelOverrideWithAuthFallback(modelPatterns: string[], parentActiveModelPattern: string | undefined, modelRegistry: ModelLookupRegistry & Pick<ModelRegistry, "getApiKey">, settings?: Settings, sessionId?: string, options?: ModelChainResolutionOptions): Promise<{
+export declare function resolveModelOverrideWithAuthFallback(modelPatterns: string[], parentActiveModelPattern: string | undefined, modelRegistry: ModelLookupRegistry & Pick<ModelRegistry, "getApiKey">, settings?: Settings, authSessionId?: string, options?: ModelChainResolutionOptions, canonicalSessionId?: string): Promise<{
     model?: Model<Api>;
     thinkingLevel?: ThinkingLevel;
     explicitThinkingLevel: boolean;
@@ -177,15 +194,11 @@ export declare function resolveRoleSelection(roles: readonly string[], settings:
     thinkingLevel?: ThinkingLevel;
 } | undefined;
 /**
- * Resolve model patterns to actual Model objects with optional thinking levels
- * Format: "pattern:level" where :level is optional
- * For each pattern, finds all matching models and picks the best version:
- * 1. Prefer alias (e.g., Anthropic model-sonnet-4-5) over dated versions (Anthropic model-sonnet-4-5-20250929)
- * 2. If no alias, pick the latest dated version
- *
- * Supports models with colons in their IDs (e.g., OpenRouter's model:exacto).
- * The algorithm tries to match the full pattern first, then progressively
- * strips colon-suffixes to find a match.
+ * Resolve model patterns to actual Model objects with optional thinking levels.
+ * A `:level` suffix is interpreted only after the complete selector fails to
+ * resolve, preserving concrete model IDs that contain colon-bearing route suffixes.
+ * For each non-glob pattern, alias IDs are preferred over dated versions; otherwise
+ * the latest dated version is selected.
  */
 export declare function resolveModelScope(patterns: string[], modelRegistry: Pick<ModelRegistry, "getAvailable" | "getCanonicalVariants">, preferences?: ModelMatchPreferences): Promise<ScopedModel[]>;
 /**
@@ -208,9 +221,7 @@ export interface ResolveCliModelResult {
     warning: string | undefined;
     error: string | undefined;
 }
-/**
- * Resolve a single model from CLI flags.
- */
+/** Resolve a single model from CLI flags through the staged selector resolver. */
 export declare function resolveCliModel(options: {
     cliProvider?: string;
     cliModel?: string;
@@ -247,4 +258,3 @@ export declare function restoreModelFromSession(savedProvider: string, savedMode
     model: Model<Api> | undefined;
     fallbackMessage: string | undefined;
 }>;
-export {};

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

@@ -62,6 +62,16 @@ export declare const OpenAICompatSchema: z.ZodObject<{
         none: "none";
     }>>;
 }, z.core.$strip>;
+export declare const GJC_MODEL_EFFORT_IDS: readonly ["minimal", "low", "medium", "high", "xhigh", "max"];
+export declare const GJC_MODEL_ASSIGNMENT_TARGET_IDS: readonly ["default", "executor", "architect", "planner", "critic"];
+export declare const EffortSchema: z.ZodEnum<{
+    high: "high";
+    low: "low";
+    max: "max";
+    medium: "medium";
+    minimal: "minimal";
+    xhigh: "xhigh";
+}>;
 export declare const ModelBindingsSchema: z.ZodObject<{
     modelRoles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
     agentModelOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
@@ -73,6 +83,7 @@ export declare const ProfileRoleSchema: z.ZodEnum<{
     executor: "executor";
     planner: "planner";
 }>;
+export declare const ProfileModelSelectorPattern: string;
 export declare const ProfileModelSelectorSchema: z.ZodString;
 export declare const ProfileModelMappingSchema: z.ZodRecord<z.ZodEnum<{
     architect: "architect";

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

@@ -128,6 +128,11 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "string";
         readonly default: undefined;
     };
+    readonly "session.directoryMigration": {
+        readonly type: "enum";
+        readonly values: readonly ["copy-retain", "disabled"];
+        readonly default: "copy-retain";
+    };
     readonly "notifications.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -135,6 +140,7 @@ export declare const SETTINGS_SCHEMA: {
     readonly "notifications.telegram.botToken": {
         readonly type: "string";
         readonly default: undefined;
+        readonly validate: (value: unknown) => value is string;
     };
     readonly "notifications.telegram.chatId": {
         readonly type: "string";
@@ -144,6 +150,10 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "record";
         readonly default: Record<string, unknown>;
     };
+    readonly "notifications.telegram.btw.enabled": {
+        readonly type: "boolean";
+        readonly default: true;
+    };
     readonly "notifications.telegram.rich.enabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -641,17 +651,26 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "tools.preAdmissionArtifactSpill": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Pre-admission artifact spill";
+            readonly description: "Experimental opt-in: save oversized tool results before provider context construction, retaining a UTF-8-safe head, tail, digest, and artifact receipt inline";
+        };
+    };
     readonly "tools.readArtifactSpillThreshold": {
         readonly type: "number";
-        readonly default: 0;
+        readonly default: 256;
         readonly ui: {
             readonly tab: "tools";
-            readonly label: "Experimental read-tool artifact spill threshold (KB)";
-            readonly description: "Advanced opt-in only: combined-size cap for `read` output across all requested ranges. Above this the full output is saved as an artifact and a bounded head+tail snippet is kept inline. Live layofflabs/gpt-5.5 medium evidence on 2026-07-07 found no token savings and a lower cache-hit rate at 50 KB, so normal coding sessions should leave this Off unless intentionally measuring large-read behavior.";
+            readonly label: "Read artifact spill threshold (KB)";
+            readonly description: "Explicit large reads above this combined size are saved as an artifact with a bounded head-and-tail snippet inline. Bare reads, directories, and converted-document receipts remain inline.";
             readonly options: readonly [{
                 readonly value: "0";
                 readonly label: "Off";
-                readonly description: "Default; no read-specific spill (backstop only)";
+                readonly description: "No read-specific spill (backstop only)";
             }, {
                 readonly value: "50";
                 readonly label: "50 KB";
@@ -663,7 +682,7 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "256";
                 readonly label: "256 KB";
-                readonly description: "~64K tokens";
+                readonly description: "Default; ~64K tokens";
             }, {
                 readonly value: "512";
                 readonly label: "512 KB";
@@ -677,11 +696,11 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "tools.fileMentionInlineBytes": {
         readonly type: "number";
-        readonly default: 20;
+        readonly default: 10;
         readonly ui: {
             readonly tab: "tools";
             readonly label: "File-mention inline cap (KB)";
-            readonly description: "Inline byte cap for auto-read `@path` file mentions, deliberately below the read-tool cap so an incidental mention injects a smaller snippet than an explicit read. The full file is still available via the read tool.";
+            readonly description: "Inline byte cap for auto-read `@path` file mentions, aligned with the 10 KiB bare-read receipt so incidental mentions stay within the same bounded context budget. The full file is still available via the read tool.";
             readonly options: readonly [{
                 readonly value: "5";
                 readonly label: "5 KB";
@@ -689,15 +708,15 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "10";
                 readonly label: "10 KB";
-                readonly description: "~2.5K tokens";
+                readonly description: "Default; ~2.5K tokens";
             }, {
                 readonly value: "20";
                 readonly label: "20 KB";
-                readonly description: "Default; ~5K tokens";
+                readonly description: "~5K tokens";
             }, {
                 readonly value: "50";
                 readonly label: "50 KB";
-                readonly description: "~12.5K tokens (matches read cap)";
+                readonly description: "~12.5K tokens (matches bare-read receipt)";
             }];
         };
     };
@@ -1369,7 +1388,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly ui: {
             readonly tab: "model";
             readonly label: "Max Retry Delay";
-            readonly description: "Maximum wait between retries, in ms. When the provider asks us to wait longer than this and no credential or model fallback succeeds, the request fails fast instead of sleeping (e.g. 3-hour Anthropic rate-limit windows).";
+            readonly description: "Maximum wait between retries, in ms. Legacy retries clamp provider Retry-After hints to this value; managed fallback honors typed Retry-After hints even when they exceed it.";
         };
     };
     readonly "retry.requestMaxRetries": {
@@ -1413,6 +1432,15 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "mouse.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly label: "Mouse Support";
+            readonly description: "Enable SGR mouse wheel scrolling and overlay row selection. Disabled in tmux and screen.";
+        };
+    };
     readonly steeringMode: {
         readonly type: "enum";
         readonly values: readonly ["all", "one-at-a-time"];
@@ -2409,6 +2437,81 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "read.receiptBudgetLines": {
+        readonly type: "number";
+        readonly default: 50;
+        readonly ui: {
+            readonly tab: "editing";
+            readonly label: "Read Receipt Line Budget";
+            readonly description: "Maximum lines included in a bare read receipt before a selector footer is shown";
+            readonly options: readonly [{
+                readonly value: "25";
+                readonly label: "25 lines";
+            }, {
+                readonly value: "50";
+                readonly label: "50 lines";
+                readonly description: "Default";
+            }, {
+                readonly value: "100";
+                readonly label: "100 lines";
+            }, {
+                readonly value: "200";
+                readonly label: "200 lines";
+            }];
+        };
+    };
+    readonly "read.receiptBudgetBytes": {
+        readonly type: "number";
+        readonly default: 10;
+        readonly ui: {
+            readonly tab: "editing";
+            readonly label: "Read Receipt Byte Budget (KB)";
+            readonly description: "Maximum UTF-8 body size for a bare read receipt before a selector footer is shown";
+            readonly options: readonly [{
+                readonly value: "5";
+                readonly label: "5 KB";
+                readonly description: "~1.25K tokens";
+            }, {
+                readonly value: "10";
+                readonly label: "10 KB";
+                readonly description: "Default; ~2.5K tokens";
+            }, {
+                readonly value: "20";
+                readonly label: "20 KB";
+                readonly description: "~5K tokens";
+            }, {
+                readonly value: "50";
+                readonly label: "50 KB";
+                readonly description: "~12.5K tokens";
+            }];
+        };
+    };
+    readonly "read.summaryMaxBytes": {
+        readonly type: "number";
+        readonly default: 20;
+        readonly ui: {
+            readonly tab: "editing";
+            readonly label: "Read Summary Size Budget (KB)";
+            readonly description: "Maximum UTF-8 size for a structural read summary before additional units are elided";
+            readonly options: readonly [{
+                readonly value: "10";
+                readonly label: "10 KB";
+                readonly description: "~2.5K tokens";
+            }, {
+                readonly value: "20";
+                readonly label: "20 KB";
+                readonly description: "Default; ~5K tokens";
+            }, {
+                readonly value: "50";
+                readonly label: "50 KB";
+                readonly description: "~12.5K tokens";
+            }, {
+                readonly value: "100";
+                readonly label: "100 KB";
+                readonly description: "~25K tokens";
+            }];
+        };
+    };
     readonly "read.summarize.enabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -3171,6 +3274,15 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: 500;
     };
+    readonly "tasksPane.defaultVisible": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "tasks";
+            readonly label: "Tasks Pane Visible By Default";
+            readonly description: "Open the unified tasks pane when the interactive UI starts";
+        };
+    };
     readonly "plan.enabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -3891,6 +4003,21 @@ export declare function getPathsForTab(tab: SettingTab): SettingPath[];
 export declare function getType(path: SettingPath): SettingDef["type"];
 /** Get enum values for an enum setting */
 export declare function getEnumValues(path: SettingPath): readonly string[] | undefined;
+export declare const CONFIG_SCHEMA_VERSION = 1;
+export type SettingsSchemaIssue = {
+    path: string;
+    kind: "unknown" | "invalid" | "coerced" | "pending-migration";
+    detail: string;
+};
+export type SettingsSchemaReport = {
+    issues: SettingsSchemaIssue[];
+    valid: boolean;
+};
+/** Coerce supported scalar legacy values and report unknown or invalid settings without dropping them. */
+export declare function reconcileSettingsSchema(raw: Record<string, unknown>): {
+    settings: Record<string, unknown>;
+    report: SettingsSchemaReport;
+};
 /** Status line preset - derived from schema */
 export type StatusLinePreset = SettingValue<"statusLine.preset">;
 /** Status line separator style - derived from schema */
@@ -4018,6 +4145,9 @@ export interface NotificationsSettings {
     telegram: {
         botToken: string | undefined;
         chatId: string | undefined;
+        btw: {
+            enabled: boolean;
+        };
         rich: {
             enabled: boolean;
         };

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

@@ -1,11 +1,11 @@
 import { procmgr } from "@gajae-code/utils";
 import type { ModelRole } from "../config/model-registry";
-import type { NotificationSettingsReader, NotificationSettingsSnapshot } from "../sdk/bus/config";
+import { type NotificationSettingsReader, type NotificationSettingsSnapshot } from "../sdk/bus/config";
 import { AgentStorage } from "../session/agent-storage";
 import { type EditMode } from "../utils/edit-mode";
 import { type CasReceipt } from "./atomic-yaml-patch";
 import { type ModelSelectorValue } from "./model-selector-value";
-import { type BashInterceptorRule, type GroupPrefix, type GroupTypeMap, type SettingPath, type SettingValue } from "./settings-schema";
+import { type BashInterceptorRule, type GroupPrefix, type GroupTypeMap, type SettingPath, type SettingsSchemaReport, type SettingValue } from "./settings-schema";
 export type * from "./settings-schema";
 export * from "./settings-schema";
 /** Raw settings object as stored in YAML */
@@ -21,13 +21,6 @@ export type SettingsAtomicPatch = {
     op: "unset";
 };
 export type SettingsAtomicReceipt = CasReceipt;
-export interface GlobalDefaultModelRoleCommit {
-    readonly previousDefault: ModelSelectorValue | undefined;
-    readonly previousModelRolesExisted: boolean;
-    readonly committedDefault: ModelSelectorValue | undefined;
-    readonly committedConfigVersion?: string;
-    readonly defaultRevision: number;
-}
 export interface SettingsOptions {
     /** Current working directory for project settings discovery */
     cwd?: string;
@@ -56,6 +49,14 @@ export declare class Settings implements NotificationSettingsReader {
      * Call once at startup before accessing `settings`.
      */
     static init(options?: SettingsOptions): Promise<Settings>;
+    /**
+     * Load settings for an explicit workspace without changing the global singleton.
+     * Managed-session policy resolution must be bound to the workspace being opened.
+     */
+    static loadForScope(options: {
+        cwd: string;
+        agentDir?: string;
+    }): Promise<Settings>;
     /**
      * Create an isolated instance for testing with explicit user/global settings.
      * Does not affect the global singleton.
@@ -86,6 +87,8 @@ export declare class Settings implements NotificationSettingsReader {
     getNotificationSettingsSnapshot(): NotificationSettingsSnapshot;
     /** Check whether a setting is present in loaded settings/overrides rather than coming from schema defaults. */
     has(path: SettingPath): boolean;
+    /** Diagnostics from schema reconciliation during the most recent load. */
+    getSchemaReport(): SettingsSchemaReport;
     /**
      * Set a setting value (sync).
      * Updates global settings and reserves its background persistence slot before
@@ -143,8 +146,8 @@ export declare class Settings implements NotificationSettingsReader {
      */
     setModelRole(role: ModelRole | string, modelId: ModelSelectorValue): void;
     setGlobalModelRole(role: ModelRole | string, modelId: ModelSelectorValue | undefined): void;
-    setGlobalModelRoleAndFlush(role: ModelRole | string, modelId: ModelSelectorValue | undefined): Promise<GlobalDefaultModelRoleCommit>;
-    restoreGlobalDefaultModelRoleIfCurrent(commit: GlobalDefaultModelRoleCommit): Promise<boolean>;
+    setGlobalModelRoleAndFlush(role: ModelRole | string, modelId: ModelSelectorValue | undefined): Promise<CasReceipt>;
+    restoreGlobalDefaultModelRoleIfCurrent(commit: CasReceipt): Promise<boolean>;
     /**
      * Set an agent model override while keeping any live runtime override aligned.
      *

package/dist/types/coordinator-mcp/policy.d.ts

@@ -1,8 +1,11 @@
+import * as fs from "node:fs/promises";
 export type CoordinatorMutationClass = "sessions" | "questions" | "reports";
 export interface CoordinatorNamespace {
     profile: string | null;
     repo: string | null;
+    identity: string;
 }
+export declare function coordinatorNamespaceIdentity(env?: NodeJS.ProcessEnv): string;
 export interface CoordinatorMcpConfig {
     allowedRoots: string[];
     mutationClasses: Set<CoordinatorMutationClass>;
@@ -25,3 +28,5 @@ export declare function assertCoordinatorArtifactPath(config: CoordinatorMcpConf
 }>;
 export declare function requireCoordinatorMutation(config: CoordinatorMcpConfig, mutationClass: CoordinatorMutationClass, request: CoordinatorMutationRequest): void;
 export declare function coordinatorNamespacePath(config: CoordinatorMcpConfig): string;
+/** Opens and authorizes an artifact by the opened handle identity, not a racy pathname. */
+export declare function safeOpenCoordinatorArtifact(config: CoordinatorMcpConfig, artifactPath: unknown): Promise<fs.FileHandle>;

package/dist/types/coordinator-mcp/question-gate-codec.d.ts

@@ -0,0 +1,129 @@
+import type { WorkflowGate } from "../modes/shared/agent-wire/workflow-gate-types";
+export type PublicReason = "unsupported_gate" | "query_unavailable" | "pagination_malformed" | "row_unrepresentable" | "missing_runtime_turn" | "invalid_runtime_turn" | "invalid_gate_row" | "wrong_session" | "ownership_unavailable" | "ownership_conflict" | "gate_provenance_changed" | "turn_terminal" | "endpoint_changed" | "terminal_race" | "terminal_uncertain" | "session_closing" | "session_unavailable" | "reported_failure" | "validation_rejected";
+export type CoordinatorQuestionStatusV1 = "pending" | "answered" | "stale" | "uncertain";
+export interface CoordinatorQuestionOptionPublicV1 {
+    id: string;
+    label: string;
+    recommended: boolean;
+}
+export interface CoordinatorQuestionPublicV1 extends Record<string, unknown> {
+    schema_version: 1;
+    question_id: string;
+    session_id: string;
+    turn_id: string;
+    status: CoordinatorQuestionStatusV1;
+    stage: string;
+    kind: string;
+    prompt: string;
+    multi: boolean;
+    allow_empty: boolean;
+    options: CoordinatorQuestionOptionPublicV1[];
+    other_allowed: boolean;
+    clarification_allowed: boolean;
+    created_at: string;
+    updated_at: string;
+    answered_at: string | null;
+    reason: PublicReason | null;
+    answer_binding?: string;
+}
+export interface CoordinatorQuestionDiagnosticPublicV1 {
+    schema_version: 1;
+    session_id: string;
+    turn_id: string | null;
+    gate_id: string | null;
+    reason: PublicReason;
+    observed_at: string;
+}
+export interface CoordinatorQuestionReconciliationPublicV1 {
+    attempted: boolean;
+    complete: boolean;
+    revision: string | null;
+    observed_at: string;
+    reason: PublicReason | null;
+}
+export interface ListQuestionsSuccessV1 extends Record<string, unknown> {
+    ok: true;
+    schema_version: 1;
+    questions: CoordinatorQuestionPublicV1[];
+    diagnostics: CoordinatorQuestionDiagnosticPublicV1[];
+    reconciliation: CoordinatorQuestionReconciliationPublicV1;
+}
+export type CoordinatorAskAnswerV1 = {
+    selected: string[];
+    other?: false;
+} | {
+    selected: string[];
+    other: true;
+    custom: string;
+} | {
+    action: "clarify";
+    question: string;
+};
+export interface SubmitQuestionAnswerInputV1 {
+    session_id: string;
+    turn_id: string;
+    question_id: string;
+    answer_binding: string;
+    answer: CoordinatorAskAnswerV1;
+    idempotency_key: string;
+    allow_mutation: true;
+}
+export type SubmitQuestionAnswerSuccessV1 = {
+    ok: true;
+    schema_version: 1;
+    session_id: string;
+    turn_id: string;
+    question_id: string;
+    operation: "workflow.gate_answer";
+    status: "accepted";
+    replayed: boolean;
+    resolved_at: string;
+};
+export type SubmitQuestionAnswerValidationRejectedV1 = {
+    ok: false;
+    schema_version: 1;
+    session_id: string;
+    turn_id: string;
+    question_id: string;
+    error: {
+        code: "validation_rejected";
+        message: string;
+    };
+    question_status: "pending";
+};
+export type SubmitQuestionAnswerFailureV1 = {
+    ok: false;
+    error: {
+        code: "not_found" | "resource_gone" | "ownership_mismatch" | "terminal_uncertain" | "idempotency_conflict";
+        message: string;
+    };
+};
+export interface PrivateAskGateCodecV1 {
+    schema_version: 1;
+    labels: string[];
+    recommended_index: number | null;
+    multi: boolean;
+    allow_empty: boolean;
+    other_allowed: true;
+    clarification_allowed: true;
+}
+export declare function decodeAskGateV1(gate: WorkflowGate): PrivateAskGateCodecV1 | null;
+export declare function projectAskGateQuestion(input: {
+    question_id: string;
+    session_id: string;
+    turn_id: string;
+    status: CoordinatorQuestionStatusV1;
+    stage: string;
+    kind: string;
+    prompt: string;
+    codec: PrivateAskGateCodecV1;
+    created_at: string;
+    updated_at: string;
+    answered_at: string | null;
+    reason: PublicReason | null;
+    answer_binding?: string;
+}): CoordinatorQuestionPublicV1;
+export declare function validateCoordinatorAskAnswer(codec: PrivateAskGateCodecV1, answer: unknown): CoordinatorAskAnswerV1 | null;
+export declare function translateCoordinatorAskAnswer(codec: PrivateAskGateCodecV1, answer: CoordinatorAskAnswerV1): unknown;
+export declare function createAnswerBinding(): string;
+export declare function answerBindingMatches(binding: string, expected: string): boolean;