qlogicagent 2.2.0 → 2.4.0

package/dist/types/skills/skill-system/skill-source.d.ts

@@ -60,6 +60,33 @@ export interface SkillStorageDeps {
     /** Write the registry lock file. */
     writeLockfile(lockfile: SkillLockfile): Promise<void>;
 }
+/**
+ * A single version history entry for a skill.
+ */
+export interface SkillVersionEntry {
+    version: string;
+    updatedAt: string;
+    changelog?: string;
+    /** Integrity hash of the SKILL.md content at this version (sha256). */
+    integrity?: string;
+}
+/**
+ * Usage statistics for a skill.
+ */
+export interface SkillUsageStats {
+    /** Total number of times this skill has been invoked/applied. */
+    invokeCount: number;
+    /** Number of turns where the skill was active and contributed. */
+    activeCount: number;
+    /** Number of times the skill received positive feedback. */
+    positiveCount: number;
+    /** Number of times the skill received negative feedback. */
+    negativeCount: number;
+    /** ISO 8601 timestamp of last use. */
+    lastUsedAt?: string;
+    /** Derived success rate = (invokeCount - negativeCount) / invokeCount */
+    successRate?: number;
+}
 /**
  * Single entry in the skill lockfile.
  */
@@ -71,6 +98,12 @@ export interface SkillLockEntry {
     scanSummary?: SkillScanSummary;
     /** Integrity hash of the SKILL.md content (sha256). */
     integrity?: string;
+    /** Current version (from frontmatter or auto-incremented). */
+    currentVersion?: string;
+    /** Version history — newest first. */
+    versionHistory?: SkillVersionEntry[];
+    /** Usage statistics. */
+    usage?: SkillUsageStats;
 }
 /**
  * Complete lockfile for all installed skills.
@@ -79,6 +112,38 @@ export interface SkillLockfile {
     version: 1;
     entries: Record<string, SkillLockEntry>;
 }
+/**
+ * Record a skill usage event. Mutates the lockfile entry in-place.
+ */
+export declare function recordSkillUsage(lockfile: SkillLockfile, skillName: string, feedback?: "positive" | "negative" | null): void;
+/**
+ * Record a skill version update. Pushes current version to history.
+ */
+export declare function recordSkillVersionUpdate(lockfile: SkillLockfile, skillName: string, newVersion: string, changelog?: string, integrity?: string): void;
+/**
+ * Lightweight per-skill stats stored in `~/.qlogicagent/skill-stats.json`.
+ * This is independent of the lockfile — covers learned, promoted, and installed skills.
+ */
+export interface SkillStatsFile {
+    [skillName: string]: SkillUsageStats;
+}
+/**
+ * Record a skill invocation. Fire-and-forget — never throws.
+ * @param agentHome - path to `~/.qlogicagent/`
+ * @param skillName - the skill that was invoked
+ * @param success - whether the invocation completed without error
+ */
+export declare function trackSkillInvocation(agentHome: string, skillName: string, success: boolean): void;
+/**
+ * Read stats for a skill. Returns undefined if no stats recorded.
+ */
+export declare function getSkillStats(agentHome: string, skillName: string): SkillUsageStats | undefined;
+/**
+ * Get all skill stats. Useful for UI display.
+ */
+export declare function getAllSkillStats(agentHome: string): SkillStatsFile;
+/** Reset cache (for testing). */
+export declare function resetStatsCache(): void;
 /**
  * Result of a skill install operation.
  */

package/dist/types/skills/tools/project-switch-tool.d.ts

@@ -0,0 +1,24 @@
+import type { PortableTool } from "../portable-tool.js";
+export declare const PROJECT_SWITCH_TOOL_NAME: "project_switch";
+export interface ProjectSwitchToolParams {
+    projectName: string;
+}
+export interface ProjectSwitchToolDeps {
+    listProjects: () => Array<{
+        id: string;
+        name: string;
+        workspaceDir: string;
+    }>;
+    switchProject: (projectId: string) => {
+        id: string;
+        name: string;
+        workspaceDir: string;
+    } | null;
+    /** Called after a successful switch so the host can update cwd/notifications. */
+    onSwitched?: (project: {
+        id: string;
+        name: string;
+        workspaceDir: string;
+    }) => void;
+}
+export declare function createProjectSwitchTool(deps: ProjectSwitchToolDeps): PortableTool<ProjectSwitchToolParams>;

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

@@ -1,5 +1,5 @@
 /**
- * Tool Registry — CC-aligned getAllBaseTools() pattern.
+ * Tool Registry 鈥?CC-aligned getAllBaseTools() pattern.
  *
  * CC reference: claude-code-haha/src/tools.ts
  *
@@ -12,7 +12,7 @@
  * The registration pattern is aligned: pure function returns array.
  */
 import type { PortableTool } from "./portable-tool.js";
-import type { ToolDefinition } from "../agent/types.js";
+import type { ToolDefinition } from "../protocol/wire/index.js";
 import { AGENT_DISALLOWED_TOOLS, CUSTOM_AGENT_DISALLOWED_TOOLS, filterToolsForAgent } from "../agent/tool-access.js";
 export { AGENT_DISALLOWED_TOOLS, CUSTOM_AGENT_DISALLOWED_TOOLS, filterToolsForAgent };
 /**
@@ -52,14 +52,14 @@ export declare function getToolCount(): number;
  */
 export declare function executeTool(name: string, toolCallId: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<import("./portable-tool.js").PortableToolResult>;
 /**
- * CC: getTools() — return all enabled tools.
+ * CC: getTools() 鈥?return all enabled tools.
  * Filters the pool by isEnabled() gate; disabled tools are invisible to callers.
  * CC reference: claude-code-haha/src/tools.ts getTools()
  */
 export declare function getTools(): PortableTool[];
 /**
  * Activate a deferred tool so it appears in subsequent LLM manifests.
- * CC parity: tool_search select: → activateTool → tool included in manifest.
+ * CC parity: tool_search select: 鈫?activateTool 鈫?tool included in manifest.
  * Returns true if the tool exists, is enabled, and was activated.
  */
 export declare function activateTool(name: string): boolean;
@@ -73,7 +73,7 @@ export declare function isToolActivated(name: string): boolean;
 export declare function clearActivatedTools(): void;
 /**
  * Generate ToolDefinition[] manifest for LLM tool_use.
- * Filters by isEnabled() — disabled tools never reach the model.
+ * Filters by isEnabled() 鈥?disabled tools never reach the model.
  * Deferred tools are excluded UNLESS they have been activated via tool_search.
  * CC: getTools() + manifest generation combined.
  */

package/dist/types/transport/acp-event-emitter.d.ts

@@ -1,5 +1,5 @@
 /**
- * ACP Event Emitter — translates internal qlogicagent notifications to ACP
+ * ACP Event Emitter 鈥?translates internal qlogicagent notifications to ACP
  * session/update notifications.
  *
  * Maps the 47+ internal notification methods (turn.delta, turn.tool_call, etc.)

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

@@ -1,5 +1,5 @@
 /**
- * ACP Server — Agent-Client Protocol server layer for qlogicagent.
+ * ACP Server 鈥?Agent-Client Protocol server layer for qlogicagent.
  *
  * This module implements qlogicagent as an ACP Server, allowing any ACP-compliant
  * host (AionUI, Cursor, openclaw, etc.) to connect and interact with the agent.
@@ -17,7 +17,7 @@
  * existing internal handlers.
  */
 import type { Transport } from "../cli/transport.js";
-import { type AcpInitializeParams, type AcpInitializeResult, type AcpSessionNewParams, type AcpSessionNewResult, type AcpSessionPromptParams, type AcpSessionPromptResult, type AcpSessionEndParams, type AcpSessionSetConfigParams, type AcpSessionUpdateType, type AcpPermissionRequestParams, type AcpPermissionRequestResult } from "qlogicagent-runtime-contracts";
+import { type AcpInitializeParams, type AcpInitializeResult, type AcpSessionNewParams, type AcpSessionNewResult, type AcpSessionPromptParams, type AcpSessionPromptResult, type AcpSessionEndParams, type AcpSessionSetConfigParams, type AcpSessionUpdateType, type AcpPermissionRequestParams, type AcpPermissionRequestResult } from "../protocol/wire/index.js";
 export declare const ACP_ERROR_CODES: {
     readonly PARSE_ERROR: -32700;
     readonly INVALID_REQUEST: -32600;
@@ -54,26 +54,33 @@ export interface AcpRequestHandler {
         ok: boolean;
         summary?: string;
     }>;
+    handleAcpAgentsList(): Promise<unknown>;
     handleAcpSoloStart(params: Record<string, unknown>): Promise<unknown>;
     handleAcpSoloStatus(params: Record<string, unknown>): Promise<unknown>;
     handleAcpSoloSelect(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpSoloCancel(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpSoloSubscribe(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductCreate(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpProductPause(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductResume(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpProductCancel(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpProductRollback(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductStatus(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpProductSubscribe(params: Record<string, unknown>): Promise<unknown>;
     handleAcpTeamDelegate(params: Record<string, unknown>): Promise<unknown>;
 }
 export interface AcpServerConfig {
     verbose?: boolean;
 }
 /**
- * AcpServer — manages the ACP protocol state machine.
+ * AcpServer 鈥?manages the ACP protocol state machine.
  *
  * Lifecycle:
  * 1. Host connects (stdio)
- * 2. Host sends `initialize` → agent responds with capabilities
- * 3. Host sends `session/new` → session created
- * 4. Host sends `session/prompt` → agent runs turn, emits session/update notifications
- * 5. Host sends `session/end` → session cleaned up
+ * 2. Host sends `initialize` 鈫?agent responds with capabilities
+ * 3. Host sends `session/new` 鈫?session created
+ * 4. Host sends `session/prompt` 鈫?agent runs turn, emits session/update notifications
+ * 5. Host sends `session/end` 鈫?session cleaned up
  */
 export declare class AcpServer {
     private transport;
@@ -87,8 +94,10 @@ export declare class AcpServer {
     private hostSupportsExtendedMethods;
     /** Active session ID (ACP v1 = single session per connection) */
     private activeSessionId;
-    /** Pending permission requests (agent → host) waiting for response */
+    /** Pending permission requests (agent 鈫?host) waiting for response */
     private pendingPermissions;
+    /** Map from outbound JSON-RPC request id 鈫?permissionId for response matching */
+    private outboundRequestMap;
     constructor(transport: Transport, handler: AcpRequestHandler, config?: AcpServerConfig);
     /**
      * Route an incoming raw message through ACP protocol handling.
@@ -103,7 +112,7 @@ export declare class AcpServer {
      */
     emitSessionUpdate(sessionId: string, type: AcpSessionUpdateType, payload: Record<string, unknown>): void;
     /**
-     * Send a permission request to the host (agent → host RPC).
+     * Send a permission request to the host (agent 鈫?host RPC).
      * Returns a promise that resolves with the host's chosen option.
      */
     requestPermission(params: AcpPermissionRequestParams): Promise<AcpPermissionRequestResult>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -23,11 +23,23 @@
     "./orchestration": {
       "types": "./dist/types/orchestration/index.d.ts",
       "default": "./dist/orchestration.js"
+    },
+    "./protocol": {
+      "types": "./dist/types/protocol/wire/index.d.ts",
+      "default": "./dist/protocol.js"
     }
   },
   "files": [
     "dist/"
   ],
+  "typesVersions": {
+    "*": {
+      "protocol": ["./dist/types/protocol/wire/index.d.ts"],
+      "agent": ["./dist/types/agent/agent.d.ts"],
+      "contracts": ["./dist/types/contracts/index.d.ts"],
+      "orchestration": ["./dist/types/orchestration/index.d.ts"]
+    }
+  },
   "scripts": {
     "dev": "tsx watch src/index.ts",
     "build": "node scripts/build.mjs",
@@ -46,8 +58,7 @@
     "nanoid": "^5.1.5",
     "pino": "^9.6.0",
     "pino-pretty": "^13.0.0",
-    "qlogicagent-adapter-claw": "^0.2.0",
-    "qlogicagent-runtime-contracts": "^3.0.0"
+    "qlogicagent-adapter-claw": "^0.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",