/** 注册结果(结构化——与 daemon registerDevice 的 RegisterResult 对齐) */ export interface DeviceRegisterResult { /** 首行必须 [sofagent] 前缀 */ text: string; /** 结构化数据 */ data: { ok: boolean; deviceId?: string; reason?: 'invalid-identity' | 'duplicate-device' | 'invalid-params' | 'daemon-unavailable'; message: string; }; } /** * 设备上线注册(G9)。 * * 延迟导入 @sofagent/daemon(optionalDependencies——与 daemon-status 同款)。 * * @param args 注册参数 * @param args.identity 设备身份码(AgentIdentity JSON——须含 publicKey + signature) * @param args.kind 设备类型(pc / node / appliance) * @param args.capabilities 能力标签清单 * @param args.tenant 租户(缺省 default) */ export declare function deviceRegister(args: { identity: Record; kind: string; capabilities?: string[]; tenant?: string; }): Promise; /** 设备侧订阅登记结果 */ export interface DeviceSubscriptionRegistrationResult { /** 三条订阅是否全部挂上 */ ok: boolean; /** 已登记的 topic 清单(取自 daemon 侧登记表——本包不复制事件类型表) */ topics: string[]; /** 退订句柄(逐个调用即解除订阅) */ unsubscribe: Array<() => void>; reason?: 'daemon-unavailable' | 'registry-unavailable' | 'invalid-params'; message: string; } /** 版本清单(升级成功后上报——与 daemon `VersionManifest` 结构对齐) */ interface UpgradeVersionManifest { deviceId: string; targetVersion: string; components: Record; outcome: string; at: string; order?: string[]; } /** G1 五件套导入器入参(与 daemon `DeployImporterPort` 对齐) */ interface DeployImportArgs { bundle: Record; imported_as?: string; actor?: string; data_dir?: string; } /** * 版本清单上报端口工厂(G11 通道——复用既有 `device_data_push`)。 * * 升级成功后由 daemon 执行器在成功分支末尾调用;上报走既有设备门禁 → * 采集声明校验 → 脱敏 → 加密入队链路。**不新建上报通道**。 * * ⚠️ 采集声明:`device_data_push` 的类别须在 * `/config/device-upload-policy.json` 声明(默认空=不上行,opt-in); * 未声明时上报被拒(fail-closed),本端口如实回传失败原因,不静默吞掉。 */ export declare function createVersionManifestPusher(identity: Record): (manifest: UpgradeVersionManifest) => Promise<{ ok: boolean; seq?: number; message?: string; }>; /** * G1 五件套导入器工厂(`device.deploy` 落盘注册用)。 * * 直接复用既有 `workflow_import`(结构闸 / 完整性核对 / schema 门 / 落地闸 * 四道 fail-closed 校验)——模板包格式与既有 G1 **完全一致,不另立格式**。 */ export declare function createG1DeployImporter(): (args: DeployImportArgs) => Promise<{ ok: boolean; importedAs?: string; code?: string; message: string; }>; /** * 设备侧订阅登记(第五章「设备侧订阅消费」入口)。 * * 设备注册成功后由设备进程调用:把 `device.upgrade` / `device.deploy` / * 任务下发三条订阅挂到设备本地事件总线(三者**共用同一推送底座**),并 * 注入两个 MCP 侧端口(G11 上报 / G1 导入器)。 * * @param args.bus 设备本地事件总线实例(第一章事件总线) * @param args.identity 设备身份码(AgentIdentity JSON) * @param args.dataDir 数据目录(测试隔离) */ export declare function registerDeviceSubscriptions(args: { bus: unknown; identity: Record; dataDir?: string; }): Promise; /** 领任务回执结果 */ export interface DeviceTaskReceiptResult { text: string; data: { ok: boolean; taskId?: string; receiptHash?: string; reason?: string; message: string; }; } /** * 领任务回执出口(第五章:领任务回执进审计链,HMAC 留痕)。 * * 复用 G9 `claimDeviceTask`(pending → claimed + 设备事件 HMAC 链留痕), * 返回 receiptHash 供调用方经 `verifyDeviceEventsChain` 回溯。 * * @param args.identity 设备身份码(过 G9 闸门) * @param args.taskId 指定领取的任务 ID(缺省领取最早入队的 pending 任务) * @param args.dataDir 数据目录(测试隔离) */ export declare function deviceTaskReceipt(args: { identity: Record; taskId?: string; dataDir?: string; }): Promise; export {}; //# sourceMappingURL=device-register.d.ts.map