import type { Agent } from "../types.js";
/**
 * Transport-neutral durable run lifecycle sink for agent-service adoption work.
 */
export interface DurableRunSink<TStartInput = void, TRun = unknown, TEvent = unknown, TTerminalState = unknown> {
    startRun(input: TStartInput): Promise<TRun> | TRun;
    appendEvents(run: TRun, events: TEvent[]): Promise<void> | void;
    finalizeRun(run: TRun, terminalState: TTerminalState): Promise<void> | void;
    cancelRun(run: TRun, terminalState: TTerminalState): Promise<void> | void;
}
/**
 * Host-facing server config for the agent service runtime shell.
 */
export type AgentServiceRouteMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS";
/** Configuration used by agent service cors. */
export interface AgentServiceCorsConfig {
    origins?: string[];
    credentials?: boolean;
    allowMethods?: AgentServiceRouteMethod[];
    allowHeaders?: string[];
    maxAgeSeconds?: number;
}
/** Configuration used by agent service server. */
export interface AgentServiceServerConfig {
    port?: number;
    basePath?: string;
    cors?: boolean | AgentServiceCorsConfig;
}
/** Public API contract for agent service route. */
export interface AgentServiceRoute {
    method: AgentServiceRouteMethod;
    path: string;
    handler: (request: Request, params: Record<string, string>) => Promise<Response> | Response;
}
export interface AgentServiceRuntime<TStartInput = void, TRun = unknown, TEvent = unknown, TTerminalState = unknown> {
    readonly contract: NormalizedAgentServiceContract<TStartInput, TRun, TEvent, TTerminalState>;
    fetch(request: Request): Promise<Response>;
    request(input: string | URL | Request, init?: RequestInit): Promise<Response>;
    setShuttingDown(shuttingDown?: boolean): void;
}
/** Public API contract for agent registry. */
export type AgentRegistry = Record<string, Agent>;
export interface AgentServiceContractBase<TStartInput = void, TRun = unknown, TEvent = unknown, TTerminalState = unknown> {
    serviceName: string;
    server?: AgentServiceServerConfig;
    durableRunSink?: DurableRunSink<TStartInput, TRun, TEvent, TTerminalState>;
}
/**
 * Multi-agent service contract. Framework services route to
 * `defaultAgentId` unless the host chooses another registered agent.
 */
export interface AgentServiceRegistryContract<TStartInput = void, TRun = unknown, TEvent = unknown, TTerminalState = unknown> extends AgentServiceContractBase<TStartInput, TRun, TEvent, TTerminalState> {
    agents: AgentRegistry;
    defaultAgentId: string;
}
/**
 * Single-agent convenience accepted by `defineAgentService()`. Implementations
 * must normalize this shape into the same registry path used by multi-agent
 * services so framework users are not boxed into one-agent-per-process.
 */
export interface AgentServiceSingleAgentContract<TStartInput = void, TRun = unknown, TEvent = unknown, TTerminalState = unknown> extends AgentServiceContractBase<TStartInput, TRun, TEvent, TTerminalState> {
    agent: Agent;
    defaultAgentId?: string;
}
/**
 * Framework-owned agent service contract.
 */
export type AgentContract<TStartInput = void, TRun = unknown, TEvent = unknown, TTerminalState = unknown> = AgentServiceRegistryContract<TStartInput, TRun, TEvent, TTerminalState> | AgentServiceSingleAgentContract<TStartInput, TRun, TEvent, TTerminalState>;
/** Public API contract for normalized agent service contract. */
export interface NormalizedAgentServiceContract<TStartInput = void, TRun = unknown, TEvent = unknown, TTerminalState = unknown> extends AgentServiceContractBase<TStartInput, TRun, TEvent, TTerminalState> {
    agents: AgentRegistry;
    defaultAgentId: string;
}
/**
 * Type-preserving service definition for request-native agent service runtimes.
 */
export interface AgentServiceDefinition<TStartInput = void, TRun = unknown, TEvent = unknown, TTerminalState = unknown> {
    contract: NormalizedAgentServiceContract<TStartInput, TRun, TEvent, TTerminalState>;
    createRuntime(options?: {
        routes?: AgentServiceRoute[];
    }): AgentServiceRuntime<TStartInput, TRun, TEvent, TTerminalState>;
}
/**
 * Define an agent service and expose a policy-neutral runtime shell.
 *
 * The first implementation slice owns contract normalization plus standard
 * health/readiness behavior. Hosts pass product-specific routes explicitly so
 * auth, observability, durable sinks, and AG-UI execution policy can keep
 * migrating in smaller additive seams.
 */
export declare function defineAgentService<TStartInput = void, TRun = unknown, TEvent = unknown, TTerminalState = unknown>(contract: AgentContract<TStartInput, TRun, TEvent, TTerminalState>): AgentServiceDefinition<TStartInput, TRun, TEvent, TTerminalState>;
//# sourceMappingURL=definition.d.ts.map