@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,357 @@
1
+ #!/usr/bin/env python3
2
+ """Add opt-in workspace identity to curl requests to the configured Egbe URL.
3
+
4
+ Requests made only to that URL with supported options send the installed catalog
5
+ release. Those with a single destination are also traced: they exit 22 on an HTTP
6
+ status of 400 or above (the body is still printed, as with `curl --fail-with-body`)
7
+ and end with one stderr line
8
+ `egbe-curl: status=<code> request_id=<id> route=<METHOD> <path> catalog=<release>`.
9
+ `--egbe-run <command>` instead starts a bundled client with the saved settings
10
+ from `.env.local` in its environment.
11
+ """
12
+ import os
13
+ import json
14
+ from pathlib import Path
15
+ import re
16
+ import shlex
17
+ import subprocess
18
+ import sys
19
+ import tempfile
20
+ from urllib.parse import quote, urlsplit
21
+ from uuid import UUID
22
+
23
+ CATALOG_DIGEST = re.compile(r"[a-f0-9]{64}")
24
+ MAX_MANIFEST_BYTES = 8 * 1024 * 1024
25
+ DATA_OPTIONS = {"-d", "--data", "--data-raw", "--data-binary", "--data-urlencode", "-F", "--form", "--form-string"}
26
+ SUPPORTED_VALUE_OPTIONS = DATA_OPTIONS | {"-H", "--header", "-X", "--request", "-o", "--output", "-w", "--write-out",
27
+ "--max-time", "--connect-timeout", "--retry", "--retry-delay",
28
+ "--retry-max-time", "-A", "--user-agent", "--url"}
29
+
30
+
31
+ def project_environment(settings_file=None, *, saved_credentials=False):
32
+ values = {}
33
+ path = Path(settings_file) if settings_file else Path.cwd() / ".env.local"
34
+ if path.is_symlink():
35
+ raise ValueError("Load connection settings from a regular project-local .env.local file")
36
+ if path.is_file():
37
+ for line in path.read_text().splitlines():
38
+ match = re.match(r"(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)=(.*)", line.strip())
39
+ if match and (match[1] in {"OS_URL", "OS_API_KEY", "OS_WORKSPACE_NAME"} or match[1].startswith("OS_CONNECTION_ID_")
40
+ or (settings_file and match[1] == "OS_AGENT_NAME")):
41
+ parts = shlex.split(match[2], comments=True)
42
+ if len(parts) <= 1:
43
+ values[match[1]] = parts[0] if parts else ""
44
+ # Saved scheduler snapshots own their agent name. Interactive credential
45
+ # files keep the actual agent shell-local; only that name may fall back.
46
+ # UUIDs, nicknames and destination always belong to the selected file.
47
+ if settings_file:
48
+ values.setdefault("OS_AGENT_NAME", os.environ.get("OS_AGENT_NAME", ""))
49
+ return values
50
+ # Identity belongs to this workspace, never an ambient previous project.
51
+ values.update({key: value for key, value in os.environ.items()
52
+ if not (key.startswith("OS_CONNECTION_ID_") or key == "OS_WORKSPACE_NAME"
53
+ or (saved_credentials and key in {"OS_URL", "OS_API_KEY"}))})
54
+ return values
55
+
56
+
57
+ def catalog_release(script=__file__):
58
+ """The skills catalog release of this installation, or None.
59
+
60
+ `.egbe-catalog/manifest.json` beside the installed skills records the
61
+ published skills archive digest the last refresh reconciled. While a refresh
62
+ kept some skills at an earlier release (local edits or conflicts) it records
63
+ only its target, reported with `+partial`. A helper outside an installed
64
+ catalog, or an unreadable manifest, sends no release.
65
+ """
66
+ parents = Path(os.path.abspath(script)).parents
67
+ if len(parents) < 3:
68
+ return None # e.g. a pre-install copy saved directly in /tmp
69
+ path = parents[2] / ".egbe-catalog" / "manifest.json"
70
+ try:
71
+ if path.is_symlink() or not path.is_file() or path.stat().st_size > MAX_MANIFEST_BYTES:
72
+ return None
73
+ manifest = json.loads(path.read_text())
74
+ except (OSError, ValueError):
75
+ return None
76
+ if not isinstance(manifest, dict):
77
+ return None
78
+ reconciled, target = manifest.get("reconciled"), manifest.get("target")
79
+ if isinstance(reconciled, str) and CATALOG_DIGEST.fullmatch(reconciled):
80
+ return reconciled
81
+ if isinstance(target, str) and CATALOG_DIGEST.fullmatch(target):
82
+ return target + "+partial"
83
+ return None
84
+
85
+
86
+ def curl_destinations(arguments):
87
+ # Consume curl option values before classifying URLs. Extra known options
88
+ # remain pass-through for other hosts, but are not enabled for identity calls.
89
+ value_options = set("""
90
+ --abstract-unix-socket --alt-svc --aws-sigv4 --cacert --capath --cert --cert-type --ciphers
91
+ --config --connect-timeout --connect-to --continue-at --cookie --cookie-jar
92
+ --create-file-mode --crlfile --curves --data --data-ascii --data-binary --data-raw
93
+ --data-urlencode --delegation --dns-interface --dns-ipv4-addr --dns-ipv6-addr --dns-servers
94
+ --doh-url --dump-header --egd-file --engine --etag-compare --etag-save --expect100-timeout
95
+ --form --form-string --ftp-account --ftp-alternative-to-user --ftp-method --ftp-port
96
+ --ftp-ssl-ccc-mode --happy-eyeballs-timeout-ms --haproxy-clientip --header --help
97
+ --hostpubmd5 --hostpubsha256 --hsts --interface --ipfs-gateway --json --keepalive-time --key
98
+ --key-type --krb --libcurl --limit-rate --local-port --login-options --mail-auth --mail-from
99
+ --mail-rcpt --max-filesize --max-redirs --max-time --netrc-file --noproxy --oauth2-bearer
100
+ --output --output-dir --parallel-max --pass --pinnedpubkey --preproxy --proto
101
+ --proto-default --proto-redir --proxy --proxy-cacert --proxy-capath --proxy-cert
102
+ --proxy-cert-type --proxy-ciphers --proxy-crlfile --proxy-header --proxy-key
103
+ --proxy-key-type --proxy-pass --proxy-pinnedpubkey --proxy-service-name
104
+ --proxy-tls13-ciphers --proxy-tlsauthtype --proxy-tlspassword --proxy-tlsuser --proxy-user
105
+ --pubkey --quote --random-file --range --rate --referer --request --request-target --resolve
106
+ --retry --retry-delay --retry-max-time --sasl-authzid --service-name --socks4 --socks4a
107
+ --socks5 --socks5-gssapi-service --socks5-hostname --speed-limit --speed-time --stderr
108
+ --telnet-option --tftp-blksize --time-cond --tls-max --tls13-ciphers --tlsauthtype
109
+ --tlspassword --tlsuser --trace --trace-ascii --trace-config --unix-socket --upload-file
110
+ --url --url-query --user --user-agent --variable --write-out
111
+ """.split()) | {"-" + char for char in "ACDEFHKPQTUXYbcdehmortuwxyz"}
112
+ flags = {"--disable", "--silent", "--show-error", "--fail", "--fail-with-body", "--include",
113
+ "--head", "--get", "--verbose", "--no-buffer", "--globoff", "--compressed",
114
+ "--http1.1", "--http2", "--no-progress-meter"}
115
+ destinations, unsupported = [], False
116
+ index = 0
117
+ while index < len(arguments):
118
+ arg = arguments[index]
119
+ option, equals, value = arg.partition("=")
120
+ if arg == "--":
121
+ destinations.extend(arguments[index + 1:])
122
+ break
123
+ if option in value_options:
124
+ unsupported |= option not in SUPPORTED_VALUE_OPTIONS
125
+ if not equals:
126
+ index += 1
127
+ if index == len(arguments):
128
+ unsupported = True
129
+ break
130
+ value = arguments[index]
131
+ if option == "--url":
132
+ destinations.append(value)
133
+ elif arg in flags or (arg.startswith("-") and not arg.startswith("--")
134
+ and set(arg[1:]) <= set("sSfIivNgG")):
135
+ pass
136
+ elif arg.startswith("-"):
137
+ unsupported = True
138
+ if not arg.startswith("--"):
139
+ # A value-taking short option consumes the rest of its cluster,
140
+ # or the next argument: e.g. -sdURL and -sd URL.
141
+ for position, char in enumerate(arg[1:], start=1):
142
+ if "-" + char in value_options:
143
+ if position == len(arg) - 1:
144
+ index += 1
145
+ break
146
+ else:
147
+ destinations.append(arg)
148
+ index += 1
149
+ return destinations, unsupported
150
+
151
+
152
+ def egbe_base(environment):
153
+ return urlsplit(environment.get("OS_URL", "https://os.hz.egbe.dev").rstrip("/"))
154
+
155
+
156
+ def is_egbe_url(url, base):
157
+ def origin(value):
158
+ port = value.port if value.port is not None else {"http": 80, "https": 443}.get(value.scheme)
159
+ return value.scheme, value.hostname, port
160
+ try:
161
+ target = urlsplit(url)
162
+ return target.hostname == base.hostname and origin(target) == origin(base) and (
163
+ not base.path or target.path == base.path or target.path.startswith(base.path + "/"))
164
+ except ValueError:
165
+ return False
166
+
167
+
168
+ def egbe_destinations(arguments, environment):
169
+ """The URLs of a request made only to the Egbe URL with supported options, else []."""
170
+ destinations, unsupported = curl_destinations(arguments)
171
+ base = egbe_base(environment)
172
+ if unsupported or not destinations or not all(is_egbe_url(url, base) for url in destinations):
173
+ return []
174
+ return destinations
175
+
176
+
177
+ def command(arguments, environment):
178
+ result = ["curl"]
179
+ base = egbe_base(environment)
180
+ destinations, unsupported = curl_destinations(arguments)
181
+ matches = [is_egbe_url(url, base) for url in destinations]
182
+ agent = environment.get("OS_AGENT_NAME", "")
183
+ ambiguous_destination = any("://" not in url and is_egbe_url(
184
+ base.scheme + "://" + url, base) for url in destinations)
185
+ if (any(matches) or ambiguous_destination) and agent:
186
+ if unsupported:
187
+ raise ValueError("Use supported explicit curl options for identified Egbe requests")
188
+ if not destinations or not all(is_egbe_url(url, base) for url in destinations):
189
+ raise ValueError("Use separate curl commands for Egbe and other destinations")
190
+ # Ignore ambient curl config only for identified requests: it may add
191
+ # extra destinations or redirects. Other curl commands stay unchanged.
192
+ result.append("--disable")
193
+ slug = re.sub(r"[^A-Z0-9]+", "_", agent.upper()).strip("_")
194
+ connection = environment.get("OS_CONNECTION_ID_" + slug)
195
+ if not connection:
196
+ raise ValueError("Run Egbe quickstart to save this agent's workspace connection ID first")
197
+ connection = str(UUID(connection))
198
+ labels = [("X-Egbe-Agent-Name", agent)]
199
+ workspace = environment.get("OS_WORKSPACE_NAME")
200
+ if workspace:
201
+ labels.append(("X-Egbe-Workspace-Name", workspace))
202
+ for _, label in labels:
203
+ if not re.fullmatch(r"[A-Za-z0-9_ .()+-]{1,80}", label) or not label.strip():
204
+ raise ValueError("Connection labels must be plain ASCII nicknames of 1–80 characters")
205
+ result += ["-H", "X-Egbe-Connection-Id: " + connection]
206
+ for name, label in labels:
207
+ result += ["-H", name + ": " + label]
208
+ release = catalog_release() if egbe_destinations(arguments, environment) else None
209
+ if release:
210
+ if result == ["curl"] and arguments[:1] == ["--disable"]:
211
+ # --disable only works as curl's first option.
212
+ result, arguments = ["curl", "--disable"], arguments[1:]
213
+ result += ["-H", "X-Egbe-Catalog-Release: " + release]
214
+ return result + arguments
215
+
216
+
217
+ def request_method(arguments):
218
+ """The HTTP method curl uses for these (supported) options."""
219
+ method, head, get, data = None, False, False, False
220
+ index = 0
221
+ while index < len(arguments) and arguments[index] != "--":
222
+ arg = arguments[index]
223
+ option, equals, value = arg.partition("=")
224
+ if option in SUPPORTED_VALUE_OPTIONS:
225
+ if not equals:
226
+ index += 1
227
+ value = arguments[index] if index < len(arguments) else ""
228
+ if option in {"-X", "--request"}:
229
+ method = value.upper()
230
+ data |= option in DATA_OPTIONS
231
+ elif arg == "--head" or (arg.startswith("-") and not arg.startswith("--") and "I" in arg):
232
+ head = True
233
+ elif arg == "--get" or (arg.startswith("-") and not arg.startswith("--") and "G" in arg):
234
+ get = True
235
+ index += 1
236
+ return method or ("HEAD" if head else "GET" if get or not data else "POST")
237
+
238
+
239
+ def responses(headers):
240
+ """(status, request ID) of each final response in a curl header dump."""
241
+ found = []
242
+ for line in headers.splitlines():
243
+ status = re.match(r"HTTP/\S+\s+(\d{3})\b", line)
244
+ if status:
245
+ found.append([status[1], "-"])
246
+ continue
247
+ request_id = re.match(r"(?i)x-egbe-request-id:\s*([A-Za-z0-9-]{1,64})\s*$", line)
248
+ if request_id and found:
249
+ found[-1][1] = request_id[1]
250
+ return [(status, request_id) for status, request_id in found if not status.startswith("1")]
251
+
252
+
253
+ def trailer_release(release):
254
+ """The short form of a catalog release in the trailer: 12 hex digits, `+partial` kept."""
255
+ if not release:
256
+ return "-"
257
+ digest, partial, _ = release.partition("+")
258
+ return digest[:12] + ("+partial" if partial else "")
259
+
260
+
261
+ def trailer(status, request_id, method, url, release=None):
262
+ path = urlsplit(url).path or "/"
263
+ # Quotes and backslashes are encoded too, so the line reads the same inside a JSON string.
264
+ path = re.sub(r'[^\x21-\x7e]|["\\]', lambda match: quote(match[0]), path)[:200]
265
+ return f"egbe-curl: status={status} request_id={request_id} route={method} {path} catalog={trailer_release(release)}"
266
+
267
+
268
+ def run_traced(args, arguments, url):
269
+ """Run curl for one destination, then report its response and fail on an HTTP error status."""
270
+ descriptor, dump = tempfile.mkstemp(prefix="egbe-curl-", suffix=".headers")
271
+ os.close(descriptor)
272
+ try:
273
+ start = 2 if args[1:2] == ["--disable"] else 1
274
+ code = subprocess.run(args[:start] + ["-D", dump] + args[start:]).returncode
275
+ with open(dump, errors="replace") as stream:
276
+ final = responses(stream.read())
277
+ finally:
278
+ os.unlink(dump)
279
+ # Retries or a proxy CONNECT add earlier responses; the last one is the answer.
280
+ status, request_id = final[-1] if final else ("000", "-")
281
+ if code == 0 and int(status) >= 400:
282
+ code = 22 # curl's own --fail exit code; the body was still printed.
283
+ try:
284
+ # Keep the trailer on its own line when the body shares the stream.
285
+ separate = not os.path.samestat(os.fstat(1), os.fstat(2))
286
+ except OSError:
287
+ separate = True
288
+ sys.stdout.flush()
289
+ line = trailer(status, request_id, request_method(arguments), url, catalog_release())
290
+ print(("" if separate else "\n") + line, file=sys.stderr)
291
+ return code
292
+
293
+
294
+ def connection_headers(url, settings_file=None):
295
+ try:
296
+ args = command([url], project_environment(settings_file))
297
+ return dict(args[index + 1].split(": ", 1) for index, arg in enumerate(args) if arg == "-H")
298
+ except (ValueError, OSError):
299
+ return {}
300
+
301
+
302
+ def run_with_settings(arguments):
303
+ """Run a bundled client with the project's saved connection settings in its environment.
304
+
305
+ `.env.local` is read without executing it, as with --egbe-request: its URL, key
306
+ and identity replace ambient ones, and the command's other environment is kept."""
307
+ if not arguments:
308
+ raise ValueError("--egbe-run requires a command")
309
+ environment = project_environment(saved_credentials=True)
310
+ if not environment.get("OS_URL") or not environment.get("OS_API_KEY"):
311
+ raise ValueError("Save OS_URL and OS_API_KEY in the project-local .env.local first")
312
+ return subprocess.run(arguments, env=environment).returncode
313
+
314
+
315
+ def main():
316
+ if len(sys.argv) >= 2 and sys.argv[1] == "--egbe-run":
317
+ try:
318
+ return run_with_settings(sys.argv[2:])
319
+ except (ValueError, OSError):
320
+ print("Could not load valid project connection settings or start the command. Check .env.local and the command.",
321
+ file=sys.stderr)
322
+ return 2
323
+ if len(sys.argv) == 5 and sys.argv[1] == "--identity-headers" and sys.argv[3] == "--env-file":
324
+ print(json.dumps(connection_headers(sys.argv[2], sys.argv[4])))
325
+ return 0
326
+ if len(sys.argv) == 3 and sys.argv[1] == "--identity-headers":
327
+ print(json.dumps(connection_headers(sys.argv[2])))
328
+ return 0
329
+ try:
330
+ arguments = sys.argv[1:]
331
+ saved_request = bool(arguments and arguments[0] == "--egbe-request")
332
+ environment = project_environment(saved_credentials=saved_request)
333
+ if saved_request:
334
+ if len(arguments) < 2 or not arguments[1].startswith('/') or arguments[1].startswith('//'):
335
+ raise ValueError("--egbe-request requires an API path beginning with a single slash")
336
+ endpoint, options = arguments[1], arguments[2:]
337
+ destinations, unsupported = curl_destinations(options)
338
+ if destinations or unsupported:
339
+ raise ValueError("Use supported curl options without destinations or redirects with --egbe-request")
340
+ base, key = environment.get("OS_URL"), environment.get("OS_API_KEY")
341
+ if not base or not key:
342
+ raise ValueError("Save OS_URL and OS_API_KEY in the project-local .env.local first")
343
+ arguments = ["--disable", base.rstrip('/') + endpoint, "-H", "Authorization: Bearer " + key, *options]
344
+ args = command(arguments, environment)
345
+ destinations = egbe_destinations(arguments, environment)
346
+ except (ValueError, OSError):
347
+ print("Could not load valid project connection settings or safely attach identity headers. Check .env.local and the Egbe quickstart.", file=sys.stderr)
348
+ return 2
349
+ if len(destinations) == 1:
350
+ # A dump of several transfers cannot be attributed to their URLs once
351
+ # retries or a proxy add responses, so only single requests are traced.
352
+ return run_traced(args, arguments, destinations[0])
353
+ return subprocess.run(args).returncode
354
+
355
+
356
+ if __name__ == "__main__":
357
+ raise SystemExit(main())
@@ -0,0 +1,152 @@
1
+ ---
2
+ name: egbe-os-quiz-funnel
3
+ description: Implement and verify an accepted interactive quiz, its answer-dependent results, conversion handoffs and measurement.
4
+ metadata:
5
+ egbe-when: "Use when implementing an agreed quiz or inspecting reference funnels to resolve a specific UX question."
6
+ egbe-visible: "true"
7
+ egbe-title: "Quiz funnels"
8
+ egbe-description: "Build an interactive quiz with personalized results, booking, signup or payment handoffs and reliable measurement."
9
+ egbe-category: "Marketing & growth"
10
+ ---
11
+
12
+ <!-- egbe-mcp-connection:v1 -->
13
+ This skill comes with the Egbe plugin. If this project has its own installed copy
14
+ of the skill, use that copy instead. Otherwise make every Egbe API call it
15
+ describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
16
+ PUT, PATCH and DELETE (with `method`). Pass the API path (for example
17
+ `/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
18
+ `egbe-curl.py` and catalog update checks; the connection authenticates and
19
+ identifies the request. Also pass the `business` that `egbe_setup` returned.
20
+ Where this skill sends an `Idempotency-Key` header, pass the same value as
21
+ `idempotency_key` and reuse it when retrying. A result with a `continuation`
22
+ holds one part of a long body; read the next part with `egbe_read`, the same
23
+ `path` and `business`, and that `continuation`.
24
+ Read bundled files beside this `SKILL.md`. For published skill resources on
25
+ Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
26
+
27
+ Publishing works through the connector: commit the app's files with the JSON
28
+ commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
29
+ commit SHA; no git push or workspace setup is needed. A step that needs a local
30
+ project key or a bundled script, such as a local `npx convex deploy`, needs a
31
+ set-up project workspace. In a persistent
32
+ project workspace that is not set up yet, set it up as the `egbe-setup` skill's
33
+ project setup describes.
34
+ Without such a workspace, or if it refuses, tell the founder that this step needs
35
+ an agent with a set-up project folder, and continue with the rest of the work.
36
+
37
+ If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
38
+ available, the plugin's connector is not signed in for this agent. Tell
39
+ the founder how to connect it, as the `egbe-setup` skill describes, rather than
40
+ saying Egbe is unavailable.
41
+
42
+ The connector's tools work even where this environment's shell cannot reach
43
+ Egbe: their calls travel through this agent's connection, not through the
44
+ shell's network. A step that runs in the shell, such as a bundled script, a `git
45
+ push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
46
+ Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
47
+ before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
48
+ the founder: they allow that host in this agent's network settings or continue
49
+ with an agent on their own computer. Code can also be published without the
50
+ shell by committing through the connector (`egbe-os-git`, "Without a terminal").
51
+ Until the shell step or that commit and its deploy succeed, do not report the
52
+ work as published: a preview in this agent or on this computer is not an Egbe
53
+ deployment.
54
+
55
+ Run a script bundled with this skill from the root of a project folder set up
56
+ for Egbe, with `OS_AGENT_NAME="<your agent name>"` set inline, such as `OpenCode`.
57
+ A script that calls Egbe reads `OS_URL`, `OS_API_KEY` and this agent's connection
58
+ ID from `.env.local` through Egbe's request helper, which comes with the plugin at
59
+ `../egbe-os-quickstart/scripts/egbe-curl.py` from this skill's folder. Where this
60
+ skill says a script needs `OS_URL` or `OS_API_KEY` in its environment, start it
61
+ through the helper, which loads `.env.local` without executing it:
62
+ `python3 <helper> --egbe-run <command>`, with the helper's absolute path. Where
63
+ this skill writes `<skills-directory>`, use the plugin's `skills` folder, which
64
+ holds this skill's folder.
65
+
66
+
67
+ # Quiz Funnel
68
+
69
+ Implement the accepted experience in the product's application. This skill owns
70
+ the executable specification, quiz runtime, integration and technical checks;
71
+ it does not choose whether the product needs a quiz or prescribe its UX method.
72
+
73
+ ## Through the Egbe connector
74
+
75
+ Through the connector alone, you can write the specification, keeping
76
+ `quiz.json` in Egbe's artifact store (`egbe-os-quickstart` →
77
+ `references/artifact-sync.md` ("Through the Egbe connector")), and change and
78
+ publish product code with `egbe-os-git` ("Without a terminal") and
79
+ `egbe-os-deploy`.
80
+
81
+ Through the Egbe connector, compile with `POST /quiz/compile {spec}` (step 2): it
82
+ returns the same files `scripts/compile-quiz-spec.py` writes, byte for byte, so
83
+ no workspace is needed for compilation. The runtime checks still need a set-up
84
+ project workspace: in a persistent project workspace not set up yet, call
85
+ `egbe_local_setup`; otherwise tell the founder which step needs it. The runtime
86
+ reads the compiler's output, so an uncompiled quiz is not ready to release.
87
+
88
+ ## Start from the task
89
+
90
+ Reuse the request and accepted project decisions for the audience, questions,
91
+ results and intended next action. Resolve only missing or conflicting inputs
92
+ needed for the current work; see [inputs](references/inputs.md). Planning,
93
+ reference research, local implementation and release are distinct scopes, not
94
+ mandatory stages of every request.
95
+
96
+ For a focused reference investigation, use the optional
97
+ [competitor teardown](references/competitor-teardown.md) and its local
98
+ [observation contract](references/walk-mechanics.v2.json). Research is not a
99
+ compiler prerequisite and need not be repeated to correct an existing quiz.
100
+
101
+ ## Implement the accepted experience
102
+
103
+ 1. Write `egbe-docs/product/quizzes/<quiz-slug>/quiz.json` using the
104
+ [specification contract](references/spec-contract.md). Reuse existing project
105
+ context; no separate approval ledger is required. Check that the bundled
106
+ runtime supports the accepted behavior before choosing it. If it does not,
107
+ explain the mismatch and use the product's implementation path rather than
108
+ silently changing the experience to fit this engine.
109
+ 2. Compile the specification:
110
+
111
+ ```bash
112
+ python3 <skill-root>/scripts/compile-quiz-spec.py \
113
+ --workspace <workspace-root> --quiz-slug <quiz-slug>
114
+ ```
115
+
116
+ The compiler writes `QUIZ.md`, `quiz.public.json` and `validation.json`;
117
+ do not edit these outputs by hand. It checks structure, references and
118
+ configured constraints, not whether a claim is true or an experience is good.
119
+ Read diagnostics, especially reachability that could not be verified.
120
+
121
+ Without a terminal, such as through the Egbe connector (`egbe_write`), send
122
+ the parsed specification to the same compiler:
123
+
124
+ ```bash
125
+ POST $OS_URL/quiz/compile
126
+ {"spec": <contents of quiz.json>, "quiz_slug": "<quiz-slug>"}
127
+ ```
128
+
129
+ `quiz_slug` defaults to `spec.quiz_slug`. When ready, `response.data.files`
130
+ maps each output name to its exact text, identical to the script's output,
131
+ and `response.data.report` holds the diagnostics. Write each file unchanged
132
+ into `response.data.folder`. A `422` with `status: not_ready` lists
133
+ `problems`, returns only `validation.json` in `files` and names the page
134
+ files in `delete`: remove those, fix `quiz.json` and compile again. Nothing
135
+ is stored or charged.
136
+ 3. Bind the runtime to the product's framework following
137
+ [implementation](references/implementation.md). Follow
138
+ [conversion handoffs](references/conversion-handoff.md) for the chosen
139
+ destination and [measurement](references/measurement.md) for event semantics
140
+ and delivery. Keep authentication, checkout and analytics under their existing
141
+ Egbe contracts.
142
+ 4. Use [verification](references/verification.md) for the changed behavior.
143
+ Local work does not require a commit or deployment. When release is in scope,
144
+ use the product's established release workflow and `egbe-os-deploy`, then
145
+ verify the live route without creating unintended real conversions or
146
+ polluting production analytics.
147
+
148
+ ## Handoff
149
+
150
+ Keep the quiz folder with the product's source. Return what changed, validation
151
+ performed, remaining gaps and the artifact or route the caller can inspect.
152
+ Distinguish a local build, a released route and an observed real conversion.
@@ -0,0 +1,4 @@
1
+ interface:
2
+ display_name: "Quiz Funnel"
3
+ short_description: "Build a quiz page that leads to a call, signup or payment"
4
+ default_prompt: "Use $egbe-os-quiz-funnel to build a quiz page for this product, segment, and offer. The quiz should lead to: <a call, a signup, or a payment>."