@danceiny/gotry 0.0.1-rc.9 → 0.2.0-rc.27

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 (507) hide show
  1. package/README.md +172 -219
  2. package/README.zh-CN.md +222 -0
  3. package/bin/gotry-backend.js +53 -0
  4. package/bin/gotry-booking-copilot.js +53 -0
  5. package/bin/gotry-bootstrap.js +1744 -0
  6. package/bin/gotry-inner.js +733 -83
  7. package/bin/gotry-process-liveness.d.ts +27 -0
  8. package/bin/gotry-process-liveness.js +97 -0
  9. package/bin/gotry-runtime-resolution.d.ts +27 -0
  10. package/bin/gotry-runtime-resolution.js +49 -0
  11. package/bin/gotry.js +1 -1
  12. package/client/client.js +203 -0
  13. package/cordis.gotry-patch.yml +80 -56
  14. package/data/airline-airports.json +39 -0
  15. package/data/stations-12306-verify.json +524 -0
  16. package/dist/capabilities/agent-reach-deep.js +45 -122
  17. package/dist/capabilities/agent-reach.js +101 -146
  18. package/dist/capabilities/anything.js +135 -94
  19. package/dist/capabilities/artifacts.js +370 -0
  20. package/dist/capabilities/channel-health.js +131 -0
  21. package/dist/capabilities/channel-registry.js +256 -0
  22. package/dist/capabilities/doctor.js +546 -0
  23. package/dist/capabilities/effect.js +394 -0
  24. package/dist/capabilities/external-event.js +149 -0
  25. package/dist/capabilities/fact-log.js +55 -0
  26. package/dist/capabilities/flyai-config.js +337 -0
  27. package/dist/capabilities/flyai.js +947 -110
  28. package/dist/capabilities/fx-contract.js +293 -0
  29. package/dist/capabilities/geo-atlas.js +246 -0
  30. package/dist/capabilities/ground-transfer.js +509 -0
  31. package/dist/capabilities/hbcli.js +260 -123
  32. package/dist/capabilities/hotelbyte-transaction.js +194 -0
  33. package/dist/capabilities/incident-log.js +131 -61
  34. package/dist/capabilities/itinerary-artifact.js +190 -0
  35. package/dist/capabilities/itinerary-deck-artifact.js +194 -0
  36. package/dist/capabilities/itinerary-deck-export.js +339 -0
  37. package/dist/capabilities/lavish-local.js +924 -0
  38. package/dist/capabilities/model-override.js +38 -0
  39. package/dist/capabilities/opensky.js +54 -43
  40. package/dist/capabilities/resilience.js +191 -0
  41. package/dist/capabilities/session/action-cache.js +50 -44
  42. package/dist/capabilities/session/adapters/ctrip-flight.js +120 -62
  43. package/dist/capabilities/session/adapters/ctrip-hotel.js +222 -0
  44. package/dist/capabilities/session/adapters/dida-portal.js +274 -0
  45. package/dist/capabilities/session/adapters/meituan-local.js +35 -54
  46. package/dist/capabilities/session/adapters/rail-12306.js +342 -0
  47. package/dist/capabilities/session/benchmark.js +189 -0
  48. package/dist/capabilities/session/bridge-ledger.js +224 -0
  49. package/dist/capabilities/session/extension-bridge.js +636 -0
  50. package/dist/capabilities/session/extension-channel.js +109 -0
  51. package/dist/capabilities/session/extension-distribution.js +230 -0
  52. package/dist/capabilities/session/extract.js +31 -21
  53. package/dist/capabilities/session/golden-score.js +114 -0
  54. package/dist/capabilities/session/health-watch.js +215 -0
  55. package/dist/capabilities/session/read-guard.js +75 -24
  56. package/dist/capabilities/session/static-flight-golden.js +150 -0
  57. package/dist/capabilities/session/transport.js +97 -83
  58. package/dist/capabilities/session/wizard.js +117 -0
  59. package/dist/capabilities/session-consent.js +178 -0
  60. package/dist/capabilities/session-login.js +170 -0
  61. package/dist/capabilities/session-search.js +635 -44
  62. package/dist/capabilities/spawn-bounded.js +203 -0
  63. package/dist/capabilities/sponsor-plugin.js +341 -0
  64. package/dist/capabilities/visa-policy.js +140 -0
  65. package/dist/capabilities/weather.js +243 -138
  66. package/dist/data/session-golden-20.json +25 -0
  67. package/dist/data/sf-golden-manifest.json +103 -0
  68. package/dist/data/sf-static-routes.json +91 -0
  69. package/dist/scripts/action-cache-tests.js +24 -59
  70. package/dist/scripts/agent-planning-turn-deadline-e2e.js +242 -0
  71. package/dist/scripts/agent-planning-turn-deadline-tests.js +185 -0
  72. package/dist/scripts/agent-reach-deep-tests.js +30 -40
  73. package/dist/scripts/agent-reach-error-tests.js +354 -0
  74. package/dist/scripts/agent-reach-tests.js +26 -18
  75. package/dist/scripts/agent-reach-wrapper-tests.js +50 -50
  76. package/dist/scripts/anything-tests.js +116 -60
  77. package/dist/scripts/artifact-client-contract-tests.js +220 -0
  78. package/dist/scripts/artifacts-capability-tests.js +727 -0
  79. package/dist/scripts/async-collect.js +50 -11
  80. package/dist/scripts/benchmark-environment-bridge-e2e.js +741 -0
  81. package/dist/scripts/benchmark-environment-bridge-tests.js +1452 -0
  82. package/dist/scripts/booking-copilot-availability-ledger-binding-tests.js +126 -0
  83. package/dist/scripts/booking-copilot-availability-policy-tests.js +265 -0
  84. package/dist/scripts/booking-copilot-bin-proof-tests.js +66 -0
  85. package/dist/scripts/booking-copilot-cleanup-proof-helper.js +76 -0
  86. package/dist/scripts/booking-copilot-crossrepo-fixture-server.js +144 -0
  87. package/dist/scripts/booking-copilot-dsh-core-proof-tests.js +424 -0
  88. package/dist/scripts/booking-copilot-dsh-planner-proof-tests.js +2839 -0
  89. package/dist/scripts/booking-copilot-dsh-plugin-proof-tests.js +309 -0
  90. package/dist/scripts/booking-copilot-dsh-readiness-proof.js +238 -0
  91. package/dist/scripts/booking-copilot-dsh-warmer-proof.js +123 -0
  92. package/dist/scripts/booking-copilot-event-sequence-concurrency-proof-tests.js +156 -0
  93. package/dist/scripts/booking-copilot-gap-code-contract-proof-tests.js +70 -0
  94. package/dist/scripts/booking-copilot-intent-proof-tests.js +422 -0
  95. package/dist/scripts/booking-copilot-operation-ledger-concurrency-proof-tests.js +184 -0
  96. package/dist/scripts/booking-copilot-planner-live-probe.js +95 -0
  97. package/dist/scripts/booking-copilot-proof-runtime.js +42 -0
  98. package/dist/scripts/booking-copilot-receipt-ledger-concurrency-proof-tests.js +210 -0
  99. package/dist/scripts/booking-copilot-runtime-proof-tests.js +2349 -0
  100. package/dist/scripts/booking-copilot-server-proof-tests.js +784 -0
  101. package/dist/scripts/booking-copilot-startup-proof-tests.js +94 -0
  102. package/dist/scripts/booking-executor-tests.js +80 -0
  103. package/dist/scripts/booking-recovery-chain-tests.js +182 -0
  104. package/dist/scripts/booking-saga-tests.js +125 -0
  105. package/dist/scripts/booking-surface-contract-proof-tests.js +212 -0
  106. package/dist/scripts/bootstrap-tests.js +1479 -0
  107. package/dist/scripts/bridge-events-tests.js +239 -0
  108. package/dist/scripts/bridge-ledger-tests.js +428 -0
  109. package/dist/scripts/build-changelog.js +238 -0
  110. package/dist/scripts/build-metrics-report.js +331 -0
  111. package/dist/scripts/changelog-tests.js +118 -0
  112. package/dist/scripts/channel-probe-tests.js +103 -0
  113. package/dist/scripts/channel-probe.js +169 -0
  114. package/dist/scripts/channel-registry-tests.js +208 -0
  115. package/dist/scripts/companion-tests.js +25 -70
  116. package/dist/scripts/dida-cookie-probe.js +87 -0
  117. package/dist/scripts/dida-runner-stop-tests.js +311 -0
  118. package/dist/scripts/dida-sw-probe.js +114 -0
  119. package/dist/scripts/diff-test.js +17 -12
  120. package/dist/scripts/doctor-tests.js +564 -0
  121. package/dist/scripts/dsh-artifact-e2e.js +279 -0
  122. package/dist/scripts/dsh-artifact-web-e2e.js +675 -0
  123. package/dist/scripts/dsh-http-proxy-sse-proof.js +90 -0
  124. package/dist/scripts/dsh-runtime-closure-tests.js +182 -0
  125. package/dist/scripts/dsh-runtime-closure.js +162 -0
  126. package/dist/scripts/dsh-session-v3-migration-proof.js +109 -0
  127. package/dist/scripts/dsh-subprocess-local-proof.js +150 -0
  128. package/dist/scripts/dsh-target-closure-proof.js +178 -0
  129. package/dist/scripts/effect-tests.js +539 -0
  130. package/dist/scripts/engine-run.js +1 -3
  131. package/dist/scripts/engine-tests.js +16 -10
  132. package/dist/scripts/evaluation-cadence-tests.js +174 -0
  133. package/dist/scripts/evaluation-contract-tests.js +268 -0
  134. package/dist/scripts/extension-distribution-cli.js +39 -0
  135. package/dist/scripts/extension-distribution-tests.js +443 -0
  136. package/dist/scripts/extension-tests.js +988 -0
  137. package/dist/scripts/external-event-tests.js +350 -0
  138. package/dist/scripts/fact-gate-tests.js +869 -0
  139. package/dist/scripts/fixtures/extension-bridge-unref-child.mjs +21 -0
  140. package/dist/scripts/flight-hotel-anchor-363-registered-e2e.js +169 -0
  141. package/dist/scripts/flight-malformed-tests.js +159 -0
  142. package/dist/scripts/flyai-setup-tests.js +228 -0
  143. package/dist/scripts/flyai-setup-tool-tests.js +54 -0
  144. package/dist/scripts/flyai-tests.js +692 -0
  145. package/dist/scripts/flyai-tool-registration-contract-tests.js +91 -0
  146. package/dist/scripts/fx-contract-tests.js +201 -0
  147. package/dist/scripts/g5-guard-tests.js +131 -0
  148. package/dist/scripts/g5-guard.js +189 -0
  149. package/dist/scripts/gen-lunar-anchors.js +106 -0
  150. package/dist/scripts/geo-atlas-tests.js +283 -0
  151. package/dist/scripts/gotry-backend-kernel-tests.js +206 -0
  152. package/dist/scripts/gotry-try-demo-tests.js +79 -0
  153. package/dist/scripts/gotry-try-demo.js +49 -0
  154. package/dist/scripts/ground-transfer-tests.js +956 -0
  155. package/dist/scripts/hbcli-e2e-tests.js +159 -0
  156. package/dist/scripts/hbcli-live-optin-tests.js +96 -0
  157. package/dist/scripts/hbcli-release-contract-tests.js +122 -0
  158. package/dist/scripts/hbcli-tests.js +121 -69
  159. package/dist/scripts/health-watch-cli.js +73 -0
  160. package/dist/scripts/hotel-date-gate-tests.js +496 -0
  161. package/dist/scripts/hotelbyte-reconcile-tests.js +141 -0
  162. package/dist/scripts/hotelbyte-spawn-e2e-tests.js +373 -0
  163. package/dist/scripts/i18n-tests.js +41 -0
  164. package/dist/scripts/incident-tests.js +281 -87
  165. package/dist/scripts/issue-194-job-id-guard-tests.js +106 -0
  166. package/dist/scripts/issue-233-cancel-refund-commission-tests.js +392 -0
  167. package/dist/scripts/issue-271-liveness-tests.js +569 -0
  168. package/dist/scripts/issue-289-model-retry-real-tests.js +296 -0
  169. package/dist/scripts/issue-289-model-retry-tests.js +441 -0
  170. package/dist/scripts/issue-289-web-retry-e2e.js +630 -0
  171. package/dist/scripts/issue-338-home-city-e2e.js +577 -0
  172. package/dist/scripts/issue343-real-entry-e2e.js +160 -0
  173. package/dist/scripts/issue436-persisted-routing-e2e.js +247 -0
  174. package/dist/scripts/itinerary-artifact-tests.js +368 -0
  175. package/dist/scripts/itinerary-deck-artifact-tests.js +416 -0
  176. package/dist/scripts/itinerary-deck-export-tests.js +552 -0
  177. package/dist/scripts/itinerary-deck-tests.js +435 -0
  178. package/dist/scripts/itinerary-html-tests.js +426 -0
  179. package/dist/scripts/journey-tests.js +22 -27
  180. package/dist/scripts/kernel-manifest-evidence.js +109 -0
  181. package/dist/scripts/kernel-manifest-gate.js +126 -0
  182. package/dist/scripts/kernel-manifest-tests.js +212 -0
  183. package/dist/scripts/kernel-manifest-trace-entry.js +7 -0
  184. package/dist/scripts/kernel-manifest-trace-hook.mjs +28 -0
  185. package/dist/scripts/kernel-manifest.js +369 -0
  186. package/dist/scripts/lavish-local-tests.js +1226 -0
  187. package/dist/scripts/lavish-product-tools-tests.js +537 -0
  188. package/dist/scripts/ledger-repair-apply-tests.js +316 -0
  189. package/dist/scripts/ledger-repair-plan-tests.js +375 -0
  190. package/dist/scripts/ledger-tests.js +382 -246
  191. package/dist/scripts/ledger-workflow-crash.js +10 -20
  192. package/dist/scripts/managed-dsh-cleanup-diagnostic-proof.js +184 -0
  193. package/dist/scripts/managed-dsh-close-failure-proof.js +172 -0
  194. package/dist/scripts/managed-dsh-run-port-proof.js +153 -0
  195. package/dist/scripts/managed-dsh-terminal-proof.js +252 -0
  196. package/dist/scripts/map-tools-vendor-package-proof.js +365 -0
  197. package/dist/scripts/memory-capture-tests.js +242 -61
  198. package/dist/scripts/memory-decay-tests.js +18 -52
  199. package/dist/scripts/memory-lifecycle-tests.js +657 -0
  200. package/dist/scripts/memory-lifecycle.js +196 -0
  201. package/dist/scripts/memory-metrics.js +24 -12
  202. package/dist/scripts/memory-value-report.js +631 -0
  203. package/dist/scripts/memory-value-tests.js +328 -0
  204. package/dist/scripts/metrics-report-tests.js +151 -0
  205. package/dist/scripts/model-override-e2e.js +137 -0
  206. package/dist/scripts/nightly-evidence-tests.js +161 -0
  207. package/dist/scripts/nightly-evidence.js +286 -0
  208. package/dist/scripts/nudge-digest.js +39 -28
  209. package/dist/scripts/observability-tests.js +381 -0
  210. package/dist/scripts/onboarding-tests.js +161 -0
  211. package/dist/scripts/opensky-check.js +18 -13
  212. package/dist/scripts/opensky-tests.js +28 -28
  213. package/dist/scripts/persona-surface-guard-tests.js +49 -0
  214. package/dist/scripts/pnpm-dsh-closure-proof.js +17 -0
  215. package/dist/scripts/policy-anchor-359-registered-e2e.js +214 -0
  216. package/dist/scripts/price-drift-tests.js +340 -0
  217. package/dist/scripts/price-drift-watch.js +447 -0
  218. package/dist/scripts/probe-poi-tests.js +53 -45
  219. package/dist/scripts/product-metrics.js +483 -0
  220. package/dist/scripts/publish-preverify.js +110 -0
  221. package/dist/scripts/realtime-pricing-tests.js +76 -0
  222. package/dist/scripts/recall-tests.js +513 -0
  223. package/dist/scripts/replay-async.js +20 -18
  224. package/dist/scripts/replay-real.js +18 -18
  225. package/dist/scripts/replay.js +52 -82
  226. package/dist/scripts/session-attach-diagnose.js +20 -20
  227. package/dist/scripts/session-attach-poc.js +34 -37
  228. package/dist/scripts/session-benchmark.js +180 -0
  229. package/dist/scripts/session-dida-live-e2e.js +199 -0
  230. package/dist/scripts/session-extract-tests.js +14 -35
  231. package/dist/scripts/session-link-tests.js +478 -0
  232. package/dist/scripts/session-login.js +27 -46
  233. package/dist/scripts/session-tests.js +796 -96
  234. package/dist/scripts/session-zones-tests.js +358 -0
  235. package/dist/scripts/sf-live-benchmark.js +367 -0
  236. package/dist/scripts/sf-live-challenge-stop-tests.js +453 -0
  237. package/dist/scripts/sf-live-cli-tests.js +92 -0
  238. package/dist/scripts/sf-live-options.js +46 -0
  239. package/dist/scripts/sf-manifest-tests.js +30 -0
  240. package/dist/scripts/sf-manifest.js +33 -0
  241. package/dist/scripts/sf-soft-score-tests.js +67 -0
  242. package/dist/scripts/sf-summary-tests.js +324 -0
  243. package/dist/scripts/sf-summary.js +525 -0
  244. package/dist/scripts/share-tests.js +432 -0
  245. package/dist/scripts/skeleton-check.js +16 -14
  246. package/dist/scripts/skeleton-integration-test.js +28 -11
  247. package/dist/scripts/skills-contract-tests.js +51 -46
  248. package/dist/scripts/smoke-session-gate-tests.js +21 -0
  249. package/dist/scripts/smoke.js +690 -246
  250. package/dist/scripts/spawn-bounded-abort-tests.js +241 -0
  251. package/dist/scripts/sponsor-reuse-tests.js +262 -0
  252. package/dist/scripts/state-cli-tests.js +226 -101
  253. package/dist/scripts/state-cli.js +550 -199
  254. package/dist/scripts/state-repair-cli.js +66 -0
  255. package/dist/scripts/state-repair-tests.js +140 -0
  256. package/dist/scripts/static-golden-tests.js +165 -0
  257. package/dist/scripts/time-eval-tests.js +210 -192
  258. package/dist/scripts/travel-timeline-tests.js +29 -93
  259. package/dist/scripts/turn-handoff-collect-tests.js +169 -0
  260. package/dist/scripts/turn-handoff-collect.js +161 -0
  261. package/dist/scripts/turn-policy-tests.js +55 -0
  262. package/dist/scripts/typed-contract-canary.js +176 -0
  263. package/dist/scripts/tz-resolver-sanity.js +50 -0
  264. package/dist/scripts/tz-resolver-tests.js +584 -0
  265. package/dist/scripts/unified-tests.js +23 -19
  266. package/dist/scripts/visa-policy-tests.js +62 -0
  267. package/dist/scripts/weather-tests.js +276 -41
  268. package/dist/scripts/wish-channel-gate-tests.js +54 -0
  269. package/dist/scripts/write-gate-tests.js +522 -0
  270. package/dist/scripts/z3-lifecycle-fault-tests.js +188 -0
  271. package/dist/scripts/z3-lifecycle-tests.js +170 -0
  272. package/dist/scripts/z3-race-repeat-tests.js +39 -0
  273. package/dist/scripts/z3-race-tests.js +41 -0
  274. package/dist/src/artifact-gate.js +829 -0
  275. package/dist/src/backend/kernel.js +91 -0
  276. package/dist/src/backend/modules/booking-copilot.js +92 -0
  277. package/dist/src/backend/modules/booking-executor.js +124 -0
  278. package/dist/src/backend/modules/session-search.js +551 -0
  279. package/dist/src/benchmark-agent-conformance.js +578 -0
  280. package/dist/src/benchmark-environment-bridge.js +515 -0
  281. package/dist/src/benchmark-headless-child-diagnostics.js +166 -0
  282. package/dist/src/benchmark-tool-isolation.js +151 -0
  283. package/dist/src/bookable-facts.js +533 -0
  284. package/dist/src/booking-saga.js +97 -0
  285. package/dist/src/booking-surface/availability-policy.js +697 -0
  286. package/dist/src/booking-surface/booking-intent.js +43 -0
  287. package/dist/src/booking-surface/cancel-refund-commission.js +379 -0
  288. package/dist/src/booking-surface/canonical-schema.js +116 -0
  289. package/dist/src/booking-surface/contracts.js +75 -0
  290. package/dist/src/booking-surface/dsh-planner.js +1854 -0
  291. package/dist/src/booking-surface/dsh-plugin.js +378 -0
  292. package/dist/src/booking-surface/dsh-worker.js +98 -0
  293. package/dist/src/booking-surface/error-codes.js +231 -0
  294. package/dist/src/booking-surface/index.js +9 -0
  295. package/dist/src/booking-surface/managed-dsh-cleanup-diagnostic.js +97 -0
  296. package/dist/src/booking-surface/managed-dsh-run-port.js +244 -0
  297. package/dist/src/booking-surface/profile.js +24 -0
  298. package/dist/src/booking-surface/recovery-chain.js +367 -0
  299. package/dist/src/booking-surface/runtime.js +1968 -0
  300. package/dist/src/booking-surface/server.js +674 -0
  301. package/dist/src/booking-surface/startup.js +168 -0
  302. package/dist/src/booking-surface/validation.js +261 -0
  303. package/dist/src/bridge.js +20 -13
  304. package/dist/src/companions.js +48 -74
  305. package/dist/src/contracts.js +21 -43
  306. package/dist/src/dsh-llm.js +97 -111
  307. package/dist/src/engine.js +276 -193
  308. package/dist/src/evaluation-cadence.js +97 -0
  309. package/dist/src/evaluation-contracts.js +283 -0
  310. package/dist/src/flight-pack-adapter.js +54 -0
  311. package/dist/src/flight-pack-contract.js +2 -0
  312. package/dist/src/flyai-setup-tool.js +70 -0
  313. package/dist/src/gotry-backend.js +125 -0
  314. package/dist/src/hotel-date-gate.js +118 -0
  315. package/dist/src/i18n.js +88 -0
  316. package/dist/src/index.js +2227 -882
  317. package/dist/src/itinerary-deck.js +139 -0
  318. package/dist/src/itinerary-doc-shared.js +661 -0
  319. package/dist/src/itinerary-html.js +131 -0
  320. package/dist/src/journey.js +155 -108
  321. package/dist/src/lavish-tools.js +400 -0
  322. package/dist/src/ledger-repair-apply.js +538 -0
  323. package/dist/src/ledger-repair-plan.js +463 -0
  324. package/dist/src/loop.js +319 -160
  325. package/dist/src/memory-capture.js +180 -32
  326. package/dist/src/memory-decay.js +30 -14
  327. package/dist/src/memory-lifecycle.js +1310 -0
  328. package/dist/src/memory-utility.js +27 -40
  329. package/dist/src/mock-llm.js +36 -61
  330. package/dist/src/model.js +81 -36
  331. package/dist/src/realtime-pricing.js +103 -0
  332. package/dist/src/recall/card.js +74 -0
  333. package/dist/src/recall/evaluator.js +140 -0
  334. package/dist/src/recall/integration.js +17 -0
  335. package/dist/src/recall/tick.js +166 -0
  336. package/dist/src/session-link/plan-it-action.js +48 -0
  337. package/dist/src/session-link/session-link.js +248 -0
  338. package/dist/src/session-zones.js +507 -0
  339. package/dist/src/share/adapters.js +51 -0
  340. package/dist/src/share/share-consent.js +76 -0
  341. package/dist/src/share/share-deck.js +58 -0
  342. package/dist/src/share/share-token.js +146 -0
  343. package/dist/src/slot-spec.js +84 -106
  344. package/dist/src/state-ledger.js +435 -516
  345. package/dist/src/state-repair.js +299 -0
  346. package/dist/src/subagent-job-id-guard.js +58 -0
  347. package/dist/src/time-anchor.js +231 -33
  348. package/dist/src/tool-packet.js +20 -8
  349. package/dist/src/travel-slots.js +58 -35
  350. package/dist/src/travel-timeline.js +44 -63
  351. package/dist/src/turn-deadline.js +287 -0
  352. package/dist/src/turn-policy.js +118 -0
  353. package/dist/src/tz-resolver.js +143 -0
  354. package/dist/src/unified.js +535 -359
  355. package/dist/src/wish-pool.js +42 -12
  356. package/dist/src/write-gate.js +495 -0
  357. package/dist/src/z3-shared.js +284 -0
  358. package/extension/README.md +21 -0
  359. package/extension/README.zh-CN.md +21 -0
  360. package/extension/background.js +463 -0
  361. package/extension/content-bridge.js +270 -0
  362. package/extension/content-main.js +111 -0
  363. package/extension/manifest.json +60 -0
  364. package/package.json +407 -14
  365. package/schemas/booking.intent.schema.json +193 -0
  366. package/schemas/booking.surface.schema.json +2622 -0
  367. package/ts/capabilities/agent-reach-deep.ts +114 -0
  368. package/ts/capabilities/agent-reach.ts +198 -0
  369. package/ts/capabilities/anything.ts +255 -0
  370. package/ts/capabilities/artifacts.ts +428 -0
  371. package/ts/capabilities/fact-log.ts +54 -0
  372. package/ts/capabilities/flyai-config.ts +388 -0
  373. package/ts/capabilities/flyai.ts +1274 -0
  374. package/ts/capabilities/hbcli.ts +253 -71
  375. package/ts/capabilities/incident-log.ts +88 -59
  376. package/ts/capabilities/itinerary-artifact.ts +214 -0
  377. package/ts/capabilities/itinerary-deck-artifact.ts +218 -0
  378. package/ts/capabilities/itinerary-deck-export.ts +378 -0
  379. package/ts/capabilities/opensky.ts +121 -0
  380. package/ts/capabilities/session/action-cache.ts +148 -0
  381. package/ts/capabilities/session/adapters/ctrip-flight.ts +181 -0
  382. package/ts/capabilities/session/adapters/ctrip-hotel.ts +238 -0
  383. package/ts/capabilities/session/adapters/dida-portal.ts +338 -0
  384. package/ts/capabilities/session/adapters/meituan-local.ts +70 -0
  385. package/ts/capabilities/session/adapters/rail-12306.ts +392 -0
  386. package/ts/capabilities/session/benchmark.ts +276 -0
  387. package/ts/capabilities/session/bridge-ledger.ts +333 -0
  388. package/ts/capabilities/session/extension-bridge.ts +794 -0
  389. package/ts/capabilities/session/extension-channel.ts +144 -0
  390. package/ts/capabilities/session/extension-distribution.ts +266 -0
  391. package/ts/capabilities/session/extract.ts +54 -0
  392. package/ts/capabilities/session/golden-score.ts +139 -0
  393. package/ts/capabilities/session/health-watch.ts +264 -0
  394. package/ts/capabilities/session/read-guard.ts +141 -0
  395. package/ts/capabilities/session/static-flight-golden.ts +209 -0
  396. package/ts/capabilities/session/transport.ts +146 -0
  397. package/ts/capabilities/session/wizard.ts +140 -0
  398. package/ts/capabilities/session-consent.ts +211 -0
  399. package/ts/capabilities/session-login.ts +208 -0
  400. package/ts/capabilities/session-search.ts +893 -0
  401. package/ts/capabilities/weather.ts +330 -0
  402. package/ts/dsh-runtime/vendor/README.md +68 -0
  403. package/ts/dsh-runtime/vendor/dsh-map-tools/LICENSE +21 -0
  404. package/ts/dsh-runtime/vendor/dsh-map-tools/README.en.md +405 -0
  405. package/ts/dsh-runtime/vendor/dsh-map-tools/README.md +404 -0
  406. package/ts/dsh-runtime/vendor/dsh-map-tools/client/client.js +1584 -0
  407. package/ts/dsh-runtime/vendor/dsh-map-tools/cordis.patch.yml +5 -0
  408. package/ts/dsh-runtime/vendor/dsh-map-tools/icon.svg +5 -0
  409. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/clients/amap.js +595 -0
  410. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/clients/nominatim.js +63 -0
  411. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/clients/osrm.js +58 -0
  412. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/clients/photon.js +55 -0
  413. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/config-file.js +87 -0
  414. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/config-route.js +131 -0
  415. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/config.js +16 -0
  416. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/geo.js +232 -0
  417. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/index.js +120 -0
  418. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/settings-ns.js +40 -0
  419. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/staticmap-route.js +115 -0
  420. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/tools/geocode.js +127 -0
  421. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/tools/poi.js +84 -0
  422. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/tools/routes.js +267 -0
  423. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/clients/amap.d.ts +90 -0
  424. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/clients/nominatim.d.ts +17 -0
  425. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/clients/osrm.d.ts +15 -0
  426. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/clients/photon.d.ts +22 -0
  427. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/config-file.d.ts +33 -0
  428. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/config-route.d.ts +23 -0
  429. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/config.d.ts +23 -0
  430. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/geo.d.ts +61 -0
  431. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/index.d.ts +18 -0
  432. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/settings-ns.d.ts +14 -0
  433. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/staticmap-route.d.ts +31 -0
  434. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/tools/geocode.d.ts +11 -0
  435. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/tools/poi.d.ts +9 -0
  436. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/tools/routes.d.ts +75 -0
  437. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types/types.d.ts +68 -0
  438. package/ts/dsh-runtime/vendor/dsh-map-tools/lib/types.js +16 -0
  439. package/ts/dsh-runtime/vendor/dsh-map-tools/package.json +97 -0
  440. package/ts/package.json +293 -3
  441. package/ts/scripts/async-collect.ts +91 -0
  442. package/ts/scripts/map-tools-vendor-package-proof.ts +404 -0
  443. package/ts/scripts/skeleton-check.ts +1 -1
  444. package/ts/scripts/skeleton-integration-test.ts +23 -1
  445. package/ts/scripts/state-cli.ts +568 -0
  446. package/ts/scripts/turn-handoff-collect.ts +178 -0
  447. package/ts/src/artifact-gate.ts +991 -0
  448. package/ts/src/benchmark-agent-conformance.ts +619 -0
  449. package/ts/src/benchmark-environment-bridge.ts +538 -0
  450. package/ts/src/benchmark-headless-child-diagnostics.ts +184 -0
  451. package/ts/src/benchmark-tool-isolation.ts +166 -0
  452. package/ts/src/bookable-facts.ts +837 -0
  453. package/ts/src/booking-saga.ts +133 -0
  454. package/ts/src/booking-surface/availability-policy.ts +522 -0
  455. package/ts/src/booking-surface/booking-intent.ts +86 -0
  456. package/ts/src/booking-surface/cancel-refund-commission.ts +488 -0
  457. package/ts/src/booking-surface/canonical-schema.js +116 -0
  458. package/ts/src/booking-surface/contracts.ts +475 -0
  459. package/ts/src/booking-surface/dsh-planner.ts +1949 -0
  460. package/ts/src/booking-surface/dsh-plugin.js +378 -0
  461. package/ts/src/booking-surface/dsh-worker.ts +110 -0
  462. package/ts/src/booking-surface/error-codes.ts +241 -0
  463. package/ts/src/booking-surface/index.ts +9 -0
  464. package/ts/src/booking-surface/managed-dsh-cleanup-diagnostic.ts +151 -0
  465. package/ts/src/booking-surface/managed-dsh-run-port.ts +273 -0
  466. package/ts/src/booking-surface/profile.ts +42 -0
  467. package/ts/src/booking-surface/recovery-chain.ts +409 -0
  468. package/ts/src/booking-surface/runtime.ts +1793 -0
  469. package/ts/src/booking-surface/server.ts +733 -0
  470. package/ts/src/booking-surface/startup.ts +201 -0
  471. package/ts/src/booking-surface/validation.ts +217 -0
  472. package/ts/src/companions.ts +113 -0
  473. package/ts/src/contracts.ts +13 -3
  474. package/ts/src/dsh-llm.ts +44 -11
  475. package/ts/src/flyai-setup-tool.ts +77 -0
  476. package/ts/src/index.ts +1948 -198
  477. package/ts/src/itinerary-deck.ts +189 -0
  478. package/ts/src/itinerary-doc-shared.ts +741 -0
  479. package/ts/src/itinerary-html.ts +171 -0
  480. package/ts/src/loop.ts +223 -25
  481. package/ts/src/memory-capture.ts +283 -0
  482. package/ts/src/memory-decay.ts +55 -0
  483. package/ts/src/memory-utility.ts +70 -0
  484. package/ts/src/mock-llm.ts +4 -8
  485. package/ts/src/model.ts +88 -2
  486. package/ts/src/recall/card.ts +106 -0
  487. package/ts/src/recall/evaluator.ts +170 -0
  488. package/ts/src/recall/integration.ts +35 -0
  489. package/ts/src/recall/tick.ts +213 -0
  490. package/ts/src/session-link/plan-it-action.ts +78 -0
  491. package/ts/src/session-link/session-link.ts +275 -0
  492. package/ts/src/share/adapters.ts +93 -0
  493. package/ts/src/share/share-consent.ts +105 -0
  494. package/ts/src/share/share-deck.ts +85 -0
  495. package/ts/src/share/share-token.ts +166 -0
  496. package/ts/src/slot-spec.ts +172 -0
  497. package/ts/src/state-ledger.ts +912 -0
  498. package/ts/src/subagent-job-id-guard.ts +72 -0
  499. package/ts/src/time-anchor.ts +338 -0
  500. package/ts/src/tool-packet.ts +32 -0
  501. package/ts/src/travel-slots.ts +219 -0
  502. package/ts/src/travel-timeline.ts +83 -0
  503. package/ts/src/turn-deadline.ts +366 -0
  504. package/ts/src/turn-policy.ts +154 -0
  505. package/ts/src/unified.ts +354 -88
  506. package/ts/src/wish-pool.ts +79 -0
  507. package/dist/scripts/session-attach-wait.js +0 -41
@@ -1,172 +1,95 @@
1
+ /**
2
+ * agent-reach 深度能力层:yt-dlp 字幕提取 + gh 仓库搜索(可选工具,系统有就调,没有降级)。
3
+ *
4
+ * 与 agent-reach.ts(r.jina.ai 读网页)互补——dsh LLM 的 3 个 agent-reach 工具:
5
+ * - gotry_web_search → r.jina.ai(已落,零配置)
6
+ * - gotry_video_subtitle → yt-dlp(本文件;系统装了就调,没装降级提示安装方式)
7
+ * - gotry_github_search → gh(本文件;系统装了就调,没装降级提示安装方式)
8
+ *
9
+ * 契约(与 anything/weather/opensky/agent-reach 同构,L4 不变量):
10
+ * - 永不抛错:spawn 失败/超时/工具未装一律降级返回;
11
+ * - 证据链标注:[agent-reach:yt-dlp@ts] / [agent-reach:gh@ts] / [@error@ts] / [@not-installed@ts];
12
+ * - 零强制依赖:不 npm install 任何东西,用系统 PATH 里的二进制。
13
+ */
1
14
  import { spawn } from 'node:child_process';
2
15
  function run(bin, args, timeoutMs) {
3
- return new Promise((resolve)=>{
4
- const child = spawn(bin, args, {
5
- env: process.env
6
- });
16
+ return new Promise((resolve) => {
17
+ const child = spawn(bin, args, { env: process.env });
7
18
  let stdout = '';
8
19
  let stderr = '';
9
20
  let err;
10
21
  let timedOut = false;
11
- const timer = setTimeout(()=>{
22
+ const timer = setTimeout(() => {
12
23
  timedOut = true;
13
24
  try {
14
25
  child.kill('SIGKILL');
15
- } catch {}
26
+ }
27
+ catch { /* ignore */ }
16
28
  }, timeoutMs);
17
- child.stdout.on('data', (d)=>{
18
- stdout += d.toString();
19
- });
20
- child.stderr.on('data', (d)=>{
21
- stderr += d.toString();
22
- });
23
- child.on('error', (e)=>{
24
- err = e.message;
25
- });
26
- child.on('close', (code)=>{
29
+ child.stdout.on('data', (d) => { stdout += d.toString(); });
30
+ child.stderr.on('data', (d) => { stderr += d.toString(); });
31
+ child.on('error', (e) => { err = e.message; });
32
+ child.on('close', (code) => {
27
33
  clearTimeout(timer);
28
- resolve({
29
- code,
30
- stdout,
31
- stderr,
32
- err,
33
- timedOut
34
- });
34
+ resolve({ code, stdout, stderr, err, timedOut });
35
35
  });
36
36
  });
37
37
  }
38
- const ts = ()=>new Date().toISOString();
38
+ const ts = () => new Date().toISOString();
39
+ /** yt-dlp 提取视频字幕(YouTube/B站;系统需已装 yt-dlp) */
39
40
  export async function videoSubtitle(q) {
40
41
  const started = Date.now();
41
42
  const lang = q.lang ?? 'zh-Hans,zh,en';
42
- const args = [
43
- '--write-sub',
44
- '--write-auto-sub',
45
- '--sub-langs',
46
- lang,
47
- '--skip-download',
48
- '--sub-format',
49
- 'vtt',
50
- '-o',
51
- '/tmp/gotry-sub-%(id)s',
52
- q.url
53
- ];
43
+ const args = ['--write-sub', '--write-auto-sub', '--sub-langs', lang, '--skip-download', '--sub-format', 'vtt', '-o', '/tmp/gotry-sub-%(id)s', q.url];
54
44
  const r = await run('yt-dlp', args, q.timeoutMs ?? 60_000);
55
45
  const latencyMs = Date.now() - started;
46
+ // not-installed: ENOENT
56
47
  if (r.err?.includes('ENOENT')) {
57
- return {
58
- ok: false,
59
- verdict: 'not-installed',
60
- evidence: `[agent-reach:yt-dlp@not-installed@${ts()}]`,
61
- latencyMs,
62
- stderr: 'yt-dlp 未安装;装法: brew install yt-dlp 或 pip install yt-dlp'
63
- };
48
+ return { ok: false, verdict: 'not-installed', evidence: `[agent-reach:yt-dlp@not-installed@${ts()}]`, latencyMs, stderr: 'yt-dlp 未安装;装法: brew install yt-dlp 或 pip install yt-dlp' };
64
49
  }
65
50
  if (r.timedOut) {
66
- return {
67
- ok: false,
68
- verdict: 'timeout',
69
- evidence: `[agent-reach:yt-dlp@error@${ts()}] timeout`,
70
- latencyMs
71
- };
51
+ return { ok: false, verdict: 'timeout', evidence: `[agent-reach:yt-dlp@error@${ts()}] timeout`, latencyMs };
72
52
  }
73
53
  if (r.code !== 0) {
74
- return {
75
- ok: false,
76
- verdict: 'error',
77
- evidence: `[agent-reach:yt-dlp@error@${ts()}] exit ${r.code}`,
78
- latencyMs,
79
- stderr: r.stderr.slice(0, 400)
80
- };
54
+ return { ok: false, verdict: 'error', evidence: `[agent-reach:yt-dlp@error@${ts()}] exit ${r.code}`, latencyMs, stderr: r.stderr.slice(0, 400) };
81
55
  }
56
+ // 从 stdout 抓写入的字幕文件名
82
57
  const m = r.stdout.match(/Writing subtitles to:\s*(\S+)/);
83
58
  if (!m) {
84
- return {
85
- ok: false,
86
- verdict: 'error',
87
- evidence: `[agent-reach:yt-dlp@error@${ts()}] no subtitle file in output`,
88
- latencyMs,
89
- stderr: r.stdout.slice(0, 300)
90
- };
59
+ return { ok: false, verdict: 'error', evidence: `[agent-reach:yt-dlp@error@${ts()}] no subtitle file in output`, latencyMs, stderr: r.stdout.slice(0, 300) };
91
60
  }
92
61
  const { readFile } = await import('node:fs/promises');
93
62
  let subtitles;
94
63
  try {
95
64
  subtitles = (await readFile(m[1], 'utf-8')).slice(0, 8000);
96
- } catch {}
97
- return {
98
- ok: true,
99
- verdict: 'found',
100
- evidence: `[agent-reach:yt-dlp@${ts()}]`,
101
- latencyMs,
102
- stdout: r.stdout.slice(0, 400),
103
- subtitles
104
- };
65
+ }
66
+ catch { /* 字幕文件读失败保留 undefined */ }
67
+ return { ok: true, verdict: 'found', evidence: `[agent-reach:yt-dlp@${ts()}]`, latencyMs, stdout: r.stdout.slice(0, 400), subtitles };
105
68
  }
69
+ /** gh 搜索 GitHub 仓库(系统需已装 gh 并登录) */
106
70
  export async function githubSearch(q) {
107
71
  const started = Date.now();
108
72
  const limit = q.limit ?? 5;
109
- const args = [
110
- 'search',
111
- 'repos',
112
- q.query,
113
- '--json',
114
- 'fullName,description,stargazersCount,url',
115
- '--limit',
116
- String(limit)
117
- ];
73
+ const args = ['search', 'repos', q.query, '--json', 'fullName,description,stargazersCount,url', '--limit', String(limit)];
118
74
  const r = await run('gh', args, q.timeoutMs ?? 30_000);
119
75
  const latencyMs = Date.now() - started;
120
76
  if (r.err?.includes('ENOENT')) {
121
- return {
122
- ok: false,
123
- verdict: 'not-installed',
124
- evidence: `[agent-reach:gh@not-installed@${ts()}]`,
125
- latencyMs,
126
- stderr: 'gh 未安装;装法: brew install gh && gh auth login'
127
- };
77
+ return { ok: false, verdict: 'not-installed', evidence: `[agent-reach:gh@not-installed@${ts()}]`, latencyMs, stderr: 'gh 未安装;装法: brew install gh && gh auth login' };
128
78
  }
129
79
  if (r.timedOut) {
130
- return {
131
- ok: false,
132
- verdict: 'timeout',
133
- evidence: `[agent-reach:gh@error@${ts()}] timeout`,
134
- latencyMs
135
- };
80
+ return { ok: false, verdict: 'timeout', evidence: `[agent-reach:gh@error@${ts()}] timeout`, latencyMs };
136
81
  }
137
82
  if (r.code !== 0) {
138
- return {
139
- ok: false,
140
- verdict: 'error',
141
- evidence: `[agent-reach:gh@error@${ts()}] exit ${r.code}`,
142
- latencyMs,
143
- stderr: r.stderr.slice(0, 300)
144
- };
83
+ return { ok: false, verdict: 'error', evidence: `[agent-reach:gh@error@${ts()}] exit ${r.code}`, latencyMs, stderr: r.stderr.slice(0, 300) };
145
84
  }
146
85
  try {
147
86
  const repos = JSON.parse(r.stdout);
148
87
  return {
149
- ok: true,
150
- verdict: 'found',
151
- evidence: `[agent-reach:gh@${ts()}]`,
152
- latencyMs,
153
- repos: repos.map((x)=>({
154
- name: x.fullName,
155
- description: x.description,
156
- stars: x.stargazersCount,
157
- url: x.url
158
- }))
159
- };
160
- } catch {
161
- return {
162
- ok: false,
163
- verdict: 'error',
164
- evidence: `[agent-reach:gh@error@${ts()}] parse fail`,
165
- latencyMs,
166
- stderr: r.stdout.slice(0, 300)
88
+ ok: true, verdict: 'found', evidence: `[agent-reach:gh@${ts()}]`, latencyMs,
89
+ repos: repos.map(x => ({ name: x.fullName, description: x.description, stars: x.stargazersCount, url: x.url })),
167
90
  };
168
91
  }
92
+ catch {
93
+ return { ok: false, verdict: 'error', evidence: `[agent-reach:gh@error@${ts()}] parse fail`, latencyMs, stderr: r.stdout.slice(0, 300) };
94
+ }
169
95
  }
170
-
171
-
172
- //# sourceURL=/Users/bytedance/work/gotry/ts/capabilities/agent-reach-deep.ts
@@ -1,204 +1,159 @@
1
+ /**
2
+ * agent-reach wrapper —— 上游 Panniantong/Agent-Reach 的薄壳(零渠道知识)。
3
+ *
4
+ * 分工(2026-08-22 founder 纠偏「wrapper 不是 router」):
5
+ * - 知识(渠道清单/方法签名/setup 指引)→ 上游:agent_reach.channels 注册表 + Channel.check() + guides/
6
+ * - 决策(该调哪个渠道哪个方法) → dsh 里的 LLM(靠本 wrapper 的自描述错误拿清单)
7
+ * - 管道(spawn/超时/永不抛错/证据链) → 本文件 + agent-reach-bridge.py,上游加渠道零改动
8
+ *
9
+ * 上游设计意图(Channel 基类原话):"After installation, agents call upstream tools directly."
10
+ * - python-API 渠道(web.read / v2ex.get_hot_topics / xueqiu.get_stock_quote / youtube.transcribe ...)
11
+ * 走本文件 reach() 的反射桥
12
+ * - 外部 CLI 工具渠道(github→gh / youtube 字幕→yt-dlp 等)由专用 dsh 工具(gotry_github_search /
13
+ * gotry_video_subtitle,见 agent-reach-deep.ts)充当执行面;上游无 python API 的不再自行拼命令
14
+ *
15
+ * 契约(L4 不变量,与 anything/weather/opensky 同构):
16
+ * - 永不抛错;verdict: found / not-installed / needs-setup / error
17
+ * - needs-setup 的 setup 文案 = 上游 check() 原话透传,不转述
18
+ * - 证据链 [agent-reach:<channel>.<method>@ts]
19
+ * - 失败人话化(#559):进程级失败与桥结构化错误均走分类文案,不漏 traceback、stderr、凭证样原话;setup(上游 check() 原话)与 inventory(上游注册表)透传契约不变
20
+ */
1
21
  import { spawn } from 'node:child_process';
2
22
  import { existsSync } from 'node:fs';
3
23
  import { resolve } from 'node:path';
4
- const ts = ()=>new Date().toISOString();
5
- const repoRoot = ()=>resolve(import.meta.dirname, '..', '..');
6
- const venvPython = ()=>resolve(repoRoot(), '.venv/bin/python');
7
- const bridgeScript = ()=>resolve(import.meta.dirname, 'agent-reach-bridge.py');
24
+ const ts = () => new Date().toISOString();
25
+ const repoRoot = () => resolve(import.meta.dirname, '..', '..');
26
+ const venvPython = () => resolve(repoRoot(), '.venv/bin/python');
27
+ const bridgeScript = () => resolve(import.meta.dirname, 'agent-reach-bridge.py');
8
28
  function run(bin, args, timeoutMs) {
9
- return new Promise((resolveRun)=>{
10
- const child = spawn(bin, args, {
11
- env: process.env
12
- });
29
+ return new Promise((resolveRun) => {
30
+ const child = spawn(bin, args, { env: process.env });
13
31
  let stdout = '';
14
32
  let stderr = '';
15
33
  let err;
16
- const timer = setTimeout(()=>{
34
+ let timedOut = false;
35
+ const timer = setTimeout(() => {
36
+ timedOut = true;
17
37
  try {
18
38
  child.kill('SIGKILL');
19
- } catch {}
39
+ }
40
+ catch { /* ignore */ }
20
41
  }, timeoutMs);
21
- child.stdout.on('data', (d)=>{
22
- stdout += d.toString();
23
- });
24
- child.stderr.on('data', (d)=>{
25
- stderr += d.toString();
26
- });
27
- child.on('error', (e)=>{
28
- err = e.message;
29
- });
30
- child.on('close', (code)=>{
31
- clearTimeout(timer);
32
- resolveRun({
33
- code,
34
- stdout,
35
- stderr,
36
- err
37
- });
38
- });
42
+ child.stdout.on('data', (d) => { stdout += d.toString(); });
43
+ child.stderr.on('data', (d) => { stderr += d.toString(); });
44
+ child.on('error', (e) => { err = e.message; });
45
+ child.on('close', (code) => { clearTimeout(timer); resolveRun({ code, stdout, stderr, err, timedOut }); });
39
46
  });
40
47
  }
48
+ /**
49
+ * 桥进程级失败人话化(对齐 anything.ts failureReason 口径;issue #559 第五缺口)。
50
+ *
51
+ * 这条消息会直接渲染进用户回复(gotry_agent_reach 的 error 分支、gotry_web_search 的
52
+ * unavailable 括号),所以 Python traceback、上游凭证片段这类桥进程 stderr 原文不能出现——
53
+ * 桥进程失败是可选实时源的降级设计行为,不是工具坏了;无法归类时也要说清发生了什么。
54
+ */
55
+ function bridgeFailureReason(r, timeoutMs) {
56
+ if (r.timedOut)
57
+ return `agent-reach 反射桥超时(>${timeoutMs}ms,本轮按降级处理;可调大 timeoutMs 或稍后再试)`;
58
+ if (!r.stdout.trim()) {
59
+ const why = r.code == null ? '进程异常结束' : `退出码 ${r.code}`;
60
+ return `agent-reach 反射桥未返回可判定结果(${why},本轮按降级处理);整体装配状态可用 gotry_doctor 查看`;
61
+ }
62
+ return `agent-reach 反射桥输出无法解析(退出码 ${r.code ?? '未知'},本轮按降级处理);整体装配状态可用 gotry_doctor 查看`;
63
+ }
64
+ /** 通用入口:反射调上游任意渠道方法;永不抛错 */
41
65
  export async function reach(q) {
42
66
  const started = Date.now();
43
- const evidence = (state)=>`[agent-reach:${q.channel}.${q.method}@${state === 'found' ? ts() : `${state}@${ts()}`}]`;
44
- const base = {
45
- channel: q.channel,
46
- method: q.method
47
- };
67
+ const evidence = (state) => `[agent-reach:${q.channel}.${q.method}@${state === 'found' ? ts() : `${state}@${ts()}`}]`;
68
+ const base = { channel: q.channel, method: q.method };
48
69
  if (!q.channel || !q.method) {
49
- return {
50
- ...base,
51
- ok: false,
52
- verdict: 'error',
53
- evidence: evidence('error'),
54
- latencyMs: 0,
55
- error: 'channel 与 method 必填(渠道/方法清单:先随便调一次,inventory 会带回上游清单)'
56
- };
70
+ return { ...base, ok: false, verdict: 'error', evidence: evidence('error'), latencyMs: 0, error: 'channel 与 method 必填(渠道/方法清单:先随便调一次,inventory 会带回上游清单)' };
57
71
  }
58
- const py = venvPython();
72
+ const py = q.pythonBin ?? venvPython();
59
73
  if (!existsSync(py)) {
60
- return {
61
- ...base,
62
- ok: false,
63
- verdict: 'not-installed',
64
- evidence: evidence('not-installed'),
65
- latencyMs: 0,
66
- setup: 'gotry .venv 缺 python — 见 docs/tokens.md(agent-reach 安装)'
67
- };
74
+ return { ...base, ok: false, verdict: 'not-installed', evidence: evidence('not-installed'), latencyMs: 0, setup: 'gotry .venv 缺 python——可选依赖未装配。补装:终端跑 npx @danceiny/gotry doctor --fix,或让用户看体检报告 npx @danceiny/gotry doctor' };
68
75
  }
69
- const args = Array.isArray(q.args) ? q.args : q.args ? q.args.split(/\s+/).filter(Boolean) : [];
70
- const r = await run(py, [
71
- bridgeScript(),
72
- q.channel,
73
- q.method,
74
- ...args
75
- ], q.timeoutMs ?? 30_000);
76
+ const args = Array.isArray(q.args) ? q.args : (q.args ? q.args.split(/\s+/).filter(Boolean) : []);
77
+ const timeoutMs = q.timeoutMs ?? 30_000;
78
+ const r = await run(py, [bridgeScript(), q.channel, q.method, ...args], timeoutMs);
76
79
  const latencyMs = Date.now() - started;
77
- let parsed = {};
80
+ let parsedRaw;
78
81
  try {
79
- parsed = JSON.parse((r.stdout || '').trim().split('\n').filter(Boolean).pop() ?? '{}');
80
- } catch {}
82
+ parsedRaw = JSON.parse((r.stdout || '').trim().split('\n').filter(Boolean).pop() ?? '{}');
83
+ }
84
+ catch { /* 走下面的兜底 */ }
85
+ // 形状闸:JSON 合法但不是对象(null/数组/标量)同不可解析处理,永不抛错(#559)
86
+ const parsed = typeof parsedRaw === 'object' && parsedRaw !== null && !Array.isArray(parsedRaw) ? parsedRaw : {};
87
+ // 桥结构化 error 是任意上游异常原话(可含凭证 URL/traceback),只在判定分支用,不透传用户面(#559)
88
+ const bridgeError = typeof parsed.error === 'string' && parsed.error.length > 0 ? parsed.error : undefined;
81
89
  if (r.err?.includes('ENOENT')) {
82
- return {
83
- ...base,
84
- ok: false,
85
- verdict: 'not-installed',
86
- evidence: evidence('not-installed'),
87
- latencyMs,
88
- setup: '.venv/bin/python 不可执行(装 agent-reach: 见 docs/tokens.md)'
89
- };
90
+ return { ...base, ok: false, verdict: 'not-installed', evidence: evidence('not-installed'), latencyMs, setup: '.venv/bin/python 不可执行——补装:终端跑 npx @danceiny/gotry doctor --fix' };
90
91
  }
91
92
  if (parsed.ok === true) {
92
- return {
93
- ...base,
94
- ok: true,
95
- verdict: 'found',
96
- evidence: evidence('found'),
97
- latencyMs,
98
- data: parsed.data
99
- };
93
+ return { ...base, ok: true, verdict: 'found', evidence: evidence('found'), latencyMs, data: parsed.data };
100
94
  }
101
- if (parsed.error?.includes('agent_reach 未安装')) {
102
- return {
103
- ...base,
104
- ok: false,
105
- verdict: 'not-installed',
106
- evidence: evidence('not-installed'),
107
- latencyMs,
108
- setup: '.venv 缺 agent-reach(pip install agent-reach,见 docs/tokens.md)'
109
- };
95
+ // 上游 agent_reach 包未装(bridge 自己的 exit 3 输出)
96
+ if (bridgeError?.includes('agent_reach 未安装')) {
97
+ return { ...base, ok: false, verdict: 'not-installed', evidence: evidence('not-installed'), latencyMs, setup: '.venv 缺 agent-reach 包——补装:终端跑 npx @danceiny/gotry doctor --fix' };
110
98
  }
99
+ // 未知渠道/方法:自描述,附上游清单(不拦 LLM,让它看清单自纠);error 用自身查询值给安全
100
+ // 描述——桥报错文案是任意上游文本不透传,清单本体不受影响(#559)
111
101
  if (r.code === 2) {
112
102
  return {
113
- ...base,
114
- ok: false,
115
- verdict: 'error',
116
- evidence: evidence('error'),
117
- latencyMs,
118
- error: parsed.error,
119
- inventory: parsed.channels ? {
120
- channels: parsed.channels
121
- } : {
122
- channel: parsed.channel,
123
- methods: parsed.methods
124
- }
103
+ ...base, ok: false, verdict: 'error', evidence: evidence('error'), latencyMs,
104
+ error: `${q.channel}.${q.method} 不在上游 agent-reach 渠道/方法清单内——按返回 inventory 清单改正渠道名/方法名后重调`,
105
+ inventory: parsed.channels ? { channels: parsed.channels } : { channel: parsed.channel, methods: parsed.methods },
125
106
  };
126
107
  }
108
+ // 调用抛错:若上游 check() 给出 warn/off,把上游原话作为 setup 透传;error 走分类安全文案
127
109
  const checkStatus = parsed.check?.status;
128
110
  if (checkStatus === 'warn' || checkStatus === 'off') {
129
111
  return {
130
- ...base,
131
- ok: false,
132
- verdict: 'needs-setup',
133
- evidence: evidence('needs-setup'),
134
- latencyMs,
135
- error: parsed.error,
136
- setup: parsed.check?.message
112
+ ...base, ok: false, verdict: 'needs-setup', evidence: evidence('needs-setup'), latencyMs,
113
+ error: `${q.channel}.${q.method} 调用失败:上游体检结论为 ${checkStatus}(渠道未就绪),本轮按降级处理;按 setup 指引配置后重试`,
114
+ setup: typeof parsed.check?.message === 'string' ? parsed.check.message : undefined,
137
115
  };
138
116
  }
117
+ // 桥报 ok:false(不论 error 字段可读与否)都按渠道调用失败分类;桥结构化 error 原话与
118
+ // 进程级失败(stdout 空/半截 JSON/形状不对/超时)都走人话——raw 原话可能带 traceback/
119
+ // 凭证片段,不进用户面;透传契约只剩 setup 与 inventory(#559)
139
120
  return {
140
- ...base,
141
- ok: false,
142
- verdict: 'error',
143
- evidence: evidence('error'),
144
- latencyMs,
145
- error: parsed.error ?? r.stderr.slice(0, 200)
121
+ ...base, ok: false, verdict: 'error', evidence: evidence('error'), latencyMs,
122
+ error: parsed.ok === false
123
+ ? `${q.channel}.${q.method} 调用失败:桥报告渠道调用出错但未附可读体检指引,本轮按降级处理;可调同渠道 check() 体检或用 gotry_doctor 查装配状态`
124
+ : bridgeFailureReason(r, timeoutMs),
146
125
  };
147
126
  }
127
+ /** 读网页:委托上游 WebChannel.read(Jina Reader 后端);供 gotry web 读取工具使用 */
148
128
  export async function readUrl(q) {
149
129
  if (!/^https?:\/\//.test(q.url.trim())) {
150
- return {
151
- ok: false,
152
- via: 'r.jina.ai-error',
153
- evidence: `[agent-reach:web.read@error@${ts()}] 非法 URL(需 http(s)://)`,
154
- latencyMs: 0,
155
- error: 'url 必须以 http(s):// 开头'
156
- };
130
+ return { ok: false, via: 'r.jina.ai-error', evidence: `[agent-reach:web.read@error@${ts()}] 非法 URL(需 http(s)://)`, latencyMs: 0, error: 'url 必须以 http(s):// 开头' };
157
131
  }
158
- const r = await reach({
159
- channel: 'web',
160
- method: 'read',
161
- args: [
162
- q.url.trim()
163
- ],
164
- timeoutMs: q.timeoutMs
165
- });
132
+ const r = await reach({ channel: 'web', method: 'read', args: [q.url.trim()], timeoutMs: q.timeoutMs, pythonBin: q.pythonBin });
166
133
  const content = typeof r.data === 'string' ? r.data.slice(0, 8000) : undefined;
134
+ // 上游 Jina Reader 输出首行 "Title: ...",提取为标题(展示层逻辑,非渠道知识)
167
135
  const title = content?.match(/^Title: (.+)$/m)?.[1];
168
136
  return {
169
- ok: r.ok,
170
- via: r.ok ? 'r.jina.ai' : 'r.jina.ai-error',
171
- title,
172
- content,
173
- evidence: r.evidence,
174
- latencyMs: r.latencyMs,
175
- error: r.error
137
+ ok: r.ok, via: r.ok ? 'r.jina.ai' : 'r.jina.ai-error',
138
+ title, content, evidence: r.evidence, latencyMs: r.latencyMs,
139
+ // not-installed/needs-setup 的补装/配置指引住在 setup,不穿过来 gotry_web_search 会渲染 unavailable (undefined)(#559)
140
+ error: r.setup ? [r.error, r.setup].filter(Boolean).join(';') : r.error,
176
141
  };
177
142
  }
143
+ /** 渠道体检:spawn 真 agent-reach doctor,输出原样透传 */
178
144
  export async function reachStatus(timeoutMs = 90_000) {
179
145
  const started = Date.now();
180
146
  const bin = resolve(repoRoot(), '.venv/bin/agent-reach');
181
147
  if (!existsSync(bin)) {
182
- return {
183
- ok: false,
184
- via: 'not-installed',
185
- evidence: `[agent-reach:doctor@not-installed@${ts()}]`,
186
- latencyMs: 0,
187
- output: 'pip install agent-reach 于 .venv(见 docs/tokens.md)'
188
- };
148
+ return { ok: false, via: 'not-installed', evidence: `[agent-reach:doctor@not-installed@${ts()}]`, latencyMs: 0, output: 'Agent Reach 未装配(.venv 缺失)——可选依赖,补装:终端跑 npx @danceiny/gotry doctor --fix;或让助手调 gotry_doctor 看整体体检报告' };
189
149
  }
190
- const r = await run(bin, [
191
- 'doctor'
192
- ], timeoutMs);
150
+ const r = await run(bin, ['doctor'], timeoutMs);
193
151
  const output = (r.stdout || r.stderr).trim();
194
152
  return {
195
153
  ok: !r.err?.includes('ENOENT') && r.code === 0,
196
154
  via: 'agent-reach-cli',
197
155
  evidence: `[agent-reach:doctor@${ts()}] via .venv/bin/agent-reach`,
198
156
  latencyMs: Date.now() - started,
199
- output: output.slice(0, 4000)
157
+ output: output.slice(0, 4000),
200
158
  };
201
159
  }
202
-
203
-
204
- //# sourceURL=/Users/bytedance/work/gotry/ts/capabilities/agent-reach.ts