@kodax-ai/kodax 0.7.80 → 0.7.81

package/dist/types-chunks/{bash-prefix-extractor.d-DStqKIlu.d.ts → bash-prefix-extractor.d-D_bvmnHs.d.ts}

@@ -1676,6 +1676,8 @@ interface KodaXActivityEventMeta extends KodaXWorkflowEventMeta, Partial<KodaXLi
     readonly sessionId?: string;
     /** Exact queue identities consumed by a mid-turn user-message boundary. */
     readonly queuedMessageIds?: readonly string[];
+    /** Exact durable lineage entry created for each consumed queue identity. */
+    readonly queuedMessageEntryIds?: Readonly<Record<string, string>>;
     /**
      * FEATURE_247 (R8) — SDK-consumer agent profile that produced this event.
      * Absent ⇒ default Coding Agent (or an event emitted before a profile is known).

package/dist/types-chunks/{capsule.d-BuFJaYxA.d.ts → capsule.d-BFpbFq-C.d.ts}

@@ -491,6 +491,8 @@ declare function generateSessionId(): Promise<string>;
 declare function extractTitleFromMessages(messages: KodaXMessage[]): string;
 
 type NavigableSessionEntry = Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry | KodaXSessionClientNoticeEntry | KodaXSessionRewindMarkerEntry | KodaXSessionMemoryOutcomeDigestEntry | KodaXSessionMemoryReviewReceiptEntry>;
+/** Return the sole physical lineage entry proven for this message reference. */
+declare function getSessionMessageEntryId(message: KodaXMessage): string | undefined;
 /**
  * Reconcile a linear message list against an existing lineage tree.
  *
@@ -761,5 +763,5 @@ declare function buildWorkflowCapsuleIntent(manifest: {
     readonly originalRequest?: string;
 }): WorkflowCapsuleIntent;
 
-export { createSessionLineage as $, DefaultSummaryCompaction as D, KODAX_API_MIN_INTERVAL as K, LINEAGE_ENTRY_TYPES as L, actorQueueId as N, appendSessionLineageLabel as O, PROMISE_PATTERN as P, applyLineageTruncation as Q, applySessionCompaction as R, archiveOldIslands as S, assertRestrictedWorkflowQuality as T, buildSessionTree as U, buildWorkflowCapsuleIntent as V, WORKFLOW_CAPSULE_API_VERSION as W, cleanupIncompleteToolCalls as X, countActiveLineageMessages as Y, countTokens as Z, _resetActiveRootQueueRoutesForTests as _, createWorkflowCapsule as a0, createWorkflowModuleFromCapsule as a1, estimateTokens as a2, evictOldIslandMessageContent as a3, extractArtifactLedger as a4, extractFileOps as a5, extractTitleFromMessages as a6, findPreviousUserEntryId as a7, forkSessionLineage as a8, generateSessionId as a9, generateSessionIdSync as aa, getAgentConfigHome as ab, getAgentConfigPath as ac, getAppDataDir as ad, getSessionLineagePath as ae, getSessionMessagesFromLineage as af, isPathInsideDirectory as ag, lintRestrictedWorkflowSource as ah, mergeArtifactLedger as ai, mergeFileOps as aj, registerActiveRootQueueRoute as ak, resolveActiveRootQueueRoute as al, resolveExecutionPath as am, resolveSessionLineageTarget as an, rewindSessionLineage as ao, setAgentConfigHome as ap, setSessionLineageActiveEntry as aq, validateAndFixToolHistory as ar, validateWorkflowCapsule as as, validateWorkflowScriptManifest as at, 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 { createSessionLineage as $, DefaultSummaryCompaction as D, KODAX_API_MIN_INTERVAL as K, LINEAGE_ENTRY_TYPES as L, actorQueueId as N, appendSessionLineageLabel as O, PROMISE_PATTERN as P, applyLineageTruncation as Q, applySessionCompaction as R, archiveOldIslands as S, assertRestrictedWorkflowQuality as T, buildSessionTree as U, buildWorkflowCapsuleIntent as V, WORKFLOW_CAPSULE_API_VERSION as W, cleanupIncompleteToolCalls as X, countActiveLineageMessages as Y, countTokens as Z, _resetActiveRootQueueRoutesForTests as _, createWorkflowCapsule as a0, createWorkflowModuleFromCapsule as a1, estimateTokens as a2, evictOldIslandMessageContent as a3, extractArtifactLedger as a4, extractFileOps as a5, extractTitleFromMessages as a6, findPreviousUserEntryId as a7, forkSessionLineage as a8, generateSessionId as a9, generateSessionIdSync as aa, getAgentConfigHome as ab, getAgentConfigPath as ac, getAppDataDir as ad, getSessionLineagePath as ae, getSessionMessageEntryId as af, getSessionMessagesFromLineage as ag, isPathInsideDirectory as ah, lintRestrictedWorkflowSource as ai, mergeArtifactLedger as aj, mergeFileOps as ak, registerActiveRootQueueRoute as al, resolveActiveRootQueueRoute as am, resolveExecutionPath as an, resolveSessionLineageTarget as ao, rewindSessionLineage as ap, setAgentConfigHome as aq, setSessionLineageActiveEntry as ar, validateAndFixToolHistory as as, validateWorkflowCapsule as at, validateWorkflowScriptManifest as au, 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, WorkflowQualityLintFinding as H, WorkflowQualityLintOptions as I, WorkflowQualityLintSeverity as J, WorkflowScriptManifest as M, 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 };

package/dist/types-chunks/{guardrail.d-DM-OK0m3.d.ts → guardrail.d-CrSR1T_a.d.ts}

@@ -4,7 +4,7 @@ import { a as CostTracker } from './cost-tracker.d-BeaenODW.js';
 import { e2 as RunnerToolCall, ez as ToolGuardrail } from './controller.d-C2aHqzHj.js';
 import { k as KodaXMessage } from './types.d-CgrXrFrq.js';
 import { S as SideQueryDiagnostics } from './side-query.d-CP1LiRiH.js';
-import { by as ToolSideEffect } from './bash-prefix-extractor.d-DStqKIlu.js';
+import { by as ToolSideEffect } from './bash-prefix-extractor.d-D_bvmnHs.js';
 
 /**
  * FEATURE_200 Phase F (v0.7.45) — MCP domain types extracted from types.ts.

package/dist/types-chunks/{public-api.d-CewTvUKV.d.ts → public-api.d-C-lVOhdt.d.ts}

@@ -1,4 +1,4 @@
-import { a as BashPrefixExtractor, t as KodaXAgentMode } from './bash-prefix-extractor.d-DStqKIlu.js';
+import { a as BashPrefixExtractor, t as KodaXAgentMode } from './bash-prefix-extractor.d-D_bvmnHs.js';
 import { G as KodaXReasoningMode, k as KodaXMessage, T as KodaXTaskResultMetadata } from './types.d-CgrXrFrq.js';
 import { cY as LearningSurfaceSnapshot$1, cT as LearningQuery, cS as LearningPage, cv as LearnedCapabilityRecord, cO as LearningEvent, cX as LearningSubscribeOptions, bY as KodaXSessionData, c1 as KodaXSessionLineage, c6 as KodaXSessionNavigationOptions, c8 as KodaXSessionRuntimeInfo, ca as KodaXSessionStorage, bZ as KodaXSessionEntry, bU as KodaXSessionArtifactLedgerEntry, bC as KodaXExtensionSessionRecord, cc as KodaXSessionUiHistoryItem, c9 as KodaXSessionScope, k as AgentActorSnapshot, aX as CompactionReport, bO as KodaXJsonValue } from './controller.d-C2aHqzHj.js';
 

package/dist/types-chunks/{repl.d-DvXQtgr7.d.ts → repl.d-DGi0nhpl.d.ts}

@@ -1,8 +1,8 @@
-import { n as ResolvedAutoModeSettings, b as CommandDefinition, e as CommandSource, c as CommandInfo, C as Command$1, I as InteractiveContext, a as CommandCallbacks, g as CurrentConfig, d as CommandInvocationRequest, f as CommandWorkflowInvocationRequest, p as RuntimeSurfaceStatus } from './utils.d-BpACJmzt.js';
-import { ae as SessionStorage$1, S as PermissionMode, L as LearningBinding } from './public-api.d-CewTvUKV.js';
-import { a1 as KodaXOptions, ad as KodaXResult } from './bash-prefix-extractor.d-DStqKIlu.js';
+import { n as ResolvedAutoModeSettings, b as CommandDefinition, e as CommandSource, c as CommandInfo, C as Command$1, I as InteractiveContext, a as CommandCallbacks, g as CurrentConfig, d as CommandInvocationRequest, f as CommandWorkflowInvocationRequest, p as RuntimeSurfaceStatus } from './utils.d-Z-YpaiUS.js';
+import { ae as SessionStorage$1, S as PermissionMode, L as LearningBinding } from './public-api.d-C-lVOhdt.js';
+import { a1 as KodaXOptions, ad as KodaXResult } from './bash-prefix-extractor.d-D_bvmnHs.js';
 import { ca as KodaXSessionStorage, bY as KodaXSessionData } from './controller.d-C2aHqzHj.js';
-import { s as AutoModeStats } from './guardrail.d-DM-OK0m3.js';
+import { s as AutoModeStats } from './guardrail.d-CrSR1T_a.js';
 
 interface ReplRuntimePermissionGrantSuggestion {
     readonly id: string;

package/dist/types-chunks/{sdk-session-C59RUrri.d.ts → sdk-session-D5Ffq4h-.d.ts}

@@ -1,4 +1,4 @@
-import { h as CreatableHistoryItem, ar as ToolCall } from './public-api.d-CewTvUKV.js';
+import { h as CreatableHistoryItem, ar as ToolCall } from './public-api.d-C-lVOhdt.js';
 import { k as KodaXMessage, c as KodaXContentBlock } from './types.d-CgrXrFrq.js';
 import { cc as KodaXSessionUiHistoryItem, cg as KodaXSessionUiToolCall } from './controller.d-C2aHqzHj.js';
 

package/dist/types-chunks/{shell-command-sets.d-Dp4UvPLL.d.ts → shell-command-sets.d-jmXn8K7r.d.ts}

@@ -1,4 +1,4 @@
-import { a as BashPrefixExtractor } from './bash-prefix-extractor.d-DStqKIlu.js';
+import { a as BashPrefixExtractor } from './bash-prefix-extractor.d-D_bvmnHs.js';
 
 /**
  * Permission Utilities

package/dist/types-chunks/{types.d-yuJzE82x.d.ts → types.d-BqYq_ljy.d.ts}

@@ -2,7 +2,7 @@ import { aa as KodaXWireReasoningEffort, a2 as KodaXToolDefinition, a4 as KodaXT
 import { K as KodaXBaseProvider } from './base.d-DxG0m09Z.js';
 import { C as CapabilityKind, a as CapabilityProvider } from './capability.d-K664nHOS.js';
 import { bO as KodaXJsonValue, bC as KodaXExtensionSessionRecord, bE as KodaXExtensionStore } from './controller.d-C2aHqzHj.js';
-import { aQ as KodaXToolExecutionContext, by as ToolSideEffect } from './bash-prefix-extractor.d-DStqKIlu.js';
+import { aQ as KodaXToolExecutionContext, by as ToolSideEffect } from './bash-prefix-extractor.d-D_bvmnHs.js';
 
 /**
  * KodaX Constructed-World types (FEATURE_087, v0.7.28).

package/dist/types-chunks/{utils.d-BpACJmzt.d.ts → utils.d-Z-YpaiUS.d.ts}

@@ -1,9 +1,9 @@
 import { k as KodaXMessage, G as KodaXReasoningMode, d as KodaXCustomProviderConfig, q as KodaXProviderCapabilityProfile } from './types.d-CgrXrFrq.js';
 import { cc as KodaXSessionUiHistoryItem, c1 as KodaXSessionLineage, bU as KodaXSessionArtifactLedgerEntry, bD as KodaXExtensionSessionState, bC as KodaXExtensionSessionRecord, c8 as KodaXSessionRuntimeInfo, fc as WorkflowProcessSource } from './controller.d-C2aHqzHj.js';
-import { O as KodaXContextTokenSnapshot, at as KodaXSkillDynamicContextPolicy, t as KodaXAgentMode, a8 as KodaXRepoIntelligenceMode, a1 as KodaXOptions, au as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-DStqKIlu.js';
-import { d as AgentsFile, s as AutoModeStats, S as KodaXMcpServersConfig } from './guardrail.d-DM-OK0m3.js';
+import { O as KodaXContextTokenSnapshot, at as KodaXSkillDynamicContextPolicy, t as KodaXAgentMode, a8 as KodaXRepoIntelligenceMode, a1 as KodaXOptions, au as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-D_bvmnHs.js';
+import { d as AgentsFile, s as AutoModeStats, S as KodaXMcpServersConfig } from './guardrail.d-CrSR1T_a.js';
 import * as readline from 'readline';
-import { S as PermissionMode, L as LearningBinding, G as LearningSurfaceSnapshot } from './public-api.d-CewTvUKV.js';
+import { S as PermissionMode, L as LearningBinding, G as LearningSurfaceSnapshot } from './public-api.d-C-lVOhdt.js';
 import { SpawnSyncReturns } from 'child_process';
 
 /**

package/docs/SDK_EMBEDDER_GUIDE.md

@@ -4398,10 +4398,19 @@ For input that must join the current active Run, submit `delivery:'interrupt'`.
 This does not create a Run. Each accepted input appears as `queued` in the
 owning Run's `interruptInputs`. At the next safe boundary, all accumulated
 interrupts are drained FIFO, remain separate user messages in one next LLM
-request, and produce one `run.input.delivered` event whose `inputs` array is the
-complete ordered batch. Exact operation retries return the same `inputId`.
-The accepted result's `runId` is the existing owning Run (equal to
-`afterRunId`), not a newly created continuation.
+request, and produce one `run.input.delivered` event whose `inputs` array is the
+complete ordered batch. Exact operation retries return the same `inputId`.
+The accepted result's `runId` is the existing owning Run (equal to
+`afterRunId`), not a newly created continuation.
+
+Since v0.7.81, every newly delivered item also carries `entryId`: the exact
+physical Session-lineage user entry created by canonical persistence. The same
+value appears in `runtime.runs.get(runId).interruptInputs`; do not infer it
+from a transcript ordinal or fabricate one. Runtime-owned Sessions write the
+required snapshot before publishing the delivery event, so a failed or
+ambiguous canonical reference fails delivery closed. The field may be absent
+only when reading a legacy persisted record. Event replay, Session compaction,
+and Runtime restart preserve a newly recorded reference.
 
 Interrupt admission closes when the Runner publishes its final completion or
 terminal error signal, or when the Run's supplied `abortSignal` aborts, even if

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kodax-ai/kodax",
-  "version": "0.7.80",
+  "version": "0.7.81",
   "description": "KodaX lightweight coding agent - TypeScript implementation with 16 built-in LLM provider aliases, published as a Node-free single-file CLI and SDK",
   "type": "module",
   "private": false,

package/dist/chunks/argument-completer-FXRZFMTC.js

@@ -1,2 +0,0 @@
-// @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{Ea as a,Fa as b}from"./chunk-IHPH3444.js";import"./chunk-CDCCTM5I.js";import"./chunk-PMKAG4SZ.js";import"./chunk-RPF5RGWZ.js";import"./chunk-VECRQTSD.js";import"./chunk-RXXKDR6Y.js";import"./chunk-HTVLCHWH.js";import"./chunk-BWX4YZX3.js";import"./chunk-GC4JBMBS.js";import"./chunk-KHEFUT6O.js";import"./chunk-TRNAWSXP.js";import"./chunk-CEB5FDND.js";import"./chunk-EVXIJPZ6.js";import"./chunk-E7C4DRD2.js";import"./chunk-6UENDY33.js";import"./chunk-ONUPGMER.js";export{a as ArgumentCompleter,b as createArgumentCompleter};