@sixb/core 0.1.0 → 0.1.1

package/README.md

@@ -26,7 +26,7 @@ bun add @sixb/core
 
 **Connectors** -- Typed external system clients that you register with the runtime and resolve lazily with `sixb.connector(...)`.
 
-**Syncs** -- Declarative batch sync definitions that read from one connector and write into one raw dataset. V1 supports `snapshot` and `append` modes with optional triggers and typed source checkpoints.
+**Syncs** -- Declarative batch sync definitions that read from one connector and write into one raw dataset. V1 supports `snapshot`, `append`, and keyed `merge` modes with optional triggers and typed source checkpoints.
 
 **Queues** -- Typed durable work lanes for executable jobs such as sync runs, pipeline runs, and projection runs. App setup passes one `Queues` provider, while workers claim from lanes like `sixb.queues.syncRuns`.
 
@@ -247,7 +247,7 @@ Use `.json(schema)` for JSON bodies so payloads are validated at runtime. The `.
 Syncs are declarative definitions in `@sixb/core` v1. They do not start background work on their own; they just declare how to read from a connector into a dataset.
 
 ```ts
-import { col, defineDataset, defineSync } from "@sixb/core"
+import { change, col, defineDataset, defineSync } from "@sixb/core"
 
 const rawOrdersDataset = defineDataset("raw.erp.orders", {
   schema: [
@@ -260,6 +260,11 @@ const rawOrderEventsDataset = defineDataset("raw.erp.order-events", {
   schema: [col("eventId", "string")],
 })
 
+const rawInvoicesDataset = defineDataset("raw.erp.invoices", {
+  schema: [col("invoiceId", "string"), col("status", "string")],
+  primaryKey: "invoiceId",
+})
+
 const syncOrders = defineSync("sync-orders")
   .from(erpDb)
   .read(({ query }) => query("select * from orders"))
@@ -275,14 +280,27 @@ const syncOrderEvents = defineSync("sync-order-events", { mode: "append" })
   })
   .intoDataset(rawOrderEventsDataset)
 
+const syncInvoices = defineSync("sync-invoices", { mode: "merge" })
+  .checkpoint<{ cursor: string }>()
+  .from(erpDb)
+  .read(async function* (client, context) {
+    for await (const event of client.invoiceChangesSince(context.checkpoint?.cursor)) {
+      yield event.deleted
+        ? change.delete({ invoiceId: event.invoiceId })
+        : change.upsert(event.invoice)
+      context.setCheckpoint({ cursor: event.cursor })
+    }
+  })
+  .intoDataset(rawInvoicesDataset)
+
 const sixb = new Sixb({
   ontology: [Room],
   broker: myBroker,
   storage: myStorage,
   queues: myQueues,
-  datasets: [rawOrdersDataset, rawOrderEventsDataset],
+  datasets: [rawOrdersDataset, rawOrderEventsDataset, rawInvoicesDataset],
   connectors: [erpDb],
-  syncs: [syncOrders, syncOrderEvents],
+  syncs: [syncOrders, syncOrderEvents, syncInvoices],
 })
 
 sixb.listSyncs()
@@ -292,6 +310,8 @@ sixb.getSyncById("sync-orders")
 Call `.checkpoint<T>()` before `.from(...)` to type `context.checkpoint` and
 `context.setCheckpoint(...)` in a sync read handler. The sync worker loads the checkpoint from the
 latest successful run and stores the next checkpoint only after the dataset commit succeeds.
+Merge syncs require a string primary key, consume complete-row upserts and exact-key deletes, and
+allow only one registered writer for their keyed dataset.
 
 ## Convention-based Setup
 

package/dist/actions/index.js

@@ -10,7 +10,7 @@ import {
   optional,
   param,
   runActionValidators
-} from "../chunk-dhmj53mx.js";
+} from "../chunk-nbywkytr.js";
 import {
   ActionDefinitionError,
   ActionEditCommitError,
@@ -21,32 +21,32 @@ import {
   requestAction,
   requestActionAndWait,
   waitForActionRun
-} from "../chunk-jdwx7vzs.js";
-import"../chunk-yvef9xwc.js";
-import"../chunk-aebzcsxr.js";
-import"../chunk-q4qzq0ea.js";
+} from "../chunk-avppcgt6.js";
+import"../chunk-rjqm6ksg.js";
+import"../chunk-raq0x6bd.js";
+import"../chunk-hb9xcx9c.js";
 import"../chunk-xqbtf4wn.js";
 import"../chunk-50kv63vj.js";
 import"../chunk-6wetht33.js";
-import"../chunk-mx84y05q.js";
-import"../chunk-45tw90k7.js";
-import"../chunk-wxhdnwh4.js";
+import"../chunk-bh8bwma3.js";
 import"../chunk-9dzba0f2.js";
-import"../chunk-p6r5g77m.js";
+import"../chunk-8kv2sez0.js";
 import"../chunk-ry24jbr1.js";
 import"../chunk-1evzqhks.js";
 import"../chunk-t72dvahb.js";
-import"../chunk-tsk2bxs3.js";
+import"../chunk-yt8wphsx.js";
+import"../chunk-9k3hgv8h.js";
+import"../chunk-y2ygpd0m.js";
+import"../chunk-md9jbrm9.js";
+import"../chunk-53s4asfm.js";
 import"../chunk-04b07a9q.js";
 import"../chunk-dktq02ne.js";
-import"../chunk-yt8wphsx.js";
-import"../chunk-k41ajtz7.js";
-import"../chunk-4pycxcj3.js";
-import"../chunk-dcgrzj1t.js";
+import"../chunk-hz8m927w.js";
+import"../chunk-xt6qx9sh.js";
 import"../chunk-xwnf87e1.js";
-import"../chunk-0fygrz37.js";
-import"../chunk-btpe64e4.js";
-import"../chunk-1vffvydj.js";
+import"../chunk-exrfbt2d.js";
+import"../chunk-m9w0artv.js";
+import"../chunk-be9vm29v.js";
 import"../chunk-y64skrwp.js";
 export {
   waitForActionRun,

package/dist/actions/worker.js

@@ -1,20 +1,20 @@
 // @bun
+import {
+  EditBatchError
+} from "../chunk-yt8wphsx.js";
 import {
   assertKnownProperties,
   assertRequiredProperties,
   normalizeObjectProperties,
   validateObjectProperties,
   validatePropertyValue
-} from "../chunk-tsk2bxs3.js";
+} from "../chunk-53s4asfm.js";
 import"../chunk-04b07a9q.js";
 import {
   OntologyValidationError
 } from "../chunk-dktq02ne.js";
-import {
-  EditBatchError
-} from "../chunk-yt8wphsx.js";
-import"../chunk-4pycxcj3.js";
-import"../chunk-1vffvydj.js";
+import"../chunk-hz8m927w.js";
+import"../chunk-be9vm29v.js";
 import"../chunk-y64skrwp.js";
 
 // src/edits/recorder.ts
@@ -321,4 +321,4 @@ export {
   recordEdits
 };
 
-//# debugId=80751F89CEB9E0C664756E2164756E21
+//# debugId=B74B664D75878CD764756E2164756E21

package/dist/actions/worker.js.map

@@ -6,6 +6,6 @@
     "import type { ObjectLink, Property, ValueType } from \"../ontology\"\nimport { OntologyValidationError } from \"../ontology/errors\"\nimport type { ObjectTypeWithPropertyTokens } from \"../ontology/tokens\"\nimport {\n  assertKnownProperties,\n  normalizeObjectProperties,\n  validateObjectProperties,\n  validatePropertyValue,\n} from \"../ontology/validation\"\nimport { EditBatchError } from \"./errors\"\nimport type { EditObjectProperties } from \"./types\"\n\nexport function normalizeObjectEditProperties(params: {\n  readonly objectType: ObjectTypeWithPropertyTokens\n  readonly properties: Record<string, unknown>\n  readonly valueTypesById: ReadonlyMap<string, ValueType>\n  readonly path: string\n}): EditObjectProperties {\n  const { objectType, properties, valueTypesById, path } = params\n  assertKnownProperties(objectType, properties)\n  assertNoTelemetryProperties(objectType.properties, properties, path)\n  validateObjectProperties(objectType, properties, valueTypesById)\n  return normalizeObjectProperties(objectType.properties, properties, valueTypesById, path)\n}\n\nexport function normalizeLinkEditProperties(params: {\n  readonly sourceObjectTypeId: string\n  readonly linkId: string\n  readonly linkDefinition: ObjectLink\n  readonly properties: Readonly<Record<string, unknown>>\n  readonly valueTypesById: ReadonlyMap<string, ValueType>\n}): EditObjectProperties {\n  const { sourceObjectTypeId, linkId, linkDefinition, properties, valueTypesById } = params\n  const linkProperties = linkDefinition.properties ?? []\n\n  if (linkProperties.length === 0 && Object.keys(properties).length > 0) {\n    throw new OntologyValidationError(\n      `[Sixb] Link ${sourceObjectTypeId}.${linkId} does not define link properties`\n    )\n  }\n\n  const knownPropertyIds = new Set(linkProperties.map((property) => property.id))\n  for (const propertyId of Object.keys(properties)) {\n    if (!knownPropertyIds.has(propertyId)) {\n      throw new OntologyValidationError(\n        `[Sixb] Unknown link property '${propertyId}' for link '${sourceObjectTypeId}.${linkId}'`\n      )\n    }\n  }\n\n  assertNoTelemetryProperties(linkProperties, properties, `${sourceObjectTypeId}.${linkId}`)\n\n  for (const [propertyId, value] of Object.entries(properties)) {\n    const property = linkProperties.find((candidate) => candidate.id === propertyId)\n    if (!property) continue\n    validatePropertyValue(\n      property,\n      value,\n      `${sourceObjectTypeId}.${linkId}.${propertyId}`,\n      valueTypesById\n    )\n  }\n\n  return normalizeObjectProperties(\n    linkProperties,\n    properties,\n    valueTypesById,\n    `${sourceObjectTypeId}.${linkId}`\n  )\n}\n\nexport function getPrimaryProperty(objectType: ObjectTypeWithPropertyTokens): Property {\n  const primaryProperty = objectType.properties.find((property) => property.primary)\n  if (!primaryProperty) {\n    throw new OntologyValidationError(\n      `[Sixb] Object type '${objectType.id}' has no primary property`\n    )\n  }\n  return primaryProperty\n}\n\nexport function assertPrimaryPropertyNotUpdated(\n  objectType: ObjectTypeWithPropertyTokens,\n  properties: EditObjectProperties\n): void {\n  const primaryProperty = getPrimaryProperty(objectType)\n  if (Object.hasOwn(properties, primaryProperty.id)) {\n    throw new EditBatchError(\n      `[Sixb] EditBatch cannot update primary property '${objectType.id}.${primaryProperty.id}'.`\n    )\n  }\n}\n\n/** Validates `unset`/`reset` targets: known, non-primary, and not telemetry-backed. */\nexport function normalizeEditablePropertyIds(params: {\n  readonly objectType: ObjectTypeWithPropertyTokens\n  readonly propertyIds: readonly unknown[]\n  readonly operation: \"unset\" | \"reset\"\n}): readonly string[] {\n  const { objectType, propertyIds, operation } = params\n  const primaryProperty = getPrimaryProperty(objectType)\n  const normalized: string[] = []\n  const seen = new Set<string>()\n\n  for (const propertyId of propertyIds) {\n    if (typeof propertyId !== \"string\" || !propertyId.trim()) {\n      throw new EditBatchError(\n        `[Sixb] EditBatch ${objectType.id}.${operation} property id must be a non-empty string.`\n      )\n    }\n    const property = objectType.properties.find((candidate) => candidate.id === propertyId)\n    if (!property) {\n      throw new EditBatchError(\n        `[Sixb] EditBatch ${operation} references unknown property '${objectType.id}.${propertyId}'.`\n      )\n    }\n    if (property.id === primaryProperty.id) {\n      throw new EditBatchError(\n        `[Sixb] EditBatch cannot ${operation} primary property '${objectType.id}.${propertyId}'.`\n      )\n    }\n    if (property.mode === \"telemetry\") {\n      throw new EditBatchError(\n        `[Sixb] EditBatch cannot ${operation} telemetry property '${objectType.id}.${propertyId}'.`\n      )\n    }\n    if (seen.has(propertyId)) continue\n    seen.add(propertyId)\n    normalized.push(propertyId)\n  }\n\n  if (normalized.length === 0) {\n    throw new EditBatchError(\n      `[Sixb] EditBatch ${objectType.id}.${operation} requires at least one property id.`\n    )\n  }\n  return normalized\n}\n\nfunction assertNoTelemetryProperties(\n  definitions: readonly Property[],\n  properties: Readonly<Record<string, unknown>>,\n  path: string\n): void {\n  for (const propertyId of Object.keys(properties)) {\n    const property = definitions.find((candidate) => candidate.id === propertyId)\n    if (property?.mode === \"telemetry\") {\n      throw new EditBatchError(\n        `[Sixb] EditBatch cannot edit telemetry property '${path}.${propertyId}' in the MVP.`\n      )\n    }\n  }\n}\n"
   ],
   "mappings": "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",
-  "debugId": "80751F89CEB9E0C664756E2164756E21",
+  "debugId": "B74B664D75878CD764756E2164756E21",
   "names": []
 }

package/dist/agents/adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/agents/adapters.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/agents/adapters.ts"],"names":[],"mappings":"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"}

package/dist/agents/builders.d.ts

@@ -1,4 +1,11 @@
-import type { AgentDefinition, DefineAgentConfig } from "./types";
+import type { AgentDefinition, AgentToolDescriptionBuilder, DefineAgentConfig } from "./types";
+/**
+ * Define a reusable tool that can be selected explicitly by one or more agents.
+ *
+ * The returned definition is inert. The agent worker supplies its run-scoped
+ * context and executes the handler only when a selected agent calls the tool.
+ */
+export declare function defineAgentTool<const TName extends string>(name: TName): AgentToolDescriptionBuilder<TName>;
 /**
  * Define an agent: a conversational, looping actor auto-discovered from `agents/`.
  *

package/dist/agents/builders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/agents/builders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AASjE;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,GAAG,SAAS,MAAM,EAClD,EAAE,EAAE,GAAG,EACP,MAAM,EAAE,iBAAiB,GACxB,eAAe,CAAC,GAAG,CAAC,CAyBtB"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/agents/builders.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EAEf,2BAA2B,EAK3B,iBAAiB,EAElB,MAAM,SAAS,CAAA;AAYhB;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,KAAK,SAAS,MAAM,EACxD,IAAI,EAAE,KAAK,GACV,2BAA2B,CAAC,KAAK,CAAC,CAwBpC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,GAAG,SAAS,MAAM,EAClD,EAAE,EAAE,GAAG,EACP,MAAM,EAAE,iBAAiB,GACxB,eAAe,CAAC,GAAG,CAAC,CA2BtB"}

package/dist/agents/context.js

@@ -7,8 +7,8 @@ import {
   agentContextFingerprint,
   agentContextIdentity,
   normalizeAgentContextEntries
-} from "../chunk-f2b5e2gf.js";
-import"../chunk-1vffvydj.js";
+} from "../chunk-sb0shdvv.js";
+import"../chunk-be9vm29v.js";
 import"../chunk-y64skrwp.js";
 export {
   normalizeAgentContextEntries,

package/dist/agents/errors.d.ts

@@ -14,6 +14,21 @@ export declare class AgentDefinitionError extends Error {
 export declare class AgentMessageAdapterError extends Error {
     readonly name = "AgentMessageAdapterError";
 }
+/**
+ * An agent-tool failure whose message is intentionally safe to expose to the model and persist in
+ * the durable trace. Tool authors must keep the message free of credentials and internal details;
+ * unknown errors remain masked by the worker.
+ */
+export declare class AgentToolPublicError extends Error {
+    readonly name: string;
+}
+/** Raised when an agent tool result cannot cross the durable JSON message boundary. */
+export declare class AgentToolResultValidationError extends Error {
+    readonly toolName: string;
+    readonly reason: string;
+    readonly name = "AgentToolResultValidationError";
+    constructor(toolName: string, reason: string, options?: ErrorOptions);
+}
 export type AgentRequestErrorCode = "agent_not_found" | "thread_not_found" | "thread_agent_mismatch" | "active_run_exists" | "invalid_context" | "storage_unavailable";
 /**
  * Raised by {@link requestAgentRun} (the trigger). Callers branch on `code` rather than message text

package/dist/agents/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/agents/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAyB;CAC/C;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,8BAA6B;CAC3C;AAED,MAAM,MAAM,qBAAqB,GAC7B,iBAAiB,GACjB,kBAAkB,GAClB,uBAAuB,GACvB,mBAAmB,GACnB,iBAAiB,GACjB,qBAAqB,CAAA;AAEzB;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAIxC,QAAQ,CAAC,IAAI,EAAE,qBAAqB;IAHtC,QAAQ,CAAC,IAAI,uBAAsB;gBAGxB,IAAI,EAAE,qBAAqB,EACpC,OAAO,EAAE,MAAM;CAIlB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/agents/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAyB;CAC/C;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,8BAA6B;CAC3C;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAyB;CAC/C;AAED,uFAAuF;AACvF,qBAAa,8BAA+B,SAAQ,KAAK;IAIrD,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM;IAJzB,QAAQ,CAAC,IAAI,oCAAmC;gBAGrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,YAAY;CAIzB;AAED,MAAM,MAAM,qBAAqB,GAC7B,iBAAiB,GACjB,kBAAkB,GAClB,uBAAuB,GACvB,mBAAmB,GACnB,iBAAiB,GACjB,qBAAqB,CAAA;AAEzB;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAIxC,QAAQ,CAAC,IAAI,EAAE,qBAAqB;IAHtC,QAAQ,CAAC,IAAI,uBAAsB;gBAGxB,IAAI,EAAE,qBAAqB,EACpC,OAAO,EAAE,MAAM;CAIlB"}

package/dist/agents/index.d.ts

@@ -2,14 +2,14 @@ export type { AgentFileDataProjection, AgentFileDataResolverInput, AgentInboundU
 export { fromAiSdk, toModelMessages, toUiMessage } from "./adapters";
 export type { AgentApiGatewayCapabilityInput, AgentApiRoute } from "./api-gateway";
 export { AGENT_API_GATEWAY_PREFIX, AGENT_API_ROUTES, createAgentApiGatewayCapability, isAllowedAgentApiRequest, isValidAgentApiGatewayCapability, } from "./api-gateway";
-export { defineAgent } from "./builders";
+export { defineAgent, defineAgentTool } from "./builders";
 export type { AgentContextEntryInput, AgentContextInput, AgentContextOrigin, AgentContextPart, } from "./context";
 export { agentContext, agentContextFingerprint, agentContextIdentity, MAX_AGENT_APP_STATE_ENTRY_BYTES, MAX_AGENT_APP_STATE_TOTAL_BYTES, MAX_AGENT_CONTEXT_ENTRIES, normalizeAgentContextEntries, } from "./context";
 export { serializeAgentContextForModel } from "./context-model";
 export { resolveAgentContextParts } from "./context-resolution";
 export type { AgentRunDispatchFailure, DispatchedAgentRun, DispatchQueuedAgentRunsInput, DispatchQueuedAgentRunsResult, } from "./dispatch";
 export { agentRunQueueJobId, dispatchQueuedAgentRuns, workflowAgentNodeQueueJobId, } from "./dispatch";
-export { AgentDefinitionError, AgentMessageAdapterError, AgentRequestError, type AgentRequestErrorCode, } from "./errors";
+export { AgentDefinitionError, AgentMessageAdapterError, AgentRequestError, type AgentRequestErrorCode, AgentToolPublicError, AgentToolResultValidationError, } from "./errors";
 export { createAgentMessageId, createAgentRunExecutionToken, createAgentRunId, createAgentThreadId, } from "./ids";
 export { AGENT_MESSAGE_CONTENT_VERSION, type AgentFilePart, type AgentMessage, type AgentMessagePart, type AgentMessagePartType, type AgentMessageRole, type AgentReasoningPart, type AgentStepStartPart, type AgentTextPart, type AgentToolCallPart, type AgentToolCallState, } from "./message";
 export { type BuildAgentSystemPromptInput, buildAgentSystemPrompt, DEFAULT_AGENT_SYSTEM_CONTEXT, DEFAULT_AGENT_TASK_SYSTEM_CONTEXT, } from "./prompt";
@@ -18,7 +18,7 @@ export type { ScopedListAgentThreadsInput } from "./runtime";
 export { AgentsRuntime } from "./runtime";
 export type { AgentRunControlStreamId, AgentRunFinishedEvent, AgentRunStreamEvent, AgentRunStreamId, } from "./streams";
 export { AGENT_RUN_CANCEL_RECORD, AGENT_RUN_STREAM_SCHEMA_VERSION, agentRunControlStreamDefinition, agentRunControlStreamId, agentRunFinishedEvent, agentRunStreamDefinition, agentRunStreamId, agentRunStreamIdempotencyKey, DEFAULT_AGENT_RUN_STREAM_RETENTION, publishAgentRunCancel, publishAgentRunFinished, subscribeAgentRunCancel, } from "./streams";
-export type { AgentDefinition, AgentLoopConfig, AgentReasoningLevel, DefineAgentConfig, } from "./types";
+export type { AgentDefinition, AgentLoopConfig, AgentReasoningLevel, AgentToolDefinition, AgentToolDescriptionBuilder, AgentToolHandler, AgentToolHandlerResult, AgentToolInputBuilder, AgentToolInputSchema, AgentToolRunBuilder, AgentToolRunContext, AgentToolRunInfo, DefineAgentConfig, InferAgentToolInput, InferAgentToolInputSchema, } from "./types";
 export { AGENT_REASONING_LEVELS } from "./types";
-export { isAgentDefinition, validateAgentGroupReferences } from "./validation";
+export { AGENT_RESERVED_TOOL_NAMES, isAgentDefinition, isAgentToolDefinition, validateAgentGroupReferences, validateAgentToolsAtStartup, validateAndNormalizeAgentToolInput, } from "./validation";
 //# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,sBAAsB,GACvB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACpE,YAAY,EAAE,8BAA8B,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClF,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,+BAA+B,EAC/B,wBAAwB,EACxB,gCAAgC,GACjC,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,oBAAoB,EACpB,+BAA+B,EAC/B,+BAA+B,EAC/B,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAA;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,KAAK,qBAAqB,GAC3B,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,OAAO,CAAA;AACd,OAAO,EACL,6BAA6B,EAC7B,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,KAAK,2BAA2B,EAChC,sBAAsB,EACtB,4BAA4B,EAC5B,iCAAiC,GAClC,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,eAAe,GAChB,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,YAAY,EACV,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,+BAA+B,EAC/B,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,4BAA4B,EAC5B,kCAAkC,EAClC,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,WAAW,CAAA;AAClB,YAAY,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"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"}

package/dist/agents/index.js

@@ -3,6 +3,7 @@ import {
   AGENT_API_GATEWAY_PREFIX,
   AGENT_API_ROUTES,
   AGENT_REASONING_LEVELS,
+  AGENT_RESERVED_TOOL_NAMES,
   AgentsRuntime,
   DEFAULT_AGENT_SYSTEM_CONTEXT,
   DEFAULT_AGENT_TASK_SYSTEM_CONTEXT,
@@ -14,9 +15,11 @@ import {
   createAgentRunId,
   createAgentThreadId,
   defineAgent,
+  defineAgentTool,
   dispatchQueuedAgentRuns,
   fromAiSdk,
   isAgentDefinition,
+  isAgentToolDefinition,
   isAllowedAgentApiRequest,
   isValidAgentApiGatewayCapability,
   requestAgentRun,
@@ -25,19 +28,28 @@ import {
   toModelMessages,
   toUiMessage,
   validateAgentGroupReferences,
+  validateAgentToolsAtStartup,
+  validateAndNormalizeAgentToolInput,
   workflowAgentNodeQueueJobId
-} from "../chunk-nvamz5dv.js";
-import"../chunk-8r8cw2xw.js";
-import"../chunk-vj723r3p.js";
+} from "../chunk-86459jn0.js";
+import"../chunk-63te770v.js";
+import"../chunk-6rzdtvn5.js";
 import"../chunk-51fjndv0.js";
 import {
   AGENT_MESSAGE_CONTENT_VERSION
-} from "../chunk-k41ajtz7.js";
-import"../chunk-4pycxcj3.js";
+} from "../chunk-9k3hgv8h.js";
+import"../chunk-y2ygpd0m.js";
+import"../chunk-md9jbrm9.js";
+import"../chunk-53s4asfm.js";
+import"../chunk-04b07a9q.js";
+import"../chunk-dktq02ne.js";
+import"../chunk-hz8m927w.js";
 import {
   AgentDefinitionError,
   AgentMessageAdapterError,
   AgentRequestError,
+  AgentToolPublicError,
+  AgentToolResultValidationError,
   MAX_AGENT_APP_STATE_ENTRY_BYTES,
   MAX_AGENT_APP_STATE_TOTAL_BYTES,
   MAX_AGENT_CONTEXT_ENTRIES,
@@ -45,7 +57,7 @@ import {
   agentContextFingerprint,
   agentContextIdentity,
   normalizeAgentContextEntries
-} from "../chunk-f2b5e2gf.js";
+} from "../chunk-sb0shdvv.js";
 import {
   AGENT_RUN_CANCEL_RECORD,
   AGENT_RUN_STREAM_SCHEMA_VERSION,
@@ -60,14 +72,16 @@ import {
   publishAgentRunFinished,
   subscribeAgentRunCancel
 } from "../chunk-k25jm1x5.js";
-import"../chunk-dcgrzj1t.js";
+import"../chunk-xt6qx9sh.js";
 import"../chunk-xwnf87e1.js";
-import"../chunk-0fygrz37.js";
-import"../chunk-btpe64e4.js";
-import"../chunk-1vffvydj.js";
+import"../chunk-exrfbt2d.js";
+import"../chunk-m9w0artv.js";
+import"../chunk-be9vm29v.js";
 import"../chunk-y64skrwp.js";
 export {
   workflowAgentNodeQueueJobId,
+  validateAndNormalizeAgentToolInput,
+  validateAgentToolsAtStartup,
   validateAgentGroupReferences,
   toUiMessage,
   toModelMessages,
@@ -80,9 +94,11 @@ export {
   normalizeAgentContextEntries,
   isValidAgentApiGatewayCapability,
   isAllowedAgentApiRequest,
+  isAgentToolDefinition,
   isAgentDefinition,
   fromAiSdk,
   dispatchQueuedAgentRuns,
+  defineAgentTool,
   defineAgent,
   createAgentThreadId,
   createAgentRunId,
@@ -107,15 +123,18 @@ export {
   DEFAULT_AGENT_SYSTEM_CONTEXT,
   DEFAULT_AGENT_RUN_STREAM_RETENTION,
   AgentsRuntime,
+  AgentToolResultValidationError,
+  AgentToolPublicError,
   AgentRequestError,
   AgentMessageAdapterError,
   AgentDefinitionError,
   AGENT_RUN_STREAM_SCHEMA_VERSION,
   AGENT_RUN_CANCEL_RECORD,
+  AGENT_RESERVED_TOOL_NAMES,
   AGENT_REASONING_LEVELS,
   AGENT_MESSAGE_CONTENT_VERSION,
   AGENT_API_ROUTES,
   AGENT_API_GATEWAY_PREFIX
 };
 
-//# debugId=E9DC4F8F4D05C48864756E2164756E21
+//# debugId=533BF466EFD4809F64756E2164756E21

package/dist/agents/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "E9DC4F8F4D05C48864756E2164756E21",
+  "debugId": "533BF466EFD4809F64756E2164756E21",
   "names": []
 }

package/dist/agents/tool-definition.d.ts

@@ -0,0 +1,9 @@
+import type { AgentToolDefinition, AgentToolHandler, AgentToolInputSchema, InferAgentToolInputSchema } from "./types";
+export declare function createAgentToolDefinition<const TName extends string, const TInput extends AgentToolInputSchema>(definition: {
+    readonly name: TName;
+    readonly description: string;
+    readonly input: TInput;
+    readonly handler: AgentToolHandler<InferAgentToolInputSchema<TInput>>;
+}): AgentToolDefinition<TName, TInput>;
+export declare function toolsFromDefinitions(agentId: string, tools: readonly AgentToolDefinition[] | undefined): readonly AgentToolDefinition[];
+//# sourceMappingURL=tool-definition.d.ts.map

package/dist/agents/tool-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-definition.d.ts","sourceRoot":"","sources":["../../src/agents/tool-definition.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,SAAS,CAAA;AAWhB,wBAAgB,yBAAyB,CACvC,KAAK,CAAC,KAAK,SAAS,MAAM,EAC1B,KAAK,CAAC,MAAM,SAAS,oBAAoB,EACzC,UAAU,EAAE;IACZ,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAA;CACtE,GAAG,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CA+BrC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,GAChD,SAAS,mBAAmB,EAAE,CAiBhC"}

package/dist/agents/types.d.ts

@@ -1,4 +1,9 @@
 import type { LanguageModelV4, LanguageModelV4CallOptions } from "@ai-sdk/provider";
+import type { ConnectorAdapter, ConnectorClient, ConnectorDefinition } from "../connectors";
+import type { JsonPrimitive, JsonValue, ReadonlyJsonValue } from "../json";
+import type { Logger } from "../logging";
+import type { InferSchema } from "../ontology/inference";
+import type { Schema } from "../ontology/types";
 import type { GroupDefinition } from "../security";
 export type { AgentContextEntryInput, AgentContextInput, AgentContextOrigin, AgentContextPart, } from "./context";
 export type AgentReasoningLevel = NonNullable<LanguageModelV4CallOptions["reasoning"]>;
@@ -13,6 +18,61 @@ export interface AgentLoopConfig {
         readonly maxSteps?: number;
     };
 }
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type JsonifyAgentToolInput<T> = unknown extends T ? ReadonlyJsonValue : T extends Date ? string : T extends readonly (infer TItem)[] ? readonly JsonifyAgentToolInput<TItem>[] : T extends JsonPrimitive ? T : T extends object ? {
+    readonly [K in keyof T]: JsonifyAgentToolInput<T[K]>;
+} : never;
+/** A model-facing object shape expressed with Sixb's schema DSL. */
+export type AgentToolInputSchema = Readonly<Record<string, Schema>>;
+/** Infer the handler input represented by an agent tool schema. */
+export type InferAgentToolInputSchema<TInput extends AgentToolInputSchema> = string extends keyof TInput ? Readonly<Record<string, unknown>> : Simplify<{
+    readonly [K in keyof TInput]: JsonifyAgentToolInput<InferSchema<TInput[K]>>;
+}>;
+/** Identifies the agent execution that invoked a tool. */
+export interface AgentToolRunInfo {
+    readonly id: string;
+    readonly agentId: string;
+    readonly threadId?: string;
+}
+/** The narrow, run-scoped surface passed to an agent tool handler. */
+export interface AgentToolRunContext<TInput extends Readonly<Record<string, unknown>> = Readonly<Record<string, unknown>>> {
+    readonly input: TInput;
+    readonly signal: AbortSignal;
+    readonly run: AgentToolRunInfo;
+    connector<TAdapter extends ConnectorAdapter>(definition: ConnectorDefinition<string, TAdapter>): Promise<ConnectorClient<TAdapter>>;
+    readonly logger: Logger;
+}
+/** Agent tool handlers may return only values safe to persist in agent messages. */
+export type AgentToolHandlerResult = ReadonlyJsonValue | Promise<ReadonlyJsonValue>;
+export type AgentToolHandler<TInput extends Readonly<Record<string, unknown>>> = (context: AgentToolRunContext<TInput>) => AgentToolHandlerResult;
+/**
+ * Runtime definitions are stored heterogeneously. Keep variance erasure at this
+ * boundary only; authoring through `run()` remains strictly contravariant.
+ */
+type StoredAgentToolHandler<TInput extends Readonly<Record<string, unknown>>> = {
+    bivarianceHack(context: AgentToolRunContext<TInput>): JsonValue | Promise<JsonValue>;
+}["bivarianceHack"];
+/** A reusable, inert model tool definition selected explicitly by an agent. */
+export interface AgentToolDefinition<TName extends string = string, TInput extends AgentToolInputSchema = AgentToolInputSchema> {
+    readonly kind: "agentTool";
+    readonly name: TName;
+    readonly description: string;
+    readonly input: TInput;
+    readonly handler: StoredAgentToolHandler<InferAgentToolInputSchema<TInput>>;
+}
+/** Infer the input received by a tool definition's handler. */
+export type InferAgentToolInput<TTool extends AgentToolDefinition> = InferAgentToolInputSchema<TTool["input"]>;
+export interface AgentToolRunBuilder<TName extends string, TInput extends AgentToolInputSchema> {
+    run(handler: AgentToolHandler<InferAgentToolInputSchema<TInput>>): AgentToolDefinition<TName, TInput>;
+}
+export interface AgentToolInputBuilder<TName extends string> {
+    input<const TInput extends AgentToolInputSchema>(input: TInput): AgentToolRunBuilder<TName, TInput>;
+}
+export interface AgentToolDescriptionBuilder<TName extends string> {
+    description(description: string): AgentToolInputBuilder<TName>;
+}
 /**
  * Declarative config accepted by {@link defineAgent}.
  *
@@ -27,6 +87,8 @@ export interface DefineAgentConfig {
     readonly providerOptions?: LanguageModelV4CallOptions["providerOptions"];
     readonly instructions: string;
     readonly groups?: readonly GroupDefinition[];
+    /** Reusable tools this agent is explicitly allowed to call. */
+    readonly tools?: readonly AgentToolDefinition[];
     readonly loop?: AgentLoopConfig;
 }
 /**
@@ -47,6 +109,8 @@ export interface AgentDefinition<TId extends string = string> {
     readonly providerOptions?: LanguageModelV4CallOptions["providerOptions"];
     readonly instructions: string;
     readonly groupIds: readonly string[];
+    /** Selected tool definitions, normalized to an empty array when omitted. */
+    readonly tools: readonly AgentToolDefinition[];
     readonly loop?: AgentLoopConfig;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAElB,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAC,CAAA;AAEtF,eAAO,MAAM,sBAAsB,oFAQgB,CAAA;AAEnD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAC3B,CAAA;CACF;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,eAAe,CAAC,EAAE,0BAA0B,CAAC,iBAAiB,CAAC,CAAA;IACxE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAA;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM;IAC1D,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAA;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,eAAe,CAAC,EAAE,0BAA0B,CAAC,iBAAiB,CAAC,CAAA;IACxE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAA;CAChC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"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"}

package/dist/agents/validation.d.ts

@@ -1,10 +1,23 @@
+import { type JsonValue } from "../json";
+import { type ValueType } from "../ontology";
 import type { GroupDefinition, SecurityRegistry } from "../security";
-import { type AgentDefinition, type AgentLoopConfig, type AgentReasoningLevel, type DefineAgentConfig } from "./types";
+import { type AgentDefinition, type AgentLoopConfig, type AgentReasoningLevel, type AgentToolDefinition, type AgentToolInputSchema, type DefineAgentConfig } from "./types";
+export declare const AGENT_RESERVED_TOOL_NAMES: readonly ["bash"];
 export declare function assertNonEmpty(value: string, field: string): void;
 export declare function isAgentDefinition(value: unknown): value is AgentDefinition;
+export declare function isAgentToolDefinition(value: unknown): value is AgentToolDefinition;
+export declare function assertValidAgentToolName(name: unknown): asserts name is string;
+export declare function assertValidAgentToolDescription(name: string, description: unknown): void;
+export declare function assertValidAgentToolInput(name: string, input: unknown): void;
+export declare function validateAndSnapshotAgentToolInput<TInput extends AgentToolInputSchema>(toolName: string, input: TInput): TInput;
+/** Validate model input against a tool schema, normalize it to JSON, and lock the snapshot. */
+export declare function validateAndNormalizeAgentToolInput(toolName: string, shape: AgentToolInputSchema, value: unknown, valueTypesById: ReadonlyMap<string, ValueType>): Record<string, JsonValue>;
+/** Revalidate and lock tool definitions supplied directly to the runtime. */
+export declare function validateAgentToolsAtStartup(agents: readonly AgentDefinition[]): void;
 export declare function assertValidLoopConfig(loop: AgentLoopConfig | undefined): void;
 export declare function assertValidReasoningLevel(reasoning: AgentReasoningLevel | undefined): void;
 export declare function assertValidProviderOptions(providerOptions: DefineAgentConfig["providerOptions"]): void;
 export declare function groupIdsFromDefinitions(agentId: string, groups: readonly GroupDefinition[] | undefined): readonly string[];
 export declare function validateAgentGroupReferences(agents: readonly AgentDefinition[], security: SecurityRegistry): void;
+export declare function assertValidAgentToolDefinitions(agentId: string, tools: readonly AgentToolDefinition[]): void;
 //# sourceMappingURL=validation.d.ts.map

package/dist/agents/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/agents/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEpE,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,SAAS,CAAA;AAEhB,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIjE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAW1E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,CAU7E;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,mBAAmB,GAAG,SAAS,GAAG,IAAI,CAS1F;AAED,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,GACpD,IAAI,CAyBN;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,GAC7C,SAAS,MAAM,EAAE,CAcnB;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CAWN"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/agents/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,SAAS,EAAE,MAAM,SAAS,CAAA;AAClF,OAAO,EAIL,KAAK,SAAS,EAEf,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEpE,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,SAAS,CAAA;AAehB,eAAO,MAAM,yBAAyB,mBAAoB,CAAA;AAE1D,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIjE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAY1E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CASlF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAS9E;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI,CAIxF;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAa5E;AAED,wBAAgB,iCAAiC,CAAC,MAAM,SAAS,oBAAoB,EACnF,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,MAAM,CASR;AAED,+FAA+F;AAC/F,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,OAAO,EACd,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,GAC7C,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAwB3B;AAED,6EAA6E;AAC7E,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI,CAcpF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,CAU7E;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,mBAAmB,GAAG,SAAS,GAAG,IAAI,CAS1F;AAED,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,GACpD,IAAI,CAyBN;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,GAC7C,SAAS,MAAM,EAAE,CAcnB;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CAWN;AA6HD,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,IAAI,CAoBN"}

package/dist/auth/index.js

@@ -20,7 +20,7 @@ import {
   parseSessionCookieValue,
   principalsEqual,
   verifyDoubleSubmitCsrf
-} from "../chunk-dcgrzj1t.js";
+} from "../chunk-xt6qx9sh.js";
 import {
   AuthRuntimeError,
   DEFAULT_AUTH_INVITATION_TTL_MS,
@@ -47,9 +47,9 @@ import {
   serializeCookie,
   shouldUseSecureCookies
 } from "../chunk-xwnf87e1.js";
-import"../chunk-0fygrz37.js";
-import"../chunk-btpe64e4.js";
-import"../chunk-1vffvydj.js";
+import"../chunk-exrfbt2d.js";
+import"../chunk-m9w0artv.js";
+import"../chunk-be9vm29v.js";
 import"../chunk-y64skrwp.js";
 export {
   verifyDoubleSubmitCsrf,