@wowok/agent-mcp 2.7.1 → 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 (375) 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.js +1 -397
  13. package/dist/customer/types.js +1 -13
  14. package/dist/customer/user-preferences.js +1 -460
  15. package/dist/evaluation/arbitration-game.d.ts +9 -2
  16. package/dist/evaluation/arbitration-game.js +1 -48
  17. package/dist/evaluation/builtins/demand-match.js +1 -153
  18. package/dist/evaluation/builtins/index.js +1 -10
  19. package/dist/evaluation/builtins/service-risk.js +1 -55
  20. package/dist/evaluation/capability.js +1 -13
  21. package/dist/evaluation/composer.js +1 -40
  22. package/dist/evaluation/engine.js +1 -175
  23. package/dist/evaluation/extract.js +1 -115
  24. package/dist/evaluation/game-strategy.d.ts +27 -0
  25. package/dist/evaluation/game-strategy.js +1 -0
  26. package/dist/evaluation/gap.js +1 -100
  27. package/dist/evaluation/index.d.ts +1 -0
  28. package/dist/evaluation/index.js +1 -11
  29. package/dist/evaluation/node-game.d.ts +31 -3
  30. package/dist/evaluation/node-game.js +1 -57
  31. package/dist/evaluation/region.js +1 -36
  32. package/dist/evaluation/types.d.ts +1 -0
  33. package/dist/evaluation/types.js +1 -1
  34. package/dist/evaluation/user-injection.js +1 -27
  35. package/dist/experience/experience-reuse.js +1 -103
  36. package/dist/experience/index.js +1 -5
  37. package/dist/experience/intent-distill.js +1 -83
  38. package/dist/experience/realtime-feedback.js +1 -94
  39. package/dist/experience/types.js +1 -1
  40. package/dist/experience/user-profile.js +1 -171
  41. package/dist/extensions/business-modules.js +1 -287
  42. package/dist/extensions/capability-manifest.js +1 -781
  43. package/dist/extensions/constraint-registry.js +1 -198
  44. package/dist/extensions/index.js +1 -6
  45. package/dist/extensions/metric-registry.js +1 -257
  46. package/dist/extensions/mode-evaluator.js +1 -170
  47. package/dist/extensions/modes.js +1 -499
  48. package/dist/extensions/registry.js +1 -717
  49. package/dist/extensions/types.js +1 -1
  50. package/dist/harness/auto-escalation.js +1 -68
  51. package/dist/harness/checkpoint.js +1 -129
  52. package/dist/harness/index.js +1 -78
  53. package/dist/harness/plan.js +1 -315
  54. package/dist/harness/recover.js +1 -139
  55. package/dist/harness/types.js +1 -1
  56. package/dist/harness/verify.js +1 -237
  57. package/dist/index.js +1 -273
  58. package/dist/intent/enrich.js +1 -67
  59. package/dist/intent/index.js +1 -60
  60. package/dist/intent/matcher.js +1 -81
  61. package/dist/intent/store.js +1 -55
  62. package/dist/intent/types.js +1 -10
  63. package/dist/knowledge/acquisition-flywheel.js +1 -192
  64. package/dist/knowledge/allocation-confirm.js +1 -534
  65. package/dist/knowledge/allocation-context.js +1 -249
  66. package/dist/knowledge/allocation-ledger.js +1 -463
  67. package/dist/knowledge/allocation-puzzle.js +1 -298
  68. package/dist/knowledge/allocation-risk.js +1 -568
  69. package/dist/knowledge/allocation-templates.js +1 -970
  70. package/dist/knowledge/allocation-translation.js +1 -585
  71. package/dist/knowledge/arb-risk.js +1 -210
  72. package/dist/knowledge/arbitration-confirm.js +1 -559
  73. package/dist/knowledge/arbitration-context.js +1 -505
  74. package/dist/knowledge/arbitration-ledger.js +1 -521
  75. package/dist/knowledge/arbitration-puzzle.js +1 -304
  76. package/dist/knowledge/arbitration-risk.js +1 -423
  77. package/dist/knowledge/arbitration-templates.js +1 -276
  78. package/dist/knowledge/arbitration-translation.js +1 -487
  79. package/dist/knowledge/arbitration-trust.js +1 -117
  80. package/dist/knowledge/audit-rules.js +1 -141
  81. package/dist/knowledge/bridge-risk.js +1 -263
  82. package/dist/knowledge/contact-risk.js +1 -200
  83. package/dist/knowledge/contact-templates.js +1 -60
  84. package/dist/knowledge/demand-confirm.js +1 -206
  85. package/dist/knowledge/demand-matching.js +1 -132
  86. package/dist/knowledge/demand-risk.js +1 -240
  87. package/dist/knowledge/demand-translation.js +1 -354
  88. package/dist/knowledge/deployment-scanner.js +1 -823
  89. package/dist/knowledge/dynamic-pricing.js +1 -87
  90. package/dist/knowledge/examples-scanner-cli.js +1 -26
  91. package/dist/knowledge/examples-scanner.js +1 -843
  92. package/dist/knowledge/flywheel-loop.js +1 -404
  93. package/dist/knowledge/fund-layer.js +1 -973
  94. package/dist/knowledge/glossary.js +1 -211
  95. package/dist/knowledge/guard-confirm.js +1 -406
  96. package/dist/knowledge/guard-context.js +1 -287
  97. package/dist/knowledge/guard-design-patterns.js +1 -360
  98. package/dist/knowledge/guard-ledger.js +1 -260
  99. package/dist/knowledge/guard-lint.js +1 -670
  100. package/dist/knowledge/guard-migration.js +1 -228
  101. package/dist/knowledge/guard-puzzle.js +1 -805
  102. package/dist/knowledge/guard-render.js +1 -700
  103. package/dist/knowledge/guard-risk.js +1 -1879
  104. package/dist/knowledge/guard-submission-prompt.js +1 -171
  105. package/dist/knowledge/guard-templates.js +1 -1105
  106. package/dist/knowledge/guard-translation.js +1 -1119
  107. package/dist/knowledge/index.js +1 -436
  108. package/dist/knowledge/industry-evolution.js +1 -323
  109. package/dist/knowledge/industry-generalizer.js +1 -381
  110. package/dist/knowledge/industry-registry.js +1 -174
  111. package/dist/knowledge/intent-metrics.d.ts +4 -3
  112. package/dist/knowledge/intent-metrics.js +1 -566
  113. package/dist/knowledge/machine-confirm.js +1 -559
  114. package/dist/knowledge/machine-context.js +1 -833
  115. package/dist/knowledge/machine-ledger.js +1 -338
  116. package/dist/knowledge/machine-puzzle.js +1 -494
  117. package/dist/knowledge/machine-render.js +1 -565
  118. package/dist/knowledge/machine-risk.js +1 -669
  119. package/dist/knowledge/machine-templates.js +1 -1597
  120. package/dist/knowledge/machine-topology.js +1 -234
  121. package/dist/knowledge/machine-translation.js +1 -513
  122. package/dist/knowledge/mcp-schema-audit-cli.js +1 -45
  123. package/dist/knowledge/mcp-schema-audit.js +1 -777
  124. package/dist/knowledge/onchain-constants.js +1 -35
  125. package/dist/knowledge/order-confirm.js +1 -573
  126. package/dist/knowledge/order-context.js +1 -390
  127. package/dist/knowledge/order-ledger.js +1 -341
  128. package/dist/knowledge/order-puzzle.js +1 -255
  129. package/dist/knowledge/order-risk.js +1 -653
  130. package/dist/knowledge/order-templates.js +1 -368
  131. package/dist/knowledge/order-translation.js +1 -550
  132. package/dist/knowledge/overrides-loader.js +1 -65
  133. package/dist/knowledge/passport-confirm.js +1 -531
  134. package/dist/knowledge/passport-context.js +1 -306
  135. package/dist/knowledge/passport-ledger.js +1 -282
  136. package/dist/knowledge/passport-puzzle.js +1 -333
  137. package/dist/knowledge/passport-risk.js +1 -450
  138. package/dist/knowledge/passport-templates.js +1 -568
  139. package/dist/knowledge/passport-translation.js +1 -516
  140. package/dist/knowledge/payment-risk.js +1 -249
  141. package/dist/knowledge/permission-confirm.js +1 -426
  142. package/dist/knowledge/permission-context.js +1 -224
  143. package/dist/knowledge/permission-ledger.js +1 -403
  144. package/dist/knowledge/permission-puzzle.js +1 -173
  145. package/dist/knowledge/permission-risk.js +1 -411
  146. package/dist/knowledge/permission-templates.js +1 -234
  147. package/dist/knowledge/permission-translation.js +1 -350
  148. package/dist/knowledge/personal-risk.js +1 -212
  149. package/dist/knowledge/process-model.js +1 -160
  150. package/dist/knowledge/progress-confirm.js +1 -456
  151. package/dist/knowledge/progress-context.js +1 -452
  152. package/dist/knowledge/progress-ledger.js +1 -330
  153. package/dist/knowledge/progress-puzzle.js +1 -219
  154. package/dist/knowledge/progress-risk.js +1 -461
  155. package/dist/knowledge/progress-templates.js +1 -228
  156. package/dist/knowledge/progress-translation.js +1 -405
  157. package/dist/knowledge/proof-confirm.js +1 -187
  158. package/dist/knowledge/proof-risk.js +1 -207
  159. package/dist/knowledge/proof-translation.js +1 -283
  160. package/dist/knowledge/registrar-risk.js +1 -217
  161. package/dist/knowledge/repository-confirm.js +1 -286
  162. package/dist/knowledge/repository-risk.js +1 -373
  163. package/dist/knowledge/repository-translation.js +1 -445
  164. package/dist/knowledge/reputation-rules.js +1 -99
  165. package/dist/knowledge/resource-risk.js +1 -157
  166. package/dist/knowledge/reward-confirm.js +1 -526
  167. package/dist/knowledge/reward-context.js +1 -504
  168. package/dist/knowledge/reward-ledger.js +1 -502
  169. package/dist/knowledge/reward-puzzle.js +1 -300
  170. package/dist/knowledge/reward-risk.js +1 -627
  171. package/dist/knowledge/reward-templates.js +1 -197
  172. package/dist/knowledge/reward-translation.js +1 -501
  173. package/dist/knowledge/safety-rules.js +1 -404
  174. package/dist/knowledge/scenario-modes.js +1 -321
  175. package/dist/knowledge/service-confirm.js +1 -807
  176. package/dist/knowledge/service-context.js +1 -403
  177. package/dist/knowledge/service-ledger.js +1 -609
  178. package/dist/knowledge/service-puzzle.js +1 -236
  179. package/dist/knowledge/service-risk.js +1 -651
  180. package/dist/knowledge/service-templates.js +1 -456
  181. package/dist/knowledge/service-translation.js +1 -622
  182. package/dist/knowledge/template-registry.js +1 -353
  183. package/dist/knowledge/tool-constraints.js +1 -195
  184. package/dist/knowledge/tools-reference.js +1 -178
  185. package/dist/knowledge/treasury-confirm.js +1 -512
  186. package/dist/knowledge/treasury-context.js +1 -363
  187. package/dist/knowledge/treasury-ledger.js +1 -300
  188. package/dist/knowledge/treasury-puzzle.js +1 -216
  189. package/dist/knowledge/treasury-risk.js +1 -440
  190. package/dist/knowledge/treasury-templates.js +1 -358
  191. package/dist/knowledge/treasury-translation.js +1 -498
  192. package/dist/knowledge/trust-metrics.js +1 -198
  193. package/dist/knowledge/util-risk.js +1 -135
  194. package/dist/loop-engineering/aggregate.js +1 -132
  195. package/dist/loop-engineering/context-collect.js +1 -83
  196. package/dist/loop-engineering/diagnose.js +1 -273
  197. package/dist/loop-engineering/improve.js +1 -405
  198. package/dist/loop-engineering/index.js +1 -4
  199. package/dist/loop-engineering/pipeline.js +1 -56
  200. package/dist/mode-market/index.js +1 -3
  201. package/dist/mode-market/registry.js +1 -124
  202. package/dist/mode-market/review.js +1 -214
  203. package/dist/mode-market/submission.js +1 -85
  204. package/dist/participation/collaborator-interest.d.ts +23 -0
  205. package/dist/participation/collaborator-interest.js +1 -0
  206. package/dist/participation/customer-interest.d.ts +25 -0
  207. package/dist/participation/customer-interest.js +1 -0
  208. package/dist/participation/merchant-interest.js +1 -100
  209. package/dist/participation/radar-core.d.ts +13 -3
  210. package/dist/participation/radar-core.js +1 -269
  211. package/dist/participation/supplier-interest.d.ts +25 -0
  212. package/dist/participation/supplier-interest.js +1 -0
  213. package/dist/persona/analyzer.js +1 -66
  214. package/dist/persona/bridge.js +1 -86
  215. package/dist/persona/defaults.js +1 -195
  216. package/dist/persona/experience-bridge.js +1 -23
  217. package/dist/persona/index.js +1 -71
  218. package/dist/persona/model.js +1 -111
  219. package/dist/persona/store.js +1 -62
  220. package/dist/persona/types.d.ts +3 -1
  221. package/dist/persona/types.js +1 -5
  222. package/dist/project/business-puzzle.js +1 -383
  223. package/dist/project/context-assembly.js +1 -254
  224. package/dist/project/deployment-bridge.js +1 -120
  225. package/dist/project/deployment-doc.js +1 -1126
  226. package/dist/project/edit-planner.js +1 -1342
  227. package/dist/project/evaluation.js +1 -2011
  228. package/dist/project/game-theory.js +1 -177
  229. package/dist/project/graph-builder.js +1 -656
  230. package/dist/project/graph.js +1 -340
  231. package/dist/project/handlers.js +1 -1784
  232. package/dist/project/index.d.ts +1 -0
  233. package/dist/project/index.js +1 -301
  234. package/dist/project/intent-analyzer.js +1 -149
  235. package/dist/project/machine-nodes.js +1 -36
  236. package/dist/project/merchant-guide.js +1 -264
  237. package/dist/project/migration.js +1 -125
  238. package/dist/project/mode-actions.js +1 -309
  239. package/dist/project/namespace.js +1 -206
  240. package/dist/project/participation-radar.js +1 -428
  241. package/dist/project/pipeline-actions.js +1 -109
  242. package/dist/project/project-store.js +1 -422
  243. package/dist/project/query.js +1 -153
  244. package/dist/project/reverse-mapping.d.ts +34 -0
  245. package/dist/project/reverse-mapping.js +1 -0
  246. package/dist/project/risk-aggregator.js +1 -295
  247. package/dist/project/rollback-policy.js +1 -290
  248. package/dist/project/semantic-assembler.js +1 -345
  249. package/dist/project/semantic-graph.js +1 -292
  250. package/dist/project/stage-gate.js +1 -369
  251. package/dist/project/substep-trace.js +1 -332
  252. package/dist/project/task-tracker.js +1 -78
  253. package/dist/role/derivation.d.ts +18 -0
  254. package/dist/role/derivation.js +1 -0
  255. package/dist/role/index.d.ts +5 -0
  256. package/dist/role/index.js +1 -0
  257. package/dist/role/model.d.ts +8 -0
  258. package/dist/role/model.js +1 -0
  259. package/dist/role/resolution.d.ts +11 -0
  260. package/dist/role/resolution.js +1 -0
  261. package/dist/role/types.d.ts +11 -0
  262. package/dist/role/types.js +1 -0
  263. package/dist/rules.js +1 -52
  264. package/dist/safety/confirm-gate.js +1 -88
  265. package/dist/safety/index.js +1 -3
  266. package/dist/safety/preview.js +1 -52
  267. package/dist/schema/call/allocation.js +1 -34
  268. package/dist/schema/call/arbitration.js +1 -113
  269. package/dist/schema/call/base.d.ts +15 -15
  270. package/dist/schema/call/base.js +1 -370
  271. package/dist/schema/call/bridge-handler.js +1 -265
  272. package/dist/schema/call/bridge.d.ts +7 -7
  273. package/dist/schema/call/bridge.js +1 -458
  274. package/dist/schema/call/contact.js +1 -37
  275. package/dist/schema/call/demand.js +1 -47
  276. package/dist/schema/call/guard.js +1 -161
  277. package/dist/schema/call/handler.js +1 -322
  278. package/dist/schema/call/index.js +1 -20
  279. package/dist/schema/call/machine.js +1 -193
  280. package/dist/schema/call/order.js +1 -35
  281. package/dist/schema/call/payment.js +1 -37
  282. package/dist/schema/call/permission-handler.js +1 -54
  283. package/dist/schema/call/permission.js +1 -105
  284. package/dist/schema/call/personal.js +1 -78
  285. package/dist/schema/call/progress.js +1 -47
  286. package/dist/schema/call/proof.js +1 -33
  287. package/dist/schema/call/repository.js +1 -77
  288. package/dist/schema/call/reward.js +1 -30
  289. package/dist/schema/call/semantic.js +1 -1679
  290. package/dist/schema/call/service.js +1 -184
  291. package/dist/schema/call/treasury.js +1 -71
  292. package/dist/schema/common/index.js +1 -407
  293. package/dist/schema/config/index.js +1 -68
  294. package/dist/schema/evaluation/index.d.ts +213 -16
  295. package/dist/schema/evaluation/index.js +1 -356
  296. package/dist/schema/index.js +1 -17
  297. package/dist/schema/intent-radar/index.d.ts +13 -13
  298. package/dist/schema/intent-radar/index.js +1 -89
  299. package/dist/schema/local/index.d.ts +21 -21
  300. package/dist/schema/local/index.js +1 -927
  301. package/dist/schema/local/wip.js +1 -187
  302. package/dist/schema/messenger/index.d.ts +7 -7
  303. package/dist/schema/messenger/index.js +1 -475
  304. package/dist/schema/operations.d.ts +7 -7
  305. package/dist/schema/operations.js +1 -520
  306. package/dist/schema/persona/index.d.ts +54 -54
  307. package/dist/schema/persona/index.js +1 -148
  308. package/dist/schema/project/index.d.ts +94 -48
  309. package/dist/schema/project/index.js +1 -2057
  310. package/dist/schema/query/index.d.ts +423 -7
  311. package/dist/schema/query/index.js +1 -1646
  312. package/dist/schema/schema-query/index.js +1 -104
  313. package/dist/schema/schema-version.js +1 -76
  314. package/dist/schema/sync-layer4.js +1 -286
  315. package/dist/schema/task-status.js +1 -36
  316. package/dist/schema/trust/index.js +1 -314
  317. package/dist/schema/utils/guard-parser.js +1 -419
  318. package/dist/schema/utils/guard-query-utils.js +1 -46
  319. package/dist/schema/utils/node-parser.js +1 -369
  320. package/dist/schema/utils/object-type-utils.js +1 -35
  321. package/dist/schema/utils/permission-index-utils.js +1 -7
  322. package/dist/schema/utils/permission-machine-check.js +1 -121
  323. package/dist/schema/utils/skills-recommendation.js +1 -77
  324. package/dist/schema-query/index.js +1 -810
  325. package/dist/schemas/account_operation.output.json +5 -2
  326. package/dist/schemas/bridge_operation.output.json +5 -2
  327. package/dist/schemas/evaluation_operation.output.json +112 -7
  328. package/dist/schemas/evaluation_operation.schema.json +93 -6
  329. package/dist/schemas/index.json +1 -1
  330. package/dist/schemas/intent_radar.output.json +4 -1
  331. package/dist/schemas/intent_radar.schema.json +4 -1
  332. package/dist/schemas/local_info_operation.output.json +5 -2
  333. package/dist/schemas/local_mark_operation.output.json +5 -2
  334. package/dist/schemas/messenger_operation.output.json +5 -2
  335. package/dist/schemas/onchain_events.output.json +5 -2
  336. package/dist/schemas/onchain_operations.output.json +5 -2
  337. package/dist/schemas/onchain_operations.schema.json +4 -4
  338. package/dist/schemas/onchain_operations_allocation.schema.json +1 -1
  339. package/dist/schemas/onchain_operations_machine.schema.json +2 -2
  340. package/dist/schemas/onchain_operations_service.schema.json +1 -1
  341. package/dist/schemas/onchain_table_data.output.json +6 -3
  342. package/dist/schemas/persona_operation.output.json +4 -1
  343. package/dist/schemas/persona_operation.schema.json +4 -1
  344. package/dist/schemas/project_operation.output.json +28 -8
  345. package/dist/schemas/query_toolkit.output.json +8 -5
  346. package/dist/schemas/wowok_buildin_info.output.json +132 -0
  347. package/dist/schemas/wowok_buildin_info.schema.json +14 -0
  348. package/dist/telemetry/index.js +1 -112
  349. package/dist/telemetry/redact.js +1 -23
  350. package/dist/telemetry/storage.js +1 -80
  351. package/dist/tools/handlers/bridge.js +1 -1
  352. package/dist/tools/handlers/config.js +1 -74
  353. package/dist/tools/handlers/evaluation.js +1 -123
  354. package/dist/tools/handlers/file-export.js +1 -90
  355. package/dist/tools/handlers/intent-radar.js +1 -76
  356. package/dist/tools/handlers/local.js +1 -53
  357. package/dist/tools/handlers/messenger.js +1 -188
  358. package/dist/tools/handlers/onchain.js +1 -1180
  359. package/dist/tools/handlers/persona.js +1 -89
  360. package/dist/tools/handlers/project.js +1 -211
  361. package/dist/tools/handlers/query.js +1 -434
  362. package/dist/tools/handlers/schema-query.js +1 -176
  363. package/dist/tools/handlers/task-status.js +1 -26
  364. package/dist/tools/handlers/trust.js +1 -380
  365. package/dist/tools/handlers/wip.js +1 -90
  366. package/dist/tools/index.js +1 -1382
  367. package/dist/tools/retry.js +1 -85
  368. package/dist/tools/rules-hook.js +1 -23
  369. package/dist/tools/shared.js +1 -130
  370. package/dist/tools/types.js +1 -1
  371. package/dist/tools/upgrade-check.d.ts +19 -0
  372. package/dist/tools/upgrade-check.js +1 -0
  373. package/dist/tools/wip-deploy-assist.js +1 -306
  374. package/dist/tools/wrap.js +1 -500
  375. package/package.json +4 -2
@@ -1,85 +1 @@
1
- export const DEFAULT_FAUCET_RETRY_CONFIG = {
2
- maxRetries: 5,
3
- intervalMs: 3000,
4
- };
5
- export function loadFaucetRetryConfig() {
6
- const maxRetries = Number(process.env.WOWOK_FAUCET_RETRY_COUNT);
7
- const intervalMs = Number(process.env.WOWOK_FAUCET_RETRY_INTERVAL_MS);
8
- return {
9
- maxRetries: Number.isFinite(maxRetries) && maxRetries > 0
10
- ? Math.floor(maxRetries)
11
- : DEFAULT_FAUCET_RETRY_CONFIG.maxRetries,
12
- intervalMs: Number.isFinite(intervalMs) && intervalMs > 0
13
- ? Math.floor(intervalMs)
14
- : DEFAULT_FAUCET_RETRY_CONFIG.intervalMs,
15
- };
16
- }
17
- export function isFaucetRateLimitError(error) {
18
- if (!error)
19
- return false;
20
- const msg = error instanceof Error ? error.message : String(error);
21
- const lower = msg.toLowerCase();
22
- if (lower.includes("429"))
23
- return true;
24
- if (lower.includes("rate limit"))
25
- return true;
26
- if (lower.includes("rate-limit"))
27
- return true;
28
- if (lower.includes("too many requests"))
29
- return true;
30
- if (lower.includes("try again in"))
31
- return true;
32
- if (lower.includes("throttle"))
33
- return true;
34
- return false;
35
- }
36
- function isFaucetOperation(input) {
37
- if (typeof input !== "object" || input === null)
38
- return false;
39
- const obj = input;
40
- return obj.faucet !== undefined && obj.faucet !== null;
41
- }
42
- export function withFaucetRetry(fn, config = loadFaucetRetryConfig()) {
43
- return async (input) => {
44
- if (!isFaucetOperation(input)) {
45
- return fn(input);
46
- }
47
- let lastError;
48
- for (let attempt = 1; attempt <= config.maxRetries; attempt++) {
49
- try {
50
- const result = await fn(input);
51
- if (result && typeof result === "object" && !Array.isArray(result)) {
52
- const obj = result;
53
- if (obj.faucet_retry_count === undefined && attempt > 1) {
54
- obj.faucet_retry_count = attempt;
55
- }
56
- }
57
- return result;
58
- }
59
- catch (error) {
60
- lastError = error;
61
- if (!isFaucetRateLimitError(error)) {
62
- throw error;
63
- }
64
- if (attempt === config.maxRetries) {
65
- break;
66
- }
67
- await new Promise((resolve) => setTimeout(resolve, config.intervalMs));
68
- }
69
- }
70
- const lastMsg = lastError instanceof Error ? lastError.message : String(lastError);
71
- const err = new Error(`Faucet request failed after ${config.maxRetries} attempts ` +
72
- `(interval ${config.intervalMs}ms). Last error: ${lastMsg}. ` +
73
- `The faucet endpoint is currently rate-limiting this account. ` +
74
- `Suggestions:\n` +
75
- ` 1. Wait a few minutes and try again.\n` +
76
- ` 2. Use a different faucet network if available.\n` +
77
- ` 3. Override retry config via env vars: ` +
78
- `WOWOK_FAUCET_RETRY_COUNT (default 5), ` +
79
- `WOWOK_FAUCET_RETRY_INTERVAL_MS (default 3000).`);
80
- if (lastError instanceof Error && lastError.code) {
81
- err.code = lastError.code;
82
- }
83
- throw err;
84
- };
85
- }
1
+ export const DEFAULT_FAUCET_RETRY_CONFIG={'maxRetries':0x5,'intervalMs':0xbb8};export function loadFaucetRetryConfig(){const a=Number(process['env']['WOWOK_FAUCET_RETRY_COUNT']),b=Number(process['env']['WOWOK_FAUCET_RETRY_INTERVAL_MS']);return{'maxRetries':Number['isFinite'](a)&&a>0x0?Math['floor'](a):DEFAULT_FAUCET_RETRY_CONFIG['maxRetries'],'intervalMs':Number['isFinite'](b)&&b>0x0?Math['floor'](b):DEFAULT_FAUCET_RETRY_CONFIG['intervalMs']};}export function isFaucetRateLimitError(a){if(!a)return![];const b=a instanceof Error?a['message']:String(a),c=b['toLowerCase']();if(c['includes']('429'))return!![];if(c['includes']('rate\x20limit'))return!![];if(c['includes']('rate-limit'))return!![];if(c['includes']('too\x20many\x20requests'))return!![];if(c['includes']('try\x20again\x20in'))return!![];if(c['includes']('throttle'))return!![];return![];}function isFaucetOperation(a){if(typeof a!=='object'||a===null)return![];const b=a;return b['faucet']!==undefined&&b['faucet']!==null;}export function withFaucetRetry(a,b=loadFaucetRetryConfig()){return async c=>{if(!isFaucetOperation(c))return a(c);let d;for(let g=0x1;g<=b['maxRetries'];g++){try{const h=await a(c);if(h&&typeof h==='object'&&!Array['isArray'](h)){const i=h;i['faucet_retry_count']===undefined&&g>0x1&&(i['faucet_retry_count']=g);}return h;}catch(j){d=j;if(!isFaucetRateLimitError(j))throw j;if(g===b['maxRetries'])break;await new Promise(k=>setTimeout(k,b['intervalMs']));}}const e=d instanceof Error?d['message']:String(d),f=new Error('Faucet\x20request\x20failed\x20after\x20'+b['maxRetries']+'\x20attempts\x20'+('(interval\x20'+b['intervalMs']+'ms).\x20Last\x20error:\x20'+e+'.\x20')+'The\x20faucet\x20endpoint\x20is\x20currently\x20rate-limiting\x20this\x20account.\x20'+'Suggestions:\x0a'+'\x20\x201.\x20Wait\x20a\x20few\x20minutes\x20and\x20try\x20again.\x0a'+'\x20\x202.\x20Use\x20a\x20different\x20faucet\x20network\x20if\x20available.\x0a'+'\x20\x203.\x20Override\x20retry\x20config\x20via\x20env\x20vars:\x20'+'WOWOK_FAUCET_RETRY_COUNT\x20(default\x205),\x20'+'WOWOK_FAUCET_RETRY_INTERVAL_MS\x20(default\x203000).');d instanceof Error&&d['code']&&(f['code']=d['code']);throw f;};}
@@ -1,23 +1 @@
1
- import { OnchainOperationsSchema, strictParse, getEnvConfig, } from "../schema/index.js";
2
- import { buildPendingConfirmation, buildConstraintError } from "./shared.js";
3
- import { validateOperation, hasBlockingViolations, } from "../knowledge/index.js";
4
- export function applyOnchainRules(args) {
5
- let validated;
6
- try {
7
- validated = strictParse(OnchainOperationsSchema, args, "onchain_operations input");
8
- }
9
- catch {
10
- return null;
11
- }
12
- const env = getEnvConfig(validated.env);
13
- const data = 'data' in validated ? validated.data : undefined;
14
- const gateResult = buildPendingConfirmation(validated.operation_type, data, env);
15
- if (gateResult.structuredContent) {
16
- return gateResult;
17
- }
18
- const constraintViolations = validateOperation(validated.operation_type, data);
19
- if (hasBlockingViolations(constraintViolations)) {
20
- return buildConstraintError(validated.operation_type, constraintViolations);
21
- }
22
- return null;
23
- }
1
+ import{OnchainOperationsSchema,strictParse,getEnvConfig}from'../schema/index.js';import{buildPendingConfirmation,buildConstraintError}from'./shared.js';import{validateOperation,hasBlockingViolations}from'../knowledge/index.js';export function applyOnchainRules(a){let b;try{b=strictParse(OnchainOperationsSchema,a,'onchain_operations\x20input');}catch{return null;}const c=getEnvConfig(b['env']),d='data'in b?b['data']:undefined,e=buildPendingConfirmation(b['operation_type'],d,c);if(e['structuredContent'])return e;const f=validateOperation(b['operation_type'],d);if(hasBlockingViolations(f))return buildConstraintError(b['operation_type'],f);return null;}
@@ -1,130 +1 @@
1
- import { confirmGate } from "../safety/confirm-gate.js";
2
- import { renderPreview } from "../safety/preview.js";
3
- import { validateOperation, hasBlockingViolations, getWarningViolations, } from "../knowledge/index.js";
4
- import { getHarness } from "../harness/index.js";
5
- import { isEnabled as isRuntimeEnabled } from "../config/index.js";
6
- import { classifyError, buildDataSemantic, } from "../schema/call/semantic.js";
7
- import { strictParse } from "../schema/index.js";
8
- export function withHarness(base, operation, intent) {
9
- if (!isRuntimeEnabled("harness"))
10
- return base;
11
- try {
12
- const harness = getHarness();
13
- const expected = harness.expect(operation, intent, base.operation_type, base.data);
14
- return {
15
- ...base,
16
- harness,
17
- expected,
18
- operation_id: `${base.operation_type}_${Date.now()}`,
19
- };
20
- }
21
- catch {
22
- return base;
23
- }
24
- }
25
- export function wrapLocalHandler(config) {
26
- const { schema, operationFn, parseLabel, buildContext } = config;
27
- return async (args) => {
28
- let validated;
29
- try {
30
- validated = strictParse(schema, args, parseLabel);
31
- const result = await operationFn(validated);
32
- const ctx = buildContext(validated);
33
- return {
34
- content: [{ type: "text", text: JSON.stringify(result) }],
35
- structuredContent: {
36
- result: {
37
- status: "success",
38
- data: result,
39
- },
40
- semantic: buildDataSemantic(result, ctx),
41
- },
42
- };
43
- }
44
- catch (error) {
45
- const errorMessage = error instanceof Error ? error.message : String(error);
46
- const ctx = validated ? buildContext(validated) : undefined;
47
- const classified = classifyError(errorMessage);
48
- const errorResult = {
49
- status: "error",
50
- error: errorMessage,
51
- };
52
- if (classified.error_code !== undefined)
53
- errorResult.error_code = classified.error_code;
54
- if (classified.retryable !== undefined)
55
- errorResult.retryable = classified.retryable;
56
- if (classified.recovery_hint !== undefined)
57
- errorResult.recovery_hint = classified.recovery_hint;
58
- return {
59
- content: [{ type: "text", text: `Error: ${errorMessage}` }],
60
- structuredContent: {
61
- result: errorResult,
62
- semantic: buildDataSemantic(undefined, ctx, true, errorMessage),
63
- },
64
- };
65
- }
66
- };
67
- }
68
- export function buildPendingConfirmation(operation_type, data, env) {
69
- const gate = confirmGate(operation_type, data, env, env?.user_intent_phrases);
70
- if (gate.pass)
71
- return { content: [], structuredContent: null };
72
- const preview = gate.preview;
73
- const rendered = renderPreview(preview);
74
- const output = {
75
- message: rendered,
76
- result: {
77
- type: "pending_confirmation",
78
- preview,
79
- rule_id: gate.rule_id,
80
- },
81
- semantic: {
82
- intent: `${operation_type}_awaiting_confirmation`,
83
- status: "pending_input",
84
- summary: `Operation blocked by ConfirmGate (${gate.level}). Review the preview and re-call with env.confirmed=true to proceed.`,
85
- next_actions: [
86
- {
87
- action: "confirm: re-call the SAME operation with env.confirmed=true",
88
- reason: `ConfirmGate rule '${gate.rule_id}' matched. The operation was NOT executed.`,
89
- tool: "onchain_operations",
90
- priority: "required",
91
- },
92
- ],
93
- warnings: preview.warnings ?? [],
94
- },
95
- };
96
- return {
97
- content: [{ type: "text", text: rendered }],
98
- structuredContent: output,
99
- };
100
- }
101
- export function buildConstraintError(operation_type, violations) {
102
- const errors = violations.filter((v) => v.severity === "error");
103
- const errorList = errors.map((v) => ` • [${v.field}] ${v.message}`).join("\n");
104
- const message = `Pre-call constraint violations for '${operation_type}':\n${errorList}\n\nFix the listed field(s) and retry.`;
105
- const output = {
106
- message,
107
- result: {
108
- type: "error",
109
- error: message,
110
- error_code: "invalid_parameter",
111
- retryable: false,
112
- recovery_hint: "Review the constraint violations above and correct the corresponding fields.",
113
- },
114
- };
115
- return {
116
- content: [{ type: "text", text: message }],
117
- structuredContent: output,
118
- };
119
- }
120
- export function buildClassifiedErrorResult(base, error, classified) {
121
- const result = { ...base, error };
122
- if (classified.error_code !== undefined)
123
- result.error_code = classified.error_code;
124
- if (classified.retryable !== undefined)
125
- result.retryable = classified.retryable;
126
- if (classified.recovery_hint !== undefined)
127
- result.recovery_hint = classified.recovery_hint;
128
- return result;
129
- }
130
- export { validateOperation, hasBlockingViolations, getWarningViolations, };
1
+ import{confirmGate}from'../safety/confirm-gate.js';import{renderPreview}from'../safety/preview.js';import{validateOperation,hasBlockingViolations,getWarningViolations}from'../knowledge/index.js';import{getHarness}from'../harness/index.js';import{isEnabled as a317a}from'../config/index.js';import{classifyError,buildDataSemantic}from'../schema/call/semantic.js';import{strictParse}from'../schema/index.js';export function withHarness(a,b,c){if(!a317a('harness'))return a;try{const d=getHarness(),e=d['expect'](b,c,a['operation_type'],a['data']);return{...a,'harness':d,'expected':e,'operation_id':a['operation_type']+'_'+Date['now']()};}catch{return a;}}export function wrapLocalHandler(a){const {schema:b,operationFn:c,parseLabel:d,buildContext:e}=a;return async f=>{let g;try{g=strictParse(b,f,d);const h=await c(g),i=e(g);return{'content':[{'type':'text','text':JSON['stringify'](h)}],'structuredContent':{'result':{'status':'success','data':h},'semantic':buildDataSemantic(h,i)}};}catch(j){const k=j instanceof Error?j['message']:String(j),l=g?e(g):undefined,m=classifyError(k),n={'status':'error','error':k};if(m['error_code']!==undefined)n['error_code']=m['error_code'];if(m['retryable']!==undefined)n['retryable']=m['retryable'];if(m['recovery_hint']!==undefined)n['recovery_hint']=m['recovery_hint'];return{'content':[{'type':'text','text':'Error:\x20'+k}],'structuredContent':{'result':n,'semantic':buildDataSemantic(undefined,l,!![],k)}};}};}export function buildPendingConfirmation(a,b,c){const d=confirmGate(a,b,c,c?.['user_intent_phrases']);if(d['pass'])return{'content':[],'structuredContent':null};const e=d['preview'],f=renderPreview(e),g={'message':f,'result':{'type':'pending_confirmation','preview':e,'rule_id':d['rule_id']},'semantic':{'intent':a+'_awaiting_confirmation','status':'pending_input','summary':'Operation\x20blocked\x20by\x20ConfirmGate\x20('+d['level']+').\x20Review\x20the\x20preview\x20and\x20re-call\x20with\x20env.confirmed=true\x20to\x20proceed.','next_actions':[{'action':'confirm:\x20re-call\x20the\x20SAME\x20operation\x20with\x20env.confirmed=true','reason':'ConfirmGate\x20rule\x20\x27'+d['rule_id']+'\x27\x20matched.\x20The\x20operation\x20was\x20NOT\x20executed.','tool':'onchain_operations','priority':'required'}],'warnings':e['warnings']??[]}};return{'content':[{'type':'text','text':f}],'structuredContent':g};}export function buildConstraintError(a,b){const c=b['filter'](g=>g['severity']==='error'),d=c['map'](g=>'\x20\x20•\x20['+g['field']+']\x20'+g['message'])['join']('\x0a'),e='Pre-call\x20constraint\x20violations\x20for\x20\x27'+a+'\x27:\x0a'+d+'\x0a\x0aFix\x20the\x20listed\x20field(s)\x20and\x20retry.',f={'message':e,'result':{'type':'error','error':e,'error_code':'invalid_parameter','retryable':![],'recovery_hint':'Review\x20the\x20constraint\x20violations\x20above\x20and\x20correct\x20the\x20corresponding\x20fields.'}};return{'content':[{'type':'text','text':e}],'structuredContent':f};}export function buildClassifiedErrorResult(a,b,c){const d={...a,'error':b};if(c['error_code']!==undefined)d['error_code']=c['error_code'];if(c['retryable']!==undefined)d['retryable']=c['retryable'];if(c['recovery_hint']!==undefined)d['recovery_hint']=c['recovery_hint'];return d;}export{validateOperation,hasBlockingViolations,getWarningViolations};
@@ -1 +1 @@
1
- export {};
1
+ export{};
@@ -0,0 +1,19 @@
1
+ export interface UpgradeCheckComponent {
2
+ current: string | null;
3
+ latest: string | null;
4
+ outdated: boolean;
5
+ }
6
+ export interface UpgradeCheckResult {
7
+ mcp: UpgradeCheckComponent;
8
+ sdk: UpgradeCheckComponent;
9
+ client_installed: boolean;
10
+ client_install_hint: string | null;
11
+ upgrade_available: boolean;
12
+ reminder: {
13
+ type: "upgrade" | "install_client" | "none";
14
+ due: boolean;
15
+ message: string | null;
16
+ };
17
+ checked_at: string;
18
+ }
19
+ export declare function checkUpgrade(): Promise<UpgradeCheckResult>;
@@ -0,0 +1 @@
1
+ import{readFileSync,existsSync,writeFileSync,mkdirSync}from'fs';import{join,dirname}from'path';import{fileURLToPath}from'url';import{getWowMcpDir}from'@wowok/wowok';const __dirname=dirname(fileURLToPath(import.meta.url)),MCP_PACKAGE='@wowok/agent-mcp',SDK_PACKAGE='@wowok/wowok',WEEK_MS=0x7*0x18*0x3c*0x3c*0x3e8,REMINDER_FILE=join(getWowMcpDir(),'upgrade-reminder.json');function readMcpVersion(){try{const a=join(__dirname,'..','..','package.json'),b=JSON['parse'](readFileSync(a,'utf-8'));return b['version']??null;}catch{return null;}}function readSdkVersion(){try{const a=fileURLToPath(import.meta.resolve(SDK_PACKAGE));let b=dirname(a);for(let c=0x0;c<0x6;c++){const d=join(b,'package.json');if(existsSync(d)){const e=JSON['parse'](readFileSync(d,'utf-8'));if(e['name']===SDK_PACKAGE)return e['version']??null;}b=dirname(b);}return null;}catch{return null;}}async function fetchNpmLatest(a){const b='https://registry.npmjs.org/'+encodeURIComponent(a)+'/latest',c=new AbortController(),d=setTimeout(()=>c['abort'](),0x1770);try{const e=await fetch(b,{'signal':c['signal']});if(!e['ok'])return null;const f=await e['json']();return f['version']??null;}catch{return null;}finally{clearTimeout(d);}}function compareVersions(c,e){const f=c['split']('.')['map'](h=>parseInt(h,0xa)||0x0),g=e['split']('.')['map'](h=>parseInt(h,0xa)||0x0);for(let h=0x0;h<Math['max'](f['length'],g['length']);h++){const j=(f[h]||0x0)-(g[h]||0x0);if(j!==0x0)return j;}return 0x0;}function detectClientInstall(){const a=[];if(process['platform']==='win32'){const b=process['env']['LOCALAPPDATA'];b&&(a['push'](join(b,'WoWok','WoWok.exe')),a['push'](join(b,'Programs','WoWok','WoWok.exe')));}else{if(process['platform']==='darwin')a['push']('/Applications/WoWok.app');else{const d=process['env']['HOME']||process['env']['USERPROFILE']||'';d&&(a['push'](join(d,'.local','share','applications','wowok.desktop')),a['push'](join(d,'Applications','WoWok.AppImage')),a['push'](join(d,'.local','bin','wowok')));}}for(const e of a){if(e&&existsSync(e))return{'installed':!![],'hint':null};}return{'installed':![],'hint':'https://download.wowok.net'};}function readReminderState(){try{const a=readFileSync(REMINDER_FILE,'utf-8'),b=JSON['parse'](a);return{'lastInstallClientReminderAt':Number(b['lastInstallClientReminderAt'])||0x0};}catch{return{'lastInstallClientReminderAt':0x0};}}function writeReminderState(a){try{mkdirSync(dirname(REMINDER_FILE),{'recursive':!![]}),writeFileSync(REMINDER_FILE,JSON['stringify'](a),'utf-8');}catch{}}export async function checkUpgrade(){const a=readMcpVersion(),b=readSdkVersion(),[c,d]=await Promise['all']([fetchNpmLatest(MCP_PACKAGE),fetchNpmLatest(SDK_PACKAGE)]),e=detectClientInstall(),f=readReminderState(),g=Date['now'](),h=!!(a&&c&&compareVersions(c,a)>0x0),i=!!(b&&d&&compareVersions(d,b)>0x0),j=h||i;let k='none',l=![],m=null;if(j){k='upgrade',l=!![];const n=c??d??'',o=a??'';m='A\x20newer\x20WoWok\x20version\x20is\x20available\x20(current\x20v'+o+'\x20→\x20latest\x20v'+n+').\x20'+('Upgrade\x20for\x20more\x20features\x20and\x20improvements.\x20Run:\x20npm\x20install\x20-g\x20'+MCP_PACKAGE+'@latest');}else!e['installed']&&g-f['lastInstallClientReminderAt']>=WEEK_MS&&(k='install_client',l=!![],m='The\x20WoWok\x20desktop\x20client\x20is\x20not\x20installed\x20yet.\x20It\x20provides\x20wallet\x20management,\x20encrypted\x20Messenger,\x20project\x20management\x20and\x20more.\x20'+'Download\x20it\x20at\x20https://download.wowok.net\x20to\x20get\x20started.',f['lastInstallClientReminderAt']=g,writeReminderState(f));return{'mcp':{'current':a,'latest':c,'outdated':h},'sdk':{'current':b,'latest':d,'outdated':i},'client_installed':e['installed'],'client_install_hint':e['hint'],'upgrade_available':j,'reminder':{'type':k,'due':l,'message':m},'checked_at':new Date()['toISOString']()};}
@@ -1,306 +1 @@
1
- export function classifyWipPath(path) {
2
- if (!path || typeof path !== "string") {
3
- return {
4
- type: "unknown",
5
- is_local: false,
6
- is_network: false,
7
- description: "Empty or invalid path",
8
- };
9
- }
10
- if (path.startsWith("data:")) {
11
- return {
12
- type: "data_url",
13
- is_local: false,
14
- is_network: true,
15
- description: "Data URL — embedded content, globally reachable",
16
- };
17
- }
18
- if (path.startsWith("ipfs://")) {
19
- return {
20
- type: "ipfs",
21
- is_local: false,
22
- is_network: true,
23
- description: "IPFS URI — resolve via any public gateway",
24
- };
25
- }
26
- const ipfsGateways = [
27
- /^https?:\/\/ipfs\.io\//i,
28
- /^https?:\/\/cloudflare-ipfs\.com\//i,
29
- /^https?:\/\/gateway\.pinata\.cloud\//i,
30
- /^https?:\/\/dweb\.link\//i,
31
- /^https?:\/\/[^/]*pinata\.cloud\//i,
32
- ];
33
- if (ipfsGateways.some((re) => re.test(path))) {
34
- return {
35
- type: "ipfs",
36
- is_local: false,
37
- is_network: true,
38
- description: "IPFS HTTP gateway URL — globally reachable",
39
- };
40
- }
41
- if (/^https?:\/\/(localhost|127\.0\.0\.1|\[::1\]|0\.0\.0\.0)([:/]|$)/i.test(path)) {
42
- return {
43
- type: "local_http",
44
- is_local: true,
45
- is_network: false,
46
- description: "Local HTTP URL (localhost/loopback) — reachable only on this machine, NOT by customers",
47
- };
48
- }
49
- const privateIpRe = /^https?:\/\/(10\.\d{1,3}\.\d{1,3}\.\d{1,3}|172\.(1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3}|192\.168\.\d{1,3}\.\d{1,3})([:/]|$)/i;
50
- if (privateIpRe.test(path)) {
51
- return {
52
- type: "local_http",
53
- is_local: true,
54
- is_network: false,
55
- description: "LAN HTTP URL (private IP) — reachable only on the local network, NOT by customers",
56
- };
57
- }
58
- if (/^https?:\/\//i.test(path)) {
59
- return {
60
- type: "http_url",
61
- is_local: false,
62
- is_network: true,
63
- description: "HTTP(S) URL — globally reachable if server returns 200",
64
- };
65
- }
66
- if (/^[A-Za-z]:[\\/]/.test(path)) {
67
- return {
68
- type: "local_windows",
69
- is_local: true,
70
- is_network: false,
71
- description: "Windows local path — NOT reachable by customers/AI",
72
- };
73
- }
74
- if (path.startsWith("/")) {
75
- return {
76
- type: "local_unix",
77
- is_local: true,
78
- is_network: false,
79
- description: "Unix local path — NOT reachable by customers/AI",
80
- };
81
- }
82
- if (path.startsWith("./") || path.startsWith("../") || path === "." || path === "..") {
83
- return {
84
- type: "local_relative",
85
- is_local: true,
86
- is_network: false,
87
- description: "Relative local path — NOT reachable by customers/AI",
88
- };
89
- }
90
- if (!path.includes("://") && !path.startsWith("data:")) {
91
- return {
92
- type: "local_relative",
93
- is_local: true,
94
- is_network: false,
95
- description: "Local file path (no scheme) — NOT reachable by customers/AI",
96
- };
97
- }
98
- return {
99
- type: "unknown",
100
- is_local: false,
101
- is_network: false,
102
- description: "Unrecognized path format",
103
- };
104
- }
105
- export function getDeployOptions(localFilePath) {
106
- const safePath = localFilePath.replace(/'/g, "'\\''");
107
- const basename = localFilePath.split(/[\\/]/).pop() || "file.wip";
108
- return [
109
- {
110
- name: "GitHub Pages (Recommended)",
111
- description: "Upload the .wip file to a GitHub repository and serve it via GitHub Pages. " +
112
- "Free, stable, HTTPS-enabled, no expiration.",
113
- difficulty: "easy",
114
- free: true,
115
- result_url_pattern: "https://<your-username>.github.io/<repo>/<file>.wip",
116
- steps: [
117
- "// 1. Create a new GitHub repository (e.g., 'wowok-wip') via https://github.com/new",
118
- "// 2. Make it PUBLIC so the file is world-readable.",
119
- `// 3. Copy your local WIP file into the repo:`,
120
- `git clone https://github.com/<your-username>/wowok-wip.git`,
121
- `cp '${safePath}' wowok-wip/${basename}`,
122
- `cd wowok-wip`,
123
- `git add ${basename}`,
124
- `git commit -m "Add WIP file"`,
125
- `git push origin main`,
126
- "// 4. Enable GitHub Pages: repo → Settings → Pages → Source → 'main' branch → /(root) → Save",
127
- "// 5. Wait 30-60 seconds for deployment, then verify the URL is reachable:",
128
- `curl -I https://<your-username>.github.io/wowok-wip/${basename}`,
129
- "// 6. Update your Service on-chain with the new public URL:",
130
- "// Call onchain_operations { operation_type: 'service', data: { object: '<service-id>', sales: { op: 'set', sales: [{ ..., wip_url: 'https://...', wip_hash: '<hash>' }] } } }",
131
- ],
132
- notes: [
133
- "If the repo already has Pages enabled on the main branch, step 4 can be skipped.",
134
- "GitHub Pages serves files up to 25 MB — well above typical WIP sizes (< 1 MB).",
135
- "URL is case-sensitive; ensure the filename in the URL matches exactly.",
136
- ],
137
- },
138
- {
139
- name: "IPFS via Pinata (Free gateway)",
140
- description: "Upload the .wip file to IPFS through Pinata's free gateway. " +
141
- "Content-addressed — the CID hash also serves as an integrity check.",
142
- difficulty: "medium",
143
- free: true,
144
- result_url_pattern: "https://gateway.pinata.cloud/ipfs/<CID> (or https://ipfs.io/ipfs/<CID>)",
145
- steps: [
146
- "// 1. Sign up for a free Pinata account at https://app.pinata.cloud/ (1 GB free storage).",
147
- "// 2. Get your API key from https://app.pinata.cloud/keys (generate a new key with 'pinFileToIPFS' scope).",
148
- `// 3. Upload your local WIP file via curl:`,
149
- `curl -X POST https://api.pinata.cloud/pinning/pinFileToIPFS \\`,
150
- ` -H "Authorization: Bearer <YOUR_PINATA_API_KEY>" \\`,
151
- ` -F "file=@'${safePath}'"`,
152
- "// 4. Pinata returns JSON with 'IpfsHash' (the CID). Extract it:",
153
- `// Example response: { "IpfsHash": "QmXYZ...", "PinSize": 12345, "Timestamp": "..." }`,
154
- "// 5. Verify the file is reachable via the public gateway:",
155
- `curl -I https://gateway.pinata.cloud/ipfs/<CID>`,
156
- "// 6. (Optional) Use ipfs://<CID> as the wip_url — the SDK resolves it.",
157
- "// 7. Update your Service on-chain with the IPFS URL or CID:",
158
- "// Call onchain_operations { operation_type: 'service', data: { object: '<service-id>', sales: { op: 'set', sales: [{ ..., wip_url: 'https://gateway.pinata.cloud/ipfs/<CID>', wip_hash: '<hash>' }] } } }",
159
- ],
160
- notes: [
161
- "Pinata free tier: 1 GB storage, 100 uploads/day — sufficient for WIP files.",
162
- "For long-term durability, also pin via another gateway (e.g., nft.storage).",
163
- "IPFS CIDs are content-addressed — if the file changes, the CID changes. This is a feature, not a bug.",
164
- ],
165
- },
166
- {
167
- name: "User's own website / static host",
168
- description: "If you already operate a website or static host (e.g., nginx, Vercel, Netlify, Cloudflare Pages), " +
169
- "upload the .wip file there and use its public URL.",
170
- difficulty: "medium",
171
- free: true,
172
- result_url_pattern: "https://<your-domain>/<path>/<file>.wip",
173
- steps: [
174
- `// 1. Copy your local WIP file to your web server's static directory:`,
175
- `scp '${safePath}' user@your-server:/var/www/html/wowok/${basename}`,
176
- "// 2. Ensure the server sets Content-Type: application/json (or application/octet-stream) for .wip files.",
177
- "// For nginx, add to your server block:",
178
- "// location ~ \\.wip$ { default_type application/json; }",
179
- "// 3. Verify the file is reachable:",
180
- `curl -I https://<your-domain>/wowok/${basename}`,
181
- "// 4. Update your Service on-chain with the new public URL:",
182
- "// Call onchain_operations { operation_type: 'service', data: { object: '<service-id>', sales: { op: 'set', sales: [{ ..., wip_url: 'https://<your-domain>/wowok/<file>.wip', wip_hash: '<hash>' }] } } }",
183
- ],
184
- notes: [
185
- "Make sure CORS is permissive if the verifier fetches via browser (Access-Control-Allow-Origin: *).",
186
- "Ensure HTTPS is enabled — most verifiers reject plain HTTP.",
187
- ],
188
- },
189
- {
190
- name: "Data URL embedding (small files only)",
191
- description: "Embed the entire WIP file as a base64 data URL directly in the wip_url field. " +
192
- "No external hosting required, but on-chain storage cost grows with file size.",
193
- difficulty: "easy",
194
- free: true,
195
- result_url_pattern: "data:application/json;base64,<base64-encoded-content>",
196
- steps: [
197
- `// 1. Encode your local WIP file as a base64 data URL:`,
198
- `// On Linux/macOS:`,
199
- `echo "data:application/json;base64,$(base64 -w0 '${safePath}')"`,
200
- `// On Windows (PowerShell):`,
201
- `$bytes = [System.IO.File]::ReadAllBytes('${localFilePath}'); $b64 = [System.Convert]::ToBase64String($bytes); Write-Output "data:application/json;base64,$b64"`,
202
- "// 2. Use the resulting data URL as the wip_url field when updating the Service.",
203
- "// 3. Note: data URLs are NOT recommended for files > 50 KB due to on-chain storage cost.",
204
- ],
205
- notes: [
206
- "Only suitable for very small WIP files (typically < 10 KB).",
207
- "Data URLs cannot be updated without an on-chain transaction — content is literally embedded.",
208
- "Prefer GitHub Pages or IPFS for files > 10 KB.",
209
- ],
210
- },
211
- ];
212
- }
213
- export function analyzeWipDeployment(path) {
214
- const classification = classifyWipPath(path);
215
- const needsDeployment = classification.is_local;
216
- let reason;
217
- let options = [];
218
- if (needsDeployment) {
219
- if (classification.type === "local_http") {
220
- reason =
221
- `The WIP URL '${path}' is a ${classification.description}. ` +
222
- "It is reachable only from the merchant's own machine/LAN — customers and " +
223
- "on-chain verifiers on other machines CANNOT fetch it. Storing it on-chain " +
224
- "makes every customer order fail. " +
225
- "Deploy the .wip file to a public host (GitHub Pages, IPFS, or your own website) " +
226
- "and update the Service's wip_url with the public URL.";
227
- }
228
- else {
229
- reason =
230
- `The WIP path '${path}' is a LOCAL ${classification.type} path. ` +
231
- "Local paths stored on-chain are unreachable by customers and verifiers. " +
232
- "Deploy the .wip file to a public host (GitHub Pages, IPFS, or your own website) " +
233
- "and update the Service's wip_url with the public URL.";
234
- }
235
- options = getDeployOptions(path);
236
- }
237
- else if (classification.type === "http_url") {
238
- reason =
239
- "The WIP path is an HTTP(S) URL — verify the server returns 200. " +
240
- "If the URL returns 404/403, the file may have been moved or deleted.";
241
- options = [];
242
- }
243
- else if (classification.type === "ipfs") {
244
- reason =
245
- "The WIP path is an IPFS URL — verify the gateway is responsive. " +
246
- "If the CID is unreachable, the file may have been unpinned.";
247
- options = [];
248
- }
249
- else if (classification.type === "data_url") {
250
- reason = "The WIP path is a data URL — content is embedded, no deployment needed.";
251
- options = [];
252
- }
253
- else {
254
- reason = `Unrecognized WIP path format: '${path}'`;
255
- options = [];
256
- }
257
- return {
258
- path,
259
- classification,
260
- needs_deployment: needsDeployment,
261
- reason,
262
- options,
263
- remind_update_hash: needsDeployment,
264
- };
265
- }
266
- export function formatDeployHints(suggestion) {
267
- if (!suggestion.needs_deployment && suggestion.options.length === 0) {
268
- return "";
269
- }
270
- const lines = [];
271
- lines.push("=== WIP Deployment Assistance ===");
272
- lines.push("");
273
- lines.push(`Path: ${suggestion.path}`);
274
- lines.push(`Type: ${suggestion.classification.description}`);
275
- lines.push(`Reason: ${suggestion.reason}`);
276
- lines.push("");
277
- if (suggestion.options.length > 0) {
278
- lines.push("Recommended deployment options:");
279
- lines.push("");
280
- for (const opt of suggestion.options) {
281
- lines.push(`▶ ${opt.name} (difficulty: ${opt.difficulty}, free: ${opt.free})`);
282
- lines.push(` ${opt.description}`);
283
- lines.push(` Resulting URL pattern: ${opt.result_url_pattern}`);
284
- lines.push(" Steps:");
285
- for (const step of opt.steps) {
286
- lines.push(` ${step}`);
287
- }
288
- if (opt.notes && opt.notes.length > 0) {
289
- lines.push(" Notes:");
290
- for (const note of opt.notes) {
291
- lines.push(` - ${note}`);
292
- }
293
- }
294
- lines.push("");
295
- }
296
- }
297
- if (suggestion.remind_update_hash) {
298
- lines.push("⚠️ After deploying, compute the new WIP hash and update the Service:");
299
- lines.push(" 1. Re-run wip_file { type: 'verify', wipFilePath: '<new-public-url>' } to confirm the file is reachable.");
300
- lines.push(" 2. Extract the meta.hash from the WIP file (or use wip_file { type: 'verify' } result).");
301
- lines.push(" 3. Update the Service on-chain: onchain_operations { operation_type: 'service', data: { object: '<service-id>', sales: { op: 'set', sales: [{ ..., wip_url: '<new-public-url>', wip_hash: '<hash>' }] } } }");
302
- lines.push("");
303
- }
304
- lines.push("===============================");
305
- return lines.join("\n");
306
- }
1
+ export function classifyWipPath(a){if(!a||typeof a!=='string')return{'type':'unknown','is_local':![],'is_network':![],'description':'Empty\x20or\x20invalid\x20path'};if(a['startsWith']('data:'))return{'type':'data_url','is_local':![],'is_network':!![],'description':'Data\x20URL\x20—\x20embedded\x20content,\x20globally\x20reachable'};if(a['startsWith']('ipfs://'))return{'type':'ipfs','is_local':![],'is_network':!![],'description':'IPFS\x20URI\x20—\x20resolve\x20via\x20any\x20public\x20gateway'};const b=[/^https?:\/\/ipfs\.io\//i,/^https?:\/\/cloudflare-ipfs\.com\//i,/^https?:\/\/gateway\.pinata\.cloud\//i,/^https?:\/\/dweb\.link\//i,/^https?:\/\/[^/]*pinata\.cloud\//i];if(b['some'](d=>d['test'](a)))return{'type':'ipfs','is_local':![],'is_network':!![],'description':'IPFS\x20HTTP\x20gateway\x20URL\x20—\x20globally\x20reachable'};if(/^https?:\/\/(localhost|127\.0\.0\.1|\[::1\]|0\.0\.0\.0)([:/]|$)/i['test'](a))return{'type':'local_http','is_local':!![],'is_network':![],'description':'Local\x20HTTP\x20URL\x20(localhost/loopback)\x20—\x20reachable\x20only\x20on\x20this\x20machine,\x20NOT\x20by\x20customers'};const c=/^https?:\/\/(10\.\d{1,3}\.\d{1,3}\.\d{1,3}|172\.(1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3}|192\.168\.\d{1,3}\.\d{1,3})([:/]|$)/i;if(c['test'](a))return{'type':'local_http','is_local':!![],'is_network':![],'description':'LAN\x20HTTP\x20URL\x20(private\x20IP)\x20—\x20reachable\x20only\x20on\x20the\x20local\x20network,\x20NOT\x20by\x20customers'};if(/^https?:\/\//i['test'](a))return{'type':'http_url','is_local':![],'is_network':!![],'description':'HTTP(S)\x20URL\x20—\x20globally\x20reachable\x20if\x20server\x20returns\x20200'};if(/^[A-Za-z]:[\\/]/['test'](a))return{'type':'local_windows','is_local':!![],'is_network':![],'description':'Windows\x20local\x20path\x20—\x20NOT\x20reachable\x20by\x20customers/AI'};if(a['startsWith']('/'))return{'type':'local_unix','is_local':!![],'is_network':![],'description':'Unix\x20local\x20path\x20—\x20NOT\x20reachable\x20by\x20customers/AI'};if(a['startsWith']('./')||a['startsWith']('../')||a==='.'||a==='..')return{'type':'local_relative','is_local':!![],'is_network':![],'description':'Relative\x20local\x20path\x20—\x20NOT\x20reachable\x20by\x20customers/AI'};if(!a['includes']('://')&&!a['startsWith']('data:'))return{'type':'local_relative','is_local':!![],'is_network':![],'description':'Local\x20file\x20path\x20(no\x20scheme)\x20—\x20NOT\x20reachable\x20by\x20customers/AI'};return{'type':'unknown','is_local':![],'is_network':![],'description':'Unrecognized\x20path\x20format'};}export function getDeployOptions(a){const b=a['replace'](/'/g,'\x27\x5c\x27\x27'),c=a['split'](/[\\/]/)['pop']()||'file.wip';return[{'name':'GitHub\x20Pages\x20(Recommended)','description':'Upload\x20the\x20.wip\x20file\x20to\x20a\x20GitHub\x20repository\x20and\x20serve\x20it\x20via\x20GitHub\x20Pages.\x20'+'Free,\x20stable,\x20HTTPS-enabled,\x20no\x20expiration.','difficulty':'easy','free':!![],'result_url_pattern':'https://<your-username>.github.io/<repo>/<file>.wip','steps':['//\x201.\x20Create\x20a\x20new\x20GitHub\x20repository\x20(e.g.,\x20\x27wowok-wip\x27)\x20via\x20https://github.com/new','//\x202.\x20Make\x20it\x20PUBLIC\x20so\x20the\x20file\x20is\x20world-readable.','//\x203.\x20Copy\x20your\x20local\x20WIP\x20file\x20into\x20the\x20repo:','git\x20clone\x20https://github.com/<your-username>/wowok-wip.git','cp\x20\x27'+b+'\x27\x20wowok-wip/'+c,'cd\x20wowok-wip','git\x20add\x20'+c,'git\x20commit\x20-m\x20\x22Add\x20WIP\x20file\x22','git\x20push\x20origin\x20main','//\x204.\x20Enable\x20GitHub\x20Pages:\x20repo\x20→\x20Settings\x20→\x20Pages\x20→\x20Source\x20→\x20\x27main\x27\x20branch\x20→\x20/(root)\x20→\x20Save','//\x205.\x20Wait\x2030-60\x20seconds\x20for\x20deployment,\x20then\x20verify\x20the\x20URL\x20is\x20reachable:','curl\x20-I\x20https://<your-username>.github.io/wowok-wip/'+c,'//\x206.\x20Update\x20your\x20Service\x20on-chain\x20with\x20the\x20new\x20public\x20URL:','//\x20\x20\x20\x20Call\x20onchain_operations\x20{\x20operation_type:\x20\x27service\x27,\x20data:\x20{\x20object:\x20\x27<service-id>\x27,\x20sales:\x20{\x20op:\x20\x27set\x27,\x20sales:\x20[{\x20...,\x20wip_url:\x20\x27https://...\x27,\x20wip_hash:\x20\x27<hash>\x27\x20}]\x20}\x20}\x20}'],'notes':['If\x20the\x20repo\x20already\x20has\x20Pages\x20enabled\x20on\x20the\x20main\x20branch,\x20step\x204\x20can\x20be\x20skipped.','GitHub\x20Pages\x20serves\x20files\x20up\x20to\x2025\x20MB\x20—\x20well\x20above\x20typical\x20WIP\x20sizes\x20(<\x201\x20MB).','URL\x20is\x20case-sensitive;\x20ensure\x20the\x20filename\x20in\x20the\x20URL\x20matches\x20exactly.']},{'name':'IPFS\x20via\x20Pinata\x20(Free\x20gateway)','description':'Upload\x20the\x20.wip\x20file\x20to\x20IPFS\x20through\x20Pinata\x27s\x20free\x20gateway.\x20'+'Content-addressed\x20—\x20the\x20CID\x20hash\x20also\x20serves\x20as\x20an\x20integrity\x20check.','difficulty':'medium','free':!![],'result_url_pattern':'https://gateway.pinata.cloud/ipfs/<CID>\x20\x20(or\x20\x20https://ipfs.io/ipfs/<CID>)','steps':['//\x201.\x20Sign\x20up\x20for\x20a\x20free\x20Pinata\x20account\x20at\x20https://app.pinata.cloud/\x20(1\x20GB\x20free\x20storage).','//\x202.\x20Get\x20your\x20API\x20key\x20from\x20https://app.pinata.cloud/keys\x20(generate\x20a\x20new\x20key\x20with\x20\x27pinFileToIPFS\x27\x20scope).','//\x203.\x20Upload\x20your\x20local\x20WIP\x20file\x20via\x20curl:','curl\x20-X\x20POST\x20https://api.pinata.cloud/pinning/pinFileToIPFS\x20\x5c','\x20\x20-H\x20\x22Authorization:\x20Bearer\x20<YOUR_PINATA_API_KEY>\x22\x20\x5c','\x20\x20-F\x20\x22file=@\x27'+b+'\x27\x22','//\x204.\x20Pinata\x20returns\x20JSON\x20with\x20\x27IpfsHash\x27\x20(the\x20CID).\x20Extract\x20it:','//\x20\x20\x20\x20Example\x20response:\x20{\x20\x22IpfsHash\x22:\x20\x22QmXYZ...\x22,\x20\x22PinSize\x22:\x2012345,\x20\x22Timestamp\x22:\x20\x22...\x22\x20}','//\x205.\x20Verify\x20the\x20file\x20is\x20reachable\x20via\x20the\x20public\x20gateway:','curl\x20-I\x20https://gateway.pinata.cloud/ipfs/<CID>','//\x206.\x20(Optional)\x20Use\x20ipfs://<CID>\x20as\x20the\x20wip_url\x20—\x20the\x20SDK\x20resolves\x20it.','//\x207.\x20Update\x20your\x20Service\x20on-chain\x20with\x20the\x20IPFS\x20URL\x20or\x20CID:','//\x20\x20\x20\x20Call\x20onchain_operations\x20{\x20operation_type:\x20\x27service\x27,\x20data:\x20{\x20object:\x20\x27<service-id>\x27,\x20sales:\x20{\x20op:\x20\x27set\x27,\x20sales:\x20[{\x20...,\x20wip_url:\x20\x27https://gateway.pinata.cloud/ipfs/<CID>\x27,\x20wip_hash:\x20\x27<hash>\x27\x20}]\x20}\x20}\x20}'],'notes':['Pinata\x20free\x20tier:\x201\x20GB\x20storage,\x20100\x20uploads/day\x20—\x20sufficient\x20for\x20WIP\x20files.','For\x20long-term\x20durability,\x20also\x20pin\x20via\x20another\x20gateway\x20(e.g.,\x20nft.storage).','IPFS\x20CIDs\x20are\x20content-addressed\x20—\x20if\x20the\x20file\x20changes,\x20the\x20CID\x20changes.\x20This\x20is\x20a\x20feature,\x20not\x20a\x20bug.']},{'name':'User\x27s\x20own\x20website\x20/\x20static\x20host','description':'If\x20you\x20already\x20operate\x20a\x20website\x20or\x20static\x20host\x20(e.g.,\x20nginx,\x20Vercel,\x20Netlify,\x20Cloudflare\x20Pages),\x20'+'upload\x20the\x20.wip\x20file\x20there\x20and\x20use\x20its\x20public\x20URL.','difficulty':'medium','free':!![],'result_url_pattern':'https://<your-domain>/<path>/<file>.wip','steps':['//\x201.\x20Copy\x20your\x20local\x20WIP\x20file\x20to\x20your\x20web\x20server\x27s\x20static\x20directory:','scp\x20\x27'+b+'\x27\x20user@your-server:/var/www/html/wowok/'+c,'//\x202.\x20Ensure\x20the\x20server\x20sets\x20Content-Type:\x20application/json\x20(or\x20application/octet-stream)\x20for\x20.wip\x20files.','//\x20\x20\x20\x20For\x20nginx,\x20add\x20to\x20your\x20server\x20block:','//\x20\x20\x20\x20\x20\x20\x20\x20location\x20~\x20\x5c.wip$\x20{\x20default_type\x20application/json;\x20}','//\x203.\x20Verify\x20the\x20file\x20is\x20reachable:','curl\x20-I\x20https://<your-domain>/wowok/'+c,'//\x204.\x20Update\x20your\x20Service\x20on-chain\x20with\x20the\x20new\x20public\x20URL:','//\x20\x20\x20\x20Call\x20onchain_operations\x20{\x20operation_type:\x20\x27service\x27,\x20data:\x20{\x20object:\x20\x27<service-id>\x27,\x20sales:\x20{\x20op:\x20\x27set\x27,\x20sales:\x20[{\x20...,\x20wip_url:\x20\x27https://<your-domain>/wowok/<file>.wip\x27,\x20wip_hash:\x20\x27<hash>\x27\x20}]\x20}\x20}\x20}'],'notes':['Make\x20sure\x20CORS\x20is\x20permissive\x20if\x20the\x20verifier\x20fetches\x20via\x20browser\x20(Access-Control-Allow-Origin:\x20*).','Ensure\x20HTTPS\x20is\x20enabled\x20—\x20most\x20verifiers\x20reject\x20plain\x20HTTP.']},{'name':'Data\x20URL\x20embedding\x20(small\x20files\x20only)','description':'Embed\x20the\x20entire\x20WIP\x20file\x20as\x20a\x20base64\x20data\x20URL\x20directly\x20in\x20the\x20wip_url\x20field.\x20'+'No\x20external\x20hosting\x20required,\x20but\x20on-chain\x20storage\x20cost\x20grows\x20with\x20file\x20size.','difficulty':'easy','free':!![],'result_url_pattern':'data:application/json;base64,<base64-encoded-content>','steps':['//\x201.\x20Encode\x20your\x20local\x20WIP\x20file\x20as\x20a\x20base64\x20data\x20URL:','//\x20\x20\x20\x20On\x20Linux/macOS:','echo\x20\x22data:application/json;base64,$(base64\x20-w0\x20\x27'+b+'\x27)\x22','//\x20\x20\x20\x20On\x20Windows\x20(PowerShell):','$bytes\x20=\x20[System.IO.File]::ReadAllBytes(\x27'+a+'\x27);\x20$b64\x20=\x20[System.Convert]::ToBase64String($bytes);\x20Write-Output\x20\x22data:application/json;base64,$b64\x22','//\x202.\x20Use\x20the\x20resulting\x20data\x20URL\x20as\x20the\x20wip_url\x20field\x20when\x20updating\x20the\x20Service.','//\x203.\x20Note:\x20data\x20URLs\x20are\x20NOT\x20recommended\x20for\x20files\x20>\x2050\x20KB\x20due\x20to\x20on-chain\x20storage\x20cost.'],'notes':['Only\x20suitable\x20for\x20very\x20small\x20WIP\x20files\x20(typically\x20<\x2010\x20KB).','Data\x20URLs\x20cannot\x20be\x20updated\x20without\x20an\x20on-chain\x20transaction\x20—\x20content\x20is\x20literally\x20embedded.','Prefer\x20GitHub\x20Pages\x20or\x20IPFS\x20for\x20files\x20>\x2010\x20KB.']}];}export function analyzeWipDeployment(a){const b=classifyWipPath(a),c=b['is_local'];let d,e=[];if(c)b['type']==='local_http'?d='The\x20WIP\x20URL\x20\x27'+a+'\x27\x20is\x20a\x20'+b['description']+'.\x20'+'It\x20is\x20reachable\x20only\x20from\x20the\x20merchant\x27s\x20own\x20machine/LAN\x20—\x20customers\x20and\x20'+'on-chain\x20verifiers\x20on\x20other\x20machines\x20CANNOT\x20fetch\x20it.\x20Storing\x20it\x20on-chain\x20'+'makes\x20every\x20customer\x20order\x20fail.\x20'+'Deploy\x20the\x20.wip\x20file\x20to\x20a\x20public\x20host\x20(GitHub\x20Pages,\x20IPFS,\x20or\x20your\x20own\x20website)\x20'+'and\x20update\x20the\x20Service\x27s\x20wip_url\x20with\x20the\x20public\x20URL.':d='The\x20WIP\x20path\x20\x27'+a+'\x27\x20is\x20a\x20LOCAL\x20'+b['type']+'\x20path.\x20'+'Local\x20paths\x20stored\x20on-chain\x20are\x20unreachable\x20by\x20customers\x20and\x20verifiers.\x20'+'Deploy\x20the\x20.wip\x20file\x20to\x20a\x20public\x20host\x20(GitHub\x20Pages,\x20IPFS,\x20or\x20your\x20own\x20website)\x20'+'and\x20update\x20the\x20Service\x27s\x20wip_url\x20with\x20the\x20public\x20URL.',e=getDeployOptions(a);else{if(b['type']==='http_url')d='The\x20WIP\x20path\x20is\x20an\x20HTTP(S)\x20URL\x20—\x20verify\x20the\x20server\x20returns\x20200.\x20'+'If\x20the\x20URL\x20returns\x20404/403,\x20the\x20file\x20may\x20have\x20been\x20moved\x20or\x20deleted.',e=[];else{if(b['type']==='ipfs')d='The\x20WIP\x20path\x20is\x20an\x20IPFS\x20URL\x20—\x20verify\x20the\x20gateway\x20is\x20responsive.\x20'+'If\x20the\x20CID\x20is\x20unreachable,\x20the\x20file\x20may\x20have\x20been\x20unpinned.',e=[];else b['type']==='data_url'?(d='The\x20WIP\x20path\x20is\x20a\x20data\x20URL\x20—\x20content\x20is\x20embedded,\x20no\x20deployment\x20needed.',e=[]):(d='Unrecognized\x20WIP\x20path\x20format:\x20\x27'+a+'\x27',e=[]);}}return{'path':a,'classification':b,'needs_deployment':c,'reason':d,'options':e,'remind_update_hash':c};}export function formatDeployHints(a){if(!a['needs_deployment']&&a['options']['length']===0x0)return'';const b=[];b['push']('===\x20WIP\x20Deployment\x20Assistance\x20==='),b['push'](''),b['push']('Path:\x20'+a['path']),b['push']('Type:\x20'+a['classification']['description']),b['push']('Reason:\x20'+a['reason']),b['push']('');if(a['options']['length']>0x0){b['push']('Recommended\x20deployment\x20options:'),b['push']('');for(const c of a['options']){b['push']('▶\x20'+c['name']+'\x20(difficulty:\x20'+c['difficulty']+',\x20free:\x20'+c['free']+')'),b['push']('\x20\x20'+c['description']),b['push']('\x20\x20Resulting\x20URL\x20pattern:\x20'+c['result_url_pattern']),b['push']('\x20\x20Steps:');for(const d of c['steps']){b['push']('\x20\x20\x20\x20'+d);}if(c['notes']&&c['notes']['length']>0x0){b['push']('\x20\x20Notes:');for(const e of c['notes']){b['push']('\x20\x20\x20\x20-\x20'+e);}}b['push']('');}}return a['remind_update_hash']&&(b['push']('⚠️\x20After\x20deploying,\x20compute\x20the\x20new\x20WIP\x20hash\x20and\x20update\x20the\x20Service:'),b['push']('\x20\x201.\x20Re-run\x20wip_file\x20{\x20type:\x20\x27verify\x27,\x20wipFilePath:\x20\x27<new-public-url>\x27\x20}\x20to\x20confirm\x20the\x20file\x20is\x20reachable.'),b['push']('\x20\x202.\x20Extract\x20the\x20meta.hash\x20from\x20the\x20WIP\x20file\x20(or\x20use\x20wip_file\x20{\x20type:\x20\x27verify\x27\x20}\x20result).'),b['push']('\x20\x203.\x20Update\x20the\x20Service\x20on-chain:\x20onchain_operations\x20{\x20operation_type:\x20\x27service\x27,\x20data:\x20{\x20object:\x20\x27<service-id>\x27,\x20sales:\x20{\x20op:\x20\x27set\x27,\x20sales:\x20[{\x20...,\x20wip_url:\x20\x27<new-public-url>\x27,\x20wip_hash:\x20\x27<hash>\x27\x20}]\x20}\x20}\x20}'),b['push']('')),b['push']('==============================='),b['join']('\x0a');}