@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,116 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-setup
|
|
3
|
+
description: Set up Egbe for the founder's business through the Egbe connector. Use when the founder asks to set up, connect or start using Egbe.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
**If the `egbe_*` tools are missing.** The plugin's Egbe connector isn't signed
|
|
7
|
+
in yet: installing the plugin doesn't sign in. OpenCode lists the connector as
|
|
8
|
+
the `egbe` MCP server and its tools with the server's prefix, such as
|
|
9
|
+
`egbe_egbe_setup`. Ask the founder to connect their Egbe account before setup
|
|
10
|
+
continues, in a short message in their language:
|
|
11
|
+
|
|
12
|
+
- Say that this is a one-time step.
|
|
13
|
+
- Number the steps: in a terminal on this computer, run `opencode mcp auth egbe`
|
|
14
|
+
(in OpenCode 2, `/mcps` in OpenCode also starts it), sign in to Egbe in the
|
|
15
|
+
browser that opens and select **Connect**, then restart OpenCode in this
|
|
16
|
+
folder. Egbe's page doesn't ask for a business, so don't ask them to choose one
|
|
17
|
+
there.
|
|
18
|
+
- Say what happens afterwards and what to reply.
|
|
19
|
+
- End with one line on what the connection allows: it covers all their Egbe
|
|
20
|
+
businesses, including ones they start later, and in each conversation you
|
|
21
|
+
work on the business they name; the Egbe team can read what you do in Egbe to
|
|
22
|
+
support them and improve Egbe, and they can disconnect you anytime under
|
|
23
|
+
[connected AI assistants](https://dashboard.egbe.ai/settings/connections).
|
|
24
|
+
|
|
25
|
+
Don't run `opencode mcp auth` yourself: it waits for the founder in a browser.
|
|
26
|
+
When OpenCode runs on another machine (SSH or a container), the browser can't
|
|
27
|
+
reach the sign-in's local callback: tell the founder to copy the address of the
|
|
28
|
+
page that fails to load (`http://127.0.0.1:<port>/...`) and paste it into the
|
|
29
|
+
terminal prompt that asks for it.
|
|
30
|
+
|
|
31
|
+
If the sign-in fails, for example because Egbe refuses to register this agent,
|
|
32
|
+
stop asking the founder to retry. Tell them what failed, quoting the error, and
|
|
33
|
+
that they can connect this agent with the connection instructions on their
|
|
34
|
+
business's **Connect** page in Egbe (<https://dashboard.egbe.ai>) instead, or ask
|
|
35
|
+
for help at <support@egbe.ai>.
|
|
36
|
+
|
|
37
|
+
Don't call Egbe unavailable before this step, and don't reach Egbe from the shell
|
|
38
|
+
instead.
|
|
39
|
+
|
|
40
|
+
**Plugin updates.** The plugin updates itself from npm while OpenCode runs and
|
|
41
|
+
records each check under `update` in `~/.local/state/egbe/opencode-plugin.json`
|
|
42
|
+
(under `$XDG_STATE_HOME` when it is set). When the founder asks about the
|
|
43
|
+
plugin's version or updates, read that entry. `manual` means a new version
|
|
44
|
+
changes what the plugin can do and waits for the founder: in OpenCode 2 they run
|
|
45
|
+
`opencode plugin update @egbe-ai/opencode`; in 1.x they delete
|
|
46
|
+
`~/.cache/opencode/packages/@egbe-ai/opencode@latest` and restart OpenCode. A
|
|
47
|
+
plugin loaded from a folder updates with `git pull` in that folder.
|
|
48
|
+
|
|
49
|
+
# Set up Egbe through this connection
|
|
50
|
+
|
|
51
|
+
You are connected to the founder's Egbe project through MCP. If this result names
|
|
52
|
+
a `business`, pass it to every later egbe_read, egbe_write, egbe_local_setup and
|
|
53
|
+
egbe_complete_setup call.
|
|
54
|
+
|
|
55
|
+
This setup runs from the Egbe plugin, which provides Egbe's skills in every
|
|
56
|
+
session. Read those skills and their files from the plugin; use `egbe_skill`
|
|
57
|
+
only for what the plugin lacks, such as `egbe-os-quickstart` below. In step 2,
|
|
58
|
+
set up a persistent project workspace that is not set up yet as
|
|
59
|
+
[project setup](references/project.md) describes. It still calls `egbe_local_setup`
|
|
60
|
+
and keeps the standard project setup, including saved credentials, playbooks,
|
|
61
|
+
session logging and the Business Loop, but installs no skills. A project that
|
|
62
|
+
already has its own installed Egbe skills uses those rather than the plugin's
|
|
63
|
+
copies.
|
|
64
|
+
|
|
65
|
+
1. **Introduce Egbe.** Read
|
|
66
|
+
`egbe_skill(name="egbe-os-quickstart", resource="references/introduction.md")` and the
|
|
67
|
+
`skills` list in this result. Give the founder a warm, compact introduction in
|
|
68
|
+
their language: what you can now do for their business with Egbe. Describe
|
|
69
|
+
platform capabilities, not an already configured business.
|
|
70
|
+
2. **Choose where setup lives.** Establish from the environment context or native
|
|
71
|
+
documentation whether you work in a persistent project workspace: a project
|
|
72
|
+
folder whose files and configuration persist across sessions, where you can
|
|
73
|
+
run commands and reuse project-scoped skills and instructions. A chat's
|
|
74
|
+
temporary execution environment, a terminal alone or this connection does not
|
|
75
|
+
establish one; do not create one through installation or plugins.
|
|
76
|
+
- **Workspace already set up for Egbe** (saved Egbe credentials or an
|
|
77
|
+
installed Egbe catalog): this is not a new setup. Skip `egbe_local_setup`,
|
|
78
|
+
use the saved credentials and the installed skills, or `egbe_skill` where
|
|
79
|
+
none are installed, and continue with what the founder asked.
|
|
80
|
+
If it has `egbe-docs/egbe-workspace.json` and its saved `releases` differ
|
|
81
|
+
from this result's `releases`, first update its files as
|
|
82
|
+
`egbe_workspace_files` describes.
|
|
83
|
+
- **Persistent project workspace not set up yet:** call `egbe_local_setup` and
|
|
84
|
+
follow its result instead of the steps below. Through your own file tools
|
|
85
|
+
and this connection, with no Egbe installer or script, the workspace gets
|
|
86
|
+
saved credentials, project playbooks and guidance, logging authorization
|
|
87
|
+
and the Business Loop offer; skills stay readable with `egbe_skill`. If it refuses, mention the reason once and
|
|
88
|
+
continue below.
|
|
89
|
+
- **Otherwise:** continue below. This path needs no installation, API key,
|
|
90
|
+
curl, shell command or local file.
|
|
91
|
+
3. **Understand the project.** `project.limits` is the verified availability of
|
|
92
|
+
this project. An unused zero allowance (`max_allowed: 0`, `current: 0`) means
|
|
93
|
+
unavailable, not exhausted. Mention a limit only if it affects requested work
|
|
94
|
+
or the next step. Review the context you already have, such as notes, to
|
|
95
|
+
recommend where to continue. Do not run a full audit.
|
|
96
|
+
4. **Offer useful follow-through.** Use the founder's goal and project evidence
|
|
97
|
+
with `egbe_skill(name="egbe-os-quickstart", resource="references/offer-loop.md")`
|
|
98
|
+
to recommend a preset or custom loop. Discuss the choice in this chat; keep
|
|
99
|
+
ongoing work in a workspace with persistent access to the project.
|
|
100
|
+
5. **Finish.** Call `egbe_complete_setup` once, then give a concise handoff in the
|
|
101
|
+
first person: what you can do with Egbe, a compact capabilities table and the
|
|
102
|
+
concrete next step. If no product idea exists yet, start that conversation
|
|
103
|
+
now with an easy question about the founder's experience, interests or the
|
|
104
|
+
people they can reach. If the founder asked to finish without questions, ask
|
|
105
|
+
none: give the next step and what you will prepare, and keep any question for
|
|
106
|
+
a later reply.
|
|
107
|
+
|
|
108
|
+
For any later Egbe work, use its advertised `name` from the skills list with
|
|
109
|
+
`egbe_skill` and perform
|
|
110
|
+
its API steps with `egbe_read` (GET) and `egbe_write` (other methods). Connection alone does not authorize
|
|
111
|
+
development, publishing, spending, outreach or recurring work; ask the founder
|
|
112
|
+
for the missing decision.
|
|
113
|
+
|
|
114
|
+
To start another business, call `egbe_create_business` with the name the founder
|
|
115
|
+
chose, only when they ask for one or agree to it, then set it up with
|
|
116
|
+
`egbe_setup` and the `business` it returns.
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
# Set up a project folder with the Egbe plugin
|
|
2
|
+
|
|
3
|
+
The Egbe plugin gives every session in this folder Egbe's skills, so the project
|
|
4
|
+
needs only what belongs to it: saved credentials, editable playbooks and project
|
|
5
|
+
guidance. Do not install Egbe skills into the project, and do not download or
|
|
6
|
+
run Egbe's catalog installer. The steps below write small text files and copy
|
|
7
|
+
files that come with the plugin.
|
|
8
|
+
|
|
9
|
+
1. Call `egbe_local_setup` with the `business` that `egbe_setup` returned. Never
|
|
10
|
+
show its `OS_API_KEY` in chat, and keep it out of logs, commits, URLs and
|
|
11
|
+
search queries.
|
|
12
|
+
2. Follow the `instructions` it returns. Do their project files step as
|
|
13
|
+
[project files](#project-files) below describes, from the plugin's own
|
|
14
|
+
files, not with `egbe_workspace_files`: the plugin brings the same
|
|
15
|
+
playbooks, and its `EGBE.md` indexes the skills the plugin provides.
|
|
16
|
+
|
|
17
|
+
## Project files
|
|
18
|
+
|
|
19
|
+
Work from the project root. "This skill's folder" is the folder holding the
|
|
20
|
+
`egbe-setup` skill's `SKILL.md`. Reuse what is already in place; ask the founder
|
|
21
|
+
before replacing a file that differs.
|
|
22
|
+
|
|
23
|
+
Use file tools to read and write files. Run each shell command on its own, with
|
|
24
|
+
absolute paths: no `&&`, `;` or pipes, no `cd`, no shell variables, and never the
|
|
25
|
+
key in a command. An agent that approves commands one by one then asks less,
|
|
26
|
+
and a refused compound command does not stall setup.
|
|
27
|
+
|
|
28
|
+
- **Credentials.** Save them as the instructions' credentials step describes:
|
|
29
|
+
write `.env.local` with the file tools, then
|
|
30
|
+
run `chmod 600 .env.local` as its own command.
|
|
31
|
+
- **Private files.** Make sure `.gitignore` ignores `.env.local` and `/.egbe/`,
|
|
32
|
+
where skill scripts downloaded from Egbe are kept. Unless
|
|
33
|
+
`.gitignore` already ends with the lines below, append them; they keep private
|
|
34
|
+
working files in `egbe-docs/` out of Git:
|
|
35
|
+
|
|
36
|
+
```gitignore
|
|
37
|
+
!/egbe-docs/marketing/campaigns/instantly/outreach.db
|
|
38
|
+
/egbe-docs/**/.local/
|
|
39
|
+
/egbe-docs/**/.env
|
|
40
|
+
/egbe-docs/**/.env.*
|
|
41
|
+
/egbe-docs/**/*.lock
|
|
42
|
+
/egbe-docs/**/*.tmp
|
|
43
|
+
/egbe-docs/**/*-wal
|
|
44
|
+
/egbe-docs/**/*-shm
|
|
45
|
+
/egbe-docs/**/*-journal
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Likewise end `.dockerignore` with these lines, which keep `egbe-docs/` out of
|
|
49
|
+
builds:
|
|
50
|
+
|
|
51
|
+
```gitignore
|
|
52
|
+
/egbe-docs/
|
|
53
|
+
.git
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
- **Playbooks.** Copy the files in the `egbe-os-playbook` skill's `playbooks/`
|
|
57
|
+
folder (`../egbe-os-playbook/playbooks/` from this skill's folder) to the same
|
|
58
|
+
paths under `egbe-docs/playbooks/` with one command,
|
|
59
|
+
`rsync -a --ignore-existing <source>/ egbe-docs/playbooks/`, where `<source>` is
|
|
60
|
+
that folder's absolute path. Add only files
|
|
61
|
+
whose path does not exist yet; never replace or delete a project file, and
|
|
62
|
+
report any file you could not add. These are the project's editable methods.
|
|
63
|
+
Do not create `egbe-docs/playbooks-sync.json`: it records a finished method
|
|
64
|
+
review, not delivery.
|
|
65
|
+
- **Project guidance.** Copy `EGBE.md` from this skill's folder to the project
|
|
66
|
+
root as a regular file: read it and write the same text with the file tools,
|
|
67
|
+
since a plugin folder can be protected from shell commands. Add this exact
|
|
68
|
+
line to the project instruction file this agent reads at the start of every
|
|
69
|
+
session, such as the root `AGENTS.md`, keeping existing instructions and
|
|
70
|
+
reusing an equivalent entry:
|
|
71
|
+
`Read and apply EGBE.md when working on this project.` Then read the whole
|
|
72
|
+
`EGBE.md` once and use it for the rest of setup.
|
|
73
|
+
|
|
74
|
+
- **Session logging.** The plugin records this folder's sessions by default.
|
|
75
|
+
Don't ask for consent: tell the founder once and record the choice as the
|
|
76
|
+
`egbe-os-telemetry` skill's plugin section describes, unless a saved choice
|
|
77
|
+
declines logging.
|
|
78
|
+
|
|
79
|
+
Later, the `egbe-os-playbook` skill's catalog guide delivers new playbooks and
|
|
80
|
+
keeps `EGBE.md` current from the plugin. Egbe's skills update with the plugin.
|
package/state.js
ADDED
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
// The plugin's state file: the last session-logging result and the updater's
|
|
2
|
+
// state, for the founder and the agent to check. It never holds a secret.
|
|
3
|
+
import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
|
|
4
|
+
import os from "node:os";
|
|
5
|
+
import path from "node:path";
|
|
6
|
+
|
|
7
|
+
export function stateDir(environment = process.env) {
|
|
8
|
+
const base = environment.XDG_STATE_HOME || path.join(os.homedir(), ".local", "state");
|
|
9
|
+
return path.join(base, "egbe");
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
export function statePath(environment = process.env) {
|
|
13
|
+
return path.join(stateDir(environment), "opencode-plugin.json");
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
export function readState(environment = process.env) {
|
|
17
|
+
try {
|
|
18
|
+
const value = JSON.parse(readFileSync(statePath(environment), "utf8"));
|
|
19
|
+
return value && typeof value === "object" ? value : {};
|
|
20
|
+
} catch {
|
|
21
|
+
return {};
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/** Merges `patch` into the state file; never throws, since the file is only informational. */
|
|
26
|
+
export function writeState(patch, environment = process.env) {
|
|
27
|
+
try {
|
|
28
|
+
const file = statePath(environment);
|
|
29
|
+
mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
|
|
30
|
+
const next = { ...readState(environment), ...patch };
|
|
31
|
+
const temporary = `${file}.${process.pid}.tmp`;
|
|
32
|
+
writeFileSync(temporary, JSON.stringify(next, null, 2) + "\n", { mode: 0o600 });
|
|
33
|
+
renameSync(temporary, file);
|
|
34
|
+
} catch {
|
|
35
|
+
// Informational only.
|
|
36
|
+
}
|
|
37
|
+
}
|
package/update.js
ADDED
|
@@ -0,0 +1,361 @@
|
|
|
1
|
+
// Egbe's OpenCode plugin updates itself from npm.
|
|
2
|
+
//
|
|
3
|
+
// OpenCode 1.x installs an unpinned npm plugin once into its cache
|
|
4
|
+
// (`<cache>/opencode/packages/@egbe-ai/opencode@latest/`) and loads that copy on
|
|
5
|
+
// every later start without checking npm again. OpenCode 2.x checks unpinned
|
|
6
|
+
// npm plugins for new versions once a day but only marks them outdated: the
|
|
7
|
+
// update runs when someone runs `opencode plugin update`. So, in a long-running
|
|
8
|
+
// OpenCode, the plugin checks npm itself, a minute after it loads and every six
|
|
9
|
+
// hours, never at import and never in the way of a turn:
|
|
10
|
+
//
|
|
11
|
+
// 1. It reads `@egbe-ai/opencode` from the npm registry. A newer `latest` version
|
|
12
|
+
// whose declared capabilities (package.json `egbe.capabilities`: MCP servers,
|
|
13
|
+
// tools, commands and hooks) differ from the running version's is not
|
|
14
|
+
// installed automatically; the state file says to update by hand.
|
|
15
|
+
// 2. It downloads that version's tarball from the registry's own host, checks
|
|
16
|
+
// it against the registry's `dist.integrity` (SHA-512), unpacks it into a
|
|
17
|
+
// staging folder and checks its name, version and capabilities, then loads
|
|
18
|
+
// the staged copy with updates and logging off and checks that it registers
|
|
19
|
+
// the Egbe connector. Nothing it downloaded runs before the integrity check.
|
|
20
|
+
// 3. OpenCode 1.x: it swaps the staged copy into OpenCode's cache and keeps the
|
|
21
|
+
// previous copy until the new version has loaded; a failed swap restores the
|
|
22
|
+
// previous copy. The next OpenCode start loads the new version.
|
|
23
|
+
// OpenCode 2.x: it asks OpenCode to update the plugin
|
|
24
|
+
// (`opencode plugin update <target>`), which installs the same version
|
|
25
|
+
// through OpenCode's own npm installer and its integrity checks and reloads it.
|
|
26
|
+
//
|
|
27
|
+
// A pinned install (an exact version or a range) and an install from a folder,
|
|
28
|
+
// such as a clone of egbe-ai/egbe-plugins (updated with `git pull`), are left
|
|
29
|
+
// alone. The `autoUpdate: false` option turns this off. Every check is recorded
|
|
30
|
+
// under `update` in the plugin's state file.
|
|
31
|
+
import { createHash, randomBytes } from "node:crypto";
|
|
32
|
+
import { spawn } from "node:child_process";
|
|
33
|
+
import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
|
|
34
|
+
import path from "node:path";
|
|
35
|
+
import { pathToFileURL } from "node:url";
|
|
36
|
+
import { gunzipSync } from "node:zlib";
|
|
37
|
+
import { readState, stateDir, writeState } from "./state.js";
|
|
38
|
+
|
|
39
|
+
export const PACKAGE = "@egbe-ai/opencode";
|
|
40
|
+
const SCOPE = PACKAGE.split("/")[0];
|
|
41
|
+
export const REGISTRY = "https://registry.npmjs.org";
|
|
42
|
+
const MAX_PACKUMENT = 16 * 1024 * 1024;
|
|
43
|
+
const MAX_TARBALL = 32 * 1024 * 1024;
|
|
44
|
+
const LOCK_STALE = 15 * 60 * 1000;
|
|
45
|
+
|
|
46
|
+
/** The updater's settings from the plugin options. */
|
|
47
|
+
export function updaterSettings(options) {
|
|
48
|
+
const o = options ?? {};
|
|
49
|
+
const number = (value, fallback, min) => (typeof value === "number" && Number.isFinite(value) && value >= min ? value : fallback);
|
|
50
|
+
let registry = REGISTRY;
|
|
51
|
+
if (o.registryUrl !== undefined) {
|
|
52
|
+
// A loopback registry for tests; otherwise only npm's. A bad value turns updates off.
|
|
53
|
+
let url;
|
|
54
|
+
try {
|
|
55
|
+
url = new URL(String(o.registryUrl));
|
|
56
|
+
} catch {
|
|
57
|
+
url = undefined;
|
|
58
|
+
}
|
|
59
|
+
const loopback = url?.protocol === "http:" && ["127.0.0.1", "localhost", "[::1]"].includes(url.hostname);
|
|
60
|
+
if (!url || (url.href.replace(/\/$/, "") !== REGISTRY && !loopback)) {
|
|
61
|
+
return { enabled: false, registry, intervalMs: 0, initialDelayMs: 0, error: "registryUrl must be npm's registry or a loopback test registry" };
|
|
62
|
+
}
|
|
63
|
+
registry = url.href.replace(/\/$/, "");
|
|
64
|
+
}
|
|
65
|
+
return {
|
|
66
|
+
enabled: o.autoUpdate !== false,
|
|
67
|
+
registry,
|
|
68
|
+
intervalMs: number(o.checkIntervalMinutes, 360, 1) * 60 * 1000,
|
|
69
|
+
initialDelayMs: number(o.initialDelaySeconds, 60, 0) * 1000,
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
export function compareVersions(a, b) {
|
|
74
|
+
const parse = (v) => String(v).split("-")[0].split(".").map((n) => Number.parseInt(n, 10) || 0);
|
|
75
|
+
const [x, y] = [parse(a), parse(b)];
|
|
76
|
+
for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] < y[i] ? -1 : 1;
|
|
77
|
+
return 0;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
const sameCapabilities = (a, b) => JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
|
|
81
|
+
|
|
82
|
+
/** How this copy was installed: OpenCode 1.x's npm cache, a folder, or a pinned spec.
|
|
83
|
+
* OpenCode 1.x keeps a package at `<cache>/packages/<spec>/node_modules/<name>`. */
|
|
84
|
+
export function v1Install(moduleRoot) {
|
|
85
|
+
const scope = path.dirname(moduleRoot);
|
|
86
|
+
const modules = path.dirname(scope);
|
|
87
|
+
const specDir = path.dirname(modules);
|
|
88
|
+
const scopeDir = path.dirname(specDir);
|
|
89
|
+
const packages = path.dirname(scopeDir);
|
|
90
|
+
const isCache = path.basename(moduleRoot) === "opencode" && path.basename(scope) === SCOPE
|
|
91
|
+
&& path.basename(modules) === "node_modules" && path.basename(scopeDir) === SCOPE && path.basename(packages) === "packages";
|
|
92
|
+
if (!isCache) return { kind: "folder" };
|
|
93
|
+
const spec = path.basename(specDir);
|
|
94
|
+
if (spec !== "opencode@latest") return { kind: "pinned", spec: `${SCOPE}/${spec}` };
|
|
95
|
+
return { kind: "npm", spec: `${PACKAGE}@latest`, packageDir: moduleRoot };
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/** The plugin's entry in OpenCode 2.x's plugin inventory, as an install kind. */
|
|
99
|
+
export function v2Install(inventory) {
|
|
100
|
+
const list = Array.isArray(inventory?.data) ? inventory.data : Array.isArray(inventory) ? inventory : [];
|
|
101
|
+
const entry = list.find((p) => p?.id === "egbe") ?? list.find((p) => p?.source?.target?.startsWith?.(PACKAGE));
|
|
102
|
+
const source = entry?.source;
|
|
103
|
+
if (!source) return { kind: "unknown" };
|
|
104
|
+
if (source.type !== "package") return { kind: "folder" };
|
|
105
|
+
const target = String(source.target);
|
|
106
|
+
if (target !== PACKAGE && target !== `${PACKAGE}@latest`) return { kind: "pinned", spec: target };
|
|
107
|
+
return { kind: "npm", target };
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
function lock(dir) {
|
|
111
|
+
const file = path.join(dir, "opencode-update.lock");
|
|
112
|
+
mkdirSync(dir, { recursive: true, mode: 0o700 });
|
|
113
|
+
try {
|
|
114
|
+
mkdirSync(file);
|
|
115
|
+
} catch {
|
|
116
|
+
try {
|
|
117
|
+
if (Date.now() - statSync(file).mtimeMs < LOCK_STALE) return undefined;
|
|
118
|
+
rmSync(file, { recursive: true, force: true });
|
|
119
|
+
mkdirSync(file);
|
|
120
|
+
} catch {
|
|
121
|
+
return undefined;
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
return () => rmSync(file, { recursive: true, force: true });
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
async function fetchLimited(fetchImpl, url, limit, accept) {
|
|
128
|
+
const res = await fetchImpl(url, { headers: { accept }, redirect: "error", signal: AbortSignal.timeout(60_000) });
|
|
129
|
+
if (!res.ok) throw new Error(`HTTP ${res.status} from ${new URL(url).host}`);
|
|
130
|
+
const body = Buffer.from(await res.arrayBuffer());
|
|
131
|
+
if (body.length > limit) throw new Error(`response from ${new URL(url).host} is too large`);
|
|
132
|
+
return body;
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/** The files of an npm tarball (`package/...`), refusing anything but regular files and folders inside it. */
|
|
136
|
+
export function untar(gzipped) {
|
|
137
|
+
const data = gunzipSync(gzipped);
|
|
138
|
+
const files = new Map();
|
|
139
|
+
let longPath;
|
|
140
|
+
const field = (block, start, length) => block.subarray(start, start + length).toString("utf8").replace(/\0.*$/s, "");
|
|
141
|
+
for (let offset = 0; offset + 512 <= data.length;) {
|
|
142
|
+
const header = data.subarray(offset, offset + 512);
|
|
143
|
+
if (header.every((b) => b === 0)) break;
|
|
144
|
+
const size = Number.parseInt(field(header, 124, 12).trim() || "0", 8);
|
|
145
|
+
const type = String.fromCharCode(header[156] || 48);
|
|
146
|
+
const mode = Number.parseInt(field(header, 100, 8).trim() || "644", 8);
|
|
147
|
+
const body = data.subarray(offset + 512, offset + 512 + size);
|
|
148
|
+
offset += 512 + Math.ceil(size / 512) * 512;
|
|
149
|
+
if (type === "x") {
|
|
150
|
+
const match = /\d+ path=([^\n]*)\n/.exec(body.toString("utf8"));
|
|
151
|
+
longPath = match?.[1];
|
|
152
|
+
continue;
|
|
153
|
+
}
|
|
154
|
+
if (type === "g") continue;
|
|
155
|
+
const prefix = field(header, 345, 155);
|
|
156
|
+
const name = longPath ?? (prefix ? `${prefix}/${field(header, 0, 100)}` : field(header, 0, 100));
|
|
157
|
+
longPath = undefined;
|
|
158
|
+
if (type === "5") continue;
|
|
159
|
+
if (type !== "0" && type !== "\0") throw new Error(`unsupported entry in the package: ${name}`);
|
|
160
|
+
const parts = name.split("/");
|
|
161
|
+
if (parts[0] !== "package" || parts.length < 2 || parts.some((p) => p === "" || p === "." || p === "..") || name.includes("\\")) {
|
|
162
|
+
throw new Error(`unsafe path in the package: ${name}`);
|
|
163
|
+
}
|
|
164
|
+
files.set(parts.slice(1).join("/"), { data: Buffer.from(body), executable: (mode & 0o111) !== 0 });
|
|
165
|
+
}
|
|
166
|
+
return files;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
function writeTree(dir, files) {
|
|
170
|
+
for (const [name, file] of files) {
|
|
171
|
+
const target = path.join(dir, name);
|
|
172
|
+
mkdirSync(path.dirname(target), { recursive: true });
|
|
173
|
+
writeFileSync(target, file.data);
|
|
174
|
+
chmodSync(target, file.executable ? 0o755 : 0o644);
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
/** Loads a staged copy with updates and logging off and checks that it adds the Egbe connector. */
|
|
179
|
+
async function smokeTest(dir, expectedUrl) {
|
|
180
|
+
const { default: plugin } = await import(`${pathToFileURL(path.join(dir, "index.js")).href}?verify=${Date.now()}`);
|
|
181
|
+
if (plugin?.id !== "egbe" || typeof plugin.server !== "function" || typeof plugin.setup !== "function") {
|
|
182
|
+
throw new Error("the new version does not export the plugin");
|
|
183
|
+
}
|
|
184
|
+
const client = { session: { messages: async () => ({ data: [] }) } };
|
|
185
|
+
const hooks = await plugin.server({ client, directory: dir, worktree: dir }, { autoUpdate: false, sessionLogging: false });
|
|
186
|
+
const config = {};
|
|
187
|
+
await hooks.config(config);
|
|
188
|
+
await hooks.dispose?.();
|
|
189
|
+
if (config.mcp?.egbe?.url !== expectedUrl) throw new Error("the new version does not add the Egbe connector");
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
/** Downloads, verifies and stages `version`; returns the staged folder. */
|
|
193
|
+
async function stage({ registry, packument, version, capabilities, stagingDir, fetchImpl, mcpUrl }) {
|
|
194
|
+
const manifest = packument.versions?.[version];
|
|
195
|
+
if (manifest?.name !== PACKAGE || manifest.version !== version) throw new Error(`the registry has no ${PACKAGE}@${version}`);
|
|
196
|
+
const integrity = String(manifest.dist?.integrity ?? "");
|
|
197
|
+
if (!integrity.startsWith("sha512-")) throw new Error("the registry gives no SHA-512 integrity");
|
|
198
|
+
const tarball = new URL(manifest.dist.tarball);
|
|
199
|
+
if (tarball.origin !== new URL(registry).origin) throw new Error(`the tarball is not on ${new URL(registry).host}`);
|
|
200
|
+
const gzipped = await fetchLimited(fetchImpl, tarball.href, MAX_TARBALL, "application/octet-stream");
|
|
201
|
+
const digest = `sha512-${createHash("sha512").update(gzipped).digest("base64")}`;
|
|
202
|
+
if (digest !== integrity) throw new Error("the tarball does not match the registry's integrity");
|
|
203
|
+
const files = untar(gzipped);
|
|
204
|
+
const pkg = JSON.parse(files.get("package.json")?.data.toString("utf8") ?? "null");
|
|
205
|
+
if (pkg?.name !== PACKAGE || pkg.version !== version) throw new Error("the tarball's package.json names another package or version");
|
|
206
|
+
if (!sameCapabilities(pkg.egbe?.capabilities, capabilities)) throw new Error("the tarball declares other capabilities than the registry");
|
|
207
|
+
rmSync(stagingDir, { recursive: true, force: true });
|
|
208
|
+
try {
|
|
209
|
+
writeTree(stagingDir, files);
|
|
210
|
+
await smokeTest(stagingDir, mcpUrl);
|
|
211
|
+
} catch (error) {
|
|
212
|
+
rmSync(stagingDir, { recursive: true, force: true });
|
|
213
|
+
throw error;
|
|
214
|
+
}
|
|
215
|
+
return stagingDir;
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
function installedVersion(packageDir) {
|
|
219
|
+
try {
|
|
220
|
+
const version = JSON.parse(readFileSync(path.join(packageDir, "package.json"), "utf8")).version;
|
|
221
|
+
return typeof version === "string" ? version : null;
|
|
222
|
+
} catch {
|
|
223
|
+
return null;
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
function runCli(command, args, cwd) {
|
|
228
|
+
return new Promise((resolve) => {
|
|
229
|
+
let child;
|
|
230
|
+
try {
|
|
231
|
+
child = spawn(command, args, { cwd, stdio: "ignore", windowsHide: true });
|
|
232
|
+
} catch (error) {
|
|
233
|
+
resolve({ code: -1, error: error.message });
|
|
234
|
+
return;
|
|
235
|
+
}
|
|
236
|
+
const timer = setTimeout(() => child.kill(), 5 * 60 * 1000);
|
|
237
|
+
child.on("error", (error) => { clearTimeout(timer); resolve({ code: -1, error: error.message }); });
|
|
238
|
+
child.on("exit", (code) => { clearTimeout(timer); resolve({ code }); });
|
|
239
|
+
});
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
/** Records that this version loaded after an update and removes the copy kept for rollback. */
|
|
243
|
+
export function confirmLoaded(version, environment = process.env) {
|
|
244
|
+
const update = readState(environment).update;
|
|
245
|
+
if (update?.status !== "installed" || update.to !== version) return false;
|
|
246
|
+
if (update.previous) rmSync(update.previous, { recursive: true, force: true });
|
|
247
|
+
writeState({ update: { ...update, status: "applied", appliedAt: new Date().toISOString(), previous: undefined } }, environment);
|
|
248
|
+
return true;
|
|
249
|
+
}
|
|
250
|
+
|
|
251
|
+
/**
|
|
252
|
+
* One update check. `install` is v1Install's or v2Install's result (or a function
|
|
253
|
+
* returning one); returns a short result, which is also recorded in the state file.
|
|
254
|
+
*/
|
|
255
|
+
export async function checkForUpdate({
|
|
256
|
+
version, capabilities, install, settings, fetchImpl = fetch, cli = runCli, opencode = process.execPath, cwd,
|
|
257
|
+
environment = process.env, mcpUrl = "https://os.hz.egbe.dev/mcp",
|
|
258
|
+
}) {
|
|
259
|
+
const record = (fields) => {
|
|
260
|
+
const update = { ...readState(environment).update, checkedAt: new Date().toISOString(), running: version, ...fields };
|
|
261
|
+
writeState({ update }, environment);
|
|
262
|
+
return fields.result;
|
|
263
|
+
};
|
|
264
|
+
confirmLoaded(version, environment);
|
|
265
|
+
if (!settings.enabled) return record({ result: `off: ${settings.error ?? "autoUpdate is false"}` });
|
|
266
|
+
const where = typeof install === "function" ? await install() : install;
|
|
267
|
+
if (where.kind === "folder") return record({ result: "skipped: installed from a folder; update it with git pull" });
|
|
268
|
+
if (where.kind === "pinned") return record({ result: `skipped: pinned to ${where.spec}` });
|
|
269
|
+
if (where.kind !== "npm") return record({ result: "skipped: install not recognized" });
|
|
270
|
+
const release = lock(stateDir(environment));
|
|
271
|
+
if (!release) return record({ result: "skipped: another update is running" });
|
|
272
|
+
let staged;
|
|
273
|
+
try {
|
|
274
|
+
const packument = JSON.parse((await fetchLimited(fetchImpl, `${settings.registry}/${PACKAGE.replace("/", "%2f")}`,
|
|
275
|
+
MAX_PACKUMENT, "application/json")).toString("utf8"));
|
|
276
|
+
const latest = packument["dist-tags"]?.latest;
|
|
277
|
+
if (typeof latest !== "string" || compareVersions(latest, version) <= 0) return record({ result: "current", latest });
|
|
278
|
+
// OpenCode 1.x loads a swapped-in copy only at its next start; until then this process
|
|
279
|
+
// runs the old version, so the copy on disk, not the running one, says what is installed.
|
|
280
|
+
const onDisk = where.packageDir ? installedVersion(where.packageDir) : null;
|
|
281
|
+
if (onDisk && compareVersions(latest, onDisk) <= 0) {
|
|
282
|
+
return record({ result: `installed ${onDisk}; OpenCode loads it at its next start`, latest });
|
|
283
|
+
}
|
|
284
|
+
const declared = packument.versions?.[latest]?.egbe?.capabilities;
|
|
285
|
+
if (!sameCapabilities(declared, capabilities)) {
|
|
286
|
+
return record({
|
|
287
|
+
result: `manual: ${latest} changes the plugin's capabilities; update it by hand`, latest, status: "manual",
|
|
288
|
+
});
|
|
289
|
+
}
|
|
290
|
+
if (where.packageDir) {
|
|
291
|
+
// OpenCode 1.x: stage beside OpenCode's copy, so the swap is a rename on one disk.
|
|
292
|
+
const scope = path.dirname(where.packageDir);
|
|
293
|
+
const suffix = randomBytes(4).toString("hex");
|
|
294
|
+
staged = await stage({ registry: settings.registry, packument, version: latest, capabilities, fetchImpl, mcpUrl,
|
|
295
|
+
stagingDir: path.join(scope, `.opencode-${latest}-${suffix}`) });
|
|
296
|
+
// A copy swapped in earlier that OpenCode hasn't loaded yet is replaced; the rollback copy
|
|
297
|
+
// stays the version that actually runs, so it is kept and stays tracked.
|
|
298
|
+
const pending = readState(environment).update;
|
|
299
|
+
// The rollback copy stays recorded until the new version loads, even if a check failed meanwhile.
|
|
300
|
+
const keep = onDisk && compareVersions(onDisk, version) > 0 && pending?.previous
|
|
301
|
+
&& existsSync(pending.previous) ? pending.previous : null;
|
|
302
|
+
const previous = keep ?? path.join(scope, `.opencode-previous-${version}-${suffix}`);
|
|
303
|
+
const displaced = keep ? path.join(scope, `.opencode-unloaded-${onDisk}-${suffix}`) : previous;
|
|
304
|
+
renameSync(where.packageDir, displaced);
|
|
305
|
+
try {
|
|
306
|
+
renameSync(staged, where.packageDir);
|
|
307
|
+
} catch (error) {
|
|
308
|
+
renameSync(displaced, where.packageDir);
|
|
309
|
+
throw error;
|
|
310
|
+
}
|
|
311
|
+
staged = undefined;
|
|
312
|
+
if (keep) rmSync(displaced, { recursive: true, force: true });
|
|
313
|
+
return record({ result: `installed ${latest}; OpenCode loads it at its next start`, latest, status: "installed",
|
|
314
|
+
from: version, to: latest, previous, at: new Date().toISOString() });
|
|
315
|
+
}
|
|
316
|
+
// OpenCode 2.x: verify the same way, then let OpenCode install it with its own npm installer.
|
|
317
|
+
staged = await stage({ registry: settings.registry, packument, version: latest, capabilities, fetchImpl, mcpUrl,
|
|
318
|
+
stagingDir: path.join(stateDir(environment), `opencode-staging-${randomBytes(4).toString("hex")}`) });
|
|
319
|
+
const run = await cli(opencode, ["plugin", "update", where.target], cwd);
|
|
320
|
+
if (run.code !== 0) {
|
|
321
|
+
return record({ result: `failed: opencode plugin update exited with ${run.code}${run.error ? ` (${run.error})` : ""}`,
|
|
322
|
+
latest, status: "failed" });
|
|
323
|
+
}
|
|
324
|
+
return record({ result: `installed ${latest} through opencode plugin update`, latest, status: "installed",
|
|
325
|
+
from: version, to: latest, at: new Date().toISOString() });
|
|
326
|
+
} catch (error) {
|
|
327
|
+
return record({ result: `failed: ${error?.message ?? error}`, status: "failed" });
|
|
328
|
+
} finally {
|
|
329
|
+
if (staged) rmSync(staged, { recursive: true, force: true });
|
|
330
|
+
release();
|
|
331
|
+
}
|
|
332
|
+
}
|
|
333
|
+
|
|
334
|
+
/** Runs checks a while after loading and then periodically; timers never keep OpenCode alive. */
|
|
335
|
+
export function scheduleUpdates({ settings, check, setTimer = setTimeout, setRepeat = setInterval }) {
|
|
336
|
+
if (!settings.enabled) return () => {};
|
|
337
|
+
let running = false;
|
|
338
|
+
const run = async () => {
|
|
339
|
+
if (running) return;
|
|
340
|
+
running = true;
|
|
341
|
+
try {
|
|
342
|
+
await check();
|
|
343
|
+
} catch {
|
|
344
|
+
// checkForUpdate records its own failures.
|
|
345
|
+
} finally {
|
|
346
|
+
running = false;
|
|
347
|
+
}
|
|
348
|
+
};
|
|
349
|
+
let repeat;
|
|
350
|
+
const first = setTimer(() => {
|
|
351
|
+
void run();
|
|
352
|
+
repeat = setRepeat(run, settings.intervalMs);
|
|
353
|
+
repeat?.unref?.();
|
|
354
|
+
}, settings.initialDelayMs);
|
|
355
|
+
first?.unref?.();
|
|
356
|
+
return () => {
|
|
357
|
+
clearTimeout(first);
|
|
358
|
+
if (repeat) clearInterval(repeat);
|
|
359
|
+
};
|
|
360
|
+
}
|
|
361
|
+
|