eve/dist/src/public/definitions/connections/dynamic.d.ts

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

import type { McpClientConnectionDefinition } from "#public/definitions/connections/mcp.js";
import type { OpenAPIConnectionDefinition } from "#public/definitions/connections/openapi.js";
import { type DynamicResolveContext, type DynamicSentinel } from "#dynamic/definition.js";
import type { ExactDefinition } from "#public/definitions/exact.js";
/** One connection returned by a dynamic connection resolver. */
export type DynamicConnectionDefinition = McpClientConnectionDefinition | OpenAPIConnectionDefinition;
/** A runtime connection set whose keys become connection names. */
export type DynamicConnectionSet = Readonly<Record<string, DynamicConnectionDefinition>>;
/** Supported return value for a dynamic connection resolver. */
export type DynamicConnectionResult = DynamicConnectionDefinition | DynamicConnectionSet | null;
/** Trusted session identity and minimal channel metadata available to connection resolvers. */
export interface DynamicConnectionResolveContext {
    readonly session: DynamicResolveContext["session"];
    readonly channel: Pick<DynamicResolveContext["channel"], "kind">;
}
/** Session and turn handlers supported by dynamic connections. */
export type DynamicConnectionEvents = {
    readonly [K in "session.started" | "turn.started"]?: (event: unknown, ctx: DynamicConnectionResolveContext) => DynamicConnectionResult | Promise<DynamicConnectionResult>;
};
/** Defines a runtime connection resolver for session and turn boundaries. */
export declare function defineDynamic<const TEvents extends DynamicConnectionEvents>(definition: {
    readonly events: ExactDefinition<TEvents, DynamicConnectionEvents>;
}): DynamicSentinel<DynamicConnectionResult>;