@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,343 @@
1
+ const connectionHeaders = require('./connection-identity');
2
+ const https = require("https");
3
+ const http = require("http");
4
+ const { URL } = require("url");
5
+
6
+ // Apollo's search page size cap. searchAllPeople requests this many per page
7
+ // and uses it as the "full page" signal when pagination metadata is missing.
8
+ const PER_PAGE = 100;
9
+
10
+ // The gateway's per-claw daily quota answers 429 with "limit_exceeded:<resource>"
11
+ // (or "limit_not_configured:<resource>"). Unlike Apollo's own rate limit it does
12
+ // not clear in seconds, so retrying would only wait out the day.
13
+ function isDailyQuotaError(response) {
14
+ return (
15
+ response.status === 429 &&
16
+ /limit_(exceeded|not_configured):/.test(JSON.stringify(response.body ?? ""))
17
+ );
18
+ }
19
+
20
+ class ApolloClient {
21
+ constructor({
22
+ osUrl,
23
+ osApiKey,
24
+ connectionEnvFile = null,
25
+ timeoutMs = 30000,
26
+ timeBudgetMs = 90000,
27
+ maxRetries = 4,
28
+ now = Date.now,
29
+ sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
30
+ verbose = false,
31
+ }) {
32
+ if (!osUrl) throw new Error("Missing OS_URL");
33
+ if (!osApiKey) throw new Error("Missing OS_API_KEY");
34
+ this.baseUrl = `${osUrl.replace(/\/$/, "")}/outreach/apollo`;
35
+ this.osApiKey = osApiKey;
36
+ this.identityHeaders = connectionHeaders(osUrl, connectionEnvFile);
37
+ this.timeoutMs = timeoutMs;
38
+ if (!Number.isFinite(timeBudgetMs) || timeBudgetMs <= 0)
39
+ throw new Error("timeBudgetMs must be a positive number");
40
+ if (!Number.isInteger(maxRetries) || maxRetries < 0)
41
+ throw new Error("maxRetries must be a non-negative integer");
42
+ this.now = now;
43
+ this.sleep = sleep;
44
+ this.deadline = now() + timeBudgetMs;
45
+ this.maxRetries = maxRetries;
46
+ this.verbose = verbose;
47
+ }
48
+
49
+ async request(method, pathname, body = null, attempt = 0) {
50
+ const remaining = this.deadline - this.now();
51
+ if (remaining <= 0) return { status: 0, stop_reason: "time_budget", body: null };
52
+ const url = new URL(String(pathname || "").replace(/^\/+/, ""), `${this.baseUrl}/`);
53
+ const transport = url.protocol === "http:" ? http : https;
54
+ const payload = body == null ? null : JSON.stringify(body);
55
+ const options = {
56
+ method,
57
+ hostname: url.hostname,
58
+ port: url.port || (url.protocol === "http:" ? 80 : 443),
59
+ path: url.pathname + url.search,
60
+ headers: {
61
+ ...(url.origin === new URL(this.baseUrl).origin ? this.identityHeaders : {}),
62
+ Authorization: `Bearer ${this.osApiKey}`,
63
+ "Content-Type": "application/json",
64
+ "Cache-Control": "no-cache",
65
+ },
66
+ timeout: Math.min(this.timeoutMs, remaining),
67
+ };
68
+ if (payload) options.headers["Content-Length"] = Buffer.byteLength(payload);
69
+
70
+ const response = await new Promise((resolve, reject) => {
71
+ const req = transport.request(options, (res) => {
72
+ let data = "";
73
+ res.on("data", (c) => (data += c));
74
+ res.on("end", () => {
75
+ let parsed = data;
76
+ try {
77
+ parsed = data ? JSON.parse(data) : null;
78
+ } catch {}
79
+ clearTimeout(deadlineTimer);
80
+ resolve({
81
+ status: res.statusCode,
82
+ headers: res.headers,
83
+ body: parsed,
84
+ });
85
+ });
86
+ res.on("error", (error) => { clearTimeout(deadlineTimer); reject(error); });
87
+ });
88
+ // A socket timeout alone can be kept alive by a slow response stream.
89
+ const deadlineTimer = setTimeout(() => req.destroy(new Error("Request time budget exceeded")), options.timeout);
90
+ req.on("error", (error) => { clearTimeout(deadlineTimer); reject(error); });
91
+ req.on("timeout", () => req.destroy(new Error("Request timeout")));
92
+ if (payload) req.write(payload);
93
+ req.end();
94
+ });
95
+
96
+ const retryable = [408, 429, 500, 502, 503, 504].includes(response.status);
97
+ if (retryable && attempt < this.maxRetries && !isDailyQuotaError(response)) {
98
+ const retryHeader = response.headers["retry-after"];
99
+ const retryAfter = Number(retryHeader) || Math.max(0, (Date.parse(retryHeader) - this.now()) / 1000) || 0;
100
+ let delayMs;
101
+ if (retryAfter > 0) {
102
+ delayMs = retryAfter * 1000;
103
+ } else if (response.status === 429) {
104
+ // Apollo returns 429 without Retry-After in some workspaces.
105
+ // The default 0.5/1/2/4s backoff is far too short — Apollo's
106
+ // typical cooldown is 60s+, so retrying inside the cooldown
107
+ // just re-trips the limit and burns the retry budget. Floor
108
+ // at 60s for 429s; keep the doubled backoff for non-429 cases.
109
+ delayMs = Math.max(60_000, 500 * Math.pow(2, attempt));
110
+ } else {
111
+ delayMs = 500 * Math.pow(2, attempt);
112
+ }
113
+ if (this.verbose)
114
+ console.error(
115
+ `Retry ${attempt + 1} after ${delayMs}ms (status ${response.status})`,
116
+ );
117
+ if (delayMs >= this.deadline - this.now())
118
+ return { ...response, stop_reason: "time_budget" };
119
+ await this.sleep(delayMs);
120
+ return this.request(method, pathname, body, attempt + 1);
121
+ }
122
+ if (this.verbose)
123
+ console.error(`${method} ${url.pathname} -> ${response.status}`);
124
+ if (
125
+ response.status >= 200 &&
126
+ response.status < 300 &&
127
+ response.body &&
128
+ typeof response.body === "object" &&
129
+ Object.prototype.hasOwnProperty.call(response.body, "data")
130
+ ) {
131
+ response.body = response.body.data;
132
+ }
133
+ return response;
134
+ }
135
+
136
+ /**
137
+ * Search for people. Does NOT return emails — use enrich for that.
138
+ * Uses project search quota; this is not an offline dry run.
139
+ * Max 100 per page, max 500 pages.
140
+ */
141
+ searchPeople(params) {
142
+ return this.request("POST", "/people/search", params);
143
+ }
144
+
145
+ /**
146
+ * Enrich a single person to get email + phone.
147
+ * Uses project enrichment quota and may incur provider charges.
148
+ */
149
+ enrichPerson(params) {
150
+ return this.request("POST", "/people/match", params);
151
+ }
152
+
153
+ /**
154
+ * Bulk enrich up to 10 people per call.
155
+ * More efficient than single enrichment.
156
+ */
157
+ bulkEnrichPeople(details) {
158
+ return this.request("POST", "/people/bulk_match", { details });
159
+ }
160
+
161
+ /**
162
+ * Paginated search: fetches all pages up to maxPages or maxResults.
163
+ * Returns people plus completeness; onProgress can persist each page.
164
+ */
165
+ async searchAllPeople(params, { maxPages = 10, maxResults = 500, onProgress = () => {} } = {}) {
166
+ const allPeople = [];
167
+ const seenIds = new Set();
168
+ const state = { people: allPeople, complete: false, stop_reason: "in_progress", next_page: 1 };
169
+ const finish = async (complete, stopReason) => {
170
+ state.complete = complete;
171
+ state.stop_reason = stopReason;
172
+ await onProgress(state);
173
+ return state;
174
+ };
175
+ for (let page = 1; page <= maxPages; page++) {
176
+ state.next_page = page;
177
+ if (this.now() >= this.deadline) return finish(false, "time_budget");
178
+ let res;
179
+ try {
180
+ res = await this.searchPeople({ ...params, page, per_page: PER_PAGE });
181
+ } catch {
182
+ return finish(false, this.now() >= this.deadline ? "time_budget" : "network_error");
183
+ }
184
+ if (res.status !== 200) {
185
+ state.error_status = res.status;
186
+ return finish(false, responseStopReason(res));
187
+ }
188
+ if (!Array.isArray(res.body?.people)) return finish(false, "invalid_response");
189
+ const people = res.body.people;
190
+ state.next_page = page + 1;
191
+ if (!people.length) return finish(true, "search_exhausted");
192
+ // Duplicate guard: if the gateway ignores the page param it returns the
193
+ // same people for every page. Track ids across pages; a page that adds
194
+ // zero new people means we are looping, not paging — stop.
195
+ let added = 0;
196
+ for (const person of people) {
197
+ const id = person?.id;
198
+ if (id != null) {
199
+ if (seenIds.has(id)) continue;
200
+ seenIds.add(id);
201
+ }
202
+ if (allPeople.length < maxResults) allPeople.push(person);
203
+ added += 1;
204
+ }
205
+ if (!added) return finish(false, "repeated_page");
206
+ if (allPeople.length >= maxResults) return finish(true, "max_results");
207
+ // The OS gateway returns an empty pagination object, so `total_pages || 1`
208
+ // silently capped every search at page 1 even though page=2 requests
209
+ // return data. Only honor pagination when it is actually present.
210
+ const totalPages = Number(res.body?.pagination?.total_pages);
211
+ if (Number.isFinite(totalPages) && totalPages > 0 && page >= totalPages)
212
+ return finish(true, "search_exhausted");
213
+ // Full-page heuristic: without pagination metadata, a page shorter than
214
+ // PER_PAGE means we have reached the end of the results.
215
+ if (people.length < PER_PAGE) return finish(true, "search_exhausted");
216
+ await onProgress(state);
217
+ }
218
+ return finish(false, "max_pages");
219
+ }
220
+
221
+ /**
222
+ * Bulk enrich an array of people in batches of 10.
223
+ * Respects rate limit with configurable delay between batches.
224
+ * Returns matches, progress and the exact unprocessed input for recovery.
225
+ */
226
+ async bulkEnrichAll(people, { batchDelayMs = 1000, onProgress = () => {} } = {}) {
227
+ // Validate the entire input before making a potentially paid request.
228
+ const normalized = people.map(toMatchDetails);
229
+ const state = { matches: [], processed_count: 0, complete: false,
230
+ stop_reason: "in_progress", not_enriched: people.length, not_enriched_people: people.slice() };
231
+ const checkpoint = async (complete, reason) => {
232
+ state.complete = complete;
233
+ state.stop_reason = reason;
234
+ state.not_enriched_people = people.slice(state.processed_count);
235
+ state.not_enriched = state.not_enriched_people.length;
236
+ await onProgress(state);
237
+ return state;
238
+ };
239
+ for (let i = 0; i < people.length; i += 10) {
240
+ if (this.now() >= this.deadline) return checkpoint(false, "time_budget");
241
+ const details = normalized.slice(i, i + 10);
242
+ let res;
243
+ try { res = await this.bulkEnrichPeople(details); }
244
+ catch { return checkpoint(false, this.now() >= this.deadline ? "time_budget" : "network_error"); }
245
+ if (res.status !== 200) {
246
+ state.error_status = res.status;
247
+ state.error = safeEnrichmentError(res);
248
+ return checkpoint(false, responseStopReason(res));
249
+ }
250
+ if (!Array.isArray(res.body?.matches)) return checkpoint(false, "invalid_response");
251
+ state.matches.push(...res.body.matches.filter(Boolean));
252
+ state.processed_count += details.length;
253
+ await checkpoint(false, "in_progress");
254
+ if (i + 10 < people.length) {
255
+ if (batchDelayMs >= this.deadline - this.now()) return checkpoint(false, "time_budget");
256
+ await this.sleep(batchDelayMs);
257
+ }
258
+ }
259
+ return checkpoint(true, "completed");
260
+ }
261
+ }
262
+
263
+ const VALIDATION_MESSAGES = {
264
+ missing: "Field required.", value_error: "Invalid value.", string_type: "Expected text.",
265
+ bool_parsing: "Expected a boolean.", int_parsing: "Expected an integer.",
266
+ list_type: "Expected a list.", dict_type: "Expected an object.", extra_forbidden: "Unexpected field.",
267
+ };
268
+ const VALIDATION_FIELDS = new Set(["body", "query", "details", "id", "first_name", "last_name",
269
+ "organization_name", "domain", "linkedin_url", "email", "reveal_personal_emails",
270
+ "reveal_phone_number", "webhook_url"]);
271
+
272
+ function safeEnrichmentError(response) {
273
+ // Provider errors may echo contact inputs or secrets. Retain only recognized
274
+ // diagnostics, never arbitrary messages, headers, input/ctx, or raw bodies.
275
+ const messages = [], validation = [];
276
+ let visited = 0;
277
+ const inspect = (value, depth = 0) => {
278
+ if (depth > 6 || ++visited > 40) return;
279
+ if (typeof value === "string") {
280
+ if (value.length > 8192) return;
281
+ // Current OS embeds the provider response in its human-readable envelope.
282
+ // Also accept raw JSON and legacy JSON-encoded error.message wrappers.
283
+ const wire = value.match(/^outreach upstream: ([\s\S]+)\. GET \/ to see what this gateway offers and how to register\.$/);
284
+ const text = wire ? wire[1] : value;
285
+ try { inspect(JSON.parse(text), depth + 1); }
286
+ catch { messages.push(text); }
287
+ } else if (Array.isArray(value)) {
288
+ for (const item of value.slice(0, 20)) inspect(item, depth + 1);
289
+ } else if (value && typeof value === "object") {
290
+ if (validation.length < 10 && Array.isArray(value.loc) && value.loc.length <= 8 &&
291
+ typeof value.type === "string" && Object.hasOwn(VALIDATION_MESSAGES, value.type)) {
292
+ const loc = value.loc.map((part) => VALIDATION_FIELDS.has(part) ||
293
+ (Number.isInteger(part) && part >= 0 && part < 10) ? part : "[redacted]");
294
+ validation.push({ loc, type: value.type, message: VALIDATION_MESSAGES[value.type] });
295
+ }
296
+ for (const key of ["error", "message", "detail", "errors", "raw", "data"])
297
+ if (Object.hasOwn(value, key)) inspect(value[key], depth + 1);
298
+ }
299
+ };
300
+ inspect(response.body);
301
+ if (messages.some((text) => /^(?:you have insufficient|insufficient(?: lead)?) credits[!.]?(?:\s|$)/i.test(text)))
302
+ return { code: "insufficient_credits", message: "You have insufficient credits! Upgrade your plan to increase your number of lead credits." };
303
+ if (isDailyQuotaError(response))
304
+ return { code: "daily_quota", message: "Egbe Apollo quota is exhausted or not configured." };
305
+ if (response.status === 429)
306
+ return { code: "rate_limited", message: "Apollo rate limit reached." };
307
+ if ([401, 403].includes(response.status))
308
+ return { code: "authorization", message: "Apollo authorization failed." };
309
+ if (validation.length)
310
+ return { code: "validation_error", message: "Apollo rejected enrichment parameters.", validation };
311
+ return { code: "provider_error", message: "Apollo enrichment failed; unrecognized provider details omitted." };
312
+ }
313
+
314
+ function responseStopReason(response) {
315
+ if (response.stop_reason) return response.stop_reason;
316
+ if (isDailyQuotaError(response)) return "daily_quota";
317
+ if (response.status === 429) return "rate_limited";
318
+ if ([401, 403].includes(response.status)) return "authorization";
319
+ return "provider_error";
320
+ }
321
+
322
+ function toMatchDetails(person) {
323
+ if (!person || typeof person !== "object" || Array.isArray(person))
324
+ throw new Error("Each enrichment input must be a person object");
325
+ const details = {
326
+ id: person.id || person.apollo_id,
327
+ first_name: person.first_name,
328
+ last_name: person.last_name,
329
+ organization_name: person.organization?.name || person.organization_name || person.company_name || person.company,
330
+ domain: person.organization?.primary_domain || person.domain || person.company_domain || person.website,
331
+ linkedin_url: person.linkedin_url,
332
+ reveal_personal_emails: false,
333
+ };
334
+ if (details.domain) {
335
+ try { details.domain = new URL(/^https?:\/\//.test(details.domain) ? details.domain : `https://${details.domain}`).hostname; }
336
+ catch { throw new Error("Invalid enrichment domain"); }
337
+ }
338
+ if (!details.id && !details.linkedin_url && !(details.first_name && details.last_name && (details.domain || details.organization_name)))
339
+ throw new Error("Enrichment needs id/apollo_id, linkedin_url, or first_name + last_name + domain/company; display name alone is not enough");
340
+ return details;
341
+ }
342
+
343
+ module.exports = { ApolloClient, isDailyQuotaError, responseStopReason, toMatchDetails };
@@ -0,0 +1,17 @@
1
+ const fs = require('fs');
2
+ const path = require('path');
3
+ const { spawnSync } = require('child_process');
4
+
5
+ module.exports = function connectionHeaders(url, envFile = null) {
6
+ const root = path.resolve(__dirname, '../..');
7
+ const quickstart = path.basename(root).startsWith('egbe-os-') ? 'egbe-os-quickstart' : 'quickstart';
8
+ const helper = path.resolve(root, '..', quickstart, 'scripts/egbe-curl.py');
9
+ if (!fs.existsSync(helper) || (!envFile && !process.env.OS_AGENT_NAME)) return {};
10
+ const args = [helper, '--identity-headers', url];
11
+ if (envFile) args.push('--env-file', envFile);
12
+ const result = spawnSync('python3', args, {
13
+ encoding: 'utf8', maxBuffer: 65536, windowsHide: true,
14
+ });
15
+ if (result.status !== 0) return {};
16
+ try { return JSON.parse(result.stdout); } catch { return {}; }
17
+ };
@@ -0,0 +1,127 @@
1
+ const fs = require('fs');
2
+ const path = require('path');
3
+
4
+ function ensureDir(dir) {
5
+ fs.mkdirSync(dir, { recursive: true });
6
+ }
7
+
8
+ function readJson(file, fallback = null) {
9
+ if (!fs.existsSync(file)) return fallback;
10
+ return JSON.parse(fs.readFileSync(file, 'utf8'));
11
+ }
12
+
13
+ function writeJson(file, data) {
14
+ ensureDir(path.dirname(file));
15
+ const temporary = `${file}.${process.pid}.tmp`;
16
+ fs.writeFileSync(temporary, JSON.stringify(data, null, 2) + '\n');
17
+ fs.renameSync(temporary, file);
18
+ }
19
+
20
+ function parseArgs(argv) {
21
+ const out = {};
22
+ for (let i = 2; i < argv.length; i++) {
23
+ const arg = argv[i];
24
+ if (!arg.startsWith('--')) continue;
25
+ const key = arg.slice(2);
26
+ const next = argv[i + 1];
27
+ if (!next || next.startsWith('--')) {
28
+ out[key] = true;
29
+ } else {
30
+ out[key] = next;
31
+ i += 1;
32
+ }
33
+ }
34
+ return out;
35
+ }
36
+
37
+ function isoNow() {
38
+ return new Date().toISOString();
39
+ }
40
+
41
+ function normalizeEmail(email) {
42
+ return String(email || '').trim().toLowerCase();
43
+ }
44
+
45
+ /**
46
+ * Convert Apollo person + enrichment data into a lead object
47
+ * compatible with Instantly campaign launcher.
48
+ */
49
+ function toLeadRecord(person) {
50
+ if (!person) return null;
51
+ const email = normalizeEmail(person.email);
52
+ if (!email) return null;
53
+ return {
54
+ email,
55
+ first_name: person.first_name || '',
56
+ last_name: person.last_name || '',
57
+ company_name: person.organization?.name || '',
58
+ website: person.organization?.primary_domain || person.organization?.website_url || '',
59
+ // Extended fields (ignored by Instantly, useful for analytics)
60
+ title: person.title || '',
61
+ seniority: person.seniority || '',
62
+ linkedin_url: person.linkedin_url || '',
63
+ city: person.city || '',
64
+ state: person.state || '',
65
+ country: person.country || '',
66
+ industry: person.organization?.industry || '',
67
+ company_size: person.organization?.estimated_num_employees || null,
68
+ email_status: person.email_status || '',
69
+ apollo_id: person.id || '',
70
+ };
71
+ }
72
+
73
+ /**
74
+ * Parse comma- or semicolon-separated string into an array.
75
+ * Returns empty array for falsy input.
76
+ */
77
+ function parseList(value) {
78
+ if (!value) return [];
79
+ if (Array.isArray(value)) return value;
80
+ return String(value).split(/[,;]+/).map(s => s.trim()).filter(Boolean);
81
+ }
82
+
83
+ /**
84
+ * Parse semicolon-separated string into an array.
85
+ * Use for values that contain commas internally (e.g. employee ranges "11,50;51,200").
86
+ */
87
+ function parseSemicolonList(value) {
88
+ if (!value) return [];
89
+ if (Array.isArray(value)) return value;
90
+ return String(value).split(/;+/).map(s => s.trim()).filter(Boolean);
91
+ }
92
+
93
+ function readEnvFile(file) {
94
+ const env = {};
95
+ for (const line of fs.readFileSync(file, 'utf8').split(/\r?\n/)) {
96
+ if (!line || /^\s*#/.test(line)) continue;
97
+ const match = line.match(/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)\s*$/);
98
+ if (!match) continue;
99
+ let [, key, value] = match;
100
+ value = value.replace(/^['"]|['"]$/g, '');
101
+ env[key] = value;
102
+ }
103
+ return env;
104
+ }
105
+
106
+ function getOsConfig(env = process.env) {
107
+ const osUrl = String(env.OS_URL || '').trim().replace(/\/$/, '');
108
+ const osApiKey = String(env.OS_API_KEY || '').trim();
109
+ const missing = [];
110
+ if (!osUrl) missing.push('OS_URL');
111
+ if (!osApiKey) missing.push('OS_API_KEY');
112
+ return { osUrl, osApiKey, missing };
113
+ }
114
+
115
+ module.exports = {
116
+ ensureDir,
117
+ readJson,
118
+ writeJson,
119
+ parseArgs,
120
+ isoNow,
121
+ normalizeEmail,
122
+ toLeadRecord,
123
+ parseList,
124
+ parseSemicolonList,
125
+ readEnvFile,
126
+ getOsConfig,
127
+ };