@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,266 @@
1
+ // Plain-text email body -> the HTML Instantly sends. Shared by the campaign
2
+ // steps (launch-campaign.js) and the agent's replies (send-reply.js): an email
3
+ // sent as text only loses its line breaks in clients that show the HTML part.
4
+
5
+ function escapeHtml(s) {
6
+ // Escape `"` and `'` too — bodies are wrapped in `<a href="...">` and could
7
+ // otherwise be embedded in attribute context, where unescaped quotes break
8
+ // out of the attribute and form a tiny XSS vector if a lead-supplied token
9
+ // ever ends up rendered server-side. Cheap to escape, no downside.
10
+ return String(s)
11
+ .replace(/&/g, "&amp;")
12
+ .replace(/</g, "&lt;")
13
+ .replace(/>/g, "&gt;")
14
+ .replace(/"/g, "&quot;")
15
+ .replace(/'/g, "&#39;");
16
+ }
17
+
18
+ // Append UTM tracking params to a URL so traffic from cold-email lands as
19
+ // (source=instantly, medium=email, campaign=<run_key>) in product analytics.
20
+ // per-run attribution including purchase signals via Stripe metadata.
21
+ // - `utm_source=instantly` — distinguishes cold email from organic / Reddit / ads
22
+ // - `utm_medium=email` — canonical medium for outbound email
23
+ // - `utm_campaign=<run_key>` — distinguishes runs of the same product
24
+ // Existing UTM values are replaced so live URLs match the immutable binding
25
+ // persisted in manifest.json and conclusion.json.
26
+ function addUtmTags(url, runKey) {
27
+ if (!runKey || typeof url !== "string") return url;
28
+ try {
29
+ const parsed = new URL(url);
30
+ parsed.searchParams.set("utm_source", "instantly");
31
+ parsed.searchParams.set("utm_medium", "email");
32
+ parsed.searchParams.set("utm_campaign", runKey);
33
+ return parsed.toString();
34
+ } catch {
35
+ const hashIndex = url.indexOf("#");
36
+ const base = hashIndex >= 0 ? url.slice(0, hashIndex) : url;
37
+ const fragment = hashIndex >= 0 ? url.slice(hashIndex) : "";
38
+ const sep = base.includes("?") ? "&" : "?";
39
+ return `${base}${sep}utm_source=instantly&utm_medium=email&utm_campaign=${encodeURIComponent(runKey)}${fragment}`;
40
+ }
41
+ }
42
+
43
+ // A body is HTML when it has a common tag, or any tag with its closing tag
44
+ // (`<section>…</section>`). Text that only contains `<your name>` or
45
+ // `costs < a coffee` is still plain text: it gets escaped and one <div> per
46
+ // line, not sent as-is.
47
+ const HTML_TAG =
48
+ /<\/?(?:a|b|i|u|p|br|hr|div|span|font|strong|em|small|sub|sup|ul|ol|li|h[1-6]|blockquote|pre|code|table|thead|tbody|tr|td|th|img|center)\b[^<>]*>/i;
49
+ const PAIRED_TAG = /<([a-z][\w-]*)\b[^<>]*>[\s\S]*<\/\1\s*>/i;
50
+ // `[anchor](url)`; the URL may hold one level of balanced parentheses
51
+ // (`https://en.wikipedia.org/wiki/X_(Y)`).
52
+ const MARKDOWN_LINK = /\[([^\]\n]+)\]\(((?:[^()\s]|\([^()\s]*\))+)\)/g;
53
+ // Link targets that become anchors; anything else (`javascript:`, `data:`,
54
+ // a relative path) stays as text. A target without a scheme that reads as a
55
+ // domain (`rolloo.app`, `www.rolloo.app/start`) is taken as https. A file
56
+ // name (`report.pdf`, `settings.json`) is not a domain and stays text.
57
+ const LINK_SCHEME = /^(?:https?:\/\/|mailto:|tel:)/i;
58
+ const FILE_EXTENSION =
59
+ /^(?:[a-z0-9-]+\.)+(?:pdf|json|csv|txt|png|jpe?g|gif|svg|webp|zip|docx?|xlsx?|pptx?|html?|m?js|ts)(?:[/?#]|$)/i;
60
+ const BARE_DOMAIN = /^(?:[a-z0-9-]+\.)+[a-z]{2,}(?:[/?#]\S*)?$/i;
61
+
62
+ function markdownTarget(url) {
63
+ if (LINK_SCHEME.test(url)) return url;
64
+ if (BARE_DOMAIN.test(url) && !FILE_EXTENSION.test(url)) return `https://${url}`;
65
+ return null;
66
+ }
67
+ const WEB_URL = /^https?:\/\//i;
68
+ // \u0001/\u0002 delimit the markdown-link placeholders in plainToHtmlBody.
69
+ const BARE_URL = /https?:\/\/[^\s<>"\u0001\u0002]+/g;
70
+
71
+ // `see https://x.com/pricing.`, `(https://x.com/app)`, `**https://x.com**`:
72
+ // the sentence's punctuation and markdown emphasis are not part of the URL.
73
+ // `*` / `_` count as emphasis only when the same char sits right before the
74
+ // URL (`https://x.com/a_b_` keeps its `_`). A closing bracket stays when the
75
+ // URL opened one itself (`https://en.wikipedia.org/wiki/X_(Y)`).
76
+ function splitTrailingPunctuation(url, before = "") {
77
+ let end = url.length;
78
+ while (end > 0) {
79
+ const ch = url[end - 1];
80
+ const open = { ")": "(", "]": "[" }[ch];
81
+ const head = url.slice(0, end);
82
+ if (
83
+ ".,;:!?'\u2026".includes(ch) ||
84
+ ("*_".includes(ch) && ch === before) ||
85
+ (open && head.split(ch).length > head.split(open).length)
86
+ ) {
87
+ end -= 1;
88
+ } else {
89
+ break;
90
+ }
91
+ }
92
+ return [url.slice(0, end), url.slice(end)];
93
+ }
94
+
95
+ // A link left as written (another site's, `mailto:` / `tel:`, or not a
96
+ // parseable URL) may still hold `"`, `<` or `>`; percent-encode them so the href cannot break
97
+ // out of its attribute. URLs that went through `new URL()` have none.
98
+ function safeHref(url) {
99
+ return String(url).replace(/["<>]/g, (ch) => encodeURIComponent(ch));
100
+ }
101
+
102
+ const bareHost = (host) => host.toLowerCase().replace(/^www\./, "");
103
+
104
+ function hostOf(url) {
105
+ try {
106
+ return bareHost(new URL(url).hostname);
107
+ } catch {
108
+ return null;
109
+ }
110
+ }
111
+
112
+ // Only http(s) links get UTMs: `mailto:` / `tel:` stay as written.
113
+ // utmHosts (optional) limits UTMs to links on those hosts or their
114
+ // subdomains; other links are left as written, and an empty list tags none.
115
+ function utmTagger(runKey, utmHosts) {
116
+ const hosts = utmHosts?.map(bareHost);
117
+ return (url) => {
118
+ if (!WEB_URL.test(url)) return url;
119
+ if (hosts) {
120
+ const host = hostOf(url);
121
+ if (!host || !hosts.some((h) => host === h || host.endsWith(`.${h}`)))
122
+ return url;
123
+ }
124
+ return addUtmTags(url, runKey);
125
+ };
126
+ }
127
+
128
+ /**
129
+ * Auto-convert a plain-text body (with `\n\n` paragraph breaks and bare URLs)
130
+ * into HTML so Instantly delivers consistent rendering across email clients.
131
+ *
132
+ * Rules (Instantly editor-native markup — the CREATE endpoint rewrites
133
+ * `<p>` blocks into margin-less `<div>`s, collapsing paragraph spacing in
134
+ * the delivered mail, while PATCH keeps `<p>` verbatim; emitting the editor's
135
+ * own format renders identically on both API paths):
136
+ * - every line → its own `<div>...</div>`
137
+ * - `\n\n` (blank line) → explicit `<div><br /></div>` separator
138
+ * - markdown links `[anchor](url)` → `<a href="url+UTMs">anchor</a>` so
139
+ * marketologist controls the visible CTA wording per product
140
+ * (e.g. `[try Rolloo free](https://rolloo.app/)`); only http(s),
141
+ * `mailto:` and `tel:` targets become links (`rolloo.app` without a
142
+ * scheme counts as https), and only http(s) get UTMs
143
+ * - bare http(s):// URLs → `<a href="url+UTMs">url</a>` (display = clean URL,
144
+ * UTMs hidden in href so the email body stays human-looking); trailing
145
+ * punctuation stays outside the link
146
+ * - merge tokens like `{{firstName}}` are preserved intact (HTML-safe by
147
+ * virtue of escaping happening before token substitution on Instantly's
148
+ * side; we never escape the braces themselves).
149
+ *
150
+ * Idempotent: if the body already contains HTML, preserve its markup while
151
+ * reconciling HTTP(S) anchor hrefs to the canonical UTM tuple.
152
+ *
153
+ * `utmHosts` (optional): tag only links to these hosts, as for a reply that
154
+ * may link to someone else's site; `[]` tags no link.
155
+ * `plain`: the body is plain text even if it contains a tag (an agent's
156
+ * reply), so it is always escaped and split into lines.
157
+ */
158
+ function plainToHtmlBody(
159
+ body,
160
+ runKey,
161
+ { utmHosts, plain } = {},
162
+ ) {
163
+ if (typeof body !== "string" || !body.trim()) return body;
164
+ const tag = utmTagger(runKey, utmHosts);
165
+ if (!plain && (HTML_TAG.test(body) || PAIRED_TAG.test(body))) {
166
+ return body.replace(
167
+ /(<a\b[^>]*\bhref\s*=\s*)(["'])(https?:\/\/[^"']+)\2/gi,
168
+ (_, prefix, quote, url) => `${prefix}${quote}${tag(url)}${quote}`,
169
+ );
170
+ }
171
+
172
+ // Two-pass extraction so escapeHtml doesn't corrupt the link markup.
173
+ // Pass 1: pull markdown links out of body, replace with sentinels we can
174
+ // reinsert AFTER escapeHtml runs (so the anchor + href bypass
175
+ // escaping). The sentinels are wrapped in the control chars
176
+ // \u0001/\u0002, which email text does not contain; BARE_URL
177
+ // stops at them, so a URL right before a markdown link ends there.
178
+ // CRLF / CR line ends count as \n: blank lines collapse the same way and
179
+ // no stray \r ends up inside a <div>.
180
+ body = body.replace(/\r\n?/g, "\n");
181
+ const linkRegistry = [];
182
+ const SENTINEL_OPEN = "\u0001OCLINK\u0001";
183
+ const SENTINEL_CLOSE = "\u0002OCLINK\u0002";
184
+ const withSentinels = body.replace(MARKDOWN_LINK, (match, anchor, target) => {
185
+ const url = markdownTarget(target);
186
+ if (!url) return match;
187
+ const idx = linkRegistry.length;
188
+ linkRegistry.push({ url: tag(url), anchor });
189
+ return `${SENTINEL_OPEN}${idx}${SENTINEL_CLOSE}`;
190
+ });
191
+
192
+ // Pass 2: paragraphs + escapeHtml + raw-URL linkify (bare URLs stay
193
+ // displayed as the clean original URL but href carries UTMs). URLs are
194
+ // cut out of the raw line before escaping: escaped first, `?a=1&b=2`
195
+ // reaches addUtmTags as `&amp;b=2` and the product loses the parameter.
196
+ const linkifyBare = (line) => {
197
+ let out = "";
198
+ let last = 0;
199
+ for (const m of line.matchAll(BARE_URL)) {
200
+ const [url, trailing] = splitTrailingPunctuation(
201
+ m[0],
202
+ line[m.index - 1],
203
+ );
204
+ out +=
205
+ escapeHtml(line.slice(last, m.index)) +
206
+ `<a href="${safeHref(tag(url))}">${escapeHtml(url)}</a>` +
207
+ escapeHtml(trailing);
208
+ last = m.index + m[0].length;
209
+ }
210
+ return out + escapeHtml(line.slice(last));
211
+ };
212
+
213
+ const lines = withSentinels
214
+ .replace(/^\n+/, "")
215
+ .replace(/\n+$/, "")
216
+ .replace(/\n{2,}/g, "\n\n")
217
+ .split("\n");
218
+ const rendered = lines
219
+ .map((line) => {
220
+ if (line.trim() === "") return "<div><br /></div>";
221
+ return `<div>${linkifyBare(line)}</div>`;
222
+ })
223
+ .join("");
224
+
225
+ // Pass 3: substitute markdown-link sentinels back in. escapeHtml leaves
226
+ // SENTINEL_OPEN/CLOSE as they are (control chars pass through), so the
227
+ // regex still matches.
228
+ return rendered.replace(
229
+ new RegExp(`${SENTINEL_OPEN}(\\d+)${SENTINEL_CLOSE}`, "g"),
230
+ (_, idx) => {
231
+ const entry = linkRegistry[Number(idx)];
232
+ if (!entry) return "";
233
+ return `<a href="${safeHref(entry.url)}">${escapeHtml(entry.anchor)}</a>`;
234
+ },
235
+ );
236
+ }
237
+
238
+ // The text part of the same email: `[anchor](url)` reads as `anchor (url)`
239
+ // in clients that show only text. Same targets as the html part; other
240
+ // markdown stays as written there too.
241
+ function markdownLinksToText(body) {
242
+ if (typeof body !== "string") return body;
243
+ return body.replace(MARKDOWN_LINK, (match, anchor, target) => {
244
+ const url = markdownTarget(target);
245
+ if (!url) return match;
246
+ return anchor === target || anchor === url ? url : `${anchor} (${url})`;
247
+ });
248
+ }
249
+
250
+ // Hosts (without `www.`) of every link in a plain-text body.
251
+ function linkHosts(body) {
252
+ const urls = [];
253
+ for (const m of String(body || "").matchAll(MARKDOWN_LINK))
254
+ urls.push(markdownTarget(m[2]));
255
+ for (const m of String(body || "").matchAll(BARE_URL))
256
+ urls.push(splitTrailingPunctuation(m[0], m.input[m.index - 1])[0]);
257
+ return [...new Set(urls.filter(Boolean).map(hostOf).filter(Boolean))];
258
+ }
259
+
260
+ module.exports = {
261
+ escapeHtml,
262
+ addUtmTags,
263
+ plainToHtmlBody,
264
+ markdownLinksToText,
265
+ linkHosts,
266
+ };
@@ -0,0 +1,328 @@
1
+ const { listLeadRows } = require('./recipient-exclusion');
2
+ const connectionHeaders = require('./connection-identity');
3
+ const http = require('http');
4
+ const https = require('https');
5
+ const { URL } = require('url');
6
+
7
+ const RETRY_DEFAULT = [408, 425, 429, 500, 502, 503, 504];
8
+ // Rate limited: the request was refused before any work was done.
9
+ const RETRY_NOT_PROCESSED = [429];
10
+ // 1,000 pages of 100 leads; far above any campaign this skill runs.
11
+ const MAX_LEAD_PAGES = 1000;
12
+
13
+ class InstantlyClient {
14
+ constructor({ osApiKey, osUrl, connectionEnvFile = null, timeoutMs = 30000, verbose = false }) {
15
+ if (!osApiKey) throw new Error('Missing OS_API_KEY');
16
+ if (!osUrl) throw new Error('Missing OS_URL');
17
+ this.osApiKey = osApiKey;
18
+ this.baseUrl = `${osUrl.replace(/\/$/, '')}/outreach/instantly`;
19
+ this.identityHeaders = connectionHeaders(osUrl, connectionEnvFile);
20
+ this.timeoutMs = timeoutMs;
21
+ this.verbose = verbose;
22
+ }
23
+
24
+ // retryOn: statuses worth repeating. The default is for reads and writes
25
+ // that end in the same state when repeated; calls that create something
26
+ // (campaign, leads, tag, reply) pass only statuses that prove nothing was
27
+ // processed.
28
+ async request(method, pathname, body = null, query = null, attempt = 0, { retryOn = RETRY_DEFAULT } = {}) {
29
+ const url = new URL(String(pathname || '').replace(/^\/+/, ''), `${this.baseUrl}/`);
30
+ if (query) {
31
+ for (const [key, value] of Object.entries(query)) {
32
+ if (Array.isArray(value)) value.forEach(v => v != null && url.searchParams.append(key, String(v)));
33
+ else if (value != null) url.searchParams.set(key, String(value));
34
+ }
35
+ }
36
+
37
+ const payload = body == null ? null : JSON.stringify(body);
38
+ const transport = url.protocol === 'https:' ? https : (url.protocol === 'http:' ? http : null);
39
+ if (!transport) throw new Error(`Unsupported protocol for OS_URL: ${url.protocol}`);
40
+ const options = {
41
+ method,
42
+ hostname: url.hostname,
43
+ port: url.port || undefined,
44
+ path: url.pathname + url.search,
45
+ headers: {
46
+ ...(url.origin === new URL(this.baseUrl).origin ? this.identityHeaders : {}),
47
+ Authorization: `Bearer ${this.osApiKey}`,
48
+ Accept: 'application/json',
49
+ },
50
+ timeout: this.timeoutMs,
51
+ };
52
+ if (payload) {
53
+ options.headers['Content-Type'] = 'application/json';
54
+ options.headers['Content-Length'] = Buffer.byteLength(payload);
55
+ }
56
+
57
+ const response = await new Promise((resolve, reject) => {
58
+ const req = transport.request(options, (res) => {
59
+ let data = '';
60
+ res.on('data', c => data += c);
61
+ res.on('end', () => {
62
+ let parsed = data;
63
+ try { parsed = data ? JSON.parse(data) : null; } catch {}
64
+ resolve({ status: res.statusCode, headers: res.headers, body: parsed });
65
+ });
66
+ });
67
+ req.on('error', reject);
68
+ req.on('timeout', () => req.destroy(new Error('Request timeout')));
69
+ if (payload) req.write(payload);
70
+ req.end();
71
+ });
72
+
73
+ if (retryOn.includes(response.status) && attempt < 4) {
74
+ const retryAfter = Number(response.headers['retry-after'] || 0);
75
+ const delayMs = retryAfter > 0 ? retryAfter * 1000 : (500 * Math.pow(2, attempt));
76
+ await new Promise(r => setTimeout(r, delayMs));
77
+ return this.request(method, pathname, body, query, attempt + 1, { retryOn });
78
+ }
79
+ if (this.verbose) console.log(`${method} ${url.pathname}${url.search} -> ${response.status}`);
80
+ if (
81
+ response.status >= 200 &&
82
+ response.status < 300 &&
83
+ response.body &&
84
+ typeof response.body === 'object' &&
85
+ Object.prototype.hasOwnProperty.call(response.body, 'data')
86
+ ) {
87
+ response.body = response.body.data;
88
+ }
89
+ return response;
90
+ }
91
+
92
+ listCampaigns(limit = 100, startingAfter) {
93
+ const query = { limit };
94
+ if (startingAfter) query.starting_after = startingAfter;
95
+ return this.request('GET', '/campaigns', null, query);
96
+ }
97
+
98
+ getCampaign(id) {
99
+ return this.request('GET', `/campaigns/${id}`);
100
+ }
101
+
102
+ // Every write through the OS outreach gateway must wrap its Instantly body
103
+ // as {"payload": {...}} — the gateway's request model requires the field
104
+ // and answers a raw Instantly body with a FastAPI 422. Centralized here so
105
+ // no new write method can forget the wrapper. Bodyless POSTs
106
+ // (activate/pause) send no body at all.
107
+ writeRequest(method, pathname, payload, options) {
108
+ return this.request(method, pathname, { payload }, null, 0, options);
109
+ }
110
+
111
+ createCampaign(payload) {
112
+ return this.writeRequest('POST', '/campaigns', payload, { retryOn: RETRY_NOT_PROCESSED });
113
+ }
114
+
115
+ patchCampaign(id, payload) {
116
+ return this.writeRequest('PATCH', `/campaigns/${id}`, payload);
117
+ }
118
+
119
+ activateCampaign(id) {
120
+ return this.request('POST', `/campaigns/${id}/activate`);
121
+ }
122
+
123
+ pauseCampaign(id) {
124
+ return this.request('POST', `/campaigns/${id}/pause`);
125
+ }
126
+
127
+ // Deletes only a draft that never sent (the gateway answers 409 otherwise).
128
+ // A 5xx may come after the delete happened, so only "rate limited" is
129
+ // retried; the caller reads the campaign back before trying again.
130
+ deleteCampaign(id) {
131
+ return this.request('DELETE', `/campaigns/${id}`, null, null, 0, { retryOn: RETRY_NOT_PROCESSED });
132
+ }
133
+
134
+ addLeadsToCampaign(payload) {
135
+ return this.writeRequest('POST', '/leads/add', payload, { retryOn: RETRY_NOT_PROCESSED });
136
+ }
137
+
138
+ deleteLead(id) {
139
+ return this.request('DELETE', `/leads/${id}`, null, null, 0, { retryOn: RETRY_NOT_PROCESSED });
140
+ }
141
+
142
+ // fields: first_name, last_name, company_name, website, personalization,
143
+ // custom_variables. The gateway rejects any other key.
144
+ updateLead(id, fields) {
145
+ return this.writeRequest('PATCH', `/leads/${id}`, fields);
146
+ }
147
+
148
+ listEmails(query) {
149
+ return this.request('GET', '/emails', null, query);
150
+ }
151
+
152
+ // Sends an email. A 5xx or timeout may come after Instantly already sent it,
153
+ // so only "rate limited" (not processed) is retried; anything else goes back
154
+ // to the caller, which treats a 5xx as an unknown outcome.
155
+ replyToEmail(payload) {
156
+ return this.writeRequest('POST', '/emails/reply', payload, { retryOn: RETRY_NOT_PROCESSED });
157
+ }
158
+
159
+ analyticsOverview(ids, extra = {}) {
160
+ const campaignId = Array.isArray(ids) ? ids.find(Boolean) : ids;
161
+ return this.request('GET', `/campaigns/${campaignId}/analytics/overview`, null, extra);
162
+ }
163
+
164
+ campaignAnalytics(id, extra = {}) {
165
+ return this.request('GET', `/campaigns/${id}/analytics`, null, extra);
166
+ }
167
+
168
+ sendingStatus(id) {
169
+ return this.request('GET', `/campaigns/${id}/sending-status`);
170
+ }
171
+
172
+ campaignSenders(id) {
173
+ return this.request('GET', `/campaigns/${encodeURIComponent(id)}/senders`);
174
+ }
175
+
176
+ listAccounts(limit = 100, query = {}) {
177
+ const params = { limit, ...query };
178
+ if (params.status != null && params.status_filter == null) {
179
+ params.status_filter = params.status;
180
+ }
181
+ delete params.status;
182
+ return this.request('GET', '/accounts', null, params);
183
+ }
184
+
185
+ createCustomTag(payload) {
186
+ return this.writeRequest('POST', '/custom-tags', payload, { retryOn: RETRY_NOT_PROCESSED });
187
+ }
188
+
189
+ listCustomTags(limit = 100, startingAfter) {
190
+ const query = { limit };
191
+ if (startingAfter) query.starting_after = startingAfter;
192
+ return this.request('GET', '/custom-tags', null, query);
193
+ }
194
+
195
+ toggleTagResource(payload) {
196
+ return this.writeRequest('POST', '/custom-tags/toggle-resource', payload);
197
+ }
198
+
199
+ listLeads(campaignId, { limit = 100, starting_after } = {}) {
200
+ const query = { campaign_id: campaignId, limit };
201
+ if (starting_after) query.starting_after = starting_after;
202
+ return this.request('GET', '/leads', null, query);
203
+ }
204
+
205
+ /**
206
+ * Lowercased emails of the leads already in a campaign. ok=false means the
207
+ * complete list could not be read (#3790), so the caller cannot tell "empty"
208
+ * from "unknown" and must not treat the set as complete.
209
+ */
210
+ listLeadRows(campaignId) {
211
+ return listLeadRows(this, campaignId);
212
+ }
213
+
214
+ async listLeadEmails(campaignId) {
215
+ const result = await this.listLeadRows(campaignId);
216
+ return { ok: result.ok, emails: new Set(result.rows.map(row => row.email.trim().toLowerCase())) };
217
+ }
218
+
219
+ getRecipientExclusion(campaignId, leadId) {
220
+ return this.request('GET', `/campaigns/${campaignId}/leads/${leadId}/exclusion`, null, null, 0, { retryOn: [] });
221
+ }
222
+
223
+ excludeRecipient(campaignId, leadId) {
224
+ // Semantic OS contract, not the generic provider payload wrapper. Never
225
+ // automatically replay a write with an uncertain outcome.
226
+ return this.request('POST', `/campaigns/${campaignId}/leads/${leadId}/exclusion`,
227
+ { intent: 'confirmed_opt_out' }, null, 0, { retryOn: [] });
228
+ }
229
+
230
+ /**
231
+ * Count leads in a campaign by paginating through all results.
232
+ * Returns { ok, status, total, contacted, not_contacted } where
233
+ * "contacted" means the lead has been reached by the sending sequence.
234
+ * ok=false means the FIRST page could not be read — callers must be able
235
+ * to tell "leads read surface down" (issue #3790: GET /leads can 404 at
236
+ * the gateway) apart from "campaign genuinely has zero leads"; treating a
237
+ * read outage as zero once turned into a false import-failure diagnosis.
238
+ */
239
+ async countLeads(campaignId) {
240
+ let total = 0;
241
+ let contacted = 0;
242
+ let contact_activity_unknown = 0;
243
+ let cursor = undefined;
244
+ let pages = 0;
245
+ let status = null;
246
+ const cursors = new Set();
247
+ const identities = new Set();
248
+ const emails = new Set();
249
+ while (true) {
250
+ const res = await this.listLeads(campaignId, { limit: 100, starting_after: cursor });
251
+ status = res.status;
252
+ if (!(res.status >= 200 && res.status < 300)) break;
253
+ const items = Array.isArray(res.body) ? res.body : res.body?.items;
254
+ if (!Array.isArray(items)) { status = null; break; }
255
+ pages += 1;
256
+ if (!items.length) break;
257
+ const lastId = items[items.length - 1]?.id;
258
+ if (lastId && cursors.has(lastId)) {
259
+ status = null;
260
+ break;
261
+ }
262
+ if (lastId) cursors.add(lastId);
263
+ let invalid = false;
264
+ for (const lead of items) {
265
+ const email = typeof lead?.email === 'string' ? lead.email.trim().toLowerCase() : null;
266
+ const id = typeof lead?.id === 'string' && lead.id ? lead.id : email;
267
+ if (!id || identities.has(id) || (email && emails.has(email))
268
+ || ['campaign', 'campaign_id'].some(key => lead[key] != null && lead[key] !== campaignId)) {
269
+ invalid = true; break;
270
+ }
271
+ identities.add(id);
272
+ if (email) emails.add(email);
273
+ total++;
274
+ if (isContactedLead(lead)) contacted++;
275
+ else if (!(Object.hasOwn(lead, 'timestamp_last_contact') && lead.timestamp_last_contact == null)
276
+ && !(Object.hasOwn(lead.status_summary || {}, 'lastStep') && lead.status_summary.lastStep == null)
277
+ && lead.lead_status !== 'Not Contacted' && lead.status !== 'not_contacted') contact_activity_unknown++;
278
+ }
279
+ if (invalid || (!lastId && items.length >= 100)) { status = null; break; }
280
+ if (items.length < 100) break;
281
+ if (pages >= MAX_LEAD_PAGES) {
282
+ status = null; // cursor ignored or no end in sight: the count is a floor
283
+ break;
284
+ }
285
+ cursor = lastId;
286
+ }
287
+ const ok = pages > 0;
288
+ // An interrupted or invalid population is a floor, not an exact count.
289
+ // Activity can separately be unknown even with complete identity pages.
290
+ const partial = ok && !(status >= 200 && status < 300);
291
+ return { ok, partial, status, total, contacted, contact_activity_unknown, not_contacted: total - contacted };
292
+ }
293
+ }
294
+
295
+ // Instantly API v2 leads carry no "Contacted" status: `status` stays 1
296
+ // (active) after the first send. A lead has been reached once it shows send
297
+ // or reply activity: the same marks and counters the tools gateway checks
298
+ // before a lead delete (_instantly_lead_contacted), plus the step recorded in
299
+ // status_summary. The older fields are kept for other payload shapes.
300
+ const LEAD_ACTIVITY_MARKS = [
301
+ 'timestamp_last_contact', 'timestamp_last_reply', 'timestamp_last_open',
302
+ 'timestamp_last_click', 'last_step_id', 'last_step_from', 'last_step_timestamp_executed',
303
+ ];
304
+ const LEAD_ACTIVITY_COUNTS = ['email_reply_count', 'email_open_count', 'email_click_count'];
305
+
306
+ function isContactedLead(lead) {
307
+ return Boolean(
308
+ LEAD_ACTIVITY_MARKS.some((k) => lead[k])
309
+ || LEAD_ACTIVITY_COUNTS.some((k) => typeof lead[k] === 'number' && lead[k] > 0)
310
+ || lead.status_summary?.lastStep?.stepID
311
+ || lead.lead_status === 'Contacted' || lead.status === 'contacted'
312
+ || (lead.subsequence_status && lead.subsequence_status !== '0'),
313
+ );
314
+ }
315
+
316
+ // Contacted count for a utilization ratio when the leads API supplies the
317
+ // total (lead_stats null, #3790). Takes the larger of analytics
318
+ // contacted_count and the per-lead count. Analytics more than 50% above the
319
+ // campaign's leads is likely workspace-level (see monitor-campaign) and is
320
+ // ignored; within that margin it is capped so utilization stays <= 100%.
321
+ function contactedForUtilization(analyticsContacted, counts) {
322
+ const analytics = analyticsContacted > counts.total * 1.5
323
+ ? 0
324
+ : Math.min(analyticsContacted || 0, counts.total);
325
+ return Math.max(analytics, counts.contacted);
326
+ }
327
+
328
+ module.exports = { InstantlyClient, isContactedLead, contactedForUtilization };