@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,135 @@
1
+ ---
2
+ name: egbe-os-apollo-lead-finder
3
+ description: Search and enrich Apollo contacts or extract contact candidates from Places business websites through Egbe OS.
4
+ version: 1.1.2
5
+ user-invocable: true
6
+ argument-hint: "[find-leads --config <file> | search --titles <t> | enrich --input <file> | places-leads --queries <q;q>] --output <leads.json>"
7
+ metadata:
8
+ egbe-when: "Use for contact discovery, Apollo enrichment, or Places website sourcing."
9
+ egbe-visible: "true"
10
+ egbe-title: "Lead discovery"
11
+ egbe-description: "Search business contacts and return source status, enrichment progress and contact candidates."
12
+ egbe-category: "Marketing & growth"
13
+ ---
14
+
15
+ <!-- egbe-mcp-connection:v1 -->
16
+ This skill comes with the Egbe plugin. If this project has its own installed copy
17
+ of the skill, use that copy instead. Otherwise make every Egbe API call it
18
+ describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
19
+ PUT, PATCH and DELETE (with `method`). Pass the API path (for example
20
+ `/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
21
+ `egbe-curl.py` and catalog update checks; the connection authenticates and
22
+ identifies the request. Also pass the `business` that `egbe_setup` returned.
23
+ Where this skill sends an `Idempotency-Key` header, pass the same value as
24
+ `idempotency_key` and reuse it when retrying. A result with a `continuation`
25
+ holds one part of a long body; read the next part with `egbe_read`, the same
26
+ `path` and `business`, and that `continuation`.
27
+ Read bundled files beside this `SKILL.md`. For published skill resources on
28
+ Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
29
+
30
+ Publishing works through the connector: commit the app's files with the JSON
31
+ commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
32
+ commit SHA; no git push or workspace setup is needed. A step that needs a local
33
+ project key or a bundled script, such as a local `npx convex deploy`, needs a
34
+ set-up project workspace. In a persistent
35
+ project workspace that is not set up yet, set it up as the `egbe-setup` skill's
36
+ project setup describes.
37
+ Without such a workspace, or if it refuses, tell the founder that this step needs
38
+ an agent with a set-up project folder, and continue with the rest of the work.
39
+
40
+ If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
41
+ available, the plugin's connector is not signed in for this agent. Tell
42
+ the founder how to connect it, as the `egbe-setup` skill describes, rather than
43
+ saying Egbe is unavailable.
44
+
45
+ The connector's tools work even where this environment's shell cannot reach
46
+ Egbe: their calls travel through this agent's connection, not through the
47
+ shell's network. A step that runs in the shell, such as a bundled script, a `git
48
+ push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
49
+ Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
50
+ before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
51
+ the founder: they allow that host in this agent's network settings or continue
52
+ with an agent on their own computer. Code can also be published without the
53
+ shell by committing through the connector (`egbe-os-git`, "Without a terminal").
54
+ Until the shell step or that commit and its deploy succeed, do not report the
55
+ work as published: a preview in this agent or on this computer is not an Egbe
56
+ deployment.
57
+
58
+ Run a script bundled with this skill from the root of a project folder set up
59
+ for Egbe, with `OS_AGENT_NAME="<your agent name>"` set inline, such as `OpenCode`.
60
+ A script that calls Egbe reads `OS_URL`, `OS_API_KEY` and this agent's connection
61
+ ID from `.env.local` through Egbe's request helper, which comes with the plugin at
62
+ `../egbe-os-quickstart/scripts/egbe-curl.py` from this skill's folder. Where this
63
+ skill says a script needs `OS_URL` or `OS_API_KEY` in its environment, start it
64
+ through the helper, which loads `.env.local` without executing it:
65
+ `python3 <helper> --egbe-run <command>`, with the helper's absolute path. Where
66
+ this skill writes `<skills-directory>`, use the plugin's `skills` folder, which
67
+ holds this skill's folder.
68
+
69
+
70
+ # Apollo Lead Finder
71
+
72
+ Use this capability for a requested contact search or enrichment. It does not
73
+ choose the audience, grant permission to spend or contact people, or require an
74
+ Instantly campaign.
75
+
76
+ Read [operations](references/operations.md) for commands, input/output shapes,
77
+ limits and recovery. The four commands are:
78
+
79
+ - `search`: live Apollo preview without enrichment; consumes search quota.
80
+ - `find-leads`: search followed by enrichment.
81
+ - `enrich`: enrich a compatible people list, or resume unfinished enrichment
82
+ from a partial Apollo result while preserving its existing leads.
83
+ - `places-leads`: Places search/details followed by guarded public website reads.
84
+
85
+ Use Node and `OS_URL` / `OS_API_KEY` (or `--env-file`). Authenticated provider
86
+ operations go through Egbe OS with Bearer auth; do not request separate Apollo
87
+ keys or bypass the gateway. Public website reads by Places are unauthenticated.
88
+
89
+ Set `--output` to a durable location in the access-controlled project repository:
90
+ the owning campaign's `egbe-docs/marketing/campaigns/instantly/<run_key>/leads.json`,
91
+ or `egbe-docs/research/<id>/work/` before a campaign exists. Keep the result's
92
+ source and completeness metadata with the contacts. Files contain personal data.
93
+
94
+ Check `meta.complete`, `stop_reason` and the unfinished inputs, not just the
95
+ number of emails. A completed zero-result search differs from an outage or quota
96
+ stop. Partial results remain usable evidence, not a claim that sourcing finished.
97
+ A provider status such as `verified` or `likely`, or a scraped `unverified`
98
+ address, does not establish current deliverability, relevance, consent or
99
+ authorization to send. These commands neither launch campaigns nor replace
100
+ downstream import verification.
101
+
102
+ ## Through the Egbe connector
103
+
104
+ Without Node, make the scripts' requests with `egbe_write` and keep their
105
+ bounds. Each result's `data` is the provider body.
106
+
107
+ - **Search** (`POST /outreach/apollo/people/search`, consumes search quota): the
108
+ Apollo fields from [search inputs](references/operations.md#search-inputs),
109
+ plus `page` (from 1) and `per_page` (at most 100). Read `data.people`. Request
110
+ the next page until a page is empty or shorter than `per_page`, the page
111
+ reaches `data.pagination.total_pages` (missing pagination does not mean one
112
+ page) or you have the requested number. Deduplicate by person `id` across
113
+ pages; a page that adds no new `id` is a repeated page, an incomplete result
114
+ rather than the end.
115
+ - **Enrich** (`POST /outreach/apollo/people/bulk_match`, consumes enrichment
116
+ quota and can cost money): `{"details": [...]}` with at most 10 people, each
117
+ with `id`, or `linkedin_url`, or `first_name` and `last_name` with `domain` or
118
+ `organization_name`, and `"reveal_personal_emails": false`. Read
119
+ `data.matches`; a null entry is an unmatched person. `POST
120
+ /outreach/apollo/people/match` takes one such person.
121
+ - Keep a match as a lead only with an email, trimmed and lower-cased, once per
122
+ address; the scripts keep `email_status` `verified` and `likely` by default.
123
+
124
+ Save the result after every page or batch, before the next request, in the
125
+ `{leads, meta}` shape of
126
+ [operations](references/operations.md#enrichment-and-result-contract) with
127
+ `complete`, `stop_reason`, `processed_count` and the inputs not yet sent as
128
+ `not_enriched_people`. Keep it at its location above in Egbe's artifact store,
129
+ as `egbe-os-quickstart` → `references/artifact-sync.md` ("Through the Egbe
130
+ connector") describes; it holds personal data, so keep it nowhere else. A lost
131
+ response may already be charged: on resume send only the saved unsent inputs.
132
+ `places-leads` reads business websites with a guarded local client and needs a
133
+ set-up project workspace: in a persistent project workspace not set up yet, call
134
+ `egbe_local_setup`; otherwise tell the founder which step needs it. Through the
135
+ connector, use `egbe-os-search` for Places listings and details instead.
@@ -0,0 +1,240 @@
1
+ # Contact sourcing operations
2
+
3
+ ## Connection and commands
4
+
5
+ Requires Node, `OS_URL` and `OS_API_KEY`. All commands accept
6
+ `--env-file <path>`; exported environment values take precedence. The shared
7
+ connection helper supplies agent identity headers when configured.
8
+
9
+ Authenticated routes:
10
+
11
+ ```text
12
+ POST $OS_URL/outreach/apollo/people/search
13
+ POST $OS_URL/outreach/apollo/people/match
14
+ POST $OS_URL/outreach/apollo/people/bulk_match
15
+ POST $OS_URL/search/places
16
+ POST $OS_URL/tools/places/details
17
+ ```
18
+
19
+ Use the installed skill directory for scripts and the project's durable output
20
+ directory for data. Shell wrappers with the same four names forward to Node.
21
+
22
+ ```bash
23
+ node "$SKILL_DIR/scripts/search.js" --titles "VP Sales,Director of Sales" \
24
+ --employee-ranges "11,50;51,200" --max-results 20 --output "$WORK_DIR/preview.json"
25
+ node "$SKILL_DIR/scripts/enrich.js" --input "$WORK_DIR/preview.json" \
26
+ --output "$WORK_DIR/leads.json"
27
+ node "$SKILL_DIR/scripts/find-leads.js" --config "$WORK_DIR/search-config.json" \
28
+ --max-results 20 --time-budget-ms 90000 --output "$WORK_DIR/leads.json"
29
+ node "$SKILL_DIR/scripts/places-leads.js" --queries "accountants in Lisbon;accountants in Porto" \
30
+ --max-places 40 --email-preference generic --output "$WORK_DIR/places-leads.json"
31
+ ```
32
+
33
+ These are live operations, not dry runs. No operation includes sending.
34
+ `--verbose` writes progress to stderr. Without `--output`, final JSON is stdout,
35
+ but there is no durable checkpoint if the process is killed.
36
+
37
+ ## Search inputs
38
+
39
+ `search` and `find-leads` accept the same flags below. Lists are comma- or
40
+ semicolon-separated except employee ranges, which use semicolons between ranges.
41
+ Alternatively `--config` accepts a raw search object or `{"search": {...}}`;
42
+ config mode uses that object, not additional search-filter flags.
43
+
44
+ | Flag | Apollo field |
45
+ | --- | --- |
46
+ | `--titles`, `--not-titles` | `person_titles`, `person_not_titles` |
47
+ | `--seniorities` | `person_seniorities` |
48
+ | `--locations`, `--not-locations` | `person_locations`, `person_not_locations` |
49
+ | `--domains` | `q_organization_domains_list` |
50
+ | `--org-locations`, `--org-names` | `organization_locations`, `organization_names` |
51
+ | `--employee-ranges` | `organization_num_employees_ranges` (e.g. `["11,50","51,200"]`) |
52
+ | `--keywords`, `--industries` | `keywords`, `industry_tag_ids` |
53
+ | `--technologies` | `currently_using_any_of_technology_uids` |
54
+ | `--email-status` | `contact_email_status` (search filter) |
55
+
56
+ `--max-results` is a positive integer (default 50 for preview, 100 for combined
57
+ search/enrichment). The client requests pages of 100, caps pagination at 500 pages,
58
+ deduplicates IDs, honors supplied total pages and stops on short/empty pages.
59
+ Missing pagination does not mean there is only one page. A repeated page is an
60
+ incomplete result, not proof that the source is exhausted.
61
+
62
+ `search` outputs `{people: [...], meta: {...}}`, preserving provider records
63
+ including IDs and structured organization fields for enrichment. Display name
64
+ alone is not sufficient enrichment input.
65
+
66
+ ## Enrichment and result contract
67
+
68
+ `enrich --input` accepts an array, `{people: [...]}`, compatible `{leads: [...]}`,
69
+ or the saved partial Apollo output. Each new input needs one of:
70
+
71
+ - `id` or `apollo_id`;
72
+ - `linkedin_url`;
73
+ - `first_name` and `last_name`, with a domain or company name.
74
+
75
+ Organization fields can be nested under `organization` or supplied as
76
+ `organization_name` / `company_name` / `company` and
77
+ `domain` / `company_domain` / `website`. Website URLs normalize to hostnames.
78
+ Unknown names are not fabricated from display names. The entire input is validated
79
+ before enrichment requests. An empty input is a valid completed empty operation.
80
+
81
+ The client batches at most ten people per call. `--email-status-filter` controls
82
+ retained enrichment results (default `verified,likely`; an empty string retains
83
+ all statuses). This is a selection setting, not a verification guarantee.
84
+ It is distinct from the search flag `--email-status`.
85
+
86
+ `find-leads` and `enrich` return:
87
+
88
+ ```json
89
+ {
90
+ "leads": [],
91
+ "meta": {
92
+ "source": "apollo",
93
+ "complete": false,
94
+ "stop_reason": "daily_quota",
95
+ "enriched": 0,
96
+ "enriched_count": 0,
97
+ "processed_count": 0,
98
+ "leads_with_email": 0,
99
+ "email_status_filter": ["verified", "likely"],
100
+ "drops": {"no_email": 0, "email_status": 0, "duplicate_email": 0},
101
+ "not_enriched": 1,
102
+ "not_enriched_people": [{"id": "provider-person-id"}]
103
+ }
104
+ }
105
+ ```
106
+
107
+ Leads have normalized `email`, available `first_name`, `last_name`,
108
+ `company_name`, `website`, `email_status`, `apollo_id`, and optional role,
109
+ location, company-size and LinkedIn fields. Empty fields stay empty. Addresses
110
+ are deduplicated, but a nonempty address is not a delivery check.
111
+
112
+ `processed_count` counts inputs in completed enrichment batches; `enriched`
113
+ and its `enriched_count` alias count non-null provider matches, before output
114
+ filtering. Null matches and matched people without emails are not queued for
115
+ automatic re-enrichment. `not_enriched` and `not_enriched_people` describe only
116
+ unprocessed inputs, not unmatched or status-filtered people. Zero results use
117
+ the same fields, rather than a special success shape.
118
+
119
+ For an HTTP failure during enrichment, SDK results include `error_status` and
120
+ `error`; CLI results and checkpoints keep these as `meta.error_status` and
121
+ `meta.error`, for example:
122
+
123
+ ```json
124
+ {
125
+ "error_status": 422,
126
+ "error": {
127
+ "code": "insufficient_credits",
128
+ "message": "You have insufficient credits! Upgrade your plan to increase your number of lead credits."
129
+ }
130
+ }
131
+ ```
132
+
133
+ The message is a safe diagnostic, not an instruction to upgrade or permission to
134
+ spend. Other codes include `validation_error`, `authorization`, `daily_quota`,
135
+ `rate_limited` and `provider_error`. Validation summaries contain at most ten
136
+ allowlisted `loc`/`type` entries with normalized messages; unknown path segments
137
+ are `[redacted]`. A `details` index is relative to the failed request's batch,
138
+ not the complete saved input list. Arbitrary provider text, input echoes, headers and credentials
139
+ are omitted. An unknown error explicitly says its details were omitted, rather
140
+ than claiming the original response was recovered. Search-only errors retain
141
+ their existing status/stop-reason contract.
142
+
143
+ `insufficient_credits` describes Apollo's shared-account capacity, independently
144
+ of remaining Egbe quota. Report it to Egbe support and preserve the checkpoint;
145
+ do not retry enrichment, purchase credits or request separate keys to diagnose
146
+ it. The existing project workflow must authorize any later continuation.
147
+ `processed_count: 0` and pending inputs are not proof that Apollo processed or
148
+ charged nothing. The diagnostic is not a billing receipt and cannot reconstruct
149
+ an error body discarded by an older SDK. Explicit `enrich --input <partial>`
150
+ continuation clears the prior enrichment error before its first checkpoint;
151
+ a new failure records its own diagnostic and a successful recovery leaves none.
152
+
153
+ Combined search includes `total_found`, `search_params`, `max_results`,
154
+ `search_complete`, `search_stop_reason`, `search_next_page` and `searched_at`.
155
+ Preview completion describes search only; its `not_enriched` is zero because no
156
+ enrichment was requested. `max_results` means the requested bound was met, not
157
+ that the entire audience was exhausted.
158
+
159
+ ## Bounded execution and recovery
160
+
161
+ All commands accept a positive `--time-budget-ms` (default 90000). Apollo allows
162
+ at most four transport retries, honors Retry-After within that budget, and has no
163
+ second unbounded batch retry loop. Daily quota/configuration limits stop without
164
+ retrying. Transient HTTP failures may retry; transport/network uncertainty stops
165
+ the operation with pending inputs. A request may already have incurred cost when
166
+ its response is lost; recovery cannot promise exactly-once provider billing.
167
+
168
+ Exit codes:
169
+
170
+ - `0`: requested operation completed, including a genuine zero-result search.
171
+ - `2`: structured incomplete result; inspect the saved JSON even with no leads.
172
+ - `1`: invalid input/credentials or a local execution failure. Inspect an existing
173
+ checkpoint rather than assuming it contains nothing or blindly replacing it.
174
+
175
+ Reasons include `completed`, `search_exhausted`, `max_results`, `daily_quota`,
176
+ `rate_limited`, `time_budget`, `authorization`, `provider_error`,
177
+ `network_error`, `invalid_response`, `repeated_page`, and `max_pages`.
178
+ A checkpoint left with `in_progress` means the process did not finish; it is
179
+ never success. Missing OS credentials fail before requests. Check the OS key,
180
+ scope or upstream configuration for 401/403 or Apollo configuration failures.
181
+ Do not widen the audience or increase spending merely to turn an empty result
182
+ into a nonempty one.
183
+
184
+ With `--output`, writes replace JSON atomically before work and after every
185
+ completed page/batch. To continue already-found inputs:
186
+
187
+ ```bash
188
+ node "$SKILL_DIR/scripts/enrich.js" --input "$WORK_DIR/leads.json" \
189
+ --output "$WORK_DIR/leads.json" --time-budget-ms 90000
190
+ ```
191
+
192
+ This keeps existing leads and processes only `meta.not_enriched_people`; it
193
+ does not repeat search or successful batches. Preserve the existing email filter
194
+ when resuming: prior filtered provider matches are not stored for re-filtering.
195
+ If search itself was incomplete, enrichment does not claim the missing search
196
+ pages finished. `search_next_page` is diagnostic context, not an automatic
197
+ search-resume token.
198
+
199
+ Subprocess callers must give the client a smaller budget than their own timeout
200
+ (e.g. 90 seconds inside 120 seconds), read output on exit 2 and on interruption,
201
+ and preserve partial state before removing temporary directories. A hard kill
202
+ can leave the in-flight batch uncertain; completed checkpoints remain available.
203
+
204
+ ## Places inputs, status and limits
205
+
206
+ `--queries` is a required semicolon-separated list; each search requests up to
207
+ 20 results. `--exclude-categories` supplies optional name/type substring
208
+ exclusions. `--max-places` defaults to 60 and is clamped to a local cap of 200
209
+ unique places across the run. These are work bounds, not remaining provider quota.
210
+
211
+ Registry defaults are separate daily resources: Apollo searches 100 and
212
+ enrichments 200 people; Places searches, details and reviews each 200. Actual
213
+ project limits and operation charges may differ. One search and one details
214
+ request consume their respective resource, not a shared 200-request pool.
215
+ This script does not call reviews. A live preview and a Places sweep are not
216
+ free workarounds for quota or cost approval.
217
+
218
+ The pipeline gets listings, details and the website homepage, `/contact` and
219
+ `/about`. Each website/redirect is checked for public DNS/IPs and pinned to the
220
+ checked address; private, internal and credential-bearing URLs are refused.
221
+ Website requests carry no OS credentials. Trap-address and malformed-address
222
+ filters remain separate from optional ranking.
223
+
224
+ `--email-preference personal|generic|first` selects a ranking heuristic (default
225
+ `personal`). “Personal” only describes the local-part shape; it does not prove
226
+ ownership, recipient suitability or that a role mailbox is inferior. Name
227
+ extraction is an English-text heuristic: candidates are in `name_candidate` and
228
+ `name_candidate_source`, not silently filled into `first_name`. Address parsing
229
+ is also labeled heuristic. Check these candidates before using them in copy.
230
+
231
+ Places returns `leads/meta` with `source: "places"` and every email
232
+ `email_status: "unverified"`. It does not enrich Apollo people:
233
+ `enriched` and `not_enriched` are zero; `sites_scraped` is a separate counter.
234
+ `drops` separates details failures, unreadable websites, category exclusions,
235
+ missing websites/emails and duplicates. `pending_queries` and
236
+ `not_processed_places` retain unfinished work, with `complete: false` for
237
+ provider/website failures. Empty completed search, all failed searches and
238
+ filtered results are distinct. Places checkpoints are retained evidence;
239
+ `enrich` is not a Places recovery command. No automatic Places replay is
240
+ implemented; review the pending items before another paid sweep.
@@ -0,0 +1,6 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+ require("./lib/sourcing").run("enrich").then((code) => { process.exitCode = code; }).catch((error) => {
4
+ console.error(`FATAL: ${error.message}`);
5
+ process.exitCode = 1;
6
+ });
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+ SKILL_SCRIPTS="$(dirname "$(readlink -f "$0")")"
4
+ exec node "${SKILL_SCRIPTS}/enrich.js" "$@"
@@ -0,0 +1,6 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+ require("./lib/sourcing").run("find-leads").then((code) => { process.exitCode = code; }).catch((error) => {
4
+ console.error(`FATAL: ${error.message}`);
5
+ process.exitCode = 1;
6
+ });
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+ SKILL_SCRIPTS="$(dirname "$(readlink -f "$0")")"
4
+ exec node "${SKILL_SCRIPTS}/find-leads.js" "$@"