memshare-mcp 0.2.6

package/dist/memory/store.js

@@ -0,0 +1,325 @@
+import { createHash, randomUUID } from "node:crypto";
+import { existsSync } from "node:fs";
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+import { Config, DEFAULT_CONFIG, MemoryItem, SuggestionFile, } from "./types.js";
+/**
+ * Where the store lives. MEMSHARE_DIR wins, so a second identity can run side
+ * by side on one machine -- which is also how the two-person sharing flow is
+ * tested without two laptops.
+ */
+export function resolveMemoryDir() {
+    const fromEnv = process.env.MEMSHARE_DIR;
+    if (fromEnv && fromEnv.trim() !== "")
+        return expandHome(fromEnv.trim());
+    return path.join(os.homedir(), ".memshare");
+}
+export function expandHome(p) {
+    if (p === "~")
+        return os.homedir();
+    if (p.startsWith("~/") || p.startsWith("~\\")) {
+        return path.join(os.homedir(), p.slice(2));
+    }
+    return path.resolve(p);
+}
+/** Stable identity for a memory's text, used to dedup on import. */
+export function contentKey(content) {
+    const normalised = content.trim().replace(/\s+/g, " ").toLowerCase();
+    return createHash("sha256").update(normalised, "utf8").digest("hex");
+}
+export class MemoryStore {
+    root;
+    constructor(root = resolveMemoryDir()) {
+        this.root = root;
+    }
+    get memoriesDir() {
+        return path.join(this.root, "memories");
+    }
+    get bundlesDir() {
+        return path.join(this.root, "bundles");
+    }
+    get configPath() {
+        return path.join(this.root, "config.json");
+    }
+    get suggestionsPath() {
+        return path.join(this.root, "suggestions.json");
+    }
+    exists() {
+        return existsSync(this.configPath);
+    }
+    /** Creates the directory layout and a config file. Safe to re-run. */
+    async init(overrides = {}) {
+        await fs.mkdir(this.memoriesDir, { recursive: true });
+        await fs.mkdir(this.bundlesDir, { recursive: true });
+        const existing = this.exists() ? await this.readConfig() : DEFAULT_CONFIG;
+        const config = Config.parse({ ...existing, ...overrides, memoryDir: this.root });
+        await this.writeConfig(config);
+        return config;
+    }
+    async readConfig() {
+        try {
+            const raw = await fs.readFile(this.configPath, "utf8");
+            return Config.parse(JSON.parse(raw));
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return { ...DEFAULT_CONFIG, memoryDir: this.root };
+            throw new Error(`Could not read ${this.configPath}: ${describe(err)}`);
+        }
+    }
+    async writeConfig(config) {
+        await fs.mkdir(this.root, { recursive: true });
+        await writeJsonAtomic(this.configPath, config);
+    }
+    itemPath(id) {
+        return path.join(this.memoriesDir, `mem_${id}.json`);
+    }
+    async add(input) {
+        const config = await this.readConfig();
+        const now = new Date().toISOString();
+        const item = MemoryItem.parse({
+            id: input.id ?? randomUUID(),
+            content: input.content.trim(),
+            tags: normaliseTags(input.tags ?? []),
+            source: {
+                tool: input.source?.tool ?? "cli",
+                ...(input.source?.sessionId ? { sessionId: input.source.sessionId } : {}),
+                timestamp: input.source?.timestamp ?? now,
+            },
+            confidence: input.confidence ?? "stated",
+            visibility: input.visibility ?? config.defaultVisibility,
+            createdAt: now,
+            updatedAt: now,
+            ...(input.expiresAt ? { expiresAt: input.expiresAt } : {}),
+            ...(input.importedFrom ? { importedFrom: input.importedFrom } : {}),
+        });
+        await fs.mkdir(this.memoriesDir, { recursive: true });
+        await writeJsonAtomic(this.itemPath(item.id), item);
+        return item;
+    }
+    async get(id) {
+        try {
+            const raw = await fs.readFile(this.itemPath(id), "utf8");
+            return MemoryItem.parse(JSON.parse(raw));
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return undefined;
+            throw err;
+        }
+    }
+    /** Every item on disk, newest first. Malformed files are skipped, not fatal. */
+    async all() {
+        let names;
+        try {
+            names = await fs.readdir(this.memoriesDir);
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return [];
+            throw err;
+        }
+        const items = [];
+        for (const name of names) {
+            if (!name.startsWith("mem_") || !name.endsWith(".json"))
+                continue;
+            try {
+                const raw = await fs.readFile(path.join(this.memoriesDir, name), "utf8");
+                items.push(MemoryItem.parse(JSON.parse(raw)));
+            }
+            catch {
+                // A corrupt or hand-edited file should not take down the whole store.
+                continue;
+            }
+        }
+        items.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+        return items;
+    }
+    async list(filter = {}) {
+        const now = Date.now();
+        const wanted = filter.tags ? normaliseTags(filter.tags) : undefined;
+        const query = filter.query?.trim().toLowerCase();
+        const tool = filter.tool?.trim().toLowerCase();
+        let items = await this.all();
+        items = items.filter((item) => {
+            if (!filter.includeExpired && isExpired(item, now))
+                return false;
+            if (filter.visibility && item.visibility !== filter.visibility)
+                return false;
+            if (filter.confidence && item.confidence !== filter.confidence)
+                return false;
+            if (tool && item.source.tool.toLowerCase() !== tool)
+                return false;
+            if (wanted && wanted.length > 0) {
+                if (!item.tags.some((t) => wanted.includes(t.toLowerCase())))
+                    return false;
+            }
+            if (query) {
+                const haystack = `${item.content} ${item.tags.join(" ")}`.toLowerCase();
+                if (!haystack.includes(query))
+                    return false;
+            }
+            return true;
+        });
+        if (filter.limit !== undefined && filter.limit >= 0) {
+            items = items.slice(0, filter.limit);
+        }
+        return items;
+    }
+    async update(id, patch) {
+        const current = await this.get(id);
+        if (!current)
+            return undefined;
+        const next = MemoryItem.parse({
+            ...current,
+            ...patch,
+            ...(patch.tags ? { tags: normaliseTags(patch.tags) } : {}),
+            updatedAt: new Date().toISOString(),
+        });
+        await writeJsonAtomic(this.itemPath(id), next);
+        return next;
+    }
+    async remove(id) {
+        try {
+            await fs.unlink(this.itemPath(id));
+            return true;
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return false;
+            throw err;
+        }
+    }
+    /** Deletes items whose expiresAt has passed. Returns how many went. */
+    async pruneExpired() {
+        const now = Date.now();
+        const items = await this.all();
+        let removed = 0;
+        for (const item of items) {
+            if (isExpired(item, now) && (await this.remove(item.id)))
+                removed += 1;
+        }
+        return removed;
+    }
+    async listTags() {
+        const items = await this.list();
+        const tags = new Set();
+        for (const item of items)
+            for (const tag of item.tags)
+                tags.add(tag);
+        return [...tags].sort((a, b) => a.localeCompare(b));
+    }
+    /** Content keys of every stored item, for import-time dedup. */
+    async contentKeys() {
+        const items = await this.all();
+        return new Set(items.map((i) => contentKey(i.content)));
+    }
+    async readSuggestions() {
+        try {
+            const raw = await fs.readFile(this.suggestionsPath, "utf8");
+            return SuggestionFile.parse(JSON.parse(raw)).suggestions;
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return [];
+            throw err;
+        }
+    }
+    async writeSuggestions(suggestions) {
+        await fs.mkdir(this.root, { recursive: true });
+        await writeJsonAtomic(this.suggestionsPath, { suggestions });
+    }
+    async addSuggestions(entries, source = {}) {
+        const now = new Date().toISOString();
+        const existing = await this.readSuggestions();
+        const seen = new Set(existing.map((s) => contentKey(s.content)));
+        const stored = await this.contentKeys();
+        const added = [];
+        for (const entry of entries) {
+            const content = entry.content.trim();
+            if (content === "")
+                continue;
+            const key = contentKey(content);
+            // Don't re-propose what is already pending or already saved.
+            if (seen.has(key) || stored.has(key))
+                continue;
+            seen.add(key);
+            added.push({
+                id: randomUUID(),
+                content,
+                tags: normaliseTags(entry.tags ?? []),
+                source: {
+                    tool: source.tool ?? "assistant",
+                    ...(source.sessionId ? { sessionId: source.sessionId } : {}),
+                    timestamp: source.timestamp ?? now,
+                },
+                suggestedAt: now,
+            });
+        }
+        if (added.length > 0)
+            await this.writeSuggestions([...existing, ...added]);
+        return added;
+    }
+    async removeSuggestions(ids) {
+        const drop = new Set(ids);
+        const remaining = (await this.readSuggestions()).filter((s) => !drop.has(s.id));
+        await this.writeSuggestions(remaining);
+    }
+}
+export function isExpired(item, now = Date.now()) {
+    if (!item.expiresAt)
+        return false;
+    const at = Date.parse(item.expiresAt);
+    return !Number.isNaN(at) && at <= now;
+}
+export function normaliseTags(tags) {
+    const out = [];
+    for (const raw of tags) {
+        const tag = raw.trim().toLowerCase();
+        if (tag !== "" && !out.includes(tag))
+            out.push(tag);
+    }
+    return out;
+}
+/** Parses --tags "a,b" (repeatable) into a flat tag list. */
+export function parseTagList(value) {
+    if (value === undefined)
+        return [];
+    const parts = Array.isArray(value) ? value : [value];
+    return normaliseTags(parts.flatMap((v) => v.split(",")));
+}
+/** Turns 7d / 12h / 30m, or an ISO date, into an absolute ISO timestamp. */
+export function parseDuration(value, from = new Date()) {
+    const match = /^(\d+)\s*([smhdw])$/i.exec(value.trim());
+    if (match) {
+        const amount = Number(match[1]);
+        const unit = match[2].toLowerCase();
+        const ms = {
+            s: 1000,
+            m: 60_000,
+            h: 3_600_000,
+            d: 86_400_000,
+            w: 604_800_000,
+        };
+        return new Date(from.getTime() + amount * ms[unit]).toISOString();
+    }
+    const parsed = Date.parse(value);
+    if (Number.isNaN(parsed)) {
+        throw new Error(`Cannot read "${value}" as a duration (try 7d, 12h) or a date.`);
+    }
+    return new Date(parsed).toISOString();
+}
+/** Write via temp file + rename so a crash can't leave a half-written record. */
+export async function writeJsonAtomic(file, data) {
+    const tmp = `${file}.${process.pid}.tmp`;
+    await fs.writeFile(tmp, `${JSON.stringify(data, null, 2)}\n`, "utf8");
+    await fs.rename(tmp, file);
+}
+function isNotFound(err) {
+    return err?.code === "ENOENT";
+}
+function describe(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=store.js.map

package/dist/memory/store.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,165 @@
+import { z } from "zod";
+/**
+ * Bundle schema version. Bump the minor when adding optional fields, the major
+ * when an old importer could misread a new bundle.
+ */
+export declare const SCHEMA_VERSION = "0.1.0";
+/** ISO-8601 timestamp. Kept permissive on purpose: any Date-parseable string. */
+export declare const IsoDateTime: z.ZodString;
+export declare const Confidence: z.ZodEnum<{
+    imported: "imported";
+    inferred: "inferred";
+    stated: "stated";
+}>;
+export type Confidence = z.infer<typeof Confidence>;
+export declare const Visibility: z.ZodEnum<{
+    private: "private";
+    shareable: "shareable";
+}>;
+export type Visibility = z.infer<typeof Visibility>;
+export declare const Mode: z.ZodEnum<{
+    auto: "auto";
+    manual: "manual";
+    suggest: "suggest";
+}>;
+export type Mode = z.infer<typeof Mode>;
+export declare const MemorySource: z.ZodObject<{
+    tool: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+export type MemorySource = z.infer<typeof MemorySource>;
+/** Set on items that arrived in someone else's bundle. */
+export declare const ImportProvenance: z.ZodObject<{
+    bundleId: z.ZodString;
+    exportedBy: z.ZodString;
+    importedAt: z.ZodString;
+    originalId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ImportProvenance = z.infer<typeof ImportProvenance>;
+export declare const MemoryItem: z.ZodObject<{
+    id: z.ZodString;
+    content: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    source: z.ZodObject<{
+        tool: z.ZodString;
+        sessionId: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodString;
+    }, z.core.$strip>;
+    confidence: z.ZodEnum<{
+        imported: "imported";
+        inferred: "inferred";
+        stated: "stated";
+    }>;
+    visibility: z.ZodEnum<{
+        private: "private";
+        shareable: "shareable";
+    }>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodString>;
+    importedFrom: z.ZodOptional<z.ZodObject<{
+        bundleId: z.ZodString;
+        exportedBy: z.ZodString;
+        importedAt: z.ZodString;
+        originalId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type MemoryItem = z.infer<typeof MemoryItem>;
+export declare const BundleMetadata: z.ZodObject<{
+    bundleId: z.ZodString;
+    exportedBy: z.ZodString;
+    exportedAt: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    exportedFor: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodString;
+    contentHash: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BundleMetadata = z.infer<typeof BundleMetadata>;
+export declare const MemoryBundle: z.ZodObject<{
+    metadata: z.ZodObject<{
+        bundleId: z.ZodString;
+        exportedBy: z.ZodString;
+        exportedAt: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        exportedFor: z.ZodOptional<z.ZodString>;
+        schemaVersion: z.ZodString;
+        contentHash: z.ZodString;
+        expiresAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        content: z.ZodString;
+        tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        source: z.ZodObject<{
+            tool: z.ZodString;
+            sessionId: z.ZodOptional<z.ZodString>;
+            timestamp: z.ZodString;
+        }, z.core.$strip>;
+        confidence: z.ZodEnum<{
+            imported: "imported";
+            inferred: "inferred";
+            stated: "stated";
+        }>;
+        visibility: z.ZodEnum<{
+            private: "private";
+            shareable: "shareable";
+        }>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        expiresAt: z.ZodOptional<z.ZodString>;
+        importedFrom: z.ZodOptional<z.ZodObject<{
+            bundleId: z.ZodString;
+            exportedBy: z.ZodString;
+            importedAt: z.ZodString;
+            originalId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type MemoryBundle = z.infer<typeof MemoryBundle>;
+export declare const Config: z.ZodObject<{
+    displayName: z.ZodDefault<z.ZodString>;
+    mode: z.ZodDefault<z.ZodEnum<{
+        auto: "auto";
+        manual: "manual";
+        suggest: "suggest";
+    }>>;
+    defaultVisibility: z.ZodDefault<z.ZodEnum<{
+        private: "private";
+        shareable: "shareable";
+    }>>;
+    autoRedactPII: z.ZodDefault<z.ZodBoolean>;
+    autoProjectTag: z.ZodDefault<z.ZodBoolean>;
+    memoryDir: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof Config>;
+export declare const DEFAULT_CONFIG: Config;
+/** A pending item proposed by an assistant in "suggest" mode. */
+export declare const Suggestion: z.ZodObject<{
+    id: z.ZodString;
+    content: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    source: z.ZodObject<{
+        tool: z.ZodString;
+        sessionId: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodString;
+    }, z.core.$strip>;
+    suggestedAt: z.ZodString;
+}, z.core.$strip>;
+export type Suggestion = z.infer<typeof Suggestion>;
+export declare const SuggestionFile: z.ZodObject<{
+    suggestions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        content: z.ZodString;
+        tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        source: z.ZodObject<{
+            tool: z.ZodString;
+            sessionId: z.ZodOptional<z.ZodString>;
+            timestamp: z.ZodString;
+        }, z.core.$strip>;
+        suggestedAt: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type SuggestionFile = z.infer<typeof SuggestionFile>;
+//# sourceMappingURL=types.d.ts.map

package/dist/memory/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,iFAAiF;AACjF,eAAO,MAAM,WAAW,aAIpB,CAAC;AAEL,eAAO,MAAM,UAAU;;;;EAA6C,CAAC;AACrE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,UAAU;;;EAAmC,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,IAAI;;;;EAAwC,CAAC;AAC1D,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,eAAO,MAAM,YAAY;;;;iBAKvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB;;;;;iBAM3B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAWrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,cAAc;;;;;;;;;iBAYzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;iBASjB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C,eAAO,MAAM,cAAc,EAAE,MAO5B,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,UAAU;;;;;;;;;;iBAMrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,cAAc;;;;;;;;;;;;iBAEzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/memory/types.js

@@ -0,0 +1,88 @@
+import { z } from "zod";
+/**
+ * Bundle schema version. Bump the minor when adding optional fields, the major
+ * when an old importer could misread a new bundle.
+ */
+export const SCHEMA_VERSION = "0.1.0";
+/** ISO-8601 timestamp. Kept permissive on purpose: any Date-parseable string. */
+export const IsoDateTime = z
+    .string()
+    .refine((s) => !Number.isNaN(Date.parse(s)), {
+    message: "must be an ISO-8601 timestamp",
+});
+export const Confidence = z.enum(["stated", "inferred", "imported"]);
+export const Visibility = z.enum(["private", "shareable"]);
+export const Mode = z.enum(["auto", "suggest", "manual"]);
+export const MemorySource = z.object({
+    /** Which adapter wrote this: "claude", "chatgpt", "cli", "import", ... */
+    tool: z.string().min(1),
+    sessionId: z.string().optional(),
+    timestamp: IsoDateTime,
+});
+/** Set on items that arrived in someone else's bundle. */
+export const ImportProvenance = z.object({
+    bundleId: z.string().min(1),
+    exportedBy: z.string().min(1),
+    importedAt: IsoDateTime,
+    /** The id the item had in the sender's store. */
+    originalId: z.string().min(1).optional(),
+});
+export const MemoryItem = z.object({
+    id: z.string().min(1),
+    content: z.string().min(1),
+    tags: z.array(z.string().min(1)).default([]),
+    source: MemorySource,
+    confidence: Confidence,
+    visibility: Visibility,
+    createdAt: IsoDateTime,
+    updatedAt: IsoDateTime,
+    expiresAt: IsoDateTime.optional(),
+    importedFrom: ImportProvenance.optional(),
+});
+export const BundleMetadata = z.object({
+    bundleId: z.string().min(1),
+    /** A display name, deliberately not a verified identity. */
+    exportedBy: z.string().min(1),
+    exportedAt: IsoDateTime,
+    /** Free-text note for the recipient, and who it was prepared for. */
+    description: z.string().optional(),
+    exportedFor: z.string().optional(),
+    schemaVersion: z.string().min(1),
+    /** SHA-256 over the canonicalised `items` array. */
+    contentHash: z.string().length(64),
+    expiresAt: IsoDateTime.optional(),
+});
+export const MemoryBundle = z.object({
+    metadata: BundleMetadata,
+    items: z.array(MemoryItem),
+});
+export const Config = z.object({
+    displayName: z.string().min(1).default("anonymous"),
+    mode: Mode.default("auto"),
+    defaultVisibility: Visibility.default("private"),
+    autoRedactPII: z.boolean().default(true),
+    /** Tag captured memories with the current git repo / folder name. */
+    autoProjectTag: z.boolean().default(true),
+    /** Informational: the live location always comes from resolveMemoryDir(). */
+    memoryDir: z.string().default("~/.memshare"),
+});
+export const DEFAULT_CONFIG = {
+    displayName: "anonymous",
+    mode: "auto",
+    defaultVisibility: "private",
+    autoRedactPII: true,
+    autoProjectTag: true,
+    memoryDir: "~/.memshare",
+};
+/** A pending item proposed by an assistant in "suggest" mode. */
+export const Suggestion = z.object({
+    id: z.string().min(1),
+    content: z.string().min(1),
+    tags: z.array(z.string().min(1)).default([]),
+    source: MemorySource,
+    suggestedAt: IsoDateTime,
+});
+export const SuggestionFile = z.object({
+    suggestions: z.array(Suggestion).default([]),
+});
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

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

package/dist/sharing/bundle.d.ts

@@ -0,0 +1,36 @@
+import { MemoryBundle, type MemoryItem } from "../memory/types.js";
+export declare const BUNDLE_EXTENSION = ".memshare.json";
+/**
+ * Deterministic JSON: object keys sorted, no incidental whitespace. Two people
+ * hashing the same items must get the same digest, whatever order their
+ * JSON runtime happened to produce.
+ */
+export declare function canonicalize(value: unknown): string;
+/** SHA-256 over the canonicalised items array. */
+export declare function computeContentHash(items: MemoryItem[]): string;
+export interface CreateBundleOptions {
+    items: MemoryItem[];
+    /** Display name of the sender. Not a verified identity. */
+    exportedBy: string;
+    description?: string;
+    exportedFor?: string;
+    /** Absolute ISO timestamp after which the recipient should refuse it. */
+    expiresAt?: string;
+}
+export declare function createBundle(options: CreateBundleOptions): MemoryBundle;
+/** e.g. `bundle-a3f8c2d1.memshare.json` */
+export declare function bundleFileName(bundle: MemoryBundle): string;
+export interface ValidationResult {
+    ok: boolean;
+    bundle?: MemoryBundle;
+    /** Problems that make the bundle unsafe to import. */
+    errors: string[];
+    /** Problems worth showing the user, but not disqualifying. */
+    warnings: string[];
+}
+/** Schema, hash integrity, schema-version and expiry checks, in that order. */
+export declare function validateBundle(raw: unknown, now?: Date): ValidationResult;
+export declare function writeBundleFile(bundle: MemoryBundle, destination: string): Promise<string>;
+/** Reads and validates a bundle file. Never throws on bad content. */
+export declare function readBundleFile(file: string, now?: Date): Promise<ValidationResult>;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/sharing/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/sharing/bundle.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,YAAY,EAGZ,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOnD;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAE9D;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAavE;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAG3D;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,sDAAsD;IACtD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,GAAE,IAAiB,GAAG,gBAAgB,CAmDrF;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,sEAAsE;AACtE,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAuB3B"}