@dex-ai/sdk 0.1.30

package/dist/tool-dispatch.js

@@ -0,0 +1,120 @@
+/** Dispatch one tool call: validate input → execute → return result. */
+import { validateWithSchema } from "./util";
+import { cacheIfLarge } from "./tool-result-cache";
+const MAX_TOOL_OUTPUT_LINES = 1000;
+const MAX_TOOL_OUTPUT_CHARS = 40_000;
+/**
+ * Truncate tool output text to fit within limits.
+ * Keeps the tail (most recent output) and prepends a truncation notice.
+ */
+function truncateText(text) {
+    const lines = text.split("\n");
+    let result = text;
+    let truncated = false;
+    if (lines.length > MAX_TOOL_OUTPUT_LINES) {
+        result = lines.slice(-MAX_TOOL_OUTPUT_LINES).join("\n");
+        truncated = true;
+    }
+    if (result.length > MAX_TOOL_OUTPUT_CHARS) {
+        result = result.slice(-MAX_TOOL_OUTPUT_CHARS);
+        truncated = true;
+    }
+    if (truncated) {
+        return ("[OUTPUT TRUNCATED — showing last portion only. " +
+            "Use more targeted commands to reduce output if needed.]\n" +
+            result);
+    }
+    return text;
+}
+/** Truncate a ToolOutput if it exceeds size limits. */
+function truncateToolOutput(output) {
+    switch (output.type) {
+        case "text":
+            return { type: "text", value: truncateText(output.value) };
+        case "error-text":
+            return { type: "error-text", value: truncateText(output.value) };
+        case "json": {
+            const serialized = JSON.stringify(output.value, null, 2);
+            const truncatedStr = truncateText(serialized);
+            if (truncatedStr !== serialized) {
+                // Truncated JSON is no longer valid JSON — return as text
+                return { type: "text", value: truncatedStr };
+            }
+            return output;
+        }
+        case "content": {
+            const parts = output.value.map((part) => {
+                if (part.type === "text") {
+                    return { ...part, text: truncateText(part.text) };
+                }
+                return part;
+            });
+            return { type: "content", value: parts };
+        }
+        default:
+            return output;
+    }
+}
+/** Wrap an execute() return value into a ToolOutput tagged variant. */
+export function toToolOutput(result) {
+    if (typeof result === "object" && result !== null && "type" in result) {
+        const t = result.type;
+        if (t === "content" ||
+            t === "json" ||
+            t === "text" ||
+            t === "error-text" ||
+            t === "error-json") {
+            return result;
+        }
+    }
+    return { type: "json", value: result };
+}
+/**
+ * Validate and execute a tool call. Tool-start/tool-stop events are handled
+ * by the generate loop — this function only does validation + execution.
+ */
+export async function dispatchTool(opts) {
+    const { call, tool, gctx, reportError } = opts;
+    // 1. Validate input against tool.parameters.
+    const validated = await validateWithSchema(tool.parameters, call.input);
+    if ("issues" in validated) {
+        const msg = validated.issues
+            .map((i) => (i.path?.length ? i.path.join(".") + ": " : "") + i.message)
+            .join("; ");
+        return {
+            result: {
+                toolCallId: call.toolCallId,
+                toolName: call.toolName,
+                output: { type: "error-text", value: "Invalid tool input: " + msg },
+            },
+            shortCircuited: false,
+        };
+    }
+    // 2. Execute.
+    let executeError;
+    let result;
+    try {
+        const raw = await tool.execute(validated.value, gctx);
+        let output = toToolOutput(raw);
+        // Cache large results before truncation — agent can explore via `read`
+        if (opts.cacheConfig) {
+            output = await cacheIfLarge(output, call.toolName, call.toolCallId, opts.cacheConfig);
+        }
+        output = truncateToolOutput(output);
+        result = { toolCallId: call.toolCallId, toolName: call.toolName, output };
+    }
+    catch (err) {
+        executeError = err;
+        await reportError(err, { kind: "tool", call });
+        result = {
+            toolCallId: call.toolCallId,
+            toolName: call.toolName,
+            output: {
+                type: "error-text",
+                value: err instanceof Error ? err.message : String(err),
+            },
+        };
+    }
+    return { result, shortCircuited: false, executeError };
+}
+//# sourceMappingURL=tool-dispatch.js.map

package/dist/tool-dispatch.js.map

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

package/dist/tool-result-cache.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Large Tool Result Caching
+ *
+ * When a tool result exceeds a character threshold, the full output is cached
+ * to disk and only the tail is sent to the model — with a header noting where
+ * the full output can be read.
+ *
+ * This reduces context consumption while allowing the agent to explore
+ * cached results via the existing `read` tool.
+ */
+import type { ToolOutput } from "./message";
+export interface ToolResultCacheConfig {
+    /** Character threshold above which results are cached. Default: 10_000 */
+    readonly threshold?: number;
+    /** Cache directory. Default: ~/.dex/cache */
+    readonly cacheDir?: string;
+    /** TTL in milliseconds for stale file cleanup. Default: 86_400_000 (24h) */
+    readonly ttlMs?: number;
+    /** Tool names excluded from caching. Default: ['read'] */
+    readonly excludedTools?: ReadonlyArray<string>;
+}
+/** Internal state key used to store the resolved config in AgentContext.state */
+export declare const TOOL_RESULT_CACHE_KEY = "__toolResultCache";
+export interface ResolvedCacheConfig {
+    readonly threshold: number;
+    readonly cacheDir: string;
+    readonly ttlMs: number;
+    readonly excludedTools: ReadonlyArray<string>;
+}
+export declare function resolveConfig(config?: ToolResultCacheConfig): ResolvedCacheConfig;
+/**
+ * If the tool output exceeds the threshold, cache the full result to disk
+ * and return a truncated version with a header pointing to the cache file.
+ *
+ * Returns the original output unchanged if below threshold or excluded.
+ */
+export declare function cacheIfLarge(output: ToolOutput, toolName: string, toolCallId: string, config: ResolvedCacheConfig): Promise<ToolOutput>;
+/**
+ * Remove stale cache files older than TTL, then wipe the directory.
+ * Called on session start to ensure a clean slate.
+ */
+export declare function cleanCacheDir(config: ResolvedCacheConfig): Promise<void>;
+//# sourceMappingURL=tool-result-cache.d.ts.map

package/dist/tool-result-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-cache.d.ts","sourceRoot":"","sources":["../src/tool-result-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAM5C,MAAM,WAAW,qBAAqB;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC/C;AAED,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AAWzD,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,wBAAgB,aAAa,CAC5B,MAAM,CAAC,EAAE,qBAAqB,GAC5B,mBAAmB,CAOrB;AA6BD;;;;;GAKG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,mBAAmB,GACzB,OAAO,CAAC,UAAU,CAAC,CA6BrB;AAMD;;;GAGG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,mBAAmB,GACzB,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/tool-result-cache.js

@@ -0,0 +1,118 @@
+/**
+ * Large Tool Result Caching
+ *
+ * When a tool result exceeds a character threshold, the full output is cached
+ * to disk and only the tail is sent to the model — with a header noting where
+ * the full output can be read.
+ *
+ * This reduces context consumption while allowing the agent to explore
+ * cached results via the existing `read` tool.
+ */
+import { writeFile, mkdir, readdir, stat, unlink, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+/** Internal state key used to store the resolved config in AgentContext.state */
+export const TOOL_RESULT_CACHE_KEY = "__toolResultCache";
+/* ------------------------------------------------------------------ */
+/* Defaults                                                            */
+/* ------------------------------------------------------------------ */
+const DEFAULT_THRESHOLD = 10_000;
+const DEFAULT_CACHE_DIR = join(homedir(), ".dex", "cache");
+const DEFAULT_TTL_MS = 86_400_000; // 24 hours
+const DEFAULT_EXCLUDED_TOOLS = ["read"];
+export function resolveConfig(config) {
+    return {
+        threshold: config?.threshold ?? DEFAULT_THRESHOLD,
+        cacheDir: config?.cacheDir ?? DEFAULT_CACHE_DIR,
+        ttlMs: config?.ttlMs ?? DEFAULT_TTL_MS,
+        excludedTools: config?.excludedTools ?? DEFAULT_EXCLUDED_TOOLS,
+    };
+}
+/* ------------------------------------------------------------------ */
+/* Text extraction                                                     */
+/* ------------------------------------------------------------------ */
+/** Extract the text content from a ToolOutput, or null if non-textual. */
+function extractText(output) {
+    switch (output.type) {
+        case "text":
+        case "error-text":
+            return output.value;
+        case "json":
+            return JSON.stringify(output.value, null, 2);
+        case "content": {
+            const texts = output.value
+                .filter((p) => p.type === "text")
+                .map((p) => p.text);
+            return texts.length > 0 ? texts.join("\n") : null;
+        }
+        default:
+            return null;
+    }
+}
+/* ------------------------------------------------------------------ */
+/* Core: cacheIfLarge                                                  */
+/* ------------------------------------------------------------------ */
+/**
+ * If the tool output exceeds the threshold, cache the full result to disk
+ * and return a truncated version with a header pointing to the cache file.
+ *
+ * Returns the original output unchanged if below threshold or excluded.
+ */
+export async function cacheIfLarge(output, toolName, toolCallId, config) {
+    // Skip excluded tools
+    if (config.excludedTools.includes(toolName))
+        return output;
+    // Extract text content
+    const text = extractText(output);
+    if (!text || text.length <= config.threshold)
+        return output;
+    // Write full output to cache
+    const cachePath = join(config.cacheDir, toolCallId);
+    try {
+        await mkdir(config.cacheDir, { recursive: true });
+        await writeFile(cachePath, text, "utf-8");
+    }
+    catch {
+        // If caching fails (disk full, permissions), fall through to existing truncation
+        return output;
+    }
+    // Return tail with header
+    const tail = text.slice(-config.threshold);
+    const header = `[Tool output cached — showing last ${config.threshold.toLocaleString()} of ${text.length.toLocaleString()} chars. ` +
+        `Full output: ${cachePath}]\n`;
+    // Preserve the output type for error results
+    if (output.type === "error-text") {
+        return { type: "error-text", value: header + tail };
+    }
+    return { type: "text", value: header + tail };
+}
+/* ------------------------------------------------------------------ */
+/* Cleanup                                                             */
+/* ------------------------------------------------------------------ */
+/**
+ * Remove stale cache files older than TTL, then wipe the directory.
+ * Called on session start to ensure a clean slate.
+ */
+export async function cleanCacheDir(config) {
+    const { cacheDir, ttlMs } = config;
+    try {
+        // First pass: remove stale files (safety net for orphaned files from crashed sessions)
+        const entries = await readdir(cacheDir).catch(() => []);
+        const now = Date.now();
+        for (const entry of entries) {
+            const filePath = join(cacheDir, entry);
+            const fileStat = await stat(filePath).catch(() => null);
+            if (fileStat && now - fileStat.mtimeMs > ttlMs) {
+                await unlink(filePath).catch(() => { });
+            }
+        }
+        // Wipe the directory for a clean session start
+        await rm(cacheDir, { recursive: true, force: true });
+    }
+    catch {
+        // Non-fatal — directory may not exist yet
+    }
+    // Ensure directory exists for this session
+    await mkdir(cacheDir, { recursive: true });
+}
+//# sourceMappingURL=tool-result-cache.js.map

package/dist/tool-result-cache.js.map

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

package/dist/tool.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Tool — an action a Provider may invoke.
+ *
+ * ai-sdk aligned:
+ *   - parameters: Standard Schema for the input
+ *   - execute:    ({input}, gctx) => ToolOutput | value
+ *   - outputSchema: optional Standard Schema for the output value
+ *
+ * Approval is NOT a first-class tool field. Use the onToolCall hook
+ * (see extension.ts) — a short-circuit-capable reducer. An approver
+ * extension returns a ToolResult to reject, a rewritten ToolCall to
+ * modify, or void to pass through. A rejection is data for the LLM:
+ * the tool-result message goes into history and the model decides to
+ * retry, call a different tool, or stop.
+ */
+import type { StandardSchemaV1, InferInput } from "./schema";
+import type { ToolOutput } from "./message";
+import type { GenerateContext } from "./context";
+/** A pending tool invocation parsed from the model. */
+export interface ToolCall<Input = unknown> {
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly input: Input;
+}
+/**
+ * The outcome of a tool invocation. Wraps a tagged ToolOutput so tools
+ * can return rich content, structured JSON, plain text, or errors
+ * uniformly.
+ */
+export interface ToolResult {
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly output: ToolOutput;
+}
+/**
+ * An execute function may return either:
+ *   - a raw Output value (wrapped by the loop into a ToolOutput.json), or
+ *   - a ToolOutput directly (for rich content / explicit error shapes).
+ */
+export type ExecuteResult<Output> = Output | ToolOutput;
+export interface Tool<Input = unknown, Output = unknown> {
+    readonly name: string;
+    readonly description?: string;
+    readonly parameters: StandardSchemaV1<Input>;
+    readonly outputSchema?: StandardSchemaV1<Output>;
+    /**
+     * Access level hint for permission systems.
+     *   - 'read': tool only reads/queries data (no side effects)
+     *   - 'write': tool modifies state (files, memory, shell, etc.)
+     *
+     * If omitted, defaults to 'write' (conservative — requires approval).
+     */
+    readonly access?: "read" | "write";
+    /**
+     * Human-friendly name for UI display.
+     * Falls back to `name` when omitted.
+     * Examples: "Read", "Update", "Search", "Remember"
+     */
+    readonly displayName?: string;
+    /**
+     * Whether the tool invocation should be rendered in the UI message stream.
+     * Defaults to `true`. Set to `false` for tools that have dedicated UI
+     * (e.g. task panel) or whose invocations aren't useful to show inline.
+     */
+    readonly visible?: boolean;
+    execute(input: Input, gctx: GenerateContext): Promise<ExecuteResult<Output>> | ExecuteResult<Output>;
+    /**
+     * Streaming alternative to execute. Yields Parts (tool-progress + tool-result).
+     * If present, the loop prefers stream() over execute().
+     * The loop stamps toolCallId on emitted parts.
+     */
+    stream?(input: Input, gctx: GenerateContext): AsyncIterable<ToolStreamPart>;
+}
+/** Parts a streaming tool can yield. */
+export type ToolStreamPart = {
+    readonly type: "tool-progress";
+    readonly text: string;
+} | {
+    readonly type: "tool-result";
+    readonly output: ToolOutput;
+};
+export type AnyTool = Tool<any, any>;
+/**
+ * Tool namespace — identity-typed declaration helper.
+ *
+ * Use `Tool.define({...})` at author-time to get full contextual typing
+ * (tool input/output inference from the Standard Schema `parameters`).
+ * Runtime behavior: returns the argument unchanged.
+ */
+export declare const Tool: {
+    define<ParamsSchema extends StandardSchemaV1<any, any>, Output>(tool: Omit<Tool<InferInput<ParamsSchema>, Output>, "parameters" | "outputSchema"> & {
+        readonly parameters: ParamsSchema;
+        readonly outputSchema?: StandardSchemaV1<Output>;
+    }): Tool<InferInput<ParamsSchema>, Output>;
+};
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,uDAAuD;AACvD,MAAM,WAAW,QAAQ,CAAC,KAAK,GAAG,OAAO;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,MAAM,IAAI,MAAM,GAAG,UAAU,CAAC;AAExD,MAAM,WAAW,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC7C,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACjD;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CACN,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,eAAe,GACnB,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1D;;;;OAIG;IACH,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;CAC5E;AAED,wCAAwC;AACxC,MAAM,MAAM,cAAc,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAErC;;;;;;GAMG;AAEH,eAAO,MAAM,IAAI;WACT,YAAY,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,QACvD,IAAI,CACT,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,EACtC,YAAY,GAAG,cAAc,CAC7B,GAAG;QACH,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;QAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;KACjD,GACC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAGzC,CAAC"}

package/dist/tool.js

@@ -0,0 +1,29 @@
+/**
+ * Tool — an action a Provider may invoke.
+ *
+ * ai-sdk aligned:
+ *   - parameters: Standard Schema for the input
+ *   - execute:    ({input}, gctx) => ToolOutput | value
+ *   - outputSchema: optional Standard Schema for the output value
+ *
+ * Approval is NOT a first-class tool field. Use the onToolCall hook
+ * (see extension.ts) — a short-circuit-capable reducer. An approver
+ * extension returns a ToolResult to reject, a rewritten ToolCall to
+ * modify, or void to pass through. A rejection is data for the LLM:
+ * the tool-result message goes into history and the model decides to
+ * retry, call a different tool, or stop.
+ */
+/**
+ * Tool namespace — identity-typed declaration helper.
+ *
+ * Use `Tool.define({...})` at author-time to get full contextual typing
+ * (tool input/output inference from the Standard Schema `parameters`).
+ * Runtime behavior: returns the argument unchanged.
+ */
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const Tool = {
+    define(tool) {
+        return tool;
+    },
+};
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA2EH;;;;;;GAMG;AACH,2DAA2D;AAC3D,MAAM,CAAC,MAAM,IAAI,GAAG;IACnB,MAAM,CACL,IAMC;QAED,OAAO,IAA8C,CAAC;IACvD,CAAC;CACD,CAAC"}

package/dist/util.d.ts

@@ -0,0 +1,26 @@
+/** Small helpers used across the agent loop. */
+import type { StandardSchemaV1 } from "./index";
+/**
+ * Format an error with full stack trace for troubleshooting.
+ * Handles nested errors, non-Error throws, and provider metadata.
+ */
+export declare function formatError(err: unknown): string;
+/** Validate a value against a Standard Schema. Returns either { value } or { issues }. */
+export declare function validateWithSchema<I, O>(schema: StandardSchemaV1<I, O>, value: unknown): Promise<import("./schema").Result<O>>;
+/** Merge two optional AbortSignals into one AbortController.signal. */
+export declare function mergeSignals(a?: AbortSignal, b?: AbortSignal): {
+    signal: AbortSignal;
+    dispose: () => void;
+};
+/** A queue-backed push channel that becomes an AsyncIterable. Used to fan out StreamParts to callers. */
+export declare class PushStream<T> implements AsyncIterable<T> {
+    private buffer;
+    private resolvers;
+    private closed;
+    private failure;
+    push(v: T): void;
+    close(): void;
+    fail(err: unknown): void;
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAkChD;AAED,0FAA0F;AAC1F,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC5C,MAAM,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAC9B,KAAK,EAAE,OAAO,yCAId;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAC3B,CAAC,CAAC,EAAE,WAAW,EACf,CAAC,CAAC,EAAE,WAAW,GACb;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAc9C;AAED,yGAAyG;AACzG,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAiB;IAEhC,IAAI,CAAC,CAAC,EAAE,CAAC;IAMT,KAAK;IAKL,IAAI,CAAC,GAAG,EAAE,OAAO;IAIjB,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;CAc1C"}

package/dist/util.js

@@ -0,0 +1,104 @@
+/** Small helpers used across the agent loop. */
+/**
+ * Format an error with full stack trace for troubleshooting.
+ * Handles nested errors, non-Error throws, and provider metadata.
+ */
+export function formatError(err) {
+    if (!(err instanceof Error)) {
+        return `Non-Error thrown: ${JSON.stringify(err)}`;
+    }
+    const parts = [];
+    parts.push(`${err.name}: ${err.message}`);
+    // Include stack trace
+    if (err.stack) {
+        // Strip the first line (it's the message, already shown)
+        const stackLines = err.stack.split("\n").slice(1);
+        if (stackLines.length > 0) {
+            parts.push(stackLines.slice(0, 15).join("\n"));
+            if (stackLines.length > 15) {
+                parts.push(`  ... ${stackLines.length - 15} more frames`);
+            }
+        }
+    }
+    // Provider-specific metadata (e.g. HTTP status, response body)
+    const meta = err.status ?? err.statusCode;
+    if (meta)
+        parts.push(`  HTTP status: ${meta}`);
+    const code = err.code;
+    if (code)
+        parts.push(`  code: ${code}`);
+    const type = err.type;
+    if (type)
+        parts.push(`  type: ${type}`);
+    // Nested cause (Error.cause)
+    if (err.cause) {
+        parts.push(`  caused by: ${formatError(err.cause)}`);
+    }
+    return parts.join("\n");
+}
+/** Validate a value against a Standard Schema. Returns either { value } or { issues }. */
+export async function validateWithSchema(schema, value) {
+    const res = await schema["~standard"].validate(value);
+    return res;
+}
+/** Merge two optional AbortSignals into one AbortController.signal. */
+export function mergeSignals(a, b) {
+    const ctrl = new AbortController();
+    const relay = (reason) => ctrl.abort(reason);
+    const la = a && (() => relay(a.reason));
+    const lb = b && (() => relay(b.reason));
+    if (a?.aborted)
+        ctrl.abort(a.reason);
+    else if (b?.aborted)
+        ctrl.abort(b.reason);
+    if (la)
+        a.addEventListener("abort", la, { once: true });
+    if (lb)
+        b.addEventListener("abort", lb, { once: true });
+    const dispose = () => {
+        if (la)
+            a.removeEventListener("abort", la);
+        if (lb)
+            b.removeEventListener("abort", lb);
+    };
+    return { signal: ctrl.signal, dispose };
+}
+/** A queue-backed push channel that becomes an AsyncIterable. Used to fan out StreamParts to callers. */
+export class PushStream {
+    buffer = [];
+    resolvers = [];
+    closed = false;
+    failure = null;
+    push(v) {
+        if (this.closed)
+            return;
+        const r = this.resolvers.shift();
+        if (r)
+            r({ value: v, done: false });
+        else
+            this.buffer.push(v);
+    }
+    close() {
+        this.closed = true;
+        while (this.resolvers.length)
+            this.resolvers.shift()({ value: undefined, done: true });
+    }
+    fail(err) {
+        this.failure = err;
+        this.close();
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                if (this.buffer.length)
+                    return Promise.resolve({ value: this.buffer.shift(), done: false });
+                if (this.failure)
+                    return Promise.reject(this.failure);
+                if (this.closed)
+                    return Promise.resolve({ value: undefined, done: true });
+                return new Promise((resolve) => this.resolvers.push(resolve));
+            },
+        };
+    }
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@dex-ai/sdk",
+  "version": "0.1.30",
+  "description": "Agent SDK: interfaces + createAgent() + generate loop. One package.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "workspaces": [
+    "examples"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "changeset publish",
+    "prepublishOnly": "bun run build"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "bun-types": "^1.3.14",
+    "typescript": "^5.6.3",
+    "@changesets/cli": "^2.29.0"
+  },
+  "engines": {
+    "bun": ">=1.1.0"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}