@kodax-ai/kodax 0.7.67 → 0.7.69

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

@@ -1,4 +1,4 @@
-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';
+import { k as KodaXMessage, a1 as KodaXToolDefinition, F as KodaXReasoningMode, a9 as KodaXWireReasoningEffort, a3 as KodaXToolResultContentItem, Y as KodaXThinkingBlock, I as KodaXRedactedThinkingBlock } from './types.d-TTvpAGWf.js';
 
 /**
  * @kodax-ai/agent Types
@@ -104,6 +104,46 @@ interface KodaXSessionClientNoticeEntry extends KodaXSessionEntryBase {
     turnId?: string;
     payload?: KodaXJsonValue;
 }
+interface KodaXMemoryOutcomeDigest {
+    readonly id: string;
+    readonly reviewKey: string;
+    readonly sessionId: string;
+    readonly branchId: string;
+    readonly sequence: number;
+    readonly objective: string;
+    readonly actionSignature?: string;
+    readonly approach: string;
+    readonly outcome: 'succeeded' | 'failed';
+    readonly summary: string;
+    readonly preconditions?: string;
+    readonly lesson?: string;
+    readonly evidenceRefs: readonly string[];
+    readonly evidence?: readonly KodaXMemoryOutcomeEvidence[];
+    readonly memoryInfluence?: readonly KodaXMemoryInfluenceRef[];
+    readonly visibility: 'prompt_safe' | 'private' | 'sensitive';
+    readonly createdAt: string;
+}
+interface KodaXMemoryOutcomeEvidence {
+    readonly ref: string;
+    readonly grade: 'authoritative' | 'verified' | 'corroborated' | 'observed' | 'inferred';
+    readonly source: 'user' | 'host' | 'tool' | 'environment' | 'agent';
+    readonly observedAt: string;
+}
+interface KodaXMemoryInfluenceRef {
+    readonly decisionReceiptRef: string;
+    readonly grade: 'direct' | 'supporting' | 'exposed' | 'unknown';
+}
+interface KodaXSessionMemoryOutcomeDigestEntry extends KodaXSessionEntryBase {
+    readonly type: 'memory_outcome_digest';
+    readonly digest: KodaXMemoryOutcomeDigest;
+}
+interface KodaXSessionMemoryReviewReceiptEntry extends KodaXSessionEntryBase {
+    readonly type: 'memory_review_receipt';
+    readonly reviewKey: string;
+    readonly proposalIds: readonly string[];
+    readonly status: 'completed' | 'no_action';
+    readonly completedAt: string;
+}
 type KodaXGoalStatus = 'active' | 'paused' | 'budget_limited' | 'blocked' | 'complete';
 /**
  * Persistent user-set goal state. v0.7.44 FEATURE_192 — backs the
@@ -142,7 +182,7 @@ interface KodaXSessionGoalEntry extends KodaXSessionEntryBase {
     goal: KodaXGoalState | null;
     event: KodaXGoalEventType;
 }
-type KodaXSessionEntry = KodaXSessionMessageEntry | KodaXSessionCompactionEntry | KodaXSessionBranchSummaryEntry | KodaXSessionLabelEntry | KodaXSessionArchiveMarkerEntry | KodaXSessionRewindMarkerEntry | KodaXSessionClientNoticeEntry | KodaXSessionGoalEntry;
+type KodaXSessionEntry = KodaXSessionMessageEntry | KodaXSessionCompactionEntry | KodaXSessionBranchSummaryEntry | KodaXSessionLabelEntry | KodaXSessionArchiveMarkerEntry | KodaXSessionRewindMarkerEntry | KodaXSessionClientNoticeEntry | KodaXSessionMemoryOutcomeDigestEntry | KodaXSessionMemoryReviewReceiptEntry | 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';
@@ -179,7 +219,7 @@ interface KodaXSessionNavigationOptions {
     summarizeCurrentBranch?: boolean;
 }
 interface KodaXSessionTreeNode {
-    entry: Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry | KodaXSessionClientNoticeEntry | KodaXSessionRewindMarkerEntry>;
+    entry: Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry | KodaXSessionClientNoticeEntry | KodaXSessionRewindMarkerEntry | KodaXSessionMemoryOutcomeDigestEntry | KodaXSessionMemoryReviewReceiptEntry>;
     children: KodaXSessionTreeNode[];
     label?: string;
     active: boolean;
@@ -678,6 +718,20 @@ interface GenerationSpanData {
     };
     readonly finishReason?: string;
     readonly error?: string;
+    readonly memoryDecisionReceipts?: readonly MemoryDecisionTraceReceipt[];
+}
+interface MemoryDecisionTraceReceipt {
+    readonly id: string;
+    readonly decisionEpoch: string;
+    readonly decisionRevision: string;
+    readonly policyVersion: string;
+    readonly candidateSetFingerprint: string;
+    readonly candidateRefs: readonly string[];
+    readonly selectedRefs: readonly string[];
+    readonly injectedRefs: readonly string[];
+    readonly selectionModes: readonly ('task_hint' | 'exact' | 'semantic_prefetch' | 'deliberate_query')[];
+    readonly actionSignature?: string;
+    readonly throughSequence: number;
 }
 interface ToolCallSpanData {
     readonly kind: 'tool_call';
@@ -1528,6 +1582,8 @@ interface RunnerToolObserver {
 interface RunnerToolContext {
     readonly agent: Agent;
     readonly abortSignal?: AbortSignal;
+    /** Transcript that the resulting tool_result batch will extend. */
+    readonly transcript?: readonly AgentMessage[];
     /** The agent's Span, so tool implementations can nest custom spans if needed. */
     readonly agentSpan?: Span | null;
     /**
@@ -1553,6 +1609,14 @@ interface RunnerToolResult {
     readonly isError?: boolean;
     readonly metadata?: Record<string, unknown>;
 }
+/** Complete settled batch presented once before the tool_result message. */
+interface RunnerToolResultBatch {
+    readonly calls: readonly RunnerToolCall[];
+    readonly results: readonly RunnerToolResult[];
+    readonly transcript: readonly AgentMessage[];
+}
+/** Optional host-owned transform for aggregate result admission. */
+type RunnerToolResultBatchTransform = (batch: RunnerToolResultBatch) => Promise<readonly RunnerToolResult[]>;
 /**
  * A tool bundled with its executor. Extends `AgentTool` (the wire-format
  * `KodaXToolDefinition`) so it can be passed through to the provider
@@ -1687,6 +1751,12 @@ interface RunOptions {
      * `onToolResult` through the usual `KodaXEvents` bus.
      */
     readonly toolObserver?: RunnerToolObserver;
+    /**
+     * Runs once after every tool call in a batch has settled and before the
+     * corresponding tool_result message is built. The transform must preserve
+     * result count/order so tool_use pairing remains valid.
+     */
+    readonly toolResultBatchTransform?: RunnerToolResultBatchTransform;
     /**
      * Compaction hook. Fires at the TOP of every tool-loop iteration,
      * BEFORE the LLM call. Return the replacement transcript to trigger
@@ -1919,6 +1989,12 @@ interface RunResult<TData = unknown> {
      *  outputs a `blocked` verdict (halt + surface to user). */
     readonly stoppedByHook?: boolean;
 }
+/** Non-enumerable recovery payload carried across Runner error boundaries. */
+interface RunnerRecoveryTranscriptCarrier {
+    readonly __kodaxRecoveredMessages?: readonly AgentMessage[];
+}
+declare function attachRunnerRecoveryTranscript(error: Error, messages: readonly AgentMessage[]): void;
+declare function readRunnerRecoveryTranscript(error: unknown): readonly AgentMessage[] | undefined;
 /**
  * Stream events emitted by `Runner.runStream`. The event surface is
  * intentionally small in v0.7.23; FEATURE_084 expands it to mirror the
@@ -2563,8 +2639,30 @@ interface DiscoveryOptions {
  */
 declare function discoverInstances(options?: DiscoveryOptions): DiscoveredInstance[];
 
+interface MemoryContextIdentity {
+    readonly tenantId: string;
+    readonly workspaceId?: string;
+    readonly userId?: string;
+    readonly agentId: string;
+    readonly projectId?: string;
+    readonly sessionId: string;
+}
+interface MemoryApplicability {
+    readonly tenantId: string;
+    readonly workspaceId?: string;
+    readonly userId?: string;
+    readonly agentId?: string;
+    readonly projectId?: string;
+    readonly sessionId?: string;
+}
+declare function matchesMemoryApplicability(identity: MemoryContextIdentity, applicability: MemoryApplicability): boolean;
+declare function hashMemoryIdentityComponent(kind: string, canonicalId: string): string;
+declare function memoryApplicabilityFingerprint(applicability: MemoryApplicability): string;
+
 type MemoryRefKind = 'working_context' | 'session_trace' | 'artifact_ledger' | 'learning_proposal' | 'memdir' | 'skill' | 'workflow_run' | 'reasoning_report' | 'self_manual' | 'project_doc';
-type MemoryScope = 'turn' | 'session' | 'project' | 'user' | 'builtin';
+
+type MemoryScope = 'turn' | 'session' | 'project' | 'workspace' | 'agent' | 'user' | 'builtin';
+type MemoryClaimKind = 'fact' | 'policy' | 'preference' | 'procedure' | 'episode';
 type MemoryLifecycle = 'pending' | 'active' | 'provisional' | 'trusted' | 'stale' | 'quarantined' | 'archived' | 'readonly';
 type MemoryAuthority = 'read_only' | 'proposal_only' | 'approved_write';
 type MemoryVisibility = 'prompt_safe' | 'private' | 'sensitive';
@@ -2572,6 +2670,11 @@ interface MemoryItemRef {
     readonly kind: MemoryRefKind;
     readonly id: string;
     readonly scope: MemoryScope;
+    readonly scopeId?: string;
+    readonly applicability?: MemoryApplicability;
+    readonly claimKind?: MemoryClaimKind;
+    readonly claimKey?: string;
+    readonly actionSignature?: string;
     readonly title?: string;
     readonly owner: 'user' | 'project' | 'kodax' | 'external';
     readonly lifecycle: MemoryLifecycle;
@@ -2586,6 +2689,9 @@ interface MemoryItemRef {
     readonly updatedAt?: string;
     readonly lastUsedAt?: string;
     readonly pinned?: boolean;
+    readonly applyReceiptRef?: string;
+    readonly expectedFingerprint?: string;
+    readonly resultingFingerprint?: string;
 }
 interface MemoryRefFilter {
     readonly kinds?: readonly MemoryRefKind[];
@@ -2630,6 +2736,8 @@ interface MemoryApproval {
     readonly approvedBy: 'user' | 'host';
     readonly approvedAt: string;
     readonly expectedFingerprints: Readonly<Record<string, string>>;
+    readonly policyId?: string;
+    readonly policyReason?: string;
 }
 interface MemoryApplyResult {
     readonly proposalId: string;
@@ -2646,6 +2754,13 @@ interface MemoryRejectResult {
     readonly review?: MemoryReviewPlan;
     readonly warnings: readonly string[];
 }
+interface MemoryLifecycleOperationResult {
+    readonly refId: string;
+    readonly operation: 'archive' | 'forget' | 'purge';
+    readonly acknowledged: boolean;
+    readonly residualSourceRefs: readonly string[];
+    readonly warnings: readonly string[];
+}
 interface MemorySourceAdapter {
     readonly kind: MemoryRefKind;
     listRefs(filter?: MemoryRefFilter): Promise<readonly MemoryItemRef[]>;
@@ -2686,11 +2801,16 @@ interface MemoryGovernanceReport {
 }
 interface MemoryPackInput {
     readonly task: string;
+    readonly identity?: MemoryContextIdentity;
+    readonly decisionIntent?: string;
+    readonly actionSignature?: string;
+    readonly maxCandidates?: number;
     readonly maxHints?: number;
     readonly includePrivate?: boolean;
     readonly includeSensitive?: boolean;
     readonly includeSnippets?: boolean;
     readonly ignoreMemory?: boolean;
+    readonly purpose?: 'automatic' | 'deliberate_query';
 }
 interface MemoryPackHint {
     readonly ref: MemoryItemRef;
@@ -2702,6 +2822,10 @@ interface MemoryPackHint {
 interface MemoryPack {
     readonly generatedAt: string;
     readonly taskFingerprint: string;
+    readonly memoryRevision: string;
+    readonly candidates: readonly MemoryPackHint[];
+    readonly promptHints: readonly MemoryPackHint[];
+    /** @deprecated Use promptHints. Retained for F228 source compatibility. */
     readonly hints: readonly MemoryPackHint[];
     readonly omitted: readonly string[];
     readonly traceMetadata: MemoryPackTraceMetadata;
@@ -2712,7 +2836,7 @@ interface MemoryPackTraceMetadata {
     readonly taskFingerprint: string;
     readonly suppressed: boolean;
 }
-type MemoryReviewTrigger = 'user_correction' | 'explicit_remember' | 'explicit_forget' | 'proposal_rejected' | 'conflict_detected';
+type MemoryReviewTrigger = 'user_correction' | 'explicit_remember' | 'explicit_forget' | 'proposal_rejected' | 'conflict_detected' | 'episode_completed';
 interface MemoryReviewCandidateRef {
     readonly ref: MemoryItemRef;
     readonly bodySnippet?: string;
@@ -2721,7 +2845,8 @@ interface MemoryReviewCandidateRef {
 }
 interface MemoryReviewInput {
     readonly trigger: MemoryReviewTrigger;
-    readonly userFeedback: string;
+    readonly userFeedback?: string;
+    readonly episodeDigest?: KodaXMemoryOutcomeDigest;
     readonly task?: string;
     readonly sourceRefs?: readonly string[];
     readonly candidateRefIds?: readonly string[];
@@ -2746,6 +2871,12 @@ interface MemoryReviewDraftAction {
     readonly risk: 'low' | 'medium' | 'high';
     readonly requiresApproval: true;
     readonly proposedBody?: string;
+    readonly claimKind?: MemoryClaimKind;
+    readonly claimKey?: string;
+    readonly actionSignature?: string;
+    readonly preconditions?: string;
+    readonly counterexamples?: readonly string[];
+    readonly relationship?: 'same_claim' | 'condition_refinement' | 'conflict';
 }
 interface MemoryReviewPlan {
     readonly trigger: MemoryReviewTrigger;
@@ -2754,6 +2885,22 @@ interface MemoryReviewPlan {
     readonly candidateRefs: readonly MemoryReviewCandidateRef[];
     readonly actions: readonly MemoryReviewDraftAction[];
     readonly warnings: readonly string[];
+    readonly episodeDigest?: KodaXMemoryOutcomeDigest;
+}
+interface MemoryEpisodeReviewResult {
+    readonly plan: MemoryReviewPlan;
+    readonly proposalIds: readonly string[];
+    readonly appliedProposalIds: readonly string[];
+    readonly decisions: readonly MemoryReviewPersistenceDecision[];
+    readonly warnings: readonly string[];
+}
+type MemoryReviewPersistenceKind = 'create' | 'evidence_update' | 'condition_refinement' | 'conflict' | 'no_action' | 'reject' | 'quarantine';
+interface MemoryReviewPersistenceDecision {
+    readonly actionIndex: number;
+    readonly kind: MemoryReviewPersistenceKind;
+    readonly reason: string;
+    readonly existingRefId?: string;
+    readonly proposalId?: string;
 }
 type MemoryReviewRunner = (input: MemoryReviewModelInput) => Promise<MemoryReviewPlan>;
 interface MemoryController {
@@ -2767,6 +2914,11 @@ interface MemoryController {
     maybeRunAutoCurator(input?: MemoryAutoCuratorInput): Promise<MemoryAutoCuratorResult>;
     buildMemoryPack(input: MemoryPackInput): Promise<MemoryPack>;
     reviewMemoryFeedback(input: MemoryReviewInput): Promise<MemoryReviewPlan>;
+    persistReviewPlan(plan: MemoryReviewPlan): Promise<readonly string[]>;
+    reviewEpisode(digest: KodaXMemoryOutcomeDigest, signal?: AbortSignal): Promise<MemoryEpisodeReviewResult>;
+    archiveRef(id: string): Promise<MemoryLifecycleOperationResult>;
+    forgetRef(id: string): Promise<MemoryLifecycleOperationResult>;
+    purgeRef(id: string): Promise<MemoryLifecycleOperationResult>;
 }
 type MemoryEvent = {
     readonly type: 'proposal.created';
@@ -2796,7 +2948,10 @@ type MemoryEvent = {
 interface CompactionConfig {
     /** Whether automatic compaction is enabled. */
     enabled: boolean;
-    /** Trigger compaction when context usage exceeds this percentage of the window. */
+    /**
+     * Optional early trigger percentage. `100` means capacity-only; values below
+     * 100 explicitly opt in to semantic compaction before physical pressure.
+     */
     triggerPercent: number;
     /**
      * @deprecated V2 compaction no longer uses this option.
@@ -2812,12 +2967,14 @@ interface CompactionConfig {
      * summary pass. Defaults to 10.
      */
     rollingSummaryPercent?: number;
-    /** Prune oversized tool results when they exceed roughly this many tokens. Defaults to 500. */
+    /**
+     * Explicit legacy opt-in for destructive pre-summary tool-result pruning.
+     * Undefined keeps the complete evidence for semantic summarization.
+     */
     pruningThresholdTokens?: number;
     /**
-     * Gap ratio for prune fast-return. After pruning, if remaining tokens still exceed
-     * triggerTokens * pruningGapRatio, the system continues to the summarization path
-     * instead of returning early. Defaults to 0.8.
+     * Legacy deterministic-pruning gap ratio. Only relevant when
+     * `pruningThresholdTokens` is explicitly configured.
      */
     pruningGapRatio?: number;
     /** Optional override for the provider context window. */
@@ -3723,5 +3880,5 @@ interface CreateAgentExecutorPlaneOptions {
     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 };
+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 bs, SpanImpl as cK, Runner as co, createInvariantSessionForAgent as d$, Tracer as d0, _resetAdmittedAgentBindings as dR, _resetPresetDispatchers as dS, asSingleSelection as dT, attachRunnerRecoveryTranscript as dU, buildAssistantMessageFromLlmResult as dV, buildSystemPrompt as dW, buildToolResultMessage as dX, createAgent as dY, createHandoff as dZ, createInMemorySession as d_, WorkflowEventRecorder as db, createStateWriter as e0, createTrace as e1, createWorkflowProcessTracker as e2, defaultTracer as e3, detectInstructionsInjection as e4, discoverInstances as e5, executeRunnerToolCall as e6, extractAssistantTextFromMessage as e7, getActiveUserInteraction as e8, getAdmittedAgentBindings as e9, hashMemoryIdentityComponent as ea, isAskUserCustomInputAnswer as eb, isFinalWorkflowProcessStatus as ec, isRunnableTool as ed, isRunnerLlmResult as ee, matchesMemoryApplicability as ef, memoryApplicabilityFingerprint as eg, normalizeHostMetadata as eh, readRunnerRecoveryTranscript as ei, registerChildTask as ej, registerPresetDispatcher as ek, requestTaskStop as el, runAdmissionAudit as em, setActiveUserInteraction as en, setAdmittedAgentBindings as eo };
+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 _, KodaXSessionCompactionEntry 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, KodaXMemoryInfluenceRef as aU, KodaXMemoryOutcomeDigest as aV, KodaXMemoryOutcomeEvidence as aW, KodaXSessionArchiveMarkerEntry as aX, KodaXSessionArtifactLedgerEntry as aY, KodaXSessionBranchSummaryEntry as aZ, KodaXSessionClientNoticeEntry 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, MemoryReviewModelInput as b$, KodaXSessionData as b0, KodaXSessionEntry as b1, KodaXSessionEntryBase as b2, KodaXSessionGoalEntry as b3, KodaXSessionLabelEntry as b4, KodaXSessionLineage as b5, KodaXSessionMemoryOutcomeDigestEntry as b6, KodaXSessionMemoryReviewReceiptEntry as b7, KodaXSessionMessageEntry as b8, KodaXSessionMeta as b9, MemoryAutoCuratorInput as bA, MemoryAutoCuratorResult as bB, MemoryBodySnapshot as bC, MemoryClaimKind as bD, MemoryContextIdentity as bE, MemoryController as bF, MemoryCuratorInput as bG, MemoryDecisionTraceReceipt as bH, MemoryEpisodeReviewResult as bI, MemoryEvent as bJ, MemoryGovernanceFinding as bK, MemoryGovernanceFindingKind as bL, MemoryGovernanceReport as bM, MemoryItemRef as bN, MemoryLifecycle as bO, MemoryLifecycleOperationResult as bP, MemoryPack as bQ, MemoryPackHint as bR, MemoryPackInput as bS, MemoryPackTraceMetadata as bT, MemoryProposalAction as bU, MemoryRefFilter as bV, MemoryRefKind as bW, MemoryRejectResult as bX, MemoryReviewCandidateRef as bY, MemoryReviewDraftAction as bZ, MemoryReviewInput as b_, KodaXSessionNavigationOptions as ba, KodaXSessionRewindMarkerEntry as bb, KodaXSessionRuntimeInfo as bc, KodaXSessionScope as bd, KodaXSessionStorage as be, KodaXSessionTreeNode as bf, KodaXSessionUiHistoryItem as bg, KodaXSessionUiHistoryItemType as bh, KodaXSessionUiTextHistoryItem as bi, KodaXSessionUiTextHistoryItemType as bj, KodaXSessionUiToolCall as bk, KodaXSessionUiToolCallStatus as bl, KodaXSessionUiToolGroupHistoryItem as bm, KodaXSessionWorkspaceKind as bn, KodaXVideoInputArtifact as bo, KodaXVideoMediaType as bp, LocalAgentTaskInput as bq, LocalAgentTaskUpdate as br, ManifestPatch as bt, MemoryActionProposal as bu, MemoryApplicability as bv, MemoryApplyPreview as bw, MemoryApplyResult as bx, MemoryApproval as by, MemoryAuthority as bz, AdmissionCtx as c, TraceOptions as c$, MemoryReviewPersistenceDecision as c0, MemoryReviewPersistenceKind as c1, MemoryReviewPlan as c2, MemoryReviewRunner as c3, MemoryReviewTrigger as c4, MemoryScope as c5, MemorySourceAdapter as c6, MemoryVisibility as c7, MessageEntry as c8, ObserveCtx as c9, SessionDispatchResult as cA, SessionEntry as cB, SessionErrorMetadata as cC, SessionExtension as cD, SessionForkOptions as cE, SessionMeta as cF, SessionStateSnapshot as cG, Span as cH, SpanData as cI, SpanError as cJ, SpanImplOptions as cL, StartTraceOptions as cM, StateWriter as cN, StateWriterFs as cO, StateWriterOptions as cP, StopHookContext as cQ, StopHookFn as cR, StopHookResult as cS, StopHookSpanData as cT, SystemCap as cU, TaskAbortRegistry as cV, TerminalCtx as cW, ToolCallSpanData as cX, ToolCapability as cY, ToolPermission as cZ, Trace as c_, PersistedSessionState as ca, PresetDispatcher as cb, PresetTracingContext as cc, QualityInvariant as cd, ReadonlyMutationTracker as ce, ReadonlyRecorder as cf, ReasoningDepth as cg, RecentlyModifiedFile as ch, RequestTaskStopOptions as ci, RequestTaskStopResult as cj, RunEvent as ck, RunOptions as cl, RunResult as cm, RunnableTool as cn, RunnerEvent as cp, RunnerLlmResult as cq, RunnerLlmReturn as cr, RunnerRecoveryTranscriptCarrier as cs, RunnerToolCall as ct, RunnerToolContext as cu, RunnerToolObserver as cv, RunnerToolResult as cw, RunnerToolResultBatch as cx, RunnerToolResultBatchTransform as cy, Session as cz, AdmissionVerdict as d, TracerOptions as d1, UserInteraction as d2, WorkflowAgentBackend as d3, WorkflowApi as d4, WorkflowApproval as d5, WorkflowApprovalSummary as d6, WorkflowArtifactRef as d7, WorkflowBudget as d8, WorkflowEvent as d9, WorkflowRun as dA, WorkflowRunState as dB, WorkflowRunStatus as dC, WorkflowSpawnAgentInput as dD, WorkflowSynthesis as dE, WorkflowSynthesizeInput as dF, WorkflowTaskHandle as dG, WorkflowTaskResult as dH, WorkflowTaskSnapshot as dI, WorkflowTaskStatus as dJ, WorkflowTaskSummaryEventUpdate as dK, WorkflowTaskSummaryKind as dL, WorkflowTaskSummaryUpdate as dM, WorkflowTaskUsage as dN, WorkflowTaskVerification as dO, WorkflowTaskVerificationResult as dP, WorkflowWaitOptions as dQ, WorkflowEventCorrelation as da, WorkflowEventType as dc, WorkflowIsolation as dd, WorkflowLimits as de, WorkflowLogEvent as df, WorkflowMeta as dg, WorkflowModelHint as dh, WorkflowModule as di, WorkflowParallelOptions as dj, WorkflowProcessArtifact as dk, WorkflowProcessCounts as dl, WorkflowProcessEvent as dm, WorkflowProcessItem as dn, WorkflowProcessItemKind as dp, WorkflowProcessItemOrigin as dq, WorkflowProcessItemStatus as dr, WorkflowProcessProgress as ds, WorkflowProcessSnapshot as dt, WorkflowProcessSource as du, WorkflowProcessStatus as dv, WorkflowProcessSummaryStatus as dw, WorkflowProcessTokenUsage as dx, WorkflowProcessTracker as dy, WorkflowProcessTrackerOptions 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-DYv3a1ka.d.ts → types.d-C9YHEAmA.d.ts}

@@ -1,8 +1,8 @@
-import { a8 as KodaXWireReasoningEffort, a0 as KodaXToolDefinition, a2 as KodaXToolResultContentItem, j as KodaXMessage } from './types.d-Bp4Lm1jv.js';
-import { K as KodaXBaseProvider } from './base.d-DalIRhbb.js';
+import { a9 as KodaXWireReasoningEffort, a1 as KodaXToolDefinition, a3 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-TTvpAGWf.js';
+import { K as KodaXBaseProvider } from './base.d-CYjtB68X.js';
 import { C as CapabilityKind, a as CapabilityProvider } from './capability.d-3C62G8Eq.js';
-import { aT as KodaXJsonValue, aH as KodaXExtensionSessionRecord, aJ as KodaXExtensionStore } from './types.d-DG9B4SMm.js';
-import { aw as KodaXToolExecutionContext, bd as ToolSideEffect } from './bash-prefix-extractor.d-D57Gt6n8.js';
+import { aT as KodaXJsonValue, aH as KodaXExtensionSessionRecord, aJ as KodaXExtensionStore } from './types.d-BtC4yLYO.js';
+import { aB as KodaXToolExecutionContext, bi as ToolSideEffect } from './bash-prefix-extractor.d-BkIA8Wto.js';
 
 /**
  * KodaX Constructed-World types (FEATURE_087, v0.7.28).
@@ -323,6 +323,35 @@ type ToolHandlerStreaming = (input: Record<string, unknown>, context: KodaXToolE
 /** Union of both handler types. Existing tools use ToolHandlerSync; new long-running tools may use ToolHandlerStreaming. */
 type ToolHandler = ToolHandlerSync | ToolHandlerStreaming;
 
+interface RuntimeRemoteWorkspaceBroker {
+    resolveReadablePath(relativePath: string): Promise<string>;
+    stageOutput(suggestedName: string): Promise<{
+        readonly stagingId: string;
+        readonly path: string;
+    }>;
+}
+interface RuntimeRemoteToolContext {
+    readonly workspaceAccess: 'none' | 'read' | 'write';
+    readonly allowedNetworkOrigins: readonly string[];
+    readonly workspace: RuntimeRemoteWorkspaceBroker;
+    readonly signal: AbortSignal;
+}
+type RuntimeRemoteToolDecision = {
+    readonly allowed: true;
+    readonly input: Readonly<Record<string, unknown>>;
+} | {
+    readonly allowed: false;
+    readonly reason: string;
+};
+/** Explicit opt-in contract required before a non-native tool can serve remote callers. */
+interface RuntimeRemoteToolContract {
+    readonly kind: 'managed-service' | 'narrow';
+    readonly workspaceEffect: 'none' | 'read' | 'write';
+    readonly networkOrigins: readonly string[];
+    readonly credentialHandling: 'none' | 'internal-only';
+    readonly processImplementation: 'none' | 'fixed-host-operation';
+    authorizeCall(input: Readonly<Record<string, unknown>>, context: RuntimeRemoteToolContext): Promise<RuntimeRemoteToolDecision>;
+}
 /**
  * FEATURE_149 (v0.7.38) — interrupt-on-submit policy for in-flight tools.
  *
@@ -352,6 +381,8 @@ interface LocalToolDefinition extends KodaXToolDefinition {
      * not optional, to prevent silent drift when new tools are added).
      */
     sideEffect: ToolSideEffect;
+    /** Absent means this tool is not eligible for remote A2A execution. */
+    remoteContract?: RuntimeRemoteToolContract;
     /**
      * v0.7.42 — Optional plan-mode override.
      *
@@ -603,7 +634,7 @@ interface RegisteredHookDiagnostic {
     order: number;
     source: ExtensionContributionSource;
 }
-type ExtensionFailureStage = 'load' | 'reload' | 'event' | 'hook' | 'persistence';
+type ExtensionFailureStage = 'load' | 'reload' | 'event' | 'hook' | 'persistence' | 'dispose';
 interface ExtensionFailureDiagnostic {
     stage: ExtensionFailureStage;
     target: string;
@@ -971,5 +1002,5 @@ interface KodaXExtensionModule {
     activate?: (api: KodaXExtensionAPI) => KodaXExtensionActivationResult;
 }
 
-export { DEFAULT_HANDLER_TIMEOUT_MS as D, defaultPolicy as a1, exec as a2, webhook as a3, CapabilityDeniedError as c, ConstructionManifestError as e };
-export type { WebhookOptions as $, AgentArtifact as A, KodaXRetrievalItem as B, Capabilities as C, ExecOptions as E, KodaXRetrievalResult as F, KodaXRetrievalScope as G, KodaXRetrievalToolName as H, KodaXRetrievalTrust as I, LocalToolDefinition as J, KodaXExtensionAPI as K, LoadedExtensionDiagnostic as L, ModelProviderRegistration as M, RegisteredCommandDiagnostic as N, RegisteredHookDiagnostic as O, RegisteredToolDefinition as P, RegisteredToolDiagnostic as Q, RegisteredCapabilityProviderDiagnostic as R, ScriptSource as S, StagedHandle as T, TestResult as U, ToolContent as V, ToolDefinitionSource as W, ToolHandler as X, ToolHandlerSync as Y, ToolRegistrationOptions as Z, ToolRegistry as _, AgentContent as a, WebhookResult as a0, ArtifactStatus as b, ConstructionArtifact as d, ConstructionPolicy as f, ConstructionPolicyVerdict as g, ExecResult as h, ExtensionCommandContext as i, ExtensionCommandDefinition as j, ExtensionCommandInvocation as k, ExtensionCommandResult as l, ExtensionContributionSource as m, ExtensionEventMap as n, ExtensionFailureDiagnostic as o, ExtensionFailureStage as p, ExtensionHookMap as q, ExtensionLoadSource as r, ExtensionLogger as s, ExtensionRuntimeController as t, ExtensionRuntimeDiagnostics as u, ExtensionToolBeforeHookContext as v, KodaXExtensionActivationResult as w, KodaXExtensionModule as x, KodaXRetrievalArtifact as y, KodaXRetrievalFreshness as z };
+export { DEFAULT_HANDLER_TIMEOUT_MS as D, defaultPolicy as a5, exec as a6, webhook as a7, CapabilityDeniedError as c, ConstructionManifestError as e };
+export type { ToolHandler as $, AgentArtifact as A, KodaXRetrievalItem as B, Capabilities as C, ExecOptions as E, KodaXRetrievalResult as F, KodaXRetrievalScope as G, KodaXRetrievalToolName as H, KodaXRetrievalTrust as I, LocalToolDefinition as J, KodaXExtensionAPI as K, LoadedExtensionDiagnostic as L, ModelProviderRegistration as M, RegisteredCommandDiagnostic as N, RegisteredHookDiagnostic as O, RegisteredToolDefinition as P, RegisteredToolDiagnostic as Q, RegisteredCapabilityProviderDiagnostic as R, RuntimeRemoteToolContext as S, RuntimeRemoteToolContract as T, RuntimeRemoteToolDecision as U, RuntimeRemoteWorkspaceBroker as V, ScriptSource as W, StagedHandle as X, TestResult as Y, ToolContent as Z, ToolDefinitionSource as _, AgentContent as a, ToolHandlerSync as a0, ToolRegistrationOptions as a1, ToolRegistry as a2, WebhookOptions as a3, WebhookResult as a4, ArtifactStatus as b, ConstructionArtifact as d, ConstructionPolicy as f, ConstructionPolicyVerdict as g, ExecResult as h, ExtensionCommandContext as i, ExtensionCommandDefinition as j, ExtensionCommandInvocation as k, ExtensionCommandResult as l, ExtensionContributionSource as m, ExtensionEventMap as n, ExtensionFailureDiagnostic as o, ExtensionFailureStage as p, ExtensionHookMap as q, ExtensionLoadSource as r, ExtensionLogger as s, ExtensionRuntimeController as t, ExtensionRuntimeDiagnostics as u, ExtensionToolBeforeHookContext as v, KodaXExtensionActivationResult as w, KodaXExtensionModule as x, KodaXRetrievalArtifact as y, KodaXRetrievalFreshness as z };

package/dist/types-chunks/{types.d-DU9lLkmE.d.ts → types.d-CJR7t6iW.d.ts}

@@ -1,5 +1,5 @@
-import { aR as KodaXInputArtifact } from './types.d-DG9B4SMm.js';
-import { R as KodaXTaskResultMetadata } from './types.d-Bp4Lm1jv.js';
+import { aR as KodaXInputArtifact } from './types.d-BtC4yLYO.js';
+import { S as KodaXTaskResultMetadata } from './types.d-TTvpAGWf.js';
 
 /**
  * @kodax-ai/agent/messaging — Message queue types

package/dist/types-chunks/{types.d-Bp4Lm1jv.d.ts → types.d-TTvpAGWf.d.ts}

@@ -73,6 +73,11 @@ interface KodaXToolResultBlock {
      */
     content: string | readonly KodaXToolResultContentItem[];
     is_error?: boolean;
+    /**
+     * Local recovery/accounting metadata. Provider serializers intentionally
+     * omit this field from the wire payload.
+     */
+    metadata?: Record<string, unknown>;
 }
 interface KodaXImageBlock {
     type: 'image';
@@ -161,6 +166,9 @@ interface KodaXMessage {
      */
     timestamp?: string;
 }
+interface KodaXEphemeralSuffix {
+    readonly content: string;
+}
 interface KodaXTokenUsage {
     inputTokens: number;
     outputTokens: number;
@@ -567,6 +575,8 @@ interface KodaXProviderConfig {
     verifyStrategy?: KodaXVerifyStrategy;
 }
 interface KodaXProviderStreamOptions {
+    /** Request-only tail context. Providers must not mutate persisted messages. */
+    ephemeralSuffix?: KodaXEphemeralSuffix;
     onTextDelta?: (text: string) => void;
     onThinkingDelta?: (text: string) => void;
     onThinkingEnd?: (thinking: string) => void;
@@ -629,4 +639,4 @@ interface KodaXProviderStreamOptions {
     signal?: AbortSignal;
 }
 
-export type { KodaXTokenUsage as $, KodaXReasoningCapability as A, KodaXReasoningEffortPreset as B, KodaXReasoningEffortRequest as C, KodaXReasoningEffortWireStrategy as D, KodaXReasoningMode as E, KodaXReasoningProfile as F, KodaXReasoningRequest as G, KodaXRedactedThinkingBlock as H, KodaXReviewScale as I, KodaXRiskLevel as J, KodaXAssuranceIntent as K, KodaXStableEffortIntent as L, KodaXStreamResult as M, KodaXTaskActionability as N, KodaXTaskBudgetOverrides as O, KodaXTaskComplexity as P, KodaXTaskFamily as Q, KodaXTaskResultMetadata as R, KodaXTaskResultSource as S, KodaXTaskRoutingDecision as T, KodaXTaskType as U, KodaXTaskWorkIntent as V, KodaXTextBlock as W, KodaXThinkingBlock as X, KodaXThinkingBudgetMap as Y, KodaXThinkingDepth as Z, KodaXThinkingWireStrategy as _, KodaXCacheBoundary as a, KodaXToolDefinition as a0, KodaXToolResultBlock as a1, KodaXToolResultContentItem as a2, KodaXToolResultImageItem as a3, KodaXToolResultTextItem as a4, KodaXToolUseBlock as a5, KodaXVerifyCredentialResult as a6, KodaXVerifyStrategy as a7, KodaXWireReasoningEffort as a8, KodaXChildFanoutClass as b, KodaXContentBlock as c, KodaXCustomProviderConfig as d, KodaXExecutionMode as e, KodaXExecutionPattern as f, KodaXHarnessProfile as g, KodaXImageBlock as h, KodaXListModelsResult as i, KodaXMessage as j, KodaXModelDescriptor as k, KodaXMutationSurface as l, KodaXNormalizedReasoningRequest as m, KodaXProtocolFamily as n, KodaXProviderCapabilityProfile as o, KodaXProviderConfig as p, KodaXProviderContextFidelity as q, KodaXProviderConversationSemantics as r, KodaXProviderEvidenceSupport as s, KodaXProviderLongRunningSupport as t, KodaXProviderMcpSupport as u, KodaXProviderMultimodalSupport as v, KodaXProviderSessionSupport as w, KodaXProviderStreamOptions as x, KodaXProviderToolCallingFidelity as y, KodaXProviderTransport as z };
+export type { KodaXThinkingWireStrategy as $, KodaXProviderTransport as A, KodaXReasoningCapability as B, KodaXReasoningEffortPreset as C, KodaXReasoningEffortRequest as D, KodaXReasoningEffortWireStrategy as E, KodaXReasoningMode as F, KodaXReasoningProfile as G, KodaXReasoningRequest as H, KodaXRedactedThinkingBlock as I, KodaXReviewScale as J, KodaXAssuranceIntent as K, KodaXRiskLevel as L, KodaXStableEffortIntent as M, KodaXStreamResult as N, KodaXTaskActionability as O, KodaXTaskBudgetOverrides as P, KodaXTaskComplexity as Q, KodaXTaskFamily as R, KodaXTaskResultMetadata as S, KodaXTaskResultSource as T, KodaXTaskRoutingDecision as U, KodaXTaskType as V, KodaXTaskWorkIntent as W, KodaXTextBlock as X, KodaXThinkingBlock as Y, KodaXThinkingBudgetMap as Z, KodaXThinkingDepth as _, KodaXCacheBoundary as a, KodaXTokenUsage as a0, KodaXToolDefinition as a1, KodaXToolResultBlock as a2, KodaXToolResultContentItem as a3, KodaXToolResultImageItem as a4, KodaXToolResultTextItem as a5, KodaXToolUseBlock as a6, KodaXVerifyCredentialResult as a7, KodaXVerifyStrategy as a8, KodaXWireReasoningEffort as a9, KodaXChildFanoutClass as b, KodaXContentBlock as c, KodaXCustomProviderConfig as d, KodaXEphemeralSuffix as e, KodaXExecutionMode as f, KodaXExecutionPattern as g, KodaXHarnessProfile as h, KodaXImageBlock as i, KodaXListModelsResult as j, KodaXMessage as k, KodaXModelDescriptor as l, KodaXMutationSurface as m, KodaXNormalizedReasoningRequest as n, KodaXProtocolFamily as o, KodaXProviderCapabilityProfile as p, KodaXProviderConfig as q, KodaXProviderContextFidelity as r, KodaXProviderConversationSemantics as s, KodaXProviderEvidenceSupport as t, KodaXProviderLongRunningSupport as u, KodaXProviderMcpSupport as v, KodaXProviderMultimodalSupport as w, KodaXProviderSessionSupport as x, KodaXProviderStreamOptions as y, KodaXProviderToolCallingFidelity as z };

package/dist/types-chunks/{utils.d-DMI-9GTR.d.ts → utils.d-BbB5jzi1.d.ts}

@@ -1,9 +1,9 @@
-import { j as KodaXMessage, E as KodaXReasoningMode, d as KodaXCustomProviderConfig, o as KodaXProviderCapabilityProfile } from './types.d-Bp4Lm1jv.js';
-import { I as KodaXContextTokenSnapshot, ad as KodaXSkillDynamicContextPolicy, r as KodaXAgentMode, a0 as KodaXRepoIntelligenceMode, X as KodaXOptions, ae as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-D57Gt6n8.js';
-import { bb as KodaXSessionUiHistoryItem, b2 as KodaXSessionLineage, aV as KodaXSessionArtifactLedgerEntry, aI as KodaXExtensionSessionState, aH as KodaXExtensionSessionRecord, b7 as KodaXSessionRuntimeInfo, dd as WorkflowProcessSource } from './types.d-DG9B4SMm.js';
-import { A as AgentsFile, f as AutoModeStats, l as KodaXMcpServersConfig } from './guardrail.d-vSaBe64I.js';
+import { k as KodaXMessage, F as KodaXReasoningMode, d as KodaXCustomProviderConfig, p as KodaXProviderCapabilityProfile } from './types.d-TTvpAGWf.js';
+import { I as KodaXContextTokenSnapshot, ae as KodaXSkillDynamicContextPolicy, r as KodaXAgentMode, a1 as KodaXRepoIntelligenceMode, Y as KodaXOptions, af as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-BkIA8Wto.js';
+import { bg as KodaXSessionUiHistoryItem, b5 as KodaXSessionLineage, aY as KodaXSessionArtifactLedgerEntry, aI as KodaXExtensionSessionState, aH as KodaXExtensionSessionRecord, bc as KodaXSessionRuntimeInfo, du as WorkflowProcessSource } from './types.d-BtC4yLYO.js';
+import { A as AgentsFile, f as AutoModeStats, l as KodaXMcpServersConfig } from './guardrail.d-R7AiGfrI.js';
 import * as readline from 'readline';
-import { f as PermissionMode } from './public-api.d-CPBMPDiU.js';
+import { f as PermissionMode } from './public-api.d-7G4--RZE.js';
 import { SpawnSyncReturns } from 'child_process';
 
 /**
@@ -512,6 +512,14 @@ declare function loadConfig(): {
  * not block startup.
  */
 declare const KODAX_EXAMPLE_CONFIG_FILE: string;
+declare const KODAX_INTEGRATION_EXAMPLE_FILES: {
+    readonly mcp: string;
+    readonly a2a: string;
+    readonly extensions: string;
+};
+
+declare function ensureExampleConfigFiles(): readonly string[];
+/** @deprecated Use ensureExampleConfigFiles() to observe every created path. */
 declare function ensureExampleConfigFile(): string | undefined;
 declare function prepareRuntimeConfig(): ReturnType<typeof loadConfig>;
 declare function saveConfig(config: {
@@ -594,5 +602,5 @@ declare function resolveRuntimeEffortSelection(input: {
 declare function getGitRoot(cwd?: string): Promise<string | null>;
 declare function rateLimitedCall<T>(fn: () => Promise<T>): Promise<T>;
 
-export { resolveRuntimeModelSelection as A, resolveRuntimeProviderSelection as B, saveConfig as D, touchContext as E, KODAX_CONFIG_FILE as K, PREVIEW_MAX_LENGTH as P, KODAX_DIR as i, KODAX_EXAMPLE_CONFIG_FILE as j, KODAX_SESSIONS_DIR as k, KODAX_VERSION as l, createInteractiveContext as n, ensureExampleConfigFile as o, getGitRoot as p, getProviderList as q, getProviderModel as r, getVersion as s, hydrateProcessEnvFromShell as t, isProviderConfigured as u, loadConfig as v, prepareRuntimeConfig as w, rateLimitedCall as x, registerConfiguredCustomProviders as y, resolveRuntimeEffortSelection as z };
-export type { Command as C, InteractiveContext as I, RuntimeSurfaceMode as R, CommandCallbacks as a, CommandDefinition as b, CommandInfo as c, CommandInvocationRequest as d, CommandSource as e, CommandWorkflowInvocationRequest as f, CurrentConfig as g, InteractiveMode as h, RuntimeSurfaceStatus as m };
+export { registerConfiguredCustomProviders as A, resolveRuntimeEffortSelection as B, resolveRuntimeModelSelection as D, resolveRuntimeProviderSelection as E, saveConfig as F, touchContext as G, KODAX_CONFIG_FILE as K, PREVIEW_MAX_LENGTH as P, KODAX_DIR as i, KODAX_EXAMPLE_CONFIG_FILE as j, KODAX_INTEGRATION_EXAMPLE_FILES as k, KODAX_SESSIONS_DIR as l, KODAX_VERSION as m, createInteractiveContext as o, ensureExampleConfigFile as p, ensureExampleConfigFiles as q, getGitRoot as r, getProviderList as s, getProviderModel as t, getVersion as u, hydrateProcessEnvFromShell as v, isProviderConfigured as w, loadConfig as x, prepareRuntimeConfig as y, rateLimitedCall as z };
+export type { Command as C, InteractiveContext as I, RuntimeSurfaceMode as R, CommandCallbacks as a, CommandDefinition as b, CommandInfo as c, CommandInvocationRequest as d, CommandSource as e, CommandWorkflowInvocationRequest as f, CurrentConfig as g, InteractiveMode as h, RuntimeSurfaceStatus as n };