@kodax-ai/kodax 0.7.77 → 0.7.79

package/dist/types-chunks/{commands.d-BccESAMV.d.ts → repl.d-CZ12Ow3X.d.ts}

@@ -1,8 +1,8 @@
-import { X as SessionStorage$1, R as PermissionMode, L as LearningBinding } from './public-api.d--fF88JrC.js';
-import { a1 as KodaXOptions, ac as KodaXResult } from './bash-prefix-extractor.d-pZdu6qt7.js';
-import { n as ResolvedAutoModeSettings, p as RuntimeSurfaceStatus, b as CommandDefinition, e as CommandSource, c as CommandInfo, C as Command$1, I as InteractiveContext, a as CommandCallbacks, g as CurrentConfig, d as CommandInvocationRequest, f as CommandWorkflowInvocationRequest } from './utils.d-CDduqbFw.js';
-import { bV as KodaXSessionStorage, bH as KodaXSessionData } from './types.d-RdWRfUEs.js';
-import { r as AutoModeStats } from './guardrail.d-B0PwAZVR.js';
+import { n as ResolvedAutoModeSettings, b as CommandDefinition, e as CommandSource, c as CommandInfo, C as Command$1, I as InteractiveContext, a as CommandCallbacks, g as CurrentConfig, d as CommandInvocationRequest, f as CommandWorkflowInvocationRequest, p as RuntimeSurfaceStatus } from './utils.d-CGpHavsU.js';
+import { af as SessionStorage$1, T as PermissionMode, L as LearningBinding } from './public-api.d-BpJhHoa7.js';
+import { a1 as KodaXOptions, ad as KodaXResult } from './bash-prefix-extractor.d-CNSidpmv.js';
+import { ca as KodaXSessionStorage, bY as KodaXSessionData } from './controller.d-RGV7Pjv9.js';
+import { s as AutoModeStats } from './guardrail.d-1NLSFTyN.js';
 
 interface ReplRuntimePermissionGrantSuggestion {
     readonly id: string;
@@ -49,77 +49,6 @@ interface ReplRuntimeAutoModeSettings {
 }
 declare function toReplRuntimeAutoModeSettings(settings: ResolvedAutoModeSettings): ReplRuntimeAutoModeSettings;
 
-/**
- * InkREPL - Ink-based REPL Adapter
- *
- * Bridges Ink UI components with existing KodaX command processing logic.
- * Replaces the Node.js readline-based input with Ink's React components.
- *
- * Architecture based on Gemini CLI:
- * - Uses UIStateContext for global state
- * - Uses KeypressContext for priority-based keyboard handling
- * - Uses StreamingContext for streaming response management
- */
-
-interface InkRuntimeRunnerInput {
-    readonly options: KodaXOptions;
-    readonly prompt: string;
-    readonly sessionId: string;
-    readonly permissionMode: PermissionMode;
-    readonly autoModeSettings?: ReplRuntimeAutoModeSettings;
-    readonly requestPermission?: ReplRuntimePermissionPrompt;
-    /** Marks the callback installed by the REPL's legacy permission UI. */
-    readonly legacyPermissionHook?: true;
-}
-type InkRuntimeRunner = (input: InkRuntimeRunnerInput) => Promise<KodaXResult>;
-type InkRuntimeStatusProvider = () => Promise<RuntimeSurfaceStatus | undefined>;
-interface InkREPLOptions extends KodaXOptions {
-    storage?: SessionStorage$1;
-    hardExitOnClose?: boolean;
-    runtimeRunner?: InkRuntimeRunner;
-    runtimeAutoModeControl?: ReplRuntimeAutoModeControl;
-    getRuntimeStatus?: InkRuntimeStatusProvider;
-    learning?: LearningBinding;
-}
-/**
- * Run Ink-based interactive mode
- */
-declare function runInkInteractiveMode(options: InkREPLOptions): Promise<void>;
-
-interface SessionStorage extends KodaXSessionStorage {
-    list(gitRoot?: string, options?: {
-        limit?: number;
-        includeArchived?: boolean;
-    }): Promise<Array<{
-        id: string;
-        title: string;
-        msgCount: number;
-        tag?: string;
-        runtimeInfo?: KodaXSessionData['runtimeInfo'];
-    }>>;
-}
-interface ReplRuntimeRunnerInput {
-    readonly options: KodaXOptions;
-    readonly prompt: string;
-    readonly sessionId: string;
-    readonly permissionMode: PermissionMode;
-    readonly autoModeSettings?: ReplRuntimeAutoModeSettings;
-    readonly requestPermission?: ReplRuntimePermissionPrompt;
-    /** Marks the callback installed by the REPL's legacy permission UI. */
-    readonly legacyPermissionHook?: true;
-}
-type ReplRuntimeRunner = (input: ReplRuntimeRunnerInput) => Promise<KodaXResult>;
-type ReplRuntimeStatusProvider = () => Promise<RuntimeSurfaceStatus | undefined>;
-interface RepLOptions extends KodaXOptions {
-    storage?: SessionStorage;
-    runtimeRunner?: ReplRuntimeRunner;
-    runtimeAutoModeControl?: ReplRuntimeAutoModeControl;
-    getRuntimeStatus?: ReplRuntimeStatusProvider;
-    learning?: LearningBinding;
-}
-declare function runInteractiveMode(options: RepLOptions): Promise<void>;
-declare function processSpecialSyntax(input: string, executionCwd?: string): Promise<string>;
-
 /**
  * Command Registry - Dynamic command registration system
  * 命令注册表 - 动态命令注册系统
@@ -270,5 +199,87 @@ declare function executeCommand(parsed: {
     };
 }, context: InteractiveContext, callbacks: CommandCallbacks, currentConfig: CurrentConfig): Promise<CommandResult>;
 
-export { BUILTIN_COMMANDS as B, RUNTIME_PERMISSION_PENDING_NOTICE as R, executeCommand as n, getCommandRegistry as o, parseCommand as p, processSpecialSyntax as q, runInkInteractiveMode as r, runInteractiveMode as s, toReplRuntimeAutoModeSettings as t };
-export type { Command as C, InkREPLOptions as I, InkRuntimeRunner as a, InkRuntimeRunnerInput as b, InkRuntimeStatusProvider as c, RepLOptions as d, ReplRuntimeAutoModeControl as e, ReplRuntimeAutoModeSettings as f, ReplRuntimePermissionDecision as g, ReplRuntimePermissionGrantSuggestion as h, ReplRuntimePermissionPrompt as i, ReplRuntimePermissionRequest as j, ReplRuntimeRunner as k, ReplRuntimeRunnerInput as l, ReplRuntimeStatusProvider as m };
+/**
+ * InkREPL - Ink-based REPL Adapter
+ *
+ * Bridges Ink UI components with existing KodaX command processing logic.
+ * Replaces the Node.js readline-based input with Ink's React components.
+ *
+ * Architecture based on Gemini CLI:
+ * - Uses UIStateContext for global state
+ * - Uses KeypressContext for priority-based keyboard handling
+ * - Uses StreamingContext for streaming response management
+ */
+
+interface InkRuntimeRunnerInput {
+    readonly options: KodaXOptions;
+    readonly prompt: string;
+    readonly sessionId: string;
+    readonly permissionMode: PermissionMode;
+    readonly autoModeSettings?: ReplRuntimeAutoModeSettings;
+    readonly requestPermission?: ReplRuntimePermissionPrompt;
+    /** Marks the callback installed by the REPL's legacy permission UI. */
+    readonly legacyPermissionHook?: true;
+}
+type InkRuntimeRunner = (input: InkRuntimeRunnerInput) => Promise<KodaXResult>;
+type InkRuntimeStatusProvider = () => Promise<RuntimeSurfaceStatus | undefined>;
+interface InkTransientNotice {
+    readonly text: string;
+    readonly tone: "success" | "warning";
+}
+interface InkREPLOptions extends KodaXOptions {
+    storage?: SessionStorage$1;
+    hardExitOnClose?: boolean;
+    runtimeRunner?: InkRuntimeRunner;
+    runtimeAutoModeControl?: ReplRuntimeAutoModeControl;
+    getRuntimeStatus?: InkRuntimeStatusProvider;
+    validateSetupA2AConfig?: (value: unknown) => unknown;
+    prepareSetupSandbox?: CommandCallbacks['prepareSetupSandbox'];
+    inspectSandbox?: CommandCallbacks['inspectSandbox'];
+    learning?: LearningBinding;
+    subscribeTransientNotices?: (listener: (notice: InkTransientNotice) => void) => () => void;
+}
+/**
+ * Run Ink-based interactive mode
+ */
+declare function runInkInteractiveMode(options: InkREPLOptions): Promise<void>;
+
+interface SessionStorage extends KodaXSessionStorage {
+    list(gitRoot?: string, options?: {
+        limit?: number;
+        includeArchived?: boolean;
+    }): Promise<Array<{
+        id: string;
+        title: string;
+        msgCount: number;
+        tag?: string;
+        runtimeInfo?: KodaXSessionData['runtimeInfo'];
+    }>>;
+}
+interface ReplRuntimeRunnerInput {
+    readonly options: KodaXOptions;
+    readonly prompt: string;
+    readonly sessionId: string;
+    readonly permissionMode: PermissionMode;
+    readonly autoModeSettings?: ReplRuntimeAutoModeSettings;
+    readonly requestPermission?: ReplRuntimePermissionPrompt;
+    /** Marks the callback installed by the REPL's legacy permission UI. */
+    readonly legacyPermissionHook?: true;
+}
+type ReplRuntimeRunner = (input: ReplRuntimeRunnerInput) => Promise<KodaXResult>;
+type ReplRuntimeStatusProvider = () => Promise<RuntimeSurfaceStatus | undefined>;
+interface RepLOptions extends KodaXOptions {
+    storage?: SessionStorage;
+    runtimeRunner?: ReplRuntimeRunner;
+    runtimeAutoModeControl?: ReplRuntimeAutoModeControl;
+    getRuntimeStatus?: ReplRuntimeStatusProvider;
+    validateSetupA2AConfig?: (value: unknown) => unknown;
+    prepareSetupSandbox?: CommandCallbacks['prepareSetupSandbox'];
+    inspectSandbox?: CommandCallbacks['inspectSandbox'];
+    learning?: LearningBinding;
+}
+declare function runInteractiveMode(options: RepLOptions): Promise<void>;
+declare function processSpecialSyntax(input: string, executionCwd?: string): Promise<string>;
+
+export { BUILTIN_COMMANDS as B, RUNTIME_PERMISSION_PENDING_NOTICE as R, executeCommand as o, getCommandRegistry as p, parseCommand as q, processSpecialSyntax as r, runInkInteractiveMode as s, runInteractiveMode as t, toReplRuntimeAutoModeSettings as u };
+export type { Command as C, InkREPLOptions as I, InkRuntimeRunner as a, InkRuntimeRunnerInput as b, InkRuntimeStatusProvider as c, InkTransientNotice as d, RepLOptions as e, ReplRuntimeAutoModeControl as f, ReplRuntimeAutoModeSettings as g, ReplRuntimePermissionDecision as h, ReplRuntimePermissionGrantSuggestion as i, ReplRuntimePermissionPrompt as j, ReplRuntimePermissionRequest as k, ReplRuntimeRunner as l, ReplRuntimeRunnerInput as m, ReplRuntimeStatusProvider as n };

package/dist/types-chunks/{side-query.d-5JvXhuOZ.d.ts → resolver.d-C9IW4fmU.d.ts}

@@ -1,8 +1,7 @@
-import { F as KodaXReasoningMode, M as KodaXStableEffortIntent, a9 as KodaXWireReasoningEffort, G as KodaXReasoningProfile, Z as KodaXThinkingBudgetMap, _ as KodaXThinkingDepth, q as KodaXProviderConfig, B as KodaXReasoningCapability, H as KodaXReasoningRequest, n as KodaXNormalizedReasoningRequest, V as KodaXTaskType, a7 as KodaXVerifyCredentialResult, a1 as KodaXToolDefinition, k as KodaXMessage, y as KodaXProviderStreamOptions, N as KodaXStreamResult, l as KodaXModelDescriptor, p as KodaXProviderCapabilityProfile, a8 as KodaXVerifyStrategy, d as KodaXCustomProviderConfig, j as KodaXListModelsResult, a0 as KodaXTokenUsage } from './types.d-DIpZJKUl.js';
+import { G as KodaXReasoningMode, N as KodaXStableEffortIntent, aa as KodaXWireReasoningEffort, H as KodaXReasoningProfile, _ as KodaXThinkingBudgetMap, $ as KodaXThinkingDepth, r as KodaXProviderConfig, C as KodaXReasoningCapability, I as KodaXReasoningRequest, n as KodaXNormalizedReasoningRequest, W as KodaXTaskType, a8 as KodaXVerifyCredentialResult, a2 as KodaXToolDefinition, k as KodaXMessage, z as KodaXProviderStreamOptions, O as KodaXStreamResult, l as KodaXModelDescriptor, q as KodaXProviderCapabilityProfile, o as KodaXOpenAICompatMaxOutputTokensField, a9 as KodaXVerifyStrategy, d as KodaXCustomProviderConfig, j as KodaXListModelsResult } from './types.d-CgrXrFrq.js';
 import Anthropic from '@anthropic-ai/sdk';
-import { K as KodaXBaseProvider } from './base.d-4e74xDdy.js';
+import { K as KodaXBaseProvider } from './base.d-DxG0m09Z.js';
 import OpenAI from 'openai';
-import { a as CostTracker } from './cost-tracker.d-BeaenODW.js';
 
 /**
  * KodaX AI Errors
@@ -283,6 +282,7 @@ declare abstract class KodaXOpenAICompatProvider extends KodaXBaseProvider {
     protected get client(): OpenAI;
     protected set client(client: OpenAI);
     protected buildClient(): OpenAI;
+    private getEffectiveMaxOutputTokensField;
     protected onStaleConnection(): void;
     /**
      * FEATURE_216 v0.7.45 — Lightweight credential verification.
@@ -390,6 +390,8 @@ type ProviderSnapshot = {
     readonly contextWindow?: number;
     /** Per-turn output token cap KodaX requests. Provider-level default. */
     readonly maxOutputTokens?: number;
+    /** OpenAI Chat Completions field used for the output-token cap. */
+    readonly maxOutputTokensField?: KodaXOpenAICompatMaxOutputTokensField;
     /** Upper bound on `thinking_budget` for native-budget reasoning providers. */
     readonly thinkingBudgetCap?: number;
     /** Whether the provider supports `thinking_budget` / native reasoning. */
@@ -661,67 +663,5 @@ declare function listProviderModels(name: string, _opts?: {
     signal?: AbortSignal;
 }): Promise<KodaXListModelsResult>;
 
-/**
- * sideQuery — independent one-shot LLM invocation.
- *
- * Used by features that need a clean LLM call outside the main agent loop.
- * The auto mode classifier (FEATURE_092) is the first consumer; future
- * users include compaction, title generation, and SA mutation reflection.
- *
- * Constraints (deliberate):
- *   - tools=[] hardcoded — sideQuery is single-turn, no tool loop
- *   - text-only output — tool_use blocks from the model produce stopReason='error'
- *   - independent timeout (default 30s; callers may supply a bounded deadline)
- *   - independent cost bucket via querySource (mapped to TokenUsageRecord.role)
- *
- * Failure handling: never throws. Timeout, abort, provider error, and
- * unexpected tool_use all produce a result with stopReason='timeout' /
- * 'aborted' / 'error' so callers implement their own degradation.
- */
-
-type SideQueryStopReason = 'end_turn' | 'max_tokens' | 'timeout' | 'aborted' | 'error';
-interface SideQueryRequest {
-    readonly provider: KodaXBaseProvider;
-    readonly model: string;
-    readonly system: string;
-    readonly messages: readonly KodaXMessage[];
-    readonly reasoning?: KodaXReasoningRequest;
-    /** Optional per-request cap for small structured sidecar responses. */
-    readonly maxOutputTokens?: number;
-    readonly timeoutMs?: number;
-    readonly abortSignal?: AbortSignal;
-    readonly querySource: string;
-    readonly costTracker?: CostTracker;
-}
-interface SideQueryResult {
-    readonly text: string;
-    readonly usage: KodaXTokenUsage;
-    readonly costTracker?: CostTracker;
-    readonly stopReason: SideQueryStopReason;
-    /**
-     * Bounded request metadata only; prompts and response text are never copied.
-     * The built-in `sideQuery()` always supplies it. Optionality preserves source
-     * compatibility for existing SDK mocks and structural result adapters.
-     */
-    readonly diagnostics?: SideQueryDiagnostics;
-    readonly error?: Error;
-}
-type SideQueryTerminalPhase = 'completed' | 'pre_output' | 'streaming' | 'contract_error';
-interface SideQueryDiagnostics {
-    readonly provider: string;
-    readonly model: string;
-    readonly timeoutMs: number;
-    readonly elapsedMs: number;
-    readonly retryCount: number;
-    readonly retryWaitMs: number;
-    /** Time until the first non-empty text delta, when the adapter exposes it. */
-    readonly firstOutputMs?: number;
-    /** Time from the first observed text delta until termination. */
-    readonly streamMs?: number;
-    /** Honest coarse phase; provider adapters cannot split DNS/connect/remote queue. */
-    readonly terminalPhase: SideQueryTerminalPhase;
-}
-declare function sideQuery(req: SideQueryRequest): Promise<SideQueryResult>;
-
-export { isRuntimeModelProviderName as $, getCustomProviderList as A, getCustomProviderModelDescriptors as B, getCustomProviderModels as C, getCustomProviderNames as D, getDefaultThinkingDepthForMode as E, getModelCapabilities as F, getProvider as G, getProviderConfiguredCapabilityProfile as H, getProviderConfiguredReasoningCapability as I, getProviderCredentialEnvironmentNames as J, KODAX_DEFAULT_PROVIDER as K, getProviderList as L, getProviderModel as M, getProviderModelDescriptors as N, getProviderModels as O, getReasoningCapability as Q, getRuntimeModelProvider as T, getRuntimeModelProviderCredentialEnvironmentNames as U, getRuntimeModelProviderNames as V, isCustomProviderName as W, isKnownProvider as X, isProviderConfigured as Y, isProviderName as Z, isReasoningEnabled as _, KODAX_DEFAULT_THINKING_BUDGETS as a, listAllModelCapabilities as a0, listBuiltinModelCapabilities as a1, listCustomProviderModelCapabilities as a2, listProviderModels as a3, mapDepthToOpenAIReasoningEffort as a4, mapLegacyReasoningModeToEffortIntent as a5, normalizeReasoningEffortValue as a6, normalizeReasoningRequest as a7, parseReasoningEffortEnv as a8, registerCustomProviders as a9, registerModelProvider as aa, resolveModelCapabilities as ab, resolveProvider as ac, resolveProviderModelDescriptors as ad, resolveReasoningEffort as ae, resolveReasoningEffortForModelSwitch as af, resolveThinkingBudget as ag, resolveWireEffort as ah, sideQuery as ai, validateCustomProviderConfig as aj, verifyProviderCredential as ak, KODAX_PROVIDERS as b, KODAX_PROVIDER_SNAPSHOTS as c, KODAX_REASONING_MODE_SEQUENCE as d, KODAX_REASONING_SAFETY_RESERVE as e, KODAX_STABLE_EFFORT_INTENTS as f, KodaXAnthropicCompatProvider as g, KodaXError as h, KodaXNetworkError as j, KodaXOpenAICompatProvider as k, KodaXProviderError as l, KodaXRateLimitError as m, KodaXToolCallIdError as n, clampThinkingBudget as t, clearRuntimeModelProviders as u, createCustomProvider as v, effortToLegacyReasoningMode as w, getAvailableProviderNames as x, getCustomModelCapabilities as y, getCustomProvider as z };
-export type { ProviderName as P, ResolveWireEffortInput as R, SideQueryDiagnostics as S, KodaXModelCapabilities as i, ResolvedWireEffort as o, SideQueryRequest as p, SideQueryResult as q, SideQueryStopReason as r, SideQueryTerminalPhase as s };
+export { mapDepthToOpenAIReasoningEffort as $, getDefaultThinkingDepthForMode as A, getModelCapabilities as B, getProvider as C, getProviderConfiguredCapabilityProfile as D, getProviderConfiguredReasoningCapability as E, getProviderCredentialEnvironmentNames as F, getProviderList as G, getProviderModel as H, getProviderModelDescriptors as I, getProviderModels as J, KODAX_DEFAULT_PROVIDER as K, getReasoningCapability as L, getRuntimeModelProvider as M, getRuntimeModelProviderCredentialEnvironmentNames as N, getRuntimeModelProviderNames as O, isCustomProviderName as Q, isKnownProvider as S, isProviderConfigured as T, isProviderName as U, isReasoningEnabled as V, isRuntimeModelProviderName as W, listAllModelCapabilities as X, listBuiltinModelCapabilities as Y, listCustomProviderModelCapabilities as Z, listProviderModels as _, KODAX_DEFAULT_THINKING_BUDGETS as a, mapLegacyReasoningModeToEffortIntent as a0, normalizeReasoningEffortValue as a1, normalizeReasoningRequest as a2, parseReasoningEffortEnv as a3, registerCustomProviders as a4, registerModelProvider as a5, resolveModelCapabilities as a6, resolveProvider as a7, resolveProviderModelDescriptors as a8, resolveReasoningEffort as a9, resolveReasoningEffortForModelSwitch as aa, resolveThinkingBudget as ab, resolveWireEffort as ac, validateCustomProviderConfig as ad, verifyProviderCredential as ae, KODAX_PROVIDERS as b, KODAX_PROVIDER_SNAPSHOTS as c, KODAX_REASONING_MODE_SEQUENCE as d, KODAX_REASONING_SAFETY_RESERVE as e, KODAX_STABLE_EFFORT_INTENTS as f, KodaXAnthropicCompatProvider as g, KodaXError as h, KodaXNetworkError as j, KodaXOpenAICompatProvider as k, KodaXProviderError as l, KodaXRateLimitError as m, KodaXToolCallIdError as n, clampThinkingBudget as p, clearRuntimeModelProviders as q, createCustomProvider as r, effortToLegacyReasoningMode as s, getAvailableProviderNames as t, getCustomModelCapabilities as u, getCustomProvider as v, getCustomProviderList as w, getCustomProviderModelDescriptors as x, getCustomProviderModels as y, getCustomProviderNames as z };
+export type { ProviderName as P, ResolveWireEffortInput as R, KodaXModelCapabilities as i, ResolvedWireEffort as o };

package/dist/types-chunks/{run-manager.d-B47hIqnI.d.ts → run-manager.d-CX3AUocA.d.ts}

@@ -1,4 +1,4 @@
-import { eg as WorkflowProcessTrackerOptions, dO as WorkflowEvent, ea as WorkflowProcessSnapshot, e4 as WorkflowProcessEvent } from './types.d-RdWRfUEs.js';
+import { fg as WorkflowProcessTrackerOptions, eO as WorkflowEvent, fa as WorkflowProcessSnapshot, f4 as WorkflowProcessEvent } from './controller.d-RGV7Pjv9.js';
 
 /**
  * FEATURE_246 Part A0 (ADR-046) — neutral workflow run lifecycle manager.

package/dist/types-chunks/{sdk-session-CLWf8Adb.d.ts → sdk-session-B3cfJKqF.d.ts}

@@ -1,6 +1,6 @@
-import { g as CreatableHistoryItem, a8 as ToolCall } from './public-api.d--fF88JrC.js';
-import { k as KodaXMessage, c as KodaXContentBlock } from './types.d-DIpZJKUl.js';
-import { bX as KodaXSessionUiHistoryItem, b$ as KodaXSessionUiToolCall } from './types.d-RdWRfUEs.js';
+import { h as CreatableHistoryItem, as as ToolCall } from './public-api.d-BpJhHoa7.js';
+import { k as KodaXMessage, c as KodaXContentBlock } from './types.d-CgrXrFrq.js';
+import { cc as KodaXSessionUiHistoryItem, cg as KodaXSessionUiToolCall } from './controller.d-RGV7Pjv9.js';
 
 interface RestoreHistoryItemsFromSessionInput {
     messages: readonly KodaXMessage[];

package/dist/types-chunks/side-query.d-CP1LiRiH.d.ts

@@ -0,0 +1,83 @@
+import { k as KodaXMessage, I as KodaXReasoningRequest, a1 as KodaXTokenUsage } from './types.d-CgrXrFrq.js';
+import { K as KodaXBaseProvider } from './base.d-DxG0m09Z.js';
+import { a as CostTracker } from './cost-tracker.d-BeaenODW.js';
+
+/**
+ * sideQuery — independent one-shot LLM invocation.
+ *
+ * Used by features that need a clean LLM call outside the main agent loop.
+ * The auto mode classifier (FEATURE_092) is the first consumer; future
+ * users include compaction, title generation, and SA mutation reflection.
+ *
+ * Constraints (deliberate):
+ *   - tools=[] hardcoded — sideQuery is single-turn, no tool loop
+ *   - text-only output — tool_use blocks from the model produce stopReason='error'
+ *   - independent timeout (default 30s; callers may supply a bounded deadline)
+ *   - independent cost bucket via querySource (mapped to TokenUsageRecord.role)
+ *
+ * Failure handling: never throws. Timeout, abort, provider error, and
+ * unexpected tool_use all produce a result with stopReason='timeout' /
+ * 'aborted' / 'error' so callers implement their own degradation.
+ */
+
+type SideQueryStopReason = 'end_turn' | 'max_tokens' | 'timeout' | 'aborted' | 'error';
+interface SideQueryRequest {
+    readonly provider: KodaXBaseProvider;
+    readonly model: string;
+    readonly system: string;
+    readonly messages: readonly KodaXMessage[];
+    readonly reasoning?: KodaXReasoningRequest;
+    /** Optional per-request cap for small structured sidecar responses. */
+    readonly maxOutputTokens?: number;
+    readonly timeoutMs?: number;
+    readonly abortSignal?: AbortSignal;
+    readonly querySource: string;
+    readonly costTracker?: CostTracker;
+}
+interface SideQueryResult {
+    readonly text: string;
+    readonly usage: KodaXTokenUsage;
+    readonly costTracker?: CostTracker;
+    readonly stopReason: SideQueryStopReason;
+    /**
+     * Bounded request metadata only; prompts and response text are never copied.
+     * The built-in `sideQuery()` always supplies it. Optionality preserves source
+     * compatibility for existing SDK mocks and structural result adapters.
+     */
+    readonly diagnostics?: SideQueryDiagnostics;
+    readonly error?: Error;
+}
+type SideQueryTerminalPhase = 'completed' | 'pre_output' | 'awaiting_text' | 'thinking' | 'streaming' | 'contract_error';
+interface SideQueryDiagnostics {
+    readonly provider: string;
+    readonly model: string;
+    readonly timeoutMs: number;
+    readonly elapsedMs: number;
+    readonly systemBytes: number;
+    readonly messageBytes: number;
+    readonly promptBytes: number;
+    readonly retryCount: number;
+    readonly retryWaitMs: number;
+    /** Provider completion mapped to the stable side-query stop taxonomy. */
+    readonly stopReason?: SideQueryStopReason;
+    /** UTF-8 size of returned text only; response content is never persisted. */
+    readonly responseBytes?: number;
+    /** Number of provider text blocks concatenated into the returned text. */
+    readonly textBlockCount?: number;
+    /** Time until the first lifecycle/data event exposed by the provider adapter. */
+    readonly firstUpstreamEventMs?: number;
+    /** Time until the first non-empty thinking delta. */
+    readonly firstThinkingDeltaMs?: number;
+    /** Time until the first non-empty text delta. */
+    readonly firstTextDeltaMs?: number;
+    /** Time until the first non-empty text delta, when the adapter exposes it. */
+    readonly firstOutputMs?: number;
+    /** Time from the first observed text delta until termination. */
+    readonly streamMs?: number;
+    /** Honest coarse phase; provider adapters cannot split DNS/connect/remote queue. */
+    readonly terminalPhase: SideQueryTerminalPhase;
+}
+declare function sideQuery(req: SideQueryRequest): Promise<SideQueryResult>;
+
+export { sideQuery as s };
+export type { SideQueryDiagnostics as S, SideQueryRequest as a, SideQueryResult as b, SideQueryStopReason as c, SideQueryTerminalPhase as d };

package/dist/types-chunks/{types-LanCEDj8.d.ts → types-Bf3Y3mW-.d.ts}

@@ -1,4 +1,4 @@
-import { k as KodaXMessage } from './types.d-DIpZJKUl.js';
+import { k as KodaXMessage } from './types.d-CgrXrFrq.js';
 
 /**
  * @kodax-ai/agent Types
@@ -86,26 +86,47 @@ interface KodaXSessionClientNoticeEntry extends KodaXSessionEntryBase {
 interface KodaXMemoryOutcomeDigest {
     readonly id: string;
     readonly reviewKey: string;
+    /** Stable root-episode identity; absent on pre-F263 digests. */
+    readonly episodeId?: string;
     readonly sessionId: string;
     readonly branchId: string;
     readonly sequence: number;
     readonly objective: string;
     readonly actionSignature?: string;
     readonly approach: string;
-    readonly outcome: 'succeeded' | 'failed';
+    /**
+     * `cancelled` is reserved for a host-bound explicit Memory intent. Ordinary
+     * cancelled episodes do not produce an outcome digest.
+     */
+    readonly outcome: 'succeeded' | 'failed' | 'cancelled';
     readonly summary: string;
     readonly preconditions?: string;
     readonly lesson?: string;
     readonly evidenceRefs: readonly string[];
     readonly evidence?: readonly KodaXMemoryOutcomeEvidence[];
+    /**
+     * Explicit durable intent captured from the Action LLM and bound by the
+     * host to an exact quote in the current user turn. It is evidence for the
+     * governed reviewer, never proof that Memory was queued or applied.
+     */
+    readonly memoryIntent?: KodaXMemoryIntent;
     readonly memoryInfluence?: readonly KodaXMemoryInfluenceRef[];
     readonly visibility: 'prompt_safe' | 'private' | 'sensitive';
     readonly createdAt: string;
 }
+interface KodaXMemoryIntent {
+    readonly operation: 'remember' | 'correct';
+    readonly evidenceRef: string;
+    /** Sanitized model-derived claim proposed for governed review. */
+    readonly candidateStatement: string;
+    /** Sanitized representation of the exact current-user quote verified by the host. */
+    readonly userQuote: string;
+}
 interface KodaXMemoryOutcomeEvidence {
     readonly ref: string;
     readonly grade: 'authoritative' | 'verified' | 'corroborated' | 'observed' | 'inferred';
     readonly source: 'user' | 'host' | 'tool' | 'environment' | 'agent';
+    readonly verdict?: 'passed' | 'failed' | 'inconclusive';
     readonly observedAt: string;
 }
 interface KodaXMemoryInfluenceRef {
@@ -115,9 +136,13 @@ interface KodaXMemoryInfluenceRef {
 interface KodaXSessionMemoryOutcomeDigestEntry extends KodaXSessionEntryBase {
     readonly type: 'memory_outcome_digest';
     readonly digest: KodaXMemoryOutcomeDigest;
+    /** Durable F263 review job identity. Absent on pre-F263 lineage records. */
+    readonly jobId?: string;
 }
 interface KodaXSessionMemoryReviewReceiptEntry extends KodaXSessionEntryBase {
     readonly type: 'memory_review_receipt';
+    /** Distinguishes repeated review keys across branch epochs. */
+    readonly jobId?: string;
     readonly reviewKey: string;
     readonly proposalIds: readonly string[];
     readonly status: 'completed' | 'no_action';
@@ -196,6 +221,8 @@ interface KodaXSessionLineage {
 }
 
 interface MemoryContextIdentity {
+    /** Explicit owner home for durable runtime state; never persisted in review envelopes. */
+    readonly configHome?: string;
     readonly tenantId: string;
     readonly workspaceId?: string;
     readonly userId?: string;
@@ -452,7 +479,15 @@ interface MemoryController {
     maybeRunAutoCurator(input?: MemoryAutoCuratorInput): Promise<MemoryAutoCuratorResult>;
     buildMemoryPack(input: MemoryPackInput): Promise<MemoryPack>;
     reviewMemoryFeedback(input: MemoryReviewInput): Promise<MemoryReviewPlan>;
+    prepareEpisodeReview?(digest: KodaXMemoryOutcomeDigest): Promise<MemoryReviewModelInput>;
+    applyReviewedEpisode?(plan: MemoryReviewPlan, digest: KodaXMemoryOutcomeDigest, signal?: AbortSignal, revalidateAuthority?: () => Promise<void>): Promise<MemoryEpisodeReviewResult>;
     persistReviewPlan(plan: MemoryReviewPlan): Promise<readonly string[]>;
+    /**
+     * Resolves which episode-review proposals were actually auto-applied by the
+     * governed host policy. Used to keep durable receipts complete while user
+     * notices remain truthful.
+     */
+    listHostAppliedEpisodeProposalIds?(proposalIds: readonly string[]): Promise<readonly string[]>;
     reviewEpisode(digest: KodaXMemoryOutcomeDigest, signal?: AbortSignal): Promise<MemoryEpisodeReviewResult>;
     archiveRef(id: string): Promise<MemoryLifecycleOperationResult>;
     forgetRef(id: string): Promise<MemoryLifecycleOperationResult>;
@@ -484,6 +519,7 @@ interface MemoryEvidenceRef {
     readonly ref: string;
     readonly requestedGrade: MemoryEvidenceGrade;
     readonly source: 'user' | 'host' | 'tool' | 'environment' | 'agent';
+    readonly verdict?: 'passed' | 'failed' | 'inconclusive';
     readonly observedAt: string;
 }
 type MemorySourcePolicy = (evidence: MemoryEvidenceRef) => MemoryEvidenceGrade;
@@ -575,7 +611,7 @@ type MemoryAgentTraceEvent = {
     /** @deprecated Retained for source compatibility; F275 no longer emits prefetch events. */
      | 'recall.prefetch.failed'
     /** @deprecated Retained for source compatibility; F275 no longer emits prefetch events. */
-     | 'recall.prefetch.discarded' | 'query.failed' | 'review.timed_out';
+     | 'recall.prefetch.discarded' | 'query.failed' | 'review.failed' | 'review.timed_out';
     readonly key: string;
     readonly detail?: string;
 } | {
@@ -585,11 +621,14 @@ type MemoryAgentTraceEvent = {
 interface MemorySessionInput {
     readonly identity: MemoryContextIdentity;
     readonly objective: string;
+    /** Stable caller-owned identity for this root episode. */
+    readonly episodeId?: string;
 }
 interface MemoryEpisodeOutcome {
     readonly status: 'succeeded' | 'failed' | 'cancelled';
     readonly summary: string;
     readonly evidence: readonly MemoryEvidenceRef[];
+    readonly memoryIntent?: KodaXMemoryIntent;
 }
 type PersistedOutcomeDigest = KodaXMemoryOutcomeDigest;
 interface MemorySession {

package/dist/types-chunks/{types.d-CODuyyqy.d.ts → types.d-BZ9oXvTV.d.ts}

@@ -1,5 +1,5 @@
-import { bw as KodaXInputArtifact } from './types.d-RdWRfUEs.js';
-import { S as KodaXTaskResultMetadata } from './types.d-DIpZJKUl.js';
+import { bM as KodaXInputArtifact } from './controller.d-RGV7Pjv9.js';
+import { T as KodaXTaskResultMetadata } from './types.d-CgrXrFrq.js';
 
 /**
  * @kodax-ai/agent/messaging — Message queue types

package/dist/types-chunks/{types.d-DCQVBqVn.d.ts → types.d-BbtGlKZu.d.ts}

@@ -56,6 +56,11 @@ interface SkillMetadata {
     argumentHint?: string;
     path: string;
     source: ResolvedSkillSource;
+    readonly learned?: {
+        readonly capabilityId: string;
+        readonly revision: number;
+        readonly fingerprint: string;
+    };
     /** If true, exclude from system prompt; still invokable by explicit slash forms. */
     disableModelInvocation: boolean;
 }
@@ -204,7 +209,22 @@ interface SkillPathsConfig {
     userPaths: string[];
     pluginPaths: string[];
     builtinPath: string;
+    /**
+     * Deprecated loose-file path. It remains in the public shape for source
+     * compatibility but is intentionally not discovered without a manifest.
+     */
     learnedPath?: string;
+    learnedArea?: LearnedSkillDiscoveryConfig;
+}
+interface LearnedSkillDiscoveryConfig {
+    readonly rootDir: string;
+    readonly expectedScope: {
+        readonly configHomeHash: string;
+        readonly tenantHash: string;
+        readonly projectHash: string;
+    };
+    readonly testingBindings?: Readonly<Record<string, string>>;
+    readonly now?: string;
 }
 /**
  * Get default skill discovery paths
@@ -215,13 +235,15 @@ interface SkillPathsConfig {
  * 3. User - ~/.agents/skills/ (AgentSkills standard)
  * 4. Plugin - (dynamic)
  * 5. Builtin - packages/skills/src/builtin/
- * 6. Learned - ~/.kodax/learned/skills/ (never shadows a formal source)
+ * Learned Skills are supplied separately through a record-gated Learned Area
+ * and never through a loose directory.
  */
 declare function getDefaultSkillPaths(projectRoot?: string): SkillPathsConfig;
 /**
  * All skill paths in priority order (highest to lowest)
  *
- * Priority: Project > User > Plugin > Builtin > Learned
+ * Priority: Project > User > Plugin > Builtin. Record-gated Learned Skills
+ * are appended by discovery after these formal sources.
  * - Project: Project-specific skills override everything else
  * - User: User preferences (~/.kodax/ and ~/.agents/)
  * - Plugin: Third-party plugins
@@ -234,4 +256,4 @@ declare function getSkillPathsFlat(config: SkillPathsConfig): Array<{
 }>;
 
 export { getDefaultSkillPaths as m, getSkillPathsFlat as n };
-export type { ISkillRegistry as I, ResolvedSkillSource as R, Skill as S, IVariableResolver as a, SkillArtifact as b, SkillContext as c, SkillDynamicContextExecutor as d, SkillFile as e, SkillFrontmatter as f, SkillHook as g, SkillHooks as h, SkillMetadata as i, SkillPathsConfig as j, SkillResult as k, SkillSource as l };
+export type { ISkillRegistry as I, LearnedSkillDiscoveryConfig as L, ResolvedSkillSource as R, Skill as S, IVariableResolver as a, SkillArtifact as b, SkillContext as c, SkillDynamicContextExecutor as d, SkillFile as e, SkillFrontmatter as f, SkillHook as g, SkillHooks as h, SkillMetadata as i, SkillPathsConfig as j, SkillResult as k, SkillSource as l };

package/dist/types-chunks/{types.d-DCsKM8aT.d.ts → types.d-C0_rn--1.d.ts}

@@ -1,8 +1,8 @@
-import { a9 as KodaXWireReasoningEffort, a1 as KodaXToolDefinition, a3 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-DIpZJKUl.js';
-import { K as KodaXBaseProvider } from './base.d-4e74xDdy.js';
+import { aa as KodaXWireReasoningEffort, a2 as KodaXToolDefinition, a4 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-CgrXrFrq.js';
+import { K as KodaXBaseProvider } from './base.d-DxG0m09Z.js';
 import { C as CapabilityKind, a as CapabilityProvider } from './capability.d-K664nHOS.js';
-import { by as KodaXJsonValue, bm as KodaXExtensionSessionRecord, bo as KodaXExtensionStore } from './types.d-RdWRfUEs.js';
-import { aK as KodaXToolExecutionContext, br as ToolSideEffect } from './bash-prefix-extractor.d-pZdu6qt7.js';
+import { bO as KodaXJsonValue, bC as KodaXExtensionSessionRecord, bE as KodaXExtensionStore } from './controller.d-RGV7Pjv9.js';
+import { aQ as KodaXToolExecutionContext, by as ToolSideEffect } from './bash-prefix-extractor.d-CNSidpmv.js';
 
 /**
  * KodaX Constructed-World types (FEATURE_087, v0.7.28).