import type { AgentServiceRoute } from "./definition.js";
import type { AgUiResumeValue } from "../ag-ui/tool-shared.js";
import type { DetachedRunTracker } from "./detached-run-tracker.js";
import { type ParsedHostedAgUiRequest } from "../hosted/ag-ui-chat-request.js";
import { type ParsedHostedChatRequest } from "../hosted/chat-request-parser.js";
import { type HostedServiceAuthenticatedRequest, type HostedServiceRunEventAppendTokenVerification } from "./auth.js";
import type { AgUiRuntimeRequest } from "../runtime/ag-ui-contract.js";
import { type HostedRuntimeSourceIdentity } from "../hosted/runtime-source-binding.js";
/** Public API contract for hosted agent service routes logger. */
export type HostedAgentServiceRoutesLogger = {
    warn?: (message: string, metadata?: Record<string, unknown>) => void;
    error(message: string, metadata?: Record<string, unknown>): void;
};
/** Public API contract for agent service routes logger. */
export type AgentServiceRoutesLogger = HostedAgentServiceRoutesLogger;
/** Public API contract for hosted agent service routes trace. */
export type HostedAgentServiceRoutesTrace = <TResult>(operationName: string, operation: () => Promise<TResult>) => Promise<TResult>;
/** Public API contract for agent service routes trace. */
export type AgentServiceRoutesTrace = HostedAgentServiceRoutesTrace;
/** Public API contract for hosted agent service active span attributes. */
export type HostedAgentServiceActiveSpanAttributes = Record<string, string | number | boolean | readonly (string | number | boolean)[] | null | undefined>;
/** Public API contract for agent service active span attributes. */
export type AgentServiceActiveSpanAttributes = HostedAgentServiceActiveSpanAttributes;
/** Input payload for hosted agent service stream execution. */
export type HostedAgentServiceStreamExecutionInput<TExecution extends object> = TExecution & {
    requestAbortSignal: AbortSignal;
    agUiInput: AgUiRuntimeRequest;
};
/** Input payload for agent service stream execution. */
export type AgentServiceStreamExecutionInput<TExecution extends object> = HostedAgentServiceStreamExecutionInput<TExecution>;
/** Input delivered to a hosted agent-service detached execution callback. */
export type HostedAgentServiceDetachedExecutionInput<TExecution extends object> = {
    execution: TExecution;
    abortSignal: AbortSignal;
    /** Required application-facing request clone with internal control headers removed. */
    rawRequest: Request;
};
/** Input payload for agent service detached execution. */
export type AgentServiceDetachedExecutionInput<TExecution extends object> = HostedAgentServiceDetachedExecutionInput<TExecution>;
/** Input payload for hosted agent service detached cleanup. */
export type HostedAgentServiceDetachedCleanupInput<TExecution extends object> = {
    execution: TExecution;
    runId: string;
    conversationId: string;
};
/** Input payload for agent service detached cleanup. */
export type AgentServiceDetachedCleanupInput<TExecution extends object> = HostedAgentServiceDetachedCleanupInput<TExecution>;
/** Options accepted by hosted agent service route set. */
export type HostedAgentServiceRouteSetOptions<TExecution extends object> = {
    forwardedConfigNamespace?: string;
    /** Exact immutable source snapshot served by control-plane runtime invocations. */
    runtimeSource?: HostedRuntimeSourceIdentity;
    authenticateRequest: (request: Request) => Promise<HostedServiceAuthenticatedRequest | Response>;
    verifyProjectAccess: (projectId: string, authToken: string) => Promise<{
        success: true;
        projectSlug?: string;
    } | {
        success: false;
        error: {
            errorCode: string;
            message: string;
            statusCode: number;
        };
    }>;
    verifyRunEventAppendToken?: (input: {
        token: string;
        projectId: string;
        runId: string;
    }) => Promise<HostedServiceRunEventAppendTokenVerification>;
    tracker: DetachedRunTracker<AgUiResumeValue>;
    prepareExecution: (req: ParsedHostedChatRequest) => Promise<TExecution>;
    streamExecutionToAgUiResponse: (input: HostedAgentServiceStreamExecutionInput<TExecution>) => Promise<Response> | Response;
    startDetachedExecution: (input: HostedAgentServiceDetachedExecutionInput<TExecution>) => Promise<void>;
    cleanupExecution?: (input: HostedAgentServiceDetachedCleanupInput<TExecution>) => Promise<void>;
    setActiveSpanAttributes?: (attributes: HostedAgentServiceActiveSpanAttributes) => void;
    trace?: HostedAgentServiceRoutesTrace;
    logger?: HostedAgentServiceRoutesLogger;
};
export type AgentServiceRouteSetOptions<TExecution extends object> = HostedAgentServiceRouteSetOptions<TExecution>;
/** Public API contract for hosted agent service route set. */
export type HostedAgentServiceRouteSet<TExecution extends object> = {
    routes: AgentServiceRoute[];
    authenticateAgUiRequest: (request: Request) => Promise<HostedServiceAuthenticatedRequest | Response>;
    createAgUiValidationErrorResponse: (response: Response) => Promise<Response>;
    buildParsedAgUiRequest: (input: {
        agUiInput: AgUiRuntimeRequest;
        authToken: string;
        userId: string;
    }) => Promise<ParsedHostedAgUiRequest | Response>;
    handleAgUiRequest: (request: Request) => Promise<Response>;
    handleDurableChatRunExecuteRequest: (input: {
        request: Request;
        requestOrCtx?: unknown;
    }) => Promise<Response>;
    handleRuntimeAgentRunInvocationExecuteRequest: (input: {
        request: Request;
        requestOrCtx?: unknown;
        runId?: string;
    }) => Promise<Response>;
    handleDurableChatRunCancelRequest: (input: {
        request: Request;
        runId: string | undefined;
    }) => Promise<Response>;
};
export type AgentServiceRouteSet<TExecution extends object> = HostedAgentServiceRouteSet<TExecution>;
/** Create hosted agent service route set. */
export declare function createHostedAgentServiceRouteSet<TExecution extends object>(options: HostedAgentServiceRouteSetOptions<TExecution>): HostedAgentServiceRouteSet<TExecution>;
export declare const createAgentServiceRouteSet: typeof createHostedAgentServiceRouteSet;
//# sourceMappingURL=routes.d.ts.map