@kodax-ai/kodax 0.7.43 → 0.7.45

package/dist/types-chunks/{types.d-mM8vqvhT.d.ts → types.d-HBbWT-iA.d.ts}

@@ -82,7 +82,45 @@ interface KodaXSessionArchiveMarkerEntry extends KodaXSessionEntryBase {
     /** Brief summary of the archived content */
     summary: string;
 }
-type KodaXSessionEntry = KodaXSessionMessageEntry | KodaXSessionCompactionEntry | KodaXSessionBranchSummaryEntry | KodaXSessionLabelEntry | KodaXSessionArchiveMarkerEntry;
+type KodaXGoalStatus = 'active' | 'paused' | 'budget_limited' | 'blocked' | 'complete';
+/**
+ * Persistent user-set goal state. v0.7.44 FEATURE_192 — backs the
+ * `/goal` slash command and the get_goal / create_goal / update_goal
+ * tools.
+ *
+ * Persistence model: each lifecycle event (create / update / pause /
+ * resume / clear / budget_limited / blocked / complete) appends a
+ * `KodaXSessionGoalEntry` carrying a frozen `KodaXGoalState` snapshot
+ * to the session lineage. `readLatestGoalFromBranch` walks the active
+ * branch's message-entry IDs and returns the latest goal entry whose
+ * parentId belongs to that branch — so forks and rewinds naturally
+ * drop goals attached to abandoned message paths.
+ */
+interface KodaXGoalState {
+    readonly version: 1;
+    /** `${createdAt}-${rand}` — stable across updates of the same goal. */
+    readonly id: string;
+    readonly objective: string;
+    readonly status: KodaXGoalStatus;
+    /** Optional explicit token budget; null when the user did not set one. */
+    readonly tokenBudget: number | null;
+    readonly tokensUsed: number;
+    readonly timeUsedSeconds: number;
+    /** Consecutive turns the model has reported the same blocker. */
+    readonly blockerTurnCount: number;
+    /** The blocker_kind string the model last reported, or null. */
+    readonly lastBlockerKind: string | null;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+}
+type KodaXGoalEventType = 'created' | 'updated' | 'paused' | 'resumed' | 'cleared' | 'budget_limited' | 'blocked' | 'complete';
+interface KodaXSessionGoalEntry extends KodaXSessionEntryBase {
+    type: 'goal';
+    /** Snapshot at time of event; `null` only when `event === 'cleared'`. */
+    goal: KodaXGoalState | null;
+    event: KodaXGoalEventType;
+}
+type KodaXSessionEntry = KodaXSessionMessageEntry | KodaXSessionCompactionEntry | KodaXSessionBranchSummaryEntry | KodaXSessionLabelEntry | KodaXSessionArchiveMarkerEntry | 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';
@@ -119,7 +157,7 @@ interface KodaXSessionNavigationOptions {
     summarizeCurrentBranch?: boolean;
 }
 interface KodaXSessionTreeNode {
-    entry: Exclude<KodaXSessionEntry, KodaXSessionLabelEntry>;
+    entry: Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry>;
     children: KodaXSessionTreeNode[];
     label?: string;
     active: boolean;
@@ -251,4 +289,4 @@ interface KodaXSessionStorage {
     deleteAll?(gitRoot?: string): Promise<void>;
 }
 
-export type { KodaXCompactMemoryProgress as K, SessionErrorMetadata as S, KodaXCompactMemorySeed as a, KodaXExtensionSessionRecord as b, KodaXExtensionSessionState as c, KodaXExtensionStore as d, KodaXExtensionStoreEntry as e, KodaXJsonValue as f, KodaXSessionArchiveMarkerEntry as g, KodaXSessionArtifactLedgerEntry as h, KodaXSessionBranchSummaryEntry as i, KodaXSessionCompactionEntry as j, KodaXSessionData as k, KodaXSessionEntry as l, KodaXSessionEntryBase as m, KodaXSessionLabelEntry as n, KodaXSessionLineage as o, KodaXSessionMessageEntry as p, KodaXSessionMeta as q, KodaXSessionNavigationOptions as r, KodaXSessionRuntimeInfo as s, KodaXSessionScope as t, KodaXSessionStorage as u, KodaXSessionTreeNode as v, KodaXSessionUiHistoryItem as w, KodaXSessionUiHistoryItemType as x, KodaXSessionWorkspaceKind as y };
+export type { KodaXSessionUiHistoryItem as A, KodaXSessionUiHistoryItemType as B, KodaXSessionWorkspaceKind as C, KodaXCompactMemoryProgress as K, SessionErrorMetadata as S, KodaXCompactMemorySeed as a, KodaXExtensionSessionRecord as b, KodaXExtensionSessionState as c, KodaXExtensionStore as d, KodaXExtensionStoreEntry as e, KodaXGoalEventType as f, KodaXGoalState as g, KodaXGoalStatus as h, KodaXJsonValue as i, KodaXSessionArchiveMarkerEntry as j, KodaXSessionArtifactLedgerEntry as k, KodaXSessionBranchSummaryEntry as l, KodaXSessionCompactionEntry as m, KodaXSessionData as n, KodaXSessionEntry as o, KodaXSessionEntryBase as p, KodaXSessionGoalEntry as q, KodaXSessionLabelEntry as r, KodaXSessionLineage as s, KodaXSessionMessageEntry as t, KodaXSessionMeta as u, KodaXSessionNavigationOptions as v, KodaXSessionRuntimeInfo as w, KodaXSessionScope as x, KodaXSessionStorage as y, KodaXSessionTreeNode as z };

package/dist/types-chunks/{utils.d-DkLZD_wa.d.ts → utils.d-DSEX6Rq1.d.ts}

@@ -1,6 +1,6 @@
-import { l as BashPrefixExtractor, W as KodaXOptions, x as KodaXContextTokenSnapshot, K as KodaXAgentMode, $ as KodaXRepoIntelligenceMode, A as AgentsFile, i as AutoModeStats, aa as KodaXSkillInvocationContext, T as KodaXMcpServersConfig } from './bash-prefix-extractor.d-DMrGImMl.js';
-import { a as SessionStorage$1 } from './storage.d-DPAEX7zS.js';
-import { u as KodaXSessionStorage, k as KodaXSessionData, w as KodaXSessionUiHistoryItem, o as KodaXSessionLineage, h as KodaXSessionArtifactLedgerEntry, s as KodaXSessionRuntimeInfo } from './types.d-mM8vqvhT.js';
+import { l as BashPrefixExtractor, a1 as KodaXOptions, L as KodaXContextTokenSnapshot, K as KodaXAgentMode, a6 as KodaXRepoIntelligenceMode, A as AgentsFile, i as AutoModeStats, ah as KodaXSkillInvocationContext, _ as KodaXMcpServersConfig } from './bash-prefix-extractor.d-HrTUwtV7.js';
+import { a as SessionStorage$1 } from './storage.d-BvTdjYQF.js';
+import { y as KodaXSessionStorage, n as KodaXSessionData, A as KodaXSessionUiHistoryItem, s as KodaXSessionLineage, k as KodaXSessionArtifactLedgerEntry, w as KodaXSessionRuntimeInfo } from './types.d-HBbWT-iA.js';
 import { m as KodaXMessage, D as KodaXReasoningMode, q as KodaXProviderCapabilityProfile, E as KodaXReasoningOverride, h as KodaXCustomProviderConfig } from './types.d-B1uGoVTE.js';
 import * as readline from 'readline';
 import { SpawnSyncReturns } from 'child_process';
@@ -233,6 +233,8 @@ interface CurrentConfig {
     repointelEndpoint?: string;
     repointelBin?: string;
     repoIntelligenceTrace?: boolean;
+    /** FEATURE_102 Phase 3 — cross-provider child fallback chain. */
+    fallbackProviders?: string[];
 }
 type SessionLoadStatus = 'loaded' | 'missing' | 'blocked';
 type SessionBranchSwitchStatus = 'switched' | 'missing' | 'blocked';
@@ -479,6 +481,14 @@ declare function loadConfig(): {
      * Mirrored to env var `KODAX_STALL_LOG=1`.
      */
     stallLog?: boolean;
+    /**
+     * FEATURE_102 Phase 3 (v0.7.45) — ordered cross-provider fallback chain for
+     * child dispatch. When a child's primary provider is exhausted/down, the
+     * runtime re-runs it on the next provider here. Empty/absent = OFF. Mirrored
+     * to env var `KODAX_FALLBACK_PROVIDERS` (comma-separated) for the coding
+     * layer, which has no config access. Set via the `/fallback` command.
+     */
+    fallbackProviders?: string[];
 };
 declare function prepareRuntimeConfig(): ReturnType<typeof loadConfig>;
 declare function saveConfig(config: {
@@ -502,6 +512,8 @@ declare function saveConfig(config: {
     verifierLog?: boolean;
     /** FEATURE_187 Phase C — opt-in stall sidecar log line. */
     stallLog?: boolean;
+    /** FEATURE_102 Phase 3 — cross-provider child fallback chain. */
+    fallbackProviders?: string[];
 }): void;
 declare function getGitRoot(): Promise<string | null>;
 declare function rateLimitedCall<T>(fn: () => Promise<T>): Promise<T>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kodax-ai/kodax",
-  "version": "0.7.43",
+  "version": "0.7.45",
   "description": "极致轻量化 Coding Agent - TypeScript 实现，支持 12 个 LLM 提供商，可发布为免 Node 单文件二进制",
   "type": "module",
   "private": false,
@@ -53,7 +53,7 @@
   "scripts": {
     "build": "npm run build:packages && npm run build:bundle && npm run build:dts",
     "build:dts": "node scripts/build-dts.mjs",
-    "build:packages": "tsc -b tsconfig.build.json && npm run copy:builtin -w @kodax-ai/agent",
+    "build:packages": "tsc -b tsconfig.build.json && npm run copy:builtin -w @kodax-ai/agent && npm run copy:provider-caps -w @kodax-ai/llm",
     "build:bundle": "node scripts/build-bundle.mjs",
     "dev": "node --max-old-space-size=4096 --require ./scripts/production-env.cjs --import tsx src/kodax_cli.ts",
     "dev:cli": "node --max-old-space-size=4096 --require ./scripts/production-env.cjs --import tsx src/kodax_cli.ts",