eve/dist/src/internal/authored-definition/schema-backed.d.ts

Filesystem-first framework for durable backend AI agents that run anywhere.

import type { InternalToolDefinition, ToolExecuteFn } from "#tools/definition.js";
import { type CompiledToolBehavior } from "#tools/behavior.js";
import { type DynamicToolEventName } from "#dynamic/definition.js";
/**
 * Canonical normalized shape of one authored tool default export.
 *
 * Identity is path-derived — the compiler stamps the filename slug onto
 * the compiled entry. This shape never carries an authored `name`.
 */
type NormalizedAuthoredTool = Readonly<Omit<InternalToolDefinition, "name"> & {
    readonly behavior?: CompiledToolBehavior;
    readonly execute?: ToolExecuteFn;
    readonly hasApproval: boolean;
    readonly hasExecute: boolean;
    readonly hasModelOutputProjection: boolean;
}>;
/**
 * Result of normalizing one authored tool default export. Either a real tool
 * definition, a sentinel that disables a framework default, or a dynamic
 * tool resolver. In all cases the disable target / runtime name is the
 * authored file's slug, supplied by the compiler — this layer never sees
 * a name.
 */
type NormalizedToolEntry = {
    readonly kind: "tool";
    readonly definition: NormalizedAuthoredTool;
} | {
    readonly kind: "disabled";
} | {
    readonly kind: "workflow-tool";
    readonly maxSubagents?: number;
} | {
    readonly kind: "web-search-tool";
    readonly provider: "exa" | "parallel";
} | {
    readonly kind: "dynamic-tool";
    readonly eventNames: readonly DynamicToolEventName[];
    readonly rebindMissingCallbacks: boolean;
};
/**
 * Normalizes one authored tool default export. Recognizes real tool
 * definitions (`defineTool(...)`), disable sentinels (`disableTool()`), and the
 * experimental `Workflow` tool definition.
 *
 * Authored `name` fields are rejected — tool identity is path-derived.
 */
export declare function normalizeToolDefinition(value: unknown, message: string): NormalizedToolEntry;
export {};