actoviq-agent-sdk 0.4.6 → 0.4.7

package/dist/src/core/agent-spec.d.ts

@@ -0,0 +1,74 @@
+import type { JsonObject, JsonValue } from './json.js';
+import type { InputItem } from './items.js';
+import type { ModelRef } from './model-ref.js';
+import type { RunContext } from './run.js';
+export type MaybePromise<T> = T | Promise<T>;
+export type PromptSource<TContext> = string | ((context: RunContext<TContext>) => MaybePromise<string>);
+export type ToolRef = string | {
+    readonly id: string;
+    readonly options?: JsonObject;
+};
+export interface HandoffRef<TContext = unknown> {
+    readonly id: string;
+    readonly targetAgentId: string;
+    readonly description?: string;
+    readonly filter?: (context: RunContext<TContext>, input: readonly InputItem[]) => MaybePromise<readonly InputItem[]>;
+    readonly metadata?: JsonObject;
+}
+export interface OutputSchema<TOutput> {
+    readonly name: string;
+    readonly schema: JsonObject;
+    readonly description?: string;
+    readonly strict?: boolean;
+    readonly parse?: (value: JsonValue) => TOutput;
+}
+export interface GuardrailDecision {
+    readonly allowed: boolean;
+    readonly reason?: string;
+    readonly metadata?: JsonObject;
+}
+export interface InputGuardrail<TContext> {
+    readonly id: string;
+    evaluate(context: RunContext<TContext>, input: readonly InputItem[]): MaybePromise<GuardrailDecision>;
+}
+export interface OutputGuardrail<TContext, TOutput> {
+    readonly id: string;
+    evaluate(context: RunContext<TContext>, output: TOutput): MaybePromise<GuardrailDecision>;
+}
+/** A registry reference; executable middleware is owned by the runtime layer. */
+export type MiddlewareRef<TContext = unknown> = string | {
+    readonly id: string;
+    readonly options?: JsonObject;
+};
+export interface RunLimits {
+    readonly maxTurns: number;
+    readonly runDeadlineMs: number;
+    readonly modelCallTimeoutMs: number;
+    readonly toolTimeoutMs: number;
+    readonly hookTimeoutMs: number;
+    readonly maxParallelTools: number;
+    readonly maxSubagentDepth: number;
+    readonly maxSubagentFanout: number;
+    readonly streamBufferSize: number;
+    readonly maxInputTokens: number;
+    readonly maxOutputTokens: number;
+    readonly maxTotalTokens: number;
+    readonly maxCostUsd: number;
+}
+/** Immutable agent configuration. Mutable execution state belongs to AgentRuntime. */
+export interface AgentSpec<TContext = unknown, TOutput = string> {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly instructions: PromptSource<TContext>;
+    readonly model?: ModelRef;
+    readonly tools?: readonly ToolRef[];
+    readonly handoffs?: readonly HandoffRef<TContext>[];
+    readonly output?: OutputSchema<TOutput>;
+    readonly inputGuardrails?: readonly InputGuardrail<TContext>[];
+    readonly outputGuardrails?: readonly OutputGuardrail<TContext, TOutput>[];
+    readonly middleware?: readonly MiddlewareRef<TContext>[];
+    readonly limits?: Partial<RunLimits>;
+    readonly metadata?: JsonObject;
+}
+//# sourceMappingURL=agent-spec.d.ts.map

package/dist/src/core/agent-spec.d.ts.map

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

package/dist/src/core/agent-spec.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-spec.js.map

package/dist/src/core/agent-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-spec.js","sourceRoot":"","sources":["../../../src/core/agent-spec.ts"],"names":[],"mappings":""}

package/dist/src/core/errors.d.ts

@@ -0,0 +1,42 @@
+import type { JsonObject } from './json.js';
+export type RunPhase = 'prepare_input' | 'before_run' | 'model_call' | 'tool_call' | 'handoff' | 'finalize_output' | 'after_run' | 'runtime';
+export interface RunErrorOptions {
+    readonly code?: string;
+    readonly runId?: string;
+    readonly phase?: RunPhase;
+    readonly retryable?: boolean;
+    readonly details?: JsonObject;
+    readonly cause?: unknown;
+}
+export interface SerializedRunError {
+    readonly name: string;
+    readonly message: string;
+    readonly code: string;
+    readonly runId?: string;
+    readonly phase?: RunPhase;
+    readonly retryable: boolean;
+    readonly details?: JsonObject;
+}
+export declare class RunError extends Error {
+    readonly code: string;
+    readonly runId?: string;
+    readonly phase?: RunPhase;
+    readonly retryable: boolean;
+    readonly details?: JsonObject;
+    constructor(message: string, options?: RunErrorOptions);
+    toJSON(): SerializedRunError;
+}
+export interface CapabilityErrorOptions {
+    readonly providerId?: string;
+    readonly model?: string;
+    readonly capability?: string;
+    readonly cause?: unknown;
+}
+/** Raised during capability preflight, before a provider request is sent. */
+export declare class CapabilityError extends RunError {
+    readonly providerId?: string;
+    readonly model?: string;
+    readonly capability?: string;
+    constructor(message: string, options?: CapabilityErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,MAAM,QAAQ,GAChB,eAAe,GACf,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,SAAS,GACT,iBAAiB,GACjB,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;CAC/B;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;IAU1D,MAAM,IAAI,kBAAkB;CAW7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,6EAA6E;AAC7E,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B;CAiBlE"}

package/dist/src/core/errors.js

@@ -0,0 +1,53 @@
+export class RunError extends Error {
+    code;
+    runId;
+    phase;
+    retryable;
+    details;
+    constructor(message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = new.target.name;
+        this.code = options.code ?? 'RUN_ERROR';
+        this.runId = options.runId;
+        this.phase = options.phase;
+        this.retryable = options.retryable ?? false;
+        this.details = options.details;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            ...(this.runId === undefined ? {} : { runId: this.runId }),
+            ...(this.phase === undefined ? {} : { phase: this.phase }),
+            retryable: this.retryable,
+            ...(this.details === undefined ? {} : { details: this.details }),
+        };
+    }
+}
+/** Raised during capability preflight, before a provider request is sent. */
+export class CapabilityError extends RunError {
+    providerId;
+    model;
+    capability;
+    constructor(message, options = {}) {
+        const details = {};
+        if (options.providerId !== undefined)
+            details.providerId = options.providerId;
+        if (options.model !== undefined)
+            details.model = options.model;
+        if (options.capability !== undefined)
+            details.capability = options.capability;
+        super(message, {
+            code: 'CAPABILITY_ERROR',
+            phase: 'model_call',
+            retryable: false,
+            details,
+            cause: options.cause,
+        });
+        this.providerId = options.providerId;
+        this.model = options.model;
+        this.capability = options.capability;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AA+BA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAS;IACb,KAAK,CAAU;IACf,KAAK,CAAY;IACjB,SAAS,CAAU;IACnB,OAAO,CAAc;IAE9B,YAAY,OAAe,EAAE,UAA2B,EAAE;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1D,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1D,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;SACjE,CAAC;IACJ,CAAC;CACF;AASD,6EAA6E;AAC7E,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAClC,UAAU,CAAU;IACpB,KAAK,CAAU;IACf,UAAU,CAAU;IAE7B,YAAY,OAAe,EAAE,UAAkC,EAAE;QAC/D,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QAC9E,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC/D,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QAE9E,KAAK,CAAC,OAAO,EAAE;YACb,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,YAAY;YACnB,SAAS,EAAE,KAAK;YAChB,OAAO;YACP,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;CACF"}

package/dist/src/core/index.d.ts

@@ -0,0 +1,11 @@
+export type { JsonArray, JsonObject, JsonPrimitive, JsonValue, } from './json.js';
+export { assertJsonValue, cloneJsonValue, isJsonValue, } from './json.js';
+export type { ArtifactRefItem, AssistantAudioItem, AssistantDocumentItem, AssistantImageItem, AssistantTextItem, AudioItem, AudioSource, CanonicalItem, DocumentItem, DocumentSource, ErrorItem, HandoffCallItem, HandoffResultItem, ImageItem, ImageSource, InputItem, MessageRole, OutputItem, RawItem, RefusalItem, ReasoningItem, StructuredOutputItem, TextItem, ToolCallItem, ToolResultItem, } from './items.js';
+export type { ModelRef } from './model-ref.js';
+export type { AgentSpec, GuardrailDecision, HandoffRef, InputGuardrail, MaybePromise, MiddlewareRef, OutputGuardrail, OutputSchema, PromptSource, RunLimits, ToolRef, } from './agent-spec.js';
+export type { RunContext, RunResult, RunStatus } from './run.js';
+export type { Usage, UsageDelta } from './usage.js';
+export { emptyUsage, normalizeUsageDelta, UsageAccumulator, } from './usage.js';
+export type { CapabilityErrorOptions, RunErrorOptions, RunPhase, SerializedRunError, } from './errors.js';
+export { CapabilityError, RunError } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,EACd,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACV,OAAO,EACP,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,QAAQ,EACR,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,OAAO,GACR,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEjE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,sBAAsB,EACtB,eAAe,EACf,QAAQ,EACR,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/core/index.js

@@ -0,0 +1,4 @@
+export { assertJsonValue, cloneJsonValue, isJsonValue, } from './json.js';
+export { emptyUsage, normalizeUsageDelta, UsageAccumulator, } from './usage.js';
+export { CapabilityError, RunError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,WAAW,CAAC;AAiDnB,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAQpB,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/core/items.d.ts

@@ -0,0 +1,161 @@
+import type { JsonObject, JsonValue } from './json.js';
+export type MessageRole = 'system' | 'user' | 'assistant';
+interface ItemBase {
+    /** Stable item identity when one is supplied by the runtime or provider. */
+    readonly id?: string;
+    readonly metadata?: JsonObject;
+}
+export interface TextItem extends ItemBase {
+    readonly type: 'text';
+    readonly role: MessageRole;
+    readonly text: string;
+}
+export type ImageSource = {
+    readonly kind: 'url';
+    readonly url: string;
+} | {
+    readonly kind: 'base64';
+    readonly mediaType: string;
+    readonly data: string;
+} | {
+    /** A provider or artifact-store file reference resolved by an adapter. */
+    readonly kind: 'file';
+    readonly fileId: string;
+};
+export interface ImageItem extends ItemBase {
+    readonly type: 'image';
+    readonly role?: 'user' | 'assistant';
+    readonly source: ImageSource;
+    readonly detail?: 'auto' | 'low' | 'high';
+    readonly altText?: string;
+}
+export type AudioSource = {
+    readonly kind: 'url';
+    readonly url: string;
+} | {
+    readonly kind: 'base64';
+    readonly mediaType: string;
+    readonly data: string;
+} | {
+    readonly kind: 'file';
+    readonly fileId: string;
+};
+export interface AudioItem extends ItemBase {
+    readonly type: 'audio';
+    readonly role?: 'user' | 'assistant';
+    readonly source: AudioSource;
+    readonly transcript?: string;
+}
+export type DocumentSource = {
+    readonly kind: 'url';
+    readonly url: string;
+} | {
+    readonly kind: 'base64';
+    readonly mediaType: string;
+    readonly data: string;
+} | {
+    readonly kind: 'file';
+    readonly fileId: string;
+};
+export interface DocumentItem extends ItemBase {
+    readonly type: 'document';
+    readonly role?: 'user' | 'assistant';
+    readonly source: DocumentSource;
+    readonly name?: string;
+    readonly mediaType?: string;
+}
+/** Reference to a large or durable payload held outside the conversation. */
+export interface ArtifactRefItem extends ItemBase {
+    readonly type: 'artifact_ref';
+    readonly artifactId: string;
+    readonly name?: string;
+    readonly mediaType?: string;
+    readonly description?: string;
+}
+export interface ToolCallItem extends ItemBase {
+    readonly type: 'tool_call';
+    /** Correlates the call with exactly one ToolResultItem. */
+    readonly id: string;
+    readonly name: string;
+    readonly input: JsonObject;
+}
+export interface ToolResultItem extends ItemBase {
+    readonly type: 'tool_result';
+    readonly callId: string;
+    readonly name?: string;
+    readonly status: 'success' | 'error';
+    readonly output: JsonValue;
+}
+export interface HandoffCallItem extends ItemBase {
+    readonly type: 'handoff_call';
+    readonly id: string;
+    readonly targetAgentId: string;
+    readonly input: JsonValue;
+}
+export interface HandoffResultItem extends ItemBase {
+    readonly type: 'handoff_result';
+    readonly callId: string;
+    readonly targetAgentId: string;
+    readonly status: 'success' | 'error';
+    readonly output: JsonValue;
+}
+/**
+ * Provider reasoning is opaque by default. Adapters may expose a human-safe
+ * summary, but core never assumes it can inspect or reproduce `opaque`.
+ */
+export interface ReasoningItem extends ItemBase {
+    readonly type: 'reasoning';
+    readonly provider?: string;
+    readonly summary?: string;
+    readonly opaque: JsonValue;
+}
+/** Lossless escape hatch for provider data that has no canonical equivalent. */
+export interface RawItem extends ItemBase {
+    readonly type: 'raw';
+    readonly provider: string;
+    readonly value: JsonValue;
+}
+/** Validated structured output kept as an item as well as a typed RunResult. */
+export interface StructuredOutputItem extends ItemBase {
+    readonly type: 'structured';
+    readonly role: 'assistant';
+    readonly value: JsonValue;
+    readonly schemaName?: string;
+}
+export interface RefusalItem extends ItemBase {
+    readonly type: 'refusal';
+    readonly role: 'assistant';
+    readonly message: string;
+    readonly providerData?: JsonValue;
+}
+export interface ErrorItem extends ItemBase {
+    readonly type: 'error';
+    readonly source: 'model' | 'tool' | 'handoff' | 'provider' | 'runtime';
+    readonly code: string;
+    readonly message: string;
+    readonly retryable: boolean;
+    readonly callId?: string;
+    readonly details?: JsonObject;
+}
+export type CanonicalItem = TextItem | ImageItem | AudioItem | DocumentItem | ArtifactRefItem | ToolCallItem | ToolResultItem | HandoffCallItem | HandoffResultItem | ReasoningItem | RawItem | StructuredOutputItem | RefusalItem | ErrorItem;
+/**
+ * Items accepted at a model boundary. This includes prior model output so a
+ * complete canonical transcript can be replayed without provider types.
+ */
+export type InputItem = CanonicalItem;
+export type AssistantTextItem = TextItem & {
+    readonly role: 'assistant';
+};
+export type AssistantImageItem = Omit<ImageItem, 'role'> & {
+    readonly role?: 'assistant';
+};
+export type AssistantAudioItem = Omit<AudioItem, 'role'> & {
+    readonly role?: 'assistant';
+};
+export type AssistantDocumentItem = Omit<DocumentItem, 'role'> & {
+    readonly role?: 'assistant';
+};
+/** Items that a model/runtime may append while executing a turn. */
+export type OutputItem = AssistantTextItem | AssistantImageItem | AssistantAudioItem | AssistantDocumentItem | ArtifactRefItem | ToolCallItem | ToolResultItem | HandoffCallItem | HandoffResultItem | ReasoningItem | RawItem | StructuredOutputItem | RefusalItem | ErrorItem;
+export {};
+//# sourceMappingURL=items.d.ts.map

package/dist/src/core/items.d.ts.map

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

package/dist/src/core/items.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=items.js.map

package/dist/src/core/items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"items.js","sourceRoot":"","sources":["../../../src/core/items.ts"],"names":[],"mappings":""}

package/dist/src/core/json.d.ts

@@ -0,0 +1,20 @@
+/** Values that can be represented without loss by JSON. */
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+export interface JsonObject {
+    readonly [key: string]: JsonValue;
+}
+export type JsonArray = readonly JsonValue[];
+/**
+ * Return whether a value is composed only of finite JSON values.
+ *
+ * JSON.stringify silently drops `undefined`, functions, and symbols, converts
+ * non-finite numbers to null, and invokes custom `toJSON` methods. Core state
+ * must not depend on those lossy behaviours, so this check is deliberately
+ * stricter than JSON.stringify.
+ */
+export declare function isJsonValue(value: unknown): value is JsonValue;
+export declare function assertJsonValue(value: unknown, label?: string): asserts value is JsonValue;
+/** Validate and clone a JSON value through the actual serialization boundary. */
+export declare function cloneJsonValue<T extends JsonValue>(value: T): T;
+//# sourceMappingURL=json.d.ts.map

package/dist/src/core/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/core/json.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,SAAS,EAAE,CAAC;AAE7C;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,KAAK,SAAU,GACd,OAAO,CAAC,KAAK,IAAI,SAAS,CAI5B;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAG/D"}

package/dist/src/core/json.js

@@ -0,0 +1,80 @@
+/**
+ * Return whether a value is composed only of finite JSON values.
+ *
+ * JSON.stringify silently drops `undefined`, functions, and symbols, converts
+ * non-finite numbers to null, and invokes custom `toJSON` methods. Core state
+ * must not depend on those lossy behaviours, so this check is deliberately
+ * stricter than JSON.stringify.
+ */
+export function isJsonValue(value) {
+    return isJsonValueInternal(value, new Set());
+}
+export function assertJsonValue(value, label = 'value') {
+    if (!isJsonValue(value)) {
+        throw new TypeError(`${label} must be a finite, acyclic JSON value.`);
+    }
+}
+/** Validate and clone a JSON value through the actual serialization boundary. */
+export function cloneJsonValue(value) {
+    assertJsonValue(value);
+    return JSON.parse(JSON.stringify(value));
+}
+function isJsonValueInternal(value, ancestors) {
+    if (value === null
+        || typeof value === 'string'
+        || typeof value === 'boolean') {
+        return true;
+    }
+    if (typeof value === 'number') {
+        return Number.isFinite(value);
+    }
+    if (typeof value !== 'object') {
+        return false;
+    }
+    if (ancestors.has(value)) {
+        return false;
+    }
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            for (let index = 0; index < value.length; index += 1) {
+                // JSON.stringify turns sparse slots into null, which is not lossless.
+                if (!Object.hasOwn(value, index))
+                    return false;
+                if (!isJsonValueInternal(value[index], ancestors))
+                    return false;
+            }
+            return Reflect.ownKeys(value).every(key => (key === 'length'
+                || (typeof key === 'string' && isCanonicalArrayIndex(key, value.length))));
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            return false;
+        }
+        for (const key of Reflect.ownKeys(value)) {
+            if (typeof key !== 'string')
+                return false;
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            if (descriptor === undefined
+                || !descriptor.enumerable
+                || !('value' in descriptor)
+                || !isJsonValueInternal(descriptor.value, ancestors)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+function isCanonicalArrayIndex(key, length) {
+    if (key === '')
+        return false;
+    const index = Number(key);
+    return Number.isSafeInteger(index)
+        && index >= 0
+        && index < length
+        && String(index) === key;
+}
+//# sourceMappingURL=json.js.map

package/dist/src/core/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/core/json.ts"],"names":[],"mappings":"AAWA;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,mBAAmB,CAAC,KAAK,EAAE,IAAI,GAAG,EAAU,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAc,EACd,KAAK,GAAG,OAAO;IAEf,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,wCAAwC,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAsB,KAAQ;IAC1D,eAAe,CAAC,KAAK,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAM,CAAC;AAChD,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc,EAAE,SAAsB;IACjE,IACE,KAAK,KAAK,IAAI;WACX,OAAO,KAAK,KAAK,QAAQ;WACzB,OAAO,KAAK,KAAK,SAAS,EAC7B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;gBACrD,sEAAsE;gBACtE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;oBAAE,OAAO,KAAK,CAAC;gBAC/C,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;oBAAE,OAAO,KAAK,CAAC;YAClE,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CACzC,GAAG,KAAK,QAAQ;mBACb,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CACzE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAY,CAAC;QAC1D,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACzD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC/D,IACE,UAAU,KAAK,SAAS;mBACrB,CAAC,UAAU,CAAC,UAAU;mBACtB,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC;mBACxB,CAAC,mBAAmB,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,EACpD,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAW,EAAE,MAAc;IACxD,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;WAC7B,KAAK,IAAI,CAAC;WACV,KAAK,GAAG,MAAM;WACd,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC;AAC7B,CAAC"}

package/dist/src/core/model-ref.d.ts

@@ -0,0 +1,6 @@
+/** A provider-neutral model reference resolved by a ModelRegistry. */
+export type ModelRef = string | {
+    readonly provider: string;
+    readonly model: string;
+};
+//# sourceMappingURL=model-ref.d.ts.map

package/dist/src/core/model-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-ref.d.ts","sourceRoot":"","sources":["../../../src/core/model-ref.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN;IACE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC"}

package/dist/src/core/model-ref.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model-ref.js.map

package/dist/src/core/model-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-ref.js","sourceRoot":"","sources":["../../../src/core/model-ref.ts"],"names":[],"mappings":""}

package/dist/src/core/run.d.ts

@@ -0,0 +1,35 @@
+import type { JsonObject } from './json.js';
+import type { OutputItem } from './items.js';
+import type { Usage } from './usage.js';
+import { UsageAccumulator } from './usage.js';
+export interface RunContext<TContext = unknown> {
+    readonly runId: string;
+    readonly agentId: string;
+    readonly context: TContext;
+    readonly signal: AbortSignal;
+    /** ISO-8601 timestamp. */
+    readonly startedAt: string;
+    /** ISO-8601 timestamp for the effective run deadline. */
+    readonly deadlineAt?: string;
+    readonly sessionId?: string;
+    readonly metadata: JsonObject;
+    /** Shared by all model calls belonging to this run. */
+    readonly usage: UsageAccumulator;
+}
+export type RunStatus = 'completed' | 'interrupted' | 'cancelled';
+export interface RunResult<TOutput = string> {
+    readonly runId: string;
+    readonly agentId: string;
+    readonly status: RunStatus;
+    readonly output: TOutput;
+    readonly items: readonly OutputItem[];
+    /** Aggregate of every model call made by this run. */
+    readonly usage: Usage;
+    /** ISO-8601 timestamp. */
+    readonly startedAt: string;
+    /** ISO-8601 timestamp. */
+    readonly completedAt: string;
+    readonly sessionId?: string;
+    readonly metadata?: JsonObject;
+}
+//# sourceMappingURL=run.d.ts.map

package/dist/src/core/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/core/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,UAAU,CAAC,QAAQ,GAAG,OAAO;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;CAClC;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,CAAC;AAElE,MAAM,WAAW,SAAS,CAAC,OAAO,GAAG,MAAM;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAChC"}

package/dist/src/core/run.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run.js.map

package/dist/src/core/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/core/run.ts"],"names":[],"mappings":""}

package/dist/src/core/usage.d.ts

@@ -0,0 +1,32 @@
+export interface Usage {
+    readonly requests: number;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly totalTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheWriteTokens: number;
+    readonly reasoningTokens: number;
+    readonly audioInputTokens: number;
+    readonly audioOutputTokens: number;
+    readonly costUsd: number;
+}
+/** A single provider call may omit counters it cannot report. */
+export type UsageDelta = Partial<Usage>;
+export declare function emptyUsage(): Usage;
+/**
+ * Mutable run-local counter with immutable snapshots.
+ *
+ * Cache and reasoning counters describe token subsets and therefore do not get
+ * added to totalTokens a second time. When a provider omits totalTokens, the
+ * delta total is derived from inputTokens + outputTokens.
+ */
+export declare class UsageAccumulator {
+    private totals;
+    constructor(initial?: UsageDelta | Iterable<UsageDelta>);
+    add(delta: UsageDelta): this;
+    addAll(deltas: Iterable<UsageDelta>): this;
+    snapshot(): Readonly<Usage>;
+    reset(): void;
+}
+export declare function normalizeUsageDelta(delta: UsageDelta): Usage;
+//# sourceMappingURL=usage.d.ts.map

package/dist/src/core/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/core/usage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,iEAAiE;AACjE,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;AA2BxC,wBAAgB,UAAU,IAAI,KAAK,CAalC;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAuB;gBAEzB,OAAO,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;IASvD,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAkB5B,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI;IAK1C,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC;IAI3B,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CAe5D"}