qlogicagent 2.13.5 → 2.13.6

package/dist/cli/handlers/skills-handler.d.ts

@@ -1,29 +0,0 @@
-/**
- * Skills management handlers — extracted from StdioServer.
- * Handles: skills.list, skills.activate, skills.deactivate, skills.delete,
- *          skills.promote, skills.stats, skills.pin, skills.unpin,
- *          skills.curator, skills.lifecycle
- */
-import { type AgentRpcError, type AgentRpcRequest } from "../../protocol/wire/index.js";
-export interface SkillsHandlerHost {
-    projectLocator?: {
-        resolveProjectRoot(projectId: string): string | undefined;
-    };
-    getActiveProjectRoot(): string;
-    sendNotification(method: string, params: Record<string, unknown>): void;
-    sendResponse(id: string | number, result?: unknown, error?: AgentRpcError): void;
-}
-export declare function extractSkillMeta(skillMdPath: string): {
-    version?: string;
-    description?: string;
-};
-export declare function handleSkillsList(this: SkillsHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSkillsActivate(this: SkillsHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSkillsDeactivate(this: SkillsHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSkillsDelete(this: SkillsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSkillsPromote(this: SkillsHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSkillsStats(this: SkillsHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSkillsPin(this: SkillsHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSkillsUnpin(this: SkillsHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSkillsCurator(this: SkillsHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSkillsLifecycle(this: SkillsHandlerHost, msg: AgentRpcRequest): void;

package/dist/cli/handlers/skills-handler.js

@@ -1,368 +0,0 @@
-/**
- * Skills management handlers — extracted from StdioServer.
- * Handles: skills.list, skills.activate, skills.deactivate, skills.delete,
- *          skills.promote, skills.stats, skills.pin, skills.unpin,
- *          skills.curator, skills.lifecycle
- */
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { getUserSkillsDir, getOwnerProfileDir } from "../../runtime/infra/agent-paths.js";
-import { getSkillStats, getAllSkillStats } from "../../skills/skill-system/skill-source.js";
-import { loadLifecycleStore, saveLifecycleStore, ensureRecord, removeRecord, pinSkill, unpinSkill, executeCuratorCycle, getSkillsByState, } from "../../skills/skill-system/skill-lifecycle.js";
-import { enableSkill, disableSkill, readProjectScopedSkills, setSkillGloballyDisabled, unmarkProjectScoped } from "../../runtime/infra/project-skill-manifest.js";
-import { resolveSkillPath } from "../../runtime/infra/skill-resolver.js";
-import { invalidateSkillRecallCache } from "../../runtime/hooks/skill-recall-hooks.js";
-import { createDefaultCommunitySignalReporter } from "../../runtime/community/community-signal-reporter.js";
-import { AGENT_RPC_ERROR_CODES } from "../../protocol/wire/index.js";
-import { listSkillsForProject } from "../skills-query-service.js";
-// ── Helper ───────────────────────────────────────────────────────────────────
-export function extractSkillMeta(skillMdPath) {
-    try {
-        const content = fs.readFileSync(skillMdPath, "utf8");
-        const versionMatch = content.match(/^---\n[\s\S]*?^version:\s*(\S+)/m);
-        const descMatch = content.match(/^---\n[\s\S]*?^description:\s*(.+)/m);
-        return {
-            version: versionMatch?.[1],
-            description: descMatch?.[1]?.trim(),
-        };
-    }
-    catch {
-        return {};
-    }
-}
-function skillDisplayName(name) {
-    return {
-        key: `capability.skill.${name}.name`,
-        fallback: name,
-    };
-}
-function skillDisplayDescription(name, description) {
-    return {
-        key: `capability.skill.${name}.description`,
-        fallback: description ?? "",
-    };
-}
-function isSystemGeneratedSkillName(name) {
-    return name.startsWith("auto-skill-") || name.startsWith("test-skill-");
-}
-function isSkillLifecycleState(value) {
-    return value === "active" || value === "stale" || value === "archived";
-}
-// ── Skills RPC handlers ──────────────────────────────────────────────────────
-export function handleSkillsList(msg) {
-    const params = msg.params;
-    const projectId = params?.projectId;
-    let cwd = this.getActiveProjectRoot();
-    if (projectId && this.projectLocator) {
-        const resolved = this.projectLocator.resolveProjectRoot(projectId);
-        if (resolved)
-            cwd = resolved;
-    }
-    const skills = listSkillsForProject(cwd);
-    if (msg.id !== undefined) {
-        this.sendResponse(msg.id, { skills });
-    }
-}
-export function handleSkillsActivate(msg) {
-    const params = msg.params;
-    const skillName = params?.name;
-    if (!skillName) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "Missing required param: name",
-            });
-        }
-        return;
-    }
-    const cwd = this.getActiveProjectRoot();
-    if (!cwd) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: "No active project workspace",
-            });
-        }
-        return;
-    }
-    // Activation = enable the skill in this project's manifest (single global store).
-    if (!resolveSkillPath(skillName)) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: `Skill "${skillName}" not found`,
-            });
-        }
-        return;
-    }
-    // Scope routes the enable to the right registry: project-scoped skills join
-    // this project's manifest; global skills come off the owner-level mute list
-    // (the plugin card's switch — see project-skill-manifest "Global disable").
-    const newlyEnabled = readProjectScopedSkills().has(skillName)
-        ? enableSkill(cwd, skillName)
-        : setSkillGloballyDisabled(skillName, false);
-    // Re-activate lifecycle state on (re)enable.
-    const agentHome = getOwnerProfileDir();
-    const store = loadLifecycleStore(agentHome);
-    const rec = ensureRecord(store, skillName);
-    if (rec.state !== "active") {
-        rec.state = "active";
-        rec.staleAt = undefined;
-        rec.archivedAt = undefined;
-    }
-    saveLifecycleStore(agentHome, store);
-    invalidateSkillRecallCache();
-    if (msg.id !== undefined)
-        this.sendResponse(msg.id, { ok: true, already: !newlyEnabled });
-    this.sendNotification("skills.updated", { action: "activate", name: skillName });
-}
-export function handleSkillsDeactivate(msg) {
-    const params = msg.params;
-    const skillName = params?.name;
-    if (!skillName) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "Missing required param: name",
-            });
-        }
-        return;
-    }
-    const cwd = this.getActiveProjectRoot();
-    if (!cwd) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: "No active project workspace",
-            });
-        }
-        return;
-    }
-    // Project-scoped: drop from this project's manifest. Global: mute everywhere
-    // via the owner-level disable registry (per-project muting of a global skill
-    // still doesn't exist under this model — the switch is all-or-nothing).
-    const removed = readProjectScopedSkills().has(skillName)
-        ? disableSkill(cwd, skillName)
-        : setSkillGloballyDisabled(skillName, true);
-    invalidateSkillRecallCache();
-    if (msg.id !== undefined)
-        this.sendResponse(msg.id, { ok: true, already: !removed });
-    this.sendNotification("skills.updated", { action: "deactivate", name: skillName });
-}
-export async function handleSkillsDelete(msg) {
-    const params = msg.params;
-    const skillName = params?.name;
-    if (!skillName || /[\/\\]|\.\./.test(skillName)) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "Missing or invalid skill name",
-            });
-        }
-        return;
-    }
-    // Pinned protection
-    const agentHome = getOwnerProfileDir();
-    const store = loadLifecycleStore(agentHome);
-    if (store.records[skillName]?.pinned) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: `Skill "${skillName}" is pinned. Unpin it first.`,
-            });
-        }
-        return;
-    }
-    const scope = params?.scope ?? "project";
-    if (scope === "project") {
-        // Project delete = remove from this project's manifest; the file stays in
-        // the global store (other projects may still use it).
-        const cwd = this.getActiveProjectRoot();
-        if (!cwd) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                    message: "No active project workspace",
-                });
-            }
-            return;
-        }
-        disableSkill(cwd, skillName);
-        invalidateSkillRecallCache();
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { ok: true, deleted: skillName, scope });
-        }
-        this.sendNotification("skills.updated", { action: "delete", name: skillName });
-        return;
-    }
-    // Global delete = hard-remove the skill from the single store + its record.
-    const targetDir = path.join(getUserSkillsDir(), skillName);
-    if (!fs.existsSync(targetDir)) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: `Skill "${skillName}" not found in global store`,
-            });
-        }
-        return;
-    }
-    const registryRecord = store.records[skillName];
-    try {
-        fs.rmSync(targetDir, { recursive: true, force: true });
-        invalidateSkillRecallCache();
-        removeRecord(store, skillName);
-        unmarkProjectScoped(skillName);
-        saveLifecycleStore(agentHome, store);
-        // Registry-installed skills report an uninstalled trust signal. The reporter
-        // gates on community consent and skips official-tier records by design.
-        let signalStatus;
-        if (registryRecord?.registryResourceId) {
-            signalStatus = await createDefaultCommunitySignalReporter()?.recordSkillLifecycle(registryRecord, "uninstalled");
-        }
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { ok: true, deleted: skillName, scope, ...(signalStatus ? { signalStatus } : {}) });
-        }
-        this.sendNotification("skills.updated", { action: "delete", name: skillName });
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: `Failed to delete skill: ${err instanceof Error ? err.message : err}`,
-            });
-        }
-    }
-}
-export function handleSkillsPromote(msg) {
-    const params = msg.params;
-    const skillName = params?.name;
-    if (!skillName || /[\/\\]|\.\./.test(skillName)) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                message: "Missing or invalid skill name",
-            });
-        }
-        return;
-    }
-    // Promote = flip the skill's enablement scope to global. Files already live in
-    // the single store, so nothing is copied. The origin project's manifest entry
-    // becomes redundant and is removed (unless keepLocal).
-    if (!resolveSkillPath(skillName)) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: `Skill "${skillName}" not found in skill store`,
-            });
-        }
-        return;
-    }
-    const agentHome = getOwnerProfileDir();
-    const store = loadLifecycleStore(agentHome);
-    const rec = ensureRecord(store, skillName);
-    rec.source = "promoted";
-    saveLifecycleStore(agentHome, store);
-    unmarkProjectScoped(skillName); // global from now on
-    const cwd = this.getActiveProjectRoot();
-    if (cwd && !params?.keepLocal)
-        disableSkill(cwd, skillName);
-    invalidateSkillRecallCache();
-    if (msg.id !== undefined) {
-        this.sendResponse(msg.id, {
-            ok: true,
-            promoted: skillName,
-            scope: "global",
-            globalPath: path.join(getUserSkillsDir(), skillName),
-            removedFromProject: Boolean(cwd) && !params?.keepLocal,
-        });
-    }
-    this.sendNotification("skills.updated", { action: "promote", name: skillName });
-}
-export function handleSkillsStats(msg) {
-    const params = msg.params;
-    const agentHome = getOwnerProfileDir();
-    if (params?.name) {
-        const stats = getSkillStats(agentHome, params.name);
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { name: params.name, stats: stats ?? null });
-        }
-    }
-    else {
-        const allStats = getAllSkillStats(agentHome);
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { stats: allStats });
-        }
-    }
-}
-// ── Skills Lifecycle RPC ─────────────────────────────────────────────────────
-export function handleSkillsPin(msg) {
-    const params = msg.params;
-    if (!params?.name) {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, null, { code: -32602, message: "Missing 'name' parameter" });
-        return;
-    }
-    const agentHome = getOwnerProfileDir();
-    const store = loadLifecycleStore(agentHome);
-    ensureRecord(store, params.name);
-    pinSkill(store, params.name);
-    saveLifecycleStore(agentHome, store);
-    if (msg.id !== undefined) {
-        this.sendResponse(msg.id, { name: params.name, pinned: true });
-    }
-}
-export function handleSkillsUnpin(msg) {
-    const params = msg.params;
-    if (!params?.name) {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, null, { code: -32602, message: "Missing 'name' parameter" });
-        return;
-    }
-    const agentHome = getOwnerProfileDir();
-    const store = loadLifecycleStore(agentHome);
-    unpinSkill(store, params.name);
-    saveLifecycleStore(agentHome, store);
-    if (msg.id !== undefined) {
-        this.sendResponse(msg.id, { name: params.name, pinned: false });
-    }
-}
-export function handleSkillsCurator(msg) {
-    const agentHome = getOwnerProfileDir();
-    // Single global store: the curator archives stale skills in the one store.
-    const skillsDir = getUserSkillsDir();
-    const result = executeCuratorCycle(agentHome, skillsDir);
-    if (result.transitioned.length > 0) {
-        invalidateSkillRecallCache();
-    }
-    if (msg.id !== undefined) {
-        this.sendResponse(msg.id, result);
-    }
-}
-export function handleSkillsLifecycle(msg) {
-    const params = msg.params;
-    const agentHome = getOwnerProfileDir();
-    const store = loadLifecycleStore(agentHome);
-    if (params?.name) {
-        const record = store.records[params.name] ?? null;
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, { record });
-    }
-    else if (params?.state) {
-        if (!isSkillLifecycleState(params.state)) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                    message: "Invalid skill lifecycle state",
-                });
-            }
-            return;
-        }
-        const records = getSkillsByState(store, params.state);
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, { records });
-    }
-    else {
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, { records: Object.values(store.records) });
-    }
-}

package/dist/cli/handlers/skills-handler.profile.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/cli/handlers/skills-handler.profile.test.js

@@ -1,70 +0,0 @@
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { afterEach, describe, expect, it, vi } from "vitest";
-import { resetStatsCache } from "../../skills/skill-system/skill-source.js";
-import { handleSkillsPin, handleSkillsStats } from "./skills-handler.js";
-const tmpDirs = [];
-function makeTempDir(prefix) {
-    const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
-    tmpDirs.push(dir);
-    return dir;
-}
-function profileDir(home, owner = "user%2Falice") {
-    return path.join(home, "profiles", owner);
-}
-function makeHost(workspace) {
-    const responses = [];
-    const host = {
-        getActiveProjectRoot: () => workspace,
-        sendNotification: () => undefined,
-        sendResponse: (id, result, error) => responses.push({ id, result, error }),
-    };
-    return { host, responses };
-}
-afterEach(() => {
-    vi.unstubAllEnvs();
-    resetStatsCache();
-    for (const dir of tmpDirs.splice(0)) {
-        fs.rmSync(dir, { recursive: true, force: true });
-    }
-});
-describe("skills handler owner profile boundary", () => {
-    it("pins skill lifecycle records in the active owner profile", () => {
-        const home = makeTempDir("skills-profile-home-");
-        const workspace = makeTempDir("skills-profile-workspace-");
-        vi.stubEnv("QLOGICAGENT_HOME", home);
-        vi.stubEnv("QLOGIC_LLMROUTER_USER_ID", "user/alice");
-        const { host, responses } = makeHost(workspace);
-        handleSkillsPin.call(host, {
-            id: "pin-1",
-            method: "skills.pin",
-            params: { name: "send-report" },
-        });
-        const profileFile = path.join(profileDir(home), "skill-lifecycle.json");
-        expect(responses[0]?.result).toEqual({ name: "send-report", pinned: true });
-        expect(fs.existsSync(profileFile)).toBe(true);
-        expect(fs.existsSync(path.join(home, "skill-lifecycle.json"))).toBe(false);
-    });
-    it("reads skill stats from the active owner profile", () => {
-        const home = makeTempDir("skills-profile-home-");
-        const workspace = makeTempDir("skills-profile-workspace-");
-        vi.stubEnv("QLOGICAGENT_HOME", home);
-        vi.stubEnv("QLOGIC_LLMROUTER_USER_ID", "user/alice");
-        const profile = profileDir(home);
-        fs.mkdirSync(profile, { recursive: true });
-        fs.writeFileSync(path.join(profile, "skill-stats.json"), JSON.stringify({
-            "send-report": { invokeCount: 3, activeCount: 0, positiveCount: 2, negativeCount: 1, successRate: 2 / 3 },
-        }), "utf-8");
-        const { host, responses } = makeHost(workspace);
-        handleSkillsStats.call(host, {
-            id: "stats-1",
-            method: "skills.stats",
-            params: { name: "send-report" },
-        });
-        expect(responses[0]?.result).toMatchObject({
-            name: "send-report",
-            stats: { invokeCount: 3, positiveCount: 2, negativeCount: 1 },
-        });
-    });
-});

package/dist/cli/handlers/solo-handler.d.ts

@@ -1,38 +0,0 @@
-/**
- * Solo mode handlers — extracted from StdioServer.
- * Handles: solo.start, solo.status, solo.cancel, solo.select,
- *          solo.list, solo.delete, solo.message, solo.evaluate
- */
-import { AgentProcessManager } from "../../runtime/infra/agent-process.js";
-import type { AcpDetector } from "../../runtime/infra/acp-detector.js";
-import type { AgentConfigStore } from "../../runtime/infra/agent-config-store.js";
-import { SoloEvaluator } from "../../orchestration/solo-evaluator.js";
-import { type AgentRpcError, type AgentRpcRequest } from "../../protocol/wire/index.js";
-export declare const soloProjectMap: Map<string, string>;
-export interface SoloHandlerHost {
-    soloEvaluator: SoloEvaluator | null;
-    soloProcessManager: AgentProcessManager | null;
-    acpDetector: AcpDetector;
-    agentConfigStore: AgentConfigStore | null;
-    sendNotification(method: string, params: Record<string, unknown>): void;
-    sendResponse(id: string | number, result?: unknown, error?: AgentRpcError): 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 ensureSoloEvaluator(this: SoloHandlerHost): SoloEvaluator;
-export declare function handleSoloStart(this: SoloHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSoloStatus(this: SoloHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSoloCancel(this: SoloHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSoloSelect(this: SoloHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSoloList(this: SoloHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSoloDelete(this: SoloHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSoloMessage(this: SoloHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSoloEvaluate(this: SoloHandlerHost, msg: AgentRpcRequest): Promise<void>;