import type { JsonObject, JsonValue } from "#shared/json.js";
/** Return JSON or immediately throw an error for a matching tool call. */
export type ToolStubOutcome = {
    readonly response: JsonValue;
    readonly throw?: never;
} | {
    readonly response?: never;
    readonly throw: {
        readonly message: string;
        /** Defaults to Error. Sets the name, not a custom JavaScript class. */
        readonly name?: string;
    };
};
/** Stub outcomes selected by tool name and input fields. */
export type ToolStub = {
    readonly id: string;
    /** Use list_tasks for a root tool or researcher/list_tasks for a local subagent's tool. */
    readonly tool: string;
    /** Each named input property must exist and satisfy its JSON Schema. */
    readonly match?: Readonly<Record<string, JsonObject | boolean>>;
} & ({
    readonly outcome: ToolStubOutcome;
    readonly outcomes?: never;
} | {
    readonly outcome?: never;
    readonly outcomes: readonly [ToolStubOutcome, ...ToolStubOutcome[]];
});
export interface StubCall {
    /** Combines the session, turn, and tool call IDs. */
    readonly callId: string;
    readonly tool: string;
    readonly input: unknown;
    readonly persistent?: boolean;
}
export type StubResult = {
    readonly kind: "real";
} | {
    readonly kind: "error";
    readonly error: string;
} | {
    readonly kind: "stub";
    readonly ruleId: string;
    readonly position: number;
    readonly outcome: ToolStubOutcome;
};
/** Rules and workflow routing set by the server after it authorizes tool stubs. */
export interface StubScope {
    readonly token: string;
    readonly rules: readonly ToolStub[];
    readonly rootSessionId?: string;
    readonly agentPath?: string;
}
export declare const STUB_CONTEXT_KEY = "eve.toolStubs";
export declare const STUB_MATCHES_NAMESPACE = "eve.tool-stubs.matches";
export declare const STUB_FAILURE_NAMESPACE = "eve.tool-stubs.failure";
export declare const stubResponseNamespace: (callId: string) => string;