@sixb/core 0.1.15 → 0.1.16

package/dist/webhooks/internal.js

@@ -1,35 +1,35 @@
 // @bun
 import"../chunk-6fsr7y93.js";
 import"../chunk-z3y5kg1x.js";
-import"../chunk-8fjmqjyx.js";
+import"../chunk-69kt9q43.js";
 import"../chunk-v4jbb3rs.js";
-import"../chunk-d8yes9yx.js";
+import"../chunk-swxzncrv.js";
 import {
   createConnectorCodedError,
   getConnectorExecutionSourceResolver
-} from "../chunk-r5sc1d2b.js";
+} from "../chunk-nvymebc1.js";
 import"../chunk-y2aq6ag9.js";
 import"../chunk-fc5zfxy1.js";
-import"../chunk-qne45xqq.js";
-import"../chunk-drz59ve0.js";
+import"../chunk-2xvgy3x5.js";
+import"../chunk-tkdbge6v.js";
 import"../chunk-2jntasmh.js";
 import"../chunk-pqajwytd.js";
-import"../chunk-ky7zpbtt.js";
+import"../chunk-tnvafr7g.js";
 import"../chunk-gfdh9kqa.js";
 import"../chunk-39tqv9hz.js";
 import"../chunk-69266efg.js";
 import"../chunk-xnx96gfy.js";
 import"../chunk-jgwb25gc.js";
 import"../chunk-h89wz928.js";
-import"../chunk-p0nbkys4.js";
+import"../chunk-dp7yk20b.js";
 import {
   ExecutionStorageError2
 } from "../chunk-tw03bsmb.js";
-import"../chunk-3nx8vj5a.js";
+import"../chunk-zvmr2hqk.js";
 import"../chunk-g4rbm4a6.js";
 import {
   canRetryWebhookRun2
-} from "../chunk-fjw417jf.js";
+} from "../chunk-6z1q7j19.js";
 import"../chunk-7ytf06d3.js";
 import"../chunk-mr60an99.js";
 import"../chunk-mmagke4x.js";
@@ -39,20 +39,20 @@ import"../chunk-jmfet9r4.js";
 import {
   WebhookRunError2
 } from "../chunk-qf954wje.js";
-import"../chunk-xr7y35yj.js";
+import"../chunk-667x4drs.js";
 import {
   isOAuthConnectorDefinition2,
   isStaticConnectorDefinition2
 } from "../chunk-9x8dybsb.js";
 import {
   createPrimitiveExecutionRecord
-} from "../chunk-8w27xf9e.js";
+} from "../chunk-7g2gjvah.js";
 import"../chunk-br3k6qbf.js";
 import {
   isStorageSerializationFailure2
 } from "../chunk-zdkcdshk.js";
 import"../chunk-s3csryxe.js";
-import"../chunk-2fv8sajb.js";
+import"../chunk-qnd7ehe5.js";
 // src/webhooks/connections.ts
 function createWebhookConnections(runtime, definition) {
   return {

package/dist/workflows/index.js

@@ -8,13 +8,13 @@ import {
   defineWorkflow2,
   createWorkflowNodeFailure2,
   unwrapWorkflowNodeFailure2
-} from "../chunk-7jc21943.js";
+} from "../chunk-kttr5ftm.js";
 import"../chunk-e1c18xjx.js";
 import"../chunk-fb3feg1e.js";
 import"../chunk-dfm066qg.js";
 import"../chunk-r2y23egw.js";
-import"../chunk-dsfw1bdr.js";
-import"../chunk-ffwvdgk1.js";
+import"../chunk-f72rbvsb.js";
+import"../chunk-nj0020ay.js";
 import"../chunk-9vx5e9g1.js";
 import {
   WorkflowDefinitionError2,
@@ -45,34 +45,34 @@ import {
   snapshotWorkflowActionInput2,
   WorkflowRunDispatcher2,
   requestWorkflowRun2
-} from "../chunk-2tz5vnvz.js";
-import"../chunk-y0zmae99.js";
-import"../chunk-r5sc1d2b.js";
-import"../chunk-adbve9zt.js";
-import"../chunk-mmac1mp6.js";
-import"../chunk-bxx3ms5t.js";
-import"../chunk-py2dw8cw.js";
+} from "../chunk-3q7z9hd4.js";
+import"../chunk-nkbev3tr.js";
+import"../chunk-nvymebc1.js";
+import"../chunk-cxj8y8t0.js";
+import"../chunk-chdg6eqq.js";
+import"../chunk-b9y8hcm2.js";
+import"../chunk-kvysp909.js";
 import"../chunk-f85hpqnm.js";
 import"../chunk-fj1dvp37.js";
-import"../chunk-4jph1t3v.js";
+import"../chunk-40qb8wpe.js";
 import"../chunk-85cd7e8c.js";
-import"../chunk-n5t4mq6z.js";
+import"../chunk-sbcm1b92.js";
 import"../chunk-5a4a52tq.js";
 import"../chunk-91kcnbf0.js";
 import"../chunk-rb143ggb.js";
 import"../chunk-cd234ba4.js";
-import"../chunk-1jvq82rp.js";
-import"../chunk-wem5vqjw.js";
-import"../chunk-z708gemf.js";
-import"../chunk-3c90jvfj.js";
-import"../chunk-8w27xf9e.js";
-import"../chunk-fjw417jf.js";
+import"../chunk-dsv8kdgk.js";
+import"../chunk-8x74221e.js";
+import"../chunk-h4138ww2.js";
+import"../chunk-h044jb97.js";
+import"../chunk-7g2gjvah.js";
+import"../chunk-6z1q7j19.js";
 import"../chunk-br3k6qbf.js";
 import"../chunk-jmfet9r4.js";
 import"../chunk-qf954wje.js";
-import"../chunk-xr7y35yj.js";
+import"../chunk-667x4drs.js";
 import"../chunk-tw03bsmb.js";
-import"../chunk-p0nbkys4.js";
+import"../chunk-dp7yk20b.js";
 import"../chunk-zdkcdshk.js";
 import"../chunk-h89wz928.js";
 import"../chunk-g4rbm4a6.js";
@@ -86,9 +86,9 @@ import"../chunk-69266efg.js";
 import"../chunk-xnx96gfy.js";
 import"../chunk-s3csryxe.js";
 import"../chunk-jgwb25gc.js";
-import"../chunk-ky7zpbtt.js";
+import"../chunk-tnvafr7g.js";
 import"../chunk-pqajwytd.js";
-import"../chunk-3nx8vj5a.js";
+import"../chunk-zvmr2hqk.js";
 import"../chunk-7ytf06d3.js";
 import"../chunk-wr8qp979.js";
 import"../chunk-vjcd8d27.js";
@@ -97,12 +97,12 @@ import"../chunk-39tqv9hz.js";
 import"../chunk-gfdh9kqa.js";
 import"../chunk-dmn70ztd.js";
 import"../chunk-4gmng3vf.js";
-import"../chunk-qne45xqq.js";
-import"../chunk-2fv8sajb.js";
-import"../chunk-drz59ve0.js";
-import"../chunk-8fjmqjyx.js";
+import"../chunk-2xvgy3x5.js";
+import"../chunk-qnd7ehe5.js";
+import"../chunk-tkdbge6v.js";
+import"../chunk-69kt9q43.js";
 import"../chunk-v4jbb3rs.js";
-import"../chunk-d8yes9yx.js";
+import"../chunk-swxzncrv.js";
 import"../chunk-6fsr7y93.js";
 import"../chunk-z3y5kg1x.js";
 import"../chunk-2jntasmh.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sixb/core",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "The ontology-first runtime for Sixb — objects, links, telemetry, actions, and provider contracts",
   "keywords": [
     "sixb",

package/src/models/embedding-model.ts

@@ -7,12 +7,16 @@ import type { ModelCostEstimator, ModelReportedCost } from "./pricing"
 export interface EmbeddingModelDefinition extends ModelDefinition {
   readonly kind: "embedding"
   readonly dimensions: number
+  /** Asymmetric models use distinct document/query modes. Omission means symmetric. */
+  readonly inputMode?: "symmetric" | "asymmetric"
   /** Actual representation behind a routing alias. Omit only when modelId identifies it directly. */
   readonly representation?: { readonly name: string; readonly version?: string }
 }
 
 export interface EmbeddingModelRequest {
   readonly texts: readonly string[]
+  /** Retrieval role. Sixb sets this for indexing and search; symmetric models may ignore it. */
+  readonly purpose?: "document" | "query"
   /** Providers must honor cancellation and propagate this signal to their transport. */
   readonly signal?: AbortSignal
 }
@@ -73,6 +77,13 @@ export function assertEmbeddingModel(model: EmbeddingModel): void {
 export function assertEmbeddingModelRef(model: EmbeddingModelRef): void {
   const definition = model?.definition
   const representation = definition?.representation
+  if (
+    definition?.inputMode !== undefined &&
+    definition.inputMode !== "symmetric" &&
+    definition.inputMode !== "asymmetric"
+  ) {
+    throw new TypeError("[Sixb] Invalid embedding input mode.")
+  }
   if (
     representation !== undefined &&
     (!representation ||
@@ -106,6 +117,7 @@ export function sameEmbeddingModel(left: EmbeddingModelRef, right: EmbeddingMode
     left.providerId === right.providerId &&
     left.modelId === right.modelId &&
     left.definition.dimensions === right.definition.dimensions &&
+    (left.definition.inputMode ?? "symmetric") === (right.definition.inputMode ?? "symmetric") &&
     (left.definition.representation?.name ?? left.modelId) ===
       (right.definition.representation?.name ?? right.modelId) &&
     left.definition.representation?.version === right.definition.representation?.version

package/src/models/execution/embedding.ts

@@ -54,6 +54,10 @@ async function executeEmbedding(
     throw new TypeError("[SixbModels] Embedding inputs must be nonempty strings.")
   }
   const texts = [...input.texts]
+  const purpose = input.purpose
+  if (purpose !== undefined && purpose !== "document" && purpose !== "query") {
+    throw new TypeError("[SixbModels] Embedding purpose must be 'document' or 'query'.")
+  }
   const signal = session.signal(input.signal)
   const requestSignal = AbortSignal.any([signal, AbortSignal.timeout(30_000)])
   requestSignal.throwIfAborted()
@@ -89,7 +93,7 @@ async function executeEmbedding(
   let result: EmbeddingModelResult
   try {
     requestSignal.throwIfAborted()
-    result = await model.embed({ texts, signal: requestSignal })
+    result = await model.embed({ texts, purpose, signal: requestSignal })
   } catch (error) {
     if (error instanceof EmbeddingModelResponseError) {
       await recordEmbedding(accounting, model, callId, error.metadata)

package/src/objects/query/validate.ts

@@ -223,7 +223,7 @@ function validateVectorComposition(query: ObjectQuery, ctx: QueryValidationConte
       path: "$",
       code: "vector.composition",
       message:
-        "Vector profiles support one top-k over one concrete type, with filters before ranking and optional limit/project after it.",
+        "Vector profiles support one top-k over one concrete type, with filters, traversals or sets before ranking and optional limit/project after it.",
     })
 }
 
@@ -923,15 +923,6 @@ function validateVectorProfileQuery(
     )
     return query
   }
-  let input = query.input
-  while (input.kind === "filter") input = input.input
-  if (input.kind !== "start" || input.includeSubtypes)
-    addIssue(
-      ctx,
-      path,
-      "unsupported_vector_composition",
-      "Vector profile input must be a type with optional filters."
-    )
   const objectType = types[0]!
   const profile =
     query.profile === undefined ? undefined : objectType.search?.vectors?.[query.profile]

package/src/objects/vectors/README.md

@@ -2,6 +2,14 @@
 
 A named profile identifies a derived representation, separate from object properties.
 
+Indexing sends embedding purpose `document`; search sends `query`. The execution wrapper preserves
+that role through model resolution, admission and accounting. Symmetric providers may ignore it.
+
+Vector candidates may come from filters, traversals, explicit refs or set operations. Canonical
+validation requires one concrete result type and admits every intermediate type, edge and source
+property. Model lookup uses that resolved result type, not the query's initial type. SQL ranks the
+eligible set after link and property authorization; it never filters a global top-k afterward.
+
 ```text
 Effective object change → invalidate stale vector + persist latest intent (one transaction)
 ProjectionWorker → durable queue → project AI admission → provider → save result → fenced commit

package/src/objects/vectors/handle.ts

@@ -65,7 +65,7 @@ export function createObjectVectorHandle(
       }
 
       // Network work never holds a storage transaction or retries an obsolete computation.
-      const result = await model.embed({ texts: [input.text] })
+      const result = await model.embed({ texts: [input.text], purpose: "document" })
       if (!Array.isArray(result?.vectors) || result.vectors.length !== 1) {
         throw new MaterializationValidationError(
           "Embedding model must return exactly one vector for one input text."

package/src/objects/vectors/indexing-generate.ts

@@ -63,7 +63,11 @@ export async function generateVectors(
       )
     }
 
-    const result = await model.embed({ texts: entries.map((entry) => entry.input.text), signal })
+    const result = await model.embed({
+      texts: entries.map((entry) => entry.input.text),
+      purpose: "document",
+      signal,
+    })
     const values = normalizeEmbeddingResult(
       result,
       entries.length,

package/src/objects/vectors/profile.ts

@@ -13,6 +13,8 @@ export function vectorConfiguration(profile: ObjectVectorSearchProfile): string
     model: profile.model.modelId,
     representation: profile.model.definition.representation ?? { name: profile.model.modelId },
     dimensions: profile.model.definition.dimensions,
+    // Include retrieval preparation without changing existing symmetric identities.
+    ...(profile.model.definition.inputMode === "asymmetric" ? { inputMode: "asymmetric" } : {}),
     metric: "cosine",
     precision: "float32",
     normalization: "l2-v1",

package/src/objects/vectors/query.ts

@@ -6,11 +6,25 @@ export function hasVectorProfile(query: ObjectQuery): boolean {
   return "input" in query && hasVectorProfile(query.input)
 }
 
-/** V1 supports one exact top-k, with filters applied before ranking. */
+/** Rank one eligible object set; validation resolves its type and admits every traversed edge. */
 export function isVectorProfileQuery(query: ObjectQuery): boolean {
   if (query.kind === "limit" || query.kind === "project") return isVectorProfileQuery(query.input)
   if (query.kind !== "vector" || !query.profile) return false
-  let input = query.input
-  while (input.kind === "filter") input = input.input
-  return input.kind === "start" && !input.includeSubtypes
+  return isVectorCandidateQuery(query.input)
+}
+
+function isVectorCandidateQuery(query: ObjectQuery): boolean {
+  switch (query.kind) {
+    case "start":
+      return !query.includeSubtypes
+    case "refs":
+      return true
+    case "filter":
+    case "traverse":
+      return isVectorCandidateQuery(query.input)
+    case "set":
+      return query.inputs.every(isVectorCandidateQuery)
+    default:
+      return false
+  }
 }

package/src/objects/vectors/resolve-query.ts

@@ -3,6 +3,7 @@ import { type EmbeddingModel, sameEmbeddingModel } from "../../models/embedding-
 import type { OntologyRegistry } from "../../ontology"
 import { ObjectQueryExecutionError } from "../query/errors"
 import type { ObjectQuery, ObjectQueryVector } from "../query/ir"
+import { resolveObjectQueryResultShape } from "../query/validate"
 import { normalizeVector } from "./profile"
 
 const QUERY_EMBEDDING_TIMEOUT_MS = 30_000
@@ -30,16 +31,19 @@ function resolveProfileEmbeddingModel(
   ontology: OntologyRegistry,
   models: EmbeddingModelCatalog | undefined
 ): EmbeddingModel {
-  let input = query.input
-  while (input.kind === "filter") input = input.input
-  if (input.kind !== "start" || !query.profile) {
+  const { objectTypeIds } = resolveObjectQueryResultShape(query.input, {
+    ontology,
+    normalize: false,
+  })
+  const objectTypeId = objectTypeIds.length === 1 ? objectTypeIds[0] : undefined
+  if (!objectTypeId || !query.profile) {
     throw new ObjectQueryExecutionError(
       "embedding_model_unavailable",
       "Vector search requires the embedding model registered for its profile."
     )
   }
 
-  const profile = ontology.resolveObjectType(input.objectTypeId).search?.vectors?.[query.profile]
+  const profile = ontology.resolveObjectType(objectTypeId).search?.vectors?.[query.profile]
   if (!profile) {
     throw new ObjectQueryExecutionError(
       "embedding_model_unavailable",
@@ -69,7 +73,7 @@ async function embedSearchText(
   const timeout = AbortSignal.timeout(QUERY_EMBEDDING_TIMEOUT_MS)
   const requestSignal = signal ? AbortSignal.any([signal, timeout]) : timeout
   requestSignal.throwIfAborted()
-  const result = await model.embed({ texts: [text], signal: requestSignal })
+  const result = await model.embed({ texts: [text], purpose: "query", signal: requestSignal })
   requestSignal.throwIfAborted()
 
   if (!Array.isArray(result?.vectors) || result.vectors.length !== 1) {

package/src/objects/vectors/types.ts

@@ -2,7 +2,9 @@ import type { ObjectType } from "../../ontology"
 
 export type VectorProfileName<T extends ObjectType> = T extends { search: { vectors: infer P } }
   ? Extract<keyof P, string>
-  : never
+  : string extends T["id"]
+    ? string
+    : never
 
 export interface ObjectVectorHandle {
   /** Generate and atomically store this profile using its configured model. Conflicts are not retried. */

package/src/ontology/builders.ts

@@ -35,6 +35,7 @@ import type {
   ObjectLink,
   ObjectLinkTargetMetadata,
   ObjectType,
+  ObjectVectorSearchProfile,
   Ontology,
   Property,
   PropertyMode,
@@ -446,19 +447,32 @@ export type DirectLinkResult<
 > = LinkResult<TId, TTargetObjectTypeId, TOptions> & ObjectLinkTargetMetadata<TTarget>
 
 type ObjectTypeIdArray<TTargets extends readonly ObjectType[]> = Array<TTargets[number]["id"]>
+/** Keep profile names without carrying provider types through every linked declaration. */
 export type DirectLinkTarget<
   TId extends string,
   TName extends string,
   TProperties extends Property[],
-> = ObjectTypeWithPropertyTokens<{
-  id: TId
-  name: TName
-  properties: TProperties
-  links: ObjectLink[]
-}>
+  TVectorProfiles extends string = never,
+> = ObjectTypeWithPropertyTokens<
+  {
+    id: TId
+    name: TName
+    properties: TProperties
+    links: ObjectLink[]
+  } & ([TVectorProfiles] extends [never]
+    ? unknown
+    : { search: { vectors: Record<TVectorProfiles, ObjectVectorSearchProfile> } })
+>
 
 type DirectLinkTargetFor<TTarget extends ObjectType> = TTarget extends ObjectTypeWithPropertyTokens
-  ? DirectLinkTarget<TTarget["id"], TTarget["name"], TTarget["properties"]>
+  ? DirectLinkTarget<
+      TTarget["id"],
+      TTarget["name"],
+      TTarget["properties"],
+      TTarget extends { search: { vectors: infer TProfiles } }
+        ? Extract<keyof TProfiles, string>
+        : never
+    >
   : TTarget
 
 /**

package/src/ontology/vector-profiles.ts

@@ -17,6 +17,7 @@ export function snapshotVectorProfiles(
           providerId,
           modelId,
           dimensions: definition.dimensions,
+          ...(definition.inputMode ? { inputMode: definition.inputMode } : {}),
           ...(definition.representation
             ? {
                 representation: Object.freeze({