@waynesutton/agent-memory 0.0.1-alpha.1

package/dist/cli/type-extractor.js

@@ -0,0 +1,254 @@
+import { readFile } from "node:fs/promises";
+import { basename, relative } from "node:path";
+import { computeChecksum } from "../component/checksum.js";
+// ── Public API ───────────────────────────────────────────────────────
+/**
+ * Extract TypeScript type definitions from files matching a glob pattern
+ * and convert them into ParsedMemory objects suitable for agent-memory.
+ *
+ * Uses `types-not-docs` under the hood to generate markdown from types.
+ */
+export async function extractTypeMemories(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const priority = opts.priority ?? 0.6;
+    const extraTags = opts.tags ?? [];
+    const exclude = opts.exclude ?? [
+        "**/node_modules/**",
+        "**/dist/**",
+        "**/_generated/**",
+        "**/*.test.ts",
+        "**/*.spec.ts",
+    ];
+    // Dynamic import — keeps types-not-docs optional at install time
+    const fg = await import("fast-glob");
+    const files = await fg.default(opts.globPattern, {
+        cwd,
+        absolute: true,
+        ignore: exclude,
+    });
+    if (files.length === 0) {
+        return { memories: [], filesProcessed: 0 };
+    }
+    // Generate markdown from type definitions
+    const markdown = await generateTypeDocumentation(files);
+    if (!markdown.trim()) {
+        return { memories: [], filesProcessed: files.length };
+    }
+    // Split the generated markdown into individual type memories
+    const sections = splitByHeadings(markdown, files, cwd);
+    const memories = sections.map((section) => ({
+        title: `types/${section.title}`,
+        content: section.content,
+        memoryType: "reference",
+        scope: "project",
+        tags: ["typescript", "types", "auto-generated", ...extraTags],
+        paths: section.sourcePaths,
+        priority,
+        source: "ingest-types",
+        checksum: computeChecksum(section.content),
+    }));
+    return { memories, filesProcessed: files.length };
+}
+// ── Type documentation generation ────────────────────────────────────
+/**
+ * Generate markdown documentation from TypeScript files using types-not-docs.
+ * Falls back to a built-in extractor if types-not-docs is not installed.
+ */
+async function generateTypeDocumentation(files) {
+    try {
+        // Try types-not-docs first (optional dependency)
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const tnd = await import(/* webpackIgnore: true */ "types-not-docs");
+        if (typeof tnd.generateDocs === "function") {
+            return tnd.generateDocs(files);
+        }
+        if (typeof tnd.default === "function") {
+            return tnd.default(files);
+        }
+    }
+    catch {
+        // types-not-docs not installed — use built-in extractor
+    }
+    // Built-in fallback: extract exported types/interfaces/functions from TS files
+    return await builtInTypeExtractor(files);
+}
+/**
+ * Built-in TypeScript type extractor that doesn't require external dependencies.
+ * Parses exported types, interfaces, type aliases, and function signatures.
+ */
+async function builtInTypeExtractor(files) {
+    const sections = [];
+    for (const filePath of files) {
+        const source = await readFile(filePath, "utf-8");
+        const extracted = extractExportedTypes(source, filePath);
+        if (extracted) {
+            sections.push(extracted);
+        }
+    }
+    return sections.join("\n\n");
+}
+/**
+ * Extract exported type definitions from a single TypeScript file.
+ */
+function extractExportedTypes(source, filePath) {
+    const lines = source.split("\n");
+    const blocks = [];
+    let currentBlock = [];
+    let braceDepth = 0;
+    let inExport = false;
+    let currentKind = "";
+    let currentName = "";
+    let pendingJsDoc = [];
+    function flushBlock() {
+        if (currentName && currentBlock.length > 0) {
+            blocks.push(formatBlock(currentKind, currentName, currentBlock));
+        }
+        inExport = false;
+        currentBlock = [];
+        braceDepth = 0;
+        currentKind = "";
+        currentName = "";
+    }
+    function countBraces(line) {
+        for (const ch of line) {
+            if (ch === "{")
+                braceDepth++;
+            if (ch === "}")
+                braceDepth--;
+        }
+    }
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        // Collect JSDoc comments (only when not inside an export block)
+        if (!inExport && trimmed.startsWith("/**")) {
+            pendingJsDoc = [line];
+            if (!trimmed.endsWith("*/")) {
+                for (let j = i + 1; j < lines.length; j++) {
+                    pendingJsDoc.push(lines[j]);
+                    if (lines[j].trim().endsWith("*/")) {
+                        i = j;
+                        break;
+                    }
+                }
+            }
+            continue;
+        }
+        // Match exported type definitions
+        if (!inExport) {
+            const exportMatch = trimmed.match(/^export\s+(interface|type|function|const|class|enum|abstract\s+class)\s+(\w+)/);
+            if (exportMatch) {
+                currentKind = exportMatch[1];
+                currentName = exportMatch[2];
+                currentBlock = [...pendingJsDoc, line];
+                pendingJsDoc = [];
+                braceDepth = 0;
+                countBraces(line);
+                // Check if statement is complete on this line
+                const isComplete = 
+                // Single-line with no braces, ending in semicolon (type alias)
+                (braceDepth === 0 && !line.includes("{") && trimmed.endsWith(";")) ||
+                    // Single-line with balanced braces
+                    (braceDepth === 0 && line.includes("{"));
+                if (isComplete) {
+                    flushBlock();
+                }
+                else {
+                    inExport = true;
+                }
+                continue;
+            }
+            // No match — clear pending JSDoc
+            if (trimmed && !trimmed.startsWith("//") && !trimmed.startsWith("*")) {
+                pendingJsDoc = [];
+            }
+            continue;
+        }
+        // Inside a multi-line export — keep collecting
+        currentBlock.push(line);
+        countBraces(line);
+        if (braceDepth <= 0) {
+            flushBlock();
+        }
+    }
+    // Flush any remaining block
+    if (inExport) {
+        flushBlock();
+    }
+    if (blocks.length === 0)
+        return null;
+    const fileName = basename(filePath);
+    return `## ${fileName}\n\n${blocks.join("\n\n")}`;
+}
+function formatBlock(kind, name, lines) {
+    const code = lines.join("\n").trim();
+    return `### ${name}\n\n\`${kind}\`\n\n\`\`\`typescript\n${code}\n\`\`\``;
+}
+/**
+ * Split generated markdown into sections by ## headings.
+ * Each ## heading becomes a separate memory entry.
+ */
+function splitByHeadings(markdown, sourceFiles, cwd) {
+    const lines = markdown.split("\n");
+    const sections = [];
+    let currentTitle = "";
+    let currentLines = [];
+    const relPaths = sourceFiles.map((f) => relative(cwd, f));
+    for (const line of lines) {
+        const h2Match = line.match(/^##\s+(.+)$/);
+        if (h2Match) {
+            // Flush previous section
+            if (currentTitle && currentLines.length > 0) {
+                const content = currentLines.join("\n").trim();
+                if (content) {
+                    sections.push({
+                        title: sanitizeTitle(currentTitle),
+                        content,
+                        sourcePaths: findMatchingPaths(currentTitle, relPaths),
+                    });
+                }
+            }
+            currentTitle = h2Match[1];
+            currentLines = [];
+        }
+        else {
+            currentLines.push(line);
+        }
+    }
+    // Flush last section
+    if (currentTitle && currentLines.length > 0) {
+        const content = currentLines.join("\n").trim();
+        if (content) {
+            sections.push({
+                title: sanitizeTitle(currentTitle),
+                content,
+                sourcePaths: findMatchingPaths(currentTitle, relPaths),
+            });
+        }
+    }
+    // Fallback: if no ## headings, treat the whole thing as one section
+    if (sections.length === 0 && markdown.trim()) {
+        sections.push({
+            title: "api-reference",
+            content: markdown.trim(),
+            sourcePaths: relPaths,
+        });
+    }
+    return sections;
+}
+function sanitizeTitle(title) {
+    return title
+        .toLowerCase()
+        .replace(/\.tsx?$/, "")
+        .replace(/[^a-z0-9-_./]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+}
+function findMatchingPaths(title, relPaths) {
+    // Try to match the heading (usually a filename) back to source paths
+    const match = relPaths.filter((p) => p.includes(title) ||
+        basename(p, ".ts") === title ||
+        basename(p, ".tsx") === title);
+    return match.length > 0 ? match : relPaths.slice(0, 1);
+}
+//# sourceMappingURL=type-extractor.js.map

package/dist/cli/type-extractor.js.map

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

package/dist/cli/type-extractor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type-extractor.test.d.ts.map

package/dist/cli/type-extractor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-extractor.test.d.ts","sourceRoot":"","sources":["../../src/cli/type-extractor.test.ts"],"names":[],"mappings":""}

package/dist/cli/type-extractor.test.js

@@ -0,0 +1,173 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtemp, mkdir, writeFile, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { extractTypeMemories } from "./type-extractor.js";
+let tempDir;
+beforeEach(async () => {
+    tempDir = await mkdtemp(join(tmpdir(), "agent-memory-types-test-"));
+});
+afterEach(async () => {
+    await rm(tempDir, { recursive: true, force: true });
+});
+describe("extractTypeMemories", () => {
+    it("extracts exported interfaces", async () => {
+        await writeFile(join(tempDir, "models.ts"), `
+export interface User {
+  id: string;
+  name: string;
+  email: string;
+  createdAt: number;
+}
+
+export interface Post {
+  id: string;
+  title: string;
+  content: string;
+  authorId: string;
+}
+`);
+        const result = await extractTypeMemories({
+            globPattern: "**/*.ts",
+            cwd: tempDir,
+        });
+        expect(result.filesProcessed).toBe(1);
+        expect(result.memories.length).toBeGreaterThanOrEqual(1);
+        const allContent = result.memories.map((m) => m.content).join("\n");
+        expect(allContent).toContain("User");
+        expect(allContent).toContain("Post");
+        for (const memory of result.memories) {
+            expect(memory.memoryType).toBe("reference");
+            expect(memory.scope).toBe("project");
+            expect(memory.source).toBe("ingest-types");
+            expect(memory.tags).toContain("typescript");
+            expect(memory.tags).toContain("types");
+            expect(memory.tags).toContain("auto-generated");
+            expect(memory.checksum).toBeTruthy();
+            expect(memory.title).toMatch(/^types\//);
+        }
+    });
+    it("extracts exported type aliases", async () => {
+        await writeFile(join(tempDir, "types.ts"), `
+export type Status = "active" | "inactive" | "pending";
+
+export type UserId = string;
+`);
+        const result = await extractTypeMemories({
+            globPattern: "**/*.ts",
+            cwd: tempDir,
+        });
+        expect(result.filesProcessed).toBe(1);
+        expect(result.memories.length).toBeGreaterThanOrEqual(1);
+        const allContent = result.memories.map((m) => m.content).join("\n");
+        expect(allContent).toContain("Status");
+    });
+    it("extracts exported functions", async () => {
+        await writeFile(join(tempDir, "utils.ts"), `
+/** Compute hash of a string */
+export function computeHash(input: string): string {
+  return input;
+}
+
+export const double = (n: number): number => n * 2;
+`);
+        const result = await extractTypeMemories({
+            globPattern: "**/*.ts",
+            cwd: tempDir,
+        });
+        expect(result.filesProcessed).toBe(1);
+        const allContent = result.memories.map((m) => m.content).join("\n");
+        expect(allContent).toContain("computeHash");
+    });
+    it("returns empty for no matching files", async () => {
+        const result = await extractTypeMemories({
+            globPattern: "**/*.ts",
+            cwd: tempDir,
+        });
+        expect(result.filesProcessed).toBe(0);
+        expect(result.memories).toHaveLength(0);
+    });
+    it("returns empty for files with no exports", async () => {
+        await writeFile(join(tempDir, "internal.ts"), `
+const x = 42;
+function helper() { return x; }
+`);
+        const result = await extractTypeMemories({
+            globPattern: "**/*.ts",
+            cwd: tempDir,
+        });
+        expect(result.filesProcessed).toBe(1);
+        expect(result.memories).toHaveLength(0);
+    });
+    it("handles multiple files", async () => {
+        await mkdir(join(tempDir, "src"));
+        await writeFile(join(tempDir, "src", "auth.ts"), `export interface Session { token: string; userId: string; }`);
+        await writeFile(join(tempDir, "src", "db.ts"), `export interface DatabaseConfig { host: string; port: number; }`);
+        const result = await extractTypeMemories({
+            globPattern: "src/**/*.ts",
+            cwd: tempDir,
+        });
+        expect(result.filesProcessed).toBe(2);
+        expect(result.memories.length).toBeGreaterThanOrEqual(2);
+        const allContent = result.memories.map((m) => m.content).join("\n");
+        expect(allContent).toContain("Session");
+        expect(allContent).toContain("DatabaseConfig");
+    });
+    it("respects exclude patterns", async () => {
+        await mkdir(join(tempDir, "src"));
+        await mkdir(join(tempDir, "dist"));
+        await writeFile(join(tempDir, "src", "api.ts"), `export interface Api { endpoint: string; }`);
+        await writeFile(join(tempDir, "dist", "api.ts"), `export interface Api { endpoint: string; }`);
+        const result = await extractTypeMemories({
+            globPattern: "**/*.ts",
+            cwd: tempDir,
+            exclude: ["**/dist/**"],
+        });
+        expect(result.filesProcessed).toBe(1);
+    });
+    it("applies custom tags", async () => {
+        await writeFile(join(tempDir, "schema.ts"), `export interface Table { id: string; }`);
+        const result = await extractTypeMemories({
+            globPattern: "**/*.ts",
+            cwd: tempDir,
+            tags: ["convex", "schema"],
+        });
+        expect(result.memories.length).toBeGreaterThanOrEqual(1);
+        for (const memory of result.memories) {
+            expect(memory.tags).toContain("convex");
+            expect(memory.tags).toContain("schema");
+        }
+    });
+    it("applies custom priority", async () => {
+        await writeFile(join(tempDir, "core.ts"), `export interface CoreConfig { debug: boolean; }`);
+        const result = await extractTypeMemories({
+            globPattern: "**/*.ts",
+            cwd: tempDir,
+            priority: 0.9,
+        });
+        expect(result.memories.length).toBeGreaterThanOrEqual(1);
+        for (const memory of result.memories) {
+            expect(memory.priority).toBe(0.9);
+        }
+    });
+    it("extracts JSDoc comments with types", async () => {
+        await writeFile(join(tempDir, "documented.ts"), `
+/** Configuration for the application */
+export interface AppConfig {
+  /** The port to listen on */
+  port: number;
+  /** Whether to enable debug mode */
+  debug: boolean;
+}
+`);
+        const result = await extractTypeMemories({
+            globPattern: "**/*.ts",
+            cwd: tempDir,
+        });
+        expect(result.memories.length).toBeGreaterThanOrEqual(1);
+        const allContent = result.memories.map((m) => m.content).join("\n");
+        expect(allContent).toContain("AppConfig");
+        expect(allContent).toContain("Configuration for the application");
+    });
+});
+//# sourceMappingURL=type-extractor.test.js.map

package/dist/cli/type-extractor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-extractor.test.js","sourceRoot":"","sources":["../../src/cli/type-extractor.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,IAAI,OAAe,CAAC;AAEpB,UAAU,CAAC,KAAK,IAAI,EAAE;IACpB,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC,CAAC;AACtE,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAC1B;;;;;;;;;;;;;;CAcL,CACI,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;YACvC,WAAW,EAAE,SAAS;YACtB,GAAG,EAAE,OAAO;SACb,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAEzD,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAErC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAChD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EACzB;;;;CAIL,CACI,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;YACvC,WAAW,EAAE,SAAS;YACtB,GAAG,EAAE,OAAO;SACb,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAEzD,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EACzB;;;;;;;CAOL,CACI,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;YACvC,WAAW,EAAE,SAAS;YACtB,GAAG,EAAE,OAAO;SACb,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;YACvC,WAAW,EAAE,SAAS;YACtB,GAAG,EAAE,OAAO;SACb,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAC5B;;;CAGL,CACI,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;YACvC,WAAW,EAAE,SAAS;YACtB,GAAG,EAAE,OAAO;SACb,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAClC,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,EAC/B,6DAA6D,CAC9D,CAAC;QACF,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,EAC7B,iEAAiE,CAClE,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;YACvC,WAAW,EAAE,aAAa;YAC1B,GAAG,EAAE,OAAO;SACb,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAEzD,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAClC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACnC,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,EAC9B,4CAA4C,CAC7C,CAAC;QACF,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAC/B,4CAA4C,CAC7C,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;YACvC,WAAW,EAAE,SAAS;YACtB,GAAG,EAAE,OAAO;YACZ,OAAO,EAAE,CAAC,YAAY,CAAC;SACxB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;QACnC,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAC1B,wCAAwC,CACzC,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;YACvC,WAAW,EAAE,SAAS;YACtB,GAAG,EAAE,OAAO;YACZ,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;SAC3B,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACzD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EACxB,iDAAiD,CAClD,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;YACvC,WAAW,EAAE,SAAS;YACtB,GAAG,EAAE,OAAO;YACZ,QAAQ,EAAE,GAAG;SACd,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACzD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,EAC9B;;;;;;;;CAQL,CACI,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;YACvC,WAAW,EAAE,SAAS;YACtB,GAAG,EAAE,OAAO;SACb,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC1C,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/client/http.d.ts

@@ -0,0 +1,44 @@
+import { type HttpRouter } from "convex/server";
+import type { api } from "../component/_generated/api.js";
+type ComponentApi = typeof api;
+export interface MemoryHttpApiConfig {
+    /** Allowed CORS origins. Defaults to ["*"]. */
+    corsOrigins?: string[];
+}
+/**
+ * Generates read-only HTTP endpoint handlers that a Convex app mounts
+ * on its own `httpRouter`. Each request is authenticated via an API key
+ * (Bearer token) and rate-limited using the component's built-in
+ * fixed-window token bucket.
+ *
+ * Usage in the consuming app's `convex/http.ts`:
+ *
+ * ```typescript
+ * import { httpRouter } from "convex/server";
+ * import { MemoryHttpApi } from "@waynesutton/agent-memory/http";
+ * import { components } from "./_generated/api";
+ *
+ * const http = httpRouter();
+ * const memoryApi = new MemoryHttpApi(components.agentMemory);
+ * memoryApi.mount(http, "/api/memory");
+ * export default http;
+ * ```
+ */
+export declare class MemoryHttpApi {
+    private component;
+    private cors;
+    constructor(component: ComponentApi, config?: MemoryHttpApiConfig);
+    /**
+     * Validates the Bearer token, checks rate limits, and returns the
+     * validated key info. Returns an error Response if auth or rate
+     * limiting fails.
+     */
+    private authenticate;
+    /**
+     * Registers all read-only memory API routes on the given httpRouter
+     * under the specified prefix (e.g. "/api/memory").
+     */
+    mount(http: HttpRouter, prefix: string): void;
+}
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/client/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/client/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAC;AAO1D,KAAK,YAAY,GAAG,OAAO,GAAG,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AA2CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,IAAI,CAAyB;gBAEzB,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,mBAAmB;IAOjE;;;;OAIG;YACW,YAAY;IA8D1B;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAiQ9C"}