hoomanjs 1.28.1 → 1.28.3

package/dist/core/memory/wiki/store.d.ts

@@ -0,0 +1,37 @@
+import { type QMDStore } from "@tobilu/qmd";
+import { type Config } from "../../config.js";
+import type { PageRecord } from "./types.js";
+export declare const PAGES_DIR = "pages";
+export declare const INDEX_FILE = "index.md";
+export declare const LOG_FILE = "log.md";
+export declare const SCHEMA_FILE = "schema.md";
+export declare const DEFAULT_SEARCH_LIMIT = 5;
+export declare const MAX_SEARCH_LIMIT = 20;
+/** QMD collection name for wiki pages (fixed; not user-configurable). */
+export declare const QMD_COLLECTION = "wiki";
+export declare class WikiStore {
+    readonly root: string;
+    private static readonly instances;
+    private qmdStorePromise;
+    private constructor();
+    /**
+     * Shared instance per wiki root so warmup and tools reuse the same QMD store promise.
+     */
+    static forConfig(config: Config): WikiStore;
+    pageRelativePath(inputPath: string): string;
+    resolveWithin(relativePath: string): string;
+    pathExists(filePath: string): Promise<boolean>;
+    ensureLayout(): Promise<void>;
+    readPage(relativePath: string): Promise<PageRecord>;
+    private listPagePaths;
+    listPages(): Promise<PageRecord[]>;
+    writeIndex(pages: PageRecord[]): Promise<void>;
+    appendLog(operation: string, details: Record<string, string>): Promise<void>;
+    qmdStore(): Promise<QMDStore>;
+    /**
+     * Preload QMD models at startup (shared cache with LTM).
+     */
+    warmup(): Promise<void>;
+    syncSearchIndex(): Promise<void>;
+}
+export declare function create(config: Config): WikiStore;

package/dist/core/memory/wiki/store.js

@@ -0,0 +1,317 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { createStore } from "@tobilu/qmd";
+import { resolveModelFile } from "node-llama-cpp";
+import matter from "gray-matter";
+import { DEFAULT_WIKI_EMBED_MODEL, DEFAULT_WIKI_GENERATE_MODEL, DEFAULT_WIKI_RERANK_MODEL, } from "../../config.js";
+import { modelsCachePath, wikiDbPath, wikiPath } from "../../utils/paths.js";
+export const PAGES_DIR = "pages";
+export const INDEX_FILE = "index.md";
+export const LOG_FILE = "log.md";
+export const SCHEMA_FILE = "schema.md";
+export const DEFAULT_SEARCH_LIMIT = 5;
+export const MAX_SEARCH_LIMIT = 20;
+/** QMD collection name for wiki pages (fixed; not user-configurable). */
+export const QMD_COLLECTION = "wiki";
+function stripLeadingSlashes(value) {
+    return value.replace(/^[/\\]+/, "");
+}
+function firstSentence(value, maxLength = 180) {
+    const clean = value.replace(/\s+/g, " ").trim();
+    if (!clean) {
+        return "";
+    }
+    return clean.length > maxLength
+        ? `${clean.slice(0, maxLength - 1).trimEnd()}…`
+        : clean;
+}
+function safeString(value) {
+    return typeof value === "string" && value.trim().length > 0
+        ? value.trim()
+        : null;
+}
+function safeStringArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .filter((item) => typeof item === "string")
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+}
+function parseFrontmatter(content) {
+    const parsed = matter(content);
+    const data = parsed.data;
+    return {
+        frontmatter: {
+            title: safeString(data.title) ?? undefined,
+            summary: safeString(data.summary) ?? undefined,
+            tags: safeStringArray(data.tags),
+            related: safeStringArray(data.related),
+            type: safeString(data.type) ?? undefined,
+            created: safeString(data.created) ?? undefined,
+            updated: safeString(data.updated) ?? undefined,
+        },
+        body: parsed.content.trim(),
+    };
+}
+function wordCount(content) {
+    const words = content.trim().match(/\S+/g);
+    return words ? words.length : 0;
+}
+function normalizeRelatedPath(value) {
+    let item = value.trim().replace(/\\/g, "/");
+    item = item.replace(/^\[\[|\]\]$/g, "");
+    item = stripLeadingSlashes(item);
+    if (!item.endsWith(".md")) {
+        item = `${item}.md`;
+    }
+    if (!item.startsWith(`${PAGES_DIR}/`)) {
+        item = `${PAGES_DIR}/${item}`;
+    }
+    return item;
+}
+function deriveTitle(relativePath, frontmatter) {
+    const fromFrontmatter = safeString(frontmatter.title);
+    if (fromFrontmatter) {
+        return fromFrontmatter;
+    }
+    return path.basename(relativePath, ".md").replace(/[-_]+/g, " ").trim();
+}
+function deriveSummary(frontmatter, body, fallback) {
+    const fromFrontmatter = safeString(frontmatter.summary);
+    if (fromFrontmatter) {
+        return firstSentence(fromFrontmatter);
+    }
+    const bodySummary = firstSentence(body);
+    return bodySummary || firstSentence(fallback) || "No summary available.";
+}
+function buildIndexMarkdown(pages) {
+    const sorted = [...pages].sort((a, b) => a.title.localeCompare(b.title));
+    const lines = [
+        "# Wiki Index",
+        "",
+        "<!-- Auto-generated by wiki_write_file. -->",
+        "",
+        `Updated: ${new Date().toISOString()}`,
+        "",
+        "## Pages",
+    ];
+    if (sorted.length === 0) {
+        lines.push("- _No wiki pages yet._");
+        return `${lines.join("\n")}\n`;
+    }
+    for (const page of sorted) {
+        const tags = page.tags.length > 0 ? ` | tags: ${page.tags.join(", ")}` : "";
+        lines.push(`- [${page.title}](${page.path}): ${page.summary}${tags}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+function buildLogEntry(operation, details) {
+    const lines = [
+        `## [${new Date().toISOString()}] ${operation}`,
+        ...Object.entries(details).map(([key, value]) => `- ${key}: ${value}`),
+        "",
+    ];
+    return `${lines.join("\n")}\n`;
+}
+const DEFAULT_SCHEMA = `# Wiki Schema
+
+This wiki is maintained by the agent through wiki tools.
+
+## Structure
+- \`pages/\`: markdown knowledge pages
+- \`index.md\`: derived index (tool-managed)
+- \`log.md\`: append-only activity log (tool-managed)
+
+## Page conventions
+- Use markdown files under \`pages/\`
+- Prefer concise titles and summaries
+- Add frontmatter when helpful (\`title\`, \`summary\`, \`tags\`, \`related\`, \`type\`)
+- Use relative links to other pages when appropriate
+`;
+export class WikiStore {
+    root;
+    static instances = new Map();
+    qmdStorePromise = null;
+    constructor(_config, root) {
+        this.root = root;
+    }
+    /**
+     * Shared instance per wiki root so warmup and tools reuse the same QMD store promise.
+     */
+    static forConfig(config) {
+        const root = wikiPath();
+        let inst = WikiStore.instances.get(root);
+        if (!inst) {
+            inst = new WikiStore(config, root);
+            WikiStore.instances.set(root, inst);
+        }
+        return inst;
+    }
+    pageRelativePath(inputPath) {
+        const normalized = stripLeadingSlashes(inputPath.trim().replace(/\\/g, "/"));
+        if (!normalized) {
+            throw new Error("Page path is required.");
+        }
+        const withPrefix = normalized.startsWith(`${PAGES_DIR}/`)
+            ? normalized
+            : `${PAGES_DIR}/${normalized}`;
+        if (!withPrefix.toLowerCase().endsWith(".md")) {
+            throw new Error("Page paths must end with .md");
+        }
+        return withPrefix;
+    }
+    resolveWithin(relativePath) {
+        const abs = path.resolve(this.root, relativePath);
+        const normalizedRoot = path.resolve(this.root);
+        if (abs !== normalizedRoot &&
+            !abs.startsWith(`${normalizedRoot}${path.sep}`) &&
+            !(process.platform === "win32" &&
+                abs
+                    .toLowerCase()
+                    .startsWith(`${normalizedRoot.toLowerCase()}${path.sep}`))) {
+            throw new Error(`Path escapes wiki root: ${relativePath}`);
+        }
+        return abs;
+    }
+    async pathExists(filePath) {
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async ensureLayout() {
+        const pagesRoot = this.resolveWithin(PAGES_DIR);
+        await fs.mkdir(pagesRoot, { recursive: true });
+        const indexPath = this.resolveWithin(INDEX_FILE);
+        const logPath = this.resolveWithin(LOG_FILE);
+        const schemaPath = this.resolveWithin(SCHEMA_FILE);
+        if (!(await this.pathExists(indexPath))) {
+            await fs.writeFile(indexPath, buildIndexMarkdown([]), "utf8");
+        }
+        if (!(await this.pathExists(logPath))) {
+            await fs.writeFile(logPath, "# Wiki Log\n\n", "utf8");
+        }
+        if (!(await this.pathExists(schemaPath))) {
+            await fs.writeFile(schemaPath, `${DEFAULT_SCHEMA}\n`, "utf8");
+        }
+    }
+    async readPage(relativePath) {
+        const absolutePath = this.resolveWithin(relativePath);
+        const content = await fs.readFile(absolutePath, "utf8");
+        const stat = await fs.stat(absolutePath);
+        const parsed = parseFrontmatter(content);
+        const title = deriveTitle(relativePath, parsed.frontmatter);
+        const summary = deriveSummary(parsed.frontmatter, parsed.body, title);
+        return {
+            path: relativePath.replace(/\\/g, "/"),
+            absolutePath,
+            title,
+            summary,
+            tags: parsed.frontmatter.tags ?? [],
+            related: (parsed.frontmatter.related ?? []).map(normalizeRelatedPath),
+            type: parsed.frontmatter.type ?? null,
+            created: parsed.frontmatter.created ?? null,
+            updated: parsed.frontmatter.updated ?? null,
+            wordCount: wordCount(parsed.body),
+            mtime: stat.mtime.toISOString(),
+            content,
+            body: parsed.body,
+            frontmatter: parsed.frontmatter,
+        };
+    }
+    async listPagePaths() {
+        const pagesRoot = this.resolveWithin(PAGES_DIR);
+        const out = [];
+        const walk = async (dirPath) => {
+            const entries = await fs.readdir(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dirPath, entry.name);
+                if (entry.isDirectory()) {
+                    await walk(fullPath);
+                    continue;
+                }
+                if (!entry.isFile() || !entry.name.toLowerCase().endsWith(".md")) {
+                    continue;
+                }
+                const relFromRoot = path
+                    .relative(this.root, fullPath)
+                    .replace(/\\/g, "/");
+                out.push(relFromRoot);
+            }
+        };
+        if (await this.pathExists(pagesRoot)) {
+            await walk(pagesRoot);
+        }
+        out.sort((a, b) => a.localeCompare(b));
+        return out;
+    }
+    async listPages() {
+        const paths = await this.listPagePaths();
+        return Promise.all(paths.map((relativePath) => this.readPage(relativePath)));
+    }
+    async writeIndex(pages) {
+        const indexPath = this.resolveWithin(INDEX_FILE);
+        await fs.writeFile(indexPath, buildIndexMarkdown(pages), "utf8");
+    }
+    async appendLog(operation, details) {
+        const logPath = this.resolveWithin(LOG_FILE);
+        await fs.appendFile(logPath, buildLogEntry(operation, details), "utf8");
+    }
+    async qmdStore() {
+        if (!this.qmdStorePromise) {
+            this.qmdStorePromise = (async () => {
+                await this.ensureLayout();
+                const dbPath = wikiDbPath();
+                await fs.mkdir(path.dirname(dbPath), { recursive: true });
+                const pagesRoot = this.resolveWithin(PAGES_DIR);
+                return createStore({
+                    dbPath,
+                    config: {
+                        collections: {
+                            [QMD_COLLECTION]: {
+                                path: pagesRoot,
+                                pattern: "**/*.md",
+                            },
+                        },
+                        models: {
+                            embed: DEFAULT_WIKI_EMBED_MODEL,
+                            rerank: DEFAULT_WIKI_RERANK_MODEL,
+                            generate: DEFAULT_WIKI_GENERATE_MODEL,
+                        },
+                    },
+                });
+            })();
+        }
+        return this.qmdStorePromise;
+    }
+    /**
+     * Preload QMD models at startup (shared cache with LTM).
+     */
+    async warmup() {
+        await this.ensureLayout();
+        const models = [
+            DEFAULT_WIKI_EMBED_MODEL,
+            DEFAULT_WIKI_RERANK_MODEL,
+            DEFAULT_WIKI_GENERATE_MODEL,
+        ];
+        const cacheDir = modelsCachePath();
+        for (const model of new Set(models)) {
+            await resolveModelFile(model, cacheDir);
+        }
+        await this.qmdStore();
+    }
+    async syncSearchIndex() {
+        const store = await this.qmdStore();
+        await store.update({ collections: [QMD_COLLECTION] });
+        await store.embed({ force: false });
+    }
+}
+export function create(config) {
+    return WikiStore.forConfig(config);
+}
+//# sourceMappingURL=store.js.map

package/dist/core/memory/wiki/store.js.map

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

package/dist/core/memory/wiki/tools.d.ts

@@ -0,0 +1,11 @@
+import type { JSONValue } from "@strands-agents/sdk";
+import { WikiStore } from "./store.js";
+export declare function createWikiTools(wiki: WikiStore): (import("@strands-agents/sdk").InvokableTool<{
+    type: "page";
+}, JSONValue> | import("@strands-agents/sdk").InvokableTool<{
+    kind: "page" | "index" | "log" | "schema";
+    path?: string | undefined;
+}, JSONValue> | import("@strands-agents/sdk").InvokableTool<Record<string, never>, JSONValue> | import("@strands-agents/sdk").InvokableTool<{
+    query: string;
+    k?: number | undefined;
+}, JSONValue>)[];

package/dist/core/memory/wiki/tools.js

@@ -0,0 +1,291 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { tool } from "@strands-agents/sdk";
+import { z } from "zod";
+import { DEFAULT_SEARCH_LIMIT, INDEX_FILE, LOG_FILE, MAX_SEARCH_LIMIT, QMD_COLLECTION, SCHEMA_FILE, } from "./store.js";
+function toJsonValue(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function mapVectorChunkToMatch(row, root, index) {
+    const relPath = path.relative(root, row.filepath).replace(/\\/g, "/");
+    const distance = typeof row.score === "number" && Number.isFinite(row.score)
+        ? Math.max(0, 1 - row.score)
+        : null;
+    const id = row.chunkPos != null
+        ? `${row.docid}:${row.chunkPos}`
+        : `${row.docid}:${index}`;
+    return {
+        id,
+        path: relPath,
+        title: row.title,
+        summary: row.context,
+        tags: "",
+        distance,
+        score: row.score,
+        source: row.source,
+        chunk_pos: row.chunkPos ?? null,
+        content: row.body ?? "",
+    };
+}
+export function createWikiTools(wiki) {
+    const { root } = wiki;
+    return [
+        tool({
+            name: "wiki_list_files",
+            description: "List wiki files by type. Supports `page` and returns frontmatter-aware summaries.",
+            inputSchema: z.object({
+                type: z.enum(["page"]).default("page"),
+            }),
+            callback: async () => {
+                await wiki.ensureLayout();
+                const pages = await wiki.listPages();
+                return toJsonValue({
+                    root,
+                    type: "page",
+                    count: pages.length,
+                    files: pages.map((page) => ({
+                        path: page.path,
+                        title: page.title,
+                        summary: page.summary,
+                        tags: page.tags,
+                        related: page.related,
+                        type: page.type,
+                        created: page.created,
+                        updated: page.updated,
+                        word_count: page.wordCount,
+                        modified_at: page.mtime,
+                    })),
+                });
+            },
+        }),
+        tool({
+            name: "wiki_read_file",
+            description: "Read wiki files. Kinds: index, log, schema, or a specific page.",
+            inputSchema: z.object({
+                kind: z.enum(["index", "log", "schema", "page"]),
+                path: z.string().optional(),
+            }),
+            callback: async (input) => {
+                await wiki.ensureLayout();
+                if (input.kind === "page") {
+                    if (!input.path) {
+                        throw new Error("`path` is required when kind is `page`.");
+                    }
+                    const relativePath = wiki.pageRelativePath(input.path);
+                    const page = await wiki.readPage(relativePath);
+                    return toJsonValue({
+                        root,
+                        kind: input.kind,
+                        path: page.path,
+                        frontmatter: page.frontmatter,
+                        title: page.title,
+                        summary: page.summary,
+                        word_count: page.wordCount,
+                        content: page.content,
+                    });
+                }
+                if (input.path) {
+                    throw new Error("`path` is only valid when kind is `page` and should be omitted otherwise.");
+                }
+                const target = input.kind === "index"
+                    ? INDEX_FILE
+                    : input.kind === "log"
+                        ? LOG_FILE
+                        : SCHEMA_FILE;
+                const absolutePath = wiki.resolveWithin(target);
+                const content = await fs.readFile(absolutePath, "utf8");
+                return toJsonValue({
+                    root,
+                    kind: input.kind,
+                    path: target,
+                    content,
+                });
+            },
+        }),
+        tool({
+            name: "wiki_write_file",
+            description: "Write wiki files. Page writes automatically maintain index, log, and search index.",
+            inputSchema: z.object({
+                kind: z.enum(["page", "schema"]),
+                path: z.string().optional(),
+                content: z.string().min(1),
+            }),
+            callback: async (input) => {
+                await wiki.ensureLayout();
+                const content = input.content;
+                if (input.kind === "schema") {
+                    if (input.path) {
+                        throw new Error("`path` is not valid when kind is `schema`.");
+                    }
+                    const schemaPath = wiki.resolveWithin(SCHEMA_FILE);
+                    await fs.writeFile(schemaPath, content, "utf8");
+                    await wiki.appendLog("schema_update", { path: SCHEMA_FILE });
+                    return toJsonValue({
+                        root,
+                        kind: input.kind,
+                        path: SCHEMA_FILE,
+                        bytes_written: Buffer.byteLength(content, "utf8"),
+                        index_updated: false,
+                        log_updated: true,
+                        search_index_updated: false,
+                    });
+                }
+                if (!input.path) {
+                    throw new Error("`path` is required when kind is `page`.");
+                }
+                const relativePath = wiki.pageRelativePath(input.path);
+                const absolutePath = wiki.resolveWithin(relativePath);
+                const existed = await wiki.pathExists(absolutePath);
+                await fs.mkdir(path.dirname(absolutePath), { recursive: true });
+                await fs.writeFile(absolutePath, content, "utf8");
+                const page = await wiki.readPage(relativePath);
+                await wiki.syncSearchIndex();
+                const pages = await wiki.listPages();
+                await wiki.writeIndex(pages);
+                await wiki.appendLog(existed ? "page_update" : "page_create", {
+                    path: page.path,
+                    title: page.title,
+                });
+                return toJsonValue({
+                    root,
+                    kind: input.kind,
+                    path: page.path,
+                    title: page.title,
+                    summary: page.summary,
+                    bytes_written: Buffer.byteLength(content, "utf8"),
+                    index_updated: true,
+                    log_updated: true,
+                    search_index_updated: true,
+                });
+            },
+        }),
+        tool({
+            name: "wiki_knowledge_graph",
+            description: "Build the wiki knowledge graph from page frontmatter links and shared tags.",
+            inputSchema: z.object({}),
+            callback: async () => {
+                await wiki.ensureLayout();
+                const pages = await wiki.listPages();
+                const nodes = pages.map((page) => ({
+                    path: page.path,
+                    title: page.title,
+                    tags: page.tags,
+                    type: page.type ?? "page",
+                    word_count: page.wordCount,
+                }));
+                const edges = [];
+                const inbound = new Map();
+                const relatedOut = new Map();
+                for (const page of pages) {
+                    relatedOut.set(page.path, page.related.length);
+                    for (const related of page.related) {
+                        edges.push({
+                            source: page.path,
+                            target: related,
+                            type: "related",
+                        });
+                        inbound.set(related, (inbound.get(related) ?? 0) + 1);
+                    }
+                }
+                const tagClusters = new Map();
+                for (const page of pages) {
+                    for (const tag of page.tags) {
+                        if (!tagClusters.has(tag)) {
+                            tagClusters.set(tag, []);
+                        }
+                        tagClusters.get(tag).push(page.path);
+                    }
+                }
+                for (const [tag, members] of tagClusters.entries()) {
+                    if (members.length < 2) {
+                        continue;
+                    }
+                    for (let i = 0; i < members.length; i += 1) {
+                        for (let j = i + 1; j < members.length; j += 1) {
+                            const source = members[i];
+                            const target = members[j];
+                            edges.push({ source, target, type: "shared-tag", tag });
+                        }
+                    }
+                }
+                const orphans = pages.filter((page) => {
+                    const incoming = inbound.get(page.path) ?? 0;
+                    const outgoing = relatedOut.get(page.path) ?? 0;
+                    return incoming === 0 && outgoing === 0;
+                });
+                return toJsonValue({
+                    nodes,
+                    edges,
+                    tag_clusters: Object.fromEntries(tagClusters.entries()),
+                    stats: {
+                        pages: pages.length,
+                        links: edges.length,
+                        orphans: orphans.length,
+                    },
+                });
+            },
+        }),
+        tool({
+            name: "wiki_stats",
+            description: "Return wiki health and usage statistics for page content.",
+            inputSchema: z.object({}),
+            callback: async () => {
+                await wiki.ensureLayout();
+                const pages = await wiki.listPages();
+                const totalWords = pages.reduce((sum, page) => sum + page.wordCount, 0);
+                const tags = new Set();
+                const types = {};
+                const inbound = new Map();
+                for (const page of pages) {
+                    for (const tag of page.tags) {
+                        tags.add(tag);
+                    }
+                    const type = page.type ?? "page";
+                    types[type] = (types[type] ?? 0) + 1;
+                    for (const related of page.related) {
+                        inbound.set(related, (inbound.get(related) ?? 0) + 1);
+                    }
+                }
+                const orphans = pages.filter((page) => (inbound.get(page.path) ?? 0) === 0 && page.related.length === 0);
+                const lastActivity = pages
+                    .map((page) => page.mtime)
+                    .sort()
+                    .at(-1);
+                return toJsonValue({
+                    pages: pages.length,
+                    links: pages.reduce((sum, page) => sum + page.related.length, 0),
+                    orphans: orphans.length,
+                    total_words: totalWords,
+                    avg_words_per_page: pages.length > 0 ? totalWords / pages.length : 0,
+                    tags: tags.size,
+                    types,
+                    last_activity: lastActivity ?? null,
+                });
+            },
+        }),
+        tool({
+            name: "wiki_search",
+            description: "Semantic search over wiki chunks (QMD index under $HOOMAN_HOME/wiki/.qmd/index.sqlite). Returns matching snippets; use wiki_read_file on paths you need in full.",
+            inputSchema: z.object({
+                query: z.string().min(1),
+                k: z.number().int().min(1).max(MAX_SEARCH_LIMIT).optional(),
+            }),
+            callback: async (input) => {
+                await wiki.ensureLayout();
+                const store = await wiki.qmdStore();
+                const k = input.k ?? DEFAULT_SEARCH_LIMIT;
+                const rows = await store.searchVector(input.query, {
+                    limit: k,
+                    collection: QMD_COLLECTION,
+                });
+                const matches = rows.map((row, index) => mapVectorChunkToMatch(row, root, index));
+                return toJsonValue({
+                    query: input.query,
+                    count: matches.length,
+                    matches,
+                });
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=tools.js.map