@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,57 @@
1
+ # Reddit execution records
2
+
3
+ Keep requests, IDs and evidence beside the relevant campaign, normally
4
+ `egbe-docs/marketing/campaigns/reddit/<campaign>/`. Reference existing input
5
+ records when available; no research, strategy or report package is required.
6
+
7
+ Through the Egbe connector without a project folder, keep these records at the
8
+ same paths in Egbe's artifact store, as `egbe-os-quickstart` →
9
+ `references/artifact-sync.md` ("Through the Egbe connector") describes. Save a
10
+ write's request record there before sending the write.
11
+
12
+ Before campaign creation save its `create_idempotency_key` and exact
13
+ `create_payload` in `campaign-state.json`. Retain every attempt's endpoint,
14
+ time, response/error and unknown outcome. Save returned IDs immediately.
15
+ Child requests/keys also need recovery records, but their success caches are
16
+ not durable campaign-create recovery. Do not store credentials.
17
+
18
+ The state retains `channel: reddit`, observed operational `status` and
19
+ `objects.campaign_id`, `ad_group_ids`, `ad_ids`, plus post IDs for creative
20
+ operations. Retain budget units, destination and selected parent mappings where
21
+ relevant. A status or campaign-only pause needs no creative/research package.
22
+
23
+ `launch-readback.json` records timezone-aware `observed_at`, `campaign`,
24
+ `ad_groups` and `ads`: exact `id`, provider `configured_status` and
25
+ separate effective/delivery/rejection fields. Save parent IDs when returned
26
+ and retain raw responses; do not infer missing fields.
27
+
28
+ ## Activation evidence
29
+
30
+ A new attempt records `activation.started_at` and `accepted_mutations`.
31
+ For each accepted status request save the returned `object_type`
32
+ (`campaign`, `ad_group` or `ad`), `object_id`, `requested_status`,
33
+ `mutation_accepted` and `mutation_accepted_at`. Readback must follow those
34
+ receipts. Do not reuse receipts from an earlier pause/launch cycle.
35
+ Pending attempts retain actual reads and `status: activation_pending`
36
+ without a new successful launch/restart timestamp. Read-only observation can
37
+ describe already ACTIVE configuration, but cannot establish a new activation.
38
+
39
+ ## Optional local check
40
+
41
+ ```bash
42
+ python3 scripts/validate-reddit-artifacts.py --product-root <repo> \
43
+ --campaign-path egbe-docs/marketing/campaigns/reddit/<campaign> \
44
+ --campaign-id <exact-id> --phase pause
45
+ ```
46
+
47
+ Phases: `build-paused`, `launch-ready`, `launch`, `status`,
48
+ `monitoring`, `pause`. The check verifies saved ID/status/timestamp integrity
49
+ and current-attempt activation evidence, not live freshness, ownership, consent
50
+ or a business verdict. Pause checks the campaign is non-serving, not that every
51
+ child's configured status changed. No narrative report is required.
52
+
53
+ Preserve supplied durable business/product/launch/experiment/variant IDs and
54
+ UTM mapping; do not substitute scheduler IDs. Keep any used index consistent
55
+ with the selected exact IDs. Save confirmed stop time/reason without replacing
56
+ history with planned deadlines. Project versioning practices apply, but a
57
+ missing commit or report never prevents stopping spend.
@@ -0,0 +1,64 @@
1
+ # Reddit status, diagnostics and pause
2
+
3
+ Read the exact campaign ID and requested fields directly; no lifecycle/report
4
+ package is required. Metrics and diagnostics are read operations. Use the
5
+ relevant write endpoint only for an authorized change.
6
+
7
+ Read `/ads/reddit/campaigns/{id}/results`, direct campaign/group/ad readback
8
+ and separately attributed product analytics as relevant. Preserve query bounds,
9
+ report timezone, pagination and observation times. Configured ACTIVE, provider
10
+ approval and actual reported traffic are separate observations.
11
+
12
+ ## Destination availability
13
+
14
+ Make a direct HTTP GET to the recorded URL including UTMs, without OS credentials.
15
+ Set `DESTINATION_URL` to that URL and run:
16
+
17
+ ```bash
18
+ curl --silent --show-error --location --max-redirs 5 \
19
+ --connect-timeout 5 --max-time 15 --output /dev/null \
20
+ --write-out 'http_status=%{http_code}\nfinal_url=%{url_effective}\n' \
21
+ "$DESTINATION_URL"
22
+ ```
23
+
24
+ Use this HTTP check, not a paid actor/crawler. A timeout or blocked request is
25
+ inconclusive, not confirmed downtime. HTTP success alone proves neither tracking
26
+ nor the product journey. Apply the current task's stop conditions and authority.
27
+
28
+ ## Sparse or flat delivery
29
+
30
+ Read `/ads/reddit/account`: check `provider_account.available`, individual
31
+ field availability, timezone, approval/suspension and separate funding readback.
32
+ Then read selected campaign/groups/ads by ID; retain configured/effective/
33
+ delivery status and rejection reasons, including disagreements.
34
+
35
+ Compare fully paginated reports using returned date/hour buckets and freshness
36
+ fields; see [API](api-reference.md). Distinguish last reported nonzero bucket,
37
+ provider update time and observation time. A later report may show renewed
38
+ delivery without explaining a quiet interval; a current parent pause does not
39
+ explain an earlier ACTIVE period. `modified_at` is not necessarily a
40
+ status-change time. Unknown metrics are not zero.
41
+
42
+ If no causal reason or budget-reset evidence is exposed, give Egbe the exact
43
+ IDs, query/returned bounds and timestamped facts for the account owner's history
44
+ check. Do not diagnose auction loss, outage or reset from ACTIVE plus underspend.
45
+ Diagnostic access does not authorize budget changes, toggles, replacements or
46
+ restarting a recorded stop.
47
+
48
+ ## Pause
49
+
50
+ Use `POST /ads/reddit/campaigns/{campaign_id}/pause` for an authorized campaign
51
+ stop. Pause selected groups/ads via their status routes when that is the requested
52
+ scope. Read each affected object by exact ID. A paused parent can prevent delivery
53
+ while children stay configured ACTIVE; report that accurately. Do not delete or
54
+ archive as a substitute.
55
+
56
+ Save accepted mutations and actual confirmation time. Failed pause or stopped
57
+ monitoring alone is not confirmed campaign termination. Preserve the known stop
58
+ reason and evidence; if unavailable, say unknown. Do not infer a reason from a
59
+ later balance/deadline or copy a scheduled boundary into factual timestamps.
60
+ Missing results, research or reports never block stopping spend.
61
+
62
+ These operations do not install a monitoring job or scheduled pause. Use
63
+ [launch](../workflows/launch.md) for pending activation confirmation without
64
+ repeating accepted writes.
@@ -0,0 +1,49 @@
1
+ # Reddit Pixel And Product Analytics
2
+
3
+ Reddit pixel tracking and OS product analytics are separate systems.
4
+
5
+ OS analytics is the source of truth for product funnel events. Reddit custom
6
+ events are channel-side mappings used for ad-network optimization.
7
+
8
+ ## Canonical Event Source
9
+
10
+ Read when configuring product-event tracking:
11
+
12
+ ```bash
13
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics/skill" -s
14
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics/events" -s
15
+ ```
16
+
17
+ Do not create new product event names for Reddit. Use canonical events such as
18
+ `signup_completed`, `activated`, and `purchase`, with Reddit-specific details in
19
+ UTMs and payload fields.
20
+
21
+ ## Reddit Event Mapping
22
+
23
+ When Reddit needs product-scoped custom events, map canonical events to a
24
+ channel-side name:
25
+
26
+ | Product event | Reddit custom event example |
27
+ |---|---|
28
+ | `signup_completed` | `Signup_<product_slug>` |
29
+ | `purchase` | `Purchase_<product_slug>` |
30
+
31
+ The mapping must be recorded in campaign artifacts.
32
+
33
+ ## Pixel Placement
34
+
35
+ Install the Reddit Pixel base snippet in the shared marketing layout that covers
36
+ landing, signup, checkout, and conversion pages. Installing it only on the
37
+ landing page is insufficient.
38
+
39
+ Fire `rdt('track', '<event_name>')` only after the conversion action succeeds,
40
+ for example on signup success or purchase confirmation.
41
+
42
+ ## Tracking evidence
43
+
44
+ Record separately whether the pixel is installed, the expected product-scoped
45
+ event is observed, and product analytics is available. A pixel ID required by
46
+ the ad-group API does not prove website tracking works. Missing event readback
47
+ does not authorize changing the requested objective. Report the limitation,
48
+ and do not claim observed
49
+ conversion tracking from source code or synthetic events alone.
@@ -0,0 +1,19 @@
1
+ # Reddit execution constraints
2
+
3
+ - Use OS and owned exact IDs; ownership failure is not permission to mutate.
4
+ - Build PAUSED; campaign activation does not cascade to children.
5
+ - Campaign creation has durable same-key/same-payload recovery; child-create
6
+ success caches are short-lived. Preserve uncertainty and read before retrying.
7
+ - Ad-group creation reserves `ceil(goal_value / 10000)` USD cents before the
8
+ provider call, including PAUSED groups. A hold is not spend and is not
9
+ multiplied by scheduled days.
10
+ - Update rejects `goal_value`/`goal_type` because it does not refresh the
11
+ hold. No in-place budget update is available. Do not automatically create a
12
+ replacement to change budget.
13
+ - Update rejects `configured_status`; use the status route so Registry's
14
+ status/hold bookkeeping stays synchronized.
15
+ - Community relevance is not Ads eligibility or forecast reach. Use current
16
+ returned interest IDs; no validate-only group endpoint is exposed.
17
+ Never create real objects merely to learn a schema.
18
+
19
+ See [API](api-reference.md) for units, payloads and retries.
@@ -0,0 +1,14 @@
1
+ # Reddit attribution
2
+
3
+ Read `/analytics/events` and the product tracking contract. Use canonical product
4
+ events, not channel-specific product names; preserve Reddit mappings separately.
5
+ Do not generate synthetic conversion events as readiness proof.
6
+
7
+ Destination URLs retain `utm_source=reddit`, `utm_medium=paid_social`,
8
+ stable `utm_campaign=<campaign slug/id>` and meaningful `utm_content`.
9
+ Keep product details in event payloads; no secrets or personal identifiers in UTMs.
10
+
11
+ Read Reddit delivery/click/spend metrics and product campaign visits/funnel
12
+ events separately. Compare compatible windows/attribution scope. Missing or
13
+ delayed product data is not zero, and site-wide totals are not campaign results.
14
+ Reddit comments, clicks and reactions are not product conversion events.
@@ -0,0 +1,35 @@
1
+ # Build paused Reddit objects
2
+
3
+ Use the requested configuration and [API payloads](../runtime/api-reference.md).
4
+ Inspect account, funding, wallet and recorded IDs. Reuse confirmed objects from
5
+ this operation; do not recreate them to repair documents.
6
+
7
+ Before campaign create, persist its exact request and stable `Idempotency-Key`
8
+ (1–128 nonblank characters) in [execution records](../runtime/artifacts.md).
9
+ Send the saved key on every retry. Create PAUSED via `/ads/reddit/campaigns`;
10
+ save its ID before creating selected missing groups, posts and ads.
11
+ Retain each child's request/key/ID too, but child keys have only a short-lived
12
+ success cache, not durable recovery.
13
+
14
+ Read campaign/groups/posts/ads by ID. Verify parent links, budget units,
15
+ targeting, destination and paused state against the authorized inputs. Save partial state
16
+ immediately on failure, keeping it paused. No minimum creative count applies.
17
+
18
+ ## Recovery
19
+
20
+ Same-key/same-payload campaign replay resumes saved registration/accounting.
21
+ For `operation_in_progress`, wait before the same request.
22
+ For `reddit_campaign_create_not_sent` or explicit provider 429, retry with
23
+ backoff and any `retry_after`.
24
+ For `reddit_campaign_create_outcome_unknown`,
25
+ `reddit_campaign_create_readback_invalid` or
26
+ `idempotency_key_payload_conflict`, preserve the record and request Egbe
27
+ reconciliation. Never bypass uncertainty with a fresh key/replacement.
28
+
29
+ For ambiguous child writes, inspect saved IDs and provider readback first.
30
+ Empty owned lists do not prove no create occurred; unresolved identity needs
31
+ reconciliation. Never probe real creates for schema discovery.
32
+
33
+ Targeting repair uses the known group's update route with complete intended
34
+ writable settings. Budget changes are not supported there; do not silently
35
+ replace the group. Build remains separate from activation.
@@ -0,0 +1,19 @@
1
+ # Read-only Reddit launch checks
2
+
3
+ Read selected campaign/groups/posts/ads by exact ID. Compare parent links,
4
+ paused state, targeting, budget, media and destination to the authorized inputs.
5
+ Check funding and measurement needed for its objective. Preserve requested and
6
+ observed values. Do not create, repair, activate or replace objects here.
7
+
8
+ Missing research/autonomy files are not blockers. Missing IDs, inconsistent
9
+ configuration, unavailable readback and unusable destinations are concrete
10
+ blockers. Use [build](build-paused.md) for separately authorized repair.
11
+
12
+ ## Moderation is separate
13
+
14
+ `PENDING_APPROVAL` alone is not configuration failure or evidence of delivery.
15
+ The API does not establish when review progresses on pause. Once checks pass
16
+ and activation is authorized, pending moderation alone does not require
17
+ indefinite waiting. Delivery/charges may begin after approval. Explicit
18
+ approval-before-launch conditions still apply; paused-only work never permits
19
+ activation. Never bypass rejection/restrictions. See [launch](launch.md).
@@ -0,0 +1,32 @@
1
+ # Activate or resume Reddit objects
2
+
3
+ Resolve selected IDs and current authorization; refresh
4
+ [read-only checks](launch-ready.md). Activation creates/replaces nothing.
5
+
6
+ For a new attempt preserve `activation.started_at` and a fresh
7
+ `accepted_mutations` list; follow-ups continue that attempt.
8
+ Activate the campaign if needed via `/ads/reddit/campaigns/{id}/launch`, then
9
+ selected groups/ads via their raw `/status` routes using
10
+ `{"status":"ACTIVE"}` without a `data` wrapper. Campaign launch does not
11
+ cascade. Skip already ACTIVE objects; never activate unselected siblings.
12
+
13
+ Persist receipts immediately (campaign: `data.raw`; children: `data`).
14
+ HTTP success with `activation_confirmed:false` is not confirmation.
15
+ Read each object and retain configured/effective/delivery status, rejection
16
+ reason and timestamps. ACTIVE is not moderation approval or actual traffic.
17
+
18
+ Report new successful activation only after current-attempt acceptance evidence
19
+ and ACTIVE readback of every selected object. If everything was already ACTIVE
20
+ and no write was made, say "already configured active"; invent no restart time.
21
+
22
+ ## Pending confirmation
23
+
24
+ After acceptance, do not repeat the write because readback lags. Save
25
+ `status: activation_pending`, receipts and reads, without a new successful
26
+ launch/restart timestamp. A timeout without acceptance is uncertain: read first.
27
+
28
+ Arrange follow-up only through an available mechanism when covered by the task.
29
+ Preserve attempt identity and agreed boundaries, honor Retry-After and bounded
30
+ retries, and do not busy-poll moderation. If no scheduler was installed, say so.
31
+ Waiting does not extend authorization, budget or time. A status-only read can
32
+ establish current configuration but not when a past activation happened.
@@ -0,0 +1,9 @@
1
+ # Reddit access/funding inspection
2
+
3
+ Read `GET /ads/reddit/account` and profiles/funding/provider-account fields
4
+ described in [API](../runtime/api-reference.md). Preserve field availability
5
+ and account/report timezone differences. Unknown details are not zero/unlimited.
6
+
7
+ Before a proposed build, confirm owned parents, usable funding/profile,
8
+ required pixel ID and wallet affordability. Status/pause needs only the selected
9
+ owned IDs. Inspection never authorizes writes.
@@ -0,0 +1,178 @@
1
+ #!/usr/bin/env bash
2
+ # Ad Creative Capture Script
3
+ # Captures HTML ad creatives as PNG images at exact dimensions
4
+ #
5
+ # Usage: capture-ad.sh <html-file> <png-file> <width> <height> [--keep-html]
6
+ #
7
+ # By default, removes the HTML file after successful PNG capture.
8
+ # Use --keep-html to preserve intermediate HTML files for debugging.
9
+ #
10
+ # Renders HTML directly via headless Chrome — no agent intervention needed.
11
+
12
+ set -e
13
+
14
+ HTML_FILE="$1"
15
+ PNG_FILE="$2"
16
+ WIDTH="$3"
17
+ HEIGHT="$4"
18
+ KEEP_HTML=false
19
+
20
+ # Parse optional flags
21
+ shift 4 2>/dev/null || true
22
+ while [ $# -gt 0 ]; do
23
+ case "$1" in
24
+ --keep-html) KEEP_HTML=true ;;
25
+ *) echo "Warning: Unknown flag '$1' ignored" ;;
26
+ esac
27
+ shift
28
+ done
29
+
30
+ # Validate arguments
31
+ if [ -z "$HTML_FILE" ] || [ -z "$PNG_FILE" ] || [ -z "$WIDTH" ] || [ -z "$HEIGHT" ]; then
32
+ echo "Usage: $0 <html-file> <png-file> <width> <height> [--keep-html]"
33
+ echo ""
34
+ echo "Examples:"
35
+ echo " $0 ad-variant-a.html ad-variant-a.png 1200 627 # LinkedIn Feed"
36
+ echo " $0 slide-01.html slide-01.png 1080 1080 # Instagram/LinkedIn Square"
37
+ echo " $0 story-ad.html story-ad.png 1080 1920 # Stories (9:16)"
38
+ echo " $0 ad.html ad.png 1200 627 --keep-html # Keep HTML for debugging"
39
+ exit 1
40
+ fi
41
+
42
+ # Check if HTML file exists
43
+ if [ ! -f "$HTML_FILE" ]; then
44
+ echo "Error: HTML file not found: $HTML_FILE"
45
+ exit 1
46
+ fi
47
+
48
+ # Find a Chrome/Chromium binary that can do headless screenshots.
49
+ # CHROME_PATH, when set, names the executable and is the only candidate.
50
+ CHROME_BIN=""
51
+ CHROME_SEARCHED=()
52
+
53
+ try_chrome() {
54
+ CHROME_SEARCHED+=("$1")
55
+ if [ -f "$1" ] && [ -x "$1" ]; then
56
+ CHROME_BIN="$1"
57
+ return 0
58
+ fi
59
+ return 1
60
+ }
61
+
62
+ find_chrome() {
63
+ local candidate dir app name
64
+ if [ -n "${CHROME_PATH:-}" ]; then
65
+ try_chrome "$CHROME_PATH" && return 0
66
+ echo "Error: CHROME_PATH is not an executable file: $CHROME_PATH" >&2
67
+ echo "Set it to the browser executable, e.g. on macOS" >&2
68
+ echo " /Applications/Google Chrome.app/Contents/MacOS/Google Chrome" >&2
69
+ return 1
70
+ fi
71
+
72
+ # Linux: prefer the agent-browser bundled Chrome (real binary, not the shim)
73
+ for candidate in \
74
+ /opt/agent-browser/browsers/chrome-*/chrome \
75
+ /usr/bin/google-chrome \
76
+ /usr/bin/chromium \
77
+ /usr/bin/chromium-browser
78
+ do
79
+ try_chrome "$candidate" && return 0
80
+ done
81
+
82
+ # macOS: Chromium-based app bundles, system-wide then per-user
83
+ for dir in /Applications ${HOME:+"$HOME/Applications"}; do
84
+ for app in \
85
+ "Google Chrome" \
86
+ "Chromium" \
87
+ "Google Chrome Canary" \
88
+ "Microsoft Edge" \
89
+ "Brave Browser"
90
+ do
91
+ try_chrome "$dir/$app.app/Contents/MacOS/$app" && return 0
92
+ done
93
+ done
94
+
95
+ # Anything else on PATH (e.g. snap or Homebrew installs)
96
+ for name in google-chrome-stable google-chrome chromium chromium-browser; do
97
+ candidate=$(command -v "$name" 2>/dev/null) || candidate=""
98
+ try_chrome "${candidate:-PATH: $name}" && return 0
99
+ done
100
+
101
+ echo "Error: no usable Chrome/Chromium binary found. Searched:" >&2
102
+ printf ' %s\n' "${CHROME_SEARCHED[@]}" >&2
103
+ echo "Set CHROME_PATH to an installed Chrome/Chromium executable, or ask the user to install one." >&2
104
+ return 1
105
+ }
106
+
107
+ find_chrome || exit 1
108
+
109
+ # Resolve absolute paths
110
+ HTML_ABS=$(cd "$(dirname "$HTML_FILE")" && pwd)/$(basename "$HTML_FILE")
111
+ PNG_DIR=$(cd "$(dirname "$PNG_FILE")" 2>/dev/null && pwd) || PNG_DIR="$(pwd)"
112
+ PNG_ABS="$PNG_DIR/$(basename "$PNG_FILE")"
113
+
114
+ echo "=== Capture: ${WIDTH}x${HEIGHT} ==="
115
+ echo "HTML: $HTML_ABS"
116
+ echo "PNG: $PNG_ABS"
117
+ echo "Chrome: $CHROME_BIN"
118
+
119
+ # Throwaway profile: never touch (or wait on) the user's running browser profile
120
+ CHROME_PROFILE=$(mktemp -d "${TMPDIR:-/tmp}/capture-ad-chrome.XXXXXX")
121
+ trap 'rm -rf "$CHROME_PROFILE"' EXIT
122
+
123
+ # --no-sandbox: required when running as non-root in a Linux container; keep
124
+ # the sandbox on macOS desktops, where it works
125
+ SANDBOX_FLAGS=()
126
+ if [ "$(uname -s)" != Darwin ]; then
127
+ SANDBOX_FLAGS=(--no-sandbox)
128
+ fi
129
+
130
+ # Render HTML → PNG via headless Chrome
131
+ # --hide-scrollbars: don't include scrollbar in screenshot
132
+ # --disable-gpu: required in headless mode without display
133
+ # --use-mock-keychain: no macOS Keychain prompt (ignored elsewhere)
134
+ # --window-size: sets viewport to exact dimensions
135
+ "$CHROME_BIN" \
136
+ --headless \
137
+ "${SANDBOX_FLAGS[@]}" \
138
+ --disable-gpu \
139
+ --hide-scrollbars \
140
+ --disable-dev-shm-usage \
141
+ --user-data-dir="$CHROME_PROFILE" \
142
+ --use-mock-keychain \
143
+ --window-size="${WIDTH},${HEIGHT}" \
144
+ --screenshot="$PNG_ABS" \
145
+ "file://${HTML_ABS}" \
146
+ 2>&1 | grep -v -E '^\[.*ERROR:dbus|^\[.*WARN:|Failed to connect to the bus|CVDisplayLinkCreateWithCGDisplay|Trying to load the allocator multiple times' || true
147
+ # Filter above hides harmless noise: dbus/bus errors from containers without
148
+ # systemd, and macOS display-link/allocator messages from headless Chrome. If you ever need
149
+ # to debug a real Chrome failure, remove the filter temporarily to see the full
150
+ # stderr.
151
+
152
+ # Validate output
153
+ if [ -f "$PNG_ABS" ]; then
154
+ DIMS=$(file "$PNG_ABS" | grep -o '[0-9]* x [0-9]*' | head -1)
155
+ SIZE=$(stat -c%s "$PNG_ABS" 2>/dev/null || stat -f%z "$PNG_ABS" 2>/dev/null)
156
+ echo "Output: $PNG_ABS"
157
+ echo "Dimensions: $DIMS"
158
+ echo "Size: ${SIZE} bytes"
159
+ EXPECTED="${WIDTH} x ${HEIGHT}"
160
+ if [ "$DIMS" = "$EXPECTED" ]; then
161
+ echo "✓ Dimensions match target (${EXPECTED})"
162
+ else
163
+ echo "✗ WARNING: Expected ${EXPECTED}, got ${DIMS}"
164
+ exit 1
165
+ fi
166
+
167
+ # Cleanup HTML unless --keep-html
168
+ if [ "$KEEP_HTML" = false ]; then
169
+ rm -f "$HTML_ABS"
170
+ echo "Cleaned up: $(basename "$HTML_ABS")"
171
+ else
172
+ echo "HTML preserved: $HTML_ABS"
173
+ fi
174
+ else
175
+ echo "Error: PNG file not produced at $PNG_ABS"
176
+ echo "HTML preserved for debugging: $HTML_ABS"
177
+ exit 1
178
+ fi