@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,163 @@
1
+ ---
2
+ name: egbe-os-google-ads
3
+ description: Inspect and operate Google Search campaigns, keywords, ads, targeting, budgets and conversion measurement through Egbe OS.
4
+ metadata:
5
+ egbe-when: "Use for Google Search advertising and existing Google campaigns."
6
+ egbe-visible: "true"
7
+ egbe-title: "Google Ads"
8
+ egbe-description: "Run ads through Egbe. Reach customers through Google Search, manage campaigns and budgets, and measure signups and purchases."
9
+ egbe-category: "Marketing & growth"
10
+ ---
11
+
12
+ <!-- egbe-mcp-connection:v1 -->
13
+ This skill comes with the Egbe plugin. If this project has its own installed copy
14
+ of the skill, use that copy instead. Otherwise make every Egbe API call it
15
+ describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
16
+ PUT, PATCH and DELETE (with `method`). Pass the API path (for example
17
+ `/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
18
+ `egbe-curl.py` and catalog update checks; the connection authenticates and
19
+ identifies the request. Also pass the `business` that `egbe_setup` returned.
20
+ Where this skill sends an `Idempotency-Key` header, pass the same value as
21
+ `idempotency_key` and reuse it when retrying. A result with a `continuation`
22
+ holds one part of a long body; read the next part with `egbe_read`, the same
23
+ `path` and `business`, and that `continuation`.
24
+ Read bundled files beside this `SKILL.md`. For published skill resources on
25
+ Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
26
+
27
+ Publishing works through the connector: commit the app's files with the JSON
28
+ commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
29
+ commit SHA; no git push or workspace setup is needed. A step that needs a local
30
+ project key or a bundled script, such as a local `npx convex deploy`, needs a
31
+ set-up project workspace. In a persistent
32
+ project workspace that is not set up yet, set it up as the `egbe-setup` skill's
33
+ project setup describes.
34
+ Without such a workspace, or if it refuses, tell the founder that this step needs
35
+ an agent with a set-up project folder, and continue with the rest of the work.
36
+
37
+ If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
38
+ available, the plugin's connector is not signed in for this agent. Tell
39
+ the founder how to connect it, as the `egbe-setup` skill describes, rather than
40
+ saying Egbe is unavailable.
41
+
42
+ The connector's tools work even where this environment's shell cannot reach
43
+ Egbe: their calls travel through this agent's connection, not through the
44
+ shell's network. A step that runs in the shell, such as a bundled script, a `git
45
+ push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
46
+ Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
47
+ before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
48
+ the founder: they allow that host in this agent's network settings or continue
49
+ with an agent on their own computer. Code can also be published without the
50
+ shell by committing through the connector (`egbe-os-git`, "Without a terminal").
51
+ Until the shell step or that commit and its deploy succeed, do not report the
52
+ work as published: a preview in this agent or on this computer is not an Egbe
53
+ deployment.
54
+
55
+
56
+ # Google Ads
57
+
58
+ Inspect and modify the selected Google Search objects through Egbe OS. Use the
59
+ requested configuration and exact owned IDs; a status read, edit or pause does
60
+ not require a campaign-planning package.
61
+
62
+ ## Connection and account
63
+
64
+ Use `OS_URL` and `OS_API_KEY`; requests authenticate with
65
+ `Authorization: Bearer $OS_API_KEY`. Campaign management needs `ads` scope.
66
+ The [server conversions reference](references/server-conversions.md) describes
67
+ the narrower runtime `analytics` access. Never put the OS key in browser code
68
+ or project evidence; direct Google credentials are not needed.
69
+
70
+ Before new campaign setup, read the selected account. For work on existing
71
+ campaigns, list them and use their saved refs; new-account access is independent:
72
+
73
+ ```bash
74
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/ads/google/account" -s
75
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/ads/google/campaigns" -s
76
+ ```
77
+
78
+ `GET /ads/google/account` checks access for new work and returns account
79
+ diagnostics in `data.raw` (customer id, currency, timezone, status). An explicit
80
+ Registry assignment takes priority. Without one, the shared Egbe account is
81
+ available only to approved owner emails. OS selects this server-side; customer
82
+ overrides are rejected and the caller cannot grant access by supplying an email.
83
+
84
+ - Success: continue the requested setup and planning with the returned account.
85
+ - `403` containing `google_ads_not_available`: tell the founder clearly, “New
86
+ Google advertising through Egbe is unavailable for this project.” They can use
87
+ their own Google Ads account through their own authorized tools/credentials,
88
+ or agree a manual account connection/assignment with Egbe. Having an MCC or
89
+ completing the Dashboard OAuth pilot alone does not assign an OS account.
90
+ Do not request a founder MCC as a prerequisite or promise automatic connection.
91
+ - Registry/provider `5xx`: report a temporary account-check failure, retry the
92
+ read later and escalate persistent failure to Egbe. This is not an access denial.
93
+
94
+ The restriction applies to selecting an account for new work, including keyword
95
+ ideas. It does not revoke existing campaign access. A denied account check must
96
+ not block an authorized read, edit, pause or saved-operation retry on an existing
97
+ campaign. Campaigns are in `data.campaigns`. Preserve the exact returned `ref`, shaped
98
+ `customer_id:campaign_id`; existing campaigns can belong to earlier assigned
99
+ accounts. Names are not ownership proof. For the selected campaign,
100
+ `GET /ads/google/campaigns/{ref}/account-settings` reads currency, timezone and
101
+ auto-tagging. Product agents cannot change shared-account auto-tagging; report
102
+ a needed change to Egbe, without requesting an admin key.
103
+
104
+ Other auth, ownership, configuration, quota and wallet errors block the affected
105
+ Egbe operation. Never use Egbe credentials, account overrides or raw provider
106
+ calls to bypass a restriction. A founder may separately authorize work through
107
+ their own tools and credentials; those are outside these OS endpoints. Keep
108
+ secrets out of chat, browser code and project evidence.
109
+
110
+ ## Choose the operation
111
+
112
+ | Task | Read |
113
+ | --- | --- |
114
+ | Query keyword ideas and interpret their fields | [Keyword ideas](references/keyword-ideas.md) |
115
+ | Create a paused campaign; change targeting, budget or bids | [Campaigns](references/campaigns.md) |
116
+ | Create or edit groups, keywords, negatives and responsive search ads | [Search assets](references/search-assets.md) |
117
+ | Launch, pause, inspect serving state or repair child status | [Delivery](references/delivery.md) |
118
+ | Read performance, search terms, diagnostics and product attribution | [Reporting](references/reporting.md) |
119
+ | Configure browser/server conversion actions, goals or bidding; read action reports | [Conversions](references/conversions.md) |
120
+ | Deliver backend-confirmed outcomes and inspect receipts | [Server conversions](references/server-conversions.md) |
121
+ | Preserve authorized inputs, confirmed state or an unfinished operation | [Campaign records](references/artifacts.md) |
122
+
123
+ Read only the relevant references. Endpoint paths below are relative to OS;
124
+ `{ref}` always means the returned campaign ref, not just the campaign id.
125
+ Google does not support the generic Meta `/plan`, `/apply`, `/state` or
126
+ `/status` routes. Use Google's `/readback`, not raw `/query` or `/mutate`.
127
+
128
+ ## Execution
129
+
130
+ Before a write, follow [Campaign records](references/artifacts.md): find existing
131
+ records by the exact campaign ref, or by the planned work before a ref exists.
132
+ Read recorded decisions and `pending_operation`; reconcile an unfinished
133
+ operation using its saved request/key and current provider state before starting
134
+ another. Do not replace unresolved input with a new operation.
135
+
136
+ Identify the exact targets, read current state and apply only the intended change.
137
+ Do not create real provider objects to test request syntax; use documented
138
+ schemas, local validation or an explicit provider validation facility.
139
+ Preserve unrelated settings and intentionally paused objects. Save recoverable
140
+ inputs before the call. Use the operation's retry rules: temporary caches, durable
141
+ receipts and desired-state assignments are not interchangeable.
142
+
143
+ OS already retries reads briefly when the ads service is restarting or
144
+ unreachable. A failure that remains has `data.upstream_status`, `data.retryable`
145
+ and `data.attempts`; `data.error: "upstream_unavailable"` means Egbe or Google
146
+ was temporarily unavailable, not that a campaign changed. Keep the last confirmed
147
+ state, re-read later and report persistent failure through support. A write that
148
+ ends in 502/503/504 has an unknown outcome: read the object back before repeating
149
+ it. Pause reports its own confirmation; see [Delivery](references/delivery.md).
150
+
151
+ Approval covers the exact write it describes. After a failed or rejected write,
152
+ reconcile an unknown outcome first, then retry without asking only with the same
153
+ approved inputs and as the operation's retry rules allow. If the fix changes the
154
+ target, payload, amount, keywords, ad text, status or another substantive input,
155
+ show the founder the failure and the proposed changed write and wait for fresh
156
+ explicit approval before sending it; a fix to request syntax alone is not a
157
+ substantive change.
158
+
159
+ Read back changed objects before reporting completion and preserve the useful
160
+ facts for continuation. Simple reads need no new artifacts; missing historical
161
+ research must not prevent an explicitly requested pause. Scheduling belongs to
162
+ the caller's runtime mechanism, not to this skill; do not claim monitoring or
163
+ a future stop is installed unless that mechanism confirms it.
@@ -0,0 +1,133 @@
1
+ # Campaign records and recovery
2
+
3
+ Keep the requested configuration, authorization context and evidence needed to
4
+ continue safely. Ordinary reads need no new files; a requested pause must not
5
+ wait for a reconstructed launch history.
6
+
7
+ ## Locations and responsibilities
8
+
9
+ ```text
10
+ egbe-docs/marketing/campaigns/google/<campaign-slug>/
11
+ campaign.json
12
+ results.md
13
+ evidence/
14
+ ```
15
+
16
+ Create these on demand, not as an empty bundle. Reference existing input records
17
+ rather than copying them or requiring a new planning document.
18
+
19
+ Through the Egbe connector without a project folder, keep these records at the
20
+ same paths in Egbe's artifact store, as `egbe-os-quickstart` →
21
+ `references/artifact-sync.md` ("Through the Egbe connector") describes. Save a
22
+ write's request record there before sending the write.
23
+
24
+ - campaign.json: object bindings, last significant confirmed provider state and
25
+ at most one unfinished agent-side campaign operation.
26
+ - results.md: observed build/launch result and later measurements, dates,
27
+ source/freshness, limitations and actual stop reason when known. No empty
28
+ report in advance.
29
+ - evidence/: useful request/readback snapshots or metric exports.
30
+ Small evidence may live in the main files; no journal of every GET.
31
+
32
+ Use one stable channel-qualified campaign slug for the folder and utm_campaign.
33
+ Do not invent experiment IDs or repurpose the slug as one. Campaign name/ref and
34
+ provider IDs are different identifiers; preserve the exact returned ref.
35
+
36
+ Existing project records remain evidence. Resolve an existing campaign by its
37
+ exact provider ref/ID, not a guessed name; ambiguous matches need clarification.
38
+ Do not rewrite or delete historical files merely to satisfy this layout.
39
+
40
+ ## Minimal campaign.json
41
+
42
+ Example after an observed paused build; values are illustrative:
43
+
44
+ ```json
45
+ {
46
+ "channel": "google",
47
+ "campaign_slug": "google-search-001",
48
+ "product_slug": "product-slug",
49
+ "plan_path": "egbe-docs/marketing/campaigns/google/google-search-001/plan.md",
50
+ "account": {"customer_id": "1234567890", "currency": "USD", "time_zone": "Europe/London"},
51
+ "campaign_ref": "1234567890:456",
52
+ "objects": {
53
+ "ad_groups": [{"id": "789", "keyword_ids": ["111"], "ad_ids": ["222"]}]
54
+ },
55
+ "confirmed": {
56
+ "observed_at": "2026-10-27T12:00:00Z",
57
+ "source": "GET /ads/google/campaigns/1234567890:456/readback?expect=PAUSED",
58
+ "readback": {"campaign": {"id": "456", "customer_id": "1234567890", "status": "PAUSED"}}
59
+ },
60
+ "pending_operation": null
61
+ }
62
+ ```
63
+
64
+ The required identity for a campaign record is channel and campaign_slug. Before
65
+ creation, campaign_ref and confirmed are null and objects may be empty. Populate
66
+ account from actual OS diagnostics; unknown currency/timezone stays unknown.
67
+ Once available, preserve the exact campaign_ref and ensure its customer/campaign
68
+ components agree with the recorded account and provider readback. A local record
69
+ does not establish server ownership.
70
+
71
+ Keep IDs needed for the task with their parent group, not an unscoped inventory.
72
+ Use negative_keyword_ids for relevant negative criteria, and conversion_refs or
73
+ restore_keys when conversion work creates values needed for continuation.
74
+ product_slug and plan_path are optional when not applicable or not known.
75
+ If supplied by the project, preserve immutable durable business_id, product_id,
76
+ launch_id, experiment_id and variant_id in an optional identity object. Do not
77
+ derive them from names or store caller orchestration identifiers here.
78
+
79
+ confirmed contains observed_at, the exact read source, and either the relevant
80
+ readback object or a project-relative readback_path. Preserve actual statuses,
81
+ delivery/drift, destinations, settings or amounts needed to verify that operation;
82
+ do not manufacture a universal projection or copy the entire desired plan.
83
+ The example is a campaign-only excerpt, not sufficient evidence of every
84
+ child's state. Use full or targeted evidence as needed for the actual change.
85
+ Never write planned state as confirmed or substitute a deadline for the actual
86
+ successful pause/readback time. Missing facts are unknown, not assumed defaults.
87
+
88
+ ## Authorization context
89
+
90
+ Keep enough content to identify the authorized operation and exact materials,
91
+ source/time and boundaries alongside existing campaign notes. A source link to
92
+ an inaccessible chat alone is insufficient for a later agent to resume a write.
93
+
94
+ A snapshot/hash can bind exact inputs; it does not prove human approval.
95
+ Do not hash an entire mutable Markdown document as the only binding:
96
+ adding commentary does not change an approved ad. Changed substantive inputs
97
+ must remain distinguishable from earlier decisions.
98
+
99
+ ## Recover one unfinished campaign operation
100
+
101
+ Agent-side changes to one campaign are sequential in this workflow. Before a
102
+ risky write, durably save pending_operation with:
103
+
104
+ - method and exact OS path/target;
105
+ - payload, or payload_path pointing to an immutable project-relative snapshot;
106
+ - idempotency_key only where the endpoint supports it;
107
+ - prepared_at with timezone;
108
+ - decision_ref to the relevant plan/notes and enough context to identify the
109
+ requested action, not only an inaccessible chat URL.
110
+
111
+ A hash without the actual request is insufficient for recovery. Preparing this
112
+ record is not proof the request was sent or executed. Do not overwrite it with
113
+ a new operation while the previous result remains uncertain.
114
+
115
+ After a response or recovery read, save confirmed IDs and provider readback
116
+ before clearing pending_operation. Preserve a needed operation key/restore key
117
+ after completion. If the result is unknown, keep the exact request/key and
118
+ diagnostic, inspect current provider state and follow that endpoint's own rules.
119
+ Some creates require Egbe reconciliation rather than a retry. Temporary caches
120
+ do not make a multi-step build atomic; do not replay uncertain batches blindly
121
+ or change keys to bypass them.
122
+
123
+ These records are campaign-management context in the product repository; follow
124
+ its ordinary synchronization workflow without requiring a commit after every
125
+ operation. Never include keys, tokens, cookies, private user data or credentials.
126
+ Do not copy raw responses wholesale without checking their content.
127
+
128
+ Per-user GCLIDs, product events, delivery intents and retry receipts belong to
129
+ the deployed product's existing durable runtime storage, not this repository
130
+ or campaign.json. See [Server conversions](server-conversions.md).
131
+
132
+ This layout is not automatically ingested into GTM Knowledge. Do not claim
133
+ central collection of these records.
@@ -0,0 +1,157 @@
1
+ # Campaign creation and settings
2
+
3
+ All paths use `/ads/google`. For a new campaign, first check `/account` as
4
+ described in the skill. For existing campaigns, use their saved refs and
5
+ campaign-specific account settings; a denied new-account check does not block
6
+ them. Keep settings changes scoped to the user's actual request.
7
+
8
+ ## Create a paused Search shell
9
+
10
+ ```http
11
+ POST /ads/google/campaigns
12
+ Idempotency-Key: <stable key for this creation>
13
+ Content-Type: application/json
14
+ ```
15
+
16
+ ```json
17
+ {
18
+ "name": "google-search-001",
19
+ "daily_budget_usd": 5,
20
+ "objective": "SEARCH",
21
+ "status": "PAUSED",
22
+ "product_slug": "product-slug"
23
+ }
24
+ ```
25
+
26
+ The amount is illustrative, not spending authorization. Creation requires a USD
27
+ account, configured mutation quota and wallet admission; no FX conversion is
28
+ performed. Use the stable campaign slug chosen for attribution. The provider creates Search with Manual CPC,
29
+ Google Search enabled and search-partner/display networks disabled. It creates
30
+ the budget and campaign separately, not as one atomic transaction. OS's generic
31
+ status field can echo the request; the actual shell is PAUSED. Verify provider
32
+ readback rather than treating that echo as truth.
33
+
34
+ Optional `product_slug` binds reusable conversion actions to the product;
35
+ it is not required for launch. Preserve `data.ref`, `customer_id` and
36
+ `campaign_id`. Never override the assigned customer.
37
+
38
+ Creation requires a stable Idempotency-Key. Reuse it with the identical payload;
39
+ a changed payload conflicts. The durable operation pins the original account.
40
+ If `google_campaign_create_outcome_unknown` is returned, stop for Egbe
41
+ reconciliation. Do not create a replacement with a new key. A timeout is not
42
+ proof that no budget or campaign was created.
43
+
44
+ Build serving objects with [Search assets](search-assets.md); use
45
+ [Delivery](delivery.md) for activation, pause and actual serving readback.
46
+
47
+ ## Inspect and change targeting
48
+
49
+ ```http
50
+ GET /ads/google/campaigns/{ref}/account-settings
51
+ GET /ads/google/campaigns/{ref}/targeting
52
+ GET /ads/google/campaigns/{ref}/diagnostics
53
+ PATCH /ads/google/campaigns/{ref}/targeting
54
+ Idempotency-Key: <stable key for this change>
55
+ ```
56
+
57
+ ```json
58
+ {
59
+ "language_ids": ["1000"],
60
+ "location_ids": ["2840"],
61
+ "positive_geo_target_type": "PRESENCE",
62
+ "networks": {"google_search": true, "search_partners": false, "display": false}
63
+ }
64
+ ```
65
+
66
+ This example selects English/US; it is not a targeting recommendation.
67
+ IDs are numeric Google constants, not full resource names. Supplied lists
68
+ replace that category; omitted fields remain unchanged, while explicit null
69
+ is invalid. `excluded_location_ids: []` clears exclusions. Positive location
70
+ and language lists cannot be empty, include/exclude sets cannot overlap and
71
+ IDs must be unique. Limits: 20 languages, 100 included and 100 excluded locations.
72
+
73
+ A supplied networks object sets all three switches and disables the separate
74
+ partner-search network; `google_search` must be true for Search. Other
75
+ criteria, status, bids and budget stay unchanged. PRESENCE excludes interest
76
+ targeting, but includes people in or regularly in the location; it is not a
77
+ precise physical-location guarantee.
78
+
79
+ Inspect `data.verified` and returned configuration. Retry an interrupted
80
+ operation with the same key and payload. On an uncertain outcome or drift,
81
+ inspect readback and the diagnostic; do not recreate criteria or change keys
82
+ to bypass it.
83
+
84
+ ## Change only the daily budget
85
+
86
+ ```http
87
+ POST /ads/google/campaigns/{ref}/search-assets
88
+ Idempotency-Key: <distinct key for this campaign and intentional change>
89
+ Content-Type: application/json
90
+ ```
91
+
92
+ ```json
93
+ {"daily_budget_usd": 4.5}
94
+ ```
95
+
96
+ Omit `geoTargets` and `adGroups`: supplying them can create assets. This
97
+ updates only the existing budget amount; it does not launch, alter statuses,
98
+ bids or targeting, or create a budget. The amount must be authorized, including
99
+ a reduction. The current budget must belong to this campaign and be used by
100
+ exactly one campaign. `explicitly_shared=true` alone is not proof of multiple
101
+ current users. Concurrent provider-side reassignments cannot be made atomic
102
+ by this API.
103
+
104
+ Current writes require USD, an explicit mutation quota, configured amount limits
105
+ and wallet admission. The wallet reserves twice the requested daily budget
106
+ using the existing budget asset key; even a reduction can fail admission.
107
+ This is not a top-up or permission to spend more.
108
+
109
+ The successful-response cache is temporary (default 15 minutes), process-local
110
+ and keyed by key AND payload; changed payload is a cache miss, not a durable
111
+ conflict check. Concurrent calls, expiry, restart or failure after mutation can
112
+ escape it. Do not send parallel copies or replay an old budget instruction.
113
+ After uncertainty, inspect the current budget and reconcile before another write.
114
+
115
+ Inspect `data.raw.readback.campaign.daily_budget`, currency and unchanged
116
+ statuses, then obtain fresh `/children` or `/readback`. A cached response is
117
+ historical, not fresh verification; HTTP 200 alone proves neither the requested
118
+ amount nor current configuration.
119
+
120
+ ## Change existing Manual CPC bids
121
+
122
+ ```http
123
+ PATCH /ads/google/campaigns/{ref}/bids
124
+ Idempotency-Key: <stable key for this bid change>
125
+ Content-Type: application/json
126
+ ```
127
+
128
+ ```json
129
+ {
130
+ "ad_groups": [{"id": "789", "cpc_bid_micros": 2500000}],
131
+ "keywords": [{"ad_group_id": "789", "criterion_id": "111", "cpc_bid_micros": null}]
132
+ }
133
+ ```
134
+
135
+ Read `/diagnostics` first. A group default does not replace explicit keyword
136
+ overrides; inherited keywords follow a changed group. Null clears a keyword
137
+ override to inherit; group bids cannot be null. Omitted targets keep their
138
+ configured bids. Supply at least one target, no duplicates, at most 100 groups
139
+ and 500 keywords. Positive bids are integer account-currency micros; 2500000
140
+ means $2.50 in USD, not an instruction to use that amount.
141
+
142
+ Configured gateway minimum/maximum CPC guardrails still apply to explicit bids.
143
+ If a bound rejects the requested amount, report that constraint; do not raise
144
+ the bid or substitute the historical high-range metric without a new decision.
145
+
146
+ This operation supports Manual CPC Search in USD accounts. It atomically changes
147
+ only the requested bids, not strategy, budget, statuses or targeting, and creates
148
+ nothing. Inspect `verified`, configured/effective CPC and its source. Retry the
149
+ same key/payload after interruption; inspect drift before a new intentional
150
+ change, never recreate groups or keywords. Higher bids can increase spend within
151
+ the existing campaign budget. Preserve the confirmed change timestamp so later
152
+ reports can distinguish observations before and after the change.
153
+
154
+ Readbacks label `currency_code` alongside money. Legacy `*_usd` values are
155
+ populated only for USD accounts; do not relabel other currencies or bypass
156
+ wallet/quota errors with provider/admin credentials. An inherited/unavailable
157
+ bid is not zero, and a configured base bid is not the average auction price.
@@ -0,0 +1,153 @@
1
+ # Conversion actions, goals and reports
2
+
3
+ Conversion measurement is optional for an ordinary CPC campaign. Creating an
4
+ action, choosing campaign goals and changing bidding are separate operations.
5
+ Use only the operation requested; action configuration is not event delivery,
6
+ attribution, reliable training data or permission to launch.
7
+
8
+ ## Choose or create an owned action
9
+
10
+ ```http
11
+ GET /ads/google/conversion-actions?offset=0&limit=20
12
+ GET /ads/google/conversion-actions/{conversion_ref}
13
+ POST /ads/google/conversion-actions
14
+ Idempotency-Key: <stable key for this creation>
15
+ Content-Type: application/json
16
+ ```
17
+
18
+ ```json
19
+ {
20
+ "campaign_ref":"1234567890:456",
21
+ "name":"Account signup",
22
+ "delivery_method":"browser",
23
+ "category":"SIGNUP",
24
+ "counting_type":"ONE_PER_CLICK"
25
+ }
26
+ ```
27
+
28
+ List pagination has offset >=0 and limit 1–100. Reuse an appropriate owned action;
29
+ do not adopt unregistered account-wide actions by name. The campaign ref selects
30
+ its authoritative conversion account and product. A paused shell suffices and
31
+ is not modified. Optional product_slug at campaign creation binds actions for
32
+ reuse across that product. Older campaigns without it have exact-campaign
33
+ binding; do not silently broaden it.
34
+
35
+ Supported categories: SIGNUP, PURCHASE, SUBMIT_LEAD_FORM, CONTACT. Browser
36
+ (default) creates WEBPAGE; server creates UPLOAD_CLICKS. Counting is ONE_PER_CLICK
37
+ or MANY_PER_CLICK. Optional default_value and uppercase three-letter currency
38
+ must be paired, with nonnegative finite value. Choose the actual outcome and
39
+ counting behavior, not a UI click presented as a completed purchase.
40
+
41
+ Read `data.ref`, `resource` and `tag`. Browser tag includes ready,
42
+ conversion_id (AW-…), conversion_label, send_to and provider snippets. Use
43
+ returned values, not a tag ID derived from customer/action ID. Missing/ambiguous
44
+ snippets are an integration blocker. The friendly name is stored by OS; the
45
+ provider uses a recovery name. Server actions have tag=null intentionally; use
46
+ [Server conversions](server-conversions.md) for delivery.
47
+
48
+ New actions are secondary (primary_for_goal=false), so they do not silently
49
+ enter account-wide bidding. Without explicit campaign goal selection, tracking
50
+ typically appears in All conversions, not primary Conversions. This is not
51
+ evidence of broken tracking.
52
+
53
+ ## Connect a browser event
54
+
55
+ Continue the product's existing Google tag and consent setup. Initialize the
56
+ returned tag once and send its exact send_to only on the confirmed successful
57
+ outcome: account creation, verified payment, or the actual selected event.
58
+ Do not duplicate on refresh/re-render or send on failed attempts. Use a stable
59
+ non-PII transaction ID for an outcome where appropriate.
60
+
61
+ Tag ID/label are public browser configuration; OS keys, auth tokens, emails and
62
+ other personal data do not belong in the event payload. Check successful and
63
+ failed paths separately. Browser dispatch is not proof of Google attribution;
64
+ reporting can lag. Do not poll/retry indefinitely waiting for a test event.
65
+
66
+ A browser signup and server purchase can coexist. Do not report the same outcome
67
+ to two different actions and select both in goals: transaction deduplication does
68
+ not span actions. Do not replace an existing browser action automatically.
69
+
70
+ ## Inspect readiness and select goals
71
+
72
+ ```http
73
+ GET /ads/google/campaigns/{ref}/conversion-readiness
74
+ GET /ads/google/campaigns/{ref}/conversion-optimization
75
+ POST /ads/google/campaigns/{ref}/conversion-optimization
76
+ Idempotency-Key: <stable key for this goal change>
77
+ Content-Type: application/json
78
+ ```
79
+
80
+ ```json
81
+ {"mode":"select_goals","conversion_actions":["1234567890:77"]}
82
+ ```
83
+
84
+ Readiness is in `data.raw` and includes only Registry-owned actions in the
85
+ campaign's product/exact-campaign binding and authoritative conversion account.
86
+ configured=true requires an ENABLED owned action. configuration_only=true means
87
+ it does not prove goal selection or event delivery. No action is not a blocker
88
+ for CPC advertising.
89
+
90
+ Always set mode explicitly. select_goals binds a campaign-specific custom goal
91
+ to the exact selected enabled actions and excludes other standard campaign goals.
92
+ It does not change bidding, budget, status, account defaults or global primary
93
+ flags. A secondary action in this custom goal can contribute to Conversions;
94
+ it is no longer necessarily limited to All conversions. This does not turn
95
+ Manual CPC into smart bidding.
96
+
97
+ ## Change conversion bidding or restore
98
+
99
+ Use the same POST endpoint with an explicit intended mode:
100
+
101
+ ```json
102
+ {"mode":"maximize_conversions","conversion_actions":["1234567890:77"]}
103
+ ```
104
+
105
+ This selects the owned actions via a custom goal, excludes other campaign goals
106
+ and switches to Maximize Conversions. It does not launch or change budget/status
107
+ or account defaults. Both browser and server actions can be selected. The
108
+ current supported starting strategies are standard Manual CPC, Maximize Clicks
109
+ (TARGET_SPEND) and Maximize Conversions on Search; portfolio strategies are not
110
+ supported. Selecting goals/configuring bidding does not prove tracking is usable.
111
+
112
+ Read the returned state and verified field, then GET conversion-optimization.
113
+ Retain the returned restore_key. To undo, send a new idempotent request:
114
+
115
+ ```json
116
+ {"mode":"restore","restore_key":"<key of the completed change>"}
117
+ ```
118
+
119
+ Restore uses the saved previous configuration, not an assumed default.
120
+ Restoring select_goals restores only goals, preserving later bid changes.
121
+ Restoring a bidding change includes its saved bidding configuration. Concurrent
122
+ or newer configuration/goal-inventory changes conflict rather than being silently
123
+ overwritten. verified confirms configuration readback, not conversions or
124
+ sufficient learning.
125
+
126
+ ## Report an exact action
127
+
128
+ ```http
129
+ GET /ads/google/campaigns/{ref}/conversion-report?conversion_ref=1234567890:77&date_from=2026-01-01&date_to=2026-01-31&date_basis=interaction
130
+ ```
131
+
132
+ Dates are inclusive in the returned account timezone, at most 366 days and cannot
133
+ end in the future. interaction attributes to the ad interaction date; conversion
134
+ uses the outcome date. The report is for the exact owned action, not all actions.
135
+ Both conversions and all_conversions follow Google's goal/attribution rules;
136
+ counts can be fractional, and neither is all product registrations.
137
+
138
+ data_status=available can contain actual reported zeros. no_rows means no rows,
139
+ with null metrics; unavailable means expected metrics are missing. Failed queries
140
+ stay errors. retrieved_at is completion time, not a freshness watermark; lag and
141
+ attribution revisions are possible. Do not infer broken tracking from a recent
142
+ empty report or wait indefinitely for a test event.
143
+
144
+ ## Retry and retention
145
+
146
+ Creation and optimization require Idempotency-Key. Reuse the identical key/body
147
+ after a timeout; changing payload under a key returns 409. Completed operations
148
+ with later drift are not silently reapplied. Inspect current state and use a
149
+ new key only for an intentional new change.
150
+
151
+ For provider_create_outcome_unconfirmed, retry the same key for readback; if
152
+ still unknown, request Egbe reconciliation, not a replacement with a new key.
153
+ Actions/custom goals are retained with archived campaigns.