@mogragsigma/dsh-dual-host-plugin 0.0.0-stage → 0.33.1

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 (264) hide show
  1. package/ASSET_NOTICE.md +19 -0
  2. package/LICENSE +58 -0
  3. package/LICENSE.en.md +94 -0
  4. package/README.md +74 -2
  5. package/THIRD_PARTY_NOTICES.md +94 -0
  6. package/a2a-dispatches.js +38 -0
  7. package/a2a-endpoint.js +112 -0
  8. package/a2a-tools.js +11 -0
  9. package/a2a-worker.js +63 -0
  10. package/approval-auth.js +5 -0
  11. package/approval-chat.js +150 -0
  12. package/approval-feishu.js +52 -0
  13. package/approval-guidance.js +68 -0
  14. package/approval-http.js +8 -0
  15. package/approval-ledger.js +142 -0
  16. package/approval-local-relay.js +86 -0
  17. package/approval-receipts.js +62 -0
  18. package/approval-reference.js +33 -0
  19. package/approval-semantic-model.js +26 -0
  20. package/approval-semantics.js +51 -0
  21. package/approval-ui/app.js +1 -0
  22. package/approval-ui/index.html +1 -0
  23. package/approval-ui/style.css +1 -0
  24. package/approval-workbench.js +45 -0
  25. package/artifact-media.js +34 -0
  26. package/bounded-text.js +44 -0
  27. package/compatibility.json +980 -0
  28. package/cordis.patch.yml +5 -0
  29. package/delivery-approval.js +133 -0
  30. package/delivery-artifacts.js +52 -0
  31. package/delivery-commit.js +125 -0
  32. package/delivery-contract.js +42 -0
  33. package/delivery-git-read.js +217 -0
  34. package/delivery-index.js +23 -0
  35. package/delivery-journal.js +207 -0
  36. package/delivery-object-plan.js +138 -0
  37. package/delivery-preview.js +153 -0
  38. package/delivery-process-receipts.js +90 -0
  39. package/delivery-process.js +46 -0
  40. package/delivery-process.py +228 -0
  41. package/delivery-push-approval.js +89 -0
  42. package/delivery-push-plan.js +98 -0
  43. package/delivery-push-recovery.js +32 -0
  44. package/delivery-push.js +83 -0
  45. package/delivery-recovery.js +143 -0
  46. package/delivery-runtime.js +182 -0
  47. package/delivery-ssh.js +64 -0
  48. package/delivery-state.js +106 -0
  49. package/development-attention.js +35 -0
  50. package/development-bridge.js +136 -0
  51. package/development-command-review.js +110 -0
  52. package/development-container.js +110 -0
  53. package/development-contract.js +17 -0
  54. package/development-files.js +101 -0
  55. package/development-gate.js +236 -0
  56. package/development-model-budget.js +48 -0
  57. package/development-peer.js +155 -0
  58. package/development-plan.js +43 -0
  59. package/development-reconciliation.js +62 -0
  60. package/development-review.js +81 -0
  61. package/development-rules/AGENTS.md +51 -0
  62. package/development-runtime.js +68 -0
  63. package/development-source.js +48 -0
  64. package/development-test-runner.js +13 -0
  65. package/development-tools.js +45 -0
  66. package/development-worker-review.js +110 -0
  67. package/development-worker.js +68 -0
  68. package/development-workspace.js +54 -0
  69. package/diagnostics.js +78 -0
  70. package/distribution-lock.json +773 -0
  71. package/drained-process.js +26 -0
  72. package/durable-inbox.js +294 -0
  73. package/feishu-policy.js +24 -0
  74. package/gateway-maintenance.js +55 -0
  75. package/global-rules/AGENTS.md +83 -0
  76. package/im-delivery.js +60 -0
  77. package/index.js +445 -0
  78. package/intervention-actions.js +135 -0
  79. package/intervention-job-control.js +28 -0
  80. package/intervention-state.js +43 -0
  81. package/job-version.js +15 -0
  82. package/legacy-feishu-adapter.js +89 -0
  83. package/link-contract.js +80 -0
  84. package/maintenance-process-identity.js +93 -0
  85. package/model-selection.js +71 -0
  86. package/native-context.js +14 -0
  87. package/native-entry-admission.js +2 -0
  88. package/native-entry.js +58 -0
  89. package/native-file-reference.js +32 -0
  90. package/native-owner-origin.js +12 -0
  91. package/native-rules/AGENTS.md +199 -0
  92. package/native-tools.js +108 -0
  93. package/notification-artifacts.js +70 -0
  94. package/notification-contract.js +29 -0
  95. package/notification-defaults.js +81 -0
  96. package/notification-discovery.js +65 -0
  97. package/notification-endpoint.js +54 -0
  98. package/notification-feishu.js +51 -0
  99. package/notification-media-endpoint.js +94 -0
  100. package/notification-review.js +27 -0
  101. package/notification-targets.js +54 -0
  102. package/onboarding-activity.js +66 -0
  103. package/onboarding-agent-hold.js +94 -0
  104. package/onboarding-boundary.js +20 -0
  105. package/onboarding-cloud-contract.js +29 -0
  106. package/onboarding-cloud-file-review.js +58 -0
  107. package/onboarding-cloud-files.js +100 -0
  108. package/onboarding-cloud-im.js +34 -0
  109. package/onboarding-cloud-model-probe.js +53 -0
  110. package/onboarding-cloud-models.js +68 -0
  111. package/onboarding-cloud-operation.js +276 -0
  112. package/onboarding-cloud-package.js +38 -0
  113. package/onboarding-cloud-repositories.js +89 -0
  114. package/onboarding-cloud-retirement.js +59 -0
  115. package/onboarding-cloud-task-runtime.js +90 -0
  116. package/onboarding-cloud-web.js +85 -0
  117. package/onboarding-cloud.js +110 -0
  118. package/onboarding-coordinated-hold.js +94 -0
  119. package/onboarding-exclusive-rename.js +16 -0
  120. package/onboarding-existing-host.js +63 -0
  121. package/onboarding-existing-setup.js +123 -0
  122. package/onboarding-file-contract.js +31 -0
  123. package/onboarding-file-review-contract.js +38 -0
  124. package/onboarding-file-transfer.js +133 -0
  125. package/onboarding-handoff-remote.js +98 -0
  126. package/onboarding-handoff.js +112 -0
  127. package/onboarding-host-stop-observation.js +44 -0
  128. package/onboarding-host.js +254 -0
  129. package/onboarding-identity.js +9 -0
  130. package/onboarding-im-maintenance-native.js +30 -0
  131. package/onboarding-im-maintenance.js +70 -0
  132. package/onboarding-im.js +31 -0
  133. package/onboarding-inspection-guard.js +15 -0
  134. package/onboarding-install-fs.js +58 -0
  135. package/onboarding-installer.js +157 -0
  136. package/onboarding-local-pair-native.js +21 -0
  137. package/onboarding-local-pair.js +99 -0
  138. package/onboarding-maintenance-fs.js +69 -0
  139. package/onboarding-maintenance-plan.js +213 -0
  140. package/onboarding-maintenance-record.js +169 -0
  141. package/onboarding-maintenance.js +163 -0
  142. package/onboarding-model-probe.js +119 -0
  143. package/onboarding-models.js +107 -0
  144. package/onboarding-native-host.js +101 -0
  145. package/onboarding-native-probe.js +56 -0
  146. package/onboarding-native-runner.js +29 -0
  147. package/onboarding-node-bootstrap.py +678 -0
  148. package/onboarding-node.js +77 -0
  149. package/onboarding-notification-defaults.js +93 -0
  150. package/onboarding-package-source.js +33 -0
  151. package/onboarding-paths.js +58 -0
  152. package/onboarding-peer-binding.js +61 -0
  153. package/onboarding-peer-contract.js +12 -0
  154. package/onboarding-plugin-repair.js +116 -0
  155. package/onboarding-plugin-version.js +143 -0
  156. package/onboarding-remote-control.js +140 -0
  157. package/onboarding-remote-probe.js +40 -0
  158. package/onboarding-repositories.js +88 -0
  159. package/onboarding-repository.js +49 -0
  160. package/onboarding-runtime-activation.js +83 -0
  161. package/onboarding-runtime-artifacts-client.js +87 -0
  162. package/onboarding-runtime-artifacts.js +126 -0
  163. package/onboarding-runtime-extension.js +400 -0
  164. package/onboarding-runtime-inventory.js +88 -0
  165. package/onboarding-runtime-program.js +42 -0
  166. package/onboarding-runtime-reclaim-client.js +94 -0
  167. package/onboarding-runtime-reclaim-worker.js +63 -0
  168. package/onboarding-runtime-reclaim.js +132 -0
  169. package/onboarding-runtime-repair-client.js +50 -0
  170. package/onboarding-runtime-repair.js +88 -0
  171. package/onboarding-runtime-stop.js +90 -0
  172. package/onboarding-runtime-uninstall-client.js +88 -0
  173. package/onboarding-runtime-uninstall.js +167 -0
  174. package/onboarding-runtime-version-client.js +138 -0
  175. package/onboarding-runtime-version.js +145 -0
  176. package/onboarding-schema.js +42 -0
  177. package/onboarding-self-disable.js +3 -0
  178. package/onboarding-self-lifecycle.js +95 -0
  179. package/onboarding-self-maintenance.js +52 -0
  180. package/onboarding-self-remove.js +3 -0
  181. package/onboarding-self-stop.js +85 -0
  182. package/onboarding-ssh-forward.js +48 -0
  183. package/onboarding-ssh.js +105 -0
  184. package/onboarding-state.js +95 -0
  185. package/onboarding-task-runtime-contract.js +38 -0
  186. package/onboarding-task-runtime-native.js +80 -0
  187. package/onboarding-task-runtime.js +66 -0
  188. package/onboarding-token-plan.js +52 -0
  189. package/onboarding-version-activation-client.js +48 -0
  190. package/onboarding-version-candidate.js +96 -0
  191. package/onboarding-version-repair.js +128 -0
  192. package/package.json +97 -4
  193. package/peer-file-fs.js +62 -0
  194. package/peer-file-migration.js +59 -0
  195. package/peer-file-review.js +107 -0
  196. package/peer-files.js +157 -0
  197. package/peer-mailbox.js +75 -0
  198. package/protocol.js +17 -0
  199. package/recovery.js +40 -0
  200. package/repository-catalog.js +85 -0
  201. package/repository-gitee.js +76 -0
  202. package/repository-managed.js +46 -0
  203. package/repository-writer.js +43 -0
  204. package/rules/AGENTS.md +22 -0
  205. package/runtime-im-lock.json +11577 -0
  206. package/runtime-im-package.json +18 -0
  207. package/runtime-lock.json +10152 -0
  208. package/runtime-package.json +17 -0
  209. package/scheduler-migration.js +45 -0
  210. package/search-contract.js +19 -0
  211. package/skills/dsh-dual-end/SKILL.md +12 -0
  212. package/skills/task-a2a/SKILL.md +55 -0
  213. package/skills/task-a2a-worker/SKILL.md +23 -0
  214. package/skills/task-approval/SKILL.md +128 -0
  215. package/skills/task-artifacts/SKILL.md +46 -0
  216. package/skills/task-development/SKILL.md +144 -0
  217. package/skills/task-diagnostics/SKILL.md +41 -0
  218. package/skills/task-direct-link/SKILL.md +143 -0
  219. package/skills/task-file-transfer/SKILL.md +107 -0
  220. package/skills/task-handoff/SKILL.md +23 -0
  221. package/skills/task-intake/SKILL.md +13 -0
  222. package/skills/task-notify/SKILL.md +102 -0
  223. package/skills/task-onboarding/SKILL.md +708 -0
  224. package/skills/task-recovery/SKILL.md +54 -0
  225. package/skills/task-repository/SKILL.md +145 -0
  226. package/skills/task-research/SKILL.md +43 -0
  227. package/skills/task-schedule/SKILL.md +79 -0
  228. package/skills/task-sidebar/SKILL.md +122 -0
  229. package/skills/task-workbench/SKILL.md +30 -0
  230. package/skills/task-worker/SKILL.md +88 -0
  231. package/source-search.js +89 -0
  232. package/source-web.js +17 -0
  233. package/ssh-connector.js +24 -0
  234. package/store.js +102 -0
  235. package/task-a2a.js +298 -0
  236. package/task-artifacts.js +179 -0
  237. package/task-board-a2a.js +55 -0
  238. package/task-board-development.js +83 -0
  239. package/task-board-planning.js +84 -0
  240. package/task-board.js +132 -0
  241. package/task-branch.js +2 -0
  242. package/task-catalog.js +77 -0
  243. package/task-context.js +40 -0
  244. package/task-envelope.js +96 -0
  245. package/task-interventions.js +54 -0
  246. package/task-jobs.js +156 -0
  247. package/task-notifications.js +132 -0
  248. package/task-results.js +16 -0
  249. package/task-scheduler.js +77 -0
  250. package/task-sources.js +101 -0
  251. package/task-trigger-time.js +46 -0
  252. package/task-triggers.js +157 -0
  253. package/task-worker.js +73 -0
  254. package/task-workflows.js +117 -0
  255. package/tools.js +13 -0
  256. package/workbench-assets/asset-provenance.json +26 -0
  257. package/workbench-assets/whale-ui-states.png +0 -0
  258. package/workbench-client.js +811 -0
  259. package/workbench-decisions.js +48 -0
  260. package/workbench-host.js +122 -0
  261. package/workbench-im-identity.js +51 -0
  262. package/workbench-proxy.js +127 -0
  263. package/worker-rules/AGENTS.md +84 -0
  264. package/worker-tools.js +13 -0
@@ -0,0 +1,150 @@
1
+ import {deliveryLabel,approvalTitle,deliveryExecution} from './delivery-contract.js';
2
+ function workspaceDevelopmentLabel(s){
3
+ return '方案约束开发:分支 '+s.branch+';执行端 '+(s.executors??['cloud']).join('、')+';最多写入 '+s.max_writes+' 次、命令 '+s.max_commands+' 次、模型请求 '+s.max_model_requests+' 次。\n'+
4
+ '文件集合(基线 SHA-256):\n'+s.files.map(f=>f.action+' '+JSON.stringify(f.path)+' '+(f.base_sha256??'absent')).join('\n')+'\n只读输入:\n'+s.reads.map(f=>JSON.stringify(f.path)+' '+f.sha256).join('\n')+'\n批准命令:\n'+s.commands.map(c=>JSON.stringify(c)).join('\n')+'\n命令仅在无网络、源快照只读的受管容器执行,不授权宿主 shell。提交、推送、发布、部署不在授权内;候选能力仍须运行时版本和运营方绑定。';
5
+ }
6
+ import {interpretApproval,SEMANTICS_VERSION} from './approval-semantics.js';
7
+ import {repositoryLabel} from './repository-gitee.js';
8
+ import {ApprovalGuidance} from './approval-guidance.js';
9
+ import {ApprovalReceipts} from './approval-receipts.js';
10
+ import {randomUUID} from 'node:crypto';
11
+ import {digest,canonical} from './approval-ledger.js';
12
+ import {chatBinding,FeishuApprovalSource} from './approval-feishu.js';
13
+ const COMMANDS=new Map([['确定','approve'],['/yes','approve'],['不批准此方案','reject'],['/no','reject'],['撤销此方案','revoke'],['/revoke','revoke']]);
14
+ export const chatAction=text=>typeof text==='string'?COMMANDS.get(text.trim())??null:null;
15
+ const plain=m=>{try{const c=JSON.parse(m.body.content);return typeof c.text==='string'?c.text:null;}catch{return null;}};
16
+ const promptVersion=m=>canonical({updated:m.updated,update_time:m.update_time});
17
+ const original=m=>m?.msg_type==='text'&&m.deleted===false&&m.updated===false&&/^\d{13}$/.test(m.create_time??'')&&m.update_time===m.create_time;
18
+ export function renderChatProposal(v,semantic=false){
19
+ const p=v.proposal;
20
+ return [approvalTitle(p),'▼ 待你决定 · 请回复本条方案(不是后续结果通知)',`任务:${v.title}(第 ${v.spec_revision} 版)`,`方案:${p.summary}`,`变更:${p.changes}`,`验收:${p.validation}`,`风险:${p.risks}`,`回滚:${p.rollback}`,`任务模型:${p.model_policy.provider} / ${p.model_policy.model}${p.model_policy.reasoningEffort?' / '+p.model_policy.reasoningEffort:''}`,`请求范围:${p.scopes.join('、')};范围互不包含`, ((p.development||deliveryExecution(p))?repositoryLabel(p.repository).replace('仅远端元数据,未检出工作区','审批绑定远端基线;独立检出由运行时另行核验'):repositoryLabel(p.repository)),p.delivery?deliveryLabel(p.delivery):p.development?.kind==='workspace-v1'?workspaceDevelopmentLabel(p.development):p.development?`受限开发:执行端 ${(p.development.executors??['cloud']).map(x=>x==='local'?'本地大肥鱼':'云端大肥鱼').join('、')};仅 ${p.development.branch} 的 ${p.development.file};最多写入 ${p.development.max_writes} 次;验收器 ${p.development.validator}。确定仅授权此范围;实际执行仍须运行时门禁及运营方匹配绑定。不得提交、推送、发布或部署。`:'开发、提交、推送、发布、部署执行器均关闭',`有效期至:${new Date(v.expires).toISOString()}`,semantic?'请使用飞书“回复”这条方案消息,用自己的话说明决定,例如:确认、可以按这个做、不批准、先等等,或提出修改意见。也可 /yes。无需编号。':'请使用飞书“回复”这条方案消息,再输入“确定”(也可 /yes)。不需要填写编号。',semantic?'有条件同意不执行旧方案;修改意见会冻结旧方案,修订后须重新确认。疑问或不确定先澄清。裸发、转述、历史或编辑后的消息不算批准。':'拒绝:回复“不批准此方案”;撤销:回复“撤销此方案”。裸发、转述、历史或修改后的消息不算批准。','普通 DSH 工具审批另行处理;本消息不授予原生工具权限。'].join('\n');
21
+ }
22
+ export class ChatApproval {
23
+ constructor(ledger,c,io={}){
24
+ this.l=ledger;this.db=ledger.db;this.hostRole=c.hostRole==='local'?'local':'cloud';this.binding=chatBinding(c);this.bindingHash=digest(this.binding);this.source=io.source??new FeishuApprovalSource(c,io);this.now=ledger.now;this.closed=false;this.running=null;this.lastError=null;this.nextPoll=0;this.semantic=!!c.semantic?.enabled;this.classify=io.classify;this.abort=new AbortController();
25
+ this.interval=c.pollIntervalMs??5000;if(!Number.isInteger(this.interval)||this.interval<1000||this.interval>60000)throw Error('INVALID_CHAT_POLL_INTERVAL');
26
+ ledger.store.tx(()=>{
27
+ if(this.db.prepare('SELECT disabled FROM approval_chat_bindings WHERE id=?').get(this.bindingHash)?.disabled)throw Error('CHAT_BINDING_REACTIVATION_REQUIRES_REVIEW');
28
+ this.db.prepare('UPDATE approval_chat_bindings SET disabled=1 WHERE id<>?').run(this.bindingHash);
29
+ this.db.prepare('INSERT INTO approval_chat_bindings(id,binding,disabled) VALUES (?,?,0) ON CONFLICT(id) DO UPDATE SET disabled=0').run(this.bindingHash,canonical(this.binding));
30
+ // Interrupted interpretation is not permission to retry the model or release a previous approval.
31
+ this.db.prepare("UPDATE approval_chat_evaluations SET state='needs_review',last_error='CHAT_SEMANTIC_INTERRUPTED' WHERE state='processing'").run();
32
+ // Crash during provider submission is uncertain, not permission to send a second proposal.
33
+ this.db.prepare("UPDATE approval_chat_deliveries SET state='needs_review',last_error='CHAT_SEND_RESULT_UNKNOWN' WHERE state='sending'").run();
34
+ this.db.prepare("UPDATE approval_chat_deliveries SET state='needs_review',last_error='CHAT_PROPOSAL_VERSION_MISSING' WHERE state='sent' AND prompt_version IS NULL").run();
35
+ });
36
+ this.receipts=new ApprovalReceipts(ledger,this.bindingHash,this.source,this.binding);this.guidance=new ApprovalGuidance(this);
37
+ }
38
+ queue(request_id){
39
+ const v=this.l.view(request_id);if(v.state!=='pending')return this.delivery(request_id);
40
+ const text=renderChatProposal(v,this.semantic);if(Buffer.byteLength(text)>18000)throw Error('CHAT_PROPOSAL_TOO_LARGE');
41
+ this.db.prepare("INSERT OR IGNORE INTO approval_chat_deliveries(request_id,binding_hash,uuid,text,state,created,semantics_version) VALUES (?,?,?,?,'queued',?,?)").run(request_id,this.bindingHash,randomUUID(),text,this.now(),this.semantic?SEMANTICS_VERSION:0);return this.delivery(request_id);
42
+ }
43
+ interpretationStatus(id){return this.db.prepare('SELECT state,created,last_error,interpretation FROM approval_chat_evaluations WHERE request_id=? ORDER BY created DESC LIMIT 20').all(id).map(({interpretation,...r})=>({...r,intent:interpretation?JSON.parse(interpretation).intent:null}));}
44
+ delivery(id){const r=this.db.prepare('SELECT state,last_error,binding_hash,semantics_version FROM approval_chat_deliveries WHERE request_id=?').get(id);return r?{state:r.binding_hash===this.bindingHash?r.state:'needs_review',last_error:r.binding_hash===this.bindingHash?r.last_error:'CHAT_ROUTE_REVIEW_REQUIRED',receipts:this.receipts.status(id),reply_guidance:this.guidance.status(id),interpretations:this.interpretationStatus(id),provider:'feishu',kind:'proposal_delivery',confirmation_target:{host_role:this.hostRole,display_name:this.hostRole==='local'?'本地 IM 机器人':'云端 IM 机器人',platform:'feishu',conversation:'configured_private_chat'},proposal_title:approvalTitle(this.l.view(id).proposal),instruction:r.semantics_version?'回复标题含【DSH 方案确认】的原方案,不要回复【审批账本回执】;自然语言说明批准、拒绝、暂缓或修改意见(也可 /yes)':'回复具体方案消息:确定(或 /yes)',execution:this.l.view(id).execution}:null;}
45
+ tick(){if(this.closed)return Promise.resolve();if(this.running)return this.running;this.running=(async()=>{await this.cycle();if(!this.closed)await this.receipts.cycle();if(!this.closed)await this.guidance.cycle();})().finally(()=>this.running=null);return this.running;}
46
+ async cycle(){
47
+ if(this.nextPoll>this.now())return;this.nextPoll=this.now()+this.interval;
48
+ try{
49
+ const rows=this.db.prepare("SELECT * FROM approval_chat_deliveries WHERE binding_hash=? AND state IN ('queued','sent') ORDER BY created LIMIT 100").all(this.bindingHash).filter(r=>{if(['pending','approved','held','clarification_required','confirmation_review'].includes(this.l.view(r.request_id).state))return true;this.db.prepare("UPDATE approval_chat_deliveries SET state='inactive' WHERE request_id=?").run(r.request_id);return false;});
50
+ if(!rows.length){this.lastError=null;return;}
51
+ await this.source.verifyBot();if(this.closed)return;
52
+ for(const r of rows.filter(r=>r.state==='queued').slice(0,5)){
53
+ if(this.closed)return;if(this.l.view(r.request_id).state!=='pending')continue;
54
+ this.db.prepare("UPDATE approval_chat_deliveries SET state='sending' WHERE request_id=?").run(r.request_id);
55
+ let messageId,version;try{
56
+ messageId=await this.source.send(r.text,r.uuid);
57
+ this.db.prepare('UPDATE approval_chat_deliveries SET message_id=? WHERE request_id=?').run(messageId,r.request_id);
58
+ const p=await this.source.get(messageId);
59
+ if(!this.validPrompt(p,r,messageId))throw Error('CHAT_PROPOSAL_CHANGED');version=promptVersion(p);
60
+ }catch{this.db.prepare("UPDATE approval_chat_deliveries SET state='needs_review',last_error='CHAT_SEND_RESULT_UNKNOWN' WHERE request_id=?").run(r.request_id);continue;}
61
+ this.db.prepare("UPDATE approval_chat_deliveries SET state='sent',message_id=?,prompt_version=?,last_error=NULL WHERE request_id=?").run(messageId,version,r.request_id);r.state='sent';r.message_id=messageId;r.prompt_version=version;
62
+ }
63
+ const sent=rows.filter(r=>r.state==='sent');if(!sent.length)return;
64
+ const history=await this.source.list(Math.min(...sent.map(r=>r.created))-30000);if(this.closed)return;
65
+ for(const m of history){
66
+ if(this.closed)return;
67
+ if(!chatAction(plain(m)))continue;
68
+ const r=sent.find(r=>r.message_id===m.parent_id&&!r.semantics_version);if(!r)continue;
69
+ if(this.db.prepare('SELECT 1 FROM approval_chat_proofs WHERE message_id=? AND binding_hash=?').get(m.message_id,this.bindingHash))continue;
70
+ // Never trust a model, PeerMailbox or a caller-supplied event. Re-fetch BOTH objects from the provider.
71
+ const reply=await this.source.get(m.message_id),prompt=await this.source.get(r.message_id);
72
+ if(this.closed)return;
73
+ if(!this.validPrompt(prompt,r,r.message_id)||promptVersion(prompt)!==r.prompt_version){this.db.prepare("UPDATE approval_chat_deliveries SET state='needs_review',last_error='CHAT_PROPOSAL_CHANGED' WHERE request_id=?").run(r.request_id);continue;}
74
+ this.verifyAndRecord(r,reply,prompt);
75
+ }
76
+ await this.semanticCycle(sent.filter(r=>r.semantics_version===SEMANTICS_VERSION),history);
77
+ if(!this.closed)await this.guidance.observe(history);
78
+ this.lastError=null;
79
+ }catch(e){if(['CHAT_BOT_CHANGED','CHAT_PRIVATE_ROUTE_REQUIRED'].includes(e.message))this.db.prepare('UPDATE approval_chat_bindings SET disabled=1 WHERE id=?').run(this.bindingHash);this.lastError=/^(CHAT_|APPROVAL_|TASK_|INVALID_PROVIDER_)[A-Z0-9_]+$/.test(e.message)?e.message:'CHAT_VERIFICATION_FAILED';}
80
+ }
81
+ validPrompt(m,r,id){const b=this.binding;return m?.message_id===id&&m.chat_id===b.chatId&&(m.chat_type===undefined||m.chat_type==='p2p')&&m.msg_type==='text'&&m.deleted===false&&typeof m.updated==='boolean'&&/^\d{13}$/.test(m.create_time??'')&&/^\d{13}$/.test(m.update_time??'')&&Number(m.update_time)>=Number(m.create_time)&&Number(m.create_time)>=r.created-30000&&Number(m.update_time)<=this.now()+30000&&m.sender?.sender_type==='app'&&m.sender.id_type==='app_id'&&m.sender.id===b.appId&&plain(m)===r.text;}
82
+ verifiedSource(r,m,prompt){
83
+ const b=this.binding,now=this.now();
84
+ if(!original(m)||!this.validPrompt(prompt,r,r.message_id)||promptVersion(prompt)!==r.prompt_version||m.chat_id!==b.chatId||prompt.chat_id!==b.chatId||(m.chat_type!==undefined&&m.chat_type!=='p2p')||(prompt.chat_type!==undefined&&prompt.chat_type!=='p2p')||m.parent_id!==r.message_id||prompt.message_id!==r.message_id||
85
+ m.sender?.sender_type!=='user'||m.sender.id_type!=='open_id'||m.sender.id!==b.approverOpenId||prompt.sender?.sender_type!=='app'||prompt.sender.id_type!=='app_id'||prompt.sender.id!==b.appId||
86
+ plain(prompt)!==r.text||Number(prompt.create_time)<r.created-30000||Number(m.create_time)<=Number(prompt.update_time)||Number(m.create_time)>now+30000)return false;
87
+ const v=this.l.view(r.request_id);if(Number(m.create_time)>v.expires)return false;
88
+ return true;
89
+ }
90
+ verifyAndRecord(r,m,prompt,interpretation=null){
91
+ const action=interpretation?.intent??chatAction(plain(m)),b=this.binding,now=this.now();
92
+ if(!action||!this.verifiedSource(r,m,prompt))return false;
93
+ const v=this.l.view(r.request_id);
94
+ if(interpretation){if(!['pending','approved','held','clarification_required'].includes(this.l.validity(this.l.row(r.request_id),{ignoreInterpretation:true})))return false;}
95
+ else if(action==='revoke'?v.recorded_state!=='approved':v.state!=='pending')return false;
96
+ const proof={provider:'feishu',binding_hash:this.bindingHash,request_id:r.request_id,proposal_hash:v.proposal_hash,prompt_version:r.prompt_version,message_id:m.message_id,parent_id:m.parent_id,actor:b.approverOpenId,text:plain(m),created:m.create_time,verified:now,...(interpretation?{interpretation}: {})};
97
+ return this.l.store.tx(()=>{
98
+ const binding=this.db.prepare('SELECT disabled FROM approval_chat_bindings WHERE id=?').get(this.bindingHash);
99
+ if(!binding||binding.disabled)throw Error('CHAT_BINDING_DISABLED');
100
+ const d=this.db.prepare('SELECT * FROM approval_chat_deliveries WHERE request_id=?').get(r.request_id);
101
+ if(d?.state!=='sent'||d.binding_hash!==this.bindingHash||d.message_id!==m.parent_id||d.text!==r.text||d.prompt_version!==r.prompt_version)throw Error('CHAT_DELIVERY_CHANGED');
102
+ if(this.db.prepare('SELECT 1 FROM approval_chat_proofs WHERE binding_hash=? AND message_id=?').get(this.bindingHash,m.message_id))return false;
103
+ if(interpretation){
104
+ const e=this.db.prepare('SELECT state FROM approval_chat_evaluations WHERE binding_hash=? AND message_id=?').get(this.bindingHash,m.message_id);
105
+ if(e?.state!=='processing')throw Error('CHAT_SEMANTIC_STATE_CHANGED');
106
+ this.db.prepare("UPDATE approval_chat_evaluations SET state='recorded',interpretation=? WHERE binding_hash=? AND message_id=?").run(canonical(interpretation),this.bindingHash,m.message_id);
107
+ this.db.prepare("UPDATE approval_chat_evaluations SET state='superseded' WHERE request_id=? AND state='needs_review' AND created<?").run(r.request_id,Number(m.create_time));
108
+ }
109
+ const challenge_id='chat-'+randomUUID(),proof_hash=digest(proof);
110
+ this.db.prepare('INSERT INTO approval_chat_proofs VALUES (?,?,?,?,?,?)').run(challenge_id,this.bindingHash,m.message_id,proof_hash,canonical(proof),now);
111
+ return this.l.recordDecision({request_id:r.request_id,action,principal:`feishu:${b.appId}:${b.approverOpenId}`,credential_id:'chat:'+this.bindingHash,proof_hash,challenge_id,chatEvaluation:!!interpretation});
112
+ });
113
+ }
114
+ async semanticCycle(rows,history){
115
+ if(!rows.length)return;
116
+ const batch=[];
117
+ for(const m of [...history].sort((a,b)=>Number(a.create_time)-Number(b.create_time)||a.message_id.localeCompare(b.message_id))){
118
+ if(this.closed)return;
119
+ const r=rows.find(r=>r.message_id===m.parent_id);if(!r||plain(m)===null)continue;
120
+ if(this.db.prepare('SELECT 1 FROM approval_chat_evaluations WHERE binding_hash=? AND message_id=?').get(this.bindingHash,m.message_id))continue;
121
+ const reply=await this.source.get(m.message_id),prompt=await this.source.get(r.message_id);
122
+ if(this.closed||!this.verifiedSource(r,reply,prompt))continue;
123
+ // Late older messages cannot override a later human decision. Same-timestamp ambiguity never grants approval.
124
+ const last=this.db.prepare('SELECT MAX(created) at FROM approval_chat_evaluations WHERE request_id=?').get(r.request_id)?.at;
125
+ if(last&&Number(reply.create_time)<last)continue;
126
+ batch.push({r,reply,prompt,tiedToPrevious:last===Number(reply.create_time)});
127
+ }
128
+ // Persist ALL known replies before interpreting any of them. A later amendment already seen in
129
+ // this batch must block a preceding "yes" even while a model call is in flight.
130
+ this.l.store.tx(()=>{for(const {r,reply} of batch)this.db.prepare("INSERT OR IGNORE INTO approval_chat_evaluations(binding_hash,message_id,request_id,state,created) VALUES (?,?,?,'processing',?)").run(this.bindingHash,reply.message_id,r.request_id,Number(reply.create_time));});
131
+ for(const {r,reply,prompt,tiedToPrevious} of batch){
132
+ if(this.closed)return;
133
+ const set=(state,error=null)=>this.db.prepare('UPDATE approval_chat_evaluations SET state=?,last_error=? WHERE binding_hash=? AND message_id=?').run(state,error,this.bindingHash,reply.message_id);
134
+ const base=this.l.validity(this.l.row(r.request_id),{ignoreInterpretation:true});
135
+ if(!['pending','approved','held','clarification_required'].includes(base)){set('obsolete');continue;}
136
+ try{
137
+ const interpretation=await interpretApproval(plain(reply),this.l.view(r.request_id).proposal,this.classify,this.abort.signal);
138
+ // The user can edit/delete a message while interpretation is awaiting a response.
139
+ const fresh=await this.source.get(reply.message_id),parent=await this.source.get(r.message_id);
140
+ if(this.closed)return;
141
+ if(canonical(fresh)!==canonical(reply)||!this.verifiedSource(r,fresh,parent)||promptVersion(parent)!==promptVersion(prompt)){set('needs_review','CHAT_SEMANTIC_SOURCE_CHANGED');continue;}
142
+ const tied=tiedToPrevious||batch.filter(x=>x.r.request_id===r.request_id&&x.reply.create_time===reply.create_time).length>1;
143
+ if(tied){interpretation.intent='clarify';interpretation.unconditional=false;interpretation.reason='同一时刻存在多条决定,请用一条完整回复说明最终意见。';}
144
+ if(!this.verifyAndRecord(r,fresh,parent,interpretation))set('needs_review','CHAT_SEMANTIC_STATE_CHANGED');
145
+ }catch{set('needs_review','CHAT_SEMANTIC_COMMIT_FAILED');}
146
+ }
147
+ }
148
+ snapshot(){return {bindingEnabled:this.db.prepare('SELECT disabled FROM approval_chat_bindings WHERE id=?').get(this.bindingHash)?.disabled===0,provider:'feishu',mode:'official-api-observer',confirmation:this.semantic?'reply-bound-semantic':'reply-bound',receipts:'ledger-outbox',lastError:this.lastError,execution:'disabled'};}
149
+ async close(){this.closed=true;this.abort.abort();this.receipts.close();this.guidance.close();await this.running;}
150
+ }
@@ -0,0 +1,52 @@
1
+ // Official HTTPS API only. No IM plugin imports, storage, WebSocket or private Host API.
2
+ const BASE='https://open.feishu.cn/open-apis';
3
+ const id=(v,p)=>typeof v==='string'&&new RegExp('^'+p+'[A-Za-z0-9_-]{4,128}$').test(v);
4
+ export function chatBinding(c){
5
+ if(!c||c.provider!=='feishu'||!id(c.appId,'cli_')||!id(c.botOpenId,'ou_')||!id(c.chatId,'oc_')||!id(c.approverOpenId,'ou_')||!(/^[A-Z][A-Z0-9_]{2,80}$/).test(c.appSecretEnv??''))throw Error('INVALID_CHAT_APPROVAL_BINDING');
6
+ return {provider:'feishu',appId:c.appId,botOpenId:c.botOpenId,chatId:c.chatId,approverOpenId:c.approverOpenId};
7
+ }
8
+ export class FeishuApprovalSource {
9
+ constructor(c,{fetcher=fetch,env=process.env,now=Date.now,credentials}={}){this.binding=chatBinding(c);this.secretRef=c.appSecretEnv;this.credentials=credentials;this.secret=credentials?null:env[c.appSecretEnv];if(!credentials&&(typeof this.secret!=='string'||!this.secret))throw Error('CHAT_APPROVAL_CREDENTIAL_UNAVAILABLE');this.fetcher=fetcher;this.now=now;this.token=null;}
10
+ async http(path,options={}){
11
+ let r;try{r=await this.fetcher(BASE+path,{...options,redirect:'error',signal:AbortSignal.timeout(10000)});}catch{throw Error('CHAT_PROVIDER_UNAVAILABLE');}
12
+ if(!r.ok)throw Error('CHAT_PROVIDER_HTTP_'+r.status);
13
+ let raw='',bytes=0;const decoder=new TextDecoder();for await(const part of r.body){bytes+=part.byteLength;raw+=decoder.decode(part,{stream:true});if(bytes>1048576)throw Error('CHAT_PROVIDER_RESPONSE_TOO_LARGE');}
14
+ raw+=decoder.decode();let d;try{d=JSON.parse(raw);}catch{throw Error('CHAT_PROVIDER_INVALID_RESPONSE');}
15
+ if(d.code!==0)throw Error('CHAT_PROVIDER_CODE_'+String(Number(d.code)));
16
+ return d;
17
+ }
18
+ async auth(){
19
+ // Official reference resolution is read-only and local to this Host. Resolve
20
+ // each operation; revocation/rotation must invalidate a cached tenant token.
21
+ if(this.credentials){let value;try{value=(await this.credentials.resolve(this.secretRef))?.value;}catch{this.token=null;this.secret=null;throw Error('CHAT_APPROVAL_CREDENTIAL_UNAVAILABLE');}
22
+ if(typeof value!=='string'||!value){this.token=null;this.secret=null;throw Error('CHAT_APPROVAL_CREDENTIAL_UNAVAILABLE');}
23
+ if(value!==this.secret){this.token=null;this.secret=value;}
24
+ }
25
+ if(this.token?.until>this.now())return this.token.value;
26
+ const d=await this.http('/auth/v3/tenant_access_token/internal',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify({app_id:this.binding.appId,app_secret:this.secret})});
27
+ if(typeof d.tenant_access_token!=='string'||!Number.isFinite(d.expire)||d.expire<=60)throw Error('CHAT_PROVIDER_INVALID_TOKEN');
28
+ this.token={value:d.tenant_access_token,until:this.now()+(Math.min(d.expire,7200)-60)*1000};return this.token.value;
29
+ }
30
+ async api(path,options={}){try{return await this.http(path,{...options,headers:{Authorization:'Bearer '+await this.auth(),'content-type':'application/json'}});}catch(e){this.token=null;throw e;}}
31
+ async verifyBot(){const d=await this.api('/bot/v3/info');if(d.bot?.open_id!==this.binding.botOpenId)throw Error('CHAT_BOT_CHANGED');const chat=await this.api('/im/v1/chats/'+encodeURIComponent(this.binding.chatId));if(chat.data?.chat_mode!=='p2p')throw Error('CHAT_PRIVATE_ROUTE_REQUIRED');}
32
+ async get(messageId){if(!id(messageId,'om_'))throw Error('INVALID_PROVIDER_MESSAGE_ID');const d=await this.api('/im/v1/messages/'+encodeURIComponent(messageId));if(d.data?.items?.length!==1||d.data.items[0].message_id!==messageId)throw Error('CHAT_MESSAGE_NOT_FOUND');return d.data.items[0];}
33
+ async send(text,uuid){
34
+ const d=await this.api('/im/v1/messages?receive_id_type=chat_id',{method:'POST',body:JSON.stringify({receive_id:this.binding.chatId,msg_type:'text',content:JSON.stringify({text}),uuid})});
35
+ if(!id(d.data?.message_id,'om_')||d.data.chat_id!==this.binding.chatId)throw Error('CHAT_SEND_RESULT_UNKNOWN');return d.data.message_id;
36
+ }
37
+ async reply(messageId,text,uuid){
38
+ if(!id(messageId,'om_'))throw Error('INVALID_PROVIDER_MESSAGE_ID');
39
+ const d=await this.api('/im/v1/messages/'+encodeURIComponent(messageId)+'/reply',{method:'POST',body:JSON.stringify({msg_type:'text',content:JSON.stringify({text}),reply_in_thread:false,uuid})});
40
+ if(!id(d.data?.message_id,'om_')||d.data.chat_id!==this.binding.chatId)throw Error('CHAT_SEND_RESULT_UNKNOWN');return d.data.message_id;
41
+ }
42
+ async list(since){
43
+ const items=[];let page;
44
+ for(let i=0;i<4;i++){
45
+ const q=new URLSearchParams({container_id_type:'chat',container_id:this.binding.chatId,start_time:String(Math.floor(since/1000)),sort_type:'ByCreateTimeAsc',page_size:'50',...(page?{page_token:page}:{})});
46
+ const d=(await this.api('/im/v1/messages?'+q)).data;if(!Array.isArray(d?.items)||typeof d.has_more!=='boolean')throw Error('CHAT_HISTORY_INVALID');
47
+ items.push(...d.items);if(!d.has_more)return items;if(typeof d.page_token!=='string'||!d.page_token||d.page_token===page)throw Error('CHAT_HISTORY_INVALID');page=d.page_token;
48
+ }
49
+ // Never silently skip confirmations or advance a cursor over an incomplete window.
50
+ throw Error('CHAT_HISTORY_WINDOW_TOO_BUSY');
51
+ }
52
+ }
@@ -0,0 +1,68 @@
1
+ import {canonical} from './approval-ledger.js';
2
+ import {randomUUID} from 'node:crypto';
3
+
4
+ const plain=m=>{try{return JSON.parse(m.body.content).text;}catch{return null;}};
5
+ const original=m=>m?.msg_type==='text'&&m.deleted===false&&m.updated===false&&/^\d{13}$/.test(m.create_time??'')&&m.update_time===m.create_time;
6
+ // Navigation only. Never calls the interpreter, creates proof or changes an approval.
7
+ export class ApprovalGuidance {
8
+ constructor(chat){
9
+ this.chat=chat;this.db=chat.db;this.source=chat.source;this.closed=false;
10
+ this.db.exec(`CREATE TABLE IF NOT EXISTS approval_guidance_epoch(binding_hash TEXT PRIMARY KEY,created INTEGER NOT NULL);
11
+ CREATE TABLE IF NOT EXISTS approval_guidance(binding_hash TEXT NOT NULL,reply_id TEXT NOT NULL,request_id TEXT NOT NULL,target_id TEXT NOT NULL,uuid TEXT NOT NULL,state TEXT NOT NULL,created INTEGER NOT NULL,text TEXT,message_id TEXT,attempts INTEGER NOT NULL DEFAULT 0,next_attempt INTEGER NOT NULL DEFAULT 0,last_error TEXT,PRIMARY KEY(binding_hash,reply_id));`);
12
+ this.db.prepare('INSERT OR IGNORE INTO approval_guidance_epoch VALUES (?,?)').run(chat.bindingHash,chat.now());
13
+ this.since=this.db.prepare('SELECT created FROM approval_guidance_epoch WHERE binding_hash=?').get(chat.bindingHash).created;
14
+ this.db.prepare("UPDATE approval_guidance SET state=CASE WHEN message_id IS NULL THEN 'needs_review' ELSE 'verifying' END,last_error='CHAT_GUIDANCE_INTERRUPTED' WHERE state='sending'").run();
15
+ }
16
+ status(id){return this.db.prepare('SELECT state,last_error FROM approval_guidance WHERE request_id=? AND binding_hash=? ORDER BY created DESC LIMIT 5').all(id,this.chat.bindingHash);}
17
+ enabled(){return !this.closed&&this.db.prepare('SELECT disabled FROM approval_chat_bindings WHERE id=?').get(this.chat.bindingHash)?.disabled===0;}
18
+ async observe(history){
19
+ let count=0;
20
+ for(const m of history){
21
+ if(!this.enabled()||count>=5)return;
22
+ if(Number(m.create_time)<=this.since||!m.parent_id)continue;
23
+ if(this.db.prepare('SELECT 1 FROM approval_guidance WHERE binding_hash=? AND reply_id=?').get(this.chat.bindingHash,m.message_id))continue;
24
+ const r=this.db.prepare("SELECT * FROM approval_receipts WHERE message_id=? AND binding_hash=? AND state='sent'").get(m.parent_id,this.chat.bindingHash);
25
+ if(!r)continue;
26
+ const b=this.chat.binding,reply=await this.source.get(m.message_id),parent=await this.source.get(r.message_id);
27
+ if(reply?.message_id!==m.message_id||!original(reply)||reply.sender?.sender_type!=='user'||reply.sender?.id_type!=='open_id'||reply.sender?.id!==b.approverOpenId||reply.chat_id!==b.chatId||(reply.chat_type!==undefined&&reply.chat_type!=='p2p')||reply.parent_id!==r.message_id||Number(reply.create_time)<=this.since||Number(reply.create_time)>this.chat.now()+30000||Number(reply.create_time)<=Number(parent?.update_time))continue;
28
+ if(parent?.message_id!==r.message_id||parent.chat_id!==b.chatId||parent.msg_type!=='text'||parent.deleted!==false||parent.sender?.sender_type!=='app'||parent.sender?.id_type!=='app_id'||parent.sender?.id!==b.appId||plain(parent)!==r.text)continue;
29
+ const d=this.db.prepare('SELECT * FROM approval_chat_deliveries WHERE request_id=? AND binding_hash=?').get(r.request_id,this.chat.bindingHash);
30
+ if(!d?.message_id)continue;
31
+ const prompt=await this.source.get(d.message_id);
32
+ if(!this.chat.validPrompt(prompt,d,d.message_id)||d.prompt_version!==canonical({update_time:prompt.update_time,updated:prompt.updated}))continue;
33
+ if(!this.enabled())return;
34
+ this.db.prepare("INSERT OR IGNORE INTO approval_guidance(binding_hash,reply_id,request_id,target_id,uuid,state,created) VALUES (?,?,?,?,?,'queued',?)").run(this.chat.bindingHash,reply.message_id,r.request_id,d.message_id,randomUUID(),this.chat.now());count++;
35
+ }
36
+ }
37
+ async cycle(){
38
+ if(!this.enabled())return;
39
+ const rows=this.db.prepare("SELECT * FROM approval_guidance WHERE binding_hash=? AND state IN ('queued','verifying') AND next_attempt<=? ORDER BY created LIMIT 5").all(this.chat.bindingHash,this.chat.now());
40
+ for(const r of rows){
41
+ if(!this.enabled())return;
42
+ try{
43
+ await this.source.verifyBot();if(!this.enabled())return;
44
+ if(r.state==='queued'){
45
+ const delivery=this.db.prepare('SELECT * FROM approval_chat_deliveries WHERE request_id=? AND binding_hash=?').get(r.request_id,r.binding_hash);
46
+ const prompt=await this.source.get(r.target_id);
47
+ if(!delivery||delivery.message_id!==r.target_id||!this.chat.validPrompt(prompt,delivery,r.target_id)||delivery.prompt_version!==canonical({update_time:prompt.update_time,updated:prompt.updated})){this.db.prepare("UPDATE approval_guidance SET state='needs_review',last_error='CHAT_PROPOSAL_CHANGED' WHERE binding_hash=? AND reply_id=?").run(r.binding_hash,r.reply_id);continue;}
48
+ if(!this.enabled())return;
49
+ const v=this.chat.l.view(r.request_id),active=['pending','approved','held','clarification_required'].includes(v.state);
50
+ const text=['【DSH 操作提示 · 不是审批回执】','你回复的是“结果通知”,这条回复没有形成新的审批决定。',`任务:${v.title}(第 ${v.spec_revision} 版)`,active?'如要改变决定:点击本条上方引用,定位原方案;对原方案点“回复”,再用自己的话表达意见。':'原方案已失效或待核对,请先查询当前方案;不要重复批准旧方案。','不要回复这条提示;无需输入任务编号。本提示不批准、不启动、不恢复任何任务。'].join('\n');
51
+ this.db.prepare("UPDATE approval_guidance SET state='sending',text=? WHERE binding_hash=? AND reply_id=?").run(text,r.binding_hash,r.reply_id);
52
+ let id;
53
+ try{id=await this.source.reply(r.target_id,text,r.uuid);}catch{this.db.prepare("UPDATE approval_guidance SET state='needs_review',last_error='CHAT_GUIDANCE_SEND_UNKNOWN' WHERE binding_hash=? AND reply_id=?").run(r.binding_hash,r.reply_id);continue;}
54
+ this.db.prepare("UPDATE approval_guidance SET state='verifying',message_id=? WHERE binding_hash=? AND reply_id=?").run(id,r.binding_hash,r.reply_id);
55
+ r.message_id=id;r.text=text;
56
+ }
57
+ if(!this.enabled())return;
58
+ const m=await this.source.get(r.message_id),b=this.chat.binding;
59
+ const valid=m?.message_id===r.message_id&&m.parent_id===r.target_id&&m.chat_id===b.chatId&&m.msg_type==='text'&&m.deleted===false&&m.sender?.sender_type==='app'&&m.sender?.id_type==='app_id'&&m.sender?.id===b.appId&&plain(m)===r.text;
60
+ this.db.prepare('UPDATE approval_guidance SET state=?,last_error=? WHERE binding_hash=? AND reply_id=?').run(valid?'sent':'needs_review',valid?null:'CHAT_GUIDANCE_CONTENT_MISMATCH',r.binding_hash,r.reply_id);
61
+ }catch{
62
+ const n=r.attempts+1;
63
+ this.db.prepare("UPDATE approval_guidance SET attempts=?,next_attempt=?,state=CASE WHEN ?>=8 THEN 'needs_review' ELSE state END,last_error='CHAT_GUIDANCE_PROVIDER_UNAVAILABLE' WHERE binding_hash=? AND reply_id=?").run(n,this.chat.now()+Math.min(300000,1000*2**n),n,r.binding_hash,r.reply_id);
64
+ }
65
+ }
66
+ }
67
+ close(){this.closed=true;}
68
+ }
@@ -0,0 +1,8 @@
1
+ // Retired URLs return a clear non-actionable response. No auth object is created,
2
+ // no input is consumed and no cookie, challenge, invitation or decision is issued.
3
+ export class ApprovalWindow {
4
+ async handle(_req,res){
5
+ res.writeHead(410,{'Content-Type':'application/json; charset=utf-8','Cache-Control':'no-store','X-Content-Type-Options':'nosniff','Content-Security-Policy':"default-src 'none'; frame-ancestors 'none'",'Referrer-Policy':'no-referrer'});
6
+ res.end(JSON.stringify({error:'APPROVAL_PASSKEY_RETIRED',message:'此旧审批入口已停用。请回到大肥鱼bot的对应任务查看处理方式;不需要注册新身份。',approval_granted:false,execution_granted:false}));
7
+ }
8
+ }
@@ -0,0 +1,142 @@
1
+ import {developmentSpec} from './development-contract.js';
2
+ import {deliveryReference,deliveryExecution} from './delivery-contract.js';
3
+ import {createHash,randomUUID} from 'node:crypto';
4
+ import {newCloudPolicy,validPolicy} from './task-context.js';
5
+ import {parseEnvelope} from './task-envelope.js';
6
+ export const canonical=v=>JSON.stringify(v,(_k,x)=>x&&typeof x==='object'&&!Array.isArray(x)?Object.fromEntries(Object.keys(x).sort().map(k=>[k,x[k]])):x);
7
+ export const digest=v=>createHash('sha256').update(typeof v==='string'?v:canonical(v)).digest('hex');
8
+ export const scopes=['develop','commit','push','publish','deploy'];
9
+ const text=(x,n)=>{if(typeof x!=='string'||!x.trim()||x.length>n)throw Error('INVALID_APPROVAL_PROPOSAL');return x;};
10
+ function proposal(p){
11
+ if(!p||Object.keys(p).some(k=>!['summary','changes','validation','risks','rollback','model_policy','scopes','repository','development','delivery'].includes(k)))throw Error('INVALID_APPROVAL_PROPOSAL');
12
+ if(!Array.isArray(p.scopes)||!p.scopes.length||p.scopes.length>5||new Set(p.scopes).size!==p.scopes.length||p.scopes.some(x=>!scopes.includes(x)))throw Error('INVALID_APPROVAL_SCOPE');
13
+ // Only an opaque reference is accepted. The coordinator supplies the immutable provider-verified snapshot.
14
+ if(p.repository!==null&&(!p.repository||typeof p.repository!=='object'||Array.isArray(p.repository)||Object.keys(p.repository).some(k=>!['binding_revision','fingerprint'].includes(k))||!Number.isInteger(p.repository.binding_revision)||p.repository.binding_revision<1||!(/^[a-f0-9]{64}$/).test(p.repository.fingerprint??'')))throw Error('REPOSITORY_BINDING_NOT_IMPLEMENTED');
15
+ const result={summary:text(p.summary,1000),changes:text(p.changes,4000),validation:text(p.validation,2000),risks:text(p.risks,2000),rollback:text(p.rollback,2000),model_policy:validPolicy(p.model_policy),scopes:[...p.scopes].sort(),repository:p.repository};
16
+ if(p.development!==undefined){if(p.scopes.length!==1||p.scopes[0]!=='develop'||p.repository===null)throw Error('DEVELOPMENT_SCOPE_DENIED');result.development=developmentSpec(p.development);}
17
+ if(p.delivery!==undefined){if(p.development!==undefined||p.scopes.length!==1||p.scopes[0]!==(p.delivery?.kind==='push-execution-reference-v1'?'push':'commit')||p.repository===null)throw Error('DELIVERY_SCOPE_DENIED');result.delivery=deliveryReference(p.delivery);}
18
+ if(canonical(result).length>12000)throw Error('APPROVAL_PROPOSAL_TOO_LARGE');return result;
19
+ }
20
+ export class ApprovalLedger {
21
+ constructor(store,catalog,now=Date.now,repositories=null){
22
+ this.store=store;this.db=store.db;this.catalog=catalog;this.now=now;this.repositories=repositories;
23
+ this.db.exec(`CREATE TABLE IF NOT EXISTS approval_requests(id TEXT PRIMARY KEY,event_id TEXT UNIQUE,fingerprint TEXT,task_id TEXT,spec_revision INTEGER,task_hash TEXT,proposal TEXT,proposal_hash TEXT,state TEXT,created INTEGER,expires INTEGER,decision_id TEXT);
24
+ CREATE TABLE IF NOT EXISTS approval_decisions(id TEXT PRIMARY KEY,request_id TEXT,action TEXT,principal TEXT,credential_id TEXT,proof_hash TEXT UNIQUE,challenge_id TEXT UNIQUE,created INTEGER);
25
+ CREATE TABLE IF NOT EXISTS approval_credentials(id TEXT PRIMARY KEY,principal TEXT NOT NULL,public_key BLOB NOT NULL,counter INTEGER NOT NULL,disabled INTEGER NOT NULL DEFAULT 0,created INTEGER);
26
+ CREATE TABLE IF NOT EXISTS approval_challenges(id TEXT PRIMARY KEY,kind TEXT,challenge TEXT,binding TEXT,expires INTEGER,used INTEGER DEFAULT 0,result TEXT);
27
+ CREATE TABLE IF NOT EXISTS approval_enrollment(ticket_hash TEXT PRIMARY KEY,principal TEXT,expires INTEGER,used INTEGER DEFAULT 0);
28
+ CREATE TABLE IF NOT EXISTS approval_chat_evaluations(binding_hash TEXT NOT NULL,message_id TEXT NOT NULL,request_id TEXT NOT NULL,state TEXT NOT NULL,created INTEGER NOT NULL,interpretation TEXT,last_error TEXT,PRIMARY KEY(binding_hash,message_id));
29
+ CREATE TABLE IF NOT EXISTS approval_chat_bindings(id TEXT PRIMARY KEY,binding TEXT NOT NULL,disabled INTEGER NOT NULL);
30
+ CREATE TABLE IF NOT EXISTS approval_chat_deliveries(request_id TEXT PRIMARY KEY,binding_hash TEXT NOT NULL,uuid TEXT UNIQUE,text TEXT NOT NULL,state TEXT NOT NULL,created INTEGER,message_id TEXT UNIQUE,last_error TEXT,prompt_version TEXT);
31
+ CREATE TABLE IF NOT EXISTS approval_chat_proofs(challenge_id TEXT PRIMARY KEY,binding_hash TEXT NOT NULL,message_id TEXT NOT NULL,proof_hash TEXT UNIQUE,proof TEXT NOT NULL,created INTEGER,UNIQUE(binding_hash,message_id));
32
+ CREATE TABLE IF NOT EXISTS approval_receipts(decision_id TEXT PRIMARY KEY,request_id TEXT NOT NULL,binding_hash TEXT NOT NULL,uuid TEXT UNIQUE NOT NULL,state TEXT NOT NULL,created INTEGER NOT NULL,attempts INTEGER NOT NULL DEFAULT 0,next_attempt INTEGER NOT NULL DEFAULT 0,text TEXT,snapshot_state TEXT,snapshot_at INTEGER,message_id TEXT UNIQUE,last_error TEXT);`);
33
+ if(!this.db.prepare('PRAGMA table_info(approval_requests)').all().some(c=>c.name==='repository_revision'))this.db.exec('ALTER TABLE approval_requests ADD COLUMN repository_revision INTEGER NOT NULL DEFAULT 0');
34
+ if(!this.db.prepare('PRAGMA table_info(approval_chat_deliveries)').all().some(c=>c.name==='semantics_version'))this.db.exec('ALTER TABLE approval_chat_deliveries ADD COLUMN semantics_version INTEGER NOT NULL DEFAULT 0');
35
+ if(!this.db.prepare('PRAGMA table_info(approval_chat_deliveries)').all().some(c=>c.name==='prompt_version'))this.db.exec('ALTER TABLE approval_chat_deliveries ADD COLUMN prompt_version TEXT');
36
+ }
37
+ request(node,a){
38
+ if(!['local','cloud'].includes(node)||!a||!Number.isInteger(a.expected_revision)||a.expected_revision<1)throw Error('INVALID_APPROVAL_REQUEST');
39
+ const event=text(a.event_id,256),task_id=text(a.task_id,128),p=proposal(a.proposal),ttl=a.ttl_seconds??3600;
40
+ if(!Number.isInteger(ttl)||ttl<60||ttl>86400)throw Error('INVALID_APPROVAL_EXPIRY');
41
+ const fp=digest({node,task_id,revision:a.expected_revision,proposal:p,ttl});
42
+ return this.store.tx(()=>{
43
+ const old=this.db.prepare('SELECT id,fingerprint FROM approval_requests WHERE event_id=?').get(event);
44
+ if(old){if(old.fingerprint!==fp)throw Error('APPROVAL_EVENT_CONFLICT');return this.view(old.id);}
45
+ const h=this.catalog.head(task_id);if(h.legacy)throw Error('LEGACY_TASK_READONLY');if(h.spec_revision!==a.expected_revision)throw Error('TASK_REVISION_CONFLICT');
46
+ if(this.store.task(task_id).blocked)throw Error('TASK_BLOCKED');
47
+ if(!this.repositories&&p.repository!==null)throw Error('REPOSITORY_BINDING_NOT_IMPLEMENTED');
48
+ const binding=this.repositories?.approvalSnapshot(task_id,p.repository)??{revision:0,snapshot:null},resolved={...p,model_policy:newCloudPolicy(p.model_policy),repository:binding.snapshot};
49
+ if(p.delivery){if(!this.delivery)throw Error('DELIVERY_CAPABILITY_REQUIRED');resolved.delivery=this.delivery.approvalSnapshot(task_id,h.spec_revision,p.delivery,binding.snapshot,resolved.model_policy);}
50
+ if(canonical(resolved).length>16000)throw Error('APPROVAL_PROPOSAL_TOO_LARGE');
51
+ const previous=this.db.prepare("SELECT proposal FROM approval_requests WHERE task_id=? AND state='changes_requested' ORDER BY created DESC,rowid DESC LIMIT 1").get(task_id);
52
+ if(previous&&canonical(JSON.parse(previous.proposal))===canonical(resolved))throw Error('APPROVAL_AMENDMENT_REQUIRED');
53
+ const id='approval-'+randomUUID(),created=this.now(),expires=created+ttl*1000,task_hash=digest(h.goal),proposal_hash=digest({task_id,spec_revision:h.spec_revision,task_hash,proposal:resolved,repository_revision:binding.revision,expires});
54
+ this.db.prepare("UPDATE approval_requests SET state='superseded' WHERE task_id=? AND state IN ('pending','approved','held','clarification_required','changes_requested')").run(task_id);
55
+ this.db.prepare("INSERT INTO approval_requests (id,event_id,fingerprint,task_id,spec_revision,task_hash,proposal,proposal_hash,state,created,expires,decision_id,repository_revision) VALUES (?,?,?,?,?,?,?,?,'pending',?,?,NULL,?)").run(id,event,fp,task_id,h.spec_revision,task_hash,canonical(resolved),proposal_hash,created,expires,binding.revision);
56
+ return this.view(id);
57
+ });
58
+ }
59
+ row(id){const r=this.db.prepare('SELECT * FROM approval_requests WHERE id=?').get(id);if(!r)throw Error('APPROVAL_NOT_FOUND');return r;}
60
+ validity(r,{ignoreInterpretation=false,ignoreTaskBlock=false}={}){
61
+ const h=this.catalog.head(r.task_id);if(r.state==='superseded'||r.state==='revoked'||r.state==='rejected'||r.state==='repository_changed'||r.state==='changes_requested')return r.state;
62
+ if(r.expires<=this.now())return 'expired';
63
+ if(h.spec_revision!==r.spec_revision||digest(h.goal)!==r.task_hash)return 'stale_revision';
64
+ if(!ignoreTaskBlock&&this.store.task(r.task_id).blocked)return 'task_blocked';
65
+ if(this.repositories&&!this.repositories.matches(r.task_id,r.repository_revision,JSON.parse(r.proposal).repository))return 'repository_changed';
66
+ const proposal=JSON.parse(r.proposal),delivery=proposal.delivery;
67
+ if(delivery&&(canonical(proposal.scopes)!==canonical([delivery.kind==='push-execution-v1'?'push':'commit'])||digest({task_id:r.task_id,spec_revision:r.spec_revision,task_hash:r.task_hash,proposal,repository_revision:r.repository_revision,expires:r.expires})!==r.proposal_hash||!this.delivery?.matches(r.task_id,r.spec_revision,delivery)))return 'delivery_changed';
68
+ if(!ignoreInterpretation&&this.db.prepare("SELECT 1 FROM approval_chat_evaluations WHERE request_id=? AND state IN ('processing','needs_review')").get(r.id))return 'confirmation_review';
69
+ if(r.state==='approved'){
70
+ const d=this.db.prepare('SELECT credential_id,challenge_id,proof_hash FROM approval_decisions WHERE id=?').get(r.decision_id);
71
+ if(d?.credential_id?.startsWith('workbench-im:')){
72
+ const exists=this.db.prepare("SELECT 1 FROM sqlite_master WHERE type='table' AND name='workbench_im_proofs'").get();
73
+ const p=exists&&this.db.prepare('SELECT binding_hash,proof_hash FROM workbench_im_proofs WHERE challenge_id=?').get(d.challenge_id),b=p&&this.db.prepare('SELECT disabled FROM approval_chat_bindings WHERE id=?').get(p.binding_hash);
74
+ if(!b||b.disabled||d.credential_id!=='workbench-im:'+p.binding_hash||d.proof_hash!==p.proof_hash)return 'identity_revoked';
75
+ }else if(d?.credential_id?.startsWith('chat:')){
76
+ const p=this.db.prepare('SELECT binding_hash,proof_hash FROM approval_chat_proofs WHERE challenge_id=?').get(d.challenge_id),b=p&&this.db.prepare('SELECT disabled FROM approval_chat_bindings WHERE id=?').get(p.binding_hash);
77
+ if(!b||b.disabled||d.credential_id!=='chat:'+p.binding_hash||d.proof_hash!==p.proof_hash)return 'identity_revoked';
78
+ }else{const c=d&&this.db.prepare('SELECT disabled FROM approval_credentials WHERE id=?').get(d.credential_id);if(!c||c.disabled)return 'identity_revoked';}
79
+ }
80
+ return r.state;
81
+ }
82
+ view(id){const r=this.row(id),revision=this.db.prepare('SELECT title,goal FROM task_revisions WHERE task_id=? AND revision=?').get(r.task_id,r.spec_revision),e=parseEnvelope(revision.goal);return {id:r.id,task_id:r.task_id,title:revision.title,spec_revision:r.spec_revision,task_sources:e?.task_context?.sources?.map(s=>s.text)??[e?.request_text??revision.goal],proposal:JSON.parse(r.proposal),proposal_hash:r.proposal_hash,recorded_state:r.state,state:this.validity(r),created:r.created,expires:r.expires,decision:r.decision_id?this.db.prepare('SELECT action,principal,created FROM approval_decisions WHERE id=?').get(r.decision_id):null,execution:deliveryExecution(JSON.parse(r.proposal))?'requires_delivery_runtime_gate':JSON.parse(r.proposal).development?'requires_runtime_gate':'disabled',repository_revision:r.repository_revision,repository_binding:JSON.parse(r.proposal).repository?'metadata_only':'unbound',feedback:this.feedback(r.id)};}
83
+ list(task_id){if(task_id)this.store.task(task_id);return this.db.prepare('SELECT id FROM approval_requests '+(task_id?'WHERE task_id=? ':'')+'ORDER BY created DESC,id LIMIT 100').all(...(task_id?[task_id]:[])).map(x=>this.view(x.id));}
84
+ feedback(id){
85
+ const current=this.db.prepare("SELECT 1 FROM sqlite_master WHERE type='table' AND name='workbench_im_proofs'").get()?this.db.prepare('SELECT p.* FROM workbench_im_proofs p JOIN approval_decisions d ON d.challenge_id=p.challenge_id JOIN approval_requests r ON r.decision_id=d.id WHERE r.id=?').get(id):null;
86
+ if(current){const i=JSON.parse(current.interpretation);return {...i,user_text:current.user_text,requires_new_proposal:i.intent==='amend',source:'workbench-existing-im'};}
87
+ const row=this.db.prepare("SELECT p.proof FROM approval_chat_proofs p JOIN approval_decisions d ON d.challenge_id=p.challenge_id WHERE d.request_id=? ORDER BY d.created DESC,d.rowid DESC LIMIT 1").get(id);
88
+ const web=this.db.prepare("SELECT 1 FROM sqlite_master WHERE type='table' AND name='approval_workbench_proofs'").get()?this.db.prepare('SELECT p.* FROM approval_workbench_proofs p JOIN approval_requests r ON r.decision_id=(SELECT id FROM approval_decisions WHERE challenge_id=p.challenge_id) WHERE r.id=?').get(id):null;
89
+ if(web){const i=JSON.parse(web.interpretation);return {...i,user_text:web.user_text,requires_new_proposal:i.intent==='amend',source:'workbench'};}
90
+ if(!row)return null;const p=JSON.parse(row.proof);return p.interpretation?{...p.interpretation,user_text:p.text,requires_new_proposal:p.interpretation.intent==='amend'}:null;
91
+ }
92
+ assertDecision(id,action,{chatEvaluation=false,workbenchEvaluation=false}={}){
93
+ const r=this.row(id);if(!['approve','reject','revoke',...((chatEvaluation||workbenchEvaluation)?['hold','amend','clarify']:[])].includes(action))throw Error('INVALID_APPROVAL_ACTION');
94
+ const state=this.validity(r,{ignoreInterpretation:chatEvaluation});
95
+ if(chatEvaluation||workbenchEvaluation){if(!['pending','approved','held','clarification_required'].includes(state))throw Error('APPROVAL_NOT_PENDING');}
96
+ else if(action==='revoke'){if(r.state!=='approved')throw Error('APPROVAL_NOT_APPROVED');}
97
+ else if(!['pending','held','clarification_required'].includes(state))throw Error('APPROVAL_NOT_PENDING');
98
+ return r;
99
+ }
100
+ // Internal ledger operation. Runtime authority currently comes from a verified IM reply.
101
+ // Historical credential/proof rows remain readable; retired ceremonies have no live entry.
102
+ recordDecision({request_id,action,principal,credential_id,proof_hash,challenge_id,chatEvaluation=false,workbenchEvaluation=false,workbenchIM=false}){
103
+ if(workbenchIM){
104
+ const p=this.db.prepare('SELECT * FROM workbench_im_proofs WHERE challenge_id=?').get(challenge_id),b=p&&this.db.prepare('SELECT disabled FROM approval_chat_bindings WHERE id=?').get(p.binding_hash);
105
+ if(!p||!b||b.disabled||credential_id!=='workbench-im:'+p.binding_hash||p.request_id!==request_id||p.credential_id!==credential_id||p.principal!==principal||p.action!==action||p.proof_hash!==proof_hash||digest(JSON.parse(p.proof))!==proof_hash)throw Error('APPROVAL_WORKBENCH_PROOF_REQUIRED');
106
+ }
107
+ if(chatEvaluation){
108
+ const proof=this.db.prepare('SELECT proof_hash FROM approval_chat_proofs WHERE challenge_id=?').get(challenge_id);
109
+ if(!credential_id?.startsWith('chat:')||proof?.proof_hash!==proof_hash)throw Error('CHAT_PROOF_REQUIRED');
110
+ }
111
+ if(workbenchEvaluation){
112
+ const p=this.db.prepare('SELECT * FROM approval_workbench_proofs WHERE challenge_id=?').get(challenge_id);
113
+ if(!p||p.request_id!==request_id||p.credential_id!==credential_id||p.principal!==principal||p.action!==action||p.proof_hash!==proof_hash)throw Error('APPROVAL_WORKBENCH_PROOF_REQUIRED');
114
+ }
115
+ const r=this.assertDecision(request_id,action,{chatEvaluation,workbenchEvaluation:workbenchEvaluation||workbenchIM}),id='decision-'+randomUUID();
116
+ this.db.prepare('INSERT INTO approval_decisions VALUES (?,?,?,?,?,?,?,?)').run(id,r.id,action,principal,credential_id,proof_hash,challenge_id,this.now());
117
+ this.db.prepare('UPDATE approval_requests SET state=?,decision_id=? WHERE id=?').run({approve:'approved',reject:'rejected',revoke:'revoked',hold:'held',amend:'changes_requested',clarify:'clarification_required'}[action],id,r.id);
118
+ this.enqueueReceipt(id);
119
+ return this.view(r.id);
120
+ }
121
+ // Part of the decision transaction. A notification is never an authorization input.
122
+ enqueueReceipt(decision_id,localWorkbenchBinding=null){
123
+ const d=this.db.prepare('SELECT * FROM approval_decisions WHERE id=?').get(decision_id);
124
+ if(!d)return;
125
+ let route=this.db.prepare("SELECT * FROM approval_chat_deliveries WHERE request_id=? AND state IN ('sent','inactive') AND message_id IS NOT NULL AND prompt_version IS NOT NULL").get(d.request_id);
126
+ // Only the live local-workbench decision transaction may create this fallback.
127
+ // Historical startup backfill never supplies a binding and cannot reroute old decisions.
128
+ if(d.credential_id?.startsWith('workbench-im:')){
129
+ const p=this.db.prepare('SELECT * FROM workbench_im_proofs WHERE challenge_id=?').get(d.challenge_id);
130
+ if(!p||p.request_id!==d.request_id||p.credential_id!==d.credential_id||p.proof_hash!==d.proof_hash)return;
131
+ if(!route&&localWorkbenchBinding===p.binding_hash)route={binding_hash:p.binding_hash};
132
+ if(route?.binding_hash!==p.binding_hash)return;
133
+ }
134
+ if(!route||this.db.prepare('SELECT disabled FROM approval_chat_bindings WHERE id=?').get(route.binding_hash)?.disabled!==0)return;
135
+ if(d.credential_id?.startsWith('chat:')){
136
+ const p=this.db.prepare('SELECT * FROM approval_chat_proofs WHERE challenge_id=?').get(d.challenge_id);
137
+ if(!p||p.binding_hash!==route.binding_hash||d.credential_id!=='chat:'+p.binding_hash||p.proof_hash!==d.proof_hash)return;
138
+ }
139
+ this.db.prepare("INSERT OR IGNORE INTO approval_receipts(decision_id,request_id,binding_hash,uuid,state,created) VALUES (?,?,?,?,'queued',?)").run(d.id,d.request_id,route.binding_hash,randomUUID(),d.created);
140
+ }
141
+ check(id,action){const r=this.row(id),p=JSON.parse(r.proposal);return {approval_valid:this.validity(r)==='approved'&&p.scopes.includes(action),executable:false,reason:deliveryExecution(p)?'DELIVERY_RUNTIME_REQUIRED':p.delivery?'DELIVERY_EXECUTION_DISABLED':'DEVELOPMENT_DISABLED',...(p.delivery?{delivery_bound:true,filesystem_checked_now:false,content_recheck_required:true}: {})};}
142
+ }
@@ -0,0 +1,86 @@
1
+ // Bounded fixed-destination platform requests. No user decision is accepted here.
2
+ // Local credentials never travel to cloud. The cloud still verifies platform objects.
3
+ import {randomUUID} from 'node:crypto';
4
+ import {canonical,digest} from './approval-ledger.js';
5
+ import {chatBinding,FeishuApprovalSource} from './approval-feishu.js';
6
+ const exact=(a,ks)=>a&&typeof a==='object'&&!Array.isArray(a)&&Object.keys(a).sort().join()===ks.slice().sort().join();
7
+ const id=x=>typeof x==='string'&&/^[a-zA-Z0-9_-]{8,128}$/.test(x);
8
+ const mid=x=>/^om_[A-Za-z0-9_-]{4,128}$/.test(x??'');
9
+ const text=x=>typeof x==='string'&&x.length>0&&Buffer.byteLength(x)<=24000;
10
+ const code=e=>/^CHAT_[A-Z0-9_]{1,80}$/.test(e?.message)?e.message:'CHAT_RELAY_PROVIDER_UNAVAILABLE';
11
+ export const localApprovalBinding=c=>chatBinding({...c,appSecretEnv:c?.appSecretEnv??'LOCAL_RELAY_NO_SECRET'});
12
+ function valid(method,a){
13
+ const fields={verify:[],get:['message_id'],list:['since'],send:['text','uuid'],reply:['message_id','text','uuid']};
14
+ if(!fields[method]||!exact(a,fields[method])||(['get','reply'].includes(method)&&!mid(a.message_id))||(['send','reply'].includes(method)&&(!text(a.text)||!id(a.uuid)))||method==='list'&&(!Number.isSafeInteger(a.since)||a.since<0))throw Error('CHAT_RELAY_ARGUMENTS');
15
+ }
16
+ function boundedResult(value){if(Buffer.byteLength(canonical(value))>90000)throw Error('CHAT_RELAY_RESULT_TOO_LARGE');return value;}
17
+ function project(m,b){
18
+ if(m?.chat_id!==b.chatId)throw Error('CHAT_RELAY_MESSAGE_SCOPE');
19
+ const fields=['message_id','chat_id','chat_type','parent_id','msg_type','deleted','updated','create_time','update_time','sender','body'];
20
+ return Object.fromEntries(fields.filter(k=>m[k]!==undefined).map(k=>[k,m[k]]));
21
+ }
22
+ export class ApprovalRelayBroker {
23
+ constructor(db,c,{now=Date.now,timeout=15000}={}){this.db=db;this.binding=localApprovalBinding(c);this.hash=digest(this.binding);this.now=now;this.timeout=timeout;this.online=0;this.closed=false;this.waiters=new Map();
24
+ db.exec("CREATE TABLE IF NOT EXISTS approval_local_relay(id TEXT PRIMARY KEY,binding_hash TEXT NOT NULL,method TEXT NOT NULL,args TEXT NOT NULL,state TEXT NOT NULL,created INTEGER NOT NULL,expires INTEGER NOT NULL,result TEXT,error TEXT)");
25
+ // Restart does not allow a queued/claimed write to execute later or be repeated.
26
+ db.prepare("UPDATE approval_local_relay SET state='needs_review',error='CHAT_RELAY_INTERRUPTED' WHERE state IN ('queued','claimed')").run();
27
+ }
28
+ assertAvailable(){if(this.closed||!this.online||this.now()-this.online>15000)throw Error('CHAT_LOCAL_IM_OFFLINE');}
29
+ snapshot(){return {host_role:'local',transport:'paired_local_platform_relay',online:!this.closed&&!!this.online&&this.now()-this.online<=15000,same_dsh_session_required:false};}
30
+ call(node,method,a){
31
+ if(node!=='local')throw Error('CHAT_RELAY_ROLE_DENIED');
32
+ if(method==='pull'){
33
+ if(this.closed)throw Error('CHAT_RELAY_CLOSED');if(!exact(a,['binding_hash'])||a.binding_hash!==this.hash)throw Error('CHAT_RELAY_BINDING_CHANGED');this.online=this.now();
34
+ this.expire();const rows=this.db.prepare("SELECT * FROM approval_local_relay WHERE binding_hash=? AND state IN ('queued','claimed') AND expires>? ORDER BY rowid LIMIT 4").all(this.hash,this.now());
35
+ for(const r of rows)this.db.prepare("UPDATE approval_local_relay SET state='claimed' WHERE id=? AND state='queued'").run(r.id);
36
+ return {binding_hash:this.hash,items:rows.map(r=>({id:r.id,method:r.method,args:JSON.parse(r.args),expires:r.expires}))};
37
+ }
38
+ if(method==='validate'){if(!exact(a,['binding_hash','id'])||a.binding_hash!==this.hash||!id(a.id))throw Error('CHAT_RELAY_ARGUMENTS');const r=this.db.prepare('SELECT * FROM approval_local_relay WHERE id=? AND binding_hash=?').get(a.id,this.hash);return {allowed:!this.closed&&r?.state==='claimed'&&r.expires>this.now()};}
39
+ if(method!=='ack'||!exact(a,['binding_hash','id','result','error'])||a.binding_hash!==this.hash||!id(a.id)||a.error!==null&&(!/^CHAT_[A-Z0-9_]{1,80}$/.test(a.error)||a.result!==null))throw Error('CHAT_RELAY_ARGUMENTS');
40
+ boundedResult(a.result);const r=this.db.prepare('SELECT * FROM approval_local_relay WHERE id=? AND binding_hash=?').get(a.id,this.hash);if(!r)throw Error('CHAT_RELAY_OPERATION_NOT_FOUND');
41
+ if(r.state==='done'){if(r.result!==canonical(a.result)||r.error!==a.error)throw Error('CHAT_RELAY_ACK_CONFLICT');return {saved:true};}
42
+ if(r.state!=='claimed'||r.expires<=this.now())return {saved:false,needs_review:true};
43
+ this.db.prepare("UPDATE approval_local_relay SET state='done',result=?,error=? WHERE id=?").run(canonical(a.result),a.error,r.id);this.waiters.get(r.id)?.();return {saved:true};
44
+ }
45
+ expire(){this.db.prepare("UPDATE approval_local_relay SET state=CASE WHEN state='queued' THEN 'cancelled' ELSE 'needs_review' END,error='CHAT_RELAY_TIMEOUT' WHERE state IN ('queued','claimed') AND expires<=?").run(this.now());}
46
+ async request(method,args){valid(method,args);this.assertAvailable();if(this.waiters.size>=4)throw Error('CHAT_RELAY_BUSY');const id=randomUUID(),created=this.now();this.db.prepare("INSERT INTO approval_local_relay(id,binding_hash,method,args,state,created,expires) VALUES (?,?,?,?,'queued',?,?)").run(id,this.hash,method,canonical(args),created,created+this.timeout);
47
+ await new Promise(resolve=>{const timer=setTimeout(resolve,this.timeout);this.waiters.set(id,()=>{clearTimeout(timer);resolve();});}).finally(()=>this.waiters.delete(id));this.expire();const r=this.db.prepare('SELECT * FROM approval_local_relay WHERE id=?').get(id);if(r.state!=='done'||r.error)throw Error(r.error??'CHAT_RELAY_RESULT_UNKNOWN');return JSON.parse(r.result);
48
+ }
49
+ source(){return {assertAvailable:()=>this.assertAvailable(),verifyBot:()=>this.request('verify',{}),get:message_id=>this.request('get',{message_id}),list:since=>this.request('list',{since}),send:(text,uuid)=>this.request('send',{text,uuid}),reply:(message_id,text,uuid)=>this.request('reply',{message_id,text,uuid})};}
50
+ close(){if(this.closed)return;this.closed=true;this.db.prepare("UPDATE approval_local_relay SET state='needs_review',error='CHAT_RELAY_CLOSED' WHERE state IN ('queued','claimed')").run();for(const done of this.waiters.values())done();}
51
+ }
52
+ export class LocalApprovalEndpoint {
53
+ constructor(g,c,io={}){this.g=g;this.db=g.db;this.binding=localApprovalBinding(c);this.hash=digest(this.binding);this.source=io.source??new FeishuApprovalSource(c,io);this.closed=false;this.running=null;this.lastError=null;
54
+ this.db.exec('CREATE TABLE IF NOT EXISTS approval_local_attempts(id TEXT PRIMARY KEY,fingerprint TEXT NOT NULL,binding_hash TEXT NOT NULL,state TEXT NOT NULL,result TEXT,error TEXT)');
55
+ this.db.prepare("UPDATE approval_local_attempts SET state='done',result='null',error='CHAT_RELAY_SEND_RESULT_UNKNOWN' WHERE state='running'").run();
56
+ }
57
+ async execute(r){valid(r.method,r.args);const fp=digest(r),old=this.db.prepare('SELECT * FROM approval_local_attempts WHERE id=?').get(r.id);
58
+ if(old){if(old.fingerprint!==fp||old.binding_hash!==this.hash)throw Error('CHAT_RELAY_OPERATION_CHANGED');return old;}
59
+ if(!id(r.id)||!Number.isSafeInteger(r.expires)||r.expires<=this.g.now())throw Error('CHAT_RELAY_EXPIRED');
60
+ this.db.prepare("INSERT INTO approval_local_attempts VALUES (?,?,?,'running',NULL,NULL)").run(r.id,fp,this.hash);
61
+ let result=null,error=null;try{
62
+ await this.source.verifyBot();if(this.closed||this.g.closed||r.expires<=this.g.now())throw Error('CHAT_RELAY_EXPIRED');
63
+ const a=r.args;
64
+ if(r.method==='verify')result=true;
65
+ if(r.method==='get')result=project(await this.source.get(a.message_id),this.binding);
66
+ if(r.method==='list'){const rows=await this.source.list(a.since);result=rows.filter(m=>m.chat_id===this.binding.chatId).map(m=>project(m,this.binding));}
67
+ if(r.method==='send'){if((await this.g.call('approval_local_validate',{binding_hash:this.hash,id:r.id})).allowed!==true||this.closed)throw Error('CHAT_RELAY_EXPIRED');result=await this.source.send(a.text,a.uuid);}
68
+ if(r.method==='reply'){project(await this.source.get(a.message_id),this.binding);if((await this.g.call('approval_local_validate',{binding_hash:this.hash,id:r.id})).allowed!==true||this.closed)throw Error('CHAT_RELAY_EXPIRED');result=await this.source.reply(a.message_id,a.text,a.uuid);}
69
+ boundedResult(result);
70
+ }catch(e){result=null;error=code(e);}
71
+ this.db.prepare("UPDATE approval_local_attempts SET state='done',result=?,error=? WHERE id=? AND state='running'").run(canonical(result),error,r.id);return this.db.prepare('SELECT * FROM approval_local_attempts WHERE id=?').get(r.id);
72
+ }
73
+ tick(){if(this.closed||this.g.closed||this.g.maintenance?.blocked)return Promise.resolve();if(this.running)return this.running;this.running=(async()=>{const leave=this.g.maintenance?.enter('local_approval_relay');try{const b=await this.g.call('approval_local_pull',{binding_hash:this.hash});if(b.binding_hash!==this.hash||!Array.isArray(b.items)||b.items.length>4)throw Error('CHAT_RELAY_BINDING_CHANGED');for(const r of b.items){if(this.closed||this.g.closed)break;const value=await this.execute(r);await this.g.call('approval_local_ack',{binding_hash:this.hash,id:r.id,result:JSON.parse(value.result),error:value.error});}this.lastError=null;}catch(e){this.lastError=code(e);}finally{leave?.();}})().finally(()=>this.running=null);return this.running;}
74
+ start(){const loop=async()=>{await this.tick();if(!this.closed)this.timer=setTimeout(loop,200);};this.loop=loop();}
75
+ async close(){this.closed=true;clearTimeout(this.timer);await this.running;}
76
+ }
77
+
78
+ // Static operator opt-in. Add the exact same private chat as an eligible result
79
+ // destination; this does not replace existing notification consent/defaults.
80
+ export function configureLocalApproval(c,targetFactory){
81
+ if(!c.localApproval)return c;if(c.chatApproval)throw Error('CHAT_MULTIPLE_APPROVAL_ROUTES');
82
+ const cfg={...c.localApproval,appSecretEnv:c.localApproval.appSecretEnv??'LOCAL_RELAY_NO_SECRET'};localApprovalBinding(cfg);
83
+ const alias=cfg.notificationAlias??'local-approval',target=targetFactory(cfg,{host:'local',alias,label:cfg.notificationLabel??'本地 IM 审批与结果'});
84
+ if((c.notificationTargets??[]).some(x=>x.host==='local'&&x.alias===alias)||(c.notificationFeishu??[]).some(x=>x.alias===alias))throw Error('CHAT_RELAY_NOTIFICATION_CONFLICT');
85
+ return {...c,notificationTargets:[...(c.notificationTargets??[]),target],notificationFeishu:[...(c.notificationFeishu??[]),...(c.role==='local'?[{...cfg,alias}]:[])]};
86
+ }