qlogicagent 0.1.0

package/dist/skills/memory-tool.js

@@ -0,0 +1,193 @@
+// ============================================================
+// Memory Tool Contract — dual-layer agent memory system.
+//
+// Two independent layers (Hermes-inspired):
+//
+// 1. **MD Memory** (local notes, always in system prompt):
+//    Agent explicitly manages via add / replace / remove.
+//    Character-bounded, no LLM needed, zero-cost.
+//    Frozen snapshot in system prompt for KV cache stability.
+//
+// 2. **QMemory** (semantic long-term memory):
+//    Automatic extraction from every conversation turn.
+//    Agent queries via search action. Vector-based recall.
+//
+// The two layers are independent — no cross-dedup, no sync.
+// MD = curated highlights; QMemory = conversation sediment.
+// ============================================================
+// ── Constants ───────────────────────────────────────────────────
+export const MEMORY_TOOL_NAME = "memory";
+export const MEMORY_TOOL_MAX_CONTENT_LENGTH = 2000;
+export const MEMORY_TOOL_ACTIONS = ["add", "replace", "remove", "search"];
+// ── Tool schema (JSON Schema compatible) ────────────────────
+export const MEMORY_TOOL_SCHEMA = {
+    type: "object",
+    properties: {
+        action: {
+            type: "string",
+            enum: MEMORY_TOOL_ACTIONS,
+            description: [
+                "The operation to perform:",
+                "• 'add' — Save a concise note about this user (→ local notes, always visible)",
+                "• 'replace' — Update an existing note by matching a substring (→ local notes)",
+                "• 'remove' — Delete a note by matching a substring (→ local notes)",
+                "• 'search' — Semantic search across long-term memory (→ qmemory)",
+            ].join("\n"),
+        },
+        target: {
+            type: "string",
+            enum: ["memory", "user"],
+            description: [
+                "Which note target to operate on (for add/replace/remove):",
+                "• 'memory' — Your personal observations/notes about this user (default)",
+                "• 'user' — User profile facts (preferences, timezone, etc.)",
+            ].join("\n"),
+        },
+        content: {
+            type: "string",
+            description: [
+                "Required for 'add' and 'replace'. The note content to store.",
+                "Write a concise, factual statement.",
+                "Good: '用户是后端工程师，主要使用 TypeScript 和 Go'",
+                "Good: 'User prefers dark UI themes and minimalist design'",
+                "Bad: '用户说了很多话' (too vague)",
+                "Bad: entire conversation transcripts (too long)",
+            ].join("\n"),
+        },
+        old_text: {
+            type: "string",
+            description: "Required for 'replace' and 'remove'. A substring that uniquely identifies the note entry to modify.",
+        },
+        query: {
+            type: "string",
+            description: "Required for 'search'. Natural language query to find relevant memories.",
+        },
+    },
+    required: ["action"],
+};
+export const MEMORY_TOOL_DESCRIPTION = [
+    "Manage your notes about this user and search long-term memory.",
+    "",
+    "Your notes (add/replace/remove) are always visible in the system prompt.",
+    "Long-term memories are automatically extracted from every conversation",
+    "and searchable via 'search'.",
+    "",
+    "Guidelines:",
+    "- Use 'add' to record important user preferences, facts, or context",
+    "- Use 'replace' to update outdated notes (match by substring)",
+    "- Use 'remove' to delete incorrect notes (match by substring)",
+    "- Use 'search' to recall conversation history and past interactions",
+    "- Keep notes concise — there's a character limit",
+].join("\n");
+export const MEMORY_TOOL_LABEL = "Memory";
+// ── Content safety ──────────────────────────────────────────
+const BLOCKED_PATTERNS = [
+    /ignore\s+(previous|all|above|prior)\s+instructions/i,
+    /you\s+are\s+now\s+/i,
+    /do\s+not\s+tell\s+the\s+user/i,
+    /system\s+prompt\s+override/i,
+];
+export function isMemoryContentSafe(text) {
+    return !BLOCKED_PATTERNS.some((pattern) => pattern.test(text));
+}
+export async function executeMemoryTool(params, deps) {
+    const { action } = params;
+    const target = params.target ?? "memory";
+    // ── MD store operations: add / replace / remove ───────
+    if (action === "add") {
+        if (!deps.store) {
+            return { ok: false, message: "Local memory store is not available.", action, errorCode: "no_store" };
+        }
+        const content = params.content?.trim();
+        if (!content) {
+            return { ok: false, message: "content is required for 'add' action.", action, errorCode: "empty_content" };
+        }
+        if (content.length > MEMORY_TOOL_MAX_CONTENT_LENGTH) {
+            return { ok: false, message: `Content too long (${content.length} chars, max ${MEMORY_TOOL_MAX_CONTENT_LENGTH}).`, action, errorCode: "too_long" };
+        }
+        const result = deps.store.add(target, content);
+        return {
+            ok: result.ok,
+            message: result.ok
+                ? `${result.message} [${result.usage}]`
+                : result.message,
+            action,
+            entryCount: result.entryCount,
+            usage: result.usage,
+            storeModified: result.ok,
+            errorCode: result.errorCode,
+        };
+    }
+    if (action === "replace") {
+        if (!deps.store) {
+            return { ok: false, message: "Local memory store is not available.", action, errorCode: "no_store" };
+        }
+        const oldText = params.old_text?.trim();
+        const content = params.content?.trim();
+        if (!oldText) {
+            return { ok: false, message: "old_text is required for 'replace' action.", action, errorCode: "empty_old_text" };
+        }
+        if (!content) {
+            return { ok: false, message: "content is required for 'replace' action.", action, errorCode: "empty_content" };
+        }
+        if (content.length > MEMORY_TOOL_MAX_CONTENT_LENGTH) {
+            return { ok: false, message: `Content too long (${content.length} chars, max ${MEMORY_TOOL_MAX_CONTENT_LENGTH}).`, action, errorCode: "too_long" };
+        }
+        const result = deps.store.replace(target, oldText, content);
+        return {
+            ok: result.ok,
+            message: result.ok
+                ? `${result.message} [${result.usage}]`
+                : result.message,
+            action,
+            entryCount: result.entryCount,
+            usage: result.usage,
+            storeModified: result.ok,
+            errorCode: result.errorCode,
+        };
+    }
+    if (action === "remove") {
+        if (!deps.store) {
+            return { ok: false, message: "Local memory store is not available.", action, errorCode: "no_store" };
+        }
+        const oldText = params.old_text?.trim();
+        if (!oldText) {
+            return { ok: false, message: "old_text is required for 'remove' action.", action, errorCode: "empty_old_text" };
+        }
+        const result = deps.store.remove(target, oldText);
+        return {
+            ok: result.ok,
+            message: result.ok
+                ? `${result.message} [${result.usage}]`
+                : result.message,
+            action,
+            entryCount: result.entryCount,
+            usage: result.usage,
+            storeModified: result.ok,
+            errorCode: result.errorCode,
+        };
+    }
+    if (action === "search") {
+        const query = params.query?.trim();
+        if (!query) {
+            return { ok: false, message: "query is required for 'search' action.", action, errorCode: "empty_query" };
+        }
+        try {
+            const results = await deps.provider.search(query, deps.userId, { limit: 10 });
+            if (results.length === 0) {
+                return { ok: true, message: "No matching memories found.", action, results: [] };
+            }
+            return {
+                ok: true,
+                message: results.map((r, i) => `${i + 1}. [${r.blockId}] ${r.text}`).join("\n"),
+                action,
+                results,
+            };
+        }
+        catch (error) {
+            return { ok: false, message: `Search failed: ${error instanceof Error ? error.message : String(error)}`, action, errorCode: "search_failed" };
+        }
+    }
+    return { ok: false, message: `Unknown action: ${action}. Use 'add', 'replace', 'remove', or 'search'.`, action, errorCode: "unknown_action" };
+}
+//# sourceMappingURL=memory-tool.js.map

package/dist/skills/memory-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tool.js","sourceRoot":"","sources":["../../src/skills/memory-tool.ts"],"names":[],"mappings":"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"}

package/dist/skills/portable-tool.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Content block returned by tool execution.
+ * Compatible with OpenAI / Anthropic content array format.
+ */
+export interface ToolContentBlock {
+    type: "text" | "image";
+    text?: string;
+    /** base64-encoded image data (only when type === "image") */
+    data?: string;
+    mimeType?: string;
+}
+/**
+ * Result of executing a portable tool.
+ */
+export interface PortableToolResult {
+    content: ToolContentBlock[];
+    /** Arbitrary structured metadata for the calling runtime. */
+    details?: Record<string, unknown>;
+}
+/**
+ * A runtime-agnostic tool definition.
+ *
+ * @typeParam TParams The expected parameter shape (for TypeScript consumers).
+ */
+export interface PortableTool<TParams = Record<string, unknown>> {
+    /** Unique tool name (e.g. "think", "todo", "memory_query"). */
+    name: string;
+    /** Human-readable label. */
+    label: string;
+    /** Tool description shown to the LLM. */
+    description: string;
+    /** JSON Schema object describing the tool's parameters. */
+    parameters: Record<string, unknown>;
+    /**
+     * When true, the tool should NOT appear in the default tool list.
+     * The host injects it only for complex tasks (e.g. multi-step reasoning)
+     * or when explicitly activated via tool_search.
+     * This saves context tokens in simple conversations.
+     */
+    shouldDefer?: boolean;
+    /**
+     * Whether the tool can safely run concurrently with other tools.
+     * When true, the runtime may execute this tool in parallel with others.
+     * Default: false (sequential execution assumed).
+     */
+    isConcurrencySafe?: boolean;
+    /**
+     * Whether the tool only reads state and never mutates anything.
+     * Read-only tools can skip confirmation prompts in strict permission modes.
+     */
+    isReadOnly?: boolean;
+    /**
+     * Brief keyword hint for tool_search to match against
+     * (e.g. "return the final response as structured JSON").
+     */
+    searchHint?: string;
+    /**
+     * Maximum allowed content size in characters for the tool result.
+     * The runtime should truncate/reject results exceeding this.
+     */
+    maxResultSizeChars?: number;
+    /**
+     * Execute the tool.
+     *
+     * @param toolCallId - Unique ID for this tool invocation (for tracing).
+     * @param params     - Parsed parameters matching the JSON Schema.
+     * @param signal     - Optional abort signal.
+     * @returns Tool result with content blocks + optional details.
+     */
+    execute(toolCallId: string, params: TParams, signal?: AbortSignal): Promise<PortableToolResult>;
+}
+//# sourceMappingURL=portable-tool.d.ts.map

package/dist/skills/portable-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-tool.d.ts","sourceRoot":"","sources":["../../src/skills/portable-tool.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC"}

package/dist/skills/portable-tool.js

@@ -0,0 +1,15 @@
+// ============================================================
+// Portable Tool Contract — runtime-agnostic tool interface.
+//
+// This is the minimal tool definition that any agent runtime
+// (openclaw, Hub, Electron, third-party) can consume. It uses
+// plain JSON Schema objects instead of @sinclair/typebox so
+// there are zero external dependencies.
+//
+// Consumers wrap PortableTool into their own tool system:
+//   - openclaw → AgentTool<TSchema>  (via typebox adapter)
+//   - Hub      → hub-managed tool registration
+//   - Electron → desktop tool host
+// ============================================================
+export {};
+//# sourceMappingURL=portable-tool.js.map

package/dist/skills/portable-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-tool.js","sourceRoot":"","sources":["../../src/skills/portable-tool.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,4DAA4D;AAC5D,EAAE;AACF,6DAA6D;AAC7D,8DAA8D;AAC9D,4DAA4D;AAC5D,wCAAwC;AACxC,EAAE;AACF,0DAA0D;AAC1D,2DAA2D;AAC3D,+CAA+C;AAC/C,mCAAmC;AACnC,+DAA+D"}

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

@@ -0,0 +1,53 @@
+import type { MemoryIngestOptions, MemoryProvider } from "qlogicagent-runtime-contracts";
+/** 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;
+}
+/** 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.
+ *
+ * @example
+ * ```ts
+ * const provider = createQMemoryAdapter({
+ *   baseUrl: "http://localhost:18800",
+ *   apiKey: "sk-...",
+ * });
+ *
+ * const results = await provider.search("last meeting notes", "alice");
+ * await provider.ingest([{ role: "user", content: "..." }], "alice");
+ * ```
+ */
+export declare function createQMemoryAdapter(config: QMemoryAdapterConfig): MemoryProvider & {
+    /** Check qmemory server health. */
+    health(): Promise<QMemoryHealthStatus>;
+    /** Write pre-extracted memories (no LLM extraction on qmemory side). */
+    ingestExtracted(items: ExtractedMemoryItem[], userId: string, options?: MemoryIngestOptions): Promise<{
+        memoriesAdded: number;
+    }>;
+};
+//# sourceMappingURL=qmemory-adapter.d.ts.map

package/dist/skills/qmemory-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qmemory-adapter.d.ts","sourceRoot":"","sources":["../../src/skills/qmemory-adapter.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,mBAAmB,EACnB,cAAc,EAGf,MAAM,+BAA+B,CAAC;AAGvC,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,kDAAkD;AAClD,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAKD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,GAAG;IACnF,mCAAmC;IACnC,MAAM,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvC,wEAAwE;IACxE,eAAe,CACb,KAAK,EAAE,mBAAmB,EAAE,EAC5B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvC,CA6KA"}

package/dist/skills/qmemory-adapter.js

@@ -0,0 +1,166 @@
+// ============================================================
+// QMemory HTTP adapter — implements MemoryProvider against the
+// QMemory REST API (v1).
+//
+// This is a Hub-ready, provider-agnostic adapter that can be
+// plugged into any consumer of the MemoryProvider contract.
+// ============================================================
+const DEFAULT_TIMEOUT_MS = 5_000;
+const PROVIDER_ID = "qmemory";
+/**
+ * Create a MemoryProvider backed by a QMemory HTTP server.
+ *
+ * @example
+ * ```ts
+ * const provider = createQMemoryAdapter({
+ *   baseUrl: "http://localhost:18800",
+ *   apiKey: "sk-...",
+ * });
+ *
+ * const results = await provider.search("last meeting notes", "alice");
+ * await provider.ingest([{ role: "user", content: "..." }], "alice");
+ * ```
+ */
+export function createQMemoryAdapter(config) {
+    const baseUrl = config.baseUrl.replace(/\/+$/, "");
+    const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    function resolveUserId(userId) {
+        return config.userIdPrefix ? `${config.userIdPrefix}:${userId}` : userId;
+    }
+    function buildHeaders() {
+        const headers = {
+            "Accept": "application/json",
+        };
+        if (config.apiKey) {
+            headers["Authorization"] = `Bearer ${config.apiKey}`;
+        }
+        return headers;
+    }
+    async function request(pathname, init) {
+        const url = `${baseUrl}${pathname}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const response = await fetch(url, {
+                ...init,
+                headers: { ...buildHeaders(), ...init?.headers },
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const text = await response.text().catch(() => "");
+                throw new Error(`QMemory ${init?.method ?? "GET"} ${pathname} returned ${response.status}: ${text.slice(0, 200)}`);
+            }
+            return await response.json();
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    return {
+        providerId: PROVIDER_ID,
+        async search(query, userId, options) {
+            const resolvedUserId = resolveUserId(userId);
+            const limit = options?.limit ?? 10;
+            const params = new URLSearchParams({
+                q: query,
+                user_id: resolvedUserId,
+                limit: String(limit),
+            });
+            const result = await request(`/v1/memories/search/?${params.toString()}`);
+            return (result.memories ?? [])
+                .filter((m) => m.id && m.text)
+                .map((m) => ({
+                blockId: m.id,
+                text: m.text,
+                score: typeof m.importance === "number" ? m.importance : 0,
+                source: PROVIDER_ID,
+                metadata: m.metadata,
+            }));
+        },
+        async ingest(messages, userId, options) {
+            const resolvedUserId = resolveUserId(userId);
+            await request("/v1/memories/", {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    user_id: resolvedUserId,
+                    messages: messages.map((m) => ({
+                        role: m.role,
+                        content: m.content,
+                        ...(m.timestamp ? { timestamp: m.timestamp } : {}),
+                    })), extraction_mode: "none", ...(options?.sessionId ? { session_id: options.sessionId } : {}),
+                    ...(options?.source ? { metadata: { source: options.source } } : {}),
+                    run_async: true,
+                }),
+            });
+        },
+        async health() {
+            const raw = await request("/v1/health/");
+            return {
+                status: raw.status ?? "unknown",
+                version: raw.version ?? "",
+                memoryCount: raw.memory_count ?? 0,
+                dbSizeBytes: raw.db_size_bytes ?? 0,
+                embeddingModel: raw.embedding_model ?? "",
+                uptimeSeconds: raw.uptime_seconds ?? 0,
+            };
+        },
+        async addText(text, userId, options) {
+            const resolvedUserId = resolveUserId(userId);
+            const result = await request("/v1/memories/", {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    user_id: resolvedUserId,
+                    text,
+                    extraction_mode: "none",
+                    ...(options?.sessionId ? { session_id: options.sessionId } : {}),
+                    ...(options?.source ? { metadata: { source: options.source } } : {}),
+                }),
+            });
+            return { memoriesAdded: result.memories_added ?? 0 };
+        },
+        async ingestExtracted(items, userId, options) {
+            if (items.length === 0)
+                return { memoriesAdded: 0 };
+            const resolvedUserId = resolveUserId(userId);
+            const results = await Promise.allSettled(items.map((item) => request("/v1/memories/", {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    user_id: resolvedUserId,
+                    text: item.text,
+                    extraction_mode: "none",
+                    ...(options?.sessionId ? { session_id: options.sessionId } : {}),
+                    metadata: {
+                        ...(options?.source ? { source: options.source } : {}),
+                        ...(item.category ? { category: item.category } : {}),
+                        ...(typeof item.importance === "number" ? { importance: item.importance } : {}),
+                        ...(item.speaker ? { speaker: item.speaker } : {}),
+                        ...(item.event_date ? { event_date: item.event_date } : {}),
+                        ...(item.tags?.length ? { tags: item.tags } : {}),
+                    },
+                }),
+            })));
+            let total = 0;
+            for (const r of results) {
+                if (r.status === "fulfilled") {
+                    total += r.value.memories_added ?? 1;
+                }
+            }
+            return { memoriesAdded: total };
+        },
+        async remove(memoryId) {
+            try {
+                await request(`/v1/memories/${encodeURIComponent(memoryId)}/`, {
+                    method: "DELETE",
+                });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+    };
+}
+//# sourceMappingURL=qmemory-adapter.js.map

package/dist/skills/qmemory-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qmemory-adapter.js","sourceRoot":"","sources":["../../src/skills/qmemory-adapter.ts"],"names":[],"mappings":"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"}

package/dist/skills/skill-frontmatter.d.ts

@@ -0,0 +1,20 @@
+import type { ParsedSkillFrontmatter, SkillInvocationPolicy, SkillMetadata } from "./skill-types.js";
+/**
+ * Parse a YAML-like frontmatter block into a flat key→value record.
+ * Uses a lightweight line parser to avoid a YAML library dependency.
+ */
+export declare function parseFrontmatter(content: string): ParsedSkillFrontmatter;
+/**
+ * Resolve structured metadata from the `metadata:` frontmatter field.
+ * Expects `metadata: {"openclaw": {...}}` (JSON format).
+ */
+export declare function resolveSkillMetadata(frontmatter: ParsedSkillFrontmatter): SkillMetadata | undefined;
+/**
+ * Resolve invocation policy from frontmatter fields.
+ */
+export declare function resolveSkillInvocationPolicy(frontmatter: ParsedSkillFrontmatter): SkillInvocationPolicy;
+/**
+ * Get the canonical key for a skill (metadata.skillKey or skill.name).
+ */
+export declare function resolveSkillKey(skillName: string, metadata?: SkillMetadata): string;
+//# sourceMappingURL=skill-frontmatter.d.ts.map

package/dist/skills/skill-frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-frontmatter.d.ts","sourceRoot":"","sources":["../../src/skills/skill-frontmatter.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,sBAAsB,EAEtB,qBAAqB,EACrB,aAAa,EACd,MAAM,kBAAkB,CAAC;AAiD1B;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,CA8CxE;AAuLD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,sBAAsB,GAClC,aAAa,GAAG,SAAS,CAyC3B;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,sBAAsB,GAClC,qBAAqB,CAKvB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,aAAa,GACvB,MAAM,CAER"}