@wowok/agent-mcp 2.7.0 → 2.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (427) hide show
  1. package/dist/config/index.js +1 -1
  2. package/dist/config/runtime.js +1 -238
  3. package/dist/customer/customer-advice.js +1 -130
  4. package/dist/customer/index.js +1 -11
  5. package/dist/customer/industry-risks.js +1 -438
  6. package/dist/customer/info-puzzle.js +1 -681
  7. package/dist/customer/order-monitor.js +1 -328
  8. package/dist/customer/order-strategy.js +1 -373
  9. package/dist/customer/post-purchase.js +1 -351
  10. package/dist/customer/preorder-compare.js +1 -34
  11. package/dist/customer/reminder-system.js +1 -316
  12. package/dist/customer/risk-assessment.d.ts +5 -1
  13. package/dist/customer/risk-assessment.js +1 -397
  14. package/dist/customer/types.js +1 -13
  15. package/dist/customer/user-preferences.js +1 -460
  16. package/dist/evaluation/arbitration-game.d.ts +23 -0
  17. package/dist/evaluation/arbitration-game.js +1 -0
  18. package/dist/evaluation/builtins/demand-match.d.ts +15 -0
  19. package/dist/evaluation/builtins/demand-match.js +1 -0
  20. package/dist/evaluation/builtins/index.d.ts +3 -0
  21. package/dist/evaluation/builtins/index.js +1 -0
  22. package/dist/evaluation/builtins/service-risk.d.ts +6 -0
  23. package/dist/evaluation/builtins/service-risk.js +1 -0
  24. package/dist/evaluation/capability.d.ts +50 -0
  25. package/dist/evaluation/capability.js +1 -0
  26. package/dist/evaluation/composer.d.ts +13 -0
  27. package/dist/evaluation/composer.js +1 -0
  28. package/dist/evaluation/engine.d.ts +18 -0
  29. package/dist/evaluation/engine.js +1 -0
  30. package/dist/evaluation/extract.d.ts +30 -0
  31. package/dist/evaluation/extract.js +1 -0
  32. package/dist/evaluation/game-strategy.d.ts +27 -0
  33. package/dist/evaluation/game-strategy.js +1 -0
  34. package/dist/evaluation/gap.d.ts +2 -0
  35. package/dist/evaluation/gap.js +1 -0
  36. package/dist/evaluation/index.d.ts +12 -0
  37. package/dist/evaluation/index.js +1 -0
  38. package/dist/evaluation/node-game.d.ts +62 -0
  39. package/dist/evaluation/node-game.js +1 -0
  40. package/dist/evaluation/region.d.ts +10 -0
  41. package/dist/evaluation/region.js +1 -0
  42. package/dist/evaluation/types.d.ts +77 -0
  43. package/dist/evaluation/types.js +1 -0
  44. package/dist/evaluation/user-injection.d.ts +6 -0
  45. package/dist/evaluation/user-injection.js +1 -0
  46. package/dist/examples/education-contact-create.json +40 -0
  47. package/dist/examples/freelance-contact-create.json +40 -0
  48. package/dist/examples/insurance-machine-create.json +1 -1
  49. package/dist/examples/insurance-service-allocators.json +1 -1
  50. package/dist/examples/machine-publish.json +1 -1
  51. package/dist/examples/rental-ziroom-service-create.json +1 -1
  52. package/dist/examples/retail-adv-guard-messenger-proof-create.json +1 -1
  53. package/dist/examples/retail-myshop-service-create.json +1 -1
  54. package/dist/examples/retail-myshop-service-customer-required.json +1 -1
  55. package/dist/examples/subscription-contact-create.json +40 -0
  56. package/dist/examples/threebody-machine-create.json +1 -1
  57. package/dist/examples/travel-machine-create.json +1 -1
  58. package/dist/examples/travel-service-create.json +1 -1
  59. package/dist/experience/experience-reuse.js +1 -103
  60. package/dist/experience/index.js +1 -5
  61. package/dist/experience/intent-distill.js +1 -83
  62. package/dist/experience/realtime-feedback.js +1 -94
  63. package/dist/experience/types.js +1 -1
  64. package/dist/experience/user-profile.js +1 -171
  65. package/dist/extensions/business-modules.js +1 -287
  66. package/dist/extensions/capability-manifest.js +1 -781
  67. package/dist/extensions/constraint-registry.js +1 -198
  68. package/dist/extensions/index.js +1 -6
  69. package/dist/extensions/metric-registry.js +1 -257
  70. package/dist/extensions/mode-evaluator.js +1 -170
  71. package/dist/extensions/modes.js +1 -499
  72. package/dist/extensions/registry.js +1 -717
  73. package/dist/extensions/types.js +1 -1
  74. package/dist/harness/auto-escalation.js +1 -68
  75. package/dist/harness/checkpoint.js +1 -129
  76. package/dist/harness/index.js +1 -78
  77. package/dist/harness/plan.js +1 -276
  78. package/dist/harness/recover.js +1 -139
  79. package/dist/harness/types.js +1 -1
  80. package/dist/harness/verify.js +1 -237
  81. package/dist/index.js +1 -273
  82. package/dist/intent/enrich.d.ts +1 -0
  83. package/dist/intent/enrich.js +1 -0
  84. package/dist/intent/index.d.ts +23 -0
  85. package/dist/intent/index.js +1 -0
  86. package/dist/intent/matcher.d.ts +2 -0
  87. package/dist/intent/matcher.js +1 -0
  88. package/dist/intent/store.d.ts +19 -0
  89. package/dist/intent/store.js +1 -0
  90. package/dist/intent/types.d.ts +33 -0
  91. package/dist/intent/types.js +1 -0
  92. package/dist/knowledge/acquisition-flywheel.js +1 -192
  93. package/dist/knowledge/allocation-confirm.js +1 -534
  94. package/dist/knowledge/allocation-context.js +1 -249
  95. package/dist/knowledge/allocation-ledger.js +1 -463
  96. package/dist/knowledge/allocation-puzzle.js +1 -298
  97. package/dist/knowledge/allocation-risk.js +1 -568
  98. package/dist/knowledge/allocation-templates.js +1 -970
  99. package/dist/knowledge/allocation-translation.js +1 -585
  100. package/dist/knowledge/arb-risk.js +1 -210
  101. package/dist/knowledge/arbitration-confirm.js +1 -559
  102. package/dist/knowledge/arbitration-context.js +1 -505
  103. package/dist/knowledge/arbitration-ledger.js +1 -521
  104. package/dist/knowledge/arbitration-puzzle.js +1 -304
  105. package/dist/knowledge/arbitration-risk.js +1 -433
  106. package/dist/knowledge/arbitration-templates.js +1 -276
  107. package/dist/knowledge/arbitration-translation.js +1 -487
  108. package/dist/knowledge/arbitration-trust.js +1 -117
  109. package/dist/knowledge/audit-rules.js +1 -141
  110. package/dist/knowledge/bridge-risk.js +1 -263
  111. package/dist/knowledge/contact-risk.js +1 -200
  112. package/dist/knowledge/contact-templates.d.ts +27 -0
  113. package/dist/knowledge/contact-templates.js +1 -0
  114. package/dist/knowledge/demand-confirm.js +1 -206
  115. package/dist/knowledge/demand-matching.js +1 -132
  116. package/dist/knowledge/demand-risk.js +1 -240
  117. package/dist/knowledge/demand-translation.js +1 -354
  118. package/dist/knowledge/deployment-scanner.js +1 -823
  119. package/dist/knowledge/dynamic-pricing.js +1 -87
  120. package/dist/knowledge/examples-scanner-cli.js +1 -26
  121. package/dist/knowledge/examples-scanner.js +1 -825
  122. package/dist/knowledge/flywheel-loop.js +1 -404
  123. package/dist/knowledge/fund-layer.js +1 -973
  124. package/dist/knowledge/glossary.js +1 -211
  125. package/dist/knowledge/guard-confirm.js +1 -406
  126. package/dist/knowledge/guard-context.js +1 -287
  127. package/dist/knowledge/guard-design-patterns.js +1 -360
  128. package/dist/knowledge/guard-ledger.js +1 -260
  129. package/dist/knowledge/guard-lint.js +1 -670
  130. package/dist/knowledge/guard-migration.js +1 -228
  131. package/dist/knowledge/guard-puzzle.js +1 -805
  132. package/dist/knowledge/guard-render.js +1 -700
  133. package/dist/knowledge/guard-risk.js +1 -1879
  134. package/dist/knowledge/guard-submission-prompt.js +1 -171
  135. package/dist/knowledge/guard-templates.js +1 -1105
  136. package/dist/knowledge/guard-translation.js +1 -1119
  137. package/dist/knowledge/index.js +1 -436
  138. package/dist/knowledge/industry-evolution.js +1 -323
  139. package/dist/knowledge/industry-generalizer.js +1 -381
  140. package/dist/knowledge/industry-registry.js +1 -174
  141. package/dist/knowledge/intent-metrics.d.ts +4 -3
  142. package/dist/knowledge/intent-metrics.js +1 -566
  143. package/dist/knowledge/machine-confirm.js +1 -559
  144. package/dist/knowledge/machine-context.js +1 -833
  145. package/dist/knowledge/machine-ledger.js +1 -338
  146. package/dist/knowledge/machine-puzzle.js +1 -494
  147. package/dist/knowledge/machine-render.js +1 -565
  148. package/dist/knowledge/machine-risk.js +1 -670
  149. package/dist/knowledge/machine-templates.js +1 -1597
  150. package/dist/knowledge/machine-topology.js +1 -234
  151. package/dist/knowledge/machine-translation.js +1 -513
  152. package/dist/knowledge/mcp-schema-audit-cli.js +1 -45
  153. package/dist/knowledge/mcp-schema-audit.d.ts +1 -1
  154. package/dist/knowledge/mcp-schema-audit.js +1 -773
  155. package/dist/knowledge/onchain-constants.js +1 -35
  156. package/dist/knowledge/order-confirm.js +1 -573
  157. package/dist/knowledge/order-context.js +1 -390
  158. package/dist/knowledge/order-ledger.js +1 -341
  159. package/dist/knowledge/order-puzzle.js +1 -255
  160. package/dist/knowledge/order-risk.js +1 -653
  161. package/dist/knowledge/order-templates.js +1 -368
  162. package/dist/knowledge/order-translation.js +1 -550
  163. package/dist/knowledge/overrides-loader.js +1 -65
  164. package/dist/knowledge/passport-confirm.js +1 -531
  165. package/dist/knowledge/passport-context.js +1 -306
  166. package/dist/knowledge/passport-ledger.js +1 -282
  167. package/dist/knowledge/passport-puzzle.js +1 -333
  168. package/dist/knowledge/passport-risk.js +1 -450
  169. package/dist/knowledge/passport-templates.js +1 -568
  170. package/dist/knowledge/passport-translation.js +1 -516
  171. package/dist/knowledge/payment-risk.js +1 -249
  172. package/dist/knowledge/permission-confirm.js +1 -426
  173. package/dist/knowledge/permission-context.js +1 -224
  174. package/dist/knowledge/permission-ledger.js +1 -403
  175. package/dist/knowledge/permission-puzzle.js +1 -173
  176. package/dist/knowledge/permission-risk.js +1 -411
  177. package/dist/knowledge/permission-templates.js +1 -234
  178. package/dist/knowledge/permission-translation.js +1 -350
  179. package/dist/knowledge/personal-risk.js +1 -212
  180. package/dist/knowledge/process-model.js +1 -160
  181. package/dist/knowledge/progress-confirm.js +1 -456
  182. package/dist/knowledge/progress-context.js +1 -452
  183. package/dist/knowledge/progress-ledger.js +1 -330
  184. package/dist/knowledge/progress-puzzle.js +1 -219
  185. package/dist/knowledge/progress-risk.js +1 -461
  186. package/dist/knowledge/progress-templates.js +1 -228
  187. package/dist/knowledge/progress-translation.js +1 -405
  188. package/dist/knowledge/proof-confirm.js +1 -187
  189. package/dist/knowledge/proof-risk.js +1 -207
  190. package/dist/knowledge/proof-translation.js +1 -283
  191. package/dist/knowledge/registrar-risk.js +1 -217
  192. package/dist/knowledge/repository-confirm.js +1 -286
  193. package/dist/knowledge/repository-risk.js +1 -373
  194. package/dist/knowledge/repository-translation.js +1 -445
  195. package/dist/knowledge/reputation-rules.js +1 -99
  196. package/dist/knowledge/resource-risk.js +1 -157
  197. package/dist/knowledge/reward-confirm.js +1 -526
  198. package/dist/knowledge/reward-context.js +1 -504
  199. package/dist/knowledge/reward-ledger.js +1 -502
  200. package/dist/knowledge/reward-puzzle.js +1 -300
  201. package/dist/knowledge/reward-risk.js +1 -627
  202. package/dist/knowledge/reward-templates.js +1 -197
  203. package/dist/knowledge/reward-translation.js +1 -501
  204. package/dist/knowledge/safety-rules.js +1 -404
  205. package/dist/knowledge/scenario-modes.js +1 -321
  206. package/dist/knowledge/service-confirm.js +1 -807
  207. package/dist/knowledge/service-context.js +1 -403
  208. package/dist/knowledge/service-ledger.js +1 -609
  209. package/dist/knowledge/service-puzzle.js +1 -236
  210. package/dist/knowledge/service-risk.js +1 -615
  211. package/dist/knowledge/service-templates.js +1 -456
  212. package/dist/knowledge/service-translation.js +1 -622
  213. package/dist/knowledge/template-registry.d.ts +1 -1
  214. package/dist/knowledge/template-registry.js +1 -341
  215. package/dist/knowledge/tool-constraints.js +1 -195
  216. package/dist/knowledge/tools-reference.js +1 -155
  217. package/dist/knowledge/treasury-confirm.js +1 -512
  218. package/dist/knowledge/treasury-context.js +1 -363
  219. package/dist/knowledge/treasury-ledger.js +1 -300
  220. package/dist/knowledge/treasury-puzzle.js +1 -216
  221. package/dist/knowledge/treasury-risk.js +1 -440
  222. package/dist/knowledge/treasury-templates.js +1 -358
  223. package/dist/knowledge/treasury-translation.js +1 -498
  224. package/dist/knowledge/trust-metrics.js +1 -198
  225. package/dist/knowledge/util-risk.js +1 -135
  226. package/dist/loop-engineering/aggregate.js +1 -132
  227. package/dist/loop-engineering/context-collect.js +1 -83
  228. package/dist/loop-engineering/diagnose.js +1 -273
  229. package/dist/loop-engineering/improve.js +1 -405
  230. package/dist/loop-engineering/index.js +1 -4
  231. package/dist/loop-engineering/pipeline.js +1 -56
  232. package/dist/mode-market/index.js +1 -3
  233. package/dist/mode-market/registry.js +1 -124
  234. package/dist/mode-market/review.js +1 -214
  235. package/dist/mode-market/submission.js +1 -85
  236. package/dist/participation/collaborator-interest.d.ts +23 -0
  237. package/dist/participation/collaborator-interest.js +1 -0
  238. package/dist/participation/customer-interest.d.ts +25 -0
  239. package/dist/participation/customer-interest.js +1 -0
  240. package/dist/participation/merchant-interest.js +1 -100
  241. package/dist/participation/radar-core.d.ts +13 -3
  242. package/dist/participation/radar-core.js +1 -269
  243. package/dist/participation/supplier-interest.d.ts +25 -0
  244. package/dist/participation/supplier-interest.js +1 -0
  245. package/dist/persona/analyzer.d.ts +16 -0
  246. package/dist/persona/analyzer.js +1 -0
  247. package/dist/persona/bridge.d.ts +5 -0
  248. package/dist/persona/bridge.js +1 -0
  249. package/dist/persona/defaults.d.ts +4 -0
  250. package/dist/persona/defaults.js +1 -0
  251. package/dist/persona/experience-bridge.d.ts +3 -0
  252. package/dist/persona/experience-bridge.js +1 -0
  253. package/dist/persona/index.d.ts +18 -0
  254. package/dist/persona/index.js +1 -0
  255. package/dist/persona/model.d.ts +7 -0
  256. package/dist/persona/model.js +1 -0
  257. package/dist/persona/store.d.ts +19 -0
  258. package/dist/persona/store.js +1 -0
  259. package/dist/persona/types.d.ts +45 -0
  260. package/dist/persona/types.js +1 -0
  261. package/dist/project/business-puzzle.js +1 -383
  262. package/dist/project/context-assembly.js +1 -254
  263. package/dist/project/deployment-bridge.js +1 -120
  264. package/dist/project/deployment-doc.js +1 -1126
  265. package/dist/project/edit-planner.js +1 -1342
  266. package/dist/project/evaluation.js +1 -2011
  267. package/dist/project/game-theory.js +1 -177
  268. package/dist/project/graph-builder.js +1 -656
  269. package/dist/project/graph.js +1 -340
  270. package/dist/project/handlers.d.ts +5 -0
  271. package/dist/project/handlers.js +1 -1762
  272. package/dist/project/index.d.ts +1 -0
  273. package/dist/project/index.js +1 -301
  274. package/dist/project/intent-analyzer.js +1 -149
  275. package/dist/project/machine-nodes.js +1 -36
  276. package/dist/project/merchant-guide.js +1 -264
  277. package/dist/project/migration.js +1 -125
  278. package/dist/project/mode-actions.js +1 -309
  279. package/dist/project/namespace.js +1 -206
  280. package/dist/project/participation-radar.js +1 -428
  281. package/dist/project/pipeline-actions.js +1 -109
  282. package/dist/project/project-store.js +1 -422
  283. package/dist/project/query.js +1 -153
  284. package/dist/project/reverse-mapping.d.ts +34 -0
  285. package/dist/project/reverse-mapping.js +1 -0
  286. package/dist/project/risk-aggregator.js +1 -295
  287. package/dist/project/rollback-policy.js +1 -290
  288. package/dist/project/semantic-assembler.js +1 -345
  289. package/dist/project/semantic-graph.js +1 -245
  290. package/dist/project/stage-gate.js +1 -369
  291. package/dist/project/substep-trace.js +1 -332
  292. package/dist/project/task-tracker.js +1 -78
  293. package/dist/role/derivation.d.ts +18 -0
  294. package/dist/role/derivation.js +1 -0
  295. package/dist/role/index.d.ts +5 -0
  296. package/dist/role/index.js +1 -0
  297. package/dist/role/model.d.ts +8 -0
  298. package/dist/role/model.js +1 -0
  299. package/dist/role/resolution.d.ts +11 -0
  300. package/dist/role/resolution.js +1 -0
  301. package/dist/role/types.d.ts +11 -0
  302. package/dist/role/types.js +1 -0
  303. package/dist/rules.d.ts +2 -0
  304. package/dist/rules.js +1 -9
  305. package/dist/safety/confirm-gate.js +1 -88
  306. package/dist/safety/index.js +1 -3
  307. package/dist/safety/preview.js +1 -52
  308. package/dist/schema/call/allocation.js +1 -34
  309. package/dist/schema/call/arbitration.js +1 -113
  310. package/dist/schema/call/base.d.ts +15 -15
  311. package/dist/schema/call/base.js +1 -370
  312. package/dist/schema/call/bridge-handler.js +1 -265
  313. package/dist/schema/call/bridge.d.ts +7 -7
  314. package/dist/schema/call/bridge.js +1 -458
  315. package/dist/schema/call/contact.js +1 -37
  316. package/dist/schema/call/demand.js +1 -47
  317. package/dist/schema/call/guard.js +1 -161
  318. package/dist/schema/call/handler.js +1 -322
  319. package/dist/schema/call/index.js +1 -20
  320. package/dist/schema/call/machine.js +1 -193
  321. package/dist/schema/call/order.js +1 -35
  322. package/dist/schema/call/payment.js +1 -37
  323. package/dist/schema/call/permission-handler.js +1 -54
  324. package/dist/schema/call/permission.js +1 -105
  325. package/dist/schema/call/personal.js +1 -78
  326. package/dist/schema/call/progress.js +1 -47
  327. package/dist/schema/call/proof.js +1 -33
  328. package/dist/schema/call/repository.js +1 -77
  329. package/dist/schema/call/reward.js +1 -30
  330. package/dist/schema/call/semantic.js +1 -1657
  331. package/dist/schema/call/service.js +1 -178
  332. package/dist/schema/call/treasury.js +1 -71
  333. package/dist/schema/common/index.js +1 -407
  334. package/dist/schema/config/index.js +1 -68
  335. package/dist/schema/evaluation/index.d.ts +4436 -0
  336. package/dist/schema/evaluation/index.js +1 -0
  337. package/dist/schema/index.d.ts +4 -0
  338. package/dist/schema/index.js +1 -13
  339. package/dist/schema/intent-radar/index.d.ts +284 -0
  340. package/dist/schema/intent-radar/index.js +1 -0
  341. package/dist/schema/local/index.d.ts +21 -21
  342. package/dist/schema/local/index.js +1 -927
  343. package/dist/schema/local/wip.js +1 -187
  344. package/dist/schema/messenger/index.d.ts +7 -7
  345. package/dist/schema/messenger/index.js +1 -475
  346. package/dist/schema/operations.d.ts +7 -7
  347. package/dist/schema/operations.js +1 -520
  348. package/dist/schema/persona/index.d.ts +1985 -0
  349. package/dist/schema/persona/index.js +1 -0
  350. package/dist/schema/project/index.d.ts +96 -50
  351. package/dist/schema/project/index.js +1 -2057
  352. package/dist/schema/query/index.d.ts +423 -7
  353. package/dist/schema/query/index.js +1 -1640
  354. package/dist/schema/schema-query/index.js +1 -104
  355. package/dist/schema/schema-version.js +1 -76
  356. package/dist/schema/sync-layer4.d.ts +1 -1
  357. package/dist/schema/sync-layer4.js +1 -282
  358. package/dist/schema/task-status.d.ts +168 -0
  359. package/dist/schema/task-status.js +1 -0
  360. package/dist/schema/trust/index.js +1 -314
  361. package/dist/schema/utils/guard-parser.js +1 -419
  362. package/dist/schema/utils/guard-query-utils.js +1 -46
  363. package/dist/schema/utils/node-parser.js +1 -369
  364. package/dist/schema/utils/object-type-utils.js +1 -35
  365. package/dist/schema/utils/permission-index-utils.js +1 -7
  366. package/dist/schema/utils/permission-machine-check.js +1 -121
  367. package/dist/schema/utils/skills-recommendation.js +1 -77
  368. package/dist/schema-query/index.js +1 -810
  369. package/dist/schemas/account_operation.output.json +5 -2
  370. package/dist/schemas/bridge_operation.output.json +5 -2
  371. package/dist/schemas/evaluation_operation.output.json +782 -0
  372. package/dist/schemas/evaluation_operation.schema.json +990 -0
  373. package/dist/schemas/index.json +25 -1
  374. package/dist/schemas/intent_radar.output.json +232 -0
  375. package/dist/schemas/intent_radar.schema.json +138 -0
  376. package/dist/schemas/local_info_operation.output.json +5 -2
  377. package/dist/schemas/local_mark_operation.output.json +5 -2
  378. package/dist/schemas/messenger_operation.output.json +5 -2
  379. package/dist/schemas/onchain_events.output.json +5 -2
  380. package/dist/schemas/onchain_operations.output.json +5 -2
  381. package/dist/schemas/onchain_operations.schema.json +6 -6
  382. package/dist/schemas/onchain_operations_allocation.schema.json +1 -1
  383. package/dist/schemas/onchain_operations_machine.schema.json +2 -2
  384. package/dist/schemas/onchain_operations_service.schema.json +3 -3
  385. package/dist/schemas/onchain_table_data.output.json +6 -3
  386. package/dist/schemas/persona_operation.output.json +392 -0
  387. package/dist/schemas/persona_operation.schema.json +250 -0
  388. package/dist/schemas/project_operation.output.json +28 -8
  389. package/dist/schemas/query_task_status.output.json +115 -0
  390. package/dist/schemas/query_task_status.schema.json +24 -0
  391. package/dist/schemas/query_toolkit.output.json +9 -6
  392. package/dist/schemas/trust_score.schema.json +1 -1
  393. package/dist/schemas/wowok_buildin_info.output.json +132 -0
  394. package/dist/schemas/wowok_buildin_info.schema.json +14 -0
  395. package/dist/telemetry/index.js +1 -112
  396. package/dist/telemetry/redact.js +1 -23
  397. package/dist/telemetry/storage.js +1 -80
  398. package/dist/tools/handlers/bridge.js +1 -1
  399. package/dist/tools/handlers/config.js +1 -74
  400. package/dist/tools/handlers/evaluation.d.ts +2 -0
  401. package/dist/tools/handlers/evaluation.js +1 -0
  402. package/dist/tools/handlers/file-export.js +1 -90
  403. package/dist/tools/handlers/intent-radar.d.ts +2 -0
  404. package/dist/tools/handlers/intent-radar.js +1 -0
  405. package/dist/tools/handlers/local.js +1 -53
  406. package/dist/tools/handlers/messenger.js +1 -188
  407. package/dist/tools/handlers/onchain.js +1 -1082
  408. package/dist/tools/handlers/persona.d.ts +4 -0
  409. package/dist/tools/handlers/persona.js +1 -0
  410. package/dist/tools/handlers/project.js +1 -211
  411. package/dist/tools/handlers/query.js +1 -434
  412. package/dist/tools/handlers/schema-query.js +1 -176
  413. package/dist/tools/handlers/task-status.d.ts +0 -168
  414. package/dist/tools/handlers/task-status.js +1 -55
  415. package/dist/tools/handlers/trust.js +1 -380
  416. package/dist/tools/handlers/wip.js +1 -90
  417. package/dist/tools/index.js +1 -1306
  418. package/dist/tools/retry.js +1 -85
  419. package/dist/tools/rules-hook.js +1 -23
  420. package/dist/tools/shared.js +1 -130
  421. package/dist/tools/types.js +1 -1
  422. package/dist/tools/upgrade-check.d.ts +19 -0
  423. package/dist/tools/upgrade-check.js +1 -0
  424. package/dist/tools/wip-deploy-assist.d.ts +1 -1
  425. package/dist/tools/wip-deploy-assist.js +1 -278
  426. package/dist/tools/wrap.js +1 -500
  427. package/package.json +5 -3
@@ -1,502 +1 @@
1
- import { MAX_GUARD_COUNT_REWARD, MAX_RECORD_COUNT_REWARD, } from "./onchain-constants.js";
2
- export { MAX_GUARD_COUNT_REWARD, MAX_RECORD_COUNT_REWARD, };
3
- export const REWARD_NEW = {
4
- index: 150,
5
- name: "REWARD_NEW",
6
- description: "Create new Reward<T> (asserted by reward::new / new_with_passport)",
7
- governed_operations: ["reward::new", "reward::new_with_passport"],
8
- sdk_exposed: true,
9
- };
10
- export const REWARD_DESCRIPTION = {
11
- index: 151,
12
- name: "REWARD_DESCRIPTION",
13
- description: "Update description (asserted by reward::description_set / _with_passport)",
14
- governed_operations: ["reward::description_set", "reward::description_set_with_passport"],
15
- sdk_exposed: true,
16
- };
17
- export const REWARD_GUARD = {
18
- index: 152,
19
- name: "REWARD_GUARD",
20
- description: "Add / remove expired guards (≤ MAX_GUARD_COUNT_REWARD=200)",
21
- governed_operations: [
22
- "reward::guard_add",
23
- "reward::guard_add_with_passport",
24
- "reward::guard_remove_expired",
25
- "reward::guard_remove_expired_with_passport",
26
- ],
27
- sdk_exposed: true,
28
- };
29
- export const REWARD_COIN_ADD = {
30
- index: 153,
31
- name: "REWARD_COIN_ADD",
32
- description: "Deposit Coin<T> directly into Reward balance (joins Balance<T>)",
33
- governed_operations: ["reward::coin_add", "reward::coin_add_with_passport"],
34
- sdk_exposed: true,
35
- };
36
- export const REWARD_RECEIVE = {
37
- index: 154,
38
- name: "REWARD_RECEIVE",
39
- description: "Receive CoinWrapper<T> via Payment.unwrap_with_check (joins Balance<T>)",
40
- governed_operations: ["reward::receive", "reward::receive_with_passport"],
41
- sdk_exposed: true,
42
- };
43
- export const REWARD_GUARD_EXPIRATION_TIME_ADD = {
44
- index: 155,
45
- name: "REWARD_GUARD_EXPIRATION_TIME_ADD",
46
- description: "Set / cancel guard_not_added_expiration_time (time-lock on new guard additions)",
47
- governed_operations: [
48
- "reward::guard_expiration_time_add",
49
- "reward::guard_expiration_time_add_with_passport",
50
- ],
51
- sdk_exposed: true,
52
- };
53
- export const REWARD_OWNER_RECEIVE = {
54
- index: 156,
55
- name: "REWARD_OWNER_RECEIVE",
56
- description: "Owner receives Receiving<K> / CoinWrapper<K> at terminal state (unwrap → owner)",
57
- governed_operations: [
58
- "reward::owner_receive",
59
- "reward::owner_receive_with_passport",
60
- "reward::owner_receive_object",
61
- "reward::owner_receive_object_with_passport",
62
- ],
63
- sdk_exposed: true,
64
- };
65
- export const REWARD_UM = {
66
- index: 157,
67
- name: "REWARD_UM",
68
- description: "Bind / unbind Contact (UM) for off-chain coordination",
69
- governed_operations: [
70
- "reward::um_set",
71
- "reward::um_set_with_passport",
72
- "reward::um_none",
73
- "reward::um_none_with_passport",
74
- ],
75
- sdk_exposed: true,
76
- };
77
- export const REWARD_PERMISSIONS = [
78
- REWARD_NEW,
79
- REWARD_DESCRIPTION,
80
- REWARD_GUARD,
81
- REWARD_COIN_ADD,
82
- REWARD_RECEIVE,
83
- REWARD_GUARD_EXPIRATION_TIME_ADD,
84
- REWARD_OWNER_RECEIVE,
85
- REWARD_UM,
86
- ];
87
- export const REWARD_FIELDS = [
88
- {
89
- name: "id",
90
- move_type: "UID",
91
- mutability: "immutable",
92
- set_at_creation: true,
93
- constraint: "Object UID; assigned in new_imp via object::new(ctx). Never changes.",
94
- },
95
- {
96
- name: "description",
97
- move_type: "String",
98
- mutability: "admin_mutable",
99
- set_at_creation: true,
100
- permission_index: 151,
101
- constraint: "Must satisfy common::DESCRIPTION. Updated via description_set (151).",
102
- },
103
- {
104
- name: "guards",
105
- move_type: "vector<RewardGuard>",
106
- mutability: "admin_mutable",
107
- set_at_creation: true,
108
- permission_index: 152,
109
- constraint: "vector::length < MAX_GUARD_COUNT (200); E_GUARD_COUNT_EXCEEDED on overflow.",
110
- related_errors: ["E_GUARD_COUNT_EXCEEDED"],
111
- },
112
- {
113
- name: "balance",
114
- move_type: "Balance<T>",
115
- mutability: "runtime",
116
- set_at_creation: true,
117
- constraint: "Zero at creation (balance::zero()); grows via coin_add/receive; shrinks via claim (split) and never via direct withdraw.",
118
- related_errors: ["E_INSUFFICIENT_BALANCE"],
119
- },
120
- {
121
- name: "guard_not_added_expiration_time",
122
- move_type: "Option<u64>",
123
- mutability: "admin_mutable",
124
- set_at_creation: true,
125
- permission_index: 155,
126
- constraint: "Option<timestamp_ms>. When Some(t): guard_add requires clock > t (E_GUARD_LOCKED_TIME). When None or t < now: guards can be added.",
127
- related_errors: ["E_GUARD_LOCKED_TIME", "E_GUARD_LOCKED_TIME_NOT_INCREASING", "E_GUARD_LOCKED_TIME_INVALID"],
128
- },
129
- {
130
- name: "record",
131
- move_type: "ParentTable<address, RecipientRecord>",
132
- mutability: "runtime",
133
- set_at_creation: true,
134
- constraint: "Per-recipient claim history. Each RecipientRecord.amount vector has length < MAX_RECORD_COUNT (5200); E_RECORD_COUNT_EXCEEDED on overflow.",
135
- related_errors: ["E_RECORD_COUNT_EXCEEDED"],
136
- },
137
- {
138
- name: "um",
139
- move_type: "Option<address>",
140
- mutability: "admin_mutable",
141
- set_at_creation: true,
142
- permission_index: 157,
143
- constraint: "Option<Contact address>. um_set creates Registrar affiliation; um_none disaffiliates.",
144
- },
145
- {
146
- name: "permission",
147
- move_type: "address",
148
- mutability: "admin_mutable",
149
- set_at_creation: true,
150
- constraint: "Permission object address. Updated via permission_set (asserts old.owner == sender). Creates Registrar affiliation_change.",
151
- },
152
- ];
153
- export const REWARD_GUARD_CONSTRUCTORS = [
154
- {
155
- constructor: "guard_u8_u8",
156
- recipient_type: "GuardIdentifier",
157
- amount_type: "GuardU64Identifier",
158
- params: {
159
- recipient_param: "u8",
160
- amount_param: "u8",
161
- expiration_time: "Option<u64>",
162
- store_from_id: "Option<u8>",
163
- },
164
- construction_checks: [
165
- "is_identifier_address(guard, recipient) — E_RECIPIENT_IDENTIFIER_NOT_ADDRESS (4)",
166
- "get_submission_value_type(guard, amount) must be Some(TYPE_U64) — E_AMOUNT_NOT_U64 (5)",
167
- "if store_from_id is Some: is_identifier_address_compatible — E_STORE_FROM_ID_NOT_COMPATIBLE (12)",
168
- ],
169
- typical_use: "Dynamic recipient + dynamic amount — both extracted from Passport at claim time (e.g. referral rewards where referrer and amount vary per claim).",
170
- },
171
- {
172
- constructor: "guard_u8_u64",
173
- recipient_type: "GuardIdentifier",
174
- amount_type: "Fixed",
175
- params: {
176
- recipient_param: "u8",
177
- amount_param: "u64",
178
- expiration_time: "Option<u64>",
179
- store_from_id: "Option<u8>",
180
- },
181
- construction_checks: [
182
- "is_identifier_address(guard, recipient) — E_RECIPIENT_IDENTIFIER_NOT_ADDRESS (4)",
183
- "if store_from_id is Some: is_identifier_address_compatible — E_STORE_FROM_ID_NOT_COMPATIBLE (12)",
184
- ],
185
- typical_use: "Dynamic recipient + fixed amount — e.g. first-order reward where any new customer claims a fixed 1 WOW.",
186
- },
187
- {
188
- constructor: "guard_entity_u8",
189
- recipient_type: "Entity",
190
- amount_type: "GuardU64Identifier",
191
- params: {
192
- recipient_param: "address",
193
- amount_param: "u8",
194
- expiration_time: "Option<u64>",
195
- store_from_id: "Option<u8>",
196
- },
197
- construction_checks: [
198
- "get_submission_value_type(guard, amount) must be Some(TYPE_U64) — E_AMOUNT_NOT_U64 (5)",
199
- "if store_from_id is Some: is_identifier_address_compatible — E_STORE_FROM_ID_NOT_COMPATIBLE (12)",
200
- ],
201
- typical_use: "Fixed recipient + dynamic amount — e.g. tiered loyalty reward where amount depends on Passport submission (tier level).",
202
- },
203
- {
204
- constructor: "guard_entity_u64",
205
- recipient_type: "Entity",
206
- amount_type: "Fixed",
207
- params: {
208
- recipient_param: "address",
209
- amount_param: "u64",
210
- expiration_time: "Option<u64>",
211
- store_from_id: "Option<u8>",
212
- },
213
- construction_checks: [
214
- "if store_from_id is Some: is_identifier_address_compatible — E_STORE_FROM_ID_NOT_COMPATIBLE (12)",
215
- ],
216
- typical_use: "Fully fixed recipient + amount — simplest configuration (e.g. specific partner bounty).",
217
- },
218
- {
219
- constructor: "guard_signer_u8",
220
- recipient_type: "Signer",
221
- amount_type: "GuardU64Identifier",
222
- params: {
223
- amount_param: "u8",
224
- expiration_time: "Option<u64>",
225
- store_from_id: "Option<u8>",
226
- },
227
- construction_checks: [
228
- "get_submission_value_type(guard, amount) must be Some(TYPE_U64) — E_AMOUNT_NOT_U64 (5)",
229
- "if store_from_id is Some: is_identifier_address_compatible — E_STORE_FROM_ID_NOT_COMPATIBLE (12)",
230
- ],
231
- typical_use: "Caller is recipient + dynamic amount — e.g. self-service claim where amount depends on Passport submission (e.g. cashback rate).",
232
- },
233
- {
234
- constructor: "guard_signer_u64",
235
- recipient_type: "Signer",
236
- amount_type: "Fixed",
237
- params: {
238
- amount_param: "u64",
239
- expiration_time: "Option<u64>",
240
- store_from_id: "Option<u8>",
241
- },
242
- construction_checks: [
243
- "if store_from_id is Some: is_identifier_address_compatible — E_STORE_FROM_ID_NOT_COMPATIBLE (12)",
244
- ],
245
- typical_use: "Caller is recipient + fixed amount — e.g. flash sale where any eligible caller claims a fixed reward.",
246
- },
247
- ];
248
- export const REWARD_ERROR_CODES = [
249
- { code: 1, name: "E_GUARD_LOCKED_TIME_NOT_INCREASING", description: "guard_expiration_time_add: new time < current clock (must be ≥ now)", trigger_operation: "guard_expiration_time_add" },
250
- { code: 2, name: "E_GUARD_EXPIRED", description: "guard_add on guard with expiration_time < now, OR claim on guard with expiration_time < now", trigger_operation: "guard_add / claim" },
251
- { code: 3, name: "E_GUARD_COUNT_EXCEEDED", description: "guard_add would exceed MAX_GUARD_COUNT=200 (only on NEW guard, not on update of existing)", trigger_operation: "guard_add" },
252
- { code: 4, name: "E_RECIPIENT_IDENTIFIER_NOT_ADDRESS", description: "RewardGuard constructor: recipient identifier type is not address (GuardIdentifier variant only)", trigger_operation: "reward_guard (constructor)" },
253
- { code: 5, name: "E_AMOUNT_NOT_U64", description: "RewardGuard constructor: amount identifier type is not u64 (GuardU64Identifier variant only)", trigger_operation: "reward_guard (constructor)" },
254
- { code: 6, name: "E_INSUFFICIENT_BALANCE", description: "claim: balance < amount (cannot split more than held)", trigger_operation: "claim" },
255
- { code: 7, name: "E_GUARD_NOT_FOUND", description: "claim: no guard in self.guards matches the supplied guard address", trigger_operation: "claim" },
256
- { code: 8, name: "E_RECORD_COUNT_EXCEEDED", description: "claim: recipient already has MAX_RECORD_COUNT=5200 entries (E_RECORD_COUNT_EXCEEDED)", trigger_operation: "claim" },
257
- { code: 10, name: "E_GUARD_LOCKED_TIME", description: "guard_add while guard_not_added_expiration_time is Some and clock ≤ expiration_time", trigger_operation: "guard_add" },
258
- { code: 11, name: "E_GUARD_LOCKED_TIME_INVALID", description: "guard_expiration_time_add: new Some(t) where t ≤ now (must be future)", trigger_operation: "guard_expiration_time_add" },
259
- { code: 12, name: "E_STORE_FROM_ID_NOT_COMPATIBLE", description: "RewardGuard constructor: store_from_id identifier type is not number or address", trigger_operation: "reward_guard (constructor)" },
260
- ];
261
- export const REWARD_SCENES = [
262
- {
263
- id: "reward_first_order",
264
- name: "First-order reward",
265
- industry: ["universal", "ecommerce", "service", "freelance"],
266
- scenario: "New customers receive a fixed reward after their first order. Guard verifies order ownership + first-time status; " +
267
- "Recipient=Signer (caller is the new customer); Amount=Fixed (e.g. 1 WOW).",
268
- phases: ["creation", "guard_addition", "funds_replenish", "claim"],
269
- coin_type_note: "T = project reward coin (e.g. 0x2::wow::WOW or a custom token)",
270
- typical_guard_count: 1,
271
- recipient_types_used: ["Signer"],
272
- amount_types_used: ["Fixed"],
273
- uses_expiration_time: true,
274
- uses_store_from_id: false,
275
- builtin_indexes_consumed: [REWARD_NEW, REWARD_GUARD, REWARD_COIN_ADD],
276
- common_patterns: [
277
- "guard_signer_u64 — caller claims a fixed amount (e.g. 1 WOW)",
278
- "Guard verifies: order_address.holder == signer AND order is the first order (Repository query)",
279
- "expiration_time bounds the campaign window (e.g. 30 days)",
280
- "coin_add deposits the campaign budget upfront (e.g. 100 WOW for 100 claims)",
281
- ],
282
- recommended_templates: ["first_order"],
283
- },
284
- {
285
- id: "reward_referral",
286
- name: "Referral viral reward",
287
- industry: ["universal", "ecommerce", "service", "content"],
288
- scenario: "Both referrer and referee receive a reward when the referee completes a first order. Two guards: one for referrer (Entity), one for referee (Signer).",
289
- phases: ["creation", "guard_addition", "funds_replenish", "claim"],
290
- coin_type_note: "T = project reward coin",
291
- typical_guard_count: 2,
292
- recipient_types_used: ["Entity", "Signer"],
293
- amount_types_used: ["Fixed"],
294
- uses_expiration_time: true,
295
- uses_store_from_id: true,
296
- builtin_indexes_consumed: [REWARD_NEW, REWARD_GUARD, REWARD_COIN_ADD],
297
- common_patterns: [
298
- "guard_entity_u64 for referrer (recipient = referrer address, fixed amount)",
299
- "guard_signer_u64 for referee (caller is recipient, fixed amount)",
300
- "Guard verifies: referrer marked in Repository AND referee's order completed",
301
- "store_from_id may record the order address for audit trail",
302
- ],
303
- recommended_templates: ["referral"],
304
- },
305
- {
306
- id: "reward_loyalty",
307
- name: "Loyalty tiered reward",
308
- industry: ["universal", "ecommerce", "subscription", "content"],
309
- scenario: "Customers unlock higher rewards after reaching cumulative spending tiers. Recipient=Signer; Amount=GuardU64Identifier (tier-dependent amount extracted from Passport).",
310
- phases: ["creation", "guard_addition", "funds_replenish", "claim"],
311
- coin_type_note: "T = project reward coin",
312
- typical_guard_count: 1,
313
- recipient_types_used: ["Signer"],
314
- amount_types_used: ["GuardU64Identifier"],
315
- uses_expiration_time: false,
316
- uses_store_from_id: false,
317
- builtin_indexes_consumed: [REWARD_NEW, REWARD_GUARD, REWARD_COIN_ADD],
318
- common_patterns: [
319
- "guard_signer_u8 — amount is dynamic, extracted from Passport submission (tier level → reward amount)",
320
- "Guard verifies: cumulative spend ≥ tier threshold (Repository query)",
321
- "No expiration_time — loyalty is perpetual (until deactivated via guard_remove_expired)",
322
- "Guard submission value type MUST be u64 (E_AMOUNT_NOT_U64 otherwise)",
323
- ],
324
- recommended_templates: ["loyalty"],
325
- },
326
- {
327
- id: "reward_flash_sale",
328
- name: "Limited-time flash sale reward",
329
- industry: ["universal", "ecommerce", "retail"],
330
- scenario: "Time-bounded reward for the first N callers. Recipient=Signer; Amount=Fixed. Guard verifies time window + claim count.",
331
- phases: ["creation", "guard_addition", "funds_replenish", "claim", "guard_lock_mgmt"],
332
- coin_type_note: "T = project reward coin",
333
- typical_guard_count: 1,
334
- recipient_types_used: ["Signer"],
335
- amount_types_used: ["Fixed"],
336
- uses_expiration_time: true,
337
- uses_store_from_id: false,
338
- builtin_indexes_consumed: [REWARD_NEW, REWARD_GUARD, REWARD_COIN_ADD, REWARD_GUARD_EXPIRATION_TIME_ADD],
339
- common_patterns: [
340
- "guard_signer_u64 — fixed amount per claim (e.g. 2 WOW)",
341
- "expiration_time bounds the flash sale window (e.g. 48 hours)",
342
- "guard_expiration_time_add (155) may lock further guard additions during the sale",
343
- "Budget = max_claims × amount; coin_add deposits this upfront",
344
- ],
345
- recommended_templates: ["flash_sale"],
346
- },
347
- {
348
- id: "reward_bulk_discount",
349
- name: "Bulk discount / cashback reward",
350
- industry: ["universal", "ecommerce", "wholesale", "service"],
351
- scenario: "Customer receives cashback proportional to order size. Recipient=Signer or Entity (order holder); Amount=GuardU64Identifier (cashback rate from Passport).",
352
- phases: ["creation", "guard_addition", "funds_replenish", "claim"],
353
- coin_type_note: "T = payment coin type (must match order payment for clean cashback)",
354
- typical_guard_count: 1,
355
- recipient_types_used: ["Signer", "Entity"],
356
- amount_types_used: ["GuardU64Identifier"],
357
- uses_expiration_time: false,
358
- uses_store_from_id: true,
359
- builtin_indexes_consumed: [REWARD_NEW, REWARD_GUARD, REWARD_COIN_ADD, REWARD_RECEIVE],
360
- common_patterns: [
361
- "guard_signer_u8 — caller claims dynamic amount (cashback = order_amount × rate)",
362
- "store_from_id records the order address for cross-reference (audit trail)",
363
- "receive (154) may be used to accept CoinWrapper<T> refunds that replenish the balance",
364
- "Guard verifies: order.completed AND order.service == this Service",
365
- ],
366
- recommended_templates: ["cashback"],
367
- },
368
- {
369
- id: "reward_milestone",
370
- name: "Service milestone reward",
371
- industry: ["universal", "ecommerce", "content", "subscription"],
372
- scenario: "When a Service reaches a milestone (e.g. 100 orders), early supporters receive extra rewards. Recipient=Entity (early customer); Amount=Fixed.",
373
- phases: ["creation", "guard_addition", "funds_replenish", "claim", "guard_lock_mgmt"],
374
- coin_type_note: "T = project reward coin",
375
- typical_guard_count: 50,
376
- recipient_types_used: ["Entity"],
377
- amount_types_used: ["Fixed"],
378
- uses_expiration_time: true,
379
- uses_store_from_id: false,
380
- builtin_indexes_consumed: [REWARD_NEW, REWARD_GUARD, REWARD_COIN_ADD, REWARD_GUARD_EXPIRATION_TIME_ADD],
381
- common_patterns: [
382
- "guard_entity_u64 for each early customer (recipient = customer address, fixed amount)",
383
- "Multiple guards (up to 50 for 50 early supporters) — well within MAX_GUARD_COUNT=200",
384
- "Guard verifies: Service order_count >= milestone AND claimer is in early-customer list",
385
- "guard_expiration_time_add (155) may lock the guard list after milestone setup",
386
- ],
387
- recommended_templates: ["milestone"],
388
- },
389
- ];
390
- export const REWARD_LEDGER_VERSION = "1.0.0";
391
- export function getScenesByPhase(phase) {
392
- return REWARD_SCENES.filter(s => s.phases.includes(phase));
393
- }
394
- export function findSceneById(id) {
395
- return REWARD_SCENES.find(s => s.id === id);
396
- }
397
- export function getScenesByIndustry(industry) {
398
- return REWARD_SCENES.filter(s => s.industry.includes(industry) || s.industry.includes("universal"));
399
- }
400
- export function getBuiltinPermissionByIndex(index) {
401
- return REWARD_PERMISSIONS.find(p => p.index === index);
402
- }
403
- export function isRewardBuiltinPermission(index) {
404
- return getBuiltinPermissionByIndex(index) !== undefined;
405
- }
406
- export function getAllBuiltinPermissions() {
407
- return [...REWARD_PERMISSIONS];
408
- }
409
- export function getRewardScenesCount() {
410
- return REWARD_SCENES.length;
411
- }
412
- export function getGuardConstructorSpec(constructor) {
413
- return REWARD_GUARD_CONSTRUCTORS.find(c => c.constructor === constructor);
414
- }
415
- export function resolveGuardConstructor(recipient_type, amount_type) {
416
- const map = {
417
- "GuardIdentifier|GuardU64Identifier": "guard_u8_u8",
418
- "GuardIdentifier|Fixed": "guard_u8_u64",
419
- "Entity|GuardU64Identifier": "guard_entity_u8",
420
- "Entity|Fixed": "guard_entity_u64",
421
- "Signer|GuardU64Identifier": "guard_signer_u8",
422
- "Signer|Fixed": "guard_signer_u64",
423
- };
424
- return map[`${recipient_type}|${amount_type}`];
425
- }
426
- export function getRewardErrorByCode(code) {
427
- return REWARD_ERROR_CODES.find(e => e.code === code);
428
- }
429
- export function getRewardErrorByName(name) {
430
- return REWARD_ERROR_CODES.find(e => e.name === name);
431
- }
432
- export function validateGuardCount(currentGuardCount) {
433
- if (currentGuardCount >= MAX_GUARD_COUNT_REWARD) {
434
- return {
435
- ok: false,
436
- violation: `Guard count ${currentGuardCount} would exceed MAX_GUARD_COUNT_REWARD ${MAX_GUARD_COUNT_REWARD}`,
437
- };
438
- }
439
- return { ok: true };
440
- }
441
- export function validateRecordCount(currentRecordCount) {
442
- if (currentRecordCount >= MAX_RECORD_COUNT_REWARD) {
443
- return {
444
- ok: false,
445
- violation: `Record count ${currentRecordCount} would exceed MAX_RECORD_COUNT_REWARD ${MAX_RECORD_COUNT_REWARD} — recipient can no longer claim`,
446
- };
447
- }
448
- return { ok: true };
449
- }
450
- export function inferSceneFromIntent(intent) {
451
- const lower = intent.toLowerCase();
452
- const keywordMap = [
453
- ["flash sale", "reward_flash_sale"],
454
- ["flash_sale", "reward_flash_sale"],
455
- ["limited-time", "reward_flash_sale"],
456
- ["limited time", "reward_flash_sale"],
457
- ["referral", "reward_referral"],
458
- ["viral", "reward_referral"],
459
- ["refer a friend", "reward_referral"],
460
- ["invite", "reward_referral"],
461
- ["loyalty", "reward_loyalty"],
462
- ["tiered", "reward_loyalty"],
463
- ["tier", "reward_loyalty"],
464
- ["repeat", "reward_loyalty"],
465
- ["cashback", "reward_bulk_discount"],
466
- ["bulk discount", "reward_bulk_discount"],
467
- ["bulk_discount", "reward_bulk_discount"],
468
- ["wholesale", "reward_bulk_discount"],
469
- ["milestone", "reward_milestone"],
470
- ["early supporter", "reward_milestone"],
471
- ["early customer", "reward_milestone"],
472
- ["first order", "reward_first_order"],
473
- ["first_order", "reward_first_order"],
474
- ["new customer", "reward_first_order"],
475
- ["first-time", "reward_first_order"],
476
- ];
477
- for (const [kw, sceneId] of keywordMap) {
478
- if (lower.includes(kw)) {
479
- const scene = findSceneById(sceneId);
480
- if (scene)
481
- return scene;
482
- }
483
- }
484
- return undefined;
485
- }
486
- export const REWARD_CROSS_OBJECT_REFS = [
487
- { object: "Permission", phase: "universal", relationship: "Reward.permission (address; borrowed for all 150-157 assertions)" },
488
- { object: "Permission", phase: "permission_update", relationship: "permission_set: asserts old.owner == sender; creates Registrar affiliation_change" },
489
- { object: "Guard", phase: "guard_addition", relationship: "RewardGuard.guard = guard.id_address (each guard registered via Registrar affiliation)" },
490
- { object: "Guard", phase: "claim", relationship: "claim: iterates self.guards looking for guard.id_address match; E_GUARD_NOT_FOUND if no match" },
491
- { object: "Guard", phase: "claim", relationship: "claim: passport::result_for_guard(passport, guard_id) verifies submission data" },
492
- { object: "Passport", phase: "claim", relationship: "claim: passport::submission_get extracts recipient (address) and/or amount (u64) per RewardGuard variant" },
493
- { object: "Passport", phase: "claim", relationship: "claim: if store_from_id is Some, extracts store-from address from Passport submission" },
494
- { object: "Payment", phase: "funds_replenish", relationship: "receive (154): Payment.unwrap_with_check extracts Coin<T> from CoinWrapper<T> and joins balance" },
495
- { object: "Payment", phase: "owner_receive", relationship: "owner_receive (156): Payment.unwrap_with_check forwards CoinWrapper<K> to Permission owner" },
496
- { object: "Repository", phase: "claim", relationship: "Guard may query Repository (e.g. order history for first-order / loyalty verification)" },
497
- { object: "Service", phase: "claim", relationship: "Guard may verify order.service == this Service (cashback / first-order scenarios)" },
498
- { object: "Demand", phase: "guard_addition", relationship: "Guard may be shared with Demand (recommendation filtering); same Guard object address space" },
499
- { object: "Allocation", phase: "owner_receive", relationship: "Terminal Allocation alloc may route funds back to Reward (replenishment loop)" },
500
- { object: "Contact", phase: "um_mgmt", relationship: "um_set (157): binds Contact (UM) for off-chain coordination; creates Registrar affiliation" },
501
- { object: "Coin", phase: "universal", relationship: "Reward<phantom T>: T is the coin type; balance: Balance<T>; coin_add expects Coin<T>" },
502
- ];
1
+ import{MAX_GUARD_COUNT_REWARD,MAX_RECORD_COUNT_REWARD}from'./onchain-constants.js';export{MAX_GUARD_COUNT_REWARD,MAX_RECORD_COUNT_REWARD};export const REWARD_NEW={'index':0x96,'name':'REWARD_NEW','description':'Create\x20new\x20Reward<T>\x20(asserted\x20by\x20reward::new\x20/\x20new_with_passport)','governed_operations':['reward::new','reward::new_with_passport'],'sdk_exposed':!![]};export const REWARD_DESCRIPTION={'index':0x97,'name':'REWARD_DESCRIPTION','description':'Update\x20description\x20(asserted\x20by\x20reward::description_set\x20/\x20_with_passport)','governed_operations':['reward::description_set','reward::description_set_with_passport'],'sdk_exposed':!![]};export const REWARD_GUARD={'index':0x98,'name':'REWARD_GUARD','description':'Add\x20/\x20remove\x20expired\x20guards\x20(≤\x20MAX_GUARD_COUNT_REWARD=200)','governed_operations':['reward::guard_add','reward::guard_add_with_passport','reward::guard_remove_expired','reward::guard_remove_expired_with_passport'],'sdk_exposed':!![]};export const REWARD_COIN_ADD={'index':0x99,'name':'REWARD_COIN_ADD','description':'Deposit\x20Coin<T>\x20directly\x20into\x20Reward\x20balance\x20(joins\x20Balance<T>)','governed_operations':['reward::coin_add','reward::coin_add_with_passport'],'sdk_exposed':!![]};export const REWARD_RECEIVE={'index':0x9a,'name':'REWARD_RECEIVE','description':'Receive\x20CoinWrapper<T>\x20via\x20Payment.unwrap_with_check\x20(joins\x20Balance<T>)','governed_operations':['reward::receive','reward::receive_with_passport'],'sdk_exposed':!![]};export const REWARD_GUARD_EXPIRATION_TIME_ADD={'index':0x9b,'name':'REWARD_GUARD_EXPIRATION_TIME_ADD','description':'Set\x20/\x20cancel\x20guard_not_added_expiration_time\x20(time-lock\x20on\x20new\x20guard\x20additions)','governed_operations':['reward::guard_expiration_time_add','reward::guard_expiration_time_add_with_passport'],'sdk_exposed':!![]};export const REWARD_OWNER_RECEIVE={'index':0x9c,'name':'REWARD_OWNER_RECEIVE','description':'Owner\x20receives\x20Receiving<K>\x20/\x20CoinWrapper<K>\x20at\x20terminal\x20state\x20(unwrap\x20→\x20owner)','governed_operations':['reward::owner_receive','reward::owner_receive_with_passport','reward::owner_receive_object','reward::owner_receive_object_with_passport'],'sdk_exposed':!![]};export const REWARD_UM={'index':0x9d,'name':'REWARD_UM','description':'Bind\x20/\x20unbind\x20Contact\x20(UM)\x20for\x20off-chain\x20coordination','governed_operations':['reward::um_set','reward::um_set_with_passport','reward::um_none','reward::um_none_with_passport'],'sdk_exposed':!![]};export const REWARD_PERMISSIONS=[REWARD_NEW,REWARD_DESCRIPTION,REWARD_GUARD,REWARD_COIN_ADD,REWARD_RECEIVE,REWARD_GUARD_EXPIRATION_TIME_ADD,REWARD_OWNER_RECEIVE,REWARD_UM];export const REWARD_FIELDS=[{'name':'id','move_type':'UID','mutability':'immutable','set_at_creation':!![],'constraint':'Object\x20UID;\x20assigned\x20in\x20new_imp\x20via\x20object::new(ctx).\x20Never\x20changes.'},{'name':'description','move_type':'String','mutability':'admin_mutable','set_at_creation':!![],'permission_index':0x97,'constraint':'Must\x20satisfy\x20common::DESCRIPTION.\x20Updated\x20via\x20description_set\x20(151).'},{'name':'guards','move_type':'vector<RewardGuard>','mutability':'admin_mutable','set_at_creation':!![],'permission_index':0x98,'constraint':'vector::length\x20<\x20MAX_GUARD_COUNT\x20(200);\x20E_GUARD_COUNT_EXCEEDED\x20on\x20overflow.','related_errors':['E_GUARD_COUNT_EXCEEDED']},{'name':'balance','move_type':'Balance<T>','mutability':'runtime','set_at_creation':!![],'constraint':'Zero\x20at\x20creation\x20(balance::zero());\x20grows\x20via\x20coin_add/receive;\x20shrinks\x20via\x20claim\x20(split)\x20and\x20never\x20via\x20direct\x20withdraw.','related_errors':['E_INSUFFICIENT_BALANCE']},{'name':'guard_not_added_expiration_time','move_type':'Option<u64>','mutability':'admin_mutable','set_at_creation':!![],'permission_index':0x9b,'constraint':'Option<timestamp_ms>.\x20When\x20Some(t):\x20guard_add\x20requires\x20clock\x20>\x20t\x20(E_GUARD_LOCKED_TIME).\x20When\x20None\x20or\x20t\x20<\x20now:\x20guards\x20can\x20be\x20added.','related_errors':['E_GUARD_LOCKED_TIME','E_GUARD_LOCKED_TIME_NOT_INCREASING','E_GUARD_LOCKED_TIME_INVALID']},{'name':'record','move_type':'ParentTable<address,\x20RecipientRecord>','mutability':'runtime','set_at_creation':!![],'constraint':'Per-recipient\x20claim\x20history.\x20Each\x20RecipientRecord.amount\x20vector\x20has\x20length\x20<\x20MAX_RECORD_COUNT\x20(5200);\x20E_RECORD_COUNT_EXCEEDED\x20on\x20overflow.','related_errors':['E_RECORD_COUNT_EXCEEDED']},{'name':'um','move_type':'Option<address>','mutability':'admin_mutable','set_at_creation':!![],'permission_index':0x9d,'constraint':'Option<Contact\x20address>.\x20um_set\x20creates\x20Registrar\x20affiliation;\x20um_none\x20disaffiliates.'},{'name':'permission','move_type':'address','mutability':'admin_mutable','set_at_creation':!![],'constraint':'Permission\x20object\x20address.\x20Updated\x20via\x20permission_set\x20(asserts\x20old.owner\x20==\x20sender).\x20Creates\x20Registrar\x20affiliation_change.'}];export const REWARD_GUARD_CONSTRUCTORS=[{'constructor':'guard_u8_u8','recipient_type':'GuardIdentifier','amount_type':'GuardU64Identifier','params':{'recipient_param':'u8','amount_param':'u8','expiration_time':'Option<u64>','store_from_id':'Option<u8>'},'construction_checks':['is_identifier_address(guard,\x20recipient)\x20—\x20E_RECIPIENT_IDENTIFIER_NOT_ADDRESS\x20(4)','get_submission_value_type(guard,\x20amount)\x20must\x20be\x20Some(TYPE_U64)\x20—\x20E_AMOUNT_NOT_U64\x20(5)','if\x20store_from_id\x20is\x20Some:\x20is_identifier_address_compatible\x20—\x20E_STORE_FROM_ID_NOT_COMPATIBLE\x20(12)'],'typical_use':'Dynamic\x20recipient\x20+\x20dynamic\x20amount\x20—\x20both\x20extracted\x20from\x20Passport\x20at\x20claim\x20time\x20(e.g.\x20referral\x20rewards\x20where\x20referrer\x20and\x20amount\x20vary\x20per\x20claim).'},{'constructor':'guard_u8_u64','recipient_type':'GuardIdentifier','amount_type':'Fixed','params':{'recipient_param':'u8','amount_param':'u64','expiration_time':'Option<u64>','store_from_id':'Option<u8>'},'construction_checks':['is_identifier_address(guard,\x20recipient)\x20—\x20E_RECIPIENT_IDENTIFIER_NOT_ADDRESS\x20(4)','if\x20store_from_id\x20is\x20Some:\x20is_identifier_address_compatible\x20—\x20E_STORE_FROM_ID_NOT_COMPATIBLE\x20(12)'],'typical_use':'Dynamic\x20recipient\x20+\x20fixed\x20amount\x20—\x20e.g.\x20first-order\x20reward\x20where\x20any\x20new\x20customer\x20claims\x20a\x20fixed\x201\x20WOW.'},{'constructor':'guard_entity_u8','recipient_type':'Entity','amount_type':'GuardU64Identifier','params':{'recipient_param':'address','amount_param':'u8','expiration_time':'Option<u64>','store_from_id':'Option<u8>'},'construction_checks':['get_submission_value_type(guard,\x20amount)\x20must\x20be\x20Some(TYPE_U64)\x20—\x20E_AMOUNT_NOT_U64\x20(5)','if\x20store_from_id\x20is\x20Some:\x20is_identifier_address_compatible\x20—\x20E_STORE_FROM_ID_NOT_COMPATIBLE\x20(12)'],'typical_use':'Fixed\x20recipient\x20+\x20dynamic\x20amount\x20—\x20e.g.\x20tiered\x20loyalty\x20reward\x20where\x20amount\x20depends\x20on\x20Passport\x20submission\x20(tier\x20level).'},{'constructor':'guard_entity_u64','recipient_type':'Entity','amount_type':'Fixed','params':{'recipient_param':'address','amount_param':'u64','expiration_time':'Option<u64>','store_from_id':'Option<u8>'},'construction_checks':['if\x20store_from_id\x20is\x20Some:\x20is_identifier_address_compatible\x20—\x20E_STORE_FROM_ID_NOT_COMPATIBLE\x20(12)'],'typical_use':'Fully\x20fixed\x20recipient\x20+\x20amount\x20—\x20simplest\x20configuration\x20(e.g.\x20specific\x20partner\x20bounty).'},{'constructor':'guard_signer_u8','recipient_type':'Signer','amount_type':'GuardU64Identifier','params':{'amount_param':'u8','expiration_time':'Option<u64>','store_from_id':'Option<u8>'},'construction_checks':['get_submission_value_type(guard,\x20amount)\x20must\x20be\x20Some(TYPE_U64)\x20—\x20E_AMOUNT_NOT_U64\x20(5)','if\x20store_from_id\x20is\x20Some:\x20is_identifier_address_compatible\x20—\x20E_STORE_FROM_ID_NOT_COMPATIBLE\x20(12)'],'typical_use':'Caller\x20is\x20recipient\x20+\x20dynamic\x20amount\x20—\x20e.g.\x20self-service\x20claim\x20where\x20amount\x20depends\x20on\x20Passport\x20submission\x20(e.g.\x20cashback\x20rate).'},{'constructor':'guard_signer_u64','recipient_type':'Signer','amount_type':'Fixed','params':{'amount_param':'u64','expiration_time':'Option<u64>','store_from_id':'Option<u8>'},'construction_checks':['if\x20store_from_id\x20is\x20Some:\x20is_identifier_address_compatible\x20—\x20E_STORE_FROM_ID_NOT_COMPATIBLE\x20(12)'],'typical_use':'Caller\x20is\x20recipient\x20+\x20fixed\x20amount\x20—\x20e.g.\x20flash\x20sale\x20where\x20any\x20eligible\x20caller\x20claims\x20a\x20fixed\x20reward.'}];export const REWARD_ERROR_CODES=[{'code':0x1,'name':'E_GUARD_LOCKED_TIME_NOT_INCREASING','description':'guard_expiration_time_add:\x20new\x20time\x20<\x20current\x20clock\x20(must\x20be\x20≥\x20now)','trigger_operation':'guard_expiration_time_add'},{'code':0x2,'name':'E_GUARD_EXPIRED','description':'guard_add\x20on\x20guard\x20with\x20expiration_time\x20<\x20now,\x20OR\x20claim\x20on\x20guard\x20with\x20expiration_time\x20<\x20now','trigger_operation':'guard_add\x20/\x20claim'},{'code':0x3,'name':'E_GUARD_COUNT_EXCEEDED','description':'guard_add\x20would\x20exceed\x20MAX_GUARD_COUNT=200\x20(only\x20on\x20NEW\x20guard,\x20not\x20on\x20update\x20of\x20existing)','trigger_operation':'guard_add'},{'code':0x4,'name':'E_RECIPIENT_IDENTIFIER_NOT_ADDRESS','description':'RewardGuard\x20constructor:\x20recipient\x20identifier\x20type\x20is\x20not\x20address\x20(GuardIdentifier\x20variant\x20only)','trigger_operation':'reward_guard\x20(constructor)'},{'code':0x5,'name':'E_AMOUNT_NOT_U64','description':'RewardGuard\x20constructor:\x20amount\x20identifier\x20type\x20is\x20not\x20u64\x20(GuardU64Identifier\x20variant\x20only)','trigger_operation':'reward_guard\x20(constructor)'},{'code':0x6,'name':'E_INSUFFICIENT_BALANCE','description':'claim:\x20balance\x20<\x20amount\x20(cannot\x20split\x20more\x20than\x20held)','trigger_operation':'claim'},{'code':0x7,'name':'E_GUARD_NOT_FOUND','description':'claim:\x20no\x20guard\x20in\x20self.guards\x20matches\x20the\x20supplied\x20guard\x20address','trigger_operation':'claim'},{'code':0x8,'name':'E_RECORD_COUNT_EXCEEDED','description':'claim:\x20recipient\x20already\x20has\x20MAX_RECORD_COUNT=5200\x20entries\x20(E_RECORD_COUNT_EXCEEDED)','trigger_operation':'claim'},{'code':0xa,'name':'E_GUARD_LOCKED_TIME','description':'guard_add\x20while\x20guard_not_added_expiration_time\x20is\x20Some\x20and\x20clock\x20≤\x20expiration_time','trigger_operation':'guard_add'},{'code':0xb,'name':'E_GUARD_LOCKED_TIME_INVALID','description':'guard_expiration_time_add:\x20new\x20Some(t)\x20where\x20t\x20≤\x20now\x20(must\x20be\x20future)','trigger_operation':'guard_expiration_time_add'},{'code':0xc,'name':'E_STORE_FROM_ID_NOT_COMPATIBLE','description':'RewardGuard\x20constructor:\x20store_from_id\x20identifier\x20type\x20is\x20not\x20number\x20or\x20address','trigger_operation':'reward_guard\x20(constructor)'}];export const REWARD_SCENES=[{'id':'reward_first_order','name':'First-order\x20reward','industry':['universal','ecommerce','service','freelance'],'scenario':'New\x20customers\x20receive\x20a\x20fixed\x20reward\x20after\x20their\x20first\x20order.\x20Guard\x20verifies\x20order\x20ownership\x20+\x20first-time\x20status;\x20'+'Recipient=Signer\x20(caller\x20is\x20the\x20new\x20customer);\x20Amount=Fixed\x20(e.g.\x201\x20WOW).','phases':['creation','guard_addition','funds_replenish','claim'],'coin_type_note':'T\x20=\x20project\x20reward\x20coin\x20(e.g.\x200x2::wow::WOW\x20or\x20a\x20custom\x20token)','typical_guard_count':0x1,'recipient_types_used':['Signer'],'amount_types_used':['Fixed'],'uses_expiration_time':!![],'uses_store_from_id':![],'builtin_indexes_consumed':[REWARD_NEW,REWARD_GUARD,REWARD_COIN_ADD],'common_patterns':['guard_signer_u64\x20—\x20caller\x20claims\x20a\x20fixed\x20amount\x20(e.g.\x201\x20WOW)','Guard\x20verifies:\x20order_address.holder\x20==\x20signer\x20AND\x20order\x20is\x20the\x20first\x20order\x20(Repository\x20query)','expiration_time\x20bounds\x20the\x20campaign\x20window\x20(e.g.\x2030\x20days)','coin_add\x20deposits\x20the\x20campaign\x20budget\x20upfront\x20(e.g.\x20100\x20WOW\x20for\x20100\x20claims)'],'recommended_templates':['first_order']},{'id':'reward_referral','name':'Referral\x20viral\x20reward','industry':['universal','ecommerce','service','content'],'scenario':'Both\x20referrer\x20and\x20referee\x20receive\x20a\x20reward\x20when\x20the\x20referee\x20completes\x20a\x20first\x20order.\x20Two\x20guards:\x20one\x20for\x20referrer\x20(Entity),\x20one\x20for\x20referee\x20(Signer).','phases':['creation','guard_addition','funds_replenish','claim'],'coin_type_note':'T\x20=\x20project\x20reward\x20coin','typical_guard_count':0x2,'recipient_types_used':['Entity','Signer'],'amount_types_used':['Fixed'],'uses_expiration_time':!![],'uses_store_from_id':!![],'builtin_indexes_consumed':[REWARD_NEW,REWARD_GUARD,REWARD_COIN_ADD],'common_patterns':['guard_entity_u64\x20for\x20referrer\x20(recipient\x20=\x20referrer\x20address,\x20fixed\x20amount)','guard_signer_u64\x20for\x20referee\x20(caller\x20is\x20recipient,\x20fixed\x20amount)','Guard\x20verifies:\x20referrer\x20marked\x20in\x20Repository\x20AND\x20referee\x27s\x20order\x20completed','store_from_id\x20may\x20record\x20the\x20order\x20address\x20for\x20audit\x20trail'],'recommended_templates':['referral']},{'id':'reward_loyalty','name':'Loyalty\x20tiered\x20reward','industry':['universal','ecommerce','subscription','content'],'scenario':'Customers\x20unlock\x20higher\x20rewards\x20after\x20reaching\x20cumulative\x20spending\x20tiers.\x20Recipient=Signer;\x20Amount=GuardU64Identifier\x20(tier-dependent\x20amount\x20extracted\x20from\x20Passport).','phases':['creation','guard_addition','funds_replenish','claim'],'coin_type_note':'T\x20=\x20project\x20reward\x20coin','typical_guard_count':0x1,'recipient_types_used':['Signer'],'amount_types_used':['GuardU64Identifier'],'uses_expiration_time':![],'uses_store_from_id':![],'builtin_indexes_consumed':[REWARD_NEW,REWARD_GUARD,REWARD_COIN_ADD],'common_patterns':['guard_signer_u8\x20—\x20amount\x20is\x20dynamic,\x20extracted\x20from\x20Passport\x20submission\x20(tier\x20level\x20→\x20reward\x20amount)','Guard\x20verifies:\x20cumulative\x20spend\x20≥\x20tier\x20threshold\x20(Repository\x20query)','No\x20expiration_time\x20—\x20loyalty\x20is\x20perpetual\x20(until\x20deactivated\x20via\x20guard_remove_expired)','Guard\x20submission\x20value\x20type\x20MUST\x20be\x20u64\x20(E_AMOUNT_NOT_U64\x20otherwise)'],'recommended_templates':['loyalty']},{'id':'reward_flash_sale','name':'Limited-time\x20flash\x20sale\x20reward','industry':['universal','ecommerce','retail'],'scenario':'Time-bounded\x20reward\x20for\x20the\x20first\x20N\x20callers.\x20Recipient=Signer;\x20Amount=Fixed.\x20Guard\x20verifies\x20time\x20window\x20+\x20claim\x20count.','phases':['creation','guard_addition','funds_replenish','claim','guard_lock_mgmt'],'coin_type_note':'T\x20=\x20project\x20reward\x20coin','typical_guard_count':0x1,'recipient_types_used':['Signer'],'amount_types_used':['Fixed'],'uses_expiration_time':!![],'uses_store_from_id':![],'builtin_indexes_consumed':[REWARD_NEW,REWARD_GUARD,REWARD_COIN_ADD,REWARD_GUARD_EXPIRATION_TIME_ADD],'common_patterns':['guard_signer_u64\x20—\x20fixed\x20amount\x20per\x20claim\x20(e.g.\x202\x20WOW)','expiration_time\x20bounds\x20the\x20flash\x20sale\x20window\x20(e.g.\x2048\x20hours)','guard_expiration_time_add\x20(155)\x20may\x20lock\x20further\x20guard\x20additions\x20during\x20the\x20sale','Budget\x20=\x20max_claims\x20×\x20amount;\x20coin_add\x20deposits\x20this\x20upfront'],'recommended_templates':['flash_sale']},{'id':'reward_bulk_discount','name':'Bulk\x20discount\x20/\x20cashback\x20reward','industry':['universal','ecommerce','wholesale','service'],'scenario':'Customer\x20receives\x20cashback\x20proportional\x20to\x20order\x20size.\x20Recipient=Signer\x20or\x20Entity\x20(order\x20holder);\x20Amount=GuardU64Identifier\x20(cashback\x20rate\x20from\x20Passport).','phases':['creation','guard_addition','funds_replenish','claim'],'coin_type_note':'T\x20=\x20payment\x20coin\x20type\x20(must\x20match\x20order\x20payment\x20for\x20clean\x20cashback)','typical_guard_count':0x1,'recipient_types_used':['Signer','Entity'],'amount_types_used':['GuardU64Identifier'],'uses_expiration_time':![],'uses_store_from_id':!![],'builtin_indexes_consumed':[REWARD_NEW,REWARD_GUARD,REWARD_COIN_ADD,REWARD_RECEIVE],'common_patterns':['guard_signer_u8\x20—\x20caller\x20claims\x20dynamic\x20amount\x20(cashback\x20=\x20order_amount\x20×\x20rate)','store_from_id\x20records\x20the\x20order\x20address\x20for\x20cross-reference\x20(audit\x20trail)','receive\x20(154)\x20may\x20be\x20used\x20to\x20accept\x20CoinWrapper<T>\x20refunds\x20that\x20replenish\x20the\x20balance','Guard\x20verifies:\x20order.completed\x20AND\x20order.service\x20==\x20this\x20Service'],'recommended_templates':['cashback']},{'id':'reward_milestone','name':'Service\x20milestone\x20reward','industry':['universal','ecommerce','content','subscription'],'scenario':'When\x20a\x20Service\x20reaches\x20a\x20milestone\x20(e.g.\x20100\x20orders),\x20early\x20supporters\x20receive\x20extra\x20rewards.\x20Recipient=Entity\x20(early\x20customer);\x20Amount=Fixed.','phases':['creation','guard_addition','funds_replenish','claim','guard_lock_mgmt'],'coin_type_note':'T\x20=\x20project\x20reward\x20coin','typical_guard_count':0x32,'recipient_types_used':['Entity'],'amount_types_used':['Fixed'],'uses_expiration_time':!![],'uses_store_from_id':![],'builtin_indexes_consumed':[REWARD_NEW,REWARD_GUARD,REWARD_COIN_ADD,REWARD_GUARD_EXPIRATION_TIME_ADD],'common_patterns':['guard_entity_u64\x20for\x20each\x20early\x20customer\x20(recipient\x20=\x20customer\x20address,\x20fixed\x20amount)','Multiple\x20guards\x20(up\x20to\x2050\x20for\x2050\x20early\x20supporters)\x20—\x20well\x20within\x20MAX_GUARD_COUNT=200','Guard\x20verifies:\x20Service\x20order_count\x20>=\x20milestone\x20AND\x20claimer\x20is\x20in\x20early-customer\x20list','guard_expiration_time_add\x20(155)\x20may\x20lock\x20the\x20guard\x20list\x20after\x20milestone\x20setup'],'recommended_templates':['milestone']}];export const REWARD_LEDGER_VERSION='1.0.0';export function getScenesByPhase(a){return REWARD_SCENES['filter'](b=>b['phases']['includes'](a));}export function findSceneById(a){return REWARD_SCENES['find'](b=>b['id']===a);}export function getScenesByIndustry(a){return REWARD_SCENES['filter'](b=>b['industry']['includes'](a)||b['industry']['includes']('universal'));}export function getBuiltinPermissionByIndex(a){return REWARD_PERMISSIONS['find'](b=>b['index']===a);}export function isRewardBuiltinPermission(a){return getBuiltinPermissionByIndex(a)!==undefined;}export function getAllBuiltinPermissions(){return[...REWARD_PERMISSIONS];}export function getRewardScenesCount(){return REWARD_SCENES['length'];}export function getGuardConstructorSpec(a){return REWARD_GUARD_CONSTRUCTORS['find'](b=>b['constructor']===a);}export function resolveGuardConstructor(a,b){const c={'GuardIdentifier|GuardU64Identifier':'guard_u8_u8','GuardIdentifier|Fixed':'guard_u8_u64','Entity|GuardU64Identifier':'guard_entity_u8','Entity|Fixed':'guard_entity_u64','Signer|GuardU64Identifier':'guard_signer_u8','Signer|Fixed':'guard_signer_u64'};return c[a+'|'+b];}export function getRewardErrorByCode(a){return REWARD_ERROR_CODES['find'](b=>b['code']===a);}export function getRewardErrorByName(a){return REWARD_ERROR_CODES['find'](b=>b['name']===a);}export function validateGuardCount(a){if(a>=MAX_GUARD_COUNT_REWARD)return{'ok':![],'violation':'Guard\x20count\x20'+a+'\x20would\x20exceed\x20MAX_GUARD_COUNT_REWARD\x20'+MAX_GUARD_COUNT_REWARD};return{'ok':!![]};}export function validateRecordCount(a){if(a>=MAX_RECORD_COUNT_REWARD)return{'ok':![],'violation':'Record\x20count\x20'+a+'\x20would\x20exceed\x20MAX_RECORD_COUNT_REWARD\x20'+MAX_RECORD_COUNT_REWARD+'\x20—\x20recipient\x20can\x20no\x20longer\x20claim'};return{'ok':!![]};}export function inferSceneFromIntent(a){const b=a['toLowerCase'](),c=[['flash\x20sale','reward_flash_sale'],['flash_sale','reward_flash_sale'],['limited-time','reward_flash_sale'],['limited\x20time','reward_flash_sale'],['referral','reward_referral'],['viral','reward_referral'],['refer\x20a\x20friend','reward_referral'],['invite','reward_referral'],['loyalty','reward_loyalty'],['tiered','reward_loyalty'],['tier','reward_loyalty'],['repeat','reward_loyalty'],['cashback','reward_bulk_discount'],['bulk\x20discount','reward_bulk_discount'],['bulk_discount','reward_bulk_discount'],['wholesale','reward_bulk_discount'],['milestone','reward_milestone'],['early\x20supporter','reward_milestone'],['early\x20customer','reward_milestone'],['first\x20order','reward_first_order'],['first_order','reward_first_order'],['new\x20customer','reward_first_order'],['first-time','reward_first_order']];for(const [d,e]of c){if(b['includes'](d)){const f=findSceneById(e);if(f)return f;}}return undefined;}export const REWARD_CROSS_OBJECT_REFS=[{'object':'Permission','phase':'universal','relationship':'Reward.permission\x20(address;\x20borrowed\x20for\x20all\x20150-157\x20assertions)'},{'object':'Permission','phase':'permission_update','relationship':'permission_set:\x20asserts\x20old.owner\x20==\x20sender;\x20creates\x20Registrar\x20affiliation_change'},{'object':'Guard','phase':'guard_addition','relationship':'RewardGuard.guard\x20=\x20guard.id_address\x20(each\x20guard\x20registered\x20via\x20Registrar\x20affiliation)'},{'object':'Guard','phase':'claim','relationship':'claim:\x20iterates\x20self.guards\x20looking\x20for\x20guard.id_address\x20match;\x20E_GUARD_NOT_FOUND\x20if\x20no\x20match'},{'object':'Guard','phase':'claim','relationship':'claim:\x20passport::result_for_guard(passport,\x20guard_id)\x20verifies\x20submission\x20data'},{'object':'Passport','phase':'claim','relationship':'claim:\x20passport::submission_get\x20extracts\x20recipient\x20(address)\x20and/or\x20amount\x20(u64)\x20per\x20RewardGuard\x20variant'},{'object':'Passport','phase':'claim','relationship':'claim:\x20if\x20store_from_id\x20is\x20Some,\x20extracts\x20store-from\x20address\x20from\x20Passport\x20submission'},{'object':'Payment','phase':'funds_replenish','relationship':'receive\x20(154):\x20Payment.unwrap_with_check\x20extracts\x20Coin<T>\x20from\x20CoinWrapper<T>\x20and\x20joins\x20balance'},{'object':'Payment','phase':'owner_receive','relationship':'owner_receive\x20(156):\x20Payment.unwrap_with_check\x20forwards\x20CoinWrapper<K>\x20to\x20Permission\x20owner'},{'object':'Repository','phase':'claim','relationship':'Guard\x20may\x20query\x20Repository\x20(e.g.\x20order\x20history\x20for\x20first-order\x20/\x20loyalty\x20verification)'},{'object':'Service','phase':'claim','relationship':'Guard\x20may\x20verify\x20order.service\x20==\x20this\x20Service\x20(cashback\x20/\x20first-order\x20scenarios)'},{'object':'Demand','phase':'guard_addition','relationship':'Guard\x20may\x20be\x20shared\x20with\x20Demand\x20(recommendation\x20filtering);\x20same\x20Guard\x20object\x20address\x20space'},{'object':'Allocation','phase':'owner_receive','relationship':'Terminal\x20Allocation\x20alloc\x20may\x20route\x20funds\x20back\x20to\x20Reward\x20(replenishment\x20loop)'},{'object':'Contact','phase':'um_mgmt','relationship':'um_set\x20(157):\x20binds\x20Contact\x20(UM)\x20for\x20off-chain\x20coordination;\x20creates\x20Registrar\x20affiliation'},{'object':'Coin','phase':'universal','relationship':'Reward<phantom\x20T>:\x20T\x20is\x20the\x20coin\x20type;\x20balance:\x20Balance<T>;\x20coin_add\x20expects\x20Coin<T>'}];