@rubytech/create-maxy-code 0.1.0

package/payload/platform/plugins/memory/mcp/dist/lib/__tests__/schema-loader.test.js.map

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

package/payload/platform/plugins/memory/mcp/dist/lib/__tests__/schema-validator.test.d.ts

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

package/payload/platform/plugins/memory/mcp/dist/lib/__tests__/schema-validator.test.d.ts.map

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

package/payload/platform/plugins/memory/mcp/dist/lib/__tests__/schema-validator.test.js

@@ -0,0 +1,448 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { validateWrite } from "../schema-validator.js";
+// ---------------------------------------------------------------------------
+// Fixture builders. These avoid hitting the real schema-*.md files so the
+// validator's behaviour can be asserted independently of the markdown
+// contents. The shape is byte-identical to what loadSchema() produces.
+// ---------------------------------------------------------------------------
+function makeSchema(opts) {
+    const markdownLabels = new Map();
+    for (const entry of opts.documented ?? []) {
+        markdownLabels.set(entry.label, {
+            label: entry.label,
+            required: entry.required,
+            sourceFile: entry.sourceFile ?? "schema-test.md",
+        });
+    }
+    const wrongToCorrect = new Map();
+    for (const [wrong, correct] of opts.synonyms ?? []) {
+        wrongToCorrect.set(wrong, { correct, sourceFile: "schema-test.md" });
+    }
+    const forbiddenByLabel = new Map();
+    for (const entry of opts.forbidden ?? []) {
+        let perLabel = forbiddenByLabel.get(entry.label);
+        if (!perLabel) {
+            perLabel = new Map();
+            forbiddenByLabel.set(entry.label, perLabel);
+        }
+        perLabel.set(entry.property, {
+            rationale: entry.rationale ?? "test rationale",
+            sourceFile: "schema-test.md",
+        });
+    }
+    return {
+        markdownLabels,
+        wrongToCorrect,
+        forbiddenByLabel,
+        sourceFiles: ["schema-test.md"],
+    };
+}
+function makeLiveSource(opts) {
+    const live = new Set(opts.live);
+    const declared = new Set(opts.declared);
+    return {
+        recognisedLabels: () => new Set([...live, ...declared]),
+        liveLabels: () => new Set(live),
+        declaredLabels: () => new Set(declared),
+        liveReady: () => true,
+    };
+}
+function captureEmits() {
+    const lines = [];
+    return { lines, emit: (line) => lines.push(line) };
+}
+// ---------------------------------------------------------------------------
+// (a) Live label not in markdown → accept, log markdown-skip
+// ---------------------------------------------------------------------------
+test("(a) live-only label, markdown-undocumented → accepted with markdown-undocumented log", () => {
+    // KnowledgeDocument is in db.labels() but has no markdown row.
+    const schema = makeSchema({});
+    const liveSource = makeLiveSource({
+        live: ["KnowledgeDocument", "Person"],
+        declared: [],
+    });
+    const { lines, emit } = captureEmits();
+    validateWrite({
+        labels: ["KnowledgeDocument"],
+        properties: { title: "x" },
+        accountId: "acct-1",
+    }, { schema, liveSource, emit });
+    const accepted = lines.find((l) => l.includes("outcome=accepted"));
+    assert.ok(accepted, `expected accepted log, got: ${lines.join(" | ")}`);
+    assert.match(accepted, /source=live/);
+    const skip = lines.find((l) => l.includes("markdown-undocumented"));
+    assert.ok(skip, `expected markdown-undocumented log, got: ${lines.join(" | ")}`);
+    assert.match(skip, /label=KnowledgeDocument/);
+});
+// ---------------------------------------------------------------------------
+// (b) Declared-but-not-live (fresh-install bootstrap) → accept
+// ---------------------------------------------------------------------------
+test("(b) declared-but-not-live LocalBusiness → accepted (bootstrap regression)", () => {
+    // The exact incident: fresh install, db.labels()=[AdminUser], schema.cypher
+    // declares LocalBusiness, agent writes LocalBusiness — must succeed.
+    const schema = makeSchema({});
+    const liveSource = makeLiveSource({
+        live: ["AdminUser"],
+        declared: ["AdminUser", "LocalBusiness", "Person"],
+    });
+    const { lines, emit } = captureEmits();
+    validateWrite({
+        labels: ["LocalBusiness"],
+        properties: { name: "Acme Plumbing" },
+        accountId: "acct-1",
+    }, { schema, liveSource, emit });
+    const accepted = lines.find((l) => l.includes("outcome=accepted"));
+    assert.ok(accepted);
+    assert.match(accepted, /source=declared/);
+});
+// ---------------------------------------------------------------------------
+// (c) Label absent from both → reject with structured error
+// ---------------------------------------------------------------------------
+test("(c) label absent from live and declared → reject with structured error", () => {
+    const schema = makeSchema({});
+    const liveSource = makeLiveSource({
+        live: ["Person", "LocalBusiness"],
+        declared: ["Person", "LocalBusiness", "AdminUser"],
+    });
+    const { lines, emit } = captureEmits();
+    assert.throws(() => validateWrite({
+        labels: ["Quokka"],
+        properties: {},
+        accountId: "acct-1",
+    }, { schema, liveSource, emit }), (err) => {
+        assert.match(err.message, /unknown Neo4j label/);
+        assert.match(err.message, /\[Quokka\]/);
+        assert.match(err.message, /Live db\.labels\(\): \[/);
+        assert.match(err.message, /Declared in schema\.cypher: \[/);
+        // Both source lists must include something so operators can grep.
+        assert.match(err.message, /Person/);
+        return true;
+    });
+    const rejected = lines.find((l) => l.includes("outcome=rejected"));
+    assert.ok(rejected);
+    assert.match(rejected, /source=neither/);
+});
+test("(c) typo gets Levenshtein 'did you mean?' suggestion", () => {
+    const schema = makeSchema({});
+    const liveSource = makeLiveSource({
+        live: ["Person", "LocalBusiness"],
+        declared: ["Person", "LocalBusiness"],
+    });
+    assert.throws(() => validateWrite(
+    // capital-I-as-l typo per the incident's exact failure mode
+    {
+        labels: ["LocaIBusiness"],
+        properties: {},
+        accountId: "acct-1",
+    }, { schema, liveSource }), (err) => {
+        assert.match(err.message, /Did you mean 'LocalBusiness'\?/);
+        return true;
+    });
+});
+// ---------------------------------------------------------------------------
+// (d) Required-property check fires only when label is documented
+// ---------------------------------------------------------------------------
+test("(d) required-property check runs for markdown-documented labels", () => {
+    const schema = makeSchema({
+        documented: [
+            {
+                label: "Person",
+                required: [{ kind: "simple", name: "givenName" }],
+            },
+        ],
+    });
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    assert.throws(() => validateWrite({
+        labels: ["Person"],
+        properties: { familyName: "Smith" }, // missing givenName
+        accountId: "acct-1",
+    }, { schema, liveSource }), /missing required property 'givenName' for label Person/);
+});
+test("(d) required-property check is SKIPPED for markdown-undocumented labels", () => {
+    // LocalBusiness is recognised (declared) but has no markdown row.
+    // Requiring properties that aren't documented would be impossible to
+    // express; the validator must accept the write.
+    const schema = makeSchema({});
+    const liveSource = makeLiveSource({
+        live: [],
+        declared: ["LocalBusiness"],
+    });
+    // No throw expected — properties are agent's responsibility for
+    // markdown-undocumented labels.
+    validateWrite({
+        labels: ["LocalBusiness"],
+        properties: {}, // intentionally empty
+        accountId: "acct-1",
+    }, { schema, liveSource });
+});
+// ---------------------------------------------------------------------------
+// (f) Synonym layer (wrongToCorrect) still rejects when triggered
+// ---------------------------------------------------------------------------
+test("(f) wrongToCorrect synonym still rejects firstName→givenName even on documented label", () => {
+    const schema = makeSchema({
+        documented: [
+            {
+                label: "Person",
+                required: [{ kind: "simple", name: "givenName" }],
+            },
+        ],
+        synonyms: [["firstName", "givenName"]],
+    });
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    assert.throws(() => validateWrite({
+        labels: ["Person"],
+        properties: { firstName: "Jane" },
+        accountId: "acct-1",
+    }, { schema, liveSource }), /property name 'firstName' is not Schema.org — use 'givenName'/);
+});
+test("(f) synonym layer also rejects on markdown-undocumented labels", () => {
+    // The synonym map is independent of label — firstName is wrong everywhere.
+    const schema = makeSchema({
+        synonyms: [["firstName", "givenName"]],
+    });
+    const liveSource = makeLiveSource({
+        live: ["LocalBusiness"],
+        declared: ["LocalBusiness"],
+    });
+    assert.throws(() => validateWrite({
+        labels: ["LocalBusiness"],
+        properties: { firstName: "x" },
+        accountId: "acct-1",
+    }, { schema, liveSource }), /property name 'firstName' is not Schema.org — use 'givenName'/);
+});
+// ---------------------------------------------------------------------------
+// accountId boundary
+// ---------------------------------------------------------------------------
+test("rejects missing accountId before consulting live source", () => {
+    const schema = makeSchema({});
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    assert.throws(() => validateWrite({ labels: ["Person"], properties: {} }, { schema, liveSource }), /accountId is required/);
+});
+test("rejects empty labels[] before consulting live source", () => {
+    const schema = makeSchema({});
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    assert.throws(() => validateWrite({ labels: [], properties: {}, accountId: "acct-1" }, { schema, liveSource }), /labels is required/);
+});
+// ---------------------------------------------------------------------------
+// Task 849 — forbidden-property check (Person.name eradication)
+// ---------------------------------------------------------------------------
+test("(849) Person + name is rejected with documented error and structured log line", () => {
+    const schema = makeSchema({
+        documented: [
+            {
+                label: "Person",
+                required: [{ kind: "simple", name: "givenName" }],
+            },
+        ],
+        forbidden: [
+            {
+                label: "Person",
+                property: "name",
+                rationale: "use givenName + familyName; rendered display name composed at read time",
+            },
+        ],
+    });
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    const { lines, emit } = captureEmits();
+    assert.throws(() => validateWrite({
+        labels: ["Person"],
+        properties: {
+            givenName: "Test",
+            familyName: "Person",
+            name: "Test",
+            createdByAgent: "memory-write",
+        },
+        accountId: "acct-1",
+    }, { schema, liveSource, emit }), (err) => {
+        // Error message names the property, the label, and the rationale.
+        assert.match(err.message, /'name' is not a valid Person property/);
+        assert.match(err.message, /givenName \+ familyName/);
+        return true;
+    });
+    // Structured log line is grep-able as the brief specifies.
+    const rejected = lines.find((l) => l.includes("[schema-validator] outcome=rejected"));
+    assert.ok(rejected, `expected forbidden-property log line, got: ${lines.join(" | ")}`);
+    assert.match(rejected, /label=Person/);
+    assert.match(rejected, /property=name/);
+    assert.match(rejected, /reason=forbidden/);
+    assert.match(rejected, /writer=memory-write/);
+});
+test("(849) Organization + name is accepted — rule is Person-specific", () => {
+    // Organization.name is canonical and must NOT be rejected even when the
+    // forbidden map carries a Person+name row. Per-label scoping is the whole
+    // point of the new map shape.
+    const schema = makeSchema({
+        forbidden: [{ label: "Person", property: "name" }],
+    });
+    const liveSource = makeLiveSource({
+        live: ["Organization"],
+        declared: ["Organization"],
+    });
+    validateWrite({
+        labels: ["Organization"],
+        properties: { name: "Acme Plumbing" },
+        accountId: "acct-1",
+    }, { schema, liveSource });
+});
+test("(849) Person without name is accepted (canonical pair only)", () => {
+    // Sanity: the forbidden-property check must not reject writes that don't
+    // include the forbidden key. givenName + familyName is the canonical
+    // shape; a write that uses it must succeed.
+    const schema = makeSchema({
+        documented: [
+            {
+                label: "Person",
+                required: [{ kind: "simple", name: "givenName" }],
+            },
+        ],
+        forbidden: [{ label: "Person", property: "name" }],
+    });
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    validateWrite({
+        labels: ["Person"],
+        properties: { givenName: "Dan", familyName: "Brett" },
+        accountId: "acct-1",
+    }, { schema, liveSource });
+});
+test("(849) firstName → givenName synonym rewrites BEFORE forbidden check fires", () => {
+    // Ordering invariant: if a Person write supplies `firstName`, the
+    // synonym pass must reject with the rename hint; the forbidden-property
+    // check must not preempt that error. Otherwise a `firstName` typo on a
+    // label with a forbidden-property rule would mis-report the failure.
+    const schema = makeSchema({
+        synonyms: [["firstName", "givenName"]],
+        forbidden: [{ label: "Person", property: "name" }],
+    });
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    assert.throws(() => validateWrite({
+        labels: ["Person"],
+        properties: { firstName: "Jane" },
+        accountId: "acct-1",
+    }, { schema, liveSource }), /property name 'firstName' is not Schema\.org — use 'givenName'/);
+});
+// ---------------------------------------------------------------------------
+// Task 893 — `mode: "update"` partial-update behaviour
+// ---------------------------------------------------------------------------
+test('(893) mode:"update" skips required-property check (partial Person SET)', () => {
+    // The personal-profile Person already has givenName/familyName from PIN
+    // setup. A partial SET adding `homeLocation` only must accept — required
+    // properties are not re-validated against the partial input. Without
+    // mode:"update" the validator would reject for missing givenName.
+    const schema = makeSchema({
+        documented: [
+            {
+                label: "Person",
+                required: [
+                    { kind: "simple", name: "givenName" },
+                    { kind: "simple", name: "familyName" },
+                    { kind: "any-of", names: ["email", "telephone"] },
+                ],
+            },
+        ],
+    });
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    const { lines, emit } = captureEmits();
+    validateWrite({
+        labels: ["Person"],
+        properties: { homeLocation: "London" },
+        accountId: "acct-1",
+    }, { schema, liveSource, emit }, { mode: "update" });
+    const accepted = lines.find((l) => l.includes("outcome=accepted"));
+    assert.ok(accepted, `expected accepted log, got: ${lines.join(" | ")}`);
+    assert.match(accepted, /mode=update/);
+    // Required-props loop did not run, so its log line must NOT appear.
+    const reqLine = lines.find((l) => l.includes("required-props"));
+    assert.ok(!reqLine, `expected no required-props log under mode=update, got: ${lines.join(" | ")}`);
+});
+test('(893) mode:"update" still rejects forbidden Person.name', () => {
+    // Skipping required-props must NOT skip the Forbidden Properties check.
+    // Task 849's `Person | name` rule fires regardless of mode.
+    const schema = makeSchema({
+        documented: [
+            {
+                label: "Person",
+                required: [{ kind: "simple", name: "givenName" }],
+            },
+        ],
+        forbidden: [{ label: "Person", property: "name", rationale: "use givenName + familyName" }],
+    });
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    assert.throws(() => validateWrite({
+        labels: ["Person"],
+        properties: { name: "Joel Smalley" },
+        accountId: "acct-1",
+    }, { schema, liveSource }, { mode: "update" }), /'name' is not a valid Person property/);
+});
+test('(893) mode:"update" still rejects synonyms (phone → telephone)', () => {
+    // Skipping required-props must NOT skip the synonym pass either. A
+    // partial Person update with the schema-synonym `phone` must reject
+    // with the canonical-name hint.
+    const schema = makeSchema({
+        documented: [
+            {
+                label: "Person",
+                required: [{ kind: "simple", name: "givenName" }],
+            },
+        ],
+        synonyms: [["phone", "telephone"]],
+    });
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    assert.throws(() => validateWrite({
+        labels: ["Person"],
+        properties: { phone: "+447111111111" },
+        accountId: "acct-1",
+    }, { schema, liveSource }, { mode: "update" }), /property name 'phone' is not Schema\.org — use 'telephone'/);
+});
+test('(893) mode defaults to "create" when omitted; required-props still fires', () => {
+    // Backwards compatibility: existing callers (memoryWrite) pass no
+    // options object; behaviour is unchanged.
+    const schema = makeSchema({
+        documented: [
+            {
+                label: "Person",
+                required: [{ kind: "simple", name: "givenName" }],
+            },
+        ],
+    });
+    const liveSource = makeLiveSource({
+        live: ["Person"],
+        declared: ["Person"],
+    });
+    assert.throws(() => validateWrite({
+        labels: ["Person"],
+        properties: { homeLocation: "London" },
+        accountId: "acct-1",
+    }, { schema, liveSource }), /missing required property 'givenName'/);
+});
+//# sourceMappingURL=schema-validator.test.js.map

package/payload/platform/plugins/memory/mcp/dist/lib/__tests__/schema-validator.test.js.map

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

package/payload/platform/plugins/memory/mcp/dist/lib/attachments.d.ts

@@ -0,0 +1,37 @@
+export declare const ATTACHMENTS_ROOT: string;
+/**
+ * Validate that a value is a UUID. Throws if not — prevents path traversal
+ * when constructing filesystem paths from user-supplied input.
+ */
+export declare function assertUUID(value: string, label: string): void;
+export interface AttachmentMeta {
+    attachmentId: string;
+    scope: string;
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
+    storedAt: string;
+}
+/**
+ * Resolve the directory for a specific attachment under an account.
+ * Returns the absolute path. Does NOT verify existence.
+ */
+export declare function attachmentDir(accountId: string, attachmentId: string): string;
+/**
+ * Read the .meta.json sidecar for an attachment.
+ * Returns null if the directory or meta file doesn't exist.
+ * Throws on parse errors (corrupt meta = caller's problem).
+ */
+export declare function readMeta(accountId: string, attachmentId: string): Promise<AttachmentMeta | null>;
+/**
+ * Find the data file (non-.meta.json) in an attachment directory.
+ * Returns the absolute path, or null if no data file exists.
+ */
+export declare function findDataFile(accountId: string, attachmentId: string): Promise<string | null>;
+/**
+ * Remove an attachment directory from disk.
+ * No-op if the directory doesn't exist (web-ingested documents have no file).
+ * Returns true if a directory was removed, false if it didn't exist.
+ */
+export declare function removeAttachmentDir(accountId: string, attachmentId: string): Promise<boolean>;
+//# sourceMappingURL=attachments.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/lib/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../src/lib/attachments.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,gBAAgB,QAA+C,CAAC;AAK7E;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAO7D;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAMhC;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAKlB"}

package/payload/platform/plugins/memory/mcp/dist/lib/attachments.js

@@ -0,0 +1,69 @@
+import { resolve } from "node:path";
+import { readFile, readdir, rm } from "node:fs/promises";
+import { existsSync } from "node:fs";
+// ---------------------------------------------------------------------------
+// Shared attachment helpers for memory MCP tools.
+//
+// Path derivation: PLATFORM_ROOT (env or dirname-based) → ../data/uploads/
+// Uploads live at {installDir}/data/uploads/ — outside the platform/ wipe zone
+// so user-uploaded files survive reinstalls.
+// ---------------------------------------------------------------------------
+const PLATFORM_ROOT = process.env.PLATFORM_ROOT ?? resolve(import.meta.dirname, "../../../..");
+export const ATTACHMENTS_ROOT = resolve(PLATFORM_ROOT, "..", "data/uploads");
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+/**
+ * Validate that a value is a UUID. Throws if not — prevents path traversal
+ * when constructing filesystem paths from user-supplied input.
+ */
+export function assertUUID(value, label) {
+    if (!UUID_RE.test(value)) {
+        throw new Error(`Invalid ${label}: "${value}" is not a valid UUID. ` +
+            `Expected format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`);
+    }
+}
+/**
+ * Resolve the directory for a specific attachment under an account.
+ * Returns the absolute path. Does NOT verify existence.
+ */
+export function attachmentDir(accountId, attachmentId) {
+    assertUUID(accountId, "accountId");
+    return resolve(ATTACHMENTS_ROOT, accountId, attachmentId);
+}
+/**
+ * Read the .meta.json sidecar for an attachment.
+ * Returns null if the directory or meta file doesn't exist.
+ * Throws on parse errors (corrupt meta = caller's problem).
+ */
+export async function readMeta(accountId, attachmentId) {
+    const dir = attachmentDir(accountId, attachmentId);
+    const metaPath = resolve(dir, `${attachmentId}.meta.json`);
+    if (!existsSync(metaPath))
+        return null;
+    const raw = await readFile(metaPath, "utf-8");
+    return JSON.parse(raw);
+}
+/**
+ * Find the data file (non-.meta.json) in an attachment directory.
+ * Returns the absolute path, or null if no data file exists.
+ */
+export async function findDataFile(accountId, attachmentId) {
+    const dir = attachmentDir(accountId, attachmentId);
+    if (!existsSync(dir))
+        return null;
+    const entries = await readdir(dir);
+    const dataFile = entries.find((f) => !f.endsWith(".meta.json"));
+    return dataFile ? resolve(dir, dataFile) : null;
+}
+/**
+ * Remove an attachment directory from disk.
+ * No-op if the directory doesn't exist (web-ingested documents have no file).
+ * Returns true if a directory was removed, false if it didn't exist.
+ */
+export async function removeAttachmentDir(accountId, attachmentId) {
+    const dir = attachmentDir(accountId, attachmentId);
+    if (!existsSync(dir))
+        return false;
+    await rm(dir, { recursive: true, force: true });
+    return true;
+}
+//# sourceMappingURL=attachments.js.map

package/payload/platform/plugins/memory/mcp/dist/lib/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../src/lib/attachments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,8EAA8E;AAC9E,kDAAkD;AAClD,EAAE;AACF,2EAA2E;AAC3E,+EAA+E;AAC/E,6CAA6C;AAC7C,8EAA8E;AAE9E,MAAM,aAAa,GACjB,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC,aAAa,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;AAE7E,MAAM,OAAO,GACX,gEAAgE,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,KAAa;IACrD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,WAAW,KAAK,MAAM,KAAK,yBAAyB;YAClD,uDAAuD,CAC1D,CAAC;IACJ,CAAC;AACH,CAAC;AAWD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,SAAiB,EACjB,YAAoB;IAEpB,UAAU,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACnC,OAAO,OAAO,CAAC,gBAAgB,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,SAAiB,EACjB,YAAoB;IAEpB,MAAM,GAAG,GAAG,aAAa,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,YAAY,YAAY,CAAC,CAAC;IAC3D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAiB,EACjB,YAAoB;IAEpB,MAAM,GAAG,GAAG,aAAa,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IAChE,OAAO,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,SAAiB,EACjB,YAAoB;IAEpB,MAAM,GAAG,GAAG,aAAa,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/payload/platform/plugins/memory/mcp/dist/lib/conversation-normalisers/index.d.ts

@@ -0,0 +1,5 @@
+import type { ConversationNormaliser, ConversationSource } from "./types.js";
+export * from "./types.js";
+export { whatsappTextNormaliser } from "./whatsapp-text.js";
+export declare function getNormaliser(source: ConversationSource): ConversationNormaliser;
+//# sourceMappingURL=index.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/lib/conversation-normalisers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/conversation-normalisers/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAG7E,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAc5D,wBAAgB,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,sBAAsB,CAShF"}

package/payload/platform/plugins/memory/mcp/dist/lib/conversation-normalisers/index.js

@@ -0,0 +1,30 @@
+// Source-specific normalisers for conversation-archive ingestion.
+//
+// Each normaliser implements `ConversationNormaliser` and returns the same
+// `ParsedLine[]` contract regardless of source format. Adding a new source
+// (telegram, slack, signal, …) means adding a sibling file here, registering
+// it in `NORMALISERS_BY_SOURCE` below, and extending `CONVERSATION_SOURCES`
+// in `types.ts`. No new skill, no new MCP tool, no new plugin.
+import { whatsappTextNormaliser } from "./whatsapp-text.js";
+export * from "./types.js";
+export { whatsappTextNormaliser } from "./whatsapp-text.js";
+/**
+ * Closed registry from source enum → normaliser. Phase 0 ships only
+ * `whatsapp`; future sources land here as they are implemented.
+ *
+ * `getNormaliser` is the only legal lookup — it loud-fails on unimplemented
+ * sources rather than silently returning undefined, so the orchestrator
+ * cannot drift into "source name in enum but no parser wired" territory.
+ */
+const NORMALISERS_BY_SOURCE = {
+    whatsapp: whatsappTextNormaliser,
+};
+export function getNormaliser(source) {
+    const normaliser = NORMALISERS_BY_SOURCE[source];
+    if (!normaliser) {
+        const implemented = Object.keys(NORMALISERS_BY_SOURCE).join(", ");
+        throw new Error(`conversation-archive: no normaliser implemented for source="${source}". Implemented: ${implemented}. Add a sibling file in conversation-normalisers/ and register it in NORMALISERS_BY_SOURCE.`);
+    }
+    return normaliser;
+}
+//# sourceMappingURL=index.js.map