@kodax-ai/kodax 0.7.61 → 0.7.62

package/dist/types-chunks/{bash-prefix-extractor.d-e1LD2IRl.d.ts → bash-prefix-extractor.d-Do_TCAmA.d.ts}

@@ -1,4 +1,4 @@
-import { W as KodaXGoalState, g as AgentMessage, b9 as StopHookFn, ab as KodaXSessionLineage, a0 as KodaXJsonValue, Q as KodaXExtensionSessionRecord, bx as WorkflowIsolation, R as KodaXExtensionSessionState, a2 as KodaXSessionArtifactLedgerEntry, aW as SessionErrorMetadata, ag as KodaXSessionScope, ah as KodaXSessionStorage, _ as KodaXInputArtifact, C as ChildTaskRegistry, bu as WorkflowEventCorrelation, t as CompactionUpdate, bG as WorkflowProcessEvent, bt as WorkflowEvent, n as AskUserQuestionOptions, l as AskUserMultiOptions, z as Guardrail, w as DiscoveredInstance, bd as TaskAbortRegistry } from './process.d-C93UMgPK.js';
+import { _ as KodaXGoalState, h as AgentMessage, bL as StopHookFn, af as KodaXSessionLineage, a4 as KodaXJsonValue, U as KodaXExtensionSessionRecord, c7 as WorkflowIsolation, V as KodaXExtensionSessionState, a6 as KodaXSessionArtifactLedgerEntry, bw as SessionErrorMetadata, ak as KodaXSessionScope, al as KodaXSessionStorage, a2 as KodaXInputArtifact, C as ChildTaskRegistry, c4 as WorkflowEventCorrelation, x as CompactionUpdate, cg as WorkflowProcessEvent, c3 as WorkflowEvent, q as AskUserQuestionOptions, m as AskUserAnswer, o as AskUserMultiOptions, a$ as MemoryReviewPlan, b0 as MemoryReviewRunner, J as Guardrail, B as DiscoveredInstance, bP as TaskAbortRegistry } from './process.d-DXkRD7hj.js';
 import { $ as KodaXTokenUsage, j as KodaXMessage, a8 as KodaXWireReasoningEffort, T as KodaXTaskRoutingDecision, U as KodaXTaskType, V as KodaXTaskWorkIntent, P as KodaXTaskComplexity, J as KodaXRiskLevel, g as KodaXHarnessProfile, e as KodaXExecutionMode, b as KodaXChildFanoutClass, E as KodaXReasoningMode, I as KodaXReviewScale } from './types.d-Bp4Lm1jv.js';
 import { d as SkillDynamicContextExecutor } from './types.d-vJExiRje.js';
 import { Diagnostic, Position, Location, Hover, DocumentSymbol, SymbolInformation, WorkspaceSymbol, CallHierarchyItem, CallHierarchyIncomingCall, CallHierarchyOutgoingCall } from 'vscode-languageserver-protocol';
@@ -1681,11 +1681,11 @@ interface KodaXEvents {
     };
     /** Tool execution hook - called before tool execution, return false to block - 工具执行前回调 */
     beforeToolExecute?: (tool: string, input: Record<string, unknown>, meta?: KodaXToolEventMeta) => Promise<boolean | string>;
-    /** Ask user a question interactively - Issue 069 - 交互式向用户提问. Multi-select
-     *  (options.multiSelect) resolves string[]; single-select resolves string. */
-    askUser?: (options: AskUserQuestionOptions, meta?: KodaXToolEventMeta) => Promise<string | string[]>;
+    /** Ask user a question interactively - Issue 069. Select answers may be
+     *  strings, arrays, or structured custom-input answers. */
+    askUser?: (options: AskUserQuestionOptions, meta?: KodaXToolEventMeta) => Promise<AskUserAnswer>;
     /** Ask user multiple independent questions sequentially - 澶氶棶棰橀『搴忔彁闂?*/
-    askUserMulti?: (options: AskUserMultiOptions, meta?: KodaXToolEventMeta) => Promise<Record<string, string | string[]> | undefined>;
+    askUserMulti?: (options: AskUserMultiOptions, meta?: KodaXToolEventMeta) => Promise<Record<string, AskUserAnswer> | undefined>;
     /** Ask user for free-text input - 自由文本输入 (Issue 112) */
     askUserInput?: (options: {
         question: string;
@@ -1701,6 +1701,8 @@ interface KodaXEvents {
      *     explicit error instead of a silent no-op.
      */
     exitPlanMode?: (plan: string) => Promise<boolean | 'not-in-plan-mode'>;
+    /** Semantic memory review plan produced from explicit user feedback. */
+    onMemoryReview?: (plan: MemoryReviewPlan) => void;
 }
 /**
  * Structured event emitted during provider recovery.
@@ -2479,6 +2481,7 @@ interface KodaXOptions {
     session?: KodaXSessionOptions;
     context?: KodaXContextOptions;
     events?: KodaXEvents;
+    memoryReviewer?: MemoryReviewRunner;
     extensionRuntime?: ExtensionRuntimeContract;
     /** FEATURE_229: host-owned policy for workflow auto-start and ceilings. */
     workflowHostPolicy?: WorkflowHostPolicy;
@@ -2871,11 +2874,11 @@ interface KodaXToolExecutionContext {
     workflowWorktreeBaseDir?: string;
     /** Shared extension capability runtime used by retrieval-family tools. */
     extensionRuntime?: CapabilityRuntimeContract;
-    /** Ask user a question interactively (select mode) - 交互式向用户提问 (Issue 069).
-     *  Multi-select resolves string[]; single-select resolves string. */
-    askUser?: (options: AskUserQuestionOptions) => Promise<string | string[]>;
+    /** Ask user a question interactively (select mode) - Issue 069. Select
+     *  answers may be strings, arrays, or structured custom-input answers. */
+    askUser?: (options: AskUserQuestionOptions) => Promise<AskUserAnswer>;
     /** Ask user multiple independent questions sequentially - 澶氶棶棰橀『搴忔彁闂?*/
-    askUserMulti?: (options: AskUserMultiOptions) => Promise<Record<string, string | string[]> | undefined>;
+    askUserMulti?: (options: AskUserMultiOptions) => Promise<Record<string, AskUserAnswer> | undefined>;
     /** Ask user for free-text input - 自由文本输入 (Issue 112) */
     askUserInput?: (options: {
         question: string;

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

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

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

@@ -2053,6 +2053,14 @@ interface AskUserQuestionItem {
      * of parsing it out of natural-language question text.
      */
     maxSelections?: number;
+    /**
+     * Choice surfaces are open-ended by default: hosts SHOULD offer a synthetic
+     * custom-input option unless this is explicitly false.
+     */
+    allowCustomInput?: boolean;
+    customInputLabel?: string;
+    customInputPrompt?: string;
+    customInputDefault?: string;
 }
 /** Options for multi-question mode — multiple independent questions in one call. */
 interface AskUserMultiOptions {
@@ -2074,7 +2082,23 @@ interface AskUserQuestionOptions {
     /** FEATURE_222 — see {@link AskUserQuestionItem.maxSelections}. */
     maxSelections?: number;
     default?: string;
+    /**
+     * Choice surfaces are open-ended by default: hosts SHOULD offer a synthetic
+     * custom-input option unless this is explicitly false.
+     */
+    allowCustomInput?: boolean;
+    customInputLabel?: string;
+    customInputPrompt?: string;
+    customInputDefault?: string;
 }
+/** Host return value for a user-entered answer chosen through a select dialog's
+ *  synthetic "Other..." option. */
+interface AskUserCustomInputAnswer {
+    kind: 'customInput';
+    value: string;
+}
+type AskUserSelectionAnswer = string | AskUserCustomInputAnswer;
+type AskUserAnswer = AskUserSelectionAnswer | AskUserSelectionAnswer[];
 /**
  * FEATURE_222 — reserved option value a host may append as a synthetic option
  * (e.g. a "← Back" entry) in `askUserMulti`'s per-question flow to mean "return
@@ -2086,6 +2110,9 @@ interface AskUserQuestionOptions {
  * back-navigation — the default multi-question flow is unaffected either way.
  */
 declare const ASK_USER_BACK_SIGNAL = "__back__";
+/** Reserved synthetic option value for a host-provided custom input entry. */
+declare const ASK_USER_CUSTOM_INPUT_SIGNAL = "__custom_input__";
+declare function isAskUserCustomInputAnswer(value: unknown): value is AskUserCustomInputAnswer;
 /**
  * FEATURE_222 — narrow an `askUser` result to a single string for the many
  * callers that only ever ask single-select questions (they never set
@@ -2093,7 +2120,7 @@ declare const ASK_USER_BACK_SIGNAL = "__back__";
  * an unexpected array to its first element so a mis-configured host degrades
  * predictably instead of leaking `[object Array]` into a string comparison.
  */
-declare function asSingleSelection(answer: string | string[]): string;
+declare function asSingleSelection(answer: AskUserAnswer): string;
 /**
  * The host-provided user-interaction surface. Each method is optional — a
  * headless host omits them and callers degrade gracefully. This is the single
@@ -2102,18 +2129,17 @@ declare function asSingleSelection(answer: string | string[]): string;
  */
 interface UserInteraction {
     /**
-     * Ask one question (select mode by default). Single-select (multiSelect
-     * falsy) resolves the chosen value as a string — unchanged. Multi-select
-     * (multiSelect: true) resolves the selected values as a `string[]`. The union
-     * is a backward-compatible superset: a host still returning a plain string
-     * satisfies this contract, but a multi-select host SHOULD return `string[]`
-     * so option values containing `, ` are not corrupted by a join.
+     * Ask one question (select mode by default). Single-select resolves the
+     * chosen option value as a string. Multi-select resolves the selected values
+     * as an array. If the user chooses the host-provided custom-input option,
+     * return `{ kind: 'customInput', value }` in the single or array position.
+     * Plain string/string[] hosts remain valid for backward compatibility.
      */
-    askUser?: (options: AskUserQuestionOptions) => Promise<string | string[]>;
+    askUser?: (options: AskUserQuestionOptions) => Promise<AskUserAnswer>;
     /** Ask several independent questions sequentially. Resolves a per-question
-     *  value map (each entry a string for single-select, `string[]` for
-     *  multi-select), or undefined when the user cancels. */
-    askUserMulti?: (options: AskUserMultiOptions) => Promise<Record<string, string | string[]> | undefined>;
+     *  value map using the same `AskUserAnswer` shape as `askUser`, or undefined
+     *  when the user cancels. */
+    askUserMulti?: (options: AskUserMultiOptions) => Promise<Record<string, AskUserAnswer> | undefined>;
     /** Ask for free-text input. Resolves the text, or undefined when cancelled. */
     askUserInput?: (options: {
         question: string;
@@ -2530,6 +2556,232 @@ interface DiscoveryOptions {
  */
 declare function discoverInstances(options?: DiscoveryOptions): DiscoveredInstance[];
 
+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 MemoryLifecycle = 'pending' | 'active' | 'provisional' | 'trusted' | 'stale' | 'quarantined' | 'archived' | 'readonly';
+type MemoryAuthority = 'read_only' | 'proposal_only' | 'approved_write';
+type MemoryVisibility = 'prompt_safe' | 'private' | 'sensitive';
+interface MemoryItemRef {
+    readonly kind: MemoryRefKind;
+    readonly id: string;
+    readonly scope: MemoryScope;
+    readonly title?: string;
+    readonly owner: 'user' | 'project' | 'kodax' | 'external';
+    readonly lifecycle: MemoryLifecycle;
+    readonly authority: MemoryAuthority;
+    readonly visibility: MemoryVisibility;
+    readonly sourceRefs: readonly string[];
+    readonly relatedRefs: readonly string[];
+    readonly version?: string;
+    readonly bodyFingerprint?: string;
+    readonly storageUri?: string;
+    readonly createdAt?: string;
+    readonly updatedAt?: string;
+    readonly lastUsedAt?: string;
+    readonly pinned?: boolean;
+}
+interface MemoryRefFilter {
+    readonly kinds?: readonly MemoryRefKind[];
+    readonly scopes?: readonly MemoryScope[];
+    readonly lifecycles?: readonly MemoryLifecycle[];
+    readonly includePrivate?: boolean;
+    readonly includeSensitive?: boolean;
+    readonly query?: string;
+}
+interface MemoryBodySnapshot {
+    readonly ref: MemoryItemRef;
+    readonly body: string;
+    readonly bodyFingerprint: string;
+    readonly frontmatter?: Readonly<Record<string, string>>;
+    readonly readAt: string;
+    readonly warnings: readonly string[];
+}
+type MemoryProposalAction = 'no_op' | 'link_refs' | 'write_memdir' | 'patch_memdir' | 'handoff_to_skill_loop' | 'quarantine' | 'archive' | 'conflict_report';
+interface MemoryApplyPreview {
+    readonly summary: string;
+    readonly changedRefs: readonly MemoryItemRef[];
+    readonly changedPaths: readonly string[];
+    readonly beforeFingerprints: Readonly<Record<string, string>>;
+    readonly afterFingerprints?: Readonly<Record<string, string>>;
+    readonly diff?: string;
+    readonly warnings: readonly string[];
+}
+interface MemoryActionProposal {
+    readonly id: string;
+    readonly action: MemoryProposalAction;
+    readonly targetRefs: readonly MemoryItemRef[];
+    readonly sourceRefs: readonly MemoryItemRef[];
+    readonly expectedFingerprints: Readonly<Record<string, string>>;
+    readonly rationale: string;
+    readonly risk: 'low' | 'medium' | 'high';
+    readonly preview: MemoryApplyPreview;
+    readonly requiresApproval: true;
+    readonly createdAt: string;
+}
+interface MemoryApproval {
+    readonly proposalId: string;
+    readonly approvedBy: 'user' | 'host';
+    readonly approvedAt: string;
+    readonly expectedFingerprints: Readonly<Record<string, string>>;
+}
+interface MemoryApplyResult {
+    readonly proposalId: string;
+    readonly applied: boolean;
+    readonly changedRefs: readonly MemoryItemRef[];
+    readonly changedPaths: readonly string[];
+    readonly skippedReason?: string;
+    readonly warnings: readonly string[];
+}
+interface MemoryRejectResult {
+    readonly proposalId: string;
+    readonly rejected: boolean;
+    readonly skippedReason?: string;
+    readonly review?: MemoryReviewPlan;
+    readonly warnings: readonly string[];
+}
+interface MemorySourceAdapter {
+    readonly kind: MemoryRefKind;
+    listRefs(filter?: MemoryRefFilter): Promise<readonly MemoryItemRef[]>;
+    readRef(ref: MemoryItemRef): Promise<MemoryBodySnapshot>;
+    previewProposal(proposal: MemoryActionProposal): Promise<MemoryApplyPreview>;
+    applyProposal(proposal: MemoryActionProposal, approval: MemoryApproval): Promise<MemoryApplyResult>;
+}
+interface MemoryCuratorInput {
+    readonly includePrivate?: boolean;
+    readonly includeSensitive?: boolean;
+}
+interface MemoryAutoCuratorInput extends MemoryCuratorInput {
+    readonly enabled?: boolean;
+    readonly intervalMs?: number;
+    readonly minRefs?: number;
+}
+type MemoryAutoCuratorSkipReason = 'disabled' | 'not_due' | 'insufficient_refs';
+interface MemoryAutoCuratorResult {
+    readonly ran: boolean;
+    readonly skippedReason?: MemoryAutoCuratorSkipReason;
+    readonly report?: MemoryGovernanceReport;
+    readonly reportPath?: string;
+    readonly nextEligibleAt?: string;
+}
+type MemoryGovernanceFindingKind = 'duplicate' | 'conflict' | 'stale' | 'quarantined' | 'orphaned' | 'no_op';
+interface MemoryGovernanceFinding {
+    readonly kind: MemoryGovernanceFindingKind;
+    readonly severity: 'info' | 'warning' | 'error';
+    readonly refIds: readonly string[];
+    readonly summary: string;
+    readonly suggestedAction: MemoryProposalAction;
+}
+interface MemoryGovernanceReport {
+    readonly reportId: string;
+    readonly generatedAt: string;
+    readonly findings: readonly MemoryGovernanceFinding[];
+    readonly warnings: readonly string[];
+}
+interface MemoryPackInput {
+    readonly task: string;
+    readonly maxHints?: number;
+    readonly includePrivate?: boolean;
+    readonly includeSensitive?: boolean;
+    readonly includeSnippets?: boolean;
+    readonly ignoreMemory?: boolean;
+}
+interface MemoryPackHint {
+    readonly ref: MemoryItemRef;
+    readonly hook: string;
+    readonly reason: string;
+    readonly bodySnippet?: string;
+    readonly bodyFingerprint?: string;
+}
+interface MemoryPack {
+    readonly generatedAt: string;
+    readonly taskFingerprint: string;
+    readonly hints: readonly MemoryPackHint[];
+    readonly omitted: readonly string[];
+    readonly traceMetadata: MemoryPackTraceMetadata;
+}
+interface MemoryPackTraceMetadata {
+    readonly selectedRefIds: readonly string[];
+    readonly omittedRefIds: readonly string[];
+    readonly taskFingerprint: string;
+    readonly suppressed: boolean;
+}
+type MemoryReviewTrigger = 'user_correction' | 'explicit_remember' | 'explicit_forget' | 'proposal_rejected' | 'conflict_detected';
+interface MemoryReviewCandidateRef {
+    readonly ref: MemoryItemRef;
+    readonly bodySnippet?: string;
+    readonly bodyFingerprint?: string;
+    readonly warnings: readonly string[];
+}
+interface MemoryReviewInput {
+    readonly trigger: MemoryReviewTrigger;
+    readonly userFeedback: string;
+    readonly task?: string;
+    readonly sourceRefs?: readonly string[];
+    readonly candidateRefIds?: readonly string[];
+    readonly includePrivate?: boolean;
+    readonly includeSensitive?: boolean;
+    readonly maxRefs?: number;
+}
+interface MemoryReviewModelInput {
+    readonly trigger: MemoryReviewTrigger;
+    readonly userFeedback: string;
+    readonly task?: string;
+    readonly sourceRefs: readonly string[];
+    readonly candidateRefs: readonly MemoryReviewCandidateRef[];
+    readonly warnings: readonly string[];
+}
+interface MemoryReviewDraftAction {
+    readonly action: MemoryProposalAction;
+    readonly targetRefIds: readonly string[];
+    readonly summary: string;
+    readonly rationale: string;
+    readonly confidence: 'low' | 'medium' | 'high';
+    readonly risk: 'low' | 'medium' | 'high';
+    readonly requiresApproval: true;
+    readonly proposedBody?: string;
+}
+interface MemoryReviewPlan {
+    readonly trigger: MemoryReviewTrigger;
+    readonly createdAt: string;
+    readonly sourceRefs: readonly string[];
+    readonly candidateRefs: readonly MemoryReviewCandidateRef[];
+    readonly actions: readonly MemoryReviewDraftAction[];
+    readonly warnings: readonly string[];
+}
+type MemoryReviewRunner = (input: MemoryReviewModelInput) => Promise<MemoryReviewPlan>;
+interface MemoryController {
+    listInbox(): Promise<readonly MemoryActionProposal[]>;
+    showProposal(id: string): Promise<MemoryActionProposal | undefined>;
+    approveProposal(id: string, expectedFingerprints: Readonly<Record<string, string>>): Promise<MemoryApplyResult>;
+    rejectProposal(id: string, reason?: string): Promise<MemoryRejectResult>;
+    listRefs(filter?: MemoryRefFilter): Promise<readonly MemoryItemRef[]>;
+    readRef(ref: MemoryItemRef): Promise<MemoryBodySnapshot>;
+    runCurator(input?: MemoryCuratorInput): Promise<MemoryGovernanceReport>;
+    maybeRunAutoCurator(input?: MemoryAutoCuratorInput): Promise<MemoryAutoCuratorResult>;
+    buildMemoryPack(input: MemoryPackInput): Promise<MemoryPack>;
+    reviewMemoryFeedback(input: MemoryReviewInput): Promise<MemoryReviewPlan>;
+}
+type MemoryEvent = {
+    readonly type: 'proposal.created';
+    readonly proposalId: string;
+} | {
+    readonly type: 'proposal.approved';
+    readonly proposalId: string;
+} | {
+    readonly type: 'proposal.rejected';
+    readonly proposalId: string;
+} | {
+    readonly type: 'curator.completed';
+    readonly reportId: string;
+} | {
+    readonly type: 'pack.selected';
+    readonly refIds: readonly string[];
+} | {
+    readonly type: 'review.completed';
+    readonly trigger: MemoryReviewTrigger;
+    readonly actionCount: number;
+};
+
 /**
  * ../../index.js Compaction Types
  */
@@ -3099,5 +3351,5 @@ declare function isFinalWorkflowProcessStatus(status: WorkflowProcessStatus): bo
 declare function normalizeHostMetadata(value: unknown): Record<string, string> | undefined;
 declare function createWorkflowProcessTracker(options: WorkflowProcessTrackerOptions): WorkflowProcessTracker;
 
-export { ASK_USER_BACK_SIGNAL as A, DEFAULT_SYSTEM_CAP as D, InvariantSession as N, Runner as aL, MAX_TOOL_LOOP_ITERATIONS as at, SpanImpl as b2, Tracer as bk, WorkflowEventRecorder as bv, _resetAdmittedAgentBindings as c8, _resetPresetDispatchers as c9, setActiveUserInteraction as cA, setAdmittedAgentBindings as cB, asSingleSelection as ca, buildAssistantMessageFromLlmResult as cb, buildSystemPrompt as cc, buildToolResultMessage as cd, createAgent as ce, createHandoff as cf, createInMemorySession as cg, createInvariantSessionForAgent as ch, createStateWriter as ci, createTrace as cj, createWorkflowProcessTracker as ck, defaultTracer as cl, detectInstructionsInjection as cm, discoverInstances as cn, executeRunnerToolCall as co, extractAssistantTextFromMessage as cp, getActiveUserInteraction as cq, getAdmittedAgentBindings as cr, isFinalWorkflowProcessStatus as cs, isRunnableTool as ct, isRunnerLlmResult as cu, normalizeHostMetadata as cv, registerChildTask as cw, registerPresetDispatcher as cx, requestTaskStop as cy, runAdmissionAudit as cz };
-export type { KodaXInputArtifactSource as $, GuardrailSpanData as B, ChildTaskRegistry as C, EvidenceSpanData as E, FanoutSpanData as F, GenerationSpanData as G, Handoff as H, HandoffSpanData as I, InMemorySessionOptions as J, InstanceDiscoveryFs as K, InvariantId as L, InvariantResult as M, KodaXCompactMemoryProgress as O, KodaXCompactMemorySeed as P, KodaXExtensionSessionRecord as Q, KodaXExtensionSessionState as R, KodaXExtensionStore as S, KodaXExtensionStoreEntry as T, KodaXFileInputArtifact as U, KodaXGoalEventType as V, KodaXGoalState as W, KodaXGoalStatus as X, KodaXImageInputArtifact as Y, KodaXImageMediaType as Z, KodaXInputArtifact as _, AdmissionAuditOptions as a, Span as a$, KodaXJsonValue as a0, KodaXSessionArchiveMarkerEntry as a1, KodaXSessionArtifactLedgerEntry as a2, KodaXSessionBranchSummaryEntry as a3, KodaXSessionClientNoticeEntry as a4, KodaXSessionCompactionEntry as a5, KodaXSessionData as a6, KodaXSessionEntry as a7, KodaXSessionEntryBase as a8, KodaXSessionGoalEntry as a9, QualityInvariant as aA, ReadonlyMutationTracker as aB, ReadonlyRecorder as aC, ReasoningDepth as aD, RecentlyModifiedFile as aE, RequestTaskStopOptions as aF, RequestTaskStopResult as aG, RunEvent as aH, RunOptions as aI, RunResult as aJ, RunnableTool as aK, RunnerEvent as aM, RunnerLlmResult as aN, RunnerLlmReturn as aO, RunnerToolCall as aP, RunnerToolContext as aQ, RunnerToolObserver as aR, RunnerToolResult as aS, Session as aT, SessionDispatchResult as aU, SessionEntry as aV, SessionErrorMetadata as aW, SessionExtension as aX, SessionForkOptions as aY, SessionMeta as aZ, SessionStateSnapshot as a_, KodaXSessionLabelEntry as aa, KodaXSessionLineage as ab, KodaXSessionMessageEntry as ac, KodaXSessionMeta as ad, KodaXSessionNavigationOptions as ae, KodaXSessionRuntimeInfo as af, KodaXSessionScope as ag, KodaXSessionStorage as ah, KodaXSessionTreeNode as ai, KodaXSessionUiHistoryItem as aj, KodaXSessionUiHistoryItemType as ak, KodaXSessionUiTextHistoryItem as al, KodaXSessionUiTextHistoryItemType as am, KodaXSessionUiToolCall as an, KodaXSessionUiToolCallStatus as ao, KodaXSessionUiToolGroupHistoryItem as ap, KodaXSessionWorkspaceKind as aq, KodaXVideoInputArtifact as ar, KodaXVideoMediaType as as, ManifestPatch as au, MessageEntry as av, ObserveCtx as aw, PersistedSessionState as ax, PresetDispatcher as ay, PresetTracingContext as az, AdmissionCtx as b, WorkflowTaskSnapshot as b$, SpanData as b0, SpanError as b1, SpanImplOptions as b3, StartTraceOptions as b4, StateWriter as b5, StateWriterFs as b6, StateWriterOptions as b7, StopHookContext as b8, StopHookFn as b9, WorkflowMeta as bA, WorkflowModelHint as bB, WorkflowModule as bC, WorkflowParallelOptions as bD, WorkflowProcessArtifact as bE, WorkflowProcessCounts as bF, WorkflowProcessEvent as bG, WorkflowProcessItem as bH, WorkflowProcessItemKind as bI, WorkflowProcessItemOrigin as bJ, WorkflowProcessItemStatus as bK, WorkflowProcessProgress as bL, WorkflowProcessSnapshot as bM, WorkflowProcessSource as bN, WorkflowProcessStatus as bO, WorkflowProcessSummaryStatus as bP, WorkflowProcessTokenUsage as bQ, WorkflowProcessTracker as bR, WorkflowProcessTrackerOptions as bS, WorkflowRun as bT, WorkflowRunState as bU, WorkflowRunStatus as bV, WorkflowSpawnAgentInput as bW, WorkflowSynthesis as bX, WorkflowSynthesizeInput as bY, WorkflowTaskHandle as bZ, WorkflowTaskResult as b_, StopHookResult as ba, StopHookSpanData as bb, SystemCap as bc, TaskAbortRegistry as bd, TerminalCtx as be, ToolCallSpanData as bf, ToolCapability as bg, ToolPermission as bh, Trace as bi, TraceOptions as bj, TracerOptions as bl, UserInteraction as bm, WorkflowAgentBackend as bn, WorkflowApi as bo, WorkflowApproval as bp, WorkflowApprovalSummary as bq, WorkflowArtifactRef as br, WorkflowBudget as bs, WorkflowEvent as bt, WorkflowEventCorrelation as bu, WorkflowEventType as bw, WorkflowIsolation as bx, WorkflowLimits as by, WorkflowLogEvent as bz, AdmissionVerdict as c, WorkflowTaskStatus as c0, WorkflowTaskSummaryEventUpdate as c1, WorkflowTaskSummaryKind as c2, WorkflowTaskSummaryUpdate as c3, WorkflowTaskUsage as c4, WorkflowTaskVerification as c5, WorkflowTaskVerificationResult as c6, WorkflowWaitOptions as c7, AdmittedHandle as d, Agent as e, AgentManifest as f, AgentMessage as g, AgentMiddlewareDeclaration as h, AgentReasoningProfile as i, AgentSpanData as j, AgentTool as k, AskUserMultiOptions as l, AskUserQuestionItem as m, AskUserQuestionOptions as n, CompactionAnchor as o, CompactionConfig as p, CompactionDetails as q, CompactionResult as r, CompactionSpanData as s, CompactionUpdate as t, CurrentTodoSummary as u, Deliverable as v, DiscoveredInstance as w, DiscoveryOptions as x, FileOperations as y, Guardrail as z };
+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 ax, SpanImpl as bE, Tracer as bW, Runner as bl, extractAssistantTextFromMessage as c$, WorkflowEventRecorder as c5, _resetAdmittedAgentBindings as cK, _resetPresetDispatchers as cL, asSingleSelection as cM, buildAssistantMessageFromLlmResult as cN, buildSystemPrompt as cO, buildToolResultMessage as cP, createAgent as cQ, createHandoff as cR, createInMemorySession as cS, createInvariantSessionForAgent as cT, createStateWriter as cU, createTrace as cV, createWorkflowProcessTracker as cW, defaultTracer as cX, detectInstructionsInjection as cY, discoverInstances as cZ, executeRunnerToolCall as c_, getActiveUserInteraction as d0, getAdmittedAgentBindings as d1, isAskUserCustomInputAnswer as d2, isFinalWorkflowProcessStatus as d3, isRunnableTool as d4, isRunnerLlmResult as d5, normalizeHostMetadata as d6, registerChildTask as d7, registerPresetDispatcher as d8, requestTaskStop as d9, runAdmissionAudit as da, setActiveUserInteraction as db, setAdmittedAgentBindings as dc };
+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 _, MemoryReviewPlan 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, MemoryApplyPreview as aA, MemoryApplyResult as aB, MemoryApproval as aC, MemoryAuthority as aD, MemoryAutoCuratorInput as aE, MemoryAutoCuratorResult as aF, MemoryBodySnapshot as aG, MemoryController as aH, MemoryCuratorInput as aI, MemoryEvent as aJ, MemoryGovernanceFinding as aK, MemoryGovernanceFindingKind as aL, MemoryGovernanceReport as aM, MemoryItemRef as aN, MemoryLifecycle as aO, MemoryPack as aP, MemoryPackHint as aQ, MemoryPackInput as aR, MemoryPackTraceMetadata as aS, MemoryProposalAction as aT, MemoryRefFilter as aU, MemoryRefKind as aV, MemoryRejectResult as aW, MemoryReviewCandidateRef as aX, MemoryReviewDraftAction as aY, MemoryReviewInput as aZ, MemoryReviewModelInput 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, KodaXSessionRuntimeInfo as aj, KodaXSessionScope as ak, KodaXSessionStorage as al, KodaXSessionTreeNode as am, KodaXSessionUiHistoryItem as an, KodaXSessionUiHistoryItemType as ao, KodaXSessionUiTextHistoryItem as ap, KodaXSessionUiTextHistoryItemType as aq, KodaXSessionUiToolCall as ar, KodaXSessionUiToolCallStatus as as, KodaXSessionUiToolGroupHistoryItem as at, KodaXSessionWorkspaceKind as au, KodaXVideoInputArtifact as av, KodaXVideoMediaType as aw, ManifestPatch as ay, MemoryActionProposal as az, AdmissionAuditOptions as b, WorkflowApproval as b$, MemoryReviewRunner as b0, MemoryReviewTrigger as b1, MemoryScope as b2, MemorySourceAdapter as b3, MemoryVisibility as b4, MessageEntry as b5, ObserveCtx as b6, PersistedSessionState as b7, PresetDispatcher as b8, PresetTracingContext as b9, SessionStateSnapshot as bA, Span as bB, SpanData as bC, SpanError as bD, SpanImplOptions as bF, StartTraceOptions as bG, StateWriter as bH, StateWriterFs as bI, StateWriterOptions as bJ, StopHookContext as bK, StopHookFn as bL, StopHookResult as bM, StopHookSpanData as bN, SystemCap as bO, TaskAbortRegistry as bP, TerminalCtx as bQ, ToolCallSpanData as bR, ToolCapability as bS, ToolPermission as bT, Trace as bU, TraceOptions as bV, TracerOptions as bX, UserInteraction as bY, WorkflowAgentBackend as bZ, WorkflowApi as b_, QualityInvariant as ba, ReadonlyMutationTracker as bb, ReadonlyRecorder as bc, ReasoningDepth as bd, RecentlyModifiedFile as be, RequestTaskStopOptions as bf, RequestTaskStopResult as bg, RunEvent as bh, RunOptions as bi, RunResult as bj, RunnableTool as bk, RunnerEvent as bm, RunnerLlmResult as bn, RunnerLlmReturn as bo, RunnerToolCall as bp, RunnerToolContext as bq, RunnerToolObserver as br, RunnerToolResult as bs, Session as bt, SessionDispatchResult as bu, SessionEntry as bv, SessionErrorMetadata as bw, SessionExtension as bx, SessionForkOptions as by, SessionMeta as bz, AdmissionCtx as c, WorkflowApprovalSummary as c0, WorkflowArtifactRef as c1, WorkflowBudget as c2, WorkflowEvent as c3, WorkflowEventCorrelation as c4, WorkflowEventType as c6, WorkflowIsolation as c7, WorkflowLimits as c8, WorkflowLogEvent as c9, WorkflowTaskResult as cA, WorkflowTaskSnapshot as cB, WorkflowTaskStatus as cC, WorkflowTaskSummaryEventUpdate as cD, WorkflowTaskSummaryKind as cE, WorkflowTaskSummaryUpdate as cF, WorkflowTaskUsage as cG, WorkflowTaskVerification as cH, WorkflowTaskVerificationResult as cI, WorkflowWaitOptions as cJ, WorkflowMeta as ca, WorkflowModelHint as cb, WorkflowModule as cc, WorkflowParallelOptions as cd, WorkflowProcessArtifact as ce, WorkflowProcessCounts as cf, WorkflowProcessEvent as cg, WorkflowProcessItem as ch, WorkflowProcessItemKind as ci, WorkflowProcessItemOrigin as cj, WorkflowProcessItemStatus as ck, WorkflowProcessProgress as cl, WorkflowProcessSnapshot as cm, WorkflowProcessSource as cn, WorkflowProcessStatus as co, WorkflowProcessSummaryStatus as cp, WorkflowProcessTokenUsage as cq, WorkflowProcessTracker as cr, WorkflowProcessTrackerOptions as cs, WorkflowRun as ct, WorkflowRunState as cu, WorkflowRunStatus as cv, WorkflowSpawnAgentInput as cw, WorkflowSynthesis as cx, WorkflowSynthesizeInput as cy, WorkflowTaskHandle 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 };

package/dist/types-chunks/{run-manager.d-DHPlNYkK.d.ts → run-manager.d-CYY3pZeJ.d.ts}

@@ -1,6 +1,6 @@
 import { j as KodaXMessage } from './types.d-Bp4Lm1jv.js';
-import { Q as QueueEventListener, f as QueuedMessage, E as EnqueueInput, D as DequeueFilter } from './types.d-CSZAMmU-.js';
-import { g as AgentMessage, aV as SessionEntry, aT as Session, aX as SessionExtension, ab as KodaXSessionLineage, a0 as KodaXJsonValue, q as CompactionDetails, P as KodaXCompactMemorySeed, a7 as KodaXSessionEntry, ai as KodaXSessionTreeNode, aa as KodaXSessionLabelEntry, a9 as KodaXSessionGoalEntry, a4 as KodaXSessionClientNoticeEntry, ae as KodaXSessionNavigationOptions, a2 as KodaXSessionArtifactLedgerEntry, y as FileOperations, bA as WorkflowMeta, bB as WorkflowModelHint, bC as WorkflowModule, bS as WorkflowProcessTrackerOptions, bt as WorkflowEvent, bM as WorkflowProcessSnapshot, bG as WorkflowProcessEvent } from './process.d-C93UMgPK.js';
+import { Q as QueueEventListener, f as QueuedMessage, E as EnqueueInput, D as DequeueFilter } from './types.d-DFf4Sfys.js';
+import { h as AgentMessage, bv as SessionEntry, bt as Session, bx as SessionExtension, af as KodaXSessionLineage, a4 as KodaXJsonValue, u as CompactionDetails, T as KodaXCompactMemorySeed, ab as KodaXSessionEntry, am as KodaXSessionTreeNode, ae as KodaXSessionLabelEntry, ad as KodaXSessionGoalEntry, a8 as KodaXSessionClientNoticeEntry, ai as KodaXSessionNavigationOptions, a6 as KodaXSessionArtifactLedgerEntry, H as FileOperations, ca as WorkflowMeta, cb as WorkflowModelHint, cc as WorkflowModule, cs as WorkflowProcessTrackerOptions, c3 as WorkflowEvent, cm as WorkflowProcessSnapshot, cg as WorkflowProcessEvent } from './process.d-DXkRD7hj.js';
 
 /**
  * @kodax-ai/agent Constants

package/dist/types-chunks/{sdk-session-DINrM1pF.d.ts → sdk-session-BGGOC0cT.d.ts}

@@ -1,7 +1,7 @@
-import { b as PermissionMode, F as FileSessionStorage, S as SessionData } from './storage.d-xiw7Vgx0.js';
+import { b as PermissionMode, F as FileSessionStorage, S as SessionData } from './storage.d-C3umBC4g.js';
 import { E as KodaXReasoningMode, j as KodaXMessage, c as KodaXContentBlock, R as KodaXTaskResultMetadata } from './types.d-Bp4Lm1jv.js';
-import { m as KodaXAgentMode } from './bash-prefix-extractor.d-e1LD2IRl.js';
-import { aj as KodaXSessionUiHistoryItem, an as KodaXSessionUiToolCall, a0 as KodaXJsonValue } from './process.d-C93UMgPK.js';
+import { m as KodaXAgentMode } from './bash-prefix-extractor.d-Do_TCAmA.js';
+import { an as KodaXSessionUiHistoryItem, ar as KodaXSessionUiToolCall, a4 as KodaXJsonValue } from './process.d-DXkRD7hj.js';
 
 /**
  * TextBuffer - Text buffer management class - 文本缓冲区管理类

package/dist/types-chunks/{storage.d-xiw7Vgx0.d.ts → storage.d-C3umBC4g.d.ts}

@@ -1,5 +1,5 @@
-import { a as BashPrefixExtractor } from './bash-prefix-extractor.d-e1LD2IRl.js';
-import { a6 as KodaXSessionData, ab as KodaXSessionLineage, ae as KodaXSessionNavigationOptions, af as KodaXSessionRuntimeInfo, ah as KodaXSessionStorage } from './process.d-C93UMgPK.js';
+import { a as BashPrefixExtractor } from './bash-prefix-extractor.d-Do_TCAmA.js';
+import { aa as KodaXSessionData, af as KodaXSessionLineage, ai as KodaXSessionNavigationOptions, aj as KodaXSessionRuntimeInfo, al as KodaXSessionStorage } from './process.d-DXkRD7hj.js';
 
 /**
  * Permission Types

package/dist/types-chunks/{types.d-CSZAMmU-.d.ts → types.d-DFf4Sfys.d.ts}

@@ -1,4 +1,4 @@
-import { z as Guardrail, aP as RunnerToolCall, e as Agent, g as AgentMessage, aS as RunnerToolResult, a$ as Span, _ as KodaXInputArtifact } from './process.d-C93UMgPK.js';
+import { J as Guardrail, bp as RunnerToolCall, f as Agent, h as AgentMessage, bs as RunnerToolResult, bB as Span, a2 as KodaXInputArtifact } from './process.d-DXkRD7hj.js';
 import { R as KodaXTaskResultMetadata } from './types.d-Bp4Lm1jv.js';
 
 /**

package/dist/types-chunks/{utils.d-Dy19-1XR.d.ts → utils.d-ChOEH3NF.d.ts}

@@ -1,8 +1,8 @@
-import { Q as KodaXOptions, v as KodaXContextTokenSnapshot, a6 as KodaXSkillDynamicContextPolicy, m as KodaXAgentMode, V as KodaXRepoIntelligenceMode, a7 as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-e1LD2IRl.js';
-import { c as SessionStorage$1, b as PermissionMode } from './storage.d-xiw7Vgx0.js';
-import { aj as KodaXSessionUiHistoryItem, ab as KodaXSessionLineage, a2 as KodaXSessionArtifactLedgerEntry, R as KodaXExtensionSessionState, Q as KodaXExtensionSessionRecord, af as KodaXSessionRuntimeInfo, ah as KodaXSessionStorage, a6 as KodaXSessionData, bN as WorkflowProcessSource } from './process.d-C93UMgPK.js';
+import { Q as KodaXOptions, v as KodaXContextTokenSnapshot, a6 as KodaXSkillDynamicContextPolicy, m as KodaXAgentMode, V as KodaXRepoIntelligenceMode, a7 as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-Do_TCAmA.js';
+import { c as SessionStorage$1, b as PermissionMode } from './storage.d-C3umBC4g.js';
+import { an as KodaXSessionUiHistoryItem, af as KodaXSessionLineage, a6 as KodaXSessionArtifactLedgerEntry, V as KodaXExtensionSessionState, U as KodaXExtensionSessionRecord, aj as KodaXSessionRuntimeInfo, al as KodaXSessionStorage, aa as KodaXSessionData, cn as WorkflowProcessSource } from './process.d-DXkRD7hj.js';
 import { j as KodaXMessage, E as KodaXReasoningMode, o as KodaXProviderCapabilityProfile, d as KodaXCustomProviderConfig } from './types.d-Bp4Lm1jv.js';
-import { A as AgentsFile, f as AutoModeStats, l as KodaXMcpServersConfig } from './guardrail.d-CdqJwwN7.js';
+import { A as AgentsFile, f as AutoModeStats, l as KodaXMcpServersConfig } from './guardrail.d-DRp0Lqvx.js';
 import * as readline from 'readline';
 import { SpawnSyncReturns } from 'child_process';
 

package/package.json

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

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

@@ -1,2 +0,0 @@
-// @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{Aa as b,za as a}from"./chunk-D7CC6YZC.js";import"./chunk-KIVYMSRH.js";import"./chunk-2OEKUAV4.js";import"./chunk-XHOPSZVL.js";import"./chunk-CGGX3FXE.js";import"./chunk-QCBKLNN5.js";import"./chunk-4NSOBQCU.js";import"./chunk-D6QVXQNI.js";import"./chunk-UA744TZM.js";import"./chunk-7COB3EKF.js";import"./chunk-S4GVQO3W.js";import"./chunk-NJW2LQOP.js";import"./chunk-ZL5CEANW.js";import"./chunk-V4WSBIXB.js";export{a as ArgumentCompleter,b as createArgumentCompleter};