@remnic/import-supermemory 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Joshua Warren
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import { ImporterAdapter, ImportedMemory } from '@remnic/core';
+
+interface SupermemoryRecord {
+    id?: string;
+    memory?: string;
+    content?: string;
+    summary?: string;
+    title?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    containerTags?: string[];
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface ParsedSupermemoryExport {
+    memories: SupermemoryRecord[];
+    importedFromPath?: string;
+}
+declare function parseSupermemoryExport(input: unknown, filePath?: string): ParsedSupermemoryExport;
+
+declare const adapter: ImporterAdapter<ParsedSupermemoryExport>;
+declare const supermemoryAdapter: ImporterAdapter<ParsedSupermemoryExport>;
+
+declare function transformSupermemoryExport(parsed: ParsedSupermemoryExport): ImportedMemory[];
+
+export { adapter, parseSupermemoryExport, supermemoryAdapter, transformSupermemoryExport };

package/dist/index.js

@@ -0,0 +1,131 @@
+// openclaw-engram: Local-first memory plugin
+
+// src/adapter.ts
+import { defaultWriteMemoriesToOrchestrator } from "@remnic/core";
+
+// src/parser.ts
+function parseSupermemoryExport(input, filePath) {
+  if (input == null) {
+    throw new Error("Supermemory import requires JSON input. Pass --file <supermemory-export.json>.");
+  }
+  const raw = coerceJson(input);
+  const memories = [];
+  if (Array.isArray(raw)) {
+    append(memories, raw);
+    return { memories, ...filePath ? { importedFromPath: filePath } : {} };
+  } else if (raw && typeof raw === "object") {
+    const obj = raw;
+    let sawKnownKey = false;
+    for (const key of ["memoryEntries", "memories", "results", "data"]) {
+      if (key in obj) {
+        sawKnownKey = true;
+        if (!Array.isArray(obj[key])) {
+          throw new Error(`Supermemory export key '${key}' must be an array.`);
+        }
+        append(memories, obj[key]);
+        return { memories, ...filePath ? { importedFromPath: filePath } : {} };
+      }
+    }
+    if (!sawKnownKey) {
+      throw new Error(
+        "Supermemory export object has no recognized memory key. Expected one of 'memoryEntries', 'memories', 'results', or 'data'."
+      );
+    }
+  }
+  throw new Error(`Supermemory export must be a JSON array or object; received ${describeType(raw)}.`);
+}
+function append(dest, src) {
+  for (const item of src) {
+    if (item && typeof item === "object") dest.push(item);
+  }
+}
+function coerceJson(input) {
+  if (typeof input !== "string") return input;
+  try {
+    return JSON.parse(input);
+  } catch (err) {
+    throw new Error(
+      `Supermemory export is not valid JSON: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+function describeType(value) {
+  if (value === null) return "null";
+  return typeof value;
+}
+
+// src/transform.ts
+var SUPERMEMORY_SOURCE_LABEL = "supermemory";
+function transformSupermemoryExport(parsed) {
+  const out = [];
+  for (const row of parsed.memories) {
+    const m = toImported(row, parsed.importedFromPath);
+    if (m) out.push(m);
+  }
+  return out;
+}
+function toImported(row, importedFromPath) {
+  const content = pickContent(row);
+  if (!content) return void 0;
+  const sourceId = pickSourceId(row.id) ?? content.slice(0, 64);
+  const sourceTimestamp = pickTimestamp(row);
+  return {
+    content,
+    sourceLabel: SUPERMEMORY_SOURCE_LABEL,
+    sourceId,
+    ...sourceTimestamp ? { sourceTimestamp } : {},
+    ...importedFromPath ? { importedFromPath } : {},
+    metadata: {
+      kind: "supermemory_memory",
+      ...Array.isArray(row.containerTags) && row.containerTags.length > 0 ? { containerTags: [...row.containerTags] } : {},
+      ...row.metadata && typeof row.metadata === "object" ? { sourceMetadata: row.metadata } : {}
+    }
+  };
+}
+function pickTimestamp(row) {
+  for (const timestamp of [row.updatedAt, row.createdAt]) {
+    if (typeof timestamp === "string" && timestamp.trim().length > 0) {
+      return timestamp.trim();
+    }
+  }
+  return void 0;
+}
+function pickSourceId(value) {
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : void 0;
+  }
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return String(value);
+  }
+  return void 0;
+}
+function pickContent(row) {
+  for (const c of [row.content, row.memory, row.summary, row.title]) {
+    if (typeof c === "string" && c.trim().length > 0) return c.trim();
+  }
+  return void 0;
+}
+
+// src/adapter.ts
+var adapter = {
+  name: "supermemory",
+  sourceLabel: SUPERMEMORY_SOURCE_LABEL,
+  parse(input, options) {
+    return parseSupermemoryExport(input, options?.filePath);
+  },
+  transform(parsed) {
+    return transformSupermemoryExport(parsed);
+  },
+  writeTo(target, memories) {
+    return defaultWriteMemoriesToOrchestrator(target, memories);
+  }
+};
+var supermemoryAdapter = adapter;
+export {
+  adapter,
+  parseSupermemoryExport,
+  supermemoryAdapter,
+  transformSupermemoryExport
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapter.ts","../src/parser.ts","../src/transform.ts"],"sourcesContent":["import type { ImporterAdapter } from \"@remnic/core\";\nimport { defaultWriteMemoriesToOrchestrator } from \"@remnic/core\";\n\nimport { parseSupermemoryExport, type ParsedSupermemoryExport } from \"./parser.js\";\nimport { SUPERMEMORY_SOURCE_LABEL, transformSupermemoryExport } from \"./transform.js\";\n\nexport const adapter: ImporterAdapter<ParsedSupermemoryExport> = {\n  name: \"supermemory\",\n  sourceLabel: SUPERMEMORY_SOURCE_LABEL,\n  parse(input, options) {\n    return parseSupermemoryExport(input, options?.filePath);\n  },\n  transform(parsed) {\n    return transformSupermemoryExport(parsed);\n  },\n  writeTo(target, memories) {\n    return defaultWriteMemoriesToOrchestrator(target, memories);\n  },\n};\n\nexport const supermemoryAdapter = adapter;\n","export interface SupermemoryRecord {\n  id?: string;\n  memory?: string;\n  content?: string;\n  summary?: string;\n  title?: string;\n  createdAt?: string;\n  updatedAt?: string;\n  containerTags?: string[];\n  metadata?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\nexport interface ParsedSupermemoryExport {\n  memories: SupermemoryRecord[];\n  importedFromPath?: string;\n}\n\nexport function parseSupermemoryExport(input: unknown, filePath?: string): ParsedSupermemoryExport {\n  if (input == null) {\n    throw new Error(\"Supermemory import requires JSON input. Pass --file <supermemory-export.json>.\");\n  }\n\n  const raw = coerceJson(input);\n  const memories: SupermemoryRecord[] = [];\n\n  if (Array.isArray(raw)) {\n    append(memories, raw);\n    return { memories, ...(filePath ? { importedFromPath: filePath } : {}) };\n  } else if (raw && typeof raw === \"object\") {\n    const obj = raw as Record<string, unknown>;\n    let sawKnownKey = false;\n    for (const key of [\"memoryEntries\", \"memories\", \"results\", \"data\"] as const) {\n      if (key in obj) {\n        sawKnownKey = true;\n        if (!Array.isArray(obj[key])) {\n          throw new Error(`Supermemory export key '${key}' must be an array.`);\n        }\n        append(memories, obj[key] as unknown[]);\n        return { memories, ...(filePath ? { importedFromPath: filePath } : {}) };\n      }\n    }\n    if (!sawKnownKey) {\n      throw new Error(\n        \"Supermemory export object has no recognized memory key. Expected one of 'memoryEntries', 'memories', 'results', or 'data'.\",\n      );\n    }\n  }\n\n  throw new Error(`Supermemory export must be a JSON array or object; received ${describeType(raw)}.`);\n}\n\nfunction append(dest: SupermemoryRecord[], src: unknown[]): void {\n  for (const item of src) {\n    if (item && typeof item === \"object\") dest.push(item as SupermemoryRecord);\n  }\n}\n\nfunction coerceJson(input: unknown): unknown {\n  if (typeof input !== \"string\") return input;\n\n  try {\n    return JSON.parse(input);\n  } catch (err) {\n    throw new Error(\n      `Supermemory export is not valid JSON: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n}\n\nfunction describeType(value: unknown): string {\n  if (value === null) return \"null\";\n  return typeof value;\n}\n","import type { ImportedMemory } from \"@remnic/core\";\nimport type { ParsedSupermemoryExport, SupermemoryRecord } from \"./parser.js\";\n\nexport const SUPERMEMORY_SOURCE_LABEL = \"supermemory\";\n\nexport function transformSupermemoryExport(parsed: ParsedSupermemoryExport): ImportedMemory[] {\n  const out: ImportedMemory[] = [];\n  for (const row of parsed.memories) {\n    const m = toImported(row, parsed.importedFromPath);\n    if (m) out.push(m);\n  }\n  return out;\n}\n\nfunction toImported(row: SupermemoryRecord, importedFromPath?: string): ImportedMemory | undefined {\n  const content = pickContent(row);\n  if (!content) return undefined;\n  const sourceId = pickSourceId(row.id) ?? content.slice(0, 64);\n  const sourceTimestamp = pickTimestamp(row);\n  return {\n    content,\n    sourceLabel: SUPERMEMORY_SOURCE_LABEL,\n    sourceId,\n    ...(sourceTimestamp ? { sourceTimestamp } : {}),\n    ...(importedFromPath ? { importedFromPath } : {}),\n    metadata: {\n      kind: \"supermemory_memory\",\n      ...(Array.isArray(row.containerTags) && row.containerTags.length > 0\n        ? { containerTags: [...row.containerTags] }\n        : {}),\n      ...(row.metadata && typeof row.metadata === \"object\" ? { sourceMetadata: row.metadata } : {}),\n    },\n  };\n}\n\nfunction pickTimestamp(row: SupermemoryRecord): string | undefined {\n  for (const timestamp of [row.updatedAt, row.createdAt]) {\n    if (typeof timestamp === \"string\" && timestamp.trim().length > 0) {\n      return timestamp.trim();\n    }\n  }\n  return undefined;\n}\n\nfunction pickSourceId(value: unknown): string | undefined {\n  if (typeof value === \"string\") {\n    const trimmed = value.trim();\n    return trimmed.length > 0 ? trimmed : undefined;\n  }\n  if (typeof value === \"number\" && Number.isFinite(value)) {\n    return String(value);\n  }\n  return undefined;\n}\n\nfunction pickContent(row: SupermemoryRecord): string | undefined {\n  for (const c of [row.content, row.memory, row.summary, row.title]) {\n    if (typeof c === \"string\" && c.trim().length > 0) return c.trim();\n  }\n  return undefined;\n}\n"],"mappings":";;;AACA,SAAS,0CAA0C;;;ACiB5C,SAAS,uBAAuB,OAAgB,UAA4C;AACjG,MAAI,SAAS,MAAM;AACjB,UAAM,IAAI,MAAM,gFAAgF;AAAA,EAClG;AAEA,QAAM,MAAM,WAAW,KAAK;AAC5B,QAAM,WAAgC,CAAC;AAEvC,MAAI,MAAM,QAAQ,GAAG,GAAG;AACtB,WAAO,UAAU,GAAG;AACpB,WAAO,EAAE,UAAU,GAAI,WAAW,EAAE,kBAAkB,SAAS,IAAI,CAAC,EAAG;AAAA,EACzE,WAAW,OAAO,OAAO,QAAQ,UAAU;AACzC,UAAM,MAAM;AACZ,QAAI,cAAc;AAClB,eAAW,OAAO,CAAC,iBAAiB,YAAY,WAAW,MAAM,GAAY;AAC3E,UAAI,OAAO,KAAK;AACd,sBAAc;AACd,YAAI,CAAC,MAAM,QAAQ,IAAI,GAAG,CAAC,GAAG;AAC5B,gBAAM,IAAI,MAAM,2BAA2B,GAAG,qBAAqB;AAAA,QACrE;AACA,eAAO,UAAU,IAAI,GAAG,CAAc;AACtC,eAAO,EAAE,UAAU,GAAI,WAAW,EAAE,kBAAkB,SAAS,IAAI,CAAC,EAAG;AAAA,MACzE;AAAA,IACF;AACA,QAAI,CAAC,aAAa;AAChB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,QAAM,IAAI,MAAM,+DAA+D,aAAa,GAAG,CAAC,GAAG;AACrG;AAEA,SAAS,OAAO,MAA2B,KAAsB;AAC/D,aAAW,QAAQ,KAAK;AACtB,QAAI,QAAQ,OAAO,SAAS,SAAU,MAAK,KAAK,IAAyB;AAAA,EAC3E;AACF;AAEA,SAAS,WAAW,OAAyB;AAC3C,MAAI,OAAO,UAAU,SAAU,QAAO;AAEtC,MAAI;AACF,WAAO,KAAK,MAAM,KAAK;AAAA,EACzB,SAAS,KAAK;AACZ,UAAM,IAAI;AAAA,MACR,yCAAyC,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,IAC3F;AAAA,EACF;AACF;AAEA,SAAS,aAAa,OAAwB;AAC5C,MAAI,UAAU,KAAM,QAAO;AAC3B,SAAO,OAAO;AAChB;;;ACtEO,IAAM,2BAA2B;AAEjC,SAAS,2BAA2B,QAAmD;AAC5F,QAAM,MAAwB,CAAC;AAC/B,aAAW,OAAO,OAAO,UAAU;AACjC,UAAM,IAAI,WAAW,KAAK,OAAO,gBAAgB;AACjD,QAAI,EAAG,KAAI,KAAK,CAAC;AAAA,EACnB;AACA,SAAO;AACT;AAEA,SAAS,WAAW,KAAwB,kBAAuD;AACjG,QAAM,UAAU,YAAY,GAAG;AAC/B,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,WAAW,aAAa,IAAI,EAAE,KAAK,QAAQ,MAAM,GAAG,EAAE;AAC5D,QAAM,kBAAkB,cAAc,GAAG;AACzC,SAAO;AAAA,IACL;AAAA,IACA,aAAa;AAAA,IACb;AAAA,IACA,GAAI,kBAAkB,EAAE,gBAAgB,IAAI,CAAC;AAAA,IAC7C,GAAI,mBAAmB,EAAE,iBAAiB,IAAI,CAAC;AAAA,IAC/C,UAAU;AAAA,MACR,MAAM;AAAA,MACN,GAAI,MAAM,QAAQ,IAAI,aAAa,KAAK,IAAI,cAAc,SAAS,IAC/D,EAAE,eAAe,CAAC,GAAG,IAAI,aAAa,EAAE,IACxC,CAAC;AAAA,MACL,GAAI,IAAI,YAAY,OAAO,IAAI,aAAa,WAAW,EAAE,gBAAgB,IAAI,SAAS,IAAI,CAAC;AAAA,IAC7F;AAAA,EACF;AACF;AAEA,SAAS,cAAc,KAA4C;AACjE,aAAW,aAAa,CAAC,IAAI,WAAW,IAAI,SAAS,GAAG;AACtD,QAAI,OAAO,cAAc,YAAY,UAAU,KAAK,EAAE,SAAS,GAAG;AAChE,aAAO,UAAU,KAAK;AAAA,IACxB;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,aAAa,OAAoC;AACxD,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,UAAU,MAAM,KAAK;AAC3B,WAAO,QAAQ,SAAS,IAAI,UAAU;AAAA,EACxC;AACA,MAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,GAAG;AACvD,WAAO,OAAO,KAAK;AAAA,EACrB;AACA,SAAO;AACT;AAEA,SAAS,YAAY,KAA4C;AAC/D,aAAW,KAAK,CAAC,IAAI,SAAS,IAAI,QAAQ,IAAI,SAAS,IAAI,KAAK,GAAG;AACjE,QAAI,OAAO,MAAM,YAAY,EAAE,KAAK,EAAE,SAAS,EAAG,QAAO,EAAE,KAAK;AAAA,EAClE;AACA,SAAO;AACT;;;AFtDO,IAAM,UAAoD;AAAA,EAC/D,MAAM;AAAA,EACN,aAAa;AAAA,EACb,MAAM,OAAO,SAAS;AACpB,WAAO,uBAAuB,OAAO,SAAS,QAAQ;AAAA,EACxD;AAAA,EACA,UAAU,QAAQ;AAChB,WAAO,2BAA2B,MAAM;AAAA,EAC1C;AAAA,EACA,QAAQ,QAAQ,UAAU;AACxB,WAAO,mCAAmC,QAAQ,QAAQ;AAAA,EAC5D;AACF;AAEO,IAAM,qBAAqB;","names":[]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@remnic/import-supermemory",
+  "version": "0.1.1",
+  "description": "Import Supermemory exports into Remnic",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "peerDependencies": {
+    "@remnic/core": "^1.1.9"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "@remnic/core": "1.1.9"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/joshuaswarren/remnic.git",
+    "directory": "packages/import-supermemory"
+  },
+  "keywords": [
+    "remnic",
+    "memory",
+    "supermemory",
+    "import"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "check-types": "tsc --noEmit",
+    "test": "tsx --test src/parser.test.ts src/transform.test.ts src/adapter.test.ts"
+  }
+}