@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,127 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-instantly-campaign-launcher
|
|
3
|
+
description: Prepare, explicitly activate, observe and recover project-owned Instantly email campaigns and reply queues; inspect assigned sender state.
|
|
4
|
+
version: 1.3.5
|
|
5
|
+
user-invocable: true
|
|
6
|
+
metadata:
|
|
7
|
+
egbe-when: "Use for Instantly campaign preparation, activation, replies, observation or recovery."
|
|
8
|
+
egbe-visible: "true"
|
|
9
|
+
egbe-title: "Email outreach"
|
|
10
|
+
egbe-description: "Operate scoped email campaigns, imports, reply queues and factual campaign observations."
|
|
11
|
+
egbe-category: "Marketing & growth"
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
<!-- egbe-mcp-connection:v1 -->
|
|
15
|
+
This skill comes with the Egbe plugin. If this project has its own installed copy
|
|
16
|
+
of the skill, use that copy instead. Otherwise make every Egbe API call it
|
|
17
|
+
describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
|
|
18
|
+
PUT, PATCH and DELETE (with `method`). Pass the API path (for example
|
|
19
|
+
`/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
|
|
20
|
+
`egbe-curl.py` and catalog update checks; the connection authenticates and
|
|
21
|
+
identifies the request. Also pass the `business` that `egbe_setup` returned.
|
|
22
|
+
Where this skill sends an `Idempotency-Key` header, pass the same value as
|
|
23
|
+
`idempotency_key` and reuse it when retrying. A result with a `continuation`
|
|
24
|
+
holds one part of a long body; read the next part with `egbe_read`, the same
|
|
25
|
+
`path` and `business`, and that `continuation`.
|
|
26
|
+
Read bundled files beside this `SKILL.md`. For published skill resources on
|
|
27
|
+
Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
|
|
28
|
+
|
|
29
|
+
Publishing works through the connector: commit the app's files with the JSON
|
|
30
|
+
commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
|
|
31
|
+
commit SHA; no git push or workspace setup is needed. A step that needs a local
|
|
32
|
+
project key or a bundled script, such as a local `npx convex deploy`, needs a
|
|
33
|
+
set-up project workspace. In a persistent
|
|
34
|
+
project workspace that is not set up yet, set it up as the `egbe-setup` skill's
|
|
35
|
+
project setup describes.
|
|
36
|
+
Without such a workspace, or if it refuses, tell the founder that this step needs
|
|
37
|
+
an agent with a set-up project folder, and continue with the rest of the work.
|
|
38
|
+
|
|
39
|
+
If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
|
|
40
|
+
available, the plugin's connector is not signed in for this agent. Tell
|
|
41
|
+
the founder how to connect it, as the `egbe-setup` skill describes, rather than
|
|
42
|
+
saying Egbe is unavailable.
|
|
43
|
+
|
|
44
|
+
The connector's tools work even where this environment's shell cannot reach
|
|
45
|
+
Egbe: their calls travel through this agent's connection, not through the
|
|
46
|
+
shell's network. A step that runs in the shell, such as a bundled script, a `git
|
|
47
|
+
push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
|
|
48
|
+
Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
|
|
49
|
+
before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
|
|
50
|
+
the founder: they allow that host in this agent's network settings or continue
|
|
51
|
+
with an agent on their own computer. Code can also be published without the
|
|
52
|
+
shell by committing through the connector (`egbe-os-git`, "Without a terminal").
|
|
53
|
+
Until the shell step or that commit and its deploy succeed, do not report the
|
|
54
|
+
work as published: a preview in this agent or on this computer is not an Egbe
|
|
55
|
+
deployment.
|
|
56
|
+
|
|
57
|
+
Run a script bundled with this skill from the root of a project folder set up
|
|
58
|
+
for Egbe, with `OS_AGENT_NAME="<your agent name>"` set inline, such as `OpenCode`.
|
|
59
|
+
A script that calls Egbe reads `OS_URL`, `OS_API_KEY` and this agent's connection
|
|
60
|
+
ID from `.env.local` through Egbe's request helper, which comes with the plugin at
|
|
61
|
+
`../egbe-os-quickstart/scripts/egbe-curl.py` from this skill's folder. Where this
|
|
62
|
+
skill says a script needs `OS_URL` or `OS_API_KEY` in its environment, start it
|
|
63
|
+
through the helper, which loads `.env.local` without executing it:
|
|
64
|
+
`python3 <helper> --egbe-run <command>`, with the helper's absolute path. Where
|
|
65
|
+
this skill writes `<skills-directory>`, use the plugin's `skills` folder, which
|
|
66
|
+
holds this skill's folder.
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
# Instantly campaign operations
|
|
70
|
+
|
|
71
|
+
Use the operation the task calls for; preparing a campaign is not authorization
|
|
72
|
+
to activate it, add recipients, reply, or install recurring jobs. Existing
|
|
73
|
+
research, copy, lists and run state are valid inputs. This capability does not
|
|
74
|
+
select a business goal or decide an outcome from reply rate.
|
|
75
|
+
|
|
76
|
+
Requires Node 24+ (`node:sqlite`), `OS_URL` and `OS_API_KEY`. Use the project
|
|
77
|
+
OS connection, not personal provider keys. Missing credentials are a blocker,
|
|
78
|
+
not permission to send cold outreach through Mailu or a trust-domain mailbox.
|
|
79
|
+
|
|
80
|
+
Read only the reference needed for the operation:
|
|
81
|
+
|
|
82
|
+
- [Campaign operations](references/instantly-ops.md): preparation/activation,
|
|
83
|
+
sender selection and state, pagination, date-filtered reads, rendering, verification,
|
|
84
|
+
imports and safe cleanup.
|
|
85
|
+
- [Reply handling](references/reply-handling.md): queue actions, confirmed
|
|
86
|
+
opt-outs, same-thread sends and uncertain-send recovery.
|
|
87
|
+
- [Observation and scheduling](references/observation-and-scheduling.md):
|
|
88
|
+
factual metrics, configured protection, optional jobs and verification.
|
|
89
|
+
- [Run state](references/run-state.md): executable configuration, artifacts,
|
|
90
|
+
identity, handoff and replenishment; includes the [spec scaffold](references/run-spec-template.json).
|
|
91
|
+
|
|
92
|
+
For activation, readiness to continue, or protection recovery, read
|
|
93
|
+
[configured protection](references/observation-and-scheduling.md#configured-operational-protection)
|
|
94
|
+
to check what the bundled monitor supports and what its state actually proves.
|
|
95
|
+
|
|
96
|
+
## Through the Egbe connector
|
|
97
|
+
|
|
98
|
+
Through the connector alone, observe without changing anything: the reads in
|
|
99
|
+
[campaign operations](references/instantly-ops.md#paginated-and-date-filtered-reads)
|
|
100
|
+
with their cursor rules, `GET /outreach/instantly/campaigns/{id}`,
|
|
101
|
+
`/campaigns/{id}/analytics`, `/campaigns/{id}/sending-status`, and the
|
|
102
|
+
assigned-sender and exclusion reads, all below `/outreach/instantly`. Report
|
|
103
|
+
them as provider observations at their read time; they are not the run's
|
|
104
|
+
`outreach.db` history, so do not compute conclusions that need it. Preparation,
|
|
105
|
+
activation, imports, replies, opt-out handling and monitoring run the bundled
|
|
106
|
+
Node scripts against the run's files and `outreach.db`, and need a set-up
|
|
107
|
+
project workspace: in a persistent project workspace not set up yet, call
|
|
108
|
+
`egbe_local_setup`; otherwise tell the founder which step needs it. Do not
|
|
109
|
+
reproduce those writes with raw requests.
|
|
110
|
+
|
|
111
|
+
Keep the owning run under
|
|
112
|
+
`egbe-docs/marketing/campaigns/instantly/<run_key>/`. Before continuing, read its
|
|
113
|
+
manifest and state files and query the project `outreach.db`, next to the run
|
|
114
|
+
directories, only through the read-only `scripts/outreach-report.js`
|
|
115
|
+
([usage](references/observation-and-scheduling.md#collect-facts-for-one-run)).
|
|
116
|
+
If it reports the database missing, say so; do not search the workspace or open
|
|
117
|
+
SQLite with inline code. Bundled scripts treat missing history after sending as a
|
|
118
|
+
blocker, not something to recreate. JSON checkpoints and queue
|
|
119
|
+
files remain active state, not disposable duplicates. Use only the run's
|
|
120
|
+
campaign IDs. Registry/gateway ownership is the tenant authority; local
|
|
121
|
+
manifest/tags narrow the run and detect conflicts, but do not grant access.
|
|
122
|
+
|
|
123
|
+
Commands return observations and operation evidence. Check readbacks and
|
|
124
|
+
incomplete actions before reporting success. Preserve contacts/messages/state
|
|
125
|
+
in the access-controlled project repository, credentials outside Git, and one
|
|
126
|
+
active executor when transferring work. Keep the current plan and decisions in
|
|
127
|
+
the existing project context, without a second preflight/log/lessons package.
|
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
# Campaign operations
|
|
2
|
+
|
|
3
|
+
## Connection and scope
|
|
4
|
+
|
|
5
|
+
Scripts authenticate to `$OS_URL/outreach/instantly/{path}` with
|
|
6
|
+
`Authorization: Bearer $OS_API_KEY`. They use the installed connection-identity
|
|
7
|
+
helper; no provider API key or hosted-agent boot environment is assumed.
|
|
8
|
+
`launch-campaign.js` materializes available credentials and identity in the
|
|
9
|
+
private run `.env` (0600). Workers load that file or an explicit `--env-file`.
|
|
10
|
+
|
|
11
|
+
The gateway exposes project-owned campaigns, their assigned senders, leads and
|
|
12
|
+
campaign emails.
|
|
13
|
+
`GET /accounts` is a shared workspace account list, not tenant-filtered sender
|
|
14
|
+
authorization; read-only keys cannot use it. For an existing campaign's sender
|
|
15
|
+
state, use the scoped read below with either a regular or read-only project key.
|
|
16
|
+
Registry campaign ownership is authoritative. Manifest IDs and run/agent
|
|
17
|
+
tags are local scope/conflict checks; best-effort tag assignment is recorded and
|
|
18
|
+
does not replace server ownership. Never use a name match or tag to adopt another
|
|
19
|
+
project's campaign.
|
|
20
|
+
|
|
21
|
+
The bundled client wraps provider POST/PATCH bodies as `{"payload": {...}}`.
|
|
22
|
+
The semantic exclusion call below uses its own fixed intent body.
|
|
23
|
+
Bodyless activate/pause calls have no body. Use the client or supported scripts;
|
|
24
|
+
raw provider-shaped writes to OS can fail 422.
|
|
25
|
+
|
|
26
|
+
## Paginated and date-filtered reads
|
|
27
|
+
|
|
28
|
+
Paths below are relative to `$OS_URL/outreach/instantly`. The bundled
|
|
29
|
+
`scripts/lib/instantly-client.js` exposes the same reads:
|
|
30
|
+
|
|
31
|
+
| GET path | Query parameters | Client method |
|
|
32
|
+
| --- | --- | --- |
|
|
33
|
+
| `/campaigns` | `limit` (default 100), `starting_after` | `listCampaigns(limit, startingAfter)` |
|
|
34
|
+
| `/accounts` | `limit` (default 100), `starting_after`, `status_filter` | `listAccounts(limit, {starting_after, status_filter})` |
|
|
35
|
+
| `/campaigns/{id}/senders` | None | `campaignSenders(id)` |
|
|
36
|
+
| `/campaigns/{id}/analytics/overview` | `start_date`, `end_date` | `analyticsOverview([id], {start_date, end_date})` |
|
|
37
|
+
|
|
38
|
+
For lists, pass the response's `next_starting_after` unchanged as
|
|
39
|
+
`starting_after` on the next read. Campaign pages are filtered to this project
|
|
40
|
+
after provider pagination: even an empty `items` array can have a next cursor.
|
|
41
|
+
Continue until the cursor is absent; stop and report a repeated cursor or read
|
|
42
|
+
failure instead of claiming the list is complete. For account-list filtering,
|
|
43
|
+
the SDK also accepts `status` as an alias for `status_filter`.
|
|
44
|
+
|
|
45
|
+
Overview dates accept `YYYY-MM-DD` or full ISO 8601 timestamps; date-only values
|
|
46
|
+
mean UTC midnight. For a UTC calendar day, specify explicit bounds such as
|
|
47
|
+
`2026-01-15T00:00:00.000Z` through `2026-01-15T23:59:59.999Z`. The gateway passes
|
|
48
|
+
the supplied strings to Instantly without normalization. Omitting both dates
|
|
49
|
+
retains the lifetime overview. Range-filtered fields include `emails_sent_count`
|
|
50
|
+
and `bounced_count`; keep these observations separate from lifetime totals.
|
|
51
|
+
Invalid ranges return the provider's error, not an empty or lifetime report.
|
|
52
|
+
The campaign ID comes from the owned path, not caller-supplied `id`/`ids`
|
|
53
|
+
parameters. See the [provider overview contract](https://developer.instantly.ai/api-reference/campaign/get-campaigns-analytics-overview).
|
|
54
|
+
|
|
55
|
+
## Read assigned sender state
|
|
56
|
+
|
|
57
|
+
`GET /campaigns/{id}/senders` checks project ownership and reads the campaign's
|
|
58
|
+
current `email_list`; it does not accept sender addresses or domains from the
|
|
59
|
+
caller. It returns only those senders, including inactive ones, with `email`,
|
|
60
|
+
`status`, `daily_limit`, `warmup_status` and `stat_warmup_score`. This is a read
|
|
61
|
+
of campaign assignment, not proof of exclusive ownership of a mailbox.
|
|
62
|
+
|
|
63
|
+
The response contains `campaign_id`, `observed_at` (UTC fetch time), `items` and
|
|
64
|
+
`complete`. Each item has `data_status` (`available`, `partial` or `unavailable`)
|
|
65
|
+
and `missing_fields`; unreadable values stay `null`, with a safe `reason` for a
|
|
66
|
+
failed account read. `complete` means data coverage, not healthy senders or
|
|
67
|
+
permission to send. An empty explicit assignment is not a healthy sending pool.
|
|
68
|
+
Reads have a shared 20-second budget (below the OS proxy timeout); slow or
|
|
69
|
+
unfinished reads stay unavailable while completed observations are preserved.
|
|
70
|
+
Tag-based assignment is not expanded: `sender_tag_assignment_unresolved` keeps
|
|
71
|
+
`complete: false`, even if all explicitly assigned senders were read.
|
|
72
|
+
|
|
73
|
+
Missing/malformed campaign assignment returns an error rather than an empty
|
|
74
|
+
success. Preserve unknowns; do not fall back to the shared `/accounts` list or
|
|
75
|
+
another key to turn incomplete data into a successful check.
|
|
76
|
+
|
|
77
|
+
## Prepare or activate an existing run
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
node "$SKILL_DIR/scripts/launch-campaign.js" --run-spec "$RUN_DIR/run-spec.json"
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
See [run-state](run-state.md) for the spec and paths. The launcher validates the
|
|
84
|
+
input, resolves specified senders, creates/reuses its campaign, uploads rendered
|
|
85
|
+
sequence and missing leads, checks import/verification, and writes state.
|
|
86
|
+
Preparation defaults to a non-activated draft. Activation occurs only with
|
|
87
|
+
`campaign.activate_on_launch: true`, after the applicable decision and gates.
|
|
88
|
+
A rerun does not mean a new experiment: it resumes the manifest. A genuinely new
|
|
89
|
+
test needs a new run identity, even if the audience and offer are the same.
|
|
90
|
+
|
|
91
|
+
The launcher fingerprints rendered sequence plus senders. A changed fingerprint
|
|
92
|
+
requires an intentional `--allow-sequence-update`; do not add this flag merely
|
|
93
|
+
to silence drift on an existing campaign. Use supported rendering when updating:
|
|
94
|
+
raw `{{senderName}}` in a provider patch is not a provider variable.
|
|
95
|
+
Skill version 1.3.5 fixed step rendering for links followed by punctuation or
|
|
96
|
+
`**`, `&` in a query, `mailto:`/`tel:` links, parentheses in a markdown URL,
|
|
97
|
+
schemeless or relative markdown targets and `<...>` in plain text. Drift that
|
|
98
|
+
comes only from those rendering fixes on a campaign prepared with an earlier
|
|
99
|
+
version is an intended update: rerun with `--allow-sequence-update`.
|
|
100
|
+
|
|
101
|
+
Create/import calls are not blindly replayed after uncertain outcomes. On a
|
|
102
|
+
create timeout/5xx, inspect scoped campaign IDs and creation times before retrying.
|
|
103
|
+
For an uncertain import, a complete live membership read establishes what is
|
|
104
|
+
missing; malformed, unavailable or incomplete membership stops the import.
|
|
105
|
+
Keep manifests, hashes and carry-over files through recovery.
|
|
106
|
+
|
|
107
|
+
## Senders, sequence and payload checks
|
|
108
|
+
|
|
109
|
+
Specify exactly one of `campaign.email_list` (owned exact addresses) or
|
|
110
|
+
`campaign.sender_domains` (owned cold domains). Named missing/inactive accounts
|
|
111
|
+
fail. Domain-selected accounts are sorted and may be limited by
|
|
112
|
+
`max_sending_accounts`. The launcher excludes `egbe.app` and `egbe.dev` trust
|
|
113
|
+
domains and fails if no eligible sender remains. This is a client-side safeguard;
|
|
114
|
+
the shared account listing is not a server-side proof of sender ownership.
|
|
115
|
+
|
|
116
|
+
Use a true sender identity. `reply_policy.sender_name` or `sender_name` takes
|
|
117
|
+
precedence over the selected account's recorded name; the code does not infer a
|
|
118
|
+
person from an email local part. If `{{senderName}}` is used, an explicit or
|
|
119
|
+
recorded account name is required. It is compiled once, not per sending account:
|
|
120
|
+
with rotating senders verify it is truthful for every mailbox (the launcher
|
|
121
|
+
warns). Unknown names must not be invented.
|
|
122
|
+
|
|
123
|
+
Plain text bodies become Instantly editor-native HTML: each line is a `<div>`,
|
|
124
|
+
blank lines are `<div><br /></div>`. Markdown links and bare URLs are rendered
|
|
125
|
+
with run UTMs in hrefs, while visible text stays readable. Review the rendered
|
|
126
|
+
output rather than manually copying unrendered spec text to provider PATCH.
|
|
127
|
+
|
|
128
|
+
Empty subjects on later steps continue the preceding thread; a nonempty subject
|
|
129
|
+
chooses a new thread. Either is supported. `delay_days` is the wait before that
|
|
130
|
+
step; the launcher maps it to the preceding provider step's delay. A delay on
|
|
131
|
+
step one is ignored with a warning; use the campaign schedule for a delayed start.
|
|
132
|
+
The final provider delay has no following step.
|
|
133
|
+
|
|
134
|
+
Used merge variables must resolve for every new lead. Missing/unresolved values
|
|
135
|
+
are payload errors; unusual capitalization, short names or long company names
|
|
136
|
+
are review warnings, not proof that real data is invalid. Exact title/credential
|
|
137
|
+
tokens used as first names (such as Dr or CA) are rejected unless the actual name
|
|
138
|
+
has been checked and marked `first_name_confirmed: true`. No merge token, fixed
|
|
139
|
+
sequence length or first-message link ban is required. Placeholder CTA URLs
|
|
140
|
+
(`example.com`, `*.example`, unreplaced product/instance tokens) still fail.
|
|
141
|
+
|
|
142
|
+
`campaign.daily_limit` is an explicit positive campaign-wide cap, not a minimum
|
|
143
|
+
recommended volume or inferred per-mailbox capacity. Validate the selected
|
|
144
|
+
schedule, nonempty sending days and timezone. The launcher maps its known
|
|
145
|
+
`America/New_York` alias to `America/Detroit` with a warning because of the
|
|
146
|
+
provider's enum; a valid IANA zone alone does not prove provider acceptance.
|
|
147
|
+
Read back the campaign's actual schedule and sender assignment.
|
|
148
|
+
|
|
149
|
+
`open_tracking` and `link_tracking` default off; either can be explicitly set.
|
|
150
|
+
`stop_on_reply`, `stop_on_auto_reply` and `insert_unsubscribe_header` default
|
|
151
|
+
true. Activation requires confirmed readback of the configured safeguards;
|
|
152
|
+
missing readback is not success. Known opt-outs and unknown project history also
|
|
153
|
+
block unsafe import/send/activation; see [reply handling](reply-handling.md).
|
|
154
|
+
|
|
155
|
+
## Import verification
|
|
156
|
+
|
|
157
|
+
Source status is not import verification. By default the launcher uploads with
|
|
158
|
+
verification enabled and waits before activation. It reads campaign
|
|
159
|
+
`lead_stats`, falling back to per-lead `verification_status` across the whole
|
|
160
|
+
campaign; imported but not yet visible leads remain pending. Valid is status 1;
|
|
161
|
+
-1 is invalid; 11/12 pending; other verification codes count as invalid/risky.
|
|
162
|
+
Missing/null read surfaces are not a successful zero.
|
|
163
|
+
|
|
164
|
+
Current execution settings (these are adjustable client defaults, not market
|
|
165
|
+
success thresholds):
|
|
166
|
+
|
|
167
|
+
| Setting | Current default / meaning |
|
|
168
|
+
| --- | --- |
|
|
169
|
+
| `verify_leads_on_import` | true; asks provider to verify |
|
|
170
|
+
| `wait_for_verification` | true; blocking wait gate, distinct from requesting verification |
|
|
171
|
+
| `max_invalid_lead_pct` | 5 percent invalid/risky; records rejected IDs/addresses |
|
|
172
|
+
| `verification_timeout_minutes` | 45 |
|
|
173
|
+
| `verification_stuck_polls` | 8 unchanged polls |
|
|
174
|
+
| `allow_unverified_activation` | false; explicit override of incomplete verification, not other safeguards |
|
|
175
|
+
|
|
176
|
+
The older `verify_leads` field is a fallback for the two verification flags.
|
|
177
|
+
Do not change either flag as an automatic workaround. Pending/unread verification
|
|
178
|
+
normally leaves the campaign unactivated with exit 2 and
|
|
179
|
+
`verification_pending` / `verification_unread` in the launch result.
|
|
180
|
+
Read `launch-summary.json` and `state/verification-state.json`; rerun the same
|
|
181
|
+
run when its state can be checked. A readable empty provider lead list after an
|
|
182
|
+
import is an import failure, not merely a stuck verifier.
|
|
183
|
+
|
|
184
|
+
If the invalid percentage exceeds the configured value, inspect
|
|
185
|
+
`state/invalid-leads.json`. After deliberately removing unwanted entries from
|
|
186
|
+
the source list, a rerun attempts eligible deletion and records
|
|
187
|
+
`state/deleted-leads.json`, removes deleted entries from carry-over, then
|
|
188
|
+
rechecks the whole campaign. Failed/unknown cleanup blocks activation.
|
|
189
|
+
|
|
190
|
+
Success requires provider readback: activation response alone does not establish
|
|
191
|
+
that the campaign is active. Inspect `activation.confirmed`, `launch_status`,
|
|
192
|
+
verification outcome and safeguard readbacks. Creating a draft is not sending.
|
|
193
|
+
A preparation-only rerun is not itself a pause request: inspect `actual_state` /
|
|
194
|
+
`campaign_status`, not the absence of a new activation request. Confirmed-refusal
|
|
195
|
+
protection still applies when membership is unreadable. Its attempts and readbacks
|
|
196
|
+
remain in `opt_out_stop_results` even if the launcher subsequently exits with an error.
|
|
197
|
+
|
|
198
|
+
## Narrow cleanup and correction
|
|
199
|
+
|
|
200
|
+
These existing gateway operations are project-scoped; foreign objects return
|
|
201
|
+
404. Do not bypass a refusal by directly calling Instantly.
|
|
202
|
+
|
|
203
|
+
- `DELETE /campaigns/{id}`: only draft status 0 with demonstrated zero sends.
|
|
204
|
+
Returns 409 `campaign_not_draft`, `campaign_has_sends` or
|
|
205
|
+
`campaign_sends_unknown` otherwise.
|
|
206
|
+
- `DELETE /leads/{id}`: only never-contacted leads. Activity counters/timestamps
|
|
207
|
+
or nonzero interest block with `lead_contacted`; absent activity evidence
|
|
208
|
+
blocks with `lead_contact_unknown`. A status label alone is insufficient.
|
|
209
|
+
- `PATCH /leads/{id}`: only first/last name, company, website, personalization
|
|
210
|
+
and custom variables. Changing email/campaign/status is unsupported.
|
|
211
|
+
- Pause an owned campaign that has sent; retain its replies and history.
|
|
212
|
+
|
|
213
|
+
Campaign delete and lead patch consume update quota. Lead deletion uses its own
|
|
214
|
+
resource (Registry default 500/day); project configuration controls the current
|
|
215
|
+
limit. Pause is not blocked by campaign-update quota. A cleanup timeout/5xx may
|
|
216
|
+
already have changed the provider: read back before repeating. Cleanup is not
|
|
217
|
+
recipient suppression and does not erase confirmed opt-out events.
|
|
218
|
+
|
|
219
|
+
|
|
220
|
+
## Recipient exclusion
|
|
221
|
+
|
|
222
|
+
Relative to `$OS_URL/outreach/instantly`:
|
|
223
|
+
|
|
224
|
+
- `GET /campaigns/{campaign_id}/leads/{lead_id}/exclusion` reads fresh owned
|
|
225
|
+
evidence. It is available with `outreach:read` / project read access.
|
|
226
|
+
- `POST` to the same resource accepts only `{"intent":"confirmed_opt_out"}`.
|
|
227
|
+
It requires existing privileged outreach writer access; read-only keys cannot
|
|
228
|
+
mutate. The bundled client exposes `getRecipientExclusion` and `excludeRecipient`.
|
|
229
|
+
|
|
230
|
+
Tools checks Registry campaign ownership before native lead access and verifies
|
|
231
|
+
ID/campaign identity. In the supported profile it sets only native
|
|
232
|
+
`lt_interest_status=-1` via exact lead-ID PATCH and verifies Completed (3) /
|
|
233
|
+
Not Interested (-1). Reply/contact/history data remain retained. Existing generic
|
|
234
|
+
lead PATCH stays limited to personalization. This safety operation, like scoped
|
|
235
|
+
pause, is independent of the ordinary campaign-update quota.
|
|
236
|
+
|
|
237
|
+
Inspect `state`: `confirmed` is observed native main-sequence exclusion;
|
|
238
|
+
`eligible` is a GET result that still needs action; `unsupported`, `rejected` and
|
|
239
|
+
`unknown` do not authorize resuming. `scope`, `observed_at`, `lead_status`,
|
|
240
|
+
`interest_status` and `write_attempted` describe the bounded observation, not
|
|
241
|
+
permanent suppression. The initial profile requires complete empty subsequences,
|
|
242
|
+
automation and webhook collections; an omitted lead attachment field by itself
|
|
243
|
+
is insufficient. Global collection details are never returned to the project.
|
|
244
|
+
|
|
245
|
+
There is no fallback to email-based interest updates (which can propagate to
|
|
246
|
+
other campaigns), a global blocklist, deletion or activation. A timeout/5xx may
|
|
247
|
+
follow a committed PATCH: use GET for recovery before considering another write.
|
|
248
|
+
Neither the client nor Tools automatically retries that write. HTTP success
|
|
249
|
+
without `state: confirmed` is not proof. Read failures expose safe status and
|
|
250
|
+
bounded numeric `retry_after` where available, without provider response bodies.
|
|
251
|
+
The shared request deadline is 22 seconds, including ownership; native attempts
|
|
252
|
+
are bounded to 5 seconds each. This does not cancel queued/in-flight mail or
|
|
253
|
+
qualify active subsequences; retain containment for unverified cases.
|
|
254
|
+
|
|
255
|
+
`listLeadRows` and `listLeadEmails` follow native continuation even on short pages,
|
|
256
|
+
reject invalid identity/duplicate IDs/repeated cursors and report incomplete reads
|
|
257
|
+
as `ok: false`. Multiple same-email IDs are retained and assessed individually.
|
|
258
|
+
Legacy responses without an explicit cursor use last-ID continuation on full
|
|
259
|
+
pages; they do not gain a recipient-exclusion exception without new semantic
|
|
260
|
+
readback. The old/new server transition therefore remains contained.
|
|
@@ -0,0 +1,188 @@
|
|
|
1
|
+
# Observation, protection and scheduling
|
|
2
|
+
|
|
3
|
+
## Collect facts for one run
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
node "$SKILL_DIR/scripts/monitor-campaign.js" --run-dir "$RUN_DIR" --env-file "$RUN_DIR/.env"
|
|
7
|
+
node "$SKILL_DIR/scripts/conclude-campaign.js" --run-dir "$RUN_DIR"
|
|
8
|
+
node "$SKILL_DIR/scripts/outreach-report.js" --run-dir "$RUN_DIR" --run-key RUN_KEY --mode summary
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
Monitor reads only the manifest campaign, writes `monitor-summary.json` and
|
|
12
|
+
appends cumulative snapshots to `state/analytics-history.json`. It preserves
|
|
13
|
+
source/quality and `metrics_observed_at` separately from packaging
|
|
14
|
+
`generated_at`. Do not sum cumulative snapshots or call a newly packaged old
|
|
15
|
+
snapshot fresh evidence.
|
|
16
|
+
|
|
17
|
+
For mailbox state and warmup, use the [assigned sender read](instantly-ops.md#read-assigned-sender-state).
|
|
18
|
+
It is available to regular and read-only project keys; it does not install a
|
|
19
|
+
warmup-based pause control in the bundled monitor.
|
|
20
|
+
|
|
21
|
+
`outreach-report` reads project SQLite and returns a JSON array of rows.
|
|
22
|
+
Modes are `summary`, `leads`, `queue` and `events`, with optional `--limit`,
|
|
23
|
+
`--run-key` and `--db`. `--run-dir` selects the project DB; add `--run-key`
|
|
24
|
+
when you need a particular run, because the DB contains multiple runs.
|
|
25
|
+
The summary attributes confirmed refusals to the run where they were received,
|
|
26
|
+
without counting repeated confirmations twice. The leads view separately exposes
|
|
27
|
+
project-wide `opt_out_confirmed`; this is not proof that provider sending stopped.
|
|
28
|
+
|
|
29
|
+
Current derived reply/bounce/unsubscribe/spam/open rates use a campaign-scoped
|
|
30
|
+
unique `contacted_count` as denominator, expressed in percent. Keep raw numerators
|
|
31
|
+
and that definition with any comparison. Positive reply count is a provider
|
|
32
|
+
classification, not proof of qualified demand. Step-reply values are counts,
|
|
33
|
+
not automatically rates; the last step is not assumed to be a breakup.
|
|
34
|
+
|
|
35
|
+
Analytics and campaign-filtered overview fill missing fields independently;
|
|
36
|
+
missing complaint data does not erase readable zero bounces. Field sources are
|
|
37
|
+
recorded in `_field_sources` and retained in conclusion quality details. A
|
|
38
|
+
complete observation can still have missing metrics; each rate needs its own
|
|
39
|
+
readable numerator and a trustworthy denominator.
|
|
40
|
+
|
|
41
|
+
Instantly's raw `contacted_count` can exceed campaign membership or conflict
|
|
42
|
+
with sending activity. The monitor retains that raw value for diagnosis and
|
|
43
|
+
recovers unique contacts only from a complete, identity-consistent lead read
|
|
44
|
+
with known contact activity that agrees with cumulative
|
|
45
|
+
`new_leads_contacted_count`. Present membership alone does not establish the
|
|
46
|
+
historical population: a mismatch, partial read or unknown activity leaves the
|
|
47
|
+
denominator unavailable. This does not prove workspace-wide data leakage.
|
|
48
|
+
|
|
49
|
+
Unknown metrics stay unknown. An email-list fallback is a bounded partial
|
|
50
|
+
sample and cannot supply complete bounce/spam/open signals or trustworthy
|
|
51
|
+
rate denominators. It is used when analytics is unavailable, or when actual
|
|
52
|
+
messages contradict the established all-zero/degraded analytics signature;
|
|
53
|
+
sampled replies are never merged into otherwise complete campaign totals.
|
|
54
|
+
A scoped zero recipients/zero events observation means no data yet, not an API
|
|
55
|
+
outage. Tracking disabled means no measured opens, not a measured zero.
|
|
56
|
+
|
|
57
|
+
The collector `conclude-campaign.js` packages the latest snapshot as
|
|
58
|
+
`conclusion.json` for the existing GTM consumer. The filename is retained,
|
|
59
|
+
but collection does not finish a campaign or wait for a prescribed sequence age.
|
|
60
|
+
It preserves identity/attribution, observation time/window, counters,
|
|
61
|
+
denominators, partial/unknown/scope limitations and missing fields. It does not
|
|
62
|
+
compute a verdict, fabricate lessons, change DB lifecycle to concluded, or infer
|
|
63
|
+
cohort maturity from the launch date. `--force` does not refresh stale data or
|
|
64
|
+
improve quality. Put the actual interpretation and accepted action in the
|
|
65
|
+
existing plan/result, not a second assessment JSON.
|
|
66
|
+
|
|
67
|
+
For product-side outcomes, use the OS analytics capability when available and
|
|
68
|
+
the run's `utm_source=instantly`, `utm_medium=email`,
|
|
69
|
+
`utm_campaign=<run_key>`. Read canonical product event names from
|
|
70
|
+
`/analytics/events`; do not invent run-specific conversion names or claim this
|
|
71
|
+
collector automatically retrieves product events. A reply counter and a product
|
|
72
|
+
action are different observations.
|
|
73
|
+
|
|
74
|
+
## Configured operational protection
|
|
75
|
+
|
|
76
|
+
Protection is separate from business evaluation. `monitoring.autopause_on_risk`
|
|
77
|
+
defaults true. Activation requires a valid explicit
|
|
78
|
+
`monitoring.thresholds.max_bounce_rate` (percentage 0–100).
|
|
79
|
+
`max_spam_complaint_rate` is optional and should be configured only when its
|
|
80
|
+
signal is available. The bundled monitor compares cumulative campaign bounce/spam
|
|
81
|
+
counts to unique `contacted_count`, as percentages, using strictly `>` with no
|
|
82
|
+
minimum sample. Use the run's accepted thresholds; the code supplies no universal
|
|
83
|
+
marketing threshold.
|
|
84
|
+
|
|
85
|
+
The bundled monitor has no configurable sent-message denominator, calendar-day
|
|
86
|
+
bounce-count gate, assigned-sender warmup status/score gate or timed missing-signal
|
|
87
|
+
grace period. Sender selection checks account activity, not ongoing warmup health.
|
|
88
|
+
Available reads or extra `run-spec.json` keys do not implement those controls.
|
|
89
|
+
Identify unsupported required conditions explicitly; do not represent a different
|
|
90
|
+
supported check as equivalent.
|
|
91
|
+
|
|
92
|
+
`monitor-summary.json.protection.active` means the supported threshold configuration
|
|
93
|
+
validates, not that autopause is enabled, every requested condition is enforced,
|
|
94
|
+
or scheduled observation is running. Keep these distinctions when reporting readiness.
|
|
95
|
+
|
|
96
|
+
With protection enabled, a configured threshold exceeded or a required signal
|
|
97
|
+
unavailable after bounded read attempts/fallbacks triggers scoped protective
|
|
98
|
+
pause. Missing configuration is not a healthy monitor result; it blocks
|
|
99
|
+
automatic activation and surfaces as a configuration risk on an existing run.
|
|
100
|
+
Explicitly disabling autopause is a run choice, not an accidental consequence
|
|
101
|
+
of an omitted field.
|
|
102
|
+
|
|
103
|
+
Open rate never triggers pause. The supported Instantly campaign analytics
|
|
104
|
+
routes currently expose no complaint/spam counter. An unconfigured complaint
|
|
105
|
+
threshold is listed as not monitored. If the run explicitly requires it and
|
|
106
|
+
the signal is absent, `spam_unavailable` still triggers protection; changing
|
|
107
|
+
that requirement needs the run's authorized decision. Refreshing this skill
|
|
108
|
+
does not change thresholds or resume a paused campaign. Partial/unknown required
|
|
109
|
+
signals cannot clear an earlier risk. No-recipient/zero-count observations skip
|
|
110
|
+
rate evaluation without declaring an outage.
|
|
111
|
+
|
|
112
|
+
Pause success requires readback. `pause_action` is an attempt;
|
|
113
|
+
`pause_failed` or unconfirmed readback requires attention. Already-paused,
|
|
114
|
+
draft and completed campaigns are not repeatedly paused. Alert state in
|
|
115
|
+
`state/monitor-alerts.json` distinguishes new/repeated incidents. A confirmed
|
|
116
|
+
operator resume acknowledges a prior numeric gate, not unknown data; material
|
|
117
|
+
worsening/new complaints/new gates can alert and pause again. Do not remove
|
|
118
|
+
the checkpoint just to suppress an alert.
|
|
119
|
+
|
|
120
|
+
Throughput compares comparable full snapshots against the run's explicit daily
|
|
121
|
+
cap. `monitoring.min_daily_capacity_pct` is optional; absent configuration or
|
|
122
|
+
incomplete metrics means no automatic throughput judgment. The monitor does
|
|
123
|
+
not auto-pause merely for slow sending or automatically increase spending,
|
|
124
|
+
mailboxes or recipients. Treat diagnostic hints as checks, not proven causes.
|
|
125
|
+
|
|
126
|
+
## Optional scheduler installation
|
|
127
|
+
|
|
128
|
+
Use scheduled workers only for the agreed operating arrangement. Manual
|
|
129
|
+
observation remains possible; record who handles observation and replies.
|
|
130
|
+
Installing a scheduler is not part of every operation, and four jobs are not
|
|
131
|
+
universally required.
|
|
132
|
+
|
|
133
|
+
```bash
|
|
134
|
+
node "$SKILL_DIR/scripts/install-crons.js" --check-scheduler --scheduler openclaw
|
|
135
|
+
node "$SKILL_DIR/scripts/install-crons.js" --run-dir "$RUN_DIR" --scheduler openclaw \
|
|
136
|
+
--deliver-channel slack --deliver-to channel:CHANNEL_ID
|
|
137
|
+
node "$SKILL_DIR/scripts/install-crons.js" --run-dir "$RUN_DIR" --scheduler cron
|
|
138
|
+
node "$SKILL_DIR/scripts/install-crons.js" --run-dir "$RUN_DIR" --scheduler cron --remove
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
These commands create/remove recurring external work when actually run; choose
|
|
142
|
+
them explicitly. `--dry-run` previews installer output, not live sourcing or
|
|
143
|
+
campaign execution. Credentials are read from the private run snapshot, never
|
|
144
|
+
embedded in scheduler entries; explicit `--env-file` supplies them without
|
|
145
|
+
modifying that source file. The installer enforces run `.env` permissions.
|
|
146
|
+
|
|
147
|
+
- `openclaw` (default) runs agent turns. It needs a deliver-channel/to pair
|
|
148
|
+
(CLI or `notifications` config), or explicit `--no-chat-delivery`; isolated
|
|
149
|
+
jobs have no implicit last chat. It selects the agent owning the run workspace,
|
|
150
|
+
else the host default; `--agent` selects explicitly. Review recorded agent
|
|
151
|
+
identity before reinstall/moving a run.
|
|
152
|
+
Reply turns read the current project email method and plan before content
|
|
153
|
+
decisions; technical references govern queue/send execution.
|
|
154
|
+
- `cron` runs Node directly on an always-on host, in the host timezone.
|
|
155
|
+
Reply collection is not reasoning or automatic reply handling. Identify the
|
|
156
|
+
person/agent that reads the queue; a sleeping laptop is not an always-on host.
|
|
157
|
+
- The Unix scheduler check executes a temporary harmless probe and removes it.
|
|
158
|
+
Default wait is 75 seconds; the accepted override
|
|
159
|
+
`--scheduler-check-timeout-seconds` is 65–120. A writable crontab alone is
|
|
160
|
+
insufficient evidence of execution.
|
|
161
|
+
|
|
162
|
+
The current installer includes reply and monitor jobs. OpenClaw uses the sending
|
|
163
|
+
window plus one hour before/two hours after, on campaign days/timezone:
|
|
164
|
+
reply hourly at :05, monitor at :15. If no usable schedule exists it records the
|
|
165
|
+
24/7 UTC fallback. Direct Unix cron uses hourly host-time cadence.
|
|
166
|
+
|
|
167
|
+
Replenishment is installed only for `lead_replenishment.enabled: true`, every
|
|
168
|
+
two hours at :45; the operation itself enforces the configured cooldown/bounds.
|
|
169
|
+
A factual-export job is added only when `monitoring.snapshot_schedule` is
|
|
170
|
+
provided. Its cadence is explicit, not a claim that a test is ready for a verdict.
|
|
171
|
+
|
|
172
|
+
Registration is scoped by `instantly-<run_key>-<job>` and exact run directory.
|
|
173
|
+
OpenClaw reuses/edits existing job IDs and removes jobs omitted from the new
|
|
174
|
+
configuration, verifying their exact run directory and removal. Unix cron replaces
|
|
175
|
+
only this run's marked block and preserves unrelated entries. The installer rereads registration and
|
|
176
|
+
records verified IDs/settings in `cron-install.json` and manifest `cron_jobs`.
|
|
177
|
+
Registration readback is not evidence that every later tick or reply succeeded.
|
|
178
|
+
|
|
179
|
+
Installation failure returns nonzero, with `installed: false` and manual
|
|
180
|
+
commands/cadences when supported. Do not announce automation as working then.
|
|
181
|
+
Before switching schedulers, remove through the recorded scheduler and verify
|
|
182
|
+
removal. The receipt supports removal even if the manifest is damaged; keep it
|
|
183
|
+
until removal is confirmed. `launchd` is not supported.
|
|
184
|
+
|
|
185
|
+
Direct cron ticks use per-job locks and bounded execution; inspect
|
|
186
|
+
`cron-<job>.log`. Stale locks fail closed. Verify no tick/installer is alive
|
|
187
|
+
before removing only the identified stale lock and retrying. Keep one executor
|
|
188
|
+
and the same absolute bundle/run/Node paths on the scheduler host.
|