@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,127 @@
1
+ ---
2
+ name: egbe-os-instantly-campaign-launcher
3
+ description: Prepare, explicitly activate, observe and recover project-owned Instantly email campaigns and reply queues; inspect assigned sender state.
4
+ version: 1.3.5
5
+ user-invocable: true
6
+ metadata:
7
+ egbe-when: "Use for Instantly campaign preparation, activation, replies, observation or recovery."
8
+ egbe-visible: "true"
9
+ egbe-title: "Email outreach"
10
+ egbe-description: "Operate scoped email campaigns, imports, reply queues and factual campaign observations."
11
+ egbe-category: "Marketing & growth"
12
+ ---
13
+
14
+ <!-- egbe-mcp-connection:v1 -->
15
+ This skill comes with the Egbe plugin. If this project has its own installed copy
16
+ of the skill, use that copy instead. Otherwise make every Egbe API call it
17
+ describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
18
+ PUT, PATCH and DELETE (with `method`). Pass the API path (for example
19
+ `/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
20
+ `egbe-curl.py` and catalog update checks; the connection authenticates and
21
+ identifies the request. Also pass the `business` that `egbe_setup` returned.
22
+ Where this skill sends an `Idempotency-Key` header, pass the same value as
23
+ `idempotency_key` and reuse it when retrying. A result with a `continuation`
24
+ holds one part of a long body; read the next part with `egbe_read`, the same
25
+ `path` and `business`, and that `continuation`.
26
+ Read bundled files beside this `SKILL.md`. For published skill resources on
27
+ Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
28
+
29
+ Publishing works through the connector: commit the app's files with the JSON
30
+ commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
31
+ commit SHA; no git push or workspace setup is needed. A step that needs a local
32
+ project key or a bundled script, such as a local `npx convex deploy`, needs a
33
+ set-up project workspace. In a persistent
34
+ project workspace that is not set up yet, set it up as the `egbe-setup` skill's
35
+ project setup describes.
36
+ Without such a workspace, or if it refuses, tell the founder that this step needs
37
+ an agent with a set-up project folder, and continue with the rest of the work.
38
+
39
+ If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
40
+ available, the plugin's connector is not signed in for this agent. Tell
41
+ the founder how to connect it, as the `egbe-setup` skill describes, rather than
42
+ saying Egbe is unavailable.
43
+
44
+ The connector's tools work even where this environment's shell cannot reach
45
+ Egbe: their calls travel through this agent's connection, not through the
46
+ shell's network. A step that runs in the shell, such as a bundled script, a `git
47
+ push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
48
+ Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
49
+ before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
50
+ the founder: they allow that host in this agent's network settings or continue
51
+ with an agent on their own computer. Code can also be published without the
52
+ shell by committing through the connector (`egbe-os-git`, "Without a terminal").
53
+ Until the shell step or that commit and its deploy succeed, do not report the
54
+ work as published: a preview in this agent or on this computer is not an Egbe
55
+ deployment.
56
+
57
+ Run a script bundled with this skill from the root of a project folder set up
58
+ for Egbe, with `OS_AGENT_NAME="<your agent name>"` set inline, such as `OpenCode`.
59
+ A script that calls Egbe reads `OS_URL`, `OS_API_KEY` and this agent's connection
60
+ ID from `.env.local` through Egbe's request helper, which comes with the plugin at
61
+ `../egbe-os-quickstart/scripts/egbe-curl.py` from this skill's folder. Where this
62
+ skill says a script needs `OS_URL` or `OS_API_KEY` in its environment, start it
63
+ through the helper, which loads `.env.local` without executing it:
64
+ `python3 <helper> --egbe-run <command>`, with the helper's absolute path. Where
65
+ this skill writes `<skills-directory>`, use the plugin's `skills` folder, which
66
+ holds this skill's folder.
67
+
68
+
69
+ # Instantly campaign operations
70
+
71
+ Use the operation the task calls for; preparing a campaign is not authorization
72
+ to activate it, add recipients, reply, or install recurring jobs. Existing
73
+ research, copy, lists and run state are valid inputs. This capability does not
74
+ select a business goal or decide an outcome from reply rate.
75
+
76
+ Requires Node 24+ (`node:sqlite`), `OS_URL` and `OS_API_KEY`. Use the project
77
+ OS connection, not personal provider keys. Missing credentials are a blocker,
78
+ not permission to send cold outreach through Mailu or a trust-domain mailbox.
79
+
80
+ Read only the reference needed for the operation:
81
+
82
+ - [Campaign operations](references/instantly-ops.md): preparation/activation,
83
+ sender selection and state, pagination, date-filtered reads, rendering, verification,
84
+ imports and safe cleanup.
85
+ - [Reply handling](references/reply-handling.md): queue actions, confirmed
86
+ opt-outs, same-thread sends and uncertain-send recovery.
87
+ - [Observation and scheduling](references/observation-and-scheduling.md):
88
+ factual metrics, configured protection, optional jobs and verification.
89
+ - [Run state](references/run-state.md): executable configuration, artifacts,
90
+ identity, handoff and replenishment; includes the [spec scaffold](references/run-spec-template.json).
91
+
92
+ For activation, readiness to continue, or protection recovery, read
93
+ [configured protection](references/observation-and-scheduling.md#configured-operational-protection)
94
+ to check what the bundled monitor supports and what its state actually proves.
95
+
96
+ ## Through the Egbe connector
97
+
98
+ Through the connector alone, observe without changing anything: the reads in
99
+ [campaign operations](references/instantly-ops.md#paginated-and-date-filtered-reads)
100
+ with their cursor rules, `GET /outreach/instantly/campaigns/{id}`,
101
+ `/campaigns/{id}/analytics`, `/campaigns/{id}/sending-status`, and the
102
+ assigned-sender and exclusion reads, all below `/outreach/instantly`. Report
103
+ them as provider observations at their read time; they are not the run's
104
+ `outreach.db` history, so do not compute conclusions that need it. Preparation,
105
+ activation, imports, replies, opt-out handling and monitoring run the bundled
106
+ Node scripts against the run's files and `outreach.db`, and need a set-up
107
+ project workspace: in a persistent project workspace not set up yet, call
108
+ `egbe_local_setup`; otherwise tell the founder which step needs it. Do not
109
+ reproduce those writes with raw requests.
110
+
111
+ Keep the owning run under
112
+ `egbe-docs/marketing/campaigns/instantly/<run_key>/`. Before continuing, read its
113
+ manifest and state files and query the project `outreach.db`, next to the run
114
+ directories, only through the read-only `scripts/outreach-report.js`
115
+ ([usage](references/observation-and-scheduling.md#collect-facts-for-one-run)).
116
+ If it reports the database missing, say so; do not search the workspace or open
117
+ SQLite with inline code. Bundled scripts treat missing history after sending as a
118
+ blocker, not something to recreate. JSON checkpoints and queue
119
+ files remain active state, not disposable duplicates. Use only the run's
120
+ campaign IDs. Registry/gateway ownership is the tenant authority; local
121
+ manifest/tags narrow the run and detect conflicts, but do not grant access.
122
+
123
+ Commands return observations and operation evidence. Check readbacks and
124
+ incomplete actions before reporting success. Preserve contacts/messages/state
125
+ in the access-controlled project repository, credentials outside Git, and one
126
+ active executor when transferring work. Keep the current plan and decisions in
127
+ the existing project context, without a second preflight/log/lessons package.
@@ -0,0 +1,260 @@
1
+ # Campaign operations
2
+
3
+ ## Connection and scope
4
+
5
+ Scripts authenticate to `$OS_URL/outreach/instantly/{path}` with
6
+ `Authorization: Bearer $OS_API_KEY`. They use the installed connection-identity
7
+ helper; no provider API key or hosted-agent boot environment is assumed.
8
+ `launch-campaign.js` materializes available credentials and identity in the
9
+ private run `.env` (0600). Workers load that file or an explicit `--env-file`.
10
+
11
+ The gateway exposes project-owned campaigns, their assigned senders, leads and
12
+ campaign emails.
13
+ `GET /accounts` is a shared workspace account list, not tenant-filtered sender
14
+ authorization; read-only keys cannot use it. For an existing campaign's sender
15
+ state, use the scoped read below with either a regular or read-only project key.
16
+ Registry campaign ownership is authoritative. Manifest IDs and run/agent
17
+ tags are local scope/conflict checks; best-effort tag assignment is recorded and
18
+ does not replace server ownership. Never use a name match or tag to adopt another
19
+ project's campaign.
20
+
21
+ The bundled client wraps provider POST/PATCH bodies as `{"payload": {...}}`.
22
+ The semantic exclusion call below uses its own fixed intent body.
23
+ Bodyless activate/pause calls have no body. Use the client or supported scripts;
24
+ raw provider-shaped writes to OS can fail 422.
25
+
26
+ ## Paginated and date-filtered reads
27
+
28
+ Paths below are relative to `$OS_URL/outreach/instantly`. The bundled
29
+ `scripts/lib/instantly-client.js` exposes the same reads:
30
+
31
+ | GET path | Query parameters | Client method |
32
+ | --- | --- | --- |
33
+ | `/campaigns` | `limit` (default 100), `starting_after` | `listCampaigns(limit, startingAfter)` |
34
+ | `/accounts` | `limit` (default 100), `starting_after`, `status_filter` | `listAccounts(limit, {starting_after, status_filter})` |
35
+ | `/campaigns/{id}/senders` | None | `campaignSenders(id)` |
36
+ | `/campaigns/{id}/analytics/overview` | `start_date`, `end_date` | `analyticsOverview([id], {start_date, end_date})` |
37
+
38
+ For lists, pass the response's `next_starting_after` unchanged as
39
+ `starting_after` on the next read. Campaign pages are filtered to this project
40
+ after provider pagination: even an empty `items` array can have a next cursor.
41
+ Continue until the cursor is absent; stop and report a repeated cursor or read
42
+ failure instead of claiming the list is complete. For account-list filtering,
43
+ the SDK also accepts `status` as an alias for `status_filter`.
44
+
45
+ Overview dates accept `YYYY-MM-DD` or full ISO 8601 timestamps; date-only values
46
+ mean UTC midnight. For a UTC calendar day, specify explicit bounds such as
47
+ `2026-01-15T00:00:00.000Z` through `2026-01-15T23:59:59.999Z`. The gateway passes
48
+ the supplied strings to Instantly without normalization. Omitting both dates
49
+ retains the lifetime overview. Range-filtered fields include `emails_sent_count`
50
+ and `bounced_count`; keep these observations separate from lifetime totals.
51
+ Invalid ranges return the provider's error, not an empty or lifetime report.
52
+ The campaign ID comes from the owned path, not caller-supplied `id`/`ids`
53
+ parameters. See the [provider overview contract](https://developer.instantly.ai/api-reference/campaign/get-campaigns-analytics-overview).
54
+
55
+ ## Read assigned sender state
56
+
57
+ `GET /campaigns/{id}/senders` checks project ownership and reads the campaign's
58
+ current `email_list`; it does not accept sender addresses or domains from the
59
+ caller. It returns only those senders, including inactive ones, with `email`,
60
+ `status`, `daily_limit`, `warmup_status` and `stat_warmup_score`. This is a read
61
+ of campaign assignment, not proof of exclusive ownership of a mailbox.
62
+
63
+ The response contains `campaign_id`, `observed_at` (UTC fetch time), `items` and
64
+ `complete`. Each item has `data_status` (`available`, `partial` or `unavailable`)
65
+ and `missing_fields`; unreadable values stay `null`, with a safe `reason` for a
66
+ failed account read. `complete` means data coverage, not healthy senders or
67
+ permission to send. An empty explicit assignment is not a healthy sending pool.
68
+ Reads have a shared 20-second budget (below the OS proxy timeout); slow or
69
+ unfinished reads stay unavailable while completed observations are preserved.
70
+ Tag-based assignment is not expanded: `sender_tag_assignment_unresolved` keeps
71
+ `complete: false`, even if all explicitly assigned senders were read.
72
+
73
+ Missing/malformed campaign assignment returns an error rather than an empty
74
+ success. Preserve unknowns; do not fall back to the shared `/accounts` list or
75
+ another key to turn incomplete data into a successful check.
76
+
77
+ ## Prepare or activate an existing run
78
+
79
+ ```bash
80
+ node "$SKILL_DIR/scripts/launch-campaign.js" --run-spec "$RUN_DIR/run-spec.json"
81
+ ```
82
+
83
+ See [run-state](run-state.md) for the spec and paths. The launcher validates the
84
+ input, resolves specified senders, creates/reuses its campaign, uploads rendered
85
+ sequence and missing leads, checks import/verification, and writes state.
86
+ Preparation defaults to a non-activated draft. Activation occurs only with
87
+ `campaign.activate_on_launch: true`, after the applicable decision and gates.
88
+ A rerun does not mean a new experiment: it resumes the manifest. A genuinely new
89
+ test needs a new run identity, even if the audience and offer are the same.
90
+
91
+ The launcher fingerprints rendered sequence plus senders. A changed fingerprint
92
+ requires an intentional `--allow-sequence-update`; do not add this flag merely
93
+ to silence drift on an existing campaign. Use supported rendering when updating:
94
+ raw `{{senderName}}` in a provider patch is not a provider variable.
95
+ Skill version 1.3.5 fixed step rendering for links followed by punctuation or
96
+ `**`, `&` in a query, `mailto:`/`tel:` links, parentheses in a markdown URL,
97
+ schemeless or relative markdown targets and `<...>` in plain text. Drift that
98
+ comes only from those rendering fixes on a campaign prepared with an earlier
99
+ version is an intended update: rerun with `--allow-sequence-update`.
100
+
101
+ Create/import calls are not blindly replayed after uncertain outcomes. On a
102
+ create timeout/5xx, inspect scoped campaign IDs and creation times before retrying.
103
+ For an uncertain import, a complete live membership read establishes what is
104
+ missing; malformed, unavailable or incomplete membership stops the import.
105
+ Keep manifests, hashes and carry-over files through recovery.
106
+
107
+ ## Senders, sequence and payload checks
108
+
109
+ Specify exactly one of `campaign.email_list` (owned exact addresses) or
110
+ `campaign.sender_domains` (owned cold domains). Named missing/inactive accounts
111
+ fail. Domain-selected accounts are sorted and may be limited by
112
+ `max_sending_accounts`. The launcher excludes `egbe.app` and `egbe.dev` trust
113
+ domains and fails if no eligible sender remains. This is a client-side safeguard;
114
+ the shared account listing is not a server-side proof of sender ownership.
115
+
116
+ Use a true sender identity. `reply_policy.sender_name` or `sender_name` takes
117
+ precedence over the selected account's recorded name; the code does not infer a
118
+ person from an email local part. If `{{senderName}}` is used, an explicit or
119
+ recorded account name is required. It is compiled once, not per sending account:
120
+ with rotating senders verify it is truthful for every mailbox (the launcher
121
+ warns). Unknown names must not be invented.
122
+
123
+ Plain text bodies become Instantly editor-native HTML: each line is a `<div>`,
124
+ blank lines are `<div><br /></div>`. Markdown links and bare URLs are rendered
125
+ with run UTMs in hrefs, while visible text stays readable. Review the rendered
126
+ output rather than manually copying unrendered spec text to provider PATCH.
127
+
128
+ Empty subjects on later steps continue the preceding thread; a nonempty subject
129
+ chooses a new thread. Either is supported. `delay_days` is the wait before that
130
+ step; the launcher maps it to the preceding provider step's delay. A delay on
131
+ step one is ignored with a warning; use the campaign schedule for a delayed start.
132
+ The final provider delay has no following step.
133
+
134
+ Used merge variables must resolve for every new lead. Missing/unresolved values
135
+ are payload errors; unusual capitalization, short names or long company names
136
+ are review warnings, not proof that real data is invalid. Exact title/credential
137
+ tokens used as first names (such as Dr or CA) are rejected unless the actual name
138
+ has been checked and marked `first_name_confirmed: true`. No merge token, fixed
139
+ sequence length or first-message link ban is required. Placeholder CTA URLs
140
+ (`example.com`, `*.example`, unreplaced product/instance tokens) still fail.
141
+
142
+ `campaign.daily_limit` is an explicit positive campaign-wide cap, not a minimum
143
+ recommended volume or inferred per-mailbox capacity. Validate the selected
144
+ schedule, nonempty sending days and timezone. The launcher maps its known
145
+ `America/New_York` alias to `America/Detroit` with a warning because of the
146
+ provider's enum; a valid IANA zone alone does not prove provider acceptance.
147
+ Read back the campaign's actual schedule and sender assignment.
148
+
149
+ `open_tracking` and `link_tracking` default off; either can be explicitly set.
150
+ `stop_on_reply`, `stop_on_auto_reply` and `insert_unsubscribe_header` default
151
+ true. Activation requires confirmed readback of the configured safeguards;
152
+ missing readback is not success. Known opt-outs and unknown project history also
153
+ block unsafe import/send/activation; see [reply handling](reply-handling.md).
154
+
155
+ ## Import verification
156
+
157
+ Source status is not import verification. By default the launcher uploads with
158
+ verification enabled and waits before activation. It reads campaign
159
+ `lead_stats`, falling back to per-lead `verification_status` across the whole
160
+ campaign; imported but not yet visible leads remain pending. Valid is status 1;
161
+ -1 is invalid; 11/12 pending; other verification codes count as invalid/risky.
162
+ Missing/null read surfaces are not a successful zero.
163
+
164
+ Current execution settings (these are adjustable client defaults, not market
165
+ success thresholds):
166
+
167
+ | Setting | Current default / meaning |
168
+ | --- | --- |
169
+ | `verify_leads_on_import` | true; asks provider to verify |
170
+ | `wait_for_verification` | true; blocking wait gate, distinct from requesting verification |
171
+ | `max_invalid_lead_pct` | 5 percent invalid/risky; records rejected IDs/addresses |
172
+ | `verification_timeout_minutes` | 45 |
173
+ | `verification_stuck_polls` | 8 unchanged polls |
174
+ | `allow_unverified_activation` | false; explicit override of incomplete verification, not other safeguards |
175
+
176
+ The older `verify_leads` field is a fallback for the two verification flags.
177
+ Do not change either flag as an automatic workaround. Pending/unread verification
178
+ normally leaves the campaign unactivated with exit 2 and
179
+ `verification_pending` / `verification_unread` in the launch result.
180
+ Read `launch-summary.json` and `state/verification-state.json`; rerun the same
181
+ run when its state can be checked. A readable empty provider lead list after an
182
+ import is an import failure, not merely a stuck verifier.
183
+
184
+ If the invalid percentage exceeds the configured value, inspect
185
+ `state/invalid-leads.json`. After deliberately removing unwanted entries from
186
+ the source list, a rerun attempts eligible deletion and records
187
+ `state/deleted-leads.json`, removes deleted entries from carry-over, then
188
+ rechecks the whole campaign. Failed/unknown cleanup blocks activation.
189
+
190
+ Success requires provider readback: activation response alone does not establish
191
+ that the campaign is active. Inspect `activation.confirmed`, `launch_status`,
192
+ verification outcome and safeguard readbacks. Creating a draft is not sending.
193
+ A preparation-only rerun is not itself a pause request: inspect `actual_state` /
194
+ `campaign_status`, not the absence of a new activation request. Confirmed-refusal
195
+ protection still applies when membership is unreadable. Its attempts and readbacks
196
+ remain in `opt_out_stop_results` even if the launcher subsequently exits with an error.
197
+
198
+ ## Narrow cleanup and correction
199
+
200
+ These existing gateway operations are project-scoped; foreign objects return
201
+ 404. Do not bypass a refusal by directly calling Instantly.
202
+
203
+ - `DELETE /campaigns/{id}`: only draft status 0 with demonstrated zero sends.
204
+ Returns 409 `campaign_not_draft`, `campaign_has_sends` or
205
+ `campaign_sends_unknown` otherwise.
206
+ - `DELETE /leads/{id}`: only never-contacted leads. Activity counters/timestamps
207
+ or nonzero interest block with `lead_contacted`; absent activity evidence
208
+ blocks with `lead_contact_unknown`. A status label alone is insufficient.
209
+ - `PATCH /leads/{id}`: only first/last name, company, website, personalization
210
+ and custom variables. Changing email/campaign/status is unsupported.
211
+ - Pause an owned campaign that has sent; retain its replies and history.
212
+
213
+ Campaign delete and lead patch consume update quota. Lead deletion uses its own
214
+ resource (Registry default 500/day); project configuration controls the current
215
+ limit. Pause is not blocked by campaign-update quota. A cleanup timeout/5xx may
216
+ already have changed the provider: read back before repeating. Cleanup is not
217
+ recipient suppression and does not erase confirmed opt-out events.
218
+
219
+
220
+ ## Recipient exclusion
221
+
222
+ Relative to `$OS_URL/outreach/instantly`:
223
+
224
+ - `GET /campaigns/{campaign_id}/leads/{lead_id}/exclusion` reads fresh owned
225
+ evidence. It is available with `outreach:read` / project read access.
226
+ - `POST` to the same resource accepts only `{"intent":"confirmed_opt_out"}`.
227
+ It requires existing privileged outreach writer access; read-only keys cannot
228
+ mutate. The bundled client exposes `getRecipientExclusion` and `excludeRecipient`.
229
+
230
+ Tools checks Registry campaign ownership before native lead access and verifies
231
+ ID/campaign identity. In the supported profile it sets only native
232
+ `lt_interest_status=-1` via exact lead-ID PATCH and verifies Completed (3) /
233
+ Not Interested (-1). Reply/contact/history data remain retained. Existing generic
234
+ lead PATCH stays limited to personalization. This safety operation, like scoped
235
+ pause, is independent of the ordinary campaign-update quota.
236
+
237
+ Inspect `state`: `confirmed` is observed native main-sequence exclusion;
238
+ `eligible` is a GET result that still needs action; `unsupported`, `rejected` and
239
+ `unknown` do not authorize resuming. `scope`, `observed_at`, `lead_status`,
240
+ `interest_status` and `write_attempted` describe the bounded observation, not
241
+ permanent suppression. The initial profile requires complete empty subsequences,
242
+ automation and webhook collections; an omitted lead attachment field by itself
243
+ is insufficient. Global collection details are never returned to the project.
244
+
245
+ There is no fallback to email-based interest updates (which can propagate to
246
+ other campaigns), a global blocklist, deletion or activation. A timeout/5xx may
247
+ follow a committed PATCH: use GET for recovery before considering another write.
248
+ Neither the client nor Tools automatically retries that write. HTTP success
249
+ without `state: confirmed` is not proof. Read failures expose safe status and
250
+ bounded numeric `retry_after` where available, without provider response bodies.
251
+ The shared request deadline is 22 seconds, including ownership; native attempts
252
+ are bounded to 5 seconds each. This does not cancel queued/in-flight mail or
253
+ qualify active subsequences; retain containment for unverified cases.
254
+
255
+ `listLeadRows` and `listLeadEmails` follow native continuation even on short pages,
256
+ reject invalid identity/duplicate IDs/repeated cursors and report incomplete reads
257
+ as `ok: false`. Multiple same-email IDs are retained and assessed individually.
258
+ Legacy responses without an explicit cursor use last-ID continuation on full
259
+ pages; they do not gain a recipient-exclusion exception without new semantic
260
+ readback. The old/new server transition therefore remains contained.
@@ -0,0 +1,188 @@
1
+ # Observation, protection and scheduling
2
+
3
+ ## Collect facts for one run
4
+
5
+ ```bash
6
+ node "$SKILL_DIR/scripts/monitor-campaign.js" --run-dir "$RUN_DIR" --env-file "$RUN_DIR/.env"
7
+ node "$SKILL_DIR/scripts/conclude-campaign.js" --run-dir "$RUN_DIR"
8
+ node "$SKILL_DIR/scripts/outreach-report.js" --run-dir "$RUN_DIR" --run-key RUN_KEY --mode summary
9
+ ```
10
+
11
+ Monitor reads only the manifest campaign, writes `monitor-summary.json` and
12
+ appends cumulative snapshots to `state/analytics-history.json`. It preserves
13
+ source/quality and `metrics_observed_at` separately from packaging
14
+ `generated_at`. Do not sum cumulative snapshots or call a newly packaged old
15
+ snapshot fresh evidence.
16
+
17
+ For mailbox state and warmup, use the [assigned sender read](instantly-ops.md#read-assigned-sender-state).
18
+ It is available to regular and read-only project keys; it does not install a
19
+ warmup-based pause control in the bundled monitor.
20
+
21
+ `outreach-report` reads project SQLite and returns a JSON array of rows.
22
+ Modes are `summary`, `leads`, `queue` and `events`, with optional `--limit`,
23
+ `--run-key` and `--db`. `--run-dir` selects the project DB; add `--run-key`
24
+ when you need a particular run, because the DB contains multiple runs.
25
+ The summary attributes confirmed refusals to the run where they were received,
26
+ without counting repeated confirmations twice. The leads view separately exposes
27
+ project-wide `opt_out_confirmed`; this is not proof that provider sending stopped.
28
+
29
+ Current derived reply/bounce/unsubscribe/spam/open rates use a campaign-scoped
30
+ unique `contacted_count` as denominator, expressed in percent. Keep raw numerators
31
+ and that definition with any comparison. Positive reply count is a provider
32
+ classification, not proof of qualified demand. Step-reply values are counts,
33
+ not automatically rates; the last step is not assumed to be a breakup.
34
+
35
+ Analytics and campaign-filtered overview fill missing fields independently;
36
+ missing complaint data does not erase readable zero bounces. Field sources are
37
+ recorded in `_field_sources` and retained in conclusion quality details. A
38
+ complete observation can still have missing metrics; each rate needs its own
39
+ readable numerator and a trustworthy denominator.
40
+
41
+ Instantly's raw `contacted_count` can exceed campaign membership or conflict
42
+ with sending activity. The monitor retains that raw value for diagnosis and
43
+ recovers unique contacts only from a complete, identity-consistent lead read
44
+ with known contact activity that agrees with cumulative
45
+ `new_leads_contacted_count`. Present membership alone does not establish the
46
+ historical population: a mismatch, partial read or unknown activity leaves the
47
+ denominator unavailable. This does not prove workspace-wide data leakage.
48
+
49
+ Unknown metrics stay unknown. An email-list fallback is a bounded partial
50
+ sample and cannot supply complete bounce/spam/open signals or trustworthy
51
+ rate denominators. It is used when analytics is unavailable, or when actual
52
+ messages contradict the established all-zero/degraded analytics signature;
53
+ sampled replies are never merged into otherwise complete campaign totals.
54
+ A scoped zero recipients/zero events observation means no data yet, not an API
55
+ outage. Tracking disabled means no measured opens, not a measured zero.
56
+
57
+ The collector `conclude-campaign.js` packages the latest snapshot as
58
+ `conclusion.json` for the existing GTM consumer. The filename is retained,
59
+ but collection does not finish a campaign or wait for a prescribed sequence age.
60
+ It preserves identity/attribution, observation time/window, counters,
61
+ denominators, partial/unknown/scope limitations and missing fields. It does not
62
+ compute a verdict, fabricate lessons, change DB lifecycle to concluded, or infer
63
+ cohort maturity from the launch date. `--force` does not refresh stale data or
64
+ improve quality. Put the actual interpretation and accepted action in the
65
+ existing plan/result, not a second assessment JSON.
66
+
67
+ For product-side outcomes, use the OS analytics capability when available and
68
+ the run's `utm_source=instantly`, `utm_medium=email`,
69
+ `utm_campaign=<run_key>`. Read canonical product event names from
70
+ `/analytics/events`; do not invent run-specific conversion names or claim this
71
+ collector automatically retrieves product events. A reply counter and a product
72
+ action are different observations.
73
+
74
+ ## Configured operational protection
75
+
76
+ Protection is separate from business evaluation. `monitoring.autopause_on_risk`
77
+ defaults true. Activation requires a valid explicit
78
+ `monitoring.thresholds.max_bounce_rate` (percentage 0–100).
79
+ `max_spam_complaint_rate` is optional and should be configured only when its
80
+ signal is available. The bundled monitor compares cumulative campaign bounce/spam
81
+ counts to unique `contacted_count`, as percentages, using strictly `>` with no
82
+ minimum sample. Use the run's accepted thresholds; the code supplies no universal
83
+ marketing threshold.
84
+
85
+ The bundled monitor has no configurable sent-message denominator, calendar-day
86
+ bounce-count gate, assigned-sender warmup status/score gate or timed missing-signal
87
+ grace period. Sender selection checks account activity, not ongoing warmup health.
88
+ Available reads or extra `run-spec.json` keys do not implement those controls.
89
+ Identify unsupported required conditions explicitly; do not represent a different
90
+ supported check as equivalent.
91
+
92
+ `monitor-summary.json.protection.active` means the supported threshold configuration
93
+ validates, not that autopause is enabled, every requested condition is enforced,
94
+ or scheduled observation is running. Keep these distinctions when reporting readiness.
95
+
96
+ With protection enabled, a configured threshold exceeded or a required signal
97
+ unavailable after bounded read attempts/fallbacks triggers scoped protective
98
+ pause. Missing configuration is not a healthy monitor result; it blocks
99
+ automatic activation and surfaces as a configuration risk on an existing run.
100
+ Explicitly disabling autopause is a run choice, not an accidental consequence
101
+ of an omitted field.
102
+
103
+ Open rate never triggers pause. The supported Instantly campaign analytics
104
+ routes currently expose no complaint/spam counter. An unconfigured complaint
105
+ threshold is listed as not monitored. If the run explicitly requires it and
106
+ the signal is absent, `spam_unavailable` still triggers protection; changing
107
+ that requirement needs the run's authorized decision. Refreshing this skill
108
+ does not change thresholds or resume a paused campaign. Partial/unknown required
109
+ signals cannot clear an earlier risk. No-recipient/zero-count observations skip
110
+ rate evaluation without declaring an outage.
111
+
112
+ Pause success requires readback. `pause_action` is an attempt;
113
+ `pause_failed` or unconfirmed readback requires attention. Already-paused,
114
+ draft and completed campaigns are not repeatedly paused. Alert state in
115
+ `state/monitor-alerts.json` distinguishes new/repeated incidents. A confirmed
116
+ operator resume acknowledges a prior numeric gate, not unknown data; material
117
+ worsening/new complaints/new gates can alert and pause again. Do not remove
118
+ the checkpoint just to suppress an alert.
119
+
120
+ Throughput compares comparable full snapshots against the run's explicit daily
121
+ cap. `monitoring.min_daily_capacity_pct` is optional; absent configuration or
122
+ incomplete metrics means no automatic throughput judgment. The monitor does
123
+ not auto-pause merely for slow sending or automatically increase spending,
124
+ mailboxes or recipients. Treat diagnostic hints as checks, not proven causes.
125
+
126
+ ## Optional scheduler installation
127
+
128
+ Use scheduled workers only for the agreed operating arrangement. Manual
129
+ observation remains possible; record who handles observation and replies.
130
+ Installing a scheduler is not part of every operation, and four jobs are not
131
+ universally required.
132
+
133
+ ```bash
134
+ node "$SKILL_DIR/scripts/install-crons.js" --check-scheduler --scheduler openclaw
135
+ node "$SKILL_DIR/scripts/install-crons.js" --run-dir "$RUN_DIR" --scheduler openclaw \
136
+ --deliver-channel slack --deliver-to channel:CHANNEL_ID
137
+ node "$SKILL_DIR/scripts/install-crons.js" --run-dir "$RUN_DIR" --scheduler cron
138
+ node "$SKILL_DIR/scripts/install-crons.js" --run-dir "$RUN_DIR" --scheduler cron --remove
139
+ ```
140
+
141
+ These commands create/remove recurring external work when actually run; choose
142
+ them explicitly. `--dry-run` previews installer output, not live sourcing or
143
+ campaign execution. Credentials are read from the private run snapshot, never
144
+ embedded in scheduler entries; explicit `--env-file` supplies them without
145
+ modifying that source file. The installer enforces run `.env` permissions.
146
+
147
+ - `openclaw` (default) runs agent turns. It needs a deliver-channel/to pair
148
+ (CLI or `notifications` config), or explicit `--no-chat-delivery`; isolated
149
+ jobs have no implicit last chat. It selects the agent owning the run workspace,
150
+ else the host default; `--agent` selects explicitly. Review recorded agent
151
+ identity before reinstall/moving a run.
152
+ Reply turns read the current project email method and plan before content
153
+ decisions; technical references govern queue/send execution.
154
+ - `cron` runs Node directly on an always-on host, in the host timezone.
155
+ Reply collection is not reasoning or automatic reply handling. Identify the
156
+ person/agent that reads the queue; a sleeping laptop is not an always-on host.
157
+ - The Unix scheduler check executes a temporary harmless probe and removes it.
158
+ Default wait is 75 seconds; the accepted override
159
+ `--scheduler-check-timeout-seconds` is 65–120. A writable crontab alone is
160
+ insufficient evidence of execution.
161
+
162
+ The current installer includes reply and monitor jobs. OpenClaw uses the sending
163
+ window plus one hour before/two hours after, on campaign days/timezone:
164
+ reply hourly at :05, monitor at :15. If no usable schedule exists it records the
165
+ 24/7 UTC fallback. Direct Unix cron uses hourly host-time cadence.
166
+
167
+ Replenishment is installed only for `lead_replenishment.enabled: true`, every
168
+ two hours at :45; the operation itself enforces the configured cooldown/bounds.
169
+ A factual-export job is added only when `monitoring.snapshot_schedule` is
170
+ provided. Its cadence is explicit, not a claim that a test is ready for a verdict.
171
+
172
+ Registration is scoped by `instantly-<run_key>-<job>` and exact run directory.
173
+ OpenClaw reuses/edits existing job IDs and removes jobs omitted from the new
174
+ configuration, verifying their exact run directory and removal. Unix cron replaces
175
+ only this run's marked block and preserves unrelated entries. The installer rereads registration and
176
+ records verified IDs/settings in `cron-install.json` and manifest `cron_jobs`.
177
+ Registration readback is not evidence that every later tick or reply succeeded.
178
+
179
+ Installation failure returns nonzero, with `installed: false` and manual
180
+ commands/cadences when supported. Do not announce automation as working then.
181
+ Before switching schedulers, remove through the recorded scheduler and verify
182
+ removal. The receipt supports removal even if the manifest is damaged; keep it
183
+ until removal is confirmed. `launchd` is not supported.
184
+
185
+ Direct cron ticks use per-job locks and bounded execution; inspect
186
+ `cron-<job>.log`. Stale locks fail closed. Verify no tick/installer is alive
187
+ before removing only the identified stale lock and retrying. Keep one executor
188
+ and the same absolute bundle/run/Node paths on the scheduler host.