/**
 * @name tools/tool-execution-pipeline
 * @description Opt-in execution pipeline for modular SAP MCP tools and trusted plugins.
 *
 * The compatibility layer still owns MCP transport normalization, allow-list,
 * private-key guards, policy checks, and metrics. This module gives individual
 * tool families a shared way to parse input, return structured success/error
 * envelopes, and attach execution metadata without repeating try/catch blocks.
 *
 * @module tools/tool-execution-pipeline
 */
import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
import type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
import type { SapMcpContext } from '../../core/src/types.js';
import type { UiCardContext } from '../../ui-cards/src/ui-resources.js';
import { type ToolExecutionMetadata } from './tool-execution-metadata.js';
export interface SafeParseSuccess<TInput> {
    readonly success: true;
    readonly data: TInput;
}
export interface SafeParseFailure {
    readonly success: false;
    readonly error: unknown;
}
export interface ToolInputParser<TInput> {
    readonly safeParse: (input: unknown) => SafeParseSuccess<TInput> | SafeParseFailure;
}
export interface ToolExecutionPipelineInput<TInput> {
    readonly rawInput: unknown;
    readonly input: TInput;
    readonly context: SapMcpContext;
    readonly metadata: ToolExecutionMetadata;
}
export interface ToolExecutionPipelineResult<TOutput extends Record<string, unknown>> {
    readonly data: TOutput;
    readonly metadata?: Record<string, unknown>;
    readonly isError?: boolean;
    readonly pipelineResult?: true;
}
export interface ToolExecutionPipelineDefinition<TInput, TOutput extends Record<string, unknown>> {
    readonly name: string;
    readonly title?: string;
    readonly description: string;
    readonly inputSchema: ToolInputParser<TInput> | Record<string, unknown>;
    readonly outputSchema?: Record<string, unknown>;
    readonly annotations?: ToolAnnotations;
    readonly _meta?: Record<string, unknown>;
    readonly responseMode?: 'envelope' | 'data';
    readonly uiCard?: (result: ToolExecutionPipelineResult<TOutput>, input: ToolExecutionPipelineInput<TInput>) => UiCardContext | undefined;
    readonly execute: (input: ToolExecutionPipelineInput<TInput>) => Promise<TOutput | ToolExecutionPipelineResult<TOutput>>;
}
export interface ToolExecutionEnvelope<TOutput extends Record<string, unknown> = Record<string, unknown>> {
    readonly [key: string]: unknown;
    readonly success: boolean;
    readonly toolName: string;
    readonly data?: TOutput;
    readonly metadata: {
        readonly intent: ToolExecutionMetadata['intent'];
        readonly paymentTier: ToolExecutionMetadata['paymentTier'];
        readonly writeOperation: boolean;
        readonly hostedAccountlessBlocked: boolean;
        readonly signerBoundary: string;
    } & Record<string, unknown>;
    readonly error?: {
        readonly code: string;
        readonly message: string;
        readonly details?: unknown;
    };
}
/**
 * @name createToolExecutionResult
 * @description Marks an execution result as an explicit pipeline result wrapper.
 */
export declare function createToolExecutionResult<TOutput extends Record<string, unknown>>(data: TOutput, metadata?: Record<string, unknown>, options?: {
    readonly isError?: boolean;
}): ToolExecutionPipelineResult<TOutput>;
/**
 * @name createToolExecutionEnvelope
 * @description Builds the structured success envelope returned by pipeline tools.
 */
export declare function createToolExecutionEnvelope<TOutput extends Record<string, unknown>>(toolName: string, data: TOutput, metadata: ToolExecutionMetadata, extraMetadata?: Record<string, unknown>): ToolExecutionEnvelope<TOutput>;
/**
 * @name createToolExecutionErrorEnvelope
 * @description Builds a structured application-level error envelope for pipeline tools.
 */
export declare function createToolExecutionErrorEnvelope(toolName: string, metadata: ToolExecutionMetadata, code: string, message: string, details?: unknown): ToolExecutionEnvelope;
/**
 * @name registerPipelineTool
 * @description Registers a modular tool with shared input validation and response envelopes.
 */
export declare function registerPipelineTool<TInput, TOutput extends Record<string, unknown>>(server: Server, context: SapMcpContext, definition: ToolExecutionPipelineDefinition<TInput, TOutput>): void;
//# sourceMappingURL=tool-execution-pipeline.d.ts.map