@dogpile/sdk 0.1.0

package/dist/runtime/termination.js

@@ -0,0 +1,355 @@
+/**
+ * Create a budget termination condition.
+ *
+ * The returned object is JSON-serializable and can be used directly in
+ * `terminate` or composed with {@link firstOf}.
+ */
+export function budget(options) {
+    return {
+        kind: "budget",
+        ...options
+    };
+}
+/**
+ * Create a convergence termination condition.
+ *
+ * The condition fires when the run has produced `stableTurns` sufficiently
+ * similar protocol outputs.
+ */
+export function convergence(options) {
+    return {
+        kind: "convergence",
+        ...options
+    };
+}
+/**
+ * Create a judge termination condition.
+ *
+ * The rubric is stored as serializable configuration so callers can replay or
+ * persist traces without SDK-owned state.
+ */
+export function judge(options) {
+    return {
+        kind: "judge",
+        ...options
+    };
+}
+/**
+ * Compose termination conditions so whichever child fires first wins.
+ *
+ * Conditions are evaluated in the order supplied by the caller. At least one
+ * condition is required so the composite is always meaningful and the public
+ * type remains a non-empty tuple.
+ */
+export function firstOf(...conditions) {
+    if (conditions.length === 0) {
+        throw new RangeError("firstOf requires at least one termination condition.");
+    }
+    return {
+        kind: "firstOf",
+        conditions
+    };
+}
+/**
+ * Evaluate a serializable termination condition against the current run state.
+ *
+ * Budget, convergence, judge, and firstOf conditions are enforced from their
+ * own normalized inputs so one stop class cannot accidentally satisfy another.
+ */
+export function evaluateTermination(condition, context) {
+    switch (condition.kind) {
+        case "budget":
+            return evaluateBudget(condition, context);
+        case "firstOf":
+            return evaluateFirstOf(condition, context).decision;
+        case "convergence":
+            return evaluateConvergence(condition, context);
+        case "judge":
+            return evaluateJudge(condition, context);
+    }
+}
+/**
+ * Evaluate an ordered firstOf composition and return the winning child, if any.
+ */
+export function evaluateFirstOf(condition, context) {
+    const evaluated = [];
+    for (const [index, child] of condition.conditions.entries()) {
+        const decision = evaluateTermination(child, context);
+        evaluated.push(decision);
+        if (decision.type === "stop") {
+            return {
+                kind: "firstOf-output",
+                decision,
+                winningConditionIndex: index,
+                evaluated
+            };
+        }
+    }
+    return {
+        kind: "firstOf-output",
+        decision: { type: "continue", condition },
+        winningConditionIndex: null,
+        evaluated
+    };
+}
+/**
+ * Evaluate a termination condition and return a trace-ready stop record.
+ *
+ * Protocol runners use this helper so the first policy decision that halts a
+ * run is recorded exactly once on the terminal event.
+ */
+export function evaluateTerminationStop(condition, context) {
+    if (condition.kind === "firstOf") {
+        const output = evaluateFirstOf(condition, context);
+        if (output.decision.type !== "stop" || output.winningConditionIndex === null) {
+            return null;
+        }
+        const winningCondition = condition.conditions[output.winningConditionIndex];
+        if (!winningCondition) {
+            throw new RangeError("firstOf stop referenced a missing winning condition.");
+        }
+        return stopRecord(condition, output.decision, {
+            kind: "firstOf-stop",
+            winningConditionIndex: output.winningConditionIndex,
+            winningCondition,
+            firedCondition: output.decision.condition,
+            evaluated: output.evaluated
+        });
+    }
+    const decision = evaluateTermination(condition, context);
+    if (decision.type !== "stop") {
+        return null;
+    }
+    return stopRecord(condition, decision);
+}
+/**
+ * Combine independently evaluated termination decisions with SDK precedence.
+ *
+ * Budget caps win over judge decisions, and judge decisions win over
+ * convergence. This keeps simultaneous stops deterministic while preserving
+ * each evaluator's normalized stop reason on the returned decision.
+ */
+export function combineTerminationDecisions(decisions) {
+    const stopDecisions = decisions.filter((decision) => decision.type === "stop");
+    if (stopDecisions.length === 0) {
+        const firstDecision = decisions[0];
+        if (!firstDecision) {
+            throw new RangeError("combineTerminationDecisions requires at least one decision.");
+        }
+        return firstDecision;
+    }
+    return stopDecisions.reduce((winner, candidate) => stopPrecedence(candidate.normalizedReason) < stopPrecedence(winner.normalizedReason) ? candidate : winner);
+}
+/**
+ * Evaluate cost, token, iteration, and timeout caps for a budget condition.
+ */
+export function evaluateBudget(condition, context) {
+    const iteration = context.iteration ?? context.transcript.length;
+    const elapsedMs = context.elapsedMs ?? 0;
+    const costStop = stopIfReached(condition, "maxUsd", "cost", context.cost.usd);
+    if (costStop) {
+        return costStop;
+    }
+    const tokenStop = stopIfReached(condition, "maxTokens", "tokens", context.cost.totalTokens);
+    if (tokenStop) {
+        return tokenStop;
+    }
+    const iterationStop = stopIfReached(condition, "maxIterations", "iterations", iteration);
+    if (iterationStop) {
+        return iterationStop;
+    }
+    const timeoutStop = stopIfReached(condition, "timeoutMs", "timeout", elapsedMs);
+    if (timeoutStop) {
+        return timeoutStop;
+    }
+    return { type: "continue", condition };
+}
+/**
+ * Evaluate protocol-level convergence from recent coordination outputs.
+ *
+ * This intentionally ignores budget caps and judge quality state. Budget and
+ * judge conditions can be composed with convergence through `firstOf`, but a
+ * convergence condition itself only reads protocol output signals.
+ */
+export function evaluateConvergence(condition, context) {
+    const stableTurns = Math.max(1, Math.ceil(condition.stableTurns));
+    if (context.transcript.length < stableTurns) {
+        return { type: "continue", condition };
+    }
+    const recentEntries = context.transcript.slice(-stableTurns);
+    const recentOutputs = recentEntries.map((entry) => entry.output);
+    const similarities = consecutiveSimilarities(recentEntries);
+    const observedSimilarity = similarities.length === 0 ? 1 : Math.min(...similarities);
+    if (observedSimilarity < condition.minSimilarity) {
+        return { type: "continue", condition };
+    }
+    return {
+        type: "stop",
+        condition,
+        reason: "convergence",
+        normalizedReason: "convergence",
+        detail: {
+            protocol: context.protocol,
+            stableTurns,
+            minSimilarity: condition.minSimilarity,
+            observedSimilarity,
+            outputs: recentOutputs
+        }
+    };
+}
+/**
+ * Evaluate caller-owned judge state without reading budget or convergence data.
+ *
+ * Explicit accept/reject verdicts always halt. Score-only decisions halt when
+ * they meet `minScore`; when `minScore` is omitted, any score-only decision is
+ * treated as the judge's terminal decision.
+ */
+export function evaluateJudge(condition, context) {
+    const decision = context.judgeDecision ?? scoreDecisionFromQuality(context.quality);
+    if (!decision) {
+        return { type: "continue", condition };
+    }
+    switch (decision.type) {
+        case "accept":
+            return judgeStop(condition, "accepted", decision);
+        case "reject":
+            return judgeStop(condition, "rejected", decision);
+        case "score": {
+            const minScore = condition.minScore;
+            if (minScore !== undefined && decision.score < minScore) {
+                return { type: "continue", condition };
+            }
+            return judgeStop(condition, "score-threshold", decision, minScore);
+        }
+    }
+}
+function stopIfReached(condition, cap, reason, observed) {
+    const limit = condition[cap];
+    if (limit === undefined || observed < limit) {
+        return null;
+    }
+    return {
+        type: "stop",
+        condition,
+        reason: "budget",
+        normalizedReason: normalizeBudgetStopReason(reason),
+        budgetReason: reason,
+        detail: {
+            cap,
+            limit,
+            observed
+        }
+    };
+}
+function scoreDecisionFromQuality(quality) {
+    if (quality === undefined) {
+        return null;
+    }
+    return {
+        type: "score",
+        score: quality
+    };
+}
+function judgeStop(condition, judgeReason, decision, minScore) {
+    return {
+        type: "stop",
+        condition,
+        reason: "judge",
+        normalizedReason: normalizeJudgeStopReason(judgeReason),
+        judgeReason,
+        detail: judgeStopDetail(decision, minScore)
+    };
+}
+function normalizeBudgetStopReason(reason) {
+    switch (reason) {
+        case "cost":
+            return "budget:cost";
+        case "tokens":
+            return "budget:tokens";
+        case "iterations":
+            return "budget:iterations";
+        case "timeout":
+            return "budget:timeout";
+    }
+}
+function normalizeJudgeStopReason(reason) {
+    switch (reason) {
+        case "accepted":
+            return "judge:accepted";
+        case "rejected":
+            return "judge:rejected";
+        case "score-threshold":
+            return "judge:score-threshold";
+    }
+}
+function stopPrecedence(reason) {
+    if (reason.startsWith("budget:")) {
+        return 0;
+    }
+    if (reason.startsWith("judge:")) {
+        return 1;
+    }
+    return 2;
+}
+function judgeStopDetail(decision, minScore) {
+    return {
+        decision: decision.type,
+        ...(decision.score !== undefined ? { score: decision.score } : {}),
+        ...(minScore !== undefined ? { minScore } : {}),
+        ...(decision.rationale !== undefined ? { rationale: decision.rationale } : {}),
+        ...(decision.metadata !== undefined ? { metadata: decision.metadata } : {})
+    };
+}
+function stopRecord(rootCondition, decision, firstOfRecord) {
+    return {
+        kind: "termination-stop",
+        rootCondition,
+        firedCondition: decision.condition,
+        reason: decision.reason,
+        normalizedReason: decision.normalizedReason,
+        ...(decision.budgetReason !== undefined ? { budgetReason: decision.budgetReason } : {}),
+        ...(decision.judgeReason !== undefined ? { judgeReason: decision.judgeReason } : {}),
+        ...(decision.detail !== undefined ? { detail: decision.detail } : {}),
+        ...(firstOfRecord !== undefined ? { firstOf: firstOfRecord } : {})
+    };
+}
+function consecutiveSimilarities(entries) {
+    const similarities = [];
+    for (let index = 1; index < entries.length; index += 1) {
+        const previous = entries[index - 1];
+        const current = entries[index];
+        if (previous && current) {
+            similarities.push(outputSimilarity(previous.output, current.output));
+        }
+    }
+    return similarities;
+}
+function outputSimilarity(left, right) {
+    const normalizedLeft = normalizeOutput(left);
+    const normalizedRight = normalizeOutput(right);
+    if (normalizedLeft === normalizedRight) {
+        return 1;
+    }
+    const leftTokens = tokenize(normalizedLeft);
+    const rightTokens = tokenize(normalizedRight);
+    if (leftTokens.length === 0 || rightTokens.length === 0) {
+        return 0;
+    }
+    const leftSet = new Set(leftTokens);
+    const rightSet = new Set(rightTokens);
+    let intersection = 0;
+    for (const token of leftSet) {
+        if (rightSet.has(token)) {
+            intersection += 1;
+        }
+    }
+    const union = new Set([...leftSet, ...rightSet]).size;
+    return union === 0 ? 0 : intersection / union;
+}
+function normalizeOutput(output) {
+    return output.trim().toLowerCase();
+}
+function tokenize(output) {
+    return output.split(/[^a-z0-9]+/u).filter((token) => token.length > 0);
+}
+//# sourceMappingURL=termination.js.map

package/dist/runtime/termination.js.map

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

package/dist/runtime/tools.d.ts

@@ -0,0 +1,314 @@
+import type { JsonObject, JsonValue, RuntimeTool, RuntimeToolAdapterContract, RuntimeToolAdapterError, RuntimeToolExecutionContext, RuntimeToolExecutor, RuntimeToolIdentity, RuntimeToolInputSchema, RuntimeToolPermission, RuntimeToolResult, TranscriptToolCall, RuntimeToolTraceContext, RuntimeToolValidationResult, RunEvent, ModelMessage, ModelResponse } from "../types.js";
+type VercelAIToolExecuteOptions = {
+    readonly toolCallId: string;
+    readonly messages: ModelMessage[];
+    readonly abortSignal?: AbortSignal;
+    readonly experimental_context: RuntimeToolExecutionContext;
+};
+type VercelAIToolExecuteFunction<Input, Output> = (input: Input, options: VercelAIToolExecuteOptions) => Output | PromiseLike<Output> | AsyncIterable<Output>;
+type VercelAICompatibleSchema<Input> = unknown;
+/**
+ * Built-in Dogpile tool names with stable protocol-facing semantics.
+ */
+export type DogpileBuiltInToolName = "webSearch" | "codeExec";
+/**
+ * Input accepted by the built-in web search tool contract.
+ */
+export interface WebSearchToolInput extends JsonObject {
+    readonly query: string;
+    readonly maxResults?: number;
+}
+/**
+ * One normalized web search result.
+ */
+export interface WebSearchToolResult extends JsonObject {
+    readonly title: string;
+    readonly url: string;
+    readonly snippet?: string;
+    readonly metadata?: JsonObject;
+}
+/**
+ * Output returned by the built-in web search tool contract.
+ */
+export interface WebSearchToolOutput extends JsonObject {
+    readonly results: WebSearchToolResult[];
+}
+/**
+ * Fetch implementation accepted by the built-in web search adapter.
+ */
+export type WebSearchFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+/**
+ * Request data produced before the built-in web search adapter calls `fetch`.
+ */
+export interface WebSearchFetchRequest {
+    readonly url: string | URL;
+    readonly init?: RequestInit;
+}
+/**
+ * Build a search backend request from normalized web search input.
+ */
+export type WebSearchFetchRequestBuilder = (input: Readonly<WebSearchToolInput>, context: RuntimeToolExecutionContext) => WebSearchFetchRequest;
+/**
+ * Parse a search backend response into Dogpile's stable web search output.
+ */
+export type WebSearchFetchResponseParser = (response: Response, input: Readonly<WebSearchToolInput>, context: RuntimeToolExecutionContext) => WebSearchToolOutput | Promise<WebSearchToolOutput>;
+/**
+ * Options for the built-in fetch-based web search adapter.
+ */
+export interface WebSearchToolAdapterOptions {
+    readonly endpoint: string | URL;
+    readonly fetch?: WebSearchFetch;
+    readonly headers?: HeadersInit;
+    readonly defaultMaxResults?: number;
+    readonly identity?: BuiltInDogpileToolIdentityOptions;
+    readonly permissions?: readonly RuntimeToolPermission[];
+    readonly buildRequest?: WebSearchFetchRequestBuilder;
+    readonly parseResponse?: WebSearchFetchResponseParser;
+}
+/**
+ * Options for the built-in code execution adapter.
+ */
+export interface CodeExecToolAdapterOptions {
+    readonly execute: CodeExecSandboxExecutor;
+    readonly defaultTimeoutMs?: number;
+    readonly maxTimeoutMs?: number;
+    readonly languages?: readonly CodeExecToolLanguage[];
+    readonly allowNetwork?: boolean;
+    readonly identity?: BuiltInDogpileToolIdentityOptions;
+    readonly permissions?: readonly RuntimeToolPermission[];
+}
+/**
+ * Input accepted by the built-in code execution tool contract.
+ *
+ * @remarks
+ * Dogpile core does not provide a sandbox implementation. Callers supply the
+ * executor while Dogpile normalizes the public tool identity and schema.
+ */
+export interface CodeExecToolInput extends JsonObject {
+    readonly language: "javascript" | "typescript" | "python" | "bash" | "shell";
+    readonly code: string;
+    readonly timeoutMs?: number;
+}
+/**
+ * Output returned by the built-in code execution tool contract.
+ */
+export interface CodeExecToolOutput extends JsonObject {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly exitCode: number;
+    readonly metadata?: JsonObject;
+}
+/**
+ * Language identifiers accepted by Dogpile's built-in code execution contract.
+ */
+export type CodeExecToolLanguage = CodeExecToolInput["language"];
+/**
+ * Executor signature for the built-in web search contract.
+ */
+export type WebSearchToolExecutor = (input: Readonly<WebSearchToolInput>, context: RuntimeToolExecutionContext) => RuntimeToolResult<WebSearchToolOutput> | Promise<RuntimeToolResult<WebSearchToolOutput>>;
+/**
+ * Executor signature for the built-in code execution contract.
+ */
+export type CodeExecToolExecutor = (input: Readonly<CodeExecToolInput>, context: RuntimeToolExecutionContext) => RuntimeToolResult<CodeExecToolOutput> | Promise<RuntimeToolResult<CodeExecToolOutput>>;
+/**
+ * Caller-owned sandbox implementation used by Dogpile's built-in code execution adapter.
+ */
+export type CodeExecSandboxExecutor = (input: Readonly<CodeExecToolInput>, context: RuntimeToolExecutionContext) => CodeExecToolOutput | Promise<CodeExecToolOutput>;
+/**
+ * Optional identity fields callers may layer onto built-in Dogpile tools.
+ */
+export interface BuiltInDogpileToolIdentityOptions {
+    readonly namespace?: string;
+    readonly version?: string;
+    readonly description?: string;
+}
+/**
+ * Definition used to normalize Dogpile's built-in web search tool.
+ */
+export interface WebSearchDogpileToolDefinition {
+    readonly name: "webSearch";
+    readonly execute: WebSearchToolExecutor;
+    readonly identity?: BuiltInDogpileToolIdentityOptions;
+    readonly inputSchema?: RuntimeToolInputSchema;
+    readonly permissions?: readonly RuntimeToolPermission[];
+}
+/**
+ * Definition used to normalize Dogpile's built-in code execution tool.
+ */
+export interface CodeExecDogpileToolDefinition {
+    readonly name: "codeExec";
+    readonly execute: CodeExecToolExecutor;
+    readonly identity?: BuiltInDogpileToolIdentityOptions;
+    readonly inputSchema?: RuntimeToolInputSchema;
+    readonly permissions?: readonly RuntimeToolPermission[];
+}
+/**
+ * Built-in Dogpile tool definitions accepted by the normalization helper.
+ */
+export type BuiltInDogpileToolDefinition = WebSearchDogpileToolDefinition | CodeExecDogpileToolDefinition;
+/**
+ * Caller-supplied built-in tool executors keyed by Dogpile's stable built-in names.
+ */
+export interface BuiltInDogpileToolExecutors {
+    readonly webSearch?: WebSearchToolExecutor | WebSearchDogpileToolDefinition;
+    readonly codeExec?: CodeExecToolExecutor | CodeExecDogpileToolDefinition;
+}
+export type BuiltInDogpileRuntimeTool = RuntimeToolAdapterContract<WebSearchToolInput, WebSearchToolOutput> | RuntimeToolAdapterContract<CodeExecToolInput, CodeExecToolOutput>;
+/**
+ * Vercel AI SDK tool shape accepted by Dogpile's normalization adapter.
+ */
+export interface VercelAITool<Input extends JsonObject = JsonObject, Output extends JsonValue = JsonValue> {
+    readonly description?: string;
+    readonly inputSchema: VercelAICompatibleSchema<Input>;
+    readonly execute?: VercelAIToolExecuteFunction<Input, Output>;
+}
+/**
+ * Optional identity fields callers may layer onto normalized Vercel AI tools.
+ */
+export interface VercelAIToolIdentityOptions {
+    readonly id?: string;
+    readonly namespace?: string;
+    readonly version?: string;
+    readonly description?: string;
+}
+/**
+ * Definition used to normalize one Vercel AI SDK tool into Dogpile's runtime tool interface.
+ */
+export interface VercelAIToolDefinition<Name extends string = string, Input extends JsonObject = JsonObject, Output extends JsonValue = JsonValue> {
+    readonly name: Name;
+    readonly tool: VercelAITool<Input, Output>;
+    readonly identity?: VercelAIToolIdentityOptions;
+    readonly inputSchema?: RuntimeToolInputSchema;
+    readonly messages?: readonly ModelMessage[];
+}
+/**
+ * Caller-supplied Vercel AI SDK tool set keyed by model-visible tool name.
+ */
+export interface VercelAIToolSetEntry {
+    readonly description?: string;
+    readonly inputSchema: VercelAICompatibleSchema<unknown>;
+    readonly execute?: VercelAIToolExecuteFunction<never, JsonValue>;
+}
+/**
+ * Caller-supplied Vercel AI SDK tool set keyed by model-visible tool name.
+ */
+export type VercelAIToolSet = Readonly<Record<string, VercelAIToolSetEntry>>;
+/**
+ * Options shared while normalizing a Vercel AI SDK tool set.
+ */
+export interface VercelAIToolSetNormalizationOptions {
+    readonly namespace?: string;
+    readonly version?: string;
+    readonly messages?: readonly ModelMessage[];
+    readonly identity?: Readonly<Record<string, VercelAIToolIdentityOptions>>;
+}
+/**
+ * Options for the shared protocol-agnostic runtime tool executor.
+ */
+export interface RuntimeToolExecutorOptions {
+    readonly runId: string;
+    readonly protocol: RuntimeToolExecutionContext["protocol"];
+    readonly tier: RuntimeToolExecutionContext["tier"];
+    readonly tools: readonly RuntimeTool<JsonObject, JsonValue>[];
+    readonly emit?: (event: RunEvent) => void;
+    readonly getTrace?: () => RuntimeToolTraceContext;
+    readonly metadata?: JsonObject;
+    readonly abortSignal?: AbortSignal;
+    readonly makeToolCallId?: (tool: RuntimeToolIdentity, callIndex: number) => string;
+}
+/**
+ * Return the default Dogpile identity for one built-in tool name.
+ */
+export declare function builtInDogpileToolIdentity(name: "webSearch"): RuntimeToolIdentity;
+export declare function builtInDogpileToolIdentity(name: "codeExec"): RuntimeToolIdentity;
+/**
+ * Return the default Dogpile input schema for one built-in tool name.
+ */
+export declare function builtInDogpileToolInputSchema(name: "webSearch"): RuntimeToolInputSchema;
+export declare function builtInDogpileToolInputSchema(name: "codeExec"): RuntimeToolInputSchema;
+/**
+ * Return the default permission declarations for one built-in tool name.
+ */
+export declare function builtInDogpileToolPermissions(name: DogpileBuiltInToolName): readonly RuntimeToolPermission[];
+/**
+ * Validate one built-in Dogpile tool input before adapter execution.
+ */
+export declare function validateBuiltInDogpileToolInput(name: "webSearch", input: Readonly<Partial<WebSearchToolInput>>): RuntimeToolValidationResult;
+export declare function validateBuiltInDogpileToolInput(name: "codeExec", input: Readonly<Partial<CodeExecToolInput>>): RuntimeToolValidationResult;
+export declare function validateBuiltInDogpileToolInput(name: DogpileBuiltInToolName, input: Readonly<Partial<WebSearchToolInput> | Partial<CodeExecToolInput>>): RuntimeToolValidationResult;
+/**
+ * Create the shared runtime tool executor used by every first-party protocol.
+ *
+ * @remarks
+ * The executor owns call id generation, read-only trace context construction,
+ * adapter validation, error normalization, and matched `tool-call` /
+ * `tool-result` events. Protocols only supply a normalized
+ * {@link RuntimeToolExecutionRequest}, which keeps tool execution independent
+ * of Coordinator, Sequential, Broadcast, or Shared control flow.
+ */
+export declare function createRuntimeToolExecutor(options: RuntimeToolExecutorOptions): RuntimeToolExecutor;
+/**
+ * Return a JSON-serializable manifest for tools visible to a protocol run.
+ */
+export declare function runtimeToolManifest(tools: readonly RuntimeTool<JsonObject, JsonValue>[]): JsonObject[];
+/**
+ * Return request metadata that makes runtime tools visible to provider
+ * adapters, or an empty object when no tools are available.
+ */
+export declare function runtimeToolAvailability(tools: readonly RuntimeTool<JsonObject, JsonValue>[]): JsonObject;
+/**
+ * Execute normalized tool requests returned by a provider response.
+ */
+export declare function executeModelResponseToolRequests(options: {
+    readonly response: ModelResponse;
+    readonly executor: RuntimeToolExecutor;
+    readonly agentId: string;
+    readonly role: string;
+    readonly turn: number;
+    readonly metadata?: JsonObject;
+}): Promise<readonly TranscriptToolCall[]>;
+/**
+ * Convert an unknown adapter failure into Dogpile's serializable error data.
+ */
+export declare function normalizeRuntimeToolAdapterError(error: unknown): RuntimeToolAdapterError;
+/**
+ * Create Dogpile's built-in fetch-based web search adapter.
+ *
+ * @remarks
+ * The adapter is backend-neutral: by default it sends a GET request with
+ * `q` and `limit` query parameters, then accepts either `{ results: [...] }`
+ * or a bare array of result objects from the response JSON. Callers can replace
+ * request construction or response parsing for a specific search API while
+ * keeping Dogpile's shared runtime tool contract, identity, permissions, input
+ * validation, and serializable errors.
+ */
+export declare function createWebSearchToolAdapter(options: WebSearchToolAdapterOptions): RuntimeToolAdapterContract<WebSearchToolInput, WebSearchToolOutput>;
+/**
+ * Create Dogpile's built-in code execution adapter around a caller-owned sandbox.
+ *
+ * @remarks
+ * Dogpile core stays runtime-portable and never evaluates code itself. This
+ * adapter supplies the stable `codeExec` identity, schema, permissions,
+ * validation, timeout defaults, abort handling, and serializable errors while
+ * the host application owns the sandbox boundary.
+ */
+export declare function createCodeExecToolAdapter(options: CodeExecToolAdapterOptions): RuntimeToolAdapterContract<CodeExecToolInput, CodeExecToolOutput>;
+/**
+ * Normalize one built-in Dogpile tool definition into the shared runtime tool interface.
+ */
+export declare function normalizeBuiltInDogpileTool(definition: WebSearchDogpileToolDefinition): RuntimeToolAdapterContract<WebSearchToolInput, WebSearchToolOutput>;
+export declare function normalizeBuiltInDogpileTool(definition: CodeExecDogpileToolDefinition): RuntimeToolAdapterContract<CodeExecToolInput, CodeExecToolOutput>;
+/**
+ * Normalize configured built-in Dogpile tool executors into runtime tools.
+ */
+export declare function normalizeBuiltInDogpileTools(tools: BuiltInDogpileToolExecutors): readonly BuiltInDogpileRuntimeTool[];
+/**
+ * Normalize one Vercel AI SDK tool into Dogpile's shared runtime tool interface.
+ */
+export declare function normalizeVercelAITool<Name extends string, Input extends JsonObject, Output extends JsonValue>(definition: VercelAIToolDefinition<Name, Input, Output>): Promise<RuntimeTool<Input, Output>>;
+/**
+ * Normalize a Vercel AI SDK tool set into runtime tools in caller-defined key order.
+ */
+export declare function normalizeVercelAITools(tools: VercelAIToolSet, options?: VercelAIToolSetNormalizationOptions): Promise<readonly RuntimeTool<JsonObject, JsonValue>[]>;
+export {};
+//# sourceMappingURL=tools.d.ts.map