@sixb/core 0.1.11 → 0.1.12

package/dist/chunk-69266efg.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/storage/agents/provider.ts", "../src/agents/types.ts", "../src/storage/agents/errors.ts"],
+  "sourcesContent": [
+    "import { isDeepStrictEqual } from \"node:util\"\nimport { AGENT_REASONING_LEVELS } from \"../../agents/types\"\nimport { isFileRef } from \"../../blob-storage\"\nimport { isJsonObject, isPlainRecord } from \"../../json\"\nimport { isModelReasoning } from \"../../models/language-model\"\nimport type { ExecutionRecord, ExecutionStorage } from \"../executions\"\nimport { findAgentRunExecution } from \"../executions/run-link\"\nimport { AgentStorageError } from \"./errors\"\nimport type {\n  AgentContextCheckpointRecord,\n  AgentMessageRecord,\n  AgentRunRecord,\n  AgentThreadRecord,\n  AgentThreadSandboxParams,\n  AgentThreadSandboxState,\n  ConversationAgentRunSpec,\n  CreateAgentContextCheckpointInput,\n  CreateSubagentRunInput,\n  SubagentRunRecord,\n  SubagentRunResult,\n  TransitionAgentThreadSandboxInput,\n} from \"./types\"\n\n/** Shared state machine. Providers must lock the run, then thread, around this decision/write. */\nexport function transitionAgentThreadSandbox(\n  thread: AgentThreadRecord | null,\n  run: AgentRunRecord | null,\n  input: TransitionAgentThreadSandboxInput\n): AgentThreadSandboxState {\n  const fail = (message: string): never => {\n    throw new AgentStorageError(\"invalid_state\", `[Sixb] Sandbox ${message}`)\n  }\n  if (!thread?.sandboxParams) return fail(\"is not configured on this thread.\")\n  if (!/^[a-zA-Z0-9-]{1,80}$/.test(input.name)) return fail(\"name is invalid.\")\n  const state = thread.sandboxState\n  if (input.action === \"recreate\") {\n    if (thread.activeRunId !== null) return fail(\"cannot be recreated during an active run.\")\n    if (!state || state.name !== input.expectedSandboxName || input.name === state.name)\n      return fail(\"changed; reload before recreating.\")\n    if (![\"busy\", \"blocked\", \"unavailable\"].includes(state.status)) {\n      return fail(\"does not require recovery.\")\n    }\n    return {\n      name: input.name,\n      status: \"new\",\n      initialized: false,\n      resetAt: new Date().toISOString(),\n    }\n  }\n  if (\n    run?.kind !== \"conversation\" ||\n    run.threadId !== thread.id ||\n    run.status !== \"running\" ||\n    thread.activeRunId !== run.id ||\n    run.id !== input.runId ||\n    run.execution?.token !== input.executionToken ||\n    run.execution.queueLeaseExpiresAt.getTime() <= Date.now()\n  ) {\n    throw new AgentStorageError(\"execution_lost\", \"[Sixb] Sandbox execution ownership was lost.\")\n  }\n  if (input.action === \"acquire\") {\n    if (state && state.status !== \"new\" && state.status !== \"ready\") {\n      return fail(\"requires recovery; previous operations may still be in flight.\")\n    }\n    if (state && state.name !== input.name) return fail(\"name changed.\")\n    if (!/^[a-f0-9]{64}$/.test(input.sourceFingerprint))\n      return fail(\"source fingerprint is invalid.\")\n    if (state?.sourceFingerprint && state.sourceFingerprint !== input.sourceFingerprint) {\n      return fail(\"source identity changed; the existing checkout was not opened.\")\n    }\n    return {\n      name: input.name,\n      status: \"busy\",\n      initialized: state?.initialized ?? false,\n      ...(state?.resetAt ? { resetAt: state.resetAt } : {}),\n      sourceFingerprint: input.sourceFingerprint,\n      owner: { runId: input.runId, executionToken: input.executionToken },\n    }\n  }\n  if (\n    state?.status !== \"busy\" ||\n    state.name !== input.name ||\n    state.owner?.runId !== input.runId ||\n    state.owner.executionToken !== input.executionToken\n  ) {\n    return fail(\"is not owned by this execution.\")\n  }\n  if (input.action === \"replace\") {\n    if (\n      !state.initialized ||\n      input.nextName === state.name ||\n      !/^[a-zA-Z0-9-]{1,80}$/.test(input.nextName)\n    ) {\n      return fail(\"replacement requires initialized state and a fresh valid name.\")\n    }\n    // Only the owning worker may report confirmed loss; retain its fence across replacement.\n    return {\n      ...state,\n      name: input.nextName,\n      initialized: false,\n      resetAt: new Date().toISOString(),\n    }\n  }\n  if (input.status === \"ready\" && !input.initialized) return fail(\"initialization is incomplete.\")\n  return {\n    name: state.name,\n    status: input.status,\n    initialized: input.initialized,\n    sourceFingerprint: state.sourceFingerprint,\n    ...(state.resetAt ? { resetAt: state.resetAt } : {}),\n  }\n}\n\n/** Snapshot application parameters independently of worker-owned sandbox state. */\nexport function snapshotAgentThreadSandboxParams(value: unknown): AgentThreadSandboxParams {\n  if (!isPlainRecord(value) || !isJsonObject(value)) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      \"[Sixb] Thread sandbox must contain only JSON params.\"\n    )\n  }\n  return structuredClone(value)\n}\n\n/** Validate the provider-neutral model selection captured for a conversational turn. */\nexport function assertConversationAgentRunSpec(\n  spec: ConversationAgentRunSpec,\n  prefix = \"Sixb\"\n): void {\n  if (!isRecord(spec) || !isRecord(spec.model)) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Conversational Agent run spec must contain a model reference.`\n    )\n  }\n  for (const [name, value] of [\n    [\"model.provider\", spec.model.provider],\n    [\"model.modelId\", spec.model.modelId],\n  ] as const) {\n    if (typeof value !== \"string\" || value.trim().length === 0) {\n      throw new AgentStorageError(\n        \"invalid_input\",\n        `[${prefix}] Conversational Agent run '${name}' must not be empty.`\n      )\n    }\n  }\n  if (spec.reasoning !== undefined && !isModelReasoning(spec.reasoning)) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Conversational Agent reasoning must be one of: ${AGENT_REASONING_LEVELS.join(\", \")}, or a nonnegative budgetTokens object.`\n    )\n  }\n}\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n}\n\n/** Validate the semantic link between a conversational Agent run and its immutable execution. */\nexport async function assertAgentRunExecution(input: {\n  readonly executions: ExecutionStorage\n  readonly projectId: string\n  readonly executionId: string\n  readonly runId: string\n}): Promise<ExecutionRecord> {\n  const execution = await findAgentRunExecution({\n    executions: input.executions,\n    projectId: input.projectId,\n    executionId: input.executionId,\n    runId: input.runId,\n    authority: { type: \"inherited\" },\n  })\n  if (!execution) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[Sixb] Execution '${input.executionId}' does not authorize Agent run '${input.runId}'.`\n    )\n  }\n  return execution\n}\n\n/** Validate the provider-neutral payload of an idempotent child admission. */\nexport function assertCreateSubagentRunInput(input: CreateSubagentRunInput, prefix = \"Sixb\"): void {\n  for (const [name, value] of [\n    [\"id\", input.id],\n    [\"projectId\", input.projectId],\n    [\"executionId\", input.executionId],\n    [\"parentRunId\", input.parentRunId],\n    [\"parentExecutionToken\", input.parentExecutionToken],\n    [\"spawnKey\", input.spawnKey],\n    [\"model.provider\", input.spec.model.provider],\n    [\"model.modelId\", input.spec.model.modelId],\n    [\"task\", input.spec.task],\n  ] as const) {\n    if (value.trim().length === 0) {\n      throw new AgentStorageError(\n        \"invalid_input\",\n        `[${prefix}] Subagent run '${name}' must not be empty.`\n      )\n    }\n  }\n  if (input.spawnKey.length > 128) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Subagent spawn key must not exceed 128 characters.`\n    )\n  }\n  for (const [name, value] of [\n    [\"maxActiveChildren\", input.maxActiveChildren],\n    [\"spec.maxSteps\", input.spec.maxSteps],\n  ] as const) {\n    if (!Number.isSafeInteger(value) || value < 1) {\n      throw new AgentStorageError(\n        \"invalid_input\",\n        `[${prefix}] Subagent run '${name}' must be a positive safe integer.`\n      )\n    }\n  }\n  if (new Set(input.spec.toolNames).size !== input.spec.toolNames.length) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Subagent run tool names must be unique.`\n    )\n  }\n  if (input.spec.reasoning !== undefined && !isModelReasoning(input.spec.reasoning)) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Subagent reasoning must be one of: ${AGENT_REASONING_LEVELS.join(\", \")}, or a nonnegative budgetTokens object.`\n    )\n  }\n  if (input.spec.toolNames.some((name) => !name.trim())) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Subagent run tool names must not be empty.`\n    )\n  }\n  if (input.createdAt && !Number.isFinite(input.createdAt.getTime())) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Subagent run createdAt must be a valid date.`\n    )\n  }\n}\n\n/** Exact semantic match required when a durable spawn key is replayed. */\nexport function subagentRunMatchesCreateInput(\n  run: AgentRunRecord,\n  input: CreateSubagentRunInput\n): run is SubagentRunRecord {\n  return (\n    run.kind === \"subagent\" &&\n    run.id === input.id &&\n    run.projectId === input.projectId &&\n    run.executionId === input.executionId &&\n    run.parentRunId === input.parentRunId &&\n    run.spawnKey === input.spawnKey &&\n    isDeepStrictEqual(run.spec, input.spec)\n  )\n}\n\n/** Validate the small durable result returned by a successful child. */\nexport function assertSubagentRunResult(\n  result: SubagentRunResult | undefined,\n  runId: string,\n  prefix = \"Sixb\"\n): asserts result is SubagentRunResult {\n  const text = result?.text\n  const files = result?.files\n  const hasText = typeof text === \"string\" && text.trim().length > 0\n  const hasFiles = Array.isArray(files) && files.length > 0 && files.every(isFileRef)\n  if (!result || (!hasText && !hasFiles)) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Succeeded subagent run '${runId}' requires text or files.`\n    )\n  }\n  if ((text !== undefined && !hasText) || (files !== undefined && !hasFiles)) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Subagent run '${runId}' has an invalid result.`\n    )\n  }\n}\n\n/** Validate provider-independent checkpoint fields before entering a storage critical section. */\nexport function assertCreateAgentContextCheckpointInput(\n  input: CreateAgentContextCheckpointInput,\n  prefix = \"Sixb\"\n): void {\n  for (const [name, value] of [\n    [\"id\", input.id],\n    [\"projectId\", input.projectId],\n    [\"threadId\", input.threadId],\n    [\"createdByRunId\", input.createdByRunId],\n    [\"executionToken\", input.executionToken],\n    [\"summary\", input.summary],\n    [\"summaryModelId\", input.summaryModelId],\n  ] as const) {\n    if (value.trim().length === 0) {\n      throw new AgentStorageError(\n        \"invalid_input\",\n        `[${prefix}] Agent context checkpoint '${name}' must not be empty.`\n      )\n    }\n  }\n\n  if (input.summaryFormatVersion !== 1) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint summary format version must be 1.`\n    )\n  }\n  if (input.reason !== \"threshold\" && input.reason !== \"overflow\") {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint reason must be 'threshold' or 'overflow'.`\n    )\n  }\n  if (\n    input.expectedPreviousCheckpointId !== null &&\n    input.expectedPreviousCheckpointId.trim().length === 0\n  ) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint expected previous id must not be empty.`\n    )\n  }\n  if (input.createdAt && !Number.isFinite(input.createdAt.getTime())) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint createdAt must be a valid date.`\n    )\n  }\n\n  for (const [name, value, minimum] of [\n    [\"expectedHeadSeq\", input.expectedHeadSeq, 1],\n    [\"summarizedThroughSeq\", input.summarizedThroughSeq, 1],\n    [\"observedHeadSeq\", input.observedHeadSeq, 1],\n    [\"estimatedInputTokensBefore\", input.estimatedInputTokensBefore, 0],\n    [\"estimatedInputTokensAfter\", input.estimatedInputTokensAfter, 0],\n  ] as const) {\n    if (!Number.isSafeInteger(value) || value < minimum) {\n      throw new AgentStorageError(\n        \"invalid_input\",\n        `[${prefix}] Agent context checkpoint '${name}' must be a safe integer greater than or equal to ${minimum}.`\n      )\n    }\n  }\n\n  if (input.observedHeadSeq !== input.expectedHeadSeq) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint observed head must equal its expected message head.`\n    )\n  }\n  if (input.summarizedThroughSeq >= input.observedHeadSeq) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint must retain the triggering head message.`\n    )\n  }\n}\n\n/** Assert that the current delivery still owns the active conversational run. */\nexport function assertAgentContextCheckpointAuthority(input: {\n  readonly create: CreateAgentContextCheckpointInput\n  readonly run: AgentRunRecord | null\n  readonly thread: AgentThreadRecord | null\n  readonly prefix?: string\n}): asserts input is typeof input & {\n  readonly run: AgentRunRecord\n  readonly thread: AgentThreadRecord\n} {\n  const { create, run, thread } = input\n  const prefix = input.prefix ?? \"Sixb\"\n  if (!run) {\n    throw new AgentStorageError(\n      \"run_not_found\",\n      `[${prefix}] Agent run '${create.createdByRunId}' not found for project '${create.projectId}'.`\n    )\n  }\n  if (!thread) {\n    throw new AgentStorageError(\n      \"thread_not_found\",\n      `[${prefix}] Agent thread '${create.threadId}' not found for project '${create.projectId}'.`\n    )\n  }\n  if (run.kind !== \"conversation\" || run.threadId !== create.threadId) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent run '${run.id}' does not belong to thread '${create.threadId}'.`\n    )\n  }\n  if (run.status !== \"running\") {\n    throw new AgentStorageError(\n      \"invalid_state\",\n      `[${prefix}] Agent run '${run.id}' is not running (status '${run.status}').`\n    )\n  }\n  if (!run.execution || run.execution.token !== create.executionToken) {\n    throw new AgentStorageError(\n      \"execution_lost\",\n      `[${prefix}] Execution token is no longer current on agent run '${run.id}'.`\n    )\n  }\n  if (thread.activeRunId !== run.id) {\n    throw new AgentStorageError(\n      \"invalid_state\",\n      `[${prefix}] Agent run '${run.id}' no longer owns thread '${thread.id}'.`\n    )\n  }\n}\n\n/** Assert both compare-and-swap anchors and the retained-turn boundary. */\nexport function assertAgentContextCheckpointAnchors(input: {\n  readonly create: CreateAgentContextCheckpointInput\n  readonly latest: AgentContextCheckpointRecord | null\n  readonly headSeq: number\n  readonly firstRetained: AgentMessageRecord | null\n  readonly prefix?: string\n}): void {\n  const { create, latest, headSeq, firstRetained } = input\n  const prefix = input.prefix ?? \"Sixb\"\n  if (headSeq !== create.expectedHeadSeq) {\n    throw new AgentStorageError(\n      \"invalid_state\",\n      `[${prefix}] Agent thread '${create.threadId}' message head changed from ${create.expectedHeadSeq} to ${headSeq}.`\n    )\n  }\n\n  const latestId = latest?.id ?? null\n  if (latestId !== create.expectedPreviousCheckpointId) {\n    throw new AgentStorageError(\n      \"invalid_state\",\n      `[${prefix}] Agent thread '${create.threadId}' checkpoint head changed.`\n    )\n  }\n  if (latest && create.summarizedThroughSeq <= latest.summarizedThroughSeq) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint boundary must advance beyond sequence ${latest.summarizedThroughSeq}.`\n    )\n  }\n  if (!firstRetained || firstRetained.seq !== create.summarizedThroughSeq + 1) {\n    throw new AgentStorageError(\n      \"invalid_state\",\n      `[${prefix}] Agent context checkpoint boundary does not align with stored thread messages.`\n    )\n  }\n  if (firstRetained.role !== \"user\") {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint must retain a complete turn beginning with a user message.`\n    )\n  }\n}\n\n/** Validate the mutable anchors again before returning an idempotently created checkpoint. */\nexport function assertAgentContextCheckpointReplayState(input: {\n  readonly create: CreateAgentContextCheckpointInput\n  readonly existing: AgentContextCheckpointRecord\n  readonly latest: AgentContextCheckpointRecord | null\n  readonly headSeq: number\n  readonly prefix?: string\n}): void {\n  const prefix = input.prefix ?? \"Sixb\"\n  if (input.headSeq !== input.create.expectedHeadSeq) {\n    throw new AgentStorageError(\n      \"invalid_state\",\n      `[${prefix}] Agent thread '${input.create.threadId}' message head changed from ${input.create.expectedHeadSeq} to ${input.headSeq}.`\n    )\n  }\n  if (input.latest?.id !== input.existing.id) {\n    throw new AgentStorageError(\n      \"invalid_state\",\n      `[${prefix}] Agent thread '${input.create.threadId}' checkpoint head changed after '${input.existing.id}'.`\n    )\n  }\n}\n\n/** Compare the durable semantic payload; delivery token and generated timestamp are not content. */\nexport function agentContextCheckpointMatchesCreateInput(\n  record: AgentContextCheckpointRecord,\n  input: CreateAgentContextCheckpointInput\n): boolean {\n  return (\n    record.id === input.id &&\n    record.projectId === input.projectId &&\n    record.threadId === input.threadId &&\n    record.createdByRunId === input.createdByRunId &&\n    (record.previousCheckpointId ?? null) === input.expectedPreviousCheckpointId &&\n    record.reason === input.reason &&\n    record.summary === input.summary &&\n    record.summaryFormatVersion === input.summaryFormatVersion &&\n    record.summarizedThroughSeq === input.summarizedThroughSeq &&\n    record.observedHeadSeq === input.observedHeadSeq &&\n    record.estimatedInputTokensBefore === input.estimatedInputTokensBefore &&\n    record.estimatedInputTokensAfter === input.estimatedInputTokensAfter &&\n    record.summaryModelId === input.summaryModelId\n  )\n}\n",
+    "import type { BlobBody, FileRef } from \"../blob-storage\"\nimport type { ConnectorRuntime } from \"../connectors\"\nimport type { JsonPrimitive, JsonValue, ReadonlyJsonValue } from \"../json\"\nimport type { Logger } from \"../logging\"\nimport { type LanguageModelRef, MODEL_REASONING_LEVELS, type ModelReasoning } from \"../models\"\nimport type { InferSchema } from \"../ontology/inference\"\nimport type { Schema } from \"../ontology/types\"\n\nexport type {\n  AgentContextEntryInput,\n  AgentContextInput,\n  AgentContextOrigin,\n  AgentContextPart,\n} from \"./context/entries\"\n\n/** Public capability reference used by security grants such as `can.run(agent)`. */\nexport interface AgentReference {\n  readonly kind: \"agent\"\n  readonly usage: AgentUsageReference\n}\n\n/** Project-wide AI accounting and limit capability, independent of permission to run the Agent. */\nexport interface AgentUsageReference {\n  readonly kind: \"aiUsage\"\n}\n\n/** Public metadata for the project's conversational Agent. */\nexport interface AgentDescriptor {\n  readonly name: string\n  readonly model: LanguageModelRef\n}\n\nexport type AgentReasoning = ModelReasoning\n\n/** @deprecated Use {@link AgentReasoning}. */\nexport type AgentReasoningLevel = AgentReasoning\n\nexport const AGENT_REASONING_LEVELS = MODEL_REASONING_LEVELS\n\ntype Simplify<T> = { [K in keyof T]: T[K] } & {}\ntype JsonifyAgentToolInput<T> = unknown extends T\n  ? ReadonlyJsonValue\n  : T extends Date\n    ? string\n    : T extends readonly (infer TItem)[]\n      ? readonly JsonifyAgentToolInput<TItem>[]\n      : T extends JsonPrimitive\n        ? T\n        : T extends object\n          ? { readonly [K in keyof T]: JsonifyAgentToolInput<T[K]> }\n          : never\n\n/** A model-facing object shape expressed with Sixb's schema DSL. */\nexport type AgentToolInputSchema = Readonly<Record<string, Schema>>\n\n/** Infer the handler input represented by an agent tool schema. */\nexport type InferAgentToolInputSchema<TInput extends AgentToolInputSchema> =\n  string extends keyof TInput\n    ? Readonly<Record<string, unknown>>\n    : Simplify<{\n        readonly [K in keyof TInput]: JsonifyAgentToolInput<InferSchema<TInput[K]>>\n      }>\n\n/** Identifies the conversational, workflow, or child Agent execution that invoked a tool. */\nexport type AgentToolRunInfo =\n  | {\n      readonly kind: \"conversation\"\n      readonly id: string\n      readonly threadId: string\n    }\n  | {\n      readonly kind: \"subagent\"\n      readonly id: string\n      readonly parentRunId: string\n    }\n  | {\n      readonly kind: \"workflow\"\n      readonly id: string\n      readonly workflowId: string\n      readonly stepId: string\n    }\n\n/** Input accepted by the run-scoped artifact publisher exposed to agent tools. */\nexport interface AgentToolArtifactPutInput {\n  readonly body: BlobBody\n  readonly fileName: string\n  readonly mediaType?: string\n}\n\n/** A durable artifact and its path inside the current run sandbox. */\nexport interface AgentToolArtifact {\n  readonly fileRef: FileRef\n  readonly sandboxPath: string\n}\n\n/** The narrow artifact-writing surface available to an agent tool call. */\nexport interface AgentToolArtifacts {\n  put(input: AgentToolArtifactPutInput): Promise<AgentToolArtifact>\n}\n\nexport type AgentToolTextContent = {\n  readonly type: \"text\"\n  readonly text: string\n}\n\nexport type AgentToolFileContent = {\n  readonly type: \"file\"\n  readonly fileRef: FileRef\n}\n\n/** Durable model-facing content returned by a file-aware tool. */\nexport type AgentToolContent = AgentToolTextContent | AgentToolFileContent\n\n/**\n * A file-aware tool result. The tag distinguishes this envelope from an ordinary JSON result while\n * keeping the whole value safe to persist in the durable tool-call trace.\n */\nexport type AgentToolResult = {\n  readonly kind: \"agentToolResult\"\n  readonly content: readonly AgentToolContent[]\n}\n\n/** The narrow, run-scoped surface passed to an agent tool handler. */\nexport interface AgentToolRunContext<\n  TInput extends Readonly<Record<string, unknown>> = Readonly<Record<string, unknown>>,\n> {\n  readonly input: TInput\n  readonly toolCallId: string\n  readonly signal: AbortSignal\n  readonly run: AgentToolRunInfo\n  readonly connector: ConnectorRuntime\n  readonly logger: Logger\n  readonly artifacts: AgentToolArtifacts\n}\n\n/** Agent tool handlers may return only values safe to persist in agent messages. */\nexport type AgentToolHandlerResult =\n  | ReadonlyJsonValue\n  | AgentToolResult\n  | Promise<ReadonlyJsonValue | AgentToolResult>\n\nexport type AgentToolHandler<TInput extends Readonly<Record<string, unknown>>> = (\n  context: AgentToolRunContext<TInput>\n) => AgentToolHandlerResult\n\n/**\n * Runtime definitions are stored heterogeneously. Keep variance erasure at this\n * boundary only; authoring through `run()` remains strictly contravariant.\n */\ntype StoredAgentToolHandler<TInput extends Readonly<Record<string, unknown>>> = {\n  bivarianceHack(context: AgentToolRunContext<TInput>): JsonValue | Promise<JsonValue>\n}[\"bivarianceHack\"]\n\n/** A reusable, inert model tool definition selected explicitly by an agent. */\nexport interface AgentToolDefinition<\n  TName extends string = string,\n  TInput extends AgentToolInputSchema = AgentToolInputSchema,\n> {\n  readonly kind: \"agentTool\"\n  readonly name: TName\n  readonly description: string\n  readonly input: TInput\n  readonly handler: StoredAgentToolHandler<InferAgentToolInputSchema<TInput>>\n}\n\n/** Infer the input received by a tool definition's handler. */\nexport type InferAgentToolInput<TTool extends AgentToolDefinition> = InferAgentToolInputSchema<\n  TTool[\"input\"]\n>\n\nexport interface AgentToolRunBuilder<TName extends string, TInput extends AgentToolInputSchema> {\n  run(\n    handler: AgentToolHandler<InferAgentToolInputSchema<TInput>>\n  ): AgentToolDefinition<TName, TInput>\n}\n\nexport interface AgentToolInputBuilder<TName extends string> {\n  input<const TInput extends AgentToolInputSchema>(\n    input: TInput\n  ): AgentToolRunBuilder<TName, TInput>\n}\n\nexport interface AgentToolDescriptionBuilder<TName extends string> {\n  description(description: string): AgentToolInputBuilder<TName>\n}\n",
+    "export type AgentStorageErrorCode =\n  | \"thread_not_found\"\n  | \"active_run_exists\"\n  | \"active_child_limit\"\n  | \"run_not_found\"\n  | \"invalid_input\"\n  | \"invalid_state\"\n  | \"execution_lost\"\n  | \"duplicate_id\"\n\n/**\n * Error for agent-storage invariants and invalid state transitions (single-flight, execution\n * ownership, run lifecycle, message append). Callers branch on `code` rather than message text.\n */\nexport class AgentStorageError extends Error {\n  readonly name = \"AgentStorageError\"\n\n  constructor(\n    readonly code: AgentStorageErrorCode,\n    message: string\n  ) {\n    super(message)\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "D063548BEBDA9CF264756E2164756E21",
+  "names": []
+}

package/dist/{chunk-a0e6x5hd.js → chunk-6ma8dvzc.js}

@@ -3,24 +3,32 @@ import {
   MAX_OBJECT_READ_FACETS2,
   isAllowed2,
   assertAuthorized2
-} from "./chunk-dz5h08xv.js";
+} from "./chunk-bbaa1fet.js";
 import {
   validateSchemaValue2,
   validatePropertyValue2
-} from "./chunk-ms2tmn1k.js";
+} from "./chunk-vsg0g7h9.js";
 import {
+  hasVectorProfile2,
+  isVectorProfileQuery2,
   objectBatchKey2,
   linkBatchKey2,
   objectLinkCursor2,
   compareQueryScalarValues,
-  queryScalarValuesEqual
-} from "./chunk-gqm76kse.js";
+  queryScalarValuesEqual,
+  MAX_VECTOR_K,
+  vectorConfiguration,
+  normalizeVector2
+} from "./chunk-ybhz3j9g.js";
 import {
   ObjectQueryValidationError2,
   ObjectQueryPlanningError2,
   ObjectQueryExecutionError2,
   normalizeObjectQuery2
-} from "./chunk-5hz0fnca.js";
+} from "./chunk-4k53sm9e.js";
+import {
+  sameEmbeddingModel
+} from "./chunk-p1683c0v.js";
 import {
   formatUnknownObjectTypeMessage
 } from "./chunk-cqr3acm1.js";
@@ -30,6 +38,56 @@ import {
 import {
   stableJsonStringify2
 } from "./chunk-wy0qdqfm.js";
+// src/objects/vectors/resolve-query.ts
+var QUERY_EMBEDDING_TIMEOUT_MS = 30000;
+async function resolveVectorSearchText(query, ontology, models, signal) {
+  if (query.kind === "limit" || query.kind === "project") {
+    const input = await resolveVectorSearchText(query.input, ontology, models, signal);
+    return { ...query, input };
+  }
+  if (query.kind !== "vector" || typeof query.vector !== "string")
+    return query;
+  const model = resolveProfileEmbeddingModel(query, ontology, models);
+  const vector = await embedSearchText(query.vector, model, signal);
+  return { ...query, vector };
+}
+function resolveProfileEmbeddingModel(query, ontology, models) {
+  let input = query.input;
+  while (input.kind === "filter")
+    input = input.input;
+  if (input.kind !== "start" || !query.profile) {
+    throw new ObjectQueryExecutionError2("embedding_model_unavailable", "Vector search requires the embedding model registered for its profile.");
+  }
+  const profile = ontology.resolveObjectType(input.objectTypeId).search?.vectors?.[query.profile];
+  if (!profile) {
+    throw new ObjectQueryExecutionError2("embedding_model_unavailable", "Vector search requires the embedding model registered for its profile.");
+  }
+  const model = models?.getByRef({
+    provider: profile.model.providerId,
+    modelId: profile.model.modelId
+  })?.model;
+  if (!model || !sameEmbeddingModel(model, profile.model)) {
+    throw new ObjectQueryExecutionError2("embedding_model_unavailable", "Vector search requires the embedding model registered for its profile.");
+  }
+  return model;
+}
+async function embedSearchText(text, model, signal) {
+  const dimensions = model.definition.dimensions;
+  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 });
+  requestSignal.throwIfAborted();
+  if (!Array.isArray(result?.vectors) || result.vectors.length !== 1) {
+    throw new ObjectQueryExecutionError2("invalid_embedding_response", "Embedding model must return exactly one vector for the search text.");
+  }
+  try {
+    return normalizeVector2(result.vectors[0], dimensions);
+  } catch {
+    throw new ObjectQueryExecutionError2("invalid_embedding_response", "Embedding model returned an invalid vector for the search profile.");
+  }
+}
+
 // src/objects/query/planner.ts
 var DEFAULT_MAX_FALLBACK_ROWS = 1000;
 var fallbackNodeKinds = new Set([
@@ -354,6 +412,7 @@ function validateObjectQuery2(query, options) {
 function validateObjectQueryWithAdmission(query, options, admission) {
   const normalized = options.normalize === false ? query : normalizeObjectQuery2(query);
   const ctx = createValidationContext(options, admission);
+  validateVectorComposition(query, ctx);
   const validation = validateQueryNode(normalized, "$", ctx);
   if (ctx.issues.length > 0) {
     throw new ObjectQueryValidationError2(ctx.issues);
@@ -371,12 +430,21 @@ function validateObjectQueryWithAdmission(query, options, admission) {
 function collectObjectQueryValidationIssues2(query, options) {
   const normalized = options.normalize === false ? query : normalizeObjectQuery2(query);
   const ctx = createValidationContext(options, NOOP_QUERY_ADMISSION);
+  validateVectorComposition(query, ctx);
   validateQueryNode(normalized, "$", ctx);
   return ctx.issues;
 }
 function resolveObjectQueryResultShape2(query, options) {
   return validateObjectQuery2(query, options).result;
 }
+function validateVectorComposition(query, ctx) {
+  if (hasVectorProfile2(query) && !isVectorProfileQuery2(query))
+    ctx.issues.push({
+      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."
+    });
+}
 function createValidationContext(options, admission) {
   return {
     ontology: options.ontology,
@@ -448,10 +516,9 @@ function dispatchQueryNode(query, path, ctx) {
     }
     case "vector": {
       const input = validateQueryNode(query.input, `${path}.input`, ctx);
-      validateVectorQuery(query.vector, query.propertyId, query.k, input.result, input.admissionState, path, ctx);
       return {
         result: input.result,
-        query: { ...query, input: input.query },
+        query: validateVectorProfileQuery({ ...query, input: input.query }, input.result, input.admissionState, path, ctx),
         admissionState: input.admissionState
       };
     }
@@ -775,39 +842,43 @@ function validateTextQuery(query, fields, shape, admissionState, path, ctx) {
   }
   return fieldsByObjectType ? { fieldsByObjectType } : {};
 }
-function validateVectorQuery(vector, propertyId, k, shape, admissionState, path, ctx) {
-  if (!Number.isInteger(k) || k <= 0) {
-    addIssue2(ctx, path, "invalid_vector_k", "Vector query k must be a positive integer");
-  }
-  if (vector.length === 0) {
-    addIssue2(ctx, path, "empty_vector", "Vector query vector must not be empty");
-  }
-  if (vector.some((value) => typeof value !== "number" || !Number.isFinite(value))) {
-    addIssue2(ctx, path, "invalid_vector_value", "Vector query vector values must be finite numbers");
-  }
-  for (const objectType of getObjectTypesForResult(shape, ctx)) {
-    admitProperty(ctx, {
-      state: admissionState,
-      propertyId,
-      objectTypeId: objectType.id,
-      use: "vector",
-      path
-    });
-    const property = getProperty(objectType, propertyId);
-    if (!property) {
-      addIssue2(ctx, path, "unknown_vector_property", `Vector query references unknown property '${propertyId}' on '${objectType.id}'`);
-      continue;
-    }
-    assertStaticSearchProperty(objectType.id, property, "vector query", path, ctx);
-    assertQueryFlag(objectType.id, property, "vector", "vector query", path, ctx);
-    if (objectType.search?.vector?.property !== propertyId) {
-      addIssue2(ctx, path, "vector_profile_missing", `Object type '${objectType.id}' must declare search.vector.property '${propertyId}' before vector search can use it`);
-    }
-    const schema = resolveSchemaForProperty(property, objectType.id, ctx, path);
-    if (schema && !isVectorSchema(schema, ctx)) {
-      addIssue2(ctx, path, "vector_property_not_numeric_array", `Vector query property '${propertyId}' on '${objectType.id}' must be a numeric array`);
+function validateVectorProfileQuery(query, shape, state, path, ctx) {
+  const types = getObjectTypesForResult(shape, ctx);
+  if (types.length !== 1 || !Number.isSafeInteger(query.k) || query.k < 1 || query.k > MAX_VECTOR_K) {
+    addIssue2(ctx, path, "invalid_vector_profile_query", `Vector search requires one type, one profile and k between 1 and ${MAX_VECTOR_K}`);
+    return query;
+  }
+  let input = query.input;
+  while (input.kind === "filter")
+    input = input.input;
+  if (input.kind !== "start" || input.includeSubtypes)
+    addIssue2(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];
+  if (!profile) {
+    addIssue2(ctx, path, "unknown_vector_profile", `Unknown vector profile: ${query.profile}`);
+    return query;
+  }
+  for (const propertyId of profile.source)
+    admitProperty(ctx, { state, propertyId, objectTypeId: objectType.id, use: "vector", path });
+  let values = query.vector;
+  try {
+    if (typeof values === "string") {
+      if (!values.trim() || values.length > 8000) {
+        throw new Error("Vector search text must be nonempty and at most 8000 characters.");
+      }
+    } else {
+      values = normalizeVector2(values, profile.model.definition.dimensions);
     }
+  } catch (error) {
+    addIssue2(ctx, path, "invalid_vector", error instanceof Error ? error.message : "Invalid vector");
   }
+  return {
+    ...query,
+    vector: values,
+    source: [...profile.source],
+    configuration: vectorConfiguration(profile)
+  };
 }
 function validateTraverse(linkId, direction, sourceObjectTypeId, shape, path, ctx) {
   if (!linkId) {
@@ -1151,14 +1222,6 @@ function isSortableSchema(schema) {
 function isContainsSchema(schema) {
   return schema === "string" || schema === "uuid" || typeof schema !== "string" && (schema.type === "array" || schema.type === "map");
 }
-function isVectorSchema(schema, ctx) {
-  if (typeof schema === "string")
-    return false;
-  if (schema.type !== "array")
-    return false;
-  const itemSchema = resolveSchema(schema.items, ctx.valueTypesById);
-  return itemSchema === "integer" || itemSchema === "double" || itemSchema === "decimal";
-}
 function keyForTypeIds(typeIds) {
   return uniqueStrings(typeIds).sort().join("\x00");
 }
@@ -1231,7 +1294,7 @@ async function executeObjectQuery2(input, options) {
     }
     const result = await options.storage.queryObjects({
       projectId: input.projectId,
-      query: plan.query,
+      query: await resolveVectorSearchText(plan.query, options.ontology, options.embeddingModels, input.signal),
       includeTotal: input.includeTotal
     });
     return { ...result, plan };
@@ -1287,7 +1350,7 @@ async function countObjects2(input, options) {
     }
     const result = await options.storage.countObjects({
       projectId: input.projectId,
-      query: plan.query
+      query: await resolveVectorSearchText(plan.query, options.ontology, options.embeddingModels)
     });
     return { ...result, plan };
   }
@@ -1341,7 +1404,7 @@ async function existsObjects2(input, options) {
     }
     const result = await options.storage.existsObjects({
       projectId: input.projectId,
-      query: plan.query
+      query: await resolveVectorSearchText(plan.query, options.ontology, options.embeddingModels)
     });
     return { ...result, plan };
   }
@@ -1396,7 +1459,7 @@ async function facetObjects2(input, options) {
     }
     const result = await options.storage.facetObjects({
       projectId: input.projectId,
-      query: plan.query,
+      query: await resolveVectorSearchText(plan.query, options.ontology, options.embeddingModels),
       facets
     });
     return { ...result, plan };
@@ -2087,8 +2150,13 @@ function buildExplainNode(query, path) {
       return {
         path,
         kind: query.kind,
-        summary: `vector ${query.propertyId} k=${query.k}`,
-        details: { propertyId: query.propertyId, dimensions: query.vector.length, k: query.k },
+        summary: `vector profile ${query.profile} k=${query.k}`,
+        details: {
+          profile: query.profile,
+          input: typeof query.vector === "string" ? "text" : "vector",
+          dimensions: typeof query.vector === "string" ? undefined : query.vector.length,
+          k: query.k
+        },
         children: [buildExplainNode(query.input, `${path}.input`)]
       };
     case "traverse":
@@ -2387,4 +2455,4 @@ async function hydrateLinkQueryObjects(projectId, selected, links, storage) {
 }
 export { planObjectQuery2, validateObjectQuery2, validateObjectQueryWithAdmission, collectObjectQueryValidationIssues2, resolveObjectQueryResultShape2, executeObjectQuery2, countObjects2, existsObjects2, facetObjects2, validateObjectFacetRequests, explainObjectQuery2, preflightObjectQueryLinks, executeObjectQueryLinks2 };
 
-//# debugId=48B001E3D65EA0BD64756E2164756E21
+//# debugId=822E01D76051F29664756E2164756E21