synabun 1.3.0 → 2.0.0

package/mcp-server/dist/tools/reflect.js

@@ -0,0 +1,157 @@
+import { z } from 'zod';
+import { getMemory, updatePayload, upsertMemory, getDb, memoryVectors } from '../services/sqlite.js';
+import { generateEmbedding } from '../services/local-embeddings.js';
+import { validateCategory } from '../services/categories.js';
+import { coerceStringArray } from './utils.js';
+import { invalidateCache } from '../services/neural-interface.js';
+import { computeChecksums } from '../services/file-checksums.js';
+import { text } from './response.js';
+import { memoryRevision, setRelation } from '../services/memory-maintenance.js';
+import { redactSecrets } from '../services/secret-gate.js';
+import { projectRoot } from '../config.js';
+import { callerMemoryContext } from '../services/identity.js';
+export function buildReflectSchema() {
+    return {
+        expected_revision: z.coerce.number().int().min(1).optional().describe('Reject if the memory changed since this revision.'),
+        supersedes: z.string().uuid().optional().describe('Explicitly mark another memory in this project as superseded by this one.'),
+        memory_id: z.string().describe('The ID of the memory to update. MUST be the full UUID format (e.g., 8f7cab3b-644e-4cea-8662-de0ca695bdf2), not a shortened version. Use recall to get the full UUID.'),
+        content: z
+            .string()
+            .optional()
+            .describe('Updated content. If provided, the embedding vector is regenerated.'),
+        importance: z.coerce.number().min(1).max(10).optional().describe('Updated importance score.'),
+        tags: coerceStringArray()
+            .optional()
+            .describe('Replace all tags with these.'),
+        add_tags: coerceStringArray()
+            .optional()
+            .describe('Add tags without replacing existing ones.'),
+        subcategory: z.string().optional().describe('Updated subcategory.'),
+        category: z
+            .string()
+            .optional()
+            .describe('Change the category name.'),
+        related_files: coerceStringArray()
+            .optional()
+            .describe('Updated related file paths.'),
+        related_memory_ids: coerceStringArray()
+            .optional()
+            .describe('Link to related memories.'),
+        project: z.string().optional().describe('Change the project this memory belongs to (e.g. "my-web-app", "synabun").'),
+    };
+}
+export const reflectSchema = buildReflectSchema();
+export const reflectDescription = 'Update or annotate an existing memory. Use this when you discover additional context, when a decision changes, or when you want to adjust importance based on new information.';
+export async function handleReflect(args) {
+    const memoryId = args.memory_id;
+    // Validate UUID format
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    if (!uuidRegex.test(memoryId)) {
+        return text(`Invalid memory_id format. Expected full UUID (e.g., 8f7cab3b-644e-4cea-8662-de0ca695bdf2), got: ${memoryId}\n\nUse the full UUID returned by 'remember', or call 'recall' to find the full UUID of an existing memory.`);
+    }
+    if (args.category) {
+        const catCheck = validateCategory(args.category);
+        if (!catCheck.valid) {
+            return text(catCheck.error);
+        }
+    }
+    const existing = await getMemory(memoryId);
+    if (!existing) {
+        return text(`Memory "${memoryId}" not found.`);
+    }
+    const expected = args.expected_revision ?? memoryRevision(memoryId);
+    const payload = existing.payload;
+    const now = new Date().toISOString();
+    const updates = { updated_at: now };
+    const changes = [];
+    let redactions = 0;
+    if (args.content) {
+        // Same gate as remember: an update must not smuggle a credential in.
+        const gate = await redactSecrets(args.content, { entityId: memoryId, origin: 'tool', project: payload.project, sessionId: callerMemoryContext().session ?? null });
+        if (gate.refused) {
+            return { ...text('Refused: the new content would be nothing but a credential. Store where the secret lives, never the secret itself.'), isError: true };
+        }
+        updates.content = gate.text;
+        redactions = gate.redactions.length;
+        changes.push(redactions ? `content (redacted ${redactions} credential-looking value${redactions === 1 ? '' : 's'})` : 'content');
+    }
+    if (args.importance !== undefined) {
+        updates.importance = args.importance;
+        changes.push(`importance -> ${args.importance}`);
+    }
+    if (args.category) {
+        updates.category = args.category;
+        changes.push(`category -> ${args.category}`);
+    }
+    if (args.subcategory) {
+        updates.subcategory = args.subcategory;
+        changes.push(`subcategory -> ${args.subcategory}`);
+    }
+    if (args.tags) {
+        updates.tags = args.tags;
+        changes.push(`tags replaced`);
+    }
+    if (args.add_tags) {
+        const existingTags = payload.tags || [];
+        updates.tags = [...new Set([...existingTags, ...args.add_tags])];
+        changes.push(`tags added: ${args.add_tags.join(', ')}`);
+    }
+    if (redactions)
+        updates.tags = [...new Set([...(updates.tags ?? payload.tags ?? []), 'redacted'])];
+    if (args.related_files) {
+        updates.related_files = args.related_files;
+        changes.push('related_files updated');
+    }
+    if (args.related_memory_ids) {
+        updates.related_memory_ids = args.related_memory_ids;
+        changes.push('related_memory_ids updated');
+    }
+    if (args.project) {
+        updates.project = args.project;
+        changes.push(`project -> ${args.project}`);
+    }
+    if (args.supersedes)
+        changes.push(`supersedes ${args.supersedes}`);
+    if (changes.length === 0) {
+        return text('No changes specified.');
+    }
+    // Recompute file checksums whenever the memory is updated
+    const finalFiles = (updates.related_files ?? payload.related_files);
+    if (finalFiles?.length && (args.content || args.related_files)) {
+        const cs = computeChecksums(finalFiles, projectRoot(updates.project ?? payload.project));
+        updates.file_checksums = Object.keys(cs).length > 0 ? cs : undefined;
+    }
+    let vector;
+    if (updates.content) {
+        try {
+            vector = await generateEmbedding(updates.content);
+        }
+        catch {
+            vector = new Array(384).fill(0);
+        }
+    }
+    const d = getDb();
+    d.exec('BEGIN IMMEDIATE');
+    try {
+        if (memoryRevision(memoryId) !== expected) {
+            d.exec('ROLLBACK');
+            return { ...text('Revision conflict: the memory changed. Fetch it again and merge your update.'), isError: true };
+        }
+        if (vector)
+            upsertMemory(memoryId, vector, { ...payload, ...updates });
+        else
+            updatePayload(memoryId, updates);
+        if (args.supersedes)
+            setRelation(memoryId, args.supersedes, 'supersedes');
+        d.exec('COMMIT');
+    }
+    catch (error) {
+        d.exec('ROLLBACK');
+        memoryVectors.invalidate();
+        return { ...text(error.message), isError: true };
+    }
+    // Invalidate Neural Interface link cache (fire-and-forget)
+    invalidateCache('reflect', memoryId);
+    return text(`Updated [${memoryId}]: ${changes.join(', ')}`);
+}
+//# sourceMappingURL=reflect.js.map

package/mcp-server/dist/tools/reflect.js.map

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

package/mcp-server/dist/tools/remember.d.ts

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { type CategoryJudgment } from '../services/memory-judgments.js';
+/**
+ * The categories a memory could be filed under, with their descriptions —
+ * leaves only (parents are containers). Above the cap, keep the caller's
+ * siblings and the top-level leaves so the request stays affordable.
+ */
+export declare function categoryOptions(current: string): Record<string, string | null>;
+/** Record what the judgment thought beside the writer's pick. Never re-routes. */
+export declare function recordCategoryJudgment(memoryId: string, verdict: CategoryJudgment | null): void;
+export declare function buildRememberSchema(): {
+    idempotency_key: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodEnum<["note", "decision", "issue", "preference", "fact", "session"]>>;
+    source_ref: z.ZodOptional<z.ZodString>;
+    content: z.ZodString;
+    category: z.ZodString;
+    project: z.ZodString;
+    tags: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+    importance: z.ZodOptional<z.ZodNumber>;
+    subcategory: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodEnum<["user-told", "self-discovered", "auto-saved"]>>;
+    related_files: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+};
+export declare const rememberSchema: {
+    idempotency_key: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodEnum<["note", "decision", "issue", "preference", "fact", "session"]>>;
+    source_ref: z.ZodOptional<z.ZodString>;
+    content: z.ZodString;
+    category: z.ZodString;
+    project: z.ZodString;
+    tags: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+    importance: z.ZodOptional<z.ZodNumber>;
+    subcategory: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodEnum<["user-told", "self-discovered", "auto-saved"]>>;
+    related_files: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+};
+export declare const rememberDescription = "Store a piece of information in persistent memory. Use this when you learn something important, make a decision, discover a pattern, fix a hard bug, or want to preserve context for future sessions.";
+export declare function handleRemember(args: {
+    content: string;
+    idempotency_key?: string;
+    kind?: string;
+    source_ref?: string;
+    category?: string;
+    project?: string;
+    tags?: string[];
+    importance?: number;
+    subcategory?: string;
+    source?: string;
+    related_files?: string[];
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+} | {
+    isError: boolean;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=remember.d.ts.map

package/mcp-server/dist/tools/remember.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember.d.ts","sourceRoot":"","sources":["../../src/tools/remember.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAMvF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAY9E;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAK/F;AAED,wBAAgB,mBAAmB;;;;;;;;;;;;EA6DlC;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;CAAwB,CAAC;AAEpD,eAAO,MAAM,mBAAmB,0MACyK,CAAC;AAsB1M,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAG7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;;;;;;;;;;;GA8EA"}

package/mcp-server/dist/tools/remember.js

@@ -0,0 +1,201 @@
+import { randomUUID } from 'node:crypto';
+import { writeMemory, IdempotencyConflict } from '../services/memory-writer.js';
+import { z } from 'zod';
+import { categoryExists, getAllCategories, getCategories } from '../services/categories.js';
+import { coerceStringArray } from './utils.js';
+import { detectProject, projectRoot } from '../config.js';
+import { computeChecksums } from '../services/file-checksums.js';
+import { text } from './response.js';
+import { callerMemoryContext } from '../services/identity.js';
+import { redactSecrets } from '../services/secret-gate.js';
+import { judgeCategory } from '../services/memory-judgments.js';
+import { surfaceConfig, relinkTypeSafeLog } from '../services/typesafe-config.js';
+import { getDb } from '../services/sqlite.js';
+const MAX_CATEGORY_OPTIONS = 60;
+/**
+ * The categories a memory could be filed under, with their descriptions —
+ * leaves only (parents are containers). Above the cap, keep the caller's
+ * siblings and the top-level leaves so the request stays affordable.
+ */
+export function categoryOptions(current) {
+    const all = getCategories();
+    const byName = new Map(all.map(c => [c.name, c]));
+    let pool = all.filter(c => !c.is_parent);
+    if (pool.length > MAX_CATEGORY_OPTIONS) {
+        const parent = byName.get(current)?.parent;
+        pool = pool.filter(c => c.name === current || (parent ? c.parent === parent : !c.parent)).slice(0, MAX_CATEGORY_OPTIONS);
+    }
+    const options = {};
+    for (const c of pool)
+        options[c.name] = c.description || null;
+    if (!(current in options))
+        options[current] = byName.get(current)?.description || null;
+    return options;
+}
+/** Record what the judgment thought beside the writer's pick. Never re-routes. */
+export function recordCategoryJudgment(memoryId, verdict) {
+    if (!verdict || verdict.category === 'none-of-these')
+        return;
+    try {
+        getDb().prepare('UPDATE memory_metadata SET category_judged=?, category_confidence=? WHERE memory_id=?').run(verdict.category, verdict.confidence, memoryId);
+    }
+    catch { /* the judgment is advisory; a missing column or row must not fail the write */ }
+}
+export function buildRememberSchema() {
+    return {
+        idempotency_key: z.string().min(1).max(200).optional().describe('Retry key scoped to project and category. Same key/content returns the existing UUID.'),
+        kind: z.enum(['note', 'decision', 'issue', 'preference', 'fact', 'session']).optional().describe('Memory kind; defaults to note.'),
+        source_ref: z.string().max(2000).optional().describe('Local session/event identifier or source reference.'),
+        content: z
+            .string()
+            .describe('The information to remember. Be specific and include context.'),
+        // category and project are REQUIRED on purpose. They were optional, and the
+        // description used to end "If omitted, a project default is used" — so hosts
+        // routinely sent { content } alone. Everything then landed in the fallback
+        // bucket, and the Claude Code stop hook (which keys off category) never
+        // cleared. A JSON Schema `required` entry is enforcement; a description is
+        // only advice, and the advice was already being ignored.
+        category: z
+            .string()
+            .min(1)
+            .describe('REQUIRED. Category name (top-level bucket) to file this memory under. ' +
+            'Call the category tool with action "list" for valid names, or action "create" ' +
+            'if nothing fits. Distinct from subcategory. An unrecognized name is still ' +
+            'accepted and remapped to a project default, but the memory is then filed in ' +
+            'the wrong bucket — pass a real one.'),
+        project: z
+            .string()
+            .min(1)
+            .describe('REQUIRED. Project this belongs to, lowercase kebab-case (e.g. "my-web-app", ' +
+            '"synabun"). Use the project named in your session context — this is NOT reliably ' +
+            'auto-detected over the HTTP transport, where every caller shares one process.'),
+        tags: coerceStringArray()
+            .optional()
+            .describe('Tags for categorization (e.g. ["redis", "cache", "pricing"])'),
+        importance: z
+            .coerce.number()
+            .min(1)
+            .max(10)
+            .optional()
+            .describe('Set this deliberately on every call: 1=trivial, 5=routine, 7=significant, ' +
+            '8+=critical. Use 8+ for hard-won bug fixes and architecture decisions. ' +
+            'Omit only when the work is genuinely routine (defaults to 5).'),
+        subcategory: z
+            .string()
+            .optional()
+            .describe('Optional refinement: architecture, bug-fix, api-quirk, performance, config, deployment, etc.'),
+        source: z
+            .enum(['user-told', 'self-discovered', 'auto-saved'])
+            .optional()
+            .describe('How this was learned. user-told=user explicitly shared, self-discovered=found during work, auto-saved=session context.'),
+        related_files: coerceStringArray()
+            .optional()
+            .describe('File paths this memory relates to.'),
+    };
+}
+export const rememberSchema = buildRememberSchema();
+export const rememberDescription = 'Store a piece of information in persistent memory. Use this when you learn something important, make a decision, discover a pattern, fix a hard bug, or want to preserve context for future sessions.';
+/**
+ * Resolve the category to store under. If the caller supplied a valid category,
+ * use it verbatim. Otherwise fall back to a project default so a memory is never
+ * lost just because the required field was omitted or misspelled.
+ * Returns the chosen category and whether a fallback was applied.
+ */
+function resolveCategory(requested, project) {
+    if (requested && categoryExists(requested)) {
+        return { category: requested, fallback: false };
+    }
+    const all = getAllCategories();
+    const projectDefault = `${project}-project`;
+    const chosen = (all.includes(projectDefault) && projectDefault) ||
+        (all.includes('conversations') && 'conversations') ||
+        all[0] ||
+        'conversations';
+    return { category: chosen, fallback: true };
+}
+export async function handleRemember(args) {
+    const project = args.project || detectProject();
+    // The id is chosen before any judgment so every write-time judgment
+    // (secret, category, duplicate) is logged against the memory it produced.
+    const provisionalId = randomUUID();
+    const judgeContext = { origin: 'tool', entityId: provisionalId, project, sessionId: callerMemoryContext().session ?? null };
+    // Secret gate first: nothing credential-shaped gets embedded or stored.
+    const gate = await redactSecrets(args.content, judgeContext);
+    if (gate.refused) {
+        return { ...text('Refused: this memory would be nothing but a credential. Store where the secret lives (the file path or the environment variable name), never the secret itself.'), isError: true };
+    }
+    const content = gate.text;
+    const { category, fallback: categoryFallback } = resolveCategory(args.category, project);
+    const tags = [...(args.tags || [])];
+    if (gate.redactions.length && !tags.includes('redacted'))
+        tags.push('redacted');
+    const importance = args.importance ?? 5;
+    const subcategory = args.subcategory;
+    const source = args.source || 'self-discovered';
+    const related_files = args.related_files;
+    const now = new Date().toISOString();
+    const payload = {
+        content,
+        category,
+        subcategory,
+        project,
+        tags,
+        importance,
+        source,
+        created_at: now,
+        updated_at: now,
+        accessed_at: now,
+        access_count: 0,
+        related_files,
+        file_checksums: (() => {
+            if (!related_files?.length)
+                return undefined;
+            const cs = computeChecksums(related_files, projectRoot(project));
+            return Object.keys(cs).length > 0 ? cs : undefined;
+        })(),
+    };
+    // The category check runs beside the write (both are round trips); its
+    // answer is recorded and reported, never applied.
+    const categorySettings = surfaceConfig('category-check');
+    const check = categorySettings.enabled
+        ? judgeCategory(content, category, categoryOptions(category), judgeContext).catch(() => null)
+        : Promise.resolve(null);
+    let result;
+    let verdict = null;
+    try {
+        [result, verdict] = await Promise.all([
+            writeMemory(payload, { idempotencyKey: args.idempotency_key, kind: args.kind, sourceRef: args.source_ref || callerMemoryContext().session, id: provisionalId, judge: judgeContext }),
+            check,
+        ]);
+    }
+    catch (error) {
+        if (error instanceof IdempotencyConflict)
+            return { ...text(error.message), isError: true };
+        throw error;
+    }
+    const { id, pending } = result;
+    // A duplicate or a retry answers with an existing id; point the rows logged
+    // under the id that was never stored at the memory the write resolved to.
+    if (id !== provisionalId)
+        relinkTypeSafeLog(provisionalId, id);
+    if (result.duplicate) {
+        return text(`Not stored — duplicate of [${id}] (P=${result.duplicate.probability.toFixed(2)}): that memory already states this. Use \`reflect\` on it to add what is new.`);
+    }
+    if (result.existing)
+        return text(`Remembered [${id}] (existing retry; no duplicate created).`);
+    recordCategoryJudgment(id, verdict);
+    const notes = [];
+    if (categoryFallback)
+        notes.push(`category ${args.category ? `"${args.category}" not found` : 'omitted'} — defaulted to "${category}"; pass a valid category next time`);
+    if (gate.redactions.length)
+        notes.push(`redacted ${gate.redactions.length} credential-looking value${gate.redactions.length === 1 ? '' : 's'}${gate.judged ? '' : ' (pattern match only)'}`);
+    if (verdict && verdict.confidence >= (categorySettings.minConfidence ?? 0.6)) {
+        if (verdict.category === 'none-of-these')
+            notes.push(`category check: no existing category fits well (${Math.round(verdict.confidence * 100)}%)`);
+        else if (verdict.category !== category)
+            notes.push(`category check: Jev suggests "${verdict.category}" (${Math.round(verdict.confidence * 100)}%) — stored under "${category}" as asked; review in Settings → Judgments → Misfiled`);
+    }
+    const note = notes.length ? ` (${notes.join('; ')})` : '';
+    return text(`Remembered [${id}] (${category}/${project}, importance: ${importance}): "${content.slice(0, 100)}${content.length > 100 ? '...' : ''}"${note}${pending ? ' (Saved durably; local semantic indexing pending.)' : ''}`);
+}
+//# sourceMappingURL=remember.js.map

package/mcp-server/dist/tools/remember.js.map

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

package/mcp-server/dist/tools/response.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MCP response helpers — eliminates verbose response object boilerplate.
+ * Inspired by FastMCP's approach of letting tools return simple values.
+ *
+ * Before:  return { content: [{ type: 'text' as const, text: msg }] };
+ * After:   return text(msg);
+ */
+/** Wrap a string in the MCP text response format. */
+export declare function text(msg: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/** Wrap base64 image data in the MCP image response format. */
+export declare function image(data: string, mimeType: string): {
+    content: {
+        type: "image";
+        data: string;
+        mimeType: string;
+    }[];
+};
+//# sourceMappingURL=response.d.ts.map

package/mcp-server/dist/tools/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/tools/response.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,qDAAqD;AACrD,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM;;;;;EAE/B;AAED,+DAA+D;AAC/D,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;;;;;;EAEnD"}

package/mcp-server/dist/tools/response.js

@@ -0,0 +1,24 @@
+/**
+ * MCP response helpers — eliminates verbose response object boilerplate.
+ * Inspired by FastMCP's approach of letting tools return simple values.
+ *
+ * Before:  return { content: [{ type: 'text' as const, text: msg }] };
+ * After:   return text(msg);
+ */
+/**
+ * Strip unpaired Unicode surrogates (U+D800–U+DFFF) that produce
+ * invalid JSON ("no low surrogate in string" API errors).
+ * Common in browser-extracted content from Facebook, WhatsApp, etc.
+ */
+function sanitizeSurrogates(s) {
+    return s.replace(/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g, '\uFFFD');
+}
+/** Wrap a string in the MCP text response format. */
+export function text(msg) {
+    return { content: [{ type: 'text', text: sanitizeSurrogates(msg) }] };
+}
+/** Wrap base64 image data in the MCP image response format. */
+export function image(data, mimeType) {
+    return { content: [{ type: 'image', data, mimeType }] };
+}
+//# sourceMappingURL=response.js.map

package/mcp-server/dist/tools/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../src/tools/response.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,CAAS;IACnC,OAAO,CAAC,CAAC,OAAO,CAAC,yEAAyE,EAAE,QAAQ,CAAC,CAAC;AACxG,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,QAAgB;IAClD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AACnE,CAAC"}

package/mcp-server/dist/tools/restore.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export declare const restoreSchema: {
+    memory_id: z.ZodString;
+};
+export declare const restoreDescription = "Restore a trashed memory by ID. Use this to undo a forget operation.";
+export declare function handleRestore(args: {
+    memory_id: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=restore.d.ts.map

package/mcp-server/dist/tools/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../src/tools/restore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,aAAa;;CAMzB,CAAC;AAEF,eAAO,MAAM,kBAAkB,yEACyC,CAAC;AAEzE,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE;;;;;GAiB9D"}

package/mcp-server/dist/tools/restore.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { restoreMemory, getMemory } from '../services/sqlite.js';
+import { text } from './response.js';
+export const restoreSchema = {
+    memory_id: z
+        .string()
+        .describe('The memory ID to restore from trash. Use the full UUID.'),
+};
+export const restoreDescription = 'Restore a trashed memory by ID. Use this to undo a forget operation.';
+export async function handleRestore(args) {
+    const memoryId = args.memory_id;
+    const existing = await getMemory(memoryId);
+    if (!existing) {
+        return text(`Memory "${memoryId}" not found.`);
+    }
+    const payload = existing.payload;
+    if (!payload.trashed_at) {
+        return text(`Memory [${memoryId.slice(0, 8)}] is not in trash.`);
+    }
+    await restoreMemory(memoryId);
+    return text(`Restored [${memoryId.slice(0, 8)}]: "${payload.content.slice(0, 80)}..."`);
+}
+//# sourceMappingURL=restore.js.map

package/mcp-server/dist/tools/restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../src/tools/restore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CACP,yDAAyD,CAC1D;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAC7B,sEAAsE,CAAC;AAEzE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAA2B;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;IAEhC,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,WAAW,QAAQ,cAAc,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAmC,CAAC;IAE7D,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,WAAW,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE9B,OAAO,IAAI,CAAC,aAAa,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;AAC1F,CAAC"}

package/mcp-server/dist/tools/style-guide-tools.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+export declare const styleGuideSchema: {
+    action: z.ZodDefault<z.ZodEnum<["get", "summary", "tokens", "contrast", "propose", "proposals", "export", "list"]>>;
+    projectPath: z.ZodOptional<z.ZodString>;
+    section: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<["json", "dtcg", "css", "tailwind-v4", "tailwind-v3"]>>;
+    theme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
+    taskClass: z.ZodOptional<z.ZodString>;
+    fg: z.ZodOptional<z.ZodString>;
+    bg: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodEnum<["normal", "large"]>>;
+    changes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    reason: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["pending", "accepted", "rejected"]>>;
+    formats: z.ZodOptional<z.ZodArray<z.ZodEnum<["design-md", "dtcg", "css", "tailwind-v4", "tailwind-v3", "tailwind"]>, "many">>;
+    runId: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+};
+export declare const styleGuideDescription = "A project's SynaBun Style Guide: brand, colors (light/dark), type, spacing, motion, components and rules, as a summary, the full DESIGN.md or tokens (CSS variables, Tailwind theme, W3C design tokens). Call it BEFORE UI, design, copy, marketing, image or video work and use its tokens instead of inventing values. Pass projectPath (your working directory). To change the guide, use action \"propose\": the user reviews proposals; never edit DESIGN.md or the token files by hand.";
+type Args = {
+    action?: string;
+    projectPath?: string;
+    section?: string;
+    format?: string;
+    theme?: string;
+    taskClass?: string;
+    fg?: string;
+    bg?: string;
+    size?: string;
+    changes?: Record<string, unknown>;
+    reason?: string;
+    status?: string;
+    formats?: string[];
+    runId?: string;
+    provider?: string;
+    model?: string;
+};
+/** The `## <name>` section of a Markdown file (case-insensitive, prefix match), or null with the names it has. */
+export declare function markdownSection(markdown: string, name: string): {
+    section: string | null;
+    names: string[];
+};
+export declare function handleStyleGuide(args: Args): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export {};
+//# sourceMappingURL=style-guide-tools.d.ts.map

package/mcp-server/dist/tools/style-guide-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-guide-tools.d.ts","sourceRoot":"","sources":["../../src/tools/style-guide-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;CAuB5B,CAAC;AAEF,eAAO,MAAM,qBAAqB,keAC8b,CAAC;AAEje,KAAK,IAAI,GAAG;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAwBF,kHAAkH;AAClH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAe3G;AAQD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,IAAI;;;;;GAIhD"}