@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,116 @@
1
+ ---
2
+ name: egbe-setup
3
+ description: Set up Egbe for the founder's business through the Egbe connector. Use when the founder asks to set up, connect or start using Egbe.
4
+ ---
5
+
6
+ **If the `egbe_*` tools are missing.** The plugin's Egbe connector isn't signed
7
+ in yet: installing the plugin doesn't sign in. OpenCode lists the connector as
8
+ the `egbe` MCP server and its tools with the server's prefix, such as
9
+ `egbe_egbe_setup`. Ask the founder to connect their Egbe account before setup
10
+ continues, in a short message in their language:
11
+
12
+ - Say that this is a one-time step.
13
+ - Number the steps: in a terminal on this computer, run `opencode mcp auth egbe`
14
+ (in OpenCode 2, `/mcps` in OpenCode also starts it), sign in to Egbe in the
15
+ browser that opens and select **Connect**, then restart OpenCode in this
16
+ folder. Egbe's page doesn't ask for a business, so don't ask them to choose one
17
+ there.
18
+ - Say what happens afterwards and what to reply.
19
+ - End with one line on what the connection allows: it covers all their Egbe
20
+ businesses, including ones they start later, and in each conversation you
21
+ work on the business they name; the Egbe team can read what you do in Egbe to
22
+ support them and improve Egbe, and they can disconnect you anytime under
23
+ [connected AI assistants](https://dashboard.egbe.ai/settings/connections).
24
+
25
+ Don't run `opencode mcp auth` yourself: it waits for the founder in a browser.
26
+ When OpenCode runs on another machine (SSH or a container), the browser can't
27
+ reach the sign-in's local callback: tell the founder to copy the address of the
28
+ page that fails to load (`http://127.0.0.1:<port>/...`) and paste it into the
29
+ terminal prompt that asks for it.
30
+
31
+ If the sign-in fails, for example because Egbe refuses to register this agent,
32
+ stop asking the founder to retry. Tell them what failed, quoting the error, and
33
+ that they can connect this agent with the connection instructions on their
34
+ business's **Connect** page in Egbe (<https://dashboard.egbe.ai>) instead, or ask
35
+ for help at <support@egbe.ai>.
36
+
37
+ Don't call Egbe unavailable before this step, and don't reach Egbe from the shell
38
+ instead.
39
+
40
+ **Plugin updates.** The plugin updates itself from npm while OpenCode runs and
41
+ records each check under `update` in `~/.local/state/egbe/opencode-plugin.json`
42
+ (under `$XDG_STATE_HOME` when it is set). When the founder asks about the
43
+ plugin's version or updates, read that entry. `manual` means a new version
44
+ changes what the plugin can do and waits for the founder: in OpenCode 2 they run
45
+ `opencode plugin update @egbe-ai/opencode`; in 1.x they delete
46
+ `~/.cache/opencode/packages/@egbe-ai/opencode@latest` and restart OpenCode. A
47
+ plugin loaded from a folder updates with `git pull` in that folder.
48
+
49
+ # Set up Egbe through this connection
50
+
51
+ You are connected to the founder's Egbe project through MCP. If this result names
52
+ a `business`, pass it to every later egbe_read, egbe_write, egbe_local_setup and
53
+ egbe_complete_setup call.
54
+
55
+ This setup runs from the Egbe plugin, which provides Egbe's skills in every
56
+ session. Read those skills and their files from the plugin; use `egbe_skill`
57
+ only for what the plugin lacks, such as `egbe-os-quickstart` below. In step 2,
58
+ set up a persistent project workspace that is not set up yet as
59
+ [project setup](references/project.md) describes. It still calls `egbe_local_setup`
60
+ and keeps the standard project setup, including saved credentials, playbooks,
61
+ session logging and the Business Loop, but installs no skills. A project that
62
+ already has its own installed Egbe skills uses those rather than the plugin's
63
+ copies.
64
+
65
+ 1. **Introduce Egbe.** Read
66
+ `egbe_skill(name="egbe-os-quickstart", resource="references/introduction.md")` and the
67
+ `skills` list in this result. Give the founder a warm, compact introduction in
68
+ their language: what you can now do for their business with Egbe. Describe
69
+ platform capabilities, not an already configured business.
70
+ 2. **Choose where setup lives.** Establish from the environment context or native
71
+ documentation whether you work in a persistent project workspace: a project
72
+ folder whose files and configuration persist across sessions, where you can
73
+ run commands and reuse project-scoped skills and instructions. A chat's
74
+ temporary execution environment, a terminal alone or this connection does not
75
+ establish one; do not create one through installation or plugins.
76
+ - **Workspace already set up for Egbe** (saved Egbe credentials or an
77
+ installed Egbe catalog): this is not a new setup. Skip `egbe_local_setup`,
78
+ use the saved credentials and the installed skills, or `egbe_skill` where
79
+ none are installed, and continue with what the founder asked.
80
+ If it has `egbe-docs/egbe-workspace.json` and its saved `releases` differ
81
+ from this result's `releases`, first update its files as
82
+ `egbe_workspace_files` describes.
83
+ - **Persistent project workspace not set up yet:** call `egbe_local_setup` and
84
+ follow its result instead of the steps below. Through your own file tools
85
+ and this connection, with no Egbe installer or script, the workspace gets
86
+ saved credentials, project playbooks and guidance, logging authorization
87
+ and the Business Loop offer; skills stay readable with `egbe_skill`. If it refuses, mention the reason once and
88
+ continue below.
89
+ - **Otherwise:** continue below. This path needs no installation, API key,
90
+ curl, shell command or local file.
91
+ 3. **Understand the project.** `project.limits` is the verified availability of
92
+ this project. An unused zero allowance (`max_allowed: 0`, `current: 0`) means
93
+ unavailable, not exhausted. Mention a limit only if it affects requested work
94
+ or the next step. Review the context you already have, such as notes, to
95
+ recommend where to continue. Do not run a full audit.
96
+ 4. **Offer useful follow-through.** Use the founder's goal and project evidence
97
+ with `egbe_skill(name="egbe-os-quickstart", resource="references/offer-loop.md")`
98
+ to recommend a preset or custom loop. Discuss the choice in this chat; keep
99
+ ongoing work in a workspace with persistent access to the project.
100
+ 5. **Finish.** Call `egbe_complete_setup` once, then give a concise handoff in the
101
+ first person: what you can do with Egbe, a compact capabilities table and the
102
+ concrete next step. If no product idea exists yet, start that conversation
103
+ now with an easy question about the founder's experience, interests or the
104
+ people they can reach. If the founder asked to finish without questions, ask
105
+ none: give the next step and what you will prepare, and keep any question for
106
+ a later reply.
107
+
108
+ For any later Egbe work, use its advertised `name` from the skills list with
109
+ `egbe_skill` and perform
110
+ its API steps with `egbe_read` (GET) and `egbe_write` (other methods). Connection alone does not authorize
111
+ development, publishing, spending, outreach or recurring work; ask the founder
112
+ for the missing decision.
113
+
114
+ To start another business, call `egbe_create_business` with the name the founder
115
+ chose, only when they ask for one or agree to it, then set it up with
116
+ `egbe_setup` and the `business` it returns.
@@ -0,0 +1,80 @@
1
+ # Set up a project folder with the Egbe plugin
2
+
3
+ The Egbe plugin gives every session in this folder Egbe's skills, so the project
4
+ needs only what belongs to it: saved credentials, editable playbooks and project
5
+ guidance. Do not install Egbe skills into the project, and do not download or
6
+ run Egbe's catalog installer. The steps below write small text files and copy
7
+ files that come with the plugin.
8
+
9
+ 1. Call `egbe_local_setup` with the `business` that `egbe_setup` returned. Never
10
+ show its `OS_API_KEY` in chat, and keep it out of logs, commits, URLs and
11
+ search queries.
12
+ 2. Follow the `instructions` it returns. Do their project files step as
13
+ [project files](#project-files) below describes, from the plugin's own
14
+ files, not with `egbe_workspace_files`: the plugin brings the same
15
+ playbooks, and its `EGBE.md` indexes the skills the plugin provides.
16
+
17
+ ## Project files
18
+
19
+ Work from the project root. "This skill's folder" is the folder holding the
20
+ `egbe-setup` skill's `SKILL.md`. Reuse what is already in place; ask the founder
21
+ before replacing a file that differs.
22
+
23
+ Use file tools to read and write files. Run each shell command on its own, with
24
+ absolute paths: no `&&`, `;` or pipes, no `cd`, no shell variables, and never the
25
+ key in a command. An agent that approves commands one by one then asks less,
26
+ and a refused compound command does not stall setup.
27
+
28
+ - **Credentials.** Save them as the instructions' credentials step describes:
29
+ write `.env.local` with the file tools, then
30
+ run `chmod 600 .env.local` as its own command.
31
+ - **Private files.** Make sure `.gitignore` ignores `.env.local` and `/.egbe/`,
32
+ where skill scripts downloaded from Egbe are kept. Unless
33
+ `.gitignore` already ends with the lines below, append them; they keep private
34
+ working files in `egbe-docs/` out of Git:
35
+
36
+ ```gitignore
37
+ !/egbe-docs/marketing/campaigns/instantly/outreach.db
38
+ /egbe-docs/**/.local/
39
+ /egbe-docs/**/.env
40
+ /egbe-docs/**/.env.*
41
+ /egbe-docs/**/*.lock
42
+ /egbe-docs/**/*.tmp
43
+ /egbe-docs/**/*-wal
44
+ /egbe-docs/**/*-shm
45
+ /egbe-docs/**/*-journal
46
+ ```
47
+
48
+ Likewise end `.dockerignore` with these lines, which keep `egbe-docs/` out of
49
+ builds:
50
+
51
+ ```gitignore
52
+ /egbe-docs/
53
+ .git
54
+ ```
55
+
56
+ - **Playbooks.** Copy the files in the `egbe-os-playbook` skill's `playbooks/`
57
+ folder (`../egbe-os-playbook/playbooks/` from this skill's folder) to the same
58
+ paths under `egbe-docs/playbooks/` with one command,
59
+ `rsync -a --ignore-existing <source>/ egbe-docs/playbooks/`, where `<source>` is
60
+ that folder's absolute path. Add only files
61
+ whose path does not exist yet; never replace or delete a project file, and
62
+ report any file you could not add. These are the project's editable methods.
63
+ Do not create `egbe-docs/playbooks-sync.json`: it records a finished method
64
+ review, not delivery.
65
+ - **Project guidance.** Copy `EGBE.md` from this skill's folder to the project
66
+ root as a regular file: read it and write the same text with the file tools,
67
+ since a plugin folder can be protected from shell commands. Add this exact
68
+ line to the project instruction file this agent reads at the start of every
69
+ session, such as the root `AGENTS.md`, keeping existing instructions and
70
+ reusing an equivalent entry:
71
+ `Read and apply EGBE.md when working on this project.` Then read the whole
72
+ `EGBE.md` once and use it for the rest of setup.
73
+
74
+ - **Session logging.** The plugin records this folder's sessions by default.
75
+ Don't ask for consent: tell the founder once and record the choice as the
76
+ `egbe-os-telemetry` skill's plugin section describes, unless a saved choice
77
+ declines logging.
78
+
79
+ Later, the `egbe-os-playbook` skill's catalog guide delivers new playbooks and
80
+ keeps `EGBE.md` current from the plugin. Egbe's skills update with the plugin.
package/state.js ADDED
@@ -0,0 +1,37 @@
1
+ // The plugin's state file: the last session-logging result and the updater's
2
+ // state, for the founder and the agent to check. It never holds a secret.
3
+ import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
4
+ import os from "node:os";
5
+ import path from "node:path";
6
+
7
+ export function stateDir(environment = process.env) {
8
+ const base = environment.XDG_STATE_HOME || path.join(os.homedir(), ".local", "state");
9
+ return path.join(base, "egbe");
10
+ }
11
+
12
+ export function statePath(environment = process.env) {
13
+ return path.join(stateDir(environment), "opencode-plugin.json");
14
+ }
15
+
16
+ export function readState(environment = process.env) {
17
+ try {
18
+ const value = JSON.parse(readFileSync(statePath(environment), "utf8"));
19
+ return value && typeof value === "object" ? value : {};
20
+ } catch {
21
+ return {};
22
+ }
23
+ }
24
+
25
+ /** Merges `patch` into the state file; never throws, since the file is only informational. */
26
+ export function writeState(patch, environment = process.env) {
27
+ try {
28
+ const file = statePath(environment);
29
+ mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
30
+ const next = { ...readState(environment), ...patch };
31
+ const temporary = `${file}.${process.pid}.tmp`;
32
+ writeFileSync(temporary, JSON.stringify(next, null, 2) + "\n", { mode: 0o600 });
33
+ renameSync(temporary, file);
34
+ } catch {
35
+ // Informational only.
36
+ }
37
+ }
package/update.js ADDED
@@ -0,0 +1,361 @@
1
+ // Egbe's OpenCode plugin updates itself from npm.
2
+ //
3
+ // OpenCode 1.x installs an unpinned npm plugin once into its cache
4
+ // (`<cache>/opencode/packages/@egbe-ai/opencode@latest/`) and loads that copy on
5
+ // every later start without checking npm again. OpenCode 2.x checks unpinned
6
+ // npm plugins for new versions once a day but only marks them outdated: the
7
+ // update runs when someone runs `opencode plugin update`. So, in a long-running
8
+ // OpenCode, the plugin checks npm itself, a minute after it loads and every six
9
+ // hours, never at import and never in the way of a turn:
10
+ //
11
+ // 1. It reads `@egbe-ai/opencode` from the npm registry. A newer `latest` version
12
+ // whose declared capabilities (package.json `egbe.capabilities`: MCP servers,
13
+ // tools, commands and hooks) differ from the running version's is not
14
+ // installed automatically; the state file says to update by hand.
15
+ // 2. It downloads that version's tarball from the registry's own host, checks
16
+ // it against the registry's `dist.integrity` (SHA-512), unpacks it into a
17
+ // staging folder and checks its name, version and capabilities, then loads
18
+ // the staged copy with updates and logging off and checks that it registers
19
+ // the Egbe connector. Nothing it downloaded runs before the integrity check.
20
+ // 3. OpenCode 1.x: it swaps the staged copy into OpenCode's cache and keeps the
21
+ // previous copy until the new version has loaded; a failed swap restores the
22
+ // previous copy. The next OpenCode start loads the new version.
23
+ // OpenCode 2.x: it asks OpenCode to update the plugin
24
+ // (`opencode plugin update <target>`), which installs the same version
25
+ // through OpenCode's own npm installer and its integrity checks and reloads it.
26
+ //
27
+ // A pinned install (an exact version or a range) and an install from a folder,
28
+ // such as a clone of egbe-ai/egbe-plugins (updated with `git pull`), are left
29
+ // alone. The `autoUpdate: false` option turns this off. Every check is recorded
30
+ // under `update` in the plugin's state file.
31
+ import { createHash, randomBytes } from "node:crypto";
32
+ import { spawn } from "node:child_process";
33
+ import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
34
+ import path from "node:path";
35
+ import { pathToFileURL } from "node:url";
36
+ import { gunzipSync } from "node:zlib";
37
+ import { readState, stateDir, writeState } from "./state.js";
38
+
39
+ export const PACKAGE = "@egbe-ai/opencode";
40
+ const SCOPE = PACKAGE.split("/")[0];
41
+ export const REGISTRY = "https://registry.npmjs.org";
42
+ const MAX_PACKUMENT = 16 * 1024 * 1024;
43
+ const MAX_TARBALL = 32 * 1024 * 1024;
44
+ const LOCK_STALE = 15 * 60 * 1000;
45
+
46
+ /** The updater's settings from the plugin options. */
47
+ export function updaterSettings(options) {
48
+ const o = options ?? {};
49
+ const number = (value, fallback, min) => (typeof value === "number" && Number.isFinite(value) && value >= min ? value : fallback);
50
+ let registry = REGISTRY;
51
+ if (o.registryUrl !== undefined) {
52
+ // A loopback registry for tests; otherwise only npm's. A bad value turns updates off.
53
+ let url;
54
+ try {
55
+ url = new URL(String(o.registryUrl));
56
+ } catch {
57
+ url = undefined;
58
+ }
59
+ const loopback = url?.protocol === "http:" && ["127.0.0.1", "localhost", "[::1]"].includes(url.hostname);
60
+ if (!url || (url.href.replace(/\/$/, "") !== REGISTRY && !loopback)) {
61
+ return { enabled: false, registry, intervalMs: 0, initialDelayMs: 0, error: "registryUrl must be npm's registry or a loopback test registry" };
62
+ }
63
+ registry = url.href.replace(/\/$/, "");
64
+ }
65
+ return {
66
+ enabled: o.autoUpdate !== false,
67
+ registry,
68
+ intervalMs: number(o.checkIntervalMinutes, 360, 1) * 60 * 1000,
69
+ initialDelayMs: number(o.initialDelaySeconds, 60, 0) * 1000,
70
+ };
71
+ }
72
+
73
+ export function compareVersions(a, b) {
74
+ const parse = (v) => String(v).split("-")[0].split(".").map((n) => Number.parseInt(n, 10) || 0);
75
+ const [x, y] = [parse(a), parse(b)];
76
+ for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] < y[i] ? -1 : 1;
77
+ return 0;
78
+ }
79
+
80
+ const sameCapabilities = (a, b) => JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
81
+
82
+ /** How this copy was installed: OpenCode 1.x's npm cache, a folder, or a pinned spec.
83
+ * OpenCode 1.x keeps a package at `<cache>/packages/<spec>/node_modules/<name>`. */
84
+ export function v1Install(moduleRoot) {
85
+ const scope = path.dirname(moduleRoot);
86
+ const modules = path.dirname(scope);
87
+ const specDir = path.dirname(modules);
88
+ const scopeDir = path.dirname(specDir);
89
+ const packages = path.dirname(scopeDir);
90
+ const isCache = path.basename(moduleRoot) === "opencode" && path.basename(scope) === SCOPE
91
+ && path.basename(modules) === "node_modules" && path.basename(scopeDir) === SCOPE && path.basename(packages) === "packages";
92
+ if (!isCache) return { kind: "folder" };
93
+ const spec = path.basename(specDir);
94
+ if (spec !== "opencode@latest") return { kind: "pinned", spec: `${SCOPE}/${spec}` };
95
+ return { kind: "npm", spec: `${PACKAGE}@latest`, packageDir: moduleRoot };
96
+ }
97
+
98
+ /** The plugin's entry in OpenCode 2.x's plugin inventory, as an install kind. */
99
+ export function v2Install(inventory) {
100
+ const list = Array.isArray(inventory?.data) ? inventory.data : Array.isArray(inventory) ? inventory : [];
101
+ const entry = list.find((p) => p?.id === "egbe") ?? list.find((p) => p?.source?.target?.startsWith?.(PACKAGE));
102
+ const source = entry?.source;
103
+ if (!source) return { kind: "unknown" };
104
+ if (source.type !== "package") return { kind: "folder" };
105
+ const target = String(source.target);
106
+ if (target !== PACKAGE && target !== `${PACKAGE}@latest`) return { kind: "pinned", spec: target };
107
+ return { kind: "npm", target };
108
+ }
109
+
110
+ function lock(dir) {
111
+ const file = path.join(dir, "opencode-update.lock");
112
+ mkdirSync(dir, { recursive: true, mode: 0o700 });
113
+ try {
114
+ mkdirSync(file);
115
+ } catch {
116
+ try {
117
+ if (Date.now() - statSync(file).mtimeMs < LOCK_STALE) return undefined;
118
+ rmSync(file, { recursive: true, force: true });
119
+ mkdirSync(file);
120
+ } catch {
121
+ return undefined;
122
+ }
123
+ }
124
+ return () => rmSync(file, { recursive: true, force: true });
125
+ }
126
+
127
+ async function fetchLimited(fetchImpl, url, limit, accept) {
128
+ const res = await fetchImpl(url, { headers: { accept }, redirect: "error", signal: AbortSignal.timeout(60_000) });
129
+ if (!res.ok) throw new Error(`HTTP ${res.status} from ${new URL(url).host}`);
130
+ const body = Buffer.from(await res.arrayBuffer());
131
+ if (body.length > limit) throw new Error(`response from ${new URL(url).host} is too large`);
132
+ return body;
133
+ }
134
+
135
+ /** The files of an npm tarball (`package/...`), refusing anything but regular files and folders inside it. */
136
+ export function untar(gzipped) {
137
+ const data = gunzipSync(gzipped);
138
+ const files = new Map();
139
+ let longPath;
140
+ const field = (block, start, length) => block.subarray(start, start + length).toString("utf8").replace(/\0.*$/s, "");
141
+ for (let offset = 0; offset + 512 <= data.length;) {
142
+ const header = data.subarray(offset, offset + 512);
143
+ if (header.every((b) => b === 0)) break;
144
+ const size = Number.parseInt(field(header, 124, 12).trim() || "0", 8);
145
+ const type = String.fromCharCode(header[156] || 48);
146
+ const mode = Number.parseInt(field(header, 100, 8).trim() || "644", 8);
147
+ const body = data.subarray(offset + 512, offset + 512 + size);
148
+ offset += 512 + Math.ceil(size / 512) * 512;
149
+ if (type === "x") {
150
+ const match = /\d+ path=([^\n]*)\n/.exec(body.toString("utf8"));
151
+ longPath = match?.[1];
152
+ continue;
153
+ }
154
+ if (type === "g") continue;
155
+ const prefix = field(header, 345, 155);
156
+ const name = longPath ?? (prefix ? `${prefix}/${field(header, 0, 100)}` : field(header, 0, 100));
157
+ longPath = undefined;
158
+ if (type === "5") continue;
159
+ if (type !== "0" && type !== "\0") throw new Error(`unsupported entry in the package: ${name}`);
160
+ const parts = name.split("/");
161
+ if (parts[0] !== "package" || parts.length < 2 || parts.some((p) => p === "" || p === "." || p === "..") || name.includes("\\")) {
162
+ throw new Error(`unsafe path in the package: ${name}`);
163
+ }
164
+ files.set(parts.slice(1).join("/"), { data: Buffer.from(body), executable: (mode & 0o111) !== 0 });
165
+ }
166
+ return files;
167
+ }
168
+
169
+ function writeTree(dir, files) {
170
+ for (const [name, file] of files) {
171
+ const target = path.join(dir, name);
172
+ mkdirSync(path.dirname(target), { recursive: true });
173
+ writeFileSync(target, file.data);
174
+ chmodSync(target, file.executable ? 0o755 : 0o644);
175
+ }
176
+ }
177
+
178
+ /** Loads a staged copy with updates and logging off and checks that it adds the Egbe connector. */
179
+ async function smokeTest(dir, expectedUrl) {
180
+ const { default: plugin } = await import(`${pathToFileURL(path.join(dir, "index.js")).href}?verify=${Date.now()}`);
181
+ if (plugin?.id !== "egbe" || typeof plugin.server !== "function" || typeof plugin.setup !== "function") {
182
+ throw new Error("the new version does not export the plugin");
183
+ }
184
+ const client = { session: { messages: async () => ({ data: [] }) } };
185
+ const hooks = await plugin.server({ client, directory: dir, worktree: dir }, { autoUpdate: false, sessionLogging: false });
186
+ const config = {};
187
+ await hooks.config(config);
188
+ await hooks.dispose?.();
189
+ if (config.mcp?.egbe?.url !== expectedUrl) throw new Error("the new version does not add the Egbe connector");
190
+ }
191
+
192
+ /** Downloads, verifies and stages `version`; returns the staged folder. */
193
+ async function stage({ registry, packument, version, capabilities, stagingDir, fetchImpl, mcpUrl }) {
194
+ const manifest = packument.versions?.[version];
195
+ if (manifest?.name !== PACKAGE || manifest.version !== version) throw new Error(`the registry has no ${PACKAGE}@${version}`);
196
+ const integrity = String(manifest.dist?.integrity ?? "");
197
+ if (!integrity.startsWith("sha512-")) throw new Error("the registry gives no SHA-512 integrity");
198
+ const tarball = new URL(manifest.dist.tarball);
199
+ if (tarball.origin !== new URL(registry).origin) throw new Error(`the tarball is not on ${new URL(registry).host}`);
200
+ const gzipped = await fetchLimited(fetchImpl, tarball.href, MAX_TARBALL, "application/octet-stream");
201
+ const digest = `sha512-${createHash("sha512").update(gzipped).digest("base64")}`;
202
+ if (digest !== integrity) throw new Error("the tarball does not match the registry's integrity");
203
+ const files = untar(gzipped);
204
+ const pkg = JSON.parse(files.get("package.json")?.data.toString("utf8") ?? "null");
205
+ if (pkg?.name !== PACKAGE || pkg.version !== version) throw new Error("the tarball's package.json names another package or version");
206
+ if (!sameCapabilities(pkg.egbe?.capabilities, capabilities)) throw new Error("the tarball declares other capabilities than the registry");
207
+ rmSync(stagingDir, { recursive: true, force: true });
208
+ try {
209
+ writeTree(stagingDir, files);
210
+ await smokeTest(stagingDir, mcpUrl);
211
+ } catch (error) {
212
+ rmSync(stagingDir, { recursive: true, force: true });
213
+ throw error;
214
+ }
215
+ return stagingDir;
216
+ }
217
+
218
+ function installedVersion(packageDir) {
219
+ try {
220
+ const version = JSON.parse(readFileSync(path.join(packageDir, "package.json"), "utf8")).version;
221
+ return typeof version === "string" ? version : null;
222
+ } catch {
223
+ return null;
224
+ }
225
+ }
226
+
227
+ function runCli(command, args, cwd) {
228
+ return new Promise((resolve) => {
229
+ let child;
230
+ try {
231
+ child = spawn(command, args, { cwd, stdio: "ignore", windowsHide: true });
232
+ } catch (error) {
233
+ resolve({ code: -1, error: error.message });
234
+ return;
235
+ }
236
+ const timer = setTimeout(() => child.kill(), 5 * 60 * 1000);
237
+ child.on("error", (error) => { clearTimeout(timer); resolve({ code: -1, error: error.message }); });
238
+ child.on("exit", (code) => { clearTimeout(timer); resolve({ code }); });
239
+ });
240
+ }
241
+
242
+ /** Records that this version loaded after an update and removes the copy kept for rollback. */
243
+ export function confirmLoaded(version, environment = process.env) {
244
+ const update = readState(environment).update;
245
+ if (update?.status !== "installed" || update.to !== version) return false;
246
+ if (update.previous) rmSync(update.previous, { recursive: true, force: true });
247
+ writeState({ update: { ...update, status: "applied", appliedAt: new Date().toISOString(), previous: undefined } }, environment);
248
+ return true;
249
+ }
250
+
251
+ /**
252
+ * One update check. `install` is v1Install's or v2Install's result (or a function
253
+ * returning one); returns a short result, which is also recorded in the state file.
254
+ */
255
+ export async function checkForUpdate({
256
+ version, capabilities, install, settings, fetchImpl = fetch, cli = runCli, opencode = process.execPath, cwd,
257
+ environment = process.env, mcpUrl = "https://os.hz.egbe.dev/mcp",
258
+ }) {
259
+ const record = (fields) => {
260
+ const update = { ...readState(environment).update, checkedAt: new Date().toISOString(), running: version, ...fields };
261
+ writeState({ update }, environment);
262
+ return fields.result;
263
+ };
264
+ confirmLoaded(version, environment);
265
+ if (!settings.enabled) return record({ result: `off: ${settings.error ?? "autoUpdate is false"}` });
266
+ const where = typeof install === "function" ? await install() : install;
267
+ if (where.kind === "folder") return record({ result: "skipped: installed from a folder; update it with git pull" });
268
+ if (where.kind === "pinned") return record({ result: `skipped: pinned to ${where.spec}` });
269
+ if (where.kind !== "npm") return record({ result: "skipped: install not recognized" });
270
+ const release = lock(stateDir(environment));
271
+ if (!release) return record({ result: "skipped: another update is running" });
272
+ let staged;
273
+ try {
274
+ const packument = JSON.parse((await fetchLimited(fetchImpl, `${settings.registry}/${PACKAGE.replace("/", "%2f")}`,
275
+ MAX_PACKUMENT, "application/json")).toString("utf8"));
276
+ const latest = packument["dist-tags"]?.latest;
277
+ if (typeof latest !== "string" || compareVersions(latest, version) <= 0) return record({ result: "current", latest });
278
+ // OpenCode 1.x loads a swapped-in copy only at its next start; until then this process
279
+ // runs the old version, so the copy on disk, not the running one, says what is installed.
280
+ const onDisk = where.packageDir ? installedVersion(where.packageDir) : null;
281
+ if (onDisk && compareVersions(latest, onDisk) <= 0) {
282
+ return record({ result: `installed ${onDisk}; OpenCode loads it at its next start`, latest });
283
+ }
284
+ const declared = packument.versions?.[latest]?.egbe?.capabilities;
285
+ if (!sameCapabilities(declared, capabilities)) {
286
+ return record({
287
+ result: `manual: ${latest} changes the plugin's capabilities; update it by hand`, latest, status: "manual",
288
+ });
289
+ }
290
+ if (where.packageDir) {
291
+ // OpenCode 1.x: stage beside OpenCode's copy, so the swap is a rename on one disk.
292
+ const scope = path.dirname(where.packageDir);
293
+ const suffix = randomBytes(4).toString("hex");
294
+ staged = await stage({ registry: settings.registry, packument, version: latest, capabilities, fetchImpl, mcpUrl,
295
+ stagingDir: path.join(scope, `.opencode-${latest}-${suffix}`) });
296
+ // A copy swapped in earlier that OpenCode hasn't loaded yet is replaced; the rollback copy
297
+ // stays the version that actually runs, so it is kept and stays tracked.
298
+ const pending = readState(environment).update;
299
+ // The rollback copy stays recorded until the new version loads, even if a check failed meanwhile.
300
+ const keep = onDisk && compareVersions(onDisk, version) > 0 && pending?.previous
301
+ && existsSync(pending.previous) ? pending.previous : null;
302
+ const previous = keep ?? path.join(scope, `.opencode-previous-${version}-${suffix}`);
303
+ const displaced = keep ? path.join(scope, `.opencode-unloaded-${onDisk}-${suffix}`) : previous;
304
+ renameSync(where.packageDir, displaced);
305
+ try {
306
+ renameSync(staged, where.packageDir);
307
+ } catch (error) {
308
+ renameSync(displaced, where.packageDir);
309
+ throw error;
310
+ }
311
+ staged = undefined;
312
+ if (keep) rmSync(displaced, { recursive: true, force: true });
313
+ return record({ result: `installed ${latest}; OpenCode loads it at its next start`, latest, status: "installed",
314
+ from: version, to: latest, previous, at: new Date().toISOString() });
315
+ }
316
+ // OpenCode 2.x: verify the same way, then let OpenCode install it with its own npm installer.
317
+ staged = await stage({ registry: settings.registry, packument, version: latest, capabilities, fetchImpl, mcpUrl,
318
+ stagingDir: path.join(stateDir(environment), `opencode-staging-${randomBytes(4).toString("hex")}`) });
319
+ const run = await cli(opencode, ["plugin", "update", where.target], cwd);
320
+ if (run.code !== 0) {
321
+ return record({ result: `failed: opencode plugin update exited with ${run.code}${run.error ? ` (${run.error})` : ""}`,
322
+ latest, status: "failed" });
323
+ }
324
+ return record({ result: `installed ${latest} through opencode plugin update`, latest, status: "installed",
325
+ from: version, to: latest, at: new Date().toISOString() });
326
+ } catch (error) {
327
+ return record({ result: `failed: ${error?.message ?? error}`, status: "failed" });
328
+ } finally {
329
+ if (staged) rmSync(staged, { recursive: true, force: true });
330
+ release();
331
+ }
332
+ }
333
+
334
+ /** Runs checks a while after loading and then periodically; timers never keep OpenCode alive. */
335
+ export function scheduleUpdates({ settings, check, setTimer = setTimeout, setRepeat = setInterval }) {
336
+ if (!settings.enabled) return () => {};
337
+ let running = false;
338
+ const run = async () => {
339
+ if (running) return;
340
+ running = true;
341
+ try {
342
+ await check();
343
+ } catch {
344
+ // checkForUpdate records its own failures.
345
+ } finally {
346
+ running = false;
347
+ }
348
+ };
349
+ let repeat;
350
+ const first = setTimer(() => {
351
+ void run();
352
+ repeat = setRepeat(run, settings.intervalMs);
353
+ repeat?.unref?.();
354
+ }, settings.initialDelayMs);
355
+ first?.unref?.();
356
+ return () => {
357
+ clearTimeout(first);
358
+ if (repeat) clearInterval(repeat);
359
+ };
360
+ }
361
+