@kodax-ai/kodax 0.7.63 → 0.7.67

package/dist/types-chunks/{process.d-CY2g03Mb.d.ts → types.d-DG9B4SMm.d.ts}

@@ -2930,6 +2930,8 @@ interface WorkflowTaskVerification {
     readonly enforcement?: 'hard' | 'warn';
     readonly requiresMutation?: boolean;
     readonly requiredChangedPaths?: readonly string[];
+    /** Read-tool paths that must be observed before accepting a review verdict. */
+    readonly requiredReadPaths?: readonly string[];
     readonly minFinalTextChars?: number;
     readonly rejectPreparatoryFinalText?: boolean;
 }
@@ -2940,6 +2942,11 @@ interface WorkflowTaskVerificationResult {
     readonly changedPaths?: readonly string[];
     readonly mutationToolCalls?: readonly string[];
     readonly mutationEvidence?: boolean;
+    readonly readPaths?: readonly string[];
+}
+interface WorkflowAgentTarget {
+    readonly agentId: string;
+    readonly expectedConfigurationRevision?: string;
 }
 interface WorkflowSpawnAgentInput {
     /** Human-readable label for the agent — surfaces in events / UI. */
@@ -2954,18 +2961,24 @@ interface WorkflowSpawnAgentInput {
     readonly phase?: string;
     /** The task prompt handed to the child agent. */
     readonly prompt: string;
+    /** Compact scope summary copied into the child briefing without retyping the diff. */
+    readonly scopeSummary?: string;
+    /** Binding constraints/interfaces the child cannot discover locally. */
+    readonly constraints?: readonly string[];
     /** When true, the child runs with a read-only tool whitelist. */
     readonly readOnly?: boolean;
     /** Route to a registered specialist agent (FEATURE_191). */
     readonly subagentType?: string;
+    /** Route through the shared dispatchable-agent catalog (FEATURE_258). */
+    readonly target?: WorkflowAgentTarget;
     /**
      * Per-agent model TIER (FEATURE_120 model_hint). The script expresses semantic
      * intent — 'fast' (cheap), 'deep' (strong), 'balanced' (default) — NOT a
      * concrete model name: the authoring model has no cognition of which
      * providers/models a given operator has configured. The operator maps the
      * tiers to concrete models via env (KODAX_FAST/DEEP_PROVIDER/MODEL); when a
-     * tier is unconfigured the child inherits the parent provider/model, so a
-     * hint is always a safe no-op at worst. 'fast' applies to read-only children
+     * tier is unconfigured the child inherits the parent provider/model. 'fast'
+     * applies to read-only children
      * only (write/codegen stays on the parent tier — a quality guard).
      */
     readonly modelHint?: WorkflowModelHint;
@@ -2989,6 +3002,8 @@ interface WorkflowSpawnAgentInput {
      * opaque value so the agent layer needs no JSON-Schema dependency.
      */
     readonly outputSchema?: unknown;
+    /** Register concise finalText for digest reuse; trusted host provenance is checked separately. */
+    readonly terseResult?: boolean;
 }
 /** Returned by `spawnAgent` — the child is in-flight, not yet complete. */
 interface WorkflowTaskHandle {
@@ -2999,6 +3014,7 @@ interface WorkflowTaskUsage {
     readonly inputTokens?: number;
     readonly outputTokens?: number;
     readonly totalTokens?: number;
+    readonly cacheReadTokens?: number;
 }
 type WorkflowTaskSummaryKind = 'digest' | 'excerpt' | 'digest-failed' | 'pending';
 interface WorkflowTaskSummaryEventUpdate {
@@ -3029,6 +3045,20 @@ interface WorkflowTaskResult {
     /** Best-known provider/model used by the child, for host correlation only. */
     readonly provider?: string;
     readonly model?: string;
+    /** Requested semantic tier and how the local runtime resolved it. */
+    readonly requestedTier?: WorkflowModelHint | 'inherited';
+    readonly tierOutcome?: 'applied' | 'balanced-parent' | 'fast-write-ineligible' | 'unconfigured' | 'shadowed-by-selector' | 'inherited';
+    readonly providerSource?: 'explicit' | 'specialist' | 'tier' | 'parent' | 'default';
+    readonly modelSource?: 'explicit' | 'specialist' | 'tier' | 'parent';
+    readonly initialProvider?: string;
+    readonly initialModel?: string;
+    readonly finalProvider?: string;
+    readonly finalModel?: string;
+    readonly fallbackReason?: string;
+    readonly resolvedEffort?: string;
+    readonly iterations?: number;
+    readonly durationMs?: number;
+    readonly digestUsage?: WorkflowTaskUsage;
     readonly usage?: WorkflowTaskUsage;
 }
 /** Point-in-time snapshot of a (possibly still-running) agent. */
@@ -3358,5 +3388,340 @@ 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 R, ASK_USER_CUSTOM_INPUT_SIGNAL as a, MAX_TOOL_LOOP_ITERATIONS as ay, SpanImpl as bF, Tracer as bX, Runner as bm, executeRunnerToolCall as c$, WorkflowEventRecorder as c6, _resetAdmittedAgentBindings as cL, _resetPresetDispatchers as cM, asSingleSelection as cN, buildAssistantMessageFromLlmResult as cO, buildSystemPrompt as cP, buildToolResultMessage as cQ, createAgent as cR, createHandoff as cS, createInMemorySession as cT, createInvariantSessionForAgent as cU, createStateWriter as cV, createTrace as cW, createWorkflowProcessTracker as cX, defaultTracer as cY, detectInstructionsInjection as cZ, discoverInstances as c_, extractAssistantTextFromMessage as d0, getActiveUserInteraction as d1, getAdmittedAgentBindings as d2, isAskUserCustomInputAnswer as d3, isFinalWorkflowProcessStatus as d4, isRunnableTool as d5, isRunnerLlmResult as d6, normalizeHostMetadata as d7, registerChildTask as d8, registerPresetDispatcher as d9, requestTaskStop as da, runAdmissionAudit as db, setActiveUserInteraction as dc, setAdmittedAgentBindings as dd };
-export type { KodaXGoalStatus as $, DiscoveredInstance as B, ChildTaskRegistry as C, DiscoveryOptions as E, EvidenceSpanData as F, FanoutSpanData as G, FileOperations as H, GenerationSpanData as I, Guardrail as J, GuardrailSpanData as K, Handoff as L, HandoffSpanData as M, InMemorySessionOptions as N, InstanceDiscoveryFs as O, InvariantId as P, InvariantResult as Q, KodaXCompactMemoryProgress as S, KodaXCompactMemorySeed as T, KodaXExtensionSessionRecord as U, KodaXExtensionSessionState as V, KodaXExtensionStore as W, KodaXExtensionStoreEntry as X, KodaXFileInputArtifact as Y, KodaXGoalEventType as Z, KodaXGoalState as _, MemoryReviewModelInput as a$, KodaXImageInputArtifact as a0, KodaXImageMediaType as a1, KodaXInputArtifact as a2, KodaXInputArtifactSource as a3, KodaXJsonValue as a4, KodaXSessionArchiveMarkerEntry as a5, KodaXSessionArtifactLedgerEntry as a6, KodaXSessionBranchSummaryEntry as a7, KodaXSessionClientNoticeEntry as a8, KodaXSessionCompactionEntry as a9, MemoryActionProposal as aA, MemoryApplyPreview as aB, MemoryApplyResult as aC, MemoryApproval as aD, MemoryAuthority as aE, MemoryAutoCuratorInput as aF, MemoryAutoCuratorResult as aG, MemoryBodySnapshot as aH, MemoryController as aI, MemoryCuratorInput as aJ, MemoryEvent as aK, MemoryGovernanceFinding as aL, MemoryGovernanceFindingKind as aM, MemoryGovernanceReport as aN, MemoryItemRef as aO, MemoryLifecycle as aP, MemoryPack as aQ, MemoryPackHint as aR, MemoryPackInput as aS, MemoryPackTraceMetadata as aT, MemoryProposalAction as aU, MemoryRefFilter as aV, MemoryRefKind as aW, MemoryRejectResult as aX, MemoryReviewCandidateRef as aY, MemoryReviewDraftAction as aZ, MemoryReviewInput as a_, KodaXSessionData as aa, KodaXSessionEntry as ab, KodaXSessionEntryBase as ac, KodaXSessionGoalEntry as ad, KodaXSessionLabelEntry as ae, KodaXSessionLineage as af, KodaXSessionMessageEntry as ag, KodaXSessionMeta as ah, KodaXSessionNavigationOptions as ai, KodaXSessionRewindMarkerEntry as aj, KodaXSessionRuntimeInfo as ak, KodaXSessionScope as al, KodaXSessionStorage as am, KodaXSessionTreeNode as an, KodaXSessionUiHistoryItem as ao, KodaXSessionUiHistoryItemType as ap, KodaXSessionUiTextHistoryItem as aq, KodaXSessionUiTextHistoryItemType as ar, KodaXSessionUiToolCall as as, KodaXSessionUiToolCallStatus as at, KodaXSessionUiToolGroupHistoryItem as au, KodaXSessionWorkspaceKind as av, KodaXVideoInputArtifact as aw, KodaXVideoMediaType as ax, ManifestPatch as az, AdmissionAuditOptions as b, WorkflowApi as b$, MemoryReviewPlan as b0, MemoryReviewRunner as b1, MemoryReviewTrigger as b2, MemoryScope as b3, MemorySourceAdapter as b4, MemoryVisibility as b5, MessageEntry as b6, ObserveCtx as b7, PersistedSessionState as b8, PresetDispatcher as b9, SessionMeta as bA, SessionStateSnapshot as bB, Span as bC, SpanData as bD, SpanError as bE, SpanImplOptions as bG, StartTraceOptions as bH, StateWriter as bI, StateWriterFs as bJ, StateWriterOptions as bK, StopHookContext as bL, StopHookFn as bM, StopHookResult as bN, StopHookSpanData as bO, SystemCap as bP, TaskAbortRegistry as bQ, TerminalCtx as bR, ToolCallSpanData as bS, ToolCapability as bT, ToolPermission as bU, Trace as bV, TraceOptions as bW, TracerOptions as bY, UserInteraction as bZ, WorkflowAgentBackend as b_, PresetTracingContext as ba, QualityInvariant as bb, ReadonlyMutationTracker as bc, ReadonlyRecorder as bd, ReasoningDepth as be, RecentlyModifiedFile as bf, RequestTaskStopOptions as bg, RequestTaskStopResult as bh, RunEvent as bi, RunOptions as bj, RunResult as bk, RunnableTool as bl, RunnerEvent as bn, RunnerLlmResult as bo, RunnerLlmReturn as bp, RunnerToolCall as bq, RunnerToolContext as br, RunnerToolObserver as bs, RunnerToolResult as bt, Session as bu, SessionDispatchResult as bv, SessionEntry as bw, SessionErrorMetadata as bx, SessionExtension as by, SessionForkOptions as bz, AdmissionCtx as c, WorkflowApproval as c0, WorkflowApprovalSummary as c1, WorkflowArtifactRef as c2, WorkflowBudget as c3, WorkflowEvent as c4, WorkflowEventCorrelation as c5, WorkflowEventType as c7, WorkflowIsolation as c8, WorkflowLimits as c9, WorkflowTaskHandle as cA, WorkflowTaskResult as cB, WorkflowTaskSnapshot as cC, WorkflowTaskStatus as cD, WorkflowTaskSummaryEventUpdate as cE, WorkflowTaskSummaryKind as cF, WorkflowTaskSummaryUpdate as cG, WorkflowTaskUsage as cH, WorkflowTaskVerification as cI, WorkflowTaskVerificationResult as cJ, WorkflowWaitOptions as cK, WorkflowLogEvent as ca, WorkflowMeta as cb, WorkflowModelHint as cc, WorkflowModule as cd, WorkflowParallelOptions as ce, WorkflowProcessArtifact as cf, WorkflowProcessCounts as cg, WorkflowProcessEvent as ch, WorkflowProcessItem as ci, WorkflowProcessItemKind as cj, WorkflowProcessItemOrigin as ck, WorkflowProcessItemStatus as cl, WorkflowProcessProgress as cm, WorkflowProcessSnapshot as cn, WorkflowProcessSource as co, WorkflowProcessStatus as cp, WorkflowProcessSummaryStatus as cq, WorkflowProcessTokenUsage as cr, WorkflowProcessTracker as cs, WorkflowProcessTrackerOptions as ct, WorkflowRun as cu, WorkflowRunState as cv, WorkflowRunStatus as cw, WorkflowSpawnAgentInput as cx, WorkflowSynthesis as cy, WorkflowSynthesizeInput as cz, AdmissionVerdict as d, AdmittedHandle as e, Agent as f, AgentManifest as g, AgentMessage as h, AgentMiddlewareDeclaration as i, AgentReasoningProfile as j, AgentSpanData as k, AgentTool as l, AskUserAnswer as m, AskUserCustomInputAnswer as n, AskUserMultiOptions as o, AskUserQuestionItem as p, AskUserQuestionOptions as q, AskUserSelectionAnswer as r, CompactionAnchor as s, CompactionConfig as t, CompactionDetails as u, CompactionResult as v, CompactionSpanData as w, CompactionUpdate as x, CurrentTodoSummary as y, Deliverable as z };
+type DispatchableAgentOrigin = 'native' | 'constructed' | 'external';
+type AgentExecutorProtocol = 'native' | 'a2a' | 'mcp' | 'http';
+type ExternalAgentProtocol = Exclude<AgentExecutorProtocol, 'native'>;
+type CapabilitySupport = 'supported' | 'unsupported' | 'conditional';
+interface AgentCapabilityDeclaration {
+    readonly streaming: CapabilitySupport;
+    readonly durableTasks: CapabilitySupport;
+    readonly inputRequired: CapabilitySupport;
+    readonly cancellation: CapabilitySupport;
+    readonly artifacts: CapabilitySupport;
+}
+interface AgentEffectDeclaration {
+    readonly remote: 'none' | 'read' | 'write' | 'unknown';
+    readonly workspace: 'none' | 'proposal' | 'direct';
+}
+interface ExternalAgentEffectDeclaration extends AgentEffectDeclaration {
+    readonly workspace: 'none' | 'proposal';
+}
+interface DispatchableAgentDescriptor {
+    readonly agentId: string;
+    readonly displayName: string;
+    readonly description?: string;
+    readonly origin: DispatchableAgentOrigin;
+    readonly protocol: AgentExecutorProtocol;
+    readonly configurationRevision: string;
+    readonly skills: readonly string[];
+    readonly inputModalities: readonly string[];
+    readonly outputModalities: readonly string[];
+    readonly capabilities: AgentCapabilityDeclaration;
+    readonly effects: AgentEffectDeclaration;
+}
+type AgentDispatchabilityStatus = 'dispatchable' | 'degraded' | 'busy' | 'unavailable';
+interface AgentDispatchabilitySnapshot {
+    readonly status: AgentDispatchabilityStatus;
+    readonly checkedAt: string;
+    readonly reasons: readonly string[];
+    readonly retryAfterMs?: number;
+}
+interface DispatchableAgentListing {
+    readonly descriptor: DispatchableAgentDescriptor;
+    readonly dispatchability: AgentDispatchabilitySnapshot;
+}
+interface AgentDispatchContext {
+    readonly actorId: string;
+    readonly projectId?: string;
+    readonly workflowId?: string;
+    readonly parentTaskId?: string;
+    readonly runId?: string;
+    readonly nodeId?: string;
+    readonly dataClassifications?: readonly string[];
+    readonly budget?: number;
+}
+interface AgentCapabilityRequirements {
+    readonly streaming?: boolean;
+    readonly durableTasks?: boolean;
+    readonly inputRequired?: boolean;
+    readonly cancellation?: boolean;
+    readonly artifacts?: boolean;
+}
+interface DispatchableAgentQuery extends AgentDispatchContext {
+    readonly requiredSkills?: readonly string[];
+    readonly requiredCapabilities?: AgentCapabilityRequirements;
+    readonly readOnly?: boolean;
+}
+interface ExternalAgentHealth {
+    readonly status: 'healthy' | 'degraded' | 'unhealthy';
+    readonly checkedAt: string;
+    readonly retryAfterMs?: number;
+    readonly diagnostic?: string;
+}
+interface ExternalAgentRegistration {
+    readonly agentId: string;
+    readonly displayName: string;
+    readonly description?: string;
+    readonly enabled: boolean;
+    readonly executorId: string;
+    readonly protocol: ExternalAgentProtocol;
+    readonly configurationRevision: string;
+    readonly endpointIdentityHash: string;
+    readonly credentialRef?: string;
+    readonly executorConfig?: Readonly<Record<string, unknown>>;
+    readonly skills?: readonly string[];
+    readonly inputModalities?: readonly string[];
+    readonly outputModalities?: readonly string[];
+    readonly capabilities: AgentCapabilityDeclaration;
+    readonly effects: ExternalAgentEffectDeclaration;
+    readonly health?: ExternalAgentHealth;
+    readonly maxConcurrency?: number;
+    readonly minimumBudget?: number;
+    readonly allowedDataClassifications?: readonly string[];
+}
+interface ExternalAgentRegistrationSummary {
+    readonly agentId: string;
+    readonly displayName: string;
+    readonly description?: string;
+    readonly enabled: boolean;
+    readonly executorId: string;
+    readonly protocol: ExternalAgentProtocol;
+    readonly configurationRevision: string;
+    readonly endpointIdentityHash: string;
+    readonly credentialConfigured: boolean;
+    readonly capabilities: AgentCapabilityDeclaration;
+    readonly effects: ExternalAgentEffectDeclaration;
+    readonly health?: ExternalAgentHealth;
+    readonly diagnostics: readonly string[];
+}
+interface AgentDispatchPolicyInput {
+    readonly registration: ExternalAgentRegistration;
+    readonly query: DispatchableAgentQuery;
+}
+interface AgentDispatchPolicyDecision {
+    readonly allowed: boolean;
+    readonly reasons?: readonly string[];
+}
+type AgentDispatchPolicy = (input: AgentDispatchPolicyInput) => AgentDispatchPolicyDecision | Promise<AgentDispatchPolicyDecision>;
+interface AgentCredentialBroker {
+    isAvailable?(credentialRef: string): boolean | Promise<boolean>;
+    withCredential<T>(credentialRef: string, use: (credential: string) => Promise<T>): Promise<T>;
+}
+interface AgentArtifactReference {
+    readonly name: string;
+    readonly mimeType?: string;
+    readonly size?: number;
+    readonly hash?: string;
+    readonly uri?: string;
+    readonly provenance?: string;
+    readonly producingAgentId?: string;
+    readonly remoteTaskId?: string;
+}
+interface AgentArtifactPolicyInput {
+    readonly registration: ExternalAgentRegistration;
+    readonly artifact: AgentArtifactReference;
+}
+interface AgentArtifactPolicyDecision {
+    readonly allowed: boolean;
+    readonly reason?: string;
+}
+type AgentArtifactPolicy = (input: AgentArtifactPolicyInput) => AgentArtifactPolicyDecision | Promise<AgentArtifactPolicyDecision>;
+interface AgentTaskUsage {
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    readonly totalTokens?: number;
+    readonly cost?: number;
+    readonly currency?: string;
+}
+type AgentTaskState = 'submitted' | 'working' | 'input-required' | 'auth-required' | 'completed' | 'failed' | 'canceled' | 'rejected' | 'unknown';
+type AgentTaskCancellation = 'none' | 'requested' | 'confirmed' | 'unsupported' | 'failed' | 'unknown';
+interface AgentTaskProgress {
+    readonly message?: string;
+    readonly percent?: number;
+}
+interface AgentTaskCorrelation {
+    readonly parentTaskId?: string;
+    readonly workflowId?: string;
+    readonly runId?: string;
+    readonly nodeId?: string;
+}
+interface AgentTaskRegistrationSnapshot {
+    readonly agentId: string;
+    readonly origin: DispatchableAgentOrigin;
+    readonly executorId: string;
+    readonly protocol: AgentExecutorProtocol;
+    readonly configurationRevision: string;
+    readonly endpointIdentityHash?: string;
+    readonly capabilities: AgentCapabilityDeclaration;
+    readonly effects: AgentEffectDeclaration;
+}
+interface AgentExecutorTaskReference {
+    readonly idempotencyKey: string;
+    readonly remoteTaskId?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+interface AgentTaskSnapshot extends AgentTaskCorrelation {
+    readonly taskId: string;
+    readonly route: 'local' | 'external';
+    readonly agentId: string;
+    readonly objective: string;
+    readonly state: AgentTaskState;
+    readonly cancellation: AgentTaskCancellation;
+    readonly registration: AgentTaskRegistrationSnapshot;
+    readonly idempotencyKey: string;
+    readonly dispatchAttempt: number;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly remoteTaskId?: string;
+    readonly executorReference?: AgentExecutorTaskReference;
+    readonly progress?: AgentTaskProgress;
+    readonly output?: string;
+    readonly error?: string;
+    readonly cancellationError?: string;
+    readonly artifacts?: readonly AgentArtifactReference[];
+    readonly usage?: AgentTaskUsage;
+}
+interface AgentExecutorTaskSnapshot {
+    readonly state: AgentTaskState;
+    readonly progress?: AgentTaskProgress;
+    readonly output?: string;
+    readonly error?: string;
+    readonly artifacts?: readonly AgentArtifactReference[];
+    readonly usage?: AgentTaskUsage;
+}
+interface AgentTaskStartInput {
+    readonly taskId?: string;
+    readonly agentId: string;
+    readonly objective: string;
+    readonly context: AgentDispatchContext;
+    readonly readOnly?: boolean;
+    readonly requiredSkills?: readonly string[];
+    readonly requiredCapabilities?: AgentCapabilityRequirements;
+    readonly expectedConfigurationRevision?: string;
+    readonly idempotencyKey?: string;
+    readonly input?: string;
+}
+interface AgentContinuationInput {
+    readonly content: string;
+}
+interface AgentExecutorEvent {
+    readonly state?: AgentTaskState;
+    readonly progress?: AgentTaskProgress;
+    readonly output?: string;
+    readonly error?: string;
+    readonly artifacts?: readonly AgentArtifactReference[];
+    readonly usage?: AgentTaskUsage;
+}
+interface AgentTaskEvent extends AgentExecutorEvent {
+    readonly taskId: string;
+    readonly seq: number;
+    readonly timestamp: string;
+    readonly type: 'submitted' | 'state' | 'progress' | 'output' | 'artifact' | 'usage' | 'error' | 'cancellation';
+    readonly cancellation?: AgentTaskCancellation;
+}
+interface AgentExecutorPreflightResult {
+    readonly ok: boolean;
+    readonly reasons?: readonly string[];
+}
+interface AgentExecutor {
+    preflight?(input: AgentTaskStartInput): Promise<AgentExecutorPreflightResult>;
+    start(input: AgentTaskStartInput): Promise<AgentExecutorTaskReference>;
+    events(reference: AgentExecutorTaskReference): AsyncIterable<AgentExecutorEvent>;
+    get(reference: AgentExecutorTaskReference): Promise<AgentExecutorTaskSnapshot>;
+    sendInput(reference: AgentExecutorTaskReference, input: AgentContinuationInput): Promise<void>;
+    cancel(reference: AgentExecutorTaskReference, reason?: string): Promise<AgentExecutorTaskSnapshot>;
+    reconcile(reference: AgentExecutorTaskReference): Promise<AgentExecutorTaskSnapshot>;
+    dispose(): Promise<void>;
+}
+interface AgentExecutorFactoryContext {
+    withCredential<T>(credentialRef: string, use: (credential: string) => Promise<T>): Promise<T>;
+    authorizeArtifact(artifact: AgentArtifactReference): Promise<void>;
+}
+interface AgentExecutorFactory {
+    readonly executorId: string;
+    readonly protocol: ExternalAgentProtocol;
+    create(registration: ExternalAgentRegistration, context: AgentExecutorFactoryContext): Promise<AgentExecutor>;
+}
+interface AgentPreflightInput {
+    readonly agentId: string;
+    readonly query: DispatchableAgentQuery;
+    readonly expectedConfigurationRevision?: string;
+}
+interface AgentPreflightResult {
+    readonly ok: boolean;
+    readonly descriptor?: DispatchableAgentDescriptor;
+    readonly dispatchability: AgentDispatchabilitySnapshot;
+    readonly reasons: readonly string[];
+}
+interface AgentTaskFilter {
+    readonly agentId?: string;
+    readonly parentTaskId?: string;
+    readonly workflowId?: string;
+    readonly runId?: string;
+    readonly state?: AgentTaskState | readonly AgentTaskState[];
+}
+interface LocalAgentTaskInput extends AgentTaskCorrelation {
+    readonly taskId: string;
+    readonly agentId: string;
+    readonly objective: string;
+    readonly configurationRevision: string;
+    readonly origin?: 'native' | 'constructed';
+}
+interface LocalAgentTaskUpdate {
+    readonly state?: AgentTaskState;
+    readonly progress?: AgentTaskProgress;
+    readonly output?: string;
+    readonly error?: string;
+    readonly artifacts?: readonly AgentArtifactReference[];
+    readonly usage?: AgentTaskUsage;
+}
+interface AgentExecutorPlaneStore {
+    loadRegistrations(): Promise<readonly ExternalAgentRegistration[]>;
+    saveRegistrations(registrations: readonly ExternalAgentRegistration[]): Promise<void>;
+    loadTasks(): Promise<readonly AgentTaskSnapshot[]>;
+    saveTask(task: AgentTaskSnapshot): Promise<void>;
+    loadEvents(taskId: string): Promise<readonly AgentTaskEvent[]>;
+    appendEvent(event: AgentTaskEvent): Promise<void>;
+}
+interface AgentRegistrationService {
+    list(): Promise<readonly ExternalAgentRegistrationSummary[]>;
+    upsert(input: ExternalAgentRegistration): Promise<ExternalAgentRegistrationSummary>;
+    remove(agentId: string): Promise<boolean>;
+}
+interface AgentTaskService {
+    start(input: AgentTaskStartInput): Promise<AgentTaskSnapshot>;
+    list(filter?: AgentTaskFilter): Promise<readonly AgentTaskSnapshot[]>;
+    get(taskId: string): Promise<AgentTaskSnapshot>;
+    events(taskId: string, cursor?: number): Promise<readonly AgentTaskEvent[]>;
+    wait(taskId: string, timeoutMs?: number): Promise<AgentTaskSnapshot>;
+    sendInput(taskId: string, input: AgentContinuationInput): Promise<AgentTaskSnapshot>;
+    cancel(taskId: string, reason?: string): Promise<AgentTaskSnapshot>;
+    reconcile(taskId: string): Promise<AgentTaskSnapshot>;
+    recordLocal(input: LocalAgentTaskInput): Promise<AgentTaskSnapshot>;
+    updateLocal(taskId: string, update: LocalAgentTaskUpdate): Promise<AgentTaskSnapshot>;
+}
+interface AgentExecutorPlaneBinding {
+    readonly plane: AgentExecutorPlane;
+    readonly context: AgentDispatchContext;
+}
+interface AgentExecutorPlane {
+    readonly registrations: AgentRegistrationService;
+    readonly tasks: AgentTaskService;
+    listDispatchable(query: DispatchableAgentQuery, localAgents?: readonly DispatchableAgentDescriptor[]): Promise<readonly DispatchableAgentListing[]>;
+    describe(agentId: string, query: DispatchableAgentQuery, localAgents?: readonly DispatchableAgentDescriptor[]): Promise<DispatchableAgentListing | undefined>;
+    preflight(input: AgentPreflightInput, localAgents?: readonly DispatchableAgentDescriptor[]): Promise<AgentPreflightResult>;
+    close(): Promise<void>;
+}
+interface CreateAgentExecutorPlaneOptions {
+    readonly factories: readonly AgentExecutorFactory[];
+    readonly policy: AgentDispatchPolicy;
+    readonly credentialBroker?: AgentCredentialBroker;
+    readonly artifactPolicy?: AgentArtifactPolicy;
+    readonly store?: AgentExecutorPlaneStore;
+    readonly now?: () => Date;
+    readonly createTaskId?: () => string;
+    readonly createIdempotencyKey?: () => string;
+}
+
+export { ASK_USER_BACK_SIGNAL as A, ASK_USER_CUSTOM_INPUT_SIGNAL as a, InvariantSession as aE, DEFAULT_SYSTEM_CAP as af, MAX_TOOL_LOOP_ITERATIONS as bn, Tracer as cM, WorkflowEventRecorder as cX, Runner as cb, SpanImpl as cu, registerPresetDispatcher as d$, _resetAdmittedAgentBindings as dB, _resetPresetDispatchers as dC, asSingleSelection as dD, buildAssistantMessageFromLlmResult as dE, buildSystemPrompt as dF, buildToolResultMessage as dG, createAgent as dH, createHandoff as dI, createInMemorySession as dJ, createInvariantSessionForAgent as dK, createStateWriter as dL, createTrace as dM, createWorkflowProcessTracker as dN, defaultTracer as dO, detectInstructionsInjection as dP, discoverInstances as dQ, executeRunnerToolCall as dR, extractAssistantTextFromMessage as dS, getActiveUserInteraction as dT, getAdmittedAgentBindings as dU, isAskUserCustomInputAnswer as dV, isFinalWorkflowProcessStatus as dW, isRunnableTool as dX, isRunnerLlmResult as dY, normalizeHostMetadata as dZ, registerChildTask as d_, requestTaskStop as e0, runAdmissionAudit as e1, setActiveUserInteraction as e2, setAdmittedAgentBindings as e3 };
+export type { AskUserAnswer as $, AgentExecutorPlaneBinding as B, AgentExecutorPlaneStore as C, AgentExecutorPreflightResult as D, AgentExecutorProtocol as E, AgentExecutorTaskReference as F, AgentExecutorTaskSnapshot as G, AgentManifest as H, AgentMessage as I, AgentMiddlewareDeclaration as J, AgentPreflightInput as K, AgentPreflightResult as L, AgentReasoningProfile as M, AgentRegistrationService as N, AgentSpanData as O, AgentTaskCancellation as P, AgentTaskCorrelation as Q, AgentTaskEvent as R, AgentTaskFilter as S, AgentTaskProgress as T, AgentTaskRegistrationSnapshot as U, AgentTaskService as V, AgentTaskSnapshot as W, AgentTaskStartInput as X, AgentTaskState as Y, AgentTaskUsage as Z, AgentTool as _, KodaXSessionEntryBase as a$, AskUserCustomInputAnswer as a0, AskUserMultiOptions as a1, AskUserQuestionItem as a2, AskUserQuestionOptions as a3, AskUserSelectionAnswer as a4, CapabilitySupport as a5, ChildTaskRegistry as a6, CompactionAnchor as a7, CompactionConfig as a8, CompactionDetails as a9, InMemorySessionOptions as aA, InstanceDiscoveryFs as aB, InvariantId as aC, InvariantResult as aD, KodaXCompactMemoryProgress as aF, KodaXCompactMemorySeed as aG, KodaXExtensionSessionRecord as aH, KodaXExtensionSessionState as aI, KodaXExtensionStore as aJ, KodaXExtensionStoreEntry as aK, KodaXFileInputArtifact as aL, KodaXGoalEventType as aM, KodaXGoalState as aN, KodaXGoalStatus as aO, KodaXImageInputArtifact as aP, KodaXImageMediaType as aQ, KodaXInputArtifact as aR, KodaXInputArtifactSource as aS, KodaXJsonValue as aT, KodaXSessionArchiveMarkerEntry as aU, KodaXSessionArtifactLedgerEntry as aV, KodaXSessionBranchSummaryEntry as aW, KodaXSessionClientNoticeEntry as aX, KodaXSessionCompactionEntry as aY, KodaXSessionData as aZ, KodaXSessionEntry as a_, CompactionResult as aa, CompactionSpanData as ab, CompactionUpdate as ac, CreateAgentExecutorPlaneOptions as ad, CurrentTodoSummary as ae, Deliverable as ag, DiscoveredInstance as ah, DiscoveryOptions as ai, DispatchableAgentDescriptor as aj, DispatchableAgentListing as ak, DispatchableAgentOrigin as al, DispatchableAgentQuery as am, EvidenceSpanData as an, ExternalAgentEffectDeclaration as ao, ExternalAgentHealth as ap, ExternalAgentProtocol as aq, ExternalAgentRegistration as ar, ExternalAgentRegistrationSummary as as, FanoutSpanData as at, FileOperations as au, GenerationSpanData as av, Guardrail as aw, GuardrailSpanData as ax, Handoff as ay, HandoffSpanData as az, AdmissionAuditOptions as b, PresetTracingContext as b$, KodaXSessionGoalEntry as b0, KodaXSessionLabelEntry as b1, KodaXSessionLineage as b2, KodaXSessionMessageEntry as b3, KodaXSessionMeta as b4, KodaXSessionNavigationOptions as b5, KodaXSessionRewindMarkerEntry as b6, KodaXSessionRuntimeInfo as b7, KodaXSessionScope as b8, KodaXSessionStorage as b9, MemoryGovernanceFinding as bA, MemoryGovernanceFindingKind as bB, MemoryGovernanceReport as bC, MemoryItemRef as bD, MemoryLifecycle as bE, MemoryPack as bF, MemoryPackHint as bG, MemoryPackInput as bH, MemoryPackTraceMetadata as bI, MemoryProposalAction as bJ, MemoryRefFilter as bK, MemoryRefKind as bL, MemoryRejectResult as bM, MemoryReviewCandidateRef as bN, MemoryReviewDraftAction as bO, MemoryReviewInput as bP, MemoryReviewModelInput as bQ, MemoryReviewPlan as bR, MemoryReviewRunner as bS, MemoryReviewTrigger as bT, MemoryScope as bU, MemorySourceAdapter as bV, MemoryVisibility as bW, MessageEntry as bX, ObserveCtx as bY, PersistedSessionState as bZ, PresetDispatcher as b_, KodaXSessionTreeNode as ba, KodaXSessionUiHistoryItem as bb, KodaXSessionUiHistoryItemType as bc, KodaXSessionUiTextHistoryItem as bd, KodaXSessionUiTextHistoryItemType as be, KodaXSessionUiToolCall as bf, KodaXSessionUiToolCallStatus as bg, KodaXSessionUiToolGroupHistoryItem as bh, KodaXSessionWorkspaceKind as bi, KodaXVideoInputArtifact as bj, KodaXVideoMediaType as bk, LocalAgentTaskInput as bl, LocalAgentTaskUpdate as bm, ManifestPatch as bo, MemoryActionProposal as bp, MemoryApplyPreview as bq, MemoryApplyResult as br, MemoryApproval as bs, MemoryAuthority as bt, MemoryAutoCuratorInput as bu, MemoryAutoCuratorResult as bv, MemoryBodySnapshot as bw, MemoryController as bx, MemoryCuratorInput as by, MemoryEvent as bz, AdmissionCtx as c, WorkflowLogEvent as c$, QualityInvariant as c0, ReadonlyMutationTracker as c1, ReadonlyRecorder as c2, ReasoningDepth as c3, RecentlyModifiedFile as c4, RequestTaskStopOptions as c5, RequestTaskStopResult as c6, RunEvent as c7, RunOptions as c8, RunResult as c9, StopHookContext as cA, StopHookFn as cB, StopHookResult as cC, StopHookSpanData as cD, SystemCap as cE, TaskAbortRegistry as cF, TerminalCtx as cG, ToolCallSpanData as cH, ToolCapability as cI, ToolPermission as cJ, Trace as cK, TraceOptions as cL, TracerOptions as cN, UserInteraction as cO, WorkflowAgentBackend as cP, WorkflowApi as cQ, WorkflowApproval as cR, WorkflowApprovalSummary as cS, WorkflowArtifactRef as cT, WorkflowBudget as cU, WorkflowEvent as cV, WorkflowEventCorrelation as cW, WorkflowEventType as cY, WorkflowIsolation as cZ, WorkflowLimits as c_, RunnableTool as ca, RunnerEvent as cc, RunnerLlmResult as cd, RunnerLlmReturn as ce, RunnerToolCall as cf, RunnerToolContext as cg, RunnerToolObserver as ch, RunnerToolResult as ci, Session as cj, SessionDispatchResult as ck, SessionEntry as cl, SessionErrorMetadata as cm, SessionExtension as cn, SessionForkOptions as co, SessionMeta as cp, SessionStateSnapshot as cq, Span as cr, SpanData as cs, SpanError as ct, SpanImplOptions as cv, StartTraceOptions as cw, StateWriter as cx, StateWriterFs as cy, StateWriterOptions as cz, AdmissionVerdict as d, WorkflowMeta as d0, WorkflowModelHint as d1, WorkflowModule as d2, WorkflowParallelOptions as d3, WorkflowProcessArtifact as d4, WorkflowProcessCounts as d5, WorkflowProcessEvent as d6, WorkflowProcessItem as d7, WorkflowProcessItemKind as d8, WorkflowProcessItemOrigin as d9, WorkflowWaitOptions as dA, WorkflowProcessItemStatus as da, WorkflowProcessProgress as db, WorkflowProcessSnapshot as dc, WorkflowProcessSource as dd, WorkflowProcessStatus as de, WorkflowProcessSummaryStatus as df, WorkflowProcessTokenUsage as dg, WorkflowProcessTracker as dh, WorkflowProcessTrackerOptions as di, WorkflowRun as dj, WorkflowRunState as dk, WorkflowRunStatus as dl, WorkflowSpawnAgentInput as dm, WorkflowSynthesis as dn, WorkflowSynthesizeInput as dp, WorkflowTaskHandle as dq, WorkflowTaskResult as dr, WorkflowTaskSnapshot as ds, WorkflowTaskStatus as dt, WorkflowTaskSummaryEventUpdate as du, WorkflowTaskSummaryKind as dv, WorkflowTaskSummaryUpdate as dw, WorkflowTaskUsage as dx, WorkflowTaskVerification as dy, WorkflowTaskVerificationResult as dz, AdmittedHandle as e, Agent as f, AgentArtifactPolicy as g, AgentArtifactPolicyDecision as h, AgentArtifactPolicyInput as i, AgentArtifactReference as j, AgentCapabilityDeclaration as k, AgentCapabilityRequirements as l, AgentContinuationInput as m, AgentCredentialBroker as n, AgentDispatchContext as o, AgentDispatchPolicy as p, AgentDispatchPolicyDecision as q, AgentDispatchPolicyInput as r, AgentDispatchabilitySnapshot as s, AgentDispatchabilityStatus as t, AgentEffectDeclaration as u, AgentExecutor as v, AgentExecutorEvent as w, AgentExecutorFactory as x, AgentExecutorFactoryContext as y, AgentExecutorPlane as z };

package/dist/types-chunks/types.d-DU9lLkmE.d.ts

@@ -0,0 +1,128 @@
+import { aR as KodaXInputArtifact } from './types.d-DG9B4SMm.js';
+import { R as KodaXTaskResultMetadata } from './types.d-Bp4Lm1jv.js';
+
+/**
+ * @kodax-ai/agent/messaging — Message queue types
+ *
+ * FEATURE_115 (v0.7.36): agentId-scoped 2-tier priority queue infrastructure.
+ *
+ * Per ADR-021: messaging is a generic agent-platform primitive (not coding-
+ * specific). Downstream consumers:
+ *   - @kodax-ai/coding runner-driven mid-turn drain
+ *   - @kodax-ai/repl InkREPL ESC soft-pause + text injection (FEATURE_111 absorbed)
+ *   - subagent task-notification routing (FEATURE_155 idle-yield wakeup)
+ *
+ * Phase 0.6 study (`c:/tmp/claude-code-actual-usage.md`): Claude Code's
+ * `'now'` priority has zero production usage; KodaX simplifies to 2 tiers.
+ */
+
+type MessagePriority = 'user' | 'background';
+type MessageMode = 'prompt' | 'task-notification' | 'system-reminder';
+type QueuedInputArtifact = KodaXInputArtifact;
+interface QueuedMessage {
+    /** Stable id for tracing / dedup. Format: `msg-<sequence>`. */
+    readonly id: string;
+    readonly priority: MessagePriority;
+    /**
+     * Routing key:
+     *   undefined = main thread / coordinator agent
+     *   'agent-id-XYZ' = subagent / specific consumer
+     *
+     * Drain consumers MUST filter by agentId match — undefined matches only
+     * undefined-agentId messages, not "any agent".
+     */
+    readonly agentId?: string;
+    readonly mode: MessageMode;
+    readonly content: string;
+    readonly inputArtifacts?: readonly QueuedInputArtifact[];
+    readonly taskResult?: KodaXTaskResultMetadata;
+    /** Wall-clock timestamp (`Date.now()`) for tracing only — not used for ordering. */
+    readonly enqueuedAt: number;
+}
+interface DequeueFilter {
+    /**
+     * Only return messages with this agentId.
+     * undefined matches messages with no agentId (main-thread messages only).
+     */
+    readonly agentId?: string;
+    /**
+     * Highest priority level included in the drain.
+     *   'user'       → only user priority drained, background stays queued
+     *   'background' → both user + background drained (Sleep-gated case)
+     */
+    readonly maxPriority: MessagePriority;
+    /**
+     * Optional cap on number of messages drained in this call.
+     * Defaults to unlimited (drains all matching).
+     */
+    readonly limit?: number;
+    /**
+     * FEATURE_159 (v0.7.40) — optional mode filter. Lets REPL split the
+     * single queue into mode-typed views (e.g. `mode:'prompt'` for user
+     * input vs `mode:'task-notification'` for child completion banners)
+     * without separate queues. When omitted, all modes match.
+     */
+    readonly mode?: MessageMode;
+    /**
+     * FEATURE_159 (v0.7.40) — optional precise-id filter. Single-message
+     * targeted removal — drives Esc-pop-this-uuid in REPL. When set, all
+     * other filters still apply (agentId / priority / mode mismatches still
+     * skip the message), so callers can't accidentally remove a message
+     * outside their scope.
+     */
+    readonly id?: string;
+    /**
+     * FEATURE_159 (v0.7.40) — optional escape-hatch predicate, AND-ed with
+     * the structured filters. Lets SDK consumers express conditions the
+     * typed fields don't cover (e.g. timestamp ranges, content-match) without
+     * forcing every new use case to extend `DequeueFilter`. KodaX-internal
+     * code should prefer the typed fields for readability; this is the
+     * "data-driven main path + predicate escape" pattern.
+     *
+     * Evaluated AFTER the typed filters succeed — so a `predicate` that
+     * inspects `message.content` never runs on messages outside the
+     * caller's `agentId` / `mode` / `id` scope.
+     */
+    readonly predicate?: (message: QueuedMessage) => boolean;
+}
+/**
+ * FEATURE_159 (v0.7.40) — structured queue event emitted to subscribers.
+ *
+ * Replaces the prior `() => void` bare-notify signal. Carries the kind +
+ * affected messages so SDK observability consumers (logging, tracing,
+ * metrics) can react per-event without re-diffing snapshots.
+ *
+ * Event granularity rules:
+ *   - `enqueued` fires ONCE per `enqueue()` call (always 1 message).
+ *   - `dequeued` fires ONCE per `dequeue()` call that removed ≥1 message,
+ *     carrying ALL drained messages in priority+FIFO order. No-op drains
+ *     (filter matched nothing) fire no event — quiet by design so the
+ *     `waitForWakeEvent` 100ms poll doesn't spam idle subscribers.
+ *   - `cleared` fires ONCE per `clear()` call that removed ≥1 message,
+ *     carrying the pre-clear messages. Empty-queue clear fires nothing.
+ *
+ * The `useSyncExternalStore` React hook ignores the event payload (it
+ * only needs the change signal); SDK / tracer consumers read the event.
+ */
+type QueueEvent = {
+    readonly kind: 'enqueued';
+    readonly message: QueuedMessage;
+} | {
+    readonly kind: 'dequeued';
+    readonly messages: readonly QueuedMessage[];
+} | {
+    readonly kind: 'cleared';
+    readonly messages: readonly QueuedMessage[];
+};
+/** FEATURE_159 — `MessageQueue.subscribe` listener signature. */
+type QueueEventListener = (event: QueueEvent) => void;
+interface EnqueueInput {
+    readonly priority: MessagePriority;
+    readonly mode: MessageMode;
+    readonly content: string;
+    readonly agentId?: string;
+    readonly inputArtifacts?: readonly QueuedInputArtifact[];
+    readonly taskResult?: KodaXTaskResultMetadata;
+}
+
+export type { DequeueFilter as D, EnqueueInput as E, MessageMode as M, QueueEventListener as Q, MessagePriority as a, QueuedInputArtifact as b, QueuedMessage as c };