@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,545 @@
1
+ const fs = require("fs");
2
+ const path = require("path");
3
+ const crypto = require("crypto");
4
+
5
+ function ensureDir(dir) {
6
+ fs.mkdirSync(dir, { recursive: true });
7
+ }
8
+
9
+ function readJson(file, fallback = null) {
10
+ if (!fs.existsSync(file)) return fallback;
11
+ return JSON.parse(fs.readFileSync(file, "utf8"));
12
+ }
13
+
14
+ function writeJson(file, data) {
15
+ ensureDir(path.dirname(file));
16
+ fs.writeFileSync(file, JSON.stringify(data, null, 2) + "\n");
17
+ }
18
+
19
+ function sha256(value) {
20
+ return crypto.createHash("sha256").update(value).digest("hex");
21
+ }
22
+
23
+ function stableStringify(value) {
24
+ if (Array.isArray(value)) return `[${value.map(stableStringify).join(",")}]`;
25
+ if (value && typeof value === "object") {
26
+ return `{${Object.keys(value)
27
+ .sort()
28
+ .map((k) => JSON.stringify(k) + ":" + stableStringify(value[k]))
29
+ .join(",")}}`;
30
+ }
31
+ return JSON.stringify(value);
32
+ }
33
+
34
+ function normalizeEmail(email) {
35
+ return String(email || "")
36
+ .trim()
37
+ .toLowerCase();
38
+ }
39
+
40
+ function parseArgs(argv) {
41
+ const out = {};
42
+ for (let i = 2; i < argv.length; i++) {
43
+ const arg = argv[i];
44
+ if (!arg.startsWith("--")) continue;
45
+ const key = arg.slice(2);
46
+ const next = argv[i + 1];
47
+ if (!next || next.startsWith("--")) {
48
+ out[key] = true;
49
+ } else {
50
+ out[key] = next;
51
+ i += 1;
52
+ }
53
+ }
54
+ return out;
55
+ }
56
+
57
+ function isoNow() {
58
+ return new Date().toISOString();
59
+ }
60
+
61
+ function ymd(date = new Date()) {
62
+ return date.toISOString().slice(0, 10);
63
+ }
64
+
65
+ function slugify(value, max = 48) {
66
+ return (
67
+ String(value || "")
68
+ .toLowerCase()
69
+ .replace(/[^a-z0-9]+/g, "-")
70
+ .replace(/^-+|-+$/g, "")
71
+ .slice(0, max) || "na"
72
+ );
73
+ }
74
+
75
+ function titleCase(value) {
76
+ return String(value || "")
77
+ .split(/[-_\s]+/)
78
+ .filter(Boolean)
79
+ .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
80
+ .join(" ");
81
+ }
82
+
83
+ function isGenericMailbox(email) {
84
+ const local = normalizeEmail(email).split("@")[0] || "";
85
+ return [
86
+ "team",
87
+ "hello",
88
+ "info",
89
+ "contact",
90
+ "support",
91
+ "sales",
92
+ "admin",
93
+ "ops",
94
+ "office",
95
+ "growth",
96
+ "founders",
97
+ "mail",
98
+ "hi",
99
+ ].includes(local);
100
+ }
101
+
102
+ function deriveSenderName({ firstName, lastName }) {
103
+ const explicit = [firstName, lastName].filter(Boolean).join(" ").trim();
104
+ // A mailbox local part is not evidence of a person's identity.
105
+ return explicit || null;
106
+ }
107
+
108
+ function replaceSenderNameToken(text, senderName) {
109
+ return String(text || "").replace(/{{\s*senderName\s*}}/g, senderName || "");
110
+ }
111
+
112
+ // Fields the Instantly /leads/add payload consumes directly. Anything else a
113
+ // sourcing script writes into a lead object is forwarded as a custom variable
114
+ // so copy tokens like {{personalization}} actually resolve — the import used
115
+ // to drop every non-standard field silently.
116
+ // Native Instantly lead fields the /leads/add payload accepts beyond the
117
+ // five always-sent ones — pass them through as-is instead of demoting them
118
+ // into custom_variables.
119
+ const NATIVE_OPTIONAL_LEAD_FIELDS = [
120
+ "phone",
121
+ "job_title",
122
+ "lt_interest_status",
123
+ "pl_value_lead",
124
+ "assigned_to",
125
+ ];
126
+
127
+ const RESERVED_LEAD_FIELDS = new Set([
128
+ "email",
129
+ "firstName",
130
+ "first_name",
131
+ "lastName",
132
+ "last_name",
133
+ "companyName",
134
+ "company_name",
135
+ "website",
136
+ "personalization",
137
+ "custom_variables",
138
+ // Launcher-only overrides for the lead-name preflight; never sent to Instantly.
139
+ "first_name_confirmed",
140
+ "company_name_confirmed",
141
+ ...NATIVE_OPTIONAL_LEAD_FIELDS,
142
+ ]);
143
+ const MAX_CUSTOM_VARIABLE_LENGTH = 1000;
144
+
145
+ function buildImportLead(lead) {
146
+ const importLead = {
147
+ email: lead.email,
148
+ first_name: lead.firstName || lead.first_name || "",
149
+ last_name: lead.lastName || lead.last_name || "",
150
+ company_name: lead.companyName || lead.company_name || "",
151
+ website: lead.website || "",
152
+ };
153
+ if (lead.personalization != null && String(lead.personalization).trim()) {
154
+ importLead.personalization = String(lead.personalization);
155
+ }
156
+ for (const key of NATIVE_OPTIONAL_LEAD_FIELDS) {
157
+ if (lead[key] != null && lead[key] !== "") importLead[key] = lead[key];
158
+ }
159
+ // Idempotent: carry-over leads round-trip through this function (launch
160
+ // stores its output, replenish re-applies it), so an already-built
161
+ // custom_variables object must survive a second pass. Booleans are valid
162
+ // Instantly custom values; the length cap only guards string blobs.
163
+ const isImportableScalar = (value) =>
164
+ typeof value === "string"
165
+ ? value.length <= MAX_CUSTOM_VARIABLE_LENGTH
166
+ : typeof value === "number" || typeof value === "boolean";
167
+ const inherited =
168
+ lead.custom_variables && typeof lead.custom_variables === "object"
169
+ ? Object.entries(lead.custom_variables)
170
+ : [];
171
+ const customEntries = [...inherited, ...Object.entries(lead)].filter(
172
+ ([key, value]) => !RESERVED_LEAD_FIELDS.has(key) && isImportableScalar(value),
173
+ );
174
+ if (customEntries.length) {
175
+ importLead.custom_variables = Object.fromEntries(customEntries);
176
+ }
177
+ return importLead;
178
+ }
179
+
180
+ // Lead-name preflight. Lead sources (Apollo) sometimes put a title or
181
+ // credential in first_name ("CA" for Chartered Accountant) or return company
182
+ // names in ALL CAPS; templated into {{firstName}} / {{companyName}} that ships
183
+ // "Dear CA," to a real prospect. Exact, case-insensitive matches only (a
184
+ // trailing "." is ignored) — "Sheikh" is a real name part and is NOT listed.
185
+ const FIRST_NAME_TITLE_TOKENS = new Set([
186
+ "ca", "cs", "cpa", "cma", "acca", "aca", "fca", "cfa",
187
+ "mr", "mrs", "ms", "miss", "dr", "eng", "engr", "prof", "sir", "madam",
188
+ ]);
189
+ const MAX_COMPANY_NAME_LENGTH = 60;
190
+
191
+ function letterCount(value) {
192
+ return (String(value).match(/\p{L}/gu) || []).length;
193
+ }
194
+
195
+ // Has cased letters and none of them are lower case. Scripts without case
196
+ // (Arabic, CJK) are never "all caps".
197
+ function isAllCaps(value) {
198
+ return /\p{Lu}/u.test(value) && !/\p{Ll}/u.test(value);
199
+ }
200
+
201
+ /** Why a lead's first name would render badly in {{firstName}}, or null. */
202
+ function firstNameProblem(lead) {
203
+ if (lead?.first_name_confirmed === true) return null;
204
+ const value = String(lead?.firstName || lead?.first_name || "").trim();
205
+ if (!value) return "empty";
206
+ if (FIRST_NAME_TITLE_TOKENS.has(value.replace(/\.+$/, "").toLowerCase())) {
207
+ return "a title or credential, not a first name";
208
+ }
209
+ // Mixed-case short names are real (Li, Wu, Ng, Al, Jo, Ed); a single
210
+ // letter or two capitals (CA, MR, AB) are initials or a credential.
211
+ const letters = letterCount(value);
212
+ if (letters <= 1) return "a single letter (an initial?)";
213
+ if (letters === 2 && isAllCaps(value)) return "two capital letters (initials or a credential?)";
214
+ if (isAllCaps(value)) return "ALL CAPS";
215
+ return null;
216
+ }
217
+
218
+ /** Why a lead's company name would render badly in {{companyName}}, or null. */
219
+ function companyNameProblem(lead) {
220
+ if (lead?.company_name_confirmed === true) return null;
221
+ const value = String(lead?.companyName || lead?.company_name || "").trim();
222
+ if (!value) return "empty";
223
+ if (value.length > MAX_COMPANY_NAME_LENGTH) {
224
+ return `${value.length} characters (limit ${MAX_COMPANY_NAME_LENGTH})`;
225
+ }
226
+ // A single short acronym (IBM, KPMG, BDO) is written in capitals on purpose.
227
+ const shortAcronym = !/\s/.test(value) && letterCount(value) <= 4;
228
+ if (isAllCaps(value) && !shortAcronym) return "ALL CAPS";
229
+ return null;
230
+ }
231
+
232
+ /**
233
+ * Which lead-name checks the copy needs: first names only when a step's
234
+ * subject or body uses {{firstName}}, company names only for {{companyName}}.
235
+ * Shared by the launcher preflight and replenishment.
236
+ */
237
+ function leadNameChecksForSteps(steps) {
238
+ const copy = (Array.isArray(steps) ? steps : [])
239
+ .map((step) => `${step?.subject || ""}\n${step?.body || ""}`)
240
+ .join("\n");
241
+ return {
242
+ checkFirstName: /{{\s*firstName\s*}}/.test(copy),
243
+ checkCompanyName: /{{\s*companyName\s*}}/.test(copy),
244
+ };
245
+ }
246
+
247
+ function findLeadVariableProblems(steps, leads, { skipEmails = null } = {}) {
248
+ const copy = (steps || []).map(step => `${step.subject || ""}\n${step.body || ""}`).join("\n");
249
+ const tokens = new Set([...copy.matchAll(/{{\s*([\w]+)\s*}}/g)].map(match => match[1]));
250
+ tokens.delete("senderName"); // resolved once from authored/verified sender identity
251
+ const aliases = { firstName: "first_name", lastName: "last_name", companyName: "company_name" };
252
+ const problems = [];
253
+ for (const lead of leads || []) {
254
+ const email = normalizeEmail(lead?.email);
255
+ if (!email || skipEmails?.has(email)) continue;
256
+ const imported = buildImportLead(lead);
257
+ for (const token of tokens) {
258
+ const field = aliases[token] || token;
259
+ const value = imported[field] ?? imported.custom_variables?.[token];
260
+ if (value == null || String(value).trim() === "" || /{{.*}}/.test(String(value)))
261
+ problems.push({ email, field: token, severity: "error", problem: "missing or unresolved substitution" });
262
+ else if (field === "first_name" && lead.first_name_confirmed !== true &&
263
+ FIRST_NAME_TITLE_TOKENS.has(String(value).trim().replace(/\.+$/, "").toLowerCase()))
264
+ problems.push({ email, field: token, severity: "error", problem: "title or credential is not a confirmed recipient name" });
265
+ }
266
+ }
267
+ return problems;
268
+ }
269
+
270
+ /**
271
+ * Every lead (with an email) whose name fields would render badly in the
272
+ * copy: first names only when the copy uses {{firstName}}, company names only
273
+ * when it uses {{companyName}}. Leads in skipEmails (already imported) are
274
+ * not checked. Returns [{ email, field, value, problem }].
275
+ */
276
+ function findLeadNameProblems(
277
+ leads,
278
+ { checkFirstName = true, checkCompanyName = false, skipEmails = null } = {},
279
+ ) {
280
+ const problems = [];
281
+ const seen = new Set();
282
+ for (const lead of Array.isArray(leads) ? leads : []) {
283
+ const email = normalizeEmail(lead?.email);
284
+ if (!email || seen.has(email)) continue;
285
+ seen.add(email);
286
+ if (skipEmails && skipEmails.has(email)) continue;
287
+ const firstProblem = checkFirstName ? firstNameProblem(lead) : null;
288
+ if (firstProblem) {
289
+ problems.push({
290
+ email,
291
+ field: "first_name",
292
+ value: String(lead.firstName || lead.first_name || ""),
293
+ problem: firstProblem,
294
+ severity: firstProblem === "empty" || firstProblem === "a title or credential, not a first name" ? "error" : "warning",
295
+ });
296
+ }
297
+ const companyProblem = checkCompanyName ? companyNameProblem(lead) : null;
298
+ if (companyProblem) {
299
+ problems.push({
300
+ email,
301
+ field: "company_name",
302
+ value: String(lead.companyName || lead.company_name || ""),
303
+ problem: companyProblem,
304
+ severity: companyProblem === "empty" ? "error" : "warning",
305
+ });
306
+ }
307
+ }
308
+ return problems;
309
+ }
310
+
311
+ function readEnvFile(file) {
312
+ const env = {};
313
+ for (const line of fs.readFileSync(file, "utf8").split(/\r?\n/)) {
314
+ if (!line || /^\s*#/.test(line)) continue;
315
+ const match = line.match(/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)\s*$/);
316
+ if (!match) continue;
317
+ let [, key, value] = match;
318
+ value = value.replace(/^['"]|['"]$/g, "");
319
+ env[key] = value;
320
+ }
321
+ return env;
322
+ }
323
+
324
+ function resolveRunEnvFile(runDir, explicitEnvFile = null) {
325
+ if (!runDir) return null;
326
+ const envFile = explicitEnvFile
327
+ ? path.resolve(explicitEnvFile)
328
+ : path.join(runDir, ".env");
329
+ return fs.existsSync(envFile) ? envFile : null;
330
+ }
331
+
332
+ function loadRunEnv(runDir, explicitEnvFile = null) {
333
+ if (!runDir) return null;
334
+ const envFile = resolveRunEnvFile(runDir, explicitEnvFile);
335
+ if (!envFile) return null;
336
+ const env = readEnvFile(envFile);
337
+ for (const [key, value] of Object.entries(env)) {
338
+ if (!(key in process.env)) process.env[key] = value;
339
+ }
340
+ return envFile;
341
+ }
342
+
343
+ function getOsConfig(env = process.env) {
344
+ const osApiKey = String(env.OS_API_KEY || "").trim();
345
+ const osUrl = String(env.OS_URL || "")
346
+ .trim()
347
+ .replace(/\/$/, "");
348
+ const missing = [];
349
+ if (!osUrl) missing.push("OS_URL");
350
+ if (!osApiKey) missing.push("OS_API_KEY");
351
+ return { osUrl, osApiKey, missing };
352
+ }
353
+
354
+ /**
355
+ * Make sure the run-scoped `.env` file contains OS credentials.
356
+ * If the file is missing or doesn't have them, copy from `process.env`.
357
+ * Cron jobs run with their own environment and only see what's in `--env-file`,
358
+ * so persisting container-level OS creds into the run `.env` is required
359
+ * for monitor / reply / replenish / conclude to work post-launch.
360
+ *
361
+ * Returns: { envFilePath, source: 'existing'|'created'|'updated', wrote: string[] }
362
+ */
363
+ function ensureRunEnv(runDir, explicitEnvFile = null) {
364
+ if (!runDir) throw new Error("ensureRunEnv requires runDir");
365
+ // An explicit file supplies credentials, but identity snapshots always
366
+ // belong to the private run file, never a shared workspace credential file.
367
+ const envFile = path.resolve(runDir, ".env");
368
+ const sourceFile = explicitEnvFile ? path.resolve(explicitEnvFile) : envFile;
369
+
370
+ ensureDir(path.dirname(envFile));
371
+ const exists = fs.existsSync(envFile);
372
+ const existing = fs.existsSync(sourceFile) ? readEnvFile(sourceFile) : {};
373
+
374
+ const required = ["OS_URL", "OS_API_KEY"];
375
+ const optional = [];
376
+ const wrote = [];
377
+ const next = { ...existing };
378
+
379
+ for (const key of [...required, ...optional]) {
380
+ if (!next[key] && process.env[key]) {
381
+ next[key] = String(process.env[key]).trim();
382
+ wrote.push(key);
383
+ }
384
+ }
385
+
386
+ // Prefer a validated current workspace during interactive launch/install.
387
+ // Outside an active workspace, explicit saved identity settings can be reused.
388
+ // Scheduled workers only load the resulting snapshot and do not refresh it.
389
+ let headers = {};
390
+ const adapter = path.join(__dirname, "connection-identity.js");
391
+ if (next.OS_URL && fs.existsSync(adapter)) {
392
+ const connectionHeaders = require(adapter);
393
+ headers = connectionHeaders(next.OS_URL);
394
+ const relativeRun = path.relative(process.cwd(), path.resolve(runDir));
395
+ const runInWorkspace = !path.isAbsolute(relativeRun) && relativeRun !== ".." && !relativeRun.startsWith(".." + path.sep);
396
+ // Even an unknown caller is interactive when running inside this run's
397
+ // workspace. An unrelated scheduler directory must not supply its identity.
398
+ const activeWorkspace = fs.existsSync(path.join(process.cwd(), ".env.local")) && (process.env.OS_AGENT_NAME || runInWorkspace);
399
+ if (explicitEnvFile && !headers["X-Egbe-Connection-Id"] && !activeWorkspace) {
400
+ headers = connectionHeaders(next.OS_URL, sourceFile);
401
+ }
402
+ }
403
+ if (headers["X-Egbe-Connection-Id"] && headers["X-Egbe-Agent-Name"]) {
404
+ const agent = headers["X-Egbe-Agent-Name"];
405
+ const slug = agent.toUpperCase().replace(/[^A-Z0-9]+/g, "_").replace(/^_+|_+$/g, "");
406
+ const identity = { OS_AGENT_NAME: agent, ["OS_CONNECTION_ID_" + slug]: headers["X-Egbe-Connection-Id"] };
407
+ if (headers["X-Egbe-Workspace-Name"]) identity.OS_WORKSPACE_NAME = headers["X-Egbe-Workspace-Name"];
408
+ else if ("OS_WORKSPACE_NAME" in next) { delete next.OS_WORKSPACE_NAME; wrote.push("OS_WORKSPACE_NAME"); }
409
+ for (const [key, value] of Object.entries(identity)) {
410
+ if (next[key] !== value) { next[key] = value; wrote.push(key); }
411
+ }
412
+ } else if (next.OS_AGENT_NAME || Object.keys(next).some(key => key.startsWith("OS_CONNECTION_ID_"))) {
413
+ // An explicit empty selection prevents both prior-agent attribution and
414
+ // shell-name fallback. Keep saved UUIDs without selecting any of them.
415
+ if (next.OS_AGENT_NAME !== "") { next.OS_AGENT_NAME = ""; wrote.push("OS_AGENT_NAME"); }
416
+ }
417
+
418
+ // Required-but-still-missing -> caller will fail downstream via getOsConfig.
419
+ // We still write what we have so cron jobs see whatever the container exported.
420
+
421
+ if (!exists || wrote.length > 0 || explicitEnvFile) {
422
+ const lines = Object.entries(next).map(([k, v]) => {
423
+ const safe = String(v).replace(/\r?\n/g, " ");
424
+ return `${k}=${["OS_AGENT_NAME", "OS_WORKSPACE_NAME"].includes(k) ? JSON.stringify(safe) : safe}`;
425
+ });
426
+ fs.writeFileSync(envFile, lines.join("\n") + "\n", { mode: 0o600 });
427
+ }
428
+ // Always enforce 0o600 even on pre-existing files; cron install validates this.
429
+ try {
430
+ fs.chmodSync(envFile, 0o600);
431
+ } catch (err) {
432
+ console.error(
433
+ `WARNING: chmod 600 ${envFile} failed (${err.code || err.message}). ` +
434
+ `Cron install will refuse to run with permissions wider than 0o600. ` +
435
+ `Fix the filesystem permissions manually before re-running install-crons.`,
436
+ );
437
+ }
438
+
439
+ // Reflect into process.env so the current process can see what we just wrote.
440
+ for (const [k, v] of Object.entries(next)) {
441
+ if (!(k in process.env)) process.env[k] = v;
442
+ }
443
+
444
+ return {
445
+ envFilePath: envFile,
446
+ source: exists ? (wrote.length || explicitEnvFile ? "updated" : "existing") : "created",
447
+ wrote,
448
+ };
449
+ }
450
+
451
+ function addTagRecord(value, tags) {
452
+ if (value == null) return;
453
+ if (Array.isArray(value)) {
454
+ value.forEach((item) => addTagRecord(item, tags));
455
+ return;
456
+ }
457
+ if (typeof value === "object") {
458
+ for (const key of ["id", "tag_id", "custom_tag_id"]) {
459
+ if (value[key] != null) tags.ids.add(String(value[key]));
460
+ }
461
+ for (const key of ["label", "name", "tag_label"]) {
462
+ if (value[key]) tags.labels.add(String(value[key]));
463
+ }
464
+ return;
465
+ }
466
+ tags.ids.add(String(value));
467
+ }
468
+
469
+ function collectCampaignTags(resource) {
470
+ const tags = { ids: new Set(), labels: new Set() };
471
+ if (!resource || typeof resource !== "object") return tags;
472
+
473
+ for (const key of ["custom_tags", "tags"]) {
474
+ addTagRecord(resource[key], tags);
475
+ }
476
+ for (const key of ["custom_tag_ids", "tag_ids"]) {
477
+ addTagRecord(resource[key], tags);
478
+ }
479
+ for (const key of ["custom_tag_labels", "tag_labels"]) {
480
+ const value = resource[key];
481
+ if (Array.isArray(value))
482
+ value.forEach((label) => label && tags.labels.add(String(label)));
483
+ }
484
+ return tags;
485
+ }
486
+
487
+ function campaignOwnershipStatus(resource, ownership) {
488
+ if (!resource || !ownership) return "unknown";
489
+ const tags = collectCampaignTags(resource);
490
+ if (!tags.ids.size && !tags.labels.size) return "unknown";
491
+
492
+ const runMatch =
493
+ (ownership.run_tag_id != null &&
494
+ tags.ids.has(String(ownership.run_tag_id))) ||
495
+ (ownership.run_tag_label &&
496
+ tags.labels.has(String(ownership.run_tag_label)));
497
+ const agentMatch =
498
+ (ownership.agent_tag_id != null &&
499
+ tags.ids.has(String(ownership.agent_tag_id))) ||
500
+ (ownership.agent_tag_label &&
501
+ tags.labels.has(String(ownership.agent_tag_label)));
502
+
503
+ if (runMatch && agentMatch) return "owned";
504
+ if (runMatch || agentMatch) return "unknown";
505
+ return "foreign";
506
+ }
507
+
508
+ function assertCampaignNotForeign(resource, ownership, context = "campaign") {
509
+ const status = campaignOwnershipStatus(resource, ownership);
510
+ if (status === "foreign") {
511
+ throw new Error(`${context} exists but is not owned by this run`);
512
+ }
513
+ return status;
514
+ }
515
+
516
+ module.exports = {
517
+ ensureDir,
518
+ readJson,
519
+ writeJson,
520
+ sha256,
521
+ stableStringify,
522
+ normalizeEmail,
523
+ parseArgs,
524
+ isoNow,
525
+ ymd,
526
+ slugify,
527
+ titleCase,
528
+ isGenericMailbox,
529
+ deriveSenderName,
530
+ replaceSenderNameToken,
531
+ buildImportLead,
532
+ firstNameProblem,
533
+ companyNameProblem,
534
+ findLeadNameProblems,
535
+ leadNameChecksForSteps,
536
+ findLeadVariableProblems,
537
+ MAX_COMPANY_NAME_LENGTH,
538
+ readEnvFile,
539
+ resolveRunEnvFile,
540
+ loadRunEnv,
541
+ ensureRunEnv,
542
+ getOsConfig,
543
+ campaignOwnershipStatus,
544
+ assertCampaignNotForeign,
545
+ };