@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,285 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-google-auth
|
|
3
|
+
description: Add Google signup and login to a deployed product.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use when customers need Google sign-in."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Google sign-in"
|
|
8
|
+
egbe-description: "Let customers sign up and sign in with Google without managing your own Google OAuth credentials."
|
|
9
|
+
egbe-category: "Payments & accounts"
|
|
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
|
+
# Product Google Sign-in
|
|
57
|
+
|
|
58
|
+
Egbe OS owns the Google OAuth client and verifies the external identity. The
|
|
59
|
+
product owns its local user, provider link, session, authorization, and logout.
|
|
60
|
+
Product code needs only its normal server-side `OS_URL` and `OS_API_KEY`.
|
|
61
|
+
The HTTP examples below describe requests from that backend to its configured
|
|
62
|
+
Egbe URL, using its product-runtime credential. Implement them with the
|
|
63
|
+
product's HTTP client; no agent catalog, workspace helper or connection identity
|
|
64
|
+
belongs in the deployed application.
|
|
65
|
+
|
|
66
|
+
Never put the OS key in browser code. Never add Google client credentials to the
|
|
67
|
+
product, call Google's token endpoint from the product, or treat an email/query
|
|
68
|
+
parameter as authenticated identity.
|
|
69
|
+
|
|
70
|
+
## Through the Egbe connector
|
|
71
|
+
|
|
72
|
+
Through the connector you can change and publish the app with `egbe-os-git`
|
|
73
|
+
("Without a terminal") and `egbe-os-deploy`. Rendered-page and interactive
|
|
74
|
+
checks need a browser: use this environment's own browser tools, or a set-up
|
|
75
|
+
project workspace. In a persistent project workspace not set up yet, call
|
|
76
|
+
`egbe_local_setup`. Without either, read pages with `egbe-os-scrape` and HTTP
|
|
77
|
+
responses, report signup, login and logout as unverified, and tell the founder
|
|
78
|
+
which check remains.
|
|
79
|
+
|
|
80
|
+
## Start from the product backend
|
|
81
|
+
|
|
82
|
+
Create a same-origin product route such as `/api/auth/google/start`. It calls:
|
|
83
|
+
|
|
84
|
+
```http
|
|
85
|
+
POST /auth/google/intents HTTP/1.1
|
|
86
|
+
Host: <configured Egbe host>
|
|
87
|
+
Authorization: Bearer <server-side product key>
|
|
88
|
+
Content-Type: application/json
|
|
89
|
+
|
|
90
|
+
{
|
|
91
|
+
"app_slug": "<deployed-slug>",
|
|
92
|
+
"return_path": "/auth/google/complete?next=%2Fdashboard"
|
|
93
|
+
}
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
Redirect the browser to `data.start_url`. `return_path` is relative and must be
|
|
97
|
+
handled by the same product backend. When a product deliberately serves more
|
|
98
|
+
than one registered host, pass `return_origin`; Egbe OS accepts it only when it
|
|
99
|
+
exactly matches an authoritative deployed origin.
|
|
100
|
+
|
|
101
|
+
## Exchange on the product backend
|
|
102
|
+
|
|
103
|
+
Egbe OS returns the browser to `return_path` with either
|
|
104
|
+
`egbe_auth_code=<opaque-code>` or `egbe_auth_error=<safe-code>`. Exchange the
|
|
105
|
+
opaque code immediately from the server:
|
|
106
|
+
|
|
107
|
+
```http
|
|
108
|
+
POST /auth/google/exchange HTTP/1.1
|
|
109
|
+
Host: <configured Egbe host>
|
|
110
|
+
Authorization: Bearer <server-side product key>
|
|
111
|
+
Content-Type: application/json
|
|
112
|
+
|
|
113
|
+
{"app_slug":"<deployed-slug>","code":"<egbe_auth_code>"}
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
The result contains `provider`, immutable Google `subject`, verified `email`,
|
|
117
|
+
`email_verified`, optional `name`, and optional `picture`. Use
|
|
118
|
+
`(provider, subject)` as the external identity key. In one database transaction:
|
|
119
|
+
|
|
120
|
+
1. return the user already linked to that identity;
|
|
121
|
+
2. otherwise link the identity to the existing account with the same normalized
|
|
122
|
+
verified email;
|
|
123
|
+
3. otherwise create the local user and identity link;
|
|
124
|
+
4. only then create the product's ordinary opaque server-side session.
|
|
125
|
+
|
|
126
|
+
Unique constraints must make concurrent callbacks converge on one identity and
|
|
127
|
+
one user. Do not overwrite an existing password hash when linking Google. Clean
|
|
128
|
+
the callback code from the browser URL after the session is established.
|
|
129
|
+
|
|
130
|
+
## Optional: Google One Tap
|
|
131
|
+
|
|
132
|
+
One Tap shows Google's floating sign-in prompt (top-right) without a redirect.
|
|
133
|
+
It is an addition to the redirect flow above, not a replacement — always keep
|
|
134
|
+
the button flow as the fallback: One Tap silently shows nothing when the
|
|
135
|
+
visitor has no Google session, dismissed it recently, or the browser blocks it.
|
|
136
|
+
|
|
137
|
+
How it works: Egbe OS hosts the actual GSI widget in an iframe on its own
|
|
138
|
+
origin (`os.hz.egbe.dev`, registered with Google once — product domains never
|
|
139
|
+
need Google Console changes). The product page embeds that frame through
|
|
140
|
+
Google's intermediate-iframe parent library, the frame posts the signed
|
|
141
|
+
credential back to the page, and the product backend exchanges it through
|
|
142
|
+
Egbe OS for the same verified identity as the redirect flow.
|
|
143
|
+
|
|
144
|
+
### 1. Backend: mint an intent
|
|
145
|
+
|
|
146
|
+
Create a same-origin route (e.g. `GET /api/auth/google/onetap/intent`) that
|
|
147
|
+
calls:
|
|
148
|
+
|
|
149
|
+
```http
|
|
150
|
+
POST /auth/google/onetap/intents HTTP/1.1
|
|
151
|
+
Host: <configured Egbe host>
|
|
152
|
+
Authorization: Bearer <server-side product key>
|
|
153
|
+
Content-Type: application/json
|
|
154
|
+
|
|
155
|
+
{"app_slug":"<deployed-slug>"}
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
and returns to the browser: the `nonce`, the frame URL
|
|
159
|
+
`https://os.hz.egbe.dev/auth/google/onetap/frame?nonce=<nonce>`, and the frame
|
|
160
|
+
origin `https://os.hz.egbe.dev`. The nonce is single-use and expires with the
|
|
161
|
+
intent — mint a fresh one per page load, never cache it.
|
|
162
|
+
|
|
163
|
+
### 2. Page: embed through Google's parent library
|
|
164
|
+
|
|
165
|
+
Load ONLY `https://accounts.google.com/gsi/intermediate` on the product page.
|
|
166
|
+
Never load `gsi/client` there (the product origin is not registered with
|
|
167
|
+
Google), never load `gsi/intermediatesupport` anywhere (it is for a separate
|
|
168
|
+
post-login page and crashes an active prompt), and never create the iframe
|
|
169
|
+
manually — GSI holds the prompt until Google's parent library completes its
|
|
170
|
+
handshake, so a hand-made iframe means the prompt never appears.
|
|
171
|
+
|
|
172
|
+
On an SPA (or any DOM rendered after load) use the JS API — the
|
|
173
|
+
`g_id_intermediate_iframe` div auto-scan only works on statically served HTML:
|
|
174
|
+
|
|
175
|
+
```js
|
|
176
|
+
// After fetching the intent from your backend:
|
|
177
|
+
window.addEventListener("message", (event) => {
|
|
178
|
+
if (event.origin !== intent.frame_origin) return; // https://os.hz.egbe.dev
|
|
179
|
+
const m = event.data || {};
|
|
180
|
+
if (m.type === "egbe:onetap:credential" && typeof m.credential === "string") {
|
|
181
|
+
// POST {credential, nonce} to your backend exchange route (step 3),
|
|
182
|
+
// then navigate on success. Do NOT verify or decode the JWT in the browser.
|
|
183
|
+
}
|
|
184
|
+
if (m.type === "egbe:onetap:closed") {
|
|
185
|
+
console.debug("onetap not shown:", m.reason); // keep for debugging
|
|
186
|
+
}
|
|
187
|
+
});
|
|
188
|
+
const s = document.createElement("script");
|
|
189
|
+
s.src = "https://accounts.google.com/gsi/intermediate";
|
|
190
|
+
s.async = true;
|
|
191
|
+
s.onload = () => {
|
|
192
|
+
google.accounts.id.initializeIntermediate({
|
|
193
|
+
src: intent.frame_url,
|
|
194
|
+
done: () => {}, // default `done` reloads the page mid-exchange — override it
|
|
195
|
+
});
|
|
196
|
+
};
|
|
197
|
+
document.body.appendChild(s);
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
Static pages may instead place, before the script tag:
|
|
201
|
+
|
|
202
|
+
```html
|
|
203
|
+
<div id="g_id_intermediate_iframe" data-src="<frame_url>"></div>
|
|
204
|
+
<script src="https://accounts.google.com/gsi/intermediate" async defer></script>
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
Mount this only for logged-out visitors (landing, /login, /signup). Google's
|
|
208
|
+
library creates the iframe itself, sizes it as the prompt shows, and sets the
|
|
209
|
+
FedCM `allow="identity-credentials-get"` permission — none of that is your
|
|
210
|
+
code's job.
|
|
211
|
+
|
|
212
|
+
### 3. Backend: exchange the credential
|
|
213
|
+
|
|
214
|
+
The credential message carries a Google-signed JWT. Post it with the nonce to
|
|
215
|
+
the product backend, which exchanges it server-side:
|
|
216
|
+
|
|
217
|
+
```http
|
|
218
|
+
POST /auth/google/onetap/exchange HTTP/1.1
|
|
219
|
+
Host: <configured Egbe host>
|
|
220
|
+
Authorization: Bearer <server-side product key>
|
|
221
|
+
Content-Type: application/json
|
|
222
|
+
|
|
223
|
+
{"app_slug":"<deployed-slug>","nonce":"<nonce>","credential":"<credential>"}
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
The result is the same verified identity payload as `/auth/google/exchange` —
|
|
227
|
+
apply the identical linking transaction from the redirect flow, create the
|
|
228
|
+
ordinary session cookie, and return the post-login path for the page to
|
|
229
|
+
navigate to. A 404 means the nonce is invalid, expired, or already used
|
|
230
|
+
(exchanging burns it even when the credential is rejected — the page should
|
|
231
|
+
just fetch a fresh intent). Fire the same signup conversion events as the
|
|
232
|
+
redirect flow, with its own method label (e.g. `google_onetap`).
|
|
233
|
+
|
|
234
|
+
### Frame → page message protocol
|
|
235
|
+
|
|
236
|
+
The frame posts to the embedding page (always check
|
|
237
|
+
`event.origin === "https://os.hz.egbe.dev"` first):
|
|
238
|
+
|
|
239
|
+
| message | payload | meaning |
|
|
240
|
+
|---|---|---|
|
|
241
|
+
| `{type:"egbe:onetap:credential"}` | `credential` (JWT string) | user picked an account — exchange it now |
|
|
242
|
+
| `{type:"egbe:onetap:closed"}` | `reason` (string) | prompt not shown / dismissed |
|
|
243
|
+
|
|
244
|
+
### Why the prompt may not appear (all of these are normal)
|
|
245
|
+
|
|
246
|
+
- No Google session in the browser profile → nothing to offer.
|
|
247
|
+
- Cooldown: each dismissal (the ✕) suppresses One Tap on that site for
|
|
248
|
+
progressively longer (minutes → hours). Test in an incognito window signed
|
|
249
|
+
in to Google.
|
|
250
|
+
- `reason` in the `closed` message is often `unknown_reason` under FedCM —
|
|
251
|
+
Chrome hides the real cause for privacy. That alone is not an error.
|
|
252
|
+
- The user is already logged in to the product — you should not have mounted
|
|
253
|
+
the embed at all.
|
|
254
|
+
- GSI console warnings about "FedCM becoming mandatory" and "prompt UI status
|
|
255
|
+
methods" on the page are advisory noise from the intermediate libraries —
|
|
256
|
+
ignore them.
|
|
257
|
+
|
|
258
|
+
A working end-to-end reference lives in the `agent-canvas` product repo
|
|
259
|
+
(Forgejo `os-e64a1fbe2153/agent-canvas`): backend routes
|
|
260
|
+
`/auth/google/onetap/intent` + `/auth/google/onetap/session` in
|
|
261
|
+
`src/index.ts`, page component `GoogleOneTap` in `web/src/App.tsx`.
|
|
262
|
+
|
|
263
|
+
### Product button
|
|
264
|
+
|
|
265
|
+
|
|
266
|
+
Use Google's pre-approved button assets or follow the official branding
|
|
267
|
+
guidelines:
|
|
268
|
+
|
|
269
|
+
- Guidelines: https://developers.google.com/identity/branding-guidelines
|
|
270
|
+
- Assets: https://developers.google.com/static/identity/images/signin-assets.zip
|
|
271
|
+
|
|
272
|
+
## Product experience and verification
|
|
273
|
+
|
|
274
|
+
- Place Google on the selected account-entry surfaces with the agreed hierarchy.
|
|
275
|
+
It may be the only method; this integration does not require email login.
|
|
276
|
+
- The visible Google control calls the product's same-origin start route, never
|
|
277
|
+
Egbe OS with a browser-visible key.
|
|
278
|
+
- Preserve a validated relative continuation through the round trip.
|
|
279
|
+
- Show safe retry/cancel states without exposing provider details.
|
|
280
|
+
- Verify live Google signup, repeat login to the same account, session refresh,
|
|
281
|
+
protected access, logout, and verified-email linking to an existing local
|
|
282
|
+
account, including a controlled imported account in a Google-only product.
|
|
283
|
+
Preserve its credentials and ownership without adding another login method.
|
|
284
|
+
For a bounded repair, verify the affected behavior and shared dependencies.
|
|
285
|
+
Another working login does not complete an agreed Google flow that is broken.
|
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-gtm-knowledge
|
|
3
|
+
description: Find comparable Egbe GTM experiments to inform audience, offer and channel choices.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use when prior experiments can inform a new test or reprioritization."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Launch GTM insights"
|
|
8
|
+
egbe-description: "Find comparable GTM experiments before choosing or reprioritizing a product's segments, offers, messages, and promotion channels."
|
|
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
|
+
# Fleet GTM Knowledge
|
|
57
|
+
|
|
58
|
+
Use this skill while preparing or materially revising `segment -> offer ->
|
|
59
|
+
channel` hypotheses. The report is supporting evidence, not a mandatory source:
|
|
60
|
+
when it contains no genuinely comparable experiment, continue from the current
|
|
61
|
+
product and market evidence.
|
|
62
|
+
|
|
63
|
+
Authenticate with `Authorization: Bearer $OS_API_KEY`. Base URL:
|
|
64
|
+
`$OS_URL` (production default: `https://os.hz.egbe.dev`).
|
|
65
|
+
|
|
66
|
+
## Find comparable experiments
|
|
67
|
+
|
|
68
|
+
Prefer `POST /gtm/comparables`: it shows the whole verified/directional pool
|
|
69
|
+
to a server-side LLM judge that keeps only experiments whose audience,
|
|
70
|
+
problem, or product category genuinely matches your context — so
|
|
71
|
+
differently-worded launches still match, and shared keywords alone do not.
|
|
72
|
+
The judge call is billed to your own LLM key.
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/gtm/comparables" -sS \
|
|
76
|
+
-H "Content-Type: application/json" \
|
|
77
|
+
-d '{
|
|
78
|
+
"query": "B2B operations teams that need recurring compliance evidence; self-serve subscription; audit generation",
|
|
79
|
+
"geo": "US",
|
|
80
|
+
"limit": 5
|
|
81
|
+
}'
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
Each result carries a `relevance_reason` and a unique `record_id` (one
|
|
85
|
+
experiment can emit several records — per campaign, variant, and window).
|
|
86
|
+
The response also reports `pool_size`, `judged`, and `partial`: when
|
|
87
|
+
`partial` is true the judge saw only part of the pool, so an empty result
|
|
88
|
+
must be treated as an incomplete review — never as a no-match conclusion.
|
|
89
|
+
`geo` is judge context, not a hard filter.
|
|
90
|
+
|
|
91
|
+
The judge can take a few minutes on a large pool. Through the Egbe connector,
|
|
92
|
+
or any client whose tool calls time out sooner, start it in async mode with
|
|
93
|
+
`?async=1` (or `"async": true` in the body): `egbe_write` POST
|
|
94
|
+
`/gtm/comparables` with query `{"async": "1"}` and the same body answers `202`
|
|
95
|
+
with a `job_id` at once. Poll `egbe_read` `/gtm/jobs/<job_id>` about every 10
|
|
96
|
+
seconds until `status` is `succeeded` or `failed`; `result` then holds the
|
|
97
|
+
response described above (`code`, `message`, `data`). The judge runs and bills
|
|
98
|
+
once per job, however often you poll. Pass the same `idempotency_key` when you
|
|
99
|
+
retry a start, so a repeat returns the existing job instead of a second run.
|
|
100
|
+
Results are kept for an hour; a `404` on poll means the job is unknown or expired.
|
|
101
|
+
|
|
102
|
+
`POST /gtm/search` remains available as a keyless-of-LLM fallback (token
|
|
103
|
+
overlap ranking with optional hard filters). Build one concise query from
|
|
104
|
+
the current product truth: the buyer, costly problem or trigger,
|
|
105
|
+
offer/mechanism, business model or price band, and the channels under
|
|
106
|
+
consideration. Then request at most five records:
|
|
107
|
+
|
|
108
|
+
```bash
|
|
109
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/gtm/search" -sS \
|
|
110
|
+
-H "Content-Type: application/json" \
|
|
111
|
+
-d '{
|
|
112
|
+
"query": "B2B operations teams that need recurring compliance evidence; self-serve subscription; audit generation",
|
|
113
|
+
"channels": ["google", "reddit", "instantly"],
|
|
114
|
+
"buyer_type": "smb",
|
|
115
|
+
"business_model": "subscription",
|
|
116
|
+
"include_directional": true,
|
|
117
|
+
"limit": 5
|
|
118
|
+
}'
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
Omit a hard filter when the current product does not establish it. Do not add a
|
|
122
|
+
filter merely to force a desired precedent.
|
|
123
|
+
|
|
124
|
+
## Evidence rules
|
|
125
|
+
|
|
126
|
+
For every returned experiment, inspect:
|
|
127
|
+
|
|
128
|
+
- product and buyer compatibility;
|
|
129
|
+
- segment, offer, CTA, message, and channel;
|
|
130
|
+
- dates, outcome window, sample size, and spend;
|
|
131
|
+
- attribution model and activation definition;
|
|
132
|
+
- trust tier, limitations, and evidence references.
|
|
133
|
+
|
|
134
|
+
Use `verified` evidence for defaults only when the tested conditions are
|
|
135
|
+
materially comparable. Use `directional` evidence only as a labelled clue or a
|
|
136
|
+
reason to run a bounded test. The endpoint intentionally excludes
|
|
137
|
+
`inconclusive` evidence.
|
|
138
|
+
|
|
139
|
+
Do not infer that a channel caused a result merely because the result happened
|
|
140
|
+
during that campaign. Do not compare provider conversions with product
|
|
141
|
+
activations or payers. Do not average records with different attribution
|
|
142
|
+
windows, currencies, activation definitions, or materially different buyers.
|
|
143
|
+
|
|
144
|
+
## Write the planning trace
|
|
145
|
+
|
|
146
|
+
When a record changes a hypothesis, cite its `experiment_id`, trust tier, and
|
|
147
|
+
the relevant observed outcome in the planning artifact. State why the precedent
|
|
148
|
+
is comparable and its most important limitation.
|
|
149
|
+
|
|
150
|
+
When no useful record is returned, record `Fleet evidence: none relevant` and
|
|
151
|
+
continue. Never invent an experiment ID, metric, or fleet conclusion.
|
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-images
|
|
3
|
+
description: Generate images or find stock photography and illustrations.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use when a product, website or campaign needs visuals."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Images"
|
|
8
|
+
egbe-description: "Generate images or find stock photography for your product, website and advertising."
|
|
9
|
+
egbe-category: "AI & data"
|
|
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
|
+
# Images
|
|
57
|
+
|
|
58
|
+
Image generation and stock image search through Egbe OS. Authenticate with
|
|
59
|
+
`Authorization: Bearer $OS_API_KEY`. The provider keys live on the gateway —
|
|
60
|
+
you never handle them.
|
|
61
|
+
|
|
62
|
+
Base URL: `https://os.hz.egbe.dev`.
|
|
63
|
+
|
|
64
|
+
Use only the `OS_URL` and `OS_API_KEY` supplied to the current workload. Product
|
|
65
|
+
server code reads those same names; the Site Gateway injects a separate product
|
|
66
|
+
identity automatically. Never mint or deploy an image-specific key, and never
|
|
67
|
+
introduce `IMAGE_API_KEY` for this OS capability.
|
|
68
|
+
|
|
69
|
+
## Through the Egbe connector
|
|
70
|
+
|
|
71
|
+
The connector refuses image generation (`/images/generations`). Through it, use
|
|
72
|
+
[stock image search](references/stock-images.md) or an image the founder
|
|
73
|
+
supplies at a public HTTPS URL. Generating an image needs a project workspace
|
|
74
|
+
connected with the business's Egbe key: in a persistent project workspace not
|
|
75
|
+
set up yet, call `egbe_local_setup`; otherwise offer stock or the founder's own
|
|
76
|
+
image and say that generation needs such a workspace.
|
|
77
|
+
|
|
78
|
+
Available options:
|
|
79
|
+
|
|
80
|
+
- [Image generation](#generate) from a text prompt.
|
|
81
|
+
- [Stock image search](references/stock-images.md) through Pixabay.
|
|
82
|
+
|
|
83
|
+
## Generate
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/images/generations" -s -X POST \
|
|
87
|
+
-H 'Content-Type: application/json' \
|
|
88
|
+
-d '{"prompt":"a minimalist logo of a fox, flat vector","model":"gemini-flash-image"}'
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
Response:
|
|
92
|
+
|
|
93
|
+
```json
|
|
94
|
+
{
|
|
95
|
+
"model": "gemini-flash-image",
|
|
96
|
+
"backend": "litellm",
|
|
97
|
+
"size": null,
|
|
98
|
+
"images": [{
|
|
99
|
+
"b64_json": "<base64>",
|
|
100
|
+
"mime_type": "image/png",
|
|
101
|
+
"url": "https://supabase.hz.gcp.egbe.dev/storage/v1/object/public/img_<you>/gen/<id>.png",
|
|
102
|
+
"stored": true
|
|
103
|
+
}],
|
|
104
|
+
"count": 1
|
|
105
|
+
}
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
Each image is also **saved to your own image bucket** and gets a stable public
|
|
109
|
+
`url` (`stored:true`) — use it directly on landing pages, no re-upload needed.
|
|
110
|
+
If storage is briefly unavailable the image still comes back as base64 with
|
|
111
|
+
`stored:false`; just retry later if you need the URL.
|
|
112
|
+
|
|
113
|
+
Save the first image:
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/images/generations" -s -X POST \
|
|
117
|
+
-H 'Content-Type: application/json' \
|
|
118
|
+
-d '{"prompt":"a red apple on a wooden table"}' \
|
|
119
|
+
| python3 -c 'import sys,json,base64; d=json.load(sys.stdin)["data"]; open("out.png","wb").write(base64.b64decode(d["images"][0]["b64_json"]))'
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Models
|
|
123
|
+
|
|
124
|
+
`model` is optional — omit it for the default (`gemini-flash-image`). Aliases:
|
|
125
|
+
|
|
126
|
+
- `gemini-flash-image` — default, Gemini 2.5 Flash via OpenRouter, fast (~seconds)
|
|
127
|
+
- `gpt-image-2.5-flare` — fast, high-quality everyday generation via CLI Proxy
|
|
128
|
+
- `gpt-image-2.5-sunburst` — demanding quality via CLI Proxy
|
|
129
|
+
- `gpt-image-2`, `gpt-image-mini`, `gpt-image`, `dall-e-3` — compatibility aliases
|
|
130
|
+
for Flare; `dall-e-3` does not invoke the retired DALL·E model
|
|
131
|
+
- `gemini-3-pro-image-preview` — Gemini via OpenRouter, high quality
|
|
132
|
+
|
|
133
|
+
Choose Flare for everyday OpenAI image generation and Sunburst when quality
|
|
134
|
+
matters most. OpenAI image models use CLI Proxy; the existing Gemini fallback
|
|
135
|
+
can serve a request if the selected OpenAI model is temporarily unavailable.
|
|
136
|
+
All requests keep the same OS account authentication and quota controls.
|
|
137
|
+
|
|
138
|
+
```bash
|
|
139
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/images/generations" -s -X POST \
|
|
140
|
+
-H 'Content-Type: application/json' \
|
|
141
|
+
-d '{"prompt":"a product photograph of a blue ceramic mug","model":"gpt-image-2.5-flare","size":"1536x1024","n":1}'
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
`size` is forwarded to the provider. Request `n=1..4` images; each generated
|
|
145
|
+
image counts against your quota. OpenAI requests expand into individual image
|
|
146
|
+
calls, so requesting several images takes longer.
|
|
147
|
+
|
|
148
|
+
List them any time with `GET /images`.
|
|
149
|
+
|
|
150
|
+
## Limits
|
|
151
|
+
|
|
152
|
+
Two quotas apply:
|
|
153
|
+
- **Generation** — `image-gen:generations`, 100/day. `n` > 1 charges per image.
|
|
154
|
+
- **Image uploads** — `image-storage:bytes`, 500 MB total uploaded image data.
|
|
155
|
+
This cumulative allowance does not reset. Deleting images from your bucket
|
|
156
|
+
does not automatically restore it.
|
|
157
|
+
|
|
158
|
+
A `429` means you've hit a cap. Check both:
|
|
159
|
+
|
|
160
|
+
```bash
|
|
161
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/me/limits?resource=image-gen" -s
|
|
162
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/me/limits?resource=image-storage" -s
|
|
163
|
+
```
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Stock image search
|
|
2
|
+
|
|
3
|
+
Search Pixabay through OS using the existing project credentials:
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/tools/pixabay/search" -sS -X POST \
|
|
7
|
+
-H 'Content-Type: application/json' \
|
|
8
|
+
-d '{"query":"ceramic workshop","image_type":"photo","orientation":"horizontal","safesearch":true,"per_page":10,"page":1}'
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
`data` contains `total` and `hits`. Each hit supplies `id`, `tags`,
|
|
12
|
+
`preview_url`, `large_url`, `page_url`, `width`, `height`, and `user`.
|
|
13
|
+
Inspect candidates for relevance, crop, resolution and visible brands/people.
|
|
14
|
+
Keep the selected image's source page and creator with the project's existing
|
|
15
|
+
asset records. Download the selected image into the product's assets rather
|
|
16
|
+
than depending on a temporary search-result URL.
|
|
17
|
+
|
|
18
|
+
Check the [Pixabay Content License](https://pixabay.com/service/license-summary/)
|
|
19
|
+
and the selected image's page for the intended use. Availability through the
|
|
20
|
+
API is not a blanket clearance for trademarks, recognizable people, resale or
|
|
21
|
+
implied endorsement.
|