@kodax-ai/kodax 0.7.48 → 0.7.50

package/dist/types-chunks/{bash-prefix-extractor.d-DNO2-ycp.d.ts → bash-prefix-extractor.d-B0CIb0N3.d.ts}

@@ -1,10 +1,10 @@
 import { M as McpConnectMode, a as McpServerConfig, b as McpServersConfig, c as McpTransportKind } from './config.d-CJy1WENT.js';
-import { g as KodaXGoalState, s as KodaXSessionLineage, x as KodaXSessionScope, y as KodaXSessionStorage, i as KodaXJsonValue, k as KodaXSessionArtifactLedgerEntry, S as SessionErrorMetadata } from './types.d-B_MIIApc.js';
-import { X as KodaXTokenUsage, n as KodaXMessage, E as KodaXReasoningMode, k as KodaXHarnessProfile, S as KodaXTaskWorkIntent, I as KodaXReviewScale, O as KodaXTaskComplexity, a as KodaXAmaFanoutClass, Q as KodaXTaskRoutingDecision, R as KodaXTaskType, J as KodaXRiskLevel, i as KodaXExecutionMode, c as KodaXAmaProfile, d as KodaXAmaTactic, b as KodaXAmaFanoutPolicy } from './types.d-Cf-GCzac.js';
-import { f as AgentMessage, ay as StopHookFn, C as ChildTaskRegistry, s as CompactionUpdate, m as AskUserQuestionOptions, k as AskUserMultiOptions, y as Guardrail, v as DiscoveredInstance, aC as TaskAbortRegistry, ad as RunnerToolCall, aH as ToolGuardrail } from './types.d-BCnbYG_A.js';
+import { g as KodaXGoalState, s as KodaXSessionLineage, x as KodaXSessionScope, y as KodaXSessionStorage, i as KodaXJsonValue, k as KodaXSessionArtifactLedgerEntry, S as SessionErrorMetadata } from './types.d-BnjX2Gn4.js';
+import { X as KodaXTokenUsage, n as KodaXMessage, E as KodaXReasoningMode, k as KodaXHarnessProfile, S as KodaXTaskWorkIntent, I as KodaXReviewScale, O as KodaXTaskComplexity, a as KodaXAmaFanoutClass, Q as KodaXTaskRoutingDecision, R as KodaXTaskType, J as KodaXRiskLevel, i as KodaXExecutionMode, c as KodaXAmaProfile, d as KodaXAmaTactic, b as KodaXAmaFanoutPolicy } from './types.d-rPRl2LSB.js';
+import { f as AgentMessage, aE as StopHookFn, C as ChildTaskRegistry, a$ as WorkflowEventCorrelation, s as CompactionUpdate, bb as WorkflowProcessEvent, m as AskUserQuestionOptions, k as AskUserMultiOptions, B as Guardrail, b2 as WorkflowIsolation, w as DiscoveredInstance, aI as TaskAbortRegistry, aj as RunnerToolCall, aN as ToolGuardrail } from './process.d-BbiXD24v.js';
 import { Diagnostic, Position, Location, Hover, DocumentSymbol, SymbolInformation } from 'vscode-languageserver-protocol';
 import { C as CapabilityKind, b as CapabilityResult } from './capability.d-3C62G8Eq.js';
-import { K as KodaXBaseProvider } from './base.d-BdJKSPO2.js';
+import { K as KodaXBaseProvider } from './base.d-C4jYVjJh.js';
 import { a as CostTracker } from './cost-tracker.d-wRtyEW9d.js';
 
 /**
@@ -139,6 +139,23 @@ interface ChildProgressSnapshot {
      */
     readonly specialistName?: string;
 }
+/**
+ * Event variants the per-child events bridge feeds back to the
+ * snapshot. Kept as a discriminated union so future event kinds (e.g.,
+ * a real assistant-text chunk hook if the agent runtime grows one) can
+ * be added without breaking existing call sites.
+ */
+type ChildSnapshotEvent = {
+    readonly kind: 'iteration';
+    readonly iteration: number;
+    readonly maxIterations: number;
+} | {
+    readonly kind: 'tool-start';
+    readonly iteration: number;
+    readonly toolName: string;
+    readonly inputHint: string;
+    readonly startedAt: number;
+};
 
 /** Result of a cache lookup. */
 type ReadStateLookup = {
@@ -392,6 +409,32 @@ interface TodoStore {
     reset(): void;
 }
 
+type WorkflowInvocationSource = 'natural-language' | 'command';
+type WorkflowInvocationAction = 'none' | 'suggest' | 'auto-start';
+type WorkflowInvocationTrigger = 'explicit' | 'complexity' | 'negated' | 'none';
+type WorkflowStartOutcome = 'started' | 'declined' | 'cancelled' | 'failed';
+interface WorkflowHostPolicy {
+    readonly autoStart?: 'off' | 'confirm' | 'on';
+    readonly maxAgents?: number;
+    readonly maxConcurrency?: number;
+    readonly tokenBudget?: number;
+}
+interface WorkflowInvocationPolicyInput {
+    readonly agentMode: KodaXAgentMode;
+    readonly source: WorkflowInvocationSource;
+    readonly input: string;
+    readonly hostPolicy?: WorkflowHostPolicy;
+}
+interface WorkflowInvocationPolicyDecision {
+    readonly action: WorkflowInvocationAction;
+    readonly trigger: WorkflowInvocationTrigger;
+    readonly reason: string;
+}
+declare function decideWorkflowInvocation(input: WorkflowInvocationPolicyInput): WorkflowInvocationPolicyDecision;
+declare function workflowStartOutcomeConsumesTurn(input: {
+    readonly outcome: WorkflowStartOutcome;
+}): boolean;
+
 /**
  * FEATURE_132 — language-server registry + discovery (cascade step ①).
  *
@@ -1193,29 +1236,43 @@ interface KodaXRepoIntelligenceTraceEvent {
     trace?: KodaXRepoIntelligenceTrace;
 }
 
+interface KodaXWorkflowEventMeta {
+    readonly workflowCorrelation?: WorkflowEventCorrelation;
+}
+interface KodaXActivityEventMeta extends KodaXWorkflowEventMeta {
+    readonly childAgentId?: string;
+    readonly childAgentName?: string;
+    readonly parentToolId?: string;
+    readonly liveOnly?: boolean;
+}
+interface KodaXToolEventMeta extends KodaXActivityEventMeta {
+    readonly toolId?: string;
+}
 interface KodaXEvents {
-    onTextDelta?: (text: string) => void;
-    onThinkingDelta?: (text: string) => void;
-    onThinkingEnd?: (thinking: string) => void;
+    /** FEATURE_229: correlates child-agent SDK callbacks back to a workflow run/item. */
+    workflowCorrelation?: WorkflowEventCorrelation;
+    onTextDelta?: (text: string, meta?: KodaXActivityEventMeta) => void;
+    onThinkingDelta?: (text: string, meta?: KodaXActivityEventMeta) => void;
+    onThinkingEnd?: (thinking: string, meta?: KodaXActivityEventMeta) => void;
     onToolUseStart?: (tool: {
         name: string;
         id: string;
         input?: Record<string, unknown>;
-    }) => void;
+    }, meta?: KodaXToolEventMeta) => void;
     onToolResult?: (result: {
         id: string;
         name: string;
         content: string;
-    }) => void;
+    }, meta?: KodaXToolEventMeta) => void;
     /** FEATURE_067 v2: Real-time tool execution progress update. Updates the tool's display in the REPL transcript. */
     onToolProgress?: (update: {
         id: string;
         message: string;
-    }) => void;
-    onToolInputDelta?: (toolName: string, partialJson: string, meta?: {
-        toolId?: string;
-    }) => void;
-    onStreamEnd?: () => void;
+    }, meta?: KodaXToolEventMeta) => void;
+    onToolInputDelta?: (toolName: string, partialJson: string, meta?: KodaXToolEventMeta) => void;
+    onStreamEnd?: (meta?: KodaXActivityEventMeta) => void;
+    /** Fired once when a child-agent run fully leaves the child executor. */
+    onChildActivityEnd?: (meta?: KodaXActivityEventMeta) => void;
     onSessionStart?: (info: {
         provider: string;
         sessionId: string;
@@ -1320,6 +1377,8 @@ interface KodaXEvents {
     onComplete?: () => void;
     onError?: (error: Error) => void;
     onManagedTaskStatus?: (status: KodaXManagedTaskStatusEvent) => void;
+    /** FEATURE_229: workflow process snapshot stream for SDK/host panels. */
+    onWorkflowProcessEvent?: (event: WorkflowProcessEvent) => void;
     /**
      * Fired when Scout's managed-task completion is inferred but the harness
      * detected suspicious signals (mutation expected but none happened, budget
@@ -1356,18 +1415,16 @@ interface KodaXEvents {
         current: (() => string) | null;
     };
     /** Tool execution hook - called before tool execution, return false to block - 工具执行前回调 */
-    beforeToolExecute?: (tool: string, input: Record<string, unknown>, meta?: {
-        toolId?: string;
-    }) => Promise<boolean | string>;
+    beforeToolExecute?: (tool: string, input: Record<string, unknown>, meta?: KodaXToolEventMeta) => Promise<boolean | string>;
     /** Ask user a question interactively - Issue 069 - 交互式向用户提问 */
-    askUser?: (options: AskUserQuestionOptions) => Promise<string>;
+    askUser?: (options: AskUserQuestionOptions, meta?: KodaXToolEventMeta) => Promise<string>;
     /** Ask user multiple independent questions sequentially - 多问题顺序提问 */
-    askUserMulti?: (options: AskUserMultiOptions) => Promise<Record<string, string> | undefined>;
+    askUserMulti?: (options: AskUserMultiOptions, meta?: KodaXToolEventMeta) => Promise<Record<string, string> | undefined>;
     /** Ask user for free-text input - 自由文本输入 (Issue 112) */
     askUserInput?: (options: {
         question: string;
         default?: string;
-    }) => Promise<string | undefined>;
+    }, meta?: KodaXToolEventMeta) => Promise<string | undefined>;
     /**
      * FEATURE_074: Exit plan mode with user approval. Called by the `exit_plan_mode` tool.
      * Returns:
@@ -1409,6 +1466,8 @@ interface KodaXSessionOptions {
     resume?: boolean;
     autoResume?: boolean;
     scope?: KodaXSessionScope;
+    /** Consumer-owned private string persisted with the session. */
+    tag?: string;
     storage?: KodaXSessionStorage;
     initialMessages?: KodaXMessage[];
     /**
@@ -1561,6 +1620,11 @@ interface KodaXChildContextBundle {
      * lands separately.
      */
     modelHint?: KodaXChildModelHint;
+    /**
+     * FEATURE_217 (v0.7.49): workflow-level child isolation hint. Default is
+     * shared parent cwd; `worktree` is opt-in and parent-managed.
+     */
+    isolation?: WorkflowIsolation;
     /**
      * FEATURE_191 — optional registered specialist agent name. When set,
      * the child is dispatched with that agent's `instructions` /
@@ -1602,8 +1666,19 @@ interface KodaXChildAgentResult {
     contradictions: string[];
     artifactPaths?: string[];
     sessionId?: string;
+    /** Bounded workflow transcript digest. Full `summary` remains the synthesis/audit source. */
+    digest?: string;
+    /** True when a workflow child digest was attempted but failed (error/timeout/empty distillation). */
+    digestFailed?: boolean;
+    /** True when a workflow child digest is running asynchronously and may arrive later. */
+    digestPending?: boolean;
+    /** Actual provider/model selected for this child run, when known. */
+    provider?: string;
+    model?: string;
     /** Actual iterations consumed by this child agent. */
     actualIterations?: number;
+    /** Best-known token usage for this child run. Used by workflow budget accounting. */
+    totalTokensUsed?: number;
     /**
      * True when the child's `runKodaX` exited via CAP-083 AbortError silent
      * terminal (`KodaXResult.interrupted === true`). Surfaces the
@@ -1674,7 +1749,7 @@ interface KodaXFanoutSchedulerPlan {
     cancellationPolicy: 'none' | 'winner-cancel' | 'budget-cancel';
     reason: string;
 }
-type KodaXAgentMode = 'ama' | 'sa';
+type KodaXAgentMode = 'ama' | 'sa' | 'amaw';
 type KodaXMemoryStrategy = 'continuous' | 'compact' | 'reset-handoff';
 type KodaXBudgetDisclosureZone = 'green' | 'yellow' | 'orange' | 'red';
 interface KodaXManagedTaskHarnessTransition {
@@ -1963,6 +2038,23 @@ interface KodaXSelfManualConfig {
     readonly productName?: string;
     readonly topics?: readonly KodaXManualTopicInput[];
 }
+/**
+ * SDK-consumer auto-compaction override. When a field is provided it wins
+ * over both the adaptive default and `~/.kodax/config.json`. Lets an
+ * embedder that calls `runManagedTask` in-process pin the context window /
+ * trigger for a model the built-in capability table doesn't cover (or that
+ * it resolves through a custom provider), or disable auto-compaction for a
+ * run — without writing to the user's home-dir config file. Omitted fields
+ * fall through to the normal resolution cascade.
+ */
+interface KodaXCompactionOverride {
+    /** Override the resolved provider context window, in tokens. */
+    contextWindow?: number;
+    /** Override the auto-compaction trigger percentage (0-100). */
+    triggerPercent?: number;
+    /** Set false to disable automatic compaction for this run. */
+    enabled?: boolean;
+}
 interface KodaXOptions {
     provider: string;
     model?: string;
@@ -1975,6 +2067,8 @@ interface KodaXOptions {
     context?: KodaXContextOptions;
     events?: KodaXEvents;
     extensionRuntime?: ExtensionRuntimeContract;
+    /** FEATURE_229: host-owned policy for workflow auto-start and ceilings. */
+    workflowHostPolicy?: WorkflowHostPolicy;
     /** FEATURE_221: SDK-consumer self-manual injection (product name + topics). */
     selfManual?: KodaXSelfManualConfig;
     /**
@@ -1999,6 +2093,11 @@ interface KodaXOptions {
      * SDK callers can also instantiate one via {@link createSessionControl}.
      */
     sessionControl?: KodaXSessionControl;
+    /**
+     * SDK-consumer auto-compaction override. Wins over the adaptive default
+     * and `~/.kodax/config.json`. See {@link KodaXCompactionOverride}.
+     */
+    compaction?: KodaXCompactionOverride;
 }
 /**
  * Low-level mutators handed to a `KodaXSessionControl` by the substrate.
@@ -2222,6 +2321,8 @@ interface KodaXResult {
     managedTask?: KodaXManagedTask;
     /** Best-known token snapshot after the round completes. */
     contextTokenSnapshot?: KodaXContextTokenSnapshot;
+    /** Latest provider usage when the caller has it directly. */
+    usage?: KodaXTokenUsage;
     /**
      * FEATURE_076: artifact ledger pre-extracted before round-boundary reshape.
      * Populated when the reshape replaces `messages` with a clean {user, assistant}
@@ -2248,6 +2349,13 @@ interface KodaXToolExecutionContext {
     selfManual?: KodaXSelfManualConfig;
     /** Working directory used to resolve relative paths and execute shell commands. */
     executionCwd?: string;
+    /**
+     * FEATURE_217 (v0.7.49): parent dir for `isolation:'worktree'` workflow child
+     * worktrees. Workflow runs point this at `<runDir>/worktrees` so worktrees are
+     * reclaimable (Layer 2/3 sweep) and never pollute the user's project tree.
+     * Absent on non-workflow paths → worktrees fall back to the git root's parent.
+     */
+    workflowWorktreeBaseDir?: string;
     /** Shared extension capability runtime used by retrieval-family tools. */
     extensionRuntime?: ExtensionRuntimeContract;
     /** Ask user a question interactively (select mode) - 交互式向用户提问 (Issue 069) */
@@ -2295,6 +2403,12 @@ interface KodaXToolExecutionContext {
         readonly model?: string;
         readonly reasoningMode?: KodaXReasoningMode;
     };
+    /**
+     * Parent SDK/REPL callback surface available to child-dispatch tools.
+     * `dispatch_child_task` uses this to preserve live child telemetry without
+     * copying every callback onto KodaXToolExecutionContext as a separate field.
+     */
+    parentEvents?: KodaXEvents;
     /**
      * FEATURE_123 v0.7.44 — agentId of the agent whose tool call this
      * context backs. `undefined` for the top-level Worker (main runtime
@@ -3173,5 +3287,5 @@ interface CreateBashPrefixExtractorOptions {
  */
 declare function createBashPrefixExtractor(opts: CreateBashPrefixExtractorOptions): BashPrefixExtractor;
 
-export { BASH_POLICY_SPEC as B, CONSECUTIVE_THRESHOLD as C, ERROR_THRESHOLD as E, LSP_SERVERS as aB, LspService as aF, WINDOW_MS as b1, buildGoalRuntimeBinding as b2, collectAllSignals as b3, computeRulesFingerprint as b4, createAutoModeToolGuardrail as b5, createBashPrefixExtractor as b6, createCircuitBreaker as b7, createDenialTracker as b8, extractCommandPrefix as b9, formatAgentsForPrompt as ba, getDefaultLspService as bb, getKodaxGlobalDir as bc, loadAgentsFiles as bd, loadAutoRules as be, makeDisabledGoalToolsContext as bf, parseAutoRules as bg, readTrustState as bh, recordAllow as bi, recordBlock as bj, recordError as bk, shouldFallback$1 as bl, shouldFallback as bm, shutdownDefaultLspService as bn, trustProjectRules as bo, withGoalBeforeNextTurn as bp, withGoalStopHook as bq, CUMULATIVE_THRESHOLD as k };
-export type { KodaXMcpTransport as $, AgentsFile as A, DenialTracker as D, FailureStage as F, GoalBlockedResult as G, KodaXContextOptions as H, KodaXContextTokenSnapshot as I, KodaXEvents as J, KodaXAgentMode as K, KodaXFanoutBranchLifecycle as L, KodaXFanoutBranchRecord as M, KodaXFanoutBranchTransition as N, KodaXFanoutSchedulerInput as O, KodaXFanoutSchedulerPlan as P, KodaXInputArtifact as Q, KodaXManagedBudgetSnapshot as R, KodaXManagedProtocolPayload as S, KodaXManagedTask as T, KodaXManagedTaskRuntimeState as U, KodaXManagedTaskStatusEvent as V, KodaXManualTopicId as W, KodaXManualTopicInput as X, KodaXMcpConnectMode as Y, KodaXMcpServerConfig as Z, KodaXMcpServersConfig as _, AutoModeAskUser as a, ToolCallSignal as a$, KodaXMemoryStrategy as a0, KodaXOptions as a1, KodaXOrchestrationVerdict as a2, KodaXParentReductionContract as a3, KodaXProviderPolicyHints as a4, KodaXRepoIntelligenceCapability as a5, KodaXRepoIntelligenceMode as a6, KodaXRepoIntelligenceResolvedMode as a7, KodaXRepoIntelligenceTrace as a8, KodaXRepoIntelligenceTraceEvent as a9, KodaXVerificationScorecardCriterion as aA, LoadAgentsOptions as aC, LoadedRulesSource as aD, LspServerInfo as aE, LspServiceConfig as aG, ProviderExecutionState as aH, ProviderRecoveryEvent as aI, ProviderResilienceConfig as aJ, ProviderResiliencePolicy as aK, RecoveryAction as aL, RecoveryDecision as aM, RecoveryLadderStep as aN, RecoveryResult as aO, ResilienceClassification as aP, ResilienceErrorClass as aQ, ResolveKodaXManualInput as aR, ResolveKodaXManualOptions as aS, ResolveKodaXManualResult as aT, RulesLoadError as aU, RulesLoadResult as aV, SignalCollector as aW, SkippedRulesSource as aX, TodoItem as aY, TodoList as aZ, TodoStatus as a_, KodaXRepoRoutingSignals as aa, KodaXResult as ab, KodaXRoleRoundSummary as ac, KodaXRuntimeVerificationContract as ad, KodaXSelfManualConfig as ae, KodaXSessionControl as af, KodaXSessionMutators as ag, KodaXSessionOptions as ah, KodaXSkillInvocationContext as ai, KodaXSkillMap as aj, KodaXSkillProjectionConfidence as ak, KodaXTaskCapabilityHint as al, KodaXTaskContract as am, KodaXTaskEvidenceArtifact as an, KodaXTaskEvidenceBundle as ao, KodaXTaskEvidenceEntry as ap, KodaXTaskRole as aq, KodaXTaskRoleAssignment as ar, KodaXTaskStatus as as, KodaXTaskSurface as at, KodaXTaskToolPolicy as au, KodaXTaskVerificationContract as av, KodaXTaskVerificationCriterion as aw, KodaXTaskWorkItem as ax, KodaXToolExecutionContext as ay, KodaXVerificationScorecard as az, AutoModeAskUserVerdict as b, TrustState as b0, AutoModeEngine as c, AutoModeGuardrailConfig as d, AutoModeSharedState as e, AutoModeStats as f, AutoModeToolGuardrail as g, AutoRules as h, BashPrefixExtractor as i, BashPrefixResult as j, CircuitBreaker as l, CreateBashPrefixExtractorOptions as m, DiagnosticsRequest as n, ExtensionRuntimeContract as o, ExtractCommandPrefixOptions as p, GoalCompleteResult as q, GoalCreateInput as r, GoalLifecycleContext as s, GoalRuntimeBinding as t, GoalRuntimeBindingDeps as u, GoalToolsContext as v, KodaXBudgetDisclosureZone as w, KodaXBudgetExtensionRequest as x, KodaXChildAgentResult as y, KodaXChildContextBundle as z };
+export { BASH_POLICY_SPEC as B, CONSECUTIVE_THRESHOLD as C, ERROR_THRESHOLD as E, LSP_SERVERS as aH, LspService as aL, WINDOW_MS as b7, shouldFallback as bA, shutdownDefaultLspService as bB, trustProjectRules as bC, withGoalBeforeNextTurn as bD, withGoalStopHook as bE, workflowStartOutcomeConsumesTurn as bF, buildGoalRuntimeBinding as bf, collectAllSignals as bg, computeRulesFingerprint as bh, createAutoModeToolGuardrail as bi, createBashPrefixExtractor as bj, createCircuitBreaker as bk, createDenialTracker as bl, decideWorkflowInvocation as bm, extractCommandPrefix as bn, formatAgentsForPrompt as bo, getDefaultLspService as bp, getKodaxGlobalDir as bq, loadAgentsFiles as br, loadAutoRules as bs, makeDisabledGoalToolsContext as bt, parseAutoRules as bu, readTrustState as bv, recordAllow as bw, recordBlock as bx, recordError as by, shouldFallback$1 as bz, CUMULATIVE_THRESHOLD as k };
+export type { KodaXManualTopicInput as $, AgentsFile as A, DenialTracker as D, FailureStage as F, GoalBlockedResult as G, KodaXChildAgentResult as H, KodaXChildContextBundle as I, KodaXChildExecutionResult as J, KodaXActivityEventMeta as K, KodaXCompactionOverride as L, KodaXContextOptions as M, KodaXContextTokenSnapshot as N, KodaXEvents as O, KodaXFanoutBranchLifecycle as P, KodaXFanoutBranchRecord as Q, KodaXFanoutBranchTransition as R, KodaXFanoutSchedulerInput as S, KodaXFanoutSchedulerPlan as T, KodaXInputArtifact as U, KodaXManagedBudgetSnapshot as V, KodaXManagedProtocolPayload as W, KodaXManagedTask as X, KodaXManagedTaskRuntimeState as Y, KodaXManagedTaskStatusEvent as Z, KodaXManualTopicId as _, AutoModeAskUser as a, RulesLoadResult as a$, KodaXMcpConnectMode as a0, KodaXMcpServerConfig as a1, KodaXMcpServersConfig as a2, KodaXMcpTransport as a3, KodaXMemoryStrategy as a4, KodaXOptions as a5, KodaXOrchestrationVerdict as a6, KodaXParentReductionContract as a7, KodaXProviderPolicyHints as a8, KodaXRepoIntelligenceCapability as a9, KodaXTaskVerificationCriterion as aA, KodaXTaskWorkItem as aB, KodaXToolEventMeta as aC, KodaXToolExecutionContext as aD, KodaXVerificationScorecard as aE, KodaXVerificationScorecardCriterion as aF, KodaXWorkflowEventMeta as aG, LoadAgentsOptions as aI, LoadedRulesSource as aJ, LspServerInfo as aK, LspServiceConfig as aM, ProviderExecutionState as aN, ProviderRecoveryEvent as aO, ProviderResilienceConfig as aP, ProviderResiliencePolicy as aQ, RecoveryAction as aR, RecoveryDecision as aS, RecoveryLadderStep as aT, RecoveryResult as aU, ResilienceClassification as aV, ResilienceErrorClass as aW, ResolveKodaXManualInput as aX, ResolveKodaXManualOptions as aY, ResolveKodaXManualResult as aZ, RulesLoadError as a_, KodaXRepoIntelligenceMode as aa, KodaXRepoIntelligenceResolvedMode as ab, KodaXRepoIntelligenceTrace as ac, KodaXRepoIntelligenceTraceEvent as ad, KodaXRepoRoutingSignals as ae, KodaXResult as af, KodaXRoleRoundSummary as ag, KodaXRuntimeVerificationContract as ah, KodaXSelfManualConfig as ai, KodaXSessionControl as aj, KodaXSessionMutators as ak, KodaXSessionOptions as al, KodaXSkillInvocationContext as am, KodaXSkillMap as an, KodaXSkillProjectionConfidence as ao, KodaXTaskCapabilityHint as ap, KodaXTaskContract as aq, KodaXTaskEvidenceArtifact as ar, KodaXTaskEvidenceBundle as as, KodaXTaskEvidenceEntry as at, KodaXTaskRole as au, KodaXTaskRoleAssignment as av, KodaXTaskStatus as aw, KodaXTaskSurface as ax, KodaXTaskToolPolicy as ay, KodaXTaskVerificationContract as az, AutoModeAskUserVerdict as b, SignalCollector as b0, SkippedRulesSource as b1, TodoItem as b2, TodoList as b3, TodoStatus as b4, ToolCallSignal as b5, TrustState as b6, WorkflowHostPolicy as b8, WorkflowInvocationAction as b9, WorkflowInvocationPolicyDecision as ba, WorkflowInvocationPolicyInput as bb, WorkflowInvocationSource as bc, WorkflowInvocationTrigger as bd, WorkflowStartOutcome as be, AutoModeEngine as c, AutoModeGuardrailConfig as d, AutoModeSharedState as e, AutoModeStats as f, AutoModeToolGuardrail as g, AutoRules as h, BashPrefixExtractor as i, BashPrefixResult as j, ChildSnapshotEvent as l, CircuitBreaker as m, CreateBashPrefixExtractorOptions as n, DiagnosticsRequest as o, ExtensionRuntimeContract as p, ExtractCommandPrefixOptions as q, GoalCompleteResult as r, GoalCreateInput as s, GoalLifecycleContext as t, GoalRuntimeBinding as u, GoalRuntimeBindingDeps as v, GoalToolsContext as w, KodaXAgentMode as x, KodaXBudgetDisclosureZone as y, KodaXBudgetExtensionRequest as z };

package/dist/types-chunks/{file-tracker.d-D7L_SbRm.d.ts → capsule.d-CwBEm6M-.d.ts}

@@ -1,6 +1,6 @@
-import { n as KodaXMessage } from './types.d-Cf-GCzac.js';
-import { f as AgentMessage, aj as SessionEntry, ah as Session, ak as SessionExtension, p as CompactionDetails, x as FileOperations } from './types.d-BCnbYG_A.js';
-import { s as KodaXSessionLineage, i as KodaXJsonValue, a as KodaXCompactMemorySeed, o as KodaXSessionEntry, z as KodaXSessionTreeNode, r as KodaXSessionLabelEntry, q as KodaXSessionGoalEntry, v as KodaXSessionNavigationOptions, k as KodaXSessionArtifactLedgerEntry } from './types.d-B_MIIApc.js';
+import { n as KodaXMessage } from './types.d-rPRl2LSB.js';
+import { f as AgentMessage, ap as SessionEntry, an as Session, a3 as QueueEventListener, a4 as QueuedMessage, E as EnqueueInput, v as DequeueFilter, aq as SessionExtension, p as CompactionDetails, z as FileOperations, b5 as WorkflowMeta, b6 as WorkflowModelHint, b7 as WorkflowModule } from './process.d-BbiXD24v.js';
+import { s as KodaXSessionLineage, i as KodaXJsonValue, a as KodaXCompactMemorySeed, o as KodaXSessionEntry, z as KodaXSessionTreeNode, r as KodaXSessionLabelEntry, q as KodaXSessionGoalEntry, v as KodaXSessionNavigationOptions, k as KodaXSessionArtifactLedgerEntry } from './types.d-BnjX2Gn4.js';
 
 /**
  * @kodax-ai/agent Constants
@@ -271,6 +271,98 @@ declare function getAgentConfigPath(...segments: string[]): string;
  */
 declare function getAppDataDir(appId: string): string;
 
+/**
+ * @kodax-ai/agent/messaging/queue — 2-tier agentId-scoped FIFO message queue.
+ *
+ * FEATURE_115 (v0.7.36).
+ *
+ * Invariants:
+ *   - In-priority FIFO: messages of the same priority drain in enqueue order.
+ *   - Cross-priority precedence: 'user' drains before 'background', regardless
+ *     of enqueue order.
+ *   - agentId routing: messages addressed to agentId X are only visible to
+ *     consumers filtering for that exact agentId. undefined ≠ "any agent" —
+ *     it specifically matches main-thread messages.
+ *   - Not persistent: process restart loses queue state, by design (matches
+ *     TodoStore semantics).
+ *
+ * The queue is process-global by default (`getMessageQueue()`); the class is
+ * also exported for tests / isolated downstream use.
+ */
+
+declare class MessageQueue {
+    private messages;
+    private nextSeq;
+    /**
+     * FEATURE_159 (v0.7.40) — observable subscription set. Same pattern as
+     * Claude Code's `messageQueueManager.ts` `createSignal()` substrate,
+     * but the listener carries a structured `QueueEvent` so SDK
+     * observability consumers (logger, tracer, metrics) can react per-
+     * event without re-diffing snapshots. `useSyncExternalStore` consumers
+     * still work — they ignore the event argument.
+     *
+     * Cached `snapshotRef` keeps reference identity stable across reads
+     * when nothing changed — required by React 18's `useSyncExternalStore`
+     * to avoid render loops.
+     */
+    private listeners;
+    private snapshotRef;
+    private notify;
+    /**
+     * Subscribe to queue mutations. Compatible with React 18's
+     * `useSyncExternalStore(subscribe, getSnapshot)` — the hook passes a
+     * `() => void` callback, which is structurally assignable to the
+     * `QueueEventListener` parameter because TypeScript treats
+     * callback parameter discards as compatible. SDK consumers that
+     * declare a typed `(event: QueueEvent) => void` listener see the
+     * structured event.
+     *
+     * Listener is called synchronously after every mutation; returns an
+     * unsubscribe function.
+     */
+    subscribe: (listener: QueueEventListener) => (() => void);
+    /**
+     * Returns the current frozen queue snapshot. Reference identity is
+     * stable across reads when the queue has not mutated, which is the
+     * contract React's `useSyncExternalStore` relies on.
+     */
+    getSnapshot: () => readonly QueuedMessage[];
+    /** Returns the assigned id of the enqueued message. */
+    enqueue(input: EnqueueInput): string;
+    /**
+     * Drain matching messages, ordered by priority (user > background) then
+     * FIFO within each priority. Removes drained messages from the queue.
+     */
+    dequeue(filter: DequeueFilter): QueuedMessage[];
+    /**
+     * Peek at matching messages without removing them. Returns messages in
+     * the same priority + FIFO order that `dequeue(filter)` would return,
+     * so callers can inspect what the next drain would yield.
+     */
+    peek(filter: DequeueFilter): QueuedMessage[];
+    /** Total queue size across all priorities / agents. */
+    size(): number;
+    /** Count of messages matching the filter. */
+    count(filter: DequeueFilter): number;
+    /** True iff at least one message matches the filter. */
+    has(filter: DequeueFilter): boolean;
+    /** Remove all queued messages — used in tests / process abort scenarios. */
+    clear(): void;
+}
+/**
+ * Returns the process-global MessageQueue singleton, creating it lazily on
+ * first call. Use this for production wiring; instantiate `MessageQueue`
+ * directly in tests / isolated subsystems where a shared instance would
+ * cause cross-test pollution.
+ */
+declare function getMessageQueue(): MessageQueue;
+/**
+ * Test-only reset hook. Production code MUST NOT call this. Underscored
+ * prefix follows the same convention as `_resetInvariantRegistry` /
+ * `_resetAdmittedAgentBindings` / `_resetAdmissionMetrics`.
+ */
+declare function _resetMessageQueueForTests(): void;
+
 /**
  * History cleanup middleware — CAP-002
  *
@@ -636,5 +728,81 @@ declare function mergeFileOps(ops1: FileOperations, ops2: FileOperations): FileO
 declare function extractArtifactLedger(messages: KodaXMessage[]): KodaXSessionArtifactLedgerEntry[];
 declare function mergeArtifactLedger(existing: KodaXSessionArtifactLedgerEntry[], next: KodaXSessionArtifactLedgerEntry[]): KodaXSessionArtifactLedgerEntry[];
 
-export { countActiveLineageMessages as A, countTokens as B, DefaultSummaryCompaction as D, createSessionLineage as E, estimateTokens as F, extractArtifactLedger as G, extractFileOps as H, extractTitleFromMessages as I, findPreviousUserEntryId as J, KODAX_API_MIN_INTERVAL as K, LINEAGE_ENTRY_TYPES as L, forkSessionLineage as M, generateSessionId as N, getAgentConfigHome as O, PROMISE_PATTERN as P, getAgentConfigPath as Q, getAppDataDir as R, getSessionLineagePath as S, getSessionMessagesFromLineage as T, mergeArtifactLedger as U, mergeFileOps as V, resolveSessionLineageTarget as W, rewindSessionLineage as X, setAgentConfigHome as Y, setSessionLineageActiveEntry as Z, validateAndFixToolHistory as _, KODAX_DEFAULT_TIMEOUT as e, KODAX_HARD_TIMEOUT as f, KODAX_MAX_INCOMPLETE_RETRIES as g, KODAX_MAX_MAXTOKENS_RETRIES as h, KODAX_MAX_RETRIES as i, KODAX_MAX_TOKENS as j, KODAX_RETRY_BASE_DELAY as k, KODAX_STAGGER_DELAY as l, LineageCompaction as n, LineageExtension as q, appendSessionLineageLabel as u, applyLineageTruncation as v, applySessionCompaction as w, archiveOldIslands as x, buildSessionTree as y, cleanupIncompleteToolCalls as z };
-export type { CompactionContext as C, CompactionEntry as a, CompactionEntryPayload as b, CompactionPolicy as c, DefaultSummaryCompactionOptions as d, LineageArtifactLedgerPayload as m, LineageCompactionDelegates as o, LineageEntryType as p, LineageLabelPayload as r, LineageTreeNode as s, PolicyCompactionResult as t };
+declare const WORKFLOW_PATTERN_IDS: readonly ["classify-and-act", "fan-out-and-synthesize", "adversarial-verification", "generate-and-filter", "tournament", "loop-until-done"];
+type WorkflowPatternId = (typeof WORKFLOW_PATTERN_IDS)[number];
+interface WorkflowScriptManifest extends WorkflowMeta {
+    readonly phases: readonly string[];
+    readonly readOnly: boolean;
+    readonly plannedAgents?: number;
+    readonly maxAgents: number;
+    readonly maxConcurrency: number;
+    readonly tokenBudget?: number;
+    readonly mayUseWorktree?: boolean;
+    readonly patterns: readonly WorkflowPatternId[];
+}
+declare function validateWorkflowScriptManifest(value: unknown): WorkflowScriptManifest;
+
+/**
+ * FEATURE_217 (v0.7.49) Phase M — reusable generated workflow capsule.
+ *
+ * Agent owns only the domain-neutral capsule contract. Persistence,
+ * environment preflight, skills, MCP, and REPL UX live in higher layers.
+ */
+
+declare const WORKFLOW_CAPSULE_FORMAT: "kodax.workflow";
+declare const WORKFLOW_CAPSULE_VERSION: 1;
+declare const WORKFLOW_CAPSULE_API_VERSION: 1;
+type WorkflowCapsuleEnvironmentRequirement = 'git-repo' | 'worktree-capable';
+interface WorkflowCapsuleIntent {
+    readonly taskClass: string;
+    readonly originalRequest?: string;
+    readonly reusableFor?: readonly string[];
+    readonly notFor?: readonly string[];
+}
+interface WorkflowCapsuleInputs {
+    readonly description: string;
+    readonly examples?: readonly unknown[];
+}
+interface WorkflowCapsuleRequirements {
+    readonly environment?: readonly WorkflowCapsuleEnvironmentRequirement[];
+    readonly tools?: readonly string[];
+    readonly mcp?: readonly string[];
+    readonly skills?: readonly string[];
+    readonly modelTiers?: readonly WorkflowModelHint[];
+    readonly userInteraction?: boolean;
+}
+interface WorkflowCapsuleProvenance {
+    readonly fromRunId?: string;
+    readonly fromWorkflowName?: string;
+    readonly revisionOf?: string;
+    readonly replacesWorkflowName?: string;
+    readonly createdAt: string;
+    readonly kodaxVersion: string;
+}
+interface WorkflowCapsule {
+    readonly format: typeof WORKFLOW_CAPSULE_FORMAT;
+    readonly version: typeof WORKFLOW_CAPSULE_VERSION;
+    readonly workflowApiVersion: typeof WORKFLOW_CAPSULE_API_VERSION;
+    readonly minKodaxVersion: string;
+    readonly manifest: WorkflowScriptManifest;
+    readonly source: string;
+    readonly intent?: WorkflowCapsuleIntent;
+    readonly inputs?: WorkflowCapsuleInputs;
+    readonly requires?: WorkflowCapsuleRequirements;
+    readonly provenance?: WorkflowCapsuleProvenance;
+}
+interface CreateWorkflowCapsuleInput {
+    readonly minKodaxVersion: string;
+    readonly manifest: WorkflowScriptManifest;
+    readonly source: string;
+    readonly intent?: WorkflowCapsuleIntent;
+    readonly inputs?: WorkflowCapsuleInputs;
+    readonly requires?: WorkflowCapsuleRequirements;
+    readonly provenance?: WorkflowCapsuleProvenance;
+}
+declare function validateWorkflowCapsule(value: unknown): WorkflowCapsule;
+declare function createWorkflowCapsule(input: CreateWorkflowCapsuleInput): WorkflowCapsule;
+declare function createWorkflowModuleFromCapsule(capsule: WorkflowCapsule): WorkflowModule;
+
+export { extractFileOps as $, DefaultSummaryCompaction as D, appendSessionLineageLabel as I, applyLineageTruncation as J, KODAX_API_MIN_INTERVAL as K, LINEAGE_ENTRY_TYPES as L, MessageQueue as M, applySessionCompaction as N, archiveOldIslands as O, PROMISE_PATTERN as P, buildSessionTree as Q, cleanupIncompleteToolCalls as R, countActiveLineageMessages as S, countTokens as T, createSessionLineage as U, createWorkflowCapsule as V, WORKFLOW_CAPSULE_API_VERSION as W, createWorkflowModuleFromCapsule as X, estimateTokens as Y, extractArtifactLedger as Z, _resetMessageQueueForTests as _, extractTitleFromMessages as a0, findPreviousUserEntryId as a1, forkSessionLineage as a2, generateSessionId as a3, getAgentConfigHome as a4, getAgentConfigPath as a5, getAppDataDir as a6, getMessageQueue as a7, getSessionLineagePath as a8, getSessionMessagesFromLineage as a9, mergeArtifactLedger as aa, mergeFileOps as ab, resolveSessionLineageTarget as ac, rewindSessionLineage as ad, setAgentConfigHome as ae, setSessionLineageActiveEntry as af, validateAndFixToolHistory as ag, validateWorkflowCapsule as ah, validateWorkflowScriptManifest as ai, KODAX_DEFAULT_TIMEOUT as f, KODAX_HARD_TIMEOUT as g, KODAX_MAX_INCOMPLETE_RETRIES as h, KODAX_MAX_MAXTOKENS_RETRIES as i, KODAX_MAX_RETRIES as j, KODAX_MAX_TOKENS as k, KODAX_RETRY_BASE_DELAY as l, KODAX_STAGGER_DELAY as m, LineageCompaction as o, LineageExtension as r, WORKFLOW_CAPSULE_FORMAT as v, WORKFLOW_CAPSULE_VERSION as w, WORKFLOW_PATTERN_IDS as x };
+export type { WorkflowCapsuleInputs as A, WorkflowCapsuleIntent as B, CompactionContext as C, WorkflowCapsuleProvenance as E, WorkflowCapsuleRequirements as F, WorkflowPatternId as G, WorkflowScriptManifest as H, CompactionEntry as a, CompactionEntryPayload as b, CompactionPolicy as c, CreateWorkflowCapsuleInput as d, DefaultSummaryCompactionOptions as e, LineageArtifactLedgerPayload as n, LineageCompactionDelegates as p, LineageEntryType as q, LineageLabelPayload as s, LineageTreeNode as t, PolicyCompactionResult as u, WorkflowCapsule as y, WorkflowCapsuleEnvironmentRequirement as z };