@nicia-ai/typegraph 0.39.0 → 0.40.0

package/dist/{sqlite-CYfhvESj.d.ts → sqlite-m9Izphk_.d.ts}

@@ -1,5 +1,5 @@
 import * as drizzle_orm_sqlite_core from 'drizzle-orm/sqlite-core';
-import { I as IndexDeclaration } from './index-Bq7vSPHy.js';
+import { I as IndexDeclaration } from './types-D8szWDUo.js';
 
 /**
  * Table name configuration.
@@ -696,41 +696,37 @@ declare function createSqliteTables(names?: Partial<SqliteTableNames>, options?:
             recordedFrom: drizzle_orm_sqlite_core.SQLiteColumn<{
                 name: "recorded_from";
                 tableName: string;
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
+                dataType: "number";
+                columnType: "SQLiteInteger";
+                data: number;
+                driverParam: number;
                 notNull: true;
                 hasDefault: false;
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: undefined;
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
+            }, {}, {}>;
             recordedTo: drizzle_orm_sqlite_core.SQLiteColumn<{
                 name: "recorded_to";
                 tableName: string;
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
+                dataType: "number";
+                columnType: "SQLiteInteger";
+                data: number;
+                driverParam: number;
                 notNull: true;
                 hasDefault: false;
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: undefined;
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
+            }, {}, {}>;
             op: drizzle_orm_sqlite_core.SQLiteColumn<{
                 name: "op";
                 tableName: string;
@@ -1081,41 +1077,37 @@ declare function createSqliteTables(names?: Partial<SqliteTableNames>, options?:
             recordedFrom: drizzle_orm_sqlite_core.SQLiteColumn<{
                 name: "recorded_from";
                 tableName: string;
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
+                dataType: "number";
+                columnType: "SQLiteInteger";
+                data: number;
+                driverParam: number;
                 notNull: true;
                 hasDefault: false;
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: undefined;
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
+            }, {}, {}>;
             recordedTo: drizzle_orm_sqlite_core.SQLiteColumn<{
                 name: "recorded_to";
                 tableName: string;
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
+                dataType: "number";
+                columnType: "SQLiteInteger";
+                data: number;
+                driverParam: number;
                 notNull: true;
                 hasDefault: false;
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: undefined;
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
+            }, {}, {}>;
             op: drizzle_orm_sqlite_core.SQLiteColumn<{
                 name: "op";
                 tableName: string;
@@ -1216,6 +1208,23 @@ declare function createSqliteTables(names?: Partial<SqliteTableNames>, options?:
             }, {}, {
                 length: number | undefined;
             }>;
+            revision: drizzle_orm_sqlite_core.SQLiteColumn<{
+                name: "revision";
+                tableName: string;
+                dataType: "number";
+                columnType: "SQLiteInteger";
+                data: number;
+                driverParam: number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
             recordedAt: drizzle_orm_sqlite_core.SQLiteColumn<{
                 name: "recorded_at";
                 tableName: string;
@@ -2730,41 +2739,37 @@ declare const tables: {
             recordedFrom: drizzle_orm_sqlite_core.SQLiteColumn<{
                 name: "recorded_from";
                 tableName: string;
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
+                dataType: "number";
+                columnType: "SQLiteInteger";
+                data: number;
+                driverParam: number;
                 notNull: true;
                 hasDefault: false;
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: undefined;
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
+            }, {}, {}>;
             recordedTo: drizzle_orm_sqlite_core.SQLiteColumn<{
                 name: "recorded_to";
                 tableName: string;
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
+                dataType: "number";
+                columnType: "SQLiteInteger";
+                data: number;
+                driverParam: number;
                 notNull: true;
                 hasDefault: false;
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: undefined;
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
+            }, {}, {}>;
             op: drizzle_orm_sqlite_core.SQLiteColumn<{
                 name: "op";
                 tableName: string;
@@ -3115,41 +3120,37 @@ declare const tables: {
             recordedFrom: drizzle_orm_sqlite_core.SQLiteColumn<{
                 name: "recorded_from";
                 tableName: string;
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
+                dataType: "number";
+                columnType: "SQLiteInteger";
+                data: number;
+                driverParam: number;
                 notNull: true;
                 hasDefault: false;
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: undefined;
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
+            }, {}, {}>;
             recordedTo: drizzle_orm_sqlite_core.SQLiteColumn<{
                 name: "recorded_to";
                 tableName: string;
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
+                dataType: "number";
+                columnType: "SQLiteInteger";
+                data: number;
+                driverParam: number;
                 notNull: true;
                 hasDefault: false;
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: undefined;
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
+            }, {}, {}>;
             op: drizzle_orm_sqlite_core.SQLiteColumn<{
                 name: "op";
                 tableName: string;
@@ -3250,6 +3251,23 @@ declare const tables: {
             }, {}, {
                 length: number | undefined;
             }>;
+            revision: drizzle_orm_sqlite_core.SQLiteColumn<{
+                name: "revision";
+                tableName: string;
+                dataType: "number";
+                columnType: "SQLiteInteger";
+                data: number;
+                driverParam: number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
             recordedAt: drizzle_orm_sqlite_core.SQLiteColumn<{
                 name: "recorded_at";
                 tableName: string;
@@ -4763,41 +4781,37 @@ declare const recordedNodes: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
         recordedFrom: drizzle_orm_sqlite_core.SQLiteColumn<{
             name: "recorded_from";
             tableName: string;
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
             notNull: true;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
+        }, {}, {}>;
         recordedTo: drizzle_orm_sqlite_core.SQLiteColumn<{
             name: "recorded_to";
             tableName: string;
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
             notNull: true;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
+        }, {}, {}>;
         op: drizzle_orm_sqlite_core.SQLiteColumn<{
             name: "op";
             tableName: string;
@@ -5148,41 +5162,37 @@ declare const recordedEdges: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
         recordedFrom: drizzle_orm_sqlite_core.SQLiteColumn<{
             name: "recorded_from";
             tableName: string;
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
             notNull: true;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
+        }, {}, {}>;
         recordedTo: drizzle_orm_sqlite_core.SQLiteColumn<{
             name: "recorded_to";
             tableName: string;
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
             notNull: true;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
+        }, {}, {}>;
         op: drizzle_orm_sqlite_core.SQLiteColumn<{
             name: "op";
             tableName: string;
@@ -5283,6 +5293,23 @@ declare const recordedClock: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
         }, {}, {
             length: number | undefined;
         }>;
+        revision: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "revision";
+            tableName: string;
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         recordedAt: drizzle_orm_sqlite_core.SQLiteColumn<{
             name: "recorded_at";
             tableName: string;

package/dist/{store-view-BJd6Vwpt.d.cts → store-view-C-buB8Q8.d.cts}

@@ -1,9 +1,10 @@
-import { G as GraphDef, E as EdgeKinds, N as NodeKinds, a as AllNodeTypes } from './define-graph-CzEvA_8F.cjs';
-import { S as SearchableMetadata, R as RecordedInstant, c as EmbeddingValue, l as ReadCoordinate } from './temporal-BC_NQV5Y.cjs';
+import { G as GraphDef, E as EdgeKinds, N as NodeKinds, a as AllNodeTypes } from './define-graph-Cv3CFwKm.cjs';
+import { R as RecordedInstant, d as ReadCoordinate } from './temporal-Dn_JADWY.cjs';
 import { a as NodeType, A as AnyEdgeType, d as EdgeType, T as TemporalMode, E as EdgeRegistration, m as NodeId, K as KindEntity, g as EdgeId, N as NodeRegistration, l as KindAnnotations, o as UniquenessScope, f as Collation, e as Cardinality, j as EndpointExistence, G as GraphExtension } from './extension-types-BLEVH4SG.cjs';
-import { K as KindRegistry, S as SchemaManagerOptions, d as SchemaValidationResult } from './manager-nCEJiYBb.cjs';
+import { K as KindRegistry, S as SchemaManagerOptions, d as SchemaValidationResult } from './manager-mqee5MVB.cjs';
 import { z } from 'zod';
-import { bp as ValueType, bq as PredicateExpression, ad as FulltextQueryMode, br as VectorMetricType, Q as QueryAst, J as JsonPointer, K as FieldRef, ay as ParameterRef, b1 as TraversalExpansion, G as GraphBackend, S as SqlDialect, aU as SqlSchema, bs as Traversal, bt as NodePredicate, bu as ProjectedField, ax as OrderSpec, bv as AggregateOrderSpec, bw as GroupBySpec, ak as HybridFusionOptions, ao as JsonPointerInput, bx as RecursiveCyclePolicy, T as TraversalDirection$1, a_ as TransactionBackend, a7 as ExternalRecordedReadSource, by as NodeRow, bz as EdgeRow, b0 as TransactionReadBackend, H as AggregateExpr, aN as SortDirection, a0 as CompiledSelectSql, F as FulltextStrategy, V as VectorStrategy, bA as VectorSlotMap, bB as RecordedReadBinding, bC as SelectiveField, bD as ComposableQuery, bE as SetOperationType, bF as SetOperation, bG as VectorMetric, x as JsonSchema, B as BackendCapabilities, a$ as TransactionOptions, A as AdapterBackend } from './index-CrFL_ENI.cjs';
+import { bp as ValueType, bq as PredicateExpression, ad as FulltextQueryMode, br as VectorMetricType, Q as QueryAst, J as JsonPointer, K as FieldRef, ay as ParameterRef, b1 as TraversalExpansion, G as GraphBackend, S as SqlDialect, aU as SqlSchema, bs as Traversal, bt as NodePredicate, bu as ProjectedField, ax as OrderSpec, bv as AggregateOrderSpec, bw as GroupBySpec, ak as HybridFusionOptions, ao as JsonPointerInput, bx as RecursiveCyclePolicy, T as TraversalDirection$1, a_ as TransactionBackend, a7 as ExternalRecordedReadSource, by as NodeRow, bz as EdgeRow, b0 as TransactionReadBackend, H as AggregateExpr, aN as SortDirection, a0 as CompiledSelectSql, F as FulltextStrategy, V as VectorStrategy, bA as VectorSlotMap, bB as RecordedReadBinding, bC as SelectiveField, bD as ComposableQuery, bE as SetOperationType, bF as SetOperation, bG as VectorMetric, x as JsonSchema, B as BackendCapabilities, a$ as TransactionOptions, A as AdapterBackend } from './types-C5pZeKTl.cjs';
+import { S as SearchableMetadata, c as EmbeddingValue } from './searchable-BxlJQVFw.cjs';
 import { b as MaterializeIndexesOptions, M as MaterializeIndexesResult, c as MaterializeSystemIndexesOptions } from './materialize-indexes-ExQ6OrAh.cjs';
 
 type FieldTypeInfo = Readonly<{
@@ -2123,14 +2124,6 @@ declare class ExecutableAggregateQuery<G extends GraphDef, Aliases extends Alias
     execute(): Promise<readonly AggregateResult<R>[]>;
 }
 
-/**
- * Temporal Filter Compilation
- *
- * Generates SQL clauses for temporal filtering based on valid_from/valid_to
- * and deleted_at timestamps. Consolidates the previously duplicated temporal
- * filter functions into a single, parameterized implementation.
- */
-
 /**
  * How a "current" valid-time read instant is emitted into compiled SQL:
  *
@@ -4402,8 +4395,8 @@ declare class StoreView<G extends GraphDef> extends CoordinatePinnedView<G> {
 declare class RecordedStoreView<G extends GraphDef> extends CoordinatePinnedView<G> {
     #private;
     constructor(store: Store<G>, coordinate: ReadCoordinate);
-    /** The recorded/system-time timestamp this view reconstructs. */
-    get asOfRecorded(): string;
+    /** The recorded/system-time anchor this view reconstructs. */
+    get asOfRecorded(): RecordedInstant;
     /** Recorded-time node reconstructing-read collections. */
     get nodes(): RecordedStoreViewNodeCollections<G>;
     /** Recorded-time edge reconstructing-read collections. */

package/dist/{store-view-CLIhwMMX.d.ts → store-view-CagdeyNn.d.ts}

@@ -1,9 +1,10 @@
-import { G as GraphDef, E as EdgeKinds, N as NodeKinds, a as AllNodeTypes } from './define-graph-DRo9xpYN.js';
-import { S as SearchableMetadata, R as RecordedInstant, c as EmbeddingValue, l as ReadCoordinate } from './temporal-DqtOEo_B.js';
+import { G as GraphDef, E as EdgeKinds, N as NodeKinds, a as AllNodeTypes } from './define-graph-DQnj3fNH.js';
+import { R as RecordedInstant, d as ReadCoordinate } from './temporal-CyFsSPe8.js';
 import { a as NodeType, A as AnyEdgeType, d as EdgeType, T as TemporalMode, E as EdgeRegistration, m as NodeId, K as KindEntity, g as EdgeId, N as NodeRegistration, l as KindAnnotations, o as UniquenessScope, f as Collation, e as Cardinality, j as EndpointExistence, G as GraphExtension } from './extension-types-BLEVH4SG.js';
-import { K as KindRegistry, S as SchemaManagerOptions, d as SchemaValidationResult } from './manager-CASfhmzV.js';
+import { K as KindRegistry, S as SchemaManagerOptions, d as SchemaValidationResult } from './manager-DjE6Mhag.js';
 import { z } from 'zod';
-import { bp as ValueType, bq as PredicateExpression, ad as FulltextQueryMode, br as VectorMetricType, Q as QueryAst, J as JsonPointer, K as FieldRef, ay as ParameterRef, b1 as TraversalExpansion, G as GraphBackend, S as SqlDialect, aU as SqlSchema, bs as Traversal, bt as NodePredicate, bu as ProjectedField, ax as OrderSpec, bv as AggregateOrderSpec, bw as GroupBySpec, ak as HybridFusionOptions, ao as JsonPointerInput, bx as RecursiveCyclePolicy, T as TraversalDirection$1, a_ as TransactionBackend, a7 as ExternalRecordedReadSource, by as NodeRow, bz as EdgeRow, b0 as TransactionReadBackend, H as AggregateExpr, aN as SortDirection, a0 as CompiledSelectSql, F as FulltextStrategy, V as VectorStrategy, bA as VectorSlotMap, bB as RecordedReadBinding, bC as SelectiveField, bD as ComposableQuery, bE as SetOperationType, bF as SetOperation, bG as VectorMetric, x as JsonSchema, B as BackendCapabilities, a$ as TransactionOptions, A as AdapterBackend } from './index-Bq7vSPHy.js';
+import { bp as ValueType, bq as PredicateExpression, ad as FulltextQueryMode, br as VectorMetricType, Q as QueryAst, J as JsonPointer, K as FieldRef, ay as ParameterRef, b1 as TraversalExpansion, G as GraphBackend, S as SqlDialect, aU as SqlSchema, bs as Traversal, bt as NodePredicate, bu as ProjectedField, ax as OrderSpec, bv as AggregateOrderSpec, bw as GroupBySpec, ak as HybridFusionOptions, ao as JsonPointerInput, bx as RecursiveCyclePolicy, T as TraversalDirection$1, a_ as TransactionBackend, a7 as ExternalRecordedReadSource, by as NodeRow, bz as EdgeRow, b0 as TransactionReadBackend, H as AggregateExpr, aN as SortDirection, a0 as CompiledSelectSql, F as FulltextStrategy, V as VectorStrategy, bA as VectorSlotMap, bB as RecordedReadBinding, bC as SelectiveField, bD as ComposableQuery, bE as SetOperationType, bF as SetOperation, bG as VectorMetric, x as JsonSchema, B as BackendCapabilities, a$ as TransactionOptions, A as AdapterBackend } from './types-D8szWDUo.js';
+import { S as SearchableMetadata, c as EmbeddingValue } from './searchable-ChJ29MCd.js';
 import { b as MaterializeIndexesOptions, M as MaterializeIndexesResult, c as MaterializeSystemIndexesOptions } from './materialize-indexes-D4iei4Kp.js';
 
 type FieldTypeInfo = Readonly<{
@@ -2123,14 +2124,6 @@ declare class ExecutableAggregateQuery<G extends GraphDef, Aliases extends Alias
     execute(): Promise<readonly AggregateResult<R>[]>;
 }
 
-/**
- * Temporal Filter Compilation
- *
- * Generates SQL clauses for temporal filtering based on valid_from/valid_to
- * and deleted_at timestamps. Consolidates the previously duplicated temporal
- * filter functions into a single, parameterized implementation.
- */
-
 /**
  * How a "current" valid-time read instant is emitted into compiled SQL:
  *
@@ -4402,8 +4395,8 @@ declare class StoreView<G extends GraphDef> extends CoordinatePinnedView<G> {
 declare class RecordedStoreView<G extends GraphDef> extends CoordinatePinnedView<G> {
     #private;
     constructor(store: Store<G>, coordinate: ReadCoordinate);
-    /** The recorded/system-time timestamp this view reconstructs. */
-    get asOfRecorded(): string;
+    /** The recorded/system-time anchor this view reconstructs. */
+    get asOfRecorded(): RecordedInstant;
     /** Recorded-time node reconstructing-read collections. */
     get nodes(): RecordedStoreViewNodeCollections<G>;
     /** Recorded-time edge reconstructing-read collections. */

package/dist/temporal-CyFsSPe8.d.ts

@@ -0,0 +1,73 @@
+import { T as TemporalMode } from './extension-types-BLEVH4SG.js';
+
+declare const RECORDED_INSTANT_BRAND: unique symbol;
+/**
+ * A versioned recorded-time anchor containing a fixed-width logical revision
+ * and a canonical UTC physical timestamp:
+ * `r1:0000000000000001:YYYY-MM-DDTHH:mm:ss.sssZ`.
+ *
+ * Logical revisions are strictly monotonic per graph and make every commit
+ * addressable even when many commits share one wall-clock millisecond. The
+ * timestamp is a non-decreasing physical wall-time high-water mark used by
+ * diagonal valid-time reads. Same-millisecond commits repeat it; backward clock
+ * corrections hold it at the previous value until wall time catches up. The
+ * string is canonical and lexicographically ordered by revision, so it can
+ * round-trip through plain string checkpoint columns without a custom
+ * serializer.
+ */
+type RecordedInstant = string & {
+    readonly [RECORDED_INSTANT_BRAND]: "RecordedInstant";
+};
+/**
+ * Returns the canonical UTC wall-time component of a recorded anchor.
+ *
+ * The value is non-decreasing per graph, but it is not the commit-order key;
+ * use the complete {@link RecordedInstant} when ordering or replaying commits.
+ */
+declare function recordedInstantWallTime(instant: RecordedInstant): string;
+/** Returns the strict per-graph logical revision carried by an anchor. */
+declare function recordedInstantRevision(instant: RecordedInstant): number;
+/**
+ * Compares two recorded anchors by logical revision.
+ *
+ * Revisions are local to a graph, so only compare anchors produced by the same
+ * graph. The physical wall-time component deliberately does not participate.
+ */
+declare function compareRecordedInstants(left: RecordedInstant, right: RecordedInstant): -1 | 0 | 1;
+/**
+ * Brands a canonical versioned anchor string as a {@link RecordedInstant}.
+ *
+ * The escape hatch for an instant that round-trips through untyped storage:
+ * captured from {@link Store.recordedNow}, persisted as a plain string, read
+ * back, and replayed into `asOfRecorded`. Validates the canonical form eagerly —
+ * the same check `asOfRecorded` applies — so a malformed value fails here, at the
+ * brand site, rather than deeper in a read. Does *not* assert the instant is a
+ * real captured commit; it only guarantees the value is well-formed enough to
+ * compare correctly against the recorded relations.
+ *
+ * @throws {ValidationError} when `value` is not a canonical versioned anchor.
+ */
+declare function asRecordedInstant(value: string): RecordedInstant;
+/**
+ * The single opaque temporal coordinate every pinned read is resolved
+ * against. It carries the valid-time axis plus an optional recorded/system-time
+ * axis, so every surface can inject one coordinate object instead of threading
+ * each temporal dimension separately.
+ */
+type ReadCoordinate = Readonly<{
+    /**
+     * The valid-time axis: a resolved temporal mode and (only for `"asOf"`) the
+     * instant it is pinned to.
+     */
+    valid: Readonly<{
+        mode: TemporalMode;
+        /** Defined only when `mode` is `"asOf"`. */
+        asOf?: string;
+    }>;
+    /** The recorded/system-time axis. Defined only for recorded-pinned views. */
+    recorded?: Readonly<{
+        asOf: RecordedInstant;
+    }>;
+}>;
+
+export { type RecordedInstant as R, asRecordedInstant as a, recordedInstantWallTime as b, compareRecordedInstants as c, type ReadCoordinate as d, recordedInstantRevision as r };

package/dist/temporal-Dn_JADWY.d.cts

@@ -0,0 +1,73 @@
+import { T as TemporalMode } from './extension-types-BLEVH4SG.cjs';
+
+declare const RECORDED_INSTANT_BRAND: unique symbol;
+/**
+ * A versioned recorded-time anchor containing a fixed-width logical revision
+ * and a canonical UTC physical timestamp:
+ * `r1:0000000000000001:YYYY-MM-DDTHH:mm:ss.sssZ`.
+ *
+ * Logical revisions are strictly monotonic per graph and make every commit
+ * addressable even when many commits share one wall-clock millisecond. The
+ * timestamp is a non-decreasing physical wall-time high-water mark used by
+ * diagonal valid-time reads. Same-millisecond commits repeat it; backward clock
+ * corrections hold it at the previous value until wall time catches up. The
+ * string is canonical and lexicographically ordered by revision, so it can
+ * round-trip through plain string checkpoint columns without a custom
+ * serializer.
+ */
+type RecordedInstant = string & {
+    readonly [RECORDED_INSTANT_BRAND]: "RecordedInstant";
+};
+/**
+ * Returns the canonical UTC wall-time component of a recorded anchor.
+ *
+ * The value is non-decreasing per graph, but it is not the commit-order key;
+ * use the complete {@link RecordedInstant} when ordering or replaying commits.
+ */
+declare function recordedInstantWallTime(instant: RecordedInstant): string;
+/** Returns the strict per-graph logical revision carried by an anchor. */
+declare function recordedInstantRevision(instant: RecordedInstant): number;
+/**
+ * Compares two recorded anchors by logical revision.
+ *
+ * Revisions are local to a graph, so only compare anchors produced by the same
+ * graph. The physical wall-time component deliberately does not participate.
+ */
+declare function compareRecordedInstants(left: RecordedInstant, right: RecordedInstant): -1 | 0 | 1;
+/**
+ * Brands a canonical versioned anchor string as a {@link RecordedInstant}.
+ *
+ * The escape hatch for an instant that round-trips through untyped storage:
+ * captured from {@link Store.recordedNow}, persisted as a plain string, read
+ * back, and replayed into `asOfRecorded`. Validates the canonical form eagerly —
+ * the same check `asOfRecorded` applies — so a malformed value fails here, at the
+ * brand site, rather than deeper in a read. Does *not* assert the instant is a
+ * real captured commit; it only guarantees the value is well-formed enough to
+ * compare correctly against the recorded relations.
+ *
+ * @throws {ValidationError} when `value` is not a canonical versioned anchor.
+ */
+declare function asRecordedInstant(value: string): RecordedInstant;
+/**
+ * The single opaque temporal coordinate every pinned read is resolved
+ * against. It carries the valid-time axis plus an optional recorded/system-time
+ * axis, so every surface can inject one coordinate object instead of threading
+ * each temporal dimension separately.
+ */
+type ReadCoordinate = Readonly<{
+    /**
+     * The valid-time axis: a resolved temporal mode and (only for `"asOf"`) the
+     * instant it is pinned to.
+     */
+    valid: Readonly<{
+        mode: TemporalMode;
+        /** Defined only when `mode` is `"asOf"`. */
+        asOf?: string;
+    }>;
+    /** The recorded/system-time axis. Defined only for recorded-pinned views. */
+    recorded?: Readonly<{
+        asOf: RecordedInstant;
+    }>;
+}>;
+
+export { type RecordedInstant as R, asRecordedInstant as a, recordedInstantWallTime as b, compareRecordedInstants as c, type ReadCoordinate as d, recordedInstantRevision as r };

package/dist/{types-CUevi_D1.d.ts → types-CYdXzZef.d.ts}

@@ -1,5 +1,5 @@
 import { K as KindEntity } from './extension-types-BLEVH4SG.js';
-import { J as JsonPointer } from './index-Bq7vSPHy.js';
+import { J as JsonPointer } from './types-D8szWDUo.js';
 
 /**
  * QueryProfiler types.

package/dist/{types-COq3-vMC.d.cts → types-CqSfMRW3.d.cts}

@@ -1,5 +1,5 @@
 import { K as KindEntity } from './extension-types-BLEVH4SG.cjs';
-import { J as JsonPointer } from './index-CrFL_ENI.cjs';
+import { J as JsonPointer } from './types-C5pZeKTl.cjs';
 
 /**
  * QueryProfiler types.

package/dist/{where-C92TXCzT.d.cts → where-C3-HRgUq.d.cts}

@@ -1,5 +1,5 @@
 import { A as AnyEdgeType, a as NodeType } from './extension-types-BLEVH4SG.cjs';
-import { a as EdgeIndexConfig, E as EdgeIndexDeclaration, i as NodeIndexConfig, N as NodeIndexDeclaration, f as IndexWhereExpression } from './index-CrFL_ENI.cjs';
+import { a as EdgeIndexConfig, E as EdgeIndexDeclaration, i as NodeIndexConfig, N as NodeIndexDeclaration, f as IndexWhereExpression } from './types-C5pZeKTl.cjs';
 
 /** The TypeGraph relations that carry system indexes. */
 type SystemIndexTable = "nodes" | "edges" | "recordedNodes" | "recordedEdges";