@kodax-ai/kodax 0.7.58 → 0.7.60

package/dist/types-chunks/{bash-prefix-extractor.d-D3cddmyV.d.ts → bash-prefix-extractor.d-Ds1THKeH.d.ts}

@@ -1,9 +1,10 @@
-import { W as KodaXGoalState, g as AgentMessage, b8 as StopHookFn, aa as KodaXSessionLineage, a0 as KodaXJsonValue, Q as KodaXExtensionSessionRecord, af as KodaXSessionScope, ag as KodaXSessionStorage, R as KodaXExtensionSessionState, _ as KodaXInputArtifact, C as ChildTaskRegistry, bt as WorkflowEventCorrelation, t as CompactionUpdate, bF as WorkflowProcessEvent, bs as WorkflowEvent, n as AskUserQuestionOptions, l as AskUserMultiOptions, z as Guardrail, bw as WorkflowIsolation, a2 as KodaXSessionArtifactLedgerEntry, aV as SessionErrorMetadata, w as DiscoveredInstance, bc as TaskAbortRegistry } from './process.d-DHow2y2G.js';
-import { Z as KodaXTokenUsage, j as KodaXMessage, a6 as KodaXWireReasoningEffort, E as KodaXReasoningMode, g as KodaXHarnessProfile, T as KodaXTaskWorkIntent, I as KodaXReviewScale, P as KodaXTaskComplexity, b as KodaXChildFanoutClass, R as KodaXTaskRoutingDecision, S as KodaXTaskType, J as KodaXRiskLevel, e as KodaXExecutionMode } from './types.d-Ci5YPFEh.js';
+import { W as KodaXGoalState, g as AgentMessage, b9 as StopHookFn, ab as KodaXSessionLineage, a0 as KodaXJsonValue, Q as KodaXExtensionSessionRecord, bx as WorkflowIsolation, R as KodaXExtensionSessionState, a2 as KodaXSessionArtifactLedgerEntry, aW as SessionErrorMetadata, ag as KodaXSessionScope, ah as KodaXSessionStorage, _ as KodaXInputArtifact, C as ChildTaskRegistry, bu as WorkflowEventCorrelation, t as CompactionUpdate, bG as WorkflowProcessEvent, bt as WorkflowEvent, n as AskUserQuestionOptions, l as AskUserMultiOptions, z as Guardrail, w as DiscoveredInstance, bd as TaskAbortRegistry } from './process.d-C93UMgPK.js';
+import { $ as KodaXTokenUsage, j as KodaXMessage, a8 as KodaXWireReasoningEffort, T as KodaXTaskRoutingDecision, U as KodaXTaskType, V as KodaXTaskWorkIntent, P as KodaXTaskComplexity, J as KodaXRiskLevel, g as KodaXHarnessProfile, e as KodaXExecutionMode, b as KodaXChildFanoutClass, E as KodaXReasoningMode, I as KodaXReviewScale } from './types.d-Bp4Lm1jv.js';
+import { d as SkillDynamicContextExecutor } from './types.d-vJExiRje.js';
 import { Diagnostic, Position, Location, Hover, DocumentSymbol, SymbolInformation, WorkspaceSymbol, CallHierarchyItem, CallHierarchyIncomingCall, CallHierarchyOutgoingCall } from 'vscode-languageserver-protocol';
 import { K as KodaXLlmTimeoutConfig, a as CostTracker } from './cost-tracker.d-CBLk1fiD.js';
 import { C as CapabilityKind, b as CapabilityResult } from './capability.d-3C62G8Eq.js';
-import { K as KodaXBaseProvider } from './base.d-BA9Doaj_.js';
+import { K as KodaXBaseProvider } from './base.d-DalIRhbb.js';
 
 /**
  * FEATURE_192 v0.7.44 Phase C — Goal-tools execution context.
@@ -1382,7 +1383,29 @@ interface KodaXRepoIntelligenceTraceEvent {
 interface KodaXWorkflowEventMeta {
     readonly workflowCorrelation?: WorkflowEventCorrelation;
 }
-interface KodaXActivityEventMeta extends KodaXWorkflowEventMeta {
+type KodaXTurnDeliveryKind = 'initial' | 'queued' | 'interrupt' | 'resume';
+interface KodaXLiveEventMeta {
+    readonly sessionId: string;
+    readonly seq: number;
+    readonly turnId: string;
+    readonly deliveryId?: string;
+    readonly timestamp?: string;
+}
+interface KodaXTurnStartedEvent extends KodaXLiveEventMeta {
+    readonly promptId?: string;
+    readonly deliveryKind: KodaXTurnDeliveryKind;
+}
+interface KodaXTurnCompletedEvent extends KodaXLiveEventMeta {
+    readonly status: 'completed' | 'cancelled' | 'interrupted';
+}
+interface KodaXTurnFailedEvent extends KodaXLiveEventMeta {
+    readonly error: {
+        readonly name: string;
+        readonly message: string;
+        readonly stack?: string;
+    };
+}
+interface KodaXActivityEventMeta extends KodaXWorkflowEventMeta, Partial<KodaXLiveEventMeta> {
     readonly childAgentId?: string;
     readonly childAgentName?: string;
     readonly parentToolId?: string;
@@ -1472,8 +1495,11 @@ interface KodaXEvents {
     onSessionStart?: (info: {
         provider: string;
         sessionId: string;
-    }) => void;
-    onIterationStart?: (iter: number, maxIter: number) => void;
+    } & Partial<KodaXLiveEventMeta>) => void;
+    onTurnStarted?: (event: KodaXTurnStartedEvent) => void;
+    onTurnCompleted?: (event: KodaXTurnCompletedEvent) => void;
+    onTurnFailed?: (event: KodaXTurnFailedEvent) => void;
+    onIterationStart?: (iter: number, maxIter: number, meta?: KodaXActivityEventMeta) => void;
     /** Called after each iteration with current token count for UI updates */
     onIterationEnd?: (info: {
         iter: number;
@@ -1492,19 +1518,19 @@ interface KodaXEvents {
          * for backward compatibility.
          */
         scope?: 'parent' | 'worker';
-    }) => void;
-    onCompactStart?: () => void;
+    } & Partial<KodaXLiveEventMeta>) => void;
+    onCompactStart?: (meta?: KodaXActivityEventMeta) => void;
     /** Emitted when compaction finishes and actually changed the context */
-    onCompact?: (estimatedTokens: number) => void;
+    onCompact?: (estimatedTokens: number, meta?: KodaXActivityEventMeta) => void;
     /** Emitted when compaction changes the context so UI can refresh token usage immediately */
     onCompactStats?: (info: {
         tokensBefore: number;
         tokensAfter: number;
-    }) => void;
+    } & Partial<KodaXLiveEventMeta>) => void;
     /** Emitted with the rewritten message history when automatic compaction changes the context. */
-    onCompactedMessages?: (messages: KodaXMessage[], update?: CompactionUpdate) => void;
+    onCompactedMessages?: (messages: KodaXMessage[], update?: CompactionUpdate, meta?: KodaXActivityEventMeta) => void;
     /** Emitted to silently dismiss the compaction UI if compaction aborted or completed without changes */
-    onCompactEnd?: () => void;
+    onCompactEnd?: (meta?: KodaXActivityEventMeta) => void;
     /** Whether the caller has queued follow-up input waiting for the next round */
     hasPendingInputs?: () => boolean;
     /**
@@ -1529,7 +1555,7 @@ interface KodaXEvents {
      * Fires once per Runner iteration boundary, with the array of
      * prompt contents in queue order. Empty arrays are not surfaced.
      */
-    onMidTurnUserMessages?: (contents: readonly string[]) => void;
+    onMidTurnUserMessages?: (contents: readonly string[], meta?: KodaXActivityEventMeta) => void;
     onRetry?: (reason: string, attempt: number, maxAttempts: number, meta?: KodaXActivityEventMeta) => void;
     onProviderRateLimit?: (attempt: number, maxRetries: number, delayMs: number, meta?: KodaXActivityEventMeta) => void;
     /**
@@ -1566,8 +1592,8 @@ interface KodaXEvents {
         provider: string;
         model: string;
         effort: string;
-    }) => void;
-    onRepoIntelligenceTrace?: (event: KodaXRepoIntelligenceTraceEvent) => void;
+    } & Partial<KodaXLiveEventMeta>) => void;
+    onRepoIntelligenceTrace?: (event: KodaXRepoIntelligenceTraceEvent & Partial<KodaXLiveEventMeta>) => void;
     /**
      * Fired when the Sidecar Verifier produces an actionable message.
      *
@@ -1577,7 +1603,7 @@ interface KodaXEvents {
      * `blocked` is surfaced terminally to the user. Accept remains silent here
      * because there is no sidecar-to-agent reply to show.
      */
-    onSidecarMessage?: (event: KodaXSidecarMessageEvent) => void;
+    onSidecarMessage?: (event: KodaXSidecarMessageEvent & Partial<KodaXLiveEventMeta>) => void;
     /**
      * FEATURE_097 (v0.7.34): emitted whenever the Scout-seeded todo list
      * changes — initial seed at `emit_scout_verdict`, per-item updates from
@@ -1587,28 +1613,28 @@ interface KodaXEvents {
      * in one event loop, so subscriber lag is not a real failure mode
      * (FEATURE_086 onRepoIntelligenceTrace single-rail precedent).
      */
-    onTodoUpdate?: (items: TodoList) => void;
+    onTodoUpdate?: (items: TodoList, meta?: KodaXActivityEventMeta) => void;
     /**
      * Warn-only telemetry: a successful real work tool completed while the
      * visible todo list had pending items but no item marked in_progress.
      * The runner does not mutate the todo list for this signal; it only
      * nudges the next model turn to call todo_update explicitly.
      */
-    onTodoDriftWarning?: (event: KodaXTodoDriftWarningEvent) => void;
+    onTodoDriftWarning?: (event: KodaXTodoDriftWarningEvent & Partial<KodaXLiveEventMeta>) => void;
     /** Structured provider recovery event (Feature 045) */
     onProviderRecovery?: (event: ProviderRecoveryEvent, meta?: KodaXActivityEventMeta) => void;
-    onComplete?: () => void;
-    onError?: (error: Error) => void;
-    onManagedTaskStatus?: (status: KodaXManagedTaskStatusEvent) => void;
+    onComplete?: (meta?: KodaXActivityEventMeta) => void;
+    onError?: (error: Error, meta?: KodaXActivityEventMeta) => void;
+    onManagedTaskStatus?: (status: KodaXManagedTaskStatusEvent & Partial<KodaXLiveEventMeta>) => void;
     /**
      * FEATURE_247 (R4) — fired once at managed-task start with the effective
      * profile / tool scope / verification snapshot. Lets an SDK embedder confirm
      * the intended profile (e.g. Partner) actually entered the SDK managed task
      * and diagnose the tools + verification constraints it was given.
      */
-    onEffectiveConfig?: (config: KodaXEffectiveTaskConfig) => void;
+    onEffectiveConfig?: (config: KodaXEffectiveTaskConfig & Partial<KodaXLiveEventMeta>) => void;
     /** FEATURE_229: workflow process snapshot stream for SDK/host panels. */
-    onWorkflowProcessEvent?: (event: WorkflowProcessEvent) => void;
+    onWorkflowProcessEvent?: (event: WorkflowProcessEvent & Partial<KodaXLiveEventMeta>) => void;
     /**
      * ADR-049: per-agent digest stream for the inline `run_workflow` path. Fires
      * once per workflow child agent reaching a terminal/summary state
@@ -1617,7 +1643,7 @@ interface KodaXEvents {
      * and writes it to the transcript — matching the slash `/workflow` path and
      * `dispatch_child_task` children, whose summaries persist in scrollback.
      */
-    onWorkflowAgentDigest?: (event: KodaXWorkflowAgentDigestEvent) => void;
+    onWorkflowAgentDigest?: (event: KodaXWorkflowAgentDigestEvent & Partial<KodaXLiveEventMeta>) => void;
     /**
      * Fired when Scout's managed-task completion is inferred but the harness
      * detected suspicious signals (mutation expected but none happened, budget
@@ -1631,7 +1657,7 @@ interface KodaXEvents {
         signals: KodaXScoutSuspiciousSignal[];
         sessionId?: string;
         lastTextPreview: string;
-    }) => void;
+    } & Partial<KodaXLiveEventMeta>) => void;
     /**
      * FEATURE_167 (v0.7.41) — Evaluator terminal-verdict fallback.
      *
@@ -2276,6 +2302,17 @@ interface KodaXContextOptions {
     promptOverlay?: string;
     /** Optional task-engine surface label used to track managed tasks across UX entry points. */
     taskSurface?: KodaXTaskSurface;
+    /**
+     * Host-provided live-turn attribution for this invocation. Embedders that
+     * resume, interrupt, or deliver queued prompts outside KodaX's own queue can
+     * preserve the real delivery kind without the SDK guessing from event order.
+     */
+    liveTurn?: {
+        deliveryKind?: KodaXTurnDeliveryKind;
+        turnId?: string;
+        deliveryId?: string;
+        promptId?: string;
+    };
     /** Optional directory where managed task artifacts should be written. */
     managedTaskWorkspaceDir?: string;
     /** Internal managed-worker protocol emission configuration. */
@@ -2415,6 +2452,21 @@ interface KodaXCompactionOverride {
     /** Set false to disable automatic compaction for this run. */
     enabled?: boolean;
 }
+/**
+ * FEATURE_222 skill security — host policy for a skill's `!`cmd`` dynamic-context
+ * tokens. By default (both fields unset) the LLM-triggered `skill` tool runs
+ * those commands via the built-in allowlist + `execSync` — fine for the trusted
+ * standalone CLI, but an embedder host (KodaX-Space) wants every shell touch to
+ * go through its own permission broker. Set `execute` to route each `!`cmd``
+ * through the host, or `disable: true` to refuse them outright.
+ */
+interface KodaXSkillDynamicContextPolicy {
+    /** Host hook run for each `!`cmd`` token (command, cwd) → stdout. Mediate via
+     *  the host's permission broker; throw to refuse a command. */
+    execute?: SkillDynamicContextExecutor;
+    /** When true, every `!`cmd`` token is refused without executing anything. */
+    disable?: boolean;
+}
 interface KodaXOptions {
     provider: string;
     model?: string;
@@ -2480,6 +2532,12 @@ interface KodaXOptions {
     };
     /** FEATURE_221: SDK-consumer self-manual injection (product name + topics). */
     selfManual?: KodaXSelfManualConfig;
+    /**
+     * FEATURE_222 skill security: host policy for skill `!`cmd`` dynamic-context.
+     * Absent → built-in allowlist+execSync (trusted-CLI default). See
+     * {@link KodaXSkillDynamicContextPolicy}.
+     */
+    skillDynamicContext?: KodaXSkillDynamicContextPolicy;
     /**
      * FEATURE_092 (v0.7.33): caller-supplied run-scoped guardrails forwarded
      * to `Runner.run` via `RunOptions.guardrails`. Merged with the START
@@ -2792,6 +2850,9 @@ interface KodaXToolExecutionContext {
     agentProfile?: KodaXAgentProfile;
     /** FEATURE_221: SDK-consumer self-manual injection, forwarded from KodaXOptions. */
     selfManual?: KodaXSelfManualConfig;
+    /** FEATURE_222 skill security — host policy for skill `!`cmd`` dynamic-context,
+     *  forwarded from `KodaXOptions.skillDynamicContext`. Consumed by the `skill` tool. */
+    skillDynamicContext?: KodaXSkillDynamicContextPolicy;
     /** Working directory used to resolve relative paths and execute shell commands. */
     executionCwd?: string;
     /** Session-scoped directory for helper scripts and scratch outputs. */
@@ -3345,5 +3406,5 @@ interface CreateBashPrefixExtractorOptions {
  */
 declare function createBashPrefixExtractor(opts: CreateBashPrefixExtractorOptions): BashPrefixExtractor;
 
-export { BASH_POLICY_SPEC as B, LSP_SERVERS as av, LspService as ax, buildGoalRuntimeBinding as b0, createBashPrefixExtractor as b1, decideWorkflowInvocation as b2, extractCommandPrefix as b3, getDefaultLspService as b4, makeDisabledGoalToolsContext as b5, providerResilienceConfigFromTimeouts as b6, shutdownDefaultLspService as b7, withGoalBeforeNextTurn as b8, withGoalStopHook as b9, workflowStartOutcomeConsumesTurn as ba };
-export type { KodaXRuntimeVerificationContract as $, KodaXManagedTask as A, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionRuntimeContract as E, FailureStage as F, GoalBlockedResult as G, KodaXManagedTaskRuntimeState as H, KodaXManagedTaskStatusEvent as I, KodaXManualSource as J, KodaXActivityEventMeta as K, KodaXManualTopic as L, KodaXManualTopicId as M, KodaXManualTopicInput as N, KodaXMemoryStrategy as O, KodaXOptions as P, KodaXOrchestrationVerdict as Q, KodaXParentReductionContract as R, KodaXProviderPolicyHints as S, KodaXRepoIntelligenceCapability as T, KodaXRepoIntelligenceMode as U, KodaXRepoIntelligenceResolvedMode as V, KodaXRepoIntelligenceTrace as W, KodaXRepoIntelligenceTraceEvent as X, KodaXRepoRoutingSignals as Y, KodaXResult as Z, KodaXRoleRoundSummary as _, BashPrefixExtractor as a, WorkflowToolHostStartResult as a$, KodaXSelfManualConfig as a0, KodaXSessionControl as a1, KodaXSessionMutators as a2, KodaXSessionOptions as a3, KodaXSidecarMessageEvent as a4, KodaXSkillInvocationContext as a5, KodaXSkillMap as a6, KodaXSkillProjectionConfidence as a7, KodaXTaskCapabilityHint as a8, KodaXTaskContract as a9, ProviderRecoveryEvent as aA, ProviderResilienceConfig as aB, ProviderResiliencePolicy as aC, RecoveryAction as aD, RecoveryDecision as aE, RecoveryLadderStep as aF, RecoveryResult as aG, ResilienceClassification as aH, ResilienceErrorClass as aI, ResolveKodaXManualInput as aJ, ResolveKodaXManualOptions as aK, ResolveKodaXManualResult as aL, RuntimeDefaultsSnapshot as aM, TodoItem as aN, TodoList as aO, TodoStatus as aP, ToolSideEffect as aQ, WorkflowHostPolicy as aR, WorkflowInvocationAction as aS, WorkflowInvocationPolicyDecision as aT, WorkflowInvocationPolicyInput as aU, WorkflowInvocationSource as aV, WorkflowRunProgressView as aW, WorkflowStartOutcome as aX, WorkflowToolHost as aY, WorkflowToolHostInlineInput as aZ, WorkflowToolHostResult as a_, KodaXTaskEvidenceArtifact as aa, KodaXTaskEvidenceBundle as ab, KodaXTaskEvidenceEntry as ac, KodaXTaskRole as ad, KodaXTaskRoleAssignment as ae, KodaXTaskStatus as af, KodaXTaskSurface as ag, KodaXTaskToolPolicy as ah, KodaXTaskVerificationContract as ai, KodaXTaskVerificationCriterion as aj, KodaXTaskWorkItem as ak, KodaXTimeoutConfig as al, KodaXToolEventMeta as am, KodaXToolExecutionContext as an, KodaXToolVisibilityMeta as ao, KodaXToolVisibilityPolicy as ap, KodaXVerificationScorecard as aq, KodaXVerificationScorecardCriterion as ar, KodaXWorkflowAgentDigestEvent as as, KodaXWorkflowEventMeta as at, KodaXWorkflowTimeoutConfig as au, LspServerInfo as aw, LspServiceConfig as ay, ProviderExecutionState as az, BashPrefixResult as b, BoundExtensionRuntimeController as c, ChildSnapshotEvent as d, CreateBashPrefixExtractorOptions as e, ExtractCommandPrefixOptions as f, GoalCompleteResult as g, GoalCreateInput as h, GoalLifecycleContext as i, GoalRuntimeBinding as j, GoalRuntimeBindingDeps as k, GoalToolsContext as l, KodaXAgentMode as m, KodaXAgentProfile as n, KodaXBudgetDisclosureZone as o, KodaXBudgetExtensionRequest as p, KodaXChildAgentResult as q, KodaXChildContextBundle as r, KodaXChildExecutionResult as s, KodaXCompactionOverride as t, KodaXContextOptions as u, KodaXContextTokenSnapshot as v, KodaXEffectiveTaskConfig as w, KodaXEvents as x, KodaXManagedBudgetSnapshot as y, KodaXManagedProtocolPayload as z };
+export { BASH_POLICY_SPEC as B, LSP_SERVERS as aB, LspService as aD, buildGoalRuntimeBinding as b6, createBashPrefixExtractor as b7, decideWorkflowInvocation as b8, extractCommandPrefix as b9, getDefaultLspService as ba, makeDisabledGoalToolsContext as bb, providerResilienceConfigFromTimeouts as bc, shutdownDefaultLspService as bd, withGoalBeforeNextTurn as be, withGoalStopHook as bf, workflowStartOutcomeConsumesTurn as bg };
+export type { KodaXRoleRoundSummary as $, KodaXManagedProtocolPayload as A, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionRuntimeContract as E, FailureStage as F, GoalBlockedResult as G, KodaXManagedTask as H, KodaXManagedTaskRuntimeState as I, KodaXManagedTaskStatusEvent as J, KodaXActivityEventMeta as K, KodaXManualSource as L, KodaXManualTopic as M, KodaXManualTopicId as N, KodaXManualTopicInput as O, KodaXMemoryStrategy as P, KodaXOptions as Q, KodaXOrchestrationVerdict as R, KodaXParentReductionContract as S, KodaXProviderPolicyHints as T, KodaXRepoIntelligenceCapability as U, KodaXRepoIntelligenceMode as V, KodaXRepoIntelligenceResolvedMode as W, KodaXRepoIntelligenceTrace as X, KodaXRepoIntelligenceTraceEvent as Y, KodaXRepoRoutingSignals as Z, KodaXResult as _, BashPrefixExtractor as a, WorkflowInvocationSource as a$, KodaXRuntimeVerificationContract as a0, KodaXSelfManualConfig as a1, KodaXSessionControl as a2, KodaXSessionMutators as a3, KodaXSessionOptions as a4, KodaXSidecarMessageEvent as a5, KodaXSkillDynamicContextPolicy as a6, KodaXSkillInvocationContext as a7, KodaXSkillMap as a8, KodaXSkillProjectionConfidence as a9, KodaXWorkflowTimeoutConfig as aA, LspServerInfo as aC, LspServiceConfig as aE, ProviderExecutionState as aF, ProviderRecoveryEvent as aG, ProviderResilienceConfig as aH, ProviderResiliencePolicy as aI, RecoveryAction as aJ, RecoveryDecision as aK, RecoveryLadderStep as aL, RecoveryResult as aM, ResilienceClassification as aN, ResilienceErrorClass as aO, ResolveKodaXManualInput as aP, ResolveKodaXManualOptions as aQ, ResolveKodaXManualResult as aR, RuntimeDefaultsSnapshot as aS, TodoItem as aT, TodoList as aU, TodoStatus as aV, ToolSideEffect as aW, WorkflowHostPolicy as aX, WorkflowInvocationAction as aY, WorkflowInvocationPolicyDecision as aZ, WorkflowInvocationPolicyInput as a_, KodaXTaskCapabilityHint as aa, KodaXTaskContract as ab, KodaXTaskEvidenceArtifact as ac, KodaXTaskEvidenceBundle as ad, KodaXTaskEvidenceEntry as ae, KodaXTaskRole as af, KodaXTaskRoleAssignment as ag, KodaXTaskStatus as ah, KodaXTaskSurface as ai, KodaXTaskToolPolicy as aj, KodaXTaskVerificationContract as ak, KodaXTaskVerificationCriterion as al, KodaXTaskWorkItem as am, KodaXTimeoutConfig as an, KodaXToolEventMeta as ao, KodaXToolExecutionContext as ap, KodaXToolVisibilityMeta as aq, KodaXToolVisibilityPolicy as ar, KodaXTurnCompletedEvent as as, KodaXTurnDeliveryKind as at, KodaXTurnFailedEvent as au, KodaXTurnStartedEvent as av, KodaXVerificationScorecard as aw, KodaXVerificationScorecardCriterion as ax, KodaXWorkflowAgentDigestEvent as ay, KodaXWorkflowEventMeta as az, BashPrefixResult as b, WorkflowRunProgressView as b0, WorkflowStartOutcome as b1, WorkflowToolHost as b2, WorkflowToolHostInlineInput as b3, WorkflowToolHostResult as b4, WorkflowToolHostStartResult as b5, BoundExtensionRuntimeController as c, ChildSnapshotEvent as d, CreateBashPrefixExtractorOptions as e, ExtractCommandPrefixOptions as f, GoalCompleteResult as g, GoalCreateInput as h, GoalLifecycleContext as i, GoalRuntimeBinding as j, GoalRuntimeBindingDeps as k, GoalToolsContext as l, KodaXAgentMode as m, KodaXAgentProfile as n, KodaXBudgetDisclosureZone as o, KodaXBudgetExtensionRequest as p, KodaXChildAgentResult as q, KodaXChildContextBundle as r, KodaXChildExecutionResult as s, KodaXCompactionOverride as t, KodaXContextOptions as u, KodaXContextTokenSnapshot as v, KodaXEffectiveTaskConfig as w, KodaXEvents as x, KodaXLiveEventMeta as y, KodaXManagedBudgetSnapshot as z };

package/dist/types-chunks/{capability-learning.d-DRV80ISB.d.ts → capability-learning.d-BQB0M70w.d.ts}

@@ -1,4 +1,4 @@
-import { F as KodaXReasoningProfile } from './types.d-Ci5YPFEh.js';
+import { F as KodaXReasoningProfile } from './types.d-Bp4Lm1jv.js';
 
 type CapabilityCacheSource = 'observed' | 'probed';
 interface CapabilityCacheEntry {

package/dist/types-chunks/{guardrail.d-iK7FwMdW.d.ts → guardrail.d-CdqJwwN7.d.ts}

@@ -1,8 +1,8 @@
 import { M as McpConnectMode, a as McpServerConfig, b as McpServersConfig, c as McpTransportKind } from './config.d-CJy1WENT.js';
-import { K as KodaXBaseProvider } from './base.d-BA9Doaj_.js';
+import { K as KodaXBaseProvider } from './base.d-DalIRhbb.js';
 import { a as CostTracker } from './cost-tracker.d-CBLk1fiD.js';
-import { aO as RunnerToolCall } from './process.d-DHow2y2G.js';
-import { g as ToolGuardrail } from './types.d-D4ZA8LJV.js';
+import { aP as RunnerToolCall } from './process.d-C93UMgPK.js';
+import { g as ToolGuardrail } from './types.d-CSZAMmU-.js';
 
 /**
  * FEATURE_200 Phase F (v0.7.45) — MCP domain types extracted from types.ts.

package/dist/types-chunks/{process.d-DHow2y2G.d.ts → process.d-C93UMgPK.d.ts}

@@ -1,4 +1,4 @@
-import { j as KodaXMessage, _ as KodaXToolDefinition, E as KodaXReasoningMode, a6 as KodaXWireReasoningEffort, a0 as KodaXToolResultContentItem, V as KodaXThinkingBlock, H as KodaXRedactedThinkingBlock } from './types.d-Ci5YPFEh.js';
+import { j as KodaXMessage, a0 as KodaXToolDefinition, E as KodaXReasoningMode, a8 as KodaXWireReasoningEffort, a2 as KodaXToolResultContentItem, X as KodaXThinkingBlock, H as KodaXRedactedThinkingBlock } from './types.d-Bp4Lm1jv.js';
 
 /**
  * @kodax-ai/agent Types
@@ -35,6 +35,14 @@ interface KodaXSessionEntryBase {
     id: string;
     parentId: string | null;
     timestamp: string;
+    /**
+     * Stable logical identity for this transcript item. Cloned/forked entries get
+     * a fresh physical `id` but keep their source entry's `logicalId`, allowing
+     * SDK hosts to group or fold cloned history without comparing content.
+     */
+    logicalId?: string;
+    /** Root physical entry id this item was cloned from, when it is a clone. */
+    sourceEntryId?: string;
 }
 interface KodaXSessionMessageEntry extends KodaXSessionEntryBase {
     type: 'message';
@@ -82,6 +90,13 @@ interface KodaXSessionArchiveMarkerEntry extends KodaXSessionEntryBase {
     /** Brief summary of the archived content */
     summary: string;
 }
+interface KodaXSessionClientNoticeEntry extends KodaXSessionEntryBase {
+    type: 'client_notice';
+    source: string;
+    content: string;
+    turnId?: string;
+    payload?: KodaXJsonValue;
+}
 type KodaXGoalStatus = 'active' | 'paused' | 'budget_limited' | 'blocked' | 'complete';
 /**
  * Persistent user-set goal state. v0.7.44 FEATURE_192 — backs the
@@ -120,7 +135,7 @@ interface KodaXSessionGoalEntry extends KodaXSessionEntryBase {
     goal: KodaXGoalState | null;
     event: KodaXGoalEventType;
 }
-type KodaXSessionEntry = KodaXSessionMessageEntry | KodaXSessionCompactionEntry | KodaXSessionBranchSummaryEntry | KodaXSessionLabelEntry | KodaXSessionArchiveMarkerEntry | KodaXSessionGoalEntry;
+type KodaXSessionEntry = KodaXSessionMessageEntry | KodaXSessionCompactionEntry | KodaXSessionBranchSummaryEntry | KodaXSessionLabelEntry | KodaXSessionArchiveMarkerEntry | KodaXSessionClientNoticeEntry | KodaXSessionGoalEntry;
 interface KodaXSessionArtifactLedgerEntry {
     id: string;
     kind: 'file_read' | 'file_modified' | 'file_created' | 'file_deleted' | 'path_scope' | 'search_scope' | 'command_scope' | 'check_result' | 'decision' | 'image_input' | 'tombstone';
@@ -157,7 +172,7 @@ interface KodaXSessionNavigationOptions {
     summarizeCurrentBranch?: boolean;
 }
 interface KodaXSessionTreeNode {
-    entry: Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry>;
+    entry: Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry | KodaXSessionClientNoticeEntry>;
     children: KodaXSessionTreeNode[];
     label?: string;
     active: boolean;
@@ -2605,7 +2620,7 @@ interface FileOperations {
  * injected clock). The run graph models agent relationships as a
  * thread/edge/event stream, not just a final summary blob.
  */
-type WorkflowEventType = 'workflow_started' | 'phase_started' | 'phase_finished' | 'agent_spawned' | 'agent_message_sent' | 'agent_completed' | 'agent_unverified' | 'agent_failed' | 'agent_summary_updated' | 'agent_stopped' | 'workflow_log' | 'artifact_written' | 'synthesis_completed' | 'workflow_completed' | 'workflow_stopped' | 'workflow_failed';
+type WorkflowEventType = 'workflow_started' | 'phase_started' | 'phase_finished' | 'agent_spawned' | 'agent_message_sent' | 'agent_completed' | 'agent_unverified' | 'agent_failed' | 'agent_summary_updated' | 'agent_stopped' | 'agent_replayed' | 'workflow_log' | 'artifact_written' | 'synthesis_completed' | 'workflow_completed' | 'workflow_stopped' | 'workflow_failed';
 interface WorkflowEvent {
     /** Monotonic sequence number — stable append ordering. */
     readonly seq: number;
@@ -2943,6 +2958,13 @@ interface WorkflowRunState {
 type WorkflowProcessStatus = 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
 type WorkflowProcessItemStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'skipped';
 type WorkflowProcessItemKind = 'phase' | 'agent' | 'step' | 'artifact';
+/**
+ * FEATURE_246 resume telemetry — how an agent item came to be in a resumed run.
+ * `ran` = executed live this run; `replayed-from-cache` = returned instantly from
+ * a prior run's content-addressed result cache (resumeFromRunId). Only populated
+ * on resumed runs; absent on a fresh run (treat absent as `ran`).
+ */
+type WorkflowProcessItemOrigin = 'ran' | 'replayed-from-cache';
 type WorkflowProcessSummaryStatus = 'pending' | 'result' | 'notice' | 'unavailable';
 type WorkflowProcessSource = 'command' | 'amaw' | 'review' | 'sdk' | 'capsule' | 'extension' | 'automation';
 interface WorkflowProcessItem {
@@ -2961,6 +2983,8 @@ interface WorkflowProcessItem {
     readonly summary?: string;
     readonly summaryStatus?: WorkflowProcessSummaryStatus;
     readonly error?: string;
+    /** FEATURE_246 resume telemetry — see {@link WorkflowProcessItemOrigin}. */
+    readonly origin?: WorkflowProcessItemOrigin;
 }
 interface WorkflowEventCorrelation {
     readonly workflowRunId: string;
@@ -2984,6 +3008,10 @@ interface WorkflowProcessProgress {
     readonly stoppedAgents: number;
     readonly agentCap?: number;
     readonly plannedItems?: number;
+    /** FEATURE_246 resume telemetry — count of agents that replayed from a prior
+     *  run's cache (origin `replayed-from-cache`). Present only when > 0, so a
+     *  fresh run's progress is unchanged. */
+    readonly replayedAgents?: number;
 }
 interface WorkflowProcessTokenUsage {
     readonly spent: number;
@@ -3008,6 +3036,9 @@ interface WorkflowProcessSnapshot {
     readonly sourceRunId?: string;
     readonly sourceWorkflowName?: string;
     readonly revisionOf?: string;
+    /** FEATURE_246 resume telemetry — the prior run this run resumed from
+     *  (content-addressed replay). Absent on a fresh (non-resumed) run. */
+    readonly resumedFromRunId?: string;
     readonly hostMetadata?: Record<string, string>;
     readonly activePhaseId?: string;
     readonly activePhaseIndex?: number;
@@ -3042,6 +3073,8 @@ interface WorkflowProcessTrackerOptions {
     readonly sourceRunId?: string;
     readonly sourceWorkflowName?: string;
     readonly revisionOf?: string;
+    /** FEATURE_246 resume telemetry — the prior run this run resumed from. */
+    readonly resumedFromRunId?: string;
     readonly hostMetadata?: Record<string, string>;
     readonly phases?: readonly string[];
     readonly maxAgents?: number;
@@ -3066,5 +3099,5 @@ declare function isFinalWorkflowProcessStatus(status: WorkflowProcessStatus): bo
 declare function normalizeHostMetadata(value: unknown): Record<string, string> | undefined;
 declare function createWorkflowProcessTracker(options: WorkflowProcessTrackerOptions): WorkflowProcessTracker;
 
-export { ASK_USER_BACK_SIGNAL as A, DEFAULT_SYSTEM_CAP as D, InvariantSession as N, Runner as aK, MAX_TOOL_LOOP_ITERATIONS as as, SpanImpl as b1, Tracer as bj, WorkflowEventRecorder as bu, _resetAdmittedAgentBindings as c6, _resetPresetDispatchers as c7, asSingleSelection as c8, buildAssistantMessageFromLlmResult as c9, buildSystemPrompt as ca, buildToolResultMessage as cb, createAgent as cc, createHandoff as cd, createInMemorySession as ce, createInvariantSessionForAgent as cf, createStateWriter as cg, createTrace as ch, createWorkflowProcessTracker as ci, defaultTracer as cj, detectInstructionsInjection as ck, discoverInstances as cl, executeRunnerToolCall as cm, extractAssistantTextFromMessage as cn, getActiveUserInteraction as co, getAdmittedAgentBindings as cp, isFinalWorkflowProcessStatus as cq, isRunnableTool as cr, isRunnerLlmResult as cs, normalizeHostMetadata as ct, registerChildTask as cu, registerPresetDispatcher as cv, requestTaskStop as cw, runAdmissionAudit as cx, setActiveUserInteraction as cy, setAdmittedAgentBindings as cz };
-export type { KodaXInputArtifactSource as $, GuardrailSpanData as B, ChildTaskRegistry as C, EvidenceSpanData as E, FanoutSpanData as F, GenerationSpanData as G, Handoff as H, HandoffSpanData as I, InMemorySessionOptions as J, InstanceDiscoveryFs as K, InvariantId as L, InvariantResult as M, KodaXCompactMemoryProgress as O, KodaXCompactMemorySeed as P, KodaXExtensionSessionRecord as Q, KodaXExtensionSessionState as R, KodaXExtensionStore as S, KodaXExtensionStoreEntry as T, KodaXFileInputArtifact as U, KodaXGoalEventType as V, KodaXGoalState as W, KodaXGoalStatus as X, KodaXImageInputArtifact as Y, KodaXImageMediaType as Z, KodaXInputArtifact as _, AdmissionAuditOptions as a, SpanData as a$, KodaXJsonValue as a0, KodaXSessionArchiveMarkerEntry as a1, KodaXSessionArtifactLedgerEntry as a2, KodaXSessionBranchSummaryEntry as a3, KodaXSessionCompactionEntry as a4, KodaXSessionData as a5, KodaXSessionEntry as a6, KodaXSessionEntryBase as a7, KodaXSessionGoalEntry as a8, KodaXSessionLabelEntry as a9, ReadonlyMutationTracker as aA, ReadonlyRecorder as aB, ReasoningDepth as aC, RecentlyModifiedFile as aD, RequestTaskStopOptions as aE, RequestTaskStopResult as aF, RunEvent as aG, RunOptions as aH, RunResult as aI, RunnableTool as aJ, RunnerEvent as aL, RunnerLlmResult as aM, RunnerLlmReturn as aN, RunnerToolCall as aO, RunnerToolContext as aP, RunnerToolObserver as aQ, RunnerToolResult as aR, Session as aS, SessionDispatchResult as aT, SessionEntry as aU, SessionErrorMetadata as aV, SessionExtension as aW, SessionForkOptions as aX, SessionMeta as aY, SessionStateSnapshot as aZ, Span as a_, KodaXSessionLineage as aa, KodaXSessionMessageEntry as ab, KodaXSessionMeta as ac, KodaXSessionNavigationOptions as ad, KodaXSessionRuntimeInfo as ae, KodaXSessionScope as af, KodaXSessionStorage as ag, KodaXSessionTreeNode as ah, KodaXSessionUiHistoryItem as ai, KodaXSessionUiHistoryItemType as aj, KodaXSessionUiTextHistoryItem as ak, KodaXSessionUiTextHistoryItemType as al, KodaXSessionUiToolCall as am, KodaXSessionUiToolCallStatus as an, KodaXSessionUiToolGroupHistoryItem as ao, KodaXSessionWorkspaceKind as ap, KodaXVideoInputArtifact as aq, KodaXVideoMediaType as ar, ManifestPatch as at, MessageEntry as au, ObserveCtx as av, PersistedSessionState as aw, PresetDispatcher as ax, PresetTracingContext as ay, QualityInvariant as az, AdmissionCtx as b, WorkflowTaskSummaryEventUpdate as b$, SpanError as b0, SpanImplOptions as b2, StartTraceOptions as b3, StateWriter as b4, StateWriterFs as b5, StateWriterOptions as b6, StopHookContext as b7, StopHookFn as b8, StopHookResult as b9, WorkflowModelHint as bA, WorkflowModule as bB, WorkflowParallelOptions as bC, WorkflowProcessArtifact as bD, WorkflowProcessCounts as bE, WorkflowProcessEvent as bF, WorkflowProcessItem as bG, WorkflowProcessItemKind as bH, WorkflowProcessItemStatus as bI, WorkflowProcessProgress as bJ, WorkflowProcessSnapshot as bK, WorkflowProcessSource as bL, WorkflowProcessStatus as bM, WorkflowProcessSummaryStatus as bN, WorkflowProcessTokenUsage as bO, WorkflowProcessTracker as bP, WorkflowProcessTrackerOptions as bQ, WorkflowRun as bR, WorkflowRunState as bS, WorkflowRunStatus as bT, WorkflowSpawnAgentInput as bU, WorkflowSynthesis as bV, WorkflowSynthesizeInput as bW, WorkflowTaskHandle as bX, WorkflowTaskResult as bY, WorkflowTaskSnapshot as bZ, WorkflowTaskStatus as b_, StopHookSpanData as ba, SystemCap as bb, TaskAbortRegistry as bc, TerminalCtx as bd, ToolCallSpanData as be, ToolCapability as bf, ToolPermission as bg, Trace as bh, TraceOptions as bi, TracerOptions as bk, UserInteraction as bl, WorkflowAgentBackend as bm, WorkflowApi as bn, WorkflowApproval as bo, WorkflowApprovalSummary as bp, WorkflowArtifactRef as bq, WorkflowBudget as br, WorkflowEvent as bs, WorkflowEventCorrelation as bt, WorkflowEventType as bv, WorkflowIsolation as bw, WorkflowLimits as bx, WorkflowLogEvent as by, WorkflowMeta as bz, AdmissionVerdict as c, WorkflowTaskSummaryKind as c0, WorkflowTaskSummaryUpdate as c1, WorkflowTaskUsage as c2, WorkflowTaskVerification as c3, WorkflowTaskVerificationResult as c4, WorkflowWaitOptions as c5, AdmittedHandle as d, Agent as e, AgentManifest as f, AgentMessage as g, AgentMiddlewareDeclaration as h, AgentReasoningProfile as i, AgentSpanData as j, AgentTool as k, AskUserMultiOptions as l, AskUserQuestionItem as m, AskUserQuestionOptions as n, CompactionAnchor as o, CompactionConfig as p, CompactionDetails as q, CompactionResult as r, CompactionSpanData as s, CompactionUpdate as t, CurrentTodoSummary as u, Deliverable as v, DiscoveredInstance as w, DiscoveryOptions as x, FileOperations as y, Guardrail as z };
+export { ASK_USER_BACK_SIGNAL as A, DEFAULT_SYSTEM_CAP as D, InvariantSession as N, Runner as aL, MAX_TOOL_LOOP_ITERATIONS as at, SpanImpl as b2, Tracer as bk, WorkflowEventRecorder as bv, _resetAdmittedAgentBindings as c8, _resetPresetDispatchers as c9, setActiveUserInteraction as cA, setAdmittedAgentBindings as cB, asSingleSelection as ca, buildAssistantMessageFromLlmResult as cb, buildSystemPrompt as cc, buildToolResultMessage as cd, createAgent as ce, createHandoff as cf, createInMemorySession as cg, createInvariantSessionForAgent as ch, createStateWriter as ci, createTrace as cj, createWorkflowProcessTracker as ck, defaultTracer as cl, detectInstructionsInjection as cm, discoverInstances as cn, executeRunnerToolCall as co, extractAssistantTextFromMessage as cp, getActiveUserInteraction as cq, getAdmittedAgentBindings as cr, isFinalWorkflowProcessStatus as cs, isRunnableTool as ct, isRunnerLlmResult as cu, normalizeHostMetadata as cv, registerChildTask as cw, registerPresetDispatcher as cx, requestTaskStop as cy, runAdmissionAudit as cz };
+export type { KodaXInputArtifactSource as $, GuardrailSpanData as B, ChildTaskRegistry as C, EvidenceSpanData as E, FanoutSpanData as F, GenerationSpanData as G, Handoff as H, HandoffSpanData as I, InMemorySessionOptions as J, InstanceDiscoveryFs as K, InvariantId as L, InvariantResult as M, KodaXCompactMemoryProgress as O, KodaXCompactMemorySeed as P, KodaXExtensionSessionRecord as Q, KodaXExtensionSessionState as R, KodaXExtensionStore as S, KodaXExtensionStoreEntry as T, KodaXFileInputArtifact as U, KodaXGoalEventType as V, KodaXGoalState as W, KodaXGoalStatus as X, KodaXImageInputArtifact as Y, KodaXImageMediaType as Z, KodaXInputArtifact as _, AdmissionAuditOptions as a, Span as a$, KodaXJsonValue as a0, KodaXSessionArchiveMarkerEntry as a1, KodaXSessionArtifactLedgerEntry as a2, KodaXSessionBranchSummaryEntry as a3, KodaXSessionClientNoticeEntry as a4, KodaXSessionCompactionEntry as a5, KodaXSessionData as a6, KodaXSessionEntry as a7, KodaXSessionEntryBase as a8, KodaXSessionGoalEntry as a9, QualityInvariant as aA, ReadonlyMutationTracker as aB, ReadonlyRecorder as aC, ReasoningDepth as aD, RecentlyModifiedFile as aE, RequestTaskStopOptions as aF, RequestTaskStopResult as aG, RunEvent as aH, RunOptions as aI, RunResult as aJ, RunnableTool as aK, RunnerEvent as aM, RunnerLlmResult as aN, RunnerLlmReturn as aO, RunnerToolCall as aP, RunnerToolContext as aQ, RunnerToolObserver as aR, RunnerToolResult as aS, Session as aT, SessionDispatchResult as aU, SessionEntry as aV, SessionErrorMetadata as aW, SessionExtension as aX, SessionForkOptions as aY, SessionMeta as aZ, SessionStateSnapshot as a_, KodaXSessionLabelEntry as aa, KodaXSessionLineage as ab, KodaXSessionMessageEntry as ac, KodaXSessionMeta as ad, KodaXSessionNavigationOptions as ae, KodaXSessionRuntimeInfo as af, KodaXSessionScope as ag, KodaXSessionStorage as ah, KodaXSessionTreeNode as ai, KodaXSessionUiHistoryItem as aj, KodaXSessionUiHistoryItemType as ak, KodaXSessionUiTextHistoryItem as al, KodaXSessionUiTextHistoryItemType as am, KodaXSessionUiToolCall as an, KodaXSessionUiToolCallStatus as ao, KodaXSessionUiToolGroupHistoryItem as ap, KodaXSessionWorkspaceKind as aq, KodaXVideoInputArtifact as ar, KodaXVideoMediaType as as, ManifestPatch as au, MessageEntry as av, ObserveCtx as aw, PersistedSessionState as ax, PresetDispatcher as ay, PresetTracingContext as az, AdmissionCtx as b, WorkflowTaskSnapshot as b$, SpanData as b0, SpanError as b1, SpanImplOptions as b3, StartTraceOptions as b4, StateWriter as b5, StateWriterFs as b6, StateWriterOptions as b7, StopHookContext as b8, StopHookFn as b9, WorkflowMeta as bA, WorkflowModelHint as bB, WorkflowModule as bC, WorkflowParallelOptions as bD, WorkflowProcessArtifact as bE, WorkflowProcessCounts as bF, WorkflowProcessEvent as bG, WorkflowProcessItem as bH, WorkflowProcessItemKind as bI, WorkflowProcessItemOrigin as bJ, WorkflowProcessItemStatus as bK, WorkflowProcessProgress as bL, WorkflowProcessSnapshot as bM, WorkflowProcessSource as bN, WorkflowProcessStatus as bO, WorkflowProcessSummaryStatus as bP, WorkflowProcessTokenUsage as bQ, WorkflowProcessTracker as bR, WorkflowProcessTrackerOptions as bS, WorkflowRun as bT, WorkflowRunState as bU, WorkflowRunStatus as bV, WorkflowSpawnAgentInput as bW, WorkflowSynthesis as bX, WorkflowSynthesizeInput as bY, WorkflowTaskHandle as bZ, WorkflowTaskResult as b_, StopHookResult as ba, StopHookSpanData as bb, SystemCap as bc, TaskAbortRegistry as bd, TerminalCtx as be, ToolCallSpanData as bf, ToolCapability as bg, ToolPermission as bh, Trace as bi, TraceOptions as bj, TracerOptions as bl, UserInteraction as bm, WorkflowAgentBackend as bn, WorkflowApi as bo, WorkflowApproval as bp, WorkflowApprovalSummary as bq, WorkflowArtifactRef as br, WorkflowBudget as bs, WorkflowEvent as bt, WorkflowEventCorrelation as bu, WorkflowEventType as bw, WorkflowIsolation as bx, WorkflowLimits as by, WorkflowLogEvent as bz, AdmissionVerdict as c, WorkflowTaskStatus as c0, WorkflowTaskSummaryEventUpdate as c1, WorkflowTaskSummaryKind as c2, WorkflowTaskSummaryUpdate as c3, WorkflowTaskUsage as c4, WorkflowTaskVerification as c5, WorkflowTaskVerificationResult as c6, WorkflowWaitOptions as c7, AdmittedHandle as d, Agent as e, AgentManifest as f, AgentMessage as g, AgentMiddlewareDeclaration as h, AgentReasoningProfile as i, AgentSpanData as j, AgentTool as k, AskUserMultiOptions as l, AskUserQuestionItem as m, AskUserQuestionOptions as n, CompactionAnchor as o, CompactionConfig as p, CompactionDetails as q, CompactionResult as r, CompactionSpanData as s, CompactionUpdate as t, CurrentTodoSummary as u, Deliverable as v, DiscoveredInstance as w, DiscoveryOptions as x, FileOperations as y, Guardrail as z };

package/dist/types-chunks/{resolver.d-DDOfVYDr.d.ts → resolver.d-CGkfRULj.d.ts}

@@ -1,6 +1,6 @@
-import { E as KodaXReasoningMode, L as KodaXStableEffortIntent, a6 as KodaXWireReasoningEffort, F as KodaXReasoningProfile, W as KodaXThinkingBudgetMap, X as KodaXThinkingDepth, p as KodaXProviderConfig, A as KodaXReasoningCapability, G as KodaXReasoningRequest, m as KodaXNormalizedReasoningRequest, S as KodaXTaskType, a4 as KodaXVerifyCredentialResult, _ as KodaXToolDefinition, j as KodaXMessage, x as KodaXProviderStreamOptions, M as KodaXStreamResult, k as KodaXModelDescriptor, o as KodaXProviderCapabilityProfile, a5 as KodaXVerifyStrategy, d as KodaXCustomProviderConfig, i as KodaXListModelsResult } from './types.d-Ci5YPFEh.js';
+import { E as KodaXReasoningMode, L as KodaXStableEffortIntent, a8 as KodaXWireReasoningEffort, F as KodaXReasoningProfile, Y as KodaXThinkingBudgetMap, Z as KodaXThinkingDepth, p as KodaXProviderConfig, A as KodaXReasoningCapability, G as KodaXReasoningRequest, m as KodaXNormalizedReasoningRequest, U as KodaXTaskType, a6 as KodaXVerifyCredentialResult, a0 as KodaXToolDefinition, j as KodaXMessage, x as KodaXProviderStreamOptions, M as KodaXStreamResult, k as KodaXModelDescriptor, o as KodaXProviderCapabilityProfile, a7 as KodaXVerifyStrategy, d as KodaXCustomProviderConfig, i as KodaXListModelsResult } from './types.d-Bp4Lm1jv.js';
 import Anthropic from '@anthropic-ai/sdk';
-import { K as KodaXBaseProvider } from './base.d-BA9Doaj_.js';
+import { K as KodaXBaseProvider } from './base.d-DalIRhbb.js';
 import OpenAI from 'openai';
 
 /**
@@ -86,6 +86,60 @@ declare function resolveThinkingBudget(config: KodaXProviderConfig, depth: KodaX
 declare function clampThinkingBudget(requestedBudget: number, maxOutputTokens: number, safetyReserve?: number): number;
 declare function mapDepthToOpenAIReasoningEffort(depth: KodaXThinkingDepth): 'low' | 'medium' | 'high' | undefined;
 
+/**
+ * FEATURE_222 (R6) — canonical host-facing reasoning-effort resolver.
+ *
+ * Mapping a user's desired reasoning strength to the actual wire `effort` value
+ * for a provider/model means composing several pieces that already exist but
+ * were only wired together privately inside the REPL: the model's reasoning
+ * profile (`resolveModelCapabilities`), the learned hard-rejection cache
+ * (`narrowReasoningProfile`), and the alias/disabled/ceiling/default resolution
+ * (`resolveReasoningEffort`). A host that re-assembles these by hand drifts.
+ *
+ * `resolveWireEffort` is the single entry point: give it a provider/model + the
+ * desired effort (+ any learned rejected efforts) and it returns the legal wire
+ * effort — or `undefined`, which is a deliberate "omit reasoning_effort" signal
+ * (e.g. anthropic-adaptive, or a provider with no reasoning). It reuses the
+ * existing pure functions verbatim; no new resolution logic.
+ */
+interface ResolveWireEffortInput {
+    /** Provider id (built-in alias or registered custom provider name). */
+    readonly provider: string;
+    /** Model id. Omit to use the provider's default model. */
+    readonly model?: string;
+    /** The desired reasoning strength (a wire effort or tier the user requested).
+     *  Treated as a non-explicit session preference: an unsupported value falls
+     *  back to a legal one rather than throwing. */
+    readonly desiredEffort?: string;
+    /** Learned hard-rejected efforts for this provider/model (e.g. from the agent
+     *  layer's `getCachedRejectedEfforts`). Removed from the ladder before
+     *  resolving, so a rejected rung is never re-selected. */
+    readonly rejectedEfforts?: readonly string[];
+}
+interface ResolvedWireEffort {
+    /** The legal wire effort to send, or `undefined` to omit reasoning_effort
+     *  entirely (adaptive/none — NOT a fallback to `configuredEffort`). */
+    readonly effort: string | undefined;
+    /** What the input resolved to before profile-driven adjustment (alias/
+     *  ceiling/disable). Useful for a "requested X → sending Y" status label. */
+    readonly configuredEffort: string | undefined;
+    /**
+     * True when the wire effort differs from the configured one — aliased, ceiled,
+     * disabled-folded, or narrowed by a rejection. NOTE: this is also true for a
+     * plain `desiredEffort: 'auto'` (configuredEffort `'auto'` resolves to a
+     * concrete rung), so do NOT read `adjusted` as "the user's explicit choice was
+     * overridden"; compare `configuredEffort` vs `effort` yourself if you need to
+     * exclude the auto→concrete case in a status label.
+     */
+    readonly adjusted: boolean;
+}
+/**
+ * Resolve the wire-level reasoning effort for a provider/model + desired
+ * strength, honoring alias/disabled/ceiling/default rules and learned
+ * rejections. Pure — no I/O, no throw.
+ */
+declare function resolveWireEffort(input: ResolveWireEffortInput): ResolvedWireEffort;
+
 /**
  * KodaX Anthropic Compatible Provider
  *
@@ -594,5 +648,5 @@ declare function listProviderModels(name: string, _opts?: {
     signal?: AbortSignal;
 }): Promise<KodaXListModelsResult>;
 
-export { parseReasoningEffortEnv as $, getModelCapabilities as A, getProvider as B, getProviderConfiguredCapabilityProfile as C, getProviderConfiguredReasoningCapability as D, getProviderList as E, getProviderModel as F, getProviderModelDescriptors as G, getProviderModels as H, getReasoningCapability as I, getRuntimeModelProvider as J, KODAX_DEFAULT_PROVIDER as K, getRuntimeModelProviderNames as L, isCustomProviderName as M, isKnownProvider as N, isProviderConfigured as O, isProviderName as Q, isReasoningEnabled as R, isRuntimeModelProviderName as S, listAllModelCapabilities as T, listBuiltinModelCapabilities as U, listCustomProviderModelCapabilities as V, listProviderModels as W, mapDepthToOpenAIReasoningEffort as X, mapLegacyReasoningModeToEffortIntent as Y, normalizeReasoningEffortValue as Z, normalizeReasoningRequest as _, KODAX_DEFAULT_THINKING_BUDGETS as a, registerCustomProviders as a0, registerModelProvider as a1, resolveModelCapabilities as a2, resolveProvider as a3, resolveProviderModelDescriptors as a4, resolveReasoningEffort as a5, resolveReasoningEffortForModelSwitch as a6, resolveThinkingBudget as a7, validateCustomProviderConfig as a8, verifyProviderCredential as a9, 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 o, clearRuntimeModelProviders as p, createCustomProvider as q, effortToLegacyReasoningMode as r, getAvailableProviderNames as s, getCustomModelCapabilities as t, getCustomProvider as u, getCustomProviderList as v, getCustomProviderModelDescriptors as w, getCustomProviderModels as x, getCustomProviderNames as y, getDefaultThinkingDepthForMode as z };
-export type { ProviderName as P, KodaXModelCapabilities as i };
+export { normalizeReasoningEffortValue as $, getDefaultThinkingDepthForMode as A, getModelCapabilities as B, getProvider as C, getProviderConfiguredCapabilityProfile as D, getProviderConfiguredReasoningCapability as E, getProviderList as F, getProviderModel as G, getProviderModelDescriptors as H, getProviderModels as I, getReasoningCapability as J, KODAX_DEFAULT_PROVIDER as K, getRuntimeModelProvider as L, getRuntimeModelProviderNames as M, isCustomProviderName as N, isKnownProvider as O, isProviderConfigured as Q, isProviderName as S, isReasoningEnabled as T, isRuntimeModelProviderName as U, listAllModelCapabilities as V, listBuiltinModelCapabilities as W, listCustomProviderModelCapabilities as X, listProviderModels as Y, mapDepthToOpenAIReasoningEffort as Z, mapLegacyReasoningModeToEffortIntent as _, KODAX_DEFAULT_THINKING_BUDGETS as a, normalizeReasoningRequest as a0, parseReasoningEffortEnv as a1, registerCustomProviders as a2, registerModelProvider as a3, resolveModelCapabilities as a4, resolveProvider as a5, resolveProviderModelDescriptors as a6, resolveReasoningEffort as a7, resolveReasoningEffortForModelSwitch as a8, resolveThinkingBudget as a9, resolveWireEffort as aa, validateCustomProviderConfig as ab, verifyProviderCredential as ac, 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-ByDcJc5g.d.ts → run-manager.d-DLK3ed-T.d.ts}

@@ -1,6 +1,6 @@
-import { j as KodaXMessage } from './types.d-Ci5YPFEh.js';
-import { Q as QueueEventListener, f as QueuedMessage, E as EnqueueInput, D as DequeueFilter } from './types.d-D4ZA8LJV.js';
-import { g as AgentMessage, aU as SessionEntry, aS as Session, aW as SessionExtension, aa as KodaXSessionLineage, a0 as KodaXJsonValue, q as CompactionDetails, P as KodaXCompactMemorySeed, a6 as KodaXSessionEntry, ah as KodaXSessionTreeNode, a9 as KodaXSessionLabelEntry, a8 as KodaXSessionGoalEntry, ad as KodaXSessionNavigationOptions, a2 as KodaXSessionArtifactLedgerEntry, y as FileOperations, bz as WorkflowMeta, bA as WorkflowModelHint, bB as WorkflowModule, bQ as WorkflowProcessTrackerOptions, bs as WorkflowEvent, bK as WorkflowProcessSnapshot, bF as WorkflowProcessEvent } from './process.d-DHow2y2G.js';
+import { j as KodaXMessage } from './types.d-Bp4Lm1jv.js';
+import { Q as QueueEventListener, f as QueuedMessage, E as EnqueueInput, D as DequeueFilter } from './types.d-CSZAMmU-.js';
+import { g as AgentMessage, aV as SessionEntry, aT as Session, aX as SessionExtension, ab as KodaXSessionLineage, a0 as KodaXJsonValue, q as CompactionDetails, P as KodaXCompactMemorySeed, a7 as KodaXSessionEntry, ai as KodaXSessionTreeNode, aa as KodaXSessionLabelEntry, a9 as KodaXSessionGoalEntry, a4 as KodaXSessionClientNoticeEntry, ae as KodaXSessionNavigationOptions, a2 as KodaXSessionArtifactLedgerEntry, y as FileOperations, bA as WorkflowMeta, bB as WorkflowModelHint, bC as WorkflowModule, bS as WorkflowProcessTrackerOptions, bt as WorkflowEvent, bM as WorkflowProcessSnapshot, bG as WorkflowProcessEvent } from './process.d-C93UMgPK.js';
 
 /**
  * @kodax-ai/agent Constants
@@ -568,7 +568,7 @@ declare function generateSessionId(): Promise<string>;
  */
 declare function extractTitleFromMessages(messages: KodaXMessage[]): string;
 
-type NavigableSessionEntry = Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry>;
+type NavigableSessionEntry = Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry | KodaXSessionClientNoticeEntry>;
 /**
  * Reconcile a linear message list against an existing lineage tree.
  *
@@ -846,7 +846,7 @@ declare function buildWorkflowCapsuleIntent(manifest: {
 
 type ManagedWorkflowStatus = 'running' | 'paused' | 'completed' | 'failed' | 'denied' | 'stopped';
 /** Provenance/display metadata for a run's process tracker. */
-type WorkflowProcessMetadata = Pick<WorkflowProcessTrackerOptions, 'displayName' | 'goal' | 'source' | 'savedWorkflowName' | 'sourceRunId' | 'sourceWorkflowName' | 'revisionOf' | 'hostMetadata'>;
+type WorkflowProcessMetadata = Pick<WorkflowProcessTrackerOptions, 'displayName' | 'goal' | 'source' | 'savedWorkflowName' | 'sourceRunId' | 'sourceWorkflowName' | 'revisionOf' | 'resumedFromRunId' | 'hostMetadata'>;
 interface ManagedWorkflowSnapshot {
     readonly runId: string;
     readonly workflow: string;