qlogicagent 2.20.6 → 2.20.8

package/dist/types/cli/handlers/turn-handler.d.ts

@@ -3,7 +3,6 @@
  * Handles: the shared turn pipeline (runTurnPipeline) + thread.user_response (ask-user answers).
  */
 import { type ModelPurpose } from "../../runtime/infra/model-registry.js";
-import { type UnderstandMediaKind } from "../media-understanding.js";
 import { type InstructionFileInfo } from "../../runtime/prompt/instruction-loader.js";
 import type { HookRegistry } from "../../contracts/hooks.js";
 export { isStructuredPlannerSystemPrompt } from "../../contracts/structured-planner.js";
@@ -11,6 +10,7 @@ import type { AppendMessageOutcome } from "../../runtime/session/session-transcr
 import type { PermissionMetadataResolver, ToolCatalog } from "../../runtime/ports/index.js";
 import type { ChatMessage, TokenUsage, ToolDefinition, TurnConfig } from "../../agent/types.js";
 import type { AgentRpcRequest } from "../../protocol/wire/agent-rpc.js";
+type UnderstandMediaKind = "image" | "video" | "audio";
 interface PendingAskUserRequest {
     resolve(answers: Record<string, string> | null): void;
 }
@@ -19,7 +19,6 @@ export interface TurnControlHandlerHost {
     permissionChecker?: PermissionMetadataResolver | null;
     toolCatalog?: ToolCatalog;
     pendingAskUser: Map<string, PendingAskUserRequest>;
-    configureTurnMedia?(config: Record<string, unknown> | undefined, turnId: string): void;
     log(message: string): void;
     sendResponse(id: string | number, result?: unknown, error?: unknown): void;
     /** Mid-turn guidance queue (运行中引导) — drained by the tool loop each round. */
@@ -111,13 +110,11 @@ export declare function getLatestUserTextForTurn(messages: readonly ChatMessage[
 /**
  * Insert a SYSTEM-role context message immediately BEFORE the last user message (LLM view only).
  *
- * Used for pinned-skill SKILL.md (cc-parity "add plugin"): the model must follow the skill for THIS
- * turn, but the SKILL.md must NOT be parsed as part of the user's literal request. The completion-
+ * Used for user-selected Host Skill instructions: the model must load the Skill for THIS turn, but
+ * the selection directive must NOT be parsed as part of the user's literal request. The completion-
  * verification heuristics (final-marker extraction, explicit required-file checks, explicit-artifact
- * counting, round/tool budget sizing) all scan `role === "user"` content only — so a SKILL.md baked
- * into the user message poisons every one of them: a skill's internal QA label like "Gate 3 PASS"
- * becomes a phantom user-requested completion marker, and the skill's example file paths inflate the
- * artifact count and budgets. A system message keeps the model bound to the instructions while being
+ * counting, round/tool budget sizing) all scan `role === "user"` content only. A system message
+ * keeps the model bound to the Host loading directive while being
  * invisible to those user-intent scans. The original array/objects are never mutated.
  */
 export declare function injectSkillContextBeforeLastUser(messages: ChatMessage[], skillContext: string): ChatMessage[];
@@ -137,8 +134,8 @@ export declare function injectSkillContextBeforeLastUser(messages: ChatMessage[]
  * Two-layer memory INDEX block for the per-turn conversation channel (global
  * owner cheat-sheet first, then project notes; injected before the last user
  * message next to the domain block). Living here instead of the system prompt
- * is deliberate: INDEX content changes whenever the agent takes a note, and as
- * a volatile system-prompt section every memory(add) re-encoded the byte-stable
+ * is deliberate: INDEX content changes whenever Host project memory is updated,
+ * and as a volatile system-prompt section every update re-encoded the byte-stable
  * prefix plus the whole conversation history on the next turn. In the per-turn
  * channel only the tail changes — the cached prefix survives.
  */
@@ -169,11 +166,11 @@ export interface MediaUnderstandingPlan {
 /**
  * Detect the media modalities the resolved main model can't consume, STRIP the media fields (a text-only
  * model 400s on multimodal content), and PLAN what to tell the model: which refs to call the understanding
- * tool on, and which kinds it must honestly report as unreadable (no understanding model bound, or every
+ * tool on, and which kinds it must honestly report as unreadable (no Host Media MCP tool projected, or every
  * ref is a non-addressable data:/oversized URL). It does NOT transcribe and does NOT touch the message
  * text — the plan is surfaced via a model-only notice so the model calls image_understand /
  * video_understand / stt itself, exactly as it would for an in-message media path; the user's bubble
- * stays clean. This is the ONLY media-understanding path (the legacy eager pre-inject was fully retired).
+ * stays clean. Understanding executes through the Host-projected Media MCP tool.
  *
  * Reliability note: unlike the eager path, this DEPENDS on the model calling the tool — the medium is not
  * transcribed anywhere, so if the model ignores the notice the understanding does not happen this turn

package/dist/types/cli/memory-candidate-service.d.ts

@@ -9,7 +9,7 @@ interface MemoryLlmClient {
     };
 }
 /** Model purposes the memory pipeline can resolve (text + multimodal). */
-export type MemoryModelPurpose = "smallModel" | "textGeneration" | "imageUnderstanding" | "stt" | "videoUnderstanding";
+export type MemoryModelPurpose = "smallModel" | "textGeneration";
 export interface MemoryCandidateHost {
     memoryProvider?: {
         search?(query: string, userId: string, options?: {
@@ -20,13 +20,6 @@ export interface MemoryCandidateHost {
             score?: number;
             metadata?: Record<string, unknown>;
         }>>;
-        /** Read an uploaded attachment's bytes (for multimodal understanding). */
-        readAttachmentBytes?(id: string): Promise<{
-            bytes: Buffer;
-            mimeType: string;
-        } | null>;
-        /** Persist the understood/extracted text back on the attachment row. */
-        setAttachmentText?(id: string, text: string): void;
     } | null;
     resolveClientForPurpose?(purpose: MemoryModelPurpose): MemoryLlmClient | null;
 }

package/dist/types/cli/memory-coordinator.d.ts

@@ -2,13 +2,12 @@ import { type HostRequestRequester } from "../skills/memory/host-memory-provider
 import { type MemoryPrefetchState } from "../runtime/hooks/memory-hooks.js";
 import type { HookRegistry } from "../contracts/hooks.js";
 import type { RuntimeLogger } from "../runtime/hooks/hook-registry.js";
-import type { MemoryDreamRuntimeProvider, MemoryExtractionQueue, MemoryHandlerProvider, MemoryLearningSink, MemoryProvider, MemoryRuntimeHookProvider, MemoryToolProvider, ProjectMemoryStore, ToolCatalog } from "../runtime/ports/index.js";
+import type { MemoryDreamRuntimeProvider, MemoryExtractionQueue, MemoryHandlerProvider, MemoryLearningSink, MemoryProvider, MemoryRuntimeHookProvider } from "../runtime/ports/index.js";
 import type { LLMTransport } from "./provider-core-facade.js";
 export interface MemoryProviderState {
     recallProvider: MemoryProvider;
     runtimeHookProvider: MemoryRuntimeHookProvider;
     learningSink: MemoryLearningSink;
-    toolProvider: MemoryToolProvider;
     handlerProvider: MemoryHandlerProvider;
     dreamProvider: MemoryDreamRuntimeProvider;
     extractionQueue: MemoryExtractionQueue;
@@ -39,14 +38,3 @@ export interface RegisterMemoryRuntimeHooksDeps {
     sendNotification?: (method: string, params: Record<string, unknown>) => void;
 }
 export declare function registerMemoryRuntimeHooks(deps: RegisterMemoryRuntimeHooksDeps): MemoryProviderState;
-export interface RegisterMemoryToolDeps {
-    memdir: ProjectMemoryStore;
-    getMemdir?: () => ProjectMemoryStore;
-    memoryProvider: MemoryToolProvider | null;
-    memoryUserId: string;
-    sessionId?: string;
-    getTurnId?: () => string;
-    toolCatalog: ToolCatalog;
-    sendNotification?: (method: string, params: Record<string, unknown>) => void;
-}
-export declare function registerMemoryTool(deps: RegisterMemoryToolDeps): void;

package/dist/types/cli/product-acp-params.d.ts

@@ -18,6 +18,7 @@ export declare function assertProductTasks(value: unknown, field?: string): void
 export declare function assertProductBudget(value: unknown, field?: string): void;
 export declare function assertProductId(params: Record<string, unknown>): string;
 export declare function assertProductTaskId(params: Record<string, unknown>): string;
+export declare function assertProductDagMutation(params: Record<string, unknown>): void;
 /**
  * `x/product.create` — the orchestrator builds the DAG straight from these.
  *

package/dist/types/cli/provider-core-facade.d.ts

@@ -1,31 +1,3 @@
-import { MediaClient, ProviderRegistry, createLLMClient, isAsyncMediaTransport, type LLMTransport, type MediaCapability, type MediaRequest, type MediaResult, type ProviderToolAPI } from "@xiaozhiclaw/provider-core";
-import { GeminiFileAPI } from "@xiaozhiclaw/provider-core/transports/gemini-file-api";
-export { MediaClient, ProviderRegistry, createLLMClient, isAsyncMediaTransport, type LLMTransport, type MediaCapability, type MediaRequest, type MediaResult, type ProviderToolAPI, };
-export declare function normalizeMediaProviderId(providerId: string): string;
-export declare function resolveMediaApiKey(apiKeys: Record<string, string>, providerId: string): string | undefined;
-export declare function createProviderToolAPIForSession(providerId: string | undefined, apiKey: string | undefined): ProviderToolAPI | undefined;
+import { ProviderRegistry, createLLMClient, type LLMTransport } from "@xiaozhiclaw/provider-core";
+export { ProviderRegistry, createLLMClient, type LLMTransport, };
 export declare function wrapDebugTransportIfEnabled(transport: LLMTransport, sessionId: string): LLMTransport;
-export declare function isMiniMaxLyricsTransport(transport: unknown): transport is {
-    generateLyrics(prompt: string, apiKey: string): Promise<string>;
-};
-export interface VolcengineFileTransport {
-    uploadFile(blob: Blob, apiKey: string, options: {
-        purpose: string;
-        filename: string;
-    }): Promise<{
-        id: string;
-        url?: string;
-        fileId?: string;
-        status?: string;
-    }>;
-    getFile(fileId: string, apiKey: string): Promise<Record<string, unknown>>;
-    listFiles(apiKey: string, options: {
-        limit: number;
-    }): Promise<{
-        data?: Array<Record<string, unknown>>;
-    }>;
-    deleteFile(fileId: string, apiKey: string): Promise<void>;
-}
-export declare function isVolcengineFileTransport(transport: unknown): transport is VolcengineFileTransport;
-export declare function createGeminiFileApi(): GeminiFileAPI;
-export declare function cleanGeminiToolSchema(schema: Record<string, unknown>): Record<string, unknown>;

package/dist/types/cli/rpc-registry.d.ts

@@ -3,10 +3,9 @@ import { type CommunityHandlerHost } from "./handlers/community-handler.js";
 import { type ConfigHandlerHost } from "./handlers/config-handler.js";
 import { type ControlHandlerHost } from "./handlers/control-handler.js";
 import { type FilesHandlerHost } from "./handlers/files-handler.js";
-import { type MediaHandlerHost } from "./handlers/media-handler.js";
 import { type MemoryHandlerHost } from "./handlers/memory-handler.js";
 import { type SessionHandlerHost } from "./handlers/session-handler.js";
-import { type SkillsHandlerHost } from "./handlers/skills-handler.js";
+import { type SkillCuratorHandlerHost } from "./handlers/skill-curator-handler.js";
 import { type TurnBaselineHandlerHost } from "./handlers/turn-baseline-handler.js";
 import { type TurnControlHandlerHost } from "./handlers/turn-handler.js";
 import { type WorkingMaterialsHandlerHost } from "./handlers/working-materials-handler.js";
@@ -47,8 +46,7 @@ export interface RpcHandlerHosts {
     session: SessionHandlerHost;
     memory: MemoryHandlerHost;
     files: FilesHandlerHost;
-    media: MediaHandlerHost;
-    skills: SkillsHandlerHost;
+    skills: SkillCuratorHandlerHost;
     community: CommunityHandlerHost;
     dream: DreamHandlerHost;
     turn: TurnControlHandlerHost;

package/dist/types/cli/runtime-hook-bootstrap.d.ts

@@ -3,7 +3,7 @@ import type { HookRegistry } from "../contracts/hooks.js";
 import { type MemoryPrefetchState } from "../runtime/hooks/memory-hooks.js";
 import type { BackgroundTaskManager } from "../runtime/infra/background-tasks.js";
 import type { TaskStore } from "../runtime/infra/task-runtime.js";
-import type { MemoryDreamRuntimeProvider, MemoryHandlerProvider, MemoryLearningSink, ProjectMemoryStore, ToolCatalog } from "../runtime/ports/index.js";
+import type { MemoryDreamRuntimeProvider, MemoryHandlerProvider, MemoryLearningSink, ProjectMemoryStore } from "../runtime/ports/index.js";
 import type { LLMTransport } from "./provider-core-facade.js";
 export interface RuntimeHookBootstrapDeps {
     log: AgentLogger;
@@ -14,7 +14,6 @@ export interface RuntimeHookBootstrapDeps {
     projectRoot: string;
     memdir: ProjectMemoryStore;
     getMemdir?: () => ProjectMemoryStore | null;
-    toolCatalog: ToolCatalog;
     currentUserId: string;
     prefetchState: MemoryPrefetchState;
     getLastUserMessage(): string | undefined;

package/dist/types/cli/stdio-acp-request-host.d.ts

@@ -21,7 +21,6 @@ export type StdioAcpRequestHostSource = Pick<CliAcpRequestHandlerHost, "activeTu
     cancelBackgroundTasksForSession(sessionId?: string, parentTurnId?: string): void;
     beginTurnRequest(): number;
     isTurnRequestCurrent(generation: number): boolean;
-    configureTurnMedia(config: Record<string, unknown> | undefined, turnId: string): void;
     getAcpPermissionSession(): {
         sessionId: string;
         requestPermission(params: AcpPermissionRequestParams): Promise<{
@@ -37,5 +36,5 @@ export type StdioAcpRequestHostSource = Pick<CliAcpRequestHandlerHost, "activeTu
 };
 /** Host members the shared turn pipeline reads/writes — keep in sync with
  * `grep -oE "this\.[a-zA-Z]+" src/cli/handlers/turn-handler.ts | sort -u`. */
-export declare const TURN_PIPELINE_HOST_MEMBERS: readonly ["activeTurn", "turnDone", "beginForegroundTurn", "beginTurnRequest", "configureTurnMedia", "currentHooks", "currentModel", "currentTurnId", "isTurnRequestCurrent", "drainPendingTaskNotifications", "endForegroundTurn", "getAcpPermissionSession", "getHostRequestClient", "getActiveProjectRoot", "lastAssistantMessageForExtract", "lastUserMessageForAutoExtract", "log", "mcpReady", "memdir", "pendingAskUser", "permissionChecker", "projectMemoryStoreFactory", "resolveAgent", "resolveClientForPurpose", "scheduleBackgroundMemoryWork", "sendNotification", "sendResponse", "sessionHistory", "sessionState", "setActiveWorkdir", "taskDistillation", "toolCatalog"];
+export declare const TURN_PIPELINE_HOST_MEMBERS: readonly ["activeTurn", "turnDone", "beginForegroundTurn", "beginTurnRequest", "currentHooks", "currentModel", "currentTurnId", "isTurnRequestCurrent", "drainPendingTaskNotifications", "endForegroundTurn", "getAcpPermissionSession", "getHostRequestClient", "getActiveProjectRoot", "lastAssistantMessageForExtract", "lastUserMessageForAutoExtract", "log", "mcpReady", "memdir", "pendingAskUser", "permissionChecker", "projectMemoryStoreFactory", "resolveAgent", "resolveClientForPurpose", "scheduleBackgroundMemoryWork", "sendNotification", "sendResponse", "sessionHistory", "sessionState", "setActiveWorkdir", "taskDistillation", "toolCatalog"];
 export declare function createStdioAcpRequestHandlerHost(host: StdioAcpRequestHostSource): CliAcpRequestHandlerHost;

package/dist/types/cli/stdio-rpc-handler-hosts.d.ts

@@ -24,7 +24,6 @@ type StdioRpcAdapterSource = DirectStdioRpcHost & {
     sessionHistory: RpcHandlerHosts["session"]["sessionHistory"];
     currentHooks: RpcHandlerHosts["dream"]["currentHooks"];
     permissionChecker: RpcHandlerHosts["turn"]["permissionChecker"];
-    mediaClient: RpcHandlerHosts["media"]["mediaClient"];
     memoryProvider: RpcHandlerHosts["memory"]["memoryProvider"];
     memoryDreamProvider: RpcHandlerHosts["dream"]["memoryProvider"];
     memoryUserId: NonNullable<RpcHandlerHosts["memory"]["memoryUserId"]>;
@@ -42,7 +41,6 @@ type StdioRpcAdapterSource = DirectStdioRpcHost & {
     } | null;
     ensureMemoryProvider: NonNullable<RpcHandlerHosts["memory"]["ensureMemoryProvider"]>;
     enableIdleDream: NonNullable<RpcHandlerHosts["session"]["enableIdleDream"]>;
-    configureTurnMedia: NonNullable<RpcHandlerHosts["turn"]["configureTurnMedia"]>;
     sendError: NonNullable<RpcHandlerHosts["session"]["sendError"]>;
     createDreamHandlerHost(): RpcHandlerHosts["dream"];
 };

package/dist/types/cli/stdio-runtime-bootstrap.d.ts

@@ -1,6 +1,4 @@
 import type { NotificationMethod, NotificationMethodMap } from "../protocol/notifications.js";
-import type { ModelPurpose } from "../runtime/infra/model-registry.js";
-import type { LLMTransport } from "./provider-core-facade.js";
 import type { MemoryHostRequestAccess } from "./memory-coordinator.js";
 import { type StdioRuntimeServices } from "./stdio-runtime-services.js";
 import type { HostProfileClient } from "../transport/host-profile-client.js";
@@ -10,11 +8,6 @@ export interface StdioRuntimeBootstrapDeps {
     getCurrentSessionId?(): string | undefined;
     getCurrentTurnId?(): string | undefined;
     isGroupSecurityMode?(): boolean;
-    resolveClientForPurpose(purpose: ModelPurpose): {
-        transport: LLMTransport;
-        apiKey: string;
-        model: string;
-    } | null;
     log(message: string): void;
     sendNotification<M extends NotificationMethod>(method: M, params: NotificationMethodMap[M]): void;
     /** B3(X7):host-state 接入面(AcpServer;lazy——gate 在 provider 创建时刻现读)。 */

package/dist/types/cli/stdio-runtime-services.d.ts

@@ -1,8 +1,7 @@
 import type { MemoryDreamRuntimeProvider, MemoryHandlerProvider, PathService, ToolBootstrap, ToolCatalog } from "../runtime/ports/index.js";
 import { MediaPersistence } from "../runtime/infra/media-persistence.js";
-import { MediaClient, ProviderRegistry } from "./provider-core-facade.js";
+import { ProviderRegistry } from "./provider-core-facade.js";
 import { type MemoryHostRequestAccess, type MemoryProviderState } from "./memory-coordinator.js";
-import { type TurnMediaSetupHost } from "./turn-media-setup.js";
 export interface StdioRuntimeServicesDeps {
     getActiveProjectRoot(): string;
     /**
@@ -13,16 +12,10 @@ export interface StdioRuntimeServicesDeps {
 }
 export interface StdioRuntimeServices {
     providerRegistry: ProviderRegistry;
-    mediaClient: MediaClient;
     mediaPersistence: MediaPersistence;
     pathService: PathService;
     toolCatalog: ToolCatalog;
     toolBootstrap: ToolBootstrap;
-    configureTurnMedia(params: {
-        host: Omit<TurnMediaSetupHost, "mediaClient">;
-        config?: Record<string, unknown>;
-        turnId: string;
-    }): void;
     ensureMemoryProvider(currentUserId: string): MemoryProviderState;
     closeMemoryProviders(state: {
         memoryProvider: MemoryHandlerProvider | null;

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

@@ -61,7 +61,6 @@ export declare class StdioServer {
     private readonly resolvedAgent;
     /** Active session/turn identity + lifecycle (id/turn/state/taskDomain/llmConfig/acpMeta). */
     private readonly session;
-    private currentMediaApiKeys;
     taskStore: TaskStore;
     /** Unified background execution registry (agent forks + backgrounded shell commands). */
     backgroundTasks: BackgroundTaskManager;
@@ -97,7 +96,6 @@ export declare class StdioServer {
     private readonly sessionRuntime;
     private modelRegistryHydration;
     private get registry();
-    get mediaClient(): import("@xiaozhiclaw/provider-core/media-client").MediaClient;
     get mediaPersistence(): import("../runtime/infra/media-persistence.js").MediaPersistence;
     private get pathService();
     get toolCatalog(): import("../runtime/ports/tool-contracts.js").ToolCatalog;
@@ -212,8 +210,6 @@ export declare class StdioServer {
      */
     drainPendingTaskNotifications(sessionId: string): string[];
     ensureModelRegistryHydrated(): Promise<void>;
-    syncToolListMediaConfig(): void;
-    configureTurnMedia(config: Record<string, unknown> | undefined, turnId: string): void;
     /**
      * Single entry point for updating the active workdir.
      * Centralizes all side-effects (bootstrap workdir, media persistence, etc.).

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

@@ -1,7 +1,6 @@
 import type { PortableTool } from "../skills/portable-tool.js";
 import { type TaskToolHooks } from "../skills/tools/task-tool.js";
 import { type AskUserQuestion } from "../skills/tools/ask-user-tool.js";
-import { type PreviewBrowserDriveResult, type PreviewBrowserToolParams } from "../skills/tools/preview-browser-tool.js";
 import { type ExecProgress } from "../skills/tools/exec-tool.js";
 import type { BackgroundTaskManager } from "../runtime/infra/background-tasks.js";
 import type { SandboxConfig } from "../skills/tools/shell/sandbox/sandbox-types.js";
@@ -15,14 +14,11 @@ export interface LocalCoreToolRegistrationContext {
     getCurrentTurnId?: () => string | undefined;
     askUserCallback: ((questions: AskUserQuestion[]) => Promise<Record<string, string> | null>) | null;
     getAskUserCallback?: () => ((questions: AskUserQuestion[]) => Promise<Record<string, string> | null>) | null;
-    previewBrowserCallback: ((params: PreviewBrowserToolParams, signal?: AbortSignal) => Promise<PreviewBrowserDriveResult>) | null;
-    getPreviewBrowserCallback?: () => ((params: PreviewBrowserToolParams, signal?: AbortSignal) => Promise<PreviewBrowserDriveResult>) | null;
     onExecProgress?: (progress: ExecProgress) => void;
     sendNotification?(method: string, params: Record<string, unknown>): void;
     getCwd(): string;
     activeProjectRoot(): string;
     resolveSandboxConfig(): SandboxConfig | undefined;
-    runtimePathEntries(): Promise<string[]>;
     isGroupSecurityMode?(): boolean;
     pathService?: PathService;
     log?: {

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

@@ -3,14 +3,10 @@ import type { PermissionMode } from "../runtime/ports/permission-contracts.js";
 import type { TaskToolHooks } from "../skills/tools/task-tool.js";
 import type { ExecProgress } from "../skills/tools/exec-tool.js";
 import type { BackgroundTaskManager } from "../runtime/infra/background-tasks.js";
-import type { ModelPurpose } from "../runtime/infra/model-registry.js";
 import type { MediaPersistence } from "../runtime/infra/media-persistence.js";
-import type { LLMTransport } from "./provider-core-facade.js";
 import type { AgentLogger } from "../agent/types.js";
 import type { AskUserQuestion } from "../skills/tools/ask-user-tool.js";
-import type { PreviewBrowserDriveResult, PreviewBrowserToolParams } from "../skills/tools/preview-browser-tool.js";
 import type { PathService, ToolCatalog } from "../runtime/ports/index.js";
-export { setMediaClientConfig, setProviderToolAPI } from "./media-runtime-facade.js";
 export { setGroupSecurityMode, validateExecCommand } from "./tool-bootstrap-core-registration.js";
 export { enforceAbsoluteFloors } from "./tool-bootstrap-paths.js";
 export interface SandboxPermissionSnapshot {
@@ -20,7 +16,6 @@ export interface SandboxPermissionSnapshot {
 }
 /** Wire the OS-sandbox permission source (live rule-engine snapshot), or null to clear. */
 export declare function setSandboxPermissionSource(source: (() => SandboxPermissionSnapshot | undefined) | null): void;
-type PreviewBrowserCallback = (params: PreviewBrowserToolParams, signal?: AbortSignal) => Promise<PreviewBrowserDriveResult>;
 /**
  * Set task tool lifecycle hooks. Called from stdio-server when session starts.
  * Connects planning-task events to the HookRegistry.
@@ -38,12 +33,6 @@ export declare function setBackgroundTaskRuntime(manager: BackgroundTaskManager
  * If null, ask_user returns "user declined" to the LLM.
  */
 export declare function setAskUserCallback(callback: ((questions: AskUserQuestion[]) => Promise<Record<string, string> | null>) | null): void;
-/**
- * Set the preview_browser callback. The host (Electron / test harness) provides the backend
- * that drives the shared preview view (via x/host.request service:preview) and returns text + screenshot.
- * Wired per turn by configureTurnPreviewBrowser. If null, preview_browser reports "not available".
- */
-export declare function setPreviewBrowserCallback(callback: PreviewBrowserCallback | null): void;
 export declare function setBootstrapWorkdir(newWorkdir: string): void;
 export interface BootstrapConfig {
     workdir?: string;
@@ -53,12 +42,6 @@ export interface BootstrapConfig {
     log?: AgentLogger;
     /** Called during foreground shell execution with incremental progress. */
     onExecProgress?(progress: ExecProgress): void;
-    /** Optional Host model resolver for locally compiled model-backed tools such as media understanding. */
-    resolveClientForPurpose?(purpose: ModelPurpose): {
-        transport: LLMTransport;
-        apiKey: string;
-        model: string;
-    } | null;
     getTaskScopeKey?(): string | undefined;
     getCurrentTurnId?(): string | undefined;
     isGroupSecurityMode?(): boolean;

package/dist/types/contracts/memory-recall-packet.d.ts

@@ -0,0 +1,31 @@
+export interface RecallClaimPacket {
+    version: 1;
+    memoryId: string;
+    category: string;
+    fact: string;
+    claim: {
+        scope: string;
+        scopeKey: string;
+        entity: string;
+        predicate: string;
+        relation: string;
+        value: Record<string, unknown>;
+        status: string;
+        validFrom: string;
+        validTo: string;
+    };
+    evidence: {
+        refs: string[];
+    };
+}
+export interface L2RecallPacketEnvelope {
+    id?: unknown;
+    source?: unknown;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Agent-side verification of the Host recall envelope. This mirrors the
+ * Host's canonical claim serialization so altered ids, facts, or packet
+ * shapes fail closed before any prompt or accounting path consumes them.
+ */
+export declare function readCanonicalL2RecallPacket(memory: L2RecallPacketEnvelope): RecallClaimPacket | null;

package/dist/types/contracts/memory-response-contract.d.ts

@@ -0,0 +1,2 @@
+export declare const MEMORY_RESPONSE_CONTRACT_LINES: readonly ["Answer only the requested slots with the shortest complete answer, then stop. Helpful elaboration is lower priority than this contract.", "For a scalar or short rule, start directly with the answer and use one sentence. Do not add a preamble.", "For ordered steps, output only a terse ordered list. Do not explain each step or repeat that the order is fixed.", "If no memory fact answers a requested slot, say only that it is unknown in one short sentence. Do not list nearby known facts, ask follow-up questions, or offer to store information.", "Do not contrast alternate entities, scenes, historical values, calculations, nearby context, repeated summaries, or unsolicited next steps unless the user explicitly asks for them."];
+export declare function renderMemoryResponseContract(heading: string): string;

package/dist/types/contracts/tool-execution-evidence.d.ts

@@ -0,0 +1,8 @@
+import type { FinalAnswerEvidence, ToolCallExecutionEvidence } from "../protocol/wire/notification-payloads.js";
+export declare function classifyToolFailureKind(result: {
+    blocked?: boolean;
+    blockReason?: string;
+    error?: string;
+    details?: Record<string, unknown>;
+}): ToolCallExecutionEvidence["failureKind"];
+export declare function buildFinalAnswerEvidence(freshEvidenceRequired: boolean, toolCalls: readonly ToolCallExecutionEvidence[]): FinalAnswerEvidence;

package/dist/types/contracts/tool-name.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Return the provider-local name of a projected function.
+ *
+ * qlogicagent must keep policy and completion logic attached to tool semantics without
+ * re-registering the retired built-in tool name. Unqualified names are returned unchanged.
+ */
+export declare function toolLocalName(toolName: string): string;
+export declare function toolNamespace(toolName: string): string | undefined;
+export declare function isQualifiedToolName(toolName: string): boolean;
+export declare function toolNameMatches(toolName: string, localName: string): boolean;

package/dist/types/contracts/turn-event.d.ts

@@ -38,6 +38,7 @@ export type TurnEvent = {
     turnId: string;
     callId: string;
     name: string;
+    displayName?: string;
     arguments: string;
     inputSummary?: string;
 } | {
@@ -79,17 +80,42 @@ export type TurnEvent = {
     turnId: string;
     action: string;
     detail?: string;
+} | {
+    /**
+     * 作废本回合已发出但随后被丢弃的助手文本。
+     *
+     * 为什么不复用 `recovery`:recovery 同时覆盖"丢弃本轮文本"与"保留前缀并续写"两类
+     * (max_output_tokens 续写把上一轮 roundText 当作 assistant 前缀带进下一轮)。把它当作
+     * 统一作废信号会在最常见的长输出续写场景下错抹合法前缀,因此作废必须是独立事件。
+     *
+     * 语义:作废永远是**后缀截断**,截断点由 Agent 权威下发,消费端只执行不推断。
+     * 一个 turn 内只有一条线性文本流,因此不需要 roundId/segmentId 编号体系。
+     */
+    type: "text_rollback";
+    turnId: string;
+    /**
+     * 本 turn 保留的助手文本长度,单位 **UTF-16 code unit**,按全部已发出文本段的逻辑拼接计算
+     * (activity 等非文本段不计入长度,也不被截断删除)。
+     *
+     * 必须满足 `committedLength <= keepLength <= sentLength`:下界是已提交轮次的累计长度,
+     * 低于它会删掉早先轮次的合法过程性文本(那些文本不由 `turn.end.content` 覆盖,删了不会回来)。
+     * 重复下发同一 keepLength 必须幂等。
+     */
+    keepLength: number;
+    /** 供 UI 呈现"已重试/已重新生成"的轻量状态,以及诊断归因。 */
+    reason: string;
 } | {
     type: "tool_selection_policy";
     turnId: string;
     policyId: string;
-    intent: "benchmark_state_maintenance" | "fresh_evidence" | "verification" | "final_answer" | "tool_recovery" | "lifecycle_reconciliation";
+    intent: "capability_routing" | "benchmark_state_maintenance" | "fresh_evidence" | "verification" | "final_answer" | "tool_recovery" | "lifecycle_reconciliation";
     reason: string;
     availableToolNames: string[];
     enabledToolNamesBefore: string[];
     enabledToolNamesAfter: string[];
     suppressedToolNames: string[];
     nextAction: string;
+    routingEvidence?: import("../protocol/wire/notification-payloads.js").CapabilityRoutingEvidence;
 } | {
     type: "plan_update";
     turnId: string;
@@ -102,7 +128,12 @@ export type TurnEvent = {
 } | {
     type: "tool_use_summary";
     turnId: string;
-    telemetrySource?: "agent" | "agent-synthetic";
+    telemetrySource?: "agent";
+    /** Versioned terminal ledger: route, per-call execution, and final-answer evidence gate. */
+    ledgerSchemaVersion: 4;
+    toolCalls: import("../protocol/wire/notification-payloads.js").ToolCallExecutionEvidence[];
+    routingEvidence?: import("../protocol/wire/notification-payloads.js").CapabilityRoutingEvidence;
+    finalAnswerEvidence: import("../protocol/wire/notification-payloads.js").FinalAnswerEvidence;
     availableToolNames: string[];
     enabledToolNames: string[];
     toolCallNames: string[];
@@ -150,7 +181,7 @@ export type TurnEvent = {
 } | {
     type: "media_result";
     turnId: string;
-    mediaType: "image" | "tts" | "video" | "music" | "3d";
+    mediaType: "image" | "tts" | "video" | "music" | "3d" | "file";
     url: string;
     model?: string;
     provider?: string;
@@ -158,6 +189,8 @@ export type TurnEvent = {
     width?: number;
     height?: number;
     mimeType?: string;
+    filename?: string;
+    size?: number;
     billingUnit?: string;
     billingQuantity?: number;
     taskId?: string;

package/dist/types/host-contract/acp-content.d.ts

@@ -0,0 +1,45 @@
+export type AcpResourceContents = {
+    uri: string;
+    text: string;
+    mimeType?: string | null;
+    _meta?: Record<string, unknown> | null;
+} | {
+    uri: string;
+    blob: string;
+    mimeType?: string | null;
+    _meta?: Record<string, unknown> | null;
+};
+export type AcpContentBlock = {
+    type: "text";
+    text: string;
+    annotations?: Record<string, unknown> | null;
+    _meta?: Record<string, unknown> | null;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+    uri?: string | null;
+    annotations?: Record<string, unknown> | null;
+    _meta?: Record<string, unknown> | null;
+} | {
+    type: "audio";
+    data: string;
+    mimeType: string;
+    annotations?: Record<string, unknown> | null;
+    _meta?: Record<string, unknown> | null;
+} | {
+    type: "resource_link";
+    uri: string;
+    name: string;
+    description?: string | null;
+    mimeType?: string | null;
+    size?: number | null;
+    title?: string | null;
+    annotations?: Record<string, unknown> | null;
+    _meta?: Record<string, unknown> | null;
+} | {
+    type: "resource";
+    resource: AcpResourceContents;
+    annotations?: Record<string, unknown> | null;
+    _meta?: Record<string, unknown> | null;
+};