@remnic/core 9.69.27 → 9.69.28

package/dist/importers/index.d.ts

@@ -251,5 +251,25 @@ declare function runImporter<Parsed>(adapter: ImporterAdapter<Parsed>, input: un
  * are free to implement their own `writeTo`.
  */
 declare function defaultWriteMemoriesToOrchestrator(target: ImporterWriteTarget, memories: ImportedMemory[]): Promise<ImporterWriteResult>;
+/** Parse args `defineFileImporterAdapter` forwards — the keys file adapters use. */
+interface FileImporterParseArgs {
+    strict?: boolean;
+    filePath?: string;
+}
+/** Per-package config consumed by `defineFileImporterAdapter`. */
+interface FileImporterDefinition<Parsed> {
+    name: string;
+    sourceLabel: string;
+    /** Decode the raw export file. Receives only `strict` / `filePath`. */
+    parse(input: unknown, options: FileImporterParseArgs): Parsed | Promise<Parsed>;
+    /** Flatten the parsed export into `ImportedMemory[]` with provenance. */
+    transform(parsed: Parsed, options: ImporterTransformOptions | undefined): ImportedMemory[] | Promise<ImportedMemory[]>;
+}
+/**
+ * Build the standard file-importer `ImporterAdapter`: parse with the
+ * `strict`/`filePath` spread, a package-specific `transform`, and `writeTo`
+ * delegating to `defaultWriteMemoriesToOrchestrator` (issue #2794).
+ */
+declare function defineFileImporterAdapter<Parsed>(definition: FileImporterDefinition<Parsed>): ImporterAdapter<Parsed>;
 
-export { DEFAULT_IMPORT_BATCH_SIZE, type ImportProgress, type ImportedMemory, type ImporterAdapter, type ImporterParseOptions, type ImporterTransformOptions, type ImporterWriteResult, type ImporterWriteTarget, type RunImportOptions, type RunImporterResult, defaultWriteMemoriesToOrchestrator, importedMemoryToTurn, runImporter, validateImportBatchSize, validateImportRateLimit };
+export { DEFAULT_IMPORT_BATCH_SIZE, type FileImporterDefinition, type FileImporterParseArgs, type ImportProgress, type ImportedMemory, type ImporterAdapter, type ImporterParseOptions, type ImporterTransformOptions, type ImporterWriteResult, type ImporterWriteTarget, type RunImportOptions, type RunImporterResult, defaultWriteMemoriesToOrchestrator, defineFileImporterAdapter, importedMemoryToTurn, runImporter, validateImportBatchSize, validateImportRateLimit };

package/dist/importers/index.js

@@ -1,17 +1,19 @@
 import {
   DEFAULT_IMPORT_BATCH_SIZE,
   defaultWriteMemoriesToOrchestrator,
+  defineFileImporterAdapter,
   importedMemoryToTurn,
   runImporter,
   validateImportBatchSize,
   validateImportRateLimit
-} from "../chunk-FQ7HAWWC.js";
+} from "../chunk-RZN4LQ5Y.js";
 import "../chunk-NOUJNHWG.js";
 import "../chunk-P7FMDTKL.js";
 import "../chunk-PZ5AY32C.js";
 export {
   DEFAULT_IMPORT_BATCH_SIZE,
   defaultWriteMemoriesToOrchestrator,
+  defineFileImporterAdapter,
   importedMemoryToTurn,
   runImporter,
   validateImportBatchSize,

package/dist/importers/test-utils.d.ts

@@ -0,0 +1,24 @@
+import { ab as ImportTurn } from '../types-YY-eKKU7.js';
+import { ImporterWriteTarget } from './index.js';
+import '../message-parts/index.js';
+import '../bounded-jsonl-state.js';
+import '../operator-doctor-types.js';
+import '../external-wiki-config.js';
+import '../contradiction-config.js';
+import '../graph-path-scoring-config.js';
+import '../deep-recall-config.js';
+import '../causal-trajectory.js';
+import '../objective-state.js';
+import '../active-context-config.js';
+import '../semantic-merge-config.js';
+import '../types-continuity.js';
+
+/** In-memory `ImporterWriteTarget` that captures every batch it receives. */
+declare function makeImporterTestTarget(): {
+    target: ImporterWriteTarget;
+    received: ImportTurn[][];
+};
+/** Read `<pkg>/fixtures/<name>` relative to the importing test file. */
+declare function loadImporterFixture(testFileUrl: string, name: string): string;
+
+export { loadImporterFixture, makeImporterTestTarget };

package/dist/importers/test-utils.js

@@ -0,0 +1,31 @@
+import "../chunk-PZ5AY32C.js";
+
+// src/importers/test-utils.ts
+import { readFileSync } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+function makeImporterTestTarget() {
+  const received = [];
+  return {
+    target: {
+      async ingestBulkImportBatch(turns) {
+        received.push(turns.map((t) => ({ ...t })));
+      },
+      bulkImportWriteNamespace() {
+        return "default";
+      }
+    },
+    received
+  };
+}
+function loadImporterFixture(testFileUrl, name) {
+  return readFileSync(
+    path.join(path.dirname(fileURLToPath(testFileUrl)), "../fixtures", name),
+    "utf-8"
+  );
+}
+export {
+  loadImporterFixture,
+  makeImporterTestTarget
+};
+//# sourceMappingURL=test-utils.js.map

package/dist/importers/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/importers/test-utils.ts"],"sourcesContent":["// ---------------------------------------------------------------------------\n// Shared importer test harness (issue #2794)\n// ---------------------------------------------------------------------------\n// `makeTarget()` / `loadFixture()` were duplicated across the\n// `@remnic/import-*` adapter tests. Test-only — never import from\n// production code paths. Ships behind the `@remnic/core/importers/test-utils`\n// subpath export, NOT the runtime barrel (issue #2794 fix round).\n\nimport { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport type { ImportTurn } from \"../bulk-import/types.js\";\nimport type { ImporterWriteTarget } from \"./base.js\";\n\n/** In-memory `ImporterWriteTarget` that captures every batch it receives. */\nexport function makeImporterTestTarget(): {\n  target: ImporterWriteTarget;\n  received: ImportTurn[][];\n} {\n  const received: ImportTurn[][] = [];\n  return {\n    target: {\n      async ingestBulkImportBatch(turns) {\n        received.push(turns.map((t) => ({ ...t })));\n      },\n      bulkImportWriteNamespace() {\n        return \"default\";\n      },\n    },\n    received,\n  };\n}\n\n/** Read `<pkg>/fixtures/<name>` relative to the importing test file. */\nexport function loadImporterFixture(\n  testFileUrl: string,\n  name: string,\n): string {\n  return readFileSync(\n    path.join(path.dirname(fileURLToPath(testFileUrl)), \"../fixtures\", name),\n    \"utf-8\",\n  );\n}\n"],"mappings":";;;AAQA,SAAS,oBAAoB;AAC7B,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAMvB,SAAS,yBAGd;AACA,QAAM,WAA2B,CAAC;AAClC,SAAO;AAAA,IACL,QAAQ;AAAA,MACN,MAAM,sBAAsB,OAAO;AACjC,iBAAS,KAAK,MAAM,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;AAAA,MAC5C;AAAA,MACA,2BAA2B;AACzB,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA;AAAA,EACF;AACF;AAGO,SAAS,oBACd,aACA,MACQ;AACR,SAAO;AAAA,IACL,KAAK,KAAK,KAAK,QAAQ,cAAc,WAAW,CAAC,GAAG,eAAe,IAAI;AAAA,IACvE;AAAA,EACF;AACF;","names":[]}