@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,165 @@
1
+ #!/usr/bin/env python3
2
+ """Versioned input adapters for the two current organic trend Apify actors."""
3
+
4
+ from __future__ import annotations
5
+
6
+ from datetime import date, timedelta
7
+ from typing import Any
8
+
9
+ from _contract import CANONICAL_PROVIDER_RUNS, ContractError, collection_parameters, parse_rfc3339
10
+
11
+
12
+ INPUT_CONTRACT_VERSION = "apify-inputs-v1"
13
+ TIKTOK_TRANSCRIPT_MODE = "DOWNLOAD_AND_TRANSCRIBE_VIDEOS_WITHOUT_SUBTITLES"
14
+
15
+
16
+ def collection_window(context: dict[str, Any], reference_at: str) -> dict[str, Any]:
17
+ parameters = collection_parameters(context)
18
+ reference = parse_rfc3339(reference_at, "collection reference_at")
19
+ try:
20
+ oldest = (reference.date() - timedelta(days=parameters["lookback_days"])).isoformat()
21
+ except (OverflowError, ValueError) as exc:
22
+ raise ContractError("collection lookback_days exceeds the supported calendar") from exc
23
+ return {**parameters, "reference_at": reference_at, "oldest_post_date": oldest}
24
+
25
+
26
+ def validate_collection_window(context: dict[str, Any], value: Any) -> dict[str, Any]:
27
+ if not isinstance(value, dict) or value != collection_window(context, value.get("reference_at")):
28
+ raise ContractError("saved collection window does not match context")
29
+ return value
30
+
31
+
32
+ def build_discovery_inputs(
33
+ accounts: list[dict[str, Any]], context: dict[str, Any], window: dict[str, Any] | None = None,
34
+ ) -> dict[str, dict[str, Any]]:
35
+ parameters = collection_parameters(context)
36
+ if window is not None:
37
+ validate_collection_window(context, window)
38
+ lower_bound = window["oldest_post_date"] if window else f"{parameters['lookback_days']} days"
39
+ if not 1 <= len(accounts) <= 6:
40
+ raise ContractError("discovery requires 1–6 accounts")
41
+ handles: dict[str, list[str]] = {"tiktok": [], "instagram": []}
42
+ for index, account in enumerate(accounts):
43
+ if not isinstance(account, dict):
44
+ raise ContractError(f"accounts[{index}] must be an object")
45
+ platform = account.get("platform")
46
+ handle = account.get("handle")
47
+ if platform not in handles or not isinstance(handle, str) or not handle.strip():
48
+ raise ContractError(f"accounts[{index}] has invalid platform or handle")
49
+ normalized = handle.strip().lstrip("@")
50
+ if normalized not in handles[platform]:
51
+ handles[platform].append(normalized)
52
+ result: dict[str, dict[str, Any]] = {}
53
+ if handles["tiktok"]:
54
+ result["tiktok-discovery"] = {
55
+ "profiles": handles["tiktok"],
56
+ "resultsPerPage": parameters["discovery_limit_per_account"],
57
+ "profileSorting": "latest",
58
+ "oldestPostDateUnified": lower_bound,
59
+ }
60
+ if handles["instagram"]:
61
+ result["instagram-discovery"] = {
62
+ "username": handles["instagram"],
63
+ "resultsLimit": parameters["discovery_limit_per_account"],
64
+ "onlyPostsNewerThan": lower_bound,
65
+ }
66
+ return result
67
+
68
+
69
+ def build_enrichment_inputs(videos: list[dict[str, Any]]) -> dict[str, dict[str, Any]]:
70
+ selected: dict[str, list[str]] = {"tiktok": [], "instagram": []}
71
+ for index, video in enumerate(videos):
72
+ if not isinstance(video, dict) or not video.get("selected_for_analysis"):
73
+ continue
74
+ if video.get("time_window_status") != "in_window":
75
+ raise ContractError("enrichment selected an observation outside the time-window sample")
76
+ platform = video.get("platform")
77
+ url = video.get("url")
78
+ if platform not in selected or not isinstance(url, str) or not url.startswith("https://"):
79
+ raise ContractError(f"videos[{index}] has invalid selected platform or URL")
80
+ if url not in selected[platform]:
81
+ selected[platform].append(url)
82
+ if sum(len(urls) for urls in selected.values()) > 30:
83
+ raise ContractError("enrichment exceeds the v1 maximum of 30 selected videos")
84
+ result: dict[str, dict[str, Any]] = {}
85
+ if selected["tiktok"]:
86
+ result["tiktok-enrichment"] = {
87
+ "postURLs": selected["tiktok"],
88
+ "shouldDownloadVideos": True,
89
+ "downloadSubtitlesOptions": TIKTOK_TRANSCRIPT_MODE,
90
+ "commentsPerPost": 20,
91
+ }
92
+ if selected["instagram"]:
93
+ result["instagram-enrichment"] = {
94
+ "username": selected["instagram"],
95
+ "includeSharesCount": True,
96
+ "includeTranscript": True,
97
+ "includeDownloadedVideo": True,
98
+ }
99
+ return result
100
+
101
+
102
+ def validate_provider_input(logical_key: str, value: dict[str, Any]) -> None:
103
+ contract = CANONICAL_PROVIDER_RUNS.get(logical_key)
104
+ if contract is None:
105
+ raise ContractError("unknown provider logical key")
106
+ expected_keys = set(contract["input_keys"])
107
+ if set(value) != expected_keys:
108
+ raise ContractError(
109
+ f"{logical_key} input keys must be exactly {sorted(expected_keys)}"
110
+ )
111
+ if logical_key == "tiktok-discovery":
112
+ profiles = value["profiles"]
113
+ if not isinstance(profiles, list) or not 1 <= len(profiles) <= 6:
114
+ raise ContractError("TikTok discovery profiles must contain 1–6 handles")
115
+ _validate_discovery_scope(value["resultsPerPage"], value["oldestPostDateUnified"])
116
+ if value["profileSorting"] != "latest":
117
+ raise ContractError("TikTok discovery must request latest videos")
118
+ elif logical_key == "instagram-discovery":
119
+ usernames = value["username"]
120
+ if not isinstance(usernames, list) or not 1 <= len(usernames) <= 6:
121
+ raise ContractError("Instagram discovery usernames must contain 1–6 handles")
122
+ _validate_discovery_scope(value["resultsLimit"], value["onlyPostsNewerThan"])
123
+ elif logical_key == "tiktok-enrichment":
124
+ urls = value["postURLs"]
125
+ if not isinstance(urls, list) or not 1 <= len(urls) <= 30:
126
+ raise ContractError("TikTok enrichment must contain 1–30 post URLs")
127
+ if (
128
+ value["shouldDownloadVideos"] is not True
129
+ or value["downloadSubtitlesOptions"] != TIKTOK_TRANSCRIPT_MODE
130
+ or value["commentsPerPost"] != 20
131
+ ):
132
+ raise ContractError("TikTok enrichment media/transcript/comment settings are invalid")
133
+ else:
134
+ urls = value["username"]
135
+ if not isinstance(urls, list) or not 1 <= len(urls) <= 30:
136
+ raise ContractError("Instagram enrichment must contain 1–30 Reel URLs")
137
+ if not all(
138
+ value[field] is True
139
+ for field in ("includeSharesCount", "includeTranscript", "includeDownloadedVideo")
140
+ ):
141
+ raise ContractError("Instagram enrichment add-ons must be enabled")
142
+ list_field = (
143
+ "profiles"
144
+ if logical_key == "tiktok-discovery"
145
+ else "postURLs"
146
+ if logical_key == "tiktok-enrichment"
147
+ else "username"
148
+ )
149
+ if not all(isinstance(item, str) and item.strip() for item in value[list_field]):
150
+ raise ContractError(f"{logical_key} input identifiers must be non-empty strings")
151
+
152
+
153
+ def _validate_discovery_scope(limit: Any, lower_bound: Any) -> None:
154
+ if isinstance(limit, bool) or not isinstance(limit, int) or not 1 <= limit <= 30:
155
+ raise ContractError("discovery limit per account must be an integer from 1 to 30")
156
+ if isinstance(lower_bound, str):
157
+ days, separator, unit = lower_bound.partition(" ")
158
+ if separator and unit == "days" and days.isdecimal() and int(days) > 0:
159
+ return
160
+ try:
161
+ if date.fromisoformat(lower_bound).isoformat() == lower_bound:
162
+ return
163
+ except ValueError:
164
+ pass
165
+ raise ContractError("discovery lower bound must be an ISO date or a positive number of days")
@@ -0,0 +1,315 @@
1
+ #!/usr/bin/env python3
2
+ """Analyze selected video frames through OS and persist resumable receipts."""
3
+
4
+ from __future__ import annotations
5
+
6
+ import runpy as _egbe_runpy
7
+ from pathlib import Path as _EgbePath
8
+ _egbe_adapter = _EgbePath(__file__).with_name("connection_identity.py")
9
+ _connection_headers = _egbe_runpy.run_path(str(_egbe_adapter))["connection_headers"] if _egbe_adapter.is_file() else lambda _url: {}
10
+
11
+ import argparse
12
+ import base64
13
+ import json
14
+ import mimetypes
15
+ import os
16
+ import sys
17
+ import urllib.error
18
+ import urllib.request
19
+ from pathlib import Path
20
+ from typing import Any
21
+
22
+ from _contract import (
23
+ ContractError,
24
+ MEDIA_PROMPT_CONTRACT_VERSION,
25
+ MULTIMODAL_ANALYSIS_CONTRACT,
26
+ SCHEMA_VERSION,
27
+ atomic_write_json,
28
+ load_visual_analysis_instructions,
29
+ multimodal_input_sha256,
30
+ read_json,
31
+ sha256_bytes,
32
+ sha256_file,
33
+ utc_now,
34
+ validate_visual_analysis_receipt,
35
+ visual_analysis_receipt_path,
36
+ )
37
+
38
+ # Longer than the OS gateway's own media-analysis budget (300 s), so the
39
+ # gateway reports a slow upstream instead of the client giving up first.
40
+ DEFAULT_TIMEOUT_SECONDS = 330
41
+
42
+
43
+ def _frame_payloads(root: Path, observation: dict[str, Any]) -> list[dict[str, Any]]:
44
+ evidence = observation.get("evidence")
45
+ if not isinstance(evidence, dict):
46
+ raise ContractError("normalized observation evidence must be an object")
47
+ preparation = evidence.get("visual_preparation")
48
+ if preparation is None:
49
+ return []
50
+ if not isinstance(preparation, dict):
51
+ raise ContractError("visual preparation must be an object or null")
52
+ samples = preparation.get("frame_samples")
53
+ if not isinstance(samples, list):
54
+ raise ContractError("visual preparation frame_samples must be a list")
55
+ hashes = evidence.get("artifact_sha256")
56
+ if not isinstance(hashes, dict):
57
+ raise ContractError("normalized observation artifact hashes are invalid")
58
+ result: list[dict[str, Any]] = []
59
+ for index, sample in enumerate(samples):
60
+ if not isinstance(sample, dict):
61
+ raise ContractError(f"frame sample {index} must be an object")
62
+ ref = sample.get("path")
63
+ timestamp = sample.get("second")
64
+ if not isinstance(ref, str) or not ref or ".." in Path(ref).parts:
65
+ raise ContractError(f"frame sample {index} has an invalid ref")
66
+ if not isinstance(timestamp, (int, float)) or isinstance(timestamp, bool):
67
+ raise ContractError(f"frame sample {index} has an invalid timestamp")
68
+ path = (root / ref).resolve()
69
+ try:
70
+ path.relative_to(root)
71
+ except ValueError as exc:
72
+ raise ContractError(f"frame sample {index} escapes the runtime root") from exc
73
+ digest = hashes.get(ref)
74
+ if not isinstance(digest, str) or sha256_file(path) != digest:
75
+ raise ContractError(f"frame sample {index} hash mismatch")
76
+ media_type = mimetypes.guess_type(path.name)[0]
77
+ if media_type not in {"image/jpeg", "image/png", "image/webp"}:
78
+ raise ContractError(f"frame sample {index} has unsupported media type")
79
+ result.append(
80
+ {
81
+ "ref": ref,
82
+ "timestamp_seconds": float(timestamp),
83
+ "media_type": media_type,
84
+ "sha256": digest,
85
+ "content_base64": base64.b64encode(path.read_bytes()).decode("ascii"),
86
+ }
87
+ )
88
+ return result
89
+
90
+
91
+ def _transcript(observation: dict[str, Any]) -> str | None:
92
+ evidence = observation.get("evidence")
93
+ value = evidence.get("transcript") if isinstance(evidence, dict) else None
94
+ return value.strip() if isinstance(value, str) and value.strip() else None
95
+
96
+
97
+ def _fingerprint_frames(frames: list[dict[str, Any]]) -> list[dict[str, Any]]:
98
+ return [
99
+ {
100
+ "ref": frame["ref"],
101
+ "timestamp_seconds": frame["timestamp_seconds"],
102
+ "media_type": frame["media_type"],
103
+ "sha256": frame["sha256"],
104
+ }
105
+ for frame in frames
106
+ ]
107
+
108
+
109
+ def _unavailable_receipt(
110
+ observation_id: str,
111
+ *,
112
+ instructions: str,
113
+ ) -> dict[str, Any]:
114
+ frames: list[dict[str, Any]] = []
115
+ return {
116
+ "schema_version": SCHEMA_VERSION,
117
+ "observation_id": observation_id,
118
+ "analysis_contract": MULTIMODAL_ANALYSIS_CONTRACT,
119
+ "prompt_contract_version": None,
120
+ "status": "unavailable",
121
+ "model_role": None,
122
+ "effective_model": None,
123
+ "input_sha256": multimodal_input_sha256(
124
+ analysis_contract=MULTIMODAL_ANALYSIS_CONTRACT,
125
+ instructions=instructions,
126
+ frames=frames,
127
+ transcript=None,
128
+ ),
129
+ "frames": frames,
130
+ "transcript": {"status": "unavailable", "sha256": None},
131
+ "analysis": {
132
+ "frames": [],
133
+ "sequence_summary": "",
134
+ "transcript": {"status": "unavailable", "observations": []},
135
+ "claims": [],
136
+ "gaps": [
137
+ "Media and transcript unavailable; no visual or verbal findings were produced."
138
+ ],
139
+ },
140
+ "completed_at": utc_now(),
141
+ }
142
+
143
+
144
+ def _post_json(url: str, api_key: str, payload: dict[str, Any], timeout: int) -> dict:
145
+ request = urllib.request.Request(
146
+ url,
147
+ data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
148
+ method="POST",
149
+ headers={
150
+ "Authorization": f"Bearer {api_key}",
151
+ "Content-Type": "application/json",
152
+ "User-Agent": "EgbeOrganicTrendWatch/1",
153
+ },
154
+ )
155
+ try:
156
+ for _name, _value in _connection_headers(request.full_url).items():
157
+ request.add_unredirected_header(_name, _value)
158
+ with urllib.request.urlopen(request, timeout=timeout) as response:
159
+ body = response.read()
160
+ except urllib.error.HTTPError as exc:
161
+ detail = exc.read().decode("utf-8", errors="replace")[:2000]
162
+ raise ContractError(f"OS media analysis returned HTTP {exc.code}: {detail}") from exc
163
+ except urllib.error.URLError as exc:
164
+ raise ContractError(f"OS media analysis is unreachable: {exc}") from exc
165
+ try:
166
+ value = json.loads(body)
167
+ except json.JSONDecodeError as exc:
168
+ raise ContractError("OS media analysis returned invalid JSON") from exc
169
+ if not isinstance(value, dict) or value.get("code") != 200 or not isinstance(
170
+ value.get("data"), dict
171
+ ):
172
+ raise ContractError("OS media analysis returned an invalid success envelope")
173
+ return value["data"]
174
+
175
+
176
+ def analyze(
177
+ root: Path,
178
+ *,
179
+ os_url: str,
180
+ os_api_key: str,
181
+ observation_id: str | None = None,
182
+ timeout: int = DEFAULT_TIMEOUT_SECONDS,
183
+ ) -> tuple[int, int, int]:
184
+ normalized = read_json(root / "normalized/videos.json")
185
+ videos = normalized.get("videos")
186
+ if not isinstance(videos, list):
187
+ raise ContractError("normalized videos must be a list")
188
+ selected = [
189
+ video
190
+ for video in videos
191
+ if isinstance(video, dict)
192
+ and video.get("selected_for_analysis") is True
193
+ and (observation_id is None or video.get("observation_id") == observation_id)
194
+ ]
195
+ if observation_id is not None and len(selected) != 1:
196
+ raise ContractError("observation ID must identify one selected video")
197
+ if not selected:
198
+ raise ContractError("no selected videos are available for multimodal analysis")
199
+ selected.sort(key=lambda video: str(video.get("observation_id")))
200
+ instructions = load_visual_analysis_instructions()
201
+ completed = reused = unavailable = 0
202
+ for video in selected:
203
+ current_id = video.get("observation_id")
204
+ if not isinstance(current_id, str) or not current_id:
205
+ raise ContractError("selected video has no observation_id")
206
+ frames = _frame_payloads(root, video)
207
+ transcript = _transcript(video)
208
+ receipt_path = visual_analysis_receipt_path(root, current_id)
209
+ if receipt_path.is_file():
210
+ try:
211
+ validate_visual_analysis_receipt(
212
+ root,
213
+ video,
214
+ instructions=instructions,
215
+ )
216
+ reused += 1
217
+ continue
218
+ except ContractError:
219
+ pass
220
+ if not frames and not transcript:
221
+ atomic_write_json(
222
+ receipt_path,
223
+ _unavailable_receipt(current_id, instructions=instructions),
224
+ )
225
+ unavailable += 1
226
+ continue
227
+ request_payload = {
228
+ "schema_version": SCHEMA_VERSION,
229
+ "analysis_contract": MULTIMODAL_ANALYSIS_CONTRACT,
230
+ "instructions": instructions,
231
+ "frames": frames,
232
+ "transcript": transcript,
233
+ }
234
+ expected_input = multimodal_input_sha256(
235
+ analysis_contract=MULTIMODAL_ANALYSIS_CONTRACT,
236
+ instructions=instructions,
237
+ frames=_fingerprint_frames(frames),
238
+ transcript=transcript,
239
+ )
240
+ response = _post_json(
241
+ f"{os_url.rstrip('/')}/v1/media/analyze",
242
+ os_api_key,
243
+ request_payload,
244
+ timeout,
245
+ )
246
+ if response.get("input_sha256") != expected_input:
247
+ raise ContractError("OS media analysis input hash mismatch")
248
+ if response.get("analysis_contract") != MULTIMODAL_ANALYSIS_CONTRACT:
249
+ raise ContractError("OS media analysis contract mismatch")
250
+ if response.get("prompt_contract_version") != MEDIA_PROMPT_CONTRACT_VERSION:
251
+ raise ContractError("OS media analysis prompt contract mismatch")
252
+ analysis = response.get("analysis")
253
+ if not isinstance(analysis, dict):
254
+ raise ContractError("OS media analysis has no structured analysis")
255
+ receipt = {
256
+ "schema_version": SCHEMA_VERSION,
257
+ "observation_id": current_id,
258
+ "analysis_contract": MULTIMODAL_ANALYSIS_CONTRACT,
259
+ "prompt_contract_version": response["prompt_contract_version"],
260
+ "status": "completed",
261
+ "model_role": response.get("model_role"),
262
+ "effective_model": response.get("effective_model"),
263
+ "input_sha256": expected_input,
264
+ "frames": _fingerprint_frames(frames),
265
+ "transcript": {
266
+ "status": "available" if transcript else "unavailable",
267
+ "sha256": sha256_bytes(transcript.encode("utf-8")) if transcript else None,
268
+ },
269
+ "analysis": analysis,
270
+ "completed_at": utc_now(),
271
+ }
272
+ if isinstance(response.get("usage"), dict):
273
+ receipt["usage"] = response["usage"]
274
+ atomic_write_json(receipt_path, receipt)
275
+ validate_visual_analysis_receipt(
276
+ root,
277
+ video,
278
+ instructions=instructions,
279
+ )
280
+ completed += 1
281
+ return completed, reused, unavailable
282
+
283
+
284
+ def main() -> int:
285
+ parser = argparse.ArgumentParser()
286
+ parser.add_argument("--runtime-root", type=Path, required=True)
287
+ parser.add_argument("--observation-id")
288
+ parser.add_argument("--os-url", default=os.environ.get("OS_URL"))
289
+ parser.add_argument("--os-api-key", default=os.environ.get("OS_API_KEY"))
290
+ parser.add_argument("--timeout-seconds", type=int, default=DEFAULT_TIMEOUT_SECONDS)
291
+ args = parser.parse_args()
292
+ try:
293
+ if not args.os_url or not args.os_api_key:
294
+ raise ContractError("OS_URL and OS_API_KEY are required")
295
+ if not 30 <= args.timeout_seconds <= 600:
296
+ raise ContractError("timeout-seconds must be between 30 and 600")
297
+ completed, reused, unavailable = analyze(
298
+ args.runtime_root.resolve(),
299
+ os_url=args.os_url,
300
+ os_api_key=args.os_api_key,
301
+ observation_id=args.observation_id,
302
+ timeout=args.timeout_seconds,
303
+ )
304
+ except (ContractError, OSError, UnicodeDecodeError) as exc:
305
+ print(f"organic multimodal analysis failed: {exc}", file=sys.stderr)
306
+ return 1
307
+ print(
308
+ "organic multimodal analysis: "
309
+ f"completed={completed} reused={reused} unavailable={unavailable}"
310
+ )
311
+ return 0
312
+
313
+
314
+ if __name__ == "__main__":
315
+ raise SystemExit(main())
@@ -0,0 +1,88 @@
1
+ #!/usr/bin/env python3
2
+ """Build canonical current-actor inputs without agent-authored field names."""
3
+
4
+ from __future__ import annotations
5
+
6
+ import argparse
7
+ import json
8
+ import sys
9
+ from pathlib import Path
10
+
11
+ from _analysis import _validate_normalized
12
+ from _contract import (
13
+ ContractError,
14
+ atomic_write_json,
15
+ load_run_state,
16
+ provider_run_lock,
17
+ read_json,
18
+ sha256_file,
19
+ validate_context,
20
+ )
21
+ from _provider_inputs import (
22
+ INPUT_CONTRACT_VERSION,
23
+ build_discovery_inputs,
24
+ build_enrichment_inputs,
25
+ validate_provider_input,
26
+ )
27
+
28
+
29
+ def main() -> int:
30
+ parser = argparse.ArgumentParser()
31
+ parser.add_argument("--runtime-root", type=Path, required=True)
32
+ parser.add_argument("--mode", choices=("discovery", "enrichment"), required=True)
33
+ parser.add_argument("--accounts-file", type=Path)
34
+ args = parser.parse_args()
35
+ root = args.runtime_root.resolve()
36
+ try:
37
+ with provider_run_lock(root):
38
+ outputs = _build(args, root)
39
+ print(json.dumps(outputs, indent=2, sort_keys=True))
40
+ return 0
41
+ except (ContractError, OSError) as exc:
42
+ print(f"could not build provider inputs: {exc}", file=sys.stderr)
43
+ return 1
44
+
45
+
46
+ def _build(args: argparse.Namespace, root: Path) -> dict[str, dict[str, str]]:
47
+ context = validate_context(root / "context.json")
48
+ state = load_run_state(root)
49
+ if state.get("accounts_source") is not None and state["accounts_source"] != {
50
+ "path": "raw/accounts.json", "sha256": sha256_file(root / "raw/accounts.json"),
51
+ }:
52
+ raise ContractError("raw/accounts.json changed within this collection epoch")
53
+ if args.mode == "discovery":
54
+ source = args.accounts_file or (root / "raw/accounts.json")
55
+ value = read_json(source.resolve())
56
+ accounts = value.get("accounts")
57
+ if not isinstance(accounts, list):
58
+ raise ContractError("accounts file must contain an accounts list")
59
+ payloads = build_discovery_inputs(accounts, context, state.get("collection_window"))
60
+ else:
61
+ normalized, _ = _validate_normalized(root)
62
+ videos = normalized.get("videos")
63
+ if not isinstance(videos, list):
64
+ raise ContractError("normalized videos must be a list")
65
+ payloads = build_enrichment_inputs(videos)
66
+ if not payloads:
67
+ raise ContractError(f"no {args.mode} provider inputs are applicable")
68
+ outputs = {}
69
+ for logical_key, payload in payloads.items():
70
+ validate_provider_input(logical_key, payload)
71
+ relative = f"raw/{logical_key}-input.json"
72
+ existing = state["provider_runs"].get(logical_key)
73
+ if existing is not None:
74
+ if (not isinstance(existing, dict)
75
+ or existing.get("input_sha256") != sha256_file(root / relative)
76
+ or read_json(root / relative) != payload):
77
+ raise ContractError(f"cannot replace attempted provider input {logical_key}")
78
+ else:
79
+ atomic_write_json(root / relative, payload)
80
+ outputs[logical_key] = {
81
+ "path": relative,
82
+ "input_contract_version": INPUT_CONTRACT_VERSION,
83
+ }
84
+ return outputs
85
+
86
+
87
+ if __name__ == "__main__":
88
+ raise SystemExit(main())
@@ -0,0 +1,22 @@
1
+ """Load opt-in identity from this catalog's shared project-local request helper."""
2
+ import importlib.util
3
+ from functools import lru_cache
4
+ from pathlib import Path
5
+
6
+
7
+ @lru_cache(maxsize=1)
8
+ def _helper():
9
+ root = Path(__file__).resolve().parents[1]
10
+ quickstart = "egbe-os-quickstart" if root.name.startswith("egbe-os-") else "quickstart"
11
+ path = root.parent / quickstart / "scripts/egbe-curl.py"
12
+ if not path.is_file():
13
+ return None
14
+ spec = importlib.util.spec_from_file_location("egbe_connection_request", path)
15
+ module = importlib.util.module_from_spec(spec)
16
+ spec.loader.exec_module(module)
17
+ return module
18
+
19
+
20
+ def connection_headers(url):
21
+ helper = _helper()
22
+ return helper.connection_headers(url) if helper else {}
@@ -0,0 +1,24 @@
1
+ """Shared project-relative artifact paths, copied into standalone skill bundles.
2
+
3
+ IDs select explicit work, never the newest directory. The defaults are stable
4
+ names for the first study/plan; callers set another ID for independent work.
5
+ """
6
+ import os
7
+ import re
8
+
9
+
10
+ def artifact_path(value: str) -> str:
11
+ for prefix, variable, default in (
12
+ ("egbe-docs/research/", "EGBE_RESEARCH_ID", "market"),
13
+ ("egbe-docs/marketing/plans/", "EGBE_GTM_PLAN_ID", "launch"),
14
+ ):
15
+ token = prefix + default
16
+ if token not in value:
17
+ continue
18
+ identifier = os.environ.get(variable, default)
19
+ if not re.fullmatch(r"[a-z0-9][a-z0-9_-]{0,95}", identifier):
20
+ raise ValueError(f"{variable} must be a lowercase work ID (letters, digits, - or _)")
21
+ value = value.replace(token + "/", prefix + identifier + "/")
22
+ if value == token:
23
+ value = prefix + identifier
24
+ return value