qlogicagent 2.2.0 → 2.4.0

package/dist/types/agent/types.d.ts

@@ -1,115 +1,35 @@
 /**
- * Pure agent types — zero I/O framework dependencies.
+ * Pure agent types 鈥?zero I/O framework dependencies.
  *
- * These types define the contract between:
- *   - CLI stdio layer ↔ Agent class
- *   - Agent class ↔ LLM Provider
- *   - Agent class ↔ Tool loop
- *
- * Ported from Hub semantic-turn-shared.ts / semantic-turn-tools.ts,
- * with Hub infrastructure (WS/PG/Redis) replaced by DI interfaces.
- *
- * No imports from express/pg/ioredis/ws.
+ * Wire-level types (ChatMessage, ToolDefinition) are canonical in
+ * protocol/wire/. This file re-exports them and adds
+ * internal-only extensions (e.g. backfillObservableInput on ToolDefinition).
  */
 import type { SkillInstruction } from "../orchestration/index.js";
 import type { HookRegistry } from "../contracts/hooks.js";
 import type { MediaCapability } from "../llm/provider-def.js";
-export type ChatMessageRole = "system" | "user" | "assistant" | "tool";
-/** Thinking block from Anthropic Messages API (DeepSeek, Claude, etc.) */
-export interface ThinkingBlock {
-    thinking: string;
-    signature: string;
-}
-export interface ChatMessage {
-    role: ChatMessageRole;
-    content: string | null;
-    /** For assistant messages with tool calls */
-    tool_calls?: ToolCallMessage[];
-    /** For tool result messages */
-    tool_call_id?: string;
-    /** For tool result messages — tool name */
-    name?: string;
-    /** Anthropic thinking blocks — must be passed back to API in subsequent requests */
-    thinkingBlocks?: ThinkingBlock[];
-    /**
-     * Image URLs for vision-capable models.
-     * Transports convert these into the provider's native content block format:
-     *   - OpenAI-chat: [{type:"text",text:...},{type:"image_url",image_url:{url:...}}]
-     *   - Anthropic: [{type:"text",text:...},{type:"image",source:{type:"url",url:...}}]
-     * Valid on role="user" and role="tool" messages.
-     * For tool results, images are resolved via FileUploadAdapter before sending to LLM.
-     */
-    imageUrls?: string[];
-    /** Image detail level for vision understanding: 'auto' | 'low' | 'high' | 'xhigh' */
-    imageDetail?: "auto" | "low" | "high" | "xhigh";
-    /** Max image pixels budget for vision understanding (Volcengine image_pixel_limit) */
-    imagePixelLimit?: {
-        minPixels?: number;
-        maxPixels?: number;
-    };
-    /** Video URLs for video-understanding models. Only valid on role="user" messages. */
-    videoUrls?: string[];
-    /** Per-video fps for video understanding (0.2-5, default 1) */
-    videoFps?: number;
-    /** Audio format hint for audio understanding: 'mp3' | 'wav' | 'aac' | 'm4a' */
-    audioFormat?: "mp3" | "wav" | "aac" | "m4a";
-    /** Audio URLs for audio-understanding models. Only valid on role="user" messages. */
-    audioUrls?: string[];
-    /**
-     * Pre-uploaded file IDs for document/media understanding.
-     * Used with Files API — each entry is a { id, mimeType } pair.
-     * Only valid on role="user" messages.
-     */
-    fileIds?: Array<{
-        id: string;
-        mimeType?: string;
-    }>;
-}
-export interface ToolCallMessage {
-    id: string;
-    type: "function";
-    function: {
-        name: string;
-        arguments: string;
-    };
-}
-export interface ToolDefinition {
-    type: "function";
-    function: {
-        name: string;
-        description: string;
-        parameters?: Record<string, unknown>;
-    };
-    /** Tool scheduling metadata from host manifest (optional) */
-    meta?: {
-        serialOnly?: boolean;
-        parallelSafe?: boolean;
-        /** If true, host should request user approval before execution (CC PreToolUse parity) */
-        requiresApproval?: boolean;
-        /** Tool is read-only / safe — skip approval even in strict mode */
-        isReadOnly?: boolean;
-        /** Tool can cause irreversible side-effects — force approval in default mode */
-        isDangerous?: boolean;
-    };
+import type { ChatMessage as WireChatMessage, ChatMessageRole as WireChatMessageRole, ThinkingBlock as WireThinkingBlock, ToolCallMessage as WireToolCallMessage, ToolDefinition as WireToolDefinition, WireTokenUsage } from "../protocol/wire/index.js";
+export type ChatMessageRole = WireChatMessageRole;
+export type ThinkingBlock = WireThinkingBlock;
+export type ToolCallMessage = WireToolCallMessage;
+export type ChatMessage = WireChatMessage;
+export interface ToolDefinition extends WireToolDefinition {
     /**
      * Backfill derived/legacy fields onto a shallow copy of the tool input
      * before hooks and observers see it (CC backfillObservableInput parity).
      * The original API-bound input is never modified.
+     * Internal-only 鈥?never serialized over JSON-RPC.
      */
     backfillObservableInput?: (input: Record<string, unknown>) => void;
 }
-export interface TokenUsage {
-    prompt: number;
-    completion: number;
-    /** Reasoning tokens (for models like o1/DeepSeek-R1) */
-    reasoning?: number;
-    /** Prompt cache read tokens (CC cache_read_input_tokens parity) */
-    cacheRead?: number;
-    /** Prompt cache creation tokens (CC cache_creation_input_tokens parity) */
-    cacheCreation?: number;
-}
 /**
- * Why the previous iteration continued — each variant corresponds to one of
+ * Token usage 鈥?unified with WireTokenUsage from contracts.
+ * No more internal/wire split: all code uses the same field names
+ * (inputTokens, outputTokens, reasoningTokens, cacheRead, cacheWrite).
+ */
+export type TokenUsage = WireTokenUsage;
+/**
+ * Why the previous iteration continued 鈥?each variant corresponds to one of
  * the 7 `continue` sites in the main while(true) loop.
  * Tests can assert recovery paths fired without inspecting message contents.
  */
@@ -194,7 +114,7 @@ export interface TurnConfig {
     summaryModel?: string;
     /** Max concurrent tool executions (0 = unlimited). */
     maxConcurrentTools?: number;
-    /** Model requires streaming — disable non-streaming fallback. */
+    /** Model requires streaming 鈥?disable non-streaming fallback. */
     streamRequired?: boolean;
     /** Reasoning effort for models that support it (GPT-5.x, o-series). */
     reasoning?: {
@@ -221,7 +141,7 @@ export interface TurnConfig {
     /**
      * User-designated provider+model per media category.
      * Each entry maps a media type (image/video/music/tts/3d/...) to
-     * the specific provider and model the user chose. No failover —
+     * the specific provider and model the user chose. No failover 鈥?
      * if the designated provider fails, the error propagates directly.
      */
     mediaProviders?: Partial<Record<MediaCapability, {
@@ -371,8 +291,12 @@ export interface ToolInvoker {
  */
 export interface AgentLogger {
     info(message: string): void;
+    info(obj: Record<string, unknown>, message: string): void;
     warn(message: string): void;
+    warn(obj: Record<string, unknown>, message: string): void;
     error(message: string): void;
+    error(obj: Record<string, unknown>, message: string): void;
     debug(message: string): void;
+    debug(obj: Record<string, unknown>, message: string): void;
 }
 export type { HookRegistry };

package/dist/types/cli/stdio-server.d.ts

@@ -92,6 +92,11 @@ export declare class StdioServer {
      * Always returns the InitializeResult shape.
      */
     private handleInitialize;
+    /**
+     * Ensure a default project exists on first start.
+     * Called from both legacy handleInitialize and ACP acpHandleInitialize.
+     */
+    private ensureDefaultProject;
     /**
      * `thread.create` — create a new thread (session container).
      * Maps threadId → sessionId for the underlying session system.
@@ -173,6 +178,16 @@ export declare class StdioServer {
      * `config.update` — Update agent runtime configuration (merges into settings.json).
      */
     private handleConfigUpdate;
+    /**
+     * `config.tunables` — Return all tunable default values with their current overrides.
+     */
+    private handleConfigTunables;
+    /**
+     * `config.updateTunable` — Write a single tunable override into settings.json.tunables.
+     * Params: { key: string, value: number | boolean | string }
+     * Only keys that exist in TunableDefaults are accepted (validation).
+     */
+    private handleConfigUpdateTunable;
     /**
      * `todos.list` — Query current todo items and summary.
      * Invokes the registered todo tool's list action.
@@ -296,13 +311,23 @@ export declare class StdioServer {
     private acpHandleSoloStart;
     private acpHandleSoloStatus;
     private acpHandleSoloSelect;
+    private acpHandleSoloCancel;
+    private acpHandleSoloSubscribe;
+    private acpHandleAgentsList;
     private acpHandleProductCreate;
     private acpHandleProductResume;
     private acpHandleProductStatus;
+    private acpHandleProductPause;
+    private acpHandleProductCancel;
+    private acpHandleProductRollback;
+    private acpHandleProductSubscribe;
     private acpHandleTeamDelegate;
     private handleProjectCreate;
     private handleProjectList;
     private handleProjectDelete;
+    private handleProjectRename;
+    private handleProjectArchive;
+    private handleProjectUnarchive;
     private handleProjectArchiveByGroup;
     private handleSessionSwitchProject;
     private handleSessionGetState;
@@ -312,8 +337,23 @@ export declare class StdioServer {
     private handleInstructionsWrite;
     private handleInstructionsDelete;
     private handleSkillsList;
+    /** Extract version and description from a SKILL.md frontmatter. */
+    private extractSkillMeta;
     private handleSkillsActivate;
     private handleSkillsDeactivate;
+    /**
+     * `skills.delete` — Permanently remove a skill from project or global scope.
+     * Params: { name: string, scope?: "project" | "global" }
+     * Default scope: "project"
+     */
+    private handleSkillsDelete;
+    /**
+     * `skills.promote` — Copy a project-level skill to global (user-level).
+     * Params: { name: string, keepLocal?: boolean }
+     * By default removes the project-level copy after promoting.
+     */
+    private handleSkillsPromote;
+    private handleSkillsStats;
     private getProjectPlanStore;
     private handlePlansList;
     private handlePlansGet;

package/dist/types/cli/tool-bootstrap.d.ts

@@ -14,6 +14,12 @@ export declare function setGroupSecurityMode(enabled: boolean): void;
  * falling back to SearXNG. Called from stdio-server per session.
  */
 export declare function setProviderToolAPI(api: ProviderToolAPI | undefined): void;
+/** Set callback invoked after LLM-driven project switch. */
+export declare function setProjectSwitchCallback(cb: ((project: {
+    id: string;
+    name: string;
+    workspaceDir: string;
+}) => void) | undefined): void;
 /**
  * Set task tool lifecycle hooks. Called from stdio-server when session starts.
  * Connects planning-task events to the HookRegistry.

package/dist/types/contracts/index.d.ts

@@ -1,8 +1,7 @@
 /**
- * Internal contracts — types internalized from qlogicagent-runtime-contracts.
+ * Internal contracts — hooks + todo types.
  *
- * These types are only consumed within qlogicagent itself (agent runtime + hub).
- * They were removed from the public npm package to slim the cross-repo API surface.
+ * These types are only consumed within qlogicagent itself.
  */
 export * from "./todo.js";
 export * from "./hooks.js";

package/dist/types/llm/provider-def.d.ts

@@ -107,6 +107,9 @@ export interface ProviderQuirks {
     filterImageBlocks?: boolean;
     /** DeepSeek: budget_tokens ignored, use output_config.effort instead */
     useEffortInsteadOfBudget?: boolean;
+    /** Provider natively supports PDF/document content blocks (Anthropic document, Gemini fileData).
+     *  When false, PDFs are annotated as text labels and the agent must use tools to extract content. */
+    supportsDocumentVision?: boolean;
     /** Provider supports reasoning_effort param (Kimi K2, OpenAI o-series) */
     supportsReasoningEffort?: boolean;
     /** Provider has built-in web search (Kimi: builtin_function.$web_search, GLM: web_search) */

package/dist/types/llm/transport.d.ts

@@ -1,14 +1,14 @@
 /**
- * LLMTransport — abstract interface for LLM inference calls.
+ * LLMTransport 鈥?abstract interface for LLM inference calls.
  *
  * Aligned with Hermes `ProviderTransport` ABC:
- *   stream(request, apiKey, signal) → AsyncGenerator<LLMChunk>
+ *   stream(request, apiKey, signal) 鈫?AsyncGenerator<LLMChunk>
  *
  * Two concrete implementations:
  *   - OpenAI Chat Completions (covers 95% of providers)
  *   - Anthropic Messages API
  */
-import type { ChatMessage, ToolDefinition } from "../agent/types.js";
+import type { ChatMessage, ToolDefinition } from "../protocol/wire/index.js";
 export type StructuredOutputConfig = {
     mode: "json_object";
 } | {
@@ -19,7 +19,7 @@ export type StructuredOutputConfig = {
 };
 export interface CachingConfig {
     type: "enabled" | "disabled";
-    /** Enable prefix caching mode (§20.3). Requires store=true and stream=false. */
+    /** Enable prefix caching mode (搂20.3). Requires store=true and stream=false. */
     prefix?: boolean;
 }
 export type ContextEdit = {
@@ -58,10 +58,10 @@ export interface LLMRequest {
     maxTokens?: number;
     reasoning?: {
         effort: "minimal" | "low" | "medium" | "high" | "xhigh";
-        /** Request encrypted original reasoning content (Volcengine §17.7). */
+        /** Request encrypted original reasoning content (Volcengine 搂17.7). */
         includeEncryptedReasoning?: boolean;
     };
-    /** Volcengine: max builtin tool calls per turn (§19.15). */
+    /** Volcengine: max builtin tool calls per turn (搂19.15). */
     maxToolCalls?: number;
     /**
      * DeepSeek prefix completion: force model to continue from this prefix.
@@ -69,7 +69,7 @@ export interface LLMRequest {
      */
     prefixMessage?: string;
     /**
-     * Model requires streaming — disable non-streaming fallback in transports.
+     * Model requires streaming 鈥?disable non-streaming fallback in transports.
      * When true, transports must NOT fall back to non-streaming requests on failure.
      * Set for models like QwQ/Omni where the provider rejects non-streaming calls.
      */
@@ -89,49 +89,49 @@ export interface LLMRequest {
         config?: Record<string, unknown>;
     }>;
     /**
-     * Server-side context continuation via response chain (§5).
+     * Server-side context continuation via response chain (搂5).
      * When set, the server automatically includes previous context,
      * so messages[] only needs to contain the NEW user message.
      */
     previousResponseId?: string;
     /**
-     * Control server-side storage of this request's input/output (§5.1).
+     * Control server-side storage of this request's input/output (搂5.1).
      * Default: true (server stores for 3 days).
      */
     store?: boolean;
     /** Expiration time for stored response (Unix seconds, max 7 days from now) */
     storeExpireAt?: number;
     /**
-     * Per-turn system instruction augmentation (§8).
+     * Per-turn system instruction augmentation (搂8).
      * Temporarily overlays persona or adds constraints for this turn only.
-     * NOTE: Incompatible with caching — do not use both together.
+     * NOTE: Incompatible with caching 鈥?do not use both together.
      */
     instructions?: string;
     /**
-     * Structured output format (§16).
+     * Structured output format (搂16).
      * Forces model to produce JSON conforming to the specified schema.
      */
     structuredOutput?: StructuredOutputConfig;
     /**
-     * Caching configuration (§20).
+     * Caching configuration (搂20).
      * Controls prefix/session caching behavior.
      * NOTE: Incompatible with instructions, json_schema, and builtin tools.
      */
     caching?: CachingConfig;
     /**
-     * Context management edits (§21, beta).
+     * Context management edits (搂21, beta).
      * Server-side trimming of historical thinking chains and tool call traces.
      */
     contextManagement?: ContextManagementConfig;
     /**
-     * Gemini explicit cache reference (gemini-ProviderMax §8).
+     * Gemini explicit cache reference (gemini-ProviderMax 搂8).
      * Passes a pre-created cache name (e.g. "cachedContents/abc123") to
      * generateContent so the server uses cached tokens instead of re-processing.
      * Create caches via GeminiCacheAPI.createCache() first.
      */
     cachedContent?: string;
     /**
-     * Predicted output for speculative decoding (openai-ProviderMax §11).
+     * Predicted output for speculative decoding (openai-ProviderMax 搂11).
      * When editing code, pass the existing content so the model can diff efficiently.
      * Reduces latency by 3-5x when prediction matches. Falls back when it doesn't.
      * Works with OpenAI GPT-5.x models via Responses API and Chat Completions.
@@ -141,24 +141,24 @@ export interface LLMRequest {
         content: string;
     };
     /**
-     * Prompt cache bucketing key (openai-ProviderMax §11).
+     * Prompt cache bucketing key (openai-ProviderMax 搂11).
      * Replaces the deprecated `user` field. Helps OpenAI group similar requests
      * for higher cache hit rates.
      */
     promptCacheKey?: string;
     /**
-     * Prompt cache retention policy (openai-ProviderMax §11).
+     * Prompt cache retention policy (openai-ProviderMax 搂11).
      * "in_memory" = default 5-10 min, "24h" = extended up to 24 hours.
      */
     promptCacheRetention?: "in_memory" | "24h";
     /**
-     * Service tier for request scheduling (openai-ProviderMax §14).
+     * Service tier for request scheduling (openai-ProviderMax 搂14).
      * "auto" = project default, "flex" = 50% cheaper / higher latency,
      * "priority" = guaranteed low latency.
      */
     serviceTier?: "auto" | "default" | "flex" | "priority";
     /**
-     * OpenAI Responses API built-in tools (openai-ProviderMax §7).
+     * OpenAI Responses API built-in tools (openai-ProviderMax 搂7).
      * Platform-executed tools like web_search, file_search, code_interpreter, etc.
      */
     openaiBuiltinTools?: Array<{
@@ -166,8 +166,8 @@ export interface LLMRequest {
         [key: string]: unknown;
     }>;
     /**
-     * OpenAI Responses API conversation ID (openai-ProviderMax §2.1).
-     * Alternative to previous_response_id — persistent server-side conversation.
+     * OpenAI Responses API conversation ID (openai-ProviderMax 搂2.1).
+     * Alternative to previous_response_id 鈥?persistent server-side conversation.
      * Cannot be used together with previousResponseId.
      */
     conversationId?: string;
@@ -177,13 +177,13 @@ export interface LLMRequest {
      */
     parallelToolCalls?: boolean;
     /**
-     * Text output verbosity hint (openai-ProviderMax §5).
+     * Text output verbosity hint (openai-ProviderMax 搂5).
      * Controls how detailed the model's textual output should be.
      */
     textVerbosity?: "low" | "medium" | "high";
 }
 /**
- * FIM completion request — DeepSeek Beta Completions API.
+ * FIM completion request 鈥?DeepSeek Beta Completions API.
  * POST /beta/v1/completions with prompt + suffix.
  * Only works with non-thinking mode.
  */
@@ -267,7 +267,7 @@ export interface LLMTransport {
      */
     stream(request: LLMRequest, apiKey: string, signal?: AbortSignal): AsyncGenerator<LLMChunk>;
     /**
-     * FIM (Fill-In-Middle) completion — optional capability.
+     * FIM (Fill-In-Middle) completion 鈥?optional capability.
      * Only implemented by providers that support it (DeepSeek /beta endpoint).
      */
     complete?(request: FIMRequest, apiKey: string, signal?: AbortSignal): AsyncGenerator<FIMChunk>;

package/dist/types/llm/transports/anthropic-messages.d.ts

@@ -1,5 +1,5 @@
 /**
- * Anthropic Messages Transport — SSE streaming for Claude API.
+ * Anthropic Messages Transport 鈥?SSE streaming for Claude API.
  *
  * Aligned with CC (claude-code-haha) src/services/api/claude.ts:
  *   - cache_control ephemeral injection on system prompt blocks
@@ -26,7 +26,7 @@ export interface AnthropicTransportConfig {
     enablePromptCaching?: boolean;
     /** Max retry attempts on transient errors (default 3) */
     maxRetries?: number;
-    /** Omit temperature when it equals 0 — MiniMax rejects temperature=0 */
+    /** Omit temperature when it equals 0 鈥?MiniMax rejects temperature=0 */
     omitZeroTemperature?: boolean;
     /** Provider-specific quirks for conditional logic (CC/altcode parity) */
     quirks?: ProviderQuirks;

package/dist/types/llm/transports/gemini-generatecontent.d.ts

@@ -1,10 +1,10 @@
 /**
- * Gemini generateContent Transport — Native Gemini API streaming implementation.
+ * Gemini generateContent Transport 鈥?Native Gemini API streaming implementation.
  *
  * Targets Gemini 3 series exclusively (3.1 Pro, 3 Flash, 3.1 Flash-Lite).
  * Uses the native Gemini REST API instead of the OpenAI compatibility layer,
  * unlocking Gemini-exclusive features unavailable via the compat endpoint:
- *   - thinkingConfig (thinkingLevel — G3 native control)
+ *   - thinkingConfig (thinkingLevel 鈥?G3 native control)
  *   - Google Search / Maps Grounding
  *   - Code Execution
  *   - Safety Settings fine-grained control

package/dist/types/llm/transports/openai-chat.d.ts

@@ -1,5 +1,5 @@
 /**
- * OpenAI Chat Completions Transport — SSE streaming implementation.
+ * OpenAI Chat Completions Transport 鈥?SSE streaming implementation.
  *
  * Covers all OpenAI-compatible providers:
  *   DeepSeek, Qwen, Minimax, Moonshot, OpenRouter, etc.
@@ -70,7 +70,7 @@ export declare class OpenAIChatTransport implements LLMTransport {
         bytes: number;
     }>;
     /**
-     * Get file content/status — GET /v1/files/{file_id}
+     * Get file content/status 鈥?GET /v1/files/{file_id}
      */
     getFileInfo(fileId: string, apiKey: string, signal?: AbortSignal): Promise<{
         id: string;

package/dist/types/llm/transports/openai-responses.d.ts

@@ -1,5 +1,5 @@
 /**
- * OpenAI Responses API Transport — SSE streaming implementation.
+ * OpenAI Responses API Transport 鈥?SSE streaming implementation.
  *
  * Implements the OpenAI Responses API (`POST /v1/responses`),
  * the officially recommended path for GPT-5.x text generation.
@@ -49,14 +49,14 @@ export declare class OpenAIResponsesTransport implements LLMTransport {
      *
      * Event format: "event: <type>\ndata: <json>\n\n"
      * Key events:
-     *   - response.output_text.delta           → text content delta
-     *   - response.reasoning_summary_text.delta → reasoning summary text
-     *   - response.function_call_arguments.delta → tool call arguments streaming
-     *   - response.output_item.added           → new output item started
-     *   - response.output_item.done            → output item completed
-     *   - response.content_part.done           → content part completed (annotations)
-     *   - response.completed                   → full response complete with usage
-     *   - response.failed                      → error
+     *   - response.output_text.delta           鈫?text content delta
+     *   - response.reasoning_summary_text.delta 鈫?reasoning summary text
+     *   - response.function_call_arguments.delta 鈫?tool call arguments streaming
+     *   - response.output_item.added           鈫?new output item started
+     *   - response.output_item.done            鈫?output item completed
+     *   - response.content_part.done           鈫?content part completed (annotations)
+     *   - response.completed                   鈫?full response complete with usage
+     *   - response.failed                      鈫?error
      */
     private parseSSEStream;
     private processEvent;

package/dist/types/llm/transports/volcengine-responses.d.ts

@@ -1,5 +1,5 @@
 /**
- * Volcengine Responses API Transport — SSE streaming implementation.
+ * Volcengine Responses API Transport 鈥?SSE streaming implementation.
  *
  * Implements the fire mountain ark Responses API (`/api/v3/responses`),
  * which is the officially recommended primary path for Doubao LLM text generation
@@ -37,9 +37,9 @@ export declare class VolcengineResponsesTransport implements LLMTransport {
     stream(request: LLMRequest, apiKey: string, signal?: AbortSignal): AsyncGenerator<LLMChunk>;
     /**
      * Resolve known Volcengine Responses API incompatibilities:
-     *   - instructions + caching → drop caching (§20.7)
-     *   - caching + json_schema → downgrade to json_object (§20.10)
-     *   - caching + builtin_web_search/image_process → drop those builtin tools
+     *   - instructions + caching 鈫?drop caching (搂20.7)
+     *   - caching + json_schema 鈫?downgrade to json_object (搂20.10)
+     *   - caching + builtin_web_search/image_process 鈫?drop those builtin tools
      * Returns a shallow copy with fields adjusted; never mutates the original.
      */
     private resolveConstraints;
@@ -51,13 +51,13 @@ export declare class VolcengineResponsesTransport implements LLMTransport {
      *
      * Event format: "event: <type>\ndata: <json>\n\n"
      * Key events:
-     *   - response.output_text.delta           → text content delta
-     *   - response.reasoning_summary_text.delta → thinking/reasoning text
-     *   - response.function_call_arguments.delta → tool call arguments streaming
-     *   - response.output_item.added           → new output item started
-     *   - response.output_item.done            → output item completed
-     *   - response.completed                   → full response complete with usage
-     *   - response.failed                      → error
+     *   - response.output_text.delta           鈫?text content delta
+     *   - response.reasoning_summary_text.delta 鈫?thinking/reasoning text
+     *   - response.function_call_arguments.delta 鈫?tool call arguments streaming
+     *   - response.output_item.added           鈫?new output item started
+     *   - response.output_item.done            鈫?output item completed
+     *   - response.completed                   鈫?full response complete with usage
+     *   - response.failed                      鈫?error
      */
     private parseSSEStream;
     private processEvent;

package/dist/types/orchestration/agent-instance.d.ts

@@ -26,6 +26,19 @@ export interface ProductCallbacks {
     onCheckpointed?: (productId: string, timestamp: string) => void;
     onBudgetWarning?: (productId: string, usedTokens: number, maxTotalTokens: number, percentage: number) => void;
     onCompleted?: (productId: string, summary: string) => void;
+    /** DAG topology resolved and sent to client for visualization. */
+    onDagTopology?: (productId: string, nodes: {
+        id: string;
+        label: string;
+        deps: string[];
+    }[], edges: {
+        from: string;
+        to: string;
+    }[]) => void;
+    /** Real-time budget consumption update. */
+    onBudgetUpdate?: (productId: string, inputTokens: number, outputTokens: number, elapsed: number, maxTotalTokens?: number) => void;
+    /** Streaming text output from a running task. */
+    onTaskOutputDelta?: (productId: string, taskId: string, text: string) => void;
 }
 export declare class ProductOrchestrator {
     private processManager;
@@ -46,6 +59,8 @@ export declare class ProductOrchestrator {
     checkpoint(productId: string): Promise<void>;
     /** Delete a product session, pausing first if active. */
     delete(productId: string): Promise<void>;
+    /** Rollback a product to a checkpoint: delete running session then resume from disk. */
+    rollback(productId: string, _checkpoint: string): Promise<void>;
     /** Get product status. */
     getStatus(productId: string): ProductStatus | null;
     /** List all products (in-memory + on-disk). */