qlogicagent 2.20.10 → 2.22.1

package/dist/types/cli/agent-runtime-session-state.d.ts

@@ -13,10 +13,8 @@ export interface SessionRuntimeState {
     hooks: HookRegistry;
     permission: PermissionState;
 }
-export declare const MCP_TOOL_SNAPSHOT_TTL_MS = 30000;
 export declare class AgentRuntimeSessionState {
     private readonly now;
-    private readonly mcpToolSnapshotTtlMs;
     private readonly runtimeBySession;
     private readonly permissionLeaseCountBySession;
     private readonly retiredPermissionUnregisterBySession;
@@ -26,7 +24,7 @@ export declare class AgentRuntimeSessionState {
     memoryProvider: MemoryHandlerProvider | null;
     memoryDreamProvider: MemoryDreamRuntimeProvider | null;
     memoryUserId: string;
-    constructor(now?: () => number, mcpToolSnapshotTtlMs?: number);
+    constructor(now?: () => number);
     getPluginSkills(): ReturnType<PluginLoader["getPluginSkills"]>;
     applyBootstrap(sessionId: string, result: AgentRuntimeBootstrapResult): void;
     withPermissionLease<T>(sessionId: string, action: () => Promise<T>): Promise<T>;

package/dist/types/protocol/wire/chat-types.d.ts

@@ -20,6 +20,8 @@ export interface SemanticToolCapability {
     effects?: string[];
     modalities?: string[];
     constraints?: string[];
+    /** Exact Host Skill ids that the execution state machine must load first. */
+    requiredSkills?: string[];
 }
 export type ChatMessageRole = "system" | "user" | "assistant" | "tool";
 export type ContextAnchorCategory = "objective" | "acceptance" | "decision" | "constraint" | "task" | "blocker" | "artifact";
@@ -131,6 +133,17 @@ export interface ToolIdentity {
     serverId?: string;
     capabilityId: string;
 }
+export interface SkillDirectoryEntry {
+    id: string;
+    description: string;
+    version?: string;
+    requiredTools?: string[];
+    memberCount?: number;
+}
+export interface SkillDirectory {
+    schemaVersion: 1;
+    entries: SkillDirectoryEntry[];
+}
 /**
  * Tool definition — wire format as sent over JSON-RPC.
  *
@@ -151,6 +164,8 @@ export interface ToolDefinition {
         displayName?: LocalizedToolText;
         displayDescription?: LocalizedToolText;
         semanticCapability?: SemanticToolCapability;
+        /** Host-authored, bounded Skill routing index. Full instructions remain behind skill_read. */
+        skillDirectory?: SkillDirectory;
         serialOnly?: boolean;
         parallelSafe?: boolean;
         /** Unified permission risk class. */

package/dist/types/runtime/execution/mcp-capability-selection.d.ts

@@ -7,6 +7,7 @@ export interface CapabilityRouterClient {
 export interface McpCapabilitySelection {
     aliases: string[];
     toolNames: ReadonlySet<string>;
+    requiredSkillNames: readonly string[];
     source: "semantic-directory";
     evidence: {
         namespaces: string[];
@@ -26,6 +27,14 @@ export type McpCapabilityRoutingOutcome = {
     status: "unavailable";
     reason: string;
 };
+/**
+ * A first-pass semantic abstention is not authoritative. Small routing models
+ * can miss an implied connector need even when the live capability directory
+ * contains an exact implementation. A second semantic opinion preserves the
+ * natural-language contract without adding connector names, keywords, or
+ * regular-expression gates.
+ */
+export declare function shouldRequestMcpCapabilitySecondOpinion(outcome: McpCapabilityRoutingOutcome): boolean;
 export interface ResolveMcpCapabilitySelectionInput {
     userText: string;
     messages: readonly ChatMessage[];

package/dist/types/skills/mcp/mcp-manager.d.ts

@@ -129,7 +129,7 @@ export declare class McpManager {
     private removeRegisteredTool;
 }
 export declare function mcpFallbackToolTitle(serverName: string, toolName: string): string;
-export declare function mcpPortableToolMetadata(serverName: string, mcpTool: ServerToolInfo): Pick<PortableTool, "name" | "label" | "description" | "semanticCapability" | "searchHint" | "isConcurrencySafe" | "isReadOnly" | "isDestructive" | "riskLevel" | "isEgress" | "egressCarriesData">;
+export declare function mcpPortableToolMetadata(serverName: string, mcpTool: ServerToolInfo): Pick<PortableTool, "name" | "label" | "description" | "semanticCapability" | "skillDirectory" | "searchHint" | "isConcurrencySafe" | "isReadOnly" | "isDestructive" | "riskLevel" | "isEgress" | "egressCarriesData">;
 /**
  * MCP bridges may already expose a globally-scoped `{server}__{tool}` name.
  * Prefixing that name again makes the model-facing function opaque and can push

package/dist/types/skills/portable-tool.d.ts

@@ -69,6 +69,8 @@ export interface PortableTool<TParams = Record<string, unknown>> {
     description: string;
     /** Structured semantics used by model-based capability discovery and routing. */
     semanticCapability?: SemanticToolCapability;
+    /** Host-authored, bounded Skill routing index attached only to skill_list. */
+    skillDirectory?: import("../protocol/wire/chat-types.js").SkillDirectory;
     /** JSON Schema object describing the tool's parameters. */
     parameters: Record<string, unknown>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.20.10",
+  "version": "2.22.1",
   "packageManager": "pnpm@10.23.0",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",