@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,619 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+
4
+ /**
5
+ * replenish-leads — Check lead utilization in an Instantly campaign.
6
+ * When utilization reaches the run's explicit threshold, source new leads via
7
+ * OS Apollo, then import them into the campaign.
8
+ *
9
+ * Usage:
10
+ * node replenish-leads.js --run-dir <path> [--env-file <path>] [--force] [--verbose]
11
+ *
12
+ * Flags:
13
+ * --force Skip utilization check and replenish immediately
14
+ * --verbose Print extra debug info
15
+ */
16
+
17
+ const fs = require("fs");
18
+ const path = require("path");
19
+ const { execFileSync } = require("child_process");
20
+ const {
21
+ InstantlyClient,
22
+ contactedForUtilization,
23
+ } = require("./lib/instantly-client");
24
+ const { leadsNotInCampaign } = require("./lib/create-once");
25
+ const { replenishmentConfig, metricNumber } = require("./lib/run-config");
26
+ const { readOptOutHistory, filterConfirmedOptOuts } = require("./lib/confirmed-opt-outs");
27
+ const {
28
+ readJson,
29
+ writeJson,
30
+ parseArgs,
31
+ isoNow,
32
+ loadRunEnv,
33
+ readEnvFile,
34
+ sha256,
35
+ getOsConfig,
36
+ assertCampaignNotForeign,
37
+ normalizeEmail,
38
+ buildImportLead,
39
+ ensureDir,
40
+ findLeadNameProblems,
41
+ findLeadVariableProblems,
42
+ leadNameChecksForSteps,
43
+ } = require("./lib/helpers");
44
+ const {
45
+ initDb,
46
+ upsertRun,
47
+ upsertLead,
48
+ upsertRunLead,
49
+ insertLeadEvent,
50
+ } = require("./lib/outreach-db");
51
+
52
+ function fail(msg) {
53
+ console.error(`FATAL: ${msg}`);
54
+ process.exit(1);
55
+ }
56
+
57
+ // ---------------------------------------------------------------------------
58
+ // Lead sourcing: Apollo (primary)
59
+ // ---------------------------------------------------------------------------
60
+
61
+ async function sourceFromApollo(
62
+ envFile,
63
+ searchConfig,
64
+ batchSize,
65
+ outputPath,
66
+ verbose,
67
+ ) {
68
+ const root = path.resolve(__dirname, "..");
69
+ const apollo = path.basename(root).startsWith("egbe-os-") ? "egbe-os-apollo-lead-finder" : "apollo-lead-finder";
70
+ const apolloScript = path.resolve(root, "..", apollo, "scripts/find-leads.js");
71
+ if (!fs.existsSync(apolloScript)) throw new Error("Apollo sourcing script is unavailable");
72
+
73
+ const env = envFile && fs.existsSync(envFile) ? readEnvFile(envFile) : {};
74
+ const os = getOsConfig({ ...env, ...process.env });
75
+ if (os.missing.length) {
76
+ throw new Error(`Apollo: missing ${os.missing.join(" and ")}`);
77
+ }
78
+
79
+ // Write search config to temp file
80
+ const configPath = path.join(
81
+ path.dirname(outputPath),
82
+ ".apollo-search-config.json",
83
+ );
84
+ writeJson(configPath, { search: searchConfig });
85
+
86
+ const args = [
87
+ apolloScript,
88
+ "--config",
89
+ configPath,
90
+ "--max-results",
91
+ String(batchSize),
92
+ "--output",
93
+ outputPath,
94
+ "--time-budget-ms",
95
+ "90000",
96
+ ];
97
+ if (envFile) args.push("--env-file", envFile);
98
+ if (verbose) args.push("--verbose");
99
+
100
+ let failure = null;
101
+ try {
102
+ if (verbose)
103
+ console.error(
104
+ `Apollo: running find-leads.js with max-results=${batchSize}`,
105
+ );
106
+ execFileSync(process.execPath, args, {
107
+ stdio: ["ignore", "pipe", "pipe"],
108
+ timeout: 120_000,
109
+ env: { ...env, ...process.env },
110
+ });
111
+
112
+ } catch (err) {
113
+ failure = err;
114
+ }
115
+ // Exit 2 and a parent timeout may still leave usable, atomically checkpointed
116
+ // partial results. Do not call them an empty successful search or delete them.
117
+ const result = readJson(outputPath);
118
+ if (!Array.isArray(result?.leads) || typeof result?.meta?.complete !== "boolean"
119
+ || typeof result.meta.stop_reason !== "string")
120
+ throw new Error(`Apollo sourcing has no valid result checkpoint${failure ? `: ${failure.message}` : ""}`);
121
+ if (failure) {
122
+ result.meta = { ...result.meta, complete: false,
123
+ stop_reason: result.meta.complete ? "child_process_failed" : result.meta.stop_reason,
124
+ child_exit_code: failure.status ?? null, child_signal: failure.signal || null };
125
+ writeJson(outputPath, result);
126
+ console.error(`Apollo sourcing incomplete (${result.meta.stop_reason}); retained ${result.leads.length} leads and source checkpoint at ${outputPath}`);
127
+ }
128
+ return result;
129
+ }
130
+
131
+ function pendingApolloSource(directory) {
132
+ if (!fs.existsSync(directory)) return null;
133
+ for (const filename of fs.readdirSync(directory).filter((name) => /^leads-.*\.json$/.test(name)).sort()) {
134
+ const file = path.join(directory, filename);
135
+ const result = readJson(file);
136
+ if (!Array.isArray(result?.leads) || result?.meta?.complete !== true)
137
+ return { path: file, complete: false, stop_reason: result?.meta?.stop_reason || "checkpoint_incomplete",
138
+ retained_leads: Array.isArray(result?.leads) ? result.leads.length : null,
139
+ not_enriched: result?.meta?.not_enriched ?? null };
140
+ }
141
+ return null;
142
+ }
143
+
144
+ // ---------------------------------------------------------------------------
145
+ // Main
146
+ // ---------------------------------------------------------------------------
147
+
148
+ async function main() {
149
+ const args = parseArgs(process.argv);
150
+ const runDir = args["run-dir"] ? path.resolve(args["run-dir"]) : null;
151
+ if (!runDir) fail("Missing --run-dir");
152
+ const connectionEnvFile = loadRunEnv(runDir, args["env-file"]);
153
+
154
+ const manifest = readJson(path.join(runDir, "manifest.json"));
155
+ const spec = readJson(path.join(runDir, "run-spec.json"));
156
+ if (!spec) fail("Run spec missing");
157
+ const replenishConfig = replenishmentConfig(spec);
158
+ if (!replenishConfig) {
159
+ console.log(JSON.stringify({ skipped: true, reason: "lead_replenishment.enabled is not true" }));
160
+ return;
161
+ }
162
+ const optOutHistory = readOptOutHistory(runDir);
163
+ const ownership = readJson(
164
+ path.join(runDir, "state", "ownership.json"),
165
+ manifest?.ownership || {},
166
+ );
167
+ if (!manifest?.campaign?.id) fail("Run manifest missing campaign ID");
168
+
169
+ const os = getOsConfig();
170
+ if (os.missing.length) fail(`Missing ${os.missing.join(" and ")}`);
171
+ const client = new InstantlyClient({
172
+ connectionEnvFile,
173
+ osApiKey: os.osApiKey,
174
+ osUrl: os.osUrl,
175
+ verbose: !!args.verbose,
176
+ });
177
+
178
+ const campaignId = manifest.campaign.id;
179
+
180
+ // Verify ownership
181
+ const campaign = await client.getCampaign(campaignId);
182
+ if (!(campaign.status >= 200 && campaign.status < 300)) {
183
+ fail(
184
+ `Campaign lookup failed: ${campaign.status} ${JSON.stringify(campaign.body)}`,
185
+ );
186
+ }
187
+ assertCampaignNotForeign(campaign.body, ownership, `campaign ${campaignId}`);
188
+ const dbPath = initDb(runDir);
189
+
190
+ // --- Read replenishment config ---
191
+ const threshold = replenishConfig.utilization_threshold;
192
+ const batchSize = replenishConfig.batch_size;
193
+ const maxReplenishments = replenishConfig.max_replenishments;
194
+ const maxTotalLeads = replenishConfig.max_total_leads;
195
+ const cooldownMinutes = replenishConfig.cooldown_minutes;
196
+ const apolloSearch = replenishConfig.apollo_search || null;
197
+ const envFile = args["env-file"]
198
+ ? path.resolve(args["env-file"])
199
+ : path.join(runDir, ".env");
200
+
201
+ // --- Check replenishment history ---
202
+ const historyPath = path.join(runDir, "state", "replenishment-history.json");
203
+ const history = readJson(historyPath, []);
204
+ if (!Array.isArray(history)) fail("Replenishment history is malformed; restore it before sourcing");
205
+
206
+ if (history.length >= maxReplenishments) {
207
+ console.log(
208
+ JSON.stringify({
209
+ skipped: true,
210
+ reason: `Max replenishments reached (${maxReplenishments})`,
211
+ }),
212
+ );
213
+ return;
214
+ }
215
+
216
+ // Cooldown: don't replenish too frequently
217
+ if (history.length > 0) {
218
+ const lastReplenishment = new Date(
219
+ history[history.length - 1].completed_at || 0,
220
+ );
221
+ const elapsedMinutes = (Date.now() - lastReplenishment.getTime()) / 60_000;
222
+ if (!Number.isFinite(elapsedMinutes) || !history[history.length - 1].completed_at)
223
+ fail("Replenishment completion time is unknown; inspect history before sourcing");
224
+ if (elapsedMinutes < cooldownMinutes) {
225
+ console.log(
226
+ JSON.stringify({
227
+ skipped: true,
228
+ reason: `Cooldown: ${Math.round(cooldownMinutes - elapsedMinutes)} minutes remaining`,
229
+ }),
230
+ );
231
+ return;
232
+ }
233
+ }
234
+
235
+ // --- Check lead utilization ---
236
+ // Primary: use analytics contacted_count vs lead_stats.total
237
+ const analytics = await client.campaignAnalytics(campaignId);
238
+ const details = campaign.body || {};
239
+ const leadStats = details.lead_stats || {};
240
+ const totalLeads = metricNumber(leadStats.total);
241
+ const contactedCount =
242
+ analytics.status >= 200 && analytics.status < 300
243
+ ? metricNumber(analytics.body?.contacted_count)
244
+ : null;
245
+
246
+ // If analytics does not give us contacted_count — or lead_stats is null
247
+ // (degraded read surface, #3790) — count via the leads API before treating
248
+ // the campaign as empty. A null lead_stats used to zero the utilization
249
+ // and silently disable replenishment for the rest of the run.
250
+ let utilization = 0;
251
+ let utilizationSource = "analytics";
252
+ let effectiveTotalLeads = totalLeads;
253
+ let effectiveContacted = contactedCount;
254
+ if (totalLeads > 0 && contactedCount !== null && contactedCount <= totalLeads * 1.5) {
255
+ effectiveContacted = Math.min(totalLeads, contactedCount);
256
+ utilization = effectiveContacted / totalLeads;
257
+ } else {
258
+ const counts = await client.countLeads(campaignId);
259
+ if (counts.ok && counts.partial) {
260
+ // A partial count is a floor — using it would let the import blow past
261
+ // max_total_leads. Treat as unreadable.
262
+ utilizationSource = "unavailable";
263
+ } else if (counts.ok && metricNumber(counts.total) !== null) {
264
+ effectiveTotalLeads = Math.max(totalLeads || 0, counts.total);
265
+ effectiveContacted = contactedForUtilization(contactedCount, counts);
266
+ utilization = effectiveTotalLeads ? effectiveContacted / effectiveTotalLeads : 0;
267
+ utilizationSource = "leads-api";
268
+ } else {
269
+ utilizationSource = "unavailable";
270
+ }
271
+ }
272
+
273
+ if (args.verbose) {
274
+ console.error(
275
+ `Utilization: ${(utilization * 100).toFixed(1)}% (source: ${utilizationSource}, total: ${effectiveTotalLeads}, contacted: ${effectiveContacted})`,
276
+ );
277
+ }
278
+
279
+ if (utilizationSource === "unavailable") {
280
+ console.log(
281
+ JSON.stringify({
282
+ skipped: true,
283
+ reason:
284
+ "Lead read surfaces degraded — cannot compute utilization or enforce the total lead cap. Restore complete reads; --force cannot bypass this guard.",
285
+ }),
286
+ );
287
+ return;
288
+ }
289
+ if (effectiveContacted > 0 && !optOutHistory.runs.some((run) =>
290
+ run.run_key === manifest.run_key && run.campaign_id === campaignId))
291
+ fail("Opt-out history unavailable: provider shows prior sending but this run is absent from outreach.db; restore history before replenishing");
292
+
293
+ if (utilization < threshold && !args.force) {
294
+ console.log(
295
+ JSON.stringify({
296
+ skipped: true,
297
+ reason:
298
+ effectiveTotalLeads === 0
299
+ ? "No leads visible on any read surface — campaign may have failed import; investigate before replenishing."
300
+ : `Utilization ${(utilization * 100).toFixed(1)}% < threshold ${(threshold * 100).toFixed(0)}%`,
301
+ utilization: Math.round(utilization * 1000) / 10,
302
+ total_leads: effectiveTotalLeads,
303
+ utilization_source: utilizationSource,
304
+ }),
305
+ );
306
+ return;
307
+ }
308
+
309
+ // Max total leads guard
310
+ if (effectiveTotalLeads >= maxTotalLeads) {
311
+ console.log(
312
+ JSON.stringify({
313
+ skipped: true,
314
+ reason: `Max total leads reached (${effectiveTotalLeads} >= ${maxTotalLeads})`,
315
+ }),
316
+ );
317
+ return;
318
+ }
319
+
320
+ // --- Source new leads ---
321
+ const effectiveBatch = Math.min(
322
+ batchSize,
323
+ maxTotalLeads - effectiveTotalLeads,
324
+ );
325
+ const tempDir = path.join(runDir, "state", "replenish-temp");
326
+ ensureDir(tempDir);
327
+ const outputPath = path.join(tempDir, `leads-${Date.now()}.json`);
328
+
329
+ let newLeads = null;
330
+ let leadSource = "none";
331
+ let sourceMeta = null;
332
+ let optedOutCount = 0;
333
+
334
+ // Strategy: drain carry-over from initial-launch first, then OS Apollo.
335
+ // Carry-over comes from launch-campaign.js capping the
336
+ // initial import at batch_size — extras land in state/carry-over-leads.json
337
+ // so they're not wasted (and so we don't re-pay Apollo for the same query).
338
+ const carryOverPath = path.join(runDir, "state", "carry-over-leads.json");
339
+ let carryOverRemainder = null;
340
+ if (fs.existsSync(carryOverPath)) {
341
+ const savedCarryOver = readJson(carryOverPath, []);
342
+ if (!Array.isArray(savedCarryOver)) fail("Carry-over leads are malformed; restore before replenishing");
343
+ const filtered = filterConfirmedOptOuts(runDir, savedCarryOver);
344
+ const carryOver = filtered.leads;
345
+ optedOutCount += filtered.excluded.length;
346
+ if (Array.isArray(carryOver) && carryOver.length > 0) {
347
+ const taken = carryOver.slice(0, effectiveBatch);
348
+ const remainder = carryOver.slice(effectiveBatch);
349
+ // Keep the selected batch queued until the provider read/import and
350
+ // local hash checkpoint have succeeded. An uncertain import can then
351
+ // reconcile the same batch against the campaign on the next run.
352
+ carryOverRemainder = remainder;
353
+ newLeads = taken;
354
+ leadSource = "carry-over";
355
+ if (args.verbose) {
356
+ console.error(
357
+ `Carry-over: selected ${taken.length} leads, ${remainder.length} remaining after successful reconciliation.`,
358
+ );
359
+ }
360
+ }
361
+ }
362
+
363
+ if (!newLeads && apolloSearch) {
364
+ const unfinished = pendingApolloSource(tempDir);
365
+ if (unfinished) {
366
+ console.log(JSON.stringify({ skipped: true,
367
+ reason: "Prior Apollo source checkpoint is incomplete; review/resume it explicitly before another paid search",
368
+ source_meta: unfinished, source_file: path.relative(runDir, unfinished.path) }));
369
+ process.exitCode = 1;
370
+ return;
371
+ }
372
+ const sourced = await sourceFromApollo(
373
+ envFile,
374
+ apolloSearch,
375
+ effectiveBatch,
376
+ outputPath,
377
+ !!args.verbose,
378
+ );
379
+ newLeads = sourced.leads;
380
+ // Raw unprocessed people remain in source_file, not duplicated into every
381
+ // summary/history record. The counts and completeness stay visible here.
382
+ const { not_enriched_people, ...observation } = sourced.meta;
383
+ sourceMeta = observation;
384
+ leadSource = "apollo";
385
+ }
386
+
387
+ if (!newLeads || !newLeads.length) {
388
+ const result = {
389
+ skipped: true,
390
+ reason: sourceMeta?.complete === false ? "Apollo sourcing incomplete; checkpoint retained for review" : "No leads sourced from the configured source",
391
+ utilization: Math.round(utilization * 1000) / 10,
392
+ apollo_available: !!apolloSearch,
393
+ source_meta: sourceMeta,
394
+ source_file: sourceMeta ? path.relative(runDir, outputPath) : null,
395
+ leads_excluded_opt_out: optedOutCount,
396
+ };
397
+ console.log(JSON.stringify(result));
398
+ if (sourceMeta?.complete === false) process.exitCode = 2;
399
+ return;
400
+ }
401
+
402
+ // --- Deduplicate against already-imported leads ---
403
+ const importedLeadsPath = path.join(runDir, "state", "imported-leads.json");
404
+ const existingHashes = new Set(readJson(importedLeadsPath, []));
405
+ const sourcedCount = newLeads.length;
406
+
407
+ // Missing substitutions are hard errors. Cosmetic name heuristics stay
408
+ // warnings; do not quietly discard usable contacts for style preferences.
409
+ const eligible = filterConfirmedOptOuts(runDir, newLeads);
410
+ newLeads = eligible.leads;
411
+ optedOutCount += eligible.excluded.length;
412
+ const nameChecks = leadNameChecksForSteps(spec.sequence?.steps);
413
+ const nameProblems = new Map();
414
+ const nameWarnings = [];
415
+ if (nameChecks.checkFirstName || nameChecks.checkCompanyName) {
416
+ for (const problem of findLeadNameProblems(newLeads, nameChecks)) {
417
+ if (problem.severity !== "error") { nameWarnings.push(problem); continue; }
418
+ if (!nameProblems.has(problem.email)) nameProblems.set(problem.email, []);
419
+ nameProblems.get(problem.email).push({
420
+ field: problem.field,
421
+ value: problem.value,
422
+ problem: problem.problem,
423
+ });
424
+ }
425
+ }
426
+ for (const problem of findLeadVariableProblems(spec.sequence?.steps, newLeads)) {
427
+ if (!nameProblems.has(problem.email)) nameProblems.set(problem.email, []);
428
+ nameProblems.get(problem.email).push(problem);
429
+ }
430
+ const rejected = [];
431
+
432
+ const deduped = [];
433
+ const seenEmails = new Set();
434
+ for (const lead of newLeads) {
435
+ const email = normalizeEmail(lead.email);
436
+ if (!email || seenEmails.has(email)) continue;
437
+ seenEmails.add(email);
438
+ const leadHash = sha256(JSON.stringify({ campaignId, email }));
439
+ if (existingHashes.has(leadHash)) continue;
440
+ if (nameProblems.has(email)) {
441
+ rejected.push({
442
+ ...lead,
443
+ email,
444
+ first_name: lead.firstName || lead.first_name || "",
445
+ company_name: lead.companyName || lead.company_name || "",
446
+ problems: nameProblems.get(email),
447
+ lead_source: leadSource,
448
+ rejected_at: isoNow(),
449
+ });
450
+ continue;
451
+ }
452
+ upsertLead(dbPath, lead);
453
+ deduped.push(buildImportLead({ ...lead, email }));
454
+ if (deduped.length >= effectiveBatch) break;
455
+ }
456
+
457
+ const rejectedPath = path.join(runDir, "state", "rejected-leads.json");
458
+ const rejectedReport = {};
459
+ if (rejected.length) {
460
+ const byEmail = new Map(
461
+ readJson(rejectedPath, []).map((entry) => [entry.email, entry]),
462
+ );
463
+ for (const entry of rejected) byEmail.set(entry.email, entry);
464
+ writeJson(rejectedPath, Array.from(byEmail.values()));
465
+ const warning =
466
+ `${rejected.length} sourced lead(s) skipped for invalid or missing values used by the copy and NOT imported: ` +
467
+ rejected
468
+ .slice(0, 20)
469
+ .map((r) => `${r.email} (${r.problems.map((p) => `${p.field} ${JSON.stringify(p.value)}`).join(", ")})`)
470
+ .join("; ") +
471
+ (rejected.length > 20 ? `; … ${rejected.length - 20} more` : "") +
472
+ `. Full lead records and reasons remain in state/rejected-leads.json. Fix the referenced values or copy and add those ` +
473
+ `leads to state/carry-over-leads.json to import them on the next replenishment.`;
474
+ console.error(`WARNING: ${warning}`);
475
+ rejectedReport.leads_rejected_names = rejected.length;
476
+ rejectedReport.rejected_leads_file = "state/rejected-leads.json";
477
+ rejectedReport.warning = warning;
478
+ }
479
+
480
+ if (!deduped.length) {
481
+ if (carryOverRemainder !== null) writeJson(carryOverPath, carryOverRemainder);
482
+ console.log(
483
+ JSON.stringify({
484
+ skipped: true,
485
+ reason: rejected.length
486
+ ? "No sourced lead left to import: the rest were already imported or have invalid or missing copy substitutions"
487
+ : optedOutCount ? "No eligible sourced leads remain after confirmed opt-outs and duplicates" : "All sourced leads already imported (duplicates)",
488
+ lead_source: leadSource,
489
+ source_meta: sourceMeta,
490
+ source_file: sourceMeta ? path.relative(runDir, outputPath) : null,
491
+ lead_name_warnings: nameWarnings,
492
+ leads_excluded_opt_out: optedOutCount,
493
+ ...rejectedReport,
494
+ }),
495
+ );
496
+ return;
497
+ }
498
+
499
+ // --- Import into campaign ---
500
+ const verifyOnImport =
501
+ spec.campaign?.verify_leads_on_import ?? spec.campaign?.verify_leads ?? true;
502
+ // An earlier import answered with a 5xx may have landed: send only leads
503
+ // that are not in the campaign yet.
504
+ const freshEligible = filterConfirmedOptOuts(runDir, deduped);
505
+ optedOutCount += freshEligible.excluded.length;
506
+ const currentMembers = await client.listLeadEmails(campaignId);
507
+ const leadsToAdd = leadsNotInCampaign(freshEligible.leads, currentMembers);
508
+ const freshTotal = Math.max(effectiveTotalLeads, currentMembers.emails.size);
509
+ if (freshTotal + leadsToAdd.length > maxTotalLeads) {
510
+ console.log(JSON.stringify({ skipped: true, reason: "Fresh lead count would exceed max_total_leads; selected batch retained for reconciliation",
511
+ total_leads: freshTotal, max_total_leads: maxTotalLeads, source_meta: sourceMeta,
512
+ source_file: sourceMeta ? path.relative(runDir, outputPath) : null }));
513
+ return;
514
+ }
515
+ const importRes = leadsToAdd.length
516
+ ? await client.addLeadsToCampaign({
517
+ campaign_id: campaignId,
518
+ leads: leadsToAdd,
519
+ verify_leads_on_import: verifyOnImport,
520
+ })
521
+ : { status: 200, body: { skipped_count: freshEligible.leads.length } };
522
+
523
+ if (!(importRes.status >= 200 && importRes.status < 300)) {
524
+ fail(
525
+ `Lead import failed: ${importRes.status} ${JSON.stringify(importRes.body)}` +
526
+ (importRes.status >= 500
527
+ ? ". The batch may have landed; the next run sends only leads not yet in the campaign."
528
+ : ""),
529
+ );
530
+ }
531
+
532
+ const importBody = importRes.body || {};
533
+ const imported = Number(
534
+ importBody.leads_uploaded || importBody.created_leads?.length || 0,
535
+ );
536
+ const importSkipped =
537
+ Number(importBody.skipped_count || 0) +
538
+ Number(importBody.duplicated_leads || 0) +
539
+ Number(importBody.in_blocklist || 0) +
540
+ Number(importBody.duplicate_email_count || 0) +
541
+ (leadsToAdd.length ? freshEligible.leads.length - leadsToAdd.length : 0);
542
+
543
+ // Persist new lead hashes
544
+ for (const lead of freshEligible.leads) existingHashes.add(sha256(JSON.stringify({ campaignId, email: lead.email })));
545
+ writeJson(importedLeadsPath, Array.from(existingHashes));
546
+ if (carryOverRemainder !== null) writeJson(carryOverPath, carryOverRemainder);
547
+
548
+ const importedAt = isoNow();
549
+ for (const lead of freshEligible.leads) {
550
+ upsertRunLead(dbPath, {
551
+ run_key: manifest.run_key,
552
+ email: lead.email,
553
+ campaign_id: campaignId,
554
+ imported_at: importedAt,
555
+ verification_status: verifyOnImport ? "pending" : "skipped",
556
+ last_known_status: "imported",
557
+ ownership_tag: ownership.run_tag_label,
558
+ });
559
+ insertLeadEvent(dbPath, {
560
+ run_key: manifest.run_key,
561
+ email: lead.email,
562
+ event_type: "imported",
563
+ event_at: importedAt,
564
+ payload_json: {
565
+ source: leadSource,
566
+ replenishment: true,
567
+ campaign_id: campaignId,
568
+ },
569
+ });
570
+ }
571
+
572
+ // --- Record replenishment event ---
573
+ const event = {
574
+ replenishment_number: history.length + 1,
575
+ lead_source: leadSource,
576
+ source_meta: sourceMeta,
577
+ source_file: sourceMeta ? path.relative(runDir, outputPath) : null,
578
+ lead_name_warnings: nameWarnings,
579
+ leads_excluded_opt_out: optedOutCount,
580
+ utilization_at_trigger: Math.round(utilization * 1000) / 10,
581
+ utilization_source: utilizationSource,
582
+ leads_sourced: sourcedCount,
583
+ leads_deduped: freshEligible.leads.length,
584
+ leads_imported: imported,
585
+ leads_skipped: importSkipped,
586
+ total_leads_before: freshTotal,
587
+ total_leads_after: freshTotal + imported,
588
+ leads_rejected_names: rejected.length,
589
+ ...rejectedReport,
590
+ completed_at: isoNow(),
591
+ };
592
+ history.push(event);
593
+ writeJson(historyPath, history);
594
+
595
+ upsertRun(dbPath, {
596
+ run_key: manifest.run_key,
597
+ product_name: spec.product?.name || spec.product_name,
598
+ segment_name:
599
+ spec.segment?.name || spec.segment?.description || spec.segment,
600
+ offer_headline:
601
+ spec.offer?.headline ||
602
+ spec.offer?.name ||
603
+ spec.offer?.description ||
604
+ spec.offer,
605
+ campaign_id: campaignId,
606
+ campaign_name: manifest.campaign?.name || spec.campaign?.name,
607
+ status: "launched",
608
+ created_at: manifest.created_at || spec.created_at || importedAt,
609
+ });
610
+
611
+ // Source checkpoints include unresolved people and completeness evidence.
612
+ // Keep them for explicit recovery; a retry may incur additional provider cost.
613
+
614
+ console.log(JSON.stringify(event, null, 2));
615
+ if (sourceMeta?.complete === false) process.exitCode = 2;
616
+ }
617
+
618
+ if (require.main === module) main().catch((err) => fail(err.stack || err.message));
619
+ module.exports = { sourceFromApollo, pendingApolloSource };