qlogicagent 0.1.0

package/dist/skills/memory-query-tool.d.ts

@@ -0,0 +1,44 @@
+import type { PortableTool } from "./portable-tool.js";
+export declare const MEMORY_QUERY_TOOL_NAME: "memory_query";
+export declare const MEMORY_QUERY_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly query: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly category: {
+            readonly type: "string";
+            readonly description: string;
+        };
+    };
+    readonly required: readonly ["query"];
+};
+export interface MediaPreferencesSummary {
+    imageStyle?: string;
+    videoStyle?: string;
+    musicGenre?: string;
+    musicMood?: string;
+    primaryPurpose?: string;
+    colorPreference?: string;
+}
+/**
+ * Dependency-injected callbacks for memory query.
+ * Consumers provide these from their own memory system.
+ */
+export interface MemoryQueryToolDeps {
+    /** Query recalled facts/memories by natural language. */
+    queryGraph?: (query: string, userId: string) => string[];
+    /** Retrieve user profile summary. */
+    getProfileSummary?: (userId: string) => string | null;
+    /** Retrieve media preferences. */
+    getMediaPreferences?: (userId: string) => MediaPreferencesSummary | null;
+    /** User ID for this session. */
+    userId?: string;
+}
+export interface MemoryQueryToolParams {
+    query: string;
+    category?: string;
+}
+export declare function createMemoryQueryTool(deps?: MemoryQueryToolDeps): PortableTool<MemoryQueryToolParams>;
+//# sourceMappingURL=memory-query-tool.d.ts.map

package/dist/skills/memory-query-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-query-tool.d.ts","sourceRoot":"","sources":["../../src/skills/memory-query-tool.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,oBAAoB,CAAC;AAE3E,eAAO,MAAM,sBAAsB,EAAG,cAAuB,CAAC;AAI9D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;CA4B3B,CAAC;AAIX,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACzD,qCAAqC;IACrC,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACtD,kCAAkC;IAClC,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,uBAAuB,GAAG,IAAI,CAAC;IACzE,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAqFrG"}

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

@@ -0,0 +1,128 @@
+// ============================================================
+// Memory Query Tool — explicit agent-initiated memory recall.
+//
+// Allows the LLM to actively query recalled memories and user
+// profile when it determines that the current context is
+// insufficient for a good response.
+// ============================================================
+export const MEMORY_QUERY_TOOL_NAME = "memory_query";
+// ── Schema ──────────────────────────────────────────────────
+export const MEMORY_QUERY_TOOL_SCHEMA = {
+    type: "object",
+    properties: {
+        query: {
+            type: "string",
+            description: [
+                "The memory query — a natural language description of what you want to recall.",
+                "Examples:",
+                "• '用户的编程语言偏好' → searches tech preferences",
+                "• '用户之前提到的项目' → searches project history",
+                "• '上次画图的风格' → searches media generation history",
+                "• 'user's name and location' → searches personal facts",
+                "Be specific: '用户喜欢什么图片风格' is better than '用户偏好'.",
+            ].join("\n"),
+        },
+        category: {
+            type: "string",
+            description: [
+                "Optional: narrow the search to a specific category.",
+                "• 'profile' — user preferences, expertise, communication style",
+                "• 'facts' — recalled long-term memories",
+                "• 'media' — media generation preferences (image style, music genre, etc.)",
+                "• 'projects' — project context and tech stack",
+                "If omitted, searches across all categories.",
+            ].join("\n"),
+        },
+    },
+    required: ["query"],
+};
+// ── Tool factory ────────────────────────────────────────────
+export function createMemoryQueryTool(deps) {
+    return {
+        name: MEMORY_QUERY_TOOL_NAME,
+        label: "Memory Query",
+        description: [
+            "Query your memory about this user to recall facts, preferences, or history.",
+            "Use this when you need information that might have been shared in previous conversations.",
+            "",
+            "Call this tool when:",
+            "- You want to personalize a response based on user preferences",
+            "- You recall the user mentioned something relevant but it's not in the current context",
+            "- You need to check media preferences before generating images/music/video",
+            "- You want to reference the user's project context or tech stack",
+            "",
+            "This tool searches recalled memories and the user profile.",
+            "It does NOT search the current conversation — that's already in your context.",
+            "Results may be empty if no relevant memories exist.",
+        ].join("\n"),
+        parameters: MEMORY_QUERY_TOOL_SCHEMA,
+        execute: async (_toolCallId, params) => {
+            const query = params.query?.trim();
+            if (!query) {
+                return {
+                    content: [{ type: "text", text: "query parameter is required." }],
+                    details: { type: "memory_query", found: false, errorCode: "empty_query" },
+                };
+            }
+            const category = params.category?.trim() || undefined;
+            const userId = deps?.userId ?? "user";
+            const sections = [];
+            // 1. Memory recall search
+            if (!category || category === "facts" || category === "projects") {
+                try {
+                    const facts = deps?.queryGraph?.(query, userId) ?? [];
+                    if (facts.length > 0) {
+                        sections.push("## Recalled Memories\n" + facts.map((f) => `• ${f}`).join("\n"));
+                    }
+                }
+                catch { /* degrade gracefully */ }
+            }
+            // 2. User Profile summary
+            if (!category || category === "profile" || category === "projects") {
+                try {
+                    const profileText = deps?.getProfileSummary?.(userId) ?? null;
+                    if (profileText) {
+                        sections.push("## User Profile\n" + profileText);
+                    }
+                }
+                catch { /* degrade gracefully */ }
+            }
+            // 3. Media Preferences
+            if (!category || category === "media") {
+                try {
+                    const mediaPrefs = deps?.getMediaPreferences?.(userId) ?? null;
+                    if (mediaPrefs) {
+                        const lines = [];
+                        if (mediaPrefs.imageStyle)
+                            lines.push(`• Image style: ${mediaPrefs.imageStyle}`);
+                        if (mediaPrefs.videoStyle)
+                            lines.push(`• Video style: ${mediaPrefs.videoStyle}`);
+                        if (mediaPrefs.musicGenre)
+                            lines.push(`• Music genre: ${mediaPrefs.musicGenre}`);
+                        if (mediaPrefs.musicMood)
+                            lines.push(`• Music mood: ${mediaPrefs.musicMood}`);
+                        if (mediaPrefs.primaryPurpose)
+                            lines.push(`• Primary purpose: ${mediaPrefs.primaryPurpose}`);
+                        if (mediaPrefs.colorPreference)
+                            lines.push(`• Color preference: ${mediaPrefs.colorPreference}`);
+                        if (lines.length > 0) {
+                            sections.push("## Media Preferences\n" + lines.join("\n"));
+                        }
+                    }
+                }
+                catch { /* degrade gracefully */ }
+            }
+            if (sections.length === 0) {
+                return {
+                    content: [{ type: "text", text: "No relevant memories found for this query. The user may not have shared this information yet." }],
+                    details: { type: "memory_query", found: false, query },
+                };
+            }
+            return {
+                content: [{ type: "text", text: sections.join("\n\n") }],
+                details: { type: "memory_query", found: true, query, category: category ?? "all", sectionCount: sections.length },
+            };
+        },
+    };
+}
+//# sourceMappingURL=memory-query-tool.js.map

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

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

package/dist/skills/memory-store.d.ts

@@ -0,0 +1,67 @@
+export declare const MEMORY_ENTRY_DELIMITER = "\n\u00A7\n";
+export declare const DEFAULT_MEMORY_CHAR_LIMIT = 2200;
+export declare const DEFAULT_USER_CHAR_LIMIT = 1375;
+export type MemoryStoreTarget = "memory" | "user";
+export interface MemoryStoreResult {
+    ok: boolean;
+    message: string;
+    target: MemoryStoreTarget;
+    entries: readonly string[];
+    entryCount: number;
+    usage: string;
+    errorCode?: string;
+}
+export interface MemoryStoreOptions {
+    memoryCharLimit?: number;
+    userCharLimit?: number;
+}
+export interface MemoryStoreSerialized {
+    memory: string;
+    user: string;
+}
+export declare class MemoryStore {
+    private memoryEntries;
+    private userEntries;
+    private frozenSnapshot;
+    private snapshotFrozen;
+    private readonly memoryCharLimit;
+    private readonly userCharLimit;
+    constructor(options?: MemoryStoreOptions);
+    /**
+     * Load from serialized form (e.g. from PG or filesystem).
+     * Deduplicates entries on load.
+     */
+    loadFromSerialized(data: Partial<MemoryStoreSerialized>): void;
+    /**
+     * Serialize current live state for persistence.
+     */
+    serialize(): MemoryStoreSerialized;
+    /**
+     * Freeze current entries for system prompt injection.
+     * Call once at session start. After freezing, mutations update
+     * live state but NOT the system prompt block.
+     */
+    freezeSnapshot(): void;
+    /**
+     * Get frozen system prompt block for the given target.
+     * Returns empty string if no entries or not yet frozen.
+     */
+    getSystemPromptBlock(target: MemoryStoreTarget): string;
+    add(target: MemoryStoreTarget, content: string): MemoryStoreResult;
+    replace(target: MemoryStoreTarget, oldText: string, newContent: string): MemoryStoreResult;
+    remove(target: MemoryStoreTarget, oldText: string): MemoryStoreResult;
+    getEntries(target: MemoryStoreTarget): readonly string[];
+    getUsage(target: MemoryStoreTarget): {
+        used: number;
+        limit: number;
+        percent: number;
+    };
+    isEmpty(): boolean;
+    private entriesFor;
+    private charLimitFor;
+    private formatUsage;
+    private renderBlock;
+    private successResult;
+    private errorResult;
+}
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/skills/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/skills/memory-store.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,sBAAsB,eAAU,CAAC;AAC9C,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAC9C,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAIlD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,cAAc,CAA8D;IACpF,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,OAAO,CAAC,EAAE,kBAAkB;IAOxC;;;OAGG;IACH,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;IAK9D;;OAEG;IACH,SAAS,IAAI,qBAAqB;IASlC;;;;OAIG;IACH,cAAc,IAAI,IAAI;IAQtB;;;OAGG;IACH,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;IAUvD,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB;IA4BlE,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB;IAiD1F,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB;IA4BrE,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,MAAM,EAAE;IAIxD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAOrF,OAAO,IAAI,OAAO;IAMlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,WAAW;CAYpB"}

package/dist/skills/memory-store.js

@@ -0,0 +1,229 @@
+// ============================================================
+// Memory Store — character-bounded local memory for agent notes.
+//
+// Inspired by Hermes' MemoryStore design:
+// - Two targets: "memory" (agent notes) + "user" (user profile)
+// - § delimiter between entries
+// - Frozen snapshot for system prompt (KV cache stability)
+// - Exact duplicate rejection
+// - Content safety scanning
+// - Pure in-memory; persistence is the consumer's responsibility.
+// ============================================================
+import { isMemoryContentSafe } from "./memory-tool.js";
+// ── Constants ───────────────────────────────────────────────
+export const MEMORY_ENTRY_DELIMITER = "\n§\n";
+export const DEFAULT_MEMORY_CHAR_LIMIT = 2200;
+export const DEFAULT_USER_CHAR_LIMIT = 1375;
+// ── MemoryStore class ───────────────────────────────────────
+export class MemoryStore {
+    memoryEntries = [];
+    userEntries = [];
+    frozenSnapshot = { memory: "", user: "" };
+    snapshotFrozen = false;
+    memoryCharLimit;
+    userCharLimit;
+    constructor(options) {
+        this.memoryCharLimit = options?.memoryCharLimit ?? DEFAULT_MEMORY_CHAR_LIMIT;
+        this.userCharLimit = options?.userCharLimit ?? DEFAULT_USER_CHAR_LIMIT;
+    }
+    // ── Load / Serialize ────────────────────────────────────
+    /**
+     * Load from serialized form (e.g. from PG or filesystem).
+     * Deduplicates entries on load.
+     */
+    loadFromSerialized(data) {
+        this.memoryEntries = deduplicateEntries(parseEntries(data.memory ?? ""));
+        this.userEntries = deduplicateEntries(parseEntries(data.user ?? ""));
+    }
+    /**
+     * Serialize current live state for persistence.
+     */
+    serialize() {
+        return {
+            memory: this.memoryEntries.join(MEMORY_ENTRY_DELIMITER),
+            user: this.userEntries.join(MEMORY_ENTRY_DELIMITER),
+        };
+    }
+    // ── Snapshot (frozen for system prompt) ─────────────────
+    /**
+     * Freeze current entries for system prompt injection.
+     * Call once at session start. After freezing, mutations update
+     * live state but NOT the system prompt block.
+     */
+    freezeSnapshot() {
+        this.frozenSnapshot = {
+            memory: this.renderBlock("memory", this.memoryEntries),
+            user: this.renderBlock("user", this.userEntries),
+        };
+        this.snapshotFrozen = true;
+    }
+    /**
+     * Get frozen system prompt block for the given target.
+     * Returns empty string if no entries or not yet frozen.
+     */
+    getSystemPromptBlock(target) {
+        if (!this.snapshotFrozen) {
+            // Auto-freeze on first access
+            this.freezeSnapshot();
+        }
+        return this.frozenSnapshot[target];
+    }
+    // ── Mutations ───────────────────────────────────────────
+    add(target, content) {
+        const trimmed = content.trim();
+        if (!trimmed) {
+            return this.errorResult(target, "Content cannot be empty.", "empty_content");
+        }
+        if (!isMemoryContentSafe(trimmed)) {
+            return this.errorResult(target, "Content rejected: potential injection detected.", "unsafe_content");
+        }
+        const entries = this.entriesFor(target);
+        // Exact duplicate check
+        if (entries.includes(trimmed)) {
+            return this.successResult(target, "Entry already exists (no change).");
+        }
+        // Character budget check
+        const newEntries = [...entries, trimmed];
+        const newTotal = newEntries.join(MEMORY_ENTRY_DELIMITER).length;
+        if (newTotal > this.charLimitFor(target)) {
+            const usage = this.formatUsage(target);
+            return this.errorResult(target, `Memory full (${usage}). Remove old entries first.`, "over_limit");
+        }
+        entries.push(trimmed);
+        return this.successResult(target, "Entry added.");
+    }
+    replace(target, oldText, newContent) {
+        const searchText = oldText.trim();
+        const replacement = newContent.trim();
+        if (!searchText) {
+            return this.errorResult(target, "old_text cannot be empty.", "empty_old_text");
+        }
+        if (!replacement) {
+            return this.errorResult(target, "content cannot be empty.", "empty_content");
+        }
+        if (!isMemoryContentSafe(replacement)) {
+            return this.errorResult(target, "Content rejected: potential injection detected.", "unsafe_content");
+        }
+        const entries = this.entriesFor(target);
+        const matchIndices = entries
+            .map((entry, i) => entry.includes(searchText) ? i : -1)
+            .filter((i) => i >= 0);
+        if (matchIndices.length === 0) {
+            return this.errorResult(target, `No entry contains: "${clipForMessage(searchText)}"`, "not_found");
+        }
+        if (matchIndices.length > 1) {
+            // Check if all matches are identical (harmless duplicate)
+            const unique = new Set(matchIndices.map((i) => entries[i]));
+            if (unique.size > 1) {
+                return this.errorResult(target, `Multiple entries match: "${clipForMessage(searchText)}" (${matchIndices.length} matches). Be more specific.`, "ambiguous_match");
+            }
+        }
+        // Replace first match
+        const matchIndex = matchIndices[0];
+        // Check char limit with replacement
+        const projected = [...entries];
+        projected[matchIndex] = replacement;
+        const projectedTotal = projected.join(MEMORY_ENTRY_DELIMITER).length;
+        if (projectedTotal > this.charLimitFor(target)) {
+            const usage = this.formatUsage(target);
+            return this.errorResult(target, `Replacement would exceed limit (${usage}).`, "over_limit");
+        }
+        entries[matchIndex] = replacement;
+        return this.successResult(target, "Entry replaced.");
+    }
+    remove(target, oldText) {
+        const searchText = oldText.trim();
+        if (!searchText) {
+            return this.errorResult(target, "old_text cannot be empty.", "empty_old_text");
+        }
+        const entries = this.entriesFor(target);
+        const matchIndices = entries
+            .map((entry, i) => entry.includes(searchText) ? i : -1)
+            .filter((i) => i >= 0);
+        if (matchIndices.length === 0) {
+            return this.errorResult(target, `No entry contains: "${clipForMessage(searchText)}"`, "not_found");
+        }
+        // Remove all matches (safe: if they all contain the substring, remove them all)
+        for (let i = matchIndices.length - 1; i >= 0; i--) {
+            entries.splice(matchIndices[i], 1);
+        }
+        return this.successResult(target, matchIndices.length === 1 ? "Entry removed." : `${matchIndices.length} entries removed.`);
+    }
+    // ── Read-only accessors ─────────────────────────────────
+    getEntries(target) {
+        return this.entriesFor(target);
+    }
+    getUsage(target) {
+        const entries = this.entriesFor(target);
+        const used = entries.length > 0 ? entries.join(MEMORY_ENTRY_DELIMITER).length : 0;
+        const limit = this.charLimitFor(target);
+        return { used, limit, percent: limit > 0 ? Math.round((used / limit) * 100) : 0 };
+    }
+    isEmpty() {
+        return this.memoryEntries.length === 0 && this.userEntries.length === 0;
+    }
+    // ── Private helpers ─────────────────────────────────────
+    entriesFor(target) {
+        return target === "user" ? this.userEntries : this.memoryEntries;
+    }
+    charLimitFor(target) {
+        return target === "user" ? this.userCharLimit : this.memoryCharLimit;
+    }
+    formatUsage(target) {
+        const { used, limit, percent } = this.getUsage(target);
+        return `${percent}% — ${used}/${limit} chars`;
+    }
+    renderBlock(target, entries) {
+        if (entries.length === 0)
+            return "";
+        const label = target === "user" ? "USER PROFILE" : "MEMORY";
+        const usage = this.formatUsage(target);
+        const divider = "══════════════════════════════════════════════════════════";
+        const body = entries.join(MEMORY_ENTRY_DELIMITER);
+        return `${divider}\n${label} (your personal notes) [${usage}]\n${divider}\n${body}`;
+    }
+    successResult(target, message) {
+        const entries = this.entriesFor(target);
+        return {
+            ok: true,
+            message,
+            target,
+            entries,
+            entryCount: entries.length,
+            usage: this.formatUsage(target),
+        };
+    }
+    errorResult(target, message, errorCode) {
+        const entries = this.entriesFor(target);
+        return {
+            ok: false,
+            message,
+            target,
+            entries,
+            entryCount: entries.length,
+            usage: this.formatUsage(target),
+            errorCode,
+        };
+    }
+}
+// ── Utilities ─────────────────────────────────────────────
+function parseEntries(raw) {
+    if (!raw.trim())
+        return [];
+    return raw.split(MEMORY_ENTRY_DELIMITER).map((e) => e.trim()).filter(Boolean);
+}
+function deduplicateEntries(entries) {
+    const seen = new Set();
+    return entries.filter((entry) => {
+        if (seen.has(entry))
+            return false;
+        seen.add(entry);
+        return true;
+    });
+}
+function clipForMessage(text, maxLength = 60) {
+    if (text.length <= maxLength)
+        return text;
+    return `${text.slice(0, maxLength - 1).trimEnd()}…`;
+}
+//# sourceMappingURL=memory-store.js.map

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

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

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

@@ -0,0 +1,68 @@
+import type { MemoryProvider, MemorySearchResult } from "qlogicagent-runtime-contracts";
+import type { MemoryStore, MemoryStoreTarget } from "./memory-store.js";
+export declare const MEMORY_TOOL_NAME: "memory";
+export declare const MEMORY_TOOL_MAX_CONTENT_LENGTH = 2000;
+export declare const MEMORY_TOOL_ACTIONS: readonly ["add", "replace", "remove", "search"];
+export type MemoryToolAction = (typeof MEMORY_TOOL_ACTIONS)[number];
+export declare const MEMORY_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly action: {
+            readonly type: "string";
+            readonly enum: string[];
+            readonly description: string;
+        };
+        readonly target: {
+            readonly type: "string";
+            readonly enum: readonly ["memory", "user"];
+            readonly description: string;
+        };
+        readonly content: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly old_text: {
+            readonly type: "string";
+            readonly description: "Required for 'replace' and 'remove'. A substring that uniquely identifies the note entry to modify.";
+        };
+        readonly query: {
+            readonly type: "string";
+            readonly description: "Required for 'search'. Natural language query to find relevant memories.";
+        };
+    };
+    readonly required: readonly ["action"];
+};
+export declare const MEMORY_TOOL_DESCRIPTION: string;
+export declare const MEMORY_TOOL_LABEL = "Memory";
+export declare function isMemoryContentSafe(text: string): boolean;
+export interface MemoryToolParams {
+    action: MemoryToolAction;
+    target?: MemoryStoreTarget;
+    content?: string;
+    old_text?: string;
+    query?: string;
+}
+export interface MemoryToolResult {
+    ok: boolean;
+    message: string;
+    action: string;
+    /** For MD store operations: live entry count */
+    entryCount?: number;
+    /** For MD store operations: usage string */
+    usage?: string;
+    /** For search: qmemory results */
+    results?: MemorySearchResult[];
+    /** Indicates MD store was mutated (consumer should persist) */
+    storeModified?: boolean;
+    errorCode?: string;
+}
+export interface MemoryToolExecutorDeps {
+    /** QMemory provider for semantic search. */
+    provider: MemoryProvider;
+    /** Local MD memory store for notes. */
+    store?: MemoryStore;
+    userId: string;
+    sessionId?: string;
+}
+export declare function executeMemoryTool(params: MemoryToolParams, deps: MemoryToolExecutorDeps): Promise<MemoryToolResult>;
+//# sourceMappingURL=memory-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tool.d.ts","sourceRoot":"","sources":["../../src/skills/memory-tool.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxF,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAIxE,eAAO,MAAM,gBAAgB,EAAG,QAAiB,CAAC;AAClD,eAAO,MAAM,8BAA8B,OAAO,CAAC;AAEnD,eAAO,MAAM,mBAAmB,iDAAkD,CAAC;AACnF,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIpE,eAAO,MAAM,kBAAkB;;;;;2BAKe,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;CAuC5C,CAAC;AAEX,eAAO,MAAM,uBAAuB,QAaxB,CAAC;AAEb,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAW1C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAID,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,+DAA+D;IAC/D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,QAAQ,EAAE,cAAc,CAAC;IACzB,uCAAuC;IACvC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAyG3B"}