qlogicagent 2.15.9 → 2.16.1

package/dist/types/runtime/ports/agent-execution-contracts.d.ts

@@ -1,138 +1,12 @@
 import type { HookRegistry } from "../../contracts/hooks.js";
 import type { ChatMessage as WireChatMessage, ToolDefinition as WireToolDefinition, WireTokenUsage } from "../../protocol/wire/index.js";
+import type { TurnEvent } from "../../contracts/turn-event.js";
+export type { TurnEvent } from "../../contracts/turn-event.js";
 export type ChatMessage = WireChatMessage;
 export type TokenUsage = WireTokenUsage;
 export interface ToolDefinition extends WireToolDefinition {
     backfillObservableInput?: (input: Record<string, unknown>) => void;
 }
-export type TurnEvent = {
-    type: "start";
-    turnId: string;
-} | {
-    type: "delta";
-    turnId: string;
-    text: string;
-} | {
-    type: "tool_call";
-    turnId: string;
-    callId: string;
-    name: string;
-    arguments: string;
-    inputSummary?: string;
-} | {
-    type: "end";
-    turnId: string;
-    content: string;
-    usage?: TokenUsage;
-    model?: string;
-    provider?: string;
-} | {
-    type: "error";
-    turnId: string;
-    error: string;
-    code?: string;
-    usage?: TokenUsage;
-} | {
-    type: "skill_instruction";
-    turnId: string;
-    instruction: unknown;
-} | {
-    type: "tool_result";
-    turnId: string;
-    callId: string;
-    name: string;
-    ok: boolean;
-    error?: string;
-    outputPreview?: string;
-    durationMs?: number;
-    exitCode?: number;
-    stdout?: string;
-    stderr?: string;
-    details?: Record<string, unknown>;
-} | {
-    type: "tool_blocked";
-    turnId: string;
-    callId: string;
-    name: string;
-    reason: string;
-} | {
-    type: "recovery";
-    turnId: string;
-    action: string;
-    detail?: string;
-} | {
-    type: "plan_update";
-    turnId: string;
-    slug: string;
-    content: string;
-} | {
-    type: "heartbeat";
-    turnId: string;
-    message: string;
-} | {
-    type: "tool_use_summary";
-    turnId: string;
-    summary: string;
-} | {
-    type: "reasoning_delta";
-    turnId: string;
-    text: string;
-} | {
-    type: "suggestions";
-    turnId: string;
-    items: Array<{
-        text: string;
-        icon?: string;
-        action?: string;
-    }>;
-} | {
-    type: "media_result";
-    turnId: string;
-    mediaType: "image" | "tts" | "video" | "music" | "3d";
-    url: string;
-    model?: string;
-    provider?: string;
-    durationSeconds?: number;
-    width?: number;
-    height?: number;
-    mimeType?: string;
-    billingUnit?: string;
-    billingQuantity?: number;
-    taskId?: string;
-} | {
-    type: "artifact";
-    turnId: string;
-    artifactId: string;
-    artifactType: "code" | "file" | "image" | "document" | "diagram" | "table";
-    title: string;
-    filePath?: string;
-    language?: string;
-    content?: string;
-    mimeType?: string;
-} | {
-    type: "annotations";
-    turnId: string;
-    annotations: Array<{
-        type: string;
-        url?: string;
-        title?: string;
-        [key: string]: unknown;
-    }>;
-} | {
-    type: "subagent_started";
-    turnId: string;
-    subagentId: string;
-    agentType: string;
-    prompt?: string;
-} | {
-    type: "subagent_ended";
-    turnId: string;
-    subagentId: string;
-    agentType: string;
-    ok: boolean;
-    outputPreview?: string;
-    error?: string;
-};
 export interface ToolInvoker {
     invoke(turnId: string, name: string, args: string, signal?: AbortSignal): Promise<{
         result: string;
@@ -146,6 +20,8 @@ export interface AgentRunRequest {
     turnId: string;
     sessionId: string;
     messages: ChatMessage[];
+    /** Full registered tool surface before per-turn policy filtering. */
+    availableTools?: ToolDefinition[];
     tools: ToolDefinition[];
     systemPrompt?: string;
     config?: {

package/dist/types/runtime/ports/tool-contracts.d.ts

@@ -48,6 +48,12 @@ export interface ToolCatalog {
     removeTool(name: string): boolean;
     activateTool(name: string): boolean;
     clearActivatedTools(): void;
+    /** SSOT for the deferred-tool set consumed by the prompt index and the tool_search corpus. */
+    listDeferredTools(): Array<{
+        name: string;
+        description: string;
+        searchHint?: string;
+    }>;
 }
 export interface ToolBootstrapProgress {
     output: string;

package/dist/types/runtime/prompt/environment-context.d.ts

@@ -35,6 +35,23 @@ export declare function createTaskGuidanceSection(domain?: TaskDomain): SystemPr
  * Tells the LLM when to use specialized tools vs. primitives.
  */
 export declare function createToolGuidanceSection(): SystemPromptSection;
+/**
+ * Render the deferred-tool listing with accuracy-aware token discipline.
+ *
+ * Dropping ALL descriptions to save tokens trades away tool-SELECTION accuracy:
+ * the model cannot tell `mcp__exa__search` from `mcp__github__search` by name.
+ * So spend the description budget exactly where confusion lives:
+ *   - small set (<= richHintLimit): every tool rich.
+ *   - built-in deferred tools (no server): always rich — small, bounded set.
+ *   - MCP tools whose leaf name collides with another tool: keep the hint.
+ *   - MCP tools with a unique leaf: name only (unambiguous; tool_search recovers
+ *     details on demand).
+ * Names are ALWAYS listed so any capability can be `select:`ed directly.
+ */
+export declare function buildDeferredToolIndexBody(deferred: Array<{
+    name: string;
+    description: string;
+}>, richHintLimit: number): string[];
 /**
  * Index of deferred tools so the model KNOWS these capabilities exist even
  * though their schemas are not loaded. Without this the model sees only the
@@ -47,7 +64,9 @@ export declare function createToolGuidanceSection(): SystemPromptSection;
 export declare function createDeferredToolIndexSection(listDeferredTools: () => Array<{
     name: string;
     description: string;
-}>): SystemPromptSection;
+}>, options?: {
+    richHintLimit?: number;
+}): SystemPromptSection;
 /**
  * Create a system prompt section that instructs the model on response language.
  * CC parity: only injected when language is explicitly set; when absent,

package/dist/types/skills/tools/ask-user-tool.d.ts

@@ -34,7 +34,9 @@ export declare const ASK_USER_TOOL_SCHEMA: {
                     };
                     readonly options: {
                         readonly type: "array";
-                        readonly description: "2-4 options for the user to choose from. Omit for free text.";
+                        readonly minItems: 2;
+                        readonly maxItems: 8;
+                        readonly description: "2-8 options for the user to choose from. Omit for free text.";
                         readonly items: {
                             readonly type: "object";
                             readonly properties: {
@@ -52,7 +54,7 @@ export declare const ASK_USER_TOOL_SCHEMA: {
                     };
                     readonly multiSelect: {
                         readonly type: "boolean";
-                        readonly description: "Allow selecting multiple options (default: false).";
+                        readonly description: string;
                     };
                 };
                 readonly required: readonly ["question", "header"];

package/dist/types/skills/tools/shell/command-classification.d.ts

@@ -42,3 +42,4 @@ export declare function commandHasAnyCd(command: string): boolean;
  * Mirrors cc's `isSearchOrReadBashCommand()` + `isSilentBashCommand()`.
  */
 export declare function classifyCommand(command: string): CommandClassification;
+export declare function requiresDedicatedReadSearchTool(classification: CommandClassification): boolean;

package/dist/types/skills/tools/tool-search-tool.d.ts

@@ -23,6 +23,11 @@ export interface DeferredToolInfo {
     description: string;
     /** Optional search hint for better discovery */
     searchHint?: string;
+    /** Compact parameter signature (e.g. "query, maxResults?") to disambiguate similar tools. */
+    paramSummary?: string;
+    score?: number;
+    matchedTerms?: string[];
+    matchedFields?: string[];
 }
 export interface ToolSearchOutput {
     matches: DeferredToolInfo[];
@@ -52,7 +57,15 @@ export interface ToolSearchCorpusEntry {
     name: string;
     description: string;
     searchHint?: string;
+    paramSummary?: string;
 }
+/**
+ * Compact parameter signature for a JSON-Schema tool, e.g. "query, maxResults?".
+ * Required params are plain, optional ones suffixed "?". Surfacing this in search
+ * results raises tool-SELECTION accuracy: two lexically similar tools (e.g. two
+ * `search` tools) are told apart by their inputs, not guessed by name.
+ */
+export declare function summarizeToolParams(parameters: unknown): string;
 /**
  * Score a keyword query against a tool corpus (CC-aligned weights).
  * Query syntax: plain terms rank, "+term" is required (must appear in

package/dist/types/skills/tools/tool-selection-eval.d.ts

@@ -0,0 +1,49 @@
+import { type ToolSearchCorpusEntry } from "./tool-search-tool.js";
+export type EvalLang = "en" | "zh";
+export interface ToolSelectionCase {
+    id: string;
+    /** Natural-language / keyword intent issued to tool_search. */
+    query: string;
+    lang: EvalLang;
+    /** Tool names that count as a correct selection (one or more acceptable). */
+    expected: string[];
+    /** Optional note on what weakness this case probes. */
+    note?: string;
+}
+export interface CaseResult {
+    id: string;
+    lang: EvalLang;
+    query: string;
+    expected: string[];
+    topMatch: string | null;
+    hitAt1: boolean;
+    hitAtK: boolean;
+    /** 1-based rank of the first expected tool among results, or null if absent. */
+    firstExpectedRank: number | null;
+}
+export interface EvalReport {
+    k: number;
+    total: number;
+    /** Share of cases whose #1 result is an expected tool. */
+    precisionAt1: number;
+    /** Share of cases with an expected tool anywhere in the top-k. */
+    recallAtK: number;
+    /** Mean reciprocal rank of the first expected tool. */
+    mrr: number;
+    byLang: Record<EvalLang, {
+        total: number;
+        precisionAt1: number;
+        recallAtK: number;
+    }>;
+    failures: CaseResult[];
+    results: CaseResult[];
+}
+/**
+ * Run the deterministic search-ranking eval: feed each case's query through
+ * searchToolCorpus and score whether the expected tool is surfaced (and where).
+ */
+export declare function evalSearchSelection(corpus: ToolSearchCorpusEntry[], cases: ToolSelectionCase[], options?: {
+    k?: number;
+}): EvalReport;
+/** Human-readable report — printed on gate failure so CI logs name the regressed cases. */
+export declare function formatEvalReport(report: EvalReport): string;

package/dist/types/skills/tools/tool-selection-eval.dataset.d.ts

@@ -0,0 +1,5 @@
+import type { ToolSearchCorpusEntry } from "./tool-search-tool.js";
+import type { ToolSelectionCase } from "./tool-selection-eval.js";
+/** Representative deferred corpus: built-in media/dev tools + colliding MCP tools. */
+export declare const SEED_CORPUS: ToolSearchCorpusEntry[];
+export declare const SEED_CASES: ToolSelectionCase[];

package/dist/types/skills/tools/write-tool.d.ts

@@ -22,6 +22,8 @@ export declare const WRITE_TOOL_SCHEMA: {
 export interface WriteToolDeps {
     /** Write content to a file. Create parent dirs as needed. */
     writeFile(path: string, content: string): Promise<void>;
+    /** Check whether the resolved path already exists. */
+    fileExists?(path: string): Promise<boolean> | boolean;
     /** Resolve a relative path to absolute. */
     resolvePath(input: string): string;
     /**

package/dist/types/skills/tools.d.ts

@@ -13,6 +13,10 @@ export { AGENT_DISALLOWED_TOOLS, CUSTOM_AGENT_DISALLOWED_TOOLS, filterToolsForAg
 export declare class ToolRegistry {
     private readonly toolPool;
     private readonly activatedTools;
+    private readonly maxActivatedDeferred;
+    constructor(options?: {
+        maxActivatedDeferred?: number;
+    });
     setTools(tools: PortableTool[]): void;
     addTool(tool: PortableTool<any>): void;
     addTools(tools: PortableTool<any>[]): void;
@@ -26,6 +30,18 @@ export declare class ToolRegistry {
     activateTool(name: string): boolean;
     isToolActivated(name: string): boolean;
     clearActivatedTools(): void;
+    /**
+     * SSOT for "which tools are deferred". Both the deferred-tool index (system
+     * prompt) and the tool_search corpus consume this — never re-derive the
+     * deferred set inline. Lists every deferred+enabled tool regardless of
+     * activation, so the model can always see/search a capability that exists.
+     * searchHint is carried for the search corpus; the prompt index ignores it.
+     */
+    listDeferredTools(): Array<{
+        name: string;
+        description: string;
+        searchHint?: string;
+    }>;
     getToolManifest(includeDeferred?: boolean): ToolDefinition[];
 }
 export declare function getDefaultToolRegistry(): ToolRegistry;
@@ -42,4 +58,9 @@ export declare function getTools(): PortableTool[];
 export declare function activateTool(name: string): boolean;
 export declare function isToolActivated(name: string): boolean;
 export declare function clearActivatedTools(): void;
+export declare function listDeferredTools(): Array<{
+    name: string;
+    description: string;
+    searchHint?: string;
+}>;
 export declare function getToolManifest(includeDeferred?: boolean): ToolDefinition[];

package/dist/types/transport/acp-server.d.ts

@@ -91,6 +91,7 @@ export interface AcpRequestHandler {
     handleAcpProductResume(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductCancel(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductRollback(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpProductReplay(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductStatus(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductSubscribe(params: Record<string, unknown>): Promise<unknown>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.15.9",
+  "version": "2.16.1",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -95,6 +95,7 @@
     "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",
     "ioredis": "^5.11.1",
+    "jsonrepair": "^3.14.0",
     "mcporter": "^0.12.0",
     "nanoid": "^5.1.5",
     "pino": "^9.6.0",