@sixb/core 0.1.16 → 0.1.17

package/dist/{chunk-kttr5ftm.js → chunk-gf7yht60.js}

@@ -10,7 +10,7 @@ import {
 import {
   isActionDefinition2,
   isGroupDefinition
-} from "./chunk-2xvgy3x5.js";
+} from "./chunk-svabwqdq.js";
 import {
   isModelReasoning2
 } from "./chunk-pqajwytd.js";
@@ -19,14 +19,14 @@ import {
 } from "./chunk-69266efg.js";
 import {
   isAgentToolDefinition2
-} from "./chunk-f72rbvsb.js";
+} from "./chunk-cnb5kv05.js";
 import {
   WorkflowDefinitionError2,
   assertNonEmpty,
   isStepDefinition2,
   isAgentStepDefinition2,
   isInterventionDefinition2
-} from "./chunk-3q7z9hd4.js";
+} from "./chunk-6wbm6ymz.js";
 import {
   isScheduleDefinition2
 } from "./chunk-e1c18xjx.js";

package/dist/chunk-h8teetr0.js

@@ -0,0 +1,9 @@
+// @bun
+// src/blob-storage/errors.ts
+class BlobStorageError2 extends Error {
+  name = "BlobStorageError";
+}
+
+export { BlobStorageError2 };
+
+//# debugId=A71607D07E6D8E0364756E2164756E21

package/dist/chunk-h8teetr0.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/blob-storage/errors.ts"],
+  "sourcesContent": [
+    "/**\n * Error for blob storage invariants and provider-level failures.\n */\nexport class BlobStorageError extends Error {\n  readonly name = \"BlobStorageError\"\n}\n"
+  ],
+  "mappings": ";;AAGO,MAAM,0BAAyB,MAAM;AAAA,EACjC,OAAO;AAClB;",
+  "debugId": "A71607D07E6D8E0364756E2164756E21",
+  "names": []
+}

package/dist/chunk-hn2r7z41.js.map

@@ -3,7 +3,7 @@
   "sources": ["../src/projections/types.ts", "../src/storage/projection-runs/types.ts"],
   "sourcesContent": [
     "import type { SixbErrorCode } from \"../errors/types\"\n\n/** Error codes a projection run can persist and expose through its public contract. */\nexport const PROJECTION_RUN_FAILURE_CODES = [\n  \"internal.unexpected\",\n  \"runtime.cancelled\",\n  \"queue.enqueue_failed\",\n  \"projection.execution_failed\",\n  \"storage.unavailable\",\n] as const satisfies readonly [SixbErrorCode, ...SixbErrorCode[]]\n\nexport type ProjectionRunFailureCode = (typeof PROJECTION_RUN_FAILURE_CODES)[number]\n\n/**\n * Lowered, serializable definition interfaces for projection DSL.\n *\n * These are the runtime-inspectable data structures that projection builders\n * lower into. They use plain string ids (no tokens, no methods) so they can\n * be stored, serialized, and introspected by tooling.\n */\n\n/**\n * Describes how a foreign key column in a dataset resolves to a link target.\n *\n * The source can be either a projected source property or a raw dataset field.\n * Its value equals the target object's primary property value, creating an\n * implicit link between source and target.\n *\n * `targetObjectTypeId` declares the concrete target type for this projection.\n * It must be the same type or a subtype (via `extends`) of the link's declared\n * target at the ontology level. Validation of the subtype relationship happens\n * at Sixb startup (Increment 7), not at DSL build time.\n */\nexport interface ForeignKeyDescriptor {\n  readonly linkId: string\n  /** Object property holding the target id. Mutually exclusive with sourceField. */\n  readonly sourcePropertyId?: string\n  /** Dataset column holding the target id. Mutually exclusive with sourcePropertyId. */\n  readonly sourceField?: string\n  readonly targetObjectTypeId: string\n}\n\n/** Resolves competing source-projection and managed-edit values for projected properties. */\nexport type SourceEditConflictResolution =\n  | { readonly strategy: \"editsWin\" }\n  | { readonly strategy: \"mostRecent\"; readonly sourceTimestamp: string }\n\n/**\n * Lowered, serializable definition for projecting a dataset into object instances.\n *\n * Each row contributes one complete object root to an authoritative replacement snapshot, with\n * properties mapped from dataset columns to object type properties. Duplicate roots are rejected.\n * FK links are resolved from source property or dataset field values to target object primary\n * values.\n */\nexport interface ObjectProjectionDefinition {\n  readonly _tag: \"ObjectProjectionDefinition\"\n  readonly id: string\n  readonly objectTypeId: string\n  readonly datasetId: string\n  /** Maps object type property id -> dataset column name. */\n  readonly properties: Readonly<Record<string, string>>\n  /** Maps link id -> FK descriptor. Empty `{}` when no FK links are projected. */\n  readonly links: Readonly<Record<string, ForeignKeyDescriptor>>\n  /** Defaults to `editsWin` when omitted by a legacy lowered definition. */\n  readonly conflictResolution?: SourceEditConflictResolution\n}\n\n/**\n * Lowered, serializable definition for projecting a join dataset into link instances.\n *\n * Each row in the join dataset contributes one complete link root to an authoritative replacement\n * snapshot, identified by its source, link id, and target. Duplicate roots are rejected.\n */\nexport interface LinkProjectionDefinition {\n  readonly _tag: \"LinkProjectionDefinition\"\n  readonly id: string\n  readonly linkId: string\n  readonly sourceObjectTypeId: string\n  readonly targetObjectTypeId: string\n  readonly datasetId: string\n  /** Dataset column holding the source object's primary property value. */\n  readonly sourceField: string\n  /** Dataset column holding the target object's primary property value. */\n  readonly targetField: string\n}\n\n/** Dataset columns that produce one telemetry property value. */\nexport interface TelemetryProjectionPropertyMapping {\n  /** Dataset column holding the telemetry value. */\n  readonly valueField: string\n  /** Dataset column holding the telemetry unit, when the property requires one. */\n  readonly unitField?: string\n}\n\n/**\n * Lowered, serializable definition for projecting dataset rows into telemetry history.\n *\n * Each row shares one target object id and observation timestamp, then contributes up to one\n * telemetry point for every mapped property. A property-token projection is lowered to the same\n * shape with one entry, so execution and ownership have one canonical contract.\n */\nexport interface TelemetryProjectionDefinition {\n  readonly _tag: \"TelemetryProjectionDefinition\"\n  readonly id: string\n  readonly objectTypeId: string\n  readonly datasetId: string\n  /** Dataset column holding the target object's primary id. */\n  readonly objectIdField: string\n  /** Dataset column holding the telemetry observation timestamp. */\n  readonly atField: string\n  /** Maps telemetry property id -> value and optional unit dataset columns. */\n  readonly properties: Readonly<Record<string, TelemetryProjectionPropertyMapping>>\n}\n\n/** Union of all projection definition types. */\nexport type ProjectionDefinition =\n  | ObjectProjectionDefinition\n  | LinkProjectionDefinition\n  | TelemetryProjectionDefinition\n\nexport interface ProjectionOwnership {\n  readonly objects: readonly {\n    readonly objectTypeId: string\n    readonly existence: boolean\n    readonly propertyIds: readonly string[]\n  }[]\n  readonly links: readonly {\n    readonly sourceObjectTypeId: string\n    readonly linkId: string\n  }[]\n  readonly telemetry: readonly {\n    readonly objectTypeId: string\n    readonly propertyId: string\n  }[]\n}\n\n/** Canonical correlation between a projection kind and its materialization protocol. */\nexport type ProjectionProtocolIdentity =\n  | { readonly projectionKind: \"object\"; readonly protocol: \"replacement\" }\n  | { readonly projectionKind: \"link\"; readonly protocol: \"replacement\" }\n  | { readonly projectionKind: \"telemetry\"; readonly protocol: \"telemetry\" }\n\nexport type ProjectionKind = ProjectionProtocolIdentity[\"projectionKind\"]\n\nexport interface ObjectProjectionTarget {\n  readonly objectTypeId: string\n}\n\nexport interface LinkProjectionTarget {\n  readonly sourceObjectTypeId: string\n  readonly targetObjectTypeId: string\n}\n\nexport interface ProjectionTargetByKind {\n  readonly object: ObjectProjectionTarget\n  readonly link: LinkProjectionTarget\n  readonly telemetry: ObjectProjectionTarget\n}\n\n/** Object types affected by one projection, correlated with its projection kind. */\nexport type ProjectionTarget<TKind extends ProjectionKind = ProjectionKind> =\n  ProjectionTargetByKind[TKind]\n\n/**\n * Frozen semantic identity used to dispatch one registered projection.\n *\n * Dataset version metadata is attached only when a committed dataset event is routed. Keeping the\n * registry-owned fields together prevents the orchestrator from recomputing ontology semantics.\n */\nexport type ProjectionDispatchDescriptor = ProjectionDispatchDescriptorBase &\n  ProjectionProtocolIdentity\n\ninterface ProjectionDispatchDescriptorBase {\n  readonly projectionId: string\n  readonly datasetId: string\n  readonly ontologyRevision: string\n  readonly projectionRevision: string\n  readonly ownershipHash: string\n}\n\nexport interface ResolvedProjection<TDefinition extends ProjectionDefinition> {\n  readonly projectionId: string\n  readonly datasetId: string\n  readonly projectionRevision: string\n  readonly ownershipHash: string\n  readonly ownership: ProjectionOwnership\n  readonly definition: TDefinition\n}\n",
-    "import type { SixbFailure } from \"../../errors/types\"\nimport type {\n  PinnedDatasetVersion,\n  ProjectionExecution,\n  ProjectionMaterializationIdentity,\n  ProjectionRunTerminalDecision,\n} from \"../../materialization/model\"\nimport type {\n  LinkProjectionTarget,\n  ObjectProjectionTarget,\n  ProjectionKind,\n  ProjectionRunFailureCode,\n  ProjectionTarget,\n} from \"../../projections/types\"\n\nexport type { ProjectionRunFailureCode } from \"../../projections/types\"\nexport { PROJECTION_RUN_FAILURE_CODES } from \"../../projections/types\"\n\n/**\n * `superseded` ends a replacement run whose output would be stale on arrival: a run of the same\n * projection pinned to a later dataset version exists and has not failed. Telemetry runs append\n * readings rather than replace a source, so none is ever superseded.\n */\nexport type ProjectionRunStatus =\n  | \"queued\"\n  | \"running\"\n  | \"succeeded\"\n  | \"failed\"\n  | \"cancelled\"\n  | \"superseded\"\n\nexport interface ProjectionRunProgress {\n  /** Physical immutable-version rows consumed, before normalization or semantic materialization. */\n  readonly sourceRowsRead: number\n  /** Physical rows intentionally skipped because a required mapped value was blank. */\n  readonly sourceRowsSkipped: number\n  /** Maximum complete change records consumed by one incremental attempt; not a recovery cursor. */\n  readonly sourceChangesRead?: number\n}\n\nconst progressKeyFlags: Record<keyof ProjectionRunProgress, true> = {\n  sourceRowsRead: true,\n  sourceRowsSkipped: true,\n  sourceChangesRead: true,\n}\n\nexport const PROJECTION_RUN_PROGRESS_KEYS = Object.keys(\n  progressKeyFlags\n) as readonly (keyof ProjectionRunProgress)[]\n\nexport function zeroProjectionRunProgress(): ProjectionRunProgress {\n  return { sourceRowsRead: 0, sourceRowsSkipped: 0 }\n}\n\nexport interface ProjectionTelemetryCheckpoint {\n  readonly fixedBatchSize: number\n  readonly nextBatchOrdinal: number\n  readonly nextRowOffset: number\n  readonly inputExhausted: boolean\n}\n\n/**\n * The object a telemetry batch is waiting for, and when this run first found it missing.\n *\n * A projection's dataset can legitimately be materialized before the objects it references, so\n * the run waits instead of failing. The wait needs a start, and the run has no other durable one:\n * `startedAt` is when the run began, which on a batched projection is long before the batch that\n * cannot commit, and `attempt` counts every reclaim including the ones an unreachable queue caused.\n *\n * Cleared by any committed batch, so a run that is making progress never carries a stale wait.\n */\nexport interface ProjectionMissingTarget {\n  readonly objectTypeId: string\n  readonly objectId: string\n  /** The batch that could not commit because of it. */\n  readonly batchOrdinal: number\n  readonly firstSeenAt: Date\n}\n\ninterface ProjectionRunRecordBase {\n  readonly id: string\n  readonly projectId: string\n  readonly executionId: string\n  readonly status: ProjectionRunStatus\n  readonly attempt: number\n  readonly progress: ProjectionRunProgress\n  readonly queuedAt: Date\n  readonly startedAt?: Date\n  readonly finishedAt?: Date\n  /**\n   * The run's most recent failure, read with its status: on a `running` run, why its last attempt\n   * failed while the queue retries it; on a `failed` or `cancelled` run, why it ended. Cleared when\n   * the run succeeds or is superseded, so a present error always describes something current.\n   */\n  readonly error?: SixbFailure<ProjectionRunFailureCode>\n}\n\ntype ProjectionIdentity<TKind extends ProjectionKind> = Extract<\n  ProjectionMaterializationIdentity,\n  { readonly projectionKind: TKind }\n>\n\nexport type ObjectProjectionRunRecord = ProjectionRunRecordBase & {\n  readonly identity: ProjectionIdentity<\"object\">\n  readonly target: ObjectProjectionTarget\n  readonly telemetryCheckpoint?: never\n  readonly missingTarget?: never\n}\n\nexport type LinkProjectionRunRecord = ProjectionRunRecordBase & {\n  readonly identity: ProjectionIdentity<\"link\">\n  readonly target: LinkProjectionTarget\n  readonly telemetryCheckpoint?: never\n  readonly missingTarget?: never\n}\n\nexport type TelemetryProjectionRunRecord = ProjectionRunRecordBase & {\n  readonly identity: ProjectionIdentity<\"telemetry\">\n  readonly target: ObjectProjectionTarget\n  readonly telemetryCheckpoint: ProjectionTelemetryCheckpoint\n  /**\n   * Only telemetry carries this: `MaterializationObjectNotFoundError` is raised by telemetry\n   * validation alone, and only a batched protocol has a checkpoint to anchor the wait to.\n   */\n  readonly missingTarget?: ProjectionMissingTarget\n}\n\n/** Durable projection lifecycle state. The execution token is deliberately returned separately. */\nexport type ProjectionRunRecord =\n  | ObjectProjectionRunRecord\n  | LinkProjectionRunRecord\n  | TelemetryProjectionRunRecord\n\nexport function projectionRunObjectTypesVisible(\n  run: ProjectionRunRecord,\n  canView: (objectTypeId: string) => boolean\n): boolean {\n  const target: ProjectionTarget = run.target\n  if (\"sourceObjectTypeId\" in target) {\n    return canView(target.sourceObjectTypeId) && canView(target.targetObjectTypeId)\n  }\n  return canView(target.objectTypeId)\n}\n\ninterface ProjectionRunAdmissionBase {\n  readonly id: string\n  readonly projectId: string\n  readonly executionId: string\n  readonly queuedAt?: Date\n}\n\nexport type QueueProjectionRunInput =\n  | (ProjectionRunAdmissionBase & {\n      readonly identity: ProjectionIdentity<\"object\">\n      readonly target: ObjectProjectionRunRecord[\"target\"]\n      readonly fixedBatchSize?: never\n    })\n  | (ProjectionRunAdmissionBase & {\n      readonly identity: ProjectionIdentity<\"link\">\n      readonly target: LinkProjectionRunRecord[\"target\"]\n      readonly fixedBatchSize?: never\n    })\n  | (ProjectionRunAdmissionBase & {\n      readonly identity: ProjectionIdentity<\"telemetry\">\n      readonly target: TelemetryProjectionRunRecord[\"target\"]\n      readonly fixedBatchSize: number\n    })\n\nexport type StartOrReclaimProjectionRunInput = QueueProjectionRunInput extends infer TInput\n  ? TInput extends QueueProjectionRunInput\n    ? Omit<TInput, \"executionId\" | \"queuedAt\"> & { readonly startedAt?: Date }\n    : never\n  : never\n\nexport interface FailProjectionRunEnqueueInput {\n  readonly id: string\n  readonly projectId: string\n  readonly finishedAt?: Date\n  readonly error: SixbFailure<ProjectionRunFailureCode>\n}\n\nexport interface ProjectionRunClaim {\n  readonly run: ProjectionRunRecord\n  readonly execution: ProjectionExecution\n}\n\nexport interface LockProjectionRunForMaterializationInput {\n  readonly id: string\n  readonly projectId: string\n  readonly executionToken: string\n  readonly identity: ProjectionMaterializationIdentity\n}\n\nexport interface UpdateProjectionRunInput extends LockProjectionRunForMaterializationInput {\n  readonly progress: Partial<ProjectionRunProgress>\n}\n\nexport type FinishProjectionRunInput = ProjectionRunTerminalDecision &\n  LockProjectionRunForMaterializationInput & {\n    readonly finishedAt?: Date\n    readonly progress?: Partial<ProjectionRunProgress>\n  }\n\nexport interface AdvanceProjectionTelemetryCheckpointInput\n  extends LockProjectionRunForMaterializationInput {\n  /** Must equal the run's current nextBatchOrdinal. */\n  readonly batchOrdinal: number\n  /** Physical dataset rows consumed by this batch, including skipped rows. */\n  readonly batchRowCount: number\n  /** Physical rows intentionally skipped inside this batch. */\n  readonly batchRowsSkipped: number\n  /** True when this batch consumed the final row of the immutable dataset version. */\n  readonly inputExhausted: boolean\n}\n\nexport interface RecordProjectionMissingTargetInput\n  extends LockProjectionRunForMaterializationInput {\n  readonly missingTarget: ProjectionMissingTarget\n}\n\nexport interface RecordProjectionAttemptFailureInput\n  extends LockProjectionRunForMaterializationInput {\n  readonly error: SixbFailure<ProjectionRunFailureCode>\n}\n\nexport interface FindSupersedingProjectionRunInput {\n  readonly projectId: string\n  /** The run that may be superseded. */\n  readonly id: string\n}\n\nexport interface ListProjectionRunsInput {\n  readonly projectId: string\n  readonly projectionId?: string\n  readonly projectionKind?: ProjectionKind\n  readonly datasetId?: string\n  readonly datasetVersionId?: string\n  /**\n   * Viewable object type ids. A run is included only if every target type is present. Omit for an\n   * unrestricted internal execution; an empty set matches no runs.\n   */\n  readonly objectTypeIds?: readonly string[]\n  readonly statuses?: readonly ProjectionRunStatus[]\n  readonly startedAfter?: Date\n  readonly startedBefore?: Date\n  readonly limit?: number\n  readonly offset?: number\n  readonly order?: \"asc\" | \"desc\"\n}\n\nexport interface ListProjectionRunsResult {\n  readonly runs: readonly ProjectionRunRecord[]\n  readonly hasMore: boolean\n  readonly total: number\n}\n\nexport interface ListLatestProjectionRunsInput {\n  readonly projectId: string\n  readonly projectionIds: readonly string[]\n}\n\nexport interface ListLatestProjectionRunsResult {\n  readonly runs: readonly ProjectionRunRecord[]\n}\n\nexport interface ProjectionRunStorage {\n  queue(input: QueueProjectionRunInput): Promise<ProjectionRunRecord>\n  startOrReclaim(input: StartOrReclaimProjectionRunInput): Promise<ProjectionRunClaim>\n  failEnqueue(input: FailProjectionRunEnqueueInput): Promise<ProjectionRunRecord>\n  /** Transactionally fences the current execution before ontology materialization writes. */\n  lockForMaterialization(\n    input: LockProjectionRunForMaterializationInput\n  ): Promise<ProjectionRunRecord>\n  /** Updates physical source progress only. */\n  update(input: UpdateProjectionRunInput): Promise<ProjectionRunRecord>\n  /**\n   * Advances telemetry progress atomically with the corresponding ontology commit.\n   *\n   * Clears any recorded missing target: a batch that commits is a batch that was not waiting.\n   */\n  advanceTelemetryCheckpoint(\n    input: AdvanceProjectionTelemetryCheckpointInput\n  ): Promise<TelemetryProjectionRunRecord>\n  /** Records the object a telemetry batch is waiting for, so the wait has a durable start. */\n  recordMissingTarget(\n    input: RecordProjectionMissingTargetInput\n  ): Promise<TelemetryProjectionRunRecord>\n  /**\n   * Records the failure of the current attempt as the `error` of a run that stays `running` to be\n   * retried. Fenced like every other write: a delivery that lost the run cannot overwrite the\n   * failure of the one that holds it now. A reclaim keeps it until the run ends.\n   */\n  recordAttemptFailure(input: RecordProjectionAttemptFailureInput): Promise<ProjectionRunRecord>\n  /** Telemetry success also records the worker's EOF observation atomically. */\n  finish(input: FinishProjectionRunInput): Promise<ProjectionRunRecord>\n  /**\n   * The newest replacement run of the same projection that makes this one stale: pinned to a\n   * later dataset version, and queued, running, or succeeded. A failed or cancelled run replaces\n   * nothing, so it supersedes nothing either. Null for a telemetry run.\n   */\n  findSupersedingRun(input: FindSupersedingProjectionRunInput): Promise<ProjectionRunRecord | null>\n  getById(params: { projectId: string; id: string }): Promise<ProjectionRunRecord | null>\n  list(input: ListProjectionRunsInput): Promise<ListProjectionRunsResult>\n  /** Superseded runs are skipped: the run that superseded them is the one that matters. */\n  listLatestByProjectionIds(\n    input: ListLatestProjectionRunsInput\n  ): Promise<ListLatestProjectionRunsResult>\n}\n\nexport type {\n  LinkProjectionTarget,\n  ObjectProjectionTarget,\n  PinnedDatasetVersion,\n  ProjectionExecution,\n  ProjectionKind,\n  ProjectionMaterializationIdentity,\n  ProjectionTarget,\n}\n"
+    "import type { SixbFailure } from \"../../errors/types\"\nimport type {\n  PinnedDatasetVersion,\n  ProjectionExecution,\n  ProjectionMaterializationIdentity,\n  ProjectionRunTerminalDecision,\n} from \"../../materialization/model\"\nimport type {\n  LinkProjectionTarget,\n  ObjectProjectionTarget,\n  ProjectionKind,\n  ProjectionRunFailureCode,\n  ProjectionTarget,\n} from \"../../projections/types\"\n\nexport type { ProjectionRunFailureCode } from \"../../projections/types\"\nexport { PROJECTION_RUN_FAILURE_CODES } from \"../../projections/types\"\n\n/**\n * `superseded` ends a replacement run whose output would be stale on arrival: a run of the same\n * projection pinned to a later dataset version exists and has not failed. Telemetry runs append\n * readings rather than replace a source, so none is ever superseded.\n */\nexport type ProjectionRunStatus =\n  | \"queued\"\n  | \"running\"\n  | \"succeeded\"\n  | \"failed\"\n  | \"cancelled\"\n  | \"superseded\"\n\nexport interface ProjectionRunProgress {\n  /** Physical immutable-version rows consumed, before normalization or semantic materialization. */\n  readonly sourceRowsRead: number\n  /** Physical rows intentionally skipped because a required mapped value was blank. */\n  readonly sourceRowsSkipped: number\n  /** Maximum complete change records consumed by one incremental attempt; not a recovery cursor. */\n  readonly sourceChangesRead?: number\n}\n\nconst progressKeyFlags: Record<keyof ProjectionRunProgress, true> = {\n  sourceRowsRead: true,\n  sourceRowsSkipped: true,\n  sourceChangesRead: true,\n}\n\nexport const PROJECTION_RUN_PROGRESS_KEYS = Object.keys(\n  progressKeyFlags\n) as readonly (keyof ProjectionRunProgress)[]\n\nexport function zeroProjectionRunProgress(): ProjectionRunProgress {\n  return { sourceRowsRead: 0, sourceRowsSkipped: 0 }\n}\n\nexport interface ProjectionTelemetryCheckpoint {\n  readonly fixedBatchSize: number\n  readonly nextBatchOrdinal: number\n  readonly nextRowOffset: number\n  readonly inputExhausted: boolean\n}\n\n/**\n * The object a telemetry batch is waiting for, and when this run first found it missing.\n *\n * A projection's dataset can legitimately be materialized before the objects it references, so\n * the run waits instead of failing. The wait needs a start, and the run has no other durable one:\n * `startedAt` is when the run began, which on a batched projection is long before the batch that\n * cannot commit, and `attempt` counts every reclaim including the ones an unreachable queue caused.\n *\n * Cleared by any committed batch, so a run that is making progress never carries a stale wait.\n */\nexport interface ProjectionMissingTarget {\n  readonly objectTypeId: string\n  readonly objectId: string\n  /** The batch that could not commit because of it. */\n  readonly batchOrdinal: number\n  readonly firstSeenAt: Date\n}\n\ninterface ProjectionRunRecordBase {\n  readonly id: string\n  readonly projectId: string\n  readonly executionId: string\n  readonly status: ProjectionRunStatus\n  readonly attempt: number\n  readonly progress: ProjectionRunProgress\n  readonly queuedAt: Date\n  readonly startedAt?: Date\n  readonly finishedAt?: Date\n  /**\n   * The run's most recent failure, read with its status: on a `running` run, why its last attempt\n   * failed while the queue retries it; on a `failed` or `cancelled` run, why it ended. Cleared when\n   * the run succeeds or is superseded, so a present error always describes something current.\n   */\n  readonly error?: SixbFailure<ProjectionRunFailureCode>\n}\n\ntype ProjectionIdentity<TKind extends ProjectionKind> = Extract<\n  ProjectionMaterializationIdentity,\n  { readonly projectionKind: TKind }\n>\n\nexport type ObjectProjectionRunRecord = ProjectionRunRecordBase & {\n  readonly identity: ProjectionIdentity<\"object\">\n  readonly target: ObjectProjectionTarget\n  readonly telemetryCheckpoint?: never\n  readonly missingTarget?: never\n}\n\nexport type LinkProjectionRunRecord = ProjectionRunRecordBase & {\n  readonly identity: ProjectionIdentity<\"link\">\n  readonly target: LinkProjectionTarget\n  readonly telemetryCheckpoint?: never\n  readonly missingTarget?: never\n}\n\nexport type TelemetryProjectionRunRecord = ProjectionRunRecordBase & {\n  readonly identity: ProjectionIdentity<\"telemetry\">\n  readonly target: ObjectProjectionTarget\n  readonly telemetryCheckpoint: ProjectionTelemetryCheckpoint\n  /**\n   * Only telemetry carries this: `MaterializationObjectNotFoundError` is raised by telemetry\n   * validation alone, and only a batched protocol has a checkpoint to anchor the wait to.\n   */\n  readonly missingTarget?: ProjectionMissingTarget\n}\n\n/** Durable projection lifecycle state. The execution token is deliberately returned separately. */\nexport type ProjectionRunRecord =\n  | ObjectProjectionRunRecord\n  | LinkProjectionRunRecord\n  | TelemetryProjectionRunRecord\n\nexport function projectionRunObjectTypesVisible(\n  run: ProjectionRunRecord,\n  canView: (objectTypeId: string) => boolean\n): boolean {\n  const target: ProjectionTarget = run.target\n  if (\"sourceObjectTypeId\" in target) {\n    return canView(target.sourceObjectTypeId) && canView(target.targetObjectTypeId)\n  }\n  return canView(target.objectTypeId)\n}\n\ninterface ProjectionRunAdmissionBase {\n  readonly id: string\n  readonly projectId: string\n  readonly executionId: string\n  readonly queuedAt?: Date\n}\n\nexport type QueueProjectionRunInput =\n  | (ProjectionRunAdmissionBase & {\n      readonly identity: ProjectionIdentity<\"object\">\n      readonly target: ObjectProjectionRunRecord[\"target\"]\n      readonly fixedBatchSize?: never\n    })\n  | (ProjectionRunAdmissionBase & {\n      readonly identity: ProjectionIdentity<\"link\">\n      readonly target: LinkProjectionRunRecord[\"target\"]\n      readonly fixedBatchSize?: never\n    })\n  | (ProjectionRunAdmissionBase & {\n      readonly identity: ProjectionIdentity<\"telemetry\">\n      readonly target: TelemetryProjectionRunRecord[\"target\"]\n      readonly fixedBatchSize: number\n    })\n\nexport type StartOrReclaimProjectionRunInput = QueueProjectionRunInput extends infer TInput\n  ? TInput extends QueueProjectionRunInput\n    ? Omit<TInput, \"executionId\" | \"queuedAt\"> & { readonly startedAt?: Date }\n    : never\n  : never\n\nexport interface FailProjectionRunEnqueueInput {\n  readonly id: string\n  readonly projectId: string\n  readonly finishedAt?: Date\n  readonly error: SixbFailure<ProjectionRunFailureCode>\n}\n\nexport interface ProjectionRunClaim {\n  readonly run: ProjectionRunRecord\n  readonly execution: ProjectionExecution\n}\n\nexport interface LockProjectionRunForMaterializationInput {\n  readonly id: string\n  readonly projectId: string\n  readonly executionToken: string\n  readonly identity: ProjectionMaterializationIdentity\n}\n\nexport interface UpdateProjectionRunInput extends LockProjectionRunForMaterializationInput {\n  readonly progress: Partial<ProjectionRunProgress>\n}\n\nexport type FinishProjectionRunInput = ProjectionRunTerminalDecision &\n  LockProjectionRunForMaterializationInput & {\n    readonly finishedAt?: Date\n    readonly progress?: Partial<ProjectionRunProgress>\n  }\n\nexport interface AdvanceProjectionTelemetryCheckpointInput\n  extends LockProjectionRunForMaterializationInput {\n  /** Must equal the run's current nextBatchOrdinal. */\n  readonly batchOrdinal: number\n  /** Physical dataset rows consumed by this batch, including skipped rows. */\n  readonly batchRowCount: number\n  /** Physical rows intentionally skipped inside this batch. */\n  readonly batchRowsSkipped: number\n  /** True when this batch consumed the final row of the immutable dataset version. */\n  readonly inputExhausted: boolean\n}\n\nexport interface RecordProjectionMissingTargetInput\n  extends LockProjectionRunForMaterializationInput {\n  readonly missingTarget: ProjectionMissingTarget\n}\n\nexport interface RecordProjectionAttemptFailureInput\n  extends LockProjectionRunForMaterializationInput {\n  readonly error: SixbFailure<ProjectionRunFailureCode>\n}\n\nexport interface FindSupersedingProjectionRunInput {\n  readonly projectId: string\n  /** The run that may be superseded. */\n  readonly id: string\n}\n\nexport interface ListProjectionRunsInput {\n  readonly projectId: string\n  readonly projectionId?: string\n  readonly projectionKind?: ProjectionKind\n  readonly datasetId?: string\n  readonly datasetVersionId?: string\n  /**\n   * Viewable object type ids. A run is included only if every target type is present. Omit for an\n   * unrestricted internal execution; an empty set matches no runs.\n   */\n  readonly objectTypeIds?: readonly string[]\n  readonly statuses?: readonly ProjectionRunStatus[]\n  /** Runs whose recorded `error` has one of these codes; an empty set matches no runs. */\n  readonly errorCodes?: readonly ProjectionRunFailureCode[]\n  readonly startedAfter?: Date\n  readonly startedBefore?: Date\n  readonly limit?: number\n  readonly offset?: number\n  readonly order?: \"asc\" | \"desc\"\n}\n\nexport interface ListProjectionRunsResult {\n  readonly runs: readonly ProjectionRunRecord[]\n  readonly hasMore: boolean\n  readonly total: number\n}\n\nexport interface ListLatestProjectionRunsInput {\n  readonly projectId: string\n  readonly projectionIds: readonly string[]\n}\n\nexport interface ListLatestProjectionRunsResult {\n  readonly runs: readonly ProjectionRunRecord[]\n}\n\nexport interface ProjectionRunStorage {\n  queue(input: QueueProjectionRunInput): Promise<ProjectionRunRecord>\n  startOrReclaim(input: StartOrReclaimProjectionRunInput): Promise<ProjectionRunClaim>\n  failEnqueue(input: FailProjectionRunEnqueueInput): Promise<ProjectionRunRecord>\n  /** Transactionally fences the current execution before ontology materialization writes. */\n  lockForMaterialization(\n    input: LockProjectionRunForMaterializationInput\n  ): Promise<ProjectionRunRecord>\n  /** Updates physical source progress only. */\n  update(input: UpdateProjectionRunInput): Promise<ProjectionRunRecord>\n  /**\n   * Advances telemetry progress atomically with the corresponding ontology commit.\n   *\n   * Clears any recorded missing target: a batch that commits is a batch that was not waiting.\n   */\n  advanceTelemetryCheckpoint(\n    input: AdvanceProjectionTelemetryCheckpointInput\n  ): Promise<TelemetryProjectionRunRecord>\n  /** Records the object a telemetry batch is waiting for, so the wait has a durable start. */\n  recordMissingTarget(\n    input: RecordProjectionMissingTargetInput\n  ): Promise<TelemetryProjectionRunRecord>\n  /**\n   * Records the failure of the current attempt as the `error` of a run that stays `running` to be\n   * retried. Fenced like every other write: a delivery that lost the run cannot overwrite the\n   * failure of the one that holds it now. A reclaim keeps it until the run ends.\n   */\n  recordAttemptFailure(input: RecordProjectionAttemptFailureInput): Promise<ProjectionRunRecord>\n  /** Telemetry success also records the worker's EOF observation atomically. */\n  finish(input: FinishProjectionRunInput): Promise<ProjectionRunRecord>\n  /**\n   * The newest replacement run of the same projection that makes this one stale: pinned to a\n   * later dataset version, and queued, running, or succeeded. A failed or cancelled run replaces\n   * nothing, so it supersedes nothing either. Null for a telemetry run.\n   */\n  findSupersedingRun(input: FindSupersedingProjectionRunInput): Promise<ProjectionRunRecord | null>\n  getById(params: { projectId: string; id: string }): Promise<ProjectionRunRecord | null>\n  list(input: ListProjectionRunsInput): Promise<ListProjectionRunsResult>\n  /** Superseded runs are skipped: the run that superseded them is the one that matters. */\n  listLatestByProjectionIds(\n    input: ListLatestProjectionRunsInput\n  ): Promise<ListLatestProjectionRunsResult>\n}\n\nexport type {\n  LinkProjectionTarget,\n  ObjectProjectionTarget,\n  PinnedDatasetVersion,\n  ProjectionExecution,\n  ProjectionKind,\n  ProjectionMaterializationIdentity,\n  ProjectionTarget,\n}\n"
   ],
   "mappings": ";;AAGO,IAAM,gCAA+B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;;;AC+BA,IAAM,mBAA8D;AAAA,EAClE,gBAAgB;AAAA,EAChB,mBAAmB;AAAA,EACnB,mBAAmB;AACrB;AAEO,IAAM,gCAA+B,OAAO,KACjD,gBACF;AAEO,SAAS,0BAAyB,GAA0B;AAAA,EACjE,OAAO,EAAE,gBAAgB,GAAG,mBAAmB,EAAE;AAAA;AAkF5C,SAAS,gCAA+B,CAC7C,KACA,SACS;AAAA,EACT,MAAM,SAA2B,IAAI;AAAA,EACrC,IAAI,wBAAwB,QAAQ;AAAA,IAClC,OAAO,QAAQ,OAAO,kBAAkB,KAAK,QAAQ,OAAO,kBAAkB;AAAA,EAChF;AAAA,EACA,OAAO,QAAQ,OAAO,YAAY;AAAA;",
   "debugId": "6E88BA6849E66AE464756E2164756E21",

package/dist/{chunk-nj0020ay.js → chunk-jjrn5v0p.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   isPrimitiveSchema
-} from "./chunk-swxzncrv.js";
+} from "./chunk-rpxz486p.js";
 import {
   isPlainRecord
 } from "./chunk-wy0qdqfm.js";

package/dist/{chunk-nvymebc1.js → chunk-jnfxmr3f.js}

@@ -7,7 +7,7 @@ import {
   resolveExecutionScopeAuthorization,
   AuthorizationError2,
   assertProviderAccess2
-} from "./chunk-69kt9q43.js";
+} from "./chunk-5be2ath4.js";
 import {
   isOAuthConnectorDefinition2
 } from "./chunk-9x8dybsb.js";

package/dist/{chunk-nkbev3tr.js → chunk-k4g51s47.js}

@@ -9,10 +9,10 @@ import {
 import {
   resolveExecutionScopeAuthorization,
   assertAuthorized2
-} from "./chunk-69kt9q43.js";
+} from "./chunk-5be2ath4.js";
 import {
   SYNC_RUN_FAILURE_CODES2
-} from "./chunk-6z1q7j19.js";
+} from "./chunk-5yd8cchh.js";
 import {
   SyncRunError2
 } from "./chunk-jmfet9r4.js";
@@ -20,7 +20,7 @@ import {
   executionRecordInputFromRuntime,
   ensureExecutionRecord2,
   createPrimitiveExecutionRecord
-} from "./chunk-7g2gjvah.js";
+} from "./chunk-a7er86jd.js";
 
 // src/syncs/errors.ts
 class SyncValidationError2 extends Error {

package/dist/{chunk-a0073121.js → chunk-kpx7jrmn.js}

@@ -52,6 +52,8 @@ function normalizeNode(query) {
       };
     case "traverse":
       return { ...query, input: normalizeObjectQuery2(query.input) };
+    case "rerank":
+      return { ...query, model: { ...query.model }, input: normalizeObjectQuery2(query.input) };
     case "set":
       return normalizeSet(query);
     case "sort":
@@ -282,4 +284,4 @@ function formatQueryPlanningMessage(issues) {
 
 export { formatObjectQueryExplanation2, normalizeObjectQuery2, normalizeObjectQueryPredicate2, ObjectQueryValidationError2, ObjectQueryPlanningError2, ObjectQueryExecutionError2 };
 
-//# debugId=D43510D30ECBDBA564756E2164756E21
+//# debugId=F89B013FA810BE5464756E2164756E21

package/dist/chunk-kpx7jrmn.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/objects/query/explain-format.ts", "../src/objects/query/normalize.ts", "../src/objects/query/errors.ts"],
+  "sourcesContent": [
+    "/**\n * Formatting for object query explanations.\n *\n * Lives apart from `explain.ts` so the fluent builder (and browser bundles\n * built on it) can import the formatter without pulling in the explanation\n * builder and its validation machinery.\n */\nimport type { ObjectQueryExplainNode, ObjectQueryExplanation } from \"./explain\"\n\nexport function formatObjectQueryExplanation(explanation: ObjectQueryExplanation): string {\n  const lines: string[] = []\n  const status =\n    explanation.valid === undefined ? \"not validated\" : explanation.valid ? \"valid\" : \"invalid\"\n  const result = explanation.result ? ` result=${explanation.result.objectTypeIds.join(\" | \")}` : \"\"\n\n  lines.push(`ObjectQuery ${status}${result}`)\n  appendNodeLines(explanation.tree, lines, 0)\n\n  if (explanation.issues.length > 0) {\n    lines.push(\"Issues:\")\n    for (const issue of explanation.issues) {\n      lines.push(`- ${issue.path} [${issue.code}] ${issue.message}`)\n    }\n  }\n\n  return lines.join(\"\\n\")\n}\n\nfunction appendNodeLines(node: ObjectQueryExplainNode, lines: string[], depth: number): void {\n  lines.push(`${\"  \".repeat(depth)}- ${node.path} ${node.summary}`)\n  for (const child of node.children) {\n    appendNodeLines(child, lines, depth + 1)\n  }\n}\n",
+    "import type {\n  ObjectExpansion,\n  ObjectQuery,\n  ObjectQueryPredicate,\n  ObjectQuerySet,\n  ObjectQuerySortField,\n} from \"./ir\"\n\n/**\n * Canonicalizes query trees before validation/planning so providers see a\n * stable shape regardless of how the typed builder assembled the query.\n *\n * `expand` is output-shaping, so it is hoisted to the outermost layer here: two\n * queries that differ only in where `.expand(...)` was chained normalize to the\n * same tree (and therefore the same cache key).\n */\nexport function normalizeObjectQuery(query: ObjectQuery): ObjectQuery {\n  return hoistExpand(normalizeNode(query))\n}\n\nfunction normalizeNode(query: ObjectQuery): ObjectQuery {\n  switch (query.kind) {\n    case \"start\":\n      return { ...query }\n    case \"refs\":\n      return {\n        kind: \"refs\",\n        refs: uniqueRefs(query.refs),\n      }\n    case \"filter\":\n      return normalizeFilter(query.input, query.predicate)\n    case \"text\":\n      return {\n        ...query,\n        input: normalizeObjectQuery(query.input),\n        fields: query.fields ? uniqueStrings(query.fields) : undefined,\n        fieldsByObjectType: query.fieldsByObjectType\n          ? uniqueStringRecord(query.fieldsByObjectType)\n          : undefined,\n      }\n    case \"vector\":\n      return {\n        ...query,\n        input: normalizeObjectQuery(query.input),\n        vector: typeof query.vector === \"string\" ? query.vector : [...query.vector],\n      }\n    case \"traverse\":\n      return { ...query, input: normalizeObjectQuery(query.input) }\n    case \"rerank\":\n      return { ...query, model: { ...query.model }, input: normalizeObjectQuery(query.input) }\n    case \"set\":\n      return normalizeSet(query)\n    case \"sort\":\n      return normalizeSort(query.input, query.fields)\n    case \"limit\":\n      return normalizeLimit(query.input, query.limit)\n    case \"page\":\n      return { ...query, input: normalizeObjectQuery(query.input) }\n    case \"project\":\n      return {\n        ...query,\n        input: normalizeObjectQuery(query.input),\n        properties: query.properties ? uniqueStrings(query.properties) : undefined,\n      }\n    case \"expand\":\n      return normalizeExpand(query.input, query.expansions)\n  }\n}\n\n/**\n * Keeps `expand` at the outermost layer. A single-input wrapper sitting above an\n * `expand` is swapped so the `expand` wraps the (re-normalized) wrapper subtree;\n * re-normalizing collapses any nodes that became adjacent, and a wrapper that\n * lands above another `expand` is merged into one.\n */\nfunction hoistExpand(query: ObjectQuery): ObjectQuery {\n  if (\n    query.kind === \"start\" ||\n    query.kind === \"refs\" ||\n    query.kind === \"set\" ||\n    query.kind === \"expand\"\n  ) {\n    return query\n  }\n  if (query.input.kind !== \"expand\") return query\n\n  const inner = query.input\n  const rebuilt = normalizeObjectQuery({ ...query, input: inner.input })\n  if (rebuilt.kind === \"expand\") {\n    return {\n      kind: \"expand\",\n      input: rebuilt.input,\n      expansions: normalizeExpansions([...inner.expansions, ...rebuilt.expansions]),\n    }\n  }\n  return { kind: \"expand\", input: rebuilt, expansions: inner.expansions }\n}\n\nfunction normalizeExpand(input: ObjectQuery, expansions: readonly ObjectExpansion[]): ObjectQuery {\n  const normalizedInput = normalizeObjectQuery(input)\n  const normalizedExpansions = normalizeExpansions(expansions)\n\n  // A directly-nested expand (`a.expand(X).expand(Y)` builds\n  // `expand(expand(start, [X]), [Y])`) collapses into one outermost expand.\n  if (normalizedInput.kind === \"expand\") {\n    return {\n      kind: \"expand\",\n      input: normalizedInput.input,\n      expansions: normalizeExpansions([...normalizedInput.expansions, ...normalizedExpansions]),\n    }\n  }\n\n  return { kind: \"expand\", input: normalizedInput, expansions: normalizedExpansions }\n}\n\nfunction normalizeExpansions(expansions: readonly ObjectExpansion[]): ObjectExpansion[] {\n  const byKey = new Map<string, ObjectExpansion>()\n  for (const expansion of expansions) {\n    const normalized = normalizeExpansion(expansion)\n    const key = expansionKey(normalized)\n    const existing = byKey.get(key)\n    byKey.set(key, existing ? mergeExpansion(existing, normalized) : normalized)\n  }\n\n  return [...byKey.values()].sort((a, b) => {\n    const left = expansionKey(a)\n    const right = expansionKey(b)\n    return left < right ? -1 : left > right ? 1 : 0\n  })\n}\n\nfunction normalizeExpansion(expansion: ObjectExpansion): ObjectExpansion {\n  const nested = expansion.expand ? normalizeExpansions(expansion.expand) : []\n  return {\n    linkId: expansion.linkId,\n    direction: expansion.direction,\n    ...(expansion.sourceObjectTypeId !== undefined\n      ? { sourceObjectTypeId: expansion.sourceObjectTypeId }\n      : {}),\n    ...(expansion.limit !== undefined ? { limit: expansion.limit } : {}),\n    ...(expansion.orderBy ? { orderBy: expansion.orderBy.map((field) => ({ ...field })) } : {}),\n    ...(nested.length > 0 ? { expand: nested } : {}),\n  }\n}\n\n// Two expansions of the same link in the same direction are one hydration; their\n// nested expansions merge so the normalized tree never double-hydrates a link.\nfunction mergeExpansion(a: ObjectExpansion, b: ObjectExpansion): ObjectExpansion {\n  const nested = normalizeExpansions([...(a.expand ?? []), ...(b.expand ?? [])])\n  const { expand: _existing, ...base } = a\n  return nested.length > 0 ? { ...base, expand: nested } : base\n}\n\nfunction expansionKey(expansion: ObjectExpansion): string {\n  return `${expansion.direction}\\0${expansion.linkId}\\0${expansion.sourceObjectTypeId ?? \"\"}`\n}\n\nexport function normalizeObjectQueryPredicate(\n  predicate: ObjectQueryPredicate\n): ObjectQueryPredicate {\n  switch (predicate.op) {\n    case \"and\":\n    case \"or\": {\n      const items = predicate.items.flatMap((item) => {\n        const normalized = normalizeObjectQueryPredicate(item)\n        if (normalized.op === predicate.op) return normalized.items\n        return [normalized]\n      })\n      return items.length === 1 ? items[0] : { op: predicate.op, items }\n    }\n    case \"not\":\n      return { op: \"not\", item: normalizeObjectQueryPredicate(predicate.item) }\n    case \"in\":\n      return { ...predicate, values: [...predicate.values] }\n    default:\n      return { ...predicate }\n  }\n}\n\nfunction normalizeFilter(input: ObjectQuery, predicate: ObjectQueryPredicate): ObjectQuery {\n  const normalizedInput = normalizeObjectQuery(input)\n  const normalizedPredicate = normalizeObjectQueryPredicate(predicate)\n\n  // Adjacent filters are equivalent to a single conjunction and are easier for\n  // capability checks and providers to inspect.\n  if (normalizedInput.kind === \"filter\") {\n    return normalizeObjectQuery({\n      kind: \"filter\",\n      input: normalizedInput.input,\n      predicate: {\n        op: \"and\",\n        items: [normalizedInput.predicate, normalizedPredicate],\n      },\n    })\n  }\n\n  return {\n    kind: \"filter\",\n    input: normalizedInput,\n    predicate: normalizedPredicate,\n  }\n}\n\nfunction normalizeSet(query: ObjectQuerySet): ObjectQuery {\n  const inputs = query.inputs.flatMap((input) => {\n    const normalized = normalizeObjectQuery(input)\n    if (normalized.kind === \"set\" && normalized.op === query.op) return normalized.inputs\n    return [normalized]\n  })\n\n  return { ...query, inputs }\n}\n\nfunction normalizeSort(input: ObjectQuery, fields: readonly ObjectQuerySortField[]): ObjectQuery {\n  const normalizedInput = normalizeObjectQuery(input)\n  const normalizedFields = fields.map((field) => ({ ...field }))\n\n  // A later sort fully determines result order, so it replaces an adjacent sort.\n  if (normalizedInput.kind === \"sort\") {\n    return {\n      kind: \"sort\",\n      input: normalizedInput.input,\n      fields: normalizedFields,\n    }\n  }\n\n  return {\n    kind: \"sort\",\n    input: normalizedInput,\n    fields: normalizedFields,\n  }\n}\n\nfunction normalizeLimit(input: ObjectQuery, limit: number): ObjectQuery {\n  const normalizedInput = normalizeObjectQuery(input)\n\n  // Adjacent limits collapse to the stricter bound.\n  if (normalizedInput.kind === \"limit\") {\n    return {\n      kind: \"limit\",\n      input: normalizedInput.input,\n      limit: Math.min(normalizedInput.limit, limit),\n    }\n  }\n\n  return {\n    kind: \"limit\",\n    input: normalizedInput,\n    limit,\n  }\n}\n\nfunction uniqueStrings(values: readonly string[]): string[] {\n  return [...new Set(values)]\n}\n\nfunction uniqueRefs(\n  refs: readonly { objectTypeId: string; primaryId: string }[]\n): { objectTypeId: string; primaryId: string }[] {\n  const seen = new Set<string>()\n  const unique = refs.flatMap((ref) => {\n    const key = JSON.stringify([ref.objectTypeId, ref.primaryId])\n    if (seen.has(key)) return []\n    seen.add(key)\n    return [{ ...ref }]\n  })\n\n  // `refs` is an object-set source, not a positional batch response. Canonical\n  // identity order makes equivalent sets normalize identically and matches the\n  // default ordering used by provider query sources.\n  return unique.sort(\n    (left, right) =>\n      compareStrings(left.objectTypeId, right.objectTypeId) ||\n      compareStrings(left.primaryId, right.primaryId)\n  )\n}\n\nfunction compareStrings(left: string, right: string): number {\n  if (left < right) return -1\n  if (left > right) return 1\n  return 0\n}\n\nfunction uniqueStringRecord(\n  record: Readonly<Record<string, readonly string[]>>\n): Record<string, string[]> {\n  return Object.fromEntries(\n    Object.entries(record).map(([objectTypeId, fields]) => [objectTypeId, uniqueStrings(fields)])\n  )\n}\n",
+    "import type { ObjectQueryValidationIssue } from \"./validate\"\n\nexport interface ObjectQueryPlanningIssue {\n  path: string\n  code: string\n  message: string\n}\n\nexport class ObjectQueryValidationError extends Error {\n  readonly name = \"ObjectQueryValidationError\"\n  readonly issues: readonly ObjectQueryValidationIssue[]\n\n  constructor(issues: readonly ObjectQueryValidationIssue[]) {\n    super(formatQueryValidationMessage(issues))\n    this.issues = issues\n  }\n}\n\nexport class ObjectQueryPlanningError extends Error {\n  readonly name = \"ObjectQueryPlanningError\"\n  readonly issues: readonly ObjectQueryPlanningIssue[]\n\n  constructor(issues: readonly ObjectQueryPlanningIssue[]) {\n    super(formatQueryPlanningMessage(issues))\n    this.issues = issues\n  }\n}\n\nexport class ObjectQueryExecutionError extends Error {\n  readonly name = \"ObjectQueryExecutionError\"\n  readonly code: string\n  readonly path?: string\n\n  constructor(code: string, message: string, path?: string) {\n    super(`[Sixb] Object query execution failed: ${message}`)\n    this.code = code\n    this.path = path\n  }\n}\n\nfunction formatQueryValidationMessage(issues: readonly ObjectQueryValidationIssue[]): string {\n  if (issues.length === 0) return \"[Sixb] Object query validation failed\"\n  if (issues.length === 1) return `[Sixb] Object query validation failed: ${issues[0].message}`\n  return `[Sixb] Object query validation failed with ${issues.length} issues: ${issues\n    .map((issue) => issue.message)\n    .join(\"; \")}`\n}\n\nfunction formatQueryPlanningMessage(issues: readonly ObjectQueryPlanningIssue[]): string {\n  if (issues.length === 0) return \"[Sixb] Object query planning failed\"\n  if (issues.length === 1) return `[Sixb] Object query planning failed: ${issues[0].message}`\n  return `[Sixb] Object query planning failed with ${issues.length} issues: ${issues\n    .map((issue) => issue.message)\n    .join(\"; \")}`\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "F89B013FA810BE5464756E2164756E21",
+  "names": []
+}

package/dist/{chunk-h044jb97.js → chunk-pja9jfz6.js}

@@ -3,7 +3,7 @@ import {
   MAX_OBJECT_READ_FACETS2,
   isAllowed2,
   assertAuthorized2
-} from "./chunk-69kt9q43.js";
+} from "./chunk-5be2ath4.js";
 import {
   validateSchemaValue2,
   validatePropertyValue2,
@@ -12,7 +12,10 @@ import {
   isTextSchema,
   isContainsSchema,
   queryScalarKindForSchema
-} from "./chunk-swxzncrv.js";
+} from "./chunk-rpxz486p.js";
+import {
+  validateRerankingResults
+} from "./chunk-s7ftxrdr.js";
 import {
   hasVectorProfile2,
   isVectorProfileQuery2,
@@ -23,26 +26,31 @@ import {
   queryScalarValuesEqual,
   MAX_VECTOR_K,
   vectorConfiguration,
+  vectorSources,
   normalizeVector2
-} from "./chunk-6z1q7j19.js";
+} from "./chunk-5yd8cchh.js";
 import {
   normalizeObjectQuery2,
   ObjectQueryValidationError2,
   ObjectQueryPlanningError2,
   ObjectQueryExecutionError2
-} from "./chunk-a0073121.js";
-import {
-  sameEmbeddingModel
-} from "./chunk-kyjcwqz6.js";
+} from "./chunk-kpx7jrmn.js";
 import {
   formatUnknownObjectTypeMessage
 } from "./chunk-cqr3acm1.js";
+import {
+  sameEmbeddingModel
+} from "./chunk-kyjcwqz6.js";
 import {
   normalizeDecimalValue2
 } from "./chunk-3bh94gbw.js";
 import {
   stableJsonStringify2
 } from "./chunk-wy0qdqfm.js";
+// src/objects/query/reranking-limits.ts
+var MAX_RERANK_CANDIDATES = 100;
+var MAX_RERANK_INPUT_BYTES = 1048576;
+
 // src/objects/query/validate.ts
 var DEFAULT_MAX_LIMIT = 1000;
 var DEFAULT_MAX_PAGE_SIZE = 1000;
@@ -100,7 +108,7 @@ function validateVectorComposition(query, ctx) {
     ctx.issues.push({
       path: "$",
       code: "vector.composition",
-      message: "Vector profiles support one top-k over one concrete type, with filters, traversals or sets before ranking and optional limit/project after it."
+      message: "Vector profiles support one top-k over one concrete type, with filters, traversals or sets before ranking, optional reranking, then limit/project."
     });
 }
 function createValidationContext(options, admission) {
@@ -197,6 +205,16 @@ function dispatchQueryNode(query, path, ctx) {
         }))
       };
     }
+    case "rerank": {
+      const input = validateQueryNode(query.input, `${path}.input`, ctx);
+      if (input.query.kind !== "vector" || typeof input.query.vector !== "string" || input.query.k > MAX_RERANK_CANDIDATES) {
+        addIssue(ctx, path, "invalid_rerank_input", `Reranking requires a text vector query with k at most ${MAX_RERANK_CANDIDATES}, before limit or project.`);
+      }
+      if (typeof query.model?.provider !== "string" || !query.model.provider.trim() || query.model.provider.trim() !== query.model.provider || typeof query.model.modelId !== "string" || !query.model.modelId.trim() || query.model.modelId.trim() !== query.model.modelId) {
+        addIssue(ctx, path, "invalid_rerank_model", "Reranking requires an explicit provider and model ID.");
+      }
+      return { ...input, query: { ...query, model: { ...query.model }, input: input.query } };
+    }
     case "set":
       return validateSet(query.inputs, query.op, path, ctx);
     case "sort": {
@@ -952,6 +970,15 @@ async function embedSearchText(text, model, signal) {
   }
 }
 
+// src/objects/query/reranking-query.ts
+function findQueryReranking(query) {
+  if (query.kind === "rerank")
+    return query;
+  if (query.kind === "limit" || query.kind === "project")
+    return findQueryReranking(query.input);
+  return;
+}
+
 // src/objects/query/planner.ts
 var DEFAULT_MAX_FALLBACK_ROWS = 1000;
 var fallbackNodeKinds = new Set([
@@ -966,6 +993,15 @@ var fallbackNodeKinds = new Set([
 ]);
 function planObjectQuery2(query, options) {
   const operation = options.operation ?? "queryObjects";
+  const reranking = findQueryReranking(query);
+  if (reranking) {
+    const candidatePlan = planObjectQuery2(reranking.input, options);
+    return {
+      ...candidatePlan,
+      query,
+      mode: candidatePlan.mode === "rejected" ? "rejected" : "pipeline"
+    };
+  }
   const providerIssues = collectProviderIssues(query, options.capabilities, {
     operation,
     hasImplementation: hasProviderImplementation(operation, options)
@@ -1061,6 +1097,7 @@ function collectNodeProviderIssues(query, path, capabilities, issues) {
       return;
     case "text":
     case "vector":
+    case "rerank":
     case "project":
       collectNodeProviderIssues(query.input, `${path}.input`, capabilities, issues);
       return;
@@ -1250,6 +1287,98 @@ function addIssue2(issues, path, code, message) {
   issues.push({ path, code, message });
 }
 
+// src/objects/query/primary-id.ts
+function usePrimaryIdLookups(query, ontology) {
+  if (query.kind === "set")
+    return { ...query, inputs: query.inputs.map((input) => usePrimaryIdLookups(input, ontology)) };
+  if (!("input" in query))
+    return query;
+  const input = usePrimaryIdLookups(query.input, ontology);
+  if (query.kind === "filter" && input.kind === "start" && !input.includeSubtypes) {
+    const propertyId = ontology.getPrimaryPropertyId(input.objectTypeId);
+    const ids = primaryIds(query.predicate, propertyId);
+    if (ids?.length && ids.length <= 1000)
+      return {
+        ...query,
+        input: {
+          kind: "refs",
+          refs: [...new Set(ids)].sort().map((primaryId) => ({ objectTypeId: input.objectTypeId, primaryId }))
+        }
+      };
+  }
+  return input === query.input ? query : { ...query, input };
+}
+function primaryIds(predicate, propertyId) {
+  if (predicate.op === "and") {
+    for (const item of predicate.items) {
+      const ids = primaryIds(item, propertyId);
+      if (ids)
+        return ids;
+    }
+    return;
+  }
+  if (predicate.op === "eq" && predicate.propertyId === propertyId && typeof predicate.value === "string")
+    return [predicate.value];
+  if (predicate.op === "in" && predicate.propertyId === propertyId && predicate.values.every((value) => typeof value === "string"))
+    return predicate.values;
+  return;
+}
+
+// src/objects/query/reranking-executor.ts
+async function rerankObjectCandidates(input) {
+  const { vector, candidates, model, signal } = input;
+  if (typeof vector.vector !== "string" || !vector.source) {
+    throw new ObjectQueryExecutionError2("invalid_rerank_input", "Reranking requires a validated text vector query.");
+  }
+  signal?.throwIfAborted();
+  if (candidates.length > vector.k) {
+    throw new ObjectQueryExecutionError2("rerank_candidate_limit_exceeded", "Storage exceeded the admitted vector candidate bound.");
+  }
+  const source = vector.source;
+  const documents = candidates.map((row) => vectorSources(source, row.properties).text);
+  const encoder = new TextEncoder;
+  const bytes = encoder.encode(vector.vector).byteLength + documents.reduce((sum, text) => sum + encoder.encode(text).byteLength, 0);
+  if (bytes > MAX_RERANK_INPUT_BYTES) {
+    throw new ObjectQueryExecutionError2("rerank_input_limit_exceeded", "Reranking input exceeds 1 MiB. Use fewer candidates or shorter profile sources.");
+  }
+  const results = documents.length === 0 ? [] : (await model.rerank({ query: vector.vector, documents, signal })).results;
+  signal?.throwIfAborted();
+  const ranking = validateRerankingResults(results, candidates.length);
+  const rows = ranking.map(({ index, score }) => ({ ...candidates[index], score }));
+  const shaped = shapeRerankedRows(input.query, rows);
+  return {
+    objects: shaped.rows,
+    hasMore: shaped.hasMore,
+    ...input.includeTotal === false ? {} : { total: shaped.total }
+  };
+}
+function shapeRerankedRows(query, rows) {
+  if (query.kind === "rerank")
+    return { rows, total: rows.length, hasMore: false };
+  if (query.kind === "limit") {
+    const input = shapeRerankedRows(query.input, rows);
+    return {
+      rows: input.rows.slice(0, query.limit),
+      total: input.total,
+      hasMore: input.hasMore || query.limit < input.rows.length
+    };
+  }
+  if (query.kind === "project") {
+    const input = shapeRerankedRows(query.input, rows);
+    if (!query.properties)
+      return input;
+    const properties = new Set(query.properties);
+    return {
+      ...input,
+      rows: input.rows.map((row) => ({
+        ...row,
+        properties: Object.fromEntries(Object.entries(row.properties).filter(([key]) => properties.has(key)))
+      }))
+    };
+  }
+  throw new ObjectQueryExecutionError2("invalid_rerank_composition", "Only limit and project may follow reranking.");
+}
+
 // src/objects/query/executor.ts
 var DEFAULT_MAX_FALLBACK_ROWS2 = 1000;
 var DEFAULT_MAX_FACET_LIMIT = 1000;
@@ -1292,6 +1421,26 @@ async function executeObjectQuery2(input, options) {
   if (plan.mode === "rejected") {
     throw new ObjectQueryPlanningError2(plan.issues);
   }
+  if (plan.mode === "pipeline") {
+    const reranking = findQueryReranking(validated.query);
+    if (!reranking || reranking.input.kind !== "vector") {
+      throw new ObjectQueryExecutionError2("invalid_rerank_input", "Reranking requires vector candidates.");
+    }
+    const model = options.rerankingModels?.getByRef(reranking.model)?.model;
+    if (!model) {
+      throw new ObjectQueryExecutionError2("reranking_model_unavailable", `Reranking model '${reranking.model.provider}/${reranking.model.modelId}' is not configured in models.reranking.`);
+    }
+    const candidates = await executeObjectQuery2({ ...input, query: reranking.input, includeTotal: false }, options);
+    const result = await rerankObjectCandidates({
+      query: validated.query,
+      vector: reranking.input,
+      candidates: candidates.objects,
+      model,
+      signal: input.signal,
+      includeTotal: input.includeTotal
+    });
+    return { ...result, plan };
+  }
   if (plan.mode === "pushdown") {
     if (!options.storage.queryObjects) {
       throw new ObjectQueryPlanningError2(plan.providerIssues);
@@ -1471,6 +1620,7 @@ async function facetObjects2(input, options) {
   const maxRows = options.maxFallbackRows ?? DEFAULT_MAX_FALLBACK_ROWS2;
   const evaluation = await evaluateFallbackQuery(input.projectId, aggregateQuery, options, maxRows);
   return {
+    total: evaluation.entries.length,
     facets: buildFacetResults(evaluation.entries.map((entry) => entry.row), facets),
     plan
   };
@@ -1486,7 +1636,7 @@ function assertQueryViewable(projectId, validated, authorization) {
 function expandPushdownQuery(query, ontology, capabilities, planning, maxExpansionFanout) {
   const ctx = { ontology, maxExpansionFanout };
   const annotated = resolveExpansions(query, ctx);
-  const expanded = expandIncludeSubtypes(annotated, ontology);
+  const expanded = usePrimaryIdLookups(expandIncludeSubtypes(annotated, ontology), ontology);
   if (expanded === annotated)
     return annotated;
   const plan = planObjectQuery2(expanded, { ...planning, capabilities, allowFallback: false });
@@ -1513,6 +1663,7 @@ function resolveExpansions(query, ctx) {
     case "filter":
     case "text":
     case "vector":
+    case "rerank":
     case "traverse":
     case "sort":
     case "limit":
@@ -1592,6 +1743,7 @@ function expandIncludeSubtypes(query, ontology) {
     case "filter":
     case "text":
     case "vector":
+    case "rerank":
     case "traverse":
     case "sort":
     case "limit":
@@ -1678,6 +1830,7 @@ async function evaluateFallbackQuery(projectId, query, options, maxRows) {
     }
     case "text":
     case "vector":
+    case "rerank":
     case "traverse":
     case "set":
       throw new ObjectQueryExecutionError2("fallback_node_not_supported", `Fallback execution does not support query node '${query.kind}'`);
@@ -1968,6 +2121,7 @@ function stripOuterRowShape(query) {
     case "page":
     case "project":
     case "sort":
+    case "rerank":
     case "expand":
       return stripOuterRowShape(query.input);
     default:
@@ -2175,6 +2329,14 @@ function buildExplainNode(query, path) {
         },
         children: [buildExplainNode(query.input, `${path}.input`)]
       };
+    case "rerank":
+      return {
+        path,
+        kind: query.kind,
+        summary: `rerank ${query.model.provider}/${query.model.modelId}`,
+        details: { model: query.model },
+        children: [buildExplainNode(query.input, `${path}.input`)]
+      };
     case "set":
       return {
         path,
@@ -2459,4 +2621,4 @@ async function hydrateLinkQueryObjects(projectId, selected, links, storage) {
 }
 export { validateObjectQuery2, validateObjectQueryWithAdmission, collectObjectQueryValidationIssues2, resolveObjectQueryResultShape2, planObjectQuery2, executeObjectQuery2, countObjects2, existsObjects2, facetObjects2, validateObjectFacetRequests, explainObjectQuery2, preflightObjectQueryLinks, executeObjectQueryLinks2 };
 
-//# debugId=96E245CAF140894464756E2164756E21
+//# debugId=A31A747EB003D67964756E2164756E21