@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,723 @@
1
+ #!/usr/bin/env python3
2
+ """Start, resume, poll, and persist one bounded OS/Apify dataset run."""
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 json
13
+ import os
14
+ import sys
15
+ import time
16
+ import urllib.error
17
+ import urllib.parse
18
+ import urllib.request
19
+ from pathlib import Path
20
+ from typing import Any
21
+
22
+ from _analysis import _validate_normalized
23
+ from _contract import (
24
+ CANONICAL_PROVIDER_RUNS,
25
+ ContractError,
26
+ PROVIDER_INPUT_CONTRACT_VERSION,
27
+ SCHEMA_VERSION,
28
+ TIKTOK_COMMENTS_BUNDLE_PATH,
29
+ TIKTOK_COMMENTS_LINK_KIND,
30
+ atomic_write_json,
31
+ linked_tiktok_comment_requests,
32
+ load_run_state,
33
+ provider_idempotency_key,
34
+ provider_run_lock,
35
+ read_json,
36
+ resolve_relative,
37
+ save_run_state,
38
+ sha256_file,
39
+ utc_now,
40
+ validate_accounts_file,
41
+ validate_context,
42
+ validate_manifest_against_state,
43
+ validate_raw_manifest,
44
+ validate_linked_tiktok_comments_bundle,
45
+ )
46
+ from _provider_inputs import (build_discovery_inputs, build_enrichment_inputs,
47
+ collection_window, validate_collection_window,
48
+ validate_provider_input)
49
+
50
+
51
+ ACTIVE = {"READY", "RUNNING", "TIMING-OUT", "ABORTING"}
52
+ FAILED = {"FAILED", "ABORTED", "TIMED-OUT", "TIMED_OUT"}
53
+
54
+
55
+ def _data(value: dict[str, Any]) -> dict[str, Any]:
56
+ data = value.get("data")
57
+ return data if isinstance(data, dict) else value
58
+
59
+
60
+ def _request(
61
+ *,
62
+ method: str,
63
+ url: str,
64
+ token: str,
65
+ body: dict[str, Any] | None = None,
66
+ request_json: str | None = None,
67
+ idempotency_key: str | None = None,
68
+ timeout: int = 60,
69
+ ) -> dict[str, Any]:
70
+ headers = {"Authorization": f"Bearer {token}", "Accept": "application/json"}
71
+ payload: bytes | None = None
72
+ if body is not None:
73
+ headers["Content-Type"] = "application/json"
74
+ payload = (request_json if request_json is not None else
75
+ json.dumps(body, separators=(",", ":"))).encode("utf-8")
76
+ if idempotency_key:
77
+ headers["Idempotency-Key"] = idempotency_key
78
+ request = urllib.request.Request(url, data=payload, headers=headers, method=method)
79
+ try:
80
+ for _name, _value in _connection_headers(request.full_url).items():
81
+ request.add_unredirected_header(_name, _value)
82
+ with urllib.request.urlopen(request, timeout=timeout) as response:
83
+ raw = response.read()
84
+ except urllib.error.HTTPError as exc:
85
+ detail = exc.read(64 * 1024).decode("utf-8", errors="replace")
86
+ try:
87
+ value = json.loads(detail)
88
+ except json.JSONDecodeError:
89
+ value = None
90
+ data = value.get("data") if isinstance(value, dict) else None
91
+ run_id = data.get("run_id") if isinstance(data, dict) else None
92
+ if (
93
+ 500 <= exc.code < 600 and method == "POST"
94
+ and urllib.parse.urlparse(url).path == "/scrape/apify/run"
95
+ and body is not None and body.get("sync") is False
96
+ and isinstance(data, dict) and data.get("source") == "apify"
97
+ and data.get("resubmit_allowed") is False
98
+ and isinstance(run_id, str) and 1 <= len(run_id) <= 128
99
+ and run_id.isascii() and all(c.isalnum() or c in "_-" for c in run_id)
100
+ ):
101
+ # The paid run exists. Let main persist its receipt before polling
102
+ # or reporting reconciliation, so another invocation cannot POST.
103
+ return value
104
+ raise ContractError(f"OS returned HTTP {exc.code}: {detail[:1000]}") from exc
105
+ except urllib.error.URLError as exc:
106
+ raise ContractError(f"OS request failed: {exc.reason}") from exc
107
+ try:
108
+ value = json.loads(raw.decode("utf-8"))
109
+ except (UnicodeDecodeError, json.JSONDecodeError) as exc:
110
+ raise ContractError("OS returned a non-JSON response") from exc
111
+ if isinstance(value, list):
112
+ return {"data": {"rows": value}}
113
+ if not isinstance(value, dict):
114
+ raise ContractError("OS response must be an object")
115
+ return value
116
+
117
+
118
+ def _handle(value: dict[str, Any]) -> tuple[str, str, str]:
119
+ data = _data(value)
120
+ run_id = str(data.get("run_id") or data.get("id") or "").strip()
121
+ dataset_id = str(
122
+ data.get("dataset_id") or data.get("defaultDatasetId") or ""
123
+ ).strip()
124
+ status = str(data.get("status") or "").strip().upper()
125
+ return run_id, dataset_id, status
126
+
127
+
128
+ def _enrichment_selection(root: Path, state: dict[str, Any]) -> dict[str, Any]:
129
+ """Reuse a validated discovery sample while other enrichment adds raw data."""
130
+ manifest = validate_raw_manifest(root)
131
+ validate_manifest_against_state(root, manifest, state)
132
+ proof = {
133
+ "normalized_sha256": sha256_file(root / "normalized/videos.json"),
134
+ "selection_sha256": sha256_file(root / "normalized/selection.json"),
135
+ }
136
+ prior = state.get("enrichment_selection")
137
+ if prior is not None and not isinstance(prior, dict):
138
+ raise ContractError("saved enrichment selection proof is invalid")
139
+ if prior is not None and prior.get("selection_sha256") != proof["selection_sha256"]:
140
+ raise ContractError("frozen enrichment selection changed")
141
+ if prior == proof:
142
+ # The first enrichment may have updated the full manifest. The exact
143
+ # already-validated sample remains usable only for the same discoveries.
144
+ selection = read_json(root / "normalized/selection.json")
145
+ discovery_sources = sorted(
146
+ [{"path": item["path"], "sha256": item["sha256"]}
147
+ for item in manifest["datasets"] if item["kind"] == "discovery"],
148
+ key=lambda item: item["path"],
149
+ )
150
+ if (selection.get("collection_epoch") != state["collection_epoch"]
151
+ or selection.get("collection_window") != state["collection_window"]
152
+ or selection.get("discovery_sources") != discovery_sources):
153
+ raise ContractError("frozen enrichment discovery evidence changed")
154
+ normalized = read_json(root / "normalized/videos.json")
155
+ else:
156
+ normalized, _ = _validate_normalized(root)
157
+ state["enrichment_selection"] = proof
158
+ return normalized
159
+
160
+
161
+ def _ensure_tiktok_comments_bundle(
162
+ root: Path,
163
+ *,
164
+ main_output: Path,
165
+ os_url: str,
166
+ token: str,
167
+ dataset_limit: int,
168
+ reread_dataset_id: str | None = None,
169
+ ) -> None:
170
+ """Persist every linked comments dataset exposed by TikTok enrichment.
171
+
172
+ The actor shares one comments dataset across all videos of a run, so the
173
+ read uses the run's dataset limit, not the per-video comment count.
174
+ The gateway grants a comments dataset while it serves the run's video
175
+ rows. A retry from saved output passes `reread_dataset_id` so that grant
176
+ is attempted again; the reread rows are discarded.
177
+ """
178
+
179
+ main_payload = read_json(main_output)
180
+ requests = linked_tiktok_comment_requests(main_payload)
181
+ bundle_path = root / TIKTOK_COMMENTS_BUNDLE_PATH
182
+ if bundle_path.is_file():
183
+ validate_linked_tiktok_comments_bundle(main_payload, read_json(bundle_path))
184
+ return
185
+
186
+ if requests and reread_dataset_id:
187
+ query = urllib.parse.urlencode({"limit": dataset_limit})
188
+ _request(
189
+ method="GET",
190
+ url=(
191
+ f"{os_url}/scrape/apify/datasets/"
192
+ f"{urllib.parse.quote(reread_dataset_id, safe='')}?{query}"
193
+ ),
194
+ token=token,
195
+ )
196
+ datasets: list[dict[str, Any]] = []
197
+ for request in requests:
198
+ dataset_id = request["dataset_id"]
199
+ query = urllib.parse.urlencode({"limit": dataset_limit})
200
+ response = _request(
201
+ method="GET",
202
+ url=(
203
+ f"{os_url}/scrape/apify/datasets/"
204
+ f"{urllib.parse.quote(dataset_id, safe='')}?{query}"
205
+ ),
206
+ token=token,
207
+ )
208
+ datasets.append({**request, "response": response})
209
+ bundle = {
210
+ "schema_version": SCHEMA_VERSION,
211
+ "source_logical_key": "tiktok-enrichment",
212
+ "source_dataset_sha256": sha256_file(main_output),
213
+ "datasets": datasets,
214
+ }
215
+ validate_linked_tiktok_comments_bundle(main_payload, bundle)
216
+ atomic_write_json(bundle_path, bundle)
217
+
218
+
219
+ def _write_manifest(
220
+ root: Path,
221
+ *,
222
+ accounts: list[dict[str, Any]],
223
+ platform: str,
224
+ kind: str,
225
+ raw_path: str,
226
+ state: dict[str, Any],
227
+ collection_changed: bool,
228
+ ) -> None:
229
+ path = root / "raw/manifest.json"
230
+ if path.exists():
231
+ manifest = read_json(path)
232
+ started_at = manifest.get("collection_started_at") or state["collection_window"]["reference_at"]
233
+ datasets = manifest.get("datasets")
234
+ if not isinstance(datasets, list):
235
+ datasets = []
236
+ else:
237
+ started_at = state["collection_window"]["reference_at"]
238
+ datasets = []
239
+ manifest = {}
240
+ dataset = {
241
+ "platform": platform,
242
+ "kind": kind,
243
+ "path": raw_path,
244
+ "sha256": sha256_file(resolve_relative(root, raw_path, "raw output")),
245
+ }
246
+ datasets = [
247
+ item
248
+ for item in datasets
249
+ if not (
250
+ isinstance(item, dict)
251
+ and item.get("platform") == platform
252
+ and item.get("kind") == kind
253
+ )
254
+ ]
255
+ datasets.append(dataset)
256
+ datasets.sort(key=lambda item: (item["platform"], item["kind"], item["path"]))
257
+
258
+ runs: list[dict[str, Any]] = []
259
+ for key in sorted(state["provider_runs"]):
260
+ run = state["provider_runs"][key]
261
+ raw_path = run.get("raw_path")
262
+ if (
263
+ run.get("status") != "SUCCEEDED"
264
+ or not isinstance(raw_path, str)
265
+ or not resolve_relative(root, raw_path, "provider raw path").is_file()
266
+ ):
267
+ continue
268
+ runs.append(
269
+ {
270
+ "logical_key": key,
271
+ "provider": "apify",
272
+ "actor_id": run["actor_id"],
273
+ "run_id": run["run_id"],
274
+ "dataset_id": run["dataset_id"],
275
+ "status": "SUCCEEDED",
276
+ "input_sha256": run["input_sha256"],
277
+ "input_contract_version": run["input_contract_version"],
278
+ "input_keys": run["input_keys"],
279
+ "actor_metadata": run["actor_metadata"],
280
+ }
281
+ )
282
+ completed_at = (
283
+ utc_now()
284
+ if collection_changed
285
+ else manifest.get("collection_completed_at")
286
+ or max(
287
+ (
288
+ str(run.get("completed_at") or "")
289
+ for run in state["provider_runs"].values()
290
+ if isinstance(run, dict) and run.get("status") == "SUCCEEDED"
291
+ ),
292
+ default="",
293
+ )
294
+ )
295
+ if not completed_at:
296
+ raise ContractError("cannot determine collection completion time")
297
+ linked_comments_path = root / TIKTOK_COMMENTS_BUNDLE_PATH
298
+ linked_datasets = (
299
+ [
300
+ {
301
+ "kind": TIKTOK_COMMENTS_LINK_KIND,
302
+ "parent_logical_key": "tiktok-enrichment",
303
+ "path": TIKTOK_COMMENTS_BUNDLE_PATH,
304
+ "sha256": sha256_file(linked_comments_path),
305
+ }
306
+ ]
307
+ if linked_comments_path.is_file()
308
+ else []
309
+ )
310
+ atomic_write_json(
311
+ path,
312
+ {
313
+ "schema_version": 1,
314
+ "collection_epoch": state["collection_epoch"],
315
+ "collection_started_at": started_at,
316
+ "collection_completed_at": completed_at,
317
+ "accounts": accounts,
318
+ "accounts_source": state["accounts_source"],
319
+ "datasets": datasets,
320
+ "linked_datasets": linked_datasets,
321
+ "provider_runs": runs,
322
+ },
323
+ )
324
+
325
+
326
+ def _save_provider(
327
+ root: Path,
328
+ state: dict[str, Any],
329
+ *,
330
+ key: str,
331
+ actor_id: str,
332
+ input_hash: str,
333
+ input_path: str,
334
+ input_keys: list[str],
335
+ actor_metadata: dict[str, str],
336
+ idempotency_key: str,
337
+ run_id: str,
338
+ dataset_id: str,
339
+ status: str,
340
+ raw_path: str | None = None,
341
+ ) -> None:
342
+ existing = state["provider_runs"].get(key)
343
+ if isinstance(existing, dict):
344
+ for field, expected in (
345
+ ("actor_id", actor_id),
346
+ ("input_sha256", input_hash),
347
+ ("input_path", input_path),
348
+ ("input_contract_version", PROVIDER_INPUT_CONTRACT_VERSION),
349
+ ("input_keys", input_keys),
350
+ ("actor_metadata", actor_metadata),
351
+ ):
352
+ if existing.get(field) != expected:
353
+ raise ContractError(f"logical provider run {key} changed {field}")
354
+ if existing.get("run_id") and existing["run_id"] != run_id:
355
+ raise ContractError(f"logical provider run {key} changed run_id")
356
+ if existing.get("dataset_id") and dataset_id and existing["dataset_id"] != dataset_id:
357
+ raise ContractError(f"logical provider run {key} changed dataset_id")
358
+ value = {
359
+ "provider": "apify",
360
+ "actor_id": actor_id,
361
+ "input_sha256": input_hash,
362
+ "input_path": input_path,
363
+ "input_contract_version": PROVIDER_INPUT_CONTRACT_VERSION,
364
+ "input_keys": input_keys,
365
+ "actor_metadata": actor_metadata,
366
+ "idempotency_key": idempotency_key,
367
+ "run_id": run_id,
368
+ "dataset_id": dataset_id,
369
+ "status": status,
370
+ "started_at": (existing or {}).get("started_at") or utc_now(),
371
+ "updated_at": utc_now(),
372
+ }
373
+ for field in ("attempted_at", "request_json"):
374
+ if isinstance(existing, dict) and field in existing:
375
+ value[field] = existing[field]
376
+ if raw_path:
377
+ value["raw_path"] = raw_path
378
+ value["raw_sha256"] = sha256_file(resolve_relative(root, raw_path, "raw output"))
379
+ if status == "SUCCEEDED":
380
+ value["completed_at"] = (existing or {}).get("completed_at") or utc_now()
381
+ state["provider_runs"][key] = value
382
+ save_run_state(root, state)
383
+
384
+
385
+ def main() -> int:
386
+ parser = argparse.ArgumentParser()
387
+ parser.add_argument("--runtime-root", type=Path, required=True)
388
+ parser.add_argument("--key", required=True)
389
+ parser.add_argument("--actor-id", required=True)
390
+ parser.add_argument("--platform", choices=("tiktok", "instagram"), required=True)
391
+ parser.add_argument("--kind", choices=("discovery", "enrichment"), required=True)
392
+ parser.add_argument("--input-file", type=Path, required=True)
393
+ parser.add_argument("--accounts-file", type=Path, required=True)
394
+ parser.add_argument("--output", required=True)
395
+ parser.add_argument("--dataset-limit", type=int, default=1000)
396
+ parser.add_argument("--poll-interval-seconds", type=int, default=30)
397
+ parser.add_argument("--poll-timeout-seconds", type=int, default=1200)
398
+ parser.add_argument("--start-only", action="store_true")
399
+ args = parser.parse_args()
400
+
401
+ root = args.runtime_root.resolve()
402
+ try:
403
+ with provider_run_lock(root):
404
+ return _run(args, root)
405
+ except (ContractError, OSError) as exc:
406
+ print(f"organic trend Apify run failed: {exc}", file=sys.stderr)
407
+ return 1
408
+
409
+
410
+ def _run(args: argparse.Namespace, root: Path) -> int:
411
+ try:
412
+ if not 1 <= args.dataset_limit <= 5000:
413
+ raise ContractError("dataset limit must be between 1 and 5000")
414
+ if not 5 <= args.poll_interval_seconds <= 60:
415
+ raise ContractError("poll interval must be between 5 and 60 seconds")
416
+ if not 1 <= args.poll_timeout_seconds <= 3600:
417
+ raise ContractError("poll timeout must be between 1 and 3600 seconds")
418
+ os_url = os.environ.get("OS_URL", "").rstrip("/")
419
+ token = os.environ.get("OS_API_KEY", "")
420
+ if not os_url or not token:
421
+ raise ContractError("OS_URL and OS_API_KEY are required")
422
+ canonical_run = CANONICAL_PROVIDER_RUNS.get(args.key)
423
+ if canonical_run is None:
424
+ raise ContractError("key must name one of the four canonical provider runs")
425
+ if (
426
+ args.actor_id != canonical_run["actor_id"]
427
+ or args.platform != canonical_run["platform"]
428
+ or args.kind != canonical_run["kind"]
429
+ ):
430
+ raise ContractError("key, actor, platform, and kind do not match the canonical run")
431
+ actor_input_path = args.input_file.resolve()
432
+ expected_input_path = (root / f"raw/{args.key}-input.json").resolve()
433
+ if actor_input_path != expected_input_path:
434
+ raise ContractError(
435
+ f"input-file must be the canonical raw/{args.key}-input.json adapter output"
436
+ )
437
+ actor_input = read_json(actor_input_path)
438
+ validate_provider_input(args.key, actor_input)
439
+ input_keys = sorted(actor_input)
440
+ expected_accounts_path = (root / "raw/accounts.json").resolve()
441
+ if args.accounts_file.resolve() != expected_accounts_path:
442
+ raise ContractError("accounts-file must be raw/accounts.json")
443
+ accounts, accounts_source = validate_accounts_file(root)
444
+ output_path = resolve_relative(root, args.output, "output")
445
+ if args.output != f"raw/{args.key}.json" or output_path.parent != (root / "raw").resolve():
446
+ raise ContractError(f"output must be raw/{args.key}.json")
447
+
448
+ state = load_run_state(root)
449
+ context = validate_context(root / "context.json")
450
+ # Calendar validation only; do not persist a preview as a first attempt.
451
+ collection_window(context, utc_now())
452
+ window = state.get("collection_window")
453
+ if window is not None:
454
+ validate_collection_window(context, window)
455
+ elif state["provider_runs"]:
456
+ raise ContractError("saved provider state has no frozen collection window; do not resubmit")
457
+ existing = state["provider_runs"].get(args.key)
458
+ if existing is not None and not isinstance(existing, dict):
459
+ raise ContractError("saved provider run is invalid; do not resubmit")
460
+ if args.kind == "discovery":
461
+ expected = build_discovery_inputs(accounts, context, window).get(args.key)
462
+ preview = build_discovery_inputs(accounts, context).get(args.key)
463
+ if actor_input not in (expected, preview):
464
+ raise ContractError("discovery input differs from context and declared accounts")
465
+ elif existing is None:
466
+ normalized = _enrichment_selection(root, state)
467
+ if actor_input != build_enrichment_inputs(normalized["videos"]).get(args.key):
468
+ raise ContractError("enrichment input differs from the frozen selection")
469
+ if state.get("accounts_source") is None:
470
+ state["accounts_source"] = accounts_source
471
+ save_run_state(root, state)
472
+ elif state.get("accounts_source") != accounts_source:
473
+ raise ContractError("raw/accounts.json changed within this collection epoch")
474
+ input_hash = sha256_file(actor_input_path)
475
+ input_relative = actor_input_path.relative_to(root).as_posix()
476
+ idempotency_key = provider_idempotency_key(
477
+ state["context_sha256"],
478
+ state["collection_epoch"],
479
+ args.key,
480
+ args.actor_id,
481
+ input_hash,
482
+ )
483
+ if isinstance(existing, dict):
484
+ expected_existing = {
485
+ "actor_id": args.actor_id,
486
+ "input_sha256": input_hash,
487
+ "input_path": input_relative,
488
+ "input_contract_version": PROVIDER_INPUT_CONTRACT_VERSION,
489
+ "input_keys": input_keys,
490
+ }
491
+ for field, expected in expected_existing.items():
492
+ if existing.get(field) != expected:
493
+ raise ContractError(
494
+ f"logical provider run {args.key} has different {field}"
495
+ )
496
+ actor_metadata = existing.get("actor_metadata")
497
+ if not isinstance(actor_metadata, dict):
498
+ raise ContractError("saved provider run has no actor metadata snapshot")
499
+ metadata_path = resolve_relative(
500
+ root, actor_metadata.get("path"), "actor metadata path"
501
+ )
502
+ if (
503
+ not metadata_path.is_file()
504
+ or actor_metadata.get("sha256") != sha256_file(metadata_path)
505
+ ):
506
+ raise ContractError("saved actor metadata snapshot hash changed")
507
+ run_id = str(existing.get("run_id") or "")
508
+ dataset_id = str(existing.get("dataset_id") or "")
509
+ status = str(existing.get("status") or "").upper()
510
+ if existing.get("idempotency_key") != idempotency_key:
511
+ raise ContractError("saved provider idempotency key changed")
512
+ if args.start_only and run_id:
513
+ if status in FAILED:
514
+ raise ContractError(f"Apify run {run_id} is terminal: {status}")
515
+ print(json.dumps(existing, sort_keys=True))
516
+ return 0
517
+ if (
518
+ status == "SUCCEEDED"
519
+ and output_path.is_file()
520
+ and existing.get("raw_sha256")
521
+ ):
522
+ if existing.get("raw_sha256") != sha256_file(output_path):
523
+ raise ContractError("saved raw dataset hash changed")
524
+ if args.key == "tiktok-enrichment":
525
+ _ensure_tiktok_comments_bundle(
526
+ root,
527
+ main_output=output_path,
528
+ os_url=os_url,
529
+ token=token,
530
+ dataset_limit=args.dataset_limit,
531
+ reread_dataset_id=dataset_id,
532
+ )
533
+ _write_manifest(
534
+ root,
535
+ accounts=accounts,
536
+ platform=args.platform,
537
+ kind=args.kind,
538
+ raw_path=args.output,
539
+ state=state,
540
+ collection_changed=False,
541
+ )
542
+ print(f"reused {args.key} run {run_id}")
543
+ return 0
544
+ else:
545
+ metadata_path = root / f"raw/{args.key}-actor-metadata.json"
546
+ metadata_response = _request(
547
+ method="GET",
548
+ url=(
549
+ f"{os_url}/scrape/apify/actors/"
550
+ f"{urllib.parse.quote(args.actor_id, safe='/~')}"
551
+ ),
552
+ token=token,
553
+ )
554
+ if _data(metadata_response).get("actor_id") != args.actor_id:
555
+ raise ContractError("OS actor metadata response changed actor_id")
556
+ atomic_write_json(metadata_path, metadata_response)
557
+ actor_metadata = {
558
+ "path": metadata_path.relative_to(root).as_posix(),
559
+ "sha256": sha256_file(metadata_path),
560
+ }
561
+ # Preview/init dates are not a paid attempt. Freeze the effective
562
+ # input and reference time immediately before the first POST.
563
+ attempted_at = utc_now()
564
+ if window is None:
565
+ window = collection_window(context, attempted_at)
566
+ state["collection_window"] = window
567
+ if args.kind == "discovery":
568
+ actor_input = build_discovery_inputs(accounts, context, window)[args.key]
569
+ atomic_write_json(actor_input_path, actor_input)
570
+ input_hash = sha256_file(actor_input_path)
571
+ idempotency_key = provider_idempotency_key(
572
+ state["context_sha256"], state["collection_epoch"],
573
+ args.key, args.actor_id, input_hash,
574
+ )
575
+ state["provider_runs"][args.key] = {
576
+ "provider": "apify", "actor_id": args.actor_id,
577
+ "input_sha256": input_hash, "input_path": input_relative,
578
+ "input_contract_version": PROVIDER_INPUT_CONTRACT_VERSION,
579
+ "input_keys": input_keys, "actor_metadata": actor_metadata,
580
+ "idempotency_key": idempotency_key,
581
+ "run_id": "", "dataset_id": "", "status": "SUBMITTING",
582
+ "started_at": attempted_at, "attempted_at": attempted_at,
583
+ "request_json": json.dumps(
584
+ {"actor": args.actor_id, "input": actor_input, "sync": False},
585
+ separators=(",", ":"),
586
+ ),
587
+ }
588
+ save_run_state(root, state)
589
+ run_id, dataset_id, status = "", "", "SUBMITTING"
590
+
591
+ if not run_id:
592
+ saved = state["provider_runs"][args.key]
593
+ request_json = saved.get("request_json")
594
+ expected_body = {"actor": args.actor_id, "input": actor_input, "sync": False}
595
+ try:
596
+ saved_body = json.loads(request_json) if isinstance(request_json, str) else None
597
+ except json.JSONDecodeError as exc:
598
+ raise ContractError("saved provider request is invalid; do not resubmit") from exc
599
+ if (not isinstance(request_json, str) or not saved.get("attempted_at")
600
+ or saved_body != expected_body):
601
+ raise ContractError("uncertain submission lacks its exact saved request; do not resubmit")
602
+ # The gateway durably reconciles this same key/body. Never mint a
603
+ # replacement operation when a response or handle is missing.
604
+ response = _request(
605
+ method="POST",
606
+ url=f"{os_url}/scrape/apify/run",
607
+ token=token,
608
+ body=expected_body,
609
+ request_json=request_json,
610
+ idempotency_key=idempotency_key,
611
+ )
612
+ run_id, dataset_id, status = _handle(response)
613
+ if not run_id:
614
+ raise ContractError("OS start response did not include run_id")
615
+ _save_provider(
616
+ root,
617
+ state,
618
+ key=args.key,
619
+ actor_id=args.actor_id,
620
+ input_hash=input_hash,
621
+ input_path=input_relative,
622
+ input_keys=input_keys,
623
+ actor_metadata=actor_metadata,
624
+ idempotency_key=idempotency_key,
625
+ run_id=run_id,
626
+ dataset_id=dataset_id,
627
+ status=status or "READY",
628
+ )
629
+ state = load_run_state(root)
630
+ if _data(response).get("reconciliation_required") is True:
631
+ raise ContractError(f"Apify run {run_id} started and its handle was saved; Egbe team reconciliation is required. Do not submit another run.")
632
+ if args.start_only:
633
+ print(json.dumps(state["provider_runs"][args.key], sort_keys=True))
634
+ return 0
635
+
636
+ if status in FAILED:
637
+ raise ContractError(f"Apify run {run_id} is terminal: {status}")
638
+ deadline = time.monotonic() + args.poll_timeout_seconds
639
+ while status != "SUCCEEDED":
640
+ if status and status not in ACTIVE:
641
+ raise ContractError(f"Apify run {run_id} has unsupported status: {status}")
642
+ if time.monotonic() >= deadline:
643
+ print(f"Apify run {run_id} is still {status}; retry will resume it", file=sys.stderr)
644
+ return 2
645
+ time.sleep(args.poll_interval_seconds)
646
+ response = _request(
647
+ method="GET",
648
+ url=f"{os_url}/scrape/apify/runs/{urllib.parse.quote(run_id, safe='')}",
649
+ token=token,
650
+ )
651
+ polled_run_id, polled_dataset_id, status = _handle(response)
652
+ if polled_run_id and polled_run_id != run_id:
653
+ raise ContractError("OS poll response changed run_id")
654
+ dataset_id = polled_dataset_id or dataset_id
655
+ _save_provider(
656
+ root,
657
+ state,
658
+ key=args.key,
659
+ actor_id=args.actor_id,
660
+ input_hash=input_hash,
661
+ input_path=input_relative,
662
+ input_keys=input_keys,
663
+ actor_metadata=actor_metadata,
664
+ idempotency_key=idempotency_key,
665
+ run_id=run_id,
666
+ dataset_id=dataset_id,
667
+ status=status,
668
+ )
669
+ state = load_run_state(root)
670
+ if status in FAILED:
671
+ raise ContractError(f"Apify run {run_id} failed: {status}")
672
+
673
+ if not dataset_id:
674
+ raise ContractError(f"successful Apify run {run_id} has no dataset_id")
675
+ query = urllib.parse.urlencode({"limit": args.dataset_limit})
676
+ response = _request(
677
+ method="GET",
678
+ url=f"{os_url}/scrape/apify/datasets/{urllib.parse.quote(dataset_id, safe='')}?{query}",
679
+ token=token,
680
+ )
681
+ atomic_write_json(output_path, response)
682
+ _save_provider(
683
+ root,
684
+ state,
685
+ key=args.key,
686
+ actor_id=args.actor_id,
687
+ input_hash=input_hash,
688
+ input_path=input_relative,
689
+ input_keys=input_keys,
690
+ actor_metadata=actor_metadata,
691
+ idempotency_key=idempotency_key,
692
+ run_id=run_id,
693
+ dataset_id=dataset_id,
694
+ status="SUCCEEDED",
695
+ raw_path=args.output,
696
+ )
697
+ state = load_run_state(root)
698
+ if args.key == "tiktok-enrichment":
699
+ _ensure_tiktok_comments_bundle(
700
+ root,
701
+ main_output=output_path,
702
+ os_url=os_url,
703
+ token=token,
704
+ dataset_limit=args.dataset_limit,
705
+ )
706
+ _write_manifest(
707
+ root,
708
+ accounts=accounts,
709
+ platform=args.platform,
710
+ kind=args.kind,
711
+ raw_path=args.output,
712
+ state=state,
713
+ collection_changed=True,
714
+ )
715
+ print(f"saved {args.key} run {run_id} to {args.output}")
716
+ return 0
717
+ except (ContractError, OSError) as exc:
718
+ print(f"organic trend Apify run failed: {exc}", file=sys.stderr)
719
+ return 1
720
+
721
+
722
+ if __name__ == "__main__":
723
+ raise SystemExit(main())