@ank1015/agents-runtime 0.1.11

package/dist/tools/build-result.js

@@ -0,0 +1,32 @@
+import { createId } from '../utils/ids.js';
+import { now } from '../utils/time.js';
+/**
+ * Converts a {@link ToolExecutionResult} into a persisted `ToolResultMessage`
+ * (successful or failed variant). For failures, `errorDetails` is used or a
+ * generic error is synthesized.
+ */
+export function buildToolResultMessage(toolCall, result, isError, errorDetails, options = {}) {
+    const base = {
+        role: 'toolResult',
+        id: options.id ?? createId('tr'),
+        toolName: toolCall.name,
+        toolCallId: toolCall.toolCallId,
+        content: result.content,
+        timestamp: options.timestamp ?? now(),
+        ...(result.details !== undefined ? { details: result.details } : {}),
+    };
+    if (isError) {
+        const failed = {
+            ...base,
+            isError: true,
+            error: errorDetails ?? { message: 'Tool execution failed' },
+        };
+        return failed;
+    }
+    const success = {
+        ...base,
+        isError: false,
+    };
+    return success;
+}
+//# sourceMappingURL=build-result.js.map

package/dist/tools/build-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-result.js","sourceRoot":"","sources":["../../src/tools/build-result.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AASvC;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA2B,EAC3B,MAA2B,EAC3B,OAAgB,EAChB,YAA8B,EAC9B,UAAkC,EAAE;IAEpC,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,YAAqB;QAC3B,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC;QAChC,QAAQ,EAAE,QAAQ,CAAC,IAAI;QACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG,EAAE;QACrC,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC;IAEF,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,MAAM,GAA4B;YACtC,GAAG,IAAI;YACP,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,YAAY,IAAI,EAAE,OAAO,EAAE,uBAAuB,EAAE;SAC5D,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAgC;QAC3C,GAAG,IAAI;QACP,OAAO,EAAE,KAAK;KACf,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/tools/define-tool.d.ts

@@ -0,0 +1,16 @@
+import type { ExecutableTool, ToolExecutionInput, ToolExecutionResult } from '@ank1015/agents-contracts';
+import type { z } from 'zod';
+export interface DefineToolOptions<TParams extends z.ZodType, TDetails> {
+    name: string;
+    description: string;
+    /** Zod schema for the tool's arguments; drives both validation and `args` typing. */
+    parameters: TParams;
+    strict?: boolean | null;
+    execute: (input: ToolExecutionInput<z.infer<TParams>, TDetails>) => Promise<ToolExecutionResult<TDetails>>;
+}
+/**
+ * Creates an {@link ExecutableTool} from a Zod schema, inferring the `execute`
+ * `args` type from `parameters` so handlers are fully typed.
+ */
+export declare function defineTool<TParams extends z.ZodType, TDetails = unknown>(options: DefineToolOptions<TParams, TDetails>): ExecutableTool<z.infer<TParams>, TDetails>;
+//# sourceMappingURL=define-tool.d.ts.map

package/dist/tools/define-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.d.ts","sourceRoot":"","sources":["../../src/tools/define-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,EAAE,QAAQ;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,CACP,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,KAClD,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,EACtE,OAAO,EAAE,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,GAC5C,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAa5C"}

package/dist/tools/define-tool.js

@@ -0,0 +1,18 @@
+/**
+ * Creates an {@link ExecutableTool} from a Zod schema, inferring the `execute`
+ * `args` type from `parameters` so handlers are fully typed.
+ */
+export function defineTool(options) {
+    const definition = {
+        type: 'function',
+        name: options.name,
+        description: options.description,
+        parameters: options.parameters,
+        ...(options.strict !== undefined ? { strict: options.strict } : {}),
+    };
+    return {
+        definition,
+        execute: options.execute,
+    };
+}
+//# sourceMappingURL=define-tool.js.map

package/dist/tools/define-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.js","sourceRoot":"","sources":["../../src/tools/define-tool.ts"],"names":[],"mappings":"AAmBA;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,OAA6C;IAE7C,MAAM,UAAU,GAA0B;QACxC,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC;IAEF,OAAO;QACL,UAAU;QACV,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,5 @@
+export * from './build-result.js';
+export * from './define-tool.js';
+export * from './registry.js';
+export * from './validate.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,5 @@
+export * from './build-result.js';
+export * from './define-tool.js';
+export * from './registry.js';
+export * from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutableTool, ToolRegistry } from '@ank1015/agents-contracts';
+export declare function createToolRegistry(tools?: readonly ExecutableTool[]): ToolRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9E,wBAAgB,kBAAkB,CAAC,KAAK,GAAE,SAAS,cAAc,EAAO,GAAG,YAAY,CAEtF"}

package/dist/tools/registry.js

@@ -0,0 +1,28 @@
+export function createToolRegistry(tools = []) {
+    return new DefaultToolRegistry(tools);
+}
+class DefaultToolRegistry {
+    #tools = new Map();
+    constructor(tools) {
+        for (const tool of tools) {
+            this.register(tool);
+        }
+    }
+    register(tool) {
+        const { name } = tool.definition;
+        if (this.#tools.has(name)) {
+            throw new Error(`Duplicate tool registered: "${name}".`);
+        }
+        this.#tools.set(name, tool);
+    }
+    get(name) {
+        return this.#tools.get(name);
+    }
+    has(name) {
+        return this.#tools.has(name);
+    }
+    list() {
+        return [...this.#tools.values()];
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,QAAmC,EAAE;IACtE,OAAO,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,mBAAmB;IACd,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEpD,YAAY,KAAgC;QAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,IAAoB;QAC3B,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QACjC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,IAAI,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/tools/validate.d.ts

@@ -0,0 +1,15 @@
+import type { AssistantToolCall, ExecutableTool } from '@ank1015/agents-contracts';
+/** Thrown when a tool call's arguments fail schema validation. */
+export declare class ToolArgumentValidationError extends Error {
+    readonly toolName: string;
+    readonly issues: unknown;
+    constructor(toolName: string, issues: unknown, message: string);
+}
+/**
+ * Validates `toolCall.arguments` against the tool's `definition.parameters`.
+ * Returns the parsed arguments, or throws {@link ToolArgumentValidationError}.
+ * Custom (grammar) tools and JSON-schema parameter sets carry no Zod validator,
+ * so their arguments pass through unchanged.
+ */
+export declare function validateToolArguments(tool: ExecutableTool, toolCall: AssistantToolCall): unknown;
+//# sourceMappingURL=validate.d.ts.map

package/dist/tools/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/tools/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAkB,MAAM,2BAA2B,CAAC;AAGnG,kEAAkE;AAClE,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEb,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;CAM/D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAgBhG"}

package/dist/tools/validate.js

@@ -0,0 +1,35 @@
+/** Thrown when a tool call's arguments fail schema validation. */
+export class ToolArgumentValidationError extends Error {
+    toolName;
+    issues;
+    constructor(toolName, issues, message) {
+        super(message);
+        this.name = 'ToolArgumentValidationError';
+        this.toolName = toolName;
+        this.issues = issues;
+    }
+}
+/**
+ * Validates `toolCall.arguments` against the tool's `definition.parameters`.
+ * Returns the parsed arguments, or throws {@link ToolArgumentValidationError}.
+ * Custom (grammar) tools and JSON-schema parameter sets carry no Zod validator,
+ * so their arguments pass through unchanged.
+ */
+export function validateToolArguments(tool, toolCall) {
+    const { definition } = tool;
+    if (definition.type !== 'function' || !isZodSchema(definition.parameters)) {
+        return toolCall.arguments;
+    }
+    const parsed = definition.parameters.safeParse(toolCall.arguments);
+    if (!parsed.success) {
+        throw new ToolArgumentValidationError(toolCall.name, parsed.error.issues, `Invalid arguments for tool "${toolCall.name}": ${parsed.error.message}`);
+    }
+    return parsed.data;
+}
+function isZodSchema(parameters) {
+    return (typeof parameters === 'object' &&
+        parameters !== null &&
+        'safeParse' in parameters &&
+        typeof parameters.safeParse === 'function');
+}
+//# sourceMappingURL=validate.js.map

package/dist/tools/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/tools/validate.ts"],"names":[],"mappings":"AAGA,kEAAkE;AAClE,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC3C,QAAQ,CAAS;IACjB,MAAM,CAAU;IAEzB,YAAY,QAAgB,EAAE,MAAe,EAAE,OAAe;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAoB,EAAE,QAA2B;IACrF,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAC5B,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1E,OAAO,QAAQ,CAAC,SAAS,CAAC;IAC5B,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,2BAA2B,CACnC,QAAQ,CAAC,IAAI,EACb,MAAM,CAAC,KAAK,CAAC,MAAM,EACnB,+BAA+B,QAAQ,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CACzE,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,SAAS,WAAW,CAAC,UAA0B;IAC7C,OAAO,CACL,OAAO,UAAU,KAAK,QAAQ;QAC9B,UAAU,KAAK,IAAI;QACnB,WAAW,IAAI,UAAU;QACzB,OAAQ,UAAqC,CAAC,SAAS,KAAK,UAAU,CACvE,CAAC;AACJ,CAAC"}

package/dist/utils/abort.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Detects abort-style errors raised by provider SDKs / `fetch`, or an already-aborted signal.
+ */
+export declare function isAbortError(error: unknown, signal?: AbortSignal): boolean;
+//# sourceMappingURL=abort.d.ts.map

package/dist/utils/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../src/utils/abort.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAQ1E"}

package/dist/utils/abort.js

@@ -0,0 +1,13 @@
+/**
+ * Detects abort-style errors raised by provider SDKs / `fetch`, or an already-aborted signal.
+ */
+export function isAbortError(error, signal) {
+    if (signal?.aborted) {
+        return true;
+    }
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    return error.name === 'AbortError' || error.name === 'APIUserAbortError';
+}
+//# sourceMappingURL=abort.js.map

package/dist/utils/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../../src/utils/abort.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,MAAoB;IAC/D,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC;AAC3E,CAAC"}

package/dist/utils/content.d.ts

@@ -0,0 +1,8 @@
+import type { Content, TextContent } from '@ank1015/agents-contracts';
+/** Builds a single text content part. */
+export declare function text(content: string): TextContent;
+/** Builds a content array with a single text part. */
+export declare function textContent(content: string): Content;
+/** Concatenates the text of all text parts, ignoring non-text (e.g. image) parts. */
+export declare function contentToText(content: Content): string;
+//# sourceMappingURL=content.d.ts.map

package/dist/utils/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/utils/content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAEtE,yCAAyC;AACzC,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAEjD;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAQtD"}

package/dist/utils/content.js

@@ -0,0 +1,19 @@
+/** Builds a single text content part. */
+export function text(content) {
+    return { type: 'text', content };
+}
+/** Builds a content array with a single text part. */
+export function textContent(content) {
+    return [text(content)];
+}
+/** Concatenates the text of all text parts, ignoring non-text (e.g. image) parts. */
+export function contentToText(content) {
+    let result = '';
+    for (const part of content) {
+        if (part.type === 'text') {
+            result += part.content;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=content.js.map

package/dist/utils/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/utils/content.ts"],"names":[],"mappings":"AAEA,yCAAyC;AACzC,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACzB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,16 @@
+import type { AgentError, AgentErrorPhase, AssistantMessage, ToolResultError } from '@ank1015/agents-contracts';
+/** Best-effort string extraction from an unknown thrown value. */
+export declare function getErrorMessage(error: unknown): string;
+/** Normalizes a thrown value into the `ToolResultError` shape stored on failed tool results. */
+export declare function toToolResultError(cause: unknown): ToolResultError;
+export interface CreateAgentErrorInput {
+    phase: AgentErrorPhase;
+    message?: string;
+    canRetry?: boolean;
+    attempts?: number;
+    cause?: unknown;
+    assistantMessage?: AssistantMessage;
+}
+/** Builds an `AgentError`, defaulting `message` from `cause`, `canRetry` false, `attempts` 1. */
+export declare function createAgentError(input: CreateAgentErrorInput): AgentError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EAChB,MAAM,2BAA2B,CAAC;AAEnC,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYtD;AAED,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CASjE;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,UAAU,CAczE"}

package/dist/utils/errors.js

@@ -0,0 +1,43 @@
+/** Best-effort string extraction from an unknown thrown value. */
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    try {
+        return JSON.stringify(error) ?? String(error);
+    }
+    catch {
+        return String(error);
+    }
+}
+/** Normalizes a thrown value into the `ToolResultError` shape stored on failed tool results. */
+export function toToolResultError(cause) {
+    if (cause instanceof Error) {
+        const error = { message: cause.message, name: cause.name };
+        if (cause.stack !== undefined) {
+            error.stack = cause.stack;
+        }
+        return error;
+    }
+    return { message: getErrorMessage(cause) };
+}
+/** Builds an `AgentError`, defaulting `message` from `cause`, `canRetry` false, `attempts` 1. */
+export function createAgentError(input) {
+    const error = {
+        phase: input.phase,
+        message: input.message ?? getErrorMessage(input.cause),
+        canRetry: input.canRetry ?? false,
+        attempts: input.attempts ?? 1,
+    };
+    if (input.cause !== undefined) {
+        error.cause = input.cause;
+    }
+    if (input.assistantMessage !== undefined) {
+        error.assistantMessage = input.assistantMessage;
+    }
+    return error;
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAOA,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAoB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5E,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC5B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;AAC7C,CAAC;AAWD,iGAAiG;AACjG,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,KAAK,GAAe;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC;QACtD,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;QACjC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC;KAC9B,CAAC;IACF,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC5B,CAAC;IACD,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACzC,KAAK,CAAC,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/ids.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Creates a unique id, optionally namespaced with a prefix
+ * (e.g. `createId('msg')` → `"msg_018f…"`).
+ */
+export declare function createId(prefix?: string): string;
+//# sourceMappingURL=ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/utils/ids.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhD"}

package/dist/utils/ids.js

@@ -0,0 +1,12 @@
+/**
+ * Creates a unique id, optionally namespaced with a prefix
+ * (e.g. `createId('msg')` → `"msg_018f…"`).
+ */
+export function createId(prefix) {
+    const uuid = globalThis.crypto?.randomUUID?.() ?? fallbackId();
+    return prefix ? `${prefix}_${uuid}` : uuid;
+}
+function fallbackId() {
+    return `${Date.now().toString(36)}${Math.random().toString(36).slice(2, 10)}`;
+}
+//# sourceMappingURL=ids.js.map

package/dist/utils/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/utils/ids.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAe;IACtC,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,UAAU,EAAE,CAAC;IAC/D,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAChF,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+export * from './abort.js';
+export * from './content.js';
+export * from './errors.js';
+export * from './ids.js';
+export * from './time.js';
+export * from './usage.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,7 @@
+export * from './abort.js';
+export * from './content.js';
+export * from './errors.js';
+export * from './ids.js';
+export * from './time.js';
+export * from './usage.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/utils/time.d.ts

@@ -0,0 +1,5 @@
+/** A source of the current time as a Unix timestamp in milliseconds. */
+export type Clock = () => number;
+/** Default {@link Clock}: the current wall-clock time in milliseconds. */
+export declare function now(): number;
+//# sourceMappingURL=time.d.ts.map

package/dist/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC;AAEjC,0EAA0E;AAC1E,wBAAgB,GAAG,IAAI,MAAM,CAE5B"}

package/dist/utils/time.js

@@ -0,0 +1,5 @@
+/** Default {@link Clock}: the current wall-clock time in milliseconds. */
+export function now() {
+    return Date.now();
+}
+//# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAGA,0EAA0E;AAC1E,MAAM,UAAU,GAAG;IACjB,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;AACpB,CAAC"}

package/dist/utils/usage.d.ts

@@ -0,0 +1,9 @@
+import type { Usage } from '@ank1015/agents-contracts';
+/**
+ * Sum of all token categories (input + output + cacheRead + cacheWrite). We
+ * intentionally don't store an aggregate on `Usage`, so callers compute it here.
+ */
+export declare function tokenTotal(usage: Usage | undefined): number;
+/** Total cost in USD for a usage record, or 0 when absent. */
+export declare function costTotal(usage: Usage | undefined): number;
+//# sourceMappingURL=usage.d.ts.map

package/dist/utils/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/utils/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAO3D;AAED,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAE1D"}

package/dist/utils/usage.js

@@ -0,0 +1,15 @@
+/**
+ * Sum of all token categories (input + output + cacheRead + cacheWrite). We
+ * intentionally don't store an aggregate on `Usage`, so callers compute it here.
+ */
+export function tokenTotal(usage) {
+    if (!usage) {
+        return 0;
+    }
+    return ((usage.input ?? 0) + (usage.output ?? 0) + (usage.cacheRead ?? 0) + (usage.cacheWrite ?? 0));
+}
+/** Total cost in USD for a usage record, or 0 when absent. */
+export function costTotal(usage) {
+    return usage?.cost?.total ?? 0;
+}
+//# sourceMappingURL=usage.js.map

package/dist/utils/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/utils/usage.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAwB;IACjD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CACL,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,CAC5F,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAC,KAAwB;IAChD,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@ank1015/agents-runtime",
+  "version": "0.1.11",
+  "description": "Generic agent loop runtime for @ank1015/agents.",
+  "keywords": [
+    "agents",
+    "llm",
+    "runtime",
+    "agent-loop",
+    "typescript"
+  ],
+  "license": "UNLICENSED",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ank1015/agent.git",
+    "directory": "packages/runtime"
+  },
+  "bugs": {
+    "url": "https://github.com/ank1015/agent/issues"
+  },
+  "homepage": "https://github.com/ank1015/agent#readme",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "prepack": "tsc -b",
+    "build": "tsc -b",
+    "check": "tsc -b --pretty false",
+    "test": "vitest run",
+    "clean": "rm -rf dist ../../.tsbuildinfo/runtime.tsbuildinfo"
+  },
+  "dependencies": {
+    "@ank1015/agents-contracts": "^0.1.11",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.9"
+  }
+}