@sixb/core 0.1.6 → 0.1.8

package/dist/agents/builders.d.ts

@@ -1,17 +1,9 @@
-import type { AgentDefinition, AgentToolDescriptionBuilder, DefineAgentConfig } from "./types";
+import type { AgentToolDescriptionBuilder } from "./types";
 /**
- * Define a reusable tool that can be selected explicitly by one or more agents.
+ * Define a reusable tool registered through `createSixb({ tools })`.
  *
  * 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.
+ * context and executes the handler only when a run 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/`.
- *
- * The returned definition is declarative and can be exported from a project-level
- * `agents/` module. The runtime loads and registers it (`sixb.agents`); the agent
- * worker executes it as a running, streaming agent.
- */
-export declare function defineAgent<const TId extends string>(id: TId, config: DefineAgentConfig): AgentDefinition<TId>;
 //# sourceMappingURL=builders.d.ts.map

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/agents/builders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,2BAA2B,EAM5B,MAAM,SAAS,CAAA;AAOhB;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,KAAK,SAAS,MAAM,EACxD,IAAI,EAAE,KAAK,GACV,2BAA2B,CAAC,KAAK,CAAC,CAwBpC"}

package/dist/agents/context-resolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-resolution.d.ts","sourceRoot":"","sources":["../../src/agents/context-resolution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EAEtB,MAAM,WAAW,CAAA;AAGlB,+FAA+F;AAC/F,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,SAAS,sBAAsB,EAAE,GAAG,SAAS,GACnD,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAyBtC"}
+{"version":3,"file":"context-resolution.d.ts","sourceRoot":"","sources":["../../src/agents/context-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EAEtB,MAAM,WAAW,CAAA;AAGlB,+FAA+F;AAC/F,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,SAAS,sBAAsB,EAAE,GAAG,SAAS,GACnD,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAuBtC"}

package/dist/agents/context.js

@@ -7,8 +7,8 @@ import {
   agentContextFingerprint,
   agentContextIdentity,
   normalizeAgentContextEntries
-} from "../chunk-rdeagz6b.js";
-import"../chunk-t8t39h7v.js";
+} from "../chunk-5e3pq99w.js";
+import"../chunk-n6jxh8sw.js";
 import"../chunk-y64skrwp.js";
 export {
   normalizeAgentContextEntries,

package/dist/agents/dispatch.d.ts

@@ -1,4 +1,4 @@
-import type { AgentQueueJob, Queue } from "../queues";
+import type { AgentQueueJob, Queue, SubagentQueueJob } from "../queues";
 import type { AgentStorage } from "../storage/agents";
 export interface DispatchQueuedAgentRunsInput {
     readonly projectId: string;
@@ -23,6 +23,7 @@ export interface DispatchQueuedAgentRunsResult {
 }
 /** Stable queue identity: repeated publication of one durable run is idempotent. */
 export declare function agentRunQueueJobId(runId: string): string;
+export declare function subagentRunQueueJobId(runId: string): string;
 /** Stable queue identity shared by workflow dispatch and agent reconciliation. */
 export declare function workflowAgentNodeQueueJobId(nodeRunId: string): string;
 /**
@@ -33,4 +34,11 @@ export declare function workflowAgentNodeQueueJobId(nodeRunId: string): string;
  * job, while the worker's queued→running transition remains the execution authority.
  */
 export declare function dispatchQueuedAgentRuns(input: DispatchQueuedAgentRunsInput): Promise<DispatchQueuedAgentRunsResult>;
+export declare function dispatchQueuedSubagentRuns(input: {
+    readonly projectId: string;
+    readonly storage: AgentStorage;
+    readonly queue: Queue<SubagentQueueJob>;
+    readonly runIds?: readonly string[];
+    readonly limit?: number;
+}): Promise<DispatchQueuedAgentRunsResult>;
 //# sourceMappingURL=dispatch.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/agents/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;IACpC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAClD,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAA;CACtD;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,kFAAkF;AAClF,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CA8CxC"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/agents/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;IACpC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAClD,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAA;CACtD;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,kFAAkF;AAClF,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CA+CxC;AAED,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB,GAAG,OAAO,CAAC,6BAA6B,CAAC,CA4CzC"}

package/dist/agents/errors.d.ts

@@ -5,15 +5,6 @@
 export declare class AgentDefinitionError extends Error {
     readonly name: string;
 }
-/**
- * Raised by the message adapters. `fromAiSdk` is **total**: rather than silently dropping a part it
- * cannot model, it throws this — which both prevents data loss and pinpoints exactly when the
- * {@link AgentMessage} part union must be extended. It also fires on transient/streaming parts that
- * must never be persisted, and on out-of-contract (non-JSON) payloads.
- */
-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;
@@ -29,7 +20,7 @@ export declare class AgentToolResultValidationError extends Error {
     readonly name = "AgentToolResultValidationError";
     constructor(toolName: string, reason: string, options?: ErrorOptions);
 }
-export type AgentRequestErrorCode = "agent_not_found" | "run_not_found" | "run_not_retryable" | "thread_not_found" | "thread_agent_mismatch" | "active_run_exists" | "invalid_context" | "storage_unavailable";
+export type AgentRequestErrorCode = "agent_selector_removed" | "agent_not_found" | "model_not_found" | "invalid_model_selection" | "run_not_found" | "run_not_retryable" | "thread_not_found" | "active_run_exists" | "authority_not_inheritable" | "invalid_context" | "storage_unavailable";
 /**
  * Raised by {@link requestAgentRun} (the trigger). Callers branch on `code` rather than message text
  * — e.g. the HTTP layer maps `active_run_exists` to 409 and `agent_not_found` to 404.

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;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAyB;CAC/C;AAED,kFAAkF;AAClF,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,eAAe,GACf,mBAAmB,GACnB,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;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAyB;CAC/C;AAED,kFAAkF;AAClF,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,wBAAwB,GACxB,iBAAiB,GACjB,iBAAiB,GACjB,yBAAyB,GACzB,eAAe,GACf,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,2BAA2B,GAC3B,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/execution.d.ts

@@ -1,16 +1,15 @@
 import type { AuthorizablePrincipal, ExecutionContext } from "../execution";
+import type { ModelCatalog } from "../models";
 import type { SixbRuntimeContext } from "../runtime/types";
-import type { SecurityDefinitionCatalog } from "../security";
-import type { AgentRunRecord, AgentThreadRecord, ListAgentRunsInput, ListAgentRunsResult, ListAgentThreadsInput, ListAgentThreadsResult } from "../storage/agents";
+import type { AgentThreadRecord, ConversationAgentRunRecord, ListAgentRunsInput, ListAgentRunsResult, ListAgentThreadsInput, ListAgentThreadsResult } from "../storage/agents";
 import type { AiCostSummary } from "../storage/ai-cost";
 import type { AiModelCallUsage } from "../storage/ai-usage";
 import { type RequestAgentRunInput, type RequestAgentRunResult } from "./request";
-import type { AgentDefinition } from "./types";
+import type { AgentDescriptor } from "./types";
 export type ExecutionAgentRequestInput = Omit<RequestAgentRunInput, "principal">;
-export type ListExecutionAgentThreadsInput = Omit<ListAgentThreadsInput, "projectId" | "agentIds" | "ownerPrincipal">;
+export type ListExecutionAgentThreadsInput = Omit<ListAgentThreadsInput, "projectId" | "ownerPrincipal">;
 export interface CreateExecutionAgentThreadInput {
     readonly id?: string;
-    readonly agentId: string;
     readonly title?: string;
 }
 export interface AgentThreadsRuntime {
@@ -25,7 +24,7 @@ export interface AgentRunsRuntime {
     listForThread(threadId: string, input?: Omit<ListAgentRunsInput, "projectId" | "threadId">): Promise<AgentRunListResult | null>;
 }
 /** Execution-facing run view with provenance resolved from the immutable execution ledger. */
-export interface AgentRunView extends AgentRunRecord {
+export interface AgentRunView extends ConversationAgentRunRecord {
     readonly requestedBy?: AuthorizablePrincipal;
     /** Derived from the model-call ledger; never persisted on the Agent run row. */
     readonly usage?: AiModelCallUsage;
@@ -38,11 +37,11 @@ export interface AgentRunListResult extends Omit<ListAgentRunsResult, "runs"> {
 export interface ExecutionAgentRunResult extends Omit<RequestAgentRunResult, "run"> {
     readonly run: AgentRunView;
 }
-export interface AgentsRuntime {
-    list(): readonly AgentDefinition[];
-    getById(agentId: string): AgentDefinition | null;
+export interface AgentRuntime {
+    /** Null when no language models are configured or the caller cannot run the Agent. */
+    get(): AgentDescriptor | null;
     readonly threads: AgentThreadsRuntime;
     readonly runs: AgentRunsRuntime;
 }
-export declare function createAgentsRuntime(runtime: SixbRuntimeContext, execution: ExecutionContext, source: Pick<AgentsRuntime, "list" | "getById">, security: SecurityDefinitionCatalog): AgentsRuntime;
+export declare function createAgentRuntime(runtime: SixbRuntimeContext, execution: ExecutionContext, models?: ModelCatalog): AgentRuntime;
 //# sourceMappingURL=execution.d.ts.map

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

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

package/dist/agents/identity.d.ts

@@ -0,0 +1,3 @@
+/** Deterministic managed service-account id owned by one framework Agent actor. */
+export declare function agentServiceAccountId(actorId: string): string;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/agents/identity.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/agents/ids.d.ts

@@ -5,6 +5,10 @@
  */
 export declare function createAgentThreadId(): string;
 export declare function createAgentRunId(): string;
+/** One stable child identity per parent-selected spawn key. */
+export declare function createSubagentRunId(parentRunId: string, spawnKey: string): string;
+/** Stable execution identity paired with a deterministic child run. */
+export declare function createSubagentExecutionId(runId: string): string;
 export declare function createAgentMessageId(): string;
 /** One deterministic context-checkpoint identity per conversational run. */
 export declare function agentContextCheckpointId(runId: string): string;

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

@@ -1 +1 @@
-{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/agents/ids.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,6EAA6E;AAC7E,wBAAgB,4BAA4B,IAAI,MAAM,CAErD"}
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/agents/ids.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOjF;AAED,uEAAuE;AACvE,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,6EAA6E;AAC7E,wBAAgB,4BAA4B,IAAI,MAAM,CAErD"}

package/dist/agents/index.d.ts

@@ -1,10 +1,10 @@
-export type { AgentFileDataProjection, AgentFileDataResolverInput, AgentInboundUiMessage, AgentInboundUiMessagePart, AgentModelAssistantPart, AgentModelFilePart, AgentModelMessage, AgentModelReasoningPart, AgentModelTextPart, AgentModelToolCallPart, AgentModelToolOutput, AgentModelToolResultPart, AgentToolResultFileResolverInput, AgentUiMessage, AgentUiMessagePart, AgentUiToolPart, ToModelMessagesOptions, } from "./adapters";
-export { fromAiSdk, omitUndefinedObjectProperties, toModelMessages, toUiMessage, } from "./adapters";
+export type { AgentFileDataProjection, AgentFileDataResolverInput, AgentToolResultFileResolverInput, ToModelMessagesOptions, } from "./adapters";
+export { toModelMessages } from "./adapters";
 export type { AgentApiGatewayCapabilityInput, AgentApiRoute } from "./api-gateway";
 export { AGENT_API_GATEWAY_PREFIX, AGENT_API_ROUTES, createAgentApiGatewayCapability, isAllowedAgentApiRequest, isValidAgentApiGatewayCapability, } from "./api-gateway";
-export type { AgentExecutionIdentity } from "./authority";
-export { agentServiceAccountId, ensureAgentExecutionIdentity, resolveAgentExecutionAuthorization, } from "./authority";
-export { defineAgent, defineAgentTool } from "./builders";
+export type { AgentExecutionAuthorization, AgentExecutionIdentity } from "./authority";
+export { agentServiceAccountId, ensureManagedAgentExecutionIdentity, resolveAgentExecutionAuthorization, resolveInheritedAgentExecutionAuthorization, } from "./authority";
+export { 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 type { AgentContextCompactionBoundary, AgentContextEstimateTool, AgentContextTokenEstimate, EstimateAgentContextRequestTokensInput, } from "./context-compaction";
@@ -12,17 +12,21 @@ export { AGENT_CONTEXT_ESTIMATOR_VERSION, estimateAgentContextMessagesTokens, es
 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, AgentToolPublicError, AgentToolResultValidationError, } from "./errors";
-export { agentContextCheckpointId, 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 { agentRunQueueJobId, dispatchQueuedAgentRuns, dispatchQueuedSubagentRuns, subagentRunQueueJobId, workflowAgentNodeQueueJobId, } from "./dispatch";
+export { AgentDefinitionError, AgentRequestError, type AgentRequestErrorCode, AgentToolPublicError, AgentToolResultValidationError, } from "./errors";
+export { agentContextCheckpointId, createAgentMessageId, createAgentRunExecutionToken, createAgentRunId, createAgentThreadId, createSubagentExecutionId, createSubagentRunId, } from "./ids";
+export { AGENT_MESSAGE_CONTENT_VERSION, type AgentFilePart, type AgentMessage, type AgentMessagePart, type AgentMessagePartType, type AgentMessageRole, type AgentProviderStatePart, type AgentReasoningPart, type AgentStepStartPart, type AgentTextPart, type AgentToolCallPart, type AgentToolCallState, } from "./message";
+export type { ModelLoopResult, PrepareModelStepInput, PrepareModelStepResult, RunModelLoopInput, } from "./model-loop";
+export { runModelLoop } from "./model-loop";
+export { agent } from "./reference";
 export { type RequestAgentRunInput, type RequestAgentRunResult, requestAgentRun, retryAgentRun, } from "./request";
 export type { AgentCompactionFailureCode, AgentRunControlStreamId, AgentRunFailure, AgentRunFinishedEvent, AgentRunStreamEvent, AgentRunStreamId, } from "./streams";
 export { AGENT_COMPACTION_FAILURE_CODES, AGENT_RUN_CANCEL_RECORD, AGENT_RUN_STREAM_SCHEMA_VERSION, agentRunControlStreamDefinition, agentRunControlStreamId, agentRunFinishedEvent, agentRunStreamDefinition, agentRunStreamId, agentRunStreamIdempotencyKey, DEFAULT_AGENT_RUN_STREAM_RETENTION, isAgentRunStreamEvent, publishAgentRunCancel, publishAgentRunFinished, subscribeAgentRunCancel, } from "./streams";
 export type { AgentThreadModelContextMessage, ProjectAgentThreadModelContextInput, } from "./thread-context-projection";
 export { projectAgentThreadModelContext } from "./thread-context-projection";
+export type { AgentToolCatalog } from "./tool-catalog";
 export { isAgentToolResult } from "./tool-result";
-export type { AgentContextConfig, AgentDefinition, AgentLoopConfig, AgentReasoningLevel, AgentToolArtifact, AgentToolArtifactPutInput, AgentToolArtifacts, AgentToolContent, AgentToolDefinition, AgentToolDescriptionBuilder, AgentToolFileContent, AgentToolHandler, AgentToolHandlerResult, AgentToolInputBuilder, AgentToolInputSchema, AgentToolResult, AgentToolRunBuilder, AgentToolRunContext, AgentToolRunInfo, AgentToolTextContent, DefineAgentConfig, InferAgentToolInput, InferAgentToolInputSchema, } from "./types";
+export type { AgentDescriptor, AgentReasoning, AgentReasoningLevel, AgentReference, AgentToolArtifact, AgentToolArtifactPutInput, AgentToolArtifacts, AgentToolContent, AgentToolDefinition, AgentToolDescriptionBuilder, AgentToolFileContent, AgentToolHandler, AgentToolHandlerResult, AgentToolInputBuilder, AgentToolInputSchema, AgentToolResult, AgentToolRunBuilder, AgentToolRunContext, AgentToolRunInfo, AgentToolTextContent, AgentUsageReference, InferAgentToolInput, InferAgentToolInputSchema, } from "./types";
 export { AGENT_REASONING_LEVELS } from "./types";
-export { AGENT_RESERVED_TOOL_NAMES, isAgentDefinition, isAgentToolDefinition, validateAgentGroupReferences, validateAgentToolsAtStartup, validateAndNormalizeAgentToolInput, } from "./validation";
+export { AGENT_RESERVED_TOOL_NAMES, isAgentToolDefinition, 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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"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"}

package/dist/agents/index.js

@@ -3,94 +3,102 @@ import {
   AGENT_API_GATEWAY_PREFIX,
   AGENT_API_ROUTES,
   AGENT_CONTEXT_ESTIMATOR_VERSION,
-  AGENT_REASONING_LEVELS,
   AGENT_RESERVED_TOOL_NAMES,
-  agentContextCheckpointId,
-  agentRunQueueJobId,
+  agent,
   createAgentApiGatewayCapability,
-  createAgentMessageId,
-  createAgentRunExecutionToken,
-  createAgentRunId,
-  createAgentThreadId,
-  defineAgent,
   defineAgentTool,
-  dispatchQueuedAgentRuns,
   estimateAgentContextMessagesTokens,
   estimateAgentContextRequestTokens,
-  fromAiSdk,
-  isAgentDefinition,
   isAgentToolDefinition,
   isAgentToolResult,
   isAllowedAgentApiRequest,
   isValidAgentApiGatewayCapability,
-  omitUndefinedObjectProperties,
   projectAgentThreadModelContext,
-  requestAgentRun,
-  resolveAgentContextParts,
-  retryAgentRun,
+  runModelLoop,
   selectAgentContextCompactionBoundary,
   serializeAgentContextForModel,
   serializeAgentMessagesForSummary,
   shouldCompactAgentContext,
   toModelMessages,
-  toUiMessage,
-  validateAgentGroupReferences,
-  validateAgentToolsAtStartup,
-  validateAndNormalizeAgentToolInput,
+  validateAndNormalizeAgentToolInput
+} from "../chunk-4qfkag59.js";
+import {
+  agentContextCheckpointId,
+  agentRunQueueJobId,
+  createAgentMessageId,
+  createAgentRunExecutionToken,
+  createAgentRunId,
+  createAgentThreadId,
+  createSubagentExecutionId,
+  createSubagentRunId,
+  dispatchQueuedAgentRuns,
+  dispatchQueuedSubagentRuns,
+  requestAgentRun,
+  resolveAgentContextParts,
+  retryAgentRun,
+  subagentRunQueueJobId,
   workflowAgentNodeQueueJobId
-} from "../chunk-nva1xkjz.js";
-import"../chunk-tg5mee00.js";
-import"../chunk-8gv5z0zm.js";
-import"../chunk-5sxb1168.js";
-import"../chunk-4rh2m6zg.js";
+} from "../chunk-xajtptbw.js";
+import"../chunk-wtf06et8.js";
+import"../chunk-c15dr03f.js";
+import"../chunk-v4en4jc2.js";
+import"../chunk-w9tg6yyb.js";
+import"../chunk-aa2pen2v.js";
 import"../chunk-xhy826cz.js";
-import"../chunk-md8k0r54.js";
-import"../chunk-rte5sm3z.js";
-import"../chunk-qewtks41.js";
-import"../chunk-8b55ygje.js";
-import"../chunk-51fjndv0.js";
+import"../chunk-4rh2m6zg.js";
+import"../chunk-9nbmsvn5.js";
 import"../chunk-8m5ejdpn.js";
 import"../chunk-nf4r78r4.js";
-import"../chunk-0hc5j867.js";
-import"../chunk-a44d5zgd.js";
-import"../chunk-nkbfrt0c.js";
+import"../chunk-359jm1jw.js";
+import"../chunk-n4khvw9n.js";
+import"../chunk-pc7ys28c.js";
+import"../chunk-v1xppd0y.js";
+import"../chunk-h5vqbfmd.js";
+import"../chunk-q0k9nc5a.js";
+import"../chunk-rte5sm3z.js";
+import"../chunk-f26bck4t.js";
 import"../chunk-96swp2wd.js";
-import"../chunk-f6erf2vv.js";
+import"../chunk-k522z7v6.js";
 import {
   AGENT_MESSAGE_CONTENT_VERSION
-} from "../chunk-t624af60.js";
-import"../chunk-72q2y8hn.js";
-import"../chunk-xc7hq65b.js";
-import"../chunk-cy0n5dms.js";
-import"../chunk-dysw7nsm.js";
-import"../chunk-62c7t4jc.js";
-import"../chunk-ezake7g1.js";
-import"../chunk-fe5ev6mr.js";
-import"../chunk-htq0qh7z.js";
-import"../chunk-xkthy56g.js";
-import"../chunk-1g8negke.js";
+} from "../chunk-sbzzr4kx.js";
+import"../chunk-4jjp5k14.js";
+import"../chunk-rv2hkwwa.js";
+import"../chunk-nx7k8tpr.js";
+import"../chunk-4yqmp43v.js";
+import"../chunk-wdage1eb.js";
+import"../chunk-5ntny1qx.js";
 import {
-  agentServiceAccountId,
-  ensureAgentExecutionIdentity,
-  resolveAgentExecutionAuthorization
-} from "../chunk-hceck7dq.js";
-import"../chunk-t9xghkva.js";
-import"../chunk-drjqm1aa.js";
+  ensureManagedAgentExecutionIdentity,
+  resolveAgentExecutionAuthorization,
+  resolveInheritedAgentExecutionAuthorization
+} from "../chunk-nn0tekr1.js";
+import"../chunk-p03r0h5s.js";
+import"../chunk-jecn6t54.js";
 import"../chunk-5gd7tpv6.js";
-import"../chunk-h9kxd41f.js";
+import"../chunk-rafagrwr.js";
+import"../chunk-8tsf6dmc.js";
+import"../chunk-yp8ee62z.js";
+import"../chunk-ka3a2ft3.js";
+import"../chunk-w1tvjszy.js";
+import {
+  AGENT_REASONING_LEVELS
+} from "../chunk-p1rzczbt.js";
+import"../chunk-j1sbhm7p.js";
 import"../chunk-9dzba0f2.js";
-import"../chunk-vybf6pkp.js";
+import"../chunk-dbc80ad7.js";
 import"../chunk-ry24jbr1.js";
-import"../chunk-3j7573mj.js";
-import"../chunk-4gz41why.js";
+import"../chunk-p2vqaxkc.js";
+import"../chunk-trxxmgnf.js";
 import"../chunk-zcnhxkvd.js";
+import"../chunk-w3e09qqk.js";
+import"../chunk-51fjndv0.js";
 import"../chunk-1evzqhks.js";
-import"../chunk-dsrkgtnh.js";
-import"../chunk-bhxaq2nn.js";
+import"../chunk-jq43kdvk.js";
+import"../chunk-qw9gvjv5.js";
 import"../chunk-yt8wphsx.js";
 import {
   AgentDefinitionError,
-  AgentMessageAdapterError,
   AgentRequestError,
   AgentToolPublicError,
   AgentToolResultValidationError,
@@ -101,7 +109,7 @@ import {
   agentContextFingerprint,
   agentContextIdentity,
   normalizeAgentContextEntries
-} from "../chunk-rdeagz6b.js";
+} from "../chunk-5e3pq99w.js";
 import {
   AGENT_COMPACTION_FAILURE_CODES,
   AGENT_RUN_CANCEL_RECORD,
@@ -117,53 +125,57 @@ import {
   publishAgentRunCancel,
   publishAgentRunFinished,
   subscribeAgentRunCancel
-} from "../chunk-dm72y8wt.js";
-import"../chunk-t0jjkep3.js";
-import"../chunk-1e8m6yn3.js";
-import"../chunk-rhrbz7d4.js";
+} from "../chunk-7y0f6rf1.js";
+import"../chunk-d8qkxt2v.js";
+import"../chunk-4sm0aznx.js";
+import"../chunk-4a849fr1.js";
+import"../chunk-2dw777qw.js";
+import"../chunk-19jp6g9d.js";
 import"../chunk-xwnf87e1.js";
-import"../chunk-f83ka50g.js";
-import"../chunk-rnshztfq.js";
-import"../chunk-04b07a9q.js";
+import {
+  agentServiceAccountId
+} from "../chunk-p1x242ad.js";
+import"../chunk-r8jrnexe.js";
+import"../chunk-h0k55pc7.js";
 import"../chunk-dktq02ne.js";
-import"../chunk-zqysyfjt.js";
-import"../chunk-0172wgm9.js";
-import"../chunk-t8t39h7v.js";
+import"../chunk-04b07a9q.js";
+import"../chunk-08m3b6w8.js";
+import"../chunk-2xns679x.js";
+import"../chunk-n6jxh8sw.js";
 import"../chunk-y64skrwp.js";
 export {
   workflowAgentNodeQueueJobId,
   validateAndNormalizeAgentToolInput,
-  validateAgentToolsAtStartup,
-  validateAgentGroupReferences,
-  toUiMessage,
   toModelMessages,
   subscribeAgentRunCancel,
+  subagentRunQueueJobId,
   shouldCompactAgentContext,
   serializeAgentMessagesForSummary,
   serializeAgentContextForModel,
   selectAgentContextCompactionBoundary,
+  runModelLoop,
   retryAgentRun,
+  resolveInheritedAgentExecutionAuthorization,
   resolveAgentExecutionAuthorization,
   resolveAgentContextParts,
   requestAgentRun,
   publishAgentRunFinished,
   publishAgentRunCancel,
   projectAgentThreadModelContext,
-  omitUndefinedObjectProperties,
   normalizeAgentContextEntries,
   isValidAgentApiGatewayCapability,
   isAllowedAgentApiRequest,
   isAgentToolResult,
   isAgentToolDefinition,
   isAgentRunStreamEvent,
-  isAgentDefinition,
-  fromAiSdk,
   estimateAgentContextRequestTokens,
   estimateAgentContextMessagesTokens,
-  ensureAgentExecutionIdentity,
+  ensureManagedAgentExecutionIdentity,
+  dispatchQueuedSubagentRuns,
   dispatchQueuedAgentRuns,
   defineAgentTool,
-  defineAgent,
+  createSubagentRunId,
+  createSubagentExecutionId,
   createAgentThreadId,
   createAgentRunId,
   createAgentRunExecutionToken,
@@ -181,6 +193,7 @@ export {
   agentContextFingerprint,
   agentContextCheckpointId,
   agentContext,
+  agent,
   MAX_AGENT_CONTEXT_ENTRIES,
   MAX_AGENT_APP_STATE_TOTAL_BYTES,
   MAX_AGENT_APP_STATE_ENTRY_BYTES,
@@ -188,7 +201,6 @@ export {
   AgentToolResultValidationError,
   AgentToolPublicError,
   AgentRequestError,
-  AgentMessageAdapterError,
   AgentDefinitionError,
   AGENT_RUN_STREAM_SCHEMA_VERSION,
   AGENT_RUN_CANCEL_RECORD,
@@ -201,4 +213,4 @@ export {
   AGENT_API_GATEWAY_PREFIX
 };
 
-//# debugId=2C5B40000D8E854464756E2164756E21
+//# debugId=7495D457F4CEE77764756E2164756E21

package/dist/agents/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "2C5B40000D8E854464756E2164756E21",
+  "debugId": "7495D457F4CEE77764756E2164756E21",
   "names": []
 }

package/dist/agents/message.d.ts

@@ -1,5 +1,6 @@
 import type { FileRef } from "../blob-storage";
 import type { JsonValue } from "../json";
+import type { ProviderData } from "../models";
 import type { AgentContextPart } from "./context";
 /**
  * The agent's own, SDK-independent message. We store messages and threads — not an SDK transport —
@@ -7,19 +8,18 @@ import type { AgentContextPart } from "./context";
  * self-describing wrapper: the storage row owns the message's identity, and `contentVersion` (a
  * column) versions the parts shape so it can be migrated.
  *
- * The part union is intentionally focused on what V1 agents actually produce (text, reasoning, step
- * boundaries, tool calls). It is extensible: adding a part kind later is non-breaking. The adapter
- * `fromAiSdk` is total — it throws on any part it cannot model rather than dropping it silently,
- * which both prevents data loss and signals exactly when the union must grow.
+ * The part union is intentionally focused on what agent runs actually produce (text, reasoning, step
+ * boundaries, tool calls). The model loop validates and normalizes output before its steps are
+ * projected into this union; storage validates the durable write contract independently.
  */
-export declare const AGENT_MESSAGE_CONTENT_VERSION: 1;
+export declare const AGENT_MESSAGE_CONTENT_VERSION: 2;
 export type AgentMessageRole = "system" | "user" | "assistant";
 /** A plain text part (assistant output, user input, or system text). */
 export interface AgentTextPart {
     readonly type: "text";
     readonly text: string;
     /** Provider passthrough (kept because some providers require it on the next turn). */
-    readonly providerMetadata?: JsonValue;
+    readonly providerMetadata?: ProviderData;
 }
 /**
  * A reasoning ("thinking") part. `providerMetadata` is load-bearing here: some providers require
@@ -28,7 +28,7 @@ export interface AgentTextPart {
 export interface AgentReasoningPart {
     readonly type: "reasoning";
     readonly text: string;
-    readonly providerMetadata?: JsonValue;
+    readonly providerMetadata?: ProviderData;
 }
 /** A step boundary between assistant loop iterations. */
 export interface AgentStepStartPart {
@@ -39,18 +39,24 @@ export interface AgentFilePart {
     readonly type: "file";
     readonly fileRef: FileRef;
     /** Provider passthrough for future model-specific file handling. */
-    readonly providerMetadata?: JsonValue;
+    readonly providerMetadata?: ProviderData;
 }
 interface AgentToolCallBase {
     readonly type: "tool-call";
     readonly toolCallId: string;
     readonly toolName: string;
-    /** `true` when reconstructed from an SDK `dynamic-tool` part (vs a static `tool-${name}` part). */
+    /** `true` when the model identifies the call as a dynamic tool. */
     readonly dynamic?: boolean;
-    /** `true` when the provider executed the tool inline (steers model projection). V1 = `false`. */
+    /** `true` when the provider executed the tool inline (steers model projection). */
     readonly providerExecuted?: boolean;
     readonly input: JsonValue;
-    readonly providerMetadata?: JsonValue;
+    readonly providerMetadata?: ProviderData;
+}
+/** Ordered, hidden provider state required to replay a model response losslessly. */
+export interface AgentProviderStatePart {
+    readonly type: "provider-state";
+    readonly providerId: string;
+    readonly data: JsonValue;
 }
 /**
  * A completed tool call. Only terminal states are modelled — transient states
@@ -64,14 +70,14 @@ export type AgentToolCallPart = AgentToolCallBase & ({
     readonly state: "output-error";
     readonly errorText: string;
 });
-export type AgentMessagePart = AgentTextPart | AgentReasoningPart | AgentStepStartPart | AgentFilePart | AgentContextPart | AgentToolCallPart;
+export type AgentMessagePart = AgentTextPart | AgentReasoningPart | AgentStepStartPart | AgentFilePart | AgentContextPart | AgentToolCallPart | AgentProviderStatePart;
 export type AgentMessagePartType = AgentMessagePart["type"];
 export type AgentToolCallState = AgentToolCallPart["state"];
 /** The logical agent message the adapters speak and the store persists (as columns). */
 export interface AgentMessage {
     readonly role: AgentMessageRole;
     readonly parts: readonly AgentMessagePart[];
-    /** Message-level metadata (mirrors `UIMessage.metadata`). */
+    /** Optional JSON metadata associated with the message. */
     readonly metadata?: JsonValue;
 }
 export {};