@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.
- package/LICENSE +4 -0
- package/README.md +124 -2
- package/index.js +5 -0
- package/package.json +55 -4
- package/plugin.js +230 -0
- package/session-log.js +315 -0
- package/skills/.egbe-catalog/manifest.json +1 -0
- package/skills/egbe-os-analytics/SKILL.md +499 -0
- package/skills/egbe-os-analytics/canonical-events.v1.json +256 -0
- package/skills/egbe-os-analytics/references/session-funnel.md +130 -0
- package/skills/egbe-os-analytics/references/workflows/activation-tracking.md +147 -0
- package/skills/egbe-os-analytics/references/workflows/landing-click-tracking.md +209 -0
- package/skills/egbe-os-analytics/references/workflows/payment-lifecycle-tracking.md +122 -0
- package/skills/egbe-os-analytics/references/workflows/product-funnel-tracking.md +77 -0
- package/skills/egbe-os-analytics/references/workflows/signup-lifecycle-tracking.md +208 -0
- package/skills/egbe-os-analytics/scripts/umami_funnel.py +927 -0
- package/skills/egbe-os-apollo-lead-finder/SKILL.md +135 -0
- package/skills/egbe-os-apollo-lead-finder/references/operations.md +240 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/enrich.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/enrich.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/apollo-client.js +343 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/connection-identity.js +17 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/helpers.js +127 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/places-filters.js +217 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/sourcing.js +153 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.js +653 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/search.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/search.sh +4 -0
- package/skills/egbe-os-campaign-landing-page/SKILL.md +95 -0
- package/skills/egbe-os-campaign-landing-page/agents/openai.yaml +4 -0
- package/skills/egbe-os-campaign-landing-page/references/leads-calendar-and-tracking.md +66 -0
- package/skills/egbe-os-campaign-landing-page/references/os-wiring.md +58 -0
- package/skills/egbe-os-campaign-landing-page/references/qa.md +40 -0
- package/skills/egbe-os-campaign-landing-page/references/routing.md +32 -0
- package/skills/egbe-os-db/SKILL.md +174 -0
- package/skills/egbe-os-deploy/SKILL.md +412 -0
- package/skills/egbe-os-design/SKILL.md +182 -0
- package/skills/egbe-os-design-landing-page/SKILL.md +117 -0
- package/skills/egbe-os-design-landing-page/agents/openai.yaml +4 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/.dockerignore +11 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/AGENTS.md +31 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/Dockerfile +21 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/eslint.config.mjs +18 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/next.config.ts +11 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/package.json +36 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/postcss.config.mjs +7 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/public/.gitkeep +1 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.edge.config.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.server.config.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/global-error.tsx +19 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/globals.css +22 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/layout.tsx +21 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/page.tsx +3 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/privacy/page.tsx +28 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/components/egbe-analytics.tsx +39 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation-client.ts +15 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/egbe-observability.generated.ts +20 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/utils.ts +6 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/tsconfig.json +34 -0
- package/skills/egbe-os-design-landing-page/references/application-preparation.md +44 -0
- package/skills/egbe-os-design-landing-page/references/page-inputs.md +22 -0
- package/skills/egbe-os-destination-readiness/SKILL.md +132 -0
- package/skills/egbe-os-destination-readiness/references/checks.md +130 -0
- package/skills/egbe-os-destination-readiness/references/network-requirements.md +34 -0
- package/skills/egbe-os-destination-readiness/references/report.md +116 -0
- package/skills/egbe-os-domains/SKILL.md +189 -0
- package/skills/egbe-os-errors/SKILL.md +259 -0
- package/skills/egbe-os-git/SKILL.md +275 -0
- package/skills/egbe-os-git/references/issues.md +33 -0
- package/skills/egbe-os-google-ads/SKILL.md +163 -0
- package/skills/egbe-os-google-ads/references/artifacts.md +133 -0
- package/skills/egbe-os-google-ads/references/campaigns.md +157 -0
- package/skills/egbe-os-google-ads/references/conversions.md +153 -0
- package/skills/egbe-os-google-ads/references/delivery.md +128 -0
- package/skills/egbe-os-google-ads/references/keyword-ideas.md +40 -0
- package/skills/egbe-os-google-ads/references/reporting.md +105 -0
- package/skills/egbe-os-google-ads/references/search-assets.md +219 -0
- package/skills/egbe-os-google-ads/references/server-conversions.md +119 -0
- package/skills/egbe-os-google-auth/SKILL.md +285 -0
- package/skills/egbe-os-google-auth/agents/openai.yaml +4 -0
- package/skills/egbe-os-gtm-knowledge/SKILL.md +151 -0
- package/skills/egbe-os-images/SKILL.md +163 -0
- package/skills/egbe-os-images/references/stock-images.md +21 -0
- package/skills/egbe-os-instantly-campaign-launcher/SKILL.md +127 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/instantly-ops.md +260 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/observation-and-scheduling.md +188 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/reply-handling.md +116 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/run-spec-template.json +65 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/run-state.md +145 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/conclude-campaign.js +158 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/install-crons.js +956 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/launch-campaign.js +2008 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/campaign-metrics.js +124 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/confirmed-opt-outs.js +208 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/connection-identity.js +17 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/create-once.js +23 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/gtm-identity.js +125 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/helpers.js +545 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/html-body.js +266 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/instantly-client.js +328 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/outreach-db.js +370 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/recipient-exclusion/index.js +86 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/replenish-test-harness.js +53 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/reply-queue.js +67 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/run-config.js +103 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/sender-selection.js +105 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/monitor-campaign.js +607 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/outreach-report.js +147 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/replenish-leads.js +619 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/reply-worker.js +258 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/run-cron-job.js +32 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/send-reply.js +260 -0
- package/skills/egbe-os-linkedin-ads/SKILL.md +114 -0
- package/skills/egbe-os-linkedin-ads/references/destination-requirements.md +30 -0
- package/skills/egbe-os-linkedin-ads/references/runtime/api-reference.md +154 -0
- package/skills/egbe-os-linkedin-ads/references/runtime/artifacts.md +63 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/build-paused.md +44 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/conversions.md +88 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/launch-and-pause.md +49 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/monitoring.md +35 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/readiness.md +63 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/targeting-and-creative.md +52 -0
- package/skills/egbe-os-llm/SKILL.md +160 -0
- package/skills/egbe-os-mail/SKILL.md +180 -0
- package/skills/egbe-os-me/SKILL.md +119 -0
- package/skills/egbe-os-meta-ads/SKILL.md +114 -0
- package/skills/egbe-os-meta-ads/references/creative/creative-specs.md +15 -0
- package/skills/egbe-os-meta-ads/references/creative/talking-head.md +35 -0
- package/skills/egbe-os-meta-ads/references/destination-requirements.md +30 -0
- package/skills/egbe-os-meta-ads/references/runtime/api-reference.md +436 -0
- package/skills/egbe-os-meta-ads/references/runtime/artifacts.md +51 -0
- package/skills/egbe-os-meta-ads/references/runtime/insights-reference.md +187 -0
- package/skills/egbe-os-meta-ads/references/runtime/pixel-install.md +196 -0
- package/skills/egbe-os-meta-ads/references/runtime/shared-analytics-attribution.md +16 -0
- package/skills/egbe-os-meta-ads/references/workflows/build-paused.md +36 -0
- package/skills/egbe-os-meta-ads/references/workflows/launch-ready.md +16 -0
- package/skills/egbe-os-meta-ads/references/workflows/launch.md +23 -0
- package/skills/egbe-os-meta-ads/references/workflows/monitoring.md +72 -0
- package/skills/egbe-os-meta-ads/references/workflows/pause.md +17 -0
- package/skills/egbe-os-meta-ads/references/workflows/recovery.md +23 -0
- package/skills/egbe-os-meta-ads/scripts/check-pixel.py +229 -0
- package/skills/egbe-os-meta-ads/scripts/validate-meta-artifacts.py +187 -0
- package/skills/egbe-os-notifications/SKILL.md +78 -0
- package/skills/egbe-os-openai-ads/SKILL.md +149 -0
- package/skills/egbe-os-openai-ads/references/creative/chat-card.md +51 -0
- package/skills/egbe-os-openai-ads/references/destination-requirements.md +29 -0
- package/skills/egbe-os-openai-ads/references/runtime/api-reference.md +219 -0
- package/skills/egbe-os-openai-ads/references/runtime/artifacts.md +169 -0
- package/skills/egbe-os-openai-ads/references/workflows/build-paused.md +40 -0
- package/skills/egbe-os-openai-ads/references/workflows/conversions.md +40 -0
- package/skills/egbe-os-openai-ads/references/workflows/creative-assembly.md +24 -0
- package/skills/egbe-os-openai-ads/references/workflows/launch.md +27 -0
- package/skills/egbe-os-openai-ads/references/workflows/monitoring.md +54 -0
- package/skills/egbe-os-openai-ads/references/workflows/pause.md +22 -0
- package/skills/egbe-os-openai-ads/references/workflows/readiness.md +37 -0
- package/skills/egbe-os-openai-ads/references/workflows/tracking.md +32 -0
- package/skills/egbe-os-openai-ads/scripts/validate-openai-artifacts.py +271 -0
- package/skills/egbe-os-organic-trend-watch/SKILL.md +139 -0
- package/skills/egbe-os-organic-trend-watch/agents/openai.yaml +4 -0
- package/skills/egbe-os-organic-trend-watch/references/analysis-and-adaptation.md +54 -0
- package/skills/egbe-os-organic-trend-watch/references/collection-and-analysis.md +117 -0
- package/skills/egbe-os-organic-trend-watch/references/output-contract.md +133 -0
- package/skills/egbe-os-organic-trend-watch/references/provider-contract.md +169 -0
- package/skills/egbe-os-organic-trend-watch/references/runtime-contract.md +204 -0
- package/skills/egbe-os-organic-trend-watch/references/visual-analysis-prompt.md +17 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_analysis.py +612 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_contract.py +1133 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_provider_inputs.py +165 -0
- package/skills/egbe-os-organic-trend-watch/scripts/analyze-visual-evidence.py +315 -0
- package/skills/egbe-os-organic-trend-watch/scripts/build-provider-inputs.py +88 -0
- package/skills/egbe-os-organic-trend-watch/scripts/connection_identity.py +22 -0
- package/skills/egbe-os-organic-trend-watch/scripts/egbe_artifacts.py +24 -0
- package/skills/egbe-os-organic-trend-watch/scripts/finalize-receipt.py +106 -0
- package/skills/egbe-os-organic-trend-watch/scripts/normalize-videos.py +647 -0
- package/skills/egbe-os-organic-trend-watch/scripts/prepare-visual-evidence.py +324 -0
- package/skills/egbe-os-organic-trend-watch/scripts/render-result.py +30 -0
- package/skills/egbe-os-organic-trend-watch/scripts/run-apify.py +723 -0
- package/skills/egbe-os-organic-trend-watch/scripts/run-state.py +192 -0
- package/skills/egbe-os-organic-trend-watch/scripts/validate-context.py +27 -0
- package/skills/egbe-os-organic-trend-watch/scripts/validate-runtime.py +137 -0
- package/skills/egbe-os-payments/SKILL.md +215 -0
- package/skills/egbe-os-payments/agents/openai.yaml +4 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/.egbe/scaffolds/billing-nextjs-subscription.v1.json +5 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/AGENTS.append.md +13 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/db/migrations/1000_egbe_billing.sql +66 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/package.fragment.json +12 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/scripts/billing-sync.mjs +162 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/error.tsx +11 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/loading.tsx +8 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/page.tsx +121 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/checkout/route.ts +102 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/portal/route.ts +54 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/status/route.ts +22 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/payments/webhook/route.ts +65 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/components/egbe-billing/plan-badge.tsx +16 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/billing-sync.test.mjs +58 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/catalog.ts +82 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/checkout-payload.ts +47 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/foundation-contract.test.mjs +59 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.d.ts +16 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.mjs +82 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.test.mjs +94 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/os-client.ts +96 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/plans.json +17 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/repository.ts +325 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.d.ts +6 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.mjs +22 -0
- package/skills/egbe-os-payments/references/contracts/plan-catalog.md +46 -0
- package/skills/egbe-os-payments/references/security/durable-verification.md +64 -0
- package/skills/egbe-os-payments/references/security/server-integration.md +26 -0
- package/skills/egbe-os-payments/references/security/webhook-and-entitlements.md +152 -0
- package/skills/egbe-os-payments/references/ux/billing-experience.md +47 -0
- package/skills/egbe-os-payments/references/workflows/account-billing.md +64 -0
- package/skills/egbe-os-payments/references/workflows/discounts-and-promotion-codes.md +265 -0
- package/skills/egbe-os-payments/references/workflows/one-time-purchase.md +75 -0
- package/skills/egbe-os-payments/references/workflows/product-checkout.md +355 -0
- package/skills/egbe-os-payments/references/workflows/subscription-lifecycle.md +55 -0
- package/skills/egbe-os-playbook/SKILL.md +79 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/email-outreach.md +91 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/google-search.md +40 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/linkedin.md +24 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/meta.md +23 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/openai.md +15 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/reddit.md +56 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/choose-test.md +73 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/evaluate.md +91 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/market.md +96 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/run-test.md +111 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition.md +56 -0
- package/skills/egbe-os-playbook/playbooks/product/business-loop.md +141 -0
- package/skills/egbe-os-playbook/playbooks/product/collaboration.md +26 -0
- package/skills/egbe-os-playbook/playbooks/product/deliver.md +75 -0
- package/skills/egbe-os-playbook/playbooks/product/diagnose.md +80 -0
- package/skills/egbe-os-playbook/playbooks/product/evaluate.md +67 -0
- package/skills/egbe-os-playbook/playbooks/product/experience.md +132 -0
- package/skills/egbe-os-playbook/playbooks/product/loop-examples.md +67 -0
- package/skills/egbe-os-playbook/playbooks/product/offer.md +65 -0
- package/skills/egbe-os-playbook/playbooks/product/value.md +91 -0
- package/skills/egbe-os-playbook/playbooks/product.md +67 -0
- package/skills/egbe-os-playbook/references/catalog.md +127 -0
- package/skills/egbe-os-playbook/references/changes.md +167 -0
- package/skills/egbe-os-playbook/scripts/playbook-changes.py +6 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/__init__.py +1 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/cli.py +57 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/operations.py +137 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/protocol.py +132 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/storage.py +180 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/transport.py +113 -0
- package/skills/egbe-os-product-auth/SKILL.md +151 -0
- package/skills/egbe-os-product-auth/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-auth/assets/db/README.md +102 -0
- package/skills/egbe-os-product-auth/assets/db/create-validation-session.mjs +223 -0
- package/skills/egbe-os-product-auth/assets/db/migrate.mjs +64 -0
- package/skills/egbe-os-product-auth/assets/db/migrations/0001_auth.sql +33 -0
- package/skills/egbe-os-product-auth/assets/db/migrations/0002_auth_identities.sql +16 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/AGENTS.append.md +17 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/package.fragment.json +10 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/AGENTS.append.md +9 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/package.fragment.json +13 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/db.ts +31 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/identity.ts +94 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/index.ts +3 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/session.ts +91 -0
- package/skills/egbe-os-product-auth/references/contracts/live-auth-interface.md +108 -0
- package/skills/egbe-os-product-auth/references/frameworks/nextjs.md +34 -0
- package/skills/egbe-os-product-auth/references/security/session-and-credentials.md +73 -0
- package/skills/egbe-os-product-auth/references/ux/auth-experience.md +58 -0
- package/skills/egbe-os-product-auth/references/workflows/account-recovery.md +22 -0
- package/skills/egbe-os-product-auth/references/workflows/build-auth.md +212 -0
- package/skills/egbe-os-product-auth/references/workflows/google.md +34 -0
- package/skills/egbe-os-product-auth/references/workflows/passwordless-email.md +65 -0
- package/skills/egbe-os-product-build/SKILL.md +111 -0
- package/skills/egbe-os-product-build/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-build/references/capabilities.md +25 -0
- package/skills/egbe-os-product-build/references/engineering.md +72 -0
- package/skills/egbe-os-product-build/references/execution.md +55 -0
- package/skills/egbe-os-product-build/references/foundations.md +93 -0
- package/skills/egbe-os-product-build/references/interface-quality.md +32 -0
- package/skills/egbe-os-product-build/references/workflows/private-review-handoff.md +86 -0
- package/skills/egbe-os-product-build/scripts/scaffold.py +296 -0
- package/skills/egbe-os-product-demo-video/SKILL.md +118 -0
- package/skills/egbe-os-product-demo-video/references/recording.md +32 -0
- package/skills/egbe-os-product-market-research/SKILL.md +159 -0
- package/skills/egbe-os-product-market-research/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-market-research/references/catalog.v1.json +177 -0
- package/skills/egbe-os-product-market-research/references/config/channel-footprint-sources.v1.json +99 -0
- package/skills/egbe-os-product-market-research/references/config/creative-taxonomy.v1.json +367 -0
- package/skills/egbe-os-product-market-research/references/contracts/creative-video.md +75 -0
- package/skills/egbe-os-product-market-research/references/contracts/funnel-teardown.md +235 -0
- package/skills/egbe-os-product-market-research/references/contracts/geography-comparison.md +71 -0
- package/skills/egbe-os-product-market-research/references/contracts/lifecycle-capture.md +119 -0
- package/skills/egbe-os-product-market-research/references/contracts/research-artifacts.md +520 -0
- package/skills/egbe-os-product-market-research/references/contracts/walk-mechanics.v2.json +18 -0
- package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.md +137 -0
- package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.md +118 -0
- package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/demand-validation.md +154 -0
- package/skills/egbe-os-product-market-research/references/prompts/demand-validation.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.md +100 -0
- package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.md +126 -0
- package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/target-audience.md +98 -0
- package/skills/egbe-os-product-market-research/references/prompts/target-audience.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/unit-economics.md +217 -0
- package/skills/egbe-os-product-market-research/references/prompts/unit-economics.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/value-proposition.md +113 -0
- package/skills/egbe-os-product-market-research/references/prompts/value-proposition.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/workflows/acquisition-channels.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/channel-footprint.md +163 -0
- package/skills/egbe-os-product-market-research/references/workflows/community-demand.md +100 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitive-landscape.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitor-ads.md +82 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitor-set.md +300 -0
- package/skills/egbe-os-product-market-research/references/workflows/creative-patterns.md +228 -0
- package/skills/egbe-os-product-market-research/references/workflows/demand-validation.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/fleet-prior.md +80 -0
- package/skills/egbe-os-product-market-research/references/workflows/funnel-teardown.md +184 -0
- package/skills/egbe-os-product-market-research/references/workflows/geography-comparison.md +84 -0
- package/skills/egbe-os-product-market-research/references/workflows/keyword-economics.md +122 -0
- package/skills/egbe-os-product-market-research/references/workflows/lifecycle-capture.md +218 -0
- package/skills/egbe-os-product-market-research/references/workflows/local-research.md +55 -0
- package/skills/egbe-os-product-market-research/references/workflows/market-size-and-dynamics.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/preview.md +175 -0
- package/skills/egbe-os-product-market-research/references/workflows/pricing-and-monetization.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/recommendations.md +35 -0
- package/skills/egbe-os-product-market-research/references/workflows/review-mining.md +76 -0
- package/skills/egbe-os-product-market-research/references/workflows/target-audience.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/tiktok-reels-market-trends.md +46 -0
- package/skills/egbe-os-product-market-research/references/workflows/unit-economics.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/value-proposition.md +27 -0
- package/skills/egbe-os-product-market-research/scripts/build-organic-trend-context.py +167 -0
- package/skills/egbe-os-product-market-research/scripts/build-preview-context.py +91 -0
- package/skills/egbe-os-product-market-research/scripts/build-research-query.py +225 -0
- package/skills/egbe-os-product-market-research/scripts/channel-footprint-model.py +294 -0
- package/skills/egbe-os-product-market-research/scripts/connection_identity.py +22 -0
- package/skills/egbe-os-product-market-research/scripts/creative-model.py +364 -0
- package/skills/egbe-os-product-market-research/scripts/creative-selection.py +113 -0
- package/skills/egbe-os-product-market-research/scripts/creative-semantics.py +365 -0
- package/skills/egbe-os-product-market-research/scripts/creative-video.py +542 -0
- package/skills/egbe-os-product-market-research/scripts/egbe_artifacts.py +24 -0
- package/skills/egbe-os-product-market-research/scripts/finalize-organic-trend-watch.py +304 -0
- package/skills/egbe-os-product-market-research/scripts/funnel-email-review.py +97 -0
- package/skills/egbe-os-product-market-research/scripts/funnel-model.py +966 -0
- package/skills/egbe-os-product-market-research/scripts/funnel_features.py +50 -0
- package/skills/egbe-os-product-market-research/scripts/geography-comparison-contract.py +172 -0
- package/skills/egbe-os-product-market-research/scripts/geography-comparison.py +169 -0
- package/skills/egbe-os-product-market-research/scripts/keyword-forecast.py +61 -0
- package/skills/egbe-os-product-market-research/scripts/keyword-locale-publication.py +136 -0
- package/skills/egbe-os-product-market-research/scripts/lifecycle-start.py +190 -0
- package/skills/egbe-os-product-market-research/scripts/persist-research-report.py +63 -0
- package/skills/egbe-os-product-market-research/scripts/research-artifact-io.py +281 -0
- package/skills/egbe-os-product-market-research/scripts/research-evidence.py +496 -0
- package/skills/egbe-os-product-market-research/scripts/research-policy.py +33 -0
- package/skills/egbe-os-product-market-research/scripts/research-section-runtime.py +343 -0
- package/skills/egbe-os-product-market-research/scripts/research-section-workflow.py +288 -0
- package/skills/egbe-os-product-market-research/scripts/research_integrity.py +122 -0
- package/skills/egbe-os-product-market-research/scripts/review-research-completion.py +306 -0
- package/skills/egbe-os-product-market-research/scripts/run-acquisition-channels.py +72 -0
- package/skills/egbe-os-product-market-research/scripts/run-channel-footprint.py +2258 -0
- package/skills/egbe-os-product-market-research/scripts/run-community-demand.py +1603 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitive-landscape.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitor-ads.py +1156 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitor-set.py +2514 -0
- package/skills/egbe-os-product-market-research/scripts/run-creative-patterns.py +2042 -0
- package/skills/egbe-os-product-market-research/scripts/run-demand-validation.py +72 -0
- package/skills/egbe-os-product-market-research/scripts/run-fleet-prior.py +652 -0
- package/skills/egbe-os-product-market-research/scripts/run-funnel-teardown.py +493 -0
- package/skills/egbe-os-product-market-research/scripts/run-keyword-economics.py +1443 -0
- package/skills/egbe-os-product-market-research/scripts/run-lifecycle-capture.py +1543 -0
- package/skills/egbe-os-product-market-research/scripts/run-market-size-and-dynamics.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-os-research.py +311 -0
- package/skills/egbe-os-product-market-research/scripts/run-pricing-and-monetization.py +71 -0
- package/skills/egbe-os-product-market-research/scripts/run-review-mining.py +1051 -0
- package/skills/egbe-os-product-market-research/scripts/run-target-audience.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-unit-economics.py +71 -0
- package/skills/egbe-os-product-market-research/scripts/run-value-proposition.py +67 -0
- package/skills/egbe-os-product-market-research/scripts/upsert-markdown-section.py +156 -0
- package/skills/egbe-os-product-market-research/scripts/walk-funnels.py +249 -0
- package/skills/egbe-os-product-market-research/scripts/write-preview.py +710 -0
- package/skills/egbe-os-product-market-research/scripts/write-recommendations.py +272 -0
- package/skills/egbe-os-product-report/SKILL.md +150 -0
- package/skills/egbe-os-product-report/references/artifacts.md +84 -0
- package/skills/egbe-os-product-report/references/brief.md +34 -0
- package/skills/egbe-os-product-report/references/daily.md +76 -0
- package/skills/egbe-os-product-report/references/sources.md +68 -0
- package/skills/egbe-os-product-routines/SKILL.md +166 -0
- package/skills/egbe-os-product-routines/references/catalog.md +22 -0
- package/skills/egbe-os-product-routines/references/continuation-check.md +41 -0
- package/skills/egbe-os-product-routines/references/product-reporting.md +163 -0
- package/skills/egbe-os-product-routines/references/run-preset.md +32 -0
- package/skills/egbe-os-quickstart/scripts/egbe-curl.py +357 -0
- package/skills/egbe-os-quiz-funnel/SKILL.md +152 -0
- package/skills/egbe-os-quiz-funnel/agents/openai.yaml +4 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.d.mts +224 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.mjs +652 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.test.mjs +764 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.d.mts +31 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.mjs +87 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.test.mjs +265 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-reference.test.mjs +254 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/QUIZ.md +195 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.json +421 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.public.json +369 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/validation.json +21 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/index.html +26 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-bootstrap.js +31 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-early-actions.mjs +11 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-first-screen.mjs +32 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-page.mjs +480 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz.css +264 -0
- package/skills/egbe-os-quiz-funnel/references/competitor-teardown.md +159 -0
- package/skills/egbe-os-quiz-funnel/references/conversion-handoff.md +156 -0
- package/skills/egbe-os-quiz-funnel/references/implementation.md +207 -0
- package/skills/egbe-os-quiz-funnel/references/inputs.md +37 -0
- package/skills/egbe-os-quiz-funnel/references/measurement.md +122 -0
- package/skills/egbe-os-quiz-funnel/references/spec-contract.md +335 -0
- package/skills/egbe-os-quiz-funnel/references/verification.md +101 -0
- package/skills/egbe-os-quiz-funnel/references/walk-mechanics.v2.json +18 -0
- package/skills/egbe-os-quiz-funnel/scripts/compile-quiz-spec.py +1869 -0
- package/skills/egbe-os-quiz-funnel/scripts/prepare-research-identity.py +66 -0
- package/skills/egbe-os-reddit-ads/SKILL.md +121 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/schema.json +41 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/template.html +106 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/schema.json +61 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/template.html +151 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/schema.json +91 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/template.html +185 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/schema.json +51 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/template.html +121 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/schema.json +87 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/template.html +212 -0
- package/skills/egbe-os-reddit-ads/references/creative/html-to-png-pipeline.md +123 -0
- package/skills/egbe-os-reddit-ads/references/creative/static-banner-qa.md +12 -0
- package/skills/egbe-os-reddit-ads/references/creative/static-banner-system.md +16 -0
- package/skills/egbe-os-reddit-ads/references/destination-requirements.md +36 -0
- package/skills/egbe-os-reddit-ads/references/runtime/api-reference.md +435 -0
- package/skills/egbe-os-reddit-ads/references/runtime/artifacts.md +57 -0
- package/skills/egbe-os-reddit-ads/references/runtime/monitoring.md +64 -0
- package/skills/egbe-os-reddit-ads/references/runtime/pixel-and-tracking.md +49 -0
- package/skills/egbe-os-reddit-ads/references/runtime/policies.md +19 -0
- package/skills/egbe-os-reddit-ads/references/runtime/shared-analytics-attribution.md +14 -0
- package/skills/egbe-os-reddit-ads/references/workflows/build-paused.md +35 -0
- package/skills/egbe-os-reddit-ads/references/workflows/launch-ready.md +19 -0
- package/skills/egbe-os-reddit-ads/references/workflows/launch.md +32 -0
- package/skills/egbe-os-reddit-ads/references/workflows/readiness.md +9 -0
- package/skills/egbe-os-reddit-ads/scripts/capture-ad.sh +178 -0
- package/skills/egbe-os-reddit-ads/scripts/validate-reddit-artifacts.py +187 -0
- package/skills/egbe-os-report-ui/SKILL.md +133 -0
- package/skills/egbe-os-report-ui/assets/egbe-wordmark.svg +9 -0
- package/skills/egbe-os-report-ui/assets/examples/components.html +417 -0
- package/skills/egbe-os-report-ui/assets/examples/editorial.html +209 -0
- package/skills/egbe-os-report-ui/assets/scaffold.html +179 -0
- package/skills/egbe-os-report-ui/references/components.md +209 -0
- package/skills/egbe-os-research/SKILL.md +125 -0
- package/skills/egbe-os-saas-unit-economics/SKILL.md +188 -0
- package/skills/egbe-os-scrape/SKILL.md +160 -0
- package/skills/egbe-os-search/SKILL.md +182 -0
- package/skills/egbe-os-search/references/google-places.md +81 -0
- package/skills/egbe-os-support/SKILL.md +149 -0
- package/skills/egbe-os-telemetry/SKILL.md +344 -0
- package/skills/egbe-os-telemetry/references/harnesses/claude-code.md +97 -0
- package/skills/egbe-os-telemetry/references/harnesses/codex.md +22 -0
- package/skills/egbe-os-telemetry/references/harnesses/hermes.md +39 -0
- package/skills/egbe-os-telemetry/references/harnesses/openclaw.md +139 -0
- package/skills/egbe-os-telemetry/references/harnesses/opencode.md +28 -0
- package/skills/egbe-os-tools/SKILL.md +180 -0
- package/skills/egbe-os-tools/references/theona.md +26 -0
- package/skills/egbe-os-wallet/SKILL.md +181 -0
- package/skills/egbe-setup/EGBE.md +484 -0
- package/skills/egbe-setup/SKILL.md +116 -0
- package/skills/egbe-setup/references/project.md +80 -0
- package/state.js +37 -0
- 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())
|