@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,30 @@
1
+ # LinkedIn destination requirements
2
+
3
+ Use for the LinkedIn paths in a destination review, independently of account,
4
+ campaign and conversion readiness. Reuse the common journey evidence.
5
+
6
+ For a complete visitor-path review, apply the `egbe-os-destination-readiness` skill with
7
+ this reference in one audit run. If missing locally, its full bundle is available
8
+ at `GET $OS_URL/skills/destination-readiness`.
9
+
10
+ Source: [LinkedIn Advertising Policies](https://www.linkedin.com/legal/ads-policy),
11
+ sections 4 and 6; checked 2026-09-29. Read current wording for a policy finding.
12
+
13
+ - **Offer and identity:** the product must match the ad; advertised prices,
14
+ discounts and offers must be easy to find from its link. Identify unsupported
15
+ affiliation or confusing brand transitions without treating an explained
16
+ parent/provider identity as an error.
17
+ - **Link behavior:** the display and destination domains must match, and members
18
+ must reach the same destination/landing page from the ad. Inspect unexpected
19
+ redirects, landing-triggered pop-ups and whether Back/navigation works. A
20
+ deliberate later booking/checkout link is a separate journey step.
21
+ - **Collection security:** LinkedIn requires HTTPS for sensitive information,
22
+ including login, financial and specified personal information. Inspect the
23
+ applicable collection step, not merely the initial page's certificate.
24
+ - **Privacy:** where cross-site tracking is actually observed, assess disclosure
25
+ and consent against section 6. Do not infer it from the absence of a cookie
26
+ banner or audit whether conversion instrumentation is installed correctly.
27
+
28
+ For each issue return the affected path, exact observation, policy section and
29
+ smallest repair with a recheck condition. An inaccessible region or browser
30
+ variant remains unverified; successful inspection is not LinkedIn approval.
@@ -0,0 +1,154 @@
1
+ # LinkedIn OS API
2
+
3
+ Base `$OS_URL/ads/linkedin`, bearer `$OS_API_KEY`; provider tokens stay in OS.
4
+ Writes require `Idempotency-Key` (1–128 characters). Same key and changed payload
5
+ is 409. Responses use the OS envelope; inspect data, not only HTTP 200.
6
+
7
+ ## Read and discovery
8
+
9
+ - `GET /account`, `GET /readiness`.
10
+ - `GET /targeting/facets`.
11
+ - `GET /targeting/entities?facet=locations&query=United%20States&language=en&country=US`.
12
+ Searchable facets require `query`; `entity_type` is optional and should only
13
+ be supplied when supported by provider facet metadata.
14
+ - `GET /targeting/entities?facet=seniorities` also works for `jobFunctions` and
15
+ `staffCountRanges`: returns the facet's options via `adTargetingFacet` rather
16
+ than typeahead. Omit `query` and `entity_type` for these listings. No mutation
17
+ occurs. [Provider targeting contract](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads/advertising-targeting/ads-targeting).
18
+ - `POST /audience-estimate`: `{"targeting":{"include":{"locations":["urn:li:geo:<resolved-id>"]}}}`.
19
+ - `POST /budget-pricing`: same targeting plus `format` and `daily_budget_usd`;
20
+ provider returns minimum/maximum/suggested bid and daily-budget limits.
21
+ - `GET /campaign-groups`, `/campaigns`, `/creatives`, `/images`:
22
+ owned only, `offset=0&limit=20`, follow next_offset until null.
23
+ - `GET /<collection>/<id>`; `GET /creatives/<id>/content` resolves its owned
24
+ Sponsored Content reference. IDs are numeric strings except image URNs.
25
+ Inspect raw resource fields including moderation and serving reasons.
26
+
27
+ ## Create a group
28
+
29
+ `POST /campaign-groups`:
30
+
31
+ ```json
32
+ {"product_slug":"example-product","name":"LinkedIn pilot","schedule":{"start":1800000000000}}
33
+ ```
34
+
35
+ Schedule values are Unix milliseconds. Use actual approved timestamps, not this
36
+ example. Groups have no shared budget; each native campaign owns its budget.
37
+ OS creates groups in DRAFT (non-serving); there is no caller status field.
38
+ LinkedIn permits initial ACTIVE or DRAFT, not PAUSED. Launch is a separate,
39
+ explicitly authorized operation. [Provider group lifecycle](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads/account-structure/create-and-manage-campaign-groups).
40
+
41
+ ## Create a campaign
42
+
43
+ `POST /campaigns`:
44
+
45
+ ```json
46
+ {
47
+ "group_id":"123",
48
+ "name":"LinkedIn pilot — image",
49
+ "format":"SINGLE_IMAGE",
50
+ "daily_budget_usd":30,
51
+ "cpc_bid_usd":3,
52
+ "locale":{"language":"en","country":"US"},
53
+ "targeting":{"include":{"locations":["urn:li:geo:103644278"]},"exclude":{}},
54
+ "schedule":{"start":1800000000000}
55
+ }
56
+ ```
57
+
58
+ Illustrative IDs must be resolved/owned. format: SINGLE_IMAGE or TEXT_AD.
59
+ Created status is DRAFT, including beneath a DRAFT group; launch is separate.
60
+ WEBSITE_VISIT/manual CPC, no expansion/offsite delivery.
61
+ USD amounts are decimal dollars, not micros; non-USD accounts are rejected.
62
+ `PATCH /campaigns/{id}` accepts only changed name, daily_budget_usd, cpc_bid_usd,
63
+ targeting or schedule; omit unchanged fields, don't send null. Targeting is a full
64
+ replacement. No hidden account-wide changes or budget increases.
65
+
66
+ ## Upload and create creative
67
+
68
+ `POST /images`: `{"product_slug":"example-product","image_base64":"<base64 PNG/JPEG>"}`.
69
+ Maximum 5 MB decoded; no data URI. Through the Egbe connector (`egbe_write`), or
70
+ when the image is already at a public HTTPS URL, send `"image_url":"https://..."`
71
+ instead of `image_base64` and OS downloads it. A connector message carries at
72
+ most 1 MiB, so store a larger local image with an upload session first:
73
+ `POST /uploads` `{"filename","content_type","size"}` returns `data.upload_id`;
74
+ send the bytes in order as `POST /uploads/{upload_id}/parts`
75
+ `{"content_base64":"<at most 512000 bytes>","offset":<data.received_bytes>}`;
76
+ `POST /uploads/{upload_id}/complete` returns a public `data.url` for `image_url`. Save the returned image URN,
77
+ then GET until AVAILABLE before using it. Signed upload URLs remain internal.
78
+
79
+ `POST /creatives`:
80
+
81
+ ```json
82
+ {"campaign_id":"456","name":"Benefit variant A","image_id":"urn:li:image:<uploaded-id>","headline":"A useful product","text":"A concrete benefit.","destination_url":"https://your-product.example/path?utm_source=linkedin&utm_medium=paid_social&utm_campaign=linkedin-pilot&utm_content=benefit-a","cta":"LEARN_MORE"}
83
+ ```
84
+
85
+ Image and campaign must belong to the same product. For Text Ad: headline≤25,
86
+ text≤75; for Single Image gateway bounds are headline≤200, text≤3000.
87
+ OS sets `intendedStatus=DRAFT` for both formats; there is no caller status field.
88
+ CTA: LEARN_MORE, SIGN_UP, DOWNLOAD, REGISTER, REQUEST_DEMO (Single Image only).
89
+ `PATCH /creatives/{id}` accepts changed `name` for both formats, and optional
90
+ `headline`, `text`, `image_id`, `destination_url` for Text Ads (same Text limits).
91
+ Omitted fields and delivery status are preserved. Single Image copy/media changes
92
+ return 409 and require an explicitly approved replacement, not implicit duplication.
93
+
94
+ ## Delivery and reports
95
+
96
+ `POST /campaign-groups/{id}/launch|pause`,
97
+ `POST /campaigns/{id}/launch|pause`,
98
+ `POST /creatives/{id}/launch|pause`; no body, Idempotency-Key required.
99
+ Follow launch workflow for parent order and wallet authorization.
100
+
101
+ `GET /campaigns/{id}/results?date_from=2026-09-01&date_to=2026-09-11`:
102
+ inclusive UTC dates, today allowed, at most 366 days per request.
103
+ Returns campaign_id, dates, currency, metrics (impressions/clicks/spend decimal
104
+ in account currency), raw data, observed_ranges, data_status, fetched_at and
105
+ freshness. Not a conversion report.
106
+
107
+ ## Optional conversions
108
+
109
+ - POST `/conversion-rules`: `{"campaign_id":"456","name":"Signup","method":"CONVERSIONS_API","type":"SIGN_UP"}`.
110
+ Method INSIGHT_TAG creates an event-specific browser rule; no URL rules.
111
+ Optional attribution_type: LAST_TOUCH_BY_CONVERSION (default) or
112
+ LAST_TOUCH_BY_CAMPAIGN; post_click_days=30 and view_through_days=7, each 1/7/30.
113
+ Creation does not associate or activate campaigns.
114
+ - GET `/conversion-rules` (owned, offset/limit); GET `/conversion-rules/{id}`.
115
+ - PATCH `/conversion-rules/{id}`: changed name, enabled, post_click_days,
116
+ view_through_days, attribution_type only. Method/product identity are immutable.
117
+ - GET `/conversion-rules/{id}/browser-tag`: owned browser rule + existing
118
+ public Insight Tag and event_id_prefix, not shared account/domain management.
119
+ - GET/PUT/DELETE `/campaigns/{campaign_id}/conversion-rules/{id}`: inspect,
120
+ attach or detach one same-product pair. No request body; writes require key.
121
+ - POST `/conversion-events`: `{"conversion_id":"789","event_id":"signup:opaque-id","happened_at":1800000000000,"email_sha256":"<64 lowercase hex characters>"}`.
122
+ Replace example time/identity with a real outcome within the past 90 days.
123
+ Optional linkedin_tracking_uuid, value ({currency_code, amount}), validate_only.
124
+ At least one genuine matching identifier is required. See the conversions
125
+ workflow for hooks, prefix/dedupe, retries and privacy.
126
+ - GET `/conversion-events/{receipt_id}`: durable delivery status, not a
127
+ provider attribution lookup. Management is ads-only; rule GET and event
128
+ send/receipt GET also accept analytics for deployed product credentials.
129
+ - GET `/campaigns/{campaign_id}/conversion-rules/{id}/results`: explicit
130
+ date_from/date_to, inclusive UTC, at most 366 days. String decimal counts
131
+ conversions/post_click_conversions/post_view_conversions; metrics=null when
132
+ no matching rows, provider errors stay errors. No bidding changes.
133
+
134
+ ## Errors and recovery
135
+
136
+ - 401/403: Egbe admin OAuth/app/account/Page permission, not a reason to switch keys.
137
+ - 404: unknown or unowned resource; ownership checks precede mutations.
138
+ - 400/422: invalid schema, provider minimum, targeting or format; inspect exact error.
139
+ - 409: conflict, unresolved operation, parent state, image processing, readback
140
+ mismatch or unavailable wallet reservation. Follow its message; don't bypass.
141
+ - 429: quota/provider throttling; retry with backoff and same operation identity.
142
+ - GET transient transport/429/5xx: bounded retry, at most three attempts. Long
143
+ Retry-After defers to the caller; 401/403 aren't repeatedly retried.
144
+ - Write transport failure: outcome may be unknown; preserve key and read back.
145
+ No blind transport retries for mutations. Event receipts distinguish confirmed
146
+ retryable refusal from uncertain delivery; see the conversions workflow.
147
+ - Same key after a later update: superseded; does not re-activate paused resources.
148
+
149
+ First defaults: 5 campaign creations/month, 50 other management mutations/day.
150
+ Reads do not consume write quotas. Pause is exempt. Image uploads/group/creative
151
+ creation and conversion configuration count as management mutations. Disable/
152
+ detach are exempt; runtime event delivery does not consume campaign-write quota.
153
+ Effective limits come from the caller's
154
+ binding, not a hardcoded assumption in the agent.
@@ -0,0 +1,63 @@
1
+ # Campaign continuity
2
+
3
+ Paths are relative to the product repository root:
4
+
5
+ ```text
6
+ egbe-docs/marketing/campaigns/linkedin/
7
+ channel-readiness.json
8
+ campaigns.json
9
+ <linkedin-slug>/
10
+ creatives.json
11
+ tracking.json
12
+ campaign-state.json
13
+ operations.json
14
+ launch-readback.json
15
+ change-log.md
16
+ assets/
17
+ monitoring/check-<UTC-timestamp>.md
18
+ ```
19
+
20
+ Create artifacts when needed, not empty files for future phases. Never store
21
+ member tokens, signed upload URLs, raw customer records or private credentials.
22
+
23
+ Through the Egbe connector without a project folder, keep these records at the
24
+ same paths in Egbe's artifact store, as `egbe-os-quickstart` →
25
+ `references/artifact-sync.md` ("Through the Egbe connector") describes. Save a
26
+ write's request record there before sending the write.
27
+
28
+ - `campaigns.json`: campaign slug/path and selected campaign; preserve caller
29
+ product/experiment identifiers when provided. Explicit task selection wins.
30
+ - `creatives.json`: approved text/image paths, format, stable local variant ID,
31
+ exact UTM destination, provenance and substantiation. Not a provider payload.
32
+ - `tracking.json`: `utm_source=linkedin`, `utm_medium=paid_social`,
33
+ `utm_campaign=<linkedin-slug>`, `utm_content=<variant>`; product analytics
34
+ verification and attribution gaps. Provider conversions default `not_configured`.
35
+ When requested, record rule IDs/methods, campaign associations, event hooks,
36
+ event_id_prefix and configuration/ingestion/attribution verification separately.
37
+ Save event receipt IDs/status, never their customer matching payloads.
38
+ - `campaign-state.json`: product slug, native account and organization URNs,
39
+ group ID, each campaign ID/format/budget, creative IDs/parents/image URNs,
40
+ observed statuses and timestamp. One experiment may contain both formats:
41
+ list their separate campaigns and total authorized daily budget.
42
+ - `launch-readback.json`: timestamped GET responses for group, campaigns,
43
+ creatives and images; preserve moderation/serving reasons and exact bindings.
44
+ - `change-log.md`: actual mutations, before/after observations and authority.
45
+ - Saved observations: query/returned periods, fetch time, source, currency,
46
+ metrics, availability and attribution gaps. Simple reads need no new files.
47
+
48
+ Before each mutation append to `operations.json`:
49
+
50
+ ```json
51
+ {"operations":[{"operation_id":"group-create","method":"POST","path":"/ads/linkedin/campaign-groups","idempotency_key":"linkedin-pilot-group-v1","payload":{"product_slug":"example-product","name":"LinkedIn pilot","schedule":{"start":1800000000000}},"status":"prepared","result_ids":[]}]}
52
+ ```
53
+
54
+ Replace the illustrative start with the approved Unix-millisecond schedule.
55
+ Store the exact configuration body and key before calling. Runtime customer-event
56
+ retry payloads belong in private product storage, not this artifact.
57
+ For image bytes store the local file
58
+ path and digest, not base64. States: prepared, unconfirmed, succeeded, failed.
59
+ A lost response is unconfirmed. Persist returned IDs even if later steps fail.
60
+ Same operation means same payload/key; resolve it before authorizing a changed one.
61
+
62
+ Reconstruct missing local history from owned OS reads and label unknowns. Urgent
63
+ authorized pause must not wait for invented strategy or complete documentation.
@@ -0,0 +1,44 @@
1
+ # Build without delivery and recover
2
+
3
+ Read artifacts and the API reference. Resolve recorded IDs through owned GETs.
4
+ If both formats are requested, create separate native campaigns under the same
5
+ product-owned group and keep the aggregate daily spend within authorization.
6
+
7
+ 1. Read account/Page, pricing and targeting; save the intended build.
8
+ 2. Create the group with product_slug and schedule. OS creates it DRAFT: LinkedIn
9
+ does not allow initial PAUSED groups. A requested "paused build" uses DRAFT
10
+ throughout; never activate parents merely to make child creation possible.
11
+ 3. Create each campaign with group ID, format, targeting, locale, daily USD budget,
12
+ CPC and schedule. OS creates it DRAFT; LinkedIn rejects PAUSED campaigns
13
+ beneath a DRAFT group.
14
+ 4. Upload each approved PNG/JPEG via `POST /ads/linkedin/images`. Poll its owned
15
+ GET until `status=AVAILABLE`; processing is asynchronous. Do not create a
16
+ new upload merely because processing is slow.
17
+ 5. Create a creative with campaign ID, owned image URN, approved copy and exact
18
+ destination. Single Image creates Direct Sponsored Content with
19
+ `feedDistribution=NONE`; it does not publish to the organic Page feed.
20
+ Text Ad uses its separate native content payload. Both creatives start DRAFT.
21
+ 6. Read back every object and parent binding; record moderation/serving reasons,
22
+ DRAFT states, image availability, budget and destination. Existing PAUSED
23
+ objects are also non-serving; preserve them when resuming work. For Single
24
+ Image the creative may read back a content reference instead of inline content;
25
+ the owned `/creatives/{id}/content` GET resolves that post for review.
26
+ 7. Save state, readback and operation outcomes; return the specific remaining
27
+ blockers. A non-serving build does not prove delivery. Creative review starts
28
+ on activation; absent review on a DRAFT creative is expected, not a reason
29
+ to activate it or wait for moderation during this build.
30
+
31
+ Uncertain create returns 409 with recovery instructions. Retry the same key/body.
32
+ If the response still requires Egbe team reconciliation, stop creation and
33
+ preserve the key: the gateway will not silently create another resource.
34
+ After an update timeout, retry the same operation for verified readback; a newer
35
+ mutation supersedes earlier update keys, so an old launch cannot undo a pause.
36
+
37
+ For Text Ads, use the bounded creative PATCH to change copy/image/destination;
38
+ it merges changed fields into fresh readback and preserves status. For Single
39
+ Image content changes, prepare an explicitly authorized new
40
+ DRAFT creative under the existing campaign, inspect it, then perform the approved
41
+ switch and pause the old creative. Do not delete history or recreate the campaign.
42
+ Creative internal names can be changed in place for both formats. If LinkedIn
43
+ rejects a field for the current creative state, report that reason; do not silently
44
+ replace the creative or change its delivery status.
@@ -0,0 +1,88 @@
1
+ # Optional conversion measurement
2
+
3
+ Use when the founder asks to measure real product outcomes in LinkedIn. A
4
+ traffic campaign can run without this setup. Work in the existing product's
5
+ auth, billing, analytics and job conventions; no scaffold or instance is needed.
6
+ Keep provider credentials in OS. Server code uses its product `OS_API_KEY`
7
+ (scope `analytics` or `ads`); configuration needs `ads`.
8
+
9
+ ## Configure and associate
10
+
11
+ 1. Read owned campaigns and conversion rules before creating anything. Reuse the
12
+ rule for the same product outcome and source. Inspect exact schemas in OpenAPI.
13
+ 2. Create `POST /ads/linkedin/conversion-rules` with an owned `campaign_id`,
14
+ `name`, `type` (e.g. SIGN_UP or PURCHASE), and `method`:
15
+ `INSIGHT_TAG` for an event-specific browser rule or `CONVERSIONS_API` for a
16
+ server rule. The campaign resolves ownership; creation does **not** attach it.
17
+ 3. Explicitly `PUT /ads/linkedin/campaigns/{campaign_id}/conversion-rules/{id}`
18
+ for each approved campaign; GET the same path to confirm `associated:true`.
19
+ This is measurement association, not campaign activation or conversion bidding.
20
+ DELETE detaches only this pair. PATCH the rule with `enabled:false` to disable
21
+ it; do not delete/recreate rules to fix reporting delays.
22
+
23
+ Mutations require a persisted Idempotency-Key. Save rule IDs, method, campaign
24
+ associations, readback and actual event hooks in tracking.json. Do not automatically
25
+ associate every campaign in the shared account.
26
+
27
+ ## Browser
28
+
29
+ For the owned browser rule, GET `/conversion-rules/{id}/browser-tag` to read the
30
+ existing shared Insight Tag. Install its returned public `insight_tag.tag` once
31
+ using the project's script conventions; never expose OS credentials. If the
32
+ account tag is missing, report the Egbe team prerequisite; don't create or change
33
+ shared tags, domain permissions or audiences.
34
+
35
+ Fire `window.lintrk("track", {conversion_id: Number(ruleId), event_id: providerEventId})`
36
+ on the actual completed outcome, not a button click or generic success-page load.
37
+ Use the rule's returned `event_id_prefix` plus the same stable product event ID
38
+ used below. The prefix isolates products sharing one LinkedIn account.
39
+
40
+ ## Server
41
+
42
+ Call `POST /ads/linkedin/conversion-events` after the authoritative product
43
+ operation succeeds: a committed registration, or a verified paid invoice/event.
44
+ Use one stable opaque `event_id` per business event (not a fresh ID per retry),
45
+ its original Unix-millisecond `happened_at`, and:
46
+
47
+ - `email_sha256`: lowercase hex SHA-256 of trimmed, lowercase email; and/or
48
+ - `linkedin_tracking_uuid`: genuine `li_fat_id` captured by the product.
49
+ - Optional `value: {"currency_code":"USD","amount":"19.00"}` for the real value.
50
+
51
+ Only send user identifiers the product is allowed to share. Never invent a click
52
+ identifier or email. Retain retry data in the product's existing server-side
53
+ storage/queue; don't put matching identifiers into marketing artifacts. Don't
54
+ block a successful signup/payment on ad delivery.
55
+
56
+ OS adds the product namespace to `event_id`; **do not add the prefix yourself in
57
+ the server request**. For redundant browser + server measurement, use separate
58
+ rules and the same prefixed event ID in the browser. LinkedIn may credit the
59
+ browser rule and remove the duplicate from the CAPI rule. Don't sum the two as
60
+ independent outcomes or treat a low CAPI count alone as failure.
61
+
62
+ ## Verify without fake conversions
63
+
64
+ - `validate_only:true` validates the body, owned enabled server rule and a live
65
+ campaign association. It sends no event; this is **not** provider ingestion proof.
66
+ - Locally test the real event hook and outbound body with a stubbed OS response.
67
+ Do not create fictional registrations/purchases in LinkedIn to get a green check.
68
+ - Actual delivery returns a durable `receipt_id`; GET
69
+ `/conversion-events/{receipt_id}`. `accepted` means provider acceptance, not
70
+ matching or attribution. The product must inspect `data.status`, not HTTP alone.
71
+ - `retryable`: fix access for 401/403, wait until `retry_at_ms`, then resubmit the
72
+ identical body/key. At most five delivery attempts; no automatic OS scheduler.
73
+ `unconfirmed` means a response was lost/ambiguous: preserve the receipt for
74
+ Egbe team review, don't generate a new event/key. `rejected` or `exhausted`
75
+ also needs diagnosis, not a loop. Receipts never contain customer identifiers.
76
+ - GET `/campaigns/{campaign_id}/conversion-rules/{id}/results?date_from=YYYY-MM-DD&date_to=YYYY-MM-DD`.
77
+ Counts are attributed to that campaign/rule, including post-click and post-view.
78
+ Empty rows mean unavailable, not zero. Full conversion reporting can take up to
79
+ 72 hours; real traffic and outcomes are needed to prove attribution.
80
+
81
+ Report separately: configuration/association, implementation of the product
82
+ hook, actual provider acceptance, and attributed results. Leave the last two
83
+ unverified until real events exist.
84
+
85
+ [Conversion contracts](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversions-api-schema),
86
+ [Insight Tag](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversion-tracking),
87
+ [Deduplication](https://learn.microsoft.com/en-us/linkedin/marketing/conversions/deduplication),
88
+ [Reporting delay](https://learn.microsoft.com/en-us/linkedin/marketing/conversions/conversions-faq).
@@ -0,0 +1,49 @@
1
+ # Launch and pause
2
+
3
+ Launch requires authorization for the selected campaign(s), targeting,
4
+ daily USD budgets and delivery schedule. Read current provider state and resolve
5
+ pending mutations. Recheck wallet availability and provider moderation/serving
6
+ holds; report blocked eligibility instead of claiming the ads are running.
7
+
8
+ Activate in this order:
9
+ 1. Group launch from DRAFT or PAUSED, with all child campaigns DRAFT or PAUSED.
10
+ 2. Selected campaign launch with wallet authorization.
11
+ 3. Selected creatives launch; this also starts their moderation.
12
+
13
+ For a DRAFT group or campaign whose start has passed, OS moves the start to
14
+ approximately one minute after the launch request, preserving its end, budget
15
+ and other settings. Future starts and PAUSED resumes stay unchanged. An expired
16
+ end window requires a newly authorized schedule; OS never extends it. Retry a
17
+ refused launch with the same key; no replacement objects are needed.
18
+
19
+ Activating a group containing active campaigns is rejected: first pause those
20
+ campaigns, activate the group, then explicitly launch selected campaigns. This
21
+ prevents group activation from bypassing campaign wallet authorization.
22
+ Campaign activation, a live campaign budget change, or creative activation beneath
23
+ an already active campaign reserves two daily budgets in Egbe wallet before the
24
+ provider change. A hold is a reservation, not a charge or a LinkedIn spend cap.
25
+ Daily budgets are pacing controls, not a promise of exact daily spend.
26
+
27
+ Read back group, campaign and creatives after launch and record intended status
28
+ separately from actual serving. Do not wait in a loop for impressions to call
29
+ configuration verified. This operation does not schedule future checks.
30
+
31
+ Pause the exact campaign with `POST /campaigns/{id}/pause` and a durable key.
32
+ Pause remains available when the mutation quota is exhausted. Campaign pause
33
+ releases its current reserve after readback; delayed actual spend can still settle.
34
+ Group pause stops its children and releases owned campaign holds, but preserves
35
+ their native individual status. Pause on an already DRAFT group, campaign or
36
+ creative is a verified no-op and returns DRAFT; it never activates an object
37
+ to make PAUSED attainable.
38
+ Pausing one creative may leave others delivering:
39
+ use campaign pause for a complete stop.
40
+ Record the requested trigger/authority in the existing change-log, then append
41
+ the affected ID, actual confirmation time and readback after success. Preserve
42
+ the known cause for this run; later balance or deadline changes do not replace it.
43
+ If the provider exposes no cause, record it as unknown. A later relaunch does not
44
+ reuse the earlier stop timestamp. A failed pause or stopped monitoring alone is
45
+ not a confirmed stop.
46
+
47
+ Archive/cleanup leaves DRAFT objects non-serving, pauses other owned
48
+ groups/campaigns/creatives and retains image/history
49
+ resources; it never changes another product's objects or deletes the Page.
@@ -0,0 +1,35 @@
1
+ # Read results and change settings
2
+
3
+ Resolve the selected campaign from artifacts or owned lists. Read the campaign,
4
+ group, creatives and results for explicit inclusive UTC dates. Today is supported
5
+ but partial. Return fetched_at, requested dates, provider ranges, currency and
6
+ any error/unknown status with the observations.
7
+
8
+ Inspect delivery/moderation/serving-hold fields first when spend or impressions
9
+ are missing. Account eligibility, schedule, audience, CPC and creative review
10
+ can each prevent serving despite ACTIVE configuration. Do not infer the cause
11
+ from zero alone or automatically raise bids.
12
+
13
+ `metrics:null` / `data_status=unavailable` is not zero: LinkedIn can return an
14
+ empty report both for no activity and missing reporting access. A real provider
15
+ row containing zeros is observed zero. API failures remain failures.
16
+ Older ranges may be rounded to full months; inspect observed_ranges.
17
+ Clicks, product visits and product outcomes have different meanings; do not label
18
+ a UTM product signup as a provider-attributed conversion.
19
+ If provider conversions were configured, use the
20
+ [conversions workflow](conversions.md) for the selected campaign/rule report.
21
+ An accepted event receipt isn't a conversion count; report the two separately.
22
+
23
+ Registry periodically synchronizes cumulative actual campaign spend into wallet.
24
+ The launch hold is not a second charge. Report unsupported currency, missing
25
+ reporting permission or unavailable cumulative spend as a billing-sync blocker;
26
+ never settle missing data as zero. Historical data beyond provider retention
27
+ requires Egbe team reconciliation.
28
+
29
+ ## Changes
30
+
31
+ Read before changing. `PATCH /campaigns/{id}` changes only supplied name, daily
32
+ budget, CPC, targeting or schedule; it does not change status, format or objective.
33
+ Preserve omitted settings. Confirm fresh readback and append the reason/evidence
34
+ and authorization to change-log. Monitoring alone authorizes no mutations.
35
+ Use the build workflow for creative replacement; do not guess a raw PATCH body.
@@ -0,0 +1,63 @@
1
+ # Readiness
2
+
3
+ Call `GET /ads/linkedin/readiness` and `GET /ads/linkedin/account`.
4
+ Record account ID, USD currency, linked organization URN, status, serving holds
5
+ and timestamp in channel-readiness. Check the Page is the intended advertiser.
6
+ A successful account GET verifies read access only. `ready:null` means remaining
7
+ permissions/serving checks are unverified, not a green light to spend.
8
+
9
+ The Egbe team supplies a verified/approved LinkedIn developer app, an enabled USD
10
+ Campaign Manager account with billing, and member OAuth access. The member needs
11
+ the appropriate account management role and Page role for Direct Sponsored Content.
12
+ Client ID/secret alone cannot manage campaigns: LinkedIn Marketing uses member
13
+ authorization, not client-credentials OAuth. Development access may require the
14
+ selected account on the app's allowlist.
15
+
16
+ If access is missing, return the precise failing operation/status and required
17
+ action from the Egbe team. Do not create disposable campaigns merely to probe permissions.
18
+ The requested non-serving DRAFT build is the controlled write test; report which steps
19
+ succeeded and which permissions remain unverified.
20
+
21
+ ## Egbe admin configuration (not product credentials)
22
+
23
+ Tools deployment reads:
24
+ - `LINKEDIN_ADS_CLIENT_ID`, `LINKEDIN_ADS_CLIENT_SECRET`;
25
+ - `LINKEDIN_ADS_ACCESS_TOKEN`, `LINKEDIN_ADS_ACCESS_TOKEN_EXPIRES_AT`;
26
+ - optional `LINKEDIN_ADS_REFRESH_TOKEN`, `LINKEDIN_ADS_REFRESH_TOKEN_EXPIRES_AT`;
27
+ - `LINKEDIN_ADS_ACCOUNT_ID`, `LINKEDIN_ADS_REDIRECT_URI`;
28
+ - `LINKEDIN_ADS_API_VERSION` (YYYYMM, currently 202608).
29
+
30
+ Expiry values are Unix seconds. Blank refresh fields are legitimate: programmatic
31
+ refresh is available only when LinkedIn grants it. Without refresh, the Egbe team
32
+ must renew member consent before access expires. Gateway refreshes near expiry
33
+ when a valid refresh token is configured; it does not rotate the configured
34
+ refresh token or write secrets back to the repository.
35
+
36
+ Register the exact redirect URI in the LinkedIn app. OAuth setup by an Egbe admin:
37
+ 1. Open `https://www.linkedin.com/oauth/v2/authorization` with URL-encoded
38
+ `response_type=code`, `client_id`, `redirect_uri`, random `state` and the
39
+ app-approved scopes (`rw_ads`, `r_ads`, `r_ads_reporting`; applicable organization
40
+ social permissions for image/DSC operations).
41
+ 2. The authorized member signs in and consents; verify returned state locally.
42
+ 3. Exchange the one-time code server-side at
43
+ `https://www.linkedin.com/oauth/v2/accessToken` with form fields
44
+ `grant_type=authorization_code`, code, identical redirect_uri, client_id,
45
+ client_secret. Save returned tokens/expiry only in Egbe's restricted secret storage.
46
+ 4. Configure the account ID from Campaign Manager; the gateway discovers its Page
47
+ through account `reference`. Do not put Page identity into product source.
48
+
49
+ Exact permissions depend on the approved API products:
50
+ [Marketing authentication](https://learn.microsoft.com/en-us/linkedin/marketing/getting-started),
51
+ [authorization code flow](https://learn.microsoft.com/en-us/linkedin/shared/authentication/authorization-code-flow),
52
+ [refresh tokens](https://learn.microsoft.com/en-us/linkedin/shared/authentication/programmatic-refresh-tokens).
53
+
54
+ Optional conversion measurement additionally needs approved Conversions API
55
+ access and member scopes `rw_conversions`, `r_ads`. Successful rule reads do
56
+ not prove create/event-ingestion permission. Check through the requested
57
+ configuration and real events, not a throwaway conversion.
58
+
59
+ Advertising, Conversions and any future Ad Library product have independent
60
+ approval/version lifecycles. Current gateway calls are pinned to 202608; recheck
61
+ the relevant API product when changing the version, not every routine campaign.
62
+ `BILLING_HOLD` blocks serving, not necessarily DRAFT object creation; don't
63
+ change billing or launch to test this assumption. Record the provider's response.
@@ -0,0 +1,52 @@
1
+ # Targeting and creative assembly
2
+
3
+ Use the requested targeting, format, budget, copy, assets and destination.
4
+ Resolve missing operation inputs before writing; preserve unaffected settings
5
+ when editing an existing object.
6
+
7
+ Resolve targeting with `GET /ads/linkedin/targeting/facets` and
8
+ `GET /ads/linkedin/targeting/entities`. Use returned facet/entity URNs, not guessed
9
+ company names or copied example IDs. Explicit locations are required. Values
10
+ within a facet are OR; included facets are AND; exclusions remove matching members.
11
+ The first release exposes locations, industries, staff count ranges, seniorities,
12
+ job functions, titles, employers and skills.
13
+
14
+ Call audience-estimate and budget-pricing with the proposed targeting/format.
15
+ Record estimates as estimates. Check provider minimum/suggested CPC and daily
16
+ budget against the authorized amount. A too-small audience is a decision to
17
+ discuss targeting, not permission to silently broaden it. Audience expansion
18
+ and offsite delivery are disabled.
19
+
20
+ ## Two creative formats
21
+
22
+ - Single Image: image, headline, introductory text, CTA and exact landing URL.
23
+ Current gateway bounds: headline ≤200 and text ≤3000 characters.
24
+ - Text Ad: headline ≤25 and description ≤75 characters, plus image and landing URL.
25
+
26
+ These formats require separate native campaigns. Verify asset dimensions/cropping
27
+ against the current format rules below.
28
+
29
+ Use approved product assets or generate an image through Egbe OS: discover the
30
+ current `images` capability via `GET $OS_URL/`, read its live skill and exact
31
+ generation contract. Save the resulting PNG/JPEG locally, inspect its readability
32
+ and claims, then upload its bytes through LinkedIn images. An OS-generated URL,
33
+ an image URN and a creative ID are different things; only the returned LinkedIn
34
+ `urn:li:image:...` goes in `image_id`. No embedded credentials or external
35
+ provider keys are needed.
36
+
37
+ Read the format's current rules before producing final assets:
38
+ [Single Image](https://business.linkedin.com/advertise/ads/sponsored-content/single-image-ads),
39
+ [Text Ads](https://business.linkedin.com/advertise/ads/text-ads),
40
+ [Advertising policies](https://www.linkedin.com/legal/ads-policy).
41
+ Use truthful, substantiated claims and a matching destination. No deceptive UI,
42
+ unsupported endorsements or fabricated customer proof.
43
+
44
+ ## Measurement
45
+
46
+ Bind stable UTMs before creative creation. Read the product's Egbe analytics
47
+ workflow when integrating attribution; reuse existing tracking rather than adding
48
+ a second tracker. Verify destination preserves the intended path/query and that
49
+ product analytics can distinguish the campaign. Record unverified attribution.
50
+ Traffic impressions/clicks are available independently of Insight Tag/CAPI.
51
+ If provider outcome measurement is requested, follow [Conversions](conversions.md).
52
+ It is optional and does not implicitly change the approved traffic strategy.