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