@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,97 @@
|
|
|
1
|
+
# Claude Code: activate the maintained plugin in this session
|
|
2
|
+
|
|
3
|
+
1. The plugin reads the session transcript at `Stop`/`SessionEnd`. Before
|
|
4
|
+
activation, explain in plain words that logging reads this chat when a turn
|
|
5
|
+
or session ends, so first activation can include earlier messages and tool
|
|
6
|
+
results from this session. Do not promise capture only from opt-in
|
|
7
|
+
onward. If the founder permits only future conversation, leave this session's
|
|
8
|
+
collector disabled, including at `SessionEnd`, and configure/activate it in a
|
|
9
|
+
genuinely fresh session; resuming the same transcript does not remove its
|
|
10
|
+
earlier history. Preserve upstream checkpoints.
|
|
11
|
+
2. With applicable authorization from the shared workflow, follow the current README of the
|
|
12
|
+
[Langfuse Observability Plugin](https://github.com/langfuse/Claude-Observability-Plugin).
|
|
13
|
+
Choose this maintained plugin, not the manual hook-copying instructions in
|
|
14
|
+
the general Claude Code integration guide. Enable and configure it only for
|
|
15
|
+
the current project: install from its root with `--scope local`, keeping private
|
|
16
|
+
settings in Git-ignored `.claude/settings.local.json` (mode `600`). Before
|
|
17
|
+
writing keys, run `git check-ignore .claude/settings.local.json` and add its
|
|
18
|
+
path to this project's `.gitignore` if necessary. The shared
|
|
19
|
+
plugin cache may remain outside the workspace. Merge the following into that
|
|
20
|
+
file's documented [`env` object](https://code.claude.com/docs/en/settings-reference#env),
|
|
21
|
+
substituting the actual selected values, not literal placeholders:
|
|
22
|
+
|
|
23
|
+
```json
|
|
24
|
+
{
|
|
25
|
+
"env": {
|
|
26
|
+
"LANGFUSE_PUBLIC_KEY": "<selected public key>",
|
|
27
|
+
"LANGFUSE_SECRET_KEY": "<selected secret key>",
|
|
28
|
+
"LANGFUSE_BASE_URL": "<EGBE_TELEMETRY_URL>/ingest/claude-code",
|
|
29
|
+
"CC_LANGFUSE_CAPTURE_IMAGES": "false"
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Do not write these names as top-level settings or put `pluginConfigs` in
|
|
35
|
+
project/local settings. Claude Code's [`userConfig` answers](https://code.claude.com/docs/en/settings-reference#pluginconfigs)
|
|
36
|
+
are user/managed scoped even when installation uses `--scope local`;
|
|
37
|
+
`/plugin configure` would share these answers across projects. The maintained
|
|
38
|
+
collector supports plain environment variables ahead of those answers. Claude
|
|
39
|
+
applies trusted local `env` changes to the running session and its subprocesses.
|
|
40
|
+
Check effective settings, including desktop/runner launch overrides, without
|
|
41
|
+
printing secrets; `.env.local` alone is not loaded by the plugin. Preserve
|
|
42
|
+
unrelated settings and hooks, and keep image capture off before activation.
|
|
43
|
+
3. After consent and configuration, prefer Claude Code's native
|
|
44
|
+
[`/reload-plugins`](https://code.claude.com/docs/en/plugins/cli-reference#reload-plugins)
|
|
45
|
+
in the **current session**. It loads newly installed/enabled plugin hooks
|
|
46
|
+
without restarting Claude Code, even when the plugin README or shell installer
|
|
47
|
+
says to restart. If you cannot invoke native slash commands, put it in the
|
|
48
|
+
common skill's optional activation note after the product handoff: “Whenever
|
|
49
|
+
convenient, run `/reload-plugins` here to start session logging; nothing else
|
|
50
|
+
depends on it.” This is a Claude Code command, not a shell command.
|
|
51
|
+
Save `verification: pending`, the delivery baseline and the pending command
|
|
52
|
+
before handing over. A shell `claude plugin list` proves installation/enabling,
|
|
53
|
+
not that the current session loaded the hook.
|
|
54
|
+
4. Check the reload summary for hooks and load errors; inspect `/plugin` errors
|
|
55
|
+
if needed. If Claude defers a reload because it would invalidate the prompt
|
|
56
|
+
cache, explain its message and the supported `/reload-plugins --force` option.
|
|
57
|
+
Do not claim a deferred/failed reload activated logging. Direct-entry reloads
|
|
58
|
+
outside an interactive terminal require Claude Code 2.1.260 or later and may
|
|
59
|
+
be unavailable over remote connections; check the active version/launch mode.
|
|
60
|
+
Request a restart only if reload is unavailable or cannot load the hook after
|
|
61
|
+
diagnosis, and record the concrete reason. Keep product work usable meanwhile.
|
|
62
|
+
5. Resume the shared delivery verification after a normal turn reaches `Stop`,
|
|
63
|
+
filtering status with `harness=claude-code`. Keep it pending until this harness's
|
|
64
|
+
delivered count increases over the saved baseline; loaded hooks alone do not
|
|
65
|
+
prove delivery. Retain the settings and checkpoints across reloads, and do
|
|
66
|
+
not start a child Claude session to claim the active session is verified.
|
|
67
|
+
6. If Auto mode denies a required setup action, keep setup/verification pending
|
|
68
|
+
and, in the optional activation note, ask the founder to approve that specific
|
|
69
|
+
action through Claude's native Manual / Ask permissions mode. Explain what the
|
|
70
|
+
action does: saving credentials does not itself send conversations; turning
|
|
71
|
+
logging on does. Do not broaden permission rules yourself or rewrite the
|
|
72
|
+
command to bypass the denial. Resume after approval, then use the shared
|
|
73
|
+
delivery verification workflow.
|
|
74
|
+
|
|
75
|
+
## Stop logging in the current session
|
|
76
|
+
|
|
77
|
+
Use the installed plugin's actual qualified ID from its saved record or plugin
|
|
78
|
+
list. From this project root, run `claude plugin disable <plugin-id> --scope local`
|
|
79
|
+
to disable only this project's collector; preserve other plugins and harnesses.
|
|
80
|
+
Then apply the change with native `/reload-plugins` in the **current session**
|
|
81
|
+
(using `--force` only when the reload message requires it). A shell disable
|
|
82
|
+
changes saved configuration; it does not prove that loaded hooks are gone.
|
|
83
|
+
|
|
84
|
+
Confirm the reload succeeded and the selected plugin's `Stop`/`SessionEnd` hooks
|
|
85
|
+
are no longer loaded. Record `stop: confirmed` and `enabled: false` only after
|
|
86
|
+
that confirmation. Preserve upstream checkpoints. Remove this collector's saved
|
|
87
|
+
key copies afterward, without changing other settings or shared keys still used
|
|
88
|
+
by another harness. Removing `env` entries does not unset their values in a
|
|
89
|
+
running Claude session, so key removal alone is never the stop procedure.
|
|
90
|
+
|
|
91
|
+
If reload is deferred, denied, unsupported or unavailable over the active remote
|
|
92
|
+
connection, record `stop: pending` and keep the last confirmed enabled state.
|
|
93
|
+
Tell the founder that previously loaded hooks may still export at `Stop` or
|
|
94
|
+
`SessionEnd`, and provide the native reload/diagnosed restart step without
|
|
95
|
+
claiming logging has stopped. For a whole-project consent withdrawal, follow the
|
|
96
|
+
common stop procedure for every collector and retain pending shutdowns. Keep the project's OS key for ordinary
|
|
97
|
+
OS access; there is no remote telemetry kill switch.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Codex: activate the upstream Stop hook
|
|
2
|
+
|
|
3
|
+
1. Follow the [Langfuse Codex guide](https://langfuse.com/integrations/developer-tools/codex)
|
|
4
|
+
for the maintained Codex observability plugin. Check its Codex/Node requirements
|
|
5
|
+
against the app or CLI that actually runs this session.
|
|
6
|
+
2. Enable the plugin and hooks in the configuration loaded by this session's
|
|
7
|
+
project. Codex loads them in a new chat; if it ignores untrusted project
|
|
8
|
+
settings, the founder must trust that project through Codex, and the Stop
|
|
9
|
+
hook needs their approval through its separate prompt. Installation alone
|
|
10
|
+
does not approve it. Keep verification pending until the hook is trusted.
|
|
11
|
+
3. Map the common workflow's selected public/secret values and gateway URL into
|
|
12
|
+
the plugin's project-local credential file or scoped environment, with base URL `<EGBE_TELEMETRY_URL>/ingest/codex`. Check
|
|
13
|
+
`LANGFUSE_CODEX_*` and `LANGFUSE_*` overrides in the actual runtime before
|
|
14
|
+
assuming the file is effective. Do not print their values.
|
|
15
|
+
4. Do not pause setup or ask for a new chat, trust or hook approval for logging.
|
|
16
|
+
Finish quickstart and the product handoff, then give the common skill's
|
|
17
|
+
optional activation note once: logging starts in the founder's next chat in
|
|
18
|
+
this project, where approving Codex's trust or hook prompt turns it on.
|
|
19
|
+
Verify after the Stop hook has run; if the last turn finalizes on the next
|
|
20
|
+
turn, continue verification there without resetting export checkpoints. If a
|
|
21
|
+
later chat still shows no delivery because the hook awaits approval, remind
|
|
22
|
+
the founder once, briefly, and continue their work.
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Hermes: configure the active profile
|
|
2
|
+
|
|
3
|
+
## With the Egbe Hermes plugin
|
|
4
|
+
|
|
5
|
+
When the Egbe plugin for Hermes is installed (`hermes plugins list` shows
|
|
6
|
+
`egbe` enabled), its session logging is the managed exporter for harness
|
|
7
|
+
`hermes`: it sends each turn from Hermes's plugin hooks when the turn ends, with
|
|
8
|
+
the project's `.env.local` credentials, grouped by Hermes session. Follow the
|
|
9
|
+
"Session logging" section of the plugin's `egbe:egbe` skill: record
|
|
10
|
+
`collectors.hermes` with integration `egbe-hermes-plugin`, verify with the
|
|
11
|
+
`egbe_status` tool or `hermes egbe status`, and stop with
|
|
12
|
+
`EGBE_SESSION_LOGGING=off`. Do not also install or configure `hermes_otel`
|
|
13
|
+
below; an existing `hermes_otel` export to Egbe keeps the plugin's logging off,
|
|
14
|
+
so sessions are not recorded twice. Without the plugin, continue below.
|
|
15
|
+
|
|
16
|
+
## Without the plugin
|
|
17
|
+
|
|
18
|
+
1. Use the maintained [hermes_otel plugin](https://github.com/briancaffey/hermes-otel):
|
|
19
|
+
install and enable it through Hermes's plugin commands in the profile used
|
|
20
|
+
for this project. Resolve that profile's `HERMES_HOME` first.
|
|
21
|
+
2. Configure `<HERMES_HOME>/hermes_otel.yaml`, not an unrelated default
|
|
22
|
+
`~/.hermes` profile. Use an OTLP backend with the complete traces URL
|
|
23
|
+
`<EGBE_TELEMETRY_URL>/ingest/hermes/api/public/otel/v1/traces` and Basic auth
|
|
24
|
+
from the common workflow's selected public and secret values. Keep the native
|
|
25
|
+
credential copy private.
|
|
26
|
+
3. Set `content_capture: full`. Send traces only to Egbe; disable metrics/log
|
|
27
|
+
export to this endpoint. This records full model requests/responses on
|
|
28
|
+
`api.*` spans; ordinary tool and `llm.*` spans can still contain previews.
|
|
29
|
+
Inspect full API history before treating a preview as missing content.
|
|
30
|
+
Preserve exact tool-call IDs and report unresolved or underlying tool-output
|
|
31
|
+
cutoffs; do not promise verbatim full capture or increase preview limits as
|
|
32
|
+
a substitute for verifying it.
|
|
33
|
+
4. Restart the active runtime after common setup, then verify delivery through
|
|
34
|
+
Egbe. For a messaging gateway in a Slack thread, ask the founder to send
|
|
35
|
+
`!restart` in that thread; Slack does not deliver native slash commands such
|
|
36
|
+
as `/restart` in threads, so those must be sent outside the thread
|
|
37
|
+
([Hermes Slack guide](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/slack)).
|
|
38
|
+
If only the plugin's local SQLite store changes, check the configured
|
|
39
|
+
backend and active profile; local records are not proof of remote delivery.
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
# OpenClaw: qualify the active conversation tracing route
|
|
2
|
+
|
|
3
|
+
## With the Egbe OpenClaw plugin
|
|
4
|
+
|
|
5
|
+
When the Egbe plugin for OpenClaw is installed (`openclaw plugins inspect egbe`
|
|
6
|
+
lists it), its session logging is the managed exporter for harness `openclaw`:
|
|
7
|
+
it sends each run's turn from `agent_end` with the workspace's `.env.local`
|
|
8
|
+
credentials and groups turns by OpenClaw session. Follow its `egbe` skill's
|
|
9
|
+
"Session logging" section: grant `plugins.entries.egbe.hooks.allowConversationAccess`,
|
|
10
|
+
record `collectors.openclaw` with integration `egbe-openclaw-plugin`, verify
|
|
11
|
+
with `openclaw egbe status`, and stop with `EGBE_SESSION_LOGGING=off`. Do not
|
|
12
|
+
also configure the native exporter or Langfuse Bridge below. Without the plugin,
|
|
13
|
+
continue below.
|
|
14
|
+
|
|
15
|
+
## Select before installation
|
|
16
|
+
|
|
17
|
+
Use the installed runtime's [OpenTelemetry guide](https://docs.openclaw.ai/gateway/opentelemetry)
|
|
18
|
+
and [configuration reference](https://docs.openclaw.ai/gateway/opentelemetry/configuration)
|
|
19
|
+
to check its native `diagnostics-otel` plugin, content capture and launch mode.
|
|
20
|
+
An unchanged native exporter that captures the granted text/tool scope and uses
|
|
21
|
+
the Egbe traces transport is allowed; the word "diagnostics" alone does not
|
|
22
|
+
establish or rule out conversation capture. Check actual content, not just OTLP.
|
|
23
|
+
|
|
24
|
+
Native capture covers every run executed by its Gateway. Require a
|
|
25
|
+
**project-dedicated Gateway/profile**, not a project config file on a shared
|
|
26
|
+
Gateway. Check effective process environment privately:
|
|
27
|
+
|
|
28
|
+
- Set `OTEL_NODE_RESOURCE_DETECTORS=none` before native activation. Default
|
|
29
|
+
process detection can export `process.command_args`, including credentials
|
|
30
|
+
passed as positional CLI arguments; content redaction does not cover this.
|
|
31
|
+
Exclude process/environment/host resource discovery and verify effective
|
|
32
|
+
settings. Do not print or copy credentials into commands or reports.
|
|
33
|
+
- `OPENCLAW_OTEL_PRELOADED=1` delegates traces to an external provider. Native
|
|
34
|
+
endpoint, headers, detector settings and shutdown do not control that provider.
|
|
35
|
+
Reuse it only through the common skill's verified managed-exporter contract
|
|
36
|
+
(destination, privacy, project scope, activation owner, flush and stop).
|
|
37
|
+
Otherwise leave capture off; do not remove a preload to take over its provider.
|
|
38
|
+
- `OTEL_SDK_DISABLED=true` disables plugin-owned export; saved config is not
|
|
39
|
+
evidence of an active collector.
|
|
40
|
+
|
|
41
|
+
If considering [Langfuse Bridge](https://langfuse.com/integrations/no-code/openclaw),
|
|
42
|
+
read its [upstream compatibility instructions](https://github.com/langfuse/openclaw-x-langfuse-plugin)
|
|
43
|
+
and check the installed release against storage and launch mode. Bridge 1.5.0
|
|
44
|
+
recovers text from trajectory JSONL, not SQLite; do not select it for SQLite
|
|
45
|
+
conversation recovery. It also fails runtime activation on tested OpenClaw
|
|
46
|
+
2026.10.2 with a missing `SeverityNumber` export. Retain an already qualified
|
|
47
|
+
Bridge on compatible runtimes; do not install a second exporter alongside it.
|
|
48
|
+
If neither route meets the required capture scope, report the limitation and
|
|
49
|
+
continue product work before configuring credentials or installing anything.
|
|
50
|
+
|
|
51
|
+
## Configure a qualified native route
|
|
52
|
+
|
|
53
|
+
1. Use the official `@openclaw/diagnostics-otel` package unchanged, through the
|
|
54
|
+
runtime's documented plugin installation and enable commands in this profile.
|
|
55
|
+
Inspect the selected release's `pluginApi` compatibility as well as minimum
|
|
56
|
+
host version. For example, stock plugin 2026.10.2 was tested on host 2026.10.2;
|
|
57
|
+
release 2026.10.7 requires a newer plugin API and is rejected there. Choose a
|
|
58
|
+
compatible maintained release, never force an incompatible latest install.
|
|
59
|
+
Preserve other plugin entries and allowlists through normal native trust
|
|
60
|
+
controls; do not bypass provenance checks or patch dependencies to load it.
|
|
61
|
+
2. Map the common workflow's selected values into private native configuration.
|
|
62
|
+
The plugin need not read `.env.local`. Replace placeholders with actual values privately;
|
|
63
|
+
`Authorization` is `Basic ` followed by base64 of the selected public value,
|
|
64
|
+
colon and selected secret value. Base64 is not encryption. Keep the native file
|
|
65
|
+
out of Git
|
|
66
|
+
with restrictive permissions, preserving existing configuration:
|
|
67
|
+
|
|
68
|
+
```json
|
|
69
|
+
{
|
|
70
|
+
"diagnostics": {
|
|
71
|
+
"enabled": true,
|
|
72
|
+
"otel": {
|
|
73
|
+
"enabled": true,
|
|
74
|
+
"tracesEndpoint": "<EGBE_TELEMETRY_URL>/ingest/openclaw/api/public/otel/v1/traces",
|
|
75
|
+
"protocol": "http/protobuf",
|
|
76
|
+
"headers": {"Authorization": "<privately computed Basic value>"},
|
|
77
|
+
"traces": true,
|
|
78
|
+
"metrics": false,
|
|
79
|
+
"logs": false,
|
|
80
|
+
"captureContent": true,
|
|
81
|
+
"sampleRate": 1
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
`captureContent: true` requires the existing grant for text/tool capture.
|
|
88
|
+
Default capture is off. Sampling 1 is for verification; sampled-out turns
|
|
89
|
+
cannot prove capture. Use `tracesEndpoint` as the exact full URL; do not send
|
|
90
|
+
metrics/logs to the traces-only gateway.
|
|
91
|
+
3. Activate the installed/enabled plugin in the actual project Gateway using
|
|
92
|
+
its documented native restart/reload. Installation and process-environment
|
|
93
|
+
changes require that process to take up the new settings; a config reload
|
|
94
|
+
does not change its inherited environment. Once loaded, supported changes to
|
|
95
|
+
`diagnostics.otel` hot-reload the exporter and flush its previous generation.
|
|
96
|
+
Verify runtime load/exporter health, not merely plugin discovery or saved keys.
|
|
97
|
+
4. Use Gateway-dispatched turns for verification. `openclaw agent --local`
|
|
98
|
+
qualifies only when the installed runtime documents starting and flushing
|
|
99
|
+
this exporter; 2026.10.2 does. `openclaw agent exec` does not start it in that
|
|
100
|
+
release. Do not start a child harness instead of activating the founder's
|
|
101
|
+
current runtime; follow the common skill's pending-activation procedure.
|
|
102
|
+
|
|
103
|
+
## Verify coverage and stop
|
|
104
|
+
|
|
105
|
+
Follow the common delivery-baseline procedure. Inspect child model and tool
|
|
106
|
+
observations as well as roots for text, results/errors, model/usage and parent
|
|
107
|
+
relationships. Check cross-turn session grouping separately. Never infer it from
|
|
108
|
+
packet counts or manufacture a constant session ID.
|
|
109
|
+
|
|
110
|
+
On native 2026.10.2 with SQLite, synthetic Gateway runs captured user/assistant
|
|
111
|
+
text, read results, usage and per-turn parent-child trees without reading JSONL.
|
|
112
|
+
Roots had empty I/O; a failed read had error status and its message in the next
|
|
113
|
+
model input, without a dedicated failed-tool result. No session/conversation ID
|
|
114
|
+
was emitted, so **cross-turn session grouping is unsupported in this release**.
|
|
115
|
+
Content is bounded/redacted; system prompts, thinking and external CLI harness
|
|
116
|
+
tool I/O are not guaranteed. Do not promise complete verbatim transcripts.
|
|
117
|
+
|
|
118
|
+
Record the chosen integration/version, actual launch/profile/environment and
|
|
119
|
+
these capture gaps in `collectors.openclaw`. Keep full session verification
|
|
120
|
+
`pending` while required grouping or live content readback is missing; report
|
|
121
|
+
the measured per-turn coverage separately. If joined cross-turn sessions are
|
|
122
|
+
required, this native release does not satisfy that requirement: leave setup
|
|
123
|
+
unavailable/unverified and continue product work. Local synthetic acknowledgement
|
|
124
|
+
does not activate the customer's connection or verify its Langfuse UI.
|
|
125
|
+
|
|
126
|
+
For one-harness native stop, set `diagnostics.otel.enabled: false` and confirm
|
|
127
|
+
the running exporter's documented reload/flush/shutdown before recording stop
|
|
128
|
+
confirmed. Preserve other plugins, collectors, keys and checkpoints. A preloaded
|
|
129
|
+
provider needs its verified managed stop path instead. Whole-project stop
|
|
130
|
+
uses the common skill and confirms every collector shutdown; it preserves the
|
|
131
|
+
OS key.
|
|
132
|
+
|
|
133
|
+
For a qualified Bridge route, map `publicKey`, `secretKey`, `baseUrl` to the
|
|
134
|
+
common workflow's selected public/secret values and base URL
|
|
135
|
+
`<EGBE_TELEMETRY_URL>/ingest/openclaw`. Preserve the profile's
|
|
136
|
+
other plugins. Follow the installed release's activation/stop procedure and
|
|
137
|
+
verify through its supported channel/webchat/TUI path; direct `openclaw agent`
|
|
138
|
+
CLI use does not establish Bridge conversation capture. Verify nonempty text,
|
|
139
|
+
tool results and session grouping; otherwise retain pending verification.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# OpenCode: enable a collector, not just credentials
|
|
2
|
+
|
|
3
|
+
## With the Egbe OpenCode plugin
|
|
4
|
+
|
|
5
|
+
When the Egbe plugin for OpenCode (`@egbe-ai/opencode`) is loaded, its session
|
|
6
|
+
logging is the managed exporter for harness `opencode`: when a run of a session
|
|
7
|
+
ends, it sends that run's turn with the project folder's `.env.local`
|
|
8
|
+
credentials and groups turns by OpenCode session. The plugin's own copy of the
|
|
9
|
+
telemetry skill says so below its title ("With the Egbe plugin in OpenCode");
|
|
10
|
+
follow it: record `collectors.opencode` with integration `egbe-opencode-plugin`,
|
|
11
|
+
verify after the next turn and stop with `EGBE_SESSION_LOGGING=off`. Do not also
|
|
12
|
+
install the Langfuse plugin below. Without the plugin, continue below.
|
|
13
|
+
|
|
14
|
+
## Without the plugin
|
|
15
|
+
|
|
16
|
+
1. Follow the [Langfuse OpenCode guide](https://langfuse.com/integrations/developer-tools/opencode)
|
|
17
|
+
to install `@langfuse/opencode-observability-plugin`. Check compatibility with
|
|
18
|
+
the installed OpenCode version. Register it in the project configuration:
|
|
19
|
+
use that version's documented plugin field (`plugin` in v1, `plugins` in v2),
|
|
20
|
+
preserving existing entries.
|
|
21
|
+
2. Map the common workflow's selected public and secret values into the plugin's
|
|
22
|
+
native credential configuration or project-scoped launch environment. Its environment uses `LANGFUSE_BASEURL`
|
|
23
|
+
for `<EGBE_TELEMETRY_URL>/ingest/opencode`. Keep settings isolated to this
|
|
24
|
+
project instead of replacing credentials shared by other OpenCode projects.
|
|
25
|
+
3. Restart OpenCode after completing setup. Confirm this process loaded the
|
|
26
|
+
plugin before performing the common delivery check. If no new receipts
|
|
27
|
+
arrive, check plugin loading and effective environment before changing
|
|
28
|
+
credentials; `setup.json` and saved credentials alone do not collect sessions.
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-tools
|
|
3
|
+
description: Call low-level external-provider tools.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use when no higher-level Egbe capability covers the operation."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Video & creative research"
|
|
8
|
+
egbe-description: "Generate videos for your marketing and research competitor creatives through the Meta Ad Library."
|
|
9
|
+
egbe-category: "Marketing & growth"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
<!-- egbe-mcp-connection:v1 -->
|
|
13
|
+
This skill comes with the Egbe plugin. If this project has its own installed copy
|
|
14
|
+
of the skill, use that copy instead. Otherwise make every Egbe API call it
|
|
15
|
+
describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
|
|
16
|
+
PUT, PATCH and DELETE (with `method`). Pass the API path (for example
|
|
17
|
+
`/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
|
|
18
|
+
`egbe-curl.py` and catalog update checks; the connection authenticates and
|
|
19
|
+
identifies the request. Also pass the `business` that `egbe_setup` returned.
|
|
20
|
+
Where this skill sends an `Idempotency-Key` header, pass the same value as
|
|
21
|
+
`idempotency_key` and reuse it when retrying. A result with a `continuation`
|
|
22
|
+
holds one part of a long body; read the next part with `egbe_read`, the same
|
|
23
|
+
`path` and `business`, and that `continuation`.
|
|
24
|
+
Read bundled files beside this `SKILL.md`. For published skill resources on
|
|
25
|
+
Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
|
|
26
|
+
|
|
27
|
+
Publishing works through the connector: commit the app's files with the JSON
|
|
28
|
+
commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
|
|
29
|
+
commit SHA; no git push or workspace setup is needed. A step that needs a local
|
|
30
|
+
project key or a bundled script, such as a local `npx convex deploy`, needs a
|
|
31
|
+
set-up project workspace. In a persistent
|
|
32
|
+
project workspace that is not set up yet, set it up as the `egbe-setup` skill's
|
|
33
|
+
project setup describes.
|
|
34
|
+
Without such a workspace, or if it refuses, tell the founder that this step needs
|
|
35
|
+
an agent with a set-up project folder, and continue with the rest of the work.
|
|
36
|
+
|
|
37
|
+
If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
|
|
38
|
+
available, the plugin's connector is not signed in for this agent. Tell
|
|
39
|
+
the founder how to connect it, as the `egbe-setup` skill describes, rather than
|
|
40
|
+
saying Egbe is unavailable.
|
|
41
|
+
|
|
42
|
+
The connector's tools work even where this environment's shell cannot reach
|
|
43
|
+
Egbe: their calls travel through this agent's connection, not through the
|
|
44
|
+
shell's network. A step that runs in the shell, such as a bundled script, a `git
|
|
45
|
+
push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
|
|
46
|
+
Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
|
|
47
|
+
before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
|
|
48
|
+
the founder: they allow that host in this agent's network settings or continue
|
|
49
|
+
with an agent on their own computer. Code can also be published without the
|
|
50
|
+
shell by committing through the connector (`egbe-os-git`, "Without a terminal").
|
|
51
|
+
Until the shell step or that commit and its deploy succeed, do not report the
|
|
52
|
+
work as published: a preview in this agent or on this computer is not an Egbe
|
|
53
|
+
deployment.
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
# Tools
|
|
57
|
+
|
|
58
|
+
Low-level external capabilities behind one endpoint. Call
|
|
59
|
+
`/tools/{provider}/{path}` with `Authorization: Bearer $OS_API_KEY`; we forward
|
|
60
|
+
to the right provider. List providers with `GET /tools`.
|
|
61
|
+
|
|
62
|
+
Prefer higher-level OS capabilities when they exist:
|
|
63
|
+
|
|
64
|
+
- `/search/skill` for Brave, Perplexity, and Places search
|
|
65
|
+
- `/scrape/skill` for Apify scraping
|
|
66
|
+
- `/images/skill` for image generation
|
|
67
|
+
- `/ads/google/skill`, `/ads/meta/skill`, or `/ads/reddit/skill` for the selected ad channel
|
|
68
|
+
- `/outreach/skill` for Apollo lead sourcing and Instantly campaigns
|
|
69
|
+
|
|
70
|
+
Base URL: `https://os.hz.egbe.dev`.
|
|
71
|
+
|
|
72
|
+
## Web & places search → use `/search`
|
|
73
|
+
|
|
74
|
+
Search has its own capability with one unified result shape. See `GET /search/skill`:
|
|
75
|
+
`POST /search/web/brave`, `POST /search/web/perplexity`, `POST /search/places`.
|
|
76
|
+
|
|
77
|
+
## Generate an image
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/tools/images/generations" -s -X POST \
|
|
81
|
+
-H 'Content-Type: application/json' \
|
|
82
|
+
-d '{"prompt":"a minimalist logo of a fox","size":"1024x1024"}'
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
## Generate a video
|
|
86
|
+
|
|
87
|
+
Talking-head and other long-running video generation goes through the low-level
|
|
88
|
+
tools endpoint:
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/tools/videos/generations" -s -X POST \
|
|
92
|
+
-H 'Content-Type: application/json' \
|
|
93
|
+
-d '{"prompt":"A founder speaks directly to camera about how the product saved hours each week.","duration_seconds":10,"aspect_ratio":"9:16","generate_audio":true}'
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
Poll status:
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/tools/videos/generations/<request_id>?model=fal-ai/kling-video/v2.6/pro/text-to-video" -s
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Upload a completed generated talking-head video into Meta and get `video_id`:
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/tools/videos/generations/<request_id>/meta-upload" -s -X POST \
|
|
106
|
+
-H 'Content-Type: application/json' \
|
|
107
|
+
-d '{"model":"fal-ai/kling-video/v2.6/pro/text-to-video","filename":"03-talking-head.mp4"}'
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
## Scrape the web (Apify)
|
|
111
|
+
|
|
112
|
+
```bash
|
|
113
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/tools/apify/run-sync" -s -X POST \
|
|
114
|
+
-H 'Content-Type: application/json' \
|
|
115
|
+
-d '{"actor":"apify/web-scraper","input":{"startUrls":[{"url":"https://example.com"}]}}'
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
## Meta Ad Library
|
|
119
|
+
|
|
120
|
+
Use this for read-only competitor ad research:
|
|
121
|
+
|
|
122
|
+
```bash
|
|
123
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/tools/meta-ad-library/search" -s -X POST \
|
|
124
|
+
-H 'Content-Type: application/json' \
|
|
125
|
+
-d '{"query":"language learning","countries":["ALL"],"activeStatus":"ALL","adType":"ALL","searchType":"KEYWORD_UNORDERED","limit":50,"sortBy":"none"}'
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
If the upstream Meta app lacks Ad Library permission, treat the research as
|
|
129
|
+
blocked rather than fabricating competitor ads.
|
|
130
|
+
|
|
131
|
+
## Google paid search of a competitor (SpyFu)
|
|
132
|
+
|
|
133
|
+
Read-only Google Ads intelligence for one domain: estimated monthly budget,
|
|
134
|
+
paid clicks and paid keyword count with history, PPC competitors, the
|
|
135
|
+
keywords it buys, its ad copy over time, and keywords shared by up to three
|
|
136
|
+
domains.
|
|
137
|
+
|
|
138
|
+
```bash
|
|
139
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/tools/spyfu/domain-stats" -s -X POST \
|
|
140
|
+
-H 'Content-Type: application/json' \
|
|
141
|
+
-d '{"domain":"competitor.com","country_code":"US","months":12}'
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
Other operations take the same `domain` and `country_code`:
|
|
145
|
+
`ppc-competitors`, `ppc-keywords`, `paid-serps`, `ad-history` (optional
|
|
146
|
+
`keyword`, `since`, `until` as `YYYY-MM-DD`), plus `kombat`
|
|
147
|
+
(`include_domains`, `exclude_domains`, `intersection`) and `keyword-ads`
|
|
148
|
+
(`keyword`). `country_code` is one of 28 markets; `GB` is accepted as `UK`.
|
|
149
|
+
|
|
150
|
+
SpyFu bills every returned row, so ask for the rows you need (`max_rows`,
|
|
151
|
+
default 100, at most 500). Each answer reports `rows_billed` and `cost_usd`.
|
|
152
|
+
The per-claw daily `spyfu:rows` limit counts those rows: near the limit a
|
|
153
|
+
list answer is cut to the rows left and says `limited_by_quota: true`, and
|
|
154
|
+
`domain-stats` answers 429 instead of a shorter history. `has_more` tells
|
|
155
|
+
whether another page exists. `found: false` from `domain-stats` means SpyFu
|
|
156
|
+
has no data for the domain, not zero spend.
|
|
157
|
+
|
|
158
|
+
## Long calls: async mode (DataForSEO, SpyFu)
|
|
159
|
+
|
|
160
|
+
A DataForSEO live call can take up to two minutes, longer than some clients wait
|
|
161
|
+
for one tool call. Through the Egbe connector, add `?async=1` to a
|
|
162
|
+
`/tools/dataforseo/...` or `/tools/spyfu/...` call (`egbe_write` or `egbe_read`
|
|
163
|
+
with query `{"async": "1"}`; the provider body is unchanged). It answers `202`
|
|
164
|
+
with a `job_id` at once. Poll `GET /tools/jobs/<job_id>` (`egbe_read`) about every
|
|
165
|
+
10 seconds until `status` is `succeeded` or `failed`; `result` then holds the
|
|
166
|
+
call's own response (`code`, `message`, `data`), provider errors included. The
|
|
167
|
+
provider call runs and bills once per job. Retry a start with the same
|
|
168
|
+
`idempotency_key` to get the existing job back instead of a second call. Results
|
|
169
|
+
are kept for an hour; a `404` on poll means the job is unknown or expired. Other
|
|
170
|
+
providers have no async mode; OS forwards the flag to them unchanged.
|
|
171
|
+
|
|
172
|
+
## More providers
|
|
173
|
+
|
|
174
|
+
For delegated research or processing with Theona agents, follow
|
|
175
|
+
[Theona runs](references/theona.md): discover the agent, start a run, and
|
|
176
|
+
continue using its returned project-owned handle.
|
|
177
|
+
|
|
178
|
+
`GET /tools` lists the low-level providers. Do not use `/tools/apollo`,
|
|
179
|
+
`/tools/instantly`, or `/tools/*-ads` for normal outreach or ads workflows;
|
|
180
|
+
use `/outreach/skill` or the selected channel's `/ads/{source}/skill` instead.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Theona runs
|
|
2
|
+
|
|
3
|
+
Use the configured `OS_URL` and `Authorization: Bearer $OS_API_KEY` for every
|
|
4
|
+
call. Begin with `GET /tools/theona/agents?search=<task>` and choose a current
|
|
5
|
+
agent by its described capability and required inputs.
|
|
6
|
+
|
|
7
|
+
| Action | Route | Body / query |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| Start | `POST /tools/theona/runs` | `{"agentId":"<selected-id>","input":"<task and bounded inputs>"}` |
|
|
10
|
+
| Status/result | `GET /tools/theona/runs/<runId>` | Optional `wait=true` for long polling |
|
|
11
|
+
| Follow-up | `POST /tools/theona/runs/<runId>/input` | `{"input":"<requested information>"}` |
|
|
12
|
+
| Cancel | `POST /tools/theona/runs/<runId>/cancel` | — |
|
|
13
|
+
| Batch | `POST /tools/theona/runs/batch` | `{"agentId":"<selected-id>","inputs":["<task A>","<task B>"]}` |
|
|
14
|
+
|
|
15
|
+
Retain the returned `runId` (each handle under `runs` for a batch) and poll
|
|
16
|
+
rather than starting the same task again. Supply follow-up input only when the
|
|
17
|
+
run requests it. Report completion from the returned terminal state and result,
|
|
18
|
+
not from successful submission. A batch consumes one run unit per input; use
|
|
19
|
+
only the authorized work and budget.
|
|
20
|
+
|
|
21
|
+
On 429 check `/me/limits?resource=theona` and honor any retry delay. On a timeout
|
|
22
|
+
or uncertain create result, do not blindly resubmit: it may already be running.
|
|
23
|
+
`theona_run_ownership_unconfirmed` requires Egbe team recovery, not another
|
|
24
|
+
create. Reads can be retried after transient failures. A 404 means no run is
|
|
25
|
+
available to this project; an old unregistered handle needs Egbe team recovery.
|
|
26
|
+
Missing provider configuration or OAuth access is a platform blocker.
|