dsh-global-supervisor 0.0.0-stage → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +52 -2
  3. package/README.zh-CN.md +55 -0
  4. package/client/client.js +168 -0
  5. package/client/src/factory-banner.txt +3 -0
  6. package/client/src/index.ts +153 -0
  7. package/cordis.patch.yml +8 -0
  8. package/dist/adapters/dsh-agent.d.ts +48 -0
  9. package/dist/adapters/dsh-agent.js +93 -0
  10. package/dist/adapters/dsh-agent.js.map +1 -0
  11. package/dist/adapters/dsh-im-notifier.d.ts +37 -0
  12. package/dist/adapters/dsh-im-notifier.js +48 -0
  13. package/dist/adapters/dsh-im-notifier.js.map +1 -0
  14. package/dist/adapters/dsh-llm-catalog.d.ts +26 -0
  15. package/dist/adapters/dsh-llm-catalog.js +41 -0
  16. package/dist/adapters/dsh-llm-catalog.js.map +1 -0
  17. package/dist/adapters/dsh-schedule.d.ts +51 -0
  18. package/dist/adapters/dsh-schedule.js +36 -0
  19. package/dist/adapters/dsh-schedule.js.map +1 -0
  20. package/dist/adapters/dsh-session.d.ts +40 -0
  21. package/dist/adapters/dsh-session.js +118 -0
  22. package/dist/adapters/dsh-session.js.map +1 -0
  23. package/dist/adapters/dsh-workspace.d.ts +29 -0
  24. package/dist/adapters/dsh-workspace.js +61 -0
  25. package/dist/adapters/dsh-workspace.js.map +1 -0
  26. package/dist/adapters/host-services.d.ts +13 -0
  27. package/dist/adapters/host-services.js +28 -0
  28. package/dist/adapters/host-services.js.map +1 -0
  29. package/dist/database/connection.d.ts +17 -0
  30. package/dist/database/connection.js +38 -0
  31. package/dist/database/connection.js.map +1 -0
  32. package/dist/database/migrations.d.ts +17 -0
  33. package/dist/database/migrations.js +239 -0
  34. package/dist/database/migrations.js.map +1 -0
  35. package/dist/database/repository/audit-repository.d.ts +29 -0
  36. package/dist/database/repository/audit-repository.js +21 -0
  37. package/dist/database/repository/audit-repository.js.map +1 -0
  38. package/dist/database/repository/event-repository.d.ts +34 -0
  39. package/dist/database/repository/event-repository.js +41 -0
  40. package/dist/database/repository/event-repository.js.map +1 -0
  41. package/dist/database/repository/event-routing-rule-repository.d.ts +37 -0
  42. package/dist/database/repository/event-routing-rule-repository.js +47 -0
  43. package/dist/database/repository/event-routing-rule-repository.js.map +1 -0
  44. package/dist/database/repository/plugin-setting-repository.d.ts +14 -0
  45. package/dist/database/repository/plugin-setting-repository.js +34 -0
  46. package/dist/database/repository/plugin-setting-repository.js.map +1 -0
  47. package/dist/database/repository/project-repository.d.ts +36 -0
  48. package/dist/database/repository/project-repository.js +83 -0
  49. package/dist/database/repository/project-repository.js.map +1 -0
  50. package/dist/database/repository/routing-rule-repository.d.ts +27 -0
  51. package/dist/database/repository/routing-rule-repository.js +57 -0
  52. package/dist/database/repository/routing-rule-repository.js.map +1 -0
  53. package/dist/database/repository/schedule-binding-repository.d.ts +33 -0
  54. package/dist/database/repository/schedule-binding-repository.js +36 -0
  55. package/dist/database/repository/schedule-binding-repository.js.map +1 -0
  56. package/dist/database/repository/task-repository.d.ts +47 -0
  57. package/dist/database/repository/task-repository.js +91 -0
  58. package/dist/database/repository/task-repository.js.map +1 -0
  59. package/dist/database/repository/task-run-repository.d.ts +23 -0
  60. package/dist/database/repository/task-run-repository.js +30 -0
  61. package/dist/database/repository/task-run-repository.js.map +1 -0
  62. package/dist/database/repository/thread-subscription-repository.d.ts +29 -0
  63. package/dist/database/repository/thread-subscription-repository.js +42 -0
  64. package/dist/database/repository/thread-subscription-repository.js.map +1 -0
  65. package/dist/database/repository/worker-report-repository.d.ts +38 -0
  66. package/dist/database/repository/worker-report-repository.js +32 -0
  67. package/dist/database/repository/worker-report-repository.js.map +1 -0
  68. package/dist/index.d.ts +88 -0
  69. package/dist/index.js +211 -0
  70. package/dist/index.js.map +1 -0
  71. package/dist/probe.d.ts +20 -0
  72. package/dist/probe.js +213 -0
  73. package/dist/probe.js.map +1 -0
  74. package/dist/protocols/schedule-timing.d.ts +34 -0
  75. package/dist/protocols/schedule-timing.js +165 -0
  76. package/dist/protocols/schedule-timing.js.map +1 -0
  77. package/dist/protocols/worker-report.d.ts +28 -0
  78. package/dist/protocols/worker-report.js +87 -0
  79. package/dist/protocols/worker-report.js.map +1 -0
  80. package/dist/runtime.d.ts +42 -0
  81. package/dist/runtime.js +92 -0
  82. package/dist/runtime.js.map +1 -0
  83. package/dist/services/agent-controller.d.ts +61 -0
  84. package/dist/services/agent-controller.js +146 -0
  85. package/dist/services/agent-controller.js.map +1 -0
  86. package/dist/services/event-batcher.d.ts +43 -0
  87. package/dist/services/event-batcher.js +98 -0
  88. package/dist/services/event-batcher.js.map +1 -0
  89. package/dist/services/event-manager.d.ts +52 -0
  90. package/dist/services/event-manager.js +64 -0
  91. package/dist/services/event-manager.js.map +1 -0
  92. package/dist/services/event-router.d.ts +60 -0
  93. package/dist/services/event-router.js +201 -0
  94. package/dist/services/event-router.js.map +1 -0
  95. package/dist/services/model-queue.d.ts +42 -0
  96. package/dist/services/model-queue.js +54 -0
  97. package/dist/services/model-queue.js.map +1 -0
  98. package/dist/services/notifier.d.ts +53 -0
  99. package/dist/services/notifier.js +99 -0
  100. package/dist/services/notifier.js.map +1 -0
  101. package/dist/services/project-monitor.d.ts +65 -0
  102. package/dist/services/project-monitor.js +125 -0
  103. package/dist/services/project-monitor.js.map +1 -0
  104. package/dist/services/router-identity.d.ts +60 -0
  105. package/dist/services/router-identity.js +93 -0
  106. package/dist/services/router-identity.js.map +1 -0
  107. package/dist/services/scheduler.d.ts +55 -0
  108. package/dist/services/scheduler.js +87 -0
  109. package/dist/services/scheduler.js.map +1 -0
  110. package/dist/services/settings-api.d.ts +40 -0
  111. package/dist/services/settings-api.js +212 -0
  112. package/dist/services/settings-api.js.map +1 -0
  113. package/dist/services/task-manager.d.ts +88 -0
  114. package/dist/services/task-manager.js +304 -0
  115. package/dist/services/task-manager.js.map +1 -0
  116. package/dist/services/task-state-machine.d.ts +17 -0
  117. package/dist/services/task-state-machine.js +37 -0
  118. package/dist/services/task-state-machine.js.map +1 -0
  119. package/dist/services/workspace-manager.d.ts +81 -0
  120. package/dist/services/workspace-manager.js +147 -0
  121. package/dist/services/workspace-manager.js.map +1 -0
  122. package/dist/tools/supervisor-tools.d.ts +9 -0
  123. package/dist/tools/supervisor-tools.js +644 -0
  124. package/dist/tools/supervisor-tools.js.map +1 -0
  125. package/dist/tools/toolkit.d.ts +40 -0
  126. package/dist/tools/toolkit.js +45 -0
  127. package/dist/tools/toolkit.js.map +1 -0
  128. package/dist/tools/worker-report-tool.d.ts +9 -0
  129. package/dist/tools/worker-report-tool.js +59 -0
  130. package/dist/tools/worker-report-tool.js.map +1 -0
  131. package/dist/types/index.d.ts +128 -0
  132. package/dist/types/index.js +6 -0
  133. package/dist/types/index.js.map +1 -0
  134. package/dist/utils/id.d.ts +4 -0
  135. package/dist/utils/id.js +8 -0
  136. package/dist/utils/id.js.map +1 -0
  137. package/docs/API_COMPATIBILITY.md +109 -0
  138. package/docs/ARCHITECTURE.md +28 -0
  139. package/docs/ASSESSMENT_SWOT.md +151 -0
  140. package/docs/DATABASE.md +28 -0
  141. package/docs/DEPLOYMENT.md +63 -0
  142. package/docs/DEVELOPMENT_PLAN.md +628 -0
  143. package/docs/INTEGRATIONS.md +88 -0
  144. package/docs/ITERATION_PLAN.md +953 -0
  145. package/docs/SUPER_AGENT_GAP_ANALYSIS.md +440 -0
  146. package/docs/TASK_STATE_MACHINE.md +26 -0
  147. package/docs/TEST_PLAN.md +53 -0
  148. package/docs/TROUBLESHOOTING.md +43 -0
  149. package/docs/UI_PANEL_PLAN.md +83 -0
  150. package/docs/USER_GUIDE.md +213 -0
  151. package/package.json +72 -4
package/dist/index.js ADDED
@@ -0,0 +1,211 @@
1
+ import z from '@deepseek-ai/schemastery';
2
+ /** 最近的 probe_echo 调用捕获(V1 复核证据;纯内存态)。 */
3
+ let lastToolInvocation;
4
+ /** 记录一次 probe_echo 调用(由工具 execute 回调写入)。 */
5
+ function captureToolInvocation(agentId, args) {
6
+ lastToolInvocation = { agentId: agentId ?? '(exec.agent 缺失)', args, at: new Date().toISOString() };
7
+ }
8
+ /** 插件配置 schema(schemastery,DSH 插件惯例)。 */
9
+ export const Config = z.object({
10
+ probe: z.boolean().default(false).description('开发期 API 探针:启动时运行兼容性自检,报告写入数据目录'),
11
+ dataDir: z.string().default('').description('插件数据目录(默认经 dsh-home-paths 解析为 ~/.dsh/global-supervisor)'),
12
+ routerWorkspaceId: z.string().default('').description('Router 所属 DSH workspace ID(super-space01)'),
13
+ routerSessionId: z.string().default('').description('Router 固定会话 ID(supervisor_* 工具的唯一授权调用方;留空则不启用业务工具)'),
14
+ events: z.object({
15
+ webhookSources: z.array(z.string()).default([]).description('允许的 Webhook 事件来源标识白名单;空数组表示不限制'),
16
+ maxEventTextChars: z.number().default(4000).description('Webhook 事件正文截断上限(字符)'),
17
+ redactPatterns: z.boolean().default(true).description('是否启用事件正文凭证脱敏(ghp_/PEM/Bearer/api key)'),
18
+ }).default({ webhookSources: [], maxEventTextChars: 4000, redactPatterns: true }).description('事件接入配置'),
19
+ notifier: z.object({
20
+ type: z.string().default('session').description('通知通道:session(仅 Router 会话)| dsh-im(优先 IM,失败降级会话)'),
21
+ botId: z.string().default('').description('dsh-im 机器人 ID(dsh-im 设置页「复制调用参数」)'),
22
+ targetId: z.string().default('supervisor-alerts').description('dsh-im 投递目标 ID(需已在 dsh-im 中保存)'),
23
+ }).default({ type: 'session', botId: '', targetId: 'supervisor-alerts' }).description('通知路由配置'),
24
+ });
25
+ /** Cordis 插件名(profile bundles / patch 的定位标识)。 */
26
+ export const name = 'global-supervisor';
27
+ /** probe_echo:探针工具(仅开发期),用于捕获工具执行上下文中的调用者身份(V1 复核)。 */
28
+ const probeEchoTool = {
29
+ name: 'probe_echo',
30
+ description: '开发期探针工具:原样返回输入并记录调用者身份。无业务副作用。',
31
+ parameters: { type: 'object', properties: { echo: { type: 'string', description: '任意回显文本' } } },
32
+ output: {
33
+ schema: { type: 'object', properties: { echoed: { type: 'string' }, byAgent: { type: 'string' } } },
34
+ render: (_args, value) => {
35
+ const record = value;
36
+ return [{ type: 'text', text: `echoed=${record['echoed'] ?? ''} byAgent=${record['byAgent'] ?? ''}` }];
37
+ },
38
+ },
39
+ async execute(args, exec) {
40
+ const input = args;
41
+ captureToolInvocation(exec.agent?.id, args);
42
+ return { echoed: input['echo'] ?? '', byAgent: exec.agent?.id ?? '(missing)' };
43
+ },
44
+ };
45
+ /**
46
+ * 启动标记:把插件启动痕迹直接写入文件系统(绕过可能不可见的 ctx.logger),
47
+ * 用于区分"插件未进加载树"与"加载后内部失败"两类问题。
48
+ */
49
+ async function writeLoadMarker(stage, detail) {
50
+ try {
51
+ const fs = await import('node:fs/promises');
52
+ const os = await import('node:os');
53
+ const path = await import('node:path');
54
+ const file = path.join(os.homedir(), '.dsh', 'global-supervisor-load.log');
55
+ await fs.mkdir(path.dirname(file), { recursive: true });
56
+ await fs.appendFile(file, `${new Date().toISOString()} [${stage}] ${JSON.stringify(detail)}\n`, 'utf8');
57
+ }
58
+ catch {
59
+ // 文件系统不可用时无通道可写——保持静默,由探针报告缺失间接暴露
60
+ }
61
+ }
62
+ /**
63
+ * 插件应用入口。
64
+ * @param ctx - Cordis 上下文(宿主为 DSH Desktop 0.2.2-rc.x Host 进程)
65
+ * @param config - 已验证配置
66
+ */
67
+ export function apply(ctx, config) {
68
+ void writeLoadMarker('apply-enter', { probe: config.probe, dataDir: config.dataDir });
69
+ ctx.logger.info(`dsh-global-supervisor 加载(probe=${String(config.probe)})`);
70
+ // 探针工具注册:开发期验证工具执行上下文(V1);经 ctx.get 绕开沙箱属性门禁
71
+ if (config.probe) {
72
+ try {
73
+ const tools = ctx.get('tools');
74
+ tools?.register(probeEchoTool);
75
+ void writeLoadMarker('probe-echo-registered', {});
76
+ }
77
+ catch (error) {
78
+ void writeLoadMarker('probe-echo-failed', { message: error instanceof Error ? error.message : String(error) });
79
+ }
80
+ }
81
+ // 启动探针(probe 模式;动态加载 probe 模块,保持本模块顶层零 node:* 依赖)
82
+ if (config.probe) {
83
+ void (async () => {
84
+ try {
85
+ const { runProbe } = await import('./probe.js');
86
+ const report = await runProbe(ctx, config.dataDir);
87
+ const verified = report.checks.filter((c) => c.status === 'VERIFIED').length;
88
+ const failed = report.checks.filter((c) => c.status !== 'VERIFIED');
89
+ void writeLoadMarker('probe-done', { verified, total: report.checks.length, dataDir: report.dataDir });
90
+ ctx.logger.info(`API 探针完成:${verified}/${report.checks.length} 项 VERIFIED,报告已写入 ${report.dataDir}`);
91
+ for (const item of failed) {
92
+ ctx.logger.warn(` [${item.status}] ${item.id}:${item.detail}`);
93
+ }
94
+ }
95
+ catch (error) {
96
+ void writeLoadMarker('probe-crashed', { message: error instanceof Error ? error.stack ?? error.message : String(error) });
97
+ ctx.logger.error(`API 探针运行失败:${error instanceof Error ? error.stack ?? error.message : String(error)}`);
98
+ }
99
+ })();
100
+ }
101
+ else {
102
+ void writeLoadMarker('probe-disabled', { note: 'config.probe=false——若期望探针运行,请检查 patch 配置' });
103
+ }
104
+ // 业务模式:Router 身份可经 patch 预置或运行时认领(supervisor_claim_router),
105
+ // 均非必需——无预置时栈照常启动,等待任意会话首次认领
106
+ {
107
+ void (async () => {
108
+ try {
109
+ const { awaitService } = await import('./adapters/host-services.js');
110
+ const tools = await awaitService(ctx, 'tools');
111
+ const { createStack } = await import('./runtime.js');
112
+ const stack = await createStack(ctx, { dataDir: config.dataDir, routerSessionId: config.routerSessionId, notifier: config.notifier });
113
+ // Host 重启存疑恢复(需求说明第八节):超时窗口已过判 failed/timeout,未过保持 running 待 Worker 汇报
114
+ const recovery = stack.taskManager.recoverFromRestart();
115
+ if (recovery.expiredIds.length > 0 || recovery.pendingIds.length > 0) {
116
+ void writeLoadMarker('restart-recovery', recovery);
117
+ ctx.logger.info(`重启恢复:${recovery.pendingIds.length} 个任务存疑待汇报,${recovery.expiredIds.length} 个已判超时`);
118
+ }
119
+ stack.monitor.start();
120
+ // Schedule 对账(第八节:Host 任务与本地绑定双向核对;远端消失的绑定停用)
121
+ const scheduleReconcile = await stack.scheduler.reconcile();
122
+ if (scheduleReconcile.remoteMissing.length > 0) {
123
+ void writeLoadMarker('schedule-reconcile', scheduleReconcile);
124
+ }
125
+ // 事件源接入(§6.4 + ITERATION_PLAN 1-C;事件名经 0.2.2-rc.1 类型基线核实):
126
+ // agent/error / agent/status / agent/inbox/inserted(dsh-agent)、
127
+ // tools/result(dsh-tools)、session/event 过滤 turn/end(dsh-session)
128
+ ctx.on('agent/error', (payload) => {
129
+ void stack.eventManager.ingest({
130
+ eventId: `agent-error:${payload.agent.id}:${Date.now()}`,
131
+ source: 'agent',
132
+ type: 'agent.error',
133
+ workspaceId: undefined,
134
+ payloadJson: JSON.stringify({ message: payload.error instanceof Error ? payload.error.message : String(payload.error) }),
135
+ });
136
+ });
137
+ ctx.on('agent/status', (payload) => {
138
+ if (!payload.agent?.id || !payload.status)
139
+ return;
140
+ void stack.eventManager.ingest({
141
+ eventId: `agent-status:${payload.agent.id}:${payload.status}:${Date.now()}`,
142
+ source: 'agent',
143
+ type: 'agent.status',
144
+ payloadJson: JSON.stringify({ agentId: payload.agent.id, status: payload.status }),
145
+ });
146
+ });
147
+ ctx.on('agent/inbox/inserted', (payload) => {
148
+ void stack.eventManager.ingest({
149
+ eventId: `user-msg:${payload.agent.id}:${payload.message.id}`,
150
+ source: 'agent',
151
+ type: 'user.message',
152
+ payloadJson: JSON.stringify({ agentId: payload.agent.id, content: payload.message.content }),
153
+ human: payload.message.source?.kind === 'user',
154
+ });
155
+ });
156
+ ctx.on('tools/result', (exec) => {
157
+ const agentId = exec.agent?.id;
158
+ if (agentId) {
159
+ void stack.eventManager.ingest({
160
+ eventId: `tool-result:${agentId}:${exec.name}:${Date.now()}`,
161
+ source: 'agent',
162
+ type: 'tool.result',
163
+ payloadJson: JSON.stringify({ toolName: exec.name, agentId }),
164
+ });
165
+ }
166
+ return undefined;
167
+ });
168
+ ctx.on('session/event', (session, event) => {
169
+ if (event.type !== 'turn/end')
170
+ return;
171
+ void stack.eventManager.ingest({
172
+ eventId: `turn-end:${session.id}:${String(event.seq)}`,
173
+ source: 'agent',
174
+ type: 'turn.end',
175
+ payloadJson: JSON.stringify({ sessionId: session.id, turn: event.data.turn, reason: event.data.reason }),
176
+ });
177
+ });
178
+ // EventManager 派发规则:Worker turn 结束 → 刷新对应 running 任务心跳(Watchdog 数据源)
179
+ stack.eventManager.on('turn.end', async (event) => {
180
+ const payload = JSON.parse(event.payload_json);
181
+ if (!payload.sessionId)
182
+ return;
183
+ for (const task of stack.taskManager.tasks.list({ status: 'running' })) {
184
+ if (task.assigned_session_id === payload.sessionId)
185
+ stack.taskManager.tasks.touchReport(task.id);
186
+ }
187
+ });
188
+ // Phase 2 事件路由决策层('*' 全量通配;route 内部永不抛错,派发失败降级 pending 记审计)
189
+ stack.eventManager.on('*', (event) => {
190
+ void stack.eventRouter.route(event);
191
+ });
192
+ // 设置面板 HTTP API(Router 身份管理入口;契约见 docs/UI_PANEL_PLAN.md)
193
+ const { registerSettingsApi } = await import('./services/settings-api.js');
194
+ await registerSettingsApi(ctx, stack, config.events);
195
+ const { buildSupervisorTools } = await import('./tools/supervisor-tools.js');
196
+ const { buildWorkerReportTool } = await import('./tools/worker-report-tool.js');
197
+ const all = [...buildSupervisorTools(stack), buildWorkerReportTool(stack)];
198
+ for (const tool of all) {
199
+ tools.register(tool);
200
+ }
201
+ void writeLoadMarker('stack-ready', { tools: all.length, dataDir: stack.dataDir, router: config.routerSessionId });
202
+ ctx.logger.info(`dsh-global-supervisor 服务栈就绪:${all.length} 个工具已注册`);
203
+ }
204
+ catch (error) {
205
+ void writeLoadMarker('stack-failed', { message: error instanceof Error ? error.stack ?? error.message : String(error) });
206
+ ctx.logger.error(`服务栈初始化失败:${error instanceof Error ? error.stack ?? error.message : String(error)}`);
207
+ }
208
+ })();
209
+ }
210
+ }
211
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * S1 API 探针:在真实 DSH Host 进程内验证本插件依赖的全部能力。
3
+ *
4
+ * 设计原则(见 docs/DEVELOPMENT_PLAN.md §10):
5
+ * - 每项检查独立 try/catch,单项失败不阻断整体;
6
+ * - 结果四态:VERIFIED / UNAVAILABLE / UNSTABLE / SKIPPED;
7
+ * - 报告 JSON 落盘到插件数据目录,供 docs/API_COMPATIBILITY.md 汇总;
8
+ * - 探针只读探测,不创建 Workspace / Session / Schedule 等业务对象。
9
+ * - 模块顶层零 node:* 静态依赖(宿主插件环境可能限制 Node 内建模块的解析,
10
+ * 全部内建改为使用点动态 import,保证本模块本身可被任何环境加载)。
11
+ */
12
+ import type { Context } from '@deepseek-ai/cordis';
13
+ import type { ProbeReport } from './types/index.js';
14
+ /**
15
+ * 运行完整探针并落盘报告。
16
+ * @param ctx - Cordis 插件上下文(真实 Host 进程内)
17
+ * @param configuredDir - 配置指定的数据目录(可空)
18
+ * @returns 完整报告对象
19
+ */
20
+ export declare function runProbe(ctx: Context, configuredDir?: string): Promise<ProbeReport>;
package/dist/probe.js ADDED
@@ -0,0 +1,213 @@
1
+ /** 插件版本(与 package.json 同步维护)。 */
2
+ const PLUGIN_VERSION = '0.5.2';
3
+ /** 单项检查的安全包装:任何抛错都转为 UNAVAILABLE 记录,不中断整体。 */
4
+ async function check(id, name, body) {
5
+ const startedAt = Date.now();
6
+ try {
7
+ const detail = await body();
8
+ return { id, name, status: 'VERIFIED', detail, durationMs: Date.now() - startedAt };
9
+ }
10
+ catch (error) {
11
+ const detail = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
12
+ return { id, name, status: 'UNAVAILABLE', detail, durationMs: Date.now() - startedAt };
13
+ }
14
+ }
15
+ /** 截断任意值的安全 JSON 摘要(探针证据有长度纪律)。 */
16
+ function brief(value, maxChars = 300) {
17
+ let text;
18
+ try {
19
+ text = JSON.stringify(value);
20
+ }
21
+ catch {
22
+ text = String(value);
23
+ }
24
+ if (text === undefined)
25
+ text = String(value);
26
+ return text.length > maxChars ? `${text.slice(0, maxChars)}…(截断)` : text;
27
+ }
28
+ /** 等待式服务解析:宿主服务链异步初始化(如 schedule 依赖 sessionPersistence),
29
+ * apply 时刻可能未就绪——轮询 ctx.get 直到出现或超时。 */
30
+ async function awaitService(ctx, name, retries = 40, intervalMs = 200) {
31
+ for (let i = 0; i < retries; i++) {
32
+ try {
33
+ const service = ctx.get(name);
34
+ if (service !== undefined && service !== null)
35
+ return service;
36
+ }
37
+ catch {
38
+ // 门禁抛错时同样等待重试(apply 早期 façade 可能尚未就绪)
39
+ }
40
+ await new Promise((resolve) => setTimeout(resolve, intervalMs));
41
+ }
42
+ return undefined;
43
+ }
44
+ /** 解析插件数据目录:优先 dsh-home-paths(V6),失败降级 ~/.dsh。 */
45
+ async function resolveDataDir(configured) {
46
+ if (configured && configured.trim() !== '') {
47
+ return { dir: configured, basis: '显式配置' };
48
+ }
49
+ try {
50
+ const mod = await import('@deepseek-ai/dsh-home-paths');
51
+ const dir = mod.dshHomePath('global-supervisor');
52
+ return { dir, basis: `dsh-home-paths(home=${mod.resolveDshHome()})` };
53
+ }
54
+ catch (error) {
55
+ const { homedir } = await import('node:os');
56
+ const { join } = await import('node:path');
57
+ const fallback = join(homedir(), '.dsh', 'global-supervisor');
58
+ const reason = error instanceof Error ? error.message : String(error);
59
+ return { dir: fallback, basis: `降级 ~/.dsh(dsh-home-paths 不可用:${reason})` };
60
+ }
61
+ }
62
+ /**
63
+ * 运行完整探针并落盘报告。
64
+ * @param ctx - Cordis 插件上下文(真实 Host 进程内)
65
+ * @param configuredDir - 配置指定的数据目录(可空)
66
+ * @returns 完整报告对象
67
+ */
68
+ export async function runProbe(ctx, configuredDir) {
69
+ const data = await resolveDataDir(configuredDir);
70
+ const checks = [];
71
+ // --- 环境 ---
72
+ checks.push(await check('env.node-version', '宿主 Node 版本(要求 >=22.19)', async () => {
73
+ const v = process.version;
74
+ const major = Number(v.slice(1).split('.')[0] ?? 0);
75
+ if (major < 22)
76
+ throw new Error(`Node 版本过低:${v}`);
77
+ return v;
78
+ }));
79
+ checks.push(await check('env.data-dir', '插件数据目录解析(V6)', async () => {
80
+ const { mkdir } = await import('node:fs/promises');
81
+ await mkdir(data.dir, { recursive: true });
82
+ return `${data.dir}(依据:${data.basis})`;
83
+ }));
84
+ // --- SQLite(V3)---
85
+ checks.push(await check('sqlite.node-sqlite', 'node:sqlite 可用性(V3:建表/插入/查询/事务)', async () => {
86
+ const { DatabaseSync } = await import('node:sqlite');
87
+ const db = new DatabaseSync(':memory:');
88
+ db.exec('CREATE TABLE probe(id INTEGER PRIMARY KEY, v TEXT)');
89
+ db.prepare('INSERT INTO probe(v) VALUES(?)').run('ok');
90
+ const row = db.prepare('SELECT * FROM probe WHERE id = ?').get(1);
91
+ db.close();
92
+ if (row['v'] !== 'ok')
93
+ throw new Error(`读写不一致:${brief(row)}`);
94
+ return 'DatabaseSync/StatementSync 正常,参数绑定与查询返回符合预期';
95
+ }));
96
+ // --- 服务存在性与实际调用 ---
97
+ // 宿主沙箱门禁:属性访问需要 inject 声明,ctx.get() 按需解析(官方插件模式);
98
+ // 服务链异步初始化,统一经 awaitService 等待就绪。
99
+ checks.push(await check('service.workspace-registry', 'ctx.workspaceRegistry 存在且 list() 可调用', async () => {
100
+ const reg = (await awaitService(ctx, 'workspaceRegistry'));
101
+ if (!reg)
102
+ throw new Error('ctx.workspaceRegistry 未就绪(等待 8s 后仍不可见)');
103
+ const list = reg.list();
104
+ const first = list[0];
105
+ return `list() 返回 ${list.length} 个 workspace;方法集:${['create', 'get', 'list', 'delete', 'resolveByPath'].filter((m) => typeof reg[m] === 'function').join('/')};示例:${first ? `${first.id} → ${first.path}` : '(空)'}`;
106
+ }));
107
+ checks.push(await check('service.agents', 'ctx.agents 存在及关键方法签名(create/resume/get/list)', async () => {
108
+ const agents = (await awaitService(ctx, 'agents'));
109
+ if (!agents)
110
+ throw new Error('ctx.agents 未就绪');
111
+ const missing = ['create', 'resume', 'get', 'list'].filter((m) => typeof agents[m] !== 'function');
112
+ if (missing.length > 0)
113
+ throw new Error(`缺少方法:${missing.join('/')}`);
114
+ const live = agents.list();
115
+ return `方法齐全;当前活动 Agent ${live.length} 个${live[0] ? `,示例 id=${live[0].id} status=${live[0].status}` : ''}`;
116
+ }));
117
+ checks.push(await check('service.schedule', 'ctx.schedule(Host-wide)存在且 catalog() 可调用', async () => {
118
+ const schedule = (await awaitService(ctx, 'schedule'));
119
+ if (!schedule)
120
+ throw new Error('ctx.schedule 未就绪(等待 8s 后仍不可见——旧版 DSH 无 Host-wide Schedule)');
121
+ const catalog = await schedule.catalog();
122
+ return `catalog() 返回 ${catalog.length} 个任务;方法集:${['create', 'list', 'catalog', 'view', 'history', 'edit', 'run', 'deleteInactive'].filter((m) => typeof schedule[m] === 'function').join('/')}`;
123
+ }));
124
+ checks.push(await check('service.session-persistence', 'ctx.sessionPersistence 存在及快照查询', async () => {
125
+ const sp = (await awaitService(ctx, 'sessionPersistence'));
126
+ if (!sp)
127
+ throw new Error('ctx.sessionPersistence 未就绪');
128
+ const missing = ['create', 'open', 'stat', 'list'].filter((m) => typeof sp[m] !== 'function');
129
+ if (missing.length > 0)
130
+ throw new Error(`缺少方法:${missing.join('/')}`);
131
+ const snapshots = await sp.list();
132
+ return `list() 返回 ${snapshots.length} 个会话快照${snapshots[0] ? `;示例字段:${Object.keys(snapshots[0]).join('/')}` : ''}`;
133
+ }));
134
+ checks.push(await check('service.tools', 'ctx.tools 存在且 register 可用', async () => {
135
+ const tools = (await awaitService(ctx, 'tools'));
136
+ if (!tools)
137
+ throw new Error('ctx.tools 未就绪');
138
+ if (typeof tools.register !== 'function')
139
+ throw new Error('ctx.tools.register 不是函数');
140
+ return 'register(definition, options?) 签名存在';
141
+ }));
142
+ checks.push(await check('service.dsh-im', 'ctx.dshIm 存在且 listBots() 可调用(Phase 4 主动投递)', async () => {
143
+ const im = (await awaitService(ctx, 'dshIm', 5, 200));
144
+ if (!im)
145
+ throw new Error('ctx.dshIm 未就绪(dsh-im 未安装或服务不可达)');
146
+ if (typeof im.listBots !== 'function')
147
+ throw new Error('ctx.dshIm.listBots 不是函数');
148
+ const raw = im.listBots();
149
+ const bots = Array.isArray(raw) ? raw : [];
150
+ return `listBots() 返回 ${bots.length} 个 bot${bots[0] ? `;示例 id=${bots[0]}` : ''}(返回形态:${Array.isArray(raw) ? 'array' : typeof raw});send=${typeof im.send === 'function' ? '存在' : '缺失'}`;
151
+ }));
152
+ checks.push(await check('service.llm-catalog', 'ctx.llm 存在且目录可枚举(Phase 6 模型校验)', async () => {
153
+ const llm = (await awaitService(ctx, 'llm', 5, 200));
154
+ if (!llm)
155
+ throw new Error('ctx.llm 未就绪');
156
+ if (typeof llm.listProviders !== 'function')
157
+ throw new Error('ctx.llm.listProviders 不是函数');
158
+ const providers = llm.listProviders();
159
+ if (!Array.isArray(providers))
160
+ throw new Error(`listProviders() 返回非数组:${typeof providers}`);
161
+ let modelCount = -1;
162
+ if (providers[0] !== undefined && typeof llm.listModels === 'function') {
163
+ const models = (await llm.listModels(providers[0].id));
164
+ modelCount = Array.isArray(models) ? models.length : -1;
165
+ }
166
+ return `listProviders() 返回 ${providers.length} 个 provider${providers[0] ? `;示例 ${providers[0].id}` : ''}${modelCount >= 0 ? `;首 provider 模型 ${modelCount} 个` : ''}`;
167
+ }));
168
+ checks.push(await check('api.agent-model-select', 'Agent.model.select 存在性(Phase 6 模型切换;机会性——无 live Agent 则 SKIPPED)', async () => {
169
+ const agents = (await awaitService(ctx, 'agents'));
170
+ const live = agents?.list?.() ?? [];
171
+ const first = live[0];
172
+ if (!first)
173
+ return 'SKIPPED:当前无 live Agent(首次真实派发/切换时复核)';
174
+ if (typeof first.model?.select !== 'function')
175
+ throw new Error('live Agent.model.select 不是函数');
176
+ return `live Agent ${live.length} 个;model.select 为函数(未调用——探针只读)`;
177
+ }));
178
+ // --- 关键 API 形态 ---
179
+ checks.push(await check('api.user-message-factory', 'createUserMessage 构造(V2:任务指令消息)', async () => {
180
+ const mod = await import('@deepseek-ai/dsh-llm');
181
+ if (typeof mod.createUserMessage !== 'function')
182
+ throw new Error('@deepseek-ai/dsh-llm 未导出 createUserMessage');
183
+ const msg = mod.createUserMessage({
184
+ content: [{ type: 'text', text: 'probe' }],
185
+ source: { kind: 'user' },
186
+ });
187
+ return `构造成功:id=${String(msg.id)} role=${msg.role} content 块数=${msg.content.length}`;
188
+ }));
189
+ // --- 工具执行上下文(V1:注册探针工具,由任意会话调用后捕获 exec.agent)---
190
+ checks.push(await check('api.tool-exec-context', '工具执行上下文可获调用者(V1:probe_echo 工具)', async () => {
191
+ // 本检查只确认工具注册通道;exec.agent 的实际捕获依赖模型调用 probe_echo,
192
+ // 结果在会话触发后由 captureToolInvocation 补充记录。
193
+ const tools = ctx.get('tools');
194
+ if (!tools || typeof tools.register !== 'function')
195
+ throw new Error('工具注册不可用');
196
+ return 'probe_echo 已注册(SKIPPED→VERIFIED 待任意会话调用一次后复核)';
197
+ }));
198
+ const report = {
199
+ ranAt: new Date().toISOString(),
200
+ nodeVersion: process.version,
201
+ pluginVersion: PLUGIN_VERSION,
202
+ dataDir: data.dir,
203
+ checks,
204
+ };
205
+ // 落盘报告(探针自身的持久化验证)
206
+ const { mkdir, writeFile } = await import('node:fs/promises');
207
+ const { join } = await import('node:path');
208
+ const reportPath = join(data.dir, 'probe-report.json');
209
+ await mkdir(data.dir, { recursive: true });
210
+ await writeFile(reportPath, `${JSON.stringify(report, null, 2)}\n`, 'utf8');
211
+ return report;
212
+ }
213
+ //# sourceMappingURL=probe.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"probe.js","sourceRoot":"","sources":["../src/probe.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,34 @@
1
+ /**
2
+ * 调度规则归一化:把模型产出的"友好形态" JSON 映射为 DSH Host-wide Schedule 的真实契约。
3
+ *
4
+ * 真实契约(dsh-schedule 0.2.2,ScheduleTiming):
5
+ * after { kind:'after', after_seconds }
6
+ * at { kind:'at', at: string | { date, time, time_zone } }
7
+ * every { kind:'every', every_seconds }
8
+ * daily { kind:'daily', daily: { time:'HH:mm:ss', time_zone } }
9
+ * weekly { kind:'weekly', weekly: { time:'HH:mm:ss', time_zone, weekdays:number[] } }
10
+ * cron { kind:'cron', cron: { expression, time_zone } }
11
+ * rrule { kind:'rrule', rrule: string }
12
+ *
13
+ * 模型通常给出 { kind:'daily', time:'09:00' } 这类扁平形态——直接透传会让 Host 拒绝建单,
14
+ * 故此处做归一化(真实形态亦被接受)。
15
+ */
16
+ import type { ScheduleCreateRequest } from '@deepseek-ai/dsh-schedule';
17
+ type Timing = ScheduleCreateRequest['timing'];
18
+ /** 调度参数不可用(机器可读错误)。 */
19
+ export declare class ScheduleTimingError extends Error {
20
+ constructor(message: string);
21
+ }
22
+ /** 默认时区:宿主本地时区(IANA 名)。 */
23
+ export declare function defaultTimeZone(): string;
24
+ /** 归一化本地时钟为 HH:mm:ss(容忍 H:mm 与缺秒)。 */
25
+ export declare function normalizeClock(input: string): string;
26
+ /** 归一化星期集合(1-7 或英文名)。 */
27
+ export declare function normalizeWeekdays(input: unknown): number[];
28
+ /**
29
+ * 归一化调度参数。
30
+ * @param input - 模型给出的友好形态或真实契约形态
31
+ * @returns 真实 ScheduleTiming
32
+ */
33
+ export declare function normalizeScheduleTiming(input: unknown): Timing;
34
+ export {};