@alvin0/ai-agent-sdk-core 0.1.0

package/dist/agent/tool/registry.d.ts

@@ -0,0 +1,70 @@
+import { ToolSchema } from "../../contract/tool.js";
+import { ToolDefinition, ToolExecutionMode } from "./definition.js";
+//#region src/agent/tool/registry.d.ts
+/** Read-only view of a set of tools. */
+interface ToolCatalog {
+  /** Look up a tool, or `undefined` when it is absent from this view. */
+  get(name: string): ToolDefinition | undefined;
+  /** Whether this view exposes a tool by that name. */
+  has(name: string): boolean;
+  /** Every exposed name, in registration order. */
+  names(): readonly string[];
+  /** The schemas to send the model — internals stripped. */
+  schemas(): readonly ToolSchema[];
+  /** How a call to this tool may be scheduled. Fail-closed for unknown names. */
+  executionMode(name: string, args: unknown): ToolExecutionMode;
+}
+/** Which tools a view exposes. */
+interface ToolFilter {
+  /** Expose only these. Omit to start from everything. */
+  allow?: readonly string[];
+  /** Remove these, applied after `allow`. */
+  deny?: readonly string[];
+}
+/** Codes the registry raises. */
+declare const REGISTRY_ERROR_CODES: Readonly<{
+  readonly DUPLICATE_TOOL: 'DUPLICATE_TOOL';
+  readonly INVALID_TOOL: 'INVALID_TOOL';
+  readonly UNKNOWN_TOOL_FILTER: 'UNKNOWN_TOOL_FILTER';
+}>;
+/** Holds the tools an agent may call. */
+declare class ToolRegistry implements ToolCatalog {
+  private readonly tools;
+  /**
+   * Register a tool.
+   * @param definition - the tool; validated before it is accepted.
+   * @returns a disposer that removes exactly this registration.
+   */
+  register<Args>(definition: ToolDefinition<Args>): () => void;
+  /**
+   * Register several tools atomically.
+   *
+   * All-or-nothing: if any is invalid or duplicated, none are registered, so a
+   * caller cannot end up with half a toolset and no indication of it.
+   * @param definitions - the tools.
+   * @returns one disposer removing all of them.
+   */
+  registerAll(definitions: readonly ToolDefinition<never>[]): () => void;
+  get(name: string): ToolDefinition | undefined;
+  has(name: string): boolean;
+  names(): readonly string[];
+  schemas(): readonly ToolSchema[];
+  executionMode(name: string, args: unknown): ToolExecutionMode;
+  /**
+   * A restricted view, for handing a narrower toolset to a sub-agent.
+   *
+   * Unknown names in the filter THROW rather than being ignored, because a typo in
+   * a deny list silently grants the capability it was meant to remove — the
+   * failure mode is invisible and points the wrong way.
+   *
+   * The view is a live projection, not a copy. An `allow` list is closed, so
+   * tools registered later stay hidden; a `deny` list is an open subtraction, so
+   * they appear. See {@link FilteredCatalog}.
+   * @param filter - which names to expose.
+   * @returns a read-only catalog.
+   */
+  view(filter: ToolFilter): ToolCatalog;
+}
+//#endregion
+export { REGISTRY_ERROR_CODES, ToolCatalog, ToolFilter, ToolRegistry };
+//# sourceMappingURL=registry.d.ts.map

package/dist/agent/tool/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../../../src/agent/tool/registry.ts"],"mappings":";;;;UAyBiB;;EAEf,IAAI,eAAe;;EAEnB,IAAI;;EAEJ;;EAEA,oBAAoB;;EAEpB,cAAc,cAAc,gBAAgB;;;UAI7B;;EAEf;;EAEA;;;cAIW,sBAAoB;;;;;;cAwGpB,wBAAwB;mBAClB;;;;;;EAOjB,SAAS,MAAM,YAAY,eAAe;;;;;;;;;EA2B1C,YAAY,sBAAsB;EAelC,IAAI,eAAe;EAInB,IAAI;EAIJ;EAIA,oBAAoB;EAIpB,cAAc,cAAc,gBAAgB;;;;;;;;;;;;;;EAiB5C,KAAK,QAAQ,aAAa"}

package/dist/agent/tool/registry.js

@@ -0,0 +1,2 @@
+import{deepFreeze as e}from"../../primitives/freeze.js";import{AgentSdkError as t}from"../../errors/agent-sdk-error.js";import{TOOL_REGISTRY_ERROR_CODES as n}from"./config.js";import{executionModeOf as r}from"./definition.js";const i=n;function a(t){return{name:t.name,description:t.description,parameters:e(structuredClone(t.parameters))}}function o(e){if(typeof e.name!=`string`||e.name.length===0)throw new t(`a tool must have a non-empty name`,i.INVALID_TOOL);if(typeof e.description!=`string`||e.description.length===0)throw new t(`tool "${e.name}" must have a non-empty description; it is what the model reads to decide when to call it`,i.INVALID_TOOL);if(typeof e.parameters!=`object`||e.parameters===null)throw new t(`tool "${e.name}" must declare a JSON Schema object for its parameters`,i.INVALID_TOOL);if(typeof e.execute!=`function`)throw new t(`tool "${e.name}" must implement execute()`,i.INVALID_TOOL);if(e.timeoutMs!==void 0&&(!Number.isFinite(e.timeoutMs)||e.timeoutMs<=0))throw new t(`tool "${e.name}" declared a non-positive timeoutMs`,i.INVALID_TOOL)}var s=class{source;allow;deny;constructor(e,t,n){this.source=e,this.allow=t,this.deny=n}exposes(e){return this.deny.has(e)?!1:this.allow===void 0||this.allow.has(e)}get(e){return this.exposes(e)?this.source.get(e):void 0}has(e){return this.exposes(e)&&this.source.has(e)}names(){return this.source.names().filter(e=>this.exposes(e))}schemas(){return this.source.schemas().filter(e=>this.exposes(e.name))}executionMode(e,t){return r(this.get(e),t)}},c=class{tools=new Map;register(e){let n=e;if(o(n),this.tools.has(n.name))throw new t(`a tool named "${n.name}" is already registered`,i.DUPLICATE_TOOL);return this.tools.set(n.name,n),()=>{this.tools.get(n.name)===n&&this.tools.delete(n.name)}}registerAll(e){let t=[];try{for(let n of e)t.push(this.register(n))}catch(e){for(let e of t.reverse())e();throw e}return()=>{for(let e of t.reverse())e()}}get(e){return this.tools.get(e)}has(e){return this.tools.has(e)}names(){return[...this.tools.keys()]}schemas(){return[...this.tools.values()].map(a)}executionMode(e,t){return r(this.tools.get(e),t)}view(e){for(let n of[...e.allow??[],...e.deny??[]])if(!this.tools.has(n))throw new t(`tool filter names "${n}", which is not registered`,i.UNKNOWN_TOOL_FILTER);return new s(this,e.allow===void 0?void 0:new Set(e.allow),new Set(e.deny??[]))}};export{i as REGISTRY_ERROR_CODES,c as ToolRegistry};
+//# sourceMappingURL=registry.js.map

package/dist/agent/tool/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../../src/agent/tool/registry.ts"],"sourcesContent":["/**\n * Where tools live, and what the model is allowed to see of them.\n *\n * The registry's one non-obvious job is the **allowlist when producing schemas**.\n * A `ToolDefinition` carries `execute`, `timeoutMs`, `isConcurrencySafe`, `render`,\n * and `meta` alongside the three fields the provider wants. Sending the object as\n * it stands would leak internal policy into the prompt — `timeoutMs` in particular\n * invites the model to reason about deadlines it has no business knowing. So\n * {@link ToolRegistry.schemas} rebuilds each entry from exactly\n * `{ name, description, parameters }`.\n *\n * @module ai-agent-sdk/agent/tool/registry\n */\n\nimport type { ToolSchema } from '../../contract/index.ts'\nimport { AgentSdkError } from '../../errors/index.ts'\nimport { deepFreeze } from '../../primitives/index.ts'\nimport {\n  executionModeOf,\n  type ToolDefinition,\n  type ToolExecutionMode,\n} from './definition.ts'\nimport { TOOL_REGISTRY_ERROR_CODES } from './config.ts'\n\n/** Read-only view of a set of tools. */\nexport interface ToolCatalog {\n  /** Look up a tool, or `undefined` when it is absent from this view. */\n  get(name: string): ToolDefinition | undefined\n  /** Whether this view exposes a tool by that name. */\n  has(name: string): boolean\n  /** Every exposed name, in registration order. */\n  names(): readonly string[]\n  /** The schemas to send the model — internals stripped. */\n  schemas(): readonly ToolSchema[]\n  /** How a call to this tool may be scheduled. Fail-closed for unknown names. */\n  executionMode(name: string, args: unknown): ToolExecutionMode\n}\n\n/** Which tools a view exposes. */\nexport interface ToolFilter {\n  /** Expose only these. Omit to start from everything. */\n  allow?: readonly string[]\n  /** Remove these, applied after `allow`. */\n  deny?: readonly string[]\n}\n\n/** Codes the registry raises. */\nexport const REGISTRY_ERROR_CODES = TOOL_REGISTRY_ERROR_CODES\n\n/** Rebuild a schema with only the fields the provider should receive. */\nfunction publicSchema(definition: ToolDefinition): ToolSchema {\n  return {\n    name: definition.name,\n    description: definition.description,\n    // Snapshot and freeze: the same definition object is reused across every\n    // request, and a provider adapter or a middleware that mutated `parameters`\n    // in place would corrupt every later turn.\n    parameters: deepFreeze(structuredClone(definition.parameters)),\n  }\n}\n\nfunction assertValid(definition: ToolDefinition): void {\n  if (typeof definition.name !== 'string' || definition.name.length === 0) {\n    throw new AgentSdkError('a tool must have a non-empty name', REGISTRY_ERROR_CODES.INVALID_TOOL)\n  }\n  if (typeof definition.description !== 'string' || definition.description.length === 0) {\n    // Not pedantry: the description IS the tool's interface to the model, and an\n    // undescribed tool gets called wrongly or not at all.\n    throw new AgentSdkError(\n      `tool \"${definition.name}\" must have a non-empty description; it is what the model reads to decide when to call it`,\n      REGISTRY_ERROR_CODES.INVALID_TOOL,\n    )\n  }\n  if (typeof definition.parameters !== 'object' || definition.parameters === null) {\n    throw new AgentSdkError(\n      `tool \"${definition.name}\" must declare a JSON Schema object for its parameters`,\n      REGISTRY_ERROR_CODES.INVALID_TOOL,\n    )\n  }\n  if (typeof definition.execute !== 'function') {\n    throw new AgentSdkError(\n      `tool \"${definition.name}\" must implement execute()`,\n      REGISTRY_ERROR_CODES.INVALID_TOOL,\n    )\n  }\n  if (definition.timeoutMs !== undefined\n    && (!Number.isFinite(definition.timeoutMs) || definition.timeoutMs <= 0)) {\n    throw new AgentSdkError(\n      `tool \"${definition.name}\" declared a non-positive timeoutMs`,\n      REGISTRY_ERROR_CODES.INVALID_TOOL,\n    )\n  }\n}\n\n/**\n * A filtered, read-only projection of a registry.\n *\n * The two filter halves are evaluated LAZILY and mean different things, which is\n * the subtle part:\n *\n * - `allow` is a closed list — \"only these\" — so a tool registered later is not in\n *   it and correctly stays hidden.\n * - `deny` is an open subtraction — \"everything except these\" — so a tool\n *   registered later IS exposed.\n *\n * Snapshotting the registry's names at construction would collapse the second case\n * into the first: `view({ deny: ['exec'] })` would silently freeze the toolset,\n * and a tool added afterwards would go missing with nothing to point at.\n */\nclass FilteredCatalog implements ToolCatalog {\n  private readonly source: ToolCatalog\n  private readonly allow: ReadonlySet<string> | undefined\n  private readonly deny: ReadonlySet<string>\n\n  constructor(\n    source: ToolCatalog,\n    allow: ReadonlySet<string> | undefined,\n    deny: ReadonlySet<string>,\n  ) {\n    this.source = source\n    this.allow = allow\n    this.deny = deny\n  }\n\n  private exposes(name: string): boolean {\n    if (this.deny.has(name)) return false\n    return this.allow === undefined || this.allow.has(name)\n  }\n\n  get(name: string): ToolDefinition | undefined {\n    return this.exposes(name) ? this.source.get(name) : undefined\n  }\n\n  has(name: string): boolean {\n    return this.exposes(name) && this.source.has(name)\n  }\n\n  names(): readonly string[] {\n    return this.source.names().filter(name => this.exposes(name))\n  }\n\n  schemas(): readonly ToolSchema[] {\n    return this.source.schemas().filter(schema => this.exposes(schema.name))\n  }\n\n  executionMode(name: string, args: unknown): ToolExecutionMode {\n    return executionModeOf(this.get(name), args)\n  }\n}\n\n/** Holds the tools an agent may call. */\nexport class ToolRegistry implements ToolCatalog {\n  private readonly tools = new Map<string, ToolDefinition>()\n\n  /**\n   * Register a tool.\n   * @param definition - the tool; validated before it is accepted.\n   * @returns a disposer that removes exactly this registration.\n   */\n  register<Args>(definition: ToolDefinition<Args>): () => void {\n    const entry = definition as ToolDefinition\n    assertValid(entry)\n    if (this.tools.has(entry.name)) {\n      // Silently shadowing would make which implementation runs depend on import\n      // order, which is invisible at the call site.\n      throw new AgentSdkError(\n        `a tool named \"${entry.name}\" is already registered`,\n        REGISTRY_ERROR_CODES.DUPLICATE_TOOL,\n      )\n    }\n    this.tools.set(entry.name, entry)\n    return () => {\n      // Guard the identity: a later re-registration under the same name must not\n      // be removed by a stale disposer.\n      if (this.tools.get(entry.name) === entry) this.tools.delete(entry.name)\n    }\n  }\n\n  /**\n   * Register several tools atomically.\n   *\n   * All-or-nothing: if any is invalid or duplicated, none are registered, so a\n   * caller cannot end up with half a toolset and no indication of it.\n   * @param definitions - the tools.\n   * @returns one disposer removing all of them.\n   */\n  registerAll(definitions: readonly ToolDefinition<never>[]): () => void {\n    const disposers: (() => void)[] = []\n    try {\n      for (const definition of definitions) {\n        disposers.push(this.register(definition as ToolDefinition))\n      }\n    } catch (error: unknown) {\n      for (const dispose of disposers.reverse()) dispose()\n      throw error\n    }\n    return () => {\n      for (const dispose of disposers.reverse()) dispose()\n    }\n  }\n\n  get(name: string): ToolDefinition | undefined {\n    return this.tools.get(name)\n  }\n\n  has(name: string): boolean {\n    return this.tools.has(name)\n  }\n\n  names(): readonly string[] {\n    return [...this.tools.keys()]\n  }\n\n  schemas(): readonly ToolSchema[] {\n    return [...this.tools.values()].map(publicSchema)\n  }\n\n  executionMode(name: string, args: unknown): ToolExecutionMode {\n    return executionModeOf(this.tools.get(name), args)\n  }\n\n  /**\n   * A restricted view, for handing a narrower toolset to a sub-agent.\n   *\n   * Unknown names in the filter THROW rather than being ignored, because a typo in\n   * a deny list silently grants the capability it was meant to remove — the\n   * failure mode is invisible and points the wrong way.\n   *\n   * The view is a live projection, not a copy. An `allow` list is closed, so\n   * tools registered later stay hidden; a `deny` list is an open subtraction, so\n   * they appear. See {@link FilteredCatalog}.\n   * @param filter - which names to expose.\n   * @returns a read-only catalog.\n   */\n  view(filter: ToolFilter): ToolCatalog {\n    for (const name of [...filter.allow ?? [], ...filter.deny ?? []]) {\n      if (!this.tools.has(name)) {\n        throw new AgentSdkError(\n          `tool filter names \"${name}\", which is not registered`,\n          REGISTRY_ERROR_CODES.UNKNOWN_TOOL_FILTER,\n        )\n      }\n    }\n    return new FilteredCatalog(\n      this,\n      filter.allow === undefined ? undefined : new Set(filter.allow),\n      new Set(filter.deny ?? []),\n    )\n  }\n}\n"],"mappings":"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"}

package/dist/agent/tool/schema.d.ts

@@ -0,0 +1,12 @@
+import { JsonObject } from "../../primitives/json.js";
+import { ToolDefinition } from "./definition.js";
+//#region src/agent/tool/schema.d.ts
+/** Adapt a schema library once: its JSON Schema and validator share one source. */
+interface RuntimeSchema<T> {
+  readonly jsonSchema: JsonObject;
+  readonly parse: (value: unknown) => T;
+}
+declare function defineToolFromSchema<T>(schema: RuntimeSchema<T>, definition: Omit<ToolDefinition<T>, 'parameters' | 'parse'>): ToolDefinition<T>;
+//#endregion
+export { RuntimeSchema, defineToolFromSchema };
+//# sourceMappingURL=schema.d.ts.map

package/dist/agent/tool/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","names":[],"sources":["../../../src/agent/tool/schema.ts"],"mappings":";;;;UAIiB,cAAc;WACpB,YAAY;WACZ,QAAQ,mBAAmB;;iBAGtB,qBAAqB,GACnC,QAAQ,cAAc,IACtB,YAAY,KAAK,eAAe,8BAC/B,eAAe"}

package/dist/agent/tool/schema.js

@@ -0,0 +1,2 @@
+import{defineTool as e}from"./definition.js";function t(t,n){let r=t.parse.bind(t);return e({...n,parameters:t.jsonSchema,parse:r})}export{t as defineToolFromSchema};
+//# sourceMappingURL=schema.js.map

package/dist/agent/tool/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../../src/agent/tool/schema.ts"],"sourcesContent":["import type { JsonObject } from '../../primitives/index.ts'\nimport { defineTool, type ToolDefinition } from './definition.ts'\n\n/** Adapt a schema library once: its JSON Schema and validator share one source. */\nexport interface RuntimeSchema<T> {\n  readonly jsonSchema: JsonObject\n  readonly parse: (value: unknown) => T\n}\n\nexport function defineToolFromSchema<T>(\n  schema: RuntimeSchema<T>,\n  definition: Omit<ToolDefinition<T>, 'parameters' | 'parse'>,\n): ToolDefinition<T> {\n  const parse = schema.parse.bind(schema)\n  return defineTool({ ...definition, parameters: schema.jsonSchema, parse })\n}\n"],"mappings":"6CASA,SAAgB,EACd,EACA,EACmB,CACnB,IAAM,EAAQ,EAAO,MAAM,KAAK,CAAM,EACtC,OAAO,EAAW,CAAE,GAAG,EAAY,WAAY,EAAO,WAAY,OAAM,CAAC,CAC3E"}

package/dist/agent/tool/source-types.d.ts

@@ -0,0 +1,25 @@
+import { SdkLogger } from "../../logging/types.js";
+import { ToolDefinition } from "./definition.js";
+//#region src/agent/tool/source-types.d.ts
+interface ToolCatalogSnapshot {
+  readonly revision: string;
+  readonly tools: readonly ToolDefinition[];
+}
+interface ToolSourceSnapshotOptions {
+  readonly signal: AbortSignal;
+  readonly logger: SdkLogger;
+}
+interface ToolSource {
+  readonly kind: 'tool-source';
+  readonly apiVersion: 1;
+  readonly id: string;
+  readonly snapshot: (options: ToolSourceSnapshotOptions) => ToolCatalogSnapshot;
+}
+type ToolSourceDefinition = Omit<ToolSource, 'kind' | 'apiVersion'>;
+interface ToolSourceRunReference {
+  readonly sourceId: string;
+  readonly revision: string;
+}
+//#endregion
+export { ToolCatalogSnapshot, ToolSource, ToolSourceDefinition, ToolSourceRunReference, ToolSourceSnapshotOptions };
+//# sourceMappingURL=source-types.d.ts.map

package/dist/agent/tool/source-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-types.d.ts","names":[],"sources":["../../../src/agent/tool/source-types.ts"],"mappings":";;;UAGiB;WACN;WACA,gBAAgB;;UAGV;WACN,QAAQ;WACR,QAAQ;;UAGF;WACN;WACA;WACA;WACA,WAAW,SAAS,8BAA8B;;KAGjD,uBAAuB,KAAK;UAGvB;WACN;WACA"}

package/dist/agent/trace/trace.d.ts

@@ -0,0 +1,63 @@
+import { TokenUsage } from "../../stream/chunk.js";
+import { SpanId, TraceId, createSpanId, createTraceId, traceparent } from "../../observation/context.js";
+//#region src/agent/trace/trace.d.ts
+interface TraceRef {
+  readonly traceId: TraceId;
+  readonly spanId: SpanId;
+  readonly parentSpanId: SpanId | null;
+}
+type AgentSpanKind = 'invoke_agent' | 'chat' | 'execute_tool' | 'compact';
+type AgentSpanStatus = 'success' | 'error' | 'aborted' | 'unknown';
+interface TraceSpanStart {
+  readonly type: 'span-start';
+  readonly trace: TraceRef;
+  readonly at: string;
+  readonly name: string;
+  readonly kind: AgentSpanKind;
+  readonly attributes?: Readonly<Record<string, unknown>>;
+  /**
+   * What went INTO this step, when the step has an input worth keeping.
+   *
+   * The counterpart of {@link TraceSpanEnd.output}, and bounded by whoever
+   * emits it: a model round's whole request can be a hundred thousand tokens,
+   * so what lands here is a summary of the request — the tools offered and the
+   * tail of the conversation — not a copy of it. A span with nothing
+   * interesting to declare omits the field rather than sending an empty object.
+   */
+  readonly input?: unknown;
+}
+interface TraceSpanEnd {
+  readonly type: 'span-end';
+  readonly trace: TraceRef;
+  readonly at: string;
+  readonly status: AgentSpanStatus;
+  readonly output?: unknown;
+  readonly usage?: TokenUsage;
+  readonly error?: {
+    readonly type: string;
+    readonly message: string;
+    readonly code?: string;
+  };
+}
+type TraceEvent = TraceSpanStart | TraceSpanEnd;
+interface AgentProcessSpan {
+  readonly traceId: TraceId;
+  readonly spanId: SpanId;
+  readonly parentSpanId: SpanId | null;
+  readonly name: string;
+  readonly kind: AgentSpanKind;
+  readonly startedAt: string;
+  readonly durationMs: number | null;
+  readonly status: AgentSpanStatus;
+  readonly attributes?: Readonly<Record<string, unknown>>;
+  readonly input?: unknown;
+  readonly output?: unknown;
+  readonly usage?: TokenUsage;
+  readonly error?: TraceSpanEnd['error'];
+  readonly children: readonly AgentProcessSpan[];
+}
+/** Project span lifecycle events into the nested shape expected by call-graph UIs. */
+declare function buildTraceTree(events: readonly TraceEvent[]): readonly AgentProcessSpan[];
+//#endregion
+export { AgentProcessSpan, AgentSpanKind, AgentSpanStatus, type SpanId, TraceEvent, type TraceId, TraceRef, TraceSpanEnd, TraceSpanStart, buildTraceTree };
+//# sourceMappingURL=trace.d.ts.map

package/dist/agent/trace/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","names":[],"sources":["../../../src/agent/trace/trace.ts"],"mappings":";;;UAMiB;WACN,SAAS;WACT,QAAQ;WACR,cAAc;;KAGb;KACA;UAEK;WACN;WACA,OAAO;WACP;WACA;WACA,MAAM;WACN,aAAa,SAAS;;;;;;;;;;WAUtB;;UAGM;WACN;WACA,OAAO;WACP;WACA,QAAQ;WACR;WACA,QAAQ;WACR;aAAmB;aAAuB;aAA0B;;;KAGnE,aAAa,iBAAiB;UAEzB;WACN,SAAS;WACT,QAAQ;WACR,cAAc;WACd;WACA,MAAM;WACN;WACA;WACA,QAAQ;WACR,aAAa,SAAS;WACtB;WACA;WACA,QAAQ;WACR,QAAQ;WACR,mBAAmB;;;iBAId,eAAe,iBAAiB,wBAAwB"}

package/dist/agent/trace/trace.js

@@ -0,0 +1,2 @@
+import{deepFreeze as e}from"../../primitives/freeze.js";import{createSpanId as t,createTraceId as n}from"../../observation/context.js";function r(t){let n=[],r=new Map;for(let e of t){if(e.type===`span-start`){let t={traceId:e.trace.traceId,spanId:e.trace.spanId,parentSpanId:e.trace.parentSpanId,name:e.name,kind:e.kind,startedAt:e.at,durationMs:null,status:`unknown`,...e.attributes===void 0?{}:{attributes:e.attributes},...e.input===void 0?{}:{input:e.input},children:[]};r.set(t.spanId,t);let i=t.parentSpanId===null?void 0:r.get(t.parentSpanId);i===void 0?n.push(t):i.children.push(t);continue}let t=r.get(e.trace.spanId);if(t===void 0)continue;t.status=e.status;let i=Date.parse(t.startedAt),a=Date.parse(e.at);t.durationMs=Number.isFinite(i)&&Number.isFinite(a)?Math.max(0,a-i):null,e.output!==void 0&&(t.output=e.output),e.usage!==void 0&&(t.usage=e.usage),e.error!==void 0&&(t.error=e.error)}return e(structuredClone(n))}export{r as buildTraceTree,t as createSpanId,n as createTraceId};
+//# sourceMappingURL=trace.js.map

package/dist/agent/trace/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","names":[],"sources":["../../../src/agent/trace/trace.ts"],"sourcesContent":["import { deepFreeze } from '../../primitives/index.ts'\nimport { createSpanId, createTraceId, traceparent, type SpanId, type TraceId } from '../../observation/index.ts'\nimport type { TokenUsage } from '../../stream/index.ts'\nexport { createSpanId, createTraceId, traceparent }\nexport type { SpanId, TraceId }\n\nexport interface TraceRef {\n  readonly traceId: TraceId\n  readonly spanId: SpanId\n  readonly parentSpanId: SpanId | null\n}\n\nexport type AgentSpanKind = 'invoke_agent' | 'chat' | 'execute_tool' | 'compact'\nexport type AgentSpanStatus = 'success' | 'error' | 'aborted' | 'unknown'\n\nexport interface TraceSpanStart {\n  readonly type: 'span-start'\n  readonly trace: TraceRef\n  readonly at: string\n  readonly name: string\n  readonly kind: AgentSpanKind\n  readonly attributes?: Readonly<Record<string, unknown>>\n  /**\n   * What went INTO this step, when the step has an input worth keeping.\n   *\n   * The counterpart of {@link TraceSpanEnd.output}, and bounded by whoever\n   * emits it: a model round's whole request can be a hundred thousand tokens,\n   * so what lands here is a summary of the request — the tools offered and the\n   * tail of the conversation — not a copy of it. A span with nothing\n   * interesting to declare omits the field rather than sending an empty object.\n   */\n  readonly input?: unknown\n}\n\nexport interface TraceSpanEnd {\n  readonly type: 'span-end'\n  readonly trace: TraceRef\n  readonly at: string\n  readonly status: AgentSpanStatus\n  readonly output?: unknown\n  readonly usage?: TokenUsage\n  readonly error?: { readonly type: string; readonly message: string; readonly code?: string }\n}\n\nexport type TraceEvent = TraceSpanStart | TraceSpanEnd\n\nexport interface AgentProcessSpan {\n  readonly traceId: TraceId\n  readonly spanId: SpanId\n  readonly parentSpanId: SpanId | null\n  readonly name: string\n  readonly kind: AgentSpanKind\n  readonly startedAt: string\n  readonly durationMs: number | null\n  readonly status: AgentSpanStatus\n  readonly attributes?: Readonly<Record<string, unknown>>\n  readonly input?: unknown\n  readonly output?: unknown\n  readonly usage?: TokenUsage\n  readonly error?: TraceSpanEnd['error']\n  readonly children: readonly AgentProcessSpan[]\n}\n\n/** Project span lifecycle events into the nested shape expected by call-graph UIs. */\nexport function buildTraceTree(events: readonly TraceEvent[]): readonly AgentProcessSpan[] {\n  interface Mutable {\n    traceId: TraceId\n    spanId: SpanId\n    parentSpanId: SpanId | null\n    name: string\n    kind: AgentSpanKind\n    startedAt: string\n    durationMs: number | null\n    status: AgentSpanStatus\n    attributes?: Readonly<Record<string, unknown>>\n    input?: unknown\n    output?: unknown\n    usage?: TokenUsage\n    error?: TraceSpanEnd['error']\n    children: Mutable[]\n  }\n  const roots: Mutable[] = []\n  const byId = new Map<SpanId, Mutable>()\n  for (const event of events) {\n    if (event.type === 'span-start') {\n      const span: Mutable = {\n        traceId: event.trace.traceId,\n        spanId: event.trace.spanId,\n        parentSpanId: event.trace.parentSpanId,\n        name: event.name,\n        kind: event.kind,\n        startedAt: event.at,\n        durationMs: null,\n        status: 'unknown',\n        ...event.attributes === undefined ? {} : { attributes: event.attributes },\n        ...event.input === undefined ? {} : { input: event.input },\n        children: [],\n      }\n      byId.set(span.spanId, span)\n      const parent = span.parentSpanId === null ? undefined : byId.get(span.parentSpanId)\n      if (parent === undefined) roots.push(span)\n      else parent.children.push(span)\n      continue\n    }\n    const span = byId.get(event.trace.spanId)\n    if (span === undefined) continue\n    span.status = event.status\n    const start = Date.parse(span.startedAt)\n    const end = Date.parse(event.at)\n    span.durationMs = Number.isFinite(start) && Number.isFinite(end) ? Math.max(0, end - start) : null\n    if (event.output !== undefined) span.output = event.output\n    if (event.usage !== undefined) span.usage = event.usage\n    if (event.error !== undefined) span.error = event.error\n  }\n  return deepFreeze(structuredClone(roots))\n}\n"],"mappings":"uIAgEA,SAAgB,EAAe,EAA4D,CAiBzF,IAAM,EAAmB,CAAC,EACpB,EAAO,IAAI,IACjB,IAAK,IAAM,KAAS,EAAQ,CAC1B,GAAI,EAAM,OAAS,aAAc,CAC/B,IAAM,EAAgB,CACpB,QAAS,EAAM,MAAM,QACrB,OAAQ,EAAM,MAAM,OACpB,aAAc,EAAM,MAAM,aAC1B,KAAM,EAAM,KACZ,KAAM,EAAM,KACZ,UAAW,EAAM,GACjB,WAAY,KACZ,OAAQ,UACR,GAAG,EAAM,aAAe,IAAA,GAAY,CAAC,EAAI,CAAE,WAAY,EAAM,UAAW,EACxE,GAAG,EAAM,QAAU,IAAA,GAAY,CAAC,EAAI,CAAE,MAAO,EAAM,KAAM,EACzD,SAAU,CAAC,CACb,EACA,EAAK,IAAI,EAAK,OAAQ,CAAI,EAC1B,IAAM,EAAS,EAAK,eAAiB,KAAO,IAAA,GAAY,EAAK,IAAI,EAAK,YAAY,EAC9E,IAAW,IAAA,GAAW,EAAM,KAAK,CAAI,EACpC,EAAO,SAAS,KAAK,CAAI,EAC9B,QACF,CACA,IAAM,EAAO,EAAK,IAAI,EAAM,MAAM,MAAM,EACxC,GAAI,IAAS,IAAA,GAAW,SACxB,EAAK,OAAS,EAAM,OACpB,IAAM,EAAQ,KAAK,MAAM,EAAK,SAAS,EACjC,EAAM,KAAK,MAAM,EAAM,EAAE,EAC/B,EAAK,WAAa,OAAO,SAAS,CAAK,GAAK,OAAO,SAAS,CAAG,EAAI,KAAK,IAAI,EAAG,EAAM,CAAK,EAAI,KAC1F,EAAM,SAAW,IAAA,KAAW,EAAK,OAAS,EAAM,QAChD,EAAM,QAAU,IAAA,KAAW,EAAK,MAAQ,EAAM,OAC9C,EAAM,QAAU,IAAA,KAAW,EAAK,MAAQ,EAAM,MACpD,CACA,OAAO,EAAW,gBAAgB,CAAK,CAAC,CAC1C"}

package/dist/agent.d.ts

@@ -0,0 +1,52 @@
+import { SdkLogger } from "./logging/types.js";
+import { AgentMessageSource } from "./message/message.js";
+import { SupportSafeError, UsageCoverageSummary } from "./support-safe/error.js";
+import { ToolCallPosition, ToolDefinition, ToolExecutionMode, ToolExecutionResult, ToolFailure, ToolRunContext, ToolSuccess, defineTool, executionModeOf, renderJsonValue } from "./agent/tool/definition.js";
+import { MemorySpillStoreLimits, SPILL_TOOL_NAME, SpillRecord, SpillSlice, SpillStore, ToolOutputOverflowPolicy, TruncatedText, createMemorySpillStore, estimateTextBlockTokens, estimateTextTokens, previewForSpill, readSpillTool, truncateMiddleToTokens } from "./agent/tool/output-budget.js";
+import { HistorySurfaceNode, projectHistorySurface, projectMessages } from "./agent/history/project.js";
+import { CompactionBackoffReason, HistoryEntry, HistoryEvent, HistoryLimits, HistorySnapshot, SurfaceOp } from "./agent/history/types.js";
+import { History } from "./agent/history/history.js";
+import { ApprovalBroker, ApprovalDecision, ApprovalRequest, ApprovalStateStore, InteractiveApprovalBroker, InteractiveApprovalBrokerOptions, createApprovalBroker, createApprovalRequest, fixedApprovalBroker, withApprovalPersistence } from "./agent/tool/approval.js";
+import { REGISTRY_ERROR_CODES, ToolCatalog, ToolFilter, ToolRegistry } from "./agent/tool/registry.js";
+import { AuthorizationOutcome, AuthorizedToolCall, DispatchToolCallOptions, PostToolDecision, PreToolDecision, PreparedToolCall, ToolCallContext, ToolCallRequest, ToolInterceptor, authorizeToolCall, dispatchAuthorizedToolCall, dispatchToolCall, finalizeToolCall, prepareToolCall, toolFailure } from "./agent/tool/pipeline.js";
+import { AgentProcessSpan, AgentSpanKind, AgentSpanStatus, TraceEvent, TraceRef, TraceSpanEnd, TraceSpanStart, buildTraceTree } from "./agent/trace/trace.js";
+import { RunLedgerLimits, RunOperationCounts, RunUsageReport, TrackedOperationKind, UsageEstimationInput, UsageEstimator, UsagePolicy } from "./agent/accounting/report.js";
+import { AgentEvent, AssistantContentTiming, BeforeStepContext, CheckpointContext, ExhaustedBudget, RequestErrorContext, StepDecision, StreamedAssistantTextPhase, TurnEndContext, TurnEndReason, TurnHooks, TurnOutcome } from "./agent/loop/events.js";
+import { TurnBounds } from "./agent/loop/types.js";
+import { ModelCallPolicyDecision, RunAccountingPort } from "./agent/accounting/contracts.js";
+import { RunTurnOptions } from "./agent/loop/turn/types.js";
+import { runTurn } from "./agent/loop/run-turn.js";
+import { InteractiveUserInputBroker, InteractiveUserInputBrokerOptions, UserInputAnswer, UserInputBroker, UserInputDecision, UserInputOption, UserInputQuestion, UserInputRequest, UserInputResponse, createUserInputBroker, fixedUserInputBroker } from "./agent/mode/user-input.js";
+import { AGENT_CONTROL_TOOLS, AgentMode, AgentRunEvent, AgentRunOutcome, BasicAgentOptions, CompletionSubmission, DeepAgentOptions, HumanInLoopAgentOptions, RunAgentOptions, runAgent } from "./agent/mode/run-agent.js";
+import { TeamMemberAttachmentOptions, TeamPort, TeamSessionPort, TeamToolAccess } from "./agent/team/contracts.js";
+import { AgentCompactionConfig, AgentCompactionOptions, resolveCompactionConfig } from "./agent/memory/compaction-config.js";
+import { RunReport, RunTerminalRecord } from "./agent/accounting/delivery-types.js";
+import { COMPACTION_INSTRUCTION, CompactionResult, ContextCompactor, ContextCompactorOptions } from "./agent/memory/compaction.js";
+import { AgentMemory, AgentMemoryConfig, AgentMemoryConfigInput, AgentMemoryItem, AgentMemoryKind, AgentMemorySeed, AgentMemorySnapshot, resolveMemoryConfig } from "./agent/memory/memory.js";
+import { MAX_SKILL_DESCRIPTION_CHARS, MAX_SKILL_ID_CHARS, MAX_SKILL_INSTRUCTIONS_CHARS, MAX_SKILL_NAME_CHARS, MAX_SKILL_RESOURCE_CHARS, MAX_SKILL_RESOURCE_PATH_CHARS, SKILL_ID_PATTERN, SkillCandidate, SkillDefinition, SkillDefinitionInput, SkillInvocationPolicy, SkillLookupOptions, SkillProvider, SkillProviderListOptions, SkillResourceBase, SkillResourceSummary, SkillSource, SkillSummary, defineSkill, defineSkillProvider, validateCandidate, validateSkillId, validateSkillResourcePath, validateSkillSource } from "./agent/skill/definition.js";
+import { SkillCatalog, SkillCatalogOptions } from "./agent/skill/catalog.js";
+import { AgentSkillOptions, ResolvedAgentSkillOptions, SKILL_TOOL_NAMES, createSkillTools, renderSkillCatalog, resolveSkillOptions } from "./agent/skill/tools.js";
+import { AgentDefinition, AgentDefinitionInput, AgentDefinitionOverrides, CloneAgentOverrides, DefinedAgent } from "./agent/define/definition.js";
+import { AgentInput, AgentInvocationOptions, AgentResponse, AgentResumeSessionOptions, AgentRunHandle, AgentRuntimeLimits, AgentSessionOptions, AgentSessionSnapshot, AgentTeamMemberOptions } from "./agent/define/session/types.js";
+import { AgentSession } from "./agent/define/session.js";
+import { AgentMemberOutcome, AgentMessageDelivery, AgentMessageRecord, AgentTeamEvent, AgentTeamMember, AgentTeamOptions, LinkAgentOptions, LinkedAgentResult, LinkedAgentSendInput, LinkedAgentTransport, SendAgentMessageRequest, SendAgentMessageResult } from "./agent/team/types.js";
+import { AgentTeam } from "./agent/team/team.js";
+import { DEFAULT_MIN_WAIT_TIMEOUT_MS, DEFAULT_WAIT_TIMEOUT_MS } from "./agent/team/common.js";
+import { DefinedAgentTeam, DefinedAgentTeamMemberInput, DefinedAgentTeamOptions, createDefinedAgentTeam } from "./agent/team/composed.js";
+import { normalizeToolPairing } from "./agent/history/normalize.js";
+import { DEFAULT_SPAWN_SETUP_TIMEOUT_MS, DEFAULT_WORKER_CLOSE_TIMEOUT_MS, ManagedAgentRole, ManagedAgentSpawnContext, ManagedAgentSpawnRequest, ManagedAgentTeam, ManagedAgentTeamOptions, ManagedAgentWorker, ManagedAgentWorkerResult, ManagedAgentWorkerStatus, ResolvedManagedAgentSpawnRequest, WriteScopeConflictPolicy, completedHistoryPrefix, createManagedAgentTeam } from "./agent/team/managed.js";
+import { AGENT_ACCOUNTING_ERROR_CODES, AgentRunError } from "./agent/accounting/error.js";
+import { authoritativeTokenUsage, budgetTokenTotal, summarizeModelCallUsage } from "./agent/accounting/usage.js";
+import { RunToolCallsOptions, ToolCallsOutcome, runToolCalls } from "./agent/loop/schedule.js";
+import { estimateContextTokens, estimateMessageTokens } from "./agent/memory/token-estimator.js";
+import { selectCompactablePrefix } from "./agent/memory/surface-compaction.js";
+import { TOOL_ERROR_CODES, ToolError, ToolErrorDisposition, toolErrorDisposition } from "./agent/tool/errors.js";
+import { RuntimeSchema, defineToolFromSchema } from "./agent/tool/schema.js";
+import { ToolExecutionBackend, ToolExecutionCapabilities, ToolExecutionRequest, ToolExecutionStore, ToolOperation, ToolOperationClaim, createToolExecutionInterceptor, localToolExecutionBackend } from "./agent/tool/execution.js";
+import { RuntimeAgent, RuntimeAgentBindingInput, RuntimeAgentDefinition, RuntimeAgentDefinitionInput, RuntimeAgentInvocationOptions, RuntimeAgentLimits, RuntimeAgentResponse, RuntimeAgentRunEvent, RuntimeAgentRunHandle, RuntimeAgentSession, RuntimeAgentSessionOptions, RuntimeAgentSessionSnapshot } from "./composition/agent/types.js";
+import { cloneAgent, defineAgent } from "./composition/agent/author.js";
+import { CapabilityIdentityConflict } from "./errors/capability-identity.js";
+import { AgentTeamMemberInput, RuntimeAgentTeam, RuntimeAgentTeamEvent, RuntimeAgentTeamOptions } from "./composition/team/types.js";
+import { AgentRuntime, AgentRuntimeOptions, RuntimeCloseReport } from "./composition/runtime/types.js";
+import { createAgentRuntime } from "./composition/runtime/public.js";
+export { AGENT_ACCOUNTING_ERROR_CODES, AGENT_CONTROL_TOOLS, type AgentCompactionConfig, type AgentCompactionOptions, type AgentDefinition, type AgentDefinitionInput, type AgentDefinitionOverrides, type AgentEvent, type AgentInput, type AgentInvocationOptions, type AgentMemberOutcome, AgentMemory, type AgentMemoryConfig, type AgentMemoryConfigInput, type AgentMemoryItem, type AgentMemoryKind, type AgentMemorySeed, type AgentMemorySnapshot, type AgentMessageDelivery, type AgentMessageRecord, type AgentMessageSource, type AgentMode, type AgentProcessSpan, type AgentResponse, type AgentResumeSessionOptions, AgentRunError, type AgentRunEvent, type AgentRunHandle, type AgentRunOutcome, type AgentRuntime, type AgentRuntimeLimits, type AgentRuntimeOptions, AgentSession, type AgentSessionOptions, type AgentSessionSnapshot, type AgentSkillOptions, type AgentSpanKind, type AgentSpanStatus, AgentTeam, type AgentTeamEvent, type AgentTeamMember, type AgentTeamMemberInput, type AgentTeamMemberOptions, type AgentTeamOptions, type ApprovalBroker, type ApprovalDecision, type ApprovalRequest, type ApprovalStateStore, type AssistantContentTiming, type AuthorizationOutcome, type AuthorizedToolCall, type BasicAgentOptions, type BeforeStepContext, COMPACTION_INSTRUCTION, type CapabilityIdentityConflict, type CheckpointContext, type CloneAgentOverrides, type CompactionBackoffReason, type CompactionResult, type CompletionSubmission, ContextCompactor, type ContextCompactorOptions, DEFAULT_MIN_WAIT_TIMEOUT_MS, DEFAULT_SPAWN_SETUP_TIMEOUT_MS, DEFAULT_WAIT_TIMEOUT_MS, DEFAULT_WORKER_CLOSE_TIMEOUT_MS, type DeepAgentOptions, type DefinedAgent, DefinedAgentTeam, type DefinedAgentTeamMemberInput, type DefinedAgentTeamOptions, type DispatchToolCallOptions, type ExhaustedBudget, History, type HistoryEntry, type HistoryEvent, type HistoryLimits, type HistorySnapshot, type HistorySurfaceNode, type HumanInLoopAgentOptions, type InteractiveApprovalBroker, type InteractiveApprovalBrokerOptions, type InteractiveUserInputBroker, type InteractiveUserInputBrokerOptions, type LinkAgentOptions, type LinkedAgentResult, type LinkedAgentSendInput, type LinkedAgentTransport, MAX_SKILL_DESCRIPTION_CHARS, MAX_SKILL_ID_CHARS, MAX_SKILL_INSTRUCTIONS_CHARS, MAX_SKILL_NAME_CHARS, MAX_SKILL_RESOURCE_CHARS, MAX_SKILL_RESOURCE_PATH_CHARS, type ManagedAgentRole, type ManagedAgentSpawnContext, type ManagedAgentSpawnRequest, ManagedAgentTeam, type ManagedAgentTeamOptions, type ManagedAgentWorker, type ManagedAgentWorkerResult, type ManagedAgentWorkerStatus, type MemorySpillStoreLimits, type ModelCallPolicyDecision, type PostToolDecision, type PreToolDecision, type PreparedToolCall, type RequestErrorContext, type ResolvedAgentSkillOptions, type ResolvedManagedAgentSpawnRequest, type RunAccountingPort, type RunAgentOptions, type RunLedgerLimits, type RunOperationCounts, type RunReport, type RunTerminalRecord, type RunToolCallsOptions, type RunTurnOptions, type RunUsageReport, type RuntimeAgent, type RuntimeAgentBindingInput, type RuntimeAgentDefinition, type RuntimeAgentDefinitionInput, type RuntimeAgentInvocationOptions, type RuntimeAgentLimits, type RuntimeAgentResponse, type RuntimeAgentRunEvent, type RuntimeAgentRunHandle, type RuntimeAgentSession, type RuntimeAgentSessionOptions, type RuntimeAgentSessionSnapshot, type RuntimeAgentTeam, type RuntimeAgentTeamEvent, type RuntimeAgentTeamOptions, type RuntimeCloseReport, type RuntimeSchema, SKILL_ID_PATTERN, SKILL_TOOL_NAMES, SPILL_TOOL_NAME, type SdkLogger, type SendAgentMessageRequest, type SendAgentMessageResult, type SkillCandidate, SkillCatalog, type SkillCatalogOptions, type SkillDefinition, type SkillDefinitionInput, type SkillInvocationPolicy, type SkillLookupOptions, type SkillProvider, type SkillProviderListOptions, type SkillResourceBase, type SkillResourceSummary, type SkillSource, type SkillSummary, type SpillRecord, type SpillSlice, type SpillStore, type StepDecision, type StreamedAssistantTextPhase, type SupportSafeError, type SurfaceOp, TOOL_ERROR_CODES, REGISTRY_ERROR_CODES as TOOL_REGISTRY_ERROR_CODES, type TeamMemberAttachmentOptions, type TeamPort, type TeamSessionPort, type TeamToolAccess, type ToolCallContext, type ToolCallPosition, type ToolCallRequest, type ToolCallsOutcome, type ToolCatalog, type ToolDefinition, ToolError, type ToolErrorDisposition, type ToolExecutionBackend, type ToolExecutionCapabilities, type ToolExecutionMode, type ToolExecutionRequest, type ToolExecutionResult, type ToolExecutionStore, type ToolFailure, type ToolFilter, type ToolInterceptor, type ToolOperation, type ToolOperationClaim, type ToolOutputOverflowPolicy, ToolRegistry, type ToolRunContext, type ToolSuccess, type TraceEvent, type TraceRef, type TraceSpanEnd, type TraceSpanStart, type TrackedOperationKind, type TruncatedText, type TurnBounds, type TurnEndContext, type TurnEndReason, type TurnHooks, type TurnOutcome, type UsageCoverageSummary, type UsageEstimationInput, type UsageEstimator, type UsagePolicy, type UserInputAnswer, type UserInputBroker, type UserInputDecision, type UserInputOption, type UserInputQuestion, type UserInputRequest, type UserInputResponse, type WriteScopeConflictPolicy, authoritativeTokenUsage, authorizeToolCall, budgetTokenTotal, buildTraceTree, cloneAgent, completedHistoryPrefix, createAgentRuntime, createApprovalBroker, createApprovalRequest, createDefinedAgentTeam, createManagedAgentTeam, createMemorySpillStore, createSkillTools, createToolExecutionInterceptor, createUserInputBroker, defineAgent, defineSkill, defineSkillProvider, defineTool, defineToolFromSchema, dispatchAuthorizedToolCall, dispatchToolCall, estimateContextTokens, estimateMessageTokens, estimateTextBlockTokens, estimateTextTokens, executionModeOf, finalizeToolCall, fixedApprovalBroker, fixedUserInputBroker, localToolExecutionBackend, normalizeToolPairing, prepareToolCall, previewForSpill, projectHistorySurface, projectMessages, readSpillTool, renderJsonValue, renderSkillCatalog, resolveCompactionConfig, resolveMemoryConfig, resolveSkillOptions, runAgent, runToolCalls, runTurn, selectCompactablePrefix, summarizeModelCallUsage, toolErrorDisposition, toolFailure, truncateMiddleToTokens, validateCandidate, validateSkillId, validateSkillResourcePath, validateSkillSource, withApprovalPersistence };

package/dist/agent.js

@@ -0,0 +1 @@
+import{AgentMemory as e,resolveMemoryConfig as t}from"./agent/memory/memory.js";import{normalizeToolPairing as n}from"./agent/history/normalize.js";import{estimateContextTokens as r,estimateMessageTokens as i}from"./agent/memory/token-estimator.js";import{selectCompactablePrefix as a}from"./agent/memory/surface-compaction.js";import{COMPACTION_INSTRUCTION as o,ContextCompactor as s}from"./agent/memory/compaction.js";import{resolveCompactionConfig as c}from"./agent/memory/compaction-config.js";import{MAX_SKILL_DESCRIPTION_CHARS as l,MAX_SKILL_ID_CHARS as u,MAX_SKILL_INSTRUCTIONS_CHARS as d,MAX_SKILL_NAME_CHARS as f,MAX_SKILL_RESOURCE_CHARS as p,MAX_SKILL_RESOURCE_PATH_CHARS as m,SKILL_ID_PATTERN as h,defineSkill as g,defineSkillProvider as _,validateCandidate as v,validateSkillId as y,validateSkillResourcePath as b,validateSkillSource as x}from"./agent/skill/definition.js";import{SkillCatalog as S}from"./agent/skill/catalog.js";import{defineTool as C,executionModeOf as w,renderJsonValue as T}from"./agent/tool/definition.js";import{SKILL_TOOL_NAMES as E,createSkillTools as D,renderSkillCatalog as O,resolveSkillOptions as k}from"./agent/skill/tools.js";import{authoritativeTokenUsage as A,budgetTokenTotal as j,summarizeModelCallUsage as M}from"./agent/accounting/usage.js";import{REGISTRY_ERROR_CODES as N,ToolRegistry as P}from"./agent/tool/registry.js";import{projectHistorySurface as F,projectMessages as I}from"./agent/history/project.js";import{History as L}from"./agent/history/history.js";import{AGENT_ACCOUNTING_ERROR_CODES as R,AgentRunError as z}from"./agent/accounting/error.js";import{buildTraceTree as B}from"./agent/trace/trace.js";import{SPILL_TOOL_NAME as V,createMemorySpillStore as H,estimateTextBlockTokens as U,estimateTextTokens as W,previewForSpill as G,readSpillTool as K,truncateMiddleToTokens as q}from"./agent/tool/output-budget.js";import{TOOL_ERROR_CODES as J,ToolError as Y,toolErrorDisposition as X}from"./agent/tool/errors.js";import{createApprovalBroker as Z,createApprovalRequest as Q,fixedApprovalBroker as $,withApprovalPersistence as ee}from"./agent/tool/approval.js";import{authorizeToolCall as te,dispatchAuthorizedToolCall as ne,dispatchToolCall as re,finalizeToolCall as ie,prepareToolCall as ae,toolFailure as oe}from"./agent/tool/pipeline.js";import{runToolCalls as se}from"./agent/loop/schedule.js";import{runTurn as ce}from"./agent/loop/run-turn.js";import{AGENT_CONTROL_TOOLS as le,runAgent as ue}from"./agent/mode/run-agent.js";import{AgentSession as de}from"./agent/define/session.js";import{DEFAULT_MIN_WAIT_TIMEOUT_MS as fe,DEFAULT_WAIT_TIMEOUT_MS as pe}from"./agent/team/common.js";import{AgentTeam as me}from"./agent/team/team.js";import{createAgentRuntime as he}from"./composition/runtime/public.js";import{cloneAgent as ge,defineAgent as _e}from"./composition/agent/author.js";import{createUserInputBroker as ve,fixedUserInputBroker as ye}from"./agent/mode/user-input.js";import{defineToolFromSchema as be}from"./agent/tool/schema.js";import{createToolExecutionInterceptor as xe,localToolExecutionBackend as Se}from"./agent/tool/execution.js";import{DefinedAgentTeam as Ce,createDefinedAgentTeam as we}from"./agent/team/composed.js";import{DEFAULT_SPAWN_SETUP_TIMEOUT_MS as Te,DEFAULT_WORKER_CLOSE_TIMEOUT_MS as Ee,ManagedAgentTeam as De,completedHistoryPrefix as Oe,createManagedAgentTeam as ke}from"./agent/team/managed.js";export{R as AGENT_ACCOUNTING_ERROR_CODES,le as AGENT_CONTROL_TOOLS,e as AgentMemory,z as AgentRunError,de as AgentSession,me as AgentTeam,o as COMPACTION_INSTRUCTION,s as ContextCompactor,fe as DEFAULT_MIN_WAIT_TIMEOUT_MS,Te as DEFAULT_SPAWN_SETUP_TIMEOUT_MS,pe as DEFAULT_WAIT_TIMEOUT_MS,Ee as DEFAULT_WORKER_CLOSE_TIMEOUT_MS,Ce as DefinedAgentTeam,L as History,l as MAX_SKILL_DESCRIPTION_CHARS,u as MAX_SKILL_ID_CHARS,d as MAX_SKILL_INSTRUCTIONS_CHARS,f as MAX_SKILL_NAME_CHARS,p as MAX_SKILL_RESOURCE_CHARS,m as MAX_SKILL_RESOURCE_PATH_CHARS,De as ManagedAgentTeam,h as SKILL_ID_PATTERN,E as SKILL_TOOL_NAMES,V as SPILL_TOOL_NAME,S as SkillCatalog,J as TOOL_ERROR_CODES,N as TOOL_REGISTRY_ERROR_CODES,Y as ToolError,P as ToolRegistry,A as authoritativeTokenUsage,te as authorizeToolCall,j as budgetTokenTotal,B as buildTraceTree,ge as cloneAgent,Oe as completedHistoryPrefix,he as createAgentRuntime,Z as createApprovalBroker,Q as createApprovalRequest,we as createDefinedAgentTeam,ke as createManagedAgentTeam,H as createMemorySpillStore,D as createSkillTools,xe as createToolExecutionInterceptor,ve as createUserInputBroker,_e as defineAgent,g as defineSkill,_ as defineSkillProvider,C as defineTool,be as defineToolFromSchema,ne as dispatchAuthorizedToolCall,re as dispatchToolCall,r as estimateContextTokens,i as estimateMessageTokens,U as estimateTextBlockTokens,W as estimateTextTokens,w as executionModeOf,ie as finalizeToolCall,$ as fixedApprovalBroker,ye as fixedUserInputBroker,Se as localToolExecutionBackend,n as normalizeToolPairing,ae as prepareToolCall,G as previewForSpill,F as projectHistorySurface,I as projectMessages,K as readSpillTool,T as renderJsonValue,O as renderSkillCatalog,c as resolveCompactionConfig,t as resolveMemoryConfig,k as resolveSkillOptions,ue as runAgent,se as runToolCalls,ce as runTurn,a as selectCompactablePrefix,M as summarizeModelCallUsage,X as toolErrorDisposition,oe as toolFailure,q as truncateMiddleToTokens,v as validateCandidate,y as validateSkillId,b as validateSkillResourcePath,x as validateSkillSource,ee as withApprovalPersistence};

package/dist/async/settlement.d.ts

@@ -0,0 +1,6 @@
+//#region src/async/settlement.d.ts
+/** Bounded waiting for cooperative teardown paths. */
+declare function waitForSettlement(promise: Promise<unknown>, timeoutMs: number): Promise<boolean>;
+//#endregion
+export { waitForSettlement };
+//# sourceMappingURL=settlement.d.ts.map

package/dist/async/settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.d.ts","names":[],"sources":["../../src/async/settlement.ts"],"mappings":";;iBAEsB,kBACpB,SAAS,kBACT,oBACC"}

package/dist/async/settlement.js

@@ -0,0 +1,2 @@
+async function e(e,t){if(!Number.isFinite(t)||t<=0)throw RangeError(`settlement timeoutMs must be a positive finite number`);let n,r=e.then(()=>!0,()=>!0),i=new Promise(e=>{n=setTimeout(()=>e(!1),t)});try{return await Promise.race([r,i])}finally{n!==void 0&&clearTimeout(n)}}export{e as waitForSettlement};
+//# sourceMappingURL=settlement.js.map

package/dist/async/settlement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.js","names":[],"sources":["../../src/async/settlement.ts"],"sourcesContent":["/** Bounded waiting for cooperative teardown paths. */\n\nexport async function waitForSettlement(\n  promise: Promise<unknown>,\n  timeoutMs: number,\n): Promise<boolean> {\n  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n    throw new RangeError('settlement timeoutMs must be a positive finite number')\n  }\n  let timer: ReturnType<typeof setTimeout> | undefined\n  const settled = promise.then(() => true, () => true)\n  const expired = new Promise<false>(resolve => {\n    timer = setTimeout(() => resolve(false), timeoutMs)\n  })\n  try {\n    return await Promise.race([settled, expired])\n  } finally {\n    if (timer !== undefined) clearTimeout(timer)\n  }\n}\n"],"mappings":"AAEA,eAAsB,EACpB,EACA,EACkB,CAClB,GAAI,CAAC,OAAO,SAAS,CAAS,GAAK,GAAa,EAC9C,MAAU,WAAW,uDAAuD,EAE9E,IAAI,EACE,EAAU,EAAQ,SAAW,OAAY,EAAI,EAC7C,EAAU,IAAI,QAAe,GAAW,CAC5C,EAAQ,eAAiB,EAAQ,EAAK,EAAG,CAAS,CACpD,CAAC,EACD,GAAI,CACF,OAAO,MAAM,QAAQ,KAAK,CAAC,EAAS,CAAO,CAAC,CAC9C,QAAU,CACJ,IAAU,IAAA,IAAW,aAAa,CAAK,CAC7C,CACF"}

package/dist/capability/common/config.js

@@ -0,0 +1,2 @@
+const e=Object.freeze({providers:128,exporters:128,routesPerProvider:128,identityBytes:256,displayNameBytes:1024,modelIdBytes:1024}),t=Object.freeze({INVALID:`MODEL_TARGET_INVALID`,UNKNOWN_ROUTE:`MODEL_ROUTE_UNAVAILABLE`,MISSING_DEFAULT:`MODEL_DEFAULT_MISSING`,AMBIGUOUS_DEFAULT:`MODEL_DEFAULT_AMBIGUOUS`});export{e as COMPOSITION_LIMITS,t as MODEL_BINDING_ERROR_CODES};
+//# sourceMappingURL=config.js.map

package/dist/capability/common/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../../../src/capability/common/config.ts"],"sourcesContent":["/** Shared resource bounds for inert capability metadata; no model/provider defaults. */\nexport const COMPOSITION_LIMITS = Object.freeze({\n  providers: 128,\n  exporters: 128,\n  routesPerProvider: 128,\n  identityBytes: 256,\n  displayNameBytes: 1_024,\n  modelIdBytes: 1_024,\n})\n\nexport const MODEL_BINDING_ERROR_CODES = Object.freeze({\n  INVALID: 'MODEL_TARGET_INVALID',\n  UNKNOWN_ROUTE: 'MODEL_ROUTE_UNAVAILABLE',\n  MISSING_DEFAULT: 'MODEL_DEFAULT_MISSING',\n  AMBIGUOUS_DEFAULT: 'MODEL_DEFAULT_AMBIGUOUS',\n})\n"],"mappings":"AACA,MAAa,EAAqB,OAAO,OAAO,CAC9C,UAAW,IACX,UAAW,IACX,kBAAmB,IACnB,cAAe,IACf,iBAAkB,KAClB,aAAc,IAChB,CAAC,EAEY,EAA4B,OAAO,OAAO,CACrD,QAAS,uBACT,cAAe,0BACf,gBAAiB,wBACjB,kBAAmB,yBACrB,CAAC"}

package/dist/capability/common/data.js

@@ -0,0 +1,2 @@
+function e(e){if(typeof e!=`object`||!e||Array.isArray(e))throw TypeError(`Expected a composition data object`);return e}function t(e,t,n=!0){let r=Object.getOwnPropertyDescriptor(e,t);if(r===void 0){if(!n)return;throw TypeError(`Required composition data field is absent`)}if(!(`value`in r))throw TypeError(`Composition metadata must not use accessors`);return r.value}function n(e,t){if(typeof e!=`string`||e.length===0||e.trim()!==e||e.length>t||new TextEncoder().encode(e).byteLength>t)throw TypeError(`Invalid bounded composition text`);return e}function r(e,n){if(!Array.isArray(e))throw TypeError(`Expected a composition data array`);let r=t(e,`length`);if(!Number.isSafeInteger(r)||Number(r)<0||Number(r)>n)throw TypeError(`Composition array exceeds its bound`);let i=[];for(let n=0;n<Number(r);n++)i.push(t(e,String(n)));return Object.freeze(i)}function i(e){if(e!==void 0){if(!(e instanceof AbortSignal))throw TypeError(`Invalid AbortSignal`);return e}}function a(e,t){let n=Reflect.get(e,t);if(typeof n!=`function`)throw TypeError(`Required capability method is absent`);return(...t)=>Reflect.apply(n,e,t)}function o(e,t){let n=Reflect.get(e,t);if(n!==void 0){if(typeof n!=`function`)throw TypeError(`Optional capability method is invalid`);return(...t)=>Reflect.apply(n,e,t)}}export{r as arrayData,n as boundedText,a as capturedMethod,o as capturedOptionalMethod,e as objectValue,i as optionalAbortSignal,t as ownData};
+//# sourceMappingURL=data.js.map

package/dist/capability/common/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","names":[],"sources":["../../../src/capability/common/data.ts"],"sourcesContent":["/** Data fields never invoke accessors. Proxy reflection failures are handled by the caller. */\nexport function objectValue(value: unknown): object {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    throw new TypeError('Expected a composition data object')\n  }\n  return value\n}\n\nexport function ownData(value: object, key: string, required = true): unknown {\n  const descriptor = Object.getOwnPropertyDescriptor(value, key)\n  if (descriptor === undefined) {\n    if (!required) return undefined\n    throw new TypeError('Required composition data field is absent')\n  }\n  if (!('value' in descriptor)) throw new TypeError('Composition metadata must not use accessors')\n  return descriptor.value\n}\n\nexport function boundedText(value: unknown, maxBytes: number): string {\n  if (typeof value !== 'string' || value.length === 0 || value.trim() !== value\n    || value.length > maxBytes || new TextEncoder().encode(value).byteLength > maxBytes) {\n    throw new TypeError('Invalid bounded composition text')\n  }\n  return value\n}\n\nexport function arrayData(value: unknown, maxItems: number): readonly unknown[] {\n  if (!Array.isArray(value)) throw new TypeError('Expected a composition data array')\n  const length = ownData(value, 'length')\n  if (!Number.isSafeInteger(length) || Number(length) < 0 || Number(length) > maxItems) {\n    throw new TypeError('Composition array exceeds its bound')\n  }\n  const result: unknown[] = []\n  for (let index = 0; index < Number(length); index++) result.push(ownData(value, String(index)))\n  return Object.freeze(result)\n}\n\nexport function optionalAbortSignal(value: unknown): AbortSignal | undefined {\n  if (value === undefined) return undefined\n  if (!(value instanceof AbortSignal)) throw new TypeError('Invalid AbortSignal')\n  return value\n}\n\nexport function capturedMethod<Args extends readonly unknown[], Result>(\n  receiver: object,\n  key: string,\n): (...args: Args) => Result {\n  const method: unknown = Reflect.get(receiver, key)\n  if (typeof method !== 'function') throw new TypeError('Required capability method is absent')\n  return (...args: Args): Result => Reflect.apply(method, receiver, args) as Result\n}\n\nexport function capturedOptionalMethod<Args extends readonly unknown[], Result>(\n  receiver: object,\n  key: string,\n): ((...args: Args) => Result) | undefined {\n  const method: unknown = Reflect.get(receiver, key)\n  if (method === undefined) return undefined\n  if (typeof method !== 'function') throw new TypeError('Optional capability method is invalid')\n  return (...args: Args): Result => Reflect.apply(method, receiver, args) as Result\n}\n"],"mappings":"AACA,SAAgB,EAAY,EAAwB,CAClD,GAAI,OAAO,GAAU,WAAY,GAAkB,MAAM,QAAQ,CAAK,EACpE,MAAU,UAAU,oCAAoC,EAE1D,OAAO,CACT,CAEA,SAAgB,EAAQ,EAAe,EAAa,EAAW,GAAe,CAC5E,IAAM,EAAa,OAAO,yBAAyB,EAAO,CAAG,EAC7D,GAAI,IAAe,IAAA,GAAW,CAC5B,GAAI,CAAC,EAAU,OACf,MAAU,UAAU,2CAA2C,CACjE,CACA,GAAI,EAAE,UAAW,GAAa,MAAU,UAAU,6CAA6C,EAC/F,OAAO,EAAW,KACpB,CAEA,SAAgB,EAAY,EAAgB,EAA0B,CACpE,GAAI,OAAO,GAAU,UAAY,EAAM,SAAW,GAAK,EAAM,KAAK,IAAM,GACnE,EAAM,OAAS,GAAY,IAAI,YAAY,CAAC,CAAC,OAAO,CAAK,CAAC,CAAC,WAAa,EAC3E,MAAU,UAAU,kCAAkC,EAExD,OAAO,CACT,CAEA,SAAgB,EAAU,EAAgB,EAAsC,CAC9E,GAAI,CAAC,MAAM,QAAQ,CAAK,EAAG,MAAU,UAAU,mCAAmC,EAClF,IAAM,EAAS,EAAQ,EAAO,QAAQ,EACtC,GAAI,CAAC,OAAO,cAAc,CAAM,GAAK,OAAO,CAAM,EAAI,GAAK,OAAO,CAAM,EAAI,EAC1E,MAAU,UAAU,qCAAqC,EAE3D,IAAM,EAAoB,CAAC,EAC3B,IAAK,IAAI,EAAQ,EAAG,EAAQ,OAAO,CAAM,EAAG,IAAS,EAAO,KAAK,EAAQ,EAAO,OAAO,CAAK,CAAC,CAAC,EAC9F,OAAO,OAAO,OAAO,CAAM,CAC7B,CAEA,SAAgB,EAAoB,EAAyC,CACvE,OAAU,IAAA,GACd,IAAI,EAAE,aAAiB,aAAc,MAAU,UAAU,qBAAqB,EAC9E,OAAO,CADuE,CAEhF,CAEA,SAAgB,EACd,EACA,EAC2B,CAC3B,IAAM,EAAkB,QAAQ,IAAI,EAAU,CAAG,EACjD,GAAI,OAAO,GAAW,WAAY,MAAU,UAAU,sCAAsC,EAC5F,OAAQ,GAAG,IAAuB,QAAQ,MAAM,EAAQ,EAAU,CAAI,CACxE,CAEA,SAAgB,EACd,EACA,EACyC,CACzC,IAAM,EAAkB,QAAQ,IAAI,EAAU,CAAG,EAC7C,OAAW,IAAA,GACf,IAAI,OAAO,GAAW,WAAY,MAAU,UAAU,uCAAuC,EAC7F,OAAQ,GAAG,IAAuB,QAAQ,MAAM,EAAQ,EAAU,CAAI,CADuB,CAE/F"}

package/dist/composition/agent/author.d.ts

@@ -0,0 +1,12 @@
+import { AgentDefinition, AgentDefinitionInput, CloneAgentOverrides, DefinedAgent } from "../../agent/define/definition.js";
+import { RuntimeAgentDefinition, RuntimeAgentDefinitionInput } from "./types.js";
+//#region src/composition/agent/author.d.ts
+declare function defineAgent(input: RuntimeAgentDefinitionInput): RuntimeAgentDefinition;
+declare function defineAgent(input: AgentDefinitionInput): DefinedAgent;
+declare function cloneAgent(source: AgentDefinition, overrides: CloneAgentOverrides): DefinedAgent;
+declare function cloneAgent(source: RuntimeAgentDefinition, overrides: Partial<Omit<RuntimeAgentDefinitionInput, 'id'>> & {
+  readonly id: string;
+}): RuntimeAgentDefinition;
+//#endregion
+export { cloneAgent, defineAgent };
+//# sourceMappingURL=author.d.ts.map

package/dist/composition/agent/author.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"author.d.ts","names":[],"sources":["../../../src/composition/agent/author.ts"],"mappings":";;;iBAYgB,YAAY,OAAO,8BAA8B;iBACjD,YAAY,OAAO,uBAAuB;iBAS1C,WAAW,QAAQ,iBAAiB,WAAW,sBAAsB;iBACrE,WACd,QAAQ,wBACR,WAAW,QAAQ,KAAK;WAAiD;IACxE"}

package/dist/composition/agent/author.js

@@ -0,0 +1,2 @@
+import{objectValue as e,ownData as t}from"../../capability/common/data.js";import{cloneAgent as n,defineAgent as r}from"../../agent/define/definition.js";import{cloneRuntimeAgentDefinition as i,defineRuntimeAgentDefinition as a}from"./definition.js";function o(e){return c(e)?a(e):r(e)}function s(e,t){return c(e)?i(e,t):n(e,t)}function c(n){let r=e(n),i=t(r,`model`,!1);if(i===void 0||typeof i==`string`)return!1;if(typeof i==`object`&&i&&!Array.isArray(i))return!0;throw TypeError(`Agent model must be a string, a model target object, or omitted`)}export{s as cloneAgent,o as defineAgent};
+//# sourceMappingURL=author.js.map

package/dist/composition/agent/author.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"author.js","names":["defineAdvancedAgent","cloneAdvancedAgent"],"sources":["../../../src/composition/agent/author.ts"],"sourcesContent":["import {\n  cloneAgent as cloneAdvancedAgent,\n  defineAgent as defineAdvancedAgent,\n  type AgentDefinition,\n  type AgentDefinitionInput,\n  type CloneAgentOverrides,\n  type DefinedAgent,\n} from '../../agent/define/definition.ts'\nimport { objectValue, ownData } from '../common/data.ts'\nimport { cloneRuntimeAgentDefinition, defineRuntimeAgentDefinition } from './definition.ts'\nimport type { RuntimeAgentDefinition, RuntimeAgentDefinitionInput } from './types.ts'\n\nexport function defineAgent(input: RuntimeAgentDefinitionInput): RuntimeAgentDefinition\nexport function defineAgent(input: AgentDefinitionInput): DefinedAgent\nexport function defineAgent(\n  input: AgentDefinitionInput | RuntimeAgentDefinitionInput,\n): DefinedAgent | RuntimeAgentDefinition {\n  return runtimeDiscriminant(input)\n    ? defineRuntimeAgentDefinition(input as RuntimeAgentDefinitionInput)\n    : defineAdvancedAgent(input as AgentDefinitionInput)\n}\n\nexport function cloneAgent(source: AgentDefinition, overrides: CloneAgentOverrides): DefinedAgent\nexport function cloneAgent(\n  source: RuntimeAgentDefinition,\n  overrides: Partial<Omit<RuntimeAgentDefinitionInput, 'id'>> & { readonly id: string },\n): RuntimeAgentDefinition\nexport function cloneAgent(\n  source: AgentDefinition | RuntimeAgentDefinition,\n  overrides: CloneAgentOverrides | (Partial<Omit<RuntimeAgentDefinitionInput, 'id'>> & { readonly id: string }),\n): DefinedAgent | RuntimeAgentDefinition {\n  return runtimeDiscriminant(source)\n    ? cloneRuntimeAgentDefinition(source as RuntimeAgentDefinition,\n      overrides as Partial<Omit<RuntimeAgentDefinitionInput, 'id'>> & { readonly id: string })\n    : cloneAdvancedAgent(source as AgentDefinition, overrides as CloneAgentOverrides)\n}\n\nfunction runtimeDiscriminant(value: unknown): boolean {\n  const source = objectValue(value)\n  const model = ownData(source, 'model', false)\n  if (model === undefined || typeof model === 'string') return false\n  if (typeof model === 'object' && model !== null && !Array.isArray(model)) return true\n  throw new TypeError('Agent model must be a string, a model target object, or omitted')\n}\n"],"mappings":"0PAcA,SAAgB,EACd,EACuC,CACvC,OAAO,EAAoB,CAAK,EAC5B,EAA6B,CAAoC,EACjEA,EAAoB,CAA6B,CACvD,CAOA,SAAgB,EACd,EACA,EACuC,CACvC,OAAO,EAAoB,CAAM,EAC7B,EAA4B,EAC5B,CAAuF,EACvFC,EAAmB,EAA2B,CAAgC,CACpF,CAEA,SAAS,EAAoB,EAAyB,CACpD,IAAM,EAAS,EAAY,CAAK,EAC1B,EAAQ,EAAQ,EAAQ,QAAS,EAAK,EAC5C,GAAI,IAAU,IAAA,IAAa,OAAO,GAAU,SAAU,MAAO,GAC7D,GAAI,OAAO,GAAU,UAAY,GAAkB,CAAC,MAAM,QAAQ,CAAK,EAAG,MAAO,GACjF,MAAU,UAAU,iEAAiE,CACvF"}

package/dist/composition/agent/definition.js

@@ -0,0 +1,2 @@
+import{ReasoningEffortId as e}from"../../primitives/brand.js";import{objectValue as t,ownData as n}from"../../capability/common/data.js";import{captureMemoryBinding as r}from"../memory/definition.js";import{captureRuntimeSkillSources as i}from"../../agent/skill/provider/definition.js";import{captureToolDefinitions as a}from"../../agent/tool/capture.js";import{captureModelTarget as o,resolveAgentModel as s}from"../provider/model-selection.js";import{defineAgent as c}from"../../agent/define/definition.js";import{captureToolSources as l}from"../tool-source/definition.js";import{captureNativeTools as u,captureToolChoice as d}from"./native-tools.js";import{captureRuntimeContextSections as f}from"./policy.js";import{assertAgentIdentitySnapshot as p}from"../identity/agent.js";const m=new Set([`id`,`name`,`description`,`model`,`instructions`,`effort`,`maxTokens`,`mode`,`tools`,`nativeTools`,`toolChoice`,`outputFormat`,`toolSources`,`skills`,`allowedSkillIds`,`memory`,`contextSections`,`compaction`,`maxTurns`,`maxToolCalls`,`commentary`]);function h(e){let t=v(e),n=_(e,Object.freeze({providers:Object.freeze([Object.freeze({id:`definition-author`,displayName:`Definition author`,family:`definition-author`,routes:Object.freeze([t.provider]),defaultModel:t})])})),r=n.legacy;return Object.freeze({id:r.id,name:r.name,...r.description===void 0?{}:{description:r.description},model:t,instructions:r.instructions,...n.effort===void 0?{}:{effort:n.effort},...n.maxTokens===void 0?{}:{maxTokens:n.maxTokens},mode:r.mode,tools:r.tools,nativeTools:r.nativeTools,...r.toolChoice===void 0?{}:{toolChoice:r.toolChoice},...r.outputFormat===void 0?{}:{outputFormat:r.outputFormat},toolSources:n.toolSources,skills:r.skills,...r.skillIds===void 0?{}:{allowedSkillIds:r.skillIds},...n.memory===void 0?{}:{memory:n.memory},compaction:y(r.compaction),maxTurns:r.maxTurns,maxToolCalls:r.maxToolCalls,commentary:r.commentary})}function g(e,r){let i=t(e),a=t(r);if(Reflect.ownKeys(a).some(e=>typeof e!=`string`||!m.has(e)))throw TypeError(`Runtime agent overrides contain unsupported fields`);let o=Object.create(null);for(let e of m){let t=n(a,e,!1),r=t===void 0?n(i,e,!1):t;r!==void 0&&(o[e]=r)}if(n(a,`id`,!1)===void 0)throw TypeError(`Runtime agent clone requires an id`);return h(o)}function _(o,h){let g=t(o);if(Reflect.ownKeys(g).some(e=>typeof e!=`string`||!m.has(e)))throw TypeError(`Runtime agent definition contains unsupported fields`);let _=Object.fromEntries([...m].map(e=>[e,n(g,e,!1)])),v=s(h,_.model);if(_.effort!==void 0&&typeof _.effort!=`string`)throw TypeError(`Runtime agent effort must be a string`);let y=_.effort===void 0?void 0:e(_.effort),b=_.maxTokens,x=_.tools===void 0?void 0:a(_.tools),S=l(_.toolSources),C=u(_.nativeTools),w=d(_.toolChoice),T=_.memory===void 0?void 0:r(_.memory),E=_.skills===void 0?void 0:i(_.skills),D=f(_.contextSections);p({...x===void 0?{}:{tools:x},nativeTools:C,...E===void 0?{}:{skills:E},..._.allowedSkillIds===void 0?{}:{allowedSkillIds:_.allowedSkillIds}});let O=c({id:_.id,..._.name===void 0?{}:{name:_.name},..._.description===void 0?{}:{description:_.description},provider:v.provider,model:v.id,effort:y??`medium`,...b===void 0?{}:{maxTokens:b},instructions:_.instructions,..._.mode===void 0?{}:{mode:_.mode},...x===void 0?{}:{tools:x},...C.length===0?{}:{nativeTools:C},...E===void 0?{}:{skills:E},..._.allowedSkillIds===void 0?{}:{skillIds:_.allowedSkillIds},...w===void 0?{}:{toolChoice:w},...D===void 0?{}:{contextSections:D},..._.outputFormat===void 0?{}:{outputFormat:_.outputFormat},..._.compaction===void 0?{}:{compaction:_.compaction},..._.maxTurns===void 0?{}:{maxTurns:_.maxTurns},..._.maxToolCalls===void 0?{}:{maxToolCalls:_.maxToolCalls},..._.commentary===void 0?{}:{commentary:_.commentary}});return Object.freeze({model:v,...y===void 0?{}:{effort:y},...b===void 0?{}:{maxTokens:b},legacy:O,toolSources:S,...T===void 0?{}:{memory:T}})}function v(e){let r=t(e);if(Reflect.ownKeys(r).some(e=>typeof e!=`string`||!m.has(e)))throw TypeError(`Runtime agent definition contains unsupported fields`);return o(n(r,`model`),!1)}function y(e){return e!==!1&&Object.freeze({auto:e.auto,...e.maxInputTokens===void 0?{}:{maxInputTokens:e.maxInputTokens},thresholdRatio:e.thresholdRatio,...e.retainRatio===void 0?{}:{retainRatio:e.retainRatio},...e.retainTokens===void 0?{}:{retainTokens:e.retainTokens},...e.summarizationProvider===void 0?{}:{summarizationProvider:e.summarizationProvider},...e.summarizationModel===void 0?{}:{summarizationModel:e.summarizationModel},...e.summarizationEffort===void 0?{}:{summarizationEffort:e.summarizationEffort},maxSummaryTokens:e.maxSummaryTokens,compactionRetries:e.compactionRetries,maxOverflowRetries:e.maxOverflowRetries,maxSummaryInputChars:e.maxSummaryInputChars,maxSummaryRequestChars:e.maxSummaryRequestChars,maxSummaryRequestBytes:e.maxSummaryRequestBytes,maxSummaryResponseBytes:e.maxSummaryResponseBytes,maxSummaryStreamEvents:e.maxSummaryStreamEvents,summaryTimeoutMs:e.summaryTimeoutMs,teardownTimeoutMs:e.teardownTimeoutMs,maxToolResultChars:e.maxToolResultChars})}export{_ as bindRuntimeAgentDefinition,g as cloneRuntimeAgentDefinition,h as defineRuntimeAgentDefinition};
+//# sourceMappingURL=definition.js.map

package/dist/composition/agent/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","names":[],"sources":["../../../src/composition/agent/definition.ts"],"sourcesContent":["import { defineAgent, type DefinedAgent } from '../../agent/define/definition.ts'\nimport { ReasoningEffortId } from '../../primitives/brand.ts'\nimport { objectValue, ownData } from '../common/data.ts'\nimport { captureModelTarget, resolveAgentModel } from '../provider/model-selection.ts'\nimport type { ModelTarget, ProviderSelection } from '../provider/types.ts'\nimport type {\n  RuntimeAgentBindingInput, RuntimeAgentDefinition, RuntimeAgentDefinitionInput,\n} from './types.ts'\nimport { captureToolDefinitions } from '../../agent/tool/capture.ts'\nimport { captureToolSources } from '../tool-source/definition.ts'\nimport type { CapturedToolSource } from '../tool-source/types.ts'\nimport { captureNativeTools, captureToolChoice } from './native-tools.ts'\nimport { captureMemoryBinding } from '../memory/definition.ts'\nimport type { CapturedMemoryBinding } from '../memory/types.ts'\nimport { captureRuntimeSkillSources } from '../skill-provider/definition.ts'\nimport { captureRuntimeContextSections } from './policy.ts'\nimport type { AgentCompactionConfig, AgentCompactionOptions } from '../../agent/memory/compaction-config.ts'\nimport { assertAgentIdentitySnapshot } from '../identity/agent.ts'\n\nconst KEYS = new Set(['id', 'name', 'description', 'model', 'instructions', 'effort', 'maxTokens', 'mode',\n  'tools', 'nativeTools', 'toolChoice', 'outputFormat', 'toolSources', 'skills', 'allowedSkillIds', 'memory',\n  'contextSections', 'compaction',\n  'maxTurns', 'maxToolCalls', 'commentary'])\n\nexport interface BoundRuntimeAgentDefinition {\n  readonly model: ModelTarget\n  readonly effort?: ReturnType<typeof ReasoningEffortId>\n  readonly maxTokens?: number\n  readonly legacy: DefinedAgent\n  readonly toolSources: readonly CapturedToolSource[]\n  readonly memory?: CapturedMemoryBinding\n}\n\n/** Validate and detach one reusable runtime definition without resolving a live provider. */\nexport function defineRuntimeAgentDefinition(input: RuntimeAgentDefinitionInput): RuntimeAgentDefinition {\n  const target = captureAuthorTarget(input)\n  const selection: ProviderSelection = Object.freeze({ providers: Object.freeze([Object.freeze({\n    id: 'definition-author', displayName: 'Definition author', family: 'definition-author',\n    routes: Object.freeze([target.provider]), defaultModel: target,\n  })]) })\n  const bound = bindRuntimeAgentDefinition(input, selection)\n  const legacy = bound.legacy\n  return Object.freeze({ id: legacy.id, name: legacy.name,\n    ...(legacy.description === undefined ? {} : { description: legacy.description }),\n    model: target, instructions: legacy.instructions,\n    ...(bound.effort === undefined ? {} : { effort: bound.effort }),\n    ...(bound.maxTokens === undefined ? {} : { maxTokens: bound.maxTokens }),\n    mode: legacy.mode, tools: legacy.tools, nativeTools: legacy.nativeTools,\n    ...(legacy.toolChoice === undefined ? {} : { toolChoice: legacy.toolChoice }),\n    ...(legacy.outputFormat === undefined ? {} : { outputFormat: legacy.outputFormat }),\n    toolSources: bound.toolSources, skills: legacy.skills,\n    ...(legacy.skillIds === undefined ? {} : { allowedSkillIds: legacy.skillIds }),\n    ...(bound.memory === undefined ? {} : { memory: bound.memory }),\n    compaction: compactionInput(legacy.compaction), maxTurns: legacy.maxTurns,\n    maxToolCalls: legacy.maxToolCalls, commentary: legacy.commentary })\n}\n\nexport function cloneRuntimeAgentDefinition(\n  sourceValue: RuntimeAgentDefinition,\n  overridesValue: Partial<Omit<RuntimeAgentDefinitionInput, 'id'>> & { readonly id: string },\n): RuntimeAgentDefinition {\n  const source = objectValue(sourceValue), overrides = objectValue(overridesValue)\n  if (Reflect.ownKeys(overrides).some(key => typeof key !== 'string' || !KEYS.has(key))) {\n    throw new TypeError('Runtime agent overrides contain unsupported fields')\n  }\n  const merged: Record<string, unknown> = Object.create(null) as Record<string, unknown>\n  for (const key of KEYS) {\n    const override = ownData(overrides, key, false)\n    const value = override === undefined ? ownData(source, key, false) : override\n    if (value !== undefined) merged[key] = value\n  }\n  if (ownData(overrides, 'id', false) === undefined) throw new TypeError('Runtime agent clone requires an id')\n  return defineRuntimeAgentDefinition(merged as unknown as RuntimeAgentDefinitionInput)\n}\n\n/** Capture one runtime definition and resolve its immutable target before any model operation. */\nexport function bindRuntimeAgentDefinition(\n  input: RuntimeAgentBindingInput,\n  selection: ProviderSelection,\n): BoundRuntimeAgentDefinition {\n  const source = objectValue(input)\n  if (Reflect.ownKeys(source).some(key => typeof key !== 'string' || !KEYS.has(key))) {\n    throw new TypeError('Runtime agent definition contains unsupported fields')\n  }\n  const values = Object.fromEntries([...KEYS].map(key => [key, ownData(source, key, false)])) as Record<string, unknown>\n  const target = resolveAgentModel(selection, values.model)\n  if (values.effort !== undefined && typeof values.effort !== 'string') throw new TypeError('Runtime agent effort must be a string')\n  const effort = values.effort === undefined ? undefined : ReasoningEffortId(values.effort)\n  const maxTokens = values.maxTokens as number | undefined\n  const tools = values.tools === undefined ? undefined : captureToolDefinitions(values.tools)\n  const toolSources = captureToolSources(values.toolSources)\n  const nativeTools = captureNativeTools(values.nativeTools)\n  const toolChoice = captureToolChoice(values.toolChoice)\n  const memory = values.memory === undefined ? undefined : captureMemoryBinding(values.memory)\n  const skills = values.skills === undefined ? undefined : captureRuntimeSkillSources(values.skills)\n  const contextSections = captureRuntimeContextSections(values.contextSections)\n  assertAgentIdentitySnapshot({ ...(tools === undefined ? {} : { tools }), nativeTools,\n    ...(skills === undefined ? {} : { skills }), ...(values.allowedSkillIds === undefined ? {} : {\n      allowedSkillIds: values.allowedSkillIds as readonly string[],\n    }) })\n  const legacy = defineAgent({\n    id: values.id as string,\n    ...(values.name === undefined ? {} : { name: values.name as string }),\n    ...(values.description === undefined ? {} : { description: values.description as string }),\n    provider: target.provider, model: target.id,\n    // Legacy definitions require a value; the runtime session override below preserves omission.\n    effort: effort ?? 'medium',\n    ...(maxTokens === undefined ? {} : { maxTokens }), instructions: values.instructions as string,\n    ...(values.mode === undefined ? {} : { mode: values.mode as NonNullable<RuntimeAgentBindingInput['mode']> }),\n    ...(tools === undefined ? {} : { tools }),\n    ...(nativeTools.length === 0 ? {} : { nativeTools }),\n    ...(skills === undefined ? {} : { skills: skills as DefinedAgent['skills'] }),\n    ...(values.allowedSkillIds === undefined ? {} : { skillIds: values.allowedSkillIds as readonly string[] }),\n    ...(toolChoice === undefined ? {} : { toolChoice }),\n    ...(contextSections === undefined ? {} : { contextSections }),\n    ...(values.outputFormat === undefined ? {} : {\n      outputFormat: values.outputFormat as NonNullable<RuntimeAgentBindingInput['outputFormat']>,\n    }),\n    ...(values.compaction === undefined ? {} : { compaction: values.compaction as NonNullable<RuntimeAgentBindingInput['compaction']> }),\n    ...(values.maxTurns === undefined ? {} : { maxTurns: values.maxTurns as number | 'auto' }),\n    ...(values.maxToolCalls === undefined ? {} : { maxToolCalls: values.maxToolCalls as number }),\n    ...(values.commentary === undefined ? {} : { commentary: values.commentary as NonNullable<RuntimeAgentBindingInput['commentary']> }),\n  })\n  return Object.freeze({ model: target, ...(effort === undefined ? {} : { effort }),\n    ...(maxTokens === undefined ? {} : { maxTokens }), legacy, toolSources,\n    ...(memory === undefined ? {} : { memory }) })\n}\n\nfunction captureAuthorTarget(input: RuntimeAgentDefinitionInput): ModelTarget {\n  const source = objectValue(input)\n  if (Reflect.ownKeys(source).some(key => typeof key !== 'string' || !KEYS.has(key))) {\n    throw new TypeError('Runtime agent definition contains unsupported fields')\n  }\n  return captureModelTarget(ownData(source, 'model'), false)\n}\n\nfunction compactionInput(value: AgentCompactionConfig | false): AgentCompactionOptions | false {\n  if (value === false) return false\n  return Object.freeze({ auto: value.auto,\n    ...(value.maxInputTokens === undefined ? {} : { maxInputTokens: value.maxInputTokens }),\n    thresholdRatio: value.thresholdRatio,\n    ...(value.retainRatio === undefined ? {} : { retainRatio: value.retainRatio }),\n    ...(value.retainTokens === undefined ? {} : { retainTokens: value.retainTokens }),\n    ...(value.summarizationProvider === undefined ? {} : { summarizationProvider: value.summarizationProvider }),\n    ...(value.summarizationModel === undefined ? {} : { summarizationModel: value.summarizationModel }),\n    ...(value.summarizationEffort === undefined ? {} : { summarizationEffort: value.summarizationEffort }),\n    maxSummaryTokens: value.maxSummaryTokens, compactionRetries: value.compactionRetries,\n    maxOverflowRetries: value.maxOverflowRetries, maxSummaryInputChars: value.maxSummaryInputChars,\n    maxSummaryRequestChars: value.maxSummaryRequestChars, maxSummaryRequestBytes: value.maxSummaryRequestBytes,\n    maxSummaryResponseBytes: value.maxSummaryResponseBytes, maxSummaryStreamEvents: value.maxSummaryStreamEvents,\n    summaryTimeoutMs: value.summaryTimeoutMs, teardownTimeoutMs: value.teardownTimeoutMs,\n    maxToolResultChars: value.maxToolResultChars })\n}\n"],"mappings":"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"}

package/dist/composition/agent/native-event.js

@@ -0,0 +1,2 @@
+import{cloneJsonValue as e}from"../common/json-data.js";import{publicContent as t}from"./public-message.js";function n(e,n){let a=r(e.arguments),o=e.content.length===0?void 0:r(t(e.content));return{type:`assistant-native-tool`,callId:e.id,provider:n,name:e.name,status:i(e.status),...a===void 0?{}:{input:a},...o===void 0?{}:{output:o}}}function r(t){if(t!==void 0)try{return e(t)}catch{return}}function i(e){return e===`started`||e===`completed`||e===`failed`?e:`unknown`}export{n as projectNativeToolEvent};
+//# sourceMappingURL=native-event.js.map

package/dist/composition/agent/native-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-event.js","names":[],"sources":["../../../src/composition/agent/native-event.ts"],"sourcesContent":["import { publicContent } from './public-message.ts'\nimport type { NativeToolCallBlock } from '../../message/content.ts'\nimport type { JsonValue } from '../../primitives/index.ts'\nimport { cloneJsonValue } from '../common/json-data.ts'\n\nexport interface ProjectedNativeToolEvent {\n  readonly type: 'assistant-native-tool'\n  readonly callId: string\n  readonly provider: string\n  readonly name: string\n  readonly status: 'started' | 'completed' | 'failed' | 'unknown'\n  readonly input?: JsonValue\n  readonly output?: JsonValue\n}\n\n/** Detach optional provider payloads into the same bounded JSON envelope used by composition metadata. */\nexport function projectNativeToolEvent(\n  call: NativeToolCallBlock,\n  provider: string,\n): ProjectedNativeToolEvent {\n  const input = optionalPayload(call.arguments)\n  const output = call.content.length === 0 ? undefined : optionalPayload(publicContent(call.content))\n  return {\n    type: 'assistant-native-tool', callId: call.id, provider, name: call.name,\n    status: nativeStatus(call.status),\n    ...(input === undefined ? {} : { input }),\n    ...(output === undefined ? {} : { output }),\n  }\n}\n\nfunction optionalPayload(value: unknown): JsonValue | undefined {\n  if (value === undefined) return undefined\n  try { return cloneJsonValue(value) } catch { return undefined }\n}\n\nfunction nativeStatus(value: string | undefined): ProjectedNativeToolEvent['status'] {\n  return value === 'started' || value === 'completed' || value === 'failed' ? value : 'unknown'\n}\n"],"mappings":"4GAgBA,SAAgB,EACd,EACA,EAC0B,CAC1B,IAAM,EAAQ,EAAgB,EAAK,SAAS,EACtC,EAAS,EAAK,QAAQ,SAAW,EAAI,IAAA,GAAY,EAAgB,EAAc,EAAK,OAAO,CAAC,EAClG,MAAO,CACL,KAAM,wBAAyB,OAAQ,EAAK,GAAI,WAAU,KAAM,EAAK,KACrE,OAAQ,EAAa,EAAK,MAAM,EAChC,GAAI,IAAU,IAAA,GAAY,CAAC,EAAI,CAAE,OAAM,EACvC,GAAI,IAAW,IAAA,GAAY,CAAC,EAAI,CAAE,QAAO,CAC3C,CACF,CAEA,SAAS,EAAgB,EAAuC,CAC1D,OAAU,IAAA,GACd,GAAI,CAAE,OAAO,EAAe,CAAK,CAAE,MAAQ,CAAE,MAAiB,CAChE,CAEA,SAAS,EAAa,EAA+D,CACnF,OAAO,IAAU,WAAa,IAAU,aAAe,IAAU,SAAW,EAAQ,SACtF"}

package/dist/composition/agent/native-tools.js

@@ -0,0 +1,2 @@
+import{AgentSdkError as e}from"../../errors/agent-sdk-error.js";import{arrayData as t,boundedText as n,objectValue as r,ownData as i}from"../../capability/common/data.js";import{cloneJsonObject as a}from"../common/json-data.js";const o=Object.freeze({tools:128,domains:128,textBytes:1024}),s=`NATIVE_TOOL_CONFIG_INVALID`;function c(n){if(n===void 0)return Object.freeze([]);try{return Object.freeze(t(n,o.tools).map(e=>u(e)))}catch(t){throw t instanceof e&&t.code===s?t:v(t)}}function l(e){if(e!==void 0){if(e===`auto`||e===`none`||e===`required`)return e;try{let t=r(e);_(t,[`type`,`name`]);let a=i(t,`type`),s=n(i(t,`name`),o.textBytes);if(a===`tool`||a===`native`&&(s===`web-search`||s===`image-generation`))return Object.freeze({type:a,name:s});throw v()}catch(e){throw v(e)}}}function u(e){let t=r(a(e));if(i(t,`type`)!==`native`)throw v();let n=i(t,`name`);if(n===`web-search`)return d(t);if(n===`image-generation`)return f(t);throw v()}function d(e){_(e,[`type`,`name`,`searchContextSize`,`allowedDomains`,`blockedDomains`,`userLocation`,`maxUses`]);let t=i(e,`searchContextSize`,!1);if(t!==void 0&&t!==`low`&&t!==`medium`&&t!==`high`)throw v();let n=p(i(e,`allowedDomains`,!1)),r=p(i(e,`blockedDomains`,!1)),a=m(i(e,`userLocation`,!1)),o=h(i(e,`maxUses`,!1));return Object.freeze({type:`native`,name:`web-search`,...t===void 0?{}:{searchContextSize:t},...n===void 0?{}:{allowedDomains:n},...r===void 0?{}:{blockedDomains:r},...a===void 0?{}:{userLocation:a},...o===void 0?{}:{maxUses:o}})}function f(e){_(e,[`type`,`name`,`size`,`quality`,`format`,`background`,`partialImages`]);let t=g(i(e,`size`,!1),[`auto`,`1024x1024`,`1536x1024`,`1024x1536`]),n=g(i(e,`quality`,!1),[`auto`,`low`,`medium`,`high`]),r=g(i(e,`format`,!1),[`png`,`jpeg`,`webp`]),a=g(i(e,`background`,!1),[`auto`,`transparent`,`opaque`]),o=h(i(e,`partialImages`,!1));return Object.freeze({type:`native`,name:`image-generation`,...t===void 0?{}:{size:t},...n===void 0?{}:{quality:n},...r===void 0?{}:{format:r},...a===void 0?{}:{background:a},...o===void 0?{}:{partialImages:o}})}function p(e){if(e!==void 0)return Object.freeze(t(e,o.domains).map(e=>n(e,o.textBytes)))}function m(e){if(e===void 0)return;let t=r(e);_(t,[`city`,`region`,`country`,`timezone`]);let a=e=>{let r=i(t,e,!1);return r===void 0?void 0:n(r,o.textBytes)},s=a(`city`),c=a(`region`),l=a(`country`),u=a(`timezone`);return Object.freeze({...s===void 0?{}:{city:s},...c===void 0?{}:{region:c},...l===void 0?{}:{country:l},...u===void 0?{}:{timezone:u}})}function h(e){if(e!==void 0){if(!Number.isSafeInteger(e)||Number(e)<0)throw v();return Number(e)}}function g(e,t){if(e!==void 0){if(!t.includes(e))throw v();return e}}function _(e,t){let n=new Set(t);if(Reflect.ownKeys(e).some(e=>typeof e!=`string`||!n.has(e)))throw v()}function v(t){return new e(`Provider-native tool configuration is invalid`,s,t===void 0?void 0:{cause:t})}export{c as captureNativeTools,l as captureToolChoice};
+//# sourceMappingURL=native-tools.js.map

package/dist/composition/agent/native-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-tools.js","names":[],"sources":["../../../src/composition/agent/native-tools.ts"],"sourcesContent":["import type {\n  NativeImageGenerationTool, NativeToolSchema, NativeWebSearchTool, ToolChoice, WebSearchLocation,\n} from '../../contract/tool.ts'\nimport { AgentSdkError } from '../../errors/agent-sdk-error.ts'\nimport { arrayData, boundedText, objectValue, ownData } from '../common/data.ts'\nimport { cloneJsonObject } from '../common/json-data.ts'\n\nconst LIMITS = Object.freeze({ tools: 128, domains: 128, textBytes: 1_024 })\nconst ERROR_CODE = 'NATIVE_TOOL_CONFIG_INVALID'\n\n/** Validate and detach provider-native configuration before model resolution/dispatch. */\nexport function captureNativeTools(value: unknown): readonly NativeToolSchema[] {\n  if (value === undefined) return Object.freeze([])\n  try {\n    return Object.freeze(arrayData(value, LIMITS.tools).map(entry => captureNativeTool(entry)))\n  } catch (error) {\n    if (error instanceof AgentSdkError && error.code === ERROR_CODE) throw error\n    throw invalid(error)\n  }\n}\n\nexport function captureToolChoice(value: unknown): ToolChoice | undefined {\n  if (value === undefined) return undefined\n  if (value === 'auto' || value === 'none' || value === 'required') return value\n  try {\n    const source = objectValue(value)\n    exactKeys(source, ['type', 'name'])\n    const type = ownData(source, 'type'), name = boundedText(ownData(source, 'name'), LIMITS.textBytes)\n    if (type === 'tool') return Object.freeze({ type, name })\n    if (type === 'native' && (name === 'web-search' || name === 'image-generation')) {\n      return Object.freeze({ type, name })\n    }\n    throw invalid()\n  } catch (error) { throw invalid(error) }\n}\n\nfunction captureNativeTool(value: unknown): NativeToolSchema {\n  const source = objectValue(cloneJsonObject(value))\n  if (ownData(source, 'type') !== 'native') throw invalid()\n  const name = ownData(source, 'name')\n  if (name === 'web-search') return webSearch(source)\n  if (name === 'image-generation') return imageGeneration(source)\n  throw invalid()\n}\n\nfunction webSearch(source: object): NativeWebSearchTool {\n  exactKeys(source, ['type', 'name', 'searchContextSize', 'allowedDomains', 'blockedDomains', 'userLocation', 'maxUses'])\n  const context = ownData(source, 'searchContextSize', false)\n  if (context !== undefined && context !== 'low' && context !== 'medium' && context !== 'high') throw invalid()\n  const allowedDomains = domains(ownData(source, 'allowedDomains', false))\n  const blockedDomains = domains(ownData(source, 'blockedDomains', false))\n  const userLocation = location(ownData(source, 'userLocation', false))\n  const maxUses = boundedInteger(ownData(source, 'maxUses', false))\n  return Object.freeze({ type: 'native', name: 'web-search',\n    ...(context === undefined ? {} : { searchContextSize: context }),\n    ...(allowedDomains === undefined ? {} : { allowedDomains }),\n    ...(blockedDomains === undefined ? {} : { blockedDomains }),\n    ...(userLocation === undefined ? {} : { userLocation }),\n    ...(maxUses === undefined ? {} : { maxUses }) })\n}\n\nfunction imageGeneration(source: object): NativeImageGenerationTool {\n  exactKeys(source, ['type', 'name', 'size', 'quality', 'format', 'background', 'partialImages'])\n  const size = choice(ownData(source, 'size', false), ['auto', '1024x1024', '1536x1024', '1024x1536'])\n  const quality = choice(ownData(source, 'quality', false), ['auto', 'low', 'medium', 'high'])\n  const format = choice(ownData(source, 'format', false), ['png', 'jpeg', 'webp'])\n  const background = choice(ownData(source, 'background', false), ['auto', 'transparent', 'opaque'])\n  const partialImages = boundedInteger(ownData(source, 'partialImages', false))\n  return Object.freeze({ type: 'native', name: 'image-generation',\n    ...(size === undefined ? {} : { size }), ...(quality === undefined ? {} : { quality }),\n    ...(format === undefined ? {} : { format }), ...(background === undefined ? {} : { background }),\n    ...(partialImages === undefined ? {} : { partialImages }) })\n}\n\nfunction domains(value: unknown): readonly string[] | undefined {\n  if (value === undefined) return undefined\n  return Object.freeze(arrayData(value, LIMITS.domains).map(item => boundedText(item, LIMITS.textBytes)))\n}\n\nfunction location(value: unknown): WebSearchLocation | undefined {\n  if (value === undefined) return undefined\n  const source = objectValue(value)\n  exactKeys(source, ['city', 'region', 'country', 'timezone'])\n  const field = (key: string): string | undefined => {\n    const entry = ownData(source, key, false)\n    return entry === undefined ? undefined : boundedText(entry, LIMITS.textBytes)\n  }\n  const city = field('city'), region = field('region'), country = field('country'), timezone = field('timezone')\n  return Object.freeze({ ...(city === undefined ? {} : { city }), ...(region === undefined ? {} : { region }),\n    ...(country === undefined ? {} : { country }), ...(timezone === undefined ? {} : { timezone }) })\n}\n\nfunction boundedInteger(value: unknown): number | undefined {\n  if (value === undefined) return undefined\n  if (!Number.isSafeInteger(value) || Number(value) < 0) throw invalid()\n  return Number(value)\n}\n\nfunction choice<const T extends string>(value: unknown, values: readonly T[]): T | undefined {\n  if (value === undefined) return undefined\n  if (!values.includes(value as T)) throw invalid()\n  return value as T\n}\n\nfunction exactKeys(source: object, allowed: readonly string[]): void {\n  const expected = new Set(allowed)\n  if (Reflect.ownKeys(source).some(key => typeof key !== 'string' || !expected.has(key))) throw invalid()\n}\n\nfunction invalid(cause?: unknown): AgentSdkError {\n  return new AgentSdkError('Provider-native tool configuration is invalid', ERROR_CODE,\n    cause === undefined ? undefined : { cause })\n}\n"],"mappings":"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"}

package/dist/composition/agent/options.js

@@ -0,0 +1,2 @@
+import{objectValue as e,optionalAbortSignal as t,ownData as n}from"../../capability/common/data.js";import{captureMemoryBinding as r}from"../memory/definition.js";import{captureRuntimeSkillSources as i}from"../../agent/skill/provider/definition.js";import{captureToolDefinitions as a}from"../../agent/tool/capture.js";import{captureAdditionalInstructions as o}from"../../agent/define/instructions.js";import{captureOutputFormat as s}from"../../agent/define/output-format.js";import{captureToolSources as c}from"../tool-source/definition.js";import{captureApprovalBroker as l,captureInterceptors as u,captureRuntimeContextSections as d,captureSpillStore as f,captureTurnHooks as p,captureUsagePolicy as m,captureUserInputBroker as h}from"./policy.js";const g=new Set([`signal`,`additionalInstructions`,`onEvent`,`imagePolicy`,`structuredOutput`]),_=new Set([`conversationId`,`tools`,`toolSources`,`skills`,`memory`,`skillCwd`,`userInput`,`approvals`,`spillStore`,`interceptors`,`contextSections`,`hooks`,`usagePolicy`,`historyLimits`,`ledgerLimits`,`eventBufferLimits`,`runtimeLimits`,`compaction`]);function v(t){if(t===void 0)return Object.freeze({});let o=e(t);if(Reflect.ownKeys(o).some(e=>typeof e!=`string`||!_.has(e)))throw TypeError(`Runtime session options contain unsupported fields`);let s=Object.fromEntries([..._].map(e=>[e,n(o,e,!1)])),g=s.tools===void 0?void 0:a(s.tools),v=s.toolSources===void 0?void 0:c(s.toolSources),y=l(s.approvals),b=f(s.spillStore),x=h(s.userInput),S=u(s.interceptors),C=d(s.contextSections),w=p(s.hooks),T=m(s.usagePolicy),E=s.memory===!1||s.memory===void 0?s.memory:r(s.memory),D=s.skills===void 0?void 0:i(s.skills);return Object.freeze({...s.conversationId===void 0?{}:{conversationId:s.conversationId},...g===void 0?{}:{tools:g},...v===void 0?{}:{toolSources:v},...D===void 0?{}:{skills:D},...E===void 0?{}:{memory:E},...s.skillCwd===void 0?{}:{skillCwd:s.skillCwd},...x===void 0?{}:{userInput:x},...y===void 0?{}:{approvals:y},...b===void 0?{}:{spillStore:b},...S===void 0?{}:{interceptors:S},...C===void 0?{}:{contextSections:C},...w===void 0?{}:{hooks:w},...T===void 0?{}:{usagePolicy:T},...s.historyLimits===void 0?{}:{historyLimits:s.historyLimits},...s.ledgerLimits===void 0?{}:{ledgerLimits:s.ledgerLimits},...s.eventBufferLimits===void 0?{}:{eventBufferLimits:s.eventBufferLimits},...s.runtimeLimits===void 0?{}:{runtimeLimits:s.runtimeLimits},...s.compaction===void 0?{}:{compaction:s.compaction}})}function y(r){if(r===void 0)return Object.freeze({});let i=e(r);if(Reflect.ownKeys(i).some(e=>typeof e!=`string`||!g.has(e)))throw TypeError(`Runtime invocation options contain unsupported fields`);let a=n(i,`structuredOutput`,!1),c;if(a!==void 0){let t=e(a),r=e(n(t,`schema`)),i=n(r,`parse`);if(typeof i!=`function`)throw TypeError(`structuredOutput schema requires a synchronous parser`);let o=s({type:`json_schema`,name:n(t,`name`),schema:n(r,`jsonSchema`)});if(o.type!==`json_schema`)throw TypeError(`structuredOutput requires JSON Schema`);c=Object.freeze({name:o.name,schema:Object.freeze({jsonSchema:o.schema,parse:i.bind(r)})})}let l=n(i,`imagePolicy`,!1);if(l!==void 0&&l!==`strict`&&l!==`project`)throw TypeError(`imagePolicy must be strict or project`);let u=t(n(i,`signal`,!1)),d=o(n(i,`additionalInstructions`,!1)),f=n(i,`onEvent`,!1);if(f!==void 0&&typeof f!=`function`)throw TypeError(`Runtime event observer must be callable`);return Object.freeze({...c===void 0?{}:{structuredOutput:c},...l===void 0?{}:{imagePolicy:l},...u===void 0?{}:{signal:u},...d===void 0?{}:{additionalInstructions:d},...f===void 0?{}:{onEvent:f}})}export{y as captureInvocationOptions,v as captureRuntimeSessionOptions};
+//# sourceMappingURL=options.js.map

package/dist/composition/agent/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","names":[],"sources":["../../../src/composition/agent/options.ts"],"sourcesContent":["import { captureOutputFormat } from '../../agent/define/output-format.ts'\nimport { objectValue, optionalAbortSignal, ownData } from '../common/data.ts'\nimport { captureAdditionalInstructions } from './instructions.ts'\nimport { captureToolDefinitions } from '../../agent/tool/capture.ts'\nimport {\n  captureApprovalBroker, captureInterceptors, captureRuntimeContextSections, captureSpillStore,\n  captureTurnHooks, captureUsagePolicy, captureUserInputBroker,\n} from './policy.ts'\nimport type { RuntimeAgentInvocationOptions, RuntimeAgentSessionOptions } from './types.ts'\nimport { captureToolSources } from '../tool-source/definition.ts'\nimport { captureMemoryBinding } from '../memory/definition.ts'\nimport { captureRuntimeSkillSources } from '../skill-provider/definition.ts'\n\nconst KEYS = new Set(['signal', 'additionalInstructions', 'onEvent', 'imagePolicy', 'structuredOutput'])\nconst SESSION_KEYS = new Set(['conversationId', 'tools', 'toolSources', 'skills', 'memory', 'skillCwd',\n  'userInput', 'approvals', 'spillStore', 'interceptors', 'contextSections', 'hooks', 'usagePolicy', 'historyLimits',\n  'ledgerLimits',\n  'eventBufferLimits', 'runtimeLimits', 'compaction'])\n\nexport interface CapturedInvocationOptions {\n  readonly structuredOutput?: NonNullable<RuntimeAgentInvocationOptions['structuredOutput']>\n  readonly imagePolicy?: 'strict' | 'project'\n  readonly signal?: AbortSignal\n  readonly additionalInstructions?: string\n  readonly onEvent?: NonNullable<RuntimeAgentInvocationOptions['onEvent']>\n}\n\n/** Capture all session option references before any agent or capability method can run. */\nexport function captureRuntimeSessionOptions(input: unknown): RuntimeAgentSessionOptions {\n  if (input === undefined) return Object.freeze({})\n  const source = objectValue(input)\n  if (Reflect.ownKeys(source).some(key => typeof key !== 'string' || !SESSION_KEYS.has(key))) {\n    throw new TypeError('Runtime session options contain unsupported fields')\n  }\n  const value = Object.fromEntries([...SESSION_KEYS].map(key => [key, ownData(source, key, false)])) as Record<string, unknown>\n  const tools = value.tools === undefined ? undefined : captureToolDefinitions(value.tools)\n  const toolSources = value.toolSources === undefined ? undefined : captureToolSources(value.toolSources)\n  const approvals = captureApprovalBroker(value.approvals)\n  const spillStore = captureSpillStore(value.spillStore)\n  const userInput = captureUserInputBroker(value.userInput)\n  const interceptors = captureInterceptors(value.interceptors)\n  const contextSections = captureRuntimeContextSections(value.contextSections)\n  const hooks = captureTurnHooks(value.hooks)\n  const usagePolicy = captureUsagePolicy(value.usagePolicy)\n  const memory = value.memory === false || value.memory === undefined\n    ? value.memory\n    : captureMemoryBinding(value.memory)\n  const skills = value.skills === undefined ? undefined : captureRuntimeSkillSources(value.skills)\n  return Object.freeze({\n    ...(value.conversationId === undefined ? {} : { conversationId: value.conversationId as string }),\n    ...(tools === undefined ? {} : { tools }),\n    ...(toolSources === undefined ? {} : { toolSources }),\n    ...(skills === undefined ? {} : { skills }),\n    ...(memory === undefined ? {} : { memory }),\n    ...(value.skillCwd === undefined ? {} : { skillCwd: value.skillCwd as string }),\n    ...(userInput === undefined ? {} : { userInput }),\n    ...(approvals === undefined ? {} : { approvals }),\n    ...(spillStore === undefined ? {} : { spillStore }),\n    ...(interceptors === undefined ? {} : { interceptors }),\n    ...(contextSections === undefined ? {} : { contextSections }),\n    ...(hooks === undefined ? {} : { hooks }),\n    ...(usagePolicy === undefined ? {} : { usagePolicy }),\n    ...(value.historyLimits === undefined ? {} : {\n      historyLimits: value.historyLimits as NonNullable<RuntimeAgentSessionOptions['historyLimits']>,\n    }),\n    ...(value.ledgerLimits === undefined ? {} : {\n      ledgerLimits: value.ledgerLimits as NonNullable<RuntimeAgentSessionOptions['ledgerLimits']>,\n    }),\n    ...(value.eventBufferLimits === undefined ? {} : {\n      eventBufferLimits: value.eventBufferLimits as NonNullable<RuntimeAgentSessionOptions['eventBufferLimits']>,\n    }),\n    ...(value.runtimeLimits === undefined ? {} : {\n      runtimeLimits: value.runtimeLimits as NonNullable<RuntimeAgentSessionOptions['runtimeLimits']>,\n    }),\n    ...(value.compaction === undefined ? {} : {\n      compaction: value.compaction as NonNullable<RuntimeAgentSessionOptions['compaction']>,\n    }),\n  })\n}\n\nexport function captureInvocationOptions(input: unknown): CapturedInvocationOptions {\n  if (input === undefined) return Object.freeze({})\n  const source = objectValue(input)\n  if (Reflect.ownKeys(source).some(key => typeof key !== 'string' || !KEYS.has(key))) {\n    throw new TypeError('Runtime invocation options contain unsupported fields')\n  }\n  const structured = ownData(source, 'structuredOutput', false)\n  let structuredOutput: RuntimeAgentInvocationOptions['structuredOutput']\n  if (structured !== undefined) {\n    const output = objectValue(structured), schema = objectValue(ownData(output, 'schema'))\n    const parse = ownData(schema, 'parse')\n    if (typeof parse !== 'function') throw new TypeError('structuredOutput schema requires a synchronous parser')\n    const format = captureOutputFormat({ type: 'json_schema', name: ownData(output, 'name') as string,\n      schema: ownData(schema, 'jsonSchema') as import('../../primitives/index.ts').JsonObject })!\n    if (format.type !== 'json_schema') throw new TypeError('structuredOutput requires JSON Schema')\n    structuredOutput = Object.freeze({ name: format.name, schema: Object.freeze({ jsonSchema: format.schema,\n      parse: parse.bind(schema) as (value: unknown) => import('../../primitives/index.ts').JsonValue }) })\n  }\n  const imagePolicy = ownData(source, 'imagePolicy', false)\n  if (imagePolicy !== undefined && imagePolicy !== 'strict' && imagePolicy !== 'project') throw new TypeError('imagePolicy must be strict or project')\n  const signal = optionalAbortSignal(ownData(source, 'signal', false))\n  const additionalInstructions = captureAdditionalInstructions(ownData(source, 'additionalInstructions', false))\n  const onEvent = ownData(source, 'onEvent', false)\n  if (onEvent !== undefined && typeof onEvent !== 'function') throw new TypeError('Runtime event observer must be callable')\n  return Object.freeze({ ...(structuredOutput === undefined ? {} : { structuredOutput }), ...(imagePolicy === undefined ? {} : { imagePolicy }), ...(signal === undefined ? {} : { signal }),\n    ...(additionalInstructions === undefined ? {} : { additionalInstructions }),\n    ...(onEvent === undefined ? {} : { onEvent: onEvent as NonNullable<RuntimeAgentInvocationOptions['onEvent']> }) })\n}\n"],"mappings":"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"}

package/dist/composition/agent/policy.js

@@ -0,0 +1,2 @@
+import{arrayData as e,boundedText as t,objectValue as n,ownData as r}from"../../capability/common/data.js";import{captureContextSections as i}from"../../agent/context/section.js";const a=Object.freeze({interceptors:128,contextSections:64,identityBytes:256});function o(o){if(o!==void 0)return i(e(o,a.contextSections).map(e=>{let i=n(e),o=t(r(i,`id`),a.identityBytes),s=p(i,`resolve`,!0),c=r(i,`retractionText`,!1);return{id:o,resolve:s,...c===void 0?{}:{retractionText:t(c,a.identityBytes*16)}}}))}function s(e){if(e===void 0)return;let t=p(n(e),`request`,!0);return Object.freeze({request:t})}function c(e){if(e===void 0)return;let t=p(n(e),`request`,!0);return Object.freeze({request:t})}function l(e){if(e===void 0)return;let t=n(e),r=p(t,`save`,!0),i=p(t,`read`,!0),a=p(t,`search`,!0);return Object.freeze({save:r,read:i,search:a})}function u(i){if(i!==void 0)return Object.freeze(e(i,a.interceptors).map(e=>{let i=n(e),o=t(r(i,`name`),a.identityBytes),s=p(i,`before`,!1),c=p(i,`around`,!1),l=p(i,`after`,!1);return Object.freeze({name:o,...s===void 0?{}:{before:s},...c===void 0?{}:{around:c},...l===void 0?{}:{after:l}})}))}function d(e){if(e===void 0)return;let t=n(e),r=p(t,`beforeStep`,!1),i=p(t,`onRequestError`,!1),a=p(t,`checkpoint`,!1),o=p(t,`onTurnEnd`,!1);return Object.freeze({...r===void 0?{}:{beforeStep:r},...i===void 0?{}:{onRequestError:i},...a===void 0?{}:{checkpoint:a},...o===void 0?{}:{onTurnEnd:o}})}function f(e){if(e===void 0)return;let i=n(e),o=r(i,`onMissing`,!1);if(o!==void 0&&o!==`warn`&&o!==`estimate`&&o!==`fail`)throw TypeError(`Runtime usage policy is invalid`);let s=r(i,`estimator`,!1),c=r(i,`estimateTimeoutMs`,!1);if(c!==void 0&&(typeof c!=`number`||!Number.isSafeInteger(c)||c<1||c>2147483647))throw TypeError(`Runtime usage estimateTimeoutMs is invalid`);let l;if(s!==void 0){let e=n(s),i=t(r(e,`id`),a.identityBytes),o=p(e,`estimate`,!0);l=Object.freeze({id:i,estimate:o})}return Object.freeze({...o===void 0?{}:{onMissing:o},...c===void 0?{}:{estimateTimeoutMs:c},...l===void 0?{}:{estimator:l}})}function p(e,t,n){let r;try{r=Reflect.get(e,t)}catch{throw TypeError(`Runtime policy method '${t}' could not be captured`)}if(!(r===void 0&&!n)){if(typeof r!=`function`)throw TypeError(`Runtime policy method '${t}' is invalid`);return(...t)=>Reflect.apply(r,e,t)}}export{s as captureApprovalBroker,u as captureInterceptors,o as captureRuntimeContextSections,l as captureSpillStore,d as captureTurnHooks,f as captureUsagePolicy,c as captureUserInputBroker};
+//# sourceMappingURL=policy.js.map