@antfly/embedded 0.3.0-rc.8 → 0.3.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as CheckReport, S as StableSnapshotReport, R as RestoreOptions, N as NativeLibrary, I as InferenceOptions, J as JsonInput, P as PullProgress, D as Database, U as Uint64Like } from './database-BT18eJuO.cjs';
-export { a as Capabilities, b as CompactReport, G as GraphDirection, c as InferenceMode, d as InferenceStatus, L as LibraryNotFoundError, e as LibrarySource, f as MIN_THREAD_STACK_SIZE, M as MemoryAdmissionStats, O as OpenMode, g as OpenOptions, h as PendingWorkStatus, i as Profile, j as ReplayGeneratedEnrichmentsResult, k as ResolvedLibrary, l as SUPPORTED_ABI_VERSION, m as Status, n as Storage, o as StorageStatus, T as THREADING_SERIALIZED, p as TTLCleanupOptions, q as TxnStatus, r as UnsupportedPlatformError, V as VacuumReport, W as WriteIntent, s as create, t as createHosted, u as createWithOptions, v as embeddedPlatformPackageName, w as open, x as openHosted, y as openReadonly, z as openStatusOnly, A as openWithOptions, B as platformLibraryFileName, E as resolveLibrary } from './database-BT18eJuO.cjs';
+import { C as CheckReport, S as StableSnapshotReport, R as RestoreOptions, N as NativeLibrary, I as InferenceOptions, J as JsonInput, P as PullProgress, D as Database, U as Uint64Like } from './database-DAUsGvzu.cjs';
+export { a as Capabilities, b as CompactReport, G as GraphDirection, c as InferenceMode, d as InferenceStatus, L as LibraryNotFoundError, e as LibrarySource, f as LiveByteAccounting, g as LiveByteCategory, h as MIN_THREAD_STACK_SIZE, M as MemoryAdmissionStats, O as OpenMode, i as OpenOptions, j as OutcomeReceiptStatus, k as PendingWorkStatus, l as Profile, m as ReplayGeneratedEnrichmentsResult, n as ResolvedLibrary, o as SUPPORTED_ABI_VERSION, p as Status, q as Storage, r as StorageStatus, T as THREADING_SERIALIZED, s as TTLCleanupOptions, t as TxnStatus, u as UnsupportedPlatformError, V as VacuumReport, W as WriteIntent, v as create, w as createHosted, x as createWithOptions, y as embeddedPlatformPackageName, z as open, A as openHosted, B as openReadonly, E as openStatusOnly, F as openWithOptions, H as platformLibraryFileName, K as resolveLibrary } from './database-DAUsGvzu.cjs';
 import 'koffi';
 
 /** Thrown by validateAbi() when the loaded libantfly does not match the header this binding was written against. */
@@ -43,8 +43,9 @@ declare enum ErrorCode {
     TxnNotFound = 5,
     Busy = 6,
     /**
-     * The operation crossed its publication point, but crash durability could
-     * not be confirmed. Inspect the destination; do not retry automatically.
+     * The operation may have taken effect: it was published but crash
+     * durability could not be confirmed, or a failure left it unknown whether
+     * it applied. Inspect the affected data; do not retry automatically.
      */
     OutcomeUnknown = 7,
     /**
@@ -53,8 +54,9 @@ declare enum ErrorCode {
      */
     Unsupported = 8,
     /**
-     * A bounded drain such as runUntilIdle detected a managed index making no
-     * forward progress and gave up.
+     * Derived work stalled or failed. A batch may already have committed its
+     * primary write: inspect the error detail and pending-work diagnostics.
+     * Do not replay a batch reported as committed.
      */
     Stalled = 9,
     /**
@@ -105,7 +107,13 @@ declare class BusyError extends AntflyError {
     constructor(message?: string);
 }
 declare class OutcomeUnknownError extends AntflyError {
-    constructor(message?: string);
+    /**
+     * The receipt the database issued for an autocommit SQL write that ended
+     * with an unknown outcome, if any. Resolve it later with
+     * `Database.outcomeReceiptStatus()`.
+     */
+    readonly outcomeReceipt?: string;
+    constructor(message?: string, outcomeReceipt?: string);
 }
 declare class UnsupportedError extends AntflyError {
     constructor(message?: string);
@@ -154,6 +162,22 @@ declare function decodeArtifactIdRaw(artifactIdBase64: string): Promise<Buffer>;
 /** Typed form of decodeArtifactIdRaw. */
 declare function decodeArtifactId(artifactIdBase64: string): Promise<unknown>;
 
+interface GraphDiagnostic {
+    code: string;
+    message: string;
+    span?: {
+        start: number;
+        end: number;
+    };
+    write_outcome?: "not_started" | "aborted" | "committed" | "unknown";
+    transaction_id?: string;
+}
+declare class GraphError extends Error {
+    readonly diagnostic: GraphDiagnostic;
+    readonly nativeCode: number;
+    constructor(diagnostic: GraphDiagnostic, nativeCode: number);
+}
+
 /**
  * Return false from a pull() onProgress or generateStream() onChunk
  * callback to cancel; anything else (including void/undefined) continues.
@@ -161,8 +185,8 @@ declare function decodeArtifactId(artifactIdBase64: string): Promise<unknown>;
 type CallbackResult = boolean | void;
 /**
  * An embedded Antfly inference runtime handle: no database, just model
- * inference (embed, rerank, chunk, generate, rewrite, decide, extract, read/OCR,
- * transcribe) via the libantfly antfly_inference_* C ABI. Models load on
+ * inference (embed, rerank, chunk, generate, rewrite, decide, extract, and read
+ * for documents/images/audio) via the libantfly antfly_inference_* C ABI. Models load on
  * first use and stay cached until close().
  *
  * Every JSON call except pull() and generateStream() is async (runs on
@@ -238,11 +262,9 @@ declare class Inference implements AsyncDisposable {
     decide(request: JsonInput): Promise<unknown>;
     extractRaw(request: JsonInput): Promise<Buffer>;
     extract(request: JsonInput): Promise<unknown>;
-    /** OCR. */
+    /** Read images, documents, or audio. */
     readRaw(request: JsonInput): Promise<Buffer>;
     read(request: JsonInput): Promise<unknown>;
-    transcribeRaw(request: JsonInput): Promise<Buffer>;
-    transcribe(request: JsonInput): Promise<unknown>;
     /** The installed models, as returned by GET /ai/v1/models. */
     listModelsRaw(): Promise<Buffer>;
     listModels(): Promise<unknown>;
@@ -290,12 +312,18 @@ interface SqlDiagnostic {
 declare class SqlError extends Error {
     readonly diagnostic: SqlDiagnostic;
     readonly transactionId?: string | undefined;
+    readonly outcomeReceipt?: string | undefined;
     readonly sqlstate: string;
-    constructor(diagnostic: SqlDiagnostic, transactionId?: string | undefined);
+    /**
+     * @param outcomeReceipt Set when an autocommit write ended with an unknown
+     *   outcome; resolve it later with `Database.outcomeReceiptStatus()`.
+     */
+    constructor(diagnostic: SqlDiagnostic, transactionId?: string | undefined, outcomeReceipt?: string | undefined);
 }
 interface SqlColumn {
     name: string;
     type: string;
+    element_type?: string;
 }
 interface SqlResult<Row = Record<string, unknown>> {
     columns: readonly SqlColumn[];
@@ -322,4 +350,4 @@ declare class Connection {
     close(): Promise<void>;
 }
 
-export { AbiMismatchError, AntflyError, BusyError, CancelledError, CheckReport, Connection, Database, ErrorCode, Inference, InferenceOptions, IntentConflictError, InternalError, InvalidArgumentError, JsonInput, NotFoundError, OutcomeUnknownError, PullProgress, RestoreOptions, type SqlColumn, SqlError, type SqlResult, StableSnapshotReport, StalledError, TxnNotFoundError, Uint64Like, UnsupportedError, VersionConflictError, abiVersion, checkFile, checkFileRaw, copyStableSnapshotFile, copyStableSnapshotFileRaw, decodeArtifactId, decodeArtifactIdRaw, errorCodeDescription, errorCodeName, restore, restoreFile, threadingMode, validateAbi, validateInferenceAbi };
+export { AbiMismatchError, AntflyError, BusyError, CancelledError, CheckReport, Connection, Database, ErrorCode, type GraphDiagnostic, GraphError, Inference, InferenceOptions, IntentConflictError, InternalError, InvalidArgumentError, JsonInput, NotFoundError, OutcomeUnknownError, PullProgress, RestoreOptions, type SqlColumn, SqlError, type SqlResult, StableSnapshotReport, StalledError, TxnNotFoundError, Uint64Like, UnsupportedError, VersionConflictError, abiVersion, checkFile, checkFileRaw, copyStableSnapshotFile, copyStableSnapshotFileRaw, decodeArtifactId, decodeArtifactIdRaw, errorCodeDescription, errorCodeName, restore, restoreFile, threadingMode, validateAbi, validateInferenceAbi };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CheckReport, S as StableSnapshotReport, R as RestoreOptions, N as NativeLibrary, I as InferenceOptions, J as JsonInput, P as PullProgress, D as Database, U as Uint64Like } from './database-BT18eJuO.js';
-export { a as Capabilities, b as CompactReport, G as GraphDirection, c as InferenceMode, d as InferenceStatus, L as LibraryNotFoundError, e as LibrarySource, f as MIN_THREAD_STACK_SIZE, M as MemoryAdmissionStats, O as OpenMode, g as OpenOptions, h as PendingWorkStatus, i as Profile, j as ReplayGeneratedEnrichmentsResult, k as ResolvedLibrary, l as SUPPORTED_ABI_VERSION, m as Status, n as Storage, o as StorageStatus, T as THREADING_SERIALIZED, p as TTLCleanupOptions, q as TxnStatus, r as UnsupportedPlatformError, V as VacuumReport, W as WriteIntent, s as create, t as createHosted, u as createWithOptions, v as embeddedPlatformPackageName, w as open, x as openHosted, y as openReadonly, z as openStatusOnly, A as openWithOptions, B as platformLibraryFileName, E as resolveLibrary } from './database-BT18eJuO.js';
+import { C as CheckReport, S as StableSnapshotReport, R as RestoreOptions, N as NativeLibrary, I as InferenceOptions, J as JsonInput, P as PullProgress, D as Database, U as Uint64Like } from './database-DAUsGvzu.js';
+export { a as Capabilities, b as CompactReport, G as GraphDirection, c as InferenceMode, d as InferenceStatus, L as LibraryNotFoundError, e as LibrarySource, f as LiveByteAccounting, g as LiveByteCategory, h as MIN_THREAD_STACK_SIZE, M as MemoryAdmissionStats, O as OpenMode, i as OpenOptions, j as OutcomeReceiptStatus, k as PendingWorkStatus, l as Profile, m as ReplayGeneratedEnrichmentsResult, n as ResolvedLibrary, o as SUPPORTED_ABI_VERSION, p as Status, q as Storage, r as StorageStatus, T as THREADING_SERIALIZED, s as TTLCleanupOptions, t as TxnStatus, u as UnsupportedPlatformError, V as VacuumReport, W as WriteIntent, v as create, w as createHosted, x as createWithOptions, y as embeddedPlatformPackageName, z as open, A as openHosted, B as openReadonly, E as openStatusOnly, F as openWithOptions, H as platformLibraryFileName, K as resolveLibrary } from './database-DAUsGvzu.js';
 import 'koffi';
 
 /** Thrown by validateAbi() when the loaded libantfly does not match the header this binding was written against. */
@@ -43,8 +43,9 @@ declare enum ErrorCode {
     TxnNotFound = 5,
     Busy = 6,
     /**
-     * The operation crossed its publication point, but crash durability could
-     * not be confirmed. Inspect the destination; do not retry automatically.
+     * The operation may have taken effect: it was published but crash
+     * durability could not be confirmed, or a failure left it unknown whether
+     * it applied. Inspect the affected data; do not retry automatically.
      */
     OutcomeUnknown = 7,
     /**
@@ -53,8 +54,9 @@ declare enum ErrorCode {
      */
     Unsupported = 8,
     /**
-     * A bounded drain such as runUntilIdle detected a managed index making no
-     * forward progress and gave up.
+     * Derived work stalled or failed. A batch may already have committed its
+     * primary write: inspect the error detail and pending-work diagnostics.
+     * Do not replay a batch reported as committed.
      */
     Stalled = 9,
     /**
@@ -105,7 +107,13 @@ declare class BusyError extends AntflyError {
     constructor(message?: string);
 }
 declare class OutcomeUnknownError extends AntflyError {
-    constructor(message?: string);
+    /**
+     * The receipt the database issued for an autocommit SQL write that ended
+     * with an unknown outcome, if any. Resolve it later with
+     * `Database.outcomeReceiptStatus()`.
+     */
+    readonly outcomeReceipt?: string;
+    constructor(message?: string, outcomeReceipt?: string);
 }
 declare class UnsupportedError extends AntflyError {
     constructor(message?: string);
@@ -154,6 +162,22 @@ declare function decodeArtifactIdRaw(artifactIdBase64: string): Promise<Buffer>;
 /** Typed form of decodeArtifactIdRaw. */
 declare function decodeArtifactId(artifactIdBase64: string): Promise<unknown>;
 
+interface GraphDiagnostic {
+    code: string;
+    message: string;
+    span?: {
+        start: number;
+        end: number;
+    };
+    write_outcome?: "not_started" | "aborted" | "committed" | "unknown";
+    transaction_id?: string;
+}
+declare class GraphError extends Error {
+    readonly diagnostic: GraphDiagnostic;
+    readonly nativeCode: number;
+    constructor(diagnostic: GraphDiagnostic, nativeCode: number);
+}
+
 /**
  * Return false from a pull() onProgress or generateStream() onChunk
  * callback to cancel; anything else (including void/undefined) continues.
@@ -161,8 +185,8 @@ declare function decodeArtifactId(artifactIdBase64: string): Promise<unknown>;
 type CallbackResult = boolean | void;
 /**
  * An embedded Antfly inference runtime handle: no database, just model
- * inference (embed, rerank, chunk, generate, rewrite, decide, extract, read/OCR,
- * transcribe) via the libantfly antfly_inference_* C ABI. Models load on
+ * inference (embed, rerank, chunk, generate, rewrite, decide, extract, and read
+ * for documents/images/audio) via the libantfly antfly_inference_* C ABI. Models load on
  * first use and stay cached until close().
  *
  * Every JSON call except pull() and generateStream() is async (runs on
@@ -238,11 +262,9 @@ declare class Inference implements AsyncDisposable {
     decide(request: JsonInput): Promise<unknown>;
     extractRaw(request: JsonInput): Promise<Buffer>;
     extract(request: JsonInput): Promise<unknown>;
-    /** OCR. */
+    /** Read images, documents, or audio. */
     readRaw(request: JsonInput): Promise<Buffer>;
     read(request: JsonInput): Promise<unknown>;
-    transcribeRaw(request: JsonInput): Promise<Buffer>;
-    transcribe(request: JsonInput): Promise<unknown>;
     /** The installed models, as returned by GET /ai/v1/models. */
     listModelsRaw(): Promise<Buffer>;
     listModels(): Promise<unknown>;
@@ -290,12 +312,18 @@ interface SqlDiagnostic {
 declare class SqlError extends Error {
     readonly diagnostic: SqlDiagnostic;
     readonly transactionId?: string | undefined;
+    readonly outcomeReceipt?: string | undefined;
     readonly sqlstate: string;
-    constructor(diagnostic: SqlDiagnostic, transactionId?: string | undefined);
+    /**
+     * @param outcomeReceipt Set when an autocommit write ended with an unknown
+     *   outcome; resolve it later with `Database.outcomeReceiptStatus()`.
+     */
+    constructor(diagnostic: SqlDiagnostic, transactionId?: string | undefined, outcomeReceipt?: string | undefined);
 }
 interface SqlColumn {
     name: string;
     type: string;
+    element_type?: string;
 }
 interface SqlResult<Row = Record<string, unknown>> {
     columns: readonly SqlColumn[];
@@ -322,4 +350,4 @@ declare class Connection {
     close(): Promise<void>;
 }
 
-export { AbiMismatchError, AntflyError, BusyError, CancelledError, CheckReport, Connection, Database, ErrorCode, Inference, InferenceOptions, IntentConflictError, InternalError, InvalidArgumentError, JsonInput, NotFoundError, OutcomeUnknownError, PullProgress, RestoreOptions, type SqlColumn, SqlError, type SqlResult, StableSnapshotReport, StalledError, TxnNotFoundError, Uint64Like, UnsupportedError, VersionConflictError, abiVersion, checkFile, checkFileRaw, copyStableSnapshotFile, copyStableSnapshotFileRaw, decodeArtifactId, decodeArtifactIdRaw, errorCodeDescription, errorCodeName, restore, restoreFile, threadingMode, validateAbi, validateInferenceAbi };
+export { AbiMismatchError, AntflyError, BusyError, CancelledError, CheckReport, Connection, Database, ErrorCode, type GraphDiagnostic, GraphError, Inference, InferenceOptions, IntentConflictError, InternalError, InvalidArgumentError, JsonInput, NotFoundError, OutcomeUnknownError, PullProgress, RestoreOptions, type SqlColumn, SqlError, type SqlResult, StableSnapshotReport, StalledError, TxnNotFoundError, Uint64Like, UnsupportedError, VersionConflictError, abiVersion, checkFile, checkFileRaw, copyStableSnapshotFile, copyStableSnapshotFileRaw, decodeArtifactId, decodeArtifactIdRaw, errorCodeDescription, errorCodeName, restore, restoreFile, threadingMode, validateAbi, validateInferenceAbi };

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   Connection,
   SqlError,
   __filename
-} from "./chunk-4KIXT2VQ.js";
+} from "./chunk-MUBX3DSJ.js";
 
 // src/abi.ts
 import koffi2 from "koffi";
@@ -154,7 +154,7 @@ var ERROR_CODE_DESCRIPTIONS = {
   [4 /* IntentConflict */]: "a transaction intent conflicts with the requested operation",
   [5 /* TxnNotFound */]: "the requested transaction was not found",
   [6 /* Busy */]: "the requested resource is temporarily busy or changed during streaming; stabilize it and retry",
-  [7 /* OutcomeUnknown */]: "the operation was published, but crash durability could not be confirmed; inspect the destination and do not retry automatically",
+  [7 /* OutcomeUnknown */]: "the operation may have taken effect, but whether it applied or became durable could not be confirmed; inspect the affected data and do not retry automatically",
   [8 /* Unsupported */]: "the operation requires a capability that is not supported by this platform or filesystem",
   [9 /* Stalled */]: "derived work stalled or failed; inspect pending-work diagnostics and repair or reopen the database",
   [10 /* Cancelled */]: "the caller cancelled the operation",
@@ -228,9 +228,16 @@ var BusyError = class extends AntflyError {
   }
 };
 var OutcomeUnknownError = class extends AntflyError {
-  constructor(message) {
+  /**
+   * The receipt the database issued for an autocommit SQL write that ended
+   * with an unknown outcome, if any. Resolve it later with
+   * `Database.outcomeReceiptStatus()`.
+   */
+  outcomeReceipt;
+  constructor(message, outcomeReceipt) {
     super(7 /* OutcomeUnknown */, message);
     this.name = "OutcomeUnknownError";
+    if (outcomeReceipt !== void 0) this.outcomeReceipt = outcomeReceipt;
     Object.setPrototypeOf(this, new.target.prototype);
   }
 };
@@ -468,6 +475,31 @@ function buildNative() {
   configureKoffiStacks();
   const handle = koffi.load(resolved.path);
   const f = handle.func.bind(handle);
+  let dbGraphCatalogJson;
+  let dbCypherJson;
+  let dbGraphWriteStatusJson;
+  try {
+    dbGraphCatalogJson = f("antfly_db_graph_catalog_json", "uint32_t", [
+      PAntflyDb,
+      AntflySlice,
+      PAntflyBufferOut
+    ]);
+    dbCypherJson = f("antfly_db_cypher_json", "uint32_t", [
+      PAntflyDb,
+      AntflySlice,
+      AntflySlice,
+      PAntflyBufferOut
+    ]);
+    dbGraphWriteStatusJson = f("antfly_db_graph_write_status_json", "uint32_t", [
+      PAntflyDb,
+      AntflySlice,
+      PAntflyBufferOut
+    ]);
+  } catch {
+    dbGraphCatalogJson = void 0;
+    dbCypherJson = void 0;
+    dbGraphWriteStatusJson = void 0;
+  }
   return {
     handle,
     resolved,
@@ -492,6 +524,9 @@ function buildNative() {
     dbClose: f("antfly_db_close", "void", [PAntflyDb]),
     bufferFree: f("antfly_buffer_free", "void", [koffi.pointer(AntflyBuffer)]),
     dbSqlJson: f("antfly_db_sql_json", "uint32_t", [PAntflyDb, AntflySlice, PAntflyBufferOut]),
+    dbGraphCatalogJson,
+    dbCypherJson,
+    dbGraphWriteStatusJson,
     dbOpenTable: f("antfly_db_open_table", "uint32_t", [PAntflyDb, AntflySlice, PAntflyDbOut]),
     dbCreateTableJson: f("antfly_db_create_table_json", "uint32_t", [
       PAntflyDb,
@@ -574,7 +609,33 @@ function buildNative() {
       "uint64_t",
       "uint8_t"
     ]),
+    dbBatchWithReceipt: f("antfly_db_batch_with_receipt", "uint32_t", [
+      PAntflyDb,
+      PAntflyWriteIntentArray,
+      "size_t",
+      PAntflyVersionPredicateArray,
+      "size_t",
+      "uint64_t",
+      "uint8_t",
+      PAntflyBufferOut
+    ]),
     dbBatchJson: f("antfly_db_batch_json", "uint32_t", [PAntflyDb, AntflySlice, PAntflyBufferOut]),
+    dbBatchJsonWithReceipt: f("antfly_db_batch_json_with_receipt", "uint32_t", [
+      PAntflyDb,
+      AntflySlice,
+      PAntflyBufferOut,
+      PAntflyBufferOut
+    ]),
+    lastErrorOutcomeReceipt: f("antfly_last_error_outcome_receipt", "uint32_t", [PAntflyBufferOut]),
+    dbOutcomeReceiptStatus: f("antfly_db_outcome_receipt_status", "uint32_t", [
+      PAntflyDb,
+      AntflySlice,
+      PUint8Out
+    ]),
+    dbOutcomeReceiptForget: f("antfly_db_outcome_receipt_forget", "uint32_t", [
+      PAntflyDb,
+      AntflySlice
+    ]),
     dbBeginTransactionWithId: f("antfly_db_begin_transaction_with_id", "uint32_t", [
       PAntflyDb,
       "const uint8_t *",
@@ -854,11 +915,6 @@ function buildNative() {
       AntflySlice,
       PAntflyBufferOut
     ]),
-    inferenceTranscribeJson: f("antfly_inference_transcribe_json", "uint32_t", [
-      PAntflyInference,
-      AntflySlice,
-      PAntflyBufferOut
-    ]),
     inferenceListModelsJson: f("antfly_inference_list_models_json", "uint32_t", [
       PAntflyInference,
       PAntflyBufferOut
@@ -917,6 +973,18 @@ function validateInferenceAbi() {
 import * as fsp from "fs/promises";
 import { basename, dirname as dirname2, join as join2 } from "path";
 
+// src/graph-types.ts
+var GraphError = class extends Error {
+  constructor(diagnostic, nativeCode) {
+    super(diagnostic.message);
+    this.diagnostic = diagnostic;
+    this.nativeCode = nativeCode;
+    this.name = "GraphError";
+  }
+  diagnostic;
+  nativeCode;
+};
+
 // src/marshal.ts
 import { promisify } from "util";
 import koffi3 from "koffi";
@@ -1030,6 +1098,8 @@ function parseMemoryJson(buf) {
 }
 
 // src/database.ts
+var OUTCOME_RECEIPT_APPLIED = 1;
+var OUTCOME_RECEIPT_NOT_APPLIED = 2;
 var OPEN_FLAG_NO_SYNC = 1 << 0;
 var OPEN_FLAG_TTL_CLEANUP = 1 << 1;
 var OPEN_FLAG_REMOTE_PROVIDER_CONFIGURED = 1 << 2;
@@ -1137,7 +1207,12 @@ var Database = class _Database {
       const code = await callAsync(fn, handle, ...args, out);
       const body = takeBuffer(this.#native, out);
       const value = body.length ? JSON.parse(body.toString("utf8")) : void 0;
-      if (code && value?.error) throw new SqlError(value.error, value.transaction_id);
+      if (code && value?.error) {
+        throw new SqlError(value.error, value.transaction_id, value.outcome_receipt);
+      }
+      if (code === 7 /* OutcomeUnknown */ && typeof value?.outcome_receipt === "string") {
+        throw new OutcomeUnknownError(void 0, value.outcome_receipt);
+      }
       checkCode(code);
       return value;
     });
@@ -1145,6 +1220,31 @@ var Database = class _Database {
   sqlJson(request) {
     return this.#invokeSql(this.#native.dbSqlJson, jsonSlice(request));
   }
+  // biome-ignore lint/suspicious/noExplicitAny: native signatures vary
+  #invokeGraph(fn, ...args) {
+    if (!fn)
+      return Promise.reject(
+        new UnsupportedError("This native library does not expose Cypher graphs")
+      );
+    return this.#run(async (handle) => {
+      const out = newBufferOut();
+      const code = await callAsync(fn, handle, ...args, out);
+      const body = takeBuffer(this.#native, out);
+      const value = body.length ? JSON.parse(body.toString("utf8")) : void 0;
+      if (code && value?.code) throw new GraphError(value, code);
+      checkCode(code);
+      return value;
+    });
+  }
+  graphCatalogJson(request) {
+    return this.#invokeGraph(this.#native.dbGraphCatalogJson, jsonSlice(request));
+  }
+  cypherJson(graph, request) {
+    return this.#invokeGraph(this.#native.dbCypherJson, stringSlice(graph), jsonSlice(request));
+  }
+  graphWriteStatus(transactionId) {
+    return this.#invokeGraph(this.#native.dbGraphWriteStatusJson, stringSlice(transactionId));
+  }
   createTable(name, schema) {
     return this.#invokeCode(this.#native.dbCreateTableJson, stringSlice(name), jsonSlice(schema));
   }
@@ -1288,21 +1388,44 @@ var Database = class _Database {
   batch(writes, timestampNs) {
     return this.#run(async (handle) => {
       const cWrites = writes.length ? writes.map(toNativeWriteIntent) : null;
+      const receiptOut = newBufferOut();
       const code = await callAsync(
-        this.#native.dbBatch,
+        this.#native.dbBatchWithReceipt,
         handle,
         cWrites,
         writes.length,
         null,
         0,
         timestampNs,
-        0
+        0,
+        receiptOut
       );
+      const receipt = takeBuffer(this.#native, receiptOut);
+      if (code === 7 /* OutcomeUnknown */ && receipt.length) {
+        throw new OutcomeUnknownError(void 0, receipt.toString("utf8"));
+      }
       checkCode(code);
     });
   }
   batchJsonRaw(request) {
-    return this.#invokeBuffer(this.#native.dbBatchJson, jsonSlice(request));
+    return this.#run(async (handle) => {
+      const out = newBufferOut();
+      const receiptOut = newBufferOut();
+      const code = await callAsync(
+        this.#native.dbBatchJsonWithReceipt,
+        handle,
+        jsonSlice(request),
+        out,
+        receiptOut
+      );
+      const receipt = takeBuffer(this.#native, receiptOut);
+      if (code === 7 /* OutcomeUnknown */ && receipt.length) {
+        takeBuffer(this.#native, out);
+        throw new OutcomeUnknownError(void 0, receipt.toString("utf8"));
+      }
+      checkCode(code);
+      return takeBuffer(this.#native, out);
+    });
   }
   async batchJson(request) {
     return parseJson(await this.batchJsonRaw(request));
@@ -1629,6 +1752,32 @@ var Database = class _Database {
       return out[0];
     });
   }
+  /**
+   * Resolves an outcome receipt (`SqlError.outcomeReceipt` or
+   * `OutcomeUnknownError.outcomeReceipt`) on any handle for the same
+   * database. Rejects with `StalledError` while the uncertain commit is not
+   * reconciled yet: retry on a Lite database; for a directory database,
+   * close the issuing handle and reopen first.
+   */
+  outcomeReceiptStatus(receipt) {
+    return this.#run(async (handle) => {
+      const out = [0];
+      const code = await callAsync(
+        this.#native.dbOutcomeReceiptStatus,
+        handle,
+        stringSlice(receipt),
+        out
+      );
+      checkCode(code);
+      if (out[0] === OUTCOME_RECEIPT_APPLIED) return "applied";
+      if (out[0] === OUTCOME_RECEIPT_NOT_APPLIED) return "not_applied";
+      throw new InternalError(`unexpected outcome receipt status ${out[0]}`);
+    });
+  }
+  /** Removes a resolved receipt's durable marker; afterwards it cannot be resolved. */
+  forgetOutcomeReceipt(receipt) {
+    return this.#invokeCode(this.#native.dbOutcomeReceiptForget, stringSlice(receipt));
+  }
   commitVersion(txnId) {
     return this.#run(async (handle) => {
       const id = txnIdBytes(txnId);
@@ -2061,19 +2210,13 @@ var Inference = class _Inference {
   async extract(request) {
     return parseJson(await this.extractRaw(request));
   }
-  /** OCR. */
+  /** Read images, documents, or audio. */
   readRaw(request) {
     return this.#invokeJson(this.#native.inferenceReadJson, request);
   }
   async read(request) {
     return parseJson(await this.readRaw(request));
   }
-  transcribeRaw(request) {
-    return this.#invokeJson(this.#native.inferenceTranscribeJson, request);
-  }
-  async transcribe(request) {
-    return parseJson(await this.transcribeRaw(request));
-  }
   /** The installed models, as returned by GET /ai/v1/models. */
   listModelsRaw() {
     return this.#run(async (handle) => {
@@ -2204,6 +2347,7 @@ export {
   Database,
   ErrorCode,
   GraphDirection,
+  GraphError,
   Inference,
   InferenceMode,
   IntentConflictError,

package/dist/kysely.cjs

@@ -24,18 +24,25 @@ __export(kysely_exports, {
 });
 module.exports = __toCommonJS(kysely_exports);
 var import_kysely = require("kysely");
+var import_migration = require("kysely/migration");
 
 // src/sql-types.ts
 var SqlError = class extends Error {
-  constructor(diagnostic, transactionId) {
+  /**
+   * @param outcomeReceipt Set when an autocommit write ended with an unknown
+   *   outcome; resolve it later with `Database.outcomeReceiptStatus()`.
+   */
+  constructor(diagnostic, transactionId, outcomeReceipt) {
     super(`${diagnostic.code}: ${diagnostic.message}`);
     this.diagnostic = diagnostic;
     this.transactionId = transactionId;
+    this.outcomeReceipt = outcomeReceipt;
     this.name = "SqlError";
     this.sqlstate = diagnostic.code;
   }
   diagnostic;
   transactionId;
+  outcomeReceipt;
   sqlstate;
 };
 
@@ -307,7 +314,7 @@ var AntflyDialect = class {
       },
       async getTables(options) {
         const names = (await database.listTables()).filter(
-          (name) => name !== "default" && (options?.withInternalKyselyTables || !name.startsWith("kysely_"))
+          (name) => name !== "default" && (options?.withInternalKyselyTables || name !== import_migration.DEFAULT_MIGRATION_TABLE && name !== import_migration.DEFAULT_MIGRATION_LOCK_TABLE)
         );
         return Promise.all(
           names.map(async (name) => {
@@ -322,19 +329,30 @@ var AntflyDialect = class {
             } finally {
               await handle.close();
             }
-            const document = schema.document_schemas?.[schema.default_type ?? "row"]?.schema;
+            const documents = Object.values(schema.document_schemas ?? {}).map(
+              (document) => document.schema
+            );
             return {
               name,
               schema: "public",
               isView: false,
               isForeign: false,
-              columns: described.columns.map((column) => ({
-                name: column.name,
-                dataType: column.type,
-                isNullable: column.name !== "_id" && !document?.required?.includes(column.name) && document?.properties?.[column.name]?.nullable !== false,
-                isAutoIncrementing: false,
-                hasDefaultValue: schema.column_defaults?.some((entry) => entry.column === column.name) ?? false
-              }))
+              columns: described.columns.map((column) => {
+                return {
+                  name: column.name,
+                  // The embedded decoder returns every integer width as bigint.
+                  // Exact NUMERIC uses decimal text; other structured values
+                  // retain conservative metadata for schema generation.
+                  dataType: column.element_type === "numeric" && column.type !== "array" ? "numeric" : column.type,
+                  isNullable: column.name !== "_id" && (documents.length === 0 || documents.some((document) => {
+                    const property = document?.properties?.[column.name];
+                    return !property || !document?.required?.includes(column.name) || property.nullable === true || property.type === "null" || Array.isArray(property.type) && property.type.includes("null");
+                  })),
+                  isAutoIncrementing: false,
+                  hasDefaultValue: schema.column_defaults?.some((entry) => entry.column === column.name) ?? false,
+                  isGeneratedAlways: schema.generated_columns?.some((entry) => entry.column === column.name) ?? false
+                };
+              })
             };
           })
         );

package/dist/kysely.d.cts

@@ -1,5 +1,5 @@
 import { Dialect, Driver, PostgresQueryCompiler, PostgresAdapter, Kysely, MigrationLockOptions, DatabaseIntrospector } from 'kysely';
-import { D as Database } from './database-BT18eJuO.cjs';
+import { D as Database } from './database-DAUsGvzu.cjs';
 import 'koffi';
 
 declare class AntflyAdapter extends PostgresAdapter {

package/dist/kysely.d.ts

@@ -1,5 +1,5 @@
 import { Dialect, Driver, PostgresQueryCompiler, PostgresAdapter, Kysely, MigrationLockOptions, DatabaseIntrospector } from 'kysely';
-import { D as Database } from './database-BT18eJuO.js';
+import { D as Database } from './database-DAUsGvzu.js';
 import 'koffi';
 
 declare class AntflyAdapter extends PostgresAdapter {