@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,95 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-campaign-landing-page
|
|
3
|
+
description: Implement campaign destinations, attribution, lead capture and booking or product handoffs.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use when a campaign needs a working destination, lead form or attributed handoff."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Campaign landing pages"
|
|
8
|
+
egbe-description: "Build campaign pages on Egbe with working requests, bookings and attribution to the visitor's source."
|
|
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
|
+
|
|
56
|
+
# Campaign page implementation
|
|
57
|
+
|
|
58
|
+
Implement the accepted page/test plan: content, audience, offer, variants, actions,
|
|
59
|
+
destinations and required measurement. Reuse actual product materials and existing
|
|
60
|
+
source. Missing material decisions go back to the caller; this capability does
|
|
61
|
+
not choose a new campaign strategy or require a fresh research pack.
|
|
62
|
+
|
|
63
|
+
The main homepage is `egbe-os-design-landing-page`. Provider campaign creation,
|
|
64
|
+
creative limits and spend controls belong to the selected channel skill; building
|
|
65
|
+
a page neither changes those objects nor authorizes traffic.
|
|
66
|
+
|
|
67
|
+
## Through the Egbe connector
|
|
68
|
+
|
|
69
|
+
Through the connector you can change and publish the page with `egbe-os-git`
|
|
70
|
+
("Without a terminal") and `egbe-os-deploy`, wire analytics and read its events.
|
|
71
|
+
Rendered-page and interactive checks need a browser: use this environment's own
|
|
72
|
+
browser tools, or a set-up project workspace. In a persistent project workspace
|
|
73
|
+
not set up yet, call `egbe_local_setup`. Without either, read pages with
|
|
74
|
+
`egbe-os-scrape` and HTTP responses, label each interactive or visual claim
|
|
75
|
+
unverified, and tell the founder which check remains.
|
|
76
|
+
|
|
77
|
+
## Build the owned page
|
|
78
|
+
|
|
79
|
+
1. Inspect the accepted inputs, current route, storage and integration contracts.
|
|
80
|
+
Preserve approved claims and design within their scope. Do not invent proof
|
|
81
|
+
or render internal plan metadata as public copy.
|
|
82
|
+
2. Follow [OS wiring](references/os-wiring.md) for hosting, credentials, endpoints
|
|
83
|
+
and analytics. Preserve existing app bindings rather than deploying a duplicate.
|
|
84
|
+
3. Implement [routing and attribution](references/routing.md) and the applicable
|
|
85
|
+
[lead, booking or product handoff](references/leads-calendar-and-tracking.md).
|
|
86
|
+
Use the accepted fields and behavior; a popup, extra qualification form or
|
|
87
|
+
email sequence is not a universal requirement.
|
|
88
|
+
4. Use `egbe-os-product-build` → `references/interface-quality.md` for interface
|
|
89
|
+
implementation and check [campaign QA](references/qa.md) for integration proof.
|
|
90
|
+
5. Publish through Git/Deploy only when requested. Report the page location,
|
|
91
|
+
verified operations, remaining gaps and the exact serving revision if deployed.
|
|
92
|
+
|
|
93
|
+
Keep reusable page decisions/materials in `egbe-docs/product/pages/<page-id>/`
|
|
94
|
+
and technical evidence alongside the task. Credential-bearing captures are private.
|
|
95
|
+
Do not create inventory, facts, copy and per-round ledgers solely for this workflow.
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# Leads, bookings and product handoffs
|
|
2
|
+
|
|
3
|
+
Implement the accepted collection and destination. Reuse the product's durable
|
|
4
|
+
backend; table names and form layout are not a cross-product schema.
|
|
5
|
+
|
|
6
|
+
## Forms and notifications
|
|
7
|
+
|
|
8
|
+
Store the accepted fields, form kind, relevant variant/attribution and a test marker.
|
|
9
|
+
Preserve entered values across recoverable validation failures and protect write
|
|
10
|
+
endpoints as described in [OS wiring](os-wiring.md). Display success only after the
|
|
11
|
+
server confirms durable storage. Mark notification delivery independently, using a
|
|
12
|
+
stable lead identity and safe retry so an attempt is not confused with delivered mail.
|
|
13
|
+
|
|
14
|
+
Read the current Mail contract for notification fields, delivery results and any
|
|
15
|
+
reply address. Use the approved recipient, not a guessed one. Include the submitted
|
|
16
|
+
information needed to handle the request and its permitted attribution; do not leak
|
|
17
|
+
it into analytics URLs. An authorized test notification is visibly marked as test.
|
|
18
|
+
Report undelivered requests and their recovery state. Do not claim a working contact
|
|
19
|
+
path solely because the row exists.
|
|
20
|
+
|
|
21
|
+
Implement the agreed fields, requiredness and form placement, with accessible errors.
|
|
22
|
+
Do not add a mandatory pre-calendar form, promise exactly one email, suppress required
|
|
23
|
+
consent or turn an optional request into an account signup by default.
|
|
24
|
+
|
|
25
|
+
## Calendar integrations
|
|
26
|
+
|
|
27
|
+
Use the chosen provider's actual contract. For an embedded widget, load it when
|
|
28
|
+
needed and retain a normal booking URL as a fallback. Preserve agreed context and
|
|
29
|
+
prefill only approved data through the provider's supported mechanism.
|
|
30
|
+
|
|
31
|
+
Correlate the launch and booking signal with a stable, validated reference. Validate
|
|
32
|
+
postMessage origin and event shape; store provider IDs/URLs only after checking their
|
|
33
|
+
expected host and format. For Calendly, `calendly.event_scheduled` from
|
|
34
|
+
`https://calendly.com` is a browser signal, not independently verified completion.
|
|
35
|
+
Use the provider's verified callback/read where available to confirm the booking.
|
|
36
|
+
|
|
37
|
+
Handle click and callback arriving out of order with idempotent storage. A browser
|
|
38
|
+
report is acknowledged only when stored; failures remain retryable. Do not emit a
|
|
39
|
+
server-confirmed conversion before that evidence exists. Opening a calendar is not
|
|
40
|
+
a booking, and QA must not reserve a real slot as a probe.
|
|
41
|
+
|
|
42
|
+
## Handoff to a product
|
|
43
|
+
|
|
44
|
+
Follow [routing](routing.md) for approved signup/checkout destinations and attribution.
|
|
45
|
+
Inspect the actual receiving flow where access permits, including redirects and
|
|
46
|
+
context retention. Do not assume a product uses Supabase or a particular analytics
|
|
47
|
+
SDK. Verify that the receiving application records the needed association; if it is
|
|
48
|
+
outside the owned work, return the precise missing behavior to its owner.
|
|
49
|
+
|
|
50
|
+
Clicks, registrations, first useful results and payments are separate observations.
|
|
51
|
+
Use real downstream events or an agreed export for the latter; lack of access is
|
|
52
|
+
an explicit gap, not zero conversions. Preserve the accepted customer journey rather
|
|
53
|
+
than inventing a signup or trial to make tracking convenient.
|
|
54
|
+
|
|
55
|
+
## Test data and measurement
|
|
56
|
+
|
|
57
|
+
Use canonical events from Analytics with the event's actual semantic meaning.
|
|
58
|
+
A lead request is not automatically an account registration and a client-side
|
|
59
|
+
booking message is not proof of paid value. Do not copy old event names to fit a
|
|
60
|
+
report. Keep test traffic out of customer/revenue metrics through the supported
|
|
61
|
+
test/collection controls, and verify event delivery with bounded test captures.
|
|
62
|
+
|
|
63
|
+
Mark permitted test records at creation. Remove only exact known test records
|
|
64
|
+
within the task's cleanup scope, or retain them excluded from reports; never delete
|
|
65
|
+
unmarked rows by guessing an address pattern. Keep technical evidence in the task's
|
|
66
|
+
existing records, without customer data in public reports.
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# OS wiring
|
|
2
|
+
|
|
3
|
+
Read the current Deploy, Domains, Analytics and Mail contracts for the operations
|
|
4
|
+
used. Do not copy provider credentials or assume capability gaps from an old page.
|
|
5
|
+
|
|
6
|
+
## Hosting and main address
|
|
7
|
+
|
|
8
|
+
Reuse the product application and agreed host. Obtain actual serving URLs and
|
|
9
|
+
domain/TLS state from OS; do not synthesize a canonical hostname or assume every
|
|
10
|
+
project has a custom-domain allowance. Register/reuse analytics for the intended
|
|
11
|
+
host and preserve existing project bindings.
|
|
12
|
+
|
|
13
|
+
When aliases redirect to the main host, preserve path, query and fragment.
|
|
14
|
+
Redirect only known app hosts, not local previews or arbitrary supplied hosts.
|
|
15
|
+
Normalize the host comparison and test the main URL for redirect loops. Place
|
|
16
|
+
redirect handling before tracking to avoid counting an alias and its destination.
|
|
17
|
+
Use absolute canonical/OG metadata for the real main address.
|
|
18
|
+
|
|
19
|
+
Provision attached storage through Deploy/DB if the accepted capture needs it,
|
|
20
|
+
or use the app's existing durable backend. Apply migrations through its supported
|
|
21
|
+
deployment mechanism, not a public initialization endpoint. Do not deploy an empty
|
|
22
|
+
app simply to follow an ordering example.
|
|
23
|
+
|
|
24
|
+
## Credentials and data
|
|
25
|
+
|
|
26
|
+
Product servers use OS_URL and the platform-injected OS_API_KEY per Deploy;
|
|
27
|
+
do not mint a mail-scoped agent key and copy it into a product. No server credential
|
|
28
|
+
may enter HTML, client code, logs or committed configuration. Use current Mail
|
|
29
|
+
fields and supported delivery channels; report an observed capability failure,
|
|
30
|
+
not a presumed lack of reply-to, CRM support or conversion upload.
|
|
31
|
+
|
|
32
|
+
Use the recorded, approved lead recipient and delivery destination. If ambiguous,
|
|
33
|
+
ask; do not scrape an address and silently route customer data there. Before an
|
|
34
|
+
external test message, confirm the allowed recipient and test scope.
|
|
35
|
+
|
|
36
|
+
Apply the accepted privacy/consent policy to analytics, replay, attribution and
|
|
37
|
+
stored data. Do not infer legal consent from a UTM slug or assume all first-party
|
|
38
|
+
data can be collected regardless of choice. Configure masking and snippet behavior
|
|
39
|
+
from the current Analytics contract; missing policy is a decision for the caller,
|
|
40
|
+
not a reason to bypass controls.
|
|
41
|
+
|
|
42
|
+
## Protect write endpoints
|
|
43
|
+
|
|
44
|
+
- Enforce accepted content types, body/field size limits, an allowlist of fields
|
|
45
|
+
and server-side validation. For small lead payloads, an 8–10 KB cap is a useful
|
|
46
|
+
starting point; adjust deliberately for the actual data.
|
|
47
|
+
- Apply origin/CSRF protection appropriate to the real transport and allowed app
|
|
48
|
+
hosts; a browser-supplied identity or destination is not authority.
|
|
49
|
+
- Rate-limit per endpoint using the supported deployment state, not process-only
|
|
50
|
+
counters when multiple instances serve it. Avoid storing raw IPs for analytics;
|
|
51
|
+
use the minimum approved abuse-protection data.
|
|
52
|
+
- If a honeypot is used, its success-shaped bot response must not create a lead
|
|
53
|
+
or trigger mail. Keep bot/test traffic distinguishable from customer outcomes.
|
|
54
|
+
- Do not acknowledge a lead as saved before durable storage succeeds. A failed
|
|
55
|
+
notification is separately observable/retryable, not permission to lose the lead.
|
|
56
|
+
|
|
57
|
+
Serve/cache assets appropriately with licensed fonts and content-versioned names.
|
|
58
|
+
Keep project documents, credentials and private captures out of public builds.
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Campaign page QA
|
|
2
|
+
|
|
3
|
+
Check the owned implementation on the appropriate local or serving revision.
|
|
4
|
+
Use `egbe-os-product-build` → `references/interface-quality.md` for rendering,
|
|
5
|
+
accessibility and interaction proof. Record concise evidence and remaining gaps,
|
|
6
|
+
not a report for every section or word-count target.
|
|
7
|
+
|
|
8
|
+
## Routing and collection
|
|
9
|
+
|
|
10
|
+
- Exercise every planned variant and the default URL. Main/alias redirects preserve
|
|
11
|
+
path, query and fragment without loops; local preview is not redirected to production.
|
|
12
|
+
- Test distinct CTA destinations, keyboard/touch actions, copied links and actual
|
|
13
|
+
redirects. Verify preserved attribution without leaking credentials, QA markers
|
|
14
|
+
or personal data to another host.
|
|
15
|
+
- Verify the configured consent/masking and tracking behavior on the relevant
|
|
16
|
+
granted/denied/unknown states. Intercept test analytics delivery where supported
|
|
17
|
+
so QA does not contaminate production metrics; inspect the intended payload.
|
|
18
|
+
- Test write validation, foreign origins, body limits, abuse controls and any
|
|
19
|
+
honeypot. Check the actual browser transport, not only an artificial HTTP request.
|
|
20
|
+
- Confirm link-scanner HEAD requests and ordinary navigation work without causing
|
|
21
|
+
a lead, booking, notification or other state-changing action.
|
|
22
|
+
|
|
23
|
+
## Relevant real paths
|
|
24
|
+
|
|
25
|
+
For a form, use a marked authorized test: verify stored fields/attribution,
|
|
26
|
+
success and failure behavior, and the separate notification result. An external
|
|
27
|
+
test message needs recipient authorization.
|
|
28
|
+
|
|
29
|
+
For a calendar, exercise opening, widget failure/fallback and context association
|
|
30
|
+
without reserving a real slot. Test callbacks in the provider's supported test
|
|
31
|
+
facility or with isolated fixtures; distinguish that from a live verified booking.
|
|
32
|
+
|
|
33
|
+
For a product handoff, verify destination parameters and continuation through
|
|
34
|
+
accessible redirects. Test accounts, paid actions or sending are not implied by
|
|
35
|
+
permission to inspect the page. State any downstream boundary not exercised.
|
|
36
|
+
|
|
37
|
+
Inspect accepted content, actual price and actions against the implemented page.
|
|
38
|
+
A proposed ad change goes back to the campaign owner; page QA does not edit provider
|
|
39
|
+
objects or grant launch permission. Clean up only identified authorized test records
|
|
40
|
+
and report the precise remaining operational gap.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Routing and attribution
|
|
2
|
+
|
|
3
|
+
Implement the plan's destinations and variants. Keep the approved promise/action
|
|
4
|
+
consistent with what the destination actually does; report a mismatch rather than
|
|
5
|
+
editing campaigns or changing the offer inside page implementation.
|
|
6
|
+
|
|
7
|
+
Select a planned variant by its path or dedicated parameter such as `v`.
|
|
8
|
+
Do not use `utm_content` to switch content: that field identifies an ad/creative.
|
|
9
|
+
Preserve existing destination parameters and the channel's attribution contract.
|
|
10
|
+
A plan without variants does not require an A/B test.
|
|
11
|
+
|
|
12
|
+
For product handoffs, preserve the applicable UTM tags and channel click IDs
|
|
13
|
+
(`gclid`, `gbraid`, `wbraid`, `fbclid`, `msclkid`, `ttclid`,
|
|
14
|
+
`rdt_cid`, `li_fat_id`, `oppref`, `twclid`) and, where the Analytics
|
|
15
|
+
contract uses it, `egbe_vid` from its visitor identity. Validate values and decorate
|
|
16
|
+
only allowlisted destination hosts. Do not forward QA markers, credentials or
|
|
17
|
+
personal data in public links.
|
|
18
|
+
|
|
19
|
+
Use the current visit's accepted attribution, then the Analytics runtime's stored
|
|
20
|
+
first touch where applicable. Refresh decorated links when identity/consent changes
|
|
21
|
+
and before pointer, keyboard, copied or middle-click navigation. A click beacon
|
|
22
|
+
must not block leaving the page. Keep path/query before any fragment and confirm
|
|
23
|
+
tags survive actual redirects.
|
|
24
|
+
|
|
25
|
+
Use the current canonical Analytics events and required fields. Log action intent
|
|
26
|
+
separately from server-confirmed completion; a click to another product does not
|
|
27
|
+
prove signup, payment or delivered value there. Report missing downstream attribution
|
|
28
|
+
or an unreadable result without fabricating conversions.
|
|
29
|
+
|
|
30
|
+
Use declarative tracker attributes for ordinary links only. For dialogs, calendar
|
|
31
|
+
launchers and dynamically rewritten URLs, track from the actual handler and verify
|
|
32
|
+
with the real tracker loaded; automatic anchor handling can bypass the interaction.
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-db
|
|
3
|
+
description: Query/export attached PostgreSQL data; update or delete individual rows by primary key.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use for inspecting, exporting or correcting stored product data."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Database access"
|
|
8
|
+
egbe-description: "Inspect and correct your app's PostgreSQL data without redeploying your app."
|
|
9
|
+
egbe-category: "Development & hosting"
|
|
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
|
+
# Work with your database
|
|
57
|
+
|
|
58
|
+
Use the founder's existing `OS_API_KEY` and configured `OS_URL` (normally
|
|
59
|
+
`https://os.hz.egbe.dev`). No additional key or scope is needed. Requests use
|
|
60
|
+
`Authorization: Bearer $OS_API_KEY` and return the usual `{code,message,data}` envelope.
|
|
61
|
+
|
|
62
|
+
The attached PostgreSQL/Supabase schema is shared by your account's apps. OS
|
|
63
|
+
selects it from your key. If no database exists, provision it through
|
|
64
|
+
`POST /deploy/<slug>/db` as described by `/deploy/skill`.
|
|
65
|
+
|
|
66
|
+
## Read and inspect
|
|
67
|
+
|
|
68
|
+
`POST /db/query` accepts one read SQL query and a `params` array. Use `$1`, `$2`,
|
|
69
|
+
etc. for values. SELECT, joins, aggregates and read-only CTEs work. Supply SQL
|
|
70
|
+
without a trailing comment after its final semicolon.
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/db/query" -s \
|
|
74
|
+
-H 'Content-Type: application/json' \
|
|
75
|
+
-d '{"sql":"SELECT id, email FROM leads WHERE email = $1 ORDER BY id","params":["test@example.com"]}'
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
Results contain `rows`, `row_count`, `truncated` and `limits`. Default limits:
|
|
79
|
+
1,000 rows, 1 MiB of response data, 5 seconds per statement and 1 second waiting
|
|
80
|
+
for a lock. A request body is limited to 64 KiB and 100 SQL parameters. Too many
|
|
81
|
+
concurrent requests return 429. An oversized single row returns 413; select
|
|
82
|
+
fewer columns or shorter values. Limits may be configured by the platform.
|
|
83
|
+
|
|
84
|
+
Large integers and fractional numbers are returned as strings to preserve
|
|
85
|
+
precision. Send large IDs and exact decimals as strings in parameters/changes
|
|
86
|
+
as well. Alias same-named columns when joining tables.
|
|
87
|
+
|
|
88
|
+
For exports, query ordered pages using a unique key: `WHERE id > $1 ORDER BY id
|
|
89
|
+
LIMIT 500`, then pass the last ID to the next call. Composite keys need matching
|
|
90
|
+
ordering/continuation on all key columns. A `truncated: true` response is
|
|
91
|
+
incomplete: reduce the page size/selected fields and repeat that page. Separate
|
|
92
|
+
requests do not share a snapshot; concurrent changes may affect an export.
|
|
93
|
+
|
|
94
|
+
The repository normally describes the schema. If needed, inspect
|
|
95
|
+
`information_schema.columns` or PostgreSQL catalogs using `/db/query`; there is
|
|
96
|
+
no separate schema-discovery endpoint.
|
|
97
|
+
|
|
98
|
+
## Correct one record
|
|
99
|
+
|
|
100
|
+
Read the target record first. Supply every primary-key column in `key`.
|
|
101
|
+
Tables without a primary key are not supported for these operations.
|
|
102
|
+
|
|
103
|
+
```bash
|
|
104
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/db/rows/update" -s \
|
|
105
|
+
-H 'Content-Type: application/json' \
|
|
106
|
+
-d '{"table":"leads","key":{"id":"42"},"values":{"name":"Corrected name"}}'
|
|
107
|
+
|
|
108
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/db/rows/delete" -s \
|
|
109
|
+
-H 'Content-Type: application/json' \
|
|
110
|
+
-d '{"table":"leads","key":{"id":"42"}}'
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
Changes accept literal values, not SQL expressions. Primary-key/generated
|
|
114
|
+
columns cannot be changed. For JSON/JSONB columns, strings remain strings;
|
|
115
|
+
send objects and arrays as JSON values. A request value of `null` sets SQL NULL.
|
|
116
|
+
Each request commits one direct row change;
|
|
117
|
+
database triggers and foreign-key cascades still apply. Missing rows return
|
|
118
|
+
404; constraint violations return 409 and roll back. Change activity records
|
|
119
|
+
the operation/table/outcome without storing row contents.
|
|
120
|
+
|
|
121
|
+
If the response says `database_write_outcome_unknown`, read the record before
|
|
122
|
+
retrying. A disconnected request can lose the acknowledgement of a committed
|
|
123
|
+
change. There is no automatic retry or undo history.
|
|
124
|
+
|
|
125
|
+
## CLI
|
|
126
|
+
|
|
127
|
+
Use the same key with the existing CLI environment variable:
|
|
128
|
+
|
|
129
|
+
```bash
|
|
130
|
+
EGBE_API_KEY="$OS_API_KEY" EGBE_OS_URL="$OS_URL" egbe db skill
|
|
131
|
+
EGBE_API_KEY="$OS_API_KEY" EGBE_OS_URL="$OS_URL" egbe --json db query \
|
|
132
|
+
--body '{"sql":"SELECT id, email FROM leads ORDER BY id LIMIT 20","params":[]}'
|
|
133
|
+
EGBE_API_KEY="$OS_API_KEY" EGBE_OS_URL="$OS_URL" egbe db update \
|
|
134
|
+
--body '{"table":"leads","key":{"id":"42"},"values":{"name":"Corrected name"}}'
|
|
135
|
+
EGBE_API_KEY="$OS_API_KEY" EGBE_OS_URL="$OS_URL" egbe db delete \
|
|
136
|
+
--body '{"table":"leads","key":{"id":"42"}}'
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
Generic database inspection and cleanup use this capability. Product admin
|
|
140
|
+
features that enforce business workflows can remain in the application.
|
|
141
|
+
Migrations stay in the product's existing deployment workflow; this API does
|
|
142
|
+
not execute arbitrary write SQL, INSERT, bulk changes or DDL.
|
|
143
|
+
|
|
144
|
+
## Convex
|
|
145
|
+
|
|
146
|
+
These SQL endpoints operate on attached PostgreSQL, not Convex.
|
|
147
|
+
|
|
148
|
+
### Read Convex documents without a terminal
|
|
149
|
+
|
|
150
|
+
`GET /db/convex/tables/<table>` returns one page of a table of the account's
|
|
151
|
+
Convex backend, like `npx convex data <table>`, with the same key and no admin
|
|
152
|
+
key:
|
|
153
|
+
|
|
154
|
+
```bash
|
|
155
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/db/convex/tables/users" -s
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
The result has `documents`, `count`, `hasMore`, `cursor` and `snapshot`. While
|
|
159
|
+
`hasMore` is true, request the next page with `?cursor=<cursor>&snapshot=<snapshot>`;
|
|
160
|
+
keep the first page's `snapshot` so every page reads the same point in time.
|
|
161
|
+
Table names come from the repository's `convex/schema.ts`; an unknown table
|
|
162
|
+
returns 404. System tables such as `_storage` can be read the same way. A page
|
|
163
|
+
too large to return gives 413; export from a workspace instead.
|
|
164
|
+
|
|
165
|
+
### Export, run functions and change data: workspace only
|
|
166
|
+
|
|
167
|
+
`npx convex export`, `npx convex run <function> <args>`, `npx convex import` and
|
|
168
|
+
direct document edits need a workspace with Node. Obtain the backend details
|
|
169
|
+
through `GET /deploy/<slug>/convex`, configure `CONVEX_SELF_HOSTED_URL` and
|
|
170
|
+
`CONVEX_SELF_HOSTED_ADMIN_KEY`, and use the project's installed Convex CLI.
|
|
171
|
+
Function execution uses deployed queries, mutations or actions. Check the
|
|
172
|
+
installed CLI/backend versions before relying on newer options such as inline
|
|
173
|
+
queries. Without a workspace, correct data through the product's own functions:
|
|
174
|
+
change the code and publish it with `POST /deploy/<slug>/convex/deploy`.
|