qlogicagent 2.6.1 → 2.7.0

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

@@ -0,0 +1,81 @@
+export type SkillLifecycleState = "active" | "stale" | "archived";
+export interface SkillLifecycleRecord {
+    name: string;
+    state: SkillLifecycleState;
+    createdAt: string;
+    lastUsedAt?: string;
+    lastViewedAt?: string;
+    lastPatchedAt?: string;
+    staleAt?: string;
+    archivedAt?: string;
+    pinned: boolean;
+    useCount: number;
+    source: "learned" | "created" | "installed" | "promoted";
+}
+export interface SkillLifecycleStore {
+    version: 1;
+    records: Record<string, SkillLifecycleRecord>;
+}
+export interface CuratorResult {
+    transitioned: Array<{
+        name: string;
+        from: SkillLifecycleState;
+        to: SkillLifecycleState;
+    }>;
+    skippedPinned: string[];
+}
+export declare function loadLifecycleStore(agentHome: string): SkillLifecycleStore;
+export declare function saveLifecycleStore(agentHome: string, store: SkillLifecycleStore): void;
+/**
+ * Ensure a lifecycle record exists for a skill. Creates one if missing.
+ */
+export declare function ensureRecord(store: SkillLifecycleStore, name: string, source?: SkillLifecycleRecord["source"]): SkillLifecycleRecord;
+/**
+ * Record a skill invocation — resets to active if stale.
+ */
+export declare function recordInvocation(store: SkillLifecycleStore, name: string): void;
+/**
+ * Record that a skill was viewed/listed.
+ */
+export declare function recordView(store: SkillLifecycleStore, name: string): void;
+/**
+ * Record that a skill was edited/patched.
+ */
+export declare function recordPatch(store: SkillLifecycleStore, name: string): void;
+export declare function pinSkill(store: SkillLifecycleStore, name: string): boolean;
+export declare function unpinSkill(store: SkillLifecycleStore, name: string): boolean;
+export declare function isPinned(store: SkillLifecycleStore, name: string): boolean;
+/**
+ * Run curator evaluation on all skills. Transitions states based on inactivity.
+ * Pinned skills are never transitioned.
+ *
+ * Call this on agent idle, periodic timer, or explicit RPC.
+ */
+export declare function runCurator(store: SkillLifecycleStore): CuratorResult;
+/**
+ * Archive a skill on disk: move its directory to `.archive/` subfolder.
+ * Returns true if archival succeeded.
+ */
+export declare function archiveSkillOnDisk(skillsDir: string, skillName: string): boolean;
+/**
+ * Unarchive a skill: move from `.archive/` back to main skills dir.
+ * Resets state to active.
+ */
+export declare function unarchiveSkillOnDisk(skillsDir: string, skillName: string): boolean;
+/**
+ * Execute full curator cycle: evaluate state transitions + archive on disk.
+ * Returns curator result with all transitions made.
+ */
+export declare function executeCuratorCycle(agentHome: string, skillsDir: string): CuratorResult;
+/**
+ * Get all skills in a given state.
+ */
+export declare function getSkillsByState(store: SkillLifecycleStore, state: SkillLifecycleState): SkillLifecycleRecord[];
+/**
+ * Get lifecycle record for a skill. Returns undefined if not tracked.
+ */
+export declare function getLifecycleRecord(store: SkillLifecycleStore, name: string): SkillLifecycleRecord | undefined;
+/**
+ * Remove a lifecycle record (e.g., when skill is deleted).
+ */
+export declare function removeRecord(store: SkillLifecycleStore, name: string): void;

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

@@ -0,0 +1,29 @@
+export interface FrontmatterValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    /** Parsed frontmatter if valid. */
+    parsed?: Record<string, string>;
+}
+/**
+ * Validate SKILL.md content for required frontmatter structure.
+ * Used before persisting agent-created skills.
+ */
+export declare function validateSkillContent(content: string, expectedName?: string): FrontmatterValidationResult;
+/**
+ * Generate valid SKILL.md content with proper frontmatter from minimal inputs.
+ * Used when auto-persisting skills from skill_instruction events.
+ */
+export declare function generateSkillContent(params: {
+    name: string;
+    description: string;
+    tools?: string[];
+    body: string;
+    version?: string;
+    category?: string;
+}): string;
+/**
+ * Auto-fix common frontmatter issues in LLM-generated skill content.
+ * Returns fixed content or null if unfixable.
+ */
+export declare function autoFixFrontmatter(content: string, name: string, description?: string): string | null;

package/dist/types/skills/tools/exec-tool.d.ts

@@ -14,7 +14,7 @@ export declare const EXEC_TOOL_SCHEMA: {
     readonly properties: {
         readonly command: {
             readonly type: "string";
-            readonly description: "Shell command to execute. On Windows uses PowerShell, on Unix uses bash.";
+            readonly description: "Shell command to execute in PowerShell." | "Shell command to execute in bash. Use Unix-style commands (ls, cat, mkdir -p, etc.).";
         };
         readonly description: {
             readonly type: "string";

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

@@ -60,7 +60,12 @@ export interface AcpRequestHandler {
     handleAcpSoloSelect(params: Record<string, unknown>): Promise<unknown>;
     handleAcpSoloCancel(params: Record<string, unknown>): Promise<unknown>;
     handleAcpSoloSubscribe(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpSoloMessage(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpSoloEvaluate(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductCreate(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpProductPlan(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpProductConfirm(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpProductMessage(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>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.6.1",
+  "version": "2.7.0",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -34,10 +34,18 @@
   ],
   "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"]
+      "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": {
@@ -54,12 +62,17 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
+    "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",
     "nanoid": "^5.1.5",
     "pino": "^9.6.0",
     "pino-pretty": "^13.0.0"
   },
+  "optionalDependencies": {
+    "@xenova/transformers": "^2.17.2"
+  },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.15.0",
     "esbuild": "^0.28.0",
     "tsx": "^4.19.0",

package/dist/types/skills/memory/qmemory-adapter.d.ts

@@ -1,55 +0,0 @@
-import type { MemoryIngestOptions, MemoryProvider } from "../../protocol/wire/index.js";
-/** A pre-extracted memory item ready to be stored (no LLM needed). */
-export interface ExtractedMemoryItem {
-    text: string;
-    category?: string;
-    importance?: number;
-    speaker?: string;
-    event_date?: string;
-    tags?: string[];
-}
-/** Configuration for the QMemory HTTP adapter. */
-export interface QMemoryAdapterConfig {
-    /** Base URL of the qmemory server (e.g. "http://localhost:18800"). */
-    baseUrl: string;
-    /** Optional API key for authentication. */
-    apiKey?: string;
-    /** Request timeout in milliseconds (default: 5000). */
-    timeoutMs?: number;
-    /** Prefix prepended to userId for multi-tenant isolation. */
-    userIdPrefix?: string;
-}
-/** Options for triggering a decay cycle. */
-export interface DecayOptions {
-    temporalExpiry?: boolean;
-    stalenessDecay?: boolean;
-    noiseArchival?: boolean;
-}
-/** Result of a decay cycle. */
-export interface DecayResult {
-    decayed: number;
-    archived: number;
-}
-/** Health status returned by qmemory `/v1/health/`. */
-export interface QMemoryHealthStatus {
-    status: string;
-    version: string;
-    memoryCount: number;
-    dbSizeBytes: number;
-    embeddingModel: string;
-    uptimeSeconds: number;
-}
-/**
- * Create a MemoryProvider backed by a QMemory HTTP server.
- *
- * Uses inlined QMemoryHttpClient for HTTP transport (zero external deps).
- */
-export declare function createQMemoryAdapter(config: QMemoryAdapterConfig): MemoryProvider & {
-    health(): Promise<QMemoryHealthStatus>;
-    remove(memoryId: string): Promise<boolean>;
-    ingestExtracted(items: ExtractedMemoryItem[], userId: string, options?: MemoryIngestOptions): Promise<{
-        memoriesAdded: number;
-    }>;
-    feedback(memoryIds: string[], signal: string, sessionId?: string): Promise<void>;
-    triggerDecay(userId: string, options?: DecayOptions): Promise<DecayResult>;
-};

package/dist/types/skills/memory/qmemory-http-client.d.ts

@@ -1,16 +0,0 @@
-export interface QMemoryClientConfig {
-    baseUrl: string;
-    apiKey?: string;
-    timeout?: number;
-}
-/**
- * Lightweight HTTP client for QMemory API.
- * Maps RPC method names to REST endpoints using native fetch.
- */
-export declare class QMemoryHttpClient {
-    private readonly baseUrl;
-    private readonly apiKey?;
-    private readonly timeout;
-    constructor(config: QMemoryClientConfig);
-    dispatch(rpc: string, params?: Record<string, any>): Promise<any>;
-}