@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,259 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-errors
|
|
3
|
+
description: Set up Sentry error reporting and inspect project-scoped issues, exception traces and event diagnostics.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use when a product has errors to investigate or needs its error reporting connected or checked."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Error monitoring"
|
|
8
|
+
egbe-description: "Connect your app to error monitoring so your agent can investigate real browser and server errors."
|
|
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
|
+
# Error tracking (Sentry)
|
|
57
|
+
|
|
58
|
+
Use OS `errors` to connect an app to Sentry and inspect its failures. The gateway
|
|
59
|
+
resolves ownership from the project key; no provider token is needed. Preserve
|
|
60
|
+
an existing working SDK, DSN and event tags rather than installing them again.
|
|
61
|
+
For an existing error, start with [issue diagnostics](#read-issue-diagnostics).
|
|
62
|
+
|
|
63
|
+
Authenticate with `Authorization: Bearer $OS_API_KEY`.
|
|
64
|
+
Base URL: `https://os.hz.egbe.dev`.
|
|
65
|
+
|
|
66
|
+
## Get a DSN
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/errors/<your-app-slug>" -s -X POST \
|
|
70
|
+
-H 'Content-Type: application/json' \
|
|
71
|
+
-d '{"target":"api","platform":"node-express"}'
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
`platform` must be one of these values; without it the project gets
|
|
75
|
+
`javascript-nextjs`:
|
|
76
|
+
|
|
77
|
+
| `platform` | Use it for |
|
|
78
|
+
|---|---|
|
|
79
|
+
| `javascript-nextjs` | Next.js apps, browser and server (the default) |
|
|
80
|
+
| `javascript-react` | React or Vite browser apps and other static browser pages, including a Vite SPA served from Convex |
|
|
81
|
+
| `node-express` | Node.js or Express servers, APIs, and workers |
|
|
82
|
+
| `python` | Other Python services |
|
|
83
|
+
| `python-django` | Django |
|
|
84
|
+
| `python-fastapi` | FastAPI |
|
|
85
|
+
| `python-flask` | Flask |
|
|
86
|
+
|
|
87
|
+
Any other value, such as `javascript` or `browser`, fails with 400
|
|
88
|
+
`invalid_platform`, and the error lists `supported_platforms`. The gateway also
|
|
89
|
+
maps a few short aliases (`next`, `react`, `vite`, `node`, `express`) to these
|
|
90
|
+
names, but send the full value.
|
|
91
|
+
|
|
92
|
+
The response carries `project.dsn`. Fetch it again later with:
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/errors/<your-app-slug>" -s
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
Use one product slug and separate targets when the product has multiple runtime
|
|
99
|
+
services:
|
|
100
|
+
|
|
101
|
+
- `web` - public frontend or a combined full-stack Next app.
|
|
102
|
+
- `api` - separate backend/API service.
|
|
103
|
+
- `worker` - background jobs.
|
|
104
|
+
- `admin` - separate admin/control surface.
|
|
105
|
+
|
|
106
|
+
For a single full-stack Next app, `target:"web"` is enough if both browser and
|
|
107
|
+
server Sentry are initialized from the same codebase. For separate frontend and
|
|
108
|
+
backend services, provision the same product slug with targets such as `web` and
|
|
109
|
+
`api`.
|
|
110
|
+
|
|
111
|
+
## Read issue diagnostics
|
|
112
|
+
|
|
113
|
+
Use the provisioned product slug and target. The reads below work with ordinary
|
|
114
|
+
project credentials and read-only credentials carrying `errors:read` or
|
|
115
|
+
`project:read`. They do not grant permission to modify or resolve an issue.
|
|
116
|
+
|
|
117
|
+
List recent issues (defaults to unresolved, most frequent first):
|
|
118
|
+
|
|
119
|
+
```bash
|
|
120
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/errors/<your-app-slug>/<target>/issues?status=unresolved&limit=10" -s
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
Query params: `status` (`unresolved` | `resolved` | `ignored` | `all`), `limit`
|
|
124
|
+
(1-50), `query` (raw Sentry search, overrides `status`), `sort` (`freq` | `date`
|
|
125
|
+
| `new`), `statsPeriod` (`24h` | `14d`). `<target>` is the project target
|
|
126
|
+
you provisioned (`web`, `api`, `worker`, `admin`).
|
|
127
|
+
|
|
128
|
+
Take the numeric `id` from the list, not the display `short_id` or a Sentry URL:
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/errors/<your-app-slug>/<target>/issues/<issue_id>" -s
|
|
132
|
+
|
|
133
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/errors/<your-app-slug>/<target>/issues/<issue_id>/events/latest" -s
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
The issue response includes its summary, platform and available first/last
|
|
137
|
+
release. The event response contains `issue` and `event`: the event ID and time,
|
|
138
|
+
release/environment, exception stack frames and breadcrumbs when Sentry captured
|
|
139
|
+
them. To inspect the same occurrence again, replace `latest` with its 32-character
|
|
140
|
+
hexadecimal event ID. The gateway verifies that both issue and event belong to
|
|
141
|
+
the requested product and target.
|
|
142
|
+
|
|
143
|
+
Diagnostics are a bounded, redacted projection, not a raw Sentry export. User
|
|
144
|
+
records, request headers/bodies, frame locals and source context are excluded;
|
|
145
|
+
URL credentials and query strings are removed. Inspect truncation markers and
|
|
146
|
+
treat missing fields as unavailable, not as evidence that nothing failed.
|
|
147
|
+
An inaccessible event does not mean the issue is resolved.
|
|
148
|
+
|
|
149
|
+
Use the event's timestamp, release, failing frame and breadcrumbs to inspect the
|
|
150
|
+
matching product code and reproduce the affected path. Compare the release with
|
|
151
|
+
the serving revision through `egbe-os-deploy`; an older event is not proof of a
|
|
152
|
+
failure in a later release. Keep the issue/event IDs with the existing repair
|
|
153
|
+
evidence so a later run can resume the same investigation.
|
|
154
|
+
|
|
155
|
+
## Resolve a verified repair
|
|
156
|
+
|
|
157
|
+
After the affected behavior is verified in the intended release, use the
|
|
158
|
+
numeric issue ID to mark it resolved. Resolving the Sentry record does not
|
|
159
|
+
repair the app or verify deployment, and the absence of a new event alone does
|
|
160
|
+
not prove a fix. A read-only key cannot perform this operation.
|
|
161
|
+
|
|
162
|
+
```bash
|
|
163
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/errors/<your-app-slug>/<target>/issues/<issue_id>/resolve" -s -X POST
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
## Wire Env
|
|
167
|
+
|
|
168
|
+
Set the DSN as `SENTRY_DSN` in server/API/worker runtime env. The same DSN is
|
|
169
|
+
public-safe and may also be exposed to browser code when the framework needs a
|
|
170
|
+
public build-time variable such as `NEXT_PUBLIC_SENTRY_DSN`.
|
|
171
|
+
|
|
172
|
+
```bash
|
|
173
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/deploy" -s -X POST \
|
|
174
|
+
-H 'Content-Type: application/json' \
|
|
175
|
+
-d '{"slug":"my-app","repo":"my-app","env":{"SENTRY_DSN":"<dsn>","NEXT_PUBLIC_SENTRY_DSN":"<dsn>"}}'
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
Do not put Sentry auth tokens in product env. Product code only needs the DSN.
|
|
179
|
+
|
|
180
|
+
## Initialize SDK
|
|
181
|
+
|
|
182
|
+
### Next / full-stack app
|
|
183
|
+
|
|
184
|
+
Use `@sentry/nextjs` and initialize both client and server sides from the same
|
|
185
|
+
DSN when the app is full-stack. Detect the installed Next.js/Sentry versions
|
|
186
|
+
and follow their bundled/current file conventions instead of assuming a
|
|
187
|
+
training-era filename. Current Next.js with Turbopack uses
|
|
188
|
+
`instrumentation-client.ts` for browser initialization and `instrumentation.ts`
|
|
189
|
+
for server registration; export `captureRouterTransitionStart` and
|
|
190
|
+
`captureRequestError` hooks when the installed SDK exposes them.
|
|
191
|
+
|
|
192
|
+
```js
|
|
193
|
+
// instrumentation-client.ts (current Next.js/Turbopack)
|
|
194
|
+
import * as Sentry from "@sentry/nextjs";
|
|
195
|
+
|
|
196
|
+
Sentry.init({
|
|
197
|
+
dsn: process.env.NEXT_PUBLIC_SENTRY_DSN || process.env.SENTRY_DSN,
|
|
198
|
+
tracesSampleRate: 0,
|
|
199
|
+
});
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
```js
|
|
203
|
+
// sentry.server.config.js
|
|
204
|
+
import * as Sentry from "@sentry/nextjs";
|
|
205
|
+
|
|
206
|
+
Sentry.init({
|
|
207
|
+
dsn: process.env.SENTRY_DSN,
|
|
208
|
+
tracesSampleRate: 0,
|
|
209
|
+
});
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
### Node / API service
|
|
213
|
+
|
|
214
|
+
```js
|
|
215
|
+
import * as Sentry from "@sentry/node";
|
|
216
|
+
|
|
217
|
+
if (process.env.SENTRY_DSN) {
|
|
218
|
+
Sentry.init({
|
|
219
|
+
dsn: process.env.SENTRY_DSN,
|
|
220
|
+
tracesSampleRate: 0,
|
|
221
|
+
});
|
|
222
|
+
}
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
### Browser-only app
|
|
226
|
+
|
|
227
|
+
```js
|
|
228
|
+
import * as Sentry from "@sentry/browser";
|
|
229
|
+
|
|
230
|
+
Sentry.init({
|
|
231
|
+
dsn: process.env.NEXT_PUBLIC_SENTRY_DSN || process.env.SENTRY_DSN,
|
|
232
|
+
tracesSampleRate: 0,
|
|
233
|
+
});
|
|
234
|
+
```
|
|
235
|
+
|
|
236
|
+
## Required Tags
|
|
237
|
+
|
|
238
|
+
Set these tags before capturing product exceptions:
|
|
239
|
+
|
|
240
|
+
- `product_slug` - the deployed product slug.
|
|
241
|
+
- `openclaw_instance` - the Egbe project identity, under its retained compatibility tag name; it does not require OpenClaw or a hosted agent.
|
|
242
|
+
- `runtime_target` - `web`, `api`, `worker`, or `admin`.
|
|
243
|
+
|
|
244
|
+
Example:
|
|
245
|
+
|
|
246
|
+
```js
|
|
247
|
+
Sentry.setTag("product_slug", process.env.PRODUCT_SLUG || "my-app");
|
|
248
|
+
Sentry.setTag("openclaw_instance", process.env.EGBE_INSTANCE_ID || process.env.OPENCLAW_INSTANCE || "unknown");
|
|
249
|
+
Sentry.setTag("runtime_target", "web");
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
## Controlled Smoke
|
|
253
|
+
|
|
254
|
+
For manual verification, you may trigger one controlled test exception and flush
|
|
255
|
+
the SDK before returning a response. Do not leave public debug routes enabled in
|
|
256
|
+
production, and do not use synthetic Sentry issues as the only proof that product
|
|
257
|
+
monitoring is ready. First verify setup and wiring:
|
|
258
|
+
Sentry project/DSN exists, deploy env carries the DSN, and product source
|
|
259
|
+
initializes the SDK with the required tags.
|
|
@@ -0,0 +1,275 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-git
|
|
3
|
+
description: Create an Egbe repository, push local code or commit files without a terminal, and read code back.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use when code needs versioning or a repository for publication."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Code repositories"
|
|
8
|
+
egbe-description: "Create an Egbe-hosted repository to store, version and publish your app's code."
|
|
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
|
+
# Git
|
|
57
|
+
|
|
58
|
+
Native Git can push, fetch and clone through `https://os.hz.egbe.dev/git/http/<repo>.git`
|
|
59
|
+
using `Authorization: Bearer $OS_API_KEY` with the `git` scope. OS resolves your
|
|
60
|
+
account's Forgejo owner and credential internally. The remote contains no secret;
|
|
61
|
+
no Forgejo token export or credential helper is required for this transport.
|
|
62
|
+
Git and Forgejo handle commits, history, branch protection and push conflicts.
|
|
63
|
+
|
|
64
|
+
## Start from your local project
|
|
65
|
+
|
|
66
|
+
A local branch such as `master`, uncommitted changes, a missing remote or absent
|
|
67
|
+
Vercel/Netlify files are normal setup, not evidence Egbe deployment is blocked.
|
|
68
|
+
Within the founder's existing publishing/deployment authorization:
|
|
69
|
+
|
|
70
|
+
1. Inspect `git status`, the current branch and remote names with `git remote`. Preserve existing
|
|
71
|
+
history and remotes. Do not print remote URLs or Git config: older remotes may
|
|
72
|
+
contain credentials. Initialize Git only if absent. Read `/deploy/skill` for the
|
|
73
|
+
Dockerfile/build requirements; configure `.gitignore` and `.dockerignore` before
|
|
74
|
+
staging so `.env.local`, credentials, dependencies and build output stay private.
|
|
75
|
+
2. List repositories with `GET /git/repos`; reuse the intended repository or create
|
|
76
|
+
an empty private one with `POST /git/repos`. Paginate with `page` and `limit`
|
|
77
|
+
(1–50, default 50) until a page has fewer than `limit` items; match the exact
|
|
78
|
+
`owner`/`name` or `full_name`, not a substring. Check HTTP success before proceeding.
|
|
79
|
+
Both operations return clean metadata and `os_http_url`. This URL is available
|
|
80
|
+
for the authenticated account’s own namespace; it is null for collaborator-owned
|
|
81
|
+
repositories, whose issues remain accessible according to repository permissions.
|
|
82
|
+
Do not substitute a same-named repository from another owner.
|
|
83
|
+
3. Check author and committer identities with `git var GIT_AUTHOR_IDENT` and
|
|
84
|
+
`git var GIT_COMMITTER_IDENT`. If missing, choose identities approved for this
|
|
85
|
+
project and save them with `git config --local user.name` / `user.email`.
|
|
86
|
+
Preserve existing identities. These are commit metadata, never API credentials.
|
|
87
|
+
4. Review and commit the intended files, then push the current branch through the
|
|
88
|
+
OS HTTP remote. Use the exact full pushed SHA from `git rev-parse HEAD` as the
|
|
89
|
+
`ref` in `POST /deploy`. No branch rename or force push is needed.
|
|
90
|
+
5. Verify deployment status, deployed revision and public URL per `/deploy/skill`.
|
|
91
|
+
|
|
92
|
+
```bash
|
|
93
|
+
# OS_URL and OS_API_KEY come from the existing quickstart connection.
|
|
94
|
+
# List first; create only if the intended repository is absent.
|
|
95
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/git/repos" -fsS
|
|
96
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/git/repos" -fsS -X POST \
|
|
97
|
+
-H 'Content-Type: application/json' \
|
|
98
|
+
-d '{"name":"my-app","private":true}' \
|
|
99
|
+
| python3 -c 'import json,sys; print(json.load(sys.stdin)["data"]["os_http_url"])'
|
|
100
|
+
# No Forgejo credentials or direct transport addresses are returned.
|
|
101
|
+
|
|
102
|
+
# Add a dedicated remote without replacing an existing origin.
|
|
103
|
+
REMOTE="$OS_URL/git/http/my-app.git"
|
|
104
|
+
# Replace all fetch and push targets on this dedicated remote. A legacy pushurl
|
|
105
|
+
# otherwise overrides url and can silently push directly to Forgejo.
|
|
106
|
+
git config --local --replace-all remote.egbe.url "$REMOTE"
|
|
107
|
+
git config --local --replace-all remote.egbe.pushurl "$REMOTE"
|
|
108
|
+
git config --local --replace-all remote.egbe.fetch '+refs/heads/*:refs/remotes/egbe/*'
|
|
109
|
+
git var GIT_AUTHOR_IDENT
|
|
110
|
+
git var GIT_COMMITTER_IDENT
|
|
111
|
+
# Review git status/diff, stage intended source files, and commit before pushing.
|
|
112
|
+
|
|
113
|
+
# Pass the key via a temporary environment variable, scoped to this remote.
|
|
114
|
+
# Do not enable shell tracing, store this header in Git config, or print it.
|
|
115
|
+
REMOTE="$OS_URL/git/http/my-app.git"
|
|
116
|
+
export OS_GIT_AUTH="Authorization: Bearer $OS_API_KEY"
|
|
117
|
+
git --config-env="http.$REMOTE.extraHeader=OS_GIT_AUTH" push -u egbe HEAD
|
|
118
|
+
unset OS_GIT_AUTH
|
|
119
|
+
git rev-parse HEAD
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
For an existing project with a legacy Forgejo origin, select the same repository
|
|
123
|
+
from the paginated list and use its OS URL on the dedicated `egbe` remote above.
|
|
124
|
+
Keep `origin` unchanged; use `egbe` explicitly for push/fetch. Never expose a legacy
|
|
125
|
+
URL while comparing remotes, and do not rotate keys or recreate the repository.
|
|
126
|
+
Preserve the current branch name. For an intentional differently named remote
|
|
127
|
+
branch use `HEAD:<approved-branch>`; do not overwrite unrelated history. On a
|
|
128
|
+
rejected push, fetch and inspect the remote changes or publish a new branch.
|
|
129
|
+
After a timeout/disconnect, inspect remote refs before deciding whether to retry;
|
|
130
|
+
a lost response does not prove the push failed.
|
|
131
|
+
|
|
132
|
+
## Clone or fetch
|
|
133
|
+
|
|
134
|
+
Use the same temporary, remote-scoped header with every authenticated Git call:
|
|
135
|
+
|
|
136
|
+
```bash
|
|
137
|
+
REMOTE="$OS_URL/git/http/my-app.git"
|
|
138
|
+
export OS_GIT_AUTH="Authorization: Bearer $OS_API_KEY"
|
|
139
|
+
git --config-env="http.$REMOTE.extraHeader=OS_GIT_AUTH" clone "$REMOTE"
|
|
140
|
+
# Inside an existing clone whose egbe remote matches REMOTE:
|
|
141
|
+
# git --config-env="http.$REMOTE.extraHeader=OS_GIT_AUTH" fetch egbe
|
|
142
|
+
unset OS_GIT_AUTH
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
This requires Git with `--config-env` support (2.31+). Git smart HTTP uses raw
|
|
146
|
+
protocol responses, while repository management APIs use the normal OS envelope.
|
|
147
|
+
The adapter supports discovery, upload-pack and receive-pack only; Git LFS and
|
|
148
|
+
dumb HTTP are outside this transport. OS keys are valid here, not as direct
|
|
149
|
+
Forgejo passwords.
|
|
150
|
+
|
|
151
|
+
## One OS contract
|
|
152
|
+
|
|
153
|
+
Repository management, issues and comments use the same OS API and authentication
|
|
154
|
+
in REST and MCP. `GET /git/credentials` returns 410 and no credentials. Refresh
|
|
155
|
+
this skill and use the OS operations; do not request a Forgejo token, construct
|
|
156
|
+
a direct Forgejo URL or send the OS key to Forgejo. Internal credentials stay on
|
|
157
|
+
the server. Existing repositories and saved remotes are not deleted or revoked.
|
|
158
|
+
|
|
159
|
+
If a shell network policy blocks OS, follow quickstart’s environment recovery for
|
|
160
|
+
`os.hz.egbe.dev` (or the configured OS host), or commit through the API below.
|
|
161
|
+
Direct Forgejo access is not required and is not the recovery path. MCP cannot
|
|
162
|
+
carry Git smart HTTP bytes, but it carries every repository, issue and commit
|
|
163
|
+
operation in this skill.
|
|
164
|
+
|
|
165
|
+
Escalate the actual redacted authorization/provisioning/network/build error,
|
|
166
|
+
not missing configuration. When the OS key cannot reach a Git process, commit
|
|
167
|
+
through the API below instead of reporting publication as blocked.
|
|
168
|
+
|
|
169
|
+
## Without a terminal: commit through the Egbe connector
|
|
170
|
+
|
|
171
|
+
Use this when the agent has no shell or Git, or its shell cannot reach Egbe (for
|
|
172
|
+
example a chat in claude.ai, Cowork or ChatGPT). Every step is a JSON request,
|
|
173
|
+
so it works through `egbe_read`/`egbe_write`; nothing contains `.git`. A
|
|
174
|
+
workspace with Git can keep using the push flow above.
|
|
175
|
+
|
|
176
|
+
1. Pick the repository from `GET /git/repos` (one with a non-null `os_http_url`,
|
|
177
|
+
your own namespace) or create it with `POST /git/repos`.
|
|
178
|
+
2. Read what is there. `GET /git/repos/<owner>/<repo>/tree` with `ref` (default:
|
|
179
|
+
the default branch) returns `commit`, the branch head's full SHA, and
|
|
180
|
+
`entries` (`path`, `type`, `mode`, `size`, `sha`); request `page=<next_page>`
|
|
181
|
+
until `next_page` is null. A repository without commits answers 404 with
|
|
182
|
+
`data.empty: true`: its base is `""`. Read a file with
|
|
183
|
+
`GET /git/repos/<owner>/<repo>/file` and `path`, `ref=<commit>`: `content` is
|
|
184
|
+
UTF-8 text or, with `encoding: "base64"`, binary. Repeat with
|
|
185
|
+
`offset=<next_offset>` until `next_offset` is null. Files over 10 MB are not
|
|
186
|
+
readable here.
|
|
187
|
+
3. Commit. A small change is one request:
|
|
188
|
+
|
|
189
|
+
```json
|
|
190
|
+
POST /git/repos/<owner>/<repo>/commits
|
|
191
|
+
{"base": "<commit>", "message": "Add pricing page",
|
|
192
|
+
"files": [{"path": "src/pricing.html", "content": "<h1>Pricing</h1>\n"}],
|
|
193
|
+
"delete": ["src/old.html"]}
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
For more files, send the same request without `message` to open a session
|
|
197
|
+
(response `session_id`), add batches with
|
|
198
|
+
`POST /git/commit-sessions/<session_id>/files` (`files`, `delete`), then
|
|
199
|
+
`POST /git/commit-sessions/<session_id>/commit` with `{"message": "..."}`.
|
|
200
|
+
Nothing reaches the branch until that call, which makes one commit.
|
|
201
|
+
- `base` is required: the branch head SHA you read, or `""` for an empty
|
|
202
|
+
repository or a new branch. `branch` defaults to the repository's default
|
|
203
|
+
branch. With `"base": ""` and `from_branch`, a new branch starts from that
|
|
204
|
+
branch's head.
|
|
205
|
+
- `encoding` is `utf-8` (default) or `base64` for images, fonts and other
|
|
206
|
+
binary files. `executable: true` marks scripts; an existing file keeps its
|
|
207
|
+
mode otherwise. `delete` removes files or whole folders of the base.
|
|
208
|
+
- Paths are relative and `/`-separated, without `..` or `.git`. Send source
|
|
209
|
+
files only: never `.env*` with real values, `node_modules/` or build output.
|
|
210
|
+
- Keep each request under 700,000 bytes (base64 grows content by a third; aim
|
|
211
|
+
for about 450 KB of file content per batch). For a larger file, send its
|
|
212
|
+
first part, then the rest in later batches with `"append": true` on the same
|
|
213
|
+
path. A later batch replaces a path staged earlier.
|
|
214
|
+
- Optional `author: {"name", "email"}` on the commit uses an identity approved
|
|
215
|
+
for this project; the default is Egbe OS.
|
|
216
|
+
- A template or other file bundled with an Egbe skill is copied on the server
|
|
217
|
+
instead of sent: give the entry `from_skill` in place of `content`, such as
|
|
218
|
+
`{"path": "src/quiz/quiz-engine.mjs", "from_skill": {"skill": "egbe-os-quiz-funnel",
|
|
219
|
+
"path": "assets/engine/quiz-engine.mjs"}}`. A `from_skill.path` ending in `/`
|
|
220
|
+
copies every file of that skill folder into the folder `path` names (`""`
|
|
221
|
+
for the repository root), each counting as one batch entry. The connector's
|
|
222
|
+
`egbe_skill` with `resource: ""` (or a folder ending in `/`) lists a skill's
|
|
223
|
+
files with their size and SHA-256; copies are byte-exact, keep a script's
|
|
224
|
+
executable mode and count toward the same limits.
|
|
225
|
+
- Product Build's shipped application and account foundations install into a
|
|
226
|
+
session with `POST /git/commit-sessions/<session_id>/scaffold`; see its
|
|
227
|
+
`references/foundations.md`.
|
|
228
|
+
4. The result's `sha` is the full commit SHA: pass it as `ref` to `POST /deploy`
|
|
229
|
+
(see `/deploy/skill`). `changed: false` means the files matched the base and
|
|
230
|
+
no commit was made.
|
|
231
|
+
|
|
232
|
+
Limits: 10 MB per file, 50 MB and 2,000 paths per commit, 500 entries per batch,
|
|
233
|
+
3 open sessions per business. A session expires 30 minutes after its last request
|
|
234
|
+
(2 hours at most); `GET /git/commit-sessions/<session_id>` shows its state, staged
|
|
235
|
+
paths and result, and `DELETE` discards it.
|
|
236
|
+
|
|
237
|
+
A failed commit call names its cause in `data.reason`, with `data.retryable`
|
|
238
|
+
saying whether repeating the same request later can succeed. Act on the reason,
|
|
239
|
+
not the HTTP status (a 403 with `data.reason` is a Git refusal, not a missing key
|
|
240
|
+
scope). Unless the reason says otherwise, nothing was written; a session's commit
|
|
241
|
+
call leaves the session open (discard it with `DELETE` if you will not retry it),
|
|
242
|
+
and a refused one-shot request keeps no session, so send it again in full.
|
|
243
|
+
|
|
244
|
+
- `moved` (409, `data.head` differs from your `base`): the branch moved. Read
|
|
245
|
+
the changed files at `data.head`, reapply your edits where needed, then repeat
|
|
246
|
+
the commit call with `"base": "<data.head>"`: the staged files replace those
|
|
247
|
+
paths at that head. Egbe never force-pushes.
|
|
248
|
+
- `source_moved` (409, retryable): the `from_branch` you started a new branch
|
|
249
|
+
from moved while committing. Repeat the same commit call; nothing was written.
|
|
250
|
+
- `protected_branch` (403): the branch is protected. Do not retry or work
|
|
251
|
+
around it; ask the founder to allow the push or name another branch, then
|
|
252
|
+
commit there with `"base": ""` and `from_branch`.
|
|
253
|
+
- `permission_denied` (403): the Git server denied Egbe access. Do not retry;
|
|
254
|
+
contact Egbe support.
|
|
255
|
+
- `too_large` (422): the push was too large. Commit the change in smaller parts.
|
|
256
|
+
- `rejected` (409, `data.head` equals your base): a server hook or ref check
|
|
257
|
+
declined the update. Read the branch head, retry once with it as base, and ask
|
|
258
|
+
the founder if it is refused again.
|
|
259
|
+
- `unreachable` (502) or `git_unavailable` (503): the Git server or Egbe's Git
|
|
260
|
+
could not be reached. Retry later. When the response has no `data.head`, the
|
|
261
|
+
push outcome may be unknown: read the tree and check whether your change is
|
|
262
|
+
already there before committing again. Contact Egbe support if it persists.
|
|
263
|
+
- `timeout` (504): the outcome is unknown. Repeat the same session's commit
|
|
264
|
+
call: a finished session returns its commit again with `replayed: true`. For a
|
|
265
|
+
one-shot request, read the tree first; if its `commit` differs from your base,
|
|
266
|
+
check whether your change is already there before committing again.
|
|
267
|
+
- `refused` (502): an unrecognized refusal. Retry once later, then contact Egbe
|
|
268
|
+
support with the time and repository.
|
|
269
|
+
- `internal` (500) or `configuration` (502): an Egbe-side fault. Do not retry;
|
|
270
|
+
contact Egbe support with the time and repository.
|
|
271
|
+
|
|
272
|
+
## Product backlog
|
|
273
|
+
|
|
274
|
+
To read or update issues in this project's repository, follow
|
|
275
|
+
[Repository issues](references/issues.md). It uses the same OS connection; no direct Forgejo access is needed.
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Repository issues and comments through OS
|
|
2
|
+
|
|
3
|
+
Use the project's existing repository for its backlog. Find its exact `owner` and
|
|
4
|
+
`name` in paginated `GET /git/repos`, retaining `full_name` to distinguish same-named
|
|
5
|
+
repositories. Never print a legacy remote URL: it may contain credentials.
|
|
6
|
+
Use the configured OS host and `Authorization: Bearer $OS_API_KEY`, as for repository
|
|
7
|
+
creation. Through MCP use `egbe_read`/`egbe_write` with the selected business.
|
|
8
|
+
The server resolves the upstream credential and applies the caller's repository
|
|
9
|
+
permissions. A repository shared with this account may support issues even when
|
|
10
|
+
its `os_http_url` is null; native OS Git transport covers the account's own namespace.
|
|
11
|
+
|
|
12
|
+
The OS prefix is `/git/repos/<owner>/<repo>/issues`:
|
|
13
|
+
|
|
14
|
+
| Operation | Method and relative path | JSON body / query |
|
|
15
|
+
|---|---|---|
|
|
16
|
+
| List | `GET` prefix | `state=open` (or `closed`, `all`), `page=1&limit=50` |
|
|
17
|
+
| Read | `GET /<number>` | — |
|
|
18
|
+
| Create | `POST` prefix | `{"title":"...","body":"..."}` |
|
|
19
|
+
| Edit or close | `PATCH /<number>` | Changed `title`, `body`, `state`; `{"state":"closed"}` to close |
|
|
20
|
+
| Read comments | `GET /<number>/comments` | `page=1&limit=50` |
|
|
21
|
+
| Comment | `POST /<number>/comments` | `{"body":"..."}` |
|
|
22
|
+
|
|
23
|
+
Responses use the normal OS envelope. Issue lists exclude pull requests. Use the
|
|
24
|
+
repository-local issue `number`, never its global database `id`. Comment `id` is
|
|
25
|
+
returned as metadata; these operations do not edit/delete comments. For repository,
|
|
26
|
+
issue and comment lists, increment `page` until fewer than `limit` items are returned
|
|
27
|
+
(`limit` 1–50, default 50). Search/read before creating to avoid duplicates.
|
|
28
|
+
|
|
29
|
+
Only make changes required by the founder's task. For a failed or disconnected
|
|
30
|
+
write, read back before retrying: the write may already have succeeded. A 401/403
|
|
31
|
+
is an access failure; a 404 may mean missing data or inaccessible private data.
|
|
32
|
+
Do not switch identity or create a different project's backlog to bypass it.
|
|
33
|
+
No Forgejo URL or token is required; the retired `/git/credentials` returns 410.
|