@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.
Files changed (479) hide show
  1. package/LICENSE +4 -0
  2. package/README.md +124 -2
  3. package/index.js +5 -0
  4. package/package.json +55 -4
  5. package/plugin.js +230 -0
  6. package/session-log.js +315 -0
  7. package/skills/.egbe-catalog/manifest.json +1 -0
  8. package/skills/egbe-os-analytics/SKILL.md +499 -0
  9. package/skills/egbe-os-analytics/canonical-events.v1.json +256 -0
  10. package/skills/egbe-os-analytics/references/session-funnel.md +130 -0
  11. package/skills/egbe-os-analytics/references/workflows/activation-tracking.md +147 -0
  12. package/skills/egbe-os-analytics/references/workflows/landing-click-tracking.md +209 -0
  13. package/skills/egbe-os-analytics/references/workflows/payment-lifecycle-tracking.md +122 -0
  14. package/skills/egbe-os-analytics/references/workflows/product-funnel-tracking.md +77 -0
  15. package/skills/egbe-os-analytics/references/workflows/signup-lifecycle-tracking.md +208 -0
  16. package/skills/egbe-os-analytics/scripts/umami_funnel.py +927 -0
  17. package/skills/egbe-os-apollo-lead-finder/SKILL.md +135 -0
  18. package/skills/egbe-os-apollo-lead-finder/references/operations.md +240 -0
  19. package/skills/egbe-os-apollo-lead-finder/scripts/enrich.js +6 -0
  20. package/skills/egbe-os-apollo-lead-finder/scripts/enrich.sh +4 -0
  21. package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.js +6 -0
  22. package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.sh +4 -0
  23. package/skills/egbe-os-apollo-lead-finder/scripts/lib/apollo-client.js +343 -0
  24. package/skills/egbe-os-apollo-lead-finder/scripts/lib/connection-identity.js +17 -0
  25. package/skills/egbe-os-apollo-lead-finder/scripts/lib/helpers.js +127 -0
  26. package/skills/egbe-os-apollo-lead-finder/scripts/lib/places-filters.js +217 -0
  27. package/skills/egbe-os-apollo-lead-finder/scripts/lib/sourcing.js +153 -0
  28. package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.js +653 -0
  29. package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.sh +4 -0
  30. package/skills/egbe-os-apollo-lead-finder/scripts/search.js +6 -0
  31. package/skills/egbe-os-apollo-lead-finder/scripts/search.sh +4 -0
  32. package/skills/egbe-os-campaign-landing-page/SKILL.md +95 -0
  33. package/skills/egbe-os-campaign-landing-page/agents/openai.yaml +4 -0
  34. package/skills/egbe-os-campaign-landing-page/references/leads-calendar-and-tracking.md +66 -0
  35. package/skills/egbe-os-campaign-landing-page/references/os-wiring.md +58 -0
  36. package/skills/egbe-os-campaign-landing-page/references/qa.md +40 -0
  37. package/skills/egbe-os-campaign-landing-page/references/routing.md +32 -0
  38. package/skills/egbe-os-db/SKILL.md +174 -0
  39. package/skills/egbe-os-deploy/SKILL.md +412 -0
  40. package/skills/egbe-os-design/SKILL.md +182 -0
  41. package/skills/egbe-os-design-landing-page/SKILL.md +117 -0
  42. package/skills/egbe-os-design-landing-page/agents/openai.yaml +4 -0
  43. package/skills/egbe-os-design-landing-page/assets/scaffold/.dockerignore +11 -0
  44. package/skills/egbe-os-design-landing-page/assets/scaffold/AGENTS.md +31 -0
  45. package/skills/egbe-os-design-landing-page/assets/scaffold/Dockerfile +21 -0
  46. package/skills/egbe-os-design-landing-page/assets/scaffold/eslint.config.mjs +18 -0
  47. package/skills/egbe-os-design-landing-page/assets/scaffold/next.config.ts +11 -0
  48. package/skills/egbe-os-design-landing-page/assets/scaffold/package.json +36 -0
  49. package/skills/egbe-os-design-landing-page/assets/scaffold/postcss.config.mjs +7 -0
  50. package/skills/egbe-os-design-landing-page/assets/scaffold/public/.gitkeep +1 -0
  51. package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.edge.config.ts +13 -0
  52. package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.server.config.ts +13 -0
  53. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/global-error.tsx +19 -0
  54. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/globals.css +22 -0
  55. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/layout.tsx +21 -0
  56. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/page.tsx +3 -0
  57. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/privacy/page.tsx +28 -0
  58. package/skills/egbe-os-design-landing-page/assets/scaffold/src/components/egbe-analytics.tsx +39 -0
  59. package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation-client.ts +15 -0
  60. package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation.ts +13 -0
  61. package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/egbe-observability.generated.ts +20 -0
  62. package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/utils.ts +6 -0
  63. package/skills/egbe-os-design-landing-page/assets/scaffold/tsconfig.json +34 -0
  64. package/skills/egbe-os-design-landing-page/references/application-preparation.md +44 -0
  65. package/skills/egbe-os-design-landing-page/references/page-inputs.md +22 -0
  66. package/skills/egbe-os-destination-readiness/SKILL.md +132 -0
  67. package/skills/egbe-os-destination-readiness/references/checks.md +130 -0
  68. package/skills/egbe-os-destination-readiness/references/network-requirements.md +34 -0
  69. package/skills/egbe-os-destination-readiness/references/report.md +116 -0
  70. package/skills/egbe-os-domains/SKILL.md +189 -0
  71. package/skills/egbe-os-errors/SKILL.md +259 -0
  72. package/skills/egbe-os-git/SKILL.md +275 -0
  73. package/skills/egbe-os-git/references/issues.md +33 -0
  74. package/skills/egbe-os-google-ads/SKILL.md +163 -0
  75. package/skills/egbe-os-google-ads/references/artifacts.md +133 -0
  76. package/skills/egbe-os-google-ads/references/campaigns.md +157 -0
  77. package/skills/egbe-os-google-ads/references/conversions.md +153 -0
  78. package/skills/egbe-os-google-ads/references/delivery.md +128 -0
  79. package/skills/egbe-os-google-ads/references/keyword-ideas.md +40 -0
  80. package/skills/egbe-os-google-ads/references/reporting.md +105 -0
  81. package/skills/egbe-os-google-ads/references/search-assets.md +219 -0
  82. package/skills/egbe-os-google-ads/references/server-conversions.md +119 -0
  83. package/skills/egbe-os-google-auth/SKILL.md +285 -0
  84. package/skills/egbe-os-google-auth/agents/openai.yaml +4 -0
  85. package/skills/egbe-os-gtm-knowledge/SKILL.md +151 -0
  86. package/skills/egbe-os-images/SKILL.md +163 -0
  87. package/skills/egbe-os-images/references/stock-images.md +21 -0
  88. package/skills/egbe-os-instantly-campaign-launcher/SKILL.md +127 -0
  89. package/skills/egbe-os-instantly-campaign-launcher/references/instantly-ops.md +260 -0
  90. package/skills/egbe-os-instantly-campaign-launcher/references/observation-and-scheduling.md +188 -0
  91. package/skills/egbe-os-instantly-campaign-launcher/references/reply-handling.md +116 -0
  92. package/skills/egbe-os-instantly-campaign-launcher/references/run-spec-template.json +65 -0
  93. package/skills/egbe-os-instantly-campaign-launcher/references/run-state.md +145 -0
  94. package/skills/egbe-os-instantly-campaign-launcher/scripts/conclude-campaign.js +158 -0
  95. package/skills/egbe-os-instantly-campaign-launcher/scripts/install-crons.js +956 -0
  96. package/skills/egbe-os-instantly-campaign-launcher/scripts/launch-campaign.js +2008 -0
  97. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/campaign-metrics.js +124 -0
  98. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/confirmed-opt-outs.js +208 -0
  99. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/connection-identity.js +17 -0
  100. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/create-once.js +23 -0
  101. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/gtm-identity.js +125 -0
  102. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/helpers.js +545 -0
  103. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/html-body.js +266 -0
  104. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/instantly-client.js +328 -0
  105. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/outreach-db.js +370 -0
  106. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/recipient-exclusion/index.js +86 -0
  107. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/replenish-test-harness.js +53 -0
  108. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/reply-queue.js +67 -0
  109. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/run-config.js +103 -0
  110. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/sender-selection.js +105 -0
  111. package/skills/egbe-os-instantly-campaign-launcher/scripts/monitor-campaign.js +607 -0
  112. package/skills/egbe-os-instantly-campaign-launcher/scripts/outreach-report.js +147 -0
  113. package/skills/egbe-os-instantly-campaign-launcher/scripts/replenish-leads.js +619 -0
  114. package/skills/egbe-os-instantly-campaign-launcher/scripts/reply-worker.js +258 -0
  115. package/skills/egbe-os-instantly-campaign-launcher/scripts/run-cron-job.js +32 -0
  116. package/skills/egbe-os-instantly-campaign-launcher/scripts/send-reply.js +260 -0
  117. package/skills/egbe-os-linkedin-ads/SKILL.md +114 -0
  118. package/skills/egbe-os-linkedin-ads/references/destination-requirements.md +30 -0
  119. package/skills/egbe-os-linkedin-ads/references/runtime/api-reference.md +154 -0
  120. package/skills/egbe-os-linkedin-ads/references/runtime/artifacts.md +63 -0
  121. package/skills/egbe-os-linkedin-ads/references/workflows/build-paused.md +44 -0
  122. package/skills/egbe-os-linkedin-ads/references/workflows/conversions.md +88 -0
  123. package/skills/egbe-os-linkedin-ads/references/workflows/launch-and-pause.md +49 -0
  124. package/skills/egbe-os-linkedin-ads/references/workflows/monitoring.md +35 -0
  125. package/skills/egbe-os-linkedin-ads/references/workflows/readiness.md +63 -0
  126. package/skills/egbe-os-linkedin-ads/references/workflows/targeting-and-creative.md +52 -0
  127. package/skills/egbe-os-llm/SKILL.md +160 -0
  128. package/skills/egbe-os-mail/SKILL.md +180 -0
  129. package/skills/egbe-os-me/SKILL.md +119 -0
  130. package/skills/egbe-os-meta-ads/SKILL.md +114 -0
  131. package/skills/egbe-os-meta-ads/references/creative/creative-specs.md +15 -0
  132. package/skills/egbe-os-meta-ads/references/creative/talking-head.md +35 -0
  133. package/skills/egbe-os-meta-ads/references/destination-requirements.md +30 -0
  134. package/skills/egbe-os-meta-ads/references/runtime/api-reference.md +436 -0
  135. package/skills/egbe-os-meta-ads/references/runtime/artifacts.md +51 -0
  136. package/skills/egbe-os-meta-ads/references/runtime/insights-reference.md +187 -0
  137. package/skills/egbe-os-meta-ads/references/runtime/pixel-install.md +196 -0
  138. package/skills/egbe-os-meta-ads/references/runtime/shared-analytics-attribution.md +16 -0
  139. package/skills/egbe-os-meta-ads/references/workflows/build-paused.md +36 -0
  140. package/skills/egbe-os-meta-ads/references/workflows/launch-ready.md +16 -0
  141. package/skills/egbe-os-meta-ads/references/workflows/launch.md +23 -0
  142. package/skills/egbe-os-meta-ads/references/workflows/monitoring.md +72 -0
  143. package/skills/egbe-os-meta-ads/references/workflows/pause.md +17 -0
  144. package/skills/egbe-os-meta-ads/references/workflows/recovery.md +23 -0
  145. package/skills/egbe-os-meta-ads/scripts/check-pixel.py +229 -0
  146. package/skills/egbe-os-meta-ads/scripts/validate-meta-artifacts.py +187 -0
  147. package/skills/egbe-os-notifications/SKILL.md +78 -0
  148. package/skills/egbe-os-openai-ads/SKILL.md +149 -0
  149. package/skills/egbe-os-openai-ads/references/creative/chat-card.md +51 -0
  150. package/skills/egbe-os-openai-ads/references/destination-requirements.md +29 -0
  151. package/skills/egbe-os-openai-ads/references/runtime/api-reference.md +219 -0
  152. package/skills/egbe-os-openai-ads/references/runtime/artifacts.md +169 -0
  153. package/skills/egbe-os-openai-ads/references/workflows/build-paused.md +40 -0
  154. package/skills/egbe-os-openai-ads/references/workflows/conversions.md +40 -0
  155. package/skills/egbe-os-openai-ads/references/workflows/creative-assembly.md +24 -0
  156. package/skills/egbe-os-openai-ads/references/workflows/launch.md +27 -0
  157. package/skills/egbe-os-openai-ads/references/workflows/monitoring.md +54 -0
  158. package/skills/egbe-os-openai-ads/references/workflows/pause.md +22 -0
  159. package/skills/egbe-os-openai-ads/references/workflows/readiness.md +37 -0
  160. package/skills/egbe-os-openai-ads/references/workflows/tracking.md +32 -0
  161. package/skills/egbe-os-openai-ads/scripts/validate-openai-artifacts.py +271 -0
  162. package/skills/egbe-os-organic-trend-watch/SKILL.md +139 -0
  163. package/skills/egbe-os-organic-trend-watch/agents/openai.yaml +4 -0
  164. package/skills/egbe-os-organic-trend-watch/references/analysis-and-adaptation.md +54 -0
  165. package/skills/egbe-os-organic-trend-watch/references/collection-and-analysis.md +117 -0
  166. package/skills/egbe-os-organic-trend-watch/references/output-contract.md +133 -0
  167. package/skills/egbe-os-organic-trend-watch/references/provider-contract.md +169 -0
  168. package/skills/egbe-os-organic-trend-watch/references/runtime-contract.md +204 -0
  169. package/skills/egbe-os-organic-trend-watch/references/visual-analysis-prompt.md +17 -0
  170. package/skills/egbe-os-organic-trend-watch/scripts/_analysis.py +612 -0
  171. package/skills/egbe-os-organic-trend-watch/scripts/_contract.py +1133 -0
  172. package/skills/egbe-os-organic-trend-watch/scripts/_provider_inputs.py +165 -0
  173. package/skills/egbe-os-organic-trend-watch/scripts/analyze-visual-evidence.py +315 -0
  174. package/skills/egbe-os-organic-trend-watch/scripts/build-provider-inputs.py +88 -0
  175. package/skills/egbe-os-organic-trend-watch/scripts/connection_identity.py +22 -0
  176. package/skills/egbe-os-organic-trend-watch/scripts/egbe_artifacts.py +24 -0
  177. package/skills/egbe-os-organic-trend-watch/scripts/finalize-receipt.py +106 -0
  178. package/skills/egbe-os-organic-trend-watch/scripts/normalize-videos.py +647 -0
  179. package/skills/egbe-os-organic-trend-watch/scripts/prepare-visual-evidence.py +324 -0
  180. package/skills/egbe-os-organic-trend-watch/scripts/render-result.py +30 -0
  181. package/skills/egbe-os-organic-trend-watch/scripts/run-apify.py +723 -0
  182. package/skills/egbe-os-organic-trend-watch/scripts/run-state.py +192 -0
  183. package/skills/egbe-os-organic-trend-watch/scripts/validate-context.py +27 -0
  184. package/skills/egbe-os-organic-trend-watch/scripts/validate-runtime.py +137 -0
  185. package/skills/egbe-os-payments/SKILL.md +215 -0
  186. package/skills/egbe-os-payments/agents/openai.yaml +4 -0
  187. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/.egbe/scaffolds/billing-nextjs-subscription.v1.json +5 -0
  188. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/AGENTS.append.md +13 -0
  189. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/db/migrations/1000_egbe_billing.sql +66 -0
  190. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/package.fragment.json +12 -0
  191. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/scripts/billing-sync.mjs +162 -0
  192. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/error.tsx +11 -0
  193. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/loading.tsx +8 -0
  194. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/page.tsx +121 -0
  195. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/checkout/route.ts +102 -0
  196. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/portal/route.ts +54 -0
  197. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/status/route.ts +22 -0
  198. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/payments/webhook/route.ts +65 -0
  199. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/components/egbe-billing/plan-badge.tsx +16 -0
  200. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/billing-sync.test.mjs +58 -0
  201. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/catalog.ts +82 -0
  202. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/checkout-payload.ts +47 -0
  203. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/foundation-contract.test.mjs +59 -0
  204. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.d.ts +16 -0
  205. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.mjs +82 -0
  206. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.test.mjs +94 -0
  207. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/os-client.ts +96 -0
  208. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/plans.json +17 -0
  209. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/repository.ts +325 -0
  210. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.d.ts +6 -0
  211. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.mjs +22 -0
  212. package/skills/egbe-os-payments/references/contracts/plan-catalog.md +46 -0
  213. package/skills/egbe-os-payments/references/security/durable-verification.md +64 -0
  214. package/skills/egbe-os-payments/references/security/server-integration.md +26 -0
  215. package/skills/egbe-os-payments/references/security/webhook-and-entitlements.md +152 -0
  216. package/skills/egbe-os-payments/references/ux/billing-experience.md +47 -0
  217. package/skills/egbe-os-payments/references/workflows/account-billing.md +64 -0
  218. package/skills/egbe-os-payments/references/workflows/discounts-and-promotion-codes.md +265 -0
  219. package/skills/egbe-os-payments/references/workflows/one-time-purchase.md +75 -0
  220. package/skills/egbe-os-payments/references/workflows/product-checkout.md +355 -0
  221. package/skills/egbe-os-payments/references/workflows/subscription-lifecycle.md +55 -0
  222. package/skills/egbe-os-playbook/SKILL.md +79 -0
  223. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/email-outreach.md +91 -0
  224. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/google-search.md +40 -0
  225. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/linkedin.md +24 -0
  226. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/meta.md +23 -0
  227. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/openai.md +15 -0
  228. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/reddit.md +56 -0
  229. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/choose-test.md +73 -0
  230. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/evaluate.md +91 -0
  231. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/market.md +96 -0
  232. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/run-test.md +111 -0
  233. package/skills/egbe-os-playbook/playbooks/market-and-acquisition.md +56 -0
  234. package/skills/egbe-os-playbook/playbooks/product/business-loop.md +141 -0
  235. package/skills/egbe-os-playbook/playbooks/product/collaboration.md +26 -0
  236. package/skills/egbe-os-playbook/playbooks/product/deliver.md +75 -0
  237. package/skills/egbe-os-playbook/playbooks/product/diagnose.md +80 -0
  238. package/skills/egbe-os-playbook/playbooks/product/evaluate.md +67 -0
  239. package/skills/egbe-os-playbook/playbooks/product/experience.md +132 -0
  240. package/skills/egbe-os-playbook/playbooks/product/loop-examples.md +67 -0
  241. package/skills/egbe-os-playbook/playbooks/product/offer.md +65 -0
  242. package/skills/egbe-os-playbook/playbooks/product/value.md +91 -0
  243. package/skills/egbe-os-playbook/playbooks/product.md +67 -0
  244. package/skills/egbe-os-playbook/references/catalog.md +127 -0
  245. package/skills/egbe-os-playbook/references/changes.md +167 -0
  246. package/skills/egbe-os-playbook/scripts/playbook-changes.py +6 -0
  247. package/skills/egbe-os-playbook/scripts/playbook_changes/__init__.py +1 -0
  248. package/skills/egbe-os-playbook/scripts/playbook_changes/cli.py +57 -0
  249. package/skills/egbe-os-playbook/scripts/playbook_changes/operations.py +137 -0
  250. package/skills/egbe-os-playbook/scripts/playbook_changes/protocol.py +132 -0
  251. package/skills/egbe-os-playbook/scripts/playbook_changes/storage.py +180 -0
  252. package/skills/egbe-os-playbook/scripts/playbook_changes/transport.py +113 -0
  253. package/skills/egbe-os-product-auth/SKILL.md +151 -0
  254. package/skills/egbe-os-product-auth/agents/openai.yaml +4 -0
  255. package/skills/egbe-os-product-auth/assets/db/README.md +102 -0
  256. package/skills/egbe-os-product-auth/assets/db/create-validation-session.mjs +223 -0
  257. package/skills/egbe-os-product-auth/assets/db/migrate.mjs +64 -0
  258. package/skills/egbe-os-product-auth/assets/db/migrations/0001_auth.sql +33 -0
  259. package/skills/egbe-os-product-auth/assets/db/migrations/0002_auth_identities.sql +16 -0
  260. package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/AGENTS.append.md +17 -0
  261. package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/package.fragment.json +10 -0
  262. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/AGENTS.append.md +9 -0
  263. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/package.fragment.json +13 -0
  264. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/db.ts +31 -0
  265. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/identity.ts +94 -0
  266. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/index.ts +3 -0
  267. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/session.ts +91 -0
  268. package/skills/egbe-os-product-auth/references/contracts/live-auth-interface.md +108 -0
  269. package/skills/egbe-os-product-auth/references/frameworks/nextjs.md +34 -0
  270. package/skills/egbe-os-product-auth/references/security/session-and-credentials.md +73 -0
  271. package/skills/egbe-os-product-auth/references/ux/auth-experience.md +58 -0
  272. package/skills/egbe-os-product-auth/references/workflows/account-recovery.md +22 -0
  273. package/skills/egbe-os-product-auth/references/workflows/build-auth.md +212 -0
  274. package/skills/egbe-os-product-auth/references/workflows/google.md +34 -0
  275. package/skills/egbe-os-product-auth/references/workflows/passwordless-email.md +65 -0
  276. package/skills/egbe-os-product-build/SKILL.md +111 -0
  277. package/skills/egbe-os-product-build/agents/openai.yaml +4 -0
  278. package/skills/egbe-os-product-build/references/capabilities.md +25 -0
  279. package/skills/egbe-os-product-build/references/engineering.md +72 -0
  280. package/skills/egbe-os-product-build/references/execution.md +55 -0
  281. package/skills/egbe-os-product-build/references/foundations.md +93 -0
  282. package/skills/egbe-os-product-build/references/interface-quality.md +32 -0
  283. package/skills/egbe-os-product-build/references/workflows/private-review-handoff.md +86 -0
  284. package/skills/egbe-os-product-build/scripts/scaffold.py +296 -0
  285. package/skills/egbe-os-product-demo-video/SKILL.md +118 -0
  286. package/skills/egbe-os-product-demo-video/references/recording.md +32 -0
  287. package/skills/egbe-os-product-market-research/SKILL.md +159 -0
  288. package/skills/egbe-os-product-market-research/agents/openai.yaml +4 -0
  289. package/skills/egbe-os-product-market-research/references/catalog.v1.json +177 -0
  290. package/skills/egbe-os-product-market-research/references/config/channel-footprint-sources.v1.json +99 -0
  291. package/skills/egbe-os-product-market-research/references/config/creative-taxonomy.v1.json +367 -0
  292. package/skills/egbe-os-product-market-research/references/contracts/creative-video.md +75 -0
  293. package/skills/egbe-os-product-market-research/references/contracts/funnel-teardown.md +235 -0
  294. package/skills/egbe-os-product-market-research/references/contracts/geography-comparison.md +71 -0
  295. package/skills/egbe-os-product-market-research/references/contracts/lifecycle-capture.md +119 -0
  296. package/skills/egbe-os-product-market-research/references/contracts/research-artifacts.md +520 -0
  297. package/skills/egbe-os-product-market-research/references/contracts/walk-mechanics.v2.json +18 -0
  298. package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.md +137 -0
  299. package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.user.md +4 -0
  300. package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.md +118 -0
  301. package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.user.md +4 -0
  302. package/skills/egbe-os-product-market-research/references/prompts/demand-validation.md +154 -0
  303. package/skills/egbe-os-product-market-research/references/prompts/demand-validation.user.md +4 -0
  304. package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.md +100 -0
  305. package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.user.md +4 -0
  306. package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.md +126 -0
  307. package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.user.md +4 -0
  308. package/skills/egbe-os-product-market-research/references/prompts/target-audience.md +98 -0
  309. package/skills/egbe-os-product-market-research/references/prompts/target-audience.user.md +4 -0
  310. package/skills/egbe-os-product-market-research/references/prompts/unit-economics.md +217 -0
  311. package/skills/egbe-os-product-market-research/references/prompts/unit-economics.user.md +4 -0
  312. package/skills/egbe-os-product-market-research/references/prompts/value-proposition.md +113 -0
  313. package/skills/egbe-os-product-market-research/references/prompts/value-proposition.user.md +4 -0
  314. package/skills/egbe-os-product-market-research/references/workflows/acquisition-channels.md +27 -0
  315. package/skills/egbe-os-product-market-research/references/workflows/channel-footprint.md +163 -0
  316. package/skills/egbe-os-product-market-research/references/workflows/community-demand.md +100 -0
  317. package/skills/egbe-os-product-market-research/references/workflows/competitive-landscape.md +27 -0
  318. package/skills/egbe-os-product-market-research/references/workflows/competitor-ads.md +82 -0
  319. package/skills/egbe-os-product-market-research/references/workflows/competitor-set.md +300 -0
  320. package/skills/egbe-os-product-market-research/references/workflows/creative-patterns.md +228 -0
  321. package/skills/egbe-os-product-market-research/references/workflows/demand-validation.md +27 -0
  322. package/skills/egbe-os-product-market-research/references/workflows/fleet-prior.md +80 -0
  323. package/skills/egbe-os-product-market-research/references/workflows/funnel-teardown.md +184 -0
  324. package/skills/egbe-os-product-market-research/references/workflows/geography-comparison.md +84 -0
  325. package/skills/egbe-os-product-market-research/references/workflows/keyword-economics.md +122 -0
  326. package/skills/egbe-os-product-market-research/references/workflows/lifecycle-capture.md +218 -0
  327. package/skills/egbe-os-product-market-research/references/workflows/local-research.md +55 -0
  328. package/skills/egbe-os-product-market-research/references/workflows/market-size-and-dynamics.md +27 -0
  329. package/skills/egbe-os-product-market-research/references/workflows/preview.md +175 -0
  330. package/skills/egbe-os-product-market-research/references/workflows/pricing-and-monetization.md +27 -0
  331. package/skills/egbe-os-product-market-research/references/workflows/recommendations.md +35 -0
  332. package/skills/egbe-os-product-market-research/references/workflows/review-mining.md +76 -0
  333. package/skills/egbe-os-product-market-research/references/workflows/target-audience.md +27 -0
  334. package/skills/egbe-os-product-market-research/references/workflows/tiktok-reels-market-trends.md +46 -0
  335. package/skills/egbe-os-product-market-research/references/workflows/unit-economics.md +27 -0
  336. package/skills/egbe-os-product-market-research/references/workflows/value-proposition.md +27 -0
  337. package/skills/egbe-os-product-market-research/scripts/build-organic-trend-context.py +167 -0
  338. package/skills/egbe-os-product-market-research/scripts/build-preview-context.py +91 -0
  339. package/skills/egbe-os-product-market-research/scripts/build-research-query.py +225 -0
  340. package/skills/egbe-os-product-market-research/scripts/channel-footprint-model.py +294 -0
  341. package/skills/egbe-os-product-market-research/scripts/connection_identity.py +22 -0
  342. package/skills/egbe-os-product-market-research/scripts/creative-model.py +364 -0
  343. package/skills/egbe-os-product-market-research/scripts/creative-selection.py +113 -0
  344. package/skills/egbe-os-product-market-research/scripts/creative-semantics.py +365 -0
  345. package/skills/egbe-os-product-market-research/scripts/creative-video.py +542 -0
  346. package/skills/egbe-os-product-market-research/scripts/egbe_artifacts.py +24 -0
  347. package/skills/egbe-os-product-market-research/scripts/finalize-organic-trend-watch.py +304 -0
  348. package/skills/egbe-os-product-market-research/scripts/funnel-email-review.py +97 -0
  349. package/skills/egbe-os-product-market-research/scripts/funnel-model.py +966 -0
  350. package/skills/egbe-os-product-market-research/scripts/funnel_features.py +50 -0
  351. package/skills/egbe-os-product-market-research/scripts/geography-comparison-contract.py +172 -0
  352. package/skills/egbe-os-product-market-research/scripts/geography-comparison.py +169 -0
  353. package/skills/egbe-os-product-market-research/scripts/keyword-forecast.py +61 -0
  354. package/skills/egbe-os-product-market-research/scripts/keyword-locale-publication.py +136 -0
  355. package/skills/egbe-os-product-market-research/scripts/lifecycle-start.py +190 -0
  356. package/skills/egbe-os-product-market-research/scripts/persist-research-report.py +63 -0
  357. package/skills/egbe-os-product-market-research/scripts/research-artifact-io.py +281 -0
  358. package/skills/egbe-os-product-market-research/scripts/research-evidence.py +496 -0
  359. package/skills/egbe-os-product-market-research/scripts/research-policy.py +33 -0
  360. package/skills/egbe-os-product-market-research/scripts/research-section-runtime.py +343 -0
  361. package/skills/egbe-os-product-market-research/scripts/research-section-workflow.py +288 -0
  362. package/skills/egbe-os-product-market-research/scripts/research_integrity.py +122 -0
  363. package/skills/egbe-os-product-market-research/scripts/review-research-completion.py +306 -0
  364. package/skills/egbe-os-product-market-research/scripts/run-acquisition-channels.py +72 -0
  365. package/skills/egbe-os-product-market-research/scripts/run-channel-footprint.py +2258 -0
  366. package/skills/egbe-os-product-market-research/scripts/run-community-demand.py +1603 -0
  367. package/skills/egbe-os-product-market-research/scripts/run-competitive-landscape.py +66 -0
  368. package/skills/egbe-os-product-market-research/scripts/run-competitor-ads.py +1156 -0
  369. package/skills/egbe-os-product-market-research/scripts/run-competitor-set.py +2514 -0
  370. package/skills/egbe-os-product-market-research/scripts/run-creative-patterns.py +2042 -0
  371. package/skills/egbe-os-product-market-research/scripts/run-demand-validation.py +72 -0
  372. package/skills/egbe-os-product-market-research/scripts/run-fleet-prior.py +652 -0
  373. package/skills/egbe-os-product-market-research/scripts/run-funnel-teardown.py +493 -0
  374. package/skills/egbe-os-product-market-research/scripts/run-keyword-economics.py +1443 -0
  375. package/skills/egbe-os-product-market-research/scripts/run-lifecycle-capture.py +1543 -0
  376. package/skills/egbe-os-product-market-research/scripts/run-market-size-and-dynamics.py +66 -0
  377. package/skills/egbe-os-product-market-research/scripts/run-os-research.py +311 -0
  378. package/skills/egbe-os-product-market-research/scripts/run-pricing-and-monetization.py +71 -0
  379. package/skills/egbe-os-product-market-research/scripts/run-review-mining.py +1051 -0
  380. package/skills/egbe-os-product-market-research/scripts/run-target-audience.py +66 -0
  381. package/skills/egbe-os-product-market-research/scripts/run-unit-economics.py +71 -0
  382. package/skills/egbe-os-product-market-research/scripts/run-value-proposition.py +67 -0
  383. package/skills/egbe-os-product-market-research/scripts/upsert-markdown-section.py +156 -0
  384. package/skills/egbe-os-product-market-research/scripts/walk-funnels.py +249 -0
  385. package/skills/egbe-os-product-market-research/scripts/write-preview.py +710 -0
  386. package/skills/egbe-os-product-market-research/scripts/write-recommendations.py +272 -0
  387. package/skills/egbe-os-product-report/SKILL.md +150 -0
  388. package/skills/egbe-os-product-report/references/artifacts.md +84 -0
  389. package/skills/egbe-os-product-report/references/brief.md +34 -0
  390. package/skills/egbe-os-product-report/references/daily.md +76 -0
  391. package/skills/egbe-os-product-report/references/sources.md +68 -0
  392. package/skills/egbe-os-product-routines/SKILL.md +166 -0
  393. package/skills/egbe-os-product-routines/references/catalog.md +22 -0
  394. package/skills/egbe-os-product-routines/references/continuation-check.md +41 -0
  395. package/skills/egbe-os-product-routines/references/product-reporting.md +163 -0
  396. package/skills/egbe-os-product-routines/references/run-preset.md +32 -0
  397. package/skills/egbe-os-quickstart/scripts/egbe-curl.py +357 -0
  398. package/skills/egbe-os-quiz-funnel/SKILL.md +152 -0
  399. package/skills/egbe-os-quiz-funnel/agents/openai.yaml +4 -0
  400. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.d.mts +224 -0
  401. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.mjs +652 -0
  402. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.test.mjs +764 -0
  403. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.d.mts +31 -0
  404. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.mjs +87 -0
  405. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.test.mjs +265 -0
  406. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-reference.test.mjs +254 -0
  407. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/QUIZ.md +195 -0
  408. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.json +421 -0
  409. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.public.json +369 -0
  410. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/validation.json +21 -0
  411. package/skills/egbe-os-quiz-funnel/assets/reference/index.html +26 -0
  412. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-bootstrap.js +31 -0
  413. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-early-actions.mjs +11 -0
  414. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-first-screen.mjs +32 -0
  415. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-page.mjs +480 -0
  416. package/skills/egbe-os-quiz-funnel/assets/reference/quiz.css +264 -0
  417. package/skills/egbe-os-quiz-funnel/references/competitor-teardown.md +159 -0
  418. package/skills/egbe-os-quiz-funnel/references/conversion-handoff.md +156 -0
  419. package/skills/egbe-os-quiz-funnel/references/implementation.md +207 -0
  420. package/skills/egbe-os-quiz-funnel/references/inputs.md +37 -0
  421. package/skills/egbe-os-quiz-funnel/references/measurement.md +122 -0
  422. package/skills/egbe-os-quiz-funnel/references/spec-contract.md +335 -0
  423. package/skills/egbe-os-quiz-funnel/references/verification.md +101 -0
  424. package/skills/egbe-os-quiz-funnel/references/walk-mechanics.v2.json +18 -0
  425. package/skills/egbe-os-quiz-funnel/scripts/compile-quiz-spec.py +1869 -0
  426. package/skills/egbe-os-quiz-funnel/scripts/prepare-research-identity.py +66 -0
  427. package/skills/egbe-os-reddit-ads/SKILL.md +121 -0
  428. package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/schema.json +41 -0
  429. package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/template.html +106 -0
  430. package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/schema.json +61 -0
  431. package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/template.html +151 -0
  432. package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/schema.json +91 -0
  433. package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/template.html +185 -0
  434. package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/schema.json +51 -0
  435. package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/template.html +121 -0
  436. package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/schema.json +87 -0
  437. package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/template.html +212 -0
  438. package/skills/egbe-os-reddit-ads/references/creative/html-to-png-pipeline.md +123 -0
  439. package/skills/egbe-os-reddit-ads/references/creative/static-banner-qa.md +12 -0
  440. package/skills/egbe-os-reddit-ads/references/creative/static-banner-system.md +16 -0
  441. package/skills/egbe-os-reddit-ads/references/destination-requirements.md +36 -0
  442. package/skills/egbe-os-reddit-ads/references/runtime/api-reference.md +435 -0
  443. package/skills/egbe-os-reddit-ads/references/runtime/artifacts.md +57 -0
  444. package/skills/egbe-os-reddit-ads/references/runtime/monitoring.md +64 -0
  445. package/skills/egbe-os-reddit-ads/references/runtime/pixel-and-tracking.md +49 -0
  446. package/skills/egbe-os-reddit-ads/references/runtime/policies.md +19 -0
  447. package/skills/egbe-os-reddit-ads/references/runtime/shared-analytics-attribution.md +14 -0
  448. package/skills/egbe-os-reddit-ads/references/workflows/build-paused.md +35 -0
  449. package/skills/egbe-os-reddit-ads/references/workflows/launch-ready.md +19 -0
  450. package/skills/egbe-os-reddit-ads/references/workflows/launch.md +32 -0
  451. package/skills/egbe-os-reddit-ads/references/workflows/readiness.md +9 -0
  452. package/skills/egbe-os-reddit-ads/scripts/capture-ad.sh +178 -0
  453. package/skills/egbe-os-reddit-ads/scripts/validate-reddit-artifacts.py +187 -0
  454. package/skills/egbe-os-report-ui/SKILL.md +133 -0
  455. package/skills/egbe-os-report-ui/assets/egbe-wordmark.svg +9 -0
  456. package/skills/egbe-os-report-ui/assets/examples/components.html +417 -0
  457. package/skills/egbe-os-report-ui/assets/examples/editorial.html +209 -0
  458. package/skills/egbe-os-report-ui/assets/scaffold.html +179 -0
  459. package/skills/egbe-os-report-ui/references/components.md +209 -0
  460. package/skills/egbe-os-research/SKILL.md +125 -0
  461. package/skills/egbe-os-saas-unit-economics/SKILL.md +188 -0
  462. package/skills/egbe-os-scrape/SKILL.md +160 -0
  463. package/skills/egbe-os-search/SKILL.md +182 -0
  464. package/skills/egbe-os-search/references/google-places.md +81 -0
  465. package/skills/egbe-os-support/SKILL.md +149 -0
  466. package/skills/egbe-os-telemetry/SKILL.md +344 -0
  467. package/skills/egbe-os-telemetry/references/harnesses/claude-code.md +97 -0
  468. package/skills/egbe-os-telemetry/references/harnesses/codex.md +22 -0
  469. package/skills/egbe-os-telemetry/references/harnesses/hermes.md +39 -0
  470. package/skills/egbe-os-telemetry/references/harnesses/openclaw.md +139 -0
  471. package/skills/egbe-os-telemetry/references/harnesses/opencode.md +28 -0
  472. package/skills/egbe-os-tools/SKILL.md +180 -0
  473. package/skills/egbe-os-tools/references/theona.md +26 -0
  474. package/skills/egbe-os-wallet/SKILL.md +181 -0
  475. package/skills/egbe-setup/EGBE.md +484 -0
  476. package/skills/egbe-setup/SKILL.md +116 -0
  477. package/skills/egbe-setup/references/project.md +80 -0
  478. package/state.js +37 -0
  479. 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.