@wowok/agent-mcp 2.7.2 → 2.7.4

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 (383) hide show
  1. package/dist/config/runtime.js +1 -1
  2. package/dist/customer/account-events.d.ts +32 -0
  3. package/dist/customer/account-events.js +1 -0
  4. package/dist/customer/customer-advice.d.ts +1 -0
  5. package/dist/customer/customer-advice.js +1 -1
  6. package/dist/customer/info-puzzle.js +1 -1
  7. package/dist/customer/order-strategy.d.ts +1 -1
  8. package/dist/customer/reminder-system.d.ts +2 -0
  9. package/dist/customer/reminder-system.js +1 -1
  10. package/dist/customer/risk-assessment.d.ts +1 -0
  11. package/dist/customer/risk-assessment.js +1 -1
  12. package/dist/customer/types.d.ts +2 -0
  13. package/dist/evaluation/builtins/arbitration-score.d.ts +41 -0
  14. package/dist/evaluation/builtins/arbitration-score.js +1 -0
  15. package/dist/evaluation/builtins/index.d.ts +1 -0
  16. package/dist/evaluation/builtins/index.js +1 -1
  17. package/dist/evaluation/category-match-rules.d.ts +30 -0
  18. package/dist/evaluation/category-match-rules.js +1 -0
  19. package/dist/evaluation/engine.js +1 -1
  20. package/dist/evaluation/extract.js +1 -1
  21. package/dist/evaluation/index.d.ts +1 -0
  22. package/dist/evaluation/index.js +1 -1
  23. package/dist/evaluation/location-match.d.ts +42 -0
  24. package/dist/evaluation/location-match.js +1 -0
  25. package/dist/evaluation/path-reasoning.d.ts +35 -0
  26. package/dist/evaluation/path-reasoning.js +1 -0
  27. package/dist/evaluation/region.d.ts +6 -0
  28. package/dist/evaluation/region.js +1 -1
  29. package/dist/evaluation/types.d.ts +17 -0
  30. package/dist/experience/realtime-feedback.js +1 -1
  31. package/dist/experience/user-profile.d.ts +1 -1
  32. package/dist/extensions/index.d.ts +6 -0
  33. package/dist/extensions/index.js +1 -1
  34. package/dist/extensions/industry-layers.d.ts +75 -0
  35. package/dist/extensions/industry-layers.js +1 -0
  36. package/dist/extensions/industry-pack.d.ts +105 -0
  37. package/dist/extensions/industry-pack.js +1 -0
  38. package/dist/extensions/metric-registry.js +1 -1
  39. package/dist/extensions/mode-evaluator.d.ts +1 -1
  40. package/dist/extensions/registry.d.ts +1 -0
  41. package/dist/extensions/registry.js +1 -1
  42. package/dist/graph/base.d.ts +8 -0
  43. package/dist/graph/base.js +1 -0
  44. package/dist/harness/index.d.ts +1 -0
  45. package/dist/harness/index.js +1 -1
  46. package/dist/harness/plan.d.ts +2 -0
  47. package/dist/harness/plan.js +1 -1
  48. package/dist/harness/recover.d.ts +1 -1
  49. package/dist/harness/types.d.ts +2 -3
  50. package/dist/index.js +1 -1
  51. package/dist/knowledge/allocation-confirm.js +1 -1
  52. package/dist/knowledge/anti-cheat.d.ts +37 -0
  53. package/dist/knowledge/anti-cheat.js +1 -0
  54. package/dist/knowledge/arb-confirm.d.ts +28 -0
  55. package/dist/knowledge/arb-confirm.js +1 -0
  56. package/dist/knowledge/arb-translation.d.ts +48 -0
  57. package/dist/knowledge/arb-translation.js +1 -0
  58. package/dist/knowledge/arbitration-context.js +1 -1
  59. package/dist/knowledge/arbitration-ledger.js +1 -1
  60. package/dist/knowledge/bridge-confirm.d.ts +26 -0
  61. package/dist/knowledge/bridge-confirm.js +1 -0
  62. package/dist/knowledge/bridge-translation.d.ts +37 -0
  63. package/dist/knowledge/bridge-translation.js +1 -0
  64. package/dist/knowledge/contact-confirm.d.ts +27 -0
  65. package/dist/knowledge/contact-confirm.js +1 -0
  66. package/dist/knowledge/contact-translation.d.ts +39 -0
  67. package/dist/knowledge/contact-translation.js +1 -0
  68. package/dist/knowledge/demand-confirm.js +1 -1
  69. package/dist/knowledge/demand-context.d.ts +17 -0
  70. package/dist/knowledge/demand-context.js +1 -0
  71. package/dist/knowledge/demand-ledger.d.ts +26 -0
  72. package/dist/knowledge/demand-ledger.js +1 -0
  73. package/dist/knowledge/demand-puzzle.d.ts +29 -0
  74. package/dist/knowledge/demand-puzzle.js +1 -0
  75. package/dist/knowledge/demand-risk.js +1 -1
  76. package/dist/knowledge/demand-templates.d.ts +12 -0
  77. package/dist/knowledge/demand-templates.js +1 -0
  78. package/dist/knowledge/demand-translation.js +1 -1
  79. package/dist/knowledge/deployment-scanner.js +1 -1
  80. package/dist/knowledge/evidence-review.d.ts +12 -0
  81. package/dist/knowledge/evidence-review.js +1 -0
  82. package/dist/knowledge/examples-scanner-cli.js +1 -1
  83. package/dist/knowledge/examples-scanner.js +1 -1
  84. package/dist/knowledge/flywheel-loop.d.ts +0 -1
  85. package/dist/knowledge/flywheel-loop.js +1 -1
  86. package/dist/knowledge/guard-design-patterns.js +1 -1
  87. package/dist/knowledge/guard-migration.d.ts +1 -1
  88. package/dist/knowledge/index.d.ts +71 -3
  89. package/dist/knowledge/index.js +1 -1
  90. package/dist/knowledge/industry-registry.js +1 -1
  91. package/dist/knowledge/machine-render.js +1 -1
  92. package/dist/knowledge/market-metrics.d.ts +12 -0
  93. package/dist/knowledge/market-metrics.js +1 -0
  94. package/dist/knowledge/market-operations.d.ts +46 -0
  95. package/dist/knowledge/market-operations.js +1 -0
  96. package/dist/knowledge/mcp-schema-audit-cli.js +1 -1
  97. package/dist/knowledge/mcp-schema-audit.d.ts +22 -22
  98. package/dist/knowledge/mcp-schema-audit.js +1 -1
  99. package/dist/knowledge/onchain-constants.d.ts +2 -2
  100. package/dist/knowledge/onchain-constants.js +1 -1
  101. package/dist/knowledge/payment-confirm.d.ts +26 -0
  102. package/dist/knowledge/payment-confirm.js +1 -0
  103. package/dist/knowledge/payment-risk.js +1 -1
  104. package/dist/knowledge/payment-translation.d.ts +37 -0
  105. package/dist/knowledge/payment-translation.js +1 -0
  106. package/dist/knowledge/permission-context.d.ts +11 -0
  107. package/dist/knowledge/permission-context.js +1 -1
  108. package/dist/knowledge/permission-ledger.d.ts +11 -0
  109. package/dist/knowledge/permission-ledger.js +1 -1
  110. package/dist/knowledge/personal-confirm.d.ts +29 -0
  111. package/dist/knowledge/personal-confirm.js +1 -0
  112. package/dist/knowledge/personal-risk.js +1 -1
  113. package/dist/knowledge/personal-translation.d.ts +37 -0
  114. package/dist/knowledge/personal-translation.js +1 -0
  115. package/dist/knowledge/process-model.d.ts +1 -11
  116. package/dist/knowledge/process-model.js +1 -1
  117. package/dist/knowledge/progress-ledger.js +1 -1
  118. package/dist/knowledge/progress-risk.js +1 -1
  119. package/dist/knowledge/progress-templates.js +1 -1
  120. package/dist/knowledge/progress-translation.js +1 -1
  121. package/dist/knowledge/proof-context.d.ts +17 -0
  122. package/dist/knowledge/proof-context.js +1 -0
  123. package/dist/knowledge/proof-ledger.d.ts +34 -0
  124. package/dist/knowledge/proof-ledger.js +1 -0
  125. package/dist/knowledge/proof-puzzle.d.ts +35 -0
  126. package/dist/knowledge/proof-puzzle.js +1 -0
  127. package/dist/knowledge/proof-templates.d.ts +22 -0
  128. package/dist/knowledge/proof-templates.js +1 -0
  129. package/dist/knowledge/registrar-confirm.d.ts +26 -0
  130. package/dist/knowledge/registrar-confirm.js +1 -0
  131. package/dist/knowledge/registrar-risk.js +1 -1
  132. package/dist/knowledge/registrar-translation.d.ts +37 -0
  133. package/dist/knowledge/registrar-translation.js +1 -0
  134. package/dist/knowledge/repository-context.d.ts +12 -0
  135. package/dist/knowledge/repository-context.js +1 -0
  136. package/dist/knowledge/repository-ledger.d.ts +25 -0
  137. package/dist/knowledge/repository-ledger.js +1 -0
  138. package/dist/knowledge/repository-puzzle.d.ts +30 -0
  139. package/dist/knowledge/repository-puzzle.js +1 -0
  140. package/dist/knowledge/repository-templates.d.ts +14 -0
  141. package/dist/knowledge/repository-templates.js +1 -0
  142. package/dist/knowledge/resource-confirm.d.ts +25 -0
  143. package/dist/knowledge/resource-confirm.js +1 -0
  144. package/dist/knowledge/resource-translation.d.ts +37 -0
  145. package/dist/knowledge/resource-translation.js +1 -0
  146. package/dist/knowledge/reward-context.d.ts +2 -2
  147. package/dist/knowledge/reward-ledger.js +1 -1
  148. package/dist/knowledge/reward-translation.js +1 -1
  149. package/dist/knowledge/safety-rules.d.ts +1 -0
  150. package/dist/knowledge/safety-rules.js +1 -1
  151. package/dist/knowledge/service-risk.d.ts +1 -1
  152. package/dist/knowledge/service-risk.js +1 -1
  153. package/dist/knowledge/template-registry.js +1 -1
  154. package/dist/knowledge/tools-reference.js +1 -1
  155. package/dist/knowledge/treasury-context.d.ts +1 -1
  156. package/dist/knowledge/treasury-context.js +1 -1
  157. package/dist/knowledge/treasury-ledger.js +1 -1
  158. package/dist/knowledge/treasury-risk.js +1 -1
  159. package/dist/knowledge/universal-template.d.ts +22 -0
  160. package/dist/knowledge/universal-template.js +1 -0
  161. package/dist/knowledge/util-confirm.d.ts +24 -0
  162. package/dist/knowledge/util-confirm.js +1 -0
  163. package/dist/knowledge/util-risk.js +1 -1
  164. package/dist/knowledge/util-translation.d.ts +39 -0
  165. package/dist/knowledge/util-translation.js +1 -0
  166. package/dist/knowledge/workflow-guidance.d.ts +180 -0
  167. package/dist/knowledge/workflow-guidance.js +1 -0
  168. package/dist/participation/employee-kpi.d.ts +25 -0
  169. package/dist/participation/employee-kpi.js +1 -0
  170. package/dist/participation/employee-store.d.ts +16 -0
  171. package/dist/participation/employee-store.js +1 -0
  172. package/dist/participation/index.d.ts +2 -0
  173. package/dist/participation/index.js +1 -0
  174. package/dist/persona/defaults.js +1 -1
  175. package/dist/persona/index.d.ts +9 -2
  176. package/dist/persona/index.js +1 -1
  177. package/dist/persona/local-region.d.ts +20 -0
  178. package/dist/persona/local-region.js +1 -0
  179. package/dist/persona/model.js +1 -1
  180. package/dist/persona/overrides.d.ts +10 -0
  181. package/dist/persona/overrides.js +1 -0
  182. package/dist/persona/pack-personae.d.ts +11 -0
  183. package/dist/persona/pack-personae.js +1 -0
  184. package/dist/persona/strategy-intent.d.ts +20 -0
  185. package/dist/persona/strategy-intent.js +1 -0
  186. package/dist/persona/types.d.ts +3 -1
  187. package/dist/project/business-puzzle.d.ts +1 -1
  188. package/dist/project/business-puzzle.js +1 -1
  189. package/dist/project/deployment-doc.js +1 -1
  190. package/dist/project/edit-planner.js +1 -1
  191. package/dist/project/evaluation.d.ts +37 -1
  192. package/dist/project/evaluation.js +1 -1
  193. package/dist/project/graph-builder.d.ts +2 -2
  194. package/dist/project/graph-builder.js +1 -1
  195. package/dist/project/graph.d.ts +3 -6
  196. package/dist/project/handlers.d.ts +33 -2
  197. package/dist/project/handlers.js +1 -1
  198. package/dist/project/index.d.ts +1 -0
  199. package/dist/project/index.js +1 -1
  200. package/dist/project/merchant-guide.d.ts +19 -0
  201. package/dist/project/merchant-guide.js +1 -1
  202. package/dist/project/mode-actions.js +1 -1
  203. package/dist/project/rollback-policy.js +1 -1
  204. package/dist/project/semantic-assembler.d.ts +2 -2
  205. package/dist/project/semantic-assembler.js +1 -1
  206. package/dist/project/semantic-graph.d.ts +3 -5
  207. package/dist/project/workflow-design-assessment.d.ts +24 -0
  208. package/dist/project/workflow-design-assessment.js +1 -0
  209. package/dist/safety/confirm-gate.d.ts +1 -1
  210. package/dist/safety/confirm-gate.js +1 -1
  211. package/dist/schema/call/allocation.d.ts +186 -1385
  212. package/dist/schema/call/arbitration.d.ts +272 -1871
  213. package/dist/schema/call/base.d.ts +1831 -9076
  214. package/dist/schema/call/base.js +1 -1
  215. package/dist/schema/call/bridge.d.ts +911 -3171
  216. package/dist/schema/call/contact.d.ts +135 -931
  217. package/dist/schema/call/demand.d.ts +164 -1194
  218. package/dist/schema/call/guard.d.ts +298 -1140
  219. package/dist/schema/call/guard.js +1 -1
  220. package/dist/schema/call/machine.d.ts +459 -5403
  221. package/dist/schema/call/machine.js +1 -1
  222. package/dist/schema/call/order.d.ts +137 -844
  223. package/dist/schema/call/payment.d.ts +74 -561
  224. package/dist/schema/call/permission.d.ts +335 -2791
  225. package/dist/schema/call/personal.d.ts +227 -1814
  226. package/dist/schema/call/progress.d.ts +140 -843
  227. package/dist/schema/call/proof.d.ts +42 -258
  228. package/dist/schema/call/repository.d.ts +324 -2222
  229. package/dist/schema/call/reward.d.ts +153 -1183
  230. package/dist/schema/call/semantic.js +1 -1
  231. package/dist/schema/call/service.d.ts +376 -3431
  232. package/dist/schema/call/treasury.d.ts +252 -2158
  233. package/dist/schema/common/index.d.ts +222 -697
  234. package/dist/schema/common/index.js +1 -1
  235. package/dist/schema/config/index.d.ts +18 -161
  236. package/dist/schema/employee/index.d.ts +99 -0
  237. package/dist/schema/employee/index.js +1 -0
  238. package/dist/schema/evaluation/index.d.ts +1035 -3918
  239. package/dist/schema/evaluation/index.js +1 -1
  240. package/dist/schema/index.d.ts +5 -0
  241. package/dist/schema/index.js +1 -1
  242. package/dist/schema/industry-pack/index.d.ts +132 -0
  243. package/dist/schema/industry-pack/index.js +1 -0
  244. package/dist/schema/intent-radar/index.d.ts +92 -245
  245. package/dist/schema/intent-radar/index.js +1 -1
  246. package/dist/schema/local/index.d.ts +2045 -18080
  247. package/dist/schema/local/index.js +1 -1
  248. package/dist/schema/local/wip.d.ts +61 -651
  249. package/dist/schema/local/wip.js +1 -1
  250. package/dist/schema/messenger/index.d.ts +949 -5557
  251. package/dist/schema/messenger/index.js +1 -1
  252. package/dist/schema/operations.d.ts +3168 -26468
  253. package/dist/schema/operations.js +1 -1
  254. package/dist/schema/permission/index.d.ts +121 -0
  255. package/dist/schema/permission/index.js +1 -0
  256. package/dist/schema/persona/index.d.ts +469 -1820
  257. package/dist/schema/persona/index.js +1 -1
  258. package/dist/schema/project/index.d.ts +1023 -8450
  259. package/dist/schema/project/index.js +1 -1
  260. package/dist/schema/query/index.d.ts +12121 -75556
  261. package/dist/schema/query/index.js +1 -1
  262. package/dist/schema/schema-query/index.d.ts +35 -98
  263. package/dist/schema/schema-query/index.js +1 -1
  264. package/dist/schema/schema-version.js +1 -1
  265. package/dist/schema/task-status.d.ts +26 -132
  266. package/dist/schema/trust/index.d.ts +194 -1290
  267. package/dist/schema/utils/guard-parser.js +1 -1
  268. package/dist/schema/utils/node-parser.js +1 -1
  269. package/dist/schema/utils/skills-recommendation.d.ts +1 -0
  270. package/dist/schema/utils/skills-recommendation.js +1 -1
  271. package/dist/schema/workflow/index.d.ts +161 -0
  272. package/dist/schema/workflow/index.js +1 -0
  273. package/dist/schema/workspace/index.d.ts +69 -0
  274. package/dist/schema/workspace/index.js +1 -0
  275. package/dist/{schema-query → schema-query-impl}/index.js +1 -1
  276. package/dist/schemas/account_operation.output.json +3147 -1655
  277. package/dist/schemas/account_operation.schema.json +225 -218
  278. package/dist/schemas/bridge_operation.output.json +1168 -653
  279. package/dist/schemas/bridge_operation.schema.json +736 -504
  280. package/dist/schemas/config_operation.output.json +185 -179
  281. package/dist/schemas/config_operation.schema.json +21 -26
  282. package/dist/schemas/employee_operation.output.json +207 -0
  283. package/dist/schemas/employee_operation.schema.json +176 -0
  284. package/dist/schemas/evaluation_operation.output.json +2268 -601
  285. package/dist/schemas/evaluation_operation.schema.json +2919 -787
  286. package/dist/schemas/guard2file.output.json +58 -64
  287. package/dist/schemas/guard2file.schema.json +79 -81
  288. package/dist/schemas/index.json +41 -11
  289. package/dist/schemas/industry_pack_operation.output.json +594 -0
  290. package/dist/schemas/industry_pack_operation.schema.json +55 -0
  291. package/dist/schemas/intent_radar.output.json +275 -203
  292. package/dist/schemas/intent_radar.schema.json +124 -126
  293. package/dist/schemas/local_info_operation.output.json +1174 -660
  294. package/dist/schemas/local_info_operation.schema.json +119 -125
  295. package/dist/schemas/local_mark_operation.output.json +1239 -692
  296. package/dist/schemas/local_mark_operation.schema.json +91 -96
  297. package/dist/schemas/machineNode2file.output.json +63 -69
  298. package/dist/schemas/machineNode2file.schema.json +79 -81
  299. package/dist/schemas/messenger_operation.output.json +2722 -1531
  300. package/dist/schemas/messenger_operation.schema.json +1482 -1264
  301. package/dist/schemas/onchain_events.output.json +2590 -978
  302. package/dist/schemas/onchain_events.schema.json +117 -99
  303. package/dist/schemas/onchain_operations.output.json +3957 -2312
  304. package/dist/schemas/onchain_operations.schema.json +20799 -9285
  305. package/dist/schemas/onchain_operations_allocation.schema.json +171 -107
  306. package/dist/schemas/onchain_operations_arbitration.schema.json +233 -146
  307. package/dist/schemas/onchain_operations_contact.schema.json +129 -90
  308. package/dist/schemas/onchain_operations_demand.schema.json +170 -112
  309. package/dist/schemas/onchain_operations_gen_passport.schema.json +61 -646
  310. package/dist/schemas/onchain_operations_gen_proof.schema.json +40 -172
  311. package/dist/schemas/onchain_operations_guard.schema.json +3765 -294
  312. package/dist/schemas/onchain_operations_machine.schema.json +536 -163
  313. package/dist/schemas/onchain_operations_order.schema.json +126 -96
  314. package/dist/schemas/onchain_operations_payment.schema.json +82 -67
  315. package/dist/schemas/onchain_operations_permission.schema.json +331 -93
  316. package/dist/schemas/onchain_operations_personal.schema.json +636 -96
  317. package/dist/schemas/onchain_operations_progress.schema.json +125 -92
  318. package/dist/schemas/onchain_operations_proof.schema.json +76 -69
  319. package/dist/schemas/onchain_operations_repository.schema.json +636 -249
  320. package/dist/schemas/onchain_operations_reward.schema.json +218 -108
  321. package/dist/schemas/onchain_operations_service.schema.json +678 -220
  322. package/dist/schemas/onchain_operations_treasury.schema.json +401 -135
  323. package/dist/schemas/onchain_table_data.output.json +6833 -2432
  324. package/dist/schemas/onchain_table_data.schema.json +684 -417
  325. package/dist/schemas/permission_operation.output.json +173 -0
  326. package/dist/schemas/permission_operation.schema.json +39 -0
  327. package/dist/schemas/persona_operation.output.json +1568 -268
  328. package/dist/schemas/persona_operation.schema.json +346 -205
  329. package/dist/schemas/project_operation.output.json +6922 -5132
  330. package/dist/schemas/project_operation.schema.json +1050 -1020
  331. package/dist/schemas/query_task_status.output.json +195 -99
  332. package/dist/schemas/query_task_status.schema.json +12 -18
  333. package/dist/schemas/query_toolkit.output.json +18862 -14561
  334. package/dist/schemas/query_toolkit.schema.json +614 -522
  335. package/dist/schemas/schema_query.output.json +127 -129
  336. package/dist/schemas/schema_query.schema.json +64 -69
  337. package/dist/schemas/trust_score.output.json +678 -587
  338. package/dist/schemas/trust_score.schema.json +289 -277
  339. package/dist/schemas/wip_file.output.json +116 -124
  340. package/dist/schemas/wip_file.schema.json +142 -143
  341. package/dist/schemas/workflow_operation.output.json +164 -0
  342. package/dist/schemas/workflow_operation.schema.json +116 -0
  343. package/dist/schemas/workspace_operation.output.json +277 -0
  344. package/dist/schemas/workspace_operation.schema.json +45 -0
  345. package/dist/schemas/wowok_buildin_info.output.json +1682 -844
  346. package/dist/schemas/wowok_buildin_info.schema.json +576 -526
  347. package/dist/tools/handlers/bridge.d.ts +8 -1
  348. package/dist/tools/handlers/bridge.js +1 -1
  349. package/dist/tools/handlers/config.js +1 -1
  350. package/dist/tools/handlers/employee.d.ts +2 -0
  351. package/dist/tools/handlers/employee.js +1 -0
  352. package/dist/tools/handlers/evaluation.js +1 -1
  353. package/dist/tools/handlers/file-export.js +1 -1
  354. package/dist/tools/handlers/industry-pack.d.ts +2 -0
  355. package/dist/tools/handlers/industry-pack.js +1 -0
  356. package/dist/tools/handlers/onchain.js +1 -1
  357. package/dist/tools/handlers/permission.d.ts +2 -0
  358. package/dist/tools/handlers/permission.js +1 -0
  359. package/dist/tools/handlers/persona.js +1 -1
  360. package/dist/tools/handlers/project.js +1 -1
  361. package/dist/tools/handlers/query.js +1 -1
  362. package/dist/tools/handlers/schema-query.js +1 -1
  363. package/dist/tools/handlers/trust.js +1 -1
  364. package/dist/tools/handlers/wip.js +1 -1
  365. package/dist/tools/handlers/workflow.d.ts +2 -0
  366. package/dist/tools/handlers/workflow.js +1 -0
  367. package/dist/tools/handlers/workspace.d.ts +4 -0
  368. package/dist/tools/handlers/workspace.js +1 -0
  369. package/dist/tools/index.d.ts +2 -1
  370. package/dist/tools/index.js +1 -1
  371. package/dist/tools/rules-hook.d.ts +1 -1
  372. package/dist/tools/rules-hook.js +1 -1
  373. package/dist/tools/shared.d.ts +1 -1
  374. package/dist/tools/shared.js +1 -1
  375. package/dist/tools/types.d.ts +2 -1
  376. package/package.json +4 -5
  377. package/dist/knowledge/arbitration-trust.d.ts +0 -24
  378. package/dist/knowledge/arbitration-trust.js +0 -1
  379. package/dist/schema/call/bridge-handler.d.ts +0 -8
  380. package/dist/schema/call/bridge-handler.js +0 -1
  381. package/dist/schema/sync-layer4.d.ts +0 -21
  382. package/dist/schema/sync-layer4.js +0 -1
  383. /package/dist/{schema-query → schema-query-impl}/index.d.ts +0 -0
@@ -3,630 +3,862 @@
3
3
  "$id": "https://wowok.net/schemas/bridge_operation.json",
4
4
  "title": "Bridge - Cross-Chain Operations",
5
5
  "description": "Simplified cross-chain bridge between WOW and EVM (Ethereum mainnet). Operations: cross_chain_wow_to_evm, cross_chain_evm_to_wow, withdraw, query_active_evm_account, query_supported_evm_chains, query_supported_tokens, query_transfer_list, query_transfer_status, manage_evm_rpc. Global single activeEvmAccount auto-generated on first use. Use schema_query (name='bridge_operation') for exact field structures.",
6
- "$ref": "#/definitions/bridge_operation",
7
- "definitions": {
8
- "bridge_operation": {
9
- "anyOf": [
10
- {
6
+ "oneOf": [
7
+ {
8
+ "type": "object",
9
+ "properties": {
10
+ "operation_type": {
11
+ "type": "string",
12
+ "const": "cross_chain_wow_to_evm"
13
+ },
14
+ "data": {
11
15
  "type": "object",
12
16
  "properties": {
13
- "operation_type": {
17
+ "token": {
14
18
  "type": "string",
15
- "const": "cross_chain_wow_to_evm"
16
- },
17
- "data": {
18
- "type": "object",
19
- "properties": {
20
- "token": {
21
- "type": "string",
22
- "enum": [
23
- "ETH",
24
- "WETH",
25
- "WBTC",
26
- "USDC",
27
- "USDT"
28
- ],
29
- "description": "Cross-chain token type"
30
- },
31
- "amount": {
32
- "type": "string",
33
- "description": "Cross-chain amount (WOW-side smallest unit, wowDecimals)"
34
- },
35
- "withdrawTo": {
36
- "type": "string",
37
- "pattern": "^0x[0-9a-fA-F]{40}$",
38
- "description": "Final withdrawal EVM address; if omitted, assets remain in activeEvmAccount. When provided, the SDK uses the activeEvmAccount key to transfer to this address."
39
- },
40
- "idempotencyKey": {
41
- "type": "string",
42
- "minLength": 1,
43
- "maxLength": 128,
44
- "description": "Idempotency key to prevent duplicate deposits on retry. If a successful transfer with this key exists, returns it immediately (idempotentHit=true)."
45
- },
46
- "idempotentByParams": {
47
- "type": "boolean",
48
- "description": "If true, auto-generates an idempotency key from token+amount+withdrawTo. Use when you want implicit idempotency without managing explicit keys."
49
- }
50
- },
51
- "required": [
52
- "token",
53
- "amount"
19
+ "enum": [
20
+ "ETH",
21
+ "WETH",
22
+ "WBTC",
23
+ "USDC",
24
+ "USDT"
54
25
  ],
55
- "additionalProperties": false,
56
- "description": "WOW→EVM cross-chain (step 1: deposit only). Returns immediately with depositTxDigest + bridgeSeq + transferId. This operation only locks assets on WOW; it does NOT complete the cross-chain. After deposit, bridge nodes need ~1-5 minutes to sign. Use query_transfer_status to monitor progress; when latestState.step shows 'signatures_ready', call claim_wow_to_evm (step 2) to claim assets on EVM. [Gas requirements] Step 1 needs WOW gas; Step 2 (claim_wow_to_evm) needs activeEvmAccount to have target-chain gas."
26
+ "description": "Cross-chain token type"
57
27
  },
58
- "env": {
59
- "type": "object",
60
- "properties": {
61
- "account": {
62
- "type": "string",
63
- "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters).",
64
- "default": ""
65
- },
66
- "permission_guard": {
67
- "type": "array",
68
- "items": {
69
- "type": "string"
70
- },
71
- "description": "List of permission guard IDs. Used to extend additional operation permissions (requires verification and configuration in the Permission object)."
72
- },
73
- "no_cache": {
74
- "type": "boolean",
75
- "description": "Whether to disable caching."
76
- },
77
- "network": {
78
- "type": "string",
79
- "enum": [
80
- "localnet",
81
- "testnet",
82
- "mainnet"
83
- ],
84
- "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
85
- },
86
- "referrer": {
87
- "$ref": "#/definitions/bridge_operation/anyOf/0/properties/env/properties/account",
88
- "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded."
89
- },
90
- "confirmed": {
91
- "type": "boolean",
92
- "description": "Phase 2 ConfirmGate: set to true to proceed after a 'pending_confirmation' result. The operation is NOT executed until you re-call with confirmed=true after user consent."
93
- },
94
- "user_intent_phrases": {
95
- "type": "array",
96
- "items": {
97
- "type": "string"
98
- },
99
- "description": "Phase 2 ConfirmGate: explicit user intent phrases collected from conversation context (e.g. 'use default account', 'force publish'). Used to bypass confirmation rules whose bypass_on_explicit_intent matches."
100
- },
101
- "project": {
102
- "type": "string",
103
- "description": "Project prefix to assign this object to (e.g. 'myshop'). When set: 1) the object is tagged with 'project:<prefix>' on-chain automatically via ProjectService, 2) the newly created object is auto-associated to the SQLite project for local management, evaluation, and graph tracking. The project MUST exist (create via project_operation action='create_project' first). Use project_operation to manage projects."
104
- },
105
- "client_schema_version": {
106
- "type": "string",
107
- "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
108
- },
109
- "schema_strict_mode": {
110
- "type": "boolean",
111
- "default": false,
112
- "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
113
- },
114
- "dry_run": {
115
- "type": "boolean",
116
- "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
117
- }
118
- },
119
- "additionalProperties": false,
120
- "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
28
+ "amount": {
29
+ "type": "string",
30
+ "description": "Cross-chain amount (WOW-side smallest unit, wowDecimals)"
31
+ },
32
+ "withdrawTo": {
33
+ "description": "Final withdrawal EVM address; if omitted, assets remain in activeEvmAccount. When provided, the SDK uses the activeEvmAccount key to transfer to this address.",
34
+ "type": "string",
35
+ "pattern": "^0x[0-9a-fA-F]{40}$"
36
+ },
37
+ "idempotencyKey": {
38
+ "description": "Idempotency key to prevent duplicate deposits on retry. If a successful transfer with this key exists, returns it immediately (idempotentHit=true).",
39
+ "type": "string",
40
+ "minLength": 1,
41
+ "maxLength": 128
42
+ },
43
+ "idempotentByParams": {
44
+ "description": "If true, auto-generates an idempotency key from token+amount+withdrawTo. Use when you want implicit idempotency without managing explicit keys.",
45
+ "type": "boolean"
121
46
  }
122
47
  },
123
48
  "required": [
124
- "operation_type",
125
- "data"
49
+ "token",
50
+ "amount"
126
51
  ],
127
52
  "additionalProperties": false,
128
- "description": "WOW→EVM cross-chain (simplified): assets auto-claim to activeEvmAccount; if withdrawTo is provided, an additional transfer is made to that address. [Requires WOW mainnet env]"
53
+ "description": "WOW→EVM cross-chain (step 1: deposit only). Returns immediately with depositTxDigest + bridgeSeq + transferId. This operation only locks assets on WOW; it does NOT complete the cross-chain. After deposit, bridge nodes need ~1-5 minutes to sign. Use query_transfer_status to monitor progress; when latestState.step shows 'signatures_ready', call claim_wow_to_evm (step 2) to claim assets on EVM. [Gas requirements] Step 1 needs WOW gas; Step 2 (claim_wow_to_evm) needs activeEvmAccount to have target-chain gas."
129
54
  },
130
- {
55
+ "env": {
131
56
  "type": "object",
132
57
  "properties": {
133
- "operation_type": {
58
+ "account": {
59
+ "default": "",
134
60
  "type": "string",
135
- "const": "cross_chain_evm_to_wow"
61
+ "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
136
62
  },
137
- "data": {
138
- "type": "object",
139
- "properties": {
140
- "token": {
141
- "type": "string",
142
- "enum": [
143
- "ETH",
144
- "WETH",
145
- "WBTC",
146
- "USDC",
147
- "USDT"
148
- ],
149
- "description": "Cross-chain token type (ETH=native ETH, others are ERC20)"
150
- },
151
- "amount": {
152
- "type": "string",
153
- "description": "Cross-chain amount (EVM-side smallest unit, evmDecimals)"
154
- },
155
- "recipientWowAddress": {
156
- "type": "string",
157
- "description": "WOW recipient address or account name; defaults to env.account if omitted"
158
- },
159
- "idempotencyKey": {
160
- "$ref": "#/definitions/bridge_operation/anyOf/0/properties/data/properties/idempotencyKey",
161
- "description": "Idempotency key to prevent duplicate deposits on retry. If a successful transfer with this key exists, returns it immediately (idempotentHit=true)."
162
- },
163
- "idempotentByParams": {
164
- "type": "boolean",
165
- "description": "If true, auto-generates an idempotency key from token+amount+recipientWowAddress. Use when you want implicit idempotency without managing explicit keys."
166
- }
167
- },
168
- "required": [
169
- "token",
170
- "amount"
63
+ "permission_guard": {
64
+ "description": "List of permission guard IDs. Used to extend additional operation permissions (requires verification and configuration in the Permission object).",
65
+ "type": "array",
66
+ "items": {
67
+ "type": "string"
68
+ }
69
+ },
70
+ "no_cache": {
71
+ "description": "Whether to disable caching.",
72
+ "type": "boolean"
73
+ },
74
+ "network": {
75
+ "type": "string",
76
+ "enum": [
77
+ "localnet",
78
+ "testnet",
79
+ "mainnet"
171
80
  ],
172
- "additionalProperties": false,
173
- "description": "EVM→WOW cross-chain (single step: deposit). Returns immediately with depositTxHash + transferId. Bridge will automatically claim on WOW (no WOW gas needed, no user action required). [Time estimate] ~10-20 minutes total: (1) 64-block confirmation ~12.8 min on ETH; (2) bridge node auto-claim ~1-5 min on WOW. [Status flow] Use query_transfer_status(refresh=true) to monitor: latestState.step: source_tx_pending → source_tx_confirmed → signatures_ready → completed. When latestState.confirmations >= 64, deposit is finalized and bridge nodes will sign. [Gas requirements] Only needs activeEvmAccount to have target-chain gas (for deposit). No WOW gas needed."
81
+ "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
174
82
  },
175
- "env": {
176
- "$ref": "#/definitions/bridge_operation/anyOf/0/properties/env",
177
- "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
83
+ "referrer": {
84
+ "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded.",
85
+ "type": "string"
86
+ },
87
+ "confirmed": {
88
+ "description": "Phase 2 ConfirmGate: set to true to proceed after a 'pending_confirmation' result. The operation is NOT executed until you re-call with confirmed=true after user consent.",
89
+ "type": "boolean"
90
+ },
91
+ "user_intent_phrases": {
92
+ "description": "Phase 2 ConfirmGate: explicit user intent phrases collected from conversation context (e.g. 'use default account', 'force publish'). Used to bypass confirmation rules whose bypass_on_explicit_intent matches.",
93
+ "type": "array",
94
+ "items": {
95
+ "type": "string"
96
+ }
97
+ },
98
+ "project": {
99
+ "description": "Project prefix to assign this object to (e.g. 'myshop'). When set: 1) the object is tagged with 'project:<prefix>' on-chain automatically via ProjectService, 2) the newly created object is auto-associated to the SQLite project for local management, evaluation, and graph tracking. The project MUST exist (create via project_operation action='create_project' first). Use project_operation to manage projects.",
100
+ "type": "string"
101
+ },
102
+ "client_schema_version": {
103
+ "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched.",
104
+ "type": "string"
105
+ },
106
+ "schema_strict_mode": {
107
+ "default": false,
108
+ "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode).",
109
+ "type": "boolean"
110
+ },
111
+ "dry_run": {
112
+ "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
113
+ "type": "boolean"
178
114
  }
179
115
  },
180
116
  "required": [
181
- "operation_type",
182
- "data"
117
+ "account",
118
+ "schema_strict_mode"
183
119
  ],
184
120
  "additionalProperties": false,
185
- "description": "EVM→WOW cross-chain (single step): deposit from activeEvmAccount, bridge auto-claims on WOW. No WOW gas needed. [Requires WOW mainnet env]"
121
+ "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
122
+ }
123
+ },
124
+ "required": [
125
+ "operation_type",
126
+ "data"
127
+ ],
128
+ "additionalProperties": false,
129
+ "description": "WOW→EVM cross-chain (simplified): assets auto-claim to activeEvmAccount; if withdrawTo is provided, an additional transfer is made to that address. [Requires WOW mainnet env]"
130
+ },
131
+ {
132
+ "type": "object",
133
+ "properties": {
134
+ "operation_type": {
135
+ "type": "string",
136
+ "const": "cross_chain_evm_to_wow"
186
137
  },
187
- {
138
+ "data": {
188
139
  "type": "object",
189
140
  "properties": {
190
- "operation_type": {
141
+ "token": {
191
142
  "type": "string",
192
- "const": "claim_wow_to_evm"
193
- },
194
- "data": {
195
- "type": "object",
196
- "properties": {
197
- "transferId": {
198
- "type": "string",
199
- "description": "Transfer ID from cross_chain_wow_to_evm (br_<timestamp>_<counter>)"
200
- }
201
- },
202
- "required": [
203
- "transferId"
143
+ "enum": [
144
+ "ETH",
145
+ "WETH",
146
+ "WBTC",
147
+ "USDC",
148
+ "USDT"
204
149
  ],
205
- "additionalProperties": false,
206
- "description": "WOW→EVM claim (step 2): claim assets on EVM after bridge nodes have signed. Prerequisite: cross_chain_wow_to_evm (step 1) must be completed, and query_transfer_status must show latestState.step = 'signatures_ready' or 'source_tx_confirmed' (nodes have approved). Returns claimTxHash on success. After claim_wow_to_evm returns, the claim tx has been submitted and confirmed (1 block) on EVM. Use query_transfer_status(refresh=true) to verify latestState.step = 'completed'. [Gas requirements] Requires activeEvmAccount to have target-chain gas (for the claim transaction)."
150
+ "description": "Cross-chain token type (ETH=native ETH, others are ERC20)"
151
+ },
152
+ "amount": {
153
+ "type": "string",
154
+ "description": "Cross-chain amount (EVM-side smallest unit, evmDecimals)"
155
+ },
156
+ "recipientWowAddress": {
157
+ "description": "WOW recipient address or account name; defaults to env.account if omitted",
158
+ "type": "string"
159
+ },
160
+ "idempotencyKey": {
161
+ "description": "Idempotency key to prevent duplicate deposits on retry. If a successful transfer with this key exists, returns it immediately (idempotentHit=true).",
162
+ "type": "string",
163
+ "minLength": 1,
164
+ "maxLength": 128
207
165
  },
208
- "env": {
209
- "$ref": "#/definitions/bridge_operation/anyOf/0/properties/env",
210
- "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
166
+ "idempotentByParams": {
167
+ "description": "If true, auto-generates an idempotency key from token+amount+recipientWowAddress. Use when you want implicit idempotency without managing explicit keys.",
168
+ "type": "boolean"
211
169
  }
212
170
  },
213
171
  "required": [
214
- "operation_type",
215
- "data"
172
+ "token",
173
+ "amount"
216
174
  ],
217
175
  "additionalProperties": false,
218
- "description": "WOW→EVM claim (step 2): claim assets on EVM after bridge signed. Requires activeEvmAccount to have EVM gas. [Requires WOW mainnet env]"
176
+ "description": "EVM→WOW cross-chain (single step: deposit). Returns immediately with depositTxHash + transferId. Bridge will automatically claim on WOW (no WOW gas needed, no user action required). [Time estimate] ~10-20 minutes total: (1) 64-block confirmation ~12.8 min on ETH; (2) bridge node auto-claim ~1-5 min on WOW. [Status flow] Use query_transfer_status(refresh=true) to monitor: latestState.step: source_tx_pending → source_tx_confirmed → signatures_ready → completed. When latestState.confirmations >= 64, deposit is finalized and bridge nodes will sign. [Gas requirements] Only needs activeEvmAccount to have target-chain gas (for deposit). No WOW gas needed."
219
177
  },
220
- {
178
+ "env": {
221
179
  "type": "object",
222
180
  "properties": {
223
- "operation_type": {
181
+ "account": {
182
+ "default": "",
224
183
  "type": "string",
225
- "const": "resume_transfer"
184
+ "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
226
185
  },
227
- "data": {
228
- "type": "object",
229
- "properties": {
230
- "transferId": {
231
- "type": "string",
232
- "description": "Transfer ID to resume (br_<timestamp>_<counter>)"
233
- }
234
- },
235
- "required": [
236
- "transferId"
186
+ "permission_guard": {
187
+ "description": "List of permission guard IDs. Used to extend additional operation permissions (requires verification and configuration in the Permission object).",
188
+ "type": "array",
189
+ "items": {
190
+ "type": "string"
191
+ }
192
+ },
193
+ "no_cache": {
194
+ "description": "Whether to disable caching.",
195
+ "type": "boolean"
196
+ },
197
+ "network": {
198
+ "type": "string",
199
+ "enum": [
200
+ "localnet",
201
+ "testnet",
202
+ "mainnet"
237
203
  ],
238
- "additionalProperties": false,
239
- "description": "Resume an interrupted transfer from its current step. Use this when a transfer was interrupted (e.g. MCP restart, network error) and you want to continue from where it left off. The SDK determines the current step and attempts to advance it: - If deposit step failed: retries the deposit - If deposit is pending/confirmed: waits for bridge signatures and proceeds to claim - If claim step is ready: executes the claim - If transfer is already complete: returns the existing record (idempotentHit=true) [Returns] The updated transfer record after attempting to advance it. [Requires env] WOW env is needed for WOW-side operations; EVM-side operations use activeEvmAccount."
204
+ "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
205
+ },
206
+ "referrer": {
207
+ "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded.",
208
+ "type": "string"
209
+ },
210
+ "confirmed": {
211
+ "description": "Phase 2 ConfirmGate: set to true to proceed after a 'pending_confirmation' result. The operation is NOT executed until you re-call with confirmed=true after user consent.",
212
+ "type": "boolean"
213
+ },
214
+ "user_intent_phrases": {
215
+ "description": "Phase 2 ConfirmGate: explicit user intent phrases collected from conversation context (e.g. 'use default account', 'force publish'). Used to bypass confirmation rules whose bypass_on_explicit_intent matches.",
216
+ "type": "array",
217
+ "items": {
218
+ "type": "string"
219
+ }
220
+ },
221
+ "project": {
222
+ "description": "Project prefix to assign this object to (e.g. 'myshop'). When set: 1) the object is tagged with 'project:<prefix>' on-chain automatically via ProjectService, 2) the newly created object is auto-associated to the SQLite project for local management, evaluation, and graph tracking. The project MUST exist (create via project_operation action='create_project' first). Use project_operation to manage projects.",
223
+ "type": "string"
240
224
  },
241
- "env": {
242
- "$ref": "#/definitions/bridge_operation/anyOf/0/properties/env",
243
- "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
225
+ "client_schema_version": {
226
+ "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched.",
227
+ "type": "string"
228
+ },
229
+ "schema_strict_mode": {
230
+ "default": false,
231
+ "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode).",
232
+ "type": "boolean"
233
+ },
234
+ "dry_run": {
235
+ "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
236
+ "type": "boolean"
244
237
  }
245
238
  },
246
239
  "required": [
247
- "operation_type",
248
- "data"
240
+ "account",
241
+ "schema_strict_mode"
249
242
  ],
250
243
  "additionalProperties": false,
251
- "description": "Resume an interrupted transfer from its current step. Safe to retry. [Requires WOW mainnet env for WOW-side operations]"
244
+ "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
245
+ }
246
+ },
247
+ "required": [
248
+ "operation_type",
249
+ "data"
250
+ ],
251
+ "additionalProperties": false,
252
+ "description": "EVM→WOW cross-chain (single step): deposit from activeEvmAccount, bridge auto-claims on WOW. No WOW gas needed. [Requires WOW mainnet env]"
253
+ },
254
+ {
255
+ "type": "object",
256
+ "properties": {
257
+ "operation_type": {
258
+ "type": "string",
259
+ "const": "claim_wow_to_evm"
252
260
  },
253
- {
261
+ "data": {
254
262
  "type": "object",
255
263
  "properties": {
256
- "operation_type": {
264
+ "transferId": {
257
265
  "type": "string",
258
- "const": "withdraw"
266
+ "description": "Transfer ID from cross_chain_wow_to_evm (br_<timestamp>_<counter>)"
267
+ }
268
+ },
269
+ "required": [
270
+ "transferId"
271
+ ],
272
+ "additionalProperties": false,
273
+ "description": "WOW→EVM claim (step 2): claim assets on EVM after bridge nodes have signed. Prerequisite: cross_chain_wow_to_evm (step 1) must be completed, and query_transfer_status must show latestState.step = 'signatures_ready' or 'source_tx_confirmed' (nodes have approved). Returns claimTxHash on success. After claim_wow_to_evm returns, the claim tx has been submitted and confirmed (1 block) on EVM. Use query_transfer_status(refresh=true) to verify latestState.step = 'completed'. [Gas requirements] Requires activeEvmAccount to have target-chain gas (for the claim transaction)."
274
+ },
275
+ "env": {
276
+ "type": "object",
277
+ "properties": {
278
+ "account": {
279
+ "default": "",
280
+ "type": "string",
281
+ "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
259
282
  },
260
- "data": {
261
- "type": "object",
262
- "properties": {
263
- "to": {
264
- "type": "string",
265
- "pattern": "^0x[0-9a-fA-F]{40}$",
266
- "description": "Withdrawal target EVM address"
267
- },
268
- "amount": {
269
- "type": "string",
270
- "description": "Withdrawal amount (smallest unit)"
271
- },
272
- "token": {
273
- "type": "string",
274
- "enum": [
275
- "ETH",
276
- "WETH",
277
- "WBTC",
278
- "USDC",
279
- "USDT"
280
- ],
281
- "description": "ERC20 token identifier; if omitted or ETH, withdraws native ETH"
282
- },
283
- "tokenAddress": {
284
- "$ref": "#/definitions/bridge_operation/anyOf/0/properties/data/properties/withdrawTo",
285
- "description": "ERC20 contract address (alternative to token; allows withdrawing by contract address)"
286
- },
287
- "network": {
288
- "type": "string",
289
- "enum": [
290
- "mainnet"
291
- ],
292
- "default": "mainnet",
293
- "description": "Target chain (defaults to Ethereum mainnet when omitted — EvmChainSchema carries .default(\"mainnet\"))"
294
- }
295
- },
296
- "required": [
297
- "to",
298
- "amount"
283
+ "permission_guard": {
284
+ "description": "List of permission guard IDs. Used to extend additional operation permissions (requires verification and configuration in the Permission object).",
285
+ "type": "array",
286
+ "items": {
287
+ "type": "string"
288
+ }
289
+ },
290
+ "no_cache": {
291
+ "description": "Whether to disable caching.",
292
+ "type": "boolean"
293
+ },
294
+ "network": {
295
+ "type": "string",
296
+ "enum": [
297
+ "localnet",
298
+ "testnet",
299
+ "mainnet"
299
300
  ],
300
- "additionalProperties": false,
301
- "description": "Withdraw from activeEvmAccount to another EVM address"
301
+ "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
302
+ },
303
+ "referrer": {
304
+ "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded.",
305
+ "type": "string"
306
+ },
307
+ "confirmed": {
308
+ "description": "Phase 2 ConfirmGate: set to true to proceed after a 'pending_confirmation' result. The operation is NOT executed until you re-call with confirmed=true after user consent.",
309
+ "type": "boolean"
310
+ },
311
+ "user_intent_phrases": {
312
+ "description": "Phase 2 ConfirmGate: explicit user intent phrases collected from conversation context (e.g. 'use default account', 'force publish'). Used to bypass confirmation rules whose bypass_on_explicit_intent matches.",
313
+ "type": "array",
314
+ "items": {
315
+ "type": "string"
316
+ }
317
+ },
318
+ "project": {
319
+ "description": "Project prefix to assign this object to (e.g. 'myshop'). When set: 1) the object is tagged with 'project:<prefix>' on-chain automatically via ProjectService, 2) the newly created object is auto-associated to the SQLite project for local management, evaluation, and graph tracking. The project MUST exist (create via project_operation action='create_project' first). Use project_operation to manage projects.",
320
+ "type": "string"
321
+ },
322
+ "client_schema_version": {
323
+ "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched.",
324
+ "type": "string"
325
+ },
326
+ "schema_strict_mode": {
327
+ "default": false,
328
+ "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode).",
329
+ "type": "boolean"
330
+ },
331
+ "dry_run": {
332
+ "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
333
+ "type": "boolean"
302
334
  }
303
335
  },
304
336
  "required": [
305
- "operation_type",
306
- "data"
337
+ "account",
338
+ "schema_strict_mode"
307
339
  ],
308
340
  "additionalProperties": false,
309
- "description": "Withdraw from activeEvmAccount to another EVM address (non-cross-chain). [No env needed]"
341
+ "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
342
+ }
343
+ },
344
+ "required": [
345
+ "operation_type",
346
+ "data"
347
+ ],
348
+ "additionalProperties": false,
349
+ "description": "WOW→EVM claim (step 2): claim assets on EVM after bridge signed. Requires activeEvmAccount to have EVM gas. [Requires WOW mainnet env]"
350
+ },
351
+ {
352
+ "type": "object",
353
+ "properties": {
354
+ "operation_type": {
355
+ "type": "string",
356
+ "const": "resume_transfer"
310
357
  },
311
- {
358
+ "data": {
312
359
  "type": "object",
313
360
  "properties": {
314
- "operation_type": {
361
+ "transferId": {
315
362
  "type": "string",
316
- "const": "query_active_evm_account"
317
- },
318
- "data": {
319
- "type": "object",
320
- "properties": {
321
- "network": {
322
- "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/network",
323
- "default": "mainnet",
324
- "description": "Specific chain; if omitted, queries all supported chains"
325
- },
326
- "tokens": {
327
- "type": "array",
328
- "items": {
329
- "$ref": "#/definitions/bridge_operation/anyOf/0/properties/data/properties/withdrawTo"
330
- },
331
- "description": "Additional ERC20 token contract addresses to query; if omitted, only native ETH balance is queried"
332
- }
333
- },
334
- "additionalProperties": false,
335
- "description": "Query activeEvmAccount parameters"
363
+ "description": "Transfer ID to resume (br_<timestamp>_<counter>)"
336
364
  }
337
365
  },
338
366
  "required": [
339
- "operation_type"
367
+ "transferId"
340
368
  ],
341
369
  "additionalProperties": false,
342
- "description": "Query activeEvmAccount address + balances (per chain or all chains). [No env needed]"
370
+ "description": "Resume an interrupted transfer from its current step. Use this when a transfer was interrupted (e.g. MCP restart, network error) and you want to continue from where it left off. The SDK determines the current step and attempts to advance it: - If deposit step failed: retries the deposit - If deposit is pending/confirmed: waits for bridge signatures and proceeds to claim - If claim step is ready: executes the claim - If transfer is already complete: returns the existing record (idempotentHit=true) [Returns] The updated transfer record after attempting to advance it. [Requires env] WOW env is needed for WOW-side operations; EVM-side operations use activeEvmAccount."
343
371
  },
344
- {
372
+ "env": {
345
373
  "type": "object",
346
374
  "properties": {
347
- "operation_type": {
375
+ "account": {
376
+ "default": "",
377
+ "type": "string",
378
+ "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
379
+ },
380
+ "permission_guard": {
381
+ "description": "List of permission guard IDs. Used to extend additional operation permissions (requires verification and configuration in the Permission object).",
382
+ "type": "array",
383
+ "items": {
384
+ "type": "string"
385
+ }
386
+ },
387
+ "no_cache": {
388
+ "description": "Whether to disable caching.",
389
+ "type": "boolean"
390
+ },
391
+ "network": {
348
392
  "type": "string",
349
- "const": "query_supported_evm_chains"
393
+ "enum": [
394
+ "localnet",
395
+ "testnet",
396
+ "mainnet"
397
+ ],
398
+ "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
399
+ },
400
+ "referrer": {
401
+ "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded.",
402
+ "type": "string"
403
+ },
404
+ "confirmed": {
405
+ "description": "Phase 2 ConfirmGate: set to true to proceed after a 'pending_confirmation' result. The operation is NOT executed until you re-call with confirmed=true after user consent.",
406
+ "type": "boolean"
407
+ },
408
+ "user_intent_phrases": {
409
+ "description": "Phase 2 ConfirmGate: explicit user intent phrases collected from conversation context (e.g. 'use default account', 'force publish'). Used to bypass confirmation rules whose bypass_on_explicit_intent matches.",
410
+ "type": "array",
411
+ "items": {
412
+ "type": "string"
413
+ }
414
+ },
415
+ "project": {
416
+ "description": "Project prefix to assign this object to (e.g. 'myshop'). When set: 1) the object is tagged with 'project:<prefix>' on-chain automatically via ProjectService, 2) the newly created object is auto-associated to the SQLite project for local management, evaluation, and graph tracking. The project MUST exist (create via project_operation action='create_project' first). Use project_operation to manage projects.",
417
+ "type": "string"
418
+ },
419
+ "client_schema_version": {
420
+ "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched.",
421
+ "type": "string"
422
+ },
423
+ "schema_strict_mode": {
424
+ "default": false,
425
+ "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode).",
426
+ "type": "boolean"
427
+ },
428
+ "dry_run": {
429
+ "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
430
+ "type": "boolean"
350
431
  }
351
432
  },
352
433
  "required": [
353
- "operation_type"
434
+ "account",
435
+ "schema_strict_mode"
354
436
  ],
355
437
  "additionalProperties": false,
356
- "description": "List currently supported EVM chains (enum value / description / chainId / RPC health). [No env needed, no data required]"
438
+ "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
439
+ }
440
+ },
441
+ "required": [
442
+ "operation_type",
443
+ "data"
444
+ ],
445
+ "additionalProperties": false,
446
+ "description": "Resume an interrupted transfer from its current step. Safe to retry. [Requires WOW mainnet env for WOW-side operations]"
447
+ },
448
+ {
449
+ "type": "object",
450
+ "properties": {
451
+ "operation_type": {
452
+ "type": "string",
453
+ "const": "withdraw"
357
454
  },
358
- {
455
+ "data": {
359
456
  "type": "object",
360
457
  "properties": {
361
- "operation_type": {
458
+ "to": {
362
459
  "type": "string",
363
- "const": "query_supported_tokens"
460
+ "pattern": "^0x[0-9a-fA-F]{40}$",
461
+ "description": "Withdrawal target EVM address"
364
462
  },
365
- "data": {
366
- "type": "object",
367
- "properties": {
368
- "network": {
369
- "$ref": "#/definitions/bridge_operation/anyOf/5/properties/data/properties/network",
370
- "description": "Specific chain; if omitted, returns token lists for all supported chains"
371
- }
372
- },
373
- "additionalProperties": false,
374
- "description": "Query supported Bridge tokens per chain (WOW/EVM addresses, decimals, description)"
463
+ "amount": {
464
+ "type": "string",
465
+ "description": "Withdrawal amount (smallest unit)"
466
+ },
467
+ "token": {
468
+ "description": "ERC20 token identifier; if omitted or ETH, withdraws native ETH",
469
+ "type": "string",
470
+ "enum": [
471
+ "ETH",
472
+ "WETH",
473
+ "WBTC",
474
+ "USDC",
475
+ "USDT"
476
+ ]
477
+ },
478
+ "tokenAddress": {
479
+ "description": "ERC20 contract address (alternative to token; allows withdrawing by contract address)",
480
+ "type": "string",
481
+ "pattern": "^0x[0-9a-fA-F]{40}$"
482
+ },
483
+ "network": {
484
+ "default": "mainnet",
485
+ "description": "Target chain (defaults to Ethereum mainnet when omitted — EvmChainSchema carries .default(\"mainnet\"))",
486
+ "type": "string",
487
+ "enum": [
488
+ "mainnet"
489
+ ]
375
490
  }
376
491
  },
377
492
  "required": [
378
- "operation_type"
493
+ "to",
494
+ "amount",
495
+ "network"
379
496
  ],
380
497
  "additionalProperties": false,
381
- "description": "List supported Bridge tokens per chain (WOW/EVM contract addresses, decimals, description). [No env needed]"
498
+ "description": "Withdraw from activeEvmAccount to another EVM address"
499
+ }
500
+ },
501
+ "required": [
502
+ "operation_type",
503
+ "data"
504
+ ],
505
+ "additionalProperties": false,
506
+ "description": "Withdraw from activeEvmAccount to another EVM address (non-cross-chain). [No env needed]"
507
+ },
508
+ {
509
+ "type": "object",
510
+ "properties": {
511
+ "operation_type": {
512
+ "type": "string",
513
+ "const": "query_active_evm_account"
382
514
  },
383
- {
515
+ "data": {
384
516
  "type": "object",
385
517
  "properties": {
386
- "operation_type": {
518
+ "network": {
519
+ "description": "Specific chain; if omitted, queries all supported chains",
520
+ "default": "mainnet",
387
521
  "type": "string",
388
- "const": "query_transfer_list"
522
+ "enum": [
523
+ "mainnet"
524
+ ]
389
525
  },
390
- "data": {
526
+ "tokens": {
527
+ "description": "Additional ERC20 token contract addresses to query; if omitted, only native ETH balance is queried",
528
+ "type": "array",
529
+ "items": {
530
+ "type": "string",
531
+ "pattern": "^0x[0-9a-fA-F]{40}$",
532
+ "description": "EVM address (0x + 40 hex)"
533
+ }
534
+ }
535
+ },
536
+ "additionalProperties": false,
537
+ "description": "Query activeEvmAccount parameters"
538
+ }
539
+ },
540
+ "required": [
541
+ "operation_type"
542
+ ],
543
+ "additionalProperties": false,
544
+ "description": "Query activeEvmAccount address + balances (per chain or all chains). [No env needed]"
545
+ },
546
+ {
547
+ "type": "object",
548
+ "properties": {
549
+ "operation_type": {
550
+ "type": "string",
551
+ "const": "query_supported_evm_chains"
552
+ }
553
+ },
554
+ "required": [
555
+ "operation_type"
556
+ ],
557
+ "additionalProperties": false,
558
+ "description": "List currently supported EVM chains (enum value / description / chainId / RPC health). [No env needed, no data required]"
559
+ },
560
+ {
561
+ "type": "object",
562
+ "properties": {
563
+ "operation_type": {
564
+ "type": "string",
565
+ "const": "query_supported_tokens"
566
+ },
567
+ "data": {
568
+ "type": "object",
569
+ "properties": {
570
+ "network": {
571
+ "description": "Specific chain; if omitted, returns token lists for all supported chains",
572
+ "default": "mainnet",
573
+ "type": "string",
574
+ "enum": [
575
+ "mainnet"
576
+ ]
577
+ }
578
+ },
579
+ "additionalProperties": false,
580
+ "description": "Query supported Bridge tokens per chain (WOW/EVM addresses, decimals, description)"
581
+ }
582
+ },
583
+ "required": [
584
+ "operation_type"
585
+ ],
586
+ "additionalProperties": false,
587
+ "description": "List supported Bridge tokens per chain (WOW/EVM contract addresses, decimals, description). [No env needed]"
588
+ },
589
+ {
590
+ "type": "object",
591
+ "properties": {
592
+ "operation_type": {
593
+ "type": "string",
594
+ "const": "query_transfer_list"
595
+ },
596
+ "data": {
597
+ "type": "object",
598
+ "properties": {
599
+ "onlyActive": {
600
+ "description": "true returns only in-progress transfers; false/omitted returns all",
601
+ "type": "boolean"
602
+ },
603
+ "status": {
604
+ "description": "Filter by transfer status",
605
+ "type": "string",
606
+ "enum": [
607
+ "pending",
608
+ "in_progress",
609
+ "success",
610
+ "failed"
611
+ ]
612
+ },
613
+ "direction": {
614
+ "description": "Filter by transfer direction",
615
+ "type": "string",
616
+ "enum": [
617
+ "wow_to_evm",
618
+ "evm_to_wow",
619
+ "withdraw"
620
+ ]
621
+ },
622
+ "token": {
623
+ "description": "Filter by token type (ETH/WETH/WBTC/USDC/USDT)",
624
+ "type": "string",
625
+ "enum": [
626
+ "ETH",
627
+ "WETH",
628
+ "WBTC",
629
+ "USDC",
630
+ "USDT"
631
+ ]
632
+ },
633
+ "limit": {
634
+ "description": "Maximum number of results (default: all, max: 100)",
635
+ "type": "integer",
636
+ "exclusiveMinimum": 0,
637
+ "maximum": 100
638
+ }
639
+ },
640
+ "additionalProperties": false,
641
+ "description": "Query transfer list with optional filters (status / direction / token / limit)"
642
+ }
643
+ },
644
+ "required": [
645
+ "operation_type"
646
+ ],
647
+ "additionalProperties": false,
648
+ "description": "Query cross-chain / withdrawal transfer history list (optionally only in-progress). [No env needed]"
649
+ },
650
+ {
651
+ "type": "object",
652
+ "properties": {
653
+ "operation_type": {
654
+ "type": "string",
655
+ "const": "query_transfer_status"
656
+ },
657
+ "data": {
658
+ "type": "object",
659
+ "properties": {
660
+ "transferId": {
661
+ "type": "string",
662
+ "description": "Transfer ID (br_<timestamp>_<counter>)"
663
+ },
664
+ "refresh": {
665
+ "default": true,
666
+ "description": "Whether to refresh from on-chain state (default true). true=queries latest on-chain status (takes 5-15s, timeout at 15s on slow RPC). false=instant response from local cache (no on-chain query). Recommended: use refresh=true every 1-2 minutes for ongoing transfers; use refresh=false for quick checks between refreshes.",
667
+ "type": "boolean"
668
+ }
669
+ },
670
+ "required": [
671
+ "transferId",
672
+ "refresh"
673
+ ],
674
+ "additionalProperties": false,
675
+ "description": "Query single transfer parameters. [Wait hint] With refresh=true (default), this call may take 5-15 seconds to query on-chain state. If on-chain RPC is slow, it will timeout at 15s and return cached state. Set refresh=false for instant response from local cache. [Returned fields] The result includes: (1) record.step/status - high-level lifecycle (deposit/claimed/success); (2) record.latestState.step/status - fine-grained on-chain progress (source_tx_pending → source_tx_confirmed → signatures_ready → completed). Use latestState.confirmations to estimate remaining time (needs 64 for ETH→WOW finalization)."
676
+ }
677
+ },
678
+ "required": [
679
+ "operation_type",
680
+ "data"
681
+ ],
682
+ "additionalProperties": false,
683
+ "description": "Query a single transfer's detail by transferId"
684
+ },
685
+ {
686
+ "type": "object",
687
+ "properties": {
688
+ "operation_type": {
689
+ "type": "string",
690
+ "const": "manage_evm_rpc"
691
+ },
692
+ "data": {
693
+ "oneOf": [
694
+ {
391
695
  "type": "object",
392
696
  "properties": {
393
- "onlyActive": {
394
- "type": "boolean",
395
- "description": "true returns only in-progress transfers; false/omitted returns all"
697
+ "op": {
698
+ "type": "string",
699
+ "const": "list",
700
+ "description": "List all configured RPC endpoints with health status"
396
701
  },
397
- "status": {
702
+ "network": {
703
+ "default": "mainnet",
704
+ "description": "Target chain (defaults to Ethereum mainnet when omitted — EvmChainSchema carries .default(\"mainnet\"))",
398
705
  "type": "string",
399
706
  "enum": [
400
- "pending",
401
- "in_progress",
402
- "success",
403
- "failed"
404
- ],
405
- "description": "Filter by transfer status"
707
+ "mainnet"
708
+ ]
709
+ }
710
+ },
711
+ "required": [
712
+ "op",
713
+ "network"
714
+ ],
715
+ "additionalProperties": false,
716
+ "description": "List RPC endpoints (no rpcUrl/rpcUrls needed)"
717
+ },
718
+ {
719
+ "type": "object",
720
+ "properties": {
721
+ "op": {
722
+ "type": "string",
723
+ "const": "add",
724
+ "description": "Append one or more RPC endpoints"
406
725
  },
407
- "direction": {
726
+ "network": {
727
+ "default": "mainnet",
728
+ "description": "Target chain (defaults to Ethereum mainnet when omitted — EvmChainSchema carries .default(\"mainnet\"))",
408
729
  "type": "string",
409
730
  "enum": [
410
- "wow_to_evm",
411
- "evm_to_wow",
412
- "withdraw"
413
- ],
414
- "description": "Filter by transfer direction"
415
- },
416
- "token": {
417
- "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/token",
418
- "description": "Filter by token type (ETH/WETH/WBTC/USDC/USDT)"
731
+ "mainnet"
732
+ ]
419
733
  },
420
- "limit": {
421
- "type": "integer",
422
- "exclusiveMinimum": 0,
423
- "maximum": 100,
424
- "description": "Maximum number of results (default: all, max: 100)"
734
+ "rpcUrls": {
735
+ "minItems": 1,
736
+ "type": "array",
737
+ "items": {
738
+ "type": "string",
739
+ "format": "uri"
740
+ },
741
+ "description": "RPC URL(s) to add"
425
742
  }
426
743
  },
744
+ "required": [
745
+ "op",
746
+ "network",
747
+ "rpcUrls"
748
+ ],
427
749
  "additionalProperties": false,
428
- "description": "Query transfer list with optional filters (status / direction / token / limit)"
429
- }
430
- },
431
- "required": [
432
- "operation_type"
433
- ],
434
- "additionalProperties": false,
435
- "description": "Query cross-chain / withdrawal transfer history list (optionally only in-progress). [No env needed]"
436
- },
437
- {
438
- "type": "object",
439
- "properties": {
440
- "operation_type": {
441
- "type": "string",
442
- "const": "query_transfer_status"
750
+ "description": "Add RPC endpoint(s)"
443
751
  },
444
- "data": {
752
+ {
445
753
  "type": "object",
446
754
  "properties": {
447
- "transferId": {
755
+ "op": {
756
+ "type": "string",
757
+ "const": "remove",
758
+ "description": "Remove one or more RPC endpoints"
759
+ },
760
+ "network": {
761
+ "default": "mainnet",
762
+ "description": "Target chain (defaults to Ethereum mainnet when omitted — EvmChainSchema carries .default(\"mainnet\"))",
448
763
  "type": "string",
449
- "description": "Transfer ID (br_<timestamp>_<counter>)"
764
+ "enum": [
765
+ "mainnet"
766
+ ]
450
767
  },
451
- "refresh": {
452
- "type": "boolean",
453
- "default": true,
454
- "description": "Whether to refresh from on-chain state (default true). true=queries latest on-chain status (takes 5-15s, timeout at 15s on slow RPC). false=instant response from local cache (no on-chain query). Recommended: use refresh=true every 1-2 minutes for ongoing transfers; use refresh=false for quick checks between refreshes."
768
+ "rpcUrls": {
769
+ "minItems": 1,
770
+ "type": "array",
771
+ "items": {
772
+ "type": "string",
773
+ "format": "uri"
774
+ },
775
+ "description": "RPC URL(s) to remove"
455
776
  }
456
777
  },
457
778
  "required": [
458
- "transferId"
779
+ "op",
780
+ "network",
781
+ "rpcUrls"
459
782
  ],
460
783
  "additionalProperties": false,
461
- "description": "Query single transfer parameters. [Wait hint] With refresh=true (default), this call may take 5-15 seconds to query on-chain state. If on-chain RPC is slow, it will timeout at 15s and return cached state. Set refresh=false for instant response from local cache. [Returned fields] The result includes: (1) record.step/status - high-level lifecycle (deposit/claimed/success); (2) record.latestState.step/status - fine-grained on-chain progress (source_tx_pending → source_tx_confirmed → signatures_ready → completed). Use latestState.confirmations to estimate remaining time (needs 64 for ETH→WOW finalization)."
462
- }
463
- },
464
- "required": [
465
- "operation_type",
466
- "data"
467
- ],
468
- "additionalProperties": false,
469
- "description": "Query a single transfer's detail by transferId"
470
- },
471
- {
472
- "type": "object",
473
- "properties": {
474
- "operation_type": {
475
- "type": "string",
476
- "const": "manage_evm_rpc"
477
- },
478
- "data": {
479
- "anyOf": [
480
- {
481
- "type": "object",
482
- "properties": {
483
- "op": {
484
- "type": "string",
485
- "const": "list",
486
- "description": "List all configured RPC endpoints with health status"
487
- },
488
- "network": {
489
- "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/network",
490
- "default": "mainnet",
491
- "description": "Target chain (defaults to Ethereum mainnet when omitted — EvmChainSchema carries .default(\"mainnet\"))"
492
- }
493
- },
494
- "required": [
495
- "op"
496
- ],
497
- "additionalProperties": false,
498
- "description": "List RPC endpoints (no rpcUrl/rpcUrls needed)"
784
+ "description": "Remove RPC endpoint(s)"
785
+ },
786
+ {
787
+ "type": "object",
788
+ "properties": {
789
+ "op": {
790
+ "type": "string",
791
+ "const": "set",
792
+ "description": "Full replace all RPC endpoints"
499
793
  },
500
- {
501
- "type": "object",
502
- "properties": {
503
- "op": {
504
- "type": "string",
505
- "const": "add",
506
- "description": "Append one or more RPC endpoints"
507
- },
508
- "network": {
509
- "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/network",
510
- "default": "mainnet",
511
- "description": "Target chain (defaults to Ethereum mainnet when omitted — EvmChainSchema carries .default(\"mainnet\"))"
512
- },
513
- "rpcUrls": {
514
- "type": "array",
515
- "items": {
516
- "type": "string",
517
- "format": "uri"
518
- },
519
- "minItems": 1,
520
- "description": "RPC URL(s) to add"
521
- }
522
- },
523
- "required": [
524
- "op",
525
- "rpcUrls"
526
- ],
527
- "additionalProperties": false,
528
- "description": "Add RPC endpoint(s)"
794
+ "network": {
795
+ "default": "mainnet",
796
+ "description": "Target chain (defaults to Ethereum mainnet when omitted — EvmChainSchema carries .default(\"mainnet\"))",
797
+ "type": "string",
798
+ "enum": [
799
+ "mainnet"
800
+ ]
529
801
  },
530
- {
531
- "type": "object",
532
- "properties": {
533
- "op": {
534
- "type": "string",
535
- "const": "remove",
536
- "description": "Remove one or more RPC endpoints"
537
- },
538
- "network": {
539
- "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/network",
540
- "default": "mainnet",
541
- "description": "Target chain (defaults to Ethereum mainnet when omitted — EvmChainSchema carries .default(\"mainnet\"))"
542
- },
543
- "rpcUrls": {
544
- "type": "array",
545
- "items": {
546
- "type": "string",
547
- "format": "uri"
548
- },
549
- "minItems": 1,
550
- "description": "RPC URL(s) to remove"
551
- }
802
+ "rpcUrls": {
803
+ "minItems": 1,
804
+ "type": "array",
805
+ "items": {
806
+ "type": "string",
807
+ "format": "uri"
552
808
  },
553
- "required": [
554
- "op",
555
- "rpcUrls"
556
- ],
557
- "additionalProperties": false,
558
- "description": "Remove RPC endpoint(s)"
809
+ "description": "Full RPC list (replaces all existing endpoints)"
810
+ }
811
+ },
812
+ "required": [
813
+ "op",
814
+ "network",
815
+ "rpcUrls"
816
+ ],
817
+ "additionalProperties": false,
818
+ "description": "Full replace RPC endpoints"
819
+ },
820
+ {
821
+ "type": "object",
822
+ "properties": {
823
+ "op": {
824
+ "type": "string",
825
+ "const": "ping",
826
+ "description": "Health check one or more RPC endpoints"
559
827
  },
560
- {
561
- "type": "object",
562
- "properties": {
563
- "op": {
564
- "type": "string",
565
- "const": "set",
566
- "description": "Full replace all RPC endpoints"
567
- },
568
- "network": {
569
- "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/network",
570
- "default": "mainnet",
571
- "description": "Target chain (defaults to Ethereum mainnet when omitted — EvmChainSchema carries .default(\"mainnet\"))"
572
- },
573
- "rpcUrls": {
574
- "type": "array",
575
- "items": {
576
- "type": "string",
577
- "format": "uri"
578
- },
579
- "minItems": 1,
580
- "description": "Full RPC list (replaces all existing endpoints)"
581
- }
582
- },
583
- "required": [
584
- "op",
585
- "rpcUrls"
586
- ],
587
- "additionalProperties": false,
588
- "description": "Full replace RPC endpoints"
828
+ "network": {
829
+ "default": "mainnet",
830
+ "description": "Target chain (defaults to Ethereum mainnet when omitted — EvmChainSchema carries .default(\"mainnet\"))",
831
+ "type": "string",
832
+ "enum": [
833
+ "mainnet"
834
+ ]
589
835
  },
590
- {
591
- "type": "object",
592
- "properties": {
593
- "op": {
594
- "type": "string",
595
- "const": "ping",
596
- "description": "Health check one or more RPC endpoints"
597
- },
598
- "network": {
599
- "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/network",
600
- "default": "mainnet",
601
- "description": "Target chain (defaults to Ethereum mainnet when omitted — EvmChainSchema carries .default(\"mainnet\"))"
602
- },
603
- "rpcUrls": {
604
- "type": "array",
605
- "items": {
606
- "type": "string",
607
- "format": "uri"
608
- },
609
- "description": "Specific RPC URLs to ping; if omitted, pings all configured RPCs"
610
- }
611
- },
612
- "required": [
613
- "op"
614
- ],
615
- "additionalProperties": false,
616
- "description": "Health check RPC endpoints"
836
+ "rpcUrls": {
837
+ "description": "Specific RPC URLs to ping; if omitted, pings all configured RPCs",
838
+ "type": "array",
839
+ "items": {
840
+ "type": "string",
841
+ "format": "uri"
842
+ }
617
843
  }
844
+ },
845
+ "required": [
846
+ "op",
847
+ "network"
618
848
  ],
619
- "description": "EVM RPC endpoint management (discriminated by op)"
849
+ "additionalProperties": false,
850
+ "description": "Health check RPC endpoints"
620
851
  }
621
- },
622
- "required": [
623
- "operation_type",
624
- "data"
625
852
  ],
626
- "additionalProperties": false,
627
- "description": "Manage EVM RPC endpoints (list/add/remove/set/ping) to mitigate public RPC 429 rate limits. [No env needed]"
853
+ "description": "EVM RPC endpoint management (discriminated by op)"
628
854
  }
629
- ]
855
+ },
856
+ "required": [
857
+ "operation_type",
858
+ "data"
859
+ ],
860
+ "additionalProperties": false,
861
+ "description": "Manage EVM RPC endpoints (list/add/remove/set/ping) to mitigate public RPC 429 rate limits. [No env needed]"
630
862
  }
631
- }
863
+ ]
632
864
  }