/** DSH ctx 最小镜像（只含本仓实际使用的面；type-only，构建期擦除，零运行时）。
 *
 * 每条成员的用法出处见 `docs/agents/dsh-client-contract.md`（附源码路径 ＋ 行）。
 * skills 面出处：`ctx.skills.registerProvider(create)`（`dsh-skill/lib/index.js:147`）；
 *   candidate 校验红线见 `validateCandidate`（同文件 `:452`）；`get` 回定义须与候选同名（同文件 `:259`）。
 * slots 面出处：`inject(key, cb)` 等声明同步跑否则等待（`dsh-client-ui-renderer/lib/client.js:1015`）；
 *   `register` list 必 `{id}`（`dsh-client-ui-slots/lib/index.js:72`）；
 *   爱生活页签槽注册形见 cookbook §11（`{name:'ilife.config-tab', id, order, label}`）。
 * connection 面出处：宿主注册走 `connection.fetch.register(route)`、面板调用走
 *   `connection.rpc.call(channel, endpoint, payload, signal)`（#80 迁移到公开 `/api` 载体，样式见
 *   `@xmanrui/dsh-im` 的 `plugin-src/management-rpc.mjs`）。
 * 禁止加镜外成员：要用新能力，先在 cookbook 落出处，再加镜像。用 `import type` 引用本文件。
 *
 * #696：本文件原先是「最小静态注册，不取数，故无 connection」。设置页要读改配置，
 * 按 #676 卡路里／#677 记账／#696 大厨先例补上 connection 两侧（host 注册 ＋ client 调用），其余面不动。
 */
/** 爱生活页签槽注册项（cookbook §11 options 全形子集，只取本次用到的面）。 */
export interface SlotsRegisterOptions {
    readonly name: string;
    readonly id?: string;
    readonly order?: number;
    readonly label?: string | (() => string);
    readonly locale?: string;
    /** 本包自己那条 RPC 通道（单段，例 `/ilife-schedule-ilife`）：注册方写进来，读方（总管）据此**通用地**
     *  调它，不必在源码里写死任何一家的通道名（#706 配置体检要走它；格与出处照
     *  `packages/plugin-manager/src/dsh-ctx.ts:19-21`）。 */
    readonly channel?: string;
    readonly inject?: () => Record<string, unknown>;
}
/** 总管声明的爱生活页签槽面（client 侧只用 inject＋register）。 */
export interface SlotsFace {
    inject(key: string, callback: () => (() => void) | Iterable<() => void>): () => void;
    register(options: SlotsRegisterOptions, component: unknown): () => void;
}
/** rpc.call 的回执信封（本包只读 ok／value／error 三处）。 */
export interface RpcCallResult {
    readonly ok: boolean;
    readonly value?: unknown;
    readonly error?: {
        readonly code?: string;
        readonly message?: string;
    };
}
/** 面板侧调用口（每次取数时现取：connection 后到也不永久缺席）。 */
export type RpcCallFace = (path: string, channel: string, body: unknown, signal?: AbortSignal) => Promise<unknown>;
/** 作息 client 上下文（#696 起 client 侧用 slots ＋ connection 两面：设置页要经 connection 读改配置）。 */
export interface ClientCtx {
    readonly slots: SlotsFace;
    /** 宿主连接面：客户端经它把请求送进宿主注册的 /api 路由。缺席即由组件判「宿主连接缺席」。 */
    readonly connection?: {
        readonly rpc?: {
            readonly call?: RpcCallFace;
        };
    };
    /** 服务取用（本包暂不用，保留面以对齐兄弟件镜像）。 */
    get?(name: string): unknown;
    /** 卸载清理登记。 */
    effect?(callback: () => void, label?: string): void;
}
/** 技能的调用策略（模型可调／用户可调）。 */
export interface SkillInvocationPolicy {
    readonly modelInvocable: boolean;
    readonly userInvocable: boolean;
}
/** 候选摘要（宿主 `list` 的返回项；`provider` 须等于注册名，否则宿主校验抛）。 */
export interface SkillCandidate {
    readonly name: string;
    readonly description: string;
    readonly invocation: SkillInvocationPolicy;
    readonly provider: string;
    readonly source: string;
    readonly rank: number;
    readonly locator: unknown;
    readonly resourceBase?: {
        readonly kind: 'directory';
        readonly path: string;
    };
}
/** 技能全文（宿主 `get` 的返回项；`content` 为 frontmatter 后正文）。 */
export interface SkillDefinition {
    readonly name: string;
    readonly description: string;
    readonly invocation: SkillInvocationPolicy;
    readonly provider: string;
    readonly source: string;
    readonly resourceBase?: {
        readonly kind: 'directory';
        readonly path: string;
    };
    readonly content: string;
}
export interface SkillProvider {
    readonly name: string;
    list(options?: unknown): Promise<readonly SkillCandidate[]>;
    get(candidate: SkillCandidate, options?: unknown): Promise<SkillDefinition | undefined>;
}
export interface SkillsFace {
    registerProvider(create: (control: {
        readonly signal: AbortSignal;
        invalidate(): void;
    }) => SkillProvider): () => void;
}
/** RPC 处理函数：端点 ＋ 载荷 → 信封回执（照 #676 卡路里样板同形）。 */
export type RpcHandler = (endpoint: string, payload: unknown) => Promise<unknown>;
/** 宿主 fetch 路由注册面（`ctx.connection.fetch.register`）。 */
export interface HostConnectionFace {
    readonly fetch: {
        register(options: Record<string, unknown>): () => void;
    };
}
/** 本插件用到的宿主面（apply 入参）。 */
export interface SkillHostCtx {
    readonly skills: SkillsFace;
    /** 模型工具注册表（#734）：本包把技能唯一出口开成 agent 工具。 */
    readonly tools?: ToolsFace;
    /** 宿主连接面：设置页的三个配置端点注册在这上面（#696 起用）。 */
    readonly connection?: HostConnectionFace;
    /** 卸载清理登记。 */
    effect?(callback: () => void, label?: string): void;
    readonly logger?: unknown;
}
/** 宿主目录选择命名空间的服务名（#736；出处与禁令见 cookbook §13）。 */
export declare const REMOTE_DIRECTORY_PICKER: "remote.directoryPicker";
/** 宿主目录选择命名空间（DSH 平台提供）：本包用它的 `pick`（系统对话框）与
 * `list`／`createDirectory`（应用内浏览那两格原语，由共用件的 `browseFaceOf` 拆信封）。不给 signal
 * （平台那格可选；描述符按「业务参数个数 ＋ 1」判有没有 signal，显式传 `undefined` 会炸）。
 *
 * **回执是信封，不是路径**（#743 真机缺陷的根因）：客户端把每次 Remote 调用包成
 * `{ok:true,value}`／`{ok:false,error}`（`@deepseek-ai/dsh-api-gateway/lib/client.js` 的 `invoke()`：
 * 失败不抛、成功也不回裸值），第一方消费方 `@deepseek-ai/dsh-client-ui-workspace/lib/client.js`
 * 的 `pickDirectory()` 就照这个形状拆：`const r = await pick(); if (!r.ok) throw …; return r.value`。
 * `value` 为 `null`＝用户取消；`ok:false`＝这条路供不了（例如组合里是 browse 后端）。 */
export interface DirectoryPickerAnswer {
    readonly ok: boolean;
    readonly value?: string | null;
    readonly error?: {
        readonly code?: string;
        readonly message?: string;
    };
}
/** 宿主「这条路没给」的回执码（#744）：一次组合里只服务一种能力（native 或 browse），
 * 另一条路上的动词一律回它。
 *
 * 出处：`@deepseek-ai/dsh-api-workspace-controller/lib/types/directory-picker.js` 的 `requireCapability()`
 * ——`RemoteError('directory-picker/unavailable', …)`。三条动词在客户端命名空间上都在，
 * 所以只有真调一次、看它拒没拒，才知道组合里服务哪种能力。
 * 共用件不认识这个名字（只照比对），于是这条宿主事实住在本镜像里。 */
export declare const DIRECTORY_PICKER_REFUSED: "directory-picker/unavailable";
export interface DirectoryPickerFace {
    pick(): Promise<DirectoryPickerAnswer>;
}
/** 总管那条电话通道的两个字面量（#744）：载体第一段与第二段。
 *
 * 出处：主管包 `packages/plugin-manager/src/update-contract.ts` 的 `MANAGER_RPC.base`／`.endpoint`
 * ——那边是一处定义，这边是镜像（本包不许 import 总管的宿主半：会把 node 内建带进浏览器束）。
 * 传错第一段就是 404：总管自己在 #678 栽过一次、各家的配置体检在 #735 又栽过一次。 */
export declare const MANAGER_RPC_BASE: "/api";
export declare const MANAGER_RPC_ENDPOINT: "ilife-manager";
/** 总管那通「本机根清单」电话名（#744）：入参 `{}`，回包 `{roots: [{path, kind}]}`。
 *
 * 出处：主管包 `update-contract.ts` 的 `MANAGER_ACTIONS.roots`。为什么要走总管：
 * 浏览器里没有卷清单接口，宿主那条目录选择接缝也只有 `list`／`createDirectory` 两格，
 * 「这台机器上有哪些盘」只能由宿主去问操作系统——那份实现在总管宿主半的 `roots.ts`。 */
export declare const MANAGER_ROOTS_METHOD: "ilife-manager.roots";
/** 模型工具面镜像（#734；出处见 cookbook §14）。
 *
 * 出处：`@deepseek-ai/dsh-tools/lib/index.js` 的 `defineTool` 与 `ToolRuntime.register`——
 * 工具对象的形状是 `name`／`description`／`parameters`（JSON Schema）／`output{schema,render}`／
 * `execute`；`register` 只校验 `output.render` 是函数、`output.schema` 受支持、`timeoutMs` 为正、
 * 名字不是保留名 `run_code`，**不要求 `defineTool` 产物** ⇒ 本包按形状手写、零依赖。 */
export interface ToolTextPart {
    readonly type: 'text';
    readonly text: string;
}
export interface ToolDefinitionMirror {
    readonly name: string;
    readonly description: string;
    readonly parameters: Record<string, unknown>;
    readonly output: {
        readonly schema: Record<string, unknown>;
        render(args: unknown, value: string): readonly ToolTextPart[];
    };
    execute(args: Record<string, unknown>, exec?: unknown): Promise<unknown>;
}
export interface ToolsFace {
    register(definition: ToolDefinitionMirror): () => void;
}
//# sourceMappingURL=dsh-ctx.d.ts.map