@fortemi/core 2026.9.0 → 2026.9.2

package/dist/index.js

@@ -2072,6 +2072,54 @@ var migration0023 = {
   `
 };
 
+// src/migrations/0024_source_upsert_contract.ts
+var migration0024 = {
+  version: 24,
+  name: "0024_source_upsert_contract",
+  sql: `
+    ALTER TABLE source_import_run ADD COLUMN IF NOT EXISTS external_run_id TEXT;
+    ALTER TABLE source_import_run ADD COLUMN IF NOT EXISTS source_id TEXT;
+    ALTER TABLE source_import_run ADD COLUMN IF NOT EXISTS source_schema_version TEXT;
+    ALTER TABLE source_import_run ADD COLUMN IF NOT EXISTS workspace_id TEXT;
+    UPDATE source_import_run SET external_run_id = id WHERE external_run_id IS NULL;
+    UPDATE source_import_run SET source_schema_version = 'legacy' WHERE source_schema_version IS NULL;
+    ALTER TABLE source_import_run ALTER COLUMN external_run_id SET NOT NULL;
+    ALTER TABLE source_import_run ALTER COLUMN source_schema_version SET NOT NULL;
+    ALTER TABLE source_import_run ADD CONSTRAINT source_import_run_contract_lengths
+      CHECK (
+        length(external_run_id) BETWEEN 1 AND 200
+        AND (source_id IS NULL OR length(source_id) BETWEEN 1 AND 500)
+        AND length(source_schema_version) BETWEEN 1 AND 100
+        AND (workspace_id IS NULL OR length(workspace_id) BETWEEN 1 AND 500)
+      );
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_source_import_run_scope
+      ON source_import_run(tenant_id, COALESCE(archive_id, ''), namespace, external_run_id);
+
+    ALTER TABLE source_identity ADD COLUMN IF NOT EXISTS source_id TEXT;
+    ALTER TABLE source_identity ADD CONSTRAINT source_identity_source_id_length
+      CHECK (source_id IS NULL OR length(source_id) BETWEEN 1 AND 500);
+
+    CREATE TABLE IF NOT EXISTS source_import_batch (
+      id TEXT PRIMARY KEY,
+      tenant_id TEXT NOT NULL DEFAULT 'default',
+      archive_id TEXT,
+      namespace TEXT NOT NULL,
+      batch_id TEXT NOT NULL,
+      request_digest TEXT NOT NULL,
+      import_run_id TEXT NOT NULL,
+      outcome TEXT NOT NULL,
+      checkpoint JSONB NOT NULL DEFAULT '{}',
+      receipt JSONB NOT NULL DEFAULT '{}',
+      created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+    );
+
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_source_import_batch_scope
+      ON source_import_batch(tenant_id, COALESCE(archive_id, ''), namespace, batch_id);
+    CREATE INDEX IF NOT EXISTS idx_source_import_batch_run
+      ON source_import_batch(import_run_id);
+  `
+};
+
 // src/migrations/index.ts
 var allMigrations = [
   migration0001,
@@ -2096,7 +2144,8 @@ var allMigrations = [
   migration0020,
   migration0021,
   migration0022,
-  migration0023
+  migration0023,
+  migration0024
 ];
 
 // src/data-archive.ts
@@ -5461,52 +5510,79 @@ function createLazyBlobStore(archiveName, options) {
 }
 
 // src/repositories/source-upsert-repository.ts
-var DEFAULT_MAX_ITEMS = 500;
+var SOURCE_UPSERT_CONTRACT_VERSION = "1.0.0";
+var SOURCE_UPSERT_MAX_ITEMS = 500;
 function assertSource(input) {
-  if (!input.namespace || input.namespace.length > 128) throw new Error("Source namespace is required and must be <= 128 characters");
-  if (!input.external_id || input.external_id.length > 1024) throw new Error("Source external_id is required and must be <= 1024 characters");
-  if (!input.source_schema_version || input.source_schema_version.length > 64) {
-    throw new Error("Source schema version is required and must be <= 64 characters");
-  }
-  if (!input.import_run_id || input.import_run_id.length > 128) throw new Error("Source import_run_id is required and must be <= 128 characters");
+  if (!input.tenant_id || input.tenant_id.length > 200) throw new Error("invalid_batch_metadata");
+  if (!input.namespace || input.namespace.length > 200) throw new Error("invalid_batch_metadata");
+  if (!input.external_id || input.external_id.length > 1e3) throw new Error("invalid_item");
+  if (!input.source_schema_version || input.source_schema_version.length > 100) throw new Error("invalid_batch_metadata");
+  if (!input.import_run_id || input.import_run_id.length > 200) throw new Error("invalid_batch_metadata");
 }
-function sourceHash(source) {
+function sourceIdentityHash(source) {
   return computeHash(new TextEncoder().encode([
     source.tenant_id ?? "default",
-    source.archive_id ?? "",
+    source.archive_id ?? "public",
     source.namespace,
-    source.external_id
+    source.external_id,
+    ""
   ].join("\0")));
 }
-function contentDigest(content) {
+function sourceContentDigest(content) {
   return computeHash(new TextEncoder().encode(content));
 }
+function sourceRequestDigest(items, options) {
+  return computeHash(new TextEncoder().encode(JSON.stringify({
+    items: items.map((item) => ({
+      source: item.source,
+      title: item.title ?? null,
+      content: item.content,
+      content_digest: item.content_digest ?? null,
+      format: item.format ?? "markdown",
+      visibility: item.visibility ?? "private",
+      metadata: item.metadata ?? null,
+      policy: item.policy ?? options.policy ?? "version"
+    })),
+    checkpoint: options.checkpoint ?? null,
+    dry_run: options.dryRun === true
+  })));
+}
+function deriveSourceBatchId(requestDigest) {
+  return `derived-${requestDigest.slice("sha256:".length, "sha256:".length + 32)}`;
+}
+function sourceRunRecordId(source) {
+  return computeHash(new TextEncoder().encode([
+    source.tenant_id ?? "default",
+    source.archive_id ?? "public",
+    source.namespace,
+    source.import_run_id,
+    ""
+  ].join("\0")));
+}
+function parseReceipt(value) {
+  const parsed = typeof value === "string" ? JSON.parse(value) : value;
+  if (!parsed || typeof parsed !== "object") return null;
+  return parsed;
+}
+function duplicateReceipt(receipt) {
+  const items = receipt.items.map((item) => ({ ...item, outcome: "unchanged", reason: void 0, reason_code: void 0 }));
+  return finish(receipt.import_run_id, receipt.batch_id, false, "duplicate", items, receipt.checkpoint);
+}
 async function insertNote(tx, input, noteId, digest2) {
   const originalId = generateId();
   if (input.source.archive_id) {
-    await tx.query(
-      `INSERT INTO archive (id, name)
-       VALUES ($1, $2)
-       ON CONFLICT (id) DO NOTHING`,
-      [input.source.archive_id, input.source.archive_id]
-    );
+    await tx.query("INSERT INTO archive (id, name) VALUES ($1, $2) ON CONFLICT (id) DO NOTHING", [input.source.archive_id, input.source.archive_id]);
   }
   await tx.query(
     `INSERT INTO note (id, archive_id, title, format, source, visibility)
      VALUES ($1, $2, $3, $4, $5, $6)`,
-    [
-      noteId,
-      input.source.archive_id ?? null,
-      input.title ?? null,
-      input.format ?? "markdown",
-      `source:${input.source.namespace}`,
-      input.visibility ?? "private"
-    ]
+    [noteId, input.source.archive_id ?? null, input.title ?? null, input.format ?? "markdown", `source:${input.source.namespace}`, input.visibility ?? "private"]
   );
+  await tx.query("INSERT INTO note_original (id, note_id, content, content_hash) VALUES ($1, $2, $3, $4)", [originalId, noteId, input.content, digest2]);
   await tx.query(
-    `INSERT INTO note_original (id, note_id, content, content_hash)
-     VALUES ($1, $2, $3, $4)`,
-    [originalId, noteId, input.content, digest2]
+    `INSERT INTO note_revision (id, note_id, revision_number, type, content, ai_metadata)
+     VALUES ($1, $2, 1, 'source-import', $3, $4::jsonb)`,
+    [generateId(), noteId, input.content, JSON.stringify(input.metadata ?? null)]
   );
   await tx.query(
     `INSERT INTO note_revised_current (note_id, content, ai_metadata)
@@ -5514,55 +5590,26 @@ async function insertNote(tx, input, noteId, digest2) {
     [noteId, input.content, JSON.stringify(input.metadata ?? null)]
   );
 }
-async function updateNote(tx, input, noteId, outcome) {
+async function updateNote(tx, input, noteId, outcome, digest2) {
   if (input.source.archive_id) {
-    await tx.query(
-      `INSERT INTO archive (id, name)
-       VALUES ($1, $2)
-       ON CONFLICT (id) DO NOTHING`,
-      [input.source.archive_id, input.source.archive_id]
-    );
+    await tx.query("INSERT INTO archive (id, name) VALUES ($1, $2) ON CONFLICT (id) DO NOTHING", [input.source.archive_id, input.source.archive_id]);
   }
   if (outcome === "versioned") {
-    const count2 = await tx.query(
-      `SELECT COUNT(*) AS count FROM note_revision WHERE note_id = $1`,
-      [noteId]
-    );
-    const current = await tx.query(
-      `SELECT content, ai_metadata FROM note_revised_current WHERE note_id = $1`,
-      [noteId]
+    const count2 = await tx.query("SELECT COUNT(*) AS count FROM note_revision WHERE note_id = $1", [noteId]);
+    await tx.query(
+      `INSERT INTO note_revision (id, note_id, revision_number, type, content, ai_metadata)
+       VALUES ($1, $2, $3, 'source-import', $4, $5::jsonb)`,
+      [generateId(), noteId, Number.parseInt(count2.rows[0]?.count ?? "0", 10) + 1, input.content, JSON.stringify(input.metadata ?? null)]
     );
-    const nextRevision = Number.parseInt(count2.rows[0]?.count ?? "0", 10) + 1;
-    if (current.rows[0]) {
-      await tx.query(
-        `INSERT INTO note_revision (id, note_id, revision_number, type, content, ai_metadata)
-         VALUES ($1, $2, $3, 'source-import', $4, $5::jsonb)`,
-        [
-          generateId(),
-          noteId,
-          nextRevision,
-          current.rows[0].content,
-          JSON.stringify(current.rows[0].ai_metadata ?? null)
-        ]
-      );
-    }
+  } else {
+    await tx.query("UPDATE note_original SET content = $1, content_hash = $2 WHERE note_id = $3", [input.content, digest2, noteId]);
   }
   await tx.query(
-    `UPDATE note
-     SET title = $1, format = $2, visibility = $3, archive_id = $4, updated_at = now(), deleted_at = NULL
-     WHERE id = $5`,
-    [
-      input.title ?? null,
-      input.format ?? "markdown",
-      input.visibility ?? "private",
-      input.source.archive_id ?? null,
-      noteId
-    ]
+    `UPDATE note SET title = $1, format = $2, visibility = $3, archive_id = $4, updated_at = now(), deleted_at = NULL WHERE id = $5`,
+    [input.title ?? null, input.format ?? "markdown", input.visibility ?? "private", input.source.archive_id ?? null, noteId]
   );
   await tx.query(
-    `UPDATE note_revised_current
-     SET content = $1, ai_metadata = $2::jsonb, is_user_edited = false, updated_at = now()
-     WHERE note_id = $3`,
+    `UPDATE note_revised_current SET content = $1, ai_metadata = $2::jsonb, is_user_edited = false, updated_at = now() WHERE note_id = $3`,
     [input.content, JSON.stringify(input.metadata ?? null), noteId]
   );
 }
@@ -5571,184 +5618,260 @@ var SourceUpsertRepository = class {
     this.db = db;
     this.events = events;
   }
-  async upsertBatch(items, options = {}) {
-    const maxItems = options.maxItems ?? DEFAULT_MAX_ITEMS;
-    if (items.length > maxItems) throw new Error(`Source upsert batch exceeds the ${maxItems} item bound`);
-    if (items.length === 0) {
-      return {
-        import_run_id: "",
-        dry_run: options.dryRun === true,
-        outcomes: [],
-        counts: { inserted: 0, unchanged: 0, versioned: 0, replaced: 0, conflict: 0, rejected: 0 }
-      };
-    }
-    const outcomes = [];
-    for (const [index, item] of items.entries()) {
-      try {
-        assertSource(item.source);
-        outcomes.push({
-          index,
-          outcome: "rejected",
-          external_id_hash: sourceHash(item.source),
-          content_digest: contentDigest(item.content)
-        });
-      } catch (error) {
-        outcomes.push({
-          index,
-          outcome: "rejected",
-          external_id_hash: item.source ? sourceHash({ ...item.source, external_id: item.source.external_id ?? "" }) : "",
-          content_digest: contentDigest(item.content ?? ""),
-          reason: error instanceof Error ? error.message : String(error)
-        });
-      }
+  async upsertRequest(request, scope = {}) {
+    const tenant = scope.tenant_id ?? "default";
+    const memory = scope.archive_id ?? null;
+    const items = request.items.map((item) => ({
+      source: {
+        tenant_id: tenant,
+        archive_id: memory,
+        namespace: request.source_namespace,
+        external_id: item.external_id,
+        source_schema_version: request.source_schema_version,
+        import_run_id: request.import_run_id,
+        source_id: request.source_id,
+        workspace_id: request.workspace_id,
+        caller_stable_id: item.caller_stable_id
+      },
+      title: item.title,
+      content: item.content,
+      content_digest: item.content_digest,
+      format: item.format,
+      metadata: item.metadata,
+      policy: item.policy ?? request.policy
+    }));
+    const invalidCommon = request.source_id !== void 0 && (request.source_id.length === 0 || request.source_id.length > 500) || request.workspace_id !== void 0 && (request.workspace_id.length === 0 || request.workspace_id.length > 500);
+    if (invalidCommon) {
+      const batchId = request.batch_id ?? deriveSourceBatchId(sourceRequestDigest(items, {}));
+      const rejected = items.map((item, index) => ({
+        index,
+        outcome: "rejected",
+        external_id_hash: sourceIdentityHash(item.source),
+        content_digest: sourceContentDigest(item.content),
+        reason_code: "invalid_batch_metadata"
+      }));
+      return contractResponse(finish(request.import_run_id, batchId, request.dry_run === true, "rejected", rejected, request.checkpoint));
     }
-    if (outcomes.some((outcome) => outcome.reason)) {
-      return this.finish(items[0].source?.import_run_id ?? "", options.dryRun === true, outcomes);
+    return contractResponse(await this.upsertBatch(items, {
+      dryRun: request.dry_run,
+      batchId: request.batch_id,
+      checkpoint: request.checkpoint,
+      policy: request.policy
+    }));
+  }
+  async upsertBatch(items, options = {}) {
+    const maxItems = options.maxItems ?? SOURCE_UPSERT_MAX_ITEMS;
+    const importRunId = items[0]?.source.import_run_id ?? "";
+    const requestDigest = sourceRequestDigest(items, options);
+    const batchId = options.batchId ?? deriveSourceBatchId(requestDigest);
+    const batchReason = batchId.length === 0 || batchId.length > 200 ? "invalid_batch_metadata" : JSON.stringify(options.checkpoint ?? {}).length > 65536 ? "checkpoint_too_large" : void 0;
+    const validation = validateItems(items, maxItems, batchReason);
+    if (validation) {
+      return finish(importRunId, batchId, options.dryRun === true, "rejected", validation, options.checkpoint);
     }
     if (options.dryRun) {
-      const preview = [];
-      for (const [index, item] of items.entries()) {
-        const externalIdHash = sourceHash(item.source);
-        const digest2 = contentDigest(item.content);
-        const existing = await this.db.query(
-          `SELECT note_id, content_digest
-           FROM source_identity
-           WHERE tenant_id = $1
-             AND archive_id IS NOT DISTINCT FROM $2
-             AND namespace = $3
-             AND external_id = $4
-           LIMIT 1`,
-          [item.source.tenant_id ?? "default", item.source.archive_id ?? null, item.source.namespace, item.source.external_id]
-        );
-        if (existing.rows.length === 0) {
-          preview.push({ index, outcome: "inserted", external_id_hash: externalIdHash, content_digest: digest2 });
-        } else if (existing.rows[0].content_digest === digest2) {
-          preview.push({ index, outcome: "unchanged", note_id: existing.rows[0].note_id, external_id_hash: externalIdHash, content_digest: digest2 });
-        } else if ((item.policy ?? "version") === "conflict") {
-          preview.push({ index, outcome: "conflict", note_id: existing.rows[0].note_id, external_id_hash: externalIdHash, content_digest: digest2 });
-        } else {
-          preview.push({
+      const preview = await previewItems(this.db, items, options.policy);
+      return finish(importRunId, batchId, true, "preview", preview, options.checkpoint);
+    }
+    const response = await this.db.transaction(async (tx) => {
+      const prior = await tx.query(
+        `SELECT request_digest, receipt FROM source_import_batch
+         WHERE tenant_id = $1 AND archive_id IS NOT DISTINCT FROM $2 AND namespace = $3 AND batch_id = $4 LIMIT 1`,
+        [items[0].source.tenant_id ?? "default", items[0].source.archive_id ?? null, items[0].source.namespace, batchId]
+      );
+      if (prior.rows[0]) {
+        if (prior.rows[0].request_digest !== requestDigest) {
+          const rejected = items.map((item, index) => ({
             index,
-            outcome: item.policy === "replace" ? "replaced" : "versioned",
-            note_id: existing.rows[0].note_id,
-            external_id_hash: externalIdHash,
-            content_digest: digest2
-          });
+            outcome: "rejected",
+            external_id_hash: sourceIdentityHash(item.source),
+            content_digest: sourceContentDigest(item.content),
+            reason_code: "batch_id_reused_with_different_request"
+          }));
+          return finish(importRunId, batchId, false, "rejected", rejected, options.checkpoint);
+        }
+        const receipt = parseReceipt(prior.rows[0].receipt);
+        if (!receipt) throw new Error("Stored source upsert receipt is invalid");
+        return duplicateReceipt(receipt);
+      }
+      for (const item of items) {
+        if (!item.source.caller_stable_id) continue;
+        const collision = await tx.query("SELECT id FROM note WHERE id = $1 LIMIT 1", [item.source.caller_stable_id]);
+        if (collision.rows[0]) {
+          const mapped = await findExisting(tx, item);
+          if (mapped?.note_id === item.source.caller_stable_id) continue;
+          const rejected = items.map((candidate, index) => ({
+            index,
+            outcome: "rejected",
+            external_id_hash: sourceIdentityHash(candidate.source),
+            content_digest: sourceContentDigest(candidate.content),
+            reason_code: "caller_stable_id_conflict"
+          }));
+          return finish(importRunId, batchId, false, "rejected", rejected, options.checkpoint);
         }
       }
-      return this.finish(items[0].source.import_run_id, true, preview);
-    }
-    await this.db.transaction(async (tx) => {
+      const outcomes = [];
       for (const [index, item] of items.entries()) {
-        const externalIdHash = sourceHash(item.source);
-        const digest2 = contentDigest(item.content);
-        const existing = await tx.query(
-          `SELECT note_id, content_digest
-           FROM source_identity
-           WHERE tenant_id = $1
-             AND archive_id IS NOT DISTINCT FROM $2
-             AND namespace = $3
-             AND external_id = $4
-           LIMIT 1`,
-          [item.source.tenant_id ?? "default", item.source.archive_id ?? null, item.source.namespace, item.source.external_id]
-        );
-        if (existing.rows.length === 0) {
+        const externalIdHash = sourceIdentityHash(item.source);
+        const digest2 = sourceContentDigest(item.content);
+        const existing = await findExisting(tx, item);
+        if (!existing) {
           const noteId = item.source.caller_stable_id ?? generateId();
           await insertNote(tx, item, noteId, digest2);
           await tx.query(
             `INSERT INTO source_identity
-              (id, tenant_id, archive_id, namespace, external_id, external_id_hash,
-               source_schema_version, content_digest, import_run_id, caller_stable_id, note_id)
-             VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11)`,
-            [
-              generateId(),
-              item.source.tenant_id ?? "default",
-              item.source.archive_id ?? null,
-              item.source.namespace,
-              item.source.external_id,
-              externalIdHash,
-              item.source.source_schema_version,
-              digest2,
-              item.source.import_run_id,
-              item.source.caller_stable_id ?? null,
-              noteId
-            ]
+              (id, tenant_id, archive_id, namespace, external_id, external_id_hash, source_id, source_schema_version, content_digest, import_run_id, caller_stable_id, note_id)
+             VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)`,
+            [generateId(), item.source.tenant_id ?? "default", item.source.archive_id ?? null, item.source.namespace, item.source.external_id, externalIdHash, item.source.source_id ?? null, item.source.source_schema_version, digest2, item.source.import_run_id, item.source.caller_stable_id ?? null, noteId]
           );
-          outcomes[index] = { index, outcome: "inserted", note_id: noteId, external_id_hash: externalIdHash, content_digest: digest2 };
+          outcomes.push({ index, outcome: "inserted", note_id: noteId, external_id_hash: externalIdHash, content_digest: digest2 });
           continue;
         }
-        const row = existing.rows[0];
-        if (row.content_digest === digest2) {
-          outcomes[index] = { index, outcome: "unchanged", note_id: row.note_id, external_id_hash: externalIdHash, content_digest: digest2 };
+        if (existing.content_digest === digest2) {
+          outcomes.push({ index, outcome: "unchanged", note_id: existing.note_id, external_id_hash: externalIdHash, content_digest: digest2 });
           continue;
         }
-        const policy = item.policy ?? "version";
+        const policy = item.policy ?? options.policy ?? "version";
         if (policy === "conflict") {
-          outcomes[index] = { index, outcome: "conflict", note_id: row.note_id, external_id_hash: externalIdHash, content_digest: digest2 };
+          outcomes.push({ index, outcome: "conflict", note_id: existing.note_id, external_id_hash: externalIdHash, content_digest: digest2 });
           continue;
         }
         const outcome = policy === "replace" ? "replaced" : "versioned";
-        await updateNote(tx, item, row.note_id, outcome);
-        await tx.query(
-          `UPDATE source_identity
-           SET source_schema_version = $1, content_digest = $2, import_run_id = $3, updated_at = now()
-           WHERE note_id = $4
-             AND tenant_id = $5
-             AND archive_id IS NOT DISTINCT FROM $6
-             AND namespace = $7
-             AND external_id = $8`,
-          [
-            item.source.source_schema_version,
-            digest2,
-            item.source.import_run_id,
-            row.note_id,
-            item.source.tenant_id ?? "default",
-            item.source.archive_id ?? null,
-            item.source.namespace,
-            item.source.external_id
-          ]
-        );
-        outcomes[index] = { index, outcome, note_id: row.note_id, external_id_hash: externalIdHash, content_digest: digest2 };
-      }
-      if (hasMaterialChange(outcomes)) {
+        await updateNote(tx, item, existing.note_id, outcome, digest2);
         await tx.query(
-          `INSERT INTO source_import_run (id, tenant_id, archive_id, namespace, completed_at, checkpoint, receipt)
-           VALUES ($1, $2, $3, $4, now(), $5::jsonb, $6::jsonb)
-           ON CONFLICT (id) DO UPDATE
-             SET completed_at = EXCLUDED.completed_at,
-                 checkpoint = EXCLUDED.checkpoint,
-                 receipt = EXCLUDED.receipt`,
-          [
-            items[0].source.import_run_id,
-            items[0].source.tenant_id ?? "default",
-            items[0].source.archive_id ?? null,
-            items[0].source.namespace,
-            JSON.stringify({ item_count: items.length }),
-            JSON.stringify({ counts: countOutcomes(outcomes) })
-          ]
+          `UPDATE source_identity SET source_id = $1, source_schema_version = $2, content_digest = $3, import_run_id = $4, updated_at = now()
+           WHERE note_id = $5 AND tenant_id = $6 AND archive_id IS NOT DISTINCT FROM $7 AND namespace = $8 AND external_id = $9`,
+          [item.source.source_id ?? null, item.source.source_schema_version, digest2, item.source.import_run_id, existing.note_id, item.source.tenant_id ?? "default", item.source.archive_id ?? null, item.source.namespace, item.source.external_id]
         );
+        outcomes.push({ index, outcome, note_id: existing.note_id, external_id_hash: externalIdHash, content_digest: digest2 });
       }
+      const committed = finish(importRunId, batchId, false, "committed", outcomes, options.checkpoint);
+      await tx.query(
+        `INSERT INTO source_import_run (id, tenant_id, archive_id, namespace, external_run_id, source_id, source_schema_version, workspace_id, completed_at, checkpoint, receipt)
+         VALUES ($1, $2, $3, $4, $5, $6, $7, $8, now(), $9::jsonb, $10::jsonb)
+         ON CONFLICT (id) DO UPDATE SET source_id = EXCLUDED.source_id, source_schema_version = EXCLUDED.source_schema_version, workspace_id = EXCLUDED.workspace_id, completed_at = EXCLUDED.completed_at, checkpoint = EXCLUDED.checkpoint, receipt = EXCLUDED.receipt`,
+        [sourceRunRecordId(items[0].source), items[0].source.tenant_id ?? "default", items[0].source.archive_id ?? null, items[0].source.namespace, importRunId, items[0].source.source_id ?? null, items[0].source.source_schema_version, items[0].source.workspace_id ?? null, JSON.stringify(options.checkpoint ?? {}), JSON.stringify(redactedReceipt(committed))]
+      );
+      await tx.query(
+        `INSERT INTO source_import_batch (id, tenant_id, archive_id, namespace, batch_id, request_digest, import_run_id, outcome, checkpoint, receipt)
+         VALUES ($1, $2, $3, $4, $5, $6, $7, 'committed', $8::jsonb, $9::jsonb)`,
+        [generateId(), items[0].source.tenant_id ?? "default", items[0].source.archive_id ?? null, items[0].source.namespace, batchId, requestDigest, importRunId, JSON.stringify(options.checkpoint ?? {}), JSON.stringify(redactedReceipt(committed))]
+      );
+      return committed;
     });
-    if (hasMaterialChange(outcomes)) {
-      this.events?.emit("source.upserted", { importRunId: items[0].source.import_run_id, counts: countOutcomes(outcomes) });
+    if (response.outcome === "committed" && hasMaterialChange(response.items)) {
+      this.events?.emit("source.upserted", { importRunId, counts: response.counts });
     }
-    return this.finish(items[0].source.import_run_id, false, outcomes);
-  }
-  finish(importRunId, dryRun, outcomes) {
-    return { import_run_id: importRunId, dry_run: dryRun, outcomes, counts: countOutcomes(outcomes) };
+    return response;
   }
 };
+async function findExisting(tx, item) {
+  const result = await tx.query(
+    `SELECT note_id, content_digest FROM source_identity
+     WHERE tenant_id = $1 AND archive_id IS NOT DISTINCT FROM $2 AND namespace = $3 AND external_id = $4 LIMIT 1`,
+    [item.source.tenant_id ?? "default", item.source.archive_id ?? null, item.source.namespace, item.source.external_id]
+  );
+  return result.rows[0] ?? null;
+}
+async function previewItems(db, items, batchPolicy) {
+  const preview = [];
+  for (const [index, item] of items.entries()) {
+    const external_id_hash = sourceIdentityHash(item.source);
+    const content_digest = sourceContentDigest(item.content);
+    const existing = await findExisting(db, item);
+    if (!existing) preview.push({ index, outcome: "inserted", external_id_hash, content_digest });
+    else if (existing.content_digest === content_digest) preview.push({ index, outcome: "unchanged", note_id: existing.note_id, external_id_hash, content_digest });
+    else if ((item.policy ?? batchPolicy ?? "version") === "conflict") preview.push({ index, outcome: "conflict", note_id: existing.note_id, external_id_hash, content_digest });
+    else preview.push({ index, outcome: (item.policy ?? batchPolicy) === "replace" ? "replaced" : "versioned", note_id: existing.note_id, external_id_hash, content_digest });
+  }
+  return preview;
+}
+function validateItems(items, maxItems, initialReason) {
+  const seen = /* @__PURE__ */ new Set();
+  const stableIds = /* @__PURE__ */ new Set();
+  const rejected = [];
+  let batchReason = initialReason ?? (items.length === 0 || items.length > maxItems ? "batch_size_out_of_bounds" : null);
+  for (const [index, item] of items.entries()) {
+    const digest2 = sourceContentDigest(item.content ?? "");
+    let reason = batchReason;
+    try {
+      assertSource(item.source);
+      if (!item.content || item.content.length > 4194304) reason ??= "invalid_item";
+      if ((item.format ?? "markdown").length > 100 || (item.title?.length ?? 0) > 2e3 || JSON.stringify(item.metadata ?? {}).length > 262144) reason ??= "invalid_item";
+      if (item.content_digest && item.content_digest !== digest2) reason ??= "content_digest_mismatch";
+      const identity = `${item.source.tenant_id ?? "default"}\0${item.source.archive_id ?? ""}\0${item.source.namespace}\0${item.source.external_id}`;
+      if (seen.has(identity)) reason ??= "duplicate_external_id_in_batch";
+      seen.add(identity);
+      if (item.source.caller_stable_id && stableIds.has(item.source.caller_stable_id)) reason ??= "caller_stable_id_conflict";
+      if (item.source.caller_stable_id) stableIds.add(item.source.caller_stable_id);
+    } catch (error) {
+      const code = error instanceof Error ? error.message : "invalid_item";
+      reason ??= code === "invalid_batch_metadata" ? code : "invalid_item";
+    }
+    if (reason) {
+      batchReason = reason;
+      rejected.push({ index, outcome: "rejected", external_id_hash: sourceIdentityHash(item.source), content_digest: digest2, reason_code: reason });
+    }
+  }
+  if (!batchReason) return null;
+  if (rejected.length === items.length) return rejected;
+  return items.map((item, index) => rejected.find((result) => result.index === index) ?? {
+    index,
+    outcome: "rejected",
+    external_id_hash: sourceIdentityHash(item.source),
+    content_digest: sourceContentDigest(item.content),
+    reason_code: batchReason
+  });
+}
+function finish(importRunId, batchId, dryRun, outcome, items, checkpoint) {
+  return {
+    contract_version: SOURCE_UPSERT_CONTRACT_VERSION,
+    import_run_id: importRunId,
+    batch_id: batchId,
+    dry_run: dryRun,
+    outcome,
+    ...checkpoint ? { checkpoint } : {},
+    items,
+    outcomes: items,
+    counts: countOutcomes(items)
+  };
+}
+function redactedReceipt(receipt) {
+  return { ...contractResponse(receipt), items: receipt.items.map(sanitizeItem) };
+}
+function contractResponse(receipt) {
+  return {
+    contract_version: receipt.contract_version,
+    import_run_id: receipt.import_run_id,
+    batch_id: receipt.batch_id,
+    dry_run: receipt.dry_run,
+    outcome: receipt.outcome,
+    ...receipt.checkpoint ? { checkpoint: receipt.checkpoint } : {},
+    counts: receipt.counts,
+    items: receipt.items
+  };
+}
+function sanitizeItem(item) {
+  return {
+    index: item.index,
+    outcome: item.outcome,
+    ...item.note_id ? { note_id: item.note_id } : {},
+    external_id_hash: item.external_id_hash,
+    content_digest: item.content_digest,
+    ...item.reason_code ? { reason_code: item.reason_code } : {}
+  };
+}
 function hasMaterialChange(outcomes) {
-  return outcomes.some((outcome) => outcome.outcome === "inserted" || outcome.outcome === "versioned" || outcome.outcome === "replaced");
+  return outcomes.some((item) => item.outcome === "inserted" || item.outcome === "versioned" || item.outcome === "replaced");
 }
 function countOutcomes(outcomes) {
   return {
-    inserted: outcomes.filter((outcome) => outcome.outcome === "inserted").length,
-    unchanged: outcomes.filter((outcome) => outcome.outcome === "unchanged").length,
-    versioned: outcomes.filter((outcome) => outcome.outcome === "versioned").length,
-    replaced: outcomes.filter((outcome) => outcome.outcome === "replaced").length,
-    conflict: outcomes.filter((outcome) => outcome.outcome === "conflict").length,
-    rejected: outcomes.filter((outcome) => outcome.outcome === "rejected").length
+    inserted: outcomes.filter((item) => item.outcome === "inserted").length,
+    unchanged: outcomes.filter((item) => item.outcome === "unchanged").length,
+    versioned: outcomes.filter((item) => item.outcome === "versioned").length,
+    replaced: outcomes.filter((item) => item.outcome === "replaced").length,
+    conflict: outcomes.filter((item) => item.outcome === "conflict").length,
+    rejected: outcomes.filter((item) => item.outcome === "rejected").length
   };
 }
 
@@ -29407,7 +29530,7 @@ function profileOf(value) {
   return typeof profile === "string" ? profile : void 0;
 }
 function validateShardManifest(value) {
-  let validate;
+  let validate2;
   const profile = profileOf(value);
   if (profile === "core-v1") {
     const version = value && typeof value === "object" && !Array.isArray(value) ? coreSchemaVersion(String(value.version ?? "")) : void 0;
@@ -29417,7 +29540,7 @@ function validateShardManifest(value) {
         errors: ["(root) uses an unsupported canonical core-v1 schema version"]
       };
     }
-    validate = coreValidatorFor("manifest", version);
+    validate2 = coreValidatorFor("manifest", version);
   } else if (profile === "record-v1") {
     const version = value && typeof value === "object" && !Array.isArray(value) ? recordSchemaVersion(String(value.version ?? "")) : void 0;
     if (!version) {
@@ -29426,7 +29549,7 @@ function validateShardManifest(value) {
         errors: ["(root) uses an unsupported canonical record-v1 schema version"]
       };
     }
-    validate = recordValidatorFor("manifest", version);
+    validate2 = recordValidatorFor("manifest", version);
   } else if (profile === "full-v1") {
     const version = value && typeof value === "object" && !Array.isArray(value) ? fullSchemaVersion(String(value.version ?? "")) : void 0;
     if (!version) {
@@ -29435,12 +29558,12 @@ function validateShardManifest(value) {
         errors: ["(root) uses an unsupported canonical full-v1 schema version"]
       };
     }
-    validate = fullValidatorFor("manifest", version);
+    validate2 = fullValidatorFor("manifest", version);
   } else {
-    validate = legacyValidatorFor("manifest");
+    validate2 = legacyValidatorFor("manifest");
   }
-  const valid = validate(value);
-  return { valid, errors: formatErrors(validate.errors) };
+  const valid = validate2(value);
+  return { valid, errors: formatErrors(validate2.errors) };
 }
 function parseJsonArray(bytes, path) {
   if (!bytes) return { records: [], errors: [] };
@@ -29883,9 +30006,9 @@ async function validateFullV1ShardArchive(input) {
   return { valid: errors.length === 0, errors };
 }
 function validateShardComponentRecord(component, value, profile, version = CURRENT_SHARD_VERSION) {
-  let validate;
+  let validate2;
   if (profile === "core-v1" && component in CORE_V1_COMPONENT_FILES) {
-    validate = coreValidatorFor(component, version);
+    validate2 = coreValidatorFor(component, version);
   } else if (profile === "record-v1" && component in RECORD_V1_COMPONENT_FILES) {
     const canonicalVersion = recordSchemaVersion(version);
     if (!canonicalVersion) {
@@ -29894,7 +30017,7 @@ function validateShardComponentRecord(component, value, profile, version = CURRE
         errors: [`(root) uses an unsupported canonical record-v1 schema version ${version}`]
       };
     }
-    validate = recordValidatorFor(component, canonicalVersion);
+    validate2 = recordValidatorFor(component, canonicalVersion);
   } else if (profile === "full-v1" && component in FULL_V1_COMPONENT_FILES) {
     const canonicalVersion = fullSchemaVersion(version);
     if (!canonicalVersion) {
@@ -29903,7 +30026,7 @@ function validateShardComponentRecord(component, value, profile, version = CURRE
         errors: [`(root) uses an unsupported canonical full-v1 schema version ${version}`]
       };
     }
-    validate = fullValidatorFor(component, canonicalVersion);
+    validate2 = fullValidatorFor(component, canonicalVersion);
   } else {
     const legacyDef = LEGACY_COMPONENT_SCHEMA_DEFS[component];
     if (!legacyDef) {
@@ -29912,10 +30035,10 @@ function validateShardComponentRecord(component, value, profile, version = CURRE
         errors: [`(root) component '${component}' requires an explicit full-v1 profile`]
       };
     }
-    validate = legacyValidatorFor(legacyDef);
+    validate2 = legacyValidatorFor(legacyDef);
   }
-  const valid = validate(value);
-  return { valid, errors: formatErrors(validate.errors) };
+  const valid = validate2(value);
+  return { valid, errors: formatErrors(validate2.errors) };
 }
 function assertShardComponentRecord(component, value, profile, version = CURRENT_SHARD_VERSION) {
   const result = validateShardComponentRecord(component, value, profile, version);
@@ -36228,7 +36351,7 @@ function getProjectedRecordValidator() {
   return projectedRecordValidator;
 }
 function validateAiwgFortemiIndexExportSchema(value) {
-  const validate = getExportValidator();
+  const validate2 = getExportValidator();
   const schemaValue = value && typeof value === "object" && Array.isArray(value.items) ? {
     ...value,
     items: value.items.map((item) => {
@@ -36238,13 +36361,13 @@ function validateAiwgFortemiIndexExportSchema(value) {
       return schemaRecord;
     })
   } : value;
-  const valid = validate(schemaValue);
-  return { valid, errors: formatErrors2(validate.errors) };
+  const valid = validate2(schemaValue);
+  return { valid, errors: formatErrors2(validate2.errors) };
 }
 function validateAiwgFortemiProjectedRecordSchema(value) {
-  const validate = getProjectedRecordValidator();
-  const valid = validate(value);
-  return { valid, errors: formatErrors2(validate.errors) };
+  const validate2 = getProjectedRecordValidator();
+  const valid = validate2(value);
+  return { valid, errors: formatErrors2(validate2.errors) };
 }
 var encoder5 = new TextEncoder();
 var UUID_NAMESPACE = "7ab5d1f8-29d2-5e35-9e2f-3a45de171a9e";
@@ -37235,6 +37358,7 @@ var RECORD_COLLECTIONS = [
   "note",
   "note_original",
   "note_revised_current",
+  "note_revision",
   "note_tag",
   "link",
   "collection",
@@ -37244,6 +37368,7 @@ var RECORD_COLLECTIONS = [
   "shard_manifest",
   "source_identity",
   "source_import_run",
+  "source_import_batch",
   "deletion_receipt"
 ];
 var RECORD_STORE_CAPABILITIES = {
@@ -37366,10 +37491,10 @@ var MemoryRecordStore = class {
 };
 
 // src/records/idb-record-store.ts
-var DB_VERSION = 2;
+var DB_VERSION = 3;
 var JOURNAL_STORE = "journal";
 var META_STORE = "meta";
-var RECORD_SCHEMA_VERSION = 2;
+var RECORD_SCHEMA_VERSION = 3;
 function requestToPromise(request) {
   return new Promise((resolve, reject) => {
     request.onsuccess = () => resolve(request.result);
@@ -37926,10 +38051,11 @@ function collectionsParentFirst(collections) {
   return ordered;
 }
 async function projectNotes(db, store) {
-  const [noteRows, originals, revised, tags, links, collections, memberships] = await Promise.all([
+  const [noteRows, originals, revised, revisions, tags, links, collections, memberships] = await Promise.all([
     store.list("note"),
     store.list("note_original"),
     store.list("note_revised_current"),
+    store.list("note_revision"),
     store.list("note_tag"),
     store.list("link"),
     store.list("collection"),
@@ -38026,6 +38152,28 @@ async function projectNotes(db, store) {
       ]
     );
   }
+  for (const r of revisions) {
+    await db.query(
+      `INSERT INTO note_revision (id, note_id, revision_number, type, content, ai_metadata, model, created_at)
+       VALUES ($1, $2, $3, $4, $5, $6::jsonb, $7, $8)
+       ON CONFLICT (id) DO UPDATE SET
+         revision_number = EXCLUDED.revision_number,
+         type = EXCLUDED.type,
+         content = EXCLUDED.content,
+         ai_metadata = EXCLUDED.ai_metadata,
+         model = EXCLUDED.model`,
+      [
+        r.id,
+        r.note_id,
+        r.revision_number,
+        r.type,
+        r.content,
+        r.ai_metadata == null ? null : JSON.stringify(r.ai_metadata),
+        r.model,
+        r.created_at
+      ]
+    );
+  }
   for (const t of tags) {
     await db.query(
       `INSERT INTO note_tag (id, note_id, tag, created_at)
@@ -38062,6 +38210,7 @@ async function projectNotes(db, store) {
   );
   return {
     notes: noteRows.length,
+    revisions: revisions.length,
     tags: tags.length,
     links: links.length,
     collections: collections.length,
@@ -39296,177 +39445,283 @@ async function importShardToRecords(store, data, options) {
 function now() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
-function contentDigest2(content) {
-  return computeHash(new TextEncoder().encode(content));
-}
-function sourceHash2(source) {
-  return computeHash(new TextEncoder().encode([
-    source.tenant_id ?? "default",
-    source.archive_id ?? "",
-    source.namespace,
-    source.external_id
-  ].join("\0")));
-}
 function countOutcomes2(outcomes) {
   return {
-    inserted: outcomes.filter((outcome) => outcome.outcome === "inserted").length,
-    unchanged: outcomes.filter((outcome) => outcome.outcome === "unchanged").length,
-    versioned: outcomes.filter((outcome) => outcome.outcome === "versioned").length,
-    replaced: outcomes.filter((outcome) => outcome.outcome === "replaced").length,
-    conflict: outcomes.filter((outcome) => outcome.outcome === "conflict").length,
-    rejected: outcomes.filter((outcome) => outcome.outcome === "rejected").length
+    inserted: outcomes.filter((item) => item.outcome === "inserted").length,
+    unchanged: outcomes.filter((item) => item.outcome === "unchanged").length,
+    versioned: outcomes.filter((item) => item.outcome === "versioned").length,
+    replaced: outcomes.filter((item) => item.outcome === "replaced").length,
+    conflict: outcomes.filter((item) => item.outcome === "conflict").length,
+    rejected: outcomes.filter((item) => item.outcome === "rejected").length
+  };
+}
+function finish2(importRunId, batchId, dryRun, outcome, items, checkpoint) {
+  return {
+    contract_version: SOURCE_UPSERT_CONTRACT_VERSION,
+    import_run_id: importRunId,
+    batch_id: batchId,
+    dry_run: dryRun,
+    outcome,
+    ...checkpoint ? { checkpoint } : {},
+    items,
+    outcomes: items,
+    counts: countOutcomes2(items)
   };
 }
 async function findSource(store, source) {
   const identities = await store.list("source_identity");
   return identities.find((identity) => identity.tenant_id === (source.tenant_id ?? "default") && identity.archive_id === (source.archive_id ?? null) && identity.namespace === source.namespace && identity.external_id === source.external_id) ?? null;
 }
+async function upsertRecordStoreRequest(store, request, scope = {}) {
+  const items = request.items.map((item) => ({
+    source: {
+      tenant_id: scope.tenant_id ?? "default",
+      archive_id: scope.archive_id ?? null,
+      namespace: request.source_namespace,
+      external_id: item.external_id,
+      source_schema_version: request.source_schema_version,
+      import_run_id: request.import_run_id,
+      source_id: request.source_id,
+      workspace_id: request.workspace_id,
+      caller_stable_id: item.caller_stable_id
+    },
+    title: item.title,
+    content: item.content,
+    content_digest: item.content_digest,
+    format: item.format,
+    metadata: item.metadata,
+    policy: item.policy ?? request.policy
+  }));
+  const result = await upsertRecordStoreSources(store, items, {
+    dryRun: request.dry_run,
+    batchId: request.batch_id,
+    checkpoint: request.checkpoint,
+    policy: request.policy
+  });
+  return {
+    contract_version: result.contract_version,
+    import_run_id: result.import_run_id,
+    batch_id: result.batch_id,
+    dry_run: result.dry_run,
+    outcome: result.outcome,
+    ...result.checkpoint ? { checkpoint: result.checkpoint } : {},
+    counts: result.counts,
+    items: result.items
+  };
+}
 async function upsertRecordStoreSources(store, items, options = {}) {
-  const maxItems = options.maxItems ?? 500;
-  if (items.length > maxItems) throw new Error(`Source upsert batch exceeds the ${maxItems} item bound`);
   if (!store.applyBatch) throw new Error("RecordStore source upsert requires atomic applyBatch() support");
-  if (items.length === 0) {
-    return {
-      import_run_id: "",
-      dry_run: options.dryRun === true,
-      outcomes: [],
-      counts: { inserted: 0, unchanged: 0, versioned: 0, replaced: 0, conflict: 0, rejected: 0 }
-    };
+  const importRunId = items[0]?.source.import_run_id ?? "";
+  const requestDigest = sourceRequestDigest(items, options);
+  const batchId = options.batchId ?? deriveSourceBatchId(requestDigest);
+  const batchReason = batchId.length === 0 || batchId.length > 200 ? "invalid_batch_metadata" : JSON.stringify(options.checkpoint ?? {}).length > 65536 ? "checkpoint_too_large" : void 0;
+  const validation = validate(items, options.maxItems ?? 500, batchReason);
+  if (validation) return finish2(importRunId, batchId, options.dryRun === true, "rejected", validation, options.checkpoint);
+  const batches = await store.list("source_import_batch");
+  const prior = batches.find((batch2) => batch2.tenant_id === (items[0].source.tenant_id ?? "default") && batch2.archive_id === (items[0].source.archive_id ?? null) && batch2.namespace === items[0].source.namespace && batch2.batch_id === batchId);
+  if (prior) {
+    if (prior.request_digest !== requestDigest) {
+      const rejected = items.map((item, index) => ({
+        index,
+        outcome: "rejected",
+        external_id_hash: sourceIdentityHash(item.source),
+        content_digest: sourceContentDigest(item.content),
+        reason_code: "batch_id_reused_with_different_request"
+      }));
+      return finish2(importRunId, batchId, false, "rejected", rejected, options.checkpoint);
+    }
+    const receipt = prior.receipt;
+    const unchanged = receipt.items.map((item) => ({ ...item, outcome: "unchanged", reason_code: void 0, reason: void 0 }));
+    return finish2(importRunId, batchId, false, "duplicate", unchanged, receipt.checkpoint);
   }
   const outcomes = [];
   const mutations = [];
   const stamp = now();
   for (const [index, item] of items.entries()) {
-    const external_id_hash = sourceHash2(item.source);
-    const content_digest = contentDigest2(item.content);
+    const external_id_hash = sourceIdentityHash(item.source);
+    const content_digest = sourceContentDigest(item.content);
     const existing = await findSource(store, item.source);
     if (!existing) {
       const noteId = item.source.caller_stable_id ?? generateId();
-      outcomes.push({ index, outcome: "inserted", note_id: noteId, external_id_hash, content_digest });
-      if (!options.dryRun) {
-        const note2 = {
-          id: noteId,
-          archive_id: item.source.archive_id ?? null,
-          title: item.title ?? null,
-          format: item.format ?? "markdown",
-          source: `source:${item.source.namespace}`,
-          visibility: item.visibility ?? "private",
-          revision_mode: "standard",
-          is_starred: false,
-          is_pinned: false,
-          is_archived: false,
-          created_at: stamp,
-          updated_at: stamp,
-          deleted_at: null
-        };
-        const original = {
-          id: generateId(),
-          note_id: noteId,
-          content: item.content,
-          content_hash: content_digest,
-          created_at: stamp
-        };
-        const current2 = {
-          id: noteId,
-          content: item.content,
-          ai_metadata: item.metadata ?? null,
-          generation_count: 0,
-          model: null,
-          is_user_edited: false,
-          updated_at: stamp
-        };
-        const identity = {
-          id: generateId(),
-          tenant_id: item.source.tenant_id ?? "default",
-          archive_id: item.source.archive_id ?? null,
-          namespace: item.source.namespace,
-          external_id: item.source.external_id,
-          external_id_hash,
-          source_schema_version: item.source.source_schema_version,
-          content_digest,
-          import_run_id: item.source.import_run_id,
-          caller_stable_id: item.source.caller_stable_id ?? null,
-          note_id: noteId,
-          created_at: stamp,
-          updated_at: stamp
-        };
-        mutations.push(
-          { op: "put", collection: "note", record: note2 },
-          { op: "put", collection: "note_original", record: original },
-          { op: "put", collection: "note_revised_current", record: current2 },
-          { op: "put", collection: "source_identity", record: identity }
-        );
+      if (await store.get("note", noteId)) {
+        const rejected = items.map((candidate, candidateIndex) => ({
+          index: candidateIndex,
+          outcome: "rejected",
+          external_id_hash: sourceIdentityHash(candidate.source),
+          content_digest: sourceContentDigest(candidate.content),
+          reason_code: "caller_stable_id_conflict"
+        }));
+        return finish2(importRunId, batchId, false, "rejected", rejected, options.checkpoint);
       }
+      outcomes.push({ index, outcome: "inserted", note_id: noteId, external_id_hash, content_digest });
+      if (!options.dryRun) addInsertMutations(mutations, item, noteId, content_digest, external_id_hash, stamp);
       continue;
     }
     if (existing.content_digest === content_digest) {
       outcomes.push({ index, outcome: "unchanged", note_id: existing.note_id, external_id_hash, content_digest });
       continue;
     }
-    const policy = item.policy ?? "version";
+    const policy = item.policy ?? options.policy ?? "version";
     if (policy === "conflict") {
       outcomes.push({ index, outcome: "conflict", note_id: existing.note_id, external_id_hash, content_digest });
       continue;
     }
     const note = await store.get("note", existing.note_id);
     const current = await store.get("note_revised_current", existing.note_id);
-    if (!note || !current) {
-      outcomes.push({ index, outcome: "rejected", note_id: existing.note_id, external_id_hash, content_digest, reason: "source identity points to a missing note" });
-      continue;
+    const originals = await store.list("note_original");
+    const original = originals.find((candidate) => candidate.note_id === existing.note_id);
+    if (!note || !current || !original) {
+      const rejected = items.map((candidate, candidateIndex) => ({
+        index: candidateIndex,
+        outcome: "rejected",
+        note_id: candidateIndex === index ? existing.note_id : void 0,
+        external_id_hash: sourceIdentityHash(candidate.source),
+        content_digest: sourceContentDigest(candidate.content),
+        reason_code: "invalid_item"
+      }));
+      return finish2(importRunId, batchId, false, "rejected", rejected, options.checkpoint);
     }
     const outcome = policy === "replace" ? "replaced" : "versioned";
     outcomes.push({ index, outcome, note_id: existing.note_id, external_id_hash, content_digest });
     if (!options.dryRun) {
-      mutations.push(
-        {
-          op: "put",
-          collection: "note",
-          record: {
-            ...note,
-            title: item.title ?? null,
-            archive_id: item.source.archive_id ?? null,
-            format: item.format ?? "markdown",
-            visibility: item.visibility ?? "private",
-            deleted_at: null,
-            updated_at: stamp
-          }
-        },
-        {
-          op: "put",
-          collection: "note_revised_current",
-          record: { ...current, content: item.content, ai_metadata: item.metadata ?? null, is_user_edited: false, updated_at: stamp }
-        },
-        {
-          op: "put",
-          collection: "source_identity",
-          record: { ...existing, source_schema_version: item.source.source_schema_version, content_digest, import_run_id: item.source.import_run_id, updated_at: stamp }
-        }
-      );
-    }
-  }
-  if (!options.dryRun && hasMaterialChange2(outcomes)) {
-    const run = {
-      id: items[0].source.import_run_id,
-      tenant_id: items[0].source.tenant_id ?? "default",
-      archive_id: items[0].source.archive_id ?? null,
-      namespace: items[0].source.namespace,
-      started_at: stamp,
-      completed_at: stamp,
-      checkpoint: { item_count: items.length },
-      receipt: { counts: countOutcomes2(outcomes) }
+      const revisionNumber = outcome === "versioned" ? (await store.list("note_revision")).filter((row) => row.note_id === existing.note_id).length + 1 : void 0;
+      addUpdateMutations(mutations, item, existing, note, current, original, outcome, content_digest, stamp, revisionNumber);
+    }
+  }
+  if (options.dryRun) return finish2(importRunId, batchId, true, "preview", outcomes, options.checkpoint);
+  const committed = finish2(importRunId, batchId, false, "committed", outcomes, options.checkpoint);
+  const contractReceipt = {
+    contract_version: committed.contract_version,
+    import_run_id: committed.import_run_id,
+    batch_id: committed.batch_id,
+    dry_run: committed.dry_run,
+    outcome: committed.outcome,
+    ...committed.checkpoint ? { checkpoint: committed.checkpoint } : {},
+    counts: committed.counts,
+    items: committed.items
+  };
+  const run = {
+    id: sourceRunRecordId(items[0].source),
+    external_run_id: importRunId,
+    source_id: items[0].source.source_id ?? null,
+    source_schema_version: items[0].source.source_schema_version,
+    workspace_id: items[0].source.workspace_id ?? null,
+    tenant_id: items[0].source.tenant_id ?? "default",
+    archive_id: items[0].source.archive_id ?? null,
+    namespace: items[0].source.namespace,
+    started_at: stamp,
+    completed_at: stamp,
+    checkpoint: options.checkpoint ?? {},
+    receipt: contractReceipt
+  };
+  const batch = {
+    id: generateId(),
+    tenant_id: items[0].source.tenant_id ?? "default",
+    archive_id: items[0].source.archive_id ?? null,
+    namespace: items[0].source.namespace,
+    batch_id: batchId,
+    request_digest: requestDigest,
+    import_run_id: importRunId,
+    outcome: "committed",
+    checkpoint: options.checkpoint ?? {},
+    receipt: contractReceipt,
+    created_at: stamp
+  };
+  mutations.push(
+    { op: "put", collection: "source_import_run", record: run },
+    { op: "put", collection: "source_import_batch", record: batch }
+  );
+  await store.applyBatch(mutations);
+  return committed;
+}
+function addInsertMutations(mutations, item, noteId, contentDigest, externalIdHash, stamp) {
+  const note = {
+    id: noteId,
+    archive_id: item.source.archive_id ?? null,
+    title: item.title ?? null,
+    format: item.format ?? "markdown",
+    source: `source:${item.source.namespace}`,
+    visibility: item.visibility ?? "private",
+    revision_mode: "standard",
+    is_starred: false,
+    is_pinned: false,
+    is_archived: false,
+    created_at: stamp,
+    updated_at: stamp,
+    deleted_at: null
+  };
+  const original = { id: generateId(), note_id: noteId, content: item.content, content_hash: contentDigest, created_at: stamp };
+  const current = { id: noteId, content: item.content, ai_metadata: item.metadata ?? null, generation_count: 0, model: null, is_user_edited: false, updated_at: stamp };
+  const revision = { id: generateId(), note_id: noteId, revision_number: 1, type: "source-import", content: item.content, ai_metadata: item.metadata ?? null, model: null, created_at: stamp };
+  const identity = {
+    id: generateId(),
+    tenant_id: item.source.tenant_id ?? "default",
+    archive_id: item.source.archive_id ?? null,
+    namespace: item.source.namespace,
+    external_id: item.source.external_id,
+    external_id_hash: externalIdHash,
+    source_id: item.source.source_id ?? null,
+    source_schema_version: item.source.source_schema_version,
+    content_digest: contentDigest,
+    import_run_id: item.source.import_run_id,
+    caller_stable_id: item.source.caller_stable_id ?? null,
+    note_id: noteId,
+    created_at: stamp,
+    updated_at: stamp
+  };
+  mutations.push(
+    { op: "put", collection: "note", record: note },
+    { op: "put", collection: "note_original", record: original },
+    { op: "put", collection: "note_revised_current", record: current },
+    { op: "put", collection: "note_revision", record: revision },
+    { op: "put", collection: "source_identity", record: identity }
+  );
+}
+function addUpdateMutations(mutations, item, identity, note, current, original, outcome, contentDigest, stamp, revisionNumber) {
+  mutations.push(
+    { op: "put", collection: "note", record: { ...note, title: item.title ?? null, archive_id: item.source.archive_id ?? null, format: item.format ?? "markdown", visibility: item.visibility ?? "private", deleted_at: null, updated_at: stamp } },
+    { op: "put", collection: "note_revised_current", record: { ...current, content: item.content, ai_metadata: item.metadata ?? null, is_user_edited: false, updated_at: stamp } },
+    { op: "put", collection: "source_identity", record: { ...identity, source_id: item.source.source_id ?? null, source_schema_version: item.source.source_schema_version, content_digest: contentDigest, import_run_id: item.source.import_run_id, updated_at: stamp } }
+  );
+  if (outcome === "replaced") {
+    mutations.push({ op: "put", collection: "note_original", record: { ...original, content: item.content, content_hash: contentDigest } });
+  } else {
+    const revision = {
+      id: generateId(),
+      note_id: identity.note_id,
+      revision_number: revisionNumber ?? 1,
+      type: "source-import",
+      content: item.content,
+      ai_metadata: item.metadata ?? null,
+      model: null,
+      created_at: stamp
     };
-    mutations.push({ op: "put", collection: "source_import_run", record: run });
-    await store.applyBatch(mutations);
+    mutations.push({ op: "put", collection: "note_revision", record: revision });
   }
-  return {
-    import_run_id: items[0].source.import_run_id,
-    dry_run: options.dryRun === true,
-    outcomes,
-    counts: countOutcomes2(outcomes)
-  };
 }
-function hasMaterialChange2(outcomes) {
-  return outcomes.some((outcome) => outcome.outcome === "inserted" || outcome.outcome === "versioned" || outcome.outcome === "replaced");
+function validate(items, maxItems, initialReason) {
+  let reason = initialReason ?? (items.length === 0 || items.length > maxItems ? "batch_size_out_of_bounds" : null);
+  const seen = /* @__PURE__ */ new Set();
+  const stableIds = /* @__PURE__ */ new Set();
+  for (const item of items) {
+    if (!item.source.tenant_id || !item.source.namespace || !item.source.external_id || !item.source.source_schema_version || !item.source.import_run_id || !item.content) reason ??= "invalid_item";
+    if ((item.source.source_id?.length ?? 0) > 500 || item.source.source_id === "" || (item.source.workspace_id?.length ?? 0) > 500 || item.source.workspace_id === "") reason ??= "invalid_batch_metadata";
+    if ((item.format ?? "markdown").length > 100 || (item.title?.length ?? 0) > 2e3 || JSON.stringify(item.metadata ?? {}).length > 262144) reason ??= "invalid_item";
+    if (item.content_digest && item.content_digest !== sourceContentDigest(item.content)) reason ??= "content_digest_mismatch";
+    const key = `${item.source.tenant_id}\0${item.source.archive_id ?? ""}\0${item.source.namespace}\0${item.source.external_id}`;
+    if (seen.has(key)) reason ??= "duplicate_external_id_in_batch";
+    seen.add(key);
+    if (item.source.caller_stable_id && stableIds.has(item.source.caller_stable_id)) reason ??= "caller_stable_id_conflict";
+    if (item.source.caller_stable_id) stableIds.add(item.source.caller_stable_id);
+  }
+  if (!reason) return null;
+  return items.map((item, index) => ({
+    index,
+    outcome: "rejected",
+    external_id_hash: sourceIdentityHash(item.source),
+    content_digest: sourceContentDigest(item.content ?? ""),
+    reason_code: reason
+  }));
 }
 
 // src/records/lifecycle-purge.ts
@@ -39586,8 +39841,8 @@ async function purgeRecordStoreGraph(store, selector, operationKey) {
 }
 
 // src/index.ts
-var VERSION = "2026.9.0";
+var VERSION = "2026.9.2";
 
-export { AIWG_SCAN_REQUIRED_FIELDS, AllowlistTrustStore, ArchiveManager, AttachmentsRepository, BridgeInferenceProvider, CORE_V1_COMPONENTS, CURRENT_MIGRATION_HEAD, CURRENT_SHARD_VERSION, CanonicalAttachmentsRepository, CanonicalNotesRepository, CapabilityManager, CaptureKnowledgeInputSchema, CollectionsRepository, CommunitiesRepository, DATASET_EXECUTION_CAPABILITY_IDS, DATASET_EXECUTION_CONTRACT, DATASET_EXECUTION_SCHEMA_VERSION, DATASET_INGEST_CONTRACT, DATASET_INGEST_SCHEMA_VERSION, DATASET_LINEAGE_CONTRACT, DATASET_LINEAGE_SCHEMA_VERSION, DATASET_MATERIALIZATION_CONTRACT, DATASET_MATERIALIZATION_KINDS, DATASET_MATERIALIZATION_SCHEMA_VERSION, DB_SNAPSHOT_SCHEMA_VERSION, DEFAULT_LARGE_DOCUMENT_CHARS, DEFAULT_LARGE_DOCUMENT_CHUNKS, DatasetIngestError, DatasetIngestExecutor, DatasetLineageLedger, DatasetMaterializationError, DbSnapshotVersionError, EMBED_REQUEST_KIND, EMBED_RESPONSE_KIND, EmbeddingSetsRepository, FORTEMI_BROWSER_LOCAL_DATASET_EXECUTION_DESCRIPTOR, FORTEMI_COMPATIBILITY_PATH, FORTEMI_COMPATIBILITY_STATES, FORTEMI_PORTABLE_SHARD_DATASET_EXECUTION_DESCRIPTOR, FORTEMI_REQUIRED_COMPATIBILITY_CAPABILITIES, FORTEMI_SERVER_COMPATIBILITY_REVISION, FORTEMI_STATIC_CACHE_DATASET_EXECUTION_DESCRIPTOR, FallbackRouter, FortemiToolManifest, GetNoteInputSchema, GraphRepository, IdbRecordStore, JOB_CAPABILITIES, JOB_PRIORITIES, JobQueueWorker, LINEAGE_ENTITY_KINDS, LINEAGE_RELATIONSHIP_KINDS, LOCAL_ENDPOINTS, LifecyclePurgeRepository, LineageValidationError, LinksRepository, ListNotesInputSchema, ManageArchiveInputSchema, ManageAttachmentsInputSchema, ManageCapabilitiesInputSchema, ManageCollectionsInputSchema, ManageLinksInputSchema, ManageNoteInputSchema, ManageTagsInputSchema, MemoryBlobStore, MemoryDatasetIngestStore, MemoryRecordStore, MigrationRunner, NotesRepository, OpenAICompatibleProvider, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, PGliteWorkerStorageBackend, PGliteWorkerStorageBackendFactory, ProvenanceRepository, ProviderRegistry, RECORD_COLLECTIONS, RECORD_SCHEMA_VERSION, RECORD_STORE_CAPABILITIES, REGISTERED_METADATA_PATHS, SHARD_FORMAT, SIGNATURE_ENTRY, SIGNING_ENVELOPE_VERSION, SUPPORTED_PGLITE_VERSION, SearchInputSchema, SearchRepository, SkosRepository, SourceUpsertRepository, TagsRepository, TransactionProxy, TypedEventBus, VERSION, aiRevisionHandler, aiwgFortemiIndexFromKnowledgeShard, aiwgFortemiIndexToCommunityGraph, aiwgFortemiIndexToKnowledgeShard, aiwgFortemiIndexToKnowledgeShardWithReport, allMigrations, appendPluginScript, assertAiwgFortemiChunkManifest, assertAiwgFortemiChunkPart, assertAiwgFortemiIndexExport, assertAiwgStaticEmbeddingSet, assertShardComponentRecord, buildAiwgChunkedIndex, buildAiwgStaticEmbeddingSet, buildMetadataPredicateConditions, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, clearPrefetchedShard, collectionFromShard, collectionToShard, compareDatasetIncrementalParity, computeBlobHash, computeHash, computeLineageDigest, computeSri, conceptTaggingHandler, configureInferenceRuntime, cosineSimilarity, createAiwgFetchChunkLoader, createAiwgFetchDetailLoader, createAiwgIndexController, createAiwgReviewDecisionExport, createBlobStore, createBridgeInferenceProviders, createCosineSemanticProvider, createCspReportHandler, createFortemi, createLazyBlobStore, createLegacyProvider, createLocalProviderProfile, createPGliteBackend, createPGliteInstance, createRecordBackend, createRecordStore, createRemoteBackend, createRoutes, createShardBackend, createShardCapabilityReport, createWorkerEmbedFunction, datasetDestinationScopeKey, defaultStorageBackendFactory, defineInferenceProvider, defineInferenceRuntime, defineLegacyInferenceProvider, defineOpenAICompatibleProvider, deriveDatasetIngestIdempotencyKey, detectCommunities, detectGpuCapabilities, detectInferenceCapabilities, digestDatasetMaterializationValue, discoverLocalProviders, dropAttachmentProjection, dropNoteProjection, dumpDbSnapshot, embeddingConfigToShard, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, executeDatasetMaterialization, executeDatasetRetrieval, exportShard, exportShardFromRecords, exportShardFromRecordsWithReport, exportShardWithReport, fetchAndValidateFortemiCompatibility, fetchPluginScript, filterAiwgRecordsByPrivacy, findAiwgStaticDuplicatePairs, formatFortemiCompatibilitySummary, fortemiCompatibilityUrl, fortemiManifest, fromPrefetched, generateId, getAiwgFortemiFacets, getAiwgFortemiIndexExportSchema, getConfiguredInferenceProviderId, getEmbedFunction, getEmbeddingTaskSelectionOptions, getFortemiBridge, getFortemiSecretStore, getJobQueueStatus, getKnowledgeShardContractReceipt, getKnowledgeShardProfileRegistry, getKnowledgeShardSchema, getLlmFunction, getNote, getPrefetchedSha256, getProviderRouteRequirementIssue, handleEmbedRequests, hasFortemiSecureSecrets, importShard, importShardToRecords, inferInferenceTaskCapability, inferLocalEmbeddingDimensions, isPluginScriptAllowed, isShardPrefetched, isShardSigningSupported, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, mergeInferenceRuntimeConfigs, migrateLegacyBlobStore, negotiateDatasetExecutionCapabilities, negotiateDatasetMaterializationProfile, noteFromShard, noteSkosTagToShard, noteToShard, openShard, packTarGz, parseCspReport, prefetchShard, previewRecordStorePurge, profileSupportError, projectAttachments, projectNotes, projectRecords, provenanceEdgeToShard, providerSatisfiesRouteRequirements, purgeRecordStoreGraph, queryAiwgFortemiIndex, queryAiwgHybridIndex, queryAiwgSemanticIndex, registerLlmCapability, registerSemanticCapability, registerSemanticCapabilityWorker, registerServiceWorker, restoreDbSnapshot, searchTool, selectBackend, selectEmbeddingTask, selectLlmModel, setEmbedFunction, setEmbeddingTaskSelectionOptions, setLlmFunction, sha256Hex, sidecarBlobDigests, signShard, skosConceptToShard, skosRelationToShard, skosSchemeToShard, suggestTags, tagsToShard, templateToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, upsertRecordStoreSources, urlLinkToShard, validateAiwgFortemiChunkManifest, validateAiwgFortemiChunkPart, validateAiwgFortemiIndexExport, validateAiwgFortemiIndexExportSchema, validateAiwgFortemiProjectedRecordSchema, validateAiwgStaticEmbeddingSet, validateChecksums, validateCoreV1ShardArchive, validateDatasetBenchmarkEvidence, validateDatasetExecutionDescriptor, validateFortemiCompatibilityResponse, validateFullV1ShardArchive, validateProviderRoute, validateRecordV1ShardArchive, validateShardArchive, validateShardComponentRecord, validateShardManifest, verifyDbSnapshotMeta, verifyShardSignature, verifySri };
+export { AIWG_SCAN_REQUIRED_FIELDS, AllowlistTrustStore, ArchiveManager, AttachmentsRepository, BridgeInferenceProvider, CORE_V1_COMPONENTS, CURRENT_MIGRATION_HEAD, CURRENT_SHARD_VERSION, CanonicalAttachmentsRepository, CanonicalNotesRepository, CapabilityManager, CaptureKnowledgeInputSchema, CollectionsRepository, CommunitiesRepository, DATASET_EXECUTION_CAPABILITY_IDS, DATASET_EXECUTION_CONTRACT, DATASET_EXECUTION_SCHEMA_VERSION, DATASET_INGEST_CONTRACT, DATASET_INGEST_SCHEMA_VERSION, DATASET_LINEAGE_CONTRACT, DATASET_LINEAGE_SCHEMA_VERSION, DATASET_MATERIALIZATION_CONTRACT, DATASET_MATERIALIZATION_KINDS, DATASET_MATERIALIZATION_SCHEMA_VERSION, DB_SNAPSHOT_SCHEMA_VERSION, DEFAULT_LARGE_DOCUMENT_CHARS, DEFAULT_LARGE_DOCUMENT_CHUNKS, DatasetIngestError, DatasetIngestExecutor, DatasetLineageLedger, DatasetMaterializationError, DbSnapshotVersionError, EMBED_REQUEST_KIND, EMBED_RESPONSE_KIND, EmbeddingSetsRepository, FORTEMI_BROWSER_LOCAL_DATASET_EXECUTION_DESCRIPTOR, FORTEMI_COMPATIBILITY_PATH, FORTEMI_COMPATIBILITY_STATES, FORTEMI_PORTABLE_SHARD_DATASET_EXECUTION_DESCRIPTOR, FORTEMI_REQUIRED_COMPATIBILITY_CAPABILITIES, FORTEMI_SERVER_COMPATIBILITY_REVISION, FORTEMI_STATIC_CACHE_DATASET_EXECUTION_DESCRIPTOR, FallbackRouter, FortemiToolManifest, GetNoteInputSchema, GraphRepository, IdbRecordStore, JOB_CAPABILITIES, JOB_PRIORITIES, JobQueueWorker, LINEAGE_ENTITY_KINDS, LINEAGE_RELATIONSHIP_KINDS, LOCAL_ENDPOINTS, LifecyclePurgeRepository, LineageValidationError, LinksRepository, ListNotesInputSchema, ManageArchiveInputSchema, ManageAttachmentsInputSchema, ManageCapabilitiesInputSchema, ManageCollectionsInputSchema, ManageLinksInputSchema, ManageNoteInputSchema, ManageTagsInputSchema, MemoryBlobStore, MemoryDatasetIngestStore, MemoryRecordStore, MigrationRunner, NotesRepository, OpenAICompatibleProvider, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, PGliteWorkerStorageBackend, PGliteWorkerStorageBackendFactory, ProvenanceRepository, ProviderRegistry, RECORD_COLLECTIONS, RECORD_SCHEMA_VERSION, RECORD_STORE_CAPABILITIES, REGISTERED_METADATA_PATHS, SHARD_FORMAT, SIGNATURE_ENTRY, SIGNING_ENVELOPE_VERSION, SOURCE_UPSERT_CONTRACT_VERSION, SOURCE_UPSERT_MAX_ITEMS, SUPPORTED_PGLITE_VERSION, SearchInputSchema, SearchRepository, SkosRepository, SourceUpsertRepository, TagsRepository, TransactionProxy, TypedEventBus, VERSION, aiRevisionHandler, aiwgFortemiIndexFromKnowledgeShard, aiwgFortemiIndexToCommunityGraph, aiwgFortemiIndexToKnowledgeShard, aiwgFortemiIndexToKnowledgeShardWithReport, allMigrations, appendPluginScript, assertAiwgFortemiChunkManifest, assertAiwgFortemiChunkPart, assertAiwgFortemiIndexExport, assertAiwgStaticEmbeddingSet, assertShardComponentRecord, buildAiwgChunkedIndex, buildAiwgStaticEmbeddingSet, buildMetadataPredicateConditions, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, clearPrefetchedShard, collectionFromShard, collectionToShard, compareDatasetIncrementalParity, computeBlobHash, computeHash, computeLineageDigest, computeSri, conceptTaggingHandler, configureInferenceRuntime, cosineSimilarity, createAiwgFetchChunkLoader, createAiwgFetchDetailLoader, createAiwgIndexController, createAiwgReviewDecisionExport, createBlobStore, createBridgeInferenceProviders, createCosineSemanticProvider, createCspReportHandler, createFortemi, createLazyBlobStore, createLegacyProvider, createLocalProviderProfile, createPGliteBackend, createPGliteInstance, createRecordBackend, createRecordStore, createRemoteBackend, createRoutes, createShardBackend, createShardCapabilityReport, createWorkerEmbedFunction, datasetDestinationScopeKey, defaultStorageBackendFactory, defineInferenceProvider, defineInferenceRuntime, defineLegacyInferenceProvider, defineOpenAICompatibleProvider, deriveDatasetIngestIdempotencyKey, detectCommunities, detectGpuCapabilities, detectInferenceCapabilities, digestDatasetMaterializationValue, discoverLocalProviders, dropAttachmentProjection, dropNoteProjection, dumpDbSnapshot, embeddingConfigToShard, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, executeDatasetMaterialization, executeDatasetRetrieval, exportShard, exportShardFromRecords, exportShardFromRecordsWithReport, exportShardWithReport, fetchAndValidateFortemiCompatibility, fetchPluginScript, filterAiwgRecordsByPrivacy, findAiwgStaticDuplicatePairs, formatFortemiCompatibilitySummary, fortemiCompatibilityUrl, fortemiManifest, fromPrefetched, generateId, getAiwgFortemiFacets, getAiwgFortemiIndexExportSchema, getConfiguredInferenceProviderId, getEmbedFunction, getEmbeddingTaskSelectionOptions, getFortemiBridge, getFortemiSecretStore, getJobQueueStatus, getKnowledgeShardContractReceipt, getKnowledgeShardProfileRegistry, getKnowledgeShardSchema, getLlmFunction, getNote, getPrefetchedSha256, getProviderRouteRequirementIssue, handleEmbedRequests, hasFortemiSecureSecrets, importShard, importShardToRecords, inferInferenceTaskCapability, inferLocalEmbeddingDimensions, isPluginScriptAllowed, isShardPrefetched, isShardSigningSupported, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, mergeInferenceRuntimeConfigs, migrateLegacyBlobStore, negotiateDatasetExecutionCapabilities, negotiateDatasetMaterializationProfile, noteFromShard, noteSkosTagToShard, noteToShard, openShard, packTarGz, parseCspReport, prefetchShard, previewRecordStorePurge, profileSupportError, projectAttachments, projectNotes, projectRecords, provenanceEdgeToShard, providerSatisfiesRouteRequirements, purgeRecordStoreGraph, queryAiwgFortemiIndex, queryAiwgHybridIndex, queryAiwgSemanticIndex, registerLlmCapability, registerSemanticCapability, registerSemanticCapabilityWorker, registerServiceWorker, restoreDbSnapshot, searchTool, selectBackend, selectEmbeddingTask, selectLlmModel, setEmbedFunction, setEmbeddingTaskSelectionOptions, setLlmFunction, sha256Hex, sidecarBlobDigests, signShard, skosConceptToShard, skosRelationToShard, skosSchemeToShard, suggestTags, tagsToShard, templateToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, upsertRecordStoreRequest, upsertRecordStoreSources, urlLinkToShard, validateAiwgFortemiChunkManifest, validateAiwgFortemiChunkPart, validateAiwgFortemiIndexExport, validateAiwgFortemiIndexExportSchema, validateAiwgFortemiProjectedRecordSchema, validateAiwgStaticEmbeddingSet, validateChecksums, validateCoreV1ShardArchive, validateDatasetBenchmarkEvidence, validateDatasetExecutionDescriptor, validateFortemiCompatibilityResponse, validateFullV1ShardArchive, validateProviderRoute, validateRecordV1ShardArchive, validateShardArchive, validateShardComponentRecord, validateShardManifest, verifyDbSnapshotMeta, verifyShardSignature, verifySri };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map