@gajae-code/coding-agent 0.11.0 → 0.11.2

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

@@ -4,13 +4,15 @@ import { type ThemeColor } from "../modes/theme/theme";
 import type { AuthStorage } from "../session/auth-storage";
 import type { ActiveSearchModelContext, WebSearchMode } from "../web/search/types";
 import { type ConfigError, ConfigFile } from "./config-file";
+import { isAuthenticated, kNoAuth } from "./model-auth";
+import { type ProviderDiscoveryState } from "./model-discovery-manager";
+export type { ProviderDiscoveryState, ProviderDiscoveryStatus } from "./model-discovery-manager";
 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 { GJC_MODEL_ASSIGNMENT_TARGET_IDS, type ModelProfileConfig } from "./models-config-schema";
 import { type Settings } from "./settings";
 export type { CanonicalModelIndex, CanonicalModelRecord, CanonicalModelVariant, ModelEquivalenceConfig };
-export declare const kNoAuth = "N/A";
-export declare function isAuthenticated(apiKey: string | undefined | null): apiKey is string;
+export { isAuthenticated, kNoAuth };
 export type ModelRole = "default";
 export interface ModelRoleInfo {
     tag?: string;
@@ -21,12 +23,12 @@ export declare const MODEL_ROLES: Record<ModelRole, ModelRoleInfo>;
 export declare const MODEL_ROLE_IDS: ModelRole[];
 export declare const MODEL_PROFILE_NAME_PATTERN: RegExp;
 export declare const MODEL_PROFILE_NAME_PATTERN_DESCRIPTION = "lowercase letters, numbers, dots, underscores, or hyphens";
-export type GjcModelAssignmentTargetId = "default" | "executor" | "architect" | "planner" | "critic";
+export type GjcModelAssignmentTargetId = (typeof GJC_MODEL_ASSIGNMENT_TARGET_IDS)[number];
 export interface GjcModelAssignmentTargetInfo extends ModelRoleInfo {
     id: GjcModelAssignmentTargetId;
     settingsPath: "modelRoles" | "task.agentModelOverrides";
 }
-export declare const GJC_MODEL_ASSIGNMENT_TARGET_IDS: GjcModelAssignmentTargetId[];
+export { GJC_MODEL_ASSIGNMENT_TARGET_IDS };
 export declare const GJC_MODEL_ASSIGNMENT_TARGETS: Record<GjcModelAssignmentTargetId, GjcModelAssignmentTargetInfo>;
 /** Alias for ModelRoleInfo - used for both built-in and custom roles */
 export type RoleInfo = ModelRoleInfo;
@@ -306,19 +308,11 @@ interface ProviderOverride {
  * regression in `model-registry.test.ts`.
  */
 export declare function mergeDiscoveredModel<TApi extends Api>(model: Model<TApi>, existing: Model<Api> | undefined, providerOverride?: Pick<ProviderOverride, "baseUrl" | "headers" | "transport" | "requestTransform" | "cacheRetention">): Model<TApi>;
-export type ProviderDiscoveryStatus = "idle" | "ok" | "empty" | "cached" | "unavailable" | "unauthenticated";
-export interface ProviderDiscoveryState {
-    provider: string;
-    status: ProviderDiscoveryStatus;
-    optional: boolean;
-    stale: boolean;
-    fetchedAt?: number;
-    models: string[];
-    error?: string;
-}
 export interface CanonicalModelQueryOptions {
     availableOnly?: boolean;
     candidates?: readonly Model<Api>[];
+    /** Stable session identity used to keep a canonical variant sticky within a session. */
+    sessionId?: string;
 }
 /**
  * Model registry - loads and manages models, resolves API keys via AuthStorage.
@@ -356,6 +350,11 @@ export declare class ModelRegistry {
     getCanonicalVariants(canonicalId: string, options?: CanonicalModelQueryOptions): CanonicalModelVariant[];
     resolveCanonicalModel(canonicalId: string, options?: CanonicalModelQueryOptions): Model<Api> | undefined;
     getCanonicalId(model: Model<Api>): string | undefined;
+    /**
+     * Seed a child canonical scope from a concrete parent model without touching
+     * the parent's canonical selection.
+     */
+    seedCanonicalVariant(sessionId: string, model: Model<Api>): boolean;
     /**
      * Get only models that have auth configured.
      * This is a fast check that doesn't refresh OAuth tokens.
@@ -425,6 +424,8 @@ export declare class ModelRegistry {
      * Check if a model selector is currently suppressed due to rate limits.
      */
     isSelectorSuppressed(selector: string): boolean;
+    /** Return whether a selector has an active, expired, or no rate-limit suppression. */
+    getSelectorSuppressionStatus(selector: string): "active" | "expired" | "none";
 }
 /**
  * Input type for registerProvider API (from extensions).

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,6 +651,15 @@ 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;
@@ -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"];
@@ -3171,6 +3199,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 +3928,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 +4070,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;