@egbe-ai/opencode 0.0.0-stage → 0.1.8

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 (479) hide show
  1. package/LICENSE +4 -0
  2. package/README.md +124 -2
  3. package/index.js +5 -0
  4. package/package.json +55 -4
  5. package/plugin.js +230 -0
  6. package/session-log.js +315 -0
  7. package/skills/.egbe-catalog/manifest.json +1 -0
  8. package/skills/egbe-os-analytics/SKILL.md +499 -0
  9. package/skills/egbe-os-analytics/canonical-events.v1.json +256 -0
  10. package/skills/egbe-os-analytics/references/session-funnel.md +130 -0
  11. package/skills/egbe-os-analytics/references/workflows/activation-tracking.md +147 -0
  12. package/skills/egbe-os-analytics/references/workflows/landing-click-tracking.md +209 -0
  13. package/skills/egbe-os-analytics/references/workflows/payment-lifecycle-tracking.md +122 -0
  14. package/skills/egbe-os-analytics/references/workflows/product-funnel-tracking.md +77 -0
  15. package/skills/egbe-os-analytics/references/workflows/signup-lifecycle-tracking.md +208 -0
  16. package/skills/egbe-os-analytics/scripts/umami_funnel.py +927 -0
  17. package/skills/egbe-os-apollo-lead-finder/SKILL.md +135 -0
  18. package/skills/egbe-os-apollo-lead-finder/references/operations.md +240 -0
  19. package/skills/egbe-os-apollo-lead-finder/scripts/enrich.js +6 -0
  20. package/skills/egbe-os-apollo-lead-finder/scripts/enrich.sh +4 -0
  21. package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.js +6 -0
  22. package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.sh +4 -0
  23. package/skills/egbe-os-apollo-lead-finder/scripts/lib/apollo-client.js +343 -0
  24. package/skills/egbe-os-apollo-lead-finder/scripts/lib/connection-identity.js +17 -0
  25. package/skills/egbe-os-apollo-lead-finder/scripts/lib/helpers.js +127 -0
  26. package/skills/egbe-os-apollo-lead-finder/scripts/lib/places-filters.js +217 -0
  27. package/skills/egbe-os-apollo-lead-finder/scripts/lib/sourcing.js +153 -0
  28. package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.js +653 -0
  29. package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.sh +4 -0
  30. package/skills/egbe-os-apollo-lead-finder/scripts/search.js +6 -0
  31. package/skills/egbe-os-apollo-lead-finder/scripts/search.sh +4 -0
  32. package/skills/egbe-os-campaign-landing-page/SKILL.md +95 -0
  33. package/skills/egbe-os-campaign-landing-page/agents/openai.yaml +4 -0
  34. package/skills/egbe-os-campaign-landing-page/references/leads-calendar-and-tracking.md +66 -0
  35. package/skills/egbe-os-campaign-landing-page/references/os-wiring.md +58 -0
  36. package/skills/egbe-os-campaign-landing-page/references/qa.md +40 -0
  37. package/skills/egbe-os-campaign-landing-page/references/routing.md +32 -0
  38. package/skills/egbe-os-db/SKILL.md +174 -0
  39. package/skills/egbe-os-deploy/SKILL.md +412 -0
  40. package/skills/egbe-os-design/SKILL.md +182 -0
  41. package/skills/egbe-os-design-landing-page/SKILL.md +117 -0
  42. package/skills/egbe-os-design-landing-page/agents/openai.yaml +4 -0
  43. package/skills/egbe-os-design-landing-page/assets/scaffold/.dockerignore +11 -0
  44. package/skills/egbe-os-design-landing-page/assets/scaffold/AGENTS.md +31 -0
  45. package/skills/egbe-os-design-landing-page/assets/scaffold/Dockerfile +21 -0
  46. package/skills/egbe-os-design-landing-page/assets/scaffold/eslint.config.mjs +18 -0
  47. package/skills/egbe-os-design-landing-page/assets/scaffold/next.config.ts +11 -0
  48. package/skills/egbe-os-design-landing-page/assets/scaffold/package.json +36 -0
  49. package/skills/egbe-os-design-landing-page/assets/scaffold/postcss.config.mjs +7 -0
  50. package/skills/egbe-os-design-landing-page/assets/scaffold/public/.gitkeep +1 -0
  51. package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.edge.config.ts +13 -0
  52. package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.server.config.ts +13 -0
  53. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/global-error.tsx +19 -0
  54. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/globals.css +22 -0
  55. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/layout.tsx +21 -0
  56. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/page.tsx +3 -0
  57. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/privacy/page.tsx +28 -0
  58. package/skills/egbe-os-design-landing-page/assets/scaffold/src/components/egbe-analytics.tsx +39 -0
  59. package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation-client.ts +15 -0
  60. package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation.ts +13 -0
  61. package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/egbe-observability.generated.ts +20 -0
  62. package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/utils.ts +6 -0
  63. package/skills/egbe-os-design-landing-page/assets/scaffold/tsconfig.json +34 -0
  64. package/skills/egbe-os-design-landing-page/references/application-preparation.md +44 -0
  65. package/skills/egbe-os-design-landing-page/references/page-inputs.md +22 -0
  66. package/skills/egbe-os-destination-readiness/SKILL.md +132 -0
  67. package/skills/egbe-os-destination-readiness/references/checks.md +130 -0
  68. package/skills/egbe-os-destination-readiness/references/network-requirements.md +34 -0
  69. package/skills/egbe-os-destination-readiness/references/report.md +116 -0
  70. package/skills/egbe-os-domains/SKILL.md +189 -0
  71. package/skills/egbe-os-errors/SKILL.md +259 -0
  72. package/skills/egbe-os-git/SKILL.md +275 -0
  73. package/skills/egbe-os-git/references/issues.md +33 -0
  74. package/skills/egbe-os-google-ads/SKILL.md +163 -0
  75. package/skills/egbe-os-google-ads/references/artifacts.md +133 -0
  76. package/skills/egbe-os-google-ads/references/campaigns.md +157 -0
  77. package/skills/egbe-os-google-ads/references/conversions.md +153 -0
  78. package/skills/egbe-os-google-ads/references/delivery.md +128 -0
  79. package/skills/egbe-os-google-ads/references/keyword-ideas.md +40 -0
  80. package/skills/egbe-os-google-ads/references/reporting.md +105 -0
  81. package/skills/egbe-os-google-ads/references/search-assets.md +219 -0
  82. package/skills/egbe-os-google-ads/references/server-conversions.md +119 -0
  83. package/skills/egbe-os-google-auth/SKILL.md +285 -0
  84. package/skills/egbe-os-google-auth/agents/openai.yaml +4 -0
  85. package/skills/egbe-os-gtm-knowledge/SKILL.md +151 -0
  86. package/skills/egbe-os-images/SKILL.md +163 -0
  87. package/skills/egbe-os-images/references/stock-images.md +21 -0
  88. package/skills/egbe-os-instantly-campaign-launcher/SKILL.md +127 -0
  89. package/skills/egbe-os-instantly-campaign-launcher/references/instantly-ops.md +260 -0
  90. package/skills/egbe-os-instantly-campaign-launcher/references/observation-and-scheduling.md +188 -0
  91. package/skills/egbe-os-instantly-campaign-launcher/references/reply-handling.md +116 -0
  92. package/skills/egbe-os-instantly-campaign-launcher/references/run-spec-template.json +65 -0
  93. package/skills/egbe-os-instantly-campaign-launcher/references/run-state.md +145 -0
  94. package/skills/egbe-os-instantly-campaign-launcher/scripts/conclude-campaign.js +158 -0
  95. package/skills/egbe-os-instantly-campaign-launcher/scripts/install-crons.js +956 -0
  96. package/skills/egbe-os-instantly-campaign-launcher/scripts/launch-campaign.js +2008 -0
  97. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/campaign-metrics.js +124 -0
  98. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/confirmed-opt-outs.js +208 -0
  99. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/connection-identity.js +17 -0
  100. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/create-once.js +23 -0
  101. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/gtm-identity.js +125 -0
  102. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/helpers.js +545 -0
  103. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/html-body.js +266 -0
  104. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/instantly-client.js +328 -0
  105. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/outreach-db.js +370 -0
  106. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/recipient-exclusion/index.js +86 -0
  107. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/replenish-test-harness.js +53 -0
  108. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/reply-queue.js +67 -0
  109. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/run-config.js +103 -0
  110. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/sender-selection.js +105 -0
  111. package/skills/egbe-os-instantly-campaign-launcher/scripts/monitor-campaign.js +607 -0
  112. package/skills/egbe-os-instantly-campaign-launcher/scripts/outreach-report.js +147 -0
  113. package/skills/egbe-os-instantly-campaign-launcher/scripts/replenish-leads.js +619 -0
  114. package/skills/egbe-os-instantly-campaign-launcher/scripts/reply-worker.js +258 -0
  115. package/skills/egbe-os-instantly-campaign-launcher/scripts/run-cron-job.js +32 -0
  116. package/skills/egbe-os-instantly-campaign-launcher/scripts/send-reply.js +260 -0
  117. package/skills/egbe-os-linkedin-ads/SKILL.md +114 -0
  118. package/skills/egbe-os-linkedin-ads/references/destination-requirements.md +30 -0
  119. package/skills/egbe-os-linkedin-ads/references/runtime/api-reference.md +154 -0
  120. package/skills/egbe-os-linkedin-ads/references/runtime/artifacts.md +63 -0
  121. package/skills/egbe-os-linkedin-ads/references/workflows/build-paused.md +44 -0
  122. package/skills/egbe-os-linkedin-ads/references/workflows/conversions.md +88 -0
  123. package/skills/egbe-os-linkedin-ads/references/workflows/launch-and-pause.md +49 -0
  124. package/skills/egbe-os-linkedin-ads/references/workflows/monitoring.md +35 -0
  125. package/skills/egbe-os-linkedin-ads/references/workflows/readiness.md +63 -0
  126. package/skills/egbe-os-linkedin-ads/references/workflows/targeting-and-creative.md +52 -0
  127. package/skills/egbe-os-llm/SKILL.md +160 -0
  128. package/skills/egbe-os-mail/SKILL.md +180 -0
  129. package/skills/egbe-os-me/SKILL.md +119 -0
  130. package/skills/egbe-os-meta-ads/SKILL.md +114 -0
  131. package/skills/egbe-os-meta-ads/references/creative/creative-specs.md +15 -0
  132. package/skills/egbe-os-meta-ads/references/creative/talking-head.md +35 -0
  133. package/skills/egbe-os-meta-ads/references/destination-requirements.md +30 -0
  134. package/skills/egbe-os-meta-ads/references/runtime/api-reference.md +436 -0
  135. package/skills/egbe-os-meta-ads/references/runtime/artifacts.md +51 -0
  136. package/skills/egbe-os-meta-ads/references/runtime/insights-reference.md +187 -0
  137. package/skills/egbe-os-meta-ads/references/runtime/pixel-install.md +196 -0
  138. package/skills/egbe-os-meta-ads/references/runtime/shared-analytics-attribution.md +16 -0
  139. package/skills/egbe-os-meta-ads/references/workflows/build-paused.md +36 -0
  140. package/skills/egbe-os-meta-ads/references/workflows/launch-ready.md +16 -0
  141. package/skills/egbe-os-meta-ads/references/workflows/launch.md +23 -0
  142. package/skills/egbe-os-meta-ads/references/workflows/monitoring.md +72 -0
  143. package/skills/egbe-os-meta-ads/references/workflows/pause.md +17 -0
  144. package/skills/egbe-os-meta-ads/references/workflows/recovery.md +23 -0
  145. package/skills/egbe-os-meta-ads/scripts/check-pixel.py +229 -0
  146. package/skills/egbe-os-meta-ads/scripts/validate-meta-artifacts.py +187 -0
  147. package/skills/egbe-os-notifications/SKILL.md +78 -0
  148. package/skills/egbe-os-openai-ads/SKILL.md +149 -0
  149. package/skills/egbe-os-openai-ads/references/creative/chat-card.md +51 -0
  150. package/skills/egbe-os-openai-ads/references/destination-requirements.md +29 -0
  151. package/skills/egbe-os-openai-ads/references/runtime/api-reference.md +219 -0
  152. package/skills/egbe-os-openai-ads/references/runtime/artifacts.md +169 -0
  153. package/skills/egbe-os-openai-ads/references/workflows/build-paused.md +40 -0
  154. package/skills/egbe-os-openai-ads/references/workflows/conversions.md +40 -0
  155. package/skills/egbe-os-openai-ads/references/workflows/creative-assembly.md +24 -0
  156. package/skills/egbe-os-openai-ads/references/workflows/launch.md +27 -0
  157. package/skills/egbe-os-openai-ads/references/workflows/monitoring.md +54 -0
  158. package/skills/egbe-os-openai-ads/references/workflows/pause.md +22 -0
  159. package/skills/egbe-os-openai-ads/references/workflows/readiness.md +37 -0
  160. package/skills/egbe-os-openai-ads/references/workflows/tracking.md +32 -0
  161. package/skills/egbe-os-openai-ads/scripts/validate-openai-artifacts.py +271 -0
  162. package/skills/egbe-os-organic-trend-watch/SKILL.md +139 -0
  163. package/skills/egbe-os-organic-trend-watch/agents/openai.yaml +4 -0
  164. package/skills/egbe-os-organic-trend-watch/references/analysis-and-adaptation.md +54 -0
  165. package/skills/egbe-os-organic-trend-watch/references/collection-and-analysis.md +117 -0
  166. package/skills/egbe-os-organic-trend-watch/references/output-contract.md +133 -0
  167. package/skills/egbe-os-organic-trend-watch/references/provider-contract.md +169 -0
  168. package/skills/egbe-os-organic-trend-watch/references/runtime-contract.md +204 -0
  169. package/skills/egbe-os-organic-trend-watch/references/visual-analysis-prompt.md +17 -0
  170. package/skills/egbe-os-organic-trend-watch/scripts/_analysis.py +612 -0
  171. package/skills/egbe-os-organic-trend-watch/scripts/_contract.py +1133 -0
  172. package/skills/egbe-os-organic-trend-watch/scripts/_provider_inputs.py +165 -0
  173. package/skills/egbe-os-organic-trend-watch/scripts/analyze-visual-evidence.py +315 -0
  174. package/skills/egbe-os-organic-trend-watch/scripts/build-provider-inputs.py +88 -0
  175. package/skills/egbe-os-organic-trend-watch/scripts/connection_identity.py +22 -0
  176. package/skills/egbe-os-organic-trend-watch/scripts/egbe_artifacts.py +24 -0
  177. package/skills/egbe-os-organic-trend-watch/scripts/finalize-receipt.py +106 -0
  178. package/skills/egbe-os-organic-trend-watch/scripts/normalize-videos.py +647 -0
  179. package/skills/egbe-os-organic-trend-watch/scripts/prepare-visual-evidence.py +324 -0
  180. package/skills/egbe-os-organic-trend-watch/scripts/render-result.py +30 -0
  181. package/skills/egbe-os-organic-trend-watch/scripts/run-apify.py +723 -0
  182. package/skills/egbe-os-organic-trend-watch/scripts/run-state.py +192 -0
  183. package/skills/egbe-os-organic-trend-watch/scripts/validate-context.py +27 -0
  184. package/skills/egbe-os-organic-trend-watch/scripts/validate-runtime.py +137 -0
  185. package/skills/egbe-os-payments/SKILL.md +215 -0
  186. package/skills/egbe-os-payments/agents/openai.yaml +4 -0
  187. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/.egbe/scaffolds/billing-nextjs-subscription.v1.json +5 -0
  188. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/AGENTS.append.md +13 -0
  189. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/db/migrations/1000_egbe_billing.sql +66 -0
  190. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/package.fragment.json +12 -0
  191. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/scripts/billing-sync.mjs +162 -0
  192. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/error.tsx +11 -0
  193. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/loading.tsx +8 -0
  194. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/page.tsx +121 -0
  195. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/checkout/route.ts +102 -0
  196. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/portal/route.ts +54 -0
  197. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/status/route.ts +22 -0
  198. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/payments/webhook/route.ts +65 -0
  199. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/components/egbe-billing/plan-badge.tsx +16 -0
  200. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/billing-sync.test.mjs +58 -0
  201. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/catalog.ts +82 -0
  202. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/checkout-payload.ts +47 -0
  203. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/foundation-contract.test.mjs +59 -0
  204. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.d.ts +16 -0
  205. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.mjs +82 -0
  206. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.test.mjs +94 -0
  207. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/os-client.ts +96 -0
  208. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/plans.json +17 -0
  209. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/repository.ts +325 -0
  210. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.d.ts +6 -0
  211. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.mjs +22 -0
  212. package/skills/egbe-os-payments/references/contracts/plan-catalog.md +46 -0
  213. package/skills/egbe-os-payments/references/security/durable-verification.md +64 -0
  214. package/skills/egbe-os-payments/references/security/server-integration.md +26 -0
  215. package/skills/egbe-os-payments/references/security/webhook-and-entitlements.md +152 -0
  216. package/skills/egbe-os-payments/references/ux/billing-experience.md +47 -0
  217. package/skills/egbe-os-payments/references/workflows/account-billing.md +64 -0
  218. package/skills/egbe-os-payments/references/workflows/discounts-and-promotion-codes.md +265 -0
  219. package/skills/egbe-os-payments/references/workflows/one-time-purchase.md +75 -0
  220. package/skills/egbe-os-payments/references/workflows/product-checkout.md +355 -0
  221. package/skills/egbe-os-payments/references/workflows/subscription-lifecycle.md +55 -0
  222. package/skills/egbe-os-playbook/SKILL.md +79 -0
  223. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/email-outreach.md +91 -0
  224. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/google-search.md +40 -0
  225. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/linkedin.md +24 -0
  226. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/meta.md +23 -0
  227. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/openai.md +15 -0
  228. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/reddit.md +56 -0
  229. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/choose-test.md +73 -0
  230. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/evaluate.md +91 -0
  231. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/market.md +96 -0
  232. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/run-test.md +111 -0
  233. package/skills/egbe-os-playbook/playbooks/market-and-acquisition.md +56 -0
  234. package/skills/egbe-os-playbook/playbooks/product/business-loop.md +141 -0
  235. package/skills/egbe-os-playbook/playbooks/product/collaboration.md +26 -0
  236. package/skills/egbe-os-playbook/playbooks/product/deliver.md +75 -0
  237. package/skills/egbe-os-playbook/playbooks/product/diagnose.md +80 -0
  238. package/skills/egbe-os-playbook/playbooks/product/evaluate.md +67 -0
  239. package/skills/egbe-os-playbook/playbooks/product/experience.md +132 -0
  240. package/skills/egbe-os-playbook/playbooks/product/loop-examples.md +67 -0
  241. package/skills/egbe-os-playbook/playbooks/product/offer.md +65 -0
  242. package/skills/egbe-os-playbook/playbooks/product/value.md +91 -0
  243. package/skills/egbe-os-playbook/playbooks/product.md +67 -0
  244. package/skills/egbe-os-playbook/references/catalog.md +127 -0
  245. package/skills/egbe-os-playbook/references/changes.md +167 -0
  246. package/skills/egbe-os-playbook/scripts/playbook-changes.py +6 -0
  247. package/skills/egbe-os-playbook/scripts/playbook_changes/__init__.py +1 -0
  248. package/skills/egbe-os-playbook/scripts/playbook_changes/cli.py +57 -0
  249. package/skills/egbe-os-playbook/scripts/playbook_changes/operations.py +137 -0
  250. package/skills/egbe-os-playbook/scripts/playbook_changes/protocol.py +132 -0
  251. package/skills/egbe-os-playbook/scripts/playbook_changes/storage.py +180 -0
  252. package/skills/egbe-os-playbook/scripts/playbook_changes/transport.py +113 -0
  253. package/skills/egbe-os-product-auth/SKILL.md +151 -0
  254. package/skills/egbe-os-product-auth/agents/openai.yaml +4 -0
  255. package/skills/egbe-os-product-auth/assets/db/README.md +102 -0
  256. package/skills/egbe-os-product-auth/assets/db/create-validation-session.mjs +223 -0
  257. package/skills/egbe-os-product-auth/assets/db/migrate.mjs +64 -0
  258. package/skills/egbe-os-product-auth/assets/db/migrations/0001_auth.sql +33 -0
  259. package/skills/egbe-os-product-auth/assets/db/migrations/0002_auth_identities.sql +16 -0
  260. package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/AGENTS.append.md +17 -0
  261. package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/package.fragment.json +10 -0
  262. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/AGENTS.append.md +9 -0
  263. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/package.fragment.json +13 -0
  264. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/db.ts +31 -0
  265. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/identity.ts +94 -0
  266. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/index.ts +3 -0
  267. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/session.ts +91 -0
  268. package/skills/egbe-os-product-auth/references/contracts/live-auth-interface.md +108 -0
  269. package/skills/egbe-os-product-auth/references/frameworks/nextjs.md +34 -0
  270. package/skills/egbe-os-product-auth/references/security/session-and-credentials.md +73 -0
  271. package/skills/egbe-os-product-auth/references/ux/auth-experience.md +58 -0
  272. package/skills/egbe-os-product-auth/references/workflows/account-recovery.md +22 -0
  273. package/skills/egbe-os-product-auth/references/workflows/build-auth.md +212 -0
  274. package/skills/egbe-os-product-auth/references/workflows/google.md +34 -0
  275. package/skills/egbe-os-product-auth/references/workflows/passwordless-email.md +65 -0
  276. package/skills/egbe-os-product-build/SKILL.md +111 -0
  277. package/skills/egbe-os-product-build/agents/openai.yaml +4 -0
  278. package/skills/egbe-os-product-build/references/capabilities.md +25 -0
  279. package/skills/egbe-os-product-build/references/engineering.md +72 -0
  280. package/skills/egbe-os-product-build/references/execution.md +55 -0
  281. package/skills/egbe-os-product-build/references/foundations.md +93 -0
  282. package/skills/egbe-os-product-build/references/interface-quality.md +32 -0
  283. package/skills/egbe-os-product-build/references/workflows/private-review-handoff.md +86 -0
  284. package/skills/egbe-os-product-build/scripts/scaffold.py +296 -0
  285. package/skills/egbe-os-product-demo-video/SKILL.md +118 -0
  286. package/skills/egbe-os-product-demo-video/references/recording.md +32 -0
  287. package/skills/egbe-os-product-market-research/SKILL.md +159 -0
  288. package/skills/egbe-os-product-market-research/agents/openai.yaml +4 -0
  289. package/skills/egbe-os-product-market-research/references/catalog.v1.json +177 -0
  290. package/skills/egbe-os-product-market-research/references/config/channel-footprint-sources.v1.json +99 -0
  291. package/skills/egbe-os-product-market-research/references/config/creative-taxonomy.v1.json +367 -0
  292. package/skills/egbe-os-product-market-research/references/contracts/creative-video.md +75 -0
  293. package/skills/egbe-os-product-market-research/references/contracts/funnel-teardown.md +235 -0
  294. package/skills/egbe-os-product-market-research/references/contracts/geography-comparison.md +71 -0
  295. package/skills/egbe-os-product-market-research/references/contracts/lifecycle-capture.md +119 -0
  296. package/skills/egbe-os-product-market-research/references/contracts/research-artifacts.md +520 -0
  297. package/skills/egbe-os-product-market-research/references/contracts/walk-mechanics.v2.json +18 -0
  298. package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.md +137 -0
  299. package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.user.md +4 -0
  300. package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.md +118 -0
  301. package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.user.md +4 -0
  302. package/skills/egbe-os-product-market-research/references/prompts/demand-validation.md +154 -0
  303. package/skills/egbe-os-product-market-research/references/prompts/demand-validation.user.md +4 -0
  304. package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.md +100 -0
  305. package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.user.md +4 -0
  306. package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.md +126 -0
  307. package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.user.md +4 -0
  308. package/skills/egbe-os-product-market-research/references/prompts/target-audience.md +98 -0
  309. package/skills/egbe-os-product-market-research/references/prompts/target-audience.user.md +4 -0
  310. package/skills/egbe-os-product-market-research/references/prompts/unit-economics.md +217 -0
  311. package/skills/egbe-os-product-market-research/references/prompts/unit-economics.user.md +4 -0
  312. package/skills/egbe-os-product-market-research/references/prompts/value-proposition.md +113 -0
  313. package/skills/egbe-os-product-market-research/references/prompts/value-proposition.user.md +4 -0
  314. package/skills/egbe-os-product-market-research/references/workflows/acquisition-channels.md +27 -0
  315. package/skills/egbe-os-product-market-research/references/workflows/channel-footprint.md +163 -0
  316. package/skills/egbe-os-product-market-research/references/workflows/community-demand.md +100 -0
  317. package/skills/egbe-os-product-market-research/references/workflows/competitive-landscape.md +27 -0
  318. package/skills/egbe-os-product-market-research/references/workflows/competitor-ads.md +82 -0
  319. package/skills/egbe-os-product-market-research/references/workflows/competitor-set.md +300 -0
  320. package/skills/egbe-os-product-market-research/references/workflows/creative-patterns.md +228 -0
  321. package/skills/egbe-os-product-market-research/references/workflows/demand-validation.md +27 -0
  322. package/skills/egbe-os-product-market-research/references/workflows/fleet-prior.md +80 -0
  323. package/skills/egbe-os-product-market-research/references/workflows/funnel-teardown.md +184 -0
  324. package/skills/egbe-os-product-market-research/references/workflows/geography-comparison.md +84 -0
  325. package/skills/egbe-os-product-market-research/references/workflows/keyword-economics.md +122 -0
  326. package/skills/egbe-os-product-market-research/references/workflows/lifecycle-capture.md +218 -0
  327. package/skills/egbe-os-product-market-research/references/workflows/local-research.md +55 -0
  328. package/skills/egbe-os-product-market-research/references/workflows/market-size-and-dynamics.md +27 -0
  329. package/skills/egbe-os-product-market-research/references/workflows/preview.md +175 -0
  330. package/skills/egbe-os-product-market-research/references/workflows/pricing-and-monetization.md +27 -0
  331. package/skills/egbe-os-product-market-research/references/workflows/recommendations.md +35 -0
  332. package/skills/egbe-os-product-market-research/references/workflows/review-mining.md +76 -0
  333. package/skills/egbe-os-product-market-research/references/workflows/target-audience.md +27 -0
  334. package/skills/egbe-os-product-market-research/references/workflows/tiktok-reels-market-trends.md +46 -0
  335. package/skills/egbe-os-product-market-research/references/workflows/unit-economics.md +27 -0
  336. package/skills/egbe-os-product-market-research/references/workflows/value-proposition.md +27 -0
  337. package/skills/egbe-os-product-market-research/scripts/build-organic-trend-context.py +167 -0
  338. package/skills/egbe-os-product-market-research/scripts/build-preview-context.py +91 -0
  339. package/skills/egbe-os-product-market-research/scripts/build-research-query.py +225 -0
  340. package/skills/egbe-os-product-market-research/scripts/channel-footprint-model.py +294 -0
  341. package/skills/egbe-os-product-market-research/scripts/connection_identity.py +22 -0
  342. package/skills/egbe-os-product-market-research/scripts/creative-model.py +364 -0
  343. package/skills/egbe-os-product-market-research/scripts/creative-selection.py +113 -0
  344. package/skills/egbe-os-product-market-research/scripts/creative-semantics.py +365 -0
  345. package/skills/egbe-os-product-market-research/scripts/creative-video.py +542 -0
  346. package/skills/egbe-os-product-market-research/scripts/egbe_artifacts.py +24 -0
  347. package/skills/egbe-os-product-market-research/scripts/finalize-organic-trend-watch.py +304 -0
  348. package/skills/egbe-os-product-market-research/scripts/funnel-email-review.py +97 -0
  349. package/skills/egbe-os-product-market-research/scripts/funnel-model.py +966 -0
  350. package/skills/egbe-os-product-market-research/scripts/funnel_features.py +50 -0
  351. package/skills/egbe-os-product-market-research/scripts/geography-comparison-contract.py +172 -0
  352. package/skills/egbe-os-product-market-research/scripts/geography-comparison.py +169 -0
  353. package/skills/egbe-os-product-market-research/scripts/keyword-forecast.py +61 -0
  354. package/skills/egbe-os-product-market-research/scripts/keyword-locale-publication.py +136 -0
  355. package/skills/egbe-os-product-market-research/scripts/lifecycle-start.py +190 -0
  356. package/skills/egbe-os-product-market-research/scripts/persist-research-report.py +63 -0
  357. package/skills/egbe-os-product-market-research/scripts/research-artifact-io.py +281 -0
  358. package/skills/egbe-os-product-market-research/scripts/research-evidence.py +496 -0
  359. package/skills/egbe-os-product-market-research/scripts/research-policy.py +33 -0
  360. package/skills/egbe-os-product-market-research/scripts/research-section-runtime.py +343 -0
  361. package/skills/egbe-os-product-market-research/scripts/research-section-workflow.py +288 -0
  362. package/skills/egbe-os-product-market-research/scripts/research_integrity.py +122 -0
  363. package/skills/egbe-os-product-market-research/scripts/review-research-completion.py +306 -0
  364. package/skills/egbe-os-product-market-research/scripts/run-acquisition-channels.py +72 -0
  365. package/skills/egbe-os-product-market-research/scripts/run-channel-footprint.py +2258 -0
  366. package/skills/egbe-os-product-market-research/scripts/run-community-demand.py +1603 -0
  367. package/skills/egbe-os-product-market-research/scripts/run-competitive-landscape.py +66 -0
  368. package/skills/egbe-os-product-market-research/scripts/run-competitor-ads.py +1156 -0
  369. package/skills/egbe-os-product-market-research/scripts/run-competitor-set.py +2514 -0
  370. package/skills/egbe-os-product-market-research/scripts/run-creative-patterns.py +2042 -0
  371. package/skills/egbe-os-product-market-research/scripts/run-demand-validation.py +72 -0
  372. package/skills/egbe-os-product-market-research/scripts/run-fleet-prior.py +652 -0
  373. package/skills/egbe-os-product-market-research/scripts/run-funnel-teardown.py +493 -0
  374. package/skills/egbe-os-product-market-research/scripts/run-keyword-economics.py +1443 -0
  375. package/skills/egbe-os-product-market-research/scripts/run-lifecycle-capture.py +1543 -0
  376. package/skills/egbe-os-product-market-research/scripts/run-market-size-and-dynamics.py +66 -0
  377. package/skills/egbe-os-product-market-research/scripts/run-os-research.py +311 -0
  378. package/skills/egbe-os-product-market-research/scripts/run-pricing-and-monetization.py +71 -0
  379. package/skills/egbe-os-product-market-research/scripts/run-review-mining.py +1051 -0
  380. package/skills/egbe-os-product-market-research/scripts/run-target-audience.py +66 -0
  381. package/skills/egbe-os-product-market-research/scripts/run-unit-economics.py +71 -0
  382. package/skills/egbe-os-product-market-research/scripts/run-value-proposition.py +67 -0
  383. package/skills/egbe-os-product-market-research/scripts/upsert-markdown-section.py +156 -0
  384. package/skills/egbe-os-product-market-research/scripts/walk-funnels.py +249 -0
  385. package/skills/egbe-os-product-market-research/scripts/write-preview.py +710 -0
  386. package/skills/egbe-os-product-market-research/scripts/write-recommendations.py +272 -0
  387. package/skills/egbe-os-product-report/SKILL.md +150 -0
  388. package/skills/egbe-os-product-report/references/artifacts.md +84 -0
  389. package/skills/egbe-os-product-report/references/brief.md +34 -0
  390. package/skills/egbe-os-product-report/references/daily.md +76 -0
  391. package/skills/egbe-os-product-report/references/sources.md +68 -0
  392. package/skills/egbe-os-product-routines/SKILL.md +166 -0
  393. package/skills/egbe-os-product-routines/references/catalog.md +22 -0
  394. package/skills/egbe-os-product-routines/references/continuation-check.md +41 -0
  395. package/skills/egbe-os-product-routines/references/product-reporting.md +163 -0
  396. package/skills/egbe-os-product-routines/references/run-preset.md +32 -0
  397. package/skills/egbe-os-quickstart/scripts/egbe-curl.py +357 -0
  398. package/skills/egbe-os-quiz-funnel/SKILL.md +152 -0
  399. package/skills/egbe-os-quiz-funnel/agents/openai.yaml +4 -0
  400. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.d.mts +224 -0
  401. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.mjs +652 -0
  402. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.test.mjs +764 -0
  403. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.d.mts +31 -0
  404. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.mjs +87 -0
  405. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.test.mjs +265 -0
  406. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-reference.test.mjs +254 -0
  407. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/QUIZ.md +195 -0
  408. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.json +421 -0
  409. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.public.json +369 -0
  410. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/validation.json +21 -0
  411. package/skills/egbe-os-quiz-funnel/assets/reference/index.html +26 -0
  412. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-bootstrap.js +31 -0
  413. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-early-actions.mjs +11 -0
  414. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-first-screen.mjs +32 -0
  415. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-page.mjs +480 -0
  416. package/skills/egbe-os-quiz-funnel/assets/reference/quiz.css +264 -0
  417. package/skills/egbe-os-quiz-funnel/references/competitor-teardown.md +159 -0
  418. package/skills/egbe-os-quiz-funnel/references/conversion-handoff.md +156 -0
  419. package/skills/egbe-os-quiz-funnel/references/implementation.md +207 -0
  420. package/skills/egbe-os-quiz-funnel/references/inputs.md +37 -0
  421. package/skills/egbe-os-quiz-funnel/references/measurement.md +122 -0
  422. package/skills/egbe-os-quiz-funnel/references/spec-contract.md +335 -0
  423. package/skills/egbe-os-quiz-funnel/references/verification.md +101 -0
  424. package/skills/egbe-os-quiz-funnel/references/walk-mechanics.v2.json +18 -0
  425. package/skills/egbe-os-quiz-funnel/scripts/compile-quiz-spec.py +1869 -0
  426. package/skills/egbe-os-quiz-funnel/scripts/prepare-research-identity.py +66 -0
  427. package/skills/egbe-os-reddit-ads/SKILL.md +121 -0
  428. package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/schema.json +41 -0
  429. package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/template.html +106 -0
  430. package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/schema.json +61 -0
  431. package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/template.html +151 -0
  432. package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/schema.json +91 -0
  433. package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/template.html +185 -0
  434. package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/schema.json +51 -0
  435. package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/template.html +121 -0
  436. package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/schema.json +87 -0
  437. package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/template.html +212 -0
  438. package/skills/egbe-os-reddit-ads/references/creative/html-to-png-pipeline.md +123 -0
  439. package/skills/egbe-os-reddit-ads/references/creative/static-banner-qa.md +12 -0
  440. package/skills/egbe-os-reddit-ads/references/creative/static-banner-system.md +16 -0
  441. package/skills/egbe-os-reddit-ads/references/destination-requirements.md +36 -0
  442. package/skills/egbe-os-reddit-ads/references/runtime/api-reference.md +435 -0
  443. package/skills/egbe-os-reddit-ads/references/runtime/artifacts.md +57 -0
  444. package/skills/egbe-os-reddit-ads/references/runtime/monitoring.md +64 -0
  445. package/skills/egbe-os-reddit-ads/references/runtime/pixel-and-tracking.md +49 -0
  446. package/skills/egbe-os-reddit-ads/references/runtime/policies.md +19 -0
  447. package/skills/egbe-os-reddit-ads/references/runtime/shared-analytics-attribution.md +14 -0
  448. package/skills/egbe-os-reddit-ads/references/workflows/build-paused.md +35 -0
  449. package/skills/egbe-os-reddit-ads/references/workflows/launch-ready.md +19 -0
  450. package/skills/egbe-os-reddit-ads/references/workflows/launch.md +32 -0
  451. package/skills/egbe-os-reddit-ads/references/workflows/readiness.md +9 -0
  452. package/skills/egbe-os-reddit-ads/scripts/capture-ad.sh +178 -0
  453. package/skills/egbe-os-reddit-ads/scripts/validate-reddit-artifacts.py +187 -0
  454. package/skills/egbe-os-report-ui/SKILL.md +133 -0
  455. package/skills/egbe-os-report-ui/assets/egbe-wordmark.svg +9 -0
  456. package/skills/egbe-os-report-ui/assets/examples/components.html +417 -0
  457. package/skills/egbe-os-report-ui/assets/examples/editorial.html +209 -0
  458. package/skills/egbe-os-report-ui/assets/scaffold.html +179 -0
  459. package/skills/egbe-os-report-ui/references/components.md +209 -0
  460. package/skills/egbe-os-research/SKILL.md +125 -0
  461. package/skills/egbe-os-saas-unit-economics/SKILL.md +188 -0
  462. package/skills/egbe-os-scrape/SKILL.md +160 -0
  463. package/skills/egbe-os-search/SKILL.md +182 -0
  464. package/skills/egbe-os-search/references/google-places.md +81 -0
  465. package/skills/egbe-os-support/SKILL.md +149 -0
  466. package/skills/egbe-os-telemetry/SKILL.md +344 -0
  467. package/skills/egbe-os-telemetry/references/harnesses/claude-code.md +97 -0
  468. package/skills/egbe-os-telemetry/references/harnesses/codex.md +22 -0
  469. package/skills/egbe-os-telemetry/references/harnesses/hermes.md +39 -0
  470. package/skills/egbe-os-telemetry/references/harnesses/openclaw.md +139 -0
  471. package/skills/egbe-os-telemetry/references/harnesses/opencode.md +28 -0
  472. package/skills/egbe-os-tools/SKILL.md +180 -0
  473. package/skills/egbe-os-tools/references/theona.md +26 -0
  474. package/skills/egbe-os-wallet/SKILL.md +181 -0
  475. package/skills/egbe-setup/EGBE.md +484 -0
  476. package/skills/egbe-setup/SKILL.md +116 -0
  477. package/skills/egbe-setup/references/project.md +80 -0
  478. package/state.js +37 -0
  479. package/update.js +361 -0
@@ -0,0 +1,653 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+ const connectionHeaders = require('./lib/connection-identity');
4
+ const connectionIdentityByConfig = new WeakMap();
5
+
6
+ /**
7
+ * places-leads — Source business listings and public website contact candidates.
8
+ *
9
+ * 1. POST $OS_URL/search/places for each query (place names + place_ids)
10
+ * 2. POST $OS_URL/tools/places/details per place (websiteUri, types, phone)
11
+ * 3. Scrape each website (homepage + /contact + /about) for an email
12
+ * 4. Filter traps, prefer personal over generic addresses, emit the same
13
+ * output contract as find-leads.js with email_status "unverified"
14
+ *
15
+ * Search, details and reviews have separate project quotas and operation costs.
16
+ * The local processing cap is not a statement of available daily quota.
17
+ *
18
+ * Usage:
19
+ * node places-leads.js \
20
+ * --queries "real estate photographer austin;real estate photographer dallas" \
21
+ * --exclude-categories "headshot,wedding,portrait" \
22
+ * --max-places 60 --output leads.json [--env-file <path>] [--verbose]
23
+ */
24
+
25
+ const https = require("https");
26
+ const http = require("http");
27
+ const dns = require("dns");
28
+ const path = require("path");
29
+ const { URL } = require("url");
30
+ const { isDailyQuotaError, responseStopReason } = require("./lib/apollo-client");
31
+ const { positiveInteger } = require("./lib/sourcing");
32
+ const {
33
+ parseArgs,
34
+ writeJson,
35
+ isoNow,
36
+ normalizeEmail,
37
+ parseList,
38
+ parseSemicolonList,
39
+ readEnvFile,
40
+ getOsConfig,
41
+ } = require("./lib/helpers");
42
+ const {
43
+ GENERIC_LOCAL_PARTS,
44
+ FREEMAIL_DOMAINS,
45
+ classifyEmail,
46
+ extractOwnerFirstName,
47
+ } = require("./lib/places-filters");
48
+
49
+ const BROWSER_UA =
50
+ "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 " +
51
+ "(KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36";
52
+ const FETCH_TIMEOUT_MS = 8000;
53
+ const MAX_REDIRECTS = 3;
54
+ const MAX_HTML_BYTES = 600_000;
55
+ // Places search returns at most 20 results per query (API page cap).
56
+ const SEARCH_PAGE_CAP = 20;
57
+ // The tools-gateway details default field mask has no primaryType/types, so
58
+ // request an explicit mask with everything the pipeline needs.
59
+ const DETAILS_FIELDS =
60
+ "id,displayName,formattedAddress,websiteUri,nationalPhoneNumber,primaryType,types";
61
+ // Conservative: bounded TLD ({2,24} covers long ICANN TLDs the target ICP
62
+ // actually uses — .photography, .construction), single-case TLD label so a
63
+ // mixed-case sentence glued after the address ("jane@janephoto.com.Call")
64
+ // cannot be matched as the TLD, and the match may not continue with a word
65
+ // char (avoids swallowing text concatenated after the address in minified
66
+ // HTML).
67
+ const EMAIL_RE =
68
+ /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.(?:[a-z]{2,24}|[A-Z]{2,24})(?![A-Za-z0-9-])/g;
69
+
70
+ function fail(msg) {
71
+ console.error(`FATAL: ${msg}`);
72
+ process.exit(1);
73
+ }
74
+
75
+ /**
76
+ * Authenticated OS request. Mirrors lib/apollo-client.js: retries transient
77
+ * statuses with backoff and unwraps the OS `{code, message, data}` envelope.
78
+ */
79
+ async function osRequest(cfg, method, pathname, body = null, attempt = 0) {
80
+ if (Date.now() >= cfg.deadline) return { status: 0, stop_reason: "time_budget" };
81
+ if (!connectionIdentityByConfig.has(cfg)) connectionIdentityByConfig.set(cfg, connectionHeaders(cfg.osUrl, cfg.connectionEnvFile));
82
+ const url = new URL(cfg.osUrl.replace(/\/$/, "") + pathname);
83
+ const transport = url.protocol === "http:" ? http : https;
84
+ const payload = body == null ? null : JSON.stringify(body);
85
+ const options = {
86
+ method,
87
+ hostname: url.hostname,
88
+ port: url.port || (url.protocol === "http:" ? 80 : 443),
89
+ path: url.pathname + url.search,
90
+ headers: {
91
+ ...connectionIdentityByConfig.get(cfg),
92
+ Authorization: `Bearer ${cfg.osApiKey}`,
93
+ "Content-Type": "application/json",
94
+ "Cache-Control": "no-cache",
95
+ },
96
+ timeout: Math.min(30000, cfg.deadline - Date.now()),
97
+ };
98
+ if (payload) options.headers["Content-Length"] = Buffer.byteLength(payload);
99
+
100
+ const response = await new Promise((resolve, reject) => {
101
+ const req = transport.request(options, (res) => {
102
+ let data = "";
103
+ res.on("data", (c) => (data += c));
104
+ res.on("end", () => {
105
+ clearTimeout(deadlineTimer);
106
+ let parsed = data;
107
+ try {
108
+ parsed = data ? JSON.parse(data) : null;
109
+ } catch {}
110
+ resolve({ status: res.statusCode, headers: res.headers, body: parsed });
111
+ });
112
+ res.on("error", (error) => { clearTimeout(deadlineTimer); reject(error); });
113
+ });
114
+ const deadlineTimer = setTimeout(() => req.destroy(new Error("Request time budget exceeded")), options.timeout);
115
+ req.on("error", (error) => { clearTimeout(deadlineTimer); reject(error); });
116
+ req.on("timeout", () => req.destroy(new Error("Request timeout")));
117
+ if (payload) req.write(payload);
118
+ req.end();
119
+ });
120
+
121
+ const retryable = [408, 429, 500, 502, 503, 504].includes(response.status);
122
+ if (retryable && attempt < 3 && !isDailyQuotaError(response)) {
123
+ const retryAfter = Number(response.headers["retry-after"] || 0);
124
+ const delayMs = retryAfter > 0 ? retryAfter * 1000 : 1000 * Math.pow(2, attempt);
125
+ if (delayMs >= cfg.deadline - Date.now()) return { ...response, stop_reason: "time_budget" };
126
+ if (cfg.verbose)
127
+ console.error(`Retry ${attempt + 1} after ${delayMs}ms (status ${response.status})`);
128
+ await new Promise((r) => setTimeout(r, delayMs));
129
+ return osRequest(cfg, method, pathname, body, attempt + 1);
130
+ }
131
+ if (cfg.verbose) console.error(`${method} ${url.pathname} -> ${response.status}`);
132
+ if (
133
+ response.status >= 200 &&
134
+ response.status < 300 &&
135
+ response.body &&
136
+ typeof response.body === "object" &&
137
+ Object.prototype.hasOwnProperty.call(response.body, "data")
138
+ ) {
139
+ response.body = response.body.data;
140
+ }
141
+ return response;
142
+ }
143
+
144
+ // --- SSRF guard -------------------------------------------------------------
145
+ // websiteUri comes from a third-party Places listing, and a public site can
146
+ // 302 to loopback / RFC1918 / link-local (cloud metadata) addresses. Mirror
147
+ // tools-gateway/app/providers/destination_urls.py: reject internal hosts up
148
+ // front, resolve DNS once per hop, refuse any non-public answer, and pin the
149
+ // connection to the vetted address (Host header + SNI keep the logical
150
+ // hostname) so a rebinding second lookup cannot redirect the request.
151
+
152
+ const INTERNAL_HOST_SUFFIXES = [".gcp.egbe.dev", ".hz.egbe.dev"];
153
+
154
+ function isGlobalIpv4(ip) {
155
+ const octets = ip.split(".").map(Number);
156
+ if (octets.length !== 4 || octets.some((n) => !Number.isInteger(n) || n < 0 || n > 255)) {
157
+ return false;
158
+ }
159
+ const [a, b] = octets;
160
+ if (a === 0 || a === 10 || a === 127) return false;
161
+ if (a === 100 && b >= 64 && b <= 127) return false; // CGNAT 100.64/10
162
+ if (a === 169 && b === 254) return false; // link-local incl. metadata
163
+ if (a === 172 && b >= 16 && b <= 31) return false;
164
+ if (a === 192 && b === 168) return false;
165
+ if (a === 192 && b === 0) return false; // 192.0.0/24 + 192.0.2/24 doc
166
+ if (a === 198 && (b === 18 || b === 19)) return false; // benchmarking
167
+ if (a === 198 && b === 51) return false; // 198.51.100/24 doc
168
+ if (a === 203 && b === 0) return false; // 203.0.113/24 doc
169
+ if (a >= 224) return false; // multicast, reserved, broadcast
170
+ return true;
171
+ }
172
+
173
+ function isGlobalIp(ip) {
174
+ const value = String(ip || "").toLowerCase();
175
+ if (!value) return false;
176
+ if (value.includes(":")) {
177
+ const mapped = value.match(/^::ffff:(\d+\.\d+\.\d+\.\d+)$/);
178
+ if (mapped) return isGlobalIpv4(mapped[1]);
179
+ if (value === "::" || value === "::1") return false;
180
+ if (/^f[cd]/.test(value)) return false; // fc00::/7 unique-local
181
+ if (/^fe[89ab]/.test(value)) return false; // fe80::/10 link-local
182
+ if (/^ff/.test(value)) return false; // multicast
183
+ if (value.startsWith("2001:db8")) return false; // documentation
184
+ return /^[23]/.test(value); // 2000::/3 global unicast
185
+ }
186
+ return isGlobalIpv4(value);
187
+ }
188
+
189
+ /**
190
+ * Resolve a hostname and return one vetted public address, or null when the
191
+ * host is internal, unresolvable, or ANY answer is a non-public address.
192
+ */
193
+ async function resolvePublicAddress(hostname) {
194
+ const host = String(hostname || "")
195
+ .toLowerCase()
196
+ .replace(/\.$/, "");
197
+ if (!host || host === "localhost" || host.endsWith(".localhost")) return null;
198
+ if (
199
+ INTERNAL_HOST_SUFFIXES.some(
200
+ (suffix) => host === suffix.slice(1) || host.endsWith(suffix),
201
+ )
202
+ ) {
203
+ return null;
204
+ }
205
+ if (/^[\d.]+$/.test(host) || host.includes(":")) {
206
+ const literal = host.replace(/^\[|\]$/g, "");
207
+ return isGlobalIp(literal) ? literal : null;
208
+ }
209
+ let answers;
210
+ try {
211
+ answers = await dns.promises.lookup(host, { all: true, verbatim: true });
212
+ } catch {
213
+ return null;
214
+ }
215
+ if (!answers.length || answers.some((entry) => !isGlobalIp(entry.address))) {
216
+ return null;
217
+ }
218
+ return answers[0].address;
219
+ }
220
+
221
+ /**
222
+ * Plain GET with a browser-ish User-Agent. Follows up to MAX_REDIRECTS with
223
+ * every hop re-validated and pinned to a vetted public address, skips
224
+ * non-HTML responses, truncates huge pages. Resolves to the HTML string or
225
+ * null — never rejects.
226
+ */
227
+ async function fetchHtml(rawUrl, redirectsLeft = MAX_REDIRECTS, deadline = Infinity) {
228
+ if (Date.now() >= deadline) return null;
229
+ let url;
230
+ try {
231
+ url = new URL(rawUrl);
232
+ } catch {
233
+ return null;
234
+ }
235
+ if (url.protocol !== "http:" && url.protocol !== "https:") return null;
236
+ if (url.username || url.password) return null;
237
+ let dnsTimer;
238
+ const address = await Promise.race([
239
+ resolvePublicAddress(url.hostname),
240
+ new Promise((resolve) => { dnsTimer = setTimeout(() => resolve(null), Math.min(FETCH_TIMEOUT_MS, deadline - Date.now())); }),
241
+ ]);
242
+ clearTimeout(dnsTimer);
243
+ if (!address) return null;
244
+ const transport = url.protocol === "http:" ? http : https;
245
+
246
+ const outcome = await new Promise((resolve) => {
247
+ let settled = false;
248
+ let deadlineTimer;
249
+ const settle = (value) => {
250
+ if (!settled) {
251
+ settled = true;
252
+ clearTimeout(deadlineTimer);
253
+ resolve(value);
254
+ }
255
+ };
256
+ const req = transport.get(
257
+ {
258
+ host: address,
259
+ port: url.port || (url.protocol === "http:" ? 80 : 443),
260
+ path: url.pathname + url.search,
261
+ headers: {
262
+ Host: url.host,
263
+ "User-Agent": BROWSER_UA,
264
+ Accept: "text/html,application/xhtml+xml;q=0.9,*/*;q=0.5",
265
+ },
266
+ ...(url.protocol === "https:" ? { servername: url.hostname } : {}),
267
+ timeout: Math.min(FETCH_TIMEOUT_MS, Math.max(1, deadline - Date.now())),
268
+ },
269
+ (res) => {
270
+ const status = res.statusCode || 0;
271
+ const location = res.headers.location;
272
+ if (status >= 300 && status < 400 && location && redirectsLeft > 0) {
273
+ res.resume();
274
+ let next;
275
+ try {
276
+ next = new URL(location, url).toString();
277
+ } catch {
278
+ return settle({ html: null });
279
+ }
280
+ return settle({ redirect: next });
281
+ }
282
+ const contentType = String(res.headers["content-type"] || "");
283
+ if (status !== 200 || (contentType && !contentType.includes("text/html"))) {
284
+ res.resume();
285
+ return settle({ html: null });
286
+ }
287
+ let data = "";
288
+ res.setEncoding("utf8");
289
+ res.on("data", (chunk) => {
290
+ data += chunk;
291
+ if (data.length > MAX_HTML_BYTES) {
292
+ settle({ html: data });
293
+ req.destroy();
294
+ }
295
+ });
296
+ res.on("end", () => settle({ html: data }));
297
+ res.on("error", () => settle({ html: data || null }));
298
+ },
299
+ );
300
+ deadlineTimer = setTimeout(() => { settle({ html: null }); req.destroy(); }, Math.min(FETCH_TIMEOUT_MS, Math.max(1, deadline - Date.now())));
301
+ req.on("timeout", () => req.destroy());
302
+ req.on("error", () => settle({ html: null }));
303
+ });
304
+
305
+ if (outcome.redirect) {
306
+ // Recurse so the redirect target goes through the same host/DNS vetting
307
+ // and address pinning as the original URL.
308
+ return fetchHtml(outcome.redirect, redirectsLeft - 1, deadline);
309
+ }
310
+ return outcome.html;
311
+ }
312
+
313
+ /** Emails from mailto: links plus a conservative regex over the raw HTML. */
314
+ function extractEmails(html) {
315
+ const out = new Set();
316
+ const source = String(html || "");
317
+ const mailtoRe = /mailto:([^"'\s<>]+)/gi;
318
+ let m;
319
+ while ((m = mailtoRe.exec(source))) {
320
+ let candidate = m[1].split("?")[0];
321
+ try {
322
+ candidate = decodeURIComponent(candidate);
323
+ } catch {}
324
+ for (const hit of candidate.match(EMAIL_RE) || []) out.add(normalizeEmail(hit));
325
+ }
326
+ for (const hit of source.match(EMAIL_RE) || []) out.add(normalizeEmail(hit));
327
+ return [...out].filter(Boolean);
328
+ }
329
+
330
+ /** Crude but dependency-free HTML -> text for owner-name extraction. */
331
+ function htmlToText(html) {
332
+ return String(html || "")
333
+ .replace(/<script[\s\S]*?<\/script>/gi, " ")
334
+ .replace(/<style[\s\S]*?<\/style>/gi, " ")
335
+ .replace(/<[^>]+>/g, " ")
336
+ .replace(/&amp;/g, "&")
337
+ .replace(/&(?:#39|#8217|apos|rsquo);/g, "'")
338
+ .replace(/&quot;/g, '"')
339
+ .replace(/&nbsp;/g, " ")
340
+ .replace(/\s+/g, " ")
341
+ .trim();
342
+ }
343
+
344
+ function pageTitle(html) {
345
+ const m = String(html || "").match(/<title[^>]*>([\s\S]*?)<\/title>/i);
346
+ return m ? htmlToText(m[1]) : "";
347
+ }
348
+
349
+ /** Best-effort {city, state, country} from a Places formattedAddress. */
350
+ function parseAddress(formatted) {
351
+ const parts = String(formatted || "")
352
+ .split(",")
353
+ .map((s) => s.trim())
354
+ .filter(Boolean);
355
+ if (parts.length < 3) return { city: "", state: "", country: "" };
356
+ return {
357
+ city: parts[parts.length - 3],
358
+ state: parts[parts.length - 2].replace(/[\d-]+/g, "").trim(),
359
+ country: parts[parts.length - 1],
360
+ };
361
+ }
362
+
363
+ function toDomain(websiteUri) {
364
+ try {
365
+ return new URL(websiteUri).hostname.replace(/^www\./, "");
366
+ } catch {
367
+ return String(websiteUri || "");
368
+ }
369
+ }
370
+
371
+ /**
372
+ * Heuristic ranking, not evidence of ownership or suitability:
373
+ * 0. personal local-part on the site's own domain
374
+ * 1. personal-looking on a freemail provider
375
+ * 2. generic on the site's own domain (GENERIC_LOCAL_PARTS order)
376
+ * 3. generic elsewhere
377
+ * 4. personal on an unrelated non-freemail domain — usually a third party
378
+ * embedded in the page (designer credit, partner studio), last resort
379
+ */
380
+ function pickEmail(candidates, siteDomain, preference = "personal") {
381
+ const site = String(siteDomain || "").toLowerCase();
382
+ let best = null;
383
+ let bestScore = Infinity;
384
+ for (const email of candidates) {
385
+ const kind = classifyEmail(email);
386
+ if (kind === "trap") continue;
387
+ if (preference === "first") return { email, kind };
388
+ const domain = String(email).toLowerCase().split("@")[1] || "";
389
+ const onSite =
390
+ !!site && (domain === site || domain.endsWith(`.${site}`) || site.endsWith(`.${domain}`));
391
+ const genericRank = Math.max(
392
+ 0,
393
+ GENERIC_LOCAL_PARTS.indexOf(String(email).toLowerCase().split("@")[0]),
394
+ );
395
+ let score;
396
+ if (kind === "personal" && onSite) score = 0;
397
+ else if (kind === "personal" && FREEMAIL_DOMAINS.has(domain)) score = 1;
398
+ else if (kind === "generic" && onSite) score = 2 + genericRank / 100;
399
+ else if (kind === "generic") score = 3 + genericRank / 100;
400
+ else score = 4;
401
+ if (preference === "generic" && kind === "generic") score -= 3;
402
+ if (score < bestScore) {
403
+ bestScore = score;
404
+ best = { email, kind };
405
+ }
406
+ }
407
+ return best;
408
+ }
409
+
410
+ async function main() {
411
+ const args = parseArgs(process.argv);
412
+ const verbose = !!args.verbose;
413
+
414
+ const env = args["env-file"] ? readEnvFile(path.resolve(args["env-file"])) : {};
415
+ const os = getOsConfig({ ...env, ...process.env });
416
+ if (os.missing.length)
417
+ fail(`${os.missing.join(" and ")} not set. Export them or pass --env-file.`);
418
+ const cfg = { osUrl: os.osUrl, osApiKey: os.osApiKey, verbose,
419
+ deadline: Date.now() + positiveInteger(args["time-budget-ms"], 90000, "--time-budget-ms"),
420
+ connectionEnvFile: args["env-file"] ? path.resolve(args["env-file"]) : null };
421
+
422
+ const queries = parseSemicolonList(args.queries);
423
+ if (!queries.length) fail('--queries is required (semicolon-separated, e.g. "a;b")');
424
+ const excludeCategories = parseList(args["exclude-categories"]).map((t) =>
425
+ t.toLowerCase(),
426
+ );
427
+ // A local bound on work, independent of current project provider quotas.
428
+ const MAX_PLACES_CAP = 200;
429
+ const maxPlacesRaw =
430
+ args["max-places"] == null ? 60 : Number(args["max-places"]);
431
+ if (!Number.isInteger(maxPlacesRaw) || maxPlacesRaw <= 0) {
432
+ fail(
433
+ `--max-places must be a positive integer, got "${args["max-places"]}"`,
434
+ );
435
+ }
436
+ const maxPlaces = Math.min(maxPlacesRaw, MAX_PLACES_CAP);
437
+ if (maxPlaces < maxPlacesRaw) {
438
+ console.error(
439
+ `--max-places clamped from ${maxPlacesRaw} to ${MAX_PLACES_CAP} (local script cap, not a provider quota)`,
440
+ );
441
+ }
442
+ const outputPath = args.output ? path.resolve(args.output) : null;
443
+ const emailPreference = args["email-preference"] || "personal";
444
+ if (!["personal", "generic", "first"].includes(emailPreference)) fail("--email-preference must be personal, generic or first");
445
+ const drops = { details_failed: 0, scrape_failed: 0, category: 0, no_website: 0, no_email: 0, duplicate_email: 0 };
446
+ let sitesScraped = 0;
447
+ let emailsFound = 0;
448
+ const seenEmails = new Set();
449
+ const leads = [];
450
+ const pendingPlaces = new Map();
451
+ const pendingQueries = new Set(queries);
452
+ let stopReason = null;
453
+ const result = { leads, meta: {
454
+ searched_at: isoNow(), search_params: { queries, exclude_categories: excludeCategories,
455
+ max_places: maxPlaces, email_preference: emailPreference }, source: "places",
456
+ complete: false, stop_reason: "in_progress", total_found: 0, enriched: 0,
457
+ not_enriched: 0, not_enriched_people: [], sites_scraped: 0, leads_with_email: 0,
458
+ email_status_filter: ["unverified"], search_failures: 0, drops,
459
+ pending_queries: queries.slice(), not_processed_places: [],
460
+ } };
461
+ const checkpoint = () => {
462
+ Object.assign(result.meta, { total_found: places.size, sites_scraped: sitesScraped,
463
+ leads_with_email: leads.length, search_failures: searchFailures,
464
+ pending_queries: [...pendingQueries], not_processed_places: [...pendingPlaces.values()] });
465
+ if (outputPath) writeJson(outputPath, result);
466
+ };
467
+
468
+ // --- Step 1: Places search (one quota unit per query) ---
469
+ const places = new Map(); // place_id -> {place_id, name, address}
470
+ let searchSuccesses = 0;
471
+ let searchFailures = 0;
472
+ let lastSearchFailure = null;
473
+ checkpoint();
474
+ for (const query of queries) {
475
+ if (places.size >= maxPlaces) {
476
+ console.error(`Skipping "${query}": --max-places ${maxPlaces} reached`);
477
+ pendingQueries.delete(query);
478
+ continue;
479
+ }
480
+ let res;
481
+ try { res = await osRequest(cfg, "POST", "/search/places", {
482
+ query,
483
+ max_results: Math.min(SEARCH_PAGE_CAP, maxPlaces - places.size),
484
+ }); } catch { res = { status: 0, stop_reason: Date.now() >= cfg.deadline ? "time_budget" : "network_error" }; }
485
+ if (res.status !== 200) {
486
+ // Auth/quota failure hits every remaining query identically — stop
487
+ // now instead of logging N times and writing a fake-empty result.
488
+ searchFailures += 1;
489
+ stopReason = responseStopReason(res);
490
+ lastSearchFailure = `${res.status} ${JSON.stringify(res.body)}`;
491
+ console.error(`Search failed for "${query}": ${lastSearchFailure}`);
492
+ checkpoint();
493
+ if ([401, 403, 429, 0].includes(res.status)) break;
494
+ continue;
495
+ }
496
+ if (!Array.isArray(res.body?.results)) { searchFailures++; stopReason = "invalid_response"; checkpoint(); continue; }
497
+ pendingQueries.delete(query);
498
+ searchSuccesses += 1;
499
+ const results = res.body?.results || [];
500
+ let added = 0;
501
+ for (const r of results) {
502
+ const placeId = r?.metadata?.place_id;
503
+ if (!placeId || places.has(placeId)) continue;
504
+ if (places.size >= maxPlaces) break;
505
+ const place = {
506
+ place_id: placeId,
507
+ name: r.title || "",
508
+ address: r.snippet || "",
509
+ };
510
+ places.set(placeId, place);
511
+ pendingPlaces.set(placeId, place);
512
+ added += 1;
513
+ }
514
+ console.error(`Query "${query}": ${results.length} places (${added} new)`);
515
+ checkpoint();
516
+ }
517
+ console.error(`${places.size} unique places found. Fetching details...`);
518
+
519
+ // --- Steps 2-5: details -> category filter -> scrape -> classify ---
520
+ for (const place of places.values()) {
521
+ try {
522
+ const res = await osRequest(cfg, "POST", "/tools/places/details", {
523
+ place_id: place.place_id,
524
+ fields: DETAILS_FIELDS,
525
+ });
526
+ if (res.status !== 200) {
527
+ drops.details_failed += 1;
528
+ stopReason = responseStopReason(res);
529
+ if (verbose)
530
+ console.error(`Details failed for ${place.place_id}: ${res.status}`);
531
+ if ([401, 403, 429, 0].includes(res.status)) break;
532
+ continue;
533
+ }
534
+ if (!res.body || typeof res.body !== "object") { drops.details_failed++; stopReason = "invalid_response"; continue; }
535
+ const details = res.body || {};
536
+ const name = details.displayName?.text || place.name;
537
+ const types = [details.primaryType || "", ...(details.types || [])];
538
+ const categoryHaystack = [name, ...types].join(" ").toLowerCase();
539
+ if (excludeCategories.some((t) => categoryHaystack.includes(t))) {
540
+ drops.category += 1;
541
+ pendingPlaces.delete(place.place_id);
542
+ if (verbose) console.error(`Excluded by category: ${name}`);
543
+ continue;
544
+ }
545
+ const websiteUri = details.websiteUri || "";
546
+ if (!websiteUri) {
547
+ drops.no_website += 1;
548
+ pendingPlaces.delete(place.place_id);
549
+ if (verbose) console.error(`No website: ${name}`);
550
+ continue;
551
+ }
552
+
553
+ // Homepage + the two pages solo operators put their address/name on.
554
+ const pageUrls = [websiteUri];
555
+ try {
556
+ pageUrls.push(new URL("/contact", websiteUri).toString());
557
+ pageUrls.push(new URL("/about", websiteUri).toString());
558
+ } catch {}
559
+ const htmls = (await Promise.all(pageUrls.map((u) => fetchHtml(u, MAX_REDIRECTS, cfg.deadline)))).filter(
560
+ Boolean,
561
+ );
562
+ if (!htmls.length) {
563
+ drops.scrape_failed += 1;
564
+ stopReason = Date.now() >= cfg.deadline ? "time_budget" : "website_unavailable";
565
+ continue;
566
+ }
567
+ sitesScraped += 1;
568
+
569
+ const candidates = new Set();
570
+ for (const html of htmls) for (const e of extractEmails(html)) candidates.add(e);
571
+ emailsFound += candidates.size;
572
+
573
+ const picked = pickEmail([...candidates], toDomain(websiteUri), emailPreference);
574
+ pendingPlaces.delete(place.place_id);
575
+ if (!picked) {
576
+ drops.no_email += 1;
577
+ if (verbose) console.error(`No usable email: ${name} (${websiteUri})`);
578
+ continue;
579
+ }
580
+ if (seenEmails.has(picked.email)) {
581
+ drops.duplicate_email += 1;
582
+ continue;
583
+ }
584
+ seenEmails.add(picked.email);
585
+
586
+ const text = `${htmls.map(pageTitle).join(" ")} ${htmls
587
+ .map(htmlToText)
588
+ .join(" ")}`;
589
+ const { city, state, country } = parseAddress(
590
+ details.formattedAddress || place.address,
591
+ );
592
+ leads.push({
593
+ email: picked.email,
594
+ first_name: "",
595
+ last_name: "",
596
+ company_name: name,
597
+ website: toDomain(websiteUri),
598
+ title: "",
599
+ seniority: "",
600
+ linkedin_url: "",
601
+ city,
602
+ state,
603
+ country,
604
+ industry: details.primaryType || "",
605
+ company_size: null,
606
+ email_status: "unverified",
607
+ apollo_id: "",
608
+ // Extended fields (ignored by Instantly, useful for analytics)
609
+ place_id: place.place_id,
610
+ phone: details.nationalPhoneNumber || "",
611
+ email_kind: picked.kind,
612
+ email_selection: `${emailPreference}_heuristic`,
613
+ name_candidate: extractOwnerFirstName(text, name),
614
+ name_candidate_source: "page_text_english_heuristic",
615
+ website_url: websiteUri,
616
+ address_source: "formatted_address_heuristic",
617
+ });
618
+ if (verbose) console.error(`Lead: ${picked.email} (${picked.kind}) — ${name}`);
619
+ } catch (e) {
620
+ drops.details_failed += 1;
621
+ stopReason = Date.now() >= cfg.deadline ? "time_budget" : "network_error";
622
+ console.error(`Place ${place.place_id} failed: ${e.message}`);
623
+ } finally {
624
+ checkpoint();
625
+ }
626
+ }
627
+ result.meta.complete = pendingQueries.size === 0 && pendingPlaces.size === 0;
628
+ result.meta.stop_reason = result.meta.complete ? (places.size >= maxPlaces ? "max_places" : "completed") : stopReason || "incomplete";
629
+ checkpoint();
630
+
631
+ const dropSummary = Object.entries(drops)
632
+ .map(([k, v]) => `${k}=${v}`)
633
+ .join(" ");
634
+ console.error(
635
+ `Summary: ${places.size} places seen, ${sitesScraped} sites scraped, ` +
636
+ `${emailsFound} emails found, ${leads.length} leads emitted. Drops: ${dropSummary}`,
637
+ );
638
+
639
+ if (outputPath) {
640
+ writeJson(outputPath, result);
641
+ console.error(`Wrote ${leads.length} leads to ${outputPath}`);
642
+ } else {
643
+ console.log(JSON.stringify(result, null, 2));
644
+ }
645
+ process.exitCode = result.meta.complete ? 0 : 2;
646
+ }
647
+
648
+ if (require.main === module) main().catch((e) => {
649
+ console.error(e);
650
+ process.exit(1);
651
+ });
652
+
653
+ module.exports = { isGlobalIp, resolvePublicAddress, fetchHtml, extractEmails, pickEmail };
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+ SKILL_SCRIPTS="$(dirname "$(readlink -f "$0")")"
4
+ exec node "${SKILL_SCRIPTS}/places-leads.js" "$@"
@@ -0,0 +1,6 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+ require("./lib/sourcing").run("search").then((code) => { process.exitCode = code; }).catch((error) => {
4
+ console.error(`FATAL: ${error.message}`);
5
+ process.exitCode = 1;
6
+ });
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+ SKILL_SCRIPTS="$(dirname "$(readlink -f "$0")")"
4
+ exec node "${SKILL_SCRIPTS}/search.js" "$@"