@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,652 @@
1
+ /**
2
+ * Quiz funnel engine.
3
+ *
4
+ * Holds the state of one compiled quiz (`quiz.public.json`), resolves what each
5
+ * screen and the result say for the given answers, builds the call-to-action
6
+ * destination, and describes the canonical analytics events. It never touches
7
+ * the DOM, the network, or an analytics tracker: the page supplies `storage`
8
+ * and `onEvent` and renders `snapshot()`.
9
+ */
10
+
11
+ export const PUBLIC_CONTRACT = "quiz-funnel-public-v1";
12
+
13
+ const UTM_FIELDS = [
14
+ ["utm_source", "first_utm_source"],
15
+ ["utm_medium", "first_utm_medium"],
16
+ ["utm_campaign", "first_utm_campaign"],
17
+ ["utm_content", "first_utm_content"],
18
+ ["utm_term", "first_utm_term"],
19
+ ];
20
+
21
+ const ATTRIBUTION_FIELDS = [
22
+ "visitor_id",
23
+ "visit_id",
24
+ "first_utm_source",
25
+ "first_utm_medium",
26
+ "first_utm_campaign",
27
+ "first_utm_content",
28
+ "first_utm_term",
29
+ "first_gclid",
30
+ "first_fbclid",
31
+ "first_msclkid",
32
+ "first_ttclid",
33
+ "first_landing_path",
34
+ "first_referrer",
35
+ "first_seen_at",
36
+ ];
37
+
38
+ const CTA_ROLES = {
39
+ call: "call_primary",
40
+ signup: "signup_primary",
41
+ payment: "checkout_primary",
42
+ };
43
+
44
+ const TOKEN = /\{\{\s*answer:([a-z][a-z0-9_-]{0,39})\s*\}\}/g;
45
+
46
+ /**
47
+ * How many combinations of the remaining answers the engine tries to decide a
48
+ * not_fit result early. Beyond it the visitor answers every question first.
49
+ */
50
+ const EARLY_LIMIT = 4096;
51
+
52
+ function assertSpec(spec) {
53
+ if (!spec || spec.contract !== PUBLIC_CONTRACT) {
54
+ throw new Error(`quiz specification must use the contract ${PUBLIC_CONTRACT}`);
55
+ }
56
+ if (!Array.isArray(spec.screens) || spec.screens.length === 0) {
57
+ throw new Error("quiz specification has no screens");
58
+ }
59
+ if (!Array.isArray(spec.results) || spec.results.length === 0) {
60
+ throw new Error("quiz specification has no results");
61
+ }
62
+ }
63
+
64
+ function cleanAttribution(attribution) {
65
+ const clean = {};
66
+ for (const field of ATTRIBUTION_FIELDS) {
67
+ const value = attribution?.[field];
68
+ if (typeof value === "string" && value.trim()) clean[field] = value.trim();
69
+ }
70
+ return clean;
71
+ }
72
+
73
+ function withParam(path, name, value) {
74
+ const separator = path.includes("?") ? "&" : "?";
75
+ return `${path}${separator}${encodeURIComponent(name)}=${encodeURIComponent(value)}`;
76
+ }
77
+
78
+ function copy(value) {
79
+ return JSON.parse(JSON.stringify(value));
80
+ }
81
+
82
+ function withoutQuery(path) {
83
+ return path.split("?", 1)[0];
84
+ }
85
+
86
+ function originAndPath(href) {
87
+ const url = new URL(href);
88
+ return `${url.origin}${url.pathname}`;
89
+ }
90
+
91
+ /**
92
+ * @param {object} spec Compiled public specification.
93
+ * @param {{storage?: Storage | null, onEvent?: (event: {name: string, data: object}) => void}} [options]
94
+ */
95
+ export function createQuiz(spec, options = {}) {
96
+ assertSpec(spec);
97
+
98
+ const screens = spec.screens;
99
+ const total = screens.length;
100
+ const storage = options.storage ?? null;
101
+ const emit = typeof options.onEvent === "function" ? options.onEvent : () => {};
102
+ const storageKey = `quiz-funnel:${spec.quiz_slug}`;
103
+ const questions = new Map(
104
+ screens.filter((screen) => screen.type === "question").map((screen) => [screen.id, screen]),
105
+ );
106
+ // Only the questions a result condition names can change which result is shown.
107
+ const named = new Set(
108
+ spec.results.flatMap((result) =>
109
+ result.when ? (result.when.all ?? result.when.any).map((condition) => condition.screen) : [],
110
+ ),
111
+ );
112
+
113
+ let state = restore() ?? { index: 0, answers: {} };
114
+
115
+ /** The first screen the visitor cannot pass yet: an unanswered question, or the result. */
116
+ function furthest(answers) {
117
+ const open = screens.findIndex(
118
+ (screen) => screen.type === "question" && !(answers[screen.id]?.length > 0),
119
+ );
120
+ return open === -1 ? total : open;
121
+ }
122
+
123
+ /** Every answer a question can receive: one option, or a set of a multi-select question. */
124
+ function choicesOf(question, budget) {
125
+ if (question.select === "single") {
126
+ if (question.options.length > budget) return null;
127
+ return question.options.map((option) => [option.id]);
128
+ }
129
+ const escapes = question.options.filter((option) => option.escape).map((option) => option.id);
130
+ const others = question.options.filter((option) => !option.escape).map((option) => option.id);
131
+ // Do not allocate a powerset just to discover that early-result analysis
132
+ // exceeds its budget. Large lists remain valid and complete normally.
133
+ if (2 ** others.length - 1 + escapes.length > budget) return null;
134
+ const sets = escapes.map((id) => [id]);
135
+ for (let mask = 1; mask < 2 ** others.length; mask += 1) {
136
+ sets.push(others.filter((_, bit) => Math.floor(mask / (2 ** bit)) % 2));
137
+ }
138
+ return sets;
139
+ }
140
+
141
+ /** The result a finished quiz shows for these answers: the first that matches. */
142
+ function firstMatch(answers) {
143
+ return spec.results.find((candidate) => matchesIn(candidate.when, answers)) ?? null;
144
+ }
145
+
146
+ /** The questions a headline or body of a result quotes. */
147
+ function quotedInSentences(result) {
148
+ return [result.headline, result.body].flatMap((text) =>
149
+ [...String(text ?? "").matchAll(TOKEN)].map((match) => match[1]),
150
+ );
151
+ }
152
+
153
+ /**
154
+ * The not_fit result that the answers up to the screen `upTo` decide: the
155
+ * first match for every answer the later questions could still receive. Null
156
+ * when a later answer could change the result, when the result would quote a
157
+ * question not answered yet, or when too many answers remain to be sure.
158
+ */
159
+ function decidedBy(known, upTo) {
160
+ const open = screens.filter(
161
+ (screen, index) => index > upTo && screen.type === "question" && named.has(screen.id),
162
+ );
163
+ const choices = [];
164
+ let combinations = 1;
165
+ for (const question of open) {
166
+ const next = choicesOf(question, Math.floor(EARLY_LIMIT / combinations));
167
+ if (!next) return null;
168
+ choices.push(next);
169
+ combinations *= next.length;
170
+ }
171
+ const answers = { ...known };
172
+ let decided;
173
+ const every = (depth) => {
174
+ if (depth === open.length) {
175
+ const found = firstMatch(answers);
176
+ if (!found || found.fit !== "not_fit") return false;
177
+ decided ??= found;
178
+ return decided === found;
179
+ }
180
+ return choices[depth].every((choice) => {
181
+ answers[open[depth].id] = choice;
182
+ return every(depth + 1);
183
+ });
184
+ };
185
+ if (!every(0)) return null;
186
+ return quotedInSentences(decided).every((id) => known[id]?.length > 0) ? decided : null;
187
+ }
188
+
189
+ /**
190
+ * The earliest question after which the answers decide a not_fit result: the
191
+ * result and the index of that question. Answers to later questions are not
192
+ * read, so an answer left from an earlier path changes nothing. Null when no
193
+ * question up to the first unanswered one decides such a result.
194
+ */
195
+ function decision(answers) {
196
+ const known = {};
197
+ for (let index = 0; index < total; index += 1) {
198
+ const screen = screens[index];
199
+ if (screen.type !== "question") continue;
200
+ if (!(answers[screen.id]?.length > 0)) return null;
201
+ known[screen.id] = answers[screen.id];
202
+ const result = decidedBy(known, index);
203
+ if (result) return { result, index, answers: { ...known } };
204
+ }
205
+ return null;
206
+ }
207
+
208
+ /**
209
+ * Whether a screen, or the result at `total`, can be shown for these answers.
210
+ * Once the answers decide a not_fit result, the screens after the deciding
211
+ * question are skipped.
212
+ */
213
+ function reachable(index, answers) {
214
+ if (!Number.isInteger(index) || index < 0 || index > total) return false;
215
+ const decided = decision(answers);
216
+ if (decided) return index <= decided.index || index === total;
217
+ return index <= furthest(answers);
218
+ }
219
+
220
+ function restore() {
221
+ if (!storage) return null;
222
+ let saved;
223
+ try {
224
+ saved = JSON.parse(storage.getItem(storageKey) ?? "null");
225
+ } catch {
226
+ return null;
227
+ }
228
+ if (!saved || saved.version !== spec.public_sha256) return null;
229
+ const { index, answers } = saved;
230
+ if (!answers || typeof answers !== "object" || Array.isArray(answers)) return null;
231
+ for (const [screenId, chosen] of Object.entries(answers)) {
232
+ const question = questions.get(screenId);
233
+ if (!question || !Array.isArray(chosen)) return null;
234
+ const known = new Set(question.options.map((option) => option.id));
235
+ if (chosen.some((optionId) => !known.has(optionId))) return null;
236
+ if (new Set(chosen).size !== chosen.length) return null;
237
+ if (question.select === "single" && chosen.length > 1) return null;
238
+ }
239
+ if (!Number.isInteger(index) || index < 0 || index > total) return null;
240
+ // A saved screen after the question that decides a not_fit result shows that result.
241
+ const decided = decision(answers);
242
+ const shown = decided && index > decided.index ? total : index;
243
+ if (!reachable(shown, answers)) return null;
244
+ return { index: shown, answers };
245
+ }
246
+
247
+ function save() {
248
+ if (!storage) return;
249
+ try {
250
+ storage.setItem(storageKey, JSON.stringify({ version: spec.public_sha256, ...state }));
251
+ } catch {
252
+ // Storage can be full or blocked; the quiz still works for this page view.
253
+ }
254
+ }
255
+
256
+ function current() {
257
+ return state.index < total ? screens[state.index] : null;
258
+ }
259
+
260
+ /** False when the page asks to act on a screen the visitor has already left. */
261
+ function isCurrent(expectedScreenId) {
262
+ return expectedScreenId === undefined || current()?.id === expectedScreenId;
263
+ }
264
+
265
+ function payload(surface, fields) {
266
+ return { product_slug: spec.product_slug, path: spec.route, surface, ...fields };
267
+ }
268
+
269
+ function requireQuestion(select) {
270
+ const screen = current();
271
+ if (!screen || screen.type !== "question" || screen.select !== select) {
272
+ throw new Error(`the current screen is not a ${select}-select question`);
273
+ }
274
+ return screen;
275
+ }
276
+
277
+ function requireOption(screen, optionId) {
278
+ const option = screen.options.find((candidate) => candidate.id === optionId);
279
+ if (!option) throw new Error(`screen ${screen.id} has no option ${optionId}`);
280
+ return option;
281
+ }
282
+
283
+ /** The options chosen for a question, in the order the screen lists them. */
284
+ function chosenOptions(screenId, answers = state.answers) {
285
+ const question = questions.get(screenId);
286
+ const chosen = answers[screenId] ?? [];
287
+ return question ? question.options.filter((option) => chosen.includes(option.id)) : [];
288
+ }
289
+
290
+ function matchesIn(when, answers) {
291
+ if (!when) return true;
292
+ const test = (condition) => {
293
+ const chosen = answers[condition.screen] ?? [];
294
+ if (condition.any_of) return condition.any_of.some((id) => chosen.includes(id));
295
+ return !condition.none_of.some((id) => chosen.includes(id));
296
+ };
297
+ return when.all ? when.all.every(test) : when.any.some(test);
298
+ }
299
+
300
+ function matches(when) {
301
+ return matchesIn(when, state.answers);
302
+ }
303
+
304
+ /** A headline or body: each token becomes the chosen option, worded for a sentence. */
305
+ function fillSentence(text, answers = state.answers) {
306
+ return text.replace(TOKEN, (_, screenId) => {
307
+ const [option] = chosenOptions(screenId, answers);
308
+ return option ? (option.phrase ?? option.label) : "";
309
+ });
310
+ }
311
+
312
+ /**
313
+ * A point: each token becomes the chosen options, separated by commas. The
314
+ * point is dropped when a question it quotes was declined or not answered.
315
+ */
316
+ function fillPoint(text, answers = state.answers) {
317
+ let complete = true;
318
+ const filled = text.replace(TOKEN, (_, screenId) => {
319
+ const chosen = chosenOptions(screenId, answers);
320
+ if (chosen.length === 0 || chosen.some((option) => option.escape)) {
321
+ complete = false;
322
+ return "";
323
+ }
324
+ return chosen.map((option) => option.phrase ?? option.label).join(", ");
325
+ });
326
+ return complete ? filled : null;
327
+ }
328
+
329
+ function fillPoints(points, answers = state.answers) {
330
+ return (points ?? []).map((point) => fillPoint(point, answers)).filter((point) => point !== null);
331
+ }
332
+
333
+ function proofOf(ids) {
334
+ return (ids ?? []).map((id) => ({ id, ...spec.proof[id] }));
335
+ }
336
+
337
+ /** An interstitial screen as the visitor sees it for the answers given so far. */
338
+ function resolveInterstitial(screen) {
339
+ const variant = (screen.variants ?? []).find((candidate) => matches(candidate.when)) ?? {};
340
+ const shown = { ...screen, ...variant };
341
+ const resolved = {
342
+ id: screen.id,
343
+ type: screen.type,
344
+ kind: screen.kind,
345
+ headline: fillSentence(shown.headline),
346
+ points: fillPoints(shown.points),
347
+ proof: proofOf(shown.proof_ids),
348
+ media: shown.media ?? null,
349
+ button: screen.button,
350
+ };
351
+ if (shown.body) resolved.body = fillSentence(shown.body);
352
+ return resolved;
353
+ }
354
+
355
+ function step() {
356
+ // A not_fit result appears as soon as the answers decide it: the questions
357
+ // after the deciding one could not change it.
358
+ const decided = decision(state.answers);
359
+ const next = decided && decided.index <= state.index ? total : state.index + 1;
360
+ state = { ...state, index: next };
361
+ save();
362
+ return snapshot();
363
+ }
364
+
365
+ function snapshot() {
366
+ const screen = current();
367
+ const selected = screen?.type === "question" ? [...(state.answers[screen.id] ?? [])] : [];
368
+ const position = Math.min(state.index + 1, total);
369
+ let canAdvance = false;
370
+ if (screen?.type === "interstitial") canAdvance = true;
371
+ if (screen?.type === "question" && screen.select === "multi") canAdvance = selected.length > 0;
372
+ return {
373
+ index: state.index,
374
+ total,
375
+ position,
376
+ progressLabel: spec.ui.progress
377
+ .replace("{current}", String(position))
378
+ .replace("{total}", String(total)),
379
+ atResult: screen === null,
380
+ canGoBack: state.index > 0,
381
+ canAdvance,
382
+ screen: screen?.type === "interstitial" ? resolveInterstitial(screen) : screen,
383
+ selected,
384
+ };
385
+ }
386
+
387
+ /**
388
+ * Answer the current single-select question and move to the next screen.
389
+ * Pass the id of the screen the visitor tapped on as `expectedScreenId`: a
390
+ * tap that arrives after the screen has changed is ignored.
391
+ */
392
+ function select(optionId, expectedScreenId) {
393
+ if (!isCurrent(expectedScreenId)) return snapshot();
394
+ const screen = requireQuestion("single");
395
+ requireOption(screen, optionId);
396
+ state = { ...state, answers: { ...state.answers, [screen.id]: [optionId] } };
397
+ emit({
398
+ name: "button_click",
399
+ data: payload("quiz", {
400
+ // The chosen option of a sensitive question stays out of analytics.
401
+ button_id: `${screen.id}.${screen.sensitive ? "answered" : optionId}`,
402
+ button_role: "quiz_answer",
403
+ position: state.index + 1,
404
+ }),
405
+ });
406
+ return step();
407
+ }
408
+
409
+ /** Switch one option of the current multi-select question on or off. */
410
+ function toggle(optionId, expectedScreenId) {
411
+ if (!isCurrent(expectedScreenId)) return snapshot();
412
+ const screen = requireQuestion("multi");
413
+ const option = requireOption(screen, optionId);
414
+ const chosen = state.answers[screen.id] ?? [];
415
+ let next;
416
+ if (chosen.includes(optionId)) {
417
+ next = chosen.filter((id) => id !== optionId);
418
+ } else if (option.escape) {
419
+ next = [optionId];
420
+ } else {
421
+ const escapes = new Set(
422
+ screen.options.filter((candidate) => candidate.escape).map((candidate) => candidate.id),
423
+ );
424
+ next = [...chosen.filter((id) => !escapes.has(id)), optionId];
425
+ }
426
+ state = { ...state, answers: { ...state.answers, [screen.id]: next } };
427
+ save();
428
+ return snapshot();
429
+ }
430
+
431
+ /** Leave an interstitial screen or confirm a multi-select question. */
432
+ function advance(expectedScreenId) {
433
+ if (!isCurrent(expectedScreenId)) return snapshot();
434
+ const screen = current();
435
+ if (!screen) throw new Error("the quiz is already at its result");
436
+ if (screen.type === "interstitial") {
437
+ emit({
438
+ name: "button_click",
439
+ data: payload("quiz", {
440
+ button_id: `${screen.id}.continue`,
441
+ button_role: "quiz_continue",
442
+ position: state.index + 1,
443
+ }),
444
+ });
445
+ return step();
446
+ }
447
+ if (screen.select !== "multi") {
448
+ throw new Error("a single-select question advances through select()");
449
+ }
450
+ const chosen = chosenOptions(screen.id).map((option) => option.id);
451
+ if (chosen.length === 0) throw new Error(`screen ${screen.id} needs at least one option`);
452
+ emit({
453
+ name: "button_click",
454
+ data: payload("quiz", {
455
+ button_id: `${screen.id}.continue`,
456
+ button_role: "quiz_answer",
457
+ ...(screen.sensitive ? {} : { state: chosen.join("+") }),
458
+ position: state.index + 1,
459
+ }),
460
+ });
461
+ return step();
462
+ }
463
+
464
+ /**
465
+ * Return to the previous screen. Answers are kept. From a not_fit result
466
+ * that the answers decided early, return to the question that decided it.
467
+ */
468
+ function back() {
469
+ if (state.index === total) {
470
+ const decided = decision(state.answers);
471
+ if (decided) return goTo(decided.index);
472
+ }
473
+ return goTo(state.index - 1);
474
+ }
475
+
476
+ /**
477
+ * Show a screen the visitor has already reached, for the browser's own back
478
+ * and forward. An index that is out of reach changes nothing.
479
+ */
480
+ function goTo(index) {
481
+ if (reachable(index, state.answers)) {
482
+ state = { ...state, index };
483
+ save();
484
+ }
485
+ return snapshot();
486
+ }
487
+
488
+ function restart() {
489
+ state = { index: 0, answers: {} };
490
+ try {
491
+ storage?.removeItem(storageKey);
492
+ } catch {
493
+ // Nothing to clear when storage is blocked.
494
+ }
495
+ return snapshot();
496
+ }
497
+
498
+ /**
499
+ * The result on screen and the answers it may quote: a not_fit result the
500
+ * answers decided quotes only the answers up to the deciding question.
501
+ */
502
+ function shownResult() {
503
+ if (current() !== null) return null;
504
+ const decided = decision(state.answers);
505
+ if (decided) return { result: decided.result, answers: decided.answers };
506
+ const result = firstMatch(state.answers);
507
+ return result ? { result, answers: state.answers } : null;
508
+ }
509
+
510
+ function selectedResult() {
511
+ return shownResult()?.result ?? null;
512
+ }
513
+
514
+ /**
515
+ * The result for the given answers, or null while it is not on screen: before
516
+ * the last screen is passed, unless the answers decided a not_fit result.
517
+ */
518
+ function result() {
519
+ const shown = shownResult();
520
+ if (!shown) return null;
521
+ const { result: selected, answers } = shown;
522
+ return {
523
+ id: selected.id,
524
+ fit: selected.fit,
525
+ headline: fillSentence(selected.headline, answers),
526
+ body: fillSentence(selected.body, answers),
527
+ points: fillPoints(selected.points, answers),
528
+ proof: proofOf(selected.proof_ids),
529
+ media: selected.media ?? null,
530
+ hasCta: selected.cta !== null,
531
+ };
532
+ }
533
+
534
+ /** The answers without those to sensitive questions, which stay on the page. */
535
+ function shareableAnswers() {
536
+ const shareable = {};
537
+ for (const [screenId, chosen] of Object.entries(state.answers)) {
538
+ if (!questions.get(screenId)?.sensitive) shareable[screenId] = [...chosen];
539
+ }
540
+ return shareable;
541
+ }
542
+
543
+ function bookingHref(destination, resultId, attribution) {
544
+ const url = new URL(destination.url);
545
+ const params = url.searchParams;
546
+ if (destination.result_param && !params.has(destination.result_param)) {
547
+ params.set(destination.result_param, `${spec.quiz_slug}.${resultId}`);
548
+ }
549
+ let arrivedWithCampaign = false;
550
+ for (const [param, field] of UTM_FIELDS) {
551
+ if (!attribution[field]) continue;
552
+ arrivedWithCampaign = true;
553
+ if (!params.has(param)) params.set(param, attribution[field]);
554
+ }
555
+ // Fallback values describe a visitor who arrived without any campaign
556
+ // parameters. They never complete a real campaign with invented values.
557
+ if (!arrivedWithCampaign) {
558
+ for (const [param, value] of Object.entries(destination.fallback_params ?? {})) {
559
+ if (!params.has(param)) params.set(param, value);
560
+ }
561
+ }
562
+ return url.toString();
563
+ }
564
+
565
+ function resolveDestination(selected, attribution) {
566
+ const override = selected.cta.destination;
567
+ if (override) {
568
+ const href = override.path ?? override.url;
569
+ return {
570
+ kind: "link",
571
+ href,
572
+ tracked: override.path ? withoutQuery(href) : originAndPath(href),
573
+ };
574
+ }
575
+ const destination = spec.goal.destination;
576
+ switch (destination.kind) {
577
+ case "booking_url": {
578
+ const href = bookingHref(destination, selected.id, attribution);
579
+ return { kind: "booking_url", href, tracked: originAndPath(href) };
580
+ }
581
+ case "lead_form":
582
+ return {
583
+ kind: "lead_form",
584
+ action: destination.action,
585
+ fields: [...destination.fields],
586
+ fieldLabels: { ...destination.field_labels },
587
+ submitLabel: destination.submit_label,
588
+ consentNote: destination.consent_note ?? null,
589
+ error: destination.error,
590
+ success: { ...destination.success },
591
+ payload: {
592
+ quiz_slug: spec.quiz_slug,
593
+ result_id: selected.id,
594
+ answers: shareableAnswers(),
595
+ attribution,
596
+ },
597
+ tracked: withoutQuery(destination.action),
598
+ };
599
+ case "signup":
600
+ return { kind: "signup", href: destination.path, tracked: withoutQuery(destination.path) };
601
+ case "checkout": {
602
+ const href = withParam(
603
+ destination.path,
604
+ destination.plan_param ?? "plan",
605
+ destination.plan_key,
606
+ );
607
+ return { kind: "checkout", href, tracked: withoutQuery(destination.path) };
608
+ }
609
+ default:
610
+ throw new Error(`unknown destination kind ${destination.kind}`);
611
+ }
612
+ }
613
+
614
+ /**
615
+ * The call to action of the current result: its label, the note under it,
616
+ * where it leads, and the canonical `cta_click` descriptor. Returns null
617
+ * when the result has no call to action. `attribution` is
618
+ * `window.__egbeAttribution.read()`.
619
+ */
620
+ function cta(attribution = {}) {
621
+ const selected = selectedResult();
622
+ if (!selected || selected.cta === null) return null;
623
+ const { tracked, ...destination } = resolveDestination(selected, cleanAttribution(attribution));
624
+ return {
625
+ label: selected.cta.label,
626
+ note: selected.cta.note ?? null,
627
+ destination,
628
+ event: {
629
+ name: "cta_click",
630
+ data: payload("quiz_result", {
631
+ cta_id: selected.id,
632
+ cta_role: selected.cta.destination ? "alternative" : CTA_ROLES[spec.goal.type],
633
+ label: selected.cta.label,
634
+ destination: tracked,
635
+ }),
636
+ },
637
+ };
638
+ }
639
+
640
+ return {
641
+ snapshot,
642
+ select,
643
+ toggle,
644
+ advance,
645
+ back,
646
+ goTo,
647
+ restart,
648
+ result,
649
+ cta,
650
+ answers: () => copy(state.answers),
651
+ };
652
+ }