@memoire-ai/collector 0.1.0

package/dist/dedup.js

@@ -0,0 +1,60 @@
+/**
+ * Client-side content deduplication using a hash-based sliding window.
+ * Prevents noisy hooks from flooding the API with duplicate observations
+ * within a short time window (default 30 seconds).
+ *
+ * Mirrors claude-mem's 30-second content-hash dedup at the edge.
+ */
+/** Simple FNV-1a hash for fast string fingerprinting */
+function fnv1a(str) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < str.length; i++) {
+        hash ^= str.charCodeAt(i);
+        hash = (hash * 0x01000193) >>> 0;
+    }
+    return hash;
+}
+export class ContentDedup {
+    seen = new Map(); // hash → timestamp
+    windowMs;
+    cleanupTimer;
+    constructor(windowMs = 30_000) {
+        this.windowMs = windowMs;
+        // Periodic cleanup to prevent unbounded growth
+        this.cleanupTimer = setInterval(() => this.evict(), this.windowMs);
+        if (this.cleanupTimer.unref) {
+            this.cleanupTimer.unref(); // Don't keep process alive
+        }
+    }
+    /**
+     * Returns true if content is a duplicate (already seen within the window).
+     * Returns false if content is new — and records it.
+     */
+    isDuplicate(content) {
+        const hash = fnv1a(content);
+        const now = Date.now();
+        const lastSeen = this.seen.get(hash);
+        if (lastSeen !== undefined && now - lastSeen < this.windowMs) {
+            return true;
+        }
+        this.seen.set(hash, now);
+        return false;
+    }
+    /** Remove entries older than the window */
+    evict() {
+        const cutoff = Date.now() - this.windowMs;
+        for (const [hash, timestamp] of this.seen) {
+            if (timestamp < cutoff) {
+                this.seen.delete(hash);
+            }
+        }
+    }
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+        this.seen.clear();
+    }
+}
+//# sourceMappingURL=dedup.js.map

package/dist/dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.js","sourceRoot":"","sources":["../src/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wDAAwD;AACxD,SAAS,KAAK,CAAC,GAAW;IACxB,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,GAAG,CAAC,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,OAAO,YAAY;IACf,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,mBAAmB;IACrD,QAAQ,CAAS;IACjB,YAAY,CAA6C;IAEjE,YAAY,QAAQ,GAAG,MAAM;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,+CAA+C;QAC/C,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnE,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YAC5B,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,2BAA2B;QACxD,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,OAAe;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAErC,IAAI,QAAQ,KAAK,SAAS,IAAI,GAAG,GAAG,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2CAA2C;IACnC,KAAK;QACX,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC1C,IAAI,SAAS,GAAG,MAAM,EAAE,CAAC;gBACvB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjC,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/dedup.test.d.ts

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

package/dist/dedup.test.d.ts.map

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

package/dist/dedup.test.js

@@ -0,0 +1,83 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { ContentDedup } from './dedup.js';
+test('ContentDedup allows first occurrence', () => {
+    const dedup = new ContentDedup(30_000);
+    try {
+        assert.equal(dedup.isDuplicate('hello world'), false);
+    }
+    finally {
+        dedup.destroy();
+    }
+});
+test('ContentDedup blocks duplicate within window', () => {
+    const dedup = new ContentDedup(30_000);
+    try {
+        assert.equal(dedup.isDuplicate('same content'), false);
+        assert.equal(dedup.isDuplicate('same content'), true);
+        assert.equal(dedup.isDuplicate('same content'), true);
+    }
+    finally {
+        dedup.destroy();
+    }
+});
+test('ContentDedup allows different content', () => {
+    const dedup = new ContentDedup(30_000);
+    try {
+        assert.equal(dedup.isDuplicate('content A'), false);
+        assert.equal(dedup.isDuplicate('content B'), false);
+        assert.equal(dedup.isDuplicate('content C'), false);
+    }
+    finally {
+        dedup.destroy();
+    }
+});
+test('ContentDedup allows content after window expires', async () => {
+    const dedup = new ContentDedup(50); // 50ms window for testing
+    try {
+        assert.equal(dedup.isDuplicate('expiring'), false);
+        assert.equal(dedup.isDuplicate('expiring'), true);
+        await new Promise((r) => setTimeout(r, 80));
+        assert.equal(dedup.isDuplicate('expiring'), false);
+    }
+    finally {
+        dedup.destroy();
+    }
+});
+test('ContentDedup disabled when windowMs is 0', () => {
+    const dedup = new ContentDedup(0);
+    try {
+        assert.equal(dedup.isDuplicate('repeat'), false);
+        assert.equal(dedup.isDuplicate('repeat'), false);
+        assert.equal(dedup.isDuplicate('repeat'), false);
+    }
+    finally {
+        dedup.destroy();
+    }
+});
+test('ContentDedup distinguishes same content with different keys', () => {
+    const dedup = new ContentDedup(30_000);
+    try {
+        // Simulates event_type\0content keying used by Collector.emit()
+        assert.equal(dedup.isDuplicate('observation\0file changed'), false);
+        assert.equal(dedup.isDuplicate('decision\0file changed'), false); // different type = not a dup
+        assert.equal(dedup.isDuplicate('observation\0file changed'), true); // same type+content = dup
+    }
+    finally {
+        dedup.destroy();
+    }
+});
+test('ContentDedup.destroy cleans up', () => {
+    const dedup = new ContentDedup(30_000);
+    dedup.isDuplicate('data');
+    dedup.destroy();
+    // After destroy, new instance should not see old data
+    const dedup2 = new ContentDedup(30_000);
+    try {
+        assert.equal(dedup2.isDuplicate('data'), false);
+    }
+    finally {
+        dedup2.destroy();
+    }
+});
+//# sourceMappingURL=dedup.test.js.map

package/dist/dedup.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.test.js","sourceRoot":"","sources":["../src/dedup.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,IAAI,CAAC,sCAAsC,EAAE,GAAG,EAAE;IAChD,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;IACvD,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACjD,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;IAClE,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,0BAA0B;IAC9D,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;QAElD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAE5C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACpD,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6DAA6D,EAAE,GAAG,EAAE;IACvE,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,gEAAgE;QAChE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,2BAA2B,CAAC,EAAE,KAAK,CAAC,CAAC;QACpE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,wBAAwB,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,6BAA6B;QAC/F,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,2BAA2B,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,0BAA0B;IAChG,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC1C,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,KAAK,CAAC,OAAO,EAAE,CAAC;IAChB,sDAAsD;IACtD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,52 @@
+import type { EventType } from '@memoire-ai/shared';
+import type { Collector } from '../capture.js';
+export interface HookEvent {
+    type: 'session_start' | 'prompt' | 'tool_use' | 'session_end';
+    content?: string;
+    files_read?: string[];
+    files_modified?: string[];
+    branch_name?: string;
+}
+export interface HookHandlers {
+    onSessionStart: () => Promise<void>;
+    onPrompt: (prompt: string) => Promise<void>;
+    onToolUse: (content: string, context?: ToolUseContext) => Promise<void>;
+    onSessionEnd: (summary?: string) => Promise<void>;
+}
+export interface ToolUseContext {
+    read?: string[];
+    modified?: string[];
+    branchName?: string;
+    toolName?: string;
+    status?: 'success' | 'error';
+    error?: string;
+    concepts?: string[];
+    eventTypeHint?: Exclude<EventType, 'prompt' | 'session_summary'>;
+}
+interface HookCollector {
+    sessionStart(): Promise<void>;
+    prompt(content: string, opts?: CaptureOptions): Promise<void>;
+    observation(content: string, opts?: CaptureOptions): Promise<void>;
+    decision(content: string, opts?: CaptureOptions): Promise<void>;
+    attempt(content: string, opts?: CaptureOptions): Promise<void>;
+    convention(content: string, opts?: CaptureOptions): Promise<void>;
+    branchEvent(content: string, opts?: CaptureOptions): Promise<void>;
+    sessionEnd(summary: string): Promise<void>;
+}
+interface CaptureOptions {
+    filesRead?: string[];
+    filesModified?: string[];
+    concepts?: string[];
+    branchName?: string;
+}
+/**
+ * Create hook handlers that bridge IDE lifecycle events
+ * to the Memoire collector.
+ *
+ * Follows the claude-mem 5-hook lifecycle:
+ * SessionStart → UserPromptSubmit → PostToolUse → Summary → SessionEnd
+ */
+export declare function createHooks(collector: HookCollector | Collector): HookHandlers;
+export declare function inferToolUseEventType(content: string, context?: ToolUseContext): Exclude<EventType, 'prompt' | 'session_summary'>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAC;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,YAAY,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,QAAQ,GAAG,iBAAiB,CAAC,CAAC;CAClE;AAED,UAAU,aAAa;IACrB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,CAiD9E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,QAAQ,GAAG,iBAAiB,CAAC,CAwBjI"}

package/dist/hooks/index.js

@@ -0,0 +1,136 @@
+/**
+ * Create hook handlers that bridge IDE lifecycle events
+ * to the Memoire collector.
+ *
+ * Follows the claude-mem 5-hook lifecycle:
+ * SessionStart → UserPromptSubmit → PostToolUse → Summary → SessionEnd
+ */
+export function createHooks(collector) {
+    return {
+        async onSessionStart() {
+            await collector.sessionStart();
+        },
+        async onPrompt(prompt) {
+            await collector.prompt(normalizePrompt(prompt), {
+                concepts: extractPromptConcepts(prompt),
+            });
+        },
+        async onToolUse(content, context) {
+            const eventType = inferToolUseEventType(content, context);
+            const captureContent = formatToolUseContent(content, context);
+            const captureOptions = {
+                filesRead: context?.read,
+                filesModified: context?.modified,
+                branchName: context?.branchName,
+                concepts: mergeConcepts(context?.concepts, context?.toolName, context?.branchName, eventType, content),
+            };
+            if (eventType === 'decision') {
+                await collector.decision(captureContent, captureOptions);
+                return;
+            }
+            if (eventType === 'attempt') {
+                await collector.attempt(captureContent, captureOptions);
+                return;
+            }
+            if (eventType === 'convention') {
+                await collector.convention(captureContent, captureOptions);
+                return;
+            }
+            if (eventType === 'branch_event') {
+                await collector.branchEvent(captureContent, captureOptions);
+                return;
+            }
+            await collector.observation(captureContent, captureOptions);
+        },
+        async onSessionEnd(summary) {
+            await collector.sessionEnd(summary ?? 'Session ended');
+        },
+    };
+}
+export function inferToolUseEventType(content, context) {
+    if (context?.eventTypeHint) {
+        return context.eventTypeHint;
+    }
+    const normalized = normalizeText(`${context?.toolName ?? ''} ${context?.error ?? ''} ${content}`);
+    if (isBranchEvent(normalized, context?.branchName)) {
+        return 'branch_event';
+    }
+    if (isConvention(normalized)) {
+        return 'convention';
+    }
+    if (context?.status === 'error' || isFailedAttempt(normalized)) {
+        return 'attempt';
+    }
+    if (isDecision(normalized)) {
+        return 'decision';
+    }
+    return 'observation';
+}
+function isBranchEvent(content, branchName) {
+    return Boolean(branchName && /\b(branch|merge|merged|rebase|rebased|checkout|checked out|abandon|abandoned|cherry-pick|pr)\b/i.test(content));
+}
+function isConvention(content) {
+    return (/\b(convention|standard|guideline|pattern|policy)\b/i.test(content)
+        || /\b(always|never|must|should)\b/i.test(content) && /\b(use|keep|store|put|place|route|name)\b/i.test(content)
+        || /\ball\s+[a-z0-9_/-]+\s+(routes|files|tests|components|handlers|schemas)\b/i.test(content));
+}
+function isFailedAttempt(content) {
+    return (/\b(tried|attempted|attempt|failed|failure|broke|broken|reverted|rollback|rolled back|did not work|error|exception|timeout)\b/i.test(content)
+        || /\bfix attempt\b/i.test(content));
+}
+function isDecision(content) {
+    return /\b(decided|decision|choose|chose|picked|standardized|settled on|adopted|switched to|going with|moved to)\b/i.test(content);
+}
+function formatToolUseContent(content, context) {
+    const normalizedContent = normalizeText(content);
+    if (!normalizedContent) {
+        return context?.toolName ? `Tool ${context.toolName} executed.` : 'Tool executed.';
+    }
+    const toolPrefix = context?.toolName && !normalizedContent.toLowerCase().includes(context.toolName.toLowerCase())
+        ? `${context.toolName}: `
+        : '';
+    const errorSuffix = context?.status === 'error' && context.error
+        ? ` Error: ${normalizeText(context.error)}`
+        : '';
+    return `${toolPrefix}${normalizedContent}${errorSuffix}`.trim();
+}
+function normalizePrompt(prompt) {
+    return `User request: ${normalizeText(prompt)}`;
+}
+function extractPromptConcepts(prompt) {
+    return normalizeText(prompt)
+        .toLowerCase()
+        .split(/[^a-z0-9_.-]+/)
+        .filter((token) => token.length >= 4)
+        .slice(0, 8);
+}
+function mergeConcepts(concepts, toolName, branchName, eventType, content) {
+    const merged = new Set();
+    for (const concept of concepts ?? []) {
+        maybeAddConcept(merged, concept);
+    }
+    maybeAddConcept(merged, toolName);
+    maybeAddConcept(merged, branchName);
+    maybeAddConcept(merged, eventType);
+    for (const token of normalizeText(content).split(/[^a-zA-Z0-9_.-]+/)) {
+        maybeAddConcept(merged, token);
+        if (merged.size >= 8) {
+            break;
+        }
+    }
+    return merged.size > 0 ? Array.from(merged).slice(0, 8) : undefined;
+}
+function maybeAddConcept(target, token) {
+    if (!token) {
+        return;
+    }
+    const normalized = token.toLowerCase();
+    if (normalized.length < 4 || /^\d+$/.test(normalized)) {
+        return;
+    }
+    target.add(normalized);
+}
+function normalizeText(value) {
+    return value.replace(/\s+/g, ' ').trim();
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

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

package/dist/hooks.test.d.ts

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

package/dist/hooks.test.d.ts.map

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

package/dist/hooks.test.js

@@ -0,0 +1,94 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { createHooks, inferToolUseEventType } from './hooks/index.js';
+function createMockCollector() {
+    const calls = [];
+    return {
+        calls,
+        collector: {
+            async sessionStart() {
+                calls.push({ method: 'sessionStart' });
+            },
+            async prompt(content, opts) {
+                calls.push({ method: 'prompt', content, opts });
+            },
+            async observation(content, opts) {
+                calls.push({ method: 'observation', content, opts });
+            },
+            async decision(content, opts) {
+                calls.push({ method: 'decision', content, opts });
+            },
+            async attempt(content, opts) {
+                calls.push({ method: 'attempt', content, opts });
+            },
+            async convention(content, opts) {
+                calls.push({ method: 'convention', content, opts });
+            },
+            async branchEvent(content, opts) {
+                calls.push({ method: 'branchEvent', content, opts });
+            },
+            async sessionEnd(summary) {
+                calls.push({ method: 'sessionEnd', content: summary });
+            },
+        },
+    };
+}
+test('hooks send user prompts as prompt events with request framing', async () => {
+    const mock = createMockCollector();
+    const hooks = createHooks(mock.collector);
+    await hooks.onPrompt('Add WorkOS auth to the dashboard');
+    assert.deepEqual(mock.calls, [
+        {
+            method: 'prompt',
+            content: 'User request: Add WorkOS auth to the dashboard',
+            opts: {
+                concepts: ['workos', 'auth', 'dashboard'],
+            },
+        },
+    ]);
+});
+test('hooks classify decisions, attempts, conventions, and branch events', async () => {
+    const mock = createMockCollector();
+    const hooks = createHooks(mock.collector);
+    await hooks.onToolUse('Decided to use Postgres for auth sessions because cold starts were hurting latency.', {
+        toolName: 'Write',
+        modified: ['src/auth/session.ts'],
+    });
+    await hooks.onToolUse('Tried middleware auth redirects and reverted after it broke streaming responses.', {
+        toolName: 'Edit',
+        status: 'error',
+        error: 'Streaming response aborted',
+        modified: ['src/auth/middleware.ts'],
+    });
+    await hooks.onToolUse('All API routes should live in src/api and use the Hono router.', {
+        toolName: 'Read',
+    });
+    await hooks.onToolUse('Merged feature/oauth into main after the PR passed.', {
+        toolName: 'Bash',
+        branchName: 'feature/oauth',
+    });
+    assert.equal(mock.calls[0]?.method, 'decision');
+    assert.match(mock.calls[0]?.content ?? '', /^Write: Decided to use Postgres/);
+    assert.equal(mock.calls[1]?.method, 'attempt');
+    assert.match(mock.calls[1]?.content ?? '', /Error: Streaming response aborted/);
+    assert.equal(mock.calls[2]?.method, 'convention');
+    assert.equal(mock.calls[3]?.method, 'branchEvent');
+    assert.deepEqual(mock.calls[3]?.opts, {
+        filesRead: undefined,
+        filesModified: undefined,
+        branchName: 'feature/oauth',
+        concepts: ['bash', 'feature/oauth', 'branch_event', 'merged', 'feature', 'oauth', 'into', 'main'],
+    });
+});
+test('inferToolUseEventType respects hints and failure signals', () => {
+    assert.equal(inferToolUseEventType('This would normally look like a decision.', {
+        eventTypeHint: 'attempt',
+    }), 'attempt');
+    assert.equal(inferToolUseEventType('Updated oauth callback flow.', {
+        status: 'error',
+    }), 'attempt');
+    assert.equal(inferToolUseEventType('Observed the auth config and test layout.', {
+        toolName: 'Read',
+    }), 'observation');
+});
+//# sourceMappingURL=hooks.test.js.map

package/dist/hooks.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { Collector, type SessionSummary } from './capture.js';
+export { createHooks, type HookEvent, type HookHandlers, type ToolUseContext, } from './hooks/index.js';
+export { buildCursorRulesContent, estimateCursorRulesTokens, writeCursorRules, readCursorRules, removeCursorRules, DEFAULT_CURSOR_RULES_TOKEN_BUDGET, type CursorRulesContext, } from './cursor-rules.js';
+export { createCollectorFromConfig, getMemoireConfigPath, readMemoireConfig, type ConfigPathOptions, type CollectorFromConfigOptions, } from './config.js';
+export { generateHooksJson, generateSetupInstructions, installCursorHooks, type CursorHooksConfig, } from './cursor-hooks.js';
+export { stripPrivateTags, stripPrivateFromOptions } from './strip-private.js';
+export { ContentDedup } from './dedup.js';
+export { ClientSummarizer, type ClientSummarizerConfig, type ClientSummaryResult } from './client-summarizer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,WAAW,EACX,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,iCAAiC,EACjC,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,GAChC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,EAClB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { Collector } from './capture.js';
+export { createHooks, } from './hooks/index.js';
+export { buildCursorRulesContent, estimateCursorRulesTokens, writeCursorRules, readCursorRules, removeCursorRules, DEFAULT_CURSOR_RULES_TOKEN_BUDGET, } from './cursor-rules.js';
+export { createCollectorFromConfig, getMemoireConfigPath, readMemoireConfig, } from './config.js';
+export { generateHooksJson, generateSetupInstructions, installCursorHooks, } from './cursor-hooks.js';
+export { stripPrivateTags, stripPrivateFromOptions } from './strip-private.js';
+export { ContentDedup } from './dedup.js';
+export { ClientSummarizer } from './client-summarizer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAuB,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,WAAW,GAIZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,iCAAiC,GAElC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,GAGlB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,GAEnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAyD,MAAM,wBAAwB,CAAC"}

package/dist/strip-private.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Strip <private>...</private> tags and their content from text
+ * before it reaches storage. Prevents sensitive data (credentials,
+ * tokens, PII) from being persisted in the memory layer.
+ *
+ * Mirrors claude-mem's tag-stripping.ts edge processing.
+ */
+/** Remove all <private>…</private> blocks from content */
+export declare function stripPrivateTags(content: string): string;
+/** Strip private tags from all string fields in an options bag */
+export declare function stripPrivateFromOptions<T extends Record<string, unknown>>(opts: T | undefined): T | undefined;
+//# sourceMappingURL=strip-private.d.ts.map

package/dist/strip-private.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-private.d.ts","sourceRoot":"","sources":["../src/strip-private.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvE,IAAI,EAAE,CAAC,GAAG,SAAS,GAClB,CAAC,GAAG,SAAS,CAef"}

package/dist/strip-private.js

@@ -0,0 +1,28 @@
+/**
+ * Strip <private>...</private> tags and their content from text
+ * before it reaches storage. Prevents sensitive data (credentials,
+ * tokens, PII) from being persisted in the memory layer.
+ *
+ * Mirrors claude-mem's tag-stripping.ts edge processing.
+ */
+const PRIVATE_TAG_RE = /<private>[\s\S]*?<\/private>/gi;
+/** Remove all <private>…</private> blocks from content */
+export function stripPrivateTags(content) {
+    return content.replace(PRIVATE_TAG_RE, '').replace(/\s{2,}/g, ' ').trim();
+}
+/** Strip private tags from all string fields in an options bag */
+export function stripPrivateFromOptions(opts) {
+    if (!opts)
+        return opts;
+    const cleaned = { ...opts };
+    for (const [key, value] of Object.entries(cleaned)) {
+        if (typeof value === 'string') {
+            cleaned[key] = stripPrivateTags(value);
+        }
+        if (Array.isArray(value)) {
+            cleaned[key] = value.map((v) => typeof v === 'string' ? stripPrivateTags(v) : v);
+        }
+    }
+    return cleaned;
+}
+//# sourceMappingURL=strip-private.js.map

package/dist/strip-private.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-private.js","sourceRoot":"","sources":["../src/strip-private.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,cAAc,GAAG,gCAAgC,CAAC;AAExD,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5E,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,uBAAuB,CACrC,IAAmB;IAEnB,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,OAAO,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAmC,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAmC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1D,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAChD,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/strip-private.test.d.ts

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

package/dist/strip-private.test.d.ts.map

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

package/dist/strip-private.test.js

@@ -0,0 +1,37 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { stripPrivateTags, stripPrivateFromOptions } from './strip-private.js';
+test('stripPrivateTags removes single private block', () => {
+    assert.equal(stripPrivateTags('before <private>secret token abc123</private> after'), 'before after');
+});
+test('stripPrivateTags removes multiple private blocks', () => {
+    assert.equal(stripPrivateTags('a <private>x</private> b <private>y</private> c'), 'a b c');
+});
+test('stripPrivateTags handles multiline private content', () => {
+    const input = `config loaded\n<private>\nAPI_KEY=sk-123\nDB_PASS=hunter2\n</private>\nproceeding`;
+    assert.equal(stripPrivateTags(input), 'config loaded proceeding');
+});
+test('stripPrivateTags is case-insensitive', () => {
+    assert.equal(stripPrivateTags('x <PRIVATE>secret</PRIVATE> y'), 'x y');
+    assert.equal(stripPrivateTags('x <Private>secret</Private> y'), 'x y');
+});
+test('stripPrivateTags returns content unchanged when no tags present', () => {
+    assert.equal(stripPrivateTags('no secrets here'), 'no secrets here');
+});
+test('stripPrivateTags returns empty string for fully private content', () => {
+    assert.equal(stripPrivateTags('<private>everything is secret</private>'), '');
+});
+test('stripPrivateFromOptions strips strings and string arrays', () => {
+    const result = stripPrivateFromOptions({
+        content: 'visible <private>hidden</private> text',
+        files: ['path/<private>secret</private>/file.ts', 'clean.ts'],
+        count: 42,
+    });
+    assert.equal(result?.content, 'visible text');
+    assert.deepEqual(result?.files, ['path//file.ts', 'clean.ts']);
+    assert.equal(result?.count, 42);
+});
+test('stripPrivateFromOptions returns undefined for undefined input', () => {
+    assert.equal(stripPrivateFromOptions(undefined), undefined);
+});
+//# sourceMappingURL=strip-private.test.js.map

package/dist/strip-private.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-private.test.js","sourceRoot":"","sources":["../src/strip-private.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;IACzD,MAAM,CAAC,KAAK,CACV,gBAAgB,CAAC,qDAAqD,CAAC,EACvE,cAAc,CACf,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAC5D,MAAM,CAAC,KAAK,CACV,gBAAgB,CAAC,iDAAiD,CAAC,EACnE,OAAO,CACR,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAC9D,MAAM,KAAK,GAAG,mFAAmF,CAAC;IAClG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,0BAA0B,CAAC,CAAC;AACpE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sCAAsC,EAAE,GAAG,EAAE;IAChD,MAAM,CAAC,KAAK,CACV,gBAAgB,CAAC,+BAA+B,CAAC,EACjD,KAAK,CACN,CAAC;IACF,MAAM,CAAC,KAAK,CACV,gBAAgB,CAAC,+BAA+B,CAAC,EACjD,KAAK,CACN,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iEAAiE,EAAE,GAAG,EAAE;IAC3E,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC,CAAC;AACvE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iEAAiE,EAAE,GAAG,EAAE;IAC3E,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,yCAAyC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0DAA0D,EAAE,GAAG,EAAE;IACpE,MAAM,MAAM,GAAG,uBAAuB,CAAC;QACrC,OAAO,EAAE,wCAAwC;QACjD,KAAK,EAAE,CAAC,wCAAwC,EAAE,UAAU,CAAC;QAC7D,KAAK,EAAE,EAAE;KACV,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAC9C,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC,CAAC;IAC/D,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;AAClC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+DAA+D,EAAE,GAAG,EAAE;IACzE,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;AAC9D,CAAC,CAAC,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,3 @@
+/** Simple nanoid-like ID generator (no dependencies) */
+export declare function nanoid(size?: number): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,wBAAgB,MAAM,CAAC,IAAI,SAAK,GAAG,MAAM,CAQxC"}

package/dist/utils.js

@@ -0,0 +1,11 @@
+/** Simple nanoid-like ID generator (no dependencies) */
+export function nanoid(size = 21) {
+    const alphabet = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
+    const bytes = crypto.getRandomValues(new Uint8Array(size));
+    let id = '';
+    for (const byte of bytes) {
+        id += alphabet[byte % alphabet.length];
+    }
+    return id;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,UAAU,MAAM,CAAC,IAAI,GAAG,EAAE;IAC9B,MAAM,QAAQ,GAAG,gEAAgE,CAAC;IAClF,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3D,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,EAAE,IAAI,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}