/**
 * module: toolbox —— 本模块要外界提供的能力(编码规范 §10.1 / §5.3)。
 */
import type { ToolContract } from './internal/domain/tool-contract.ts';
import type { ToolCall, ToolResult } from './contract.ts';
export type Clock = {
    now(): Date;
};
export type IdGenerator = {
    next(): string;
};
/** 凭证密封 —— 与 llm 同一实现,由 app 注入(ADR-009) */
export type SecretBox = {
    seal(plaintext: string): string;
    open(cipher: string): string;
};
export type ToolRegistry = {
    list(): Promise<ToolContract[]>;
    get(name: string): Promise<ToolContract | undefined>;
    isEnabled(name: string): Promise<boolean>;
    upsert(contract: ToolContract, connectionCipher: Record<string, string> | null): Promise<void>;
    setEnabled(name: string, enabled: boolean): Promise<void>;
    connectionCipher(name: string): Promise<Record<string, string> | undefined>;
    setAllowlist(activityId: string, tools: readonly string[]): Promise<void>;
    allowlistOf(activityId: string): Promise<string[]>;
    /** 有活动声明引用即不得删除 */
    referencedBy(name: string): Promise<string[]>;
};
/** 工具录制回放存储 —— 与 llm 的 ReplayStore 同构,另存一表(§7.3) */
export type ToolReplayStore = {
    put(record: {
        key: string;
        call: ToolCall;
        result: ToolResult;
        recordedAt: Date;
    }): Promise<void>;
    get(key: string): Promise<{
        call: ToolCall;
        result: ToolResult;
    } | undefined>;
};
/**
 * 工具执行 —— 实现对系统:server 侧执行代码,运行时受限,
 * **只可访问注册申报的连接目标,无其他环境能力**(OS 7.3)。
 */
/**
 * 工具转人台(§6.2)—— 人是工具的一种实现:发出去的卡、答回来的出参都记在这。
 * 内容地址 `callKey` 保证同一次调用只问人一次。
 */
export type ToolHandoffStore = {
    find(taskId: string, callKey: string): Promise<ToolHandoff | undefined>;
    open(handoff: Omit<ToolHandoff, 'state' | 'output'>): Promise<void>;
    /** 人答完:值即出参 */
    answer(workOrderId: string, output: Record<string, unknown>): Promise<ToolHandoff | undefined>;
};
export type ToolHandoff = {
    readonly id: string;
    readonly taskId: string;
    readonly tool: string;
    readonly callKey: string;
    readonly input: Record<string, unknown>;
    readonly workOrderId: string;
    readonly state: 'pending' | 'answered';
    readonly output?: Record<string, unknown> | undefined;
};
export type ToolRuntime = {
    execute(input: {
        readonly contract: ToolContract;
        readonly connection: Readonly<Record<string, string>>;
        readonly call: ToolCall;
        readonly idempotencyKey?: string;
    }): Promise<{
        ok: boolean;
        output?: Record<string, unknown>;
        error?: {
            code: string;
            retryable: boolean;
            message: string;
        };
    }>;
};
/** JSON Schema 校验 —— ajv 在 adapter,usecase 只见本端口(ADR-003) */
export type SchemaValidator = {
    validate(schema: Record<string, unknown>, value: unknown): {
        ok: boolean;
        errors: string[];
    };
};