qlogicagent 2.13.2 → 2.13.4

package/dist/types/cli/agent-config-coordinator.d.ts

@@ -4,6 +4,8 @@ export interface AgentConfigCoordinatorDeps {
     acpDetector: AcpDetector;
     getActiveProjectRoot(): string;
 }
+export declare function resolveLlmrouterPublicOrigin(rawBaseUrl?: string): string | undefined;
+export declare function resolveLlmrouterProtocolBaseUrl(agentId: string, rawBaseUrl?: string): string | undefined;
 export declare class AgentConfigCoordinator {
     private readonly deps;
     private store;

package/dist/types/cli/handlers/community-handler.d.ts

@@ -18,6 +18,14 @@ export declare function handleCommunityListShared(this: CommunityHandlerHost, ms
 export declare function handleCommunityMatchRegistry(this: CommunityHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export declare function handleCommunityResolveInstall(this: CommunityHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export declare function handleCommunityInstallResource(this: CommunityHandlerHost, msg: AgentRpcRequest): Promise<void>;
+/**
+ * Handshake step ① — probe declared runtime dependencies (vetted catalog only).
+ * The plugin page calls this right after install so "点 + 即可用" holds: missing
+ * quick runtimes are auto-installed, heavy/unknown ones surface a consent card.
+ */
+export declare function handleCommunityRuntimeStatus(this: CommunityHandlerHost, msg: AgentRpcRequest): Promise<void>;
+/** Handshake step ② — install ONE vetted runtime dependency (catalog recipe only). */
+export declare function handleCommunityInstallRuntime(this: CommunityHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export declare function handleCommunityPublishSkill(this: CommunityHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export declare function handleCommunityPublishPet(this: CommunityHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export declare function handleCommunityRecordSignal(this: CommunityHandlerHost, msg: AgentRpcRequest): Promise<void>;

package/dist/types/cli/handlers/settings-handler.d.ts

@@ -2,11 +2,13 @@ import { type AgentRpcError, type AgentRpcRequest } from "../../protocol/wire/in
 export interface SettingsHandlerHost {
     sendError?(id: string | number, code: number, message: string): void;
     sendResponse(id: string | number, result?: unknown, error?: AgentRpcError): void;
+    writeClipboard?(text: string): Promise<void>;
 }
 export declare function handleSettingsListProviders(this: SettingsHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export declare function handleSettingsAddKey(this: SettingsHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export declare function handleSettingsRemoveKey(this: SettingsHandlerHost, msg: AgentRpcRequest): void;
 export declare function handleSettingsGetKey(this: SettingsHandlerHost, msg: AgentRpcRequest): void;
+export declare function handleSettingsCopyKey(this: SettingsHandlerHost, msg: AgentRpcRequest): Promise<void>;
 export declare function handleSettingsToggleKey(this: SettingsHandlerHost, msg: AgentRpcRequest): void;
 export declare function handleSettingsToggleModel(this: SettingsHandlerHost, msg: AgentRpcRequest): void;
 export declare function handleSettingsListModels(this: SettingsHandlerHost, msg: AgentRpcRequest): Promise<void>;

package/dist/types/cli/runtime-dependency-catalog.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Vetted runtime-dependency catalog for community skills.
+ *
+ * A skill manifest may declare `runtime: ["officecli"]` — bare ids only. The
+ * registry stays declarative: WHAT a skill needs lives in Hub data, but HOW to
+ * probe/install it lives here, reviewed in code. The installer never executes
+ * anything from registry payloads, so a compromised registry row cannot turn
+ * "install skill" into arbitrary code execution; unknown ids surface as
+ * "manual" in the handshake UI instead of running anything.
+ */
+export interface RuntimeDependencySpec {
+    id: string;
+    /** Human-facing name shown in the handshake card. */
+    label: string;
+    /** Executable probed on PATH (and `extraWindowsPaths` fallbacks). */
+    bin: string;
+    probeArgs: string[];
+    /** Known install locations not yet on PATH in this process (fresh installs). */
+    extraWindowsPaths?: string[];
+    /**
+     * quick=true → the handshake auto-installs without an extra consent step
+     * (small, single-artifact, official installer). quick=false → the client
+     * must show a consent card first (large download / system-level changes).
+     */
+    quick: boolean;
+    /** Honest size estimate surfaced in the consent card. */
+    estSizeMB: number;
+    install: Partial<Record<"win32" | "default", {
+        command: string;
+        args: string[];
+    }>>;
+    installTimeoutMs: number;
+    docsUrl?: string;
+}
+export declare const RUNTIME_DEPENDENCIES: Record<string, RuntimeDependencySpec>;
+export interface RuntimeDependencyStatus {
+    id: string;
+    /** false → not in the vetted catalog: the client can only show guidance. */
+    known: boolean;
+    label?: string;
+    present: boolean;
+    version?: string;
+    /** Absolute path when found via a known location instead of PATH. */
+    binPath?: string;
+    quick?: boolean;
+    estSizeMB?: number;
+    docsUrl?: string;
+}
+export declare function probeRuntimeDependency(id: string): Promise<RuntimeDependencyStatus>;
+export interface RuntimeInstallResult {
+    id: string;
+    ok: true;
+    version?: string;
+    binPath?: string;
+}
+export declare function installRuntimeDependency(id: string): Promise<RuntimeInstallResult>;

package/dist/types/protocol/methods.d.ts

@@ -568,6 +568,33 @@ export interface CommunityInstallResourceResult {
     preview?: CommunityInstallResourcePreview;
     signalWarning?: string;
 }
+export interface CommunityRuntimeStatusParams {
+    ids: string[];
+}
+export interface CommunityRuntimeDependencyStatus {
+    id: string;
+    known: boolean;
+    label?: string;
+    present: boolean;
+    version?: string;
+    binPath?: string;
+    quick?: boolean;
+    estSizeMB?: number;
+    docsUrl?: string;
+}
+export interface CommunityRuntimeStatusResult {
+    ok: boolean;
+    items: CommunityRuntimeDependencyStatus[];
+}
+export interface CommunityInstallRuntimeParams {
+    id: string;
+}
+export interface CommunityInstallRuntimeResult {
+    ok: boolean;
+    id: string;
+    version?: string;
+    binPath?: string;
+}
 export interface TodosListParams {
     /** Filter by status. */
     status?: "not-started" | "in-progress" | "completed" | "all";
@@ -803,6 +830,14 @@ export interface RpcMethodMap {
         params: CommunityInstallResourceParams;
         result: CommunityInstallResourceResult;
     };
+    "community.runtimeStatus": {
+        params: CommunityRuntimeStatusParams;
+        result: CommunityRuntimeStatusResult;
+    };
+    "community.installRuntime": {
+        params: CommunityInstallRuntimeParams;
+        result: CommunityInstallRuntimeResult;
+    };
     "community.publishSkill": {
         params: CommunityPublishSkillParams;
         result: CommunityPublishSkillResult;

package/dist/types/runtime/infra/acp-detector.d.ts

@@ -14,6 +14,18 @@ export declare function getCatalogEntry(id: string): AcpBackendConfig | undefine
 /** Ordered curated catalog: base ACP config merged with grid/install metadata. */
 export declare function getAgentCatalog(): AcpBackendConfig[];
 export declare function resolveWindowsCopilotLoader(): string | null;
+export declare function getNpmInstallPackageName(command: string | undefined): string | null;
+export declare function compareSemverVersions(a: string, b: string): number;
+export declare function isVersionNewer(latest: string | null | undefined, current: string | null | undefined): boolean;
+export declare function readGlobalNpmPackageVersion(packageName: string | null | undefined): string | null;
+export declare function fetchNpmLatestPackageVersion(packageName: string | null | undefined): string | null;
+export declare function resolveInstalledNpmPackageVersionFromInstall(install: AcpBackendConfig["install"] | undefined): string | null;
+export declare function getCatalogPackageVersionInfo(entry: AcpBackendConfig, detectedVersion?: string): {
+    packageName?: string;
+    installedVersion?: string;
+    latestVersion?: string;
+    updateAvailable: boolean;
+};
 export declare function normalizeWindowsAcpCommand(cliPath: string, args: string[]): {
     cliPath: string;
     acpArgs: string[];
@@ -45,6 +57,10 @@ export interface CatalogKeySources {
     llmrouterKey?: string;
     /** Base URL an llmrouter-routed agent should call (our gateway endpoint). */
     llmrouterBaseUrl?: string;
+    /** Resolve an agent/protocol-specific LLMRouter base URL. */
+    getLlmrouterBaseUrl?: (agentId: string, entry: AcpBackendConfig) => string | null | undefined;
+    /** Default LLMRouter model for agent CLIs that require an explicit model pin. */
+    llmrouterModel?: string;
     /** Resolve a provider's direct third-party key for keySource:"direct". */
     getDirectKey?: (providerId: string) => string | null | undefined;
     /** The host's active text-generation model (deepseek / volcengine / …) to "pass through" to

package/dist/types/runtime/infra/project-skill-manifest.d.ts

@@ -26,3 +26,7 @@ export declare function readProjectScopedSkills(): Set<string>;
 export declare function markProjectScoped(name: string): boolean;
 /** Unmark a skill (promote to global). Idempotent. Returns true if removed. */
 export declare function unmarkProjectScoped(name: string): boolean;
+/** Globally muted skills (inactive everywhere). */
+export declare function readGloballyDisabledSkills(): Set<string>;
+/** Mute/unmute a global skill everywhere. Idempotent. Returns true if the registry changed. */
+export declare function setSkillGloballyDisabled(name: string, disabled: boolean): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.13.2",
+  "version": "2.13.4",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",