@kodax-ai/kodax 0.7.49 → 0.7.50

package/dist/types-chunks/{types.d-BR9oNWup.d.ts → process.d-BbiXD24v.d.ts}

@@ -2468,7 +2468,7 @@ interface FileOperations {
  * injected clock). The run graph models agent relationships as a
  * thread/edge/event stream, not just a final summary blob.
  */
-type WorkflowEventType = 'workflow_started' | 'phase_started' | 'phase_finished' | 'agent_spawned' | 'agent_message_sent' | 'agent_completed' | 'agent_stopped' | 'artifact_written' | 'synthesis_completed' | 'workflow_completed' | 'workflow_stopped' | 'workflow_failed';
+type WorkflowEventType = 'workflow_started' | 'phase_started' | 'phase_finished' | 'agent_spawned' | 'agent_message_sent' | 'agent_completed' | 'agent_summary_updated' | 'agent_stopped' | 'workflow_log' | 'artifact_written' | 'synthesis_completed' | 'workflow_completed' | 'workflow_stopped' | 'workflow_failed';
 interface WorkflowEvent {
     /** Monotonic sequence number — stable append ordering. */
     readonly seq: number;
@@ -2536,6 +2536,12 @@ interface WorkflowTaskUsage {
     readonly outputTokens?: number;
     readonly totalTokens?: number;
 }
+type WorkflowTaskSummaryKind = 'digest' | 'excerpt' | 'digest-failed' | 'pending';
+interface WorkflowTaskSummaryEventUpdate {
+    readonly summary?: string;
+    readonly summaryKind: WorkflowTaskSummaryKind;
+    readonly usage?: WorkflowTaskUsage;
+}
 /** Terminal result of a spawned agent (from `wait` / `runAgent`). */
 interface WorkflowTaskResult {
     readonly taskId: string;
@@ -2546,6 +2552,11 @@ interface WorkflowTaskResult {
     readonly digest?: string;
     /** True when a digest was attempted but failed (error/timeout/empty); the UI then labels the excerpt fallback. */
     readonly digestFailed?: boolean;
+    /** True when a digest was scheduled asynchronously and may arrive via `agent_summary_updated`. */
+    readonly digestPending?: boolean;
+    /** Best-known provider/model used by the child, for host correlation only. */
+    readonly provider?: string;
+    readonly model?: string;
     readonly usage?: WorkflowTaskUsage;
 }
 /** Point-in-time snapshot of a (possibly still-running) agent. */
@@ -2615,6 +2626,9 @@ interface WorkflowApi {
     /** Await a spawned agent's terminal result. */
     wait(taskId: string, opts?: WorkflowWaitOptions): Promise<WorkflowTaskResult>;
     /** Snapshot a (possibly running) agent. */
+    snapshot(taskId: string): Promise<WorkflowTaskSnapshot>;
+    /** Snapshot a (possibly running) agent.
+     *  @deprecated Prefer `snapshot(taskId)`; `output` is kept as a compatibility alias. */
     output(taskId: string): Promise<WorkflowTaskSnapshot>;
     /** Send a message to a running agent (via MessageQueue routing). */
     send(taskId: string, content: string): Promise<void>;
@@ -2683,6 +2697,8 @@ interface WorkflowAgentBackend {
     output(taskId: string): Promise<WorkflowTaskSnapshot>;
     send(taskId: string, content: string): Promise<void>;
     stop(taskId: string, reason: string): Promise<void>;
+    /** Optional late summary stream for presentation-only async digests. */
+    subscribeTaskSummaryUpdates?(listener: (taskId: string, update: WorkflowTaskSummaryEventUpdate) => void): () => void;
     /** Optional durable artifact writer (Phase D wires the run graph).
      *  `wf.synthesize` is NOT a backend method — it runs as a gated agent
      *  through `spawn`/`wait` so it counts toward the runtime's caps. */
@@ -2698,5 +2714,128 @@ interface WorkflowRunState {
     readonly artifacts: readonly WorkflowArtifactRef[];
 }
 
-export { DEFAULT_SYSTEM_CAP as D, GuardrailBlockedError as H, GuardrailEscalateError as J, InvariantSession as T, MAX_TOOL_LOOP_ITERATIONS as U, WorkflowEventRecorder as a$, Tracer as aR, Runner as af, SpanImpl as ax, extractAssistantTextFromMessage as bA, getActiveUserInteraction as bB, getAdmittedAgentBindings as bC, isRunnableTool as bD, isRunnerLlmResult as bE, registerChildTask as bF, registerPresetDispatcher as bG, requestTaskStop as bH, runAdmissionAudit as bI, runInputGuardrails as bJ, runOutputGuardrails as bK, runToolAfterGuardrails as bL, runToolBeforeGuardrails as bM, setActiveUserInteraction as bN, setAdmittedAgentBindings as bO, _resetAdmittedAgentBindings as bk, _resetPresetDispatchers as bl, buildAssistantMessageFromLlmResult as bm, buildSystemPrompt as bn, buildToolResultMessage as bo, collectGuardrails as bp, createAgent as bq, createHandoff as br, createInMemorySession as bs, createInvariantSessionForAgent as bt, createStateWriter as bu, createTrace as bv, defaultTracer as bw, detectInstructionsInjection as bx, discoverInstances as by, executeRunnerToolCall as bz };
-export type { PersistedSessionState as $, AdmissionAuditOptions as A, Guardrail as B, ChildTaskRegistry as C, EnqueueInput as E, FanoutSpanData as F, GenerationSpanData as G, GuardrailContext as I, GuardrailSpanData as K, GuardrailVerdict as L, Handoff as M, HandoffSpanData as N, InMemorySessionOptions as O, InputGuardrail as P, InstanceDiscoveryFs as Q, InvariantId as R, InvariantResult as S, ManifestPatch as V, MessageEntry as W, MessageMode as X, MessagePriority as Y, ObserveCtx as Z, OutputGuardrail as _, AdmissionCtx as a, PresetDispatcher as a0, PresetTracingContext as a1, QualityInvariant as a2, QueueEventListener as a3, QueuedMessage as a4, ReadonlyMutationTracker as a5, ReadonlyRecorder as a6, ReasoningDepth as a7, RecentlyModifiedFile as a8, RequestTaskStopOptions as a9, StateWriter as aA, StateWriterFs as aB, StateWriterOptions as aC, StopHookContext as aD, StopHookFn as aE, StopHookResult as aF, StopHookSpanData as aG, SystemCap as aH, TaskAbortRegistry as aI, TerminalCtx as aJ, ToolBeforeOutcome as aK, ToolCallSpanData as aL, ToolCapability as aM, ToolGuardrail as aN, ToolPermission as aO, Trace as aP, TraceOptions as aQ, TracerOptions as aS, UserInteraction as aT, WorkflowAgentBackend as aU, WorkflowApi as aV, WorkflowApproval as aW, WorkflowApprovalSummary as aX, WorkflowArtifactRef as aY, WorkflowBudget as aZ, WorkflowEvent as a_, RequestTaskStopResult as aa, RunEvent as ab, RunOptions as ac, RunResult as ad, RunnableTool as ae, RunnerEvent as ag, RunnerLlmResult as ah, RunnerLlmReturn as ai, RunnerToolCall as aj, RunnerToolContext as ak, RunnerToolObserver as al, RunnerToolResult as am, Session as an, SessionDispatchResult as ao, SessionEntry as ap, SessionExtension as aq, SessionForkOptions as ar, SessionMeta as as, SessionStateSnapshot as at, Span as au, SpanData as av, SpanError as aw, SpanImplOptions as ay, StartTraceOptions as az, AdmissionVerdict as b, WorkflowEventType as b0, WorkflowIsolation as b1, WorkflowLimits as b2, WorkflowLogEvent as b3, WorkflowMeta as b4, WorkflowModelHint as b5, WorkflowModule as b6, WorkflowParallelOptions as b7, WorkflowRun as b8, WorkflowRunState as b9, WorkflowRunStatus as ba, WorkflowSpawnAgentInput as bb, WorkflowSynthesis as bc, WorkflowSynthesizeInput as bd, WorkflowTaskHandle as be, WorkflowTaskResult as bf, WorkflowTaskSnapshot as bg, WorkflowTaskStatus as bh, WorkflowTaskUsage as bi, WorkflowWaitOptions as bj, AdmittedHandle as c, Agent as d, AgentManifest as e, AgentMessage as f, AgentMiddlewareDeclaration as g, AgentReasoningProfile as h, AgentSpanData as i, AgentTool as j, AskUserMultiOptions as k, AskUserQuestionItem as l, AskUserQuestionOptions as m, CompactionAnchor as n, CompactionConfig as o, CompactionDetails as p, CompactionResult as q, CompactionSpanData as r, CompactionUpdate as s, CurrentTodoSummary as t, Deliverable as u, DequeueFilter as v, DiscoveredInstance as w, DiscoveryOptions as x, EvidenceSpanData as y, FileOperations as z };
+type WorkflowProcessStatus = 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+type WorkflowProcessItemStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'skipped';
+type WorkflowProcessItemKind = 'phase' | 'agent' | 'step' | 'artifact';
+type WorkflowProcessSummaryStatus = 'pending' | 'result' | 'notice' | 'unavailable';
+type WorkflowProcessSource = 'command' | 'amaw' | 'review' | 'sdk' | 'capsule' | 'extension' | 'automation';
+interface WorkflowProcessItem {
+    readonly id: string;
+    readonly title: string;
+    readonly kind: WorkflowProcessItemKind;
+    readonly status: WorkflowProcessItemStatus;
+    readonly phaseId?: string;
+    readonly parentId?: string;
+    readonly agentId?: string;
+    readonly childAgentId?: string;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly startedAt?: string;
+    readonly endedAt?: string;
+    readonly summary?: string;
+    readonly summaryStatus?: WorkflowProcessSummaryStatus;
+    readonly error?: string;
+}
+interface WorkflowEventCorrelation {
+    readonly workflowRunId: string;
+    readonly childAgentId?: string;
+    readonly phaseId?: string;
+    readonly itemId?: string;
+}
+interface WorkflowProcessCounts {
+    readonly pending: number;
+    readonly running: number;
+    readonly completed: number;
+    readonly failed: number;
+    readonly cancelled: number;
+    readonly skipped: number;
+}
+interface WorkflowProcessProgress {
+    readonly spawnedAgents: number;
+    readonly finishedAgents: number;
+    readonly activeAgents: number;
+    readonly failedAgents: number;
+    readonly stoppedAgents: number;
+    readonly agentCap?: number;
+    readonly plannedItems?: number;
+}
+interface WorkflowProcessTokenUsage {
+    readonly spent: number;
+    readonly total?: number;
+}
+interface WorkflowProcessArtifact {
+    readonly name: string;
+    readonly path?: string;
+    readonly description?: string;
+}
+interface WorkflowProcessSnapshot {
+    readonly runId: string;
+    readonly workflowName: string;
+    readonly displayName?: string;
+    readonly status: WorkflowProcessStatus;
+    readonly startedAt: string;
+    readonly updatedAt: string;
+    readonly elapsedMs?: number;
+    readonly goal?: string;
+    readonly source?: WorkflowProcessSource;
+    readonly savedWorkflowName?: string;
+    readonly sourceRunId?: string;
+    readonly sourceWorkflowName?: string;
+    readonly revisionOf?: string;
+    readonly activePhaseId?: string;
+    readonly activePhaseIndex?: number;
+    readonly phaseCount?: number;
+    readonly items: readonly WorkflowProcessItem[];
+    readonly counts: WorkflowProcessCounts;
+    readonly progress: WorkflowProcessProgress;
+    readonly tokens?: WorkflowProcessTokenUsage;
+    readonly latestMessage?: string;
+    readonly resultSummary?: string;
+    readonly error?: string;
+    readonly artifacts?: readonly WorkflowProcessArtifact[];
+}
+type WorkflowProcessEvent = {
+    readonly type: 'workflow_started';
+    readonly snapshot: WorkflowProcessSnapshot;
+} | {
+    readonly type: 'workflow_updated';
+    readonly snapshot: WorkflowProcessSnapshot;
+    readonly message?: string;
+} | {
+    readonly type: 'workflow_finished';
+    readonly snapshot: WorkflowProcessSnapshot;
+};
+interface WorkflowProcessTrackerOptions {
+    readonly runId: string;
+    readonly workflowName: string;
+    readonly displayName?: string;
+    readonly goal?: string;
+    readonly source?: WorkflowProcessSource;
+    readonly savedWorkflowName?: string;
+    readonly sourceRunId?: string;
+    readonly sourceWorkflowName?: string;
+    readonly revisionOf?: string;
+    readonly phases?: readonly string[];
+    readonly maxAgents?: number;
+    readonly plannedAgents?: number;
+    readonly tokenBudget?: number;
+    readonly resultSummary?: string;
+    readonly artifacts?: readonly WorkflowArtifactRef[];
+    readonly now?: () => string;
+}
+interface WorkflowTaskSummaryUpdate {
+    readonly summary?: string;
+    readonly summaryStatus: WorkflowProcessSummaryStatus;
+}
+interface WorkflowProcessTracker {
+    applyEvent(event: WorkflowEvent): WorkflowProcessEvent;
+    updateTaskSummary(taskId: string, update: WorkflowTaskSummaryUpdate): WorkflowProcessEvent | undefined;
+    setStatus(status: WorkflowProcessStatus, message?: string): WorkflowProcessEvent;
+    setResultSummary(resultSummary: string | undefined): WorkflowProcessEvent;
+    getSnapshot(): WorkflowProcessSnapshot;
+}
+declare function isFinalWorkflowProcessStatus(status: WorkflowProcessStatus): boolean;
+declare function createWorkflowProcessTracker(options: WorkflowProcessTrackerOptions): WorkflowProcessTracker;
+
+export { DEFAULT_SYSTEM_CAP as D, GuardrailBlockedError as H, GuardrailEscalateError as J, InvariantSession as T, MAX_TOOL_LOOP_ITERATIONS as U, Tracer as aR, Runner as af, SpanImpl as ax, requestTaskStop as b$, WorkflowEventRecorder as b0, _resetAdmittedAgentBindings as bC, _resetPresetDispatchers as bD, buildAssistantMessageFromLlmResult as bE, buildSystemPrompt as bF, buildToolResultMessage as bG, collectGuardrails as bH, createAgent as bI, createHandoff as bJ, createInMemorySession as bK, createInvariantSessionForAgent as bL, createStateWriter as bM, createTrace as bN, createWorkflowProcessTracker as bO, defaultTracer as bP, detectInstructionsInjection as bQ, discoverInstances as bR, executeRunnerToolCall as bS, extractAssistantTextFromMessage as bT, getActiveUserInteraction as bU, getAdmittedAgentBindings as bV, isFinalWorkflowProcessStatus as bW, isRunnableTool as bX, isRunnerLlmResult as bY, registerChildTask as bZ, registerPresetDispatcher as b_, runAdmissionAudit as c0, runInputGuardrails as c1, runOutputGuardrails as c2, runToolAfterGuardrails as c3, runToolBeforeGuardrails as c4, setActiveUserInteraction as c5, setAdmittedAgentBindings as c6 };
+export type { PersistedSessionState as $, AdmissionAuditOptions as A, Guardrail as B, ChildTaskRegistry as C, EnqueueInput as E, FanoutSpanData as F, GenerationSpanData as G, GuardrailContext as I, GuardrailSpanData as K, GuardrailVerdict as L, Handoff as M, HandoffSpanData as N, InMemorySessionOptions as O, InputGuardrail as P, InstanceDiscoveryFs as Q, InvariantId as R, InvariantResult as S, ManifestPatch as V, MessageEntry as W, MessageMode as X, MessagePriority as Y, ObserveCtx as Z, OutputGuardrail as _, AdmissionCtx as a, WorkflowEventCorrelation as a$, PresetDispatcher as a0, PresetTracingContext as a1, QualityInvariant as a2, QueueEventListener as a3, QueuedMessage as a4, ReadonlyMutationTracker as a5, ReadonlyRecorder as a6, ReasoningDepth as a7, RecentlyModifiedFile as a8, RequestTaskStopOptions as a9, StateWriter as aA, StateWriterFs as aB, StateWriterOptions as aC, StopHookContext as aD, StopHookFn as aE, StopHookResult as aF, StopHookSpanData as aG, SystemCap as aH, TaskAbortRegistry as aI, TerminalCtx as aJ, ToolBeforeOutcome as aK, ToolCallSpanData as aL, ToolCapability as aM, ToolGuardrail as aN, ToolPermission as aO, Trace as aP, TraceOptions as aQ, TracerOptions as aS, UserInteraction as aT, WorkflowAgentBackend as aU, WorkflowApi as aV, WorkflowApproval as aW, WorkflowApprovalSummary as aX, WorkflowArtifactRef as aY, WorkflowBudget as aZ, WorkflowEvent as a_, RequestTaskStopResult as aa, RunEvent as ab, RunOptions as ac, RunResult as ad, RunnableTool as ae, RunnerEvent as ag, RunnerLlmResult as ah, RunnerLlmReturn as ai, RunnerToolCall as aj, RunnerToolContext as ak, RunnerToolObserver as al, RunnerToolResult as am, Session as an, SessionDispatchResult as ao, SessionEntry as ap, SessionExtension as aq, SessionForkOptions as ar, SessionMeta as as, SessionStateSnapshot as at, Span as au, SpanData as av, SpanError as aw, SpanImplOptions as ay, StartTraceOptions as az, AdmissionVerdict as b, WorkflowEventType as b1, WorkflowIsolation as b2, WorkflowLimits as b3, WorkflowLogEvent as b4, WorkflowMeta as b5, WorkflowModelHint as b6, WorkflowModule as b7, WorkflowParallelOptions as b8, WorkflowProcessArtifact as b9, WorkflowTaskUsage as bA, WorkflowWaitOptions as bB, WorkflowProcessCounts as ba, WorkflowProcessEvent as bb, WorkflowProcessItem as bc, WorkflowProcessItemKind as bd, WorkflowProcessItemStatus as be, WorkflowProcessProgress as bf, WorkflowProcessSnapshot as bg, WorkflowProcessSource as bh, WorkflowProcessStatus as bi, WorkflowProcessSummaryStatus as bj, WorkflowProcessTokenUsage as bk, WorkflowProcessTracker as bl, WorkflowProcessTrackerOptions as bm, WorkflowRun as bn, WorkflowRunState as bo, WorkflowRunStatus as bp, WorkflowSpawnAgentInput as bq, WorkflowSynthesis as br, WorkflowSynthesizeInput as bs, WorkflowTaskHandle as bt, WorkflowTaskResult as bu, WorkflowTaskSnapshot as bv, WorkflowTaskStatus as bw, WorkflowTaskSummaryEventUpdate as bx, WorkflowTaskSummaryKind as by, WorkflowTaskSummaryUpdate as bz, AdmittedHandle as c, Agent as d, AgentManifest as e, AgentMessage as f, AgentMiddlewareDeclaration as g, AgentReasoningProfile as h, AgentSpanData as i, AgentTool as j, AskUserMultiOptions as k, AskUserQuestionItem as l, AskUserQuestionOptions as m, CompactionAnchor as n, CompactionConfig as o, CompactionDetails as p, CompactionResult as q, CompactionSpanData as r, CompactionUpdate as s, CurrentTodoSummary as t, Deliverable as u, DequeueFilter as v, DiscoveredInstance as w, DiscoveryOptions as x, EvidenceSpanData as y, FileOperations as z };

package/dist/types-chunks/{resolver.d-B_wm409c.d.ts → resolver.d-CQfaJbht.d.ts}

@@ -61,8 +61,17 @@ declare abstract class KodaXAnthropicCompatProvider extends KodaXBaseProvider {
     abstract readonly name: string;
     readonly supportsThinking = true;
     protected abstract readonly config: KodaXProviderConfig;
-    protected client: Anthropic;
-    protected initClient(): void;
+    private _client?;
+    /**
+     * The SDK client is built lazily on first use. Constructing it requires the
+     * API key (`getApiKey()` throws when the env var is unset), so deferring it
+     * lets callers construct a provider and read static metadata (context
+     * window, model descriptors) without a key. This also keeps key-less unit
+     * tests (which mock the actual LLM calls) from failing at construction time.
+     */
+    protected get client(): Anthropic;
+    protected set client(client: Anthropic);
+    protected buildClient(): Anthropic;
     protected onStaleConnection(): void;
     /**
      * FEATURE_216 v0.7.45 — Lightweight credential verification.
@@ -122,8 +131,17 @@ declare abstract class KodaXOpenAICompatProvider extends KodaXBaseProvider {
     abstract readonly name: string;
     readonly supportsThinking = true;
     protected abstract readonly config: KodaXProviderConfig;
-    protected client: OpenAI;
-    protected initClient(): void;
+    private _client?;
+    /**
+     * The SDK client is built lazily on first use. Constructing it requires the
+     * API key (`getApiKey()` throws when the env var is unset), so deferring it
+     * lets callers construct a provider and read static metadata (context
+     * window, model descriptors) without a key. This also keeps key-less unit
+     * tests (which mock the actual LLM calls) from failing at construction time.
+     */
+    protected get client(): OpenAI;
+    protected set client(client: OpenAI);
+    protected buildClient(): OpenAI;
     protected onStaleConnection(): void;
     /**
      * FEATURE_216 v0.7.45 — Lightweight credential verification.

package/dist/types-chunks/{utils.d-BJ_-y8gC.d.ts → utils.d-D_-jrRku.d.ts}

@@ -1,7 +1,8 @@
-import { i as BashPrefixExtractor, a4 as KodaXOptions, M as KodaXContextTokenSnapshot, K as KodaXAgentMode, a9 as KodaXRepoIntelligenceMode, A as AgentsFile, f as AutoModeStats, al as KodaXSkillInvocationContext, a1 as KodaXMcpServersConfig } from './bash-prefix-extractor.d-CI_xcPhn.js';
+import { i as BashPrefixExtractor, a5 as KodaXOptions, N as KodaXContextTokenSnapshot, x as KodaXAgentMode, aa as KodaXRepoIntelligenceMode, A as AgentsFile, f as AutoModeStats, am as KodaXSkillInvocationContext, a2 as KodaXMcpServersConfig } from './bash-prefix-extractor.d-B0CIb0N3.js';
 import { a as SessionStorage$1 } from './storage.d-J2GqOgaX.js';
 import { y as KodaXSessionStorage, n as KodaXSessionData, A as KodaXSessionUiHistoryItem, s as KodaXSessionLineage, k as KodaXSessionArtifactLedgerEntry, w as KodaXSessionRuntimeInfo } from './types.d-BnjX2Gn4.js';
 import { n as KodaXMessage, E as KodaXReasoningMode, r as KodaXProviderCapabilityProfile, F as KodaXReasoningOverride, h as KodaXCustomProviderConfig } from './types.d-rPRl2LSB.js';
+import { bh as WorkflowProcessSource } from './process.d-BbiXD24v.js';
 import * as readline from 'readline';
 import { SpawnSyncReturns } from 'child_process';
 
@@ -347,6 +348,7 @@ interface CommandWorkflowInvocationRequest {
     request: string;
     source: 'command' | 'natural-language';
     displayName: string;
+    processSource?: WorkflowProcessSource;
 }
 type CommandResult$1 = boolean | CommandResultData;
 type CommandHandler = (args: string[], context: InteractiveContext, callbacks: CommandCallbacks, currentConfig: CurrentConfig) => Promise<CommandResult$1 | void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kodax-ai/kodax",
-  "version": "0.7.49",
+  "version": "0.7.50",
   "description": "极致轻量化 Coding Agent - TypeScript 实现，支持 12 个 LLM 提供商，可发布为免 Node 单文件二进制",
   "type": "module",
   "private": false,

package/dist/chunks/argument-completer-GDG5OHN7.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-ISGHUKRY.js";import"./chunk-TYZAH3YP.js";import"./chunk-YW4RQV7U.js";import"./chunk-67SWUEEN.js";import"./chunk-YACQ4OST.js";import"./chunk-JTHMWRXM.js";import"./chunk-V4WSBIXB.js";export{a as ArgumentCompleter,b as createArgumentCompleter};