qlogicagent 2.16.4 → 2.16.6

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

@@ -5,27 +5,16 @@
  * New runtime code should depend on a ToolCatalog/ToolRegistry instance; the
  * module-level functions below remain as a compatibility facade for older
  * bootstrap paths while those call sites are migrated.
+ *
+ * All registered tools are resident: every enabled tool is offered to the model
+ * each turn (hermes-aligned). There is no deferral / on-demand discovery.
  */
 import type { PortableTool } from "./portable-tool.js";
 import type { ToolDefinition } from "../protocol/wire/index.js";
 import { AGENT_DISALLOWED_TOOLS, CUSTOM_AGENT_DISALLOWED_TOOLS, filterToolsForAgent } from "./tool-access.js";
 export { AGENT_DISALLOWED_TOOLS, CUSTOM_AGENT_DISALLOWED_TOOLS, filterToolsForAgent };
-/**
- * Deferral policy (CC-aligned): a few HIGH-FREQUENCY capabilities stay LOADED even if their
- * factory marks them deferrable, so the model never has to voluntarily tool_search for the
- * things users ask for most. Only the long tail (rare media variants, niche tools) and MCP
- * stay deferred. Trades a small always-on token cost on common paths for discovery
- * reliability — mirrors Claude Code (keeps common tools loaded; defers only the long
- * tail / large MCP sets) rather than relying on the model to decide to search.
- */
-export declare const COMMON_LOADED_CAPABILITIES: Set<string>;
 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;
@@ -36,22 +25,7 @@ export declare class ToolRegistry {
     getToolCount(): number;
     executeTool(name: string, toolCallId: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<import("./portable-tool.js").PortableToolResult>;
     getTools(): PortableTool[];
-    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[];
+    getToolManifest(): ToolDefinition[];
 }
 export declare function getDefaultToolRegistry(): ToolRegistry;
 export declare function setToolPool(tools: PortableTool[]): void;
@@ -64,12 +38,4 @@ export declare function getToolNames(): string[];
 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>;
 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[];
+export declare function getToolManifest(): ToolDefinition[];

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

@@ -2,7 +2,7 @@
  * ACP ServerAgent-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.
+ * host (AionUI, Cursor, xiaozhiclaw, etc.) to connect and interact with the agent.
  *
  * Protocol: ACP v1 over JSON-RPC 2.0 / stdio (line-delimited JSON).
  *
@@ -94,6 +94,18 @@ export interface AcpRequestHandler {
     handleAcpProductReplay(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductStatus(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductSubscribe(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpGoalStart(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpGoalStatus(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpGoalPause(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpGoalResume(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpGoalUpdateGoal(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpGoalStop(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpGoalMessage(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpGoalSubscribe(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpGoalEvents(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpMentionDelegate(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpMentionCancel(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpMentionList(params: Record<string, unknown>): Promise<unknown>;
 }
 export interface AcpServerConfig {
     verbose?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.16.4",
+  "version": "2.16.6",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -71,6 +71,7 @@
     "test": "vitest run",
     "check": "tsc --noEmit && pnpm test && pnpm run check:architecture-boundaries && pnpm run check:provider-core-boundary && pnpm run check:provider-core-release-sync && pnpm run check:pet-core-boundary && pnpm run check:workspace-hygiene && pnpm run check:package-artifact",
     "test:watch": "vitest",
+    "benchmark:hermes-superiority": "tsx benchmarks/hermes-superiority/runner.ts",
     "lint": "oxlint .",
     "check:architecture-boundaries": "node scripts/check-architecture-boundaries.mjs",
     "check:provider-core-boundary": "node scripts/check-provider-core-boundary.mjs",
@@ -80,7 +81,6 @@
     "check:workspace-hygiene:strict": "node scripts/check-workspace-hygiene.mjs --strict",
     "check:package-artifact": "npm run build && node scripts/check-package-artifact.mjs",
     "redteam:community-desensitization": "tsx src/runtime/community/community-desensitization-red-team-cli.ts",
-    "redteam:community-sandbox": "tsx src/skills/permissions/community-sandbox-red-team-cli.ts",
     "clean:workspace-hygiene": "node scripts/clean-workspace-hygiene.mjs",
     "release": "node scripts/release.mjs"
   },
@@ -90,7 +90,7 @@
   "dependencies": {
     "@agentclientprotocol/sdk": "^0.25.0",
     "@napi-rs/canvas": "0.1.100",
-    "@xiaozhiclaw/pet-core": "0.1.2",
+    "@xiaozhiclaw/pet-core": "0.1.3",
     "@xiaozhiclaw/provider-core": "^0.1.20",
     "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",

package/dist/types/cli/core-tools/team-registry.d.ts

@@ -1,62 +0,0 @@
-/**
- * TeamRegistry — session-scoped roster for the team tool: create registers
- * members (producer), the send action routes messages to them (consumer).
- *
- * The team tool spawns each member as a real subprocess agent
- * (AgentProcessManager) and registers a delivery closure here. The send
- * action looks the target up by name or full member id and routes the message
- * into the member's process via that closure, returning the member's reply.
- *
- * This registry is the ONLY routing path to team members, so an
- * unregistered/dead target fails loud.
- */
-export interface TeamRegistryMember {
-    /** Full member id, e.g. "team-research-coder". */
-    memberId: string;
-    /** Display name within the team, e.g. "coder". */
-    name: string;
-    /** Team this member belongs to. */
-    teamName: string;
-    /** Role description. */
-    role: string;
-    /** Deliver a message into the member's process and return its reply text. */
-    deliver: (message: string, fromId: string) => Promise<string>;
-    /** Whether the member's process is still alive. */
-    isAlive: () => boolean;
-}
-export interface TeamRegistryListEntry {
-    memberId: string;
-    name: string;
-    teamName: string;
-    role: string;
-    alive: boolean;
-}
-export interface DeliveryOutcome {
-    ok: boolean;
-    /** Per-recipient replies (broadcast may have several). */
-    replies?: Array<{
-        memberId: string;
-        name: string;
-        reply: string;
-    }>;
-    error?: string;
-}
-export declare class TeamRegistry {
-    private readonly members;
-    register(member: TeamRegistryMember): void;
-    unregister(memberId: string): void;
-    /** Live roster (alive flag reflects the underlying process). */
-    list(): TeamRegistryListEntry[];
-    /**
-     * Resolve a send `to` token to concrete members.
-     * Accepts a member name ("coder"), a full member id ("team-x-coder"),
-     * or "*" for broadcast to all alive members.
-     * Returns [] when nothing matches (caller fails loud).
-     */
-    private resolveTargets;
-    /**
-     * Deliver a message to the resolved target(s) and collect replies.
-     * Fail-loud: no target → ok:false; any delivery error → surfaced.
-     */
-    deliver(to: string, message: string, fromId: string): Promise<DeliveryOutcome>;
-}

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

@@ -1,11 +0,0 @@
-import type { ToolCatalog } from "../../runtime/ports/index.js";
-import type { AgentLogger } from "../../agent/types.js";
-import { type TeamToolServiceHost } from "./team-tool-service.js";
-import type { TeamRegistry } from "./team-registry.js";
-export interface TeamToolRegistrationDeps {
-    host: TeamToolServiceHost;
-    log: AgentLogger;
-    toolCatalog: ToolCatalog;
-    teamRegistry: TeamRegistry;
-}
-export declare function registerTeamTool({ host, log, toolCatalog, teamRegistry }: TeamToolRegistrationDeps): void;

package/dist/types/cli/core-tools/team-tool-service.d.ts

@@ -1,43 +0,0 @@
-import type { AgentLogger } from "../../agent/types.js";
-import type { BackgroundTaskManager } from "../../runtime/infra/background-tasks.js";
-import type { TeamToolDeps } from "../../skills/tools/team-tool.js";
-import type { TeamRegistry } from "./team-registry.js";
-export interface TeamToolService extends TeamToolDeps {
-    dispose(): void;
-}
-export interface TeamToolServiceHost {
-    readonly currentSessionId: string;
-    readonly verbose: boolean;
-    /**
-     * The leader's resolved LLM config, pushed to each spawned member as standing
-     * session config (session/set_config_option). Without it a standalone member
-     * (no llmrouter directory to hydrate a catalog from) cannot provision a
-     * provider, and its first reply turn fails with NO_PROVIDER. Returns null
-     * when the leader has no resolved provider yet.
-     */
-    getLlmConfig(): {
-        provider: string;
-        model: string;
-        apiKey: string;
-        baseUrl?: string;
-    } | null;
-    /** Lightweight memory INDEX injected into each member's system prompt (parent context). */
-    getMemoryIndex(): string | null;
-    /**
-     * Unified background-task registry. Team members register here as `team_member`
-     * tasks so the `task` tool's list/output/cancel reach them. Null when unbound.
-     */
-    getBackgroundTasks(): BackgroundTaskManager | null;
-    sendNotification(method: string, params: Record<string, unknown>): void;
-    emitAgentStatus(agentId: string, state: string, extra?: {
-        missedBeats?: number;
-        lastActivityAt?: number;
-        usage?: {
-            inputTokens: number;
-            outputTokens: number;
-            totalTokens: number;
-        };
-    }): void;
-    handleMcpToolCall(memberId: string, toolName: string, args: Record<string, unknown>): Promise<unknown>;
-}
-export declare function createTeamToolService(host: TeamToolServiceHost, log: AgentLogger, registry: TeamRegistry): TeamToolService;

package/dist/types/cli/skill-meta-subturn-service.d.ts

@@ -1,26 +0,0 @@
-import type { TurnEvent, TurnRequest } from "../agent/types.js";
-import type { HookRegistry } from "../contracts/hooks.js";
-import type { ToolCatalog } from "../runtime/ports/index.js";
-import { type CommunitySignalReporter } from "../runtime/community/community-signal-reporter.js";
-import { type SkillSandbox } from "../runtime/sandbox/skill-sandbox.js";
-import { type SkillLifecycleRecord } from "../skills/skill-system/skill-lifecycle.js";
-export interface SkillSubturnAgent {
-    run(request: TurnRequest, signal?: AbortSignal): AsyncGenerator<TurnEvent>;
-}
-export interface SkillSubturnHost {
-    getAgent(): SkillSubturnAgent | null;
-    getCurrentSessionId(): string;
-    getCurrentHooks(): HookRegistry | null;
-}
-export interface ExecuteSkillSubturnParams {
-    host: SkillSubturnHost;
-    toolCatalog: ToolCatalog;
-    skillName: string;
-    skillContent: string;
-    userArgs?: string;
-    signal?: AbortSignal;
-    communitySignalReporter?: CommunitySignalReporter | null;
-    skillSandbox?: SkillSandbox | null;
-}
-export declare function executeSkillSubturn(params: ExecuteSkillSubturnParams): Promise<string>;
-export declare function resolveSkillSubagentTypeForLifecycle(skillName: string, record: SkillLifecycleRecord | undefined): string;

package/dist/types/runtime/hooks/skill-recall-hooks.d.ts

@@ -1,37 +0,0 @@
-import type { HookRegistry } from "../../contracts/hooks.js";
-import type { CommunityDiscoveryCoordinator } from "../community/community-discovery-coordinator.js";
-export declare const SKILL_RECALL_CONFIG: {
-    readonly MAX_RECALLED_SKILLS: 3;
-    readonly MAX_SKILL_CONTENT_CHARS: 800;
-    readonly CACHE_TTL_MS: number;
-};
-/**
- * Detect whether user message contains retrospective/cross-reference semantics
- * OR similar-task patterns that could benefit from existing skills.
- * Returns extracted keywords for skill matching if triggered, or null.
- */
-export declare function detectRetrospectiveTrigger(message: string): string[] | null;
-export interface SkillRecallHooksDeps {
-    /** Current project cwd (to exclude from cross-project search). */
-    currentCwd?: string;
-    /** Optional online community discovery coordinator. */
-    communityDiscovery?: CommunityDiscoveryCoordinator | null;
-    /** Logger. */
-    log: {
-        debug(msg: string): void;
-        warn(msg: string): void;
-    };
-}
-/**
- * Register the cross-project skill recall hook on `memory.before_recall`.
- * Runs at lower priority (60) than QMemory prefetch (50) so it supplements,
- * not replaces, the standard memory recall.
- *
- * When triggered, injects cross-project skill metadata into recalledMemories.
- */
-export declare function registerSkillRecallHooks(hooks: HookRegistry, deps: SkillRecallHooksDeps): () => void;
-/**
- * Invalidate the cross-project skill index cache.
- * Call when skills are created/deleted/promoted to refresh.
- */
-export declare function invalidateSkillRecallCache(): void;

package/dist/types/runtime/sandbox/skill-sandbox.d.ts

@@ -1,53 +0,0 @@
-import { buildWindowsProcessTreeLauncherAuditEnvelope, type WindowsSkillSandboxAvailability } from "./windows-skill-sandbox.js";
-export type SkillSandboxOrigin = "community" | "first-party" | "official";
-export type SkillSandboxRiskTier = "R0" | "R1" | "R2" | "R3" | "unknown";
-export type SkillSandboxDecisionReason = "first-party-action" | "community-low-risk" | "manual-run" | "l0-available" | "l0-unavailable" | "launcher-required" | "launcher-unavailable";
-export interface SkillSandboxAvailability extends WindowsSkillSandboxAvailability {
-}
-export interface SkillSandboxRunRequest {
-    origin: SkillSandboxOrigin;
-    official?: boolean;
-    riskTier?: SkillSandboxRiskTier;
-    autoRun?: boolean;
-    executable?: boolean;
-}
-export interface SkillSandboxLauncherDecisionMetadata {
-    level: "L0";
-    mode: "os-native-launcher";
-    defaultHostAccess: true;
-    noFsNetworkRestriction: true;
-    audit: {
-        envelope: "l0-launcher-audit-v1";
-        subject: {
-            origin: SkillSandboxOrigin;
-            official: boolean;
-            executable: boolean;
-            autoRun: boolean;
-        };
-        decision: "allowed" | "blocked";
-        reason: "launcher-required" | "launcher-unavailable";
-    };
-    windows?: ReturnType<typeof buildWindowsProcessTreeLauncherAuditEnvelope>;
-}
-export interface SkillSandboxDecision {
-    allowed: boolean;
-    spawnAllowed: boolean;
-    launcherRequired: boolean;
-    reason: SkillSandboxDecisionReason;
-    backend: "first-party" | "community-l1-l2" | "community-l0" | "community-l0-launcher";
-    l0: SkillSandboxAvailability;
-    launcher?: SkillSandboxLauncherDecisionMetadata;
-}
-export interface SkillSandbox {
-    getAvailability(): SkillSandboxAvailability;
-    decide(request: SkillSandboxRunRequest): SkillSandboxDecision;
-}
-export interface SkillSandboxOptions {
-    availability?: SkillSandboxAvailability;
-    platform?: string;
-    appContainerAvailable?: boolean;
-    jobObjectAvailable?: boolean;
-    processTreeLauncherAvailable?: boolean;
-}
-export declare function createSkillSandbox(options?: SkillSandboxOptions): SkillSandbox;
-export declare function createDefaultSkillSandbox(): SkillSandbox;

package/dist/types/runtime/sandbox/windows-skill-sandbox.d.ts

@@ -1,78 +0,0 @@
-export type WindowsSkillSandboxBackend = "windows-process-tree-launcher";
-export type WindowsProcessTreeLauncherAuditEvent = "launch-requested" | "process-started" | "process-exited" | "tree-kill-requested" | "launch-failed";
-export interface WindowsSkillSandboxAvailabilityOptions {
-    platform?: string;
-    appContainerAvailable?: boolean;
-    jobObjectAvailable?: boolean;
-    processTreeLauncherAvailable?: boolean;
-}
-export interface WindowsSkillSandboxAvailability {
-    level: "L0";
-    available: boolean;
-    backend: WindowsSkillSandboxBackend | "unsupported-platform" | "unavailable";
-    platform: string;
-    reason?: "unsupported-platform" | "windows-l0-not-provisioned";
-}
-export interface WindowsSandboxLaunchMetadata {
-    backend: WindowsSkillSandboxBackend;
-    command: string;
-    args: string[];
-    elevated: false;
-    defaultHostAccess: true;
-    noFsNetworkRestriction: true;
-    jobObject: {
-        implemented: false;
-        ready: true;
-    };
-    processTree: {
-        killOnClose: true;
-        trackChildren: true;
-        terminateOnLauncherClose: true;
-    };
-    audit: {
-        envelope: "l0-launcher-audit-v1";
-        lifecycle: WindowsProcessTreeLauncherAuditEvent[];
-    };
-}
-export interface WindowsProcessTreeLauncherAuditEnvelope {
-    envelope: "l0-launcher-audit-v1";
-    backend: WindowsSkillSandboxBackend;
-    defaultHostAccess: true;
-    noFsNetworkRestriction: true;
-    processTree: {
-        killOnClose: true;
-        trackChildren: true;
-    };
-    jobObject: {
-        implemented: false;
-        ready: true;
-    };
-}
-export interface WindowsProcessTreeChild {
-    pid?: number;
-}
-export interface WindowsProcessTreeLauncherDependencies {
-    spawn?: (command: string, args: string[]) => WindowsProcessTreeChild;
-    killProcessTree?: (pid: number) => Promise<void> | void;
-}
-export interface WindowsProcessTreeLaunchRequest {
-    command: string;
-    args?: string[];
-}
-export interface WindowsProcessTreeLaunchHandle {
-    pid: number;
-    metadata: WindowsSandboxLaunchMetadata;
-    auditEvents: WindowsProcessTreeLauncherAuditEvent[];
-    close(): Promise<void>;
-}
-export interface WindowsProcessTreeLauncher {
-    auditEvents: WindowsProcessTreeLauncherAuditEvent[];
-    launch(request: WindowsProcessTreeLaunchRequest): WindowsProcessTreeLaunchHandle;
-}
-export declare function getWindowsSkillSandboxAvailability(options?: WindowsSkillSandboxAvailabilityOptions): WindowsSkillSandboxAvailability;
-export declare function buildWindowsSandboxLaunchMetadata(input: {
-    command: string;
-    args?: string[];
-}): WindowsSandboxLaunchMetadata;
-export declare function buildWindowsProcessTreeLauncherAuditEnvelope(): WindowsProcessTreeLauncherAuditEnvelope;
-export declare function createWindowsProcessTreeLauncher(dependencies?: WindowsProcessTreeLauncherDependencies): WindowsProcessTreeLauncher;

package/dist/types/skills/permissions/community-sandbox-policy.d.ts

@@ -1,3 +0,0 @@
-import type { PermissionRuleEntry } from "./types.js";
-export type CommunitySandboxRuleId = "community-l1-shell" | "community-l1-file-read" | "community-l1-file-write" | "community-l1-network" | "community-l1-mcp" | "community-l1-host-control" | "community-l2-host-side-effect" | "community-l2-data-egress" | "community-l2-provider-prompt-egress" | "community-l2-provider-media-egress";
-export declare function createCommunitySandboxScopedRules(): PermissionRuleEntry[];

package/dist/types/skills/permissions/community-sandbox-red-team-cli.d.ts

@@ -1,7 +0,0 @@
-export interface CommunitySandboxRedTeamCliDeps {
-    log?: {
-        info(message: string): void;
-        error(message: string): void;
-    };
-}
-export declare function runCommunitySandboxRedTeamCli(argv?: string[], deps?: CommunitySandboxRedTeamCliDeps): Promise<number>;

package/dist/types/skills/permissions/community-sandbox-red-team.d.ts

@@ -1,32 +0,0 @@
-import { type SkillSandboxAvailability } from "../../runtime/sandbox/skill-sandbox.js";
-export type CommunitySandboxRedTeamFinding = "community-sandbox:shell-exec" | "community-sandbox:file-read" | "community-sandbox:file-write" | "community-sandbox:network-egress" | "community-sandbox:mcp-call" | "community-sandbox:host-side-effect" | "community-sandbox:data-egress" | "community-sandbox:provider-prompt-egress" | "community-sandbox:provider-media-egress";
-export interface CommunitySandboxRedTeamCase {
-    id: string;
-    expectedFinding: CommunitySandboxRedTeamFinding;
-    toolName: string;
-    arguments?: Record<string, unknown>;
-}
-export interface CommunitySandboxRedTeamReport {
-    suite: "sandbox";
-    generatedAt: string;
-    cases: number;
-    passed: boolean;
-    failures: number;
-    telemetryEvents: number;
-    approvalRequests: number;
-    l0: SkillSandboxAvailability;
-    breakdown: Record<CommunitySandboxRedTeamFinding, {
-        cases: number;
-        failures: number;
-    }>;
-    failureDetails: Array<{
-        id: string;
-        expectedFinding: CommunitySandboxRedTeamFinding;
-        action: "continue" | "abort" | "skip" | "prevent";
-        reason?: string;
-        telemetryRecorded: boolean;
-        approvalRecorded: boolean;
-    }>;
-}
-export declare function buildCommunitySandboxRedTeamCases(): CommunitySandboxRedTeamCase[];
-export declare function runCommunitySandboxRedTeam(cases?: CommunitySandboxRedTeamCase[]): Promise<CommunitySandboxRedTeamReport>;

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

@@ -1,38 +0,0 @@
-/**
- * Lightweight per-skill stats stored in `~/.qlogicagent/skill-stats.json`.
- * Covers learned, promoted, and registry-installed skills.
- */
-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;
-}
-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;