@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,81 @@
|
|
|
1
|
+
# Google Places
|
|
2
|
+
|
|
3
|
+
Find businesses, inspect place details, and retrieve available Google reviews
|
|
4
|
+
through Egbe OS. Use this workflow for local business research and reputation
|
|
5
|
+
monitoring. It requires only the configured project's `OS_URL` and `OS_API_KEY`;
|
|
6
|
+
search, details, and reviews require the key's `tools` scope. Keep credentials
|
|
7
|
+
out of committed files. Read `GET /search/skill` and `GET /tools/skill` for the
|
|
8
|
+
current contracts before making requests.
|
|
9
|
+
|
|
10
|
+
## Setup
|
|
11
|
+
|
|
12
|
+
Check project identity and Places limits before spending:
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/me/limits?resource=places" -fsS
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## Search for a place
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/search/places" -fsS \
|
|
22
|
+
-H "Content-Type: application/json" \
|
|
23
|
+
-d '{"query":"Blue Bottle Coffee San Francisco","max_results":5}'
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
OS returns `{code, message, data}`. Read search rows from `data.results`:
|
|
27
|
+
`title` is the business name, `snippet` its address, `score` its star rating,
|
|
28
|
+
and `url` its Google Maps link. The stable provider ID is
|
|
29
|
+
`data.results[i].metadata.place_id`; `metadata.user_rating_count` holds the
|
|
30
|
+
rating count. Select the matching business by name, address, and geography
|
|
31
|
+
before using its ID below. Replace the example `place_id` in both requests
|
|
32
|
+
with that selected ID.
|
|
33
|
+
|
|
34
|
+
## Get reviews for a place
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/tools/places/reviews" -fsS \
|
|
38
|
+
-H "Content-Type: application/json" \
|
|
39
|
+
-d '{"place_id":"ChIJ3UFdD2KAhYARYOHf4j7DshM"}'
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Read `data.reviews` and `data.count` from the OS envelope. The response also
|
|
43
|
+
includes `data.place_id`, `data.name`, and aggregate rating information. Reviews
|
|
44
|
+
are normalized and ready to store: each has `id` (stable, source-prefixed
|
|
45
|
+
for dedup upsert), `source`, `business_id`, `author`, `rating`, `text`,
|
|
46
|
+
`publish_time`, `relative_time`, and `url` (direct Google Maps link to the review).
|
|
47
|
+
|
|
48
|
+
## Get full place details
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/tools/places/details" -fsS \
|
|
52
|
+
-H "Content-Type: application/json" \
|
|
53
|
+
-d '{"place_id":"ChIJ3UFdD2KAhYARYOHf4j7DshM"}'
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
The OS envelope's `data` contains Google's place-details object, including
|
|
57
|
+
`id`, `displayName`, and requested fields. This differs from normalized search
|
|
58
|
+
rows and reviews. Pass optional `fields` (a comma-separated Places field mask,
|
|
59
|
+
such as `id,displayName,websiteUri`) to narrow the response; `language_code`
|
|
60
|
+
selects a localized response.
|
|
61
|
+
|
|
62
|
+
## Tool Parameters
|
|
63
|
+
|
|
64
|
+
| Endpoint | Body | Quota unit |
|
|
65
|
+
| --- | --- | --- |
|
|
66
|
+
| `POST /search/places` | `query` (required), `max_results` (1–20), `language_code`, `region_code` | `places:searches` |
|
|
67
|
+
| `POST /tools/places/details` | `place_id` (required), `fields`, `language_code` | `places:details` |
|
|
68
|
+
| `POST /tools/places/reviews` | `place_id` (required), `language_code` | `places:reviews` |
|
|
69
|
+
|
|
70
|
+
## Notes
|
|
71
|
+
|
|
72
|
+
- Google Places (New) returns **at most 5 reviews per place** (most relevant) —
|
|
73
|
+
a hard API limit, not a bug. There is no full review history through this API.
|
|
74
|
+
- Each request consumes one quota unit of its resource; budgets reset daily.
|
|
75
|
+
- The API is **read-only**: it cannot post replies to reviews. Posting a reply
|
|
76
|
+
requires the business owner's Google Business Profile, a separate authorized API.
|
|
77
|
+
- If the OS quota is exhausted, stop and report the exhausted resource rather
|
|
78
|
+
than bypassing OS with direct Google credentials. Treat 401/403 as a project
|
|
79
|
+
connection or scope problem; treat provider errors as failures, not empty
|
|
80
|
+
search/review results. An empty `data.reviews` list means no reviews were
|
|
81
|
+
returned, not that the business has no reviews.
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-support
|
|
3
|
+
description: Contact the Egbe team through support tickets and follow up on replies.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use for Egbe-team contact; offer a handoff when an Egbe blocker needs human intervention."
|
|
6
|
+
egbe-category: "Business operations"
|
|
7
|
+
egbe-visible: "true"
|
|
8
|
+
egbe-title: "Help from the Egbe team"
|
|
9
|
+
egbe-description: "Ask your agent to contact Egbe about a blocker and follow up on the team's replies."
|
|
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
|
+
# Support Tickets
|
|
57
|
+
|
|
58
|
+
Use Egbe's built-in support to contact the Egbe team and track human handoffs.
|
|
59
|
+
No external helpdesk connection is required. The team sees your ticket and acts
|
|
60
|
+
on it; check replies in a later session.
|
|
61
|
+
|
|
62
|
+
Tickets are scoped to you: you only ever see and touch your own. Each ticket
|
|
63
|
+
has a stable numeric `id` — use it for follow-ups. At the project's configured
|
|
64
|
+
`OS_URL`, authenticate with `Authorization: Bearer $OS_API_KEY`; the key needs
|
|
65
|
+
support permission. `POST /support/tickets` uses the `CreateTicketRequest`
|
|
66
|
+
schema in `/openapi.json` (operation `support_ticket_create`).
|
|
67
|
+
|
|
68
|
+
## When to use this
|
|
69
|
+
|
|
70
|
+
- Blocked on a human-only action (credential, domain, third-party dashboard).
|
|
71
|
+
- A shared service is broken and you can't fix it yourself.
|
|
72
|
+
- You need to ask the team a question and want it tracked, not lost in chat.
|
|
73
|
+
|
|
74
|
+
Do **not** open a ticket for things you can fix yourself — debugging, installing
|
|
75
|
+
packages, retrying a flaky deploy. Tickets are for genuine human handoffs.
|
|
76
|
+
|
|
77
|
+
## Create a ticket
|
|
78
|
+
|
|
79
|
+
Prepare a redacted report. Send it only with the founder's authorization or an
|
|
80
|
+
applicable workflow that explicitly requires the handoff; respect draft-only
|
|
81
|
+
requests.
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/support/tickets" -fsS -X POST \
|
|
85
|
+
-H "Content-Type: application/json" \
|
|
86
|
+
-d '{"title":"Need domain DNS access","body":"Please add the required DNS records or grant access to the domain settings.","reason":"The business cannot launch its custom-domain landing page until DNS is configured.","environment":"I am an AI assistant with shell and OS API access, but no access to the domain registrar. I checked the available DNS tools and cannot update these records.","requested_action":"Add the DNS records listed in the report or provide registrar access. Do not start paid work."}'
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
The response `data` carries the created ticket, including its `id` (use this for
|
|
90
|
+
follow-ups). Write a clear `body`: what you need, why you can't do it yourself,
|
|
91
|
+
and exactly what action would unblock you.
|
|
92
|
+
|
|
93
|
+
Include `reason`, `environment`, and `requested_action` whenever you open a
|
|
94
|
+
ticket. These fields are optional for older API clients, but make the handoff
|
|
95
|
+
actionable: explain the business goal and impact, your runtime and access
|
|
96
|
+
constraints (for example browser-only secrets versus shell access), what you
|
|
97
|
+
already tried, and the precise answer or action needed. Include relevant budget
|
|
98
|
+
and approval limits. Do not include API keys, tokens, passwords, or private keys.
|
|
99
|
+
|
|
100
|
+
The server adds the authenticated business ID, registry instance ID, instance
|
|
101
|
+
name, and agent support API attribution to the ticket and each follow-up. You
|
|
102
|
+
do not need to guess these IDs. Environment and reason are your account of the
|
|
103
|
+
problem; the API attribution alone does not establish human approval.
|
|
104
|
+
|
|
105
|
+
## List your tickets
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/support/tickets" -fsS
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
Returns your tickets, newest first. Check the `status` field of each:
|
|
112
|
+
`open` = not resolved yet, `closed` = the team marked it done.
|
|
113
|
+
|
|
114
|
+
## Get one ticket + comments (was it resolved?)
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/support/tickets/12" -fsS
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
Returns the ticket plus all replies from the human team in `comments`.
|
|
121
|
+
|
|
122
|
+
**Reading "resolved or not":**
|
|
123
|
+
- `status: "open"` → still being worked on (or not picked up yet). Keep waiting.
|
|
124
|
+
- `status: "closed"` → the team considers it resolved. Read the `comments` for
|
|
125
|
+
what they did, then act on it (e.g. redeploy, retry the blocked step).
|
|
126
|
+
- New `comments` while still `open` → the team may be asking you for more info.
|
|
127
|
+
Reply with the comment command below.
|
|
128
|
+
|
|
129
|
+
Poll this on a later session rather than busy-waiting — a ticket is an async
|
|
130
|
+
handoff, not a synchronous call.
|
|
131
|
+
|
|
132
|
+
## Comment on a ticket
|
|
133
|
+
|
|
134
|
+
Add context, answer a team question, or report that something is still broken:
|
|
135
|
+
|
|
136
|
+
```bash
|
|
137
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/support/tickets/12/comments" -fsS -X POST \
|
|
138
|
+
-H "Content-Type: application/json" \
|
|
139
|
+
-d '{"body":"Confirmed — redeployed and Stripe is working now. Thanks."}'
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
## Notes
|
|
143
|
+
|
|
144
|
+
- If a request fails, diagnose the actual authentication, scope or service error;
|
|
145
|
+
a third-party helpdesk is not a prerequisite.
|
|
146
|
+
- You can only see and comment on **your own** tickets. A ticket id that isn't
|
|
147
|
+
yours returns `404` — that's expected, not a bug.
|
|
148
|
+
- You do **not** close tickets — the human team does that. Your job is to file
|
|
149
|
+
a clear ticket, answer questions, and act on the resolution.
|
|
@@ -0,0 +1,344 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-telemetry
|
|
3
|
+
description: Connect, verify or disable project session logging.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use when session logging is requested or needs checking."
|
|
6
|
+
egbe-category: "Business operations"
|
|
7
|
+
egbe-visible: "false"
|
|
8
|
+
egbe-title: "Session logging"
|
|
9
|
+
egbe-description: "Connect authorized project session logging, verify delivery or turn it off."
|
|
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
|
+
# Agent session logging
|
|
57
|
+
|
|
58
|
+
<!-- egbe-opencode-telemetry:v1 -->
|
|
59
|
+
**With the Egbe plugin in OpenCode.** The plugin's session logging is the
|
|
60
|
+
managed exporter for harness `opencode` (step 3) in a set-up project folder, and
|
|
61
|
+
it is **on by default**: installing the plugin is the founder's agreement, which
|
|
62
|
+
the plugin's README and Egbe's setup disclose. This replaces asking for consent
|
|
63
|
+
in step 1 for this harness only; a saved decline, skip or disable still keeps it
|
|
64
|
+
off. When a run of an OpenCode session ends, the plugin sends that run's turn
|
|
65
|
+
(the founder's message, model calls with usage, tool calls with their results
|
|
66
|
+
and the reply) to the gateway's `opencode` route, grouped by OpenCode session.
|
|
67
|
+
It needs only the project's `OS_URL` and `OS_API_KEY` in its private
|
|
68
|
+
`.env.local` (mode 600), read at each run: it finds the gateway and the
|
|
69
|
+
project's public key itself. Do not install the Langfuse OpenCode plugin or set
|
|
70
|
+
`LANGFUSE_*` variables for it. If this project already sends OpenCode sessions
|
|
71
|
+
through the Langfuse plugin (a `LANGFUSE_BASEURL` ending in `/ingest/opencode`),
|
|
72
|
+
the plugin stays off so sessions are not recorded twice.
|
|
73
|
+
|
|
74
|
+
- **During setup**, tell the founder once, in plain words, that Egbe records
|
|
75
|
+
this folder's sessions (conversation text, tool inputs and results, and usage)
|
|
76
|
+
for the authorized Egbe team, and that they can ask you to turn it off. Save
|
|
77
|
+
`consent: granted` with authorization source `egbe-opencode-plugin-install`
|
|
78
|
+
for harness `opencode` (an existing grant keeps its source and scope, as
|
|
79
|
+
step 1 says) and record `collectors.opencode` with integration
|
|
80
|
+
`egbe-opencode-plugin`, the plugin version, `.env.local` as its config
|
|
81
|
+
location and pending verification. No restart or configuration change is
|
|
82
|
+
needed.
|
|
83
|
+
- **Verify** after the next completed turn, as Verify below describes. The
|
|
84
|
+
plugin also writes each run's result, never a secret, to
|
|
85
|
+
`~/.local/state/egbe/opencode-plugin.json` (under `$XDG_STATE_HOME` when
|
|
86
|
+
it is set); `sent` means Egbe accepted the turn.
|
|
87
|
+
- **Where it logs.** Sessions OpenCode runs in this folder or a subfolder of the
|
|
88
|
+
project, including `opencode run`, are logged; a session elsewhere uses that
|
|
89
|
+
folder's own `.env.local`, if any. Tell the founder when a schedule you set up
|
|
90
|
+
runs where sessions aren't logged.
|
|
91
|
+
- **Disable** when the founder asks, or when a saved choice declines logging:
|
|
92
|
+
set `EGBE_SESSION_LOGGING=off` in the project folder's `.env.local` with the
|
|
93
|
+
file tools and record the choice. The next run sends nothing, so the stop is
|
|
94
|
+
confirmed once the file is saved. `EGBE_SESSION_LOGGING=on` turns it back on,
|
|
95
|
+
also over a saved decline.
|
|
96
|
+
|
|
97
|
+
## Connect
|
|
98
|
+
|
|
99
|
+
1. Check the founder's request and the project's saved choice in
|
|
100
|
+
`egbe-docs/telemetry/setup.json` and project notes **before any setup work**.
|
|
101
|
+
A saved decline, skip or disable takes precedence over a pasted standard
|
|
102
|
+
connection prompt, including its "enable session logging" and authorization
|
|
103
|
+
text, and over the Egbe plugin's default logging. Keep logging off and return
|
|
104
|
+
to product work without collector discovery, configuration or installation.
|
|
105
|
+
Where the plugin's hook applies (below) and `setup.json` does not yet record
|
|
106
|
+
that choice, save it there as `declined` or `skipped`: the hook reads only
|
|
107
|
+
that file and `EGBE_SESSION_LOGGING`, not project notes.
|
|
108
|
+
Reopen setup only on an explicit request to reverse the previous choice;
|
|
109
|
+
routine reruns and harness changes do not qualify.
|
|
110
|
+
|
|
111
|
+
Otherwise, reuse applicable permission from the standard prompt or a saved
|
|
112
|
+
grant without asking again. The prompt authorizes conversation text, tool
|
|
113
|
+
inputs/results and usage through Egbe for access by the authorized Egbe team.
|
|
114
|
+
The Egbe plugin's session-logging hook applies when the plugin's own copy of
|
|
115
|
+
this skill, whichever copy you follow, carries its route ("With the Egbe
|
|
116
|
+
plugin in Claude Code or Cowork" below the title; the plugin's directory build
|
|
117
|
+
has none) and this project folder is set up for Egbe with a private
|
|
118
|
+
`.env.local`. There,
|
|
119
|
+
installing the plugin is the applicable permission for harness `claude-code`
|
|
120
|
+
only, for the same scope, disclosed by its README and Egbe's setup. Do not
|
|
121
|
+
ask; during setup tell the founder once that Egbe records this folder's
|
|
122
|
+
sessions and that they can ask you to turn it off, then save authorization
|
|
123
|
+
source `egbe-plugin-install`. A saved grant from another source keeps its
|
|
124
|
+
source and scope; add the plugin's collector without overwriting them.
|
|
125
|
+
Another harness does not reuse an `egbe-plugin-install` grant; it needs its
|
|
126
|
+
own applicable permission. That hook is the managed exporter (step 3);
|
|
127
|
+
install no second collector for it.
|
|
128
|
+
Without applicable permission, keep logging off and continue product work;
|
|
129
|
+
silence is not consent. If an explicit logging request leaves its scope
|
|
130
|
+
unresolved, ask only about the missing scope.
|
|
131
|
+
|
|
132
|
+
Save `consent: granted`, `declined` or `skipped`, the verified project ID,
|
|
133
|
+
choice date, authorization source and any scope restriction, preserving
|
|
134
|
+
connection and collector records. A missing answer is not a saved founder
|
|
135
|
+
choice. `skipped` means an explicit dismissed offer, never a grant. A later
|
|
136
|
+
explicit re-enable replaces the saved choice with `granted` and reuses records.
|
|
137
|
+
2. Read `GET /telemetry`. If `data.available` is false, report that logging is
|
|
138
|
+
unavailable and continue Egbe setup without it.
|
|
139
|
+
3. Check whether the environment already supplies a managed session exporter.
|
|
140
|
+
Reuse it only when its installed integration/version, project scope,
|
|
141
|
+
configuration inputs, activation owner and flush point are established and
|
|
142
|
+
compatible with the gateway and granted capture scope. Record that managed
|
|
143
|
+
route without installing a second collector or assuming native hooks are
|
|
144
|
+
active. Unknown availability is not an installed integration.
|
|
145
|
+
|
|
146
|
+
Otherwise identify the active harness, version and launch mode. Read only its
|
|
147
|
+
reference:
|
|
148
|
+
* [Codex](references/harnesses/codex.md)
|
|
149
|
+
* [Claude Code](references/harnesses/claude-code.md)
|
|
150
|
+
* [Hermes](references/harnesses/hermes.md)
|
|
151
|
+
* [OpenCode](references/harnesses/opencode.md)
|
|
152
|
+
* [OpenClaw](references/harnesses/openclaw.md)
|
|
153
|
+
If not installed, fetch it at
|
|
154
|
+
`GET /skills/telemetry/resources/references/harnesses/<harness>.md`.
|
|
155
|
+
For another harness, find its current session
|
|
156
|
+
tracing integration in the [Langfuse integration catalog](https://langfuse.com/integrations)
|
|
157
|
+
or [documentation index](https://langfuse.com/llms.txt), and read the linked
|
|
158
|
+
official installation/configuration guide. When selecting or installing an
|
|
159
|
+
integration yourself, use a maintained plugin or native exporter unchanged,
|
|
160
|
+
not an Egbe wrapper or a copied collector implementation.
|
|
161
|
+
Check its capture coverage and the gateway contract below. A missing or
|
|
162
|
+
incompatible integration ends this setup attempt before configuration or
|
|
163
|
+
installation: report the limitation and continue product work, rather than
|
|
164
|
+
building a custom adapter or claiming logging is active.
|
|
165
|
+
|
|
166
|
+
Tell the founder as [What to tell the founder](#what-to-tell-the-founder)
|
|
167
|
+
describes. For your own reference: records go to Egbe's shared Langfuse
|
|
168
|
+
project, accessible to the authorized Egbe team; attachments/media are
|
|
169
|
+
excluded and secret redaction is best-effort. Explain any history replay from
|
|
170
|
+
the harness reference: first activation may include earlier messages from
|
|
171
|
+
this session, not just new ones.
|
|
172
|
+
Honor narrower permission; do not expand it to match a collector's coverage.
|
|
173
|
+
4. Leave a working existing collector and its saved credentials unchanged,
|
|
174
|
+
including an existing telemetry key pair. Check project/harness status through
|
|
175
|
+
`GET /telemetry/status?harness=<harness>`. A saved decline or locally stopped
|
|
176
|
+
collector stays off; a skill update is not a request to re-enable it. If a
|
|
177
|
+
saved pair is rejected, diagnose it and keep verification pending rather than
|
|
178
|
+
silently replacing it.
|
|
179
|
+
|
|
180
|
+
For new setup, lost settings or explicitly requested reconfiguration, use the
|
|
181
|
+
project's existing `OS_API_KEY` from its private OS configuration: the primary
|
|
182
|
+
key, or the workspace key that setup through the Egbe connector saved there.
|
|
183
|
+
Verify the project ID through authenticated OS context, for example
|
|
184
|
+
`GET /me/limits`. Do not use a founder OAuth token, an apps/eval key, a scoped
|
|
185
|
+
key without the `telemetry` scope or a shared gateway token as the collector secret. Obtain the nonsecret base URL
|
|
186
|
+
from `GET /telemetry` and retained environment/connection metadata from status.
|
|
187
|
+
If status is unavailable, leave setup pending until that context can be checked.
|
|
188
|
+
Use the retained environment when a legacy connection exists. Otherwise use
|
|
189
|
+
production, or test for a designated test project. Select native values:
|
|
190
|
+
|
|
191
|
+
- Public key: `pk-lf-egbe-<project_id>`; append `-test` for test environment.
|
|
192
|
+
- Secret key: that existing `OS_API_KEY`. Revoking or rotating it stops delivery.
|
|
193
|
+
|
|
194
|
+
There is no registration, new key issuance or fallback pair to request. A
|
|
195
|
+
legacy `connection_id` is optional history, not a setup prerequisite. Reusing
|
|
196
|
+
the OS key means its private plugin copy has ordinary OS permissions too;
|
|
197
|
+
the gateway's traces-only route does not reduce those permissions. Never put
|
|
198
|
+
this secret in the public-key field or copy provider Langfuse keys to clients.
|
|
199
|
+
5. Save the shared settings below and configure the selected route through its
|
|
200
|
+
documented project-scoped inputs. For a native integration, follow its upstream
|
|
201
|
+
guide using native settings or a dedicated runtime profile.
|
|
202
|
+
Map the selected public/secret values and gateway URL to the integration's
|
|
203
|
+
documented fields; the native field names still use Langfuse terminology.
|
|
204
|
+
An isolated harness profile or plugin cache may live outside the workspace;
|
|
205
|
+
use the normal permission flow for those locations or protected files,
|
|
206
|
+
keeping collection scoped to this project.
|
|
207
|
+
Check effective settings, including inherited environment overrides, without
|
|
208
|
+
printing secrets. Preserve other hooks/collectors; avoid duplicate exporters.
|
|
209
|
+
Verify which working directory or profile resolves those settings; nested
|
|
210
|
+
directories do not necessarily inherit the project's configuration.
|
|
211
|
+
Disable media upload with native settings where available; media endpoints
|
|
212
|
+
are blocked at the gateway regardless. Keep text/tool capture enabled and
|
|
213
|
+
record unavoidable truncation or unsupported launch modes.
|
|
214
|
+
6. Confirm the selected plugin/exporter is actually installed and enabled in the
|
|
215
|
+
runtime that will run this project; saved credentials alone do not enable it.
|
|
216
|
+
For a verified managed route, follow its documented activation ownership;
|
|
217
|
+
do not request native hook trust for a route that does not use that hook.
|
|
218
|
+
This does not approve or activate any separate native integration.
|
|
219
|
+
Record the integration/version, guide URL, config locations and verification
|
|
220
|
+
state under `collectors.<harness>` in `setup.json`. For an already verified
|
|
221
|
+
collector, retain it and its export checkpoints. For a native integration,
|
|
222
|
+
prefer the harness reference's supported reload in the current session.
|
|
223
|
+
When only the founder can run its native command, save pending verification
|
|
224
|
+
and include that command in the optional activation note below, not as the
|
|
225
|
+
next step; do not run it in a shell or start a child harness as a substitute.
|
|
226
|
+
Request a new session/restart only for an evidenced runtime or consent-scope
|
|
227
|
+
limitation, after completing the rest of quickstart. Resume pending verification
|
|
228
|
+
after activation; do not claim that a reload alone proves delivery.
|
|
229
|
+
|
|
230
|
+
## What to tell the founder
|
|
231
|
+
|
|
232
|
+
Session logging is background setup. During onboarding it is never the
|
|
233
|
+
headline, the next step or a reason to pause product work: the founder's next
|
|
234
|
+
step stays their business. Speak plainly and leave out tool and mechanism names
|
|
235
|
+
(Langfuse, collector, exporter, Stop hook, `/hooks`, OTLP) and quotes from this
|
|
236
|
+
skill unless the founder asks how logging works.
|
|
237
|
+
|
|
238
|
+
- **While setting it up**, say once, in a sentence or two, that Egbe records this
|
|
239
|
+
project's agent sessions (conversation text, tool inputs and results, usage)
|
|
240
|
+
for the authorized Egbe team, that hiding secrets is best-effort (so avoid
|
|
241
|
+
pasting passwords or keys into chat), and that they can ask you to turn it off.
|
|
242
|
+
- **When activation still needs the founder** (a new chat, trusting the project,
|
|
243
|
+
approving a prompt in their app, or a native reload command), add one short
|
|
244
|
+
note after the product handoff, never before it: when logging will start and
|
|
245
|
+
the single action, named as the app shows it. Say it is optional, can wait and
|
|
246
|
+
affects nothing else. For example: "Session logging will start in your next
|
|
247
|
+
chat in this project. If Codex asks you to trust the project or review a hook
|
|
248
|
+
there, approving it turns logging on; nothing else depends on it." Do not ask
|
|
249
|
+
for a new chat or restart for logging alone.
|
|
250
|
+
- **Stay accurate:** while activation or verification is pending, say logging
|
|
251
|
+
will start, not that it is on. Verification is your own follow-up on a later
|
|
252
|
+
normal turn; mention it to the founder only if it finds a problem.
|
|
253
|
+
|
|
254
|
+
## Shared settings and gateway contract
|
|
255
|
+
|
|
256
|
+
Keep the existing OS credentials in Git-ignored `.env.local` (mode `600`),
|
|
257
|
+
preserving other variables. Save the nonsecret gateway location alongside them:
|
|
258
|
+
|
|
259
|
+
```dotenv
|
|
260
|
+
EGBE_TELEMETRY_URL=<data.base_url from GET /telemetry>
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
For new setup, no separate telemetry public/secret variables are needed. A plugin
|
|
264
|
+
need not read `.env.local`: pass the selected public identifier and existing OS
|
|
265
|
+
secret through its documented private native configuration or scoped environment.
|
|
266
|
+
Keep any copies out of Git and do not print them. OS-key rotation requires updating
|
|
267
|
+
those native secret copies before verifying delivery again.
|
|
268
|
+
|
|
269
|
+
Existing `EGBE_TELEMETRY_PUBLIC_KEY` / `EGBE_TELEMETRY_SECRET_KEY` and native copies
|
|
270
|
+
remain supported. Leave a working saved pair in place; no migration step is
|
|
271
|
+
required when skills update. New collectors follow step 4 above.
|
|
272
|
+
|
|
273
|
+
Use `<EGBE_TELEMETRY_URL>/ingest/<harness>` as the Langfuse SDK base URL. Choose a
|
|
274
|
+
stable harness label: 1–64 lowercase letters, digits or hyphens, starting with a
|
|
275
|
+
letter (for example `codex`, `hermes`, `opencode`). No server registration is needed.
|
|
276
|
+
The gateway accepts **only** `POST /api/public/otel/v1/traces` under that prefix:
|
|
277
|
+
OTLP HTTP JSON/protobuf, optional gzip, Basic auth with the selected public and secret values.
|
|
278
|
+
For a native exporter, use that complete traces URL. Packet limit: 8 MiB after
|
|
279
|
+
decompression. Other signals, legacy ingestion, media, read and admin APIs are
|
|
280
|
+
not proxied. Confirm the selected integration uses this transport; an arbitrary
|
|
281
|
+
Langfuse-compatible tool is not necessarily a session collector.
|
|
282
|
+
|
|
283
|
+
Version `egbe-docs/telemetry/setup.json` with the project. It has no secrets:
|
|
284
|
+
`project_id`, `consent` (`granted`, `declined` or `skipped`), choice date,
|
|
285
|
+
authorization source (for example, the setup request, not a copy containing its
|
|
286
|
+
API key, or `egbe-plugin-install` for the plugin's hook), optional consent scope,
|
|
287
|
+
`environment`, optional historical `connection_id`, and `collectors` keyed by
|
|
288
|
+
harness. Each collector records `enabled`, integration version/config locations
|
|
289
|
+
and `verification` (`pending` or `verified`). When switching harnesses, retain
|
|
290
|
+
existing entries and configure only the new one.
|
|
291
|
+
After cloning or moving the project, verify the current machine's collector
|
|
292
|
+
and config before treating a saved `verified` status as active here. Keep the
|
|
293
|
+
recorded consent scope; installation elsewhere does not expand authorization.
|
|
294
|
+
|
|
295
|
+
## Verify
|
|
296
|
+
|
|
297
|
+
Record a delivery baseline from
|
|
298
|
+
`GET /telemetry/status?harness=<harness>`, then make a harmless
|
|
299
|
+
text exchange and tool call. Check again after the integration's documented
|
|
300
|
+
flush point. If it exports after the current turn, save **pending verification**
|
|
301
|
+
and check on the next normal turn; do not generate extra turns just to verify.
|
|
302
|
+
|
|
303
|
+
- New receipts in `delivery.counts`/`last_result.updated` prove gateway acceptance;
|
|
304
|
+
an increase in `delivery.delivered` proves upstream acknowledgement, not
|
|
305
|
+
transcript completeness. `delivery.received` alone can refer to old records.
|
|
306
|
+
Another harness's deliveries or old counts do not verify this collector.
|
|
307
|
+
- Where Langfuse read access is available to the Egbe team, check the corresponding
|
|
308
|
+
session for test text, tool output and grouping. Report capture gaps separately.
|
|
309
|
+
- `last_result` is the latest receipt and may be successful despite an earlier
|
|
310
|
+
failure. For `needs_attention`, inspect `last_failure.reason` and its safe
|
|
311
|
+
`diagnostic` (known status, phase, error type, duration and bytes). On old
|
|
312
|
+
gateways without `last_failure`, report that failure details are unavailable;
|
|
313
|
+
do not use a successful `last_result` to clear the warning. Old receipts may
|
|
314
|
+
have no diagnostic. After payload expiry its diagnostic preserves the earlier
|
|
315
|
+
attempt while the current state/reason report expiry.
|
|
316
|
+
`uncertain` means an upstream acknowledgement was lost or partial; report it
|
|
317
|
+
without deleting checkpoints or blindly re-exporting. Missing status is not success.
|
|
318
|
+
|
|
319
|
+
For `401`, check the selected credential, project binding and key rotation; do not
|
|
320
|
+
request a legacy pair as fallback. For `409`, check retained environment and span
|
|
321
|
+
compatibility without resetting history or checkpoints.
|
|
322
|
+
For `413`, reduce batch size rather than silently truncate content. `429`/`503`
|
|
323
|
+
are temporary failures. Logging failures do not block product work. Offline
|
|
324
|
+
recovery depends on the upstream collector; Egbe can retry only received packets.
|
|
325
|
+
|
|
326
|
+
## Disable
|
|
327
|
+
|
|
328
|
+
For one harness, use its verified managed stop path when applicable; otherwise
|
|
329
|
+
read its reference and disable its integration using the upstream procedure,
|
|
330
|
+
including applying the change to the **running session**. Record
|
|
331
|
+
`stop: pending` until effective shutdown is confirmed; only then mark that
|
|
332
|
+
collector `enabled: false` and `stop: confirmed`. Removing saved credentials
|
|
333
|
+
alone does not prove shutdown. If applying the change is unavailable or fails,
|
|
334
|
+
explain any remaining hook/export risk, keep stop pending and give the next native
|
|
335
|
+
step. Preserve OS credentials, other collectors and upstream export checkpoints.
|
|
336
|
+
After confirmed stop, remove only that collector's private credential copies;
|
|
337
|
+
keep `.env.local`'s `OS_API_KEY` for ordinary OS access.
|
|
338
|
+
|
|
339
|
+
For the whole project, record `consent: declined` immediately and shut down all
|
|
340
|
+
recorded collectors, including other machines, through their native procedures.
|
|
341
|
+
Keep each unavailable/unconfirmed stop pending and explain any remaining export
|
|
342
|
+
risk. There is no server telemetry enable/disable switch or key-revocation call.
|
|
343
|
+
Never revoke/delete the project's OS key just to stop logging. Stopping collection
|
|
344
|
+
does not delete existing Langfuse data; refer a deletion request to the Egbe team.
|