@kodax-ai/kodax 0.7.42 → 0.7.44

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/{storage.d-Bc5DoAwp.d.ts → utils.d-C5fzCE9W.d.ts}

@@ -1,6 +1,6 @@
-import { l as BashPrefixExtractor, _ as KodaXOptions, H as KodaXContextTokenSnapshot, K as KodaXAgentMode, a3 as KodaXRepoIntelligenceMode, A as AgentsFile, i as AutoModeStats, ae as KodaXSkillInvocationContext, X as KodaXMcpServersConfig } from './bash-prefix-extractor.d-CkhaqKkg.js';
-import { a as SessionStorage$1, S as SessionData } from './session-storage.d-Cci897iM.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-DdoSeghD.js';
+import { a as SessionStorage$1 } from './storage.d-DFD9ln5c.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';
@@ -462,6 +462,23 @@ declare function loadConfig(): {
     repointelBin?: string;
     repoIntelligenceTrace?: boolean;
     streamIdleTimeoutMs?: number;
+    /**
+     * FEATURE_184 Phase D.3 follow-up (v0.7.42) — opt-in Sidecar Verifier
+     * observability. When `true`, the runtime emits a persisted note per
+     * verifier call:
+     *   `[Sidecar Verifier] {verdict} · {model} · {ms}ms · {trace}`
+     * Mirrored to env var `KODAX_VERIFIER_LOG=1` so the agent-runtime
+     * layer (which has no access to `~/.kodax/config.json`) can read it.
+     */
+    verifierLog?: boolean;
+    /**
+     * FEATURE_187 Phase C (v0.7.43) — opt-in Stall Sidecar observability.
+     * When `true`, the runtime emits a persisted note per L2 stall
+     * verdict (isStuck true OR false):
+     *   `[Stall Sidecar] isStuck={true|false} · {provider}/{model} · {ms}ms · {trace}`
+     * Mirrored to env var `KODAX_STALL_LOG=1`.
+     */
+    stallLog?: boolean;
 };
 declare function prepareRuntimeConfig(): ReturnType<typeof loadConfig>;
 declare function saveConfig(config: {
@@ -481,52 +498,13 @@ declare function saveConfig(config: {
     repointelEndpoint?: string;
     repointelBin?: string;
     repoIntelligenceTrace?: boolean;
+    /** FEATURE_184 Phase D.3 follow-up — opt-in verifier log line. */
+    verifierLog?: boolean;
+    /** FEATURE_187 Phase C — opt-in stall sidecar log line. */
+    stallLog?: boolean;
 }): void;
 declare function getGitRoot(): Promise<string | null>;
 declare function rateLimitedCall<T>(fn: () => Promise<T>): Promise<T>;
 
-/**
- * KodaX session storage - filesystem implementation.
- */
-
-declare class FileSessionStorage implements KodaXSessionStorage {
-    private writeQueues;
-    private serializedWrite;
-    private appendState;
-    /** Update watermarks. Only overwrites fields the caller actually provided. */
-    private syncAppendState;
-    private getSessionFilePath;
-    private getArchiveFilePath;
-    private readSession;
-    private writeSessionInternal;
-    private mergeAndWriteInternal;
-    appendSessionDelta(id: string, data: SessionData): Promise<void>;
-    private shouldRunMaintenance;
-    private runMaintenance;
-    save(id: string, data: SessionData): Promise<void>;
-    load(id: string): Promise<SessionData | null>;
-    getLineage(id: string): Promise<KodaXSessionLineage | null>;
-    setActiveEntry(id: string, selector: string, options?: {
-        summarizeCurrentBranch?: boolean;
-    }): Promise<SessionData | null>;
-    rewind(id: string, selector?: string): Promise<SessionData | null>;
-    setLabel(id: string, selector: string, label?: string): Promise<SessionData | null>;
-    fork(id: string, selector?: string, options?: {
-        sessionId?: string;
-        title?: string;
-    }): Promise<{
-        sessionId: string;
-        data: SessionData;
-    } | null>;
-    list(gitRoot?: string): Promise<Array<{
-        id: string;
-        title: string;
-        msgCount: number;
-        runtimeInfo?: KodaXSessionRuntimeInfo;
-    }>>;
-    delete(id: string): Promise<void>;
-    deleteAll(gitRoot?: string): Promise<void>;
-}
-
-export { processSpecialSyntax as A, BUILTIN_COMMANDS as B, rateLimitedCall as D, registerConfiguredCustomProviders as E, FileSessionStorage as F, runInkInteractiveMode as G, runInteractiveMode as H, saveConfig as J, KODAX_CONFIG_FILE as K, touchContext as L, PERMISSION_MODES as P, KODAX_DIR as f, KODAX_SESSIONS_DIR as g, KODAX_VERSION as h, PREVIEW_MAX_LENGTH as i, computeConfirmTools as l, createInteractiveContext as m, executeCommand as n, getGitRoot as o, getProviderList as p, getProviderModel as q, getVersion as r, hydrateProcessEnvFromShell as s, isPermissionMode as t, isProviderConfigured as u, loadConfig as v, normalizePermissionMode as w, parseCommand as x, permissionModeDisplayName as y, prepareRuntimeConfig as z };
+export { processSpecialSyntax as A, BUILTIN_COMMANDS as B, rateLimitedCall as D, registerConfiguredCustomProviders as E, runInkInteractiveMode as F, runInteractiveMode as G, saveConfig as H, touchContext as J, KODAX_CONFIG_FILE as K, PERMISSION_MODES as P, KODAX_DIR as f, KODAX_SESSIONS_DIR as g, KODAX_VERSION as h, PREVIEW_MAX_LENGTH as i, computeConfirmTools as l, createInteractiveContext as m, executeCommand as n, getGitRoot as o, getProviderList as p, getProviderModel as q, getVersion as r, hydrateProcessEnvFromShell as s, isPermissionMode as t, isProviderConfigured as u, loadConfig as v, normalizePermissionMode as w, parseCommand as x, permissionModeDisplayName as y, prepareRuntimeConfig as z };
 export type { Command as C, InkREPLOptions as I, RepLOptions as R, CommandCallbacks as a, ConfirmResult as b, CurrentConfig as c, InteractiveContext as d, InteractiveMode as e, PermissionContext as j, PermissionMode as k };

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@kodax-ai/kodax",
-  "version": "0.7.42",
+  "version": "0.7.44",
   "description": "极致轻量化 Coding Agent - TypeScript 实现，支持 12 个 LLM 提供商，可发布为免 Node 单文件二进制",
   "type": "module",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "workspaces": [
     "packages/*"
   ],
@@ -49,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/skills",
+    "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",
@@ -150,8 +154,5 @@
     "README_CN.md",
     "LICENSE",
     "CHANGELOG.md"
-  ],
-  "publishConfig": {
-    "access": "public"
-  }
+  ]
 }

package/dist/chunks/chunk-3RKBXWZS.js

@@ -1,2 +0,0 @@
-// @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{a as n}from"./chunk-V4WSBIXB.js";var o=class r{static{n(this,"SpanImpl")}id;traceId;parentId;name;data;startedAt;_endedAt;_error;_children=[];now;nextSpanId;onChildCreated;onSpanEnd;_ended=!1;constructor(e){this.id=e.id,this.traceId=e.traceId,this.parentId=e.parentId,this.name=e.name,this.data=e.data,this.now=e.now??(()=>Date.now()),this.startedAt=e.startedAt??this.now(),this.nextSpanId=e.nextSpanId??I,this.onChildCreated=e.onChildCreated,this.onSpanEnd=e.onSpanEnd}get endedAt(){return this._endedAt}get error(){return this._error}get children(){return this._children}addChild(e,a){let t=new r({id:this.nextSpanId(),traceId:this.traceId,parentId:this.id,name:e,data:a,now:this.now,nextSpanId:this.nextSpanId,onChildCreated:this.onChildCreated,onSpanEnd:this.onSpanEnd});return this._children.push(t),this.onChildCreated&&this.onChildCreated(t),t}setError(e){e instanceof Error?this._error={message:e.message,stack:e.stack}:this._error=e}end(){this._ended||(this._ended=!0,this._endedAt=this.now(),this.onSpanEnd&&this.onSpanEnd(this))}},f=0;function I(){f+=1;let r=Math.random().toString(36).slice(2,8);return`span-${Date.now()}-${f}-${r}`}n(I,"defaultNextSpanId");var g=0;function w(){g+=1;let r=Math.random().toString(36).slice(2,8);return`trace-${Date.now()}-${g}-${r}`}n(w,"defaultNextTraceId");function s(r={}){let e=r.now??(()=>Date.now()),a=r.id??(r.nextTraceId??w)(),t=e(),u=r.name??"trace",T=r.metadata??new Map,x=r.rootSpanData??{kind:"agent",agentName:u},m=!1,h,v,d=new o({id:`${a}-root`,traceId:a,name:u,data:x,startedAt:t,now:e,nextSpanId:r.nextSpanId,onChildCreated:r.onSpanStart,onSpanEnd:r.onSpanEnd});r.onSpanStart&&r.onSpanStart(d);let y={id:a,startedAt:t,rootSpan:d,metadata:T,get endedAt(){return h},get error(){return v??d.error},end(){m||(m=!0,h=e(),d.end(),r.onTraceEnd&&r.onTraceEnd(y))}};return y}n(s,"createTrace");var p=[];function c(r){for(let e of p)try{e.onSpanStart(r)}catch{}}n(c,"_emitSpanStart");function l(r){for(let e of p)try{e.onSpanEnd(r)}catch{}}n(l,"_emitSpanEnd");function S(r){for(let e of p)try{e.onTraceEnd(r)}catch{}}n(S,"_emitTraceEnd");var i=class{static{n(this,"Tracer")}options;constructor(e={}){this.options=e}startTrace(e={}){return s({id:e.id,name:e.name,rootSpanData:e.rootSpanData,metadata:e.metadata,now:this.options.now,nextSpanId:this.options.nextSpanId,nextTraceId:this.options.nextTraceId,onSpanStart:c,onSpanEnd:l,onTraceEnd:S})}},E=new i;export{E as a};