@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,187 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Check saved evidence for one operation; no network calls or method gates."""
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import argparse
|
|
6
|
+
import json
|
|
7
|
+
import math
|
|
8
|
+
import sys
|
|
9
|
+
from datetime import datetime
|
|
10
|
+
from pathlib import Path
|
|
11
|
+
from typing import Any
|
|
12
|
+
|
|
13
|
+
CHANNEL = "meta"
|
|
14
|
+
GROUP_IDS = "adset_ids"
|
|
15
|
+
GROUP_ROWS = "adsets"
|
|
16
|
+
GROUP_KIND = "adset"
|
|
17
|
+
PHASES = ("build-paused", "launch-ready", "launch", "status", "monitoring", "pause")
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
def timestamp(value: Any) -> datetime | None:
|
|
21
|
+
try:
|
|
22
|
+
result = datetime.fromisoformat(value.replace("Z", "+00:00"))
|
|
23
|
+
return result if result.tzinfo is not None else None
|
|
24
|
+
except (AttributeError, TypeError, ValueError):
|
|
25
|
+
return None
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
def identifier(value: Any) -> bool:
|
|
29
|
+
return isinstance(value, str) and bool(value.strip()) and value == value.strip()
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
def observed_status(row: dict) -> str:
|
|
33
|
+
keys = ("configured_status", "status") if CHANNEL == "reddit" else ("effective_status", "status")
|
|
34
|
+
return next((str(row[key]).upper() for key in keys if row.get(key)), "")
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
def validate(state: Any, readback: Any, phase: str, campaign_id: str) -> list[str]:
|
|
38
|
+
issues: list[str] = []
|
|
39
|
+
if not isinstance(state, dict) or not isinstance(readback, dict):
|
|
40
|
+
return ["state and readback must be JSON objects"]
|
|
41
|
+
if state.get("channel") != CHANNEL:
|
|
42
|
+
issues.append(f"campaign-state.json.channel must be {CHANNEL}")
|
|
43
|
+
objects = state.get("objects")
|
|
44
|
+
if not isinstance(objects, dict):
|
|
45
|
+
return issues + ["campaign-state.json.objects must be an object"]
|
|
46
|
+
if not identifier(campaign_id) or objects.get("campaign_id") != campaign_id:
|
|
47
|
+
issues.append("campaign-state campaign_id must match the exact requested campaign ID")
|
|
48
|
+
|
|
49
|
+
selected = {"campaign": [campaign_id]}
|
|
50
|
+
for key, kind in ((GROUP_IDS, GROUP_KIND), ("ad_ids", "ad")):
|
|
51
|
+
values = objects.get(key, [])
|
|
52
|
+
if not isinstance(values, list) or any(not identifier(value) for value in values):
|
|
53
|
+
issues.append(f"objects.{key} must contain string IDs")
|
|
54
|
+
values = []
|
|
55
|
+
if len(set(values)) != len(values):
|
|
56
|
+
issues.append(f"objects.{key} contains duplicate IDs")
|
|
57
|
+
if phase in {"build-paused", "launch-ready", "launch"} and not values:
|
|
58
|
+
issues.append(f"objects.{key} must be non-empty for {phase}")
|
|
59
|
+
selected[kind] = values
|
|
60
|
+
|
|
61
|
+
observed_at = timestamp(readback.get("observed_at"))
|
|
62
|
+
if observed_at is None:
|
|
63
|
+
issues.append("readback.observed_at must be an ISO-8601 timestamp with timezone")
|
|
64
|
+
rows = {}
|
|
65
|
+
campaign = readback.get("campaign")
|
|
66
|
+
if not isinstance(campaign, dict) or campaign.get("id") != campaign_id:
|
|
67
|
+
issues.append("readback campaign ID must match the exact requested campaign")
|
|
68
|
+
else:
|
|
69
|
+
rows[("campaign", campaign_id)] = campaign
|
|
70
|
+
for key, kind in ((GROUP_ROWS, GROUP_KIND), ("ads", "ad")):
|
|
71
|
+
entries = readback.get(key, [])
|
|
72
|
+
if not isinstance(entries, list):
|
|
73
|
+
issues.append(f"readback.{key} must be a list")
|
|
74
|
+
entries = []
|
|
75
|
+
seen = set()
|
|
76
|
+
for row in entries:
|
|
77
|
+
if not isinstance(row, dict) or not identifier(row.get("id")):
|
|
78
|
+
issues.append(f"readback.{key} contains an invalid object ID")
|
|
79
|
+
continue
|
|
80
|
+
identity = row["id"]
|
|
81
|
+
if identity in seen:
|
|
82
|
+
issues.append(f"readback.{key} contains duplicate ID {identity}")
|
|
83
|
+
seen.add(identity)
|
|
84
|
+
rows[(kind, identity)] = row
|
|
85
|
+
parent_field = "campaign_id" if kind == GROUP_KIND else ("ad_group_id" if CHANNEL == "reddit" else "adset_id")
|
|
86
|
+
parents = [campaign_id] if kind == GROUP_KIND else selected[GROUP_KIND]
|
|
87
|
+
if parent_field in row and row[parent_field] not in parents:
|
|
88
|
+
issues.append(f"readback {kind} {identity} has a mismatched parent")
|
|
89
|
+
for identity in selected[kind]:
|
|
90
|
+
if identity not in seen:
|
|
91
|
+
issues.append(f"readback is missing selected {kind} ID {identity}")
|
|
92
|
+
|
|
93
|
+
selected_rows = [rows[(kind, identity)] for kind, ids in selected.items()
|
|
94
|
+
for identity in ids if (kind, identity) in rows]
|
|
95
|
+
paused = {"PAUSED", "ARCHIVED", "DELETED"}
|
|
96
|
+
if phase in {"build-paused", "launch-ready"}:
|
|
97
|
+
if any(observed_status(row) != "PAUSED" for row in selected_rows):
|
|
98
|
+
issues.append("paused build/readiness requires PAUSED readback for every selected object")
|
|
99
|
+
if phase == "pause" and isinstance(campaign, dict) and observed_status(campaign) not in paused:
|
|
100
|
+
issues.append("pause requires confirmed non-serving campaign readback")
|
|
101
|
+
if phase == "pause" and state.get("status") not in {"paused", "archived", "deleted"}:
|
|
102
|
+
issues.append("pause state must reflect the confirmed non-serving campaign")
|
|
103
|
+
active_claim = state.get("status") in {"active", "monitoring"}
|
|
104
|
+
if active_claim and any(observed_status(row) != "ACTIVE" for row in selected_rows):
|
|
105
|
+
issues.append("active state requires ACTIVE provider readback for every selected object")
|
|
106
|
+
if phase == "launch" and state.get("status") not in {"active", "activation_pending"}:
|
|
107
|
+
issues.append("launch status must be active or activation_pending")
|
|
108
|
+
|
|
109
|
+
# These optional operational values are checked when recorded, not demanded
|
|
110
|
+
# for a status/pause. The live API owns its configurable budget limits.
|
|
111
|
+
budget = state.get("budget")
|
|
112
|
+
if budget is not None:
|
|
113
|
+
value = budget.get("daily_budget_usd") if isinstance(budget, dict) else None
|
|
114
|
+
if isinstance(value, bool) or not isinstance(value, (int, float)) or not math.isfinite(value) or value <= 0:
|
|
115
|
+
issues.append("recorded daily_budget_usd must be a finite positive number")
|
|
116
|
+
if "create_payload" in state or "create_idempotency_key" in state:
|
|
117
|
+
key = state.get("create_idempotency_key")
|
|
118
|
+
if not identifier(key) or len(key) > 128 or not isinstance(state.get("create_payload"), dict):
|
|
119
|
+
issues.append("campaign create recovery requires the saved key and exact payload")
|
|
120
|
+
|
|
121
|
+
if CHANNEL == "reddit":
|
|
122
|
+
activation = state.get("activation")
|
|
123
|
+
pending = state.get("status") == "activation_pending"
|
|
124
|
+
# Status-only reads can observe existing ACTIVE configuration without
|
|
125
|
+
# claiming a new activation. New launch completion requires receipts.
|
|
126
|
+
if phase == "launch" or pending:
|
|
127
|
+
if not isinstance(activation, dict):
|
|
128
|
+
issues.append("activation requires current-attempt mutation evidence")
|
|
129
|
+
else:
|
|
130
|
+
started = timestamp(activation.get("started_at"))
|
|
131
|
+
receipts = activation.get("accepted_mutations")
|
|
132
|
+
valid = (
|
|
133
|
+
started is not None and observed_at is not None
|
|
134
|
+
and started <= observed_at and isinstance(receipts, list)
|
|
135
|
+
and (bool(receipts) or pending)
|
|
136
|
+
)
|
|
137
|
+
for receipt in receipts if isinstance(receipts, list) else []:
|
|
138
|
+
if not isinstance(receipt, dict):
|
|
139
|
+
valid = False
|
|
140
|
+
continue
|
|
141
|
+
accepted = timestamp(receipt.get("mutation_accepted_at"))
|
|
142
|
+
valid = valid and (
|
|
143
|
+
(receipt.get("object_type"), receipt.get("object_id")) in rows
|
|
144
|
+
and receipt.get("object_id") in selected.get(receipt.get("object_type"), [])
|
|
145
|
+
and receipt.get("mutation_accepted") is True
|
|
146
|
+
and receipt.get("requested_status") == "ACTIVE"
|
|
147
|
+
and accepted is not None and started <= accepted <= observed_at
|
|
148
|
+
)
|
|
149
|
+
if not valid:
|
|
150
|
+
issues.append("activation requires accepted ACTIVE mutation receipts for selected objects from this attempt, followed by timestamped readback")
|
|
151
|
+
if pending and started is not None:
|
|
152
|
+
for field in ("launched_at", "restarted_at", "reactivated_at"):
|
|
153
|
+
value = timestamp(state.get(field))
|
|
154
|
+
if value is not None and value >= started:
|
|
155
|
+
issues.append(f"activation_pending must not record a successful {field}")
|
|
156
|
+
return issues
|
|
157
|
+
|
|
158
|
+
|
|
159
|
+
def main(argv: list[str] | None = None) -> int:
|
|
160
|
+
parser = argparse.ArgumentParser(description=__doc__)
|
|
161
|
+
parser.add_argument("--product-root", type=Path, required=True)
|
|
162
|
+
parser.add_argument("--campaign-path", required=True, help="Product-relative folder for this exact operation.")
|
|
163
|
+
parser.add_argument("--campaign-id", required=True, help="Exact ID selected by the task, not inferred from a name.")
|
|
164
|
+
parser.add_argument("--phase", required=True, choices=PHASES)
|
|
165
|
+
args = parser.parse_args(argv)
|
|
166
|
+
root = args.product_root.resolve()
|
|
167
|
+
relative = Path(args.campaign_path)
|
|
168
|
+
directory = (root / relative).resolve()
|
|
169
|
+
try:
|
|
170
|
+
if relative.is_absolute() or directory == root or not directory.is_relative_to(root):
|
|
171
|
+
raise ValueError("campaign-path must be a folder inside product-root")
|
|
172
|
+
state = json.loads((directory / "campaign-state.json").read_text(encoding="utf-8"))
|
|
173
|
+
readback = json.loads((directory / "launch-readback.json").read_text(encoding="utf-8"))
|
|
174
|
+
issues = validate(state, readback, args.phase, args.campaign_id)
|
|
175
|
+
except (OSError, ValueError) as exc:
|
|
176
|
+
issues = [str(exc)]
|
|
177
|
+
if issues:
|
|
178
|
+
print(f"FAIL {CHANNEL} operation evidence", file=sys.stderr)
|
|
179
|
+
for issue in issues:
|
|
180
|
+
print(f"- {issue}", file=sys.stderr)
|
|
181
|
+
return 1
|
|
182
|
+
print(f"OK {CHANNEL} operation evidence phase={args.phase}")
|
|
183
|
+
return 0
|
|
184
|
+
|
|
185
|
+
|
|
186
|
+
if __name__ == "__main__":
|
|
187
|
+
raise SystemExit(main())
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-notifications
|
|
3
|
+
description: Read platform notifications and mark them read.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use to review notices affecting the business."
|
|
6
|
+
egbe-category: "Business operations"
|
|
7
|
+
egbe-visible: "false"
|
|
8
|
+
egbe-title: "Project notices"
|
|
9
|
+
egbe-description: "Read updates and notices from Egbe about your project."
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
<!-- egbe-mcp-connection:v1 -->
|
|
13
|
+
This skill comes with the Egbe plugin. If this project has its own installed copy
|
|
14
|
+
of the skill, use that copy instead. Otherwise make every Egbe API call it
|
|
15
|
+
describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
|
|
16
|
+
PUT, PATCH and DELETE (with `method`). Pass the API path (for example
|
|
17
|
+
`/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
|
|
18
|
+
`egbe-curl.py` and catalog update checks; the connection authenticates and
|
|
19
|
+
identifies the request. Also pass the `business` that `egbe_setup` returned.
|
|
20
|
+
Where this skill sends an `Idempotency-Key` header, pass the same value as
|
|
21
|
+
`idempotency_key` and reuse it when retrying. A result with a `continuation`
|
|
22
|
+
holds one part of a long body; read the next part with `egbe_read`, the same
|
|
23
|
+
`path` and `business`, and that `continuation`.
|
|
24
|
+
Read bundled files beside this `SKILL.md`. For published skill resources on
|
|
25
|
+
Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
|
|
26
|
+
|
|
27
|
+
Publishing works through the connector: commit the app's files with the JSON
|
|
28
|
+
commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
|
|
29
|
+
commit SHA; no git push or workspace setup is needed. A step that needs a local
|
|
30
|
+
project key or a bundled script, such as a local `npx convex deploy`, needs a
|
|
31
|
+
set-up project workspace. In a persistent
|
|
32
|
+
project workspace that is not set up yet, set it up as the `egbe-setup` skill's
|
|
33
|
+
project setup describes.
|
|
34
|
+
Without such a workspace, or if it refuses, tell the founder that this step needs
|
|
35
|
+
an agent with a set-up project folder, and continue with the rest of the work.
|
|
36
|
+
|
|
37
|
+
If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
|
|
38
|
+
available, the plugin's connector is not signed in for this agent. Tell
|
|
39
|
+
the founder how to connect it, as the `egbe-setup` skill describes, rather than
|
|
40
|
+
saying Egbe is unavailable.
|
|
41
|
+
|
|
42
|
+
The connector's tools work even where this environment's shell cannot reach
|
|
43
|
+
Egbe: their calls travel through this agent's connection, not through the
|
|
44
|
+
shell's network. A step that runs in the shell, such as a bundled script, a `git
|
|
45
|
+
push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
|
|
46
|
+
Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
|
|
47
|
+
before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
|
|
48
|
+
the founder: they allow that host in this agent's network settings or continue
|
|
49
|
+
with an agent on their own computer. Code can also be published without the
|
|
50
|
+
shell by committing through the connector (`egbe-os-git`, "Without a terminal").
|
|
51
|
+
Until the shell step or that commit and its deploy succeed, do not report the
|
|
52
|
+
work as published: a preview in this agent or on this computer is not an Egbe
|
|
53
|
+
deployment.
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
# Notifications
|
|
57
|
+
|
|
58
|
+
Your inbox of system and Egbe team notices (deploys, limits, capability updates).
|
|
59
|
+
Authenticate with `Authorization: Bearer $OS_API_KEY`. Base URL: `https://os.hz.egbe.dev`.
|
|
60
|
+
|
|
61
|
+
## Read your inbox
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
# all notifications (newest first)
|
|
65
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/notifications" -s
|
|
66
|
+
|
|
67
|
+
# only unread
|
|
68
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/notifications?unread=1" -s
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
Each item has `id`, `title`, `body`, `level` (`info`/`warning`/`action`),
|
|
72
|
+
`read_at` (null = unread), `created_at`.
|
|
73
|
+
|
|
74
|
+
## Mark one read
|
|
75
|
+
|
|
76
|
+
```bash
|
|
77
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/notifications/123/read" -s -X POST
|
|
78
|
+
```
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-openai-ads
|
|
3
|
+
description: Build, operate and measure OpenAI Ads campaigns, including conversion tracking.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Offer when customers discover products through AI; use for existing OpenAI Ads campaigns."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "OpenAI Ads"
|
|
8
|
+
egbe-description: "Run ads through Egbe. Create and manage OpenAI advertising campaigns, track conversions and review performance."
|
|
9
|
+
egbe-category: "Marketing & growth"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
<!-- egbe-mcp-connection:v1 -->
|
|
13
|
+
This skill comes with the Egbe plugin. If this project has its own installed copy
|
|
14
|
+
of the skill, use that copy instead. Otherwise make every Egbe API call it
|
|
15
|
+
describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
|
|
16
|
+
PUT, PATCH and DELETE (with `method`). Pass the API path (for example
|
|
17
|
+
`/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
|
|
18
|
+
`egbe-curl.py` and catalog update checks; the connection authenticates and
|
|
19
|
+
identifies the request. Also pass the `business` that `egbe_setup` returned.
|
|
20
|
+
Where this skill sends an `Idempotency-Key` header, pass the same value as
|
|
21
|
+
`idempotency_key` and reuse it when retrying. A result with a `continuation`
|
|
22
|
+
holds one part of a long body; read the next part with `egbe_read`, the same
|
|
23
|
+
`path` and `business`, and that `continuation`.
|
|
24
|
+
Read bundled files beside this `SKILL.md`. For published skill resources on
|
|
25
|
+
Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
|
|
26
|
+
|
|
27
|
+
Publishing works through the connector: commit the app's files with the JSON
|
|
28
|
+
commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
|
|
29
|
+
commit SHA; no git push or workspace setup is needed. A step that needs a local
|
|
30
|
+
project key or a bundled script, such as a local `npx convex deploy`, needs a
|
|
31
|
+
set-up project workspace. In a persistent
|
|
32
|
+
project workspace that is not set up yet, set it up as the `egbe-setup` skill's
|
|
33
|
+
project setup describes.
|
|
34
|
+
Without such a workspace, or if it refuses, tell the founder that this step needs
|
|
35
|
+
an agent with a set-up project folder, and continue with the rest of the work.
|
|
36
|
+
|
|
37
|
+
If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
|
|
38
|
+
available, the plugin's connector is not signed in for this agent. Tell
|
|
39
|
+
the founder how to connect it, as the `egbe-setup` skill describes, rather than
|
|
40
|
+
saying Egbe is unavailable.
|
|
41
|
+
|
|
42
|
+
The connector's tools work even where this environment's shell cannot reach
|
|
43
|
+
Egbe: their calls travel through this agent's connection, not through the
|
|
44
|
+
shell's network. A step that runs in the shell, such as a bundled script, a `git
|
|
45
|
+
push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
|
|
46
|
+
Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
|
|
47
|
+
before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
|
|
48
|
+
the founder: they allow that host in this agent's network settings or continue
|
|
49
|
+
with an agent on their own computer. Code can also be published without the
|
|
50
|
+
shell by committing through the connector (`egbe-os-git`, "Without a terminal").
|
|
51
|
+
Until the shell step or that commit and its deploy succeed, do not report the
|
|
52
|
+
work as published: a preview in this agent or on this computer is not an Egbe
|
|
53
|
+
deployment.
|
|
54
|
+
|
|
55
|
+
Run a script bundled with this skill from the root of a project folder set up
|
|
56
|
+
for Egbe, with `OS_AGENT_NAME="<your agent name>"` set inline, such as `OpenCode`.
|
|
57
|
+
A script that calls Egbe reads `OS_URL`, `OS_API_KEY` and this agent's connection
|
|
58
|
+
ID from `.env.local` through Egbe's request helper, which comes with the plugin at
|
|
59
|
+
`../egbe-os-quickstart/scripts/egbe-curl.py` from this skill's folder. Where this
|
|
60
|
+
skill says a script needs `OS_URL` or `OS_API_KEY` in its environment, start it
|
|
61
|
+
through the helper, which loads `.env.local` without executing it:
|
|
62
|
+
`python3 <helper> --egbe-run <command>`, with the helper's absolute path. Where
|
|
63
|
+
this skill writes `<skills-directory>`, use the plugin's `skills` folder, which
|
|
64
|
+
holds this skill's folder.
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
# OpenAI Ads
|
|
68
|
+
|
|
69
|
+
Run the requested part of a campaign lifecycle from any product repository.
|
|
70
|
+
No scaffold, egbe-os-product-build stage, instance layout or particular agent runtime
|
|
71
|
+
is required. An edit or audit does not authorize a new campaign or a launch.
|
|
72
|
+
|
|
73
|
+
## Runtime and reference discovery
|
|
74
|
+
|
|
75
|
+
Use `OS_URL` and `OS_API_KEY` with the `ads` scope:
|
|
76
|
+
`Authorization: Bearer $OS_API_KEY`. Provider credentials stay inside Egbe OS.
|
|
77
|
+
Browser Pixel is the public tracking exception; management and server event
|
|
78
|
+
delivery go through OS.
|
|
79
|
+
|
|
80
|
+
`GET /ads/openai/skill` returns this entrypoint only. Read the referenced files
|
|
81
|
+
from the installed `egbe-os-openai-ads` bundle. If absent, retrieve the complete
|
|
82
|
+
bundle with `GET $OS_URL/skills/openai-ads` (ZIP), or fetch one file through
|
|
83
|
+
`GET $OS_URL/skills/openai-ads/resources/<relative-path>`, for example
|
|
84
|
+
`references/workflows/monitoring.md`. Do not guess missing instructions.
|
|
85
|
+
Exact request schemas are at `$OS_URL/openapi.json`.
|
|
86
|
+
|
|
87
|
+
## Choose the workflow
|
|
88
|
+
|
|
89
|
+
For campaign work read the [artifact contract](references/runtime/artifacts.md),
|
|
90
|
+
then only the relevant workflow. Resolve the existing campaign before writing.
|
|
91
|
+
|
|
92
|
+
| Request | Read |
|
|
93
|
+
|---|---|
|
|
94
|
+
| Inspect destination-specific requirements only | [Destination requirements](references/destination-requirements.md) |
|
|
95
|
+
| Check account/product readiness | [Readiness](references/workflows/readiness.md) |
|
|
96
|
+
| Assemble planned targeting and creatives | [Creative and targeting assembly](references/workflows/creative-assembly.md) |
|
|
97
|
+
| Bind UTMs and product analytics | [Tracking](references/workflows/tracking.md) |
|
|
98
|
+
| Build paused objects or recover a partial build | [Build and recovery](references/workflows/build-paused.md) |
|
|
99
|
+
| Activate an approved campaign | [Launch](references/workflows/launch.md) |
|
|
100
|
+
| Diagnose serving/review blockers, inspect performance or edit an existing campaign | [Monitoring and changes](references/workflows/monitoring.md) |
|
|
101
|
+
| Stop delivery and confirm state | [Pause](references/workflows/pause.md) |
|
|
102
|
+
| Add optional Pixel/server conversions or conversion bidding | [Conversions](references/workflows/conversions.md) |
|
|
103
|
+
| Exact operations, units, errors and readback | [API reference](references/runtime/api-reference.md) |
|
|
104
|
+
|
|
105
|
+
## Shared operating boundaries
|
|
106
|
+
|
|
107
|
+
- Preserve the selected campaign, segment, offer, destination and approved daily
|
|
108
|
+
budget. Reuse recorded provider IDs. A new request key is not recovery.
|
|
109
|
+
- Create paused; launch only within explicit founder authorization or an
|
|
110
|
+
applicable product marketing policy. Neither this skill nor an API key grants
|
|
111
|
+
permission to spend. Never raise an approved budget to satisfy provider minima.
|
|
112
|
+
- Only daily USD budgets. Daily budget is an average, not a hard daily cap;
|
|
113
|
+
use the API reference for pacing and wallet semantics. No mandatory lifetime
|
|
114
|
+
budget, arbitrary total-spend ceiling, or copied cross-network thresholds.
|
|
115
|
+
- Distinguish intended configuration, observed provider state, actual delivery,
|
|
116
|
+
product outcomes and attribution. Do not infer one from another.
|
|
117
|
+
- Provider conversion tracking is optional for ordinary traffic campaigns.
|
|
118
|
+
- Monitoring reads do not authorize campaign changes. These API operations do
|
|
119
|
+
not install recurring jobs.
|
|
120
|
+
- Persist artifacts after meaningful progress and before handing off a partial
|
|
121
|
+
result. Preserve repository conventions; commit/push only when authorized by
|
|
122
|
+
the current task or repository rules, not merely because this skill ran.
|
|
123
|
+
- Artifact repair and audits do not mutate provider objects. Real
|
|
124
|
+
repairs use the explicitly authorized build/edit workflow.
|
|
125
|
+
|
|
126
|
+
## Local self-check and handoff
|
|
127
|
+
|
|
128
|
+
Run the portable, read-only structural check from the downloaded skill:
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
python3 <skill-dir>/scripts/validate-openai-artifacts.py \
|
|
132
|
+
--product-root <product-repo-root> --phase <phase>
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
Use `--campaign <openai-slug>` when the task names a different campaign from
|
|
136
|
+
the selected one. See the artifact contract for phases and required files.
|
|
137
|
+
This validates structure and cross-references, not permission, current provider
|
|
138
|
+
state, creative quality or campaign success. A validation error never justifies
|
|
139
|
+
inventing evidence or blocking an urgent authorized pause.
|
|
140
|
+
|
|
141
|
+
Return: campaign folder/ID, actual changes (or none), observed state and timestamp,
|
|
142
|
+
evidence gaps and operation outcome. For unfinished work include the pending
|
|
143
|
+
operation and its saved recovery key; never include credentials or customer data.
|
|
144
|
+
|
|
145
|
+
## Scope
|
|
146
|
+
|
|
147
|
+
No raw provider passthrough, lifetime budgets, product feeds, custom audiences,
|
|
148
|
+
automatic payment-gateway events, fleet scheduling or Dashboard integration.
|
|
149
|
+
Scheduling is external to these API operations.
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# Chat-card creative production
|
|
2
|
+
|
|
3
|
+
Read this when drafting or changing an image ad, not for a metrics-only audit.
|
|
4
|
+
|
|
5
|
+
## Provider requirements
|
|
6
|
+
|
|
7
|
+
- [Ads API](https://developers.openai.com/ads/api-reference/ads): `chat_card`,
|
|
8
|
+
title 3–50 characters, body up to 100, real target URL and uploaded `file_id`.
|
|
9
|
+
On creative updates send the complete object. Editing an ad can trigger review.
|
|
10
|
+
- [Files API](https://developers.openai.com/ads/api-reference/files): upload the
|
|
11
|
+
image, then attach its returned file ID. A generated file alone is not an ad.
|
|
12
|
+
- [OpenAI ad policies](https://openai.com/policies/ad-policies/): check the offer,
|
|
13
|
+
claims, creative and destination, including restricted categories. Do not imply
|
|
14
|
+
OpenAI endorses the product or that the card is a ChatGPT response.
|
|
15
|
+
- Check current image/crop requirements in official docs and provider validation.
|
|
16
|
+
Do not copy another network's dimensions, text-overlay rules or file limits.
|
|
17
|
+
`paused`, `in_review` and `approved` are separate facts; paused creation is not
|
|
18
|
+
policy approval. Return a rejection and its reason instead of bypassing review.
|
|
19
|
+
|
|
20
|
+
## Generate → inspect → upload → attach
|
|
21
|
+
|
|
22
|
+
Through the Egbe connector, step 2's generation is refused. There, start from an
|
|
23
|
+
existing approved image, a stock image (`egbe-os-images` →
|
|
24
|
+
`references/stock-images.md`) or one the founder supplies at a public HTTPS URL,
|
|
25
|
+
and continue from step 3. Generating a new image needs a project workspace
|
|
26
|
+
connected with the business's Egbe key (`egbe_local_setup`).
|
|
27
|
+
|
|
28
|
+
1. Read `$OS_URL/images/skill` and `GET $OS_URL/images` using the current
|
|
29
|
+
`OS_API_KEY`. Choose an available model within the task's cost/quality scope;
|
|
30
|
+
never request OpenAI provider keys or introduce `IMAGE_API_KEY`.
|
|
31
|
+
2. Call `POST $OS_URL/images/generations` per that live skill. Describe the actual
|
|
32
|
+
product, intended visual idea, framing, crop-safe subject and what must not be
|
|
33
|
+
fabricated. Existing approved images may be reused instead of regenerated.
|
|
34
|
+
3. Save and view the returned bitmap. Check legibility at card size, artifacts,
|
|
35
|
+
product accuracy and cropping. Fix an actual defect, not by unbounded model
|
|
36
|
+
probing. Preserve the prompt/model and approved asset path in campaign records.
|
|
37
|
+
4. Use the returned image's stable public `url` when `stored:true`. If only
|
|
38
|
+
base64 is available, save it and store it with `POST $OS_URL/tools/ad-assets/upload`
|
|
39
|
+
(multipart `file`, or JSON `content_base64` up to about 512 KiB) or, through
|
|
40
|
+
the Egbe connector for a larger file, an upload session (`POST $OS_URL/uploads`,
|
|
41
|
+
then `/parts` and `/complete`); use the returned `data.url`. Do not regenerate
|
|
42
|
+
just to upload, pass local paths to the Ads API, or invent hosting URLs.
|
|
43
|
+
5. `POST $OS_URL/ads/openai/uploads` with `{product_slug,image_url}` and a saved
|
|
44
|
+
idempotency key. Save its returned `data.id` (the uploaded file ID).
|
|
45
|
+
6. Attach that ID as `creative.file_id` when creating/updating the paused ad.
|
|
46
|
+
Independently read the ad back and verify image, title/body, tracked URL and
|
|
47
|
+
status. Inspect the card in Ads Manager/preview when available; do not claim
|
|
48
|
+
rendered-card verification from JSON alone.
|
|
49
|
+
|
|
50
|
+
Finish with approved local assets and recorded provider IDs/readback, or identify
|
|
51
|
+
the exact unfinished operation. Keep credentials and customer data out of artifacts.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# OpenAI destination requirements
|
|
2
|
+
|
|
3
|
+
Use for OpenAI ad destinations, not the account or conversion-readiness workflow.
|
|
4
|
+
Apply network checks to the same evidence as the common visitor-path review.
|
|
5
|
+
Technical sources were checked 2026-09-29; verify current applicable wording.
|
|
6
|
+
|
|
7
|
+
For a complete visitor-path review, apply the `egbe-os-destination-readiness` skill with
|
|
8
|
+
this reference in one audit run. If missing locally, its full bundle is available
|
|
9
|
+
at `GET $OS_URL/skills/destination-readiness`.
|
|
10
|
+
|
|
11
|
+
- For a chat-card, inspect the actual `creative.target_url` and its destination.
|
|
12
|
+
The [campaign/creative documentation](https://developers.openai.com/ads/campaign-management)
|
|
13
|
+
requires an HTTP(S) URL within 2,048 characters, accessible to OpenAI ad
|
|
14
|
+
crawlers. Include actual query parameters in the inspection; a browser success
|
|
15
|
+
is not proof that a crawler can access the page. Do not substitute training
|
|
16
|
+
crawler rules for ad-crawler requirements.
|
|
17
|
+
- If the actual integration uses product-feed ads, the
|
|
18
|
+
[feed documentation](https://developers.openai.com/ads/product-feeds)
|
|
19
|
+
requires publicly accessible HTTPS product pages/images. Compare the selected
|
|
20
|
+
item's offer with the destination; do not add feed setup to a chat-card review.
|
|
21
|
+
- For an offer/content concern, consult the relevant
|
|
22
|
+
[OpenAI ad policy](https://openai.com/policies/ad-policies/) and record the
|
|
23
|
+
actual clause and applicability. The API's acceptance of a URL is not evidence
|
|
24
|
+
of policy compliance. If the policy cannot be inspected, distinguish that
|
|
25
|
+
uncertainty from observed broken or misleading visitor steps.
|
|
26
|
+
|
|
27
|
+
Return affected path, evidence, source and repair/recheck. Do not infer review
|
|
28
|
+
approval or launch eligibility from a usable destination. Image-production rules
|
|
29
|
+
remain in the creative workflow; this review does not create or edit an ad.
|