wyrm-mcp 7.3.2 → 7.4.0

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 (200) hide show
  1. package/README.md +12 -18
  2. package/dist/activation.js +59 -1
  3. package/dist/agent-daemon.js +281 -4
  4. package/dist/agent-loop.js +332 -7
  5. package/dist/analytics.js +236 -13
  6. package/dist/attribution.js +49 -1
  7. package/dist/audit.js +457 -2
  8. package/dist/auto-capture.js +138 -3
  9. package/dist/auto-orchestrator.js +325 -1
  10. package/dist/autoconfig.d.ts +51 -0
  11. package/dist/autoconfig.d.ts.map +1 -1
  12. package/dist/autoconfig.js +1121 -39
  13. package/dist/autoconfig.js.map +1 -1
  14. package/dist/buddy-runner.js +109 -1
  15. package/dist/buddy.js +564 -14
  16. package/dist/build-flags.js +15 -1
  17. package/dist/capabilities.js +183 -3
  18. package/dist/capture.js +56 -1
  19. package/dist/causality.js +148 -8
  20. package/dist/cli.js +281 -20
  21. package/dist/cloud/cli.js +541 -5
  22. package/dist/cloud/client.js +221 -1
  23. package/dist/cloud/crypto.js +85 -1
  24. package/dist/cloud/machine-id.js +113 -2
  25. package/dist/cloud/recovery.js +60 -1
  26. package/dist/cloud/sync-engine.js +543 -7
  27. package/dist/cloud-backup.js +579 -5
  28. package/dist/cloud-profile.js +138 -1
  29. package/dist/cloud-sync-entrypoint.js +47 -1
  30. package/dist/cloud-sync.js +309 -2
  31. package/dist/connectors/bridge-source.d.ts +46 -0
  32. package/dist/connectors/bridge-source.d.ts.map +1 -0
  33. package/dist/connectors/bridge-source.js +77 -0
  34. package/dist/connectors/bridge-source.js.map +1 -0
  35. package/dist/connectors/index.d.ts +24 -0
  36. package/dist/connectors/index.d.ts.map +1 -0
  37. package/dist/connectors/index.js +69 -0
  38. package/dist/connectors/index.js.map +1 -0
  39. package/dist/connectors/ingest.d.ts +16 -0
  40. package/dist/connectors/ingest.d.ts.map +1 -0
  41. package/dist/connectors/ingest.js +116 -0
  42. package/dist/connectors/ingest.js.map +1 -0
  43. package/dist/connectors/types.d.ts +99 -0
  44. package/dist/connectors/types.d.ts.map +1 -0
  45. package/dist/connectors/types.js +17 -0
  46. package/dist/connectors/types.js.map +1 -0
  47. package/dist/constellation.js +168 -12
  48. package/dist/content-signature.js +45 -1
  49. package/dist/context-build-budgeted.js +144 -4
  50. package/dist/context-ranking.js +69 -1
  51. package/dist/crypto.js +179 -1
  52. package/dist/daemon-write-endpoint.js +290 -1
  53. package/dist/daemon-writer.js +406 -2
  54. package/dist/database.js +1278 -53
  55. package/dist/deprecations.js +162 -2
  56. package/dist/design.js +141 -13
  57. package/dist/event-replication.js +112 -1
  58. package/dist/events-sse.js +43 -7
  59. package/dist/events.js +238 -6
  60. package/dist/failure-patterns.d.ts +107 -0
  61. package/dist/failure-patterns.d.ts.map +1 -1
  62. package/dist/failure-patterns.js +924 -43
  63. package/dist/failure-patterns.js.map +1 -1
  64. package/dist/federation.js +236 -12
  65. package/dist/goals.js +101 -13
  66. package/dist/golden.js +355 -3
  67. package/dist/handlers/agent.js +165 -4
  68. package/dist/handlers/alias-adapters.js +129 -1
  69. package/dist/handlers/aliases.js +171 -1
  70. package/dist/handlers/audit.js +87 -1
  71. package/dist/handlers/boundary.js +221 -1
  72. package/dist/handlers/capture.js +1114 -73
  73. package/dist/handlers/causality.js +119 -9
  74. package/dist/handlers/cloud.js +382 -85
  75. package/dist/handlers/companion.js +459 -28
  76. package/dist/handlers/datalake.js +187 -7
  77. package/dist/handlers/dispatch-context.js +22 -0
  78. package/dist/handlers/entity.js +256 -25
  79. package/dist/handlers/events.js +335 -16
  80. package/dist/handlers/failure.d.ts +1 -0
  81. package/dist/handlers/failure.d.ts.map +1 -1
  82. package/dist/handlers/failure.js +458 -13
  83. package/dist/handlers/failure.js.map +1 -1
  84. package/dist/handlers/goals.js +296 -4
  85. package/dist/handlers/intelligence.d.ts.map +1 -1
  86. package/dist/handlers/intelligence.js +690 -126
  87. package/dist/handlers/intelligence.js.map +1 -1
  88. package/dist/handlers/invoicing.js +70 -1
  89. package/dist/handlers/mcpclient.js +137 -6
  90. package/dist/handlers/orchestration.js +125 -40
  91. package/dist/handlers/output-schemas.js +24 -1
  92. package/dist/handlers/presence.js +99 -3
  93. package/dist/handlers/project.js +182 -28
  94. package/dist/handlers/prompts.js +157 -6
  95. package/dist/handlers/quest.js +224 -4
  96. package/dist/handlers/recall.js +237 -13
  97. package/dist/handlers/registry.js +167 -1
  98. package/dist/handlers/resources.js +288 -1
  99. package/dist/handlers/review.js +74 -11
  100. package/dist/handlers/run.js +498 -16
  101. package/dist/handlers/search.js +338 -15
  102. package/dist/handlers/session.js +643 -31
  103. package/dist/handlers/share.js +184 -8
  104. package/dist/handlers/shims.js +464 -1
  105. package/dist/handlers/skill.js +449 -67
  106. package/dist/handlers/survivors.js +120 -1
  107. package/dist/handlers/symbols.js +109 -8
  108. package/dist/handlers/syncops.js +302 -4
  109. package/dist/handlers/types.js +27 -1
  110. package/dist/harvest.js +191 -5
  111. package/dist/hours.js +156 -7
  112. package/dist/http-auth.js +321 -3
  113. package/dist/http-fast.d.ts.map +1 -1
  114. package/dist/http-fast.js +1308 -22
  115. package/dist/http-fast.js.map +1 -1
  116. package/dist/icons.js +47 -1
  117. package/dist/importers.js +268 -1
  118. package/dist/index.js +844 -2
  119. package/dist/index.js.map +1 -1
  120. package/dist/indexer.js +145 -4
  121. package/dist/intelligence.d.ts +16 -0
  122. package/dist/intelligence.d.ts.map +1 -1
  123. package/dist/intelligence.js +283 -31
  124. package/dist/intelligence.js.map +1 -1
  125. package/dist/internal-dispatch.js +212 -3
  126. package/dist/keyset.js +110 -1
  127. package/dist/knowledge-graph.js +176 -12
  128. package/dist/license.js +441 -2
  129. package/dist/logger.js +199 -2
  130. package/dist/maintenance.js +148 -2
  131. package/dist/mcp-client.js +262 -6
  132. package/dist/memory-artifacts.js +596 -32
  133. package/dist/migrate-prompt.js +124 -2
  134. package/dist/migrations.d.ts.map +1 -1
  135. package/dist/migrations.js +799 -42
  136. package/dist/migrations.js.map +1 -1
  137. package/dist/performance.js +228 -1
  138. package/dist/presence.js +140 -11
  139. package/dist/priority-embed.js +164 -5
  140. package/dist/providers/embedding-provider.js +196 -1
  141. package/dist/readonly-gate.js +29 -1
  142. package/dist/receipt.js +43 -1
  143. package/dist/rehydration.js +157 -9
  144. package/dist/reindex.js +88 -1
  145. package/dist/render-target.js +544 -21
  146. package/dist/render.js +280 -4
  147. package/dist/repl-guard.js +173 -1
  148. package/dist/replication-daemon-entrypoint.js +31 -1
  149. package/dist/replication-daemon.js +262 -2
  150. package/dist/rerank.js +142 -1
  151. package/dist/resilience.js +591 -1
  152. package/dist/reverse-bridge.js +360 -5
  153. package/dist/security.js +244 -1
  154. package/dist/session-seen.js +51 -3
  155. package/dist/setup.js +260 -1
  156. package/dist/skill-author.js +168 -5
  157. package/dist/spec-kit.js +191 -1
  158. package/dist/sqlite-busy.js +154 -1
  159. package/dist/statusline.js +315 -11
  160. package/dist/sub-agent.js +262 -13
  161. package/dist/summarizer.js +139 -13
  162. package/dist/symbols.js +283 -7
  163. package/dist/sync.js +359 -5
  164. package/dist/tasks-dispatch.js +84 -1
  165. package/dist/tasks.js +282 -1
  166. package/dist/token-budget.js +143 -1
  167. package/dist/tool-analytics.js +129 -7
  168. package/dist/tool-annotations.js +365 -1
  169. package/dist/tool-manifest-v2.json +1 -1
  170. package/dist/tool-manifest.json +1 -1
  171. package/dist/tool-profiles.js +75 -1
  172. package/dist/trace-harvest.js +244 -6
  173. package/dist/truth-cascade.d.ts +13 -0
  174. package/dist/truth-cascade.d.ts.map +1 -0
  175. package/dist/truth-cascade.js +4 -0
  176. package/dist/truth-cascade.js.map +1 -0
  177. package/dist/types.js +30 -1
  178. package/dist/ui-dashboard.js +50 -41
  179. package/dist/ulid.js +81 -1
  180. package/dist/usage-tracker.js +66 -1
  181. package/dist/validate.js +129 -1
  182. package/dist/vault.js +534 -1
  183. package/dist/vector-init.js +67 -1
  184. package/dist/vectors.js +184 -3
  185. package/dist/version-check.d.ts.map +1 -1
  186. package/dist/version-check.js +145 -4
  187. package/dist/version-check.js.map +1 -1
  188. package/dist/visibility.js +155 -19
  189. package/dist/wyrm-cli.js +2849 -101
  190. package/dist/wyrm-cli.js.map +1 -1
  191. package/dist/wyrm-guard.d.ts.map +1 -1
  192. package/dist/wyrm-guard.js +475 -14
  193. package/dist/wyrm-guard.js.map +1 -1
  194. package/dist/wyrm-loop.js +174 -3
  195. package/dist/wyrm-loop.js.map +1 -1
  196. package/dist/wyrm-manifest.json +1 -1
  197. package/dist/wyrm-statusline-daemon.js +11 -1
  198. package/dist/wyrm-statusline.js +56 -4
  199. package/dist/wyrm-ui.js +77 -9
  200. package/package.json +3 -2
package/README.md CHANGED
@@ -3,14 +3,14 @@
3
3
  > Persistent memory is table stakes. The real problem is what agents *do* with it — Wyrm blocks the repeat, keeps decisions true, and learns as a fleet. Memory is the substrate; the judgment is the moat.
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/wyrm-mcp?color=00B89F&label=npm)](https://www.npmjs.com/package/wyrm-mcp)
6
- [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-00B89F.svg)](LICENSE)
7
- [![Tests](https://img.shields.io/badge/tests-1820%20passing-00B89F)](https://github.com/Ghosts-Protocol-Pvt-Ltd/Wyrm)
6
+ [![License: Proprietary](https://img.shields.io/badge/License-Proprietary-b91c1c.svg)](LICENSE)
7
+ [![Tests](https://img.shields.io/badge/tests-1901%20passing-00B89F)](https://github.com/Ghosts-Protocol-Pvt-Ltd/Wyrm)
8
8
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
9
9
  [![MCP](https://img.shields.io/badge/MCP-compatible-00B89F)](https://modelcontextprotocol.io)
10
10
 
11
11
  **[wyrm.ghosts.lk](https://wyrm.ghosts.lk)**  ·  **[npm](https://www.npmjs.com/package/wyrm-mcp)**  ·  **[GitHub](https://github.com/Ghosts-Protocol-Pvt-Ltd/Wyrm)**  ·  **[Ghost Protocol](https://ghosts.lk)**  ·  `npm i -g wyrm-mcp`
12
12
 
13
- Local-first persistent memory for AI agents over MCP — by [Ghost Protocol](https://ghosts.lk). Runs fully offline on your machine: no cloud, no account, no LLM required. The managed cloud tier lives at **[wyrm.ghosts.lk](https://wyrm.ghosts.lk)**.
13
+ Local-first persistent memory for AI agents over MCP — by [Ghost Protocol](https://ghosts.lk). Runs fully offline on your machine: no cloud, no LLM required. The official build activates with a one-time free `wyrm login`; your memory stays local either way. The managed cloud tier lives at **[wyrm.ghosts.lk](https://wyrm.ghosts.lk)**.
14
14
 
15
15
  ---
16
16
 
@@ -230,7 +230,7 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
230
230
 
231
231
  </details>
232
232
 
233
- Or run **`wyrm-setup`** to auto-detect and configure all installed AI clients at once.
233
+ Or run **`wyrm-setup`** to auto-detect and configure every supported AI client at once (VS Code Copilot, Claude Desktop, Cursor, Windsurf, Zed, Continue, plus Claude Code hooks).
234
234
 
235
235
  ### 3. Enable Semantic Search (Optional but Recommended)
236
236
 
@@ -263,7 +263,7 @@ Once connected, your AI has access to all Wyrm tools. Try:
263
263
 
264
264
  ## MCP Tools Reference
265
265
 
266
- Wyrm exposes 38 tools via the Model Context Protocol:
266
+ Wyrm exposes a frozen 32-verb typed surface (137 tools callable) via the Model Context Protocol:
267
267
 
268
268
  ### Projects
269
269
 
@@ -320,7 +320,7 @@ Wyrm exposes 38 tools via the Model Context Protocol:
320
320
  | `wyrm_stats` | Database statistics and health |
321
321
  | `wyrm_usage` | Token usage stats, cache hit rates, and cost estimates |
322
322
  | `wyrm_maintenance` | Vacuum, archive old data, optimize indexes |
323
- | `wyrm_setup` | Auto-configure Wyrm in all detected AI clients |
323
+ | `wyrm_setup` | Auto-configure Wyrm in every supported AI client it detects |
324
324
 
325
325
  ### Auto-Orchestration
326
326
 
@@ -485,26 +485,20 @@ Wyrm/
485
485
 
486
486
  ## Contributing
487
487
 
488
- Contributions are welcome! Here's how:
488
+ Wyrm is a **proprietary repository** — free to use, but not open to external contributions. We do **not** accept forks or external pull requests.
489
489
 
490
- 1. **Fork** the repository
491
- 2. **Create** a feature branch (`git checkout -b feat/amazing-feature`)
492
- 3. **Commit** your changes (`git commit -m 'feat: add amazing feature'`)
493
- 4. **Push** to the branch (`git push origin feat/amazing-feature`)
494
- 5. **Open** a Pull Request
495
-
496
- Please ensure tests pass (`npm test`) and the project builds (`npm run build`) before submitting.
490
+ Issues and bug reports are welcome: please open an issue or email ryan@ghosts.lk.
497
491
 
498
492
  ---
499
493
 
500
494
  ## Security
501
495
 
502
- - **Local-only** — All data stored on your machine. Nothing leaves by default.
496
+ - **Local-only** — All your data stays on your machine. The only default outbound call is a once-a-day npm version check (no data sent beyond the request itself; opt out with `WYRM_NO_VERSION_CHECK=1`).
503
497
  - **No telemetry** — Zero data collection, zero phone-home.
504
498
  - **Optional encryption** — AES-256-GCM for sensitive context data.
505
499
  - **Audited** — Security audits documented in [SECURITY_AUDIT.md](SECURITY_AUDIT.md) and [SECURITY_AUDIT_V2.md](SECURITY_AUDIT_V2.md).
506
500
 
507
- Found a vulnerability? Please open an issue or email security@ghosts.lk.
501
+ Found a vulnerability? Please open an issue or email ryan@ghosts.lk.
508
502
 
509
503
  ---
510
504
 
@@ -513,9 +507,9 @@ Found a vulnerability? Please open an issue or email security@ghosts.lk.
513
507
  **Open standard + protected implementation:**
514
508
 
515
509
  - **The Wyrm Memory Protocol** ([`PROTOCOL.md`](../../PROTOCOL.md)) is an **open spec, freely implementable** by anyone (CC-BY-4.0) — build a WMP-compatible memory without touching Wyrm's code.
516
- - **This implementation** (`wyrm-mcp`) is **[AGPL-3.0-or-later](LICENSE)** — Copyright © 2024-2026 [Ghost Protocol (Pvt) Ltd](https://ghosts.lk).
510
+ - **This implementation** (`wyrm-mcp`) is **[Proprietary Freeware](LICENSE)** — free to use, all rights reserved. Copyright © 2024-2026 [Ghost Protocol (Pvt) Ltd](https://ghosts.lk).
517
511
 
518
- For a **commercial license** (embedding Wyrm in a closed product, or running it as a managed service without AGPL's source-sharing obligations), contact [ghosts.lk@proton.me](mailto:ghosts.lk@proton.me).
512
+ For a **commercial license** (embedding Wyrm in a closed product, or running it as a managed service), contact [ryan@ghosts.lk](mailto:ryan@ghosts.lk).
519
513
 
520
514
  ---
521
515
 
@@ -1 +1,59 @@
1
- import{getLicenseInfo as r,selfTestVerifier as n}from"./license.js";import{OFFICIAL_BUILD as e}from"./build-flags.js";const i=e||/^(1|true|yes|on)$/i.test(process.env.WYRM_REQUIRE_ACTIVATION??""),t=e?!n().ok:!1;if(t)try{console.error("Wyrm: integrity self-test FAILED \u2014 license verifier tampered; activation gate locked.")}catch{}function s(){return t?!1:!i||r().valid}function c(){return{content:[{type:"text",text:"\u{1F512} Wyrm requires a free account on this build.\n\nRun `wyrm login` in your terminal to sign in and activate (free). Your memory stays local \u2014 login just ties usage to an account so it can be managed.\n\nAlready logged in? Your activation may have expired \u2014 run `wyrm login` again to refresh."}],isError:!0}}export{i as REQUIRE_ACTIVATION,c as activationGateResult,s as activationSatisfied};
1
+ /**
2
+ * Activation gate for account-required builds.
3
+ *
4
+ * OFF by default in source — the test suite and local dev builds are unaffected.
5
+ * The OFFICIAL distribution bakes `WYRM_REQUIRE_ACTIVATION=1`, so the free tier
6
+ * needs a (free) account: `wyrm login` fetches a short-lived, account-bound signed
7
+ * license that's validated locally by license.ts. A suspended account can't
8
+ * refresh, so access lapses at expiry. Memory is local either way — login only
9
+ * ties usage to a revocable identity. (Wyrm is proprietary; see LICENSE.)
10
+ *
11
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd.
12
+ * @license Proprietary — (c) 2026 Ghost Protocol (Pvt) Ltd. All rights reserved. See LICENSE.
13
+ */
14
+ import { getLicenseInfo, selfTestVerifier } from './license.js';
15
+ import { OFFICIAL_BUILD } from './build-flags.js';
16
+ /**
17
+ * Whether the account-required gate is enabled on this build. ON when this is the
18
+ * official published artifact (OFFICIAL_BUILD baked true at release), OR when the
19
+ * operator opts in via WYRM_REQUIRE_ACTIVATION. OFF in source + tests.
20
+ */
21
+ export const REQUIRE_ACTIVATION = OFFICIAL_BUILD || /^(1|true|yes|on)$/i.test(process.env.WYRM_REQUIRE_ACTIVATION ?? '');
22
+ /**
23
+ * Tamper-evidence: on the official build, verify at load that the license verifier
24
+ * still rejects a forged signature. If it doesn't, someone stubbed the verifier to
25
+ * bypass the gate — so we keep the gate CLOSED regardless of what getLicenseInfo()
26
+ * now claims. A determined forker can remove this too (patching the closed, minified dist) — a
27
+ * deterrent, not a guarantee.
28
+ */
29
+ const TAMPERED = OFFICIAL_BUILD ? !selfTestVerifier().ok : false;
30
+ if (TAMPERED) {
31
+ try {
32
+ console.error('Wyrm: integrity self-test FAILED — license verifier tampered; activation gate locked.');
33
+ }
34
+ catch { /* noop */ }
35
+ }
36
+ /**
37
+ * True when tool execution is permitted. Always true unless the build requires
38
+ * activation AND no valid (free or paid) account-bound license is loaded.
39
+ * Re-checked live so a mid-session `wyrm login` takes effect without a restart.
40
+ */
41
+ export function activationSatisfied() {
42
+ if (TAMPERED)
43
+ return false; // verifier subverted → never satisfy the gate
44
+ return !REQUIRE_ACTIVATION || getLicenseInfo().valid;
45
+ }
46
+ /** The MCP error result returned for any tool call while activation is unmet. */
47
+ export function activationGateResult() {
48
+ return {
49
+ content: [{
50
+ type: 'text',
51
+ text: '🔒 Wyrm requires a free account on this build.\n\n'
52
+ + 'Run `wyrm login` in your terminal to sign in and activate (free). '
53
+ + 'Your memory stays local — login just ties usage to an account so it can be managed.\n\n'
54
+ + 'Already logged in? Your activation may have expired — run `wyrm login` again to refresh.',
55
+ }],
56
+ isError: true,
57
+ };
58
+ }
59
+ //# sourceMappingURL=activation.js.map
@@ -1,6 +1,283 @@
1
- import{spawn as E}from"child_process";import{existsSync as l,readFileSync as g,writeFileSync as I,statSync as w,openSync as M,closeSync as h,renameSync as v,unlinkSync as f,mkdirSync as O}from"fs";import{homedir as R}from"os";import{join as d,dirname as S,resolve as k}from"path";import{fileURLToPath as b}from"url";const m=d(R(),".wyrm"),i=d(m,"wyrm-loop.pid"),u=d(m,"wyrm-loop.log"),_=d(m,"wyrm-loop.log.1"),D=1e6;function T(){l(m)||O(m,{recursive:!0})}function C(){try{l(u)&&w(u).size>D&&(l(_)&&f(_),v(u,_))}catch{}}function L(){try{const p=g(i,"utf-8").trim(),t=parseInt(p,10);return Number.isFinite(t)&&t>0?t:null}catch{return null}}function y(p){try{return process.kill(p,0),!0}catch{return!1}}function F(){try{const t=b(import.meta.url),r=[k(S(t),"wyrm-loop.js"),k(S(t),"..","dist","wyrm-loop.js")];for(const n of r)if(l(n))return n}catch{}const p=(process.env.PATH??"").split(":");for(const t of p){const r=d(t,"wyrm-loop");if(l(r))return r}return null}class A{db;constructor(t){this.db=t}status(){const t=L(),r=t!=null&&y(t);let n,a;try{if(l(i)){const s=w(i);n=s.mtime.toISOString(),a=Math.round((Date.now()-s.mtime.getTime())/1e3)}}catch{}let e;try{const s=this.db.prepare(`
1
+ /**
2
+ * Agent daemon process manager.
3
+ *
4
+ * Lets an AI client (Claude / Codex / Cursor / etc.) bootstrap, monitor,
5
+ * and tear down the `wyrm-loop` autonomous scheduler without the
6
+ * operator running shell commands. The MCP server can spawn the daemon
7
+ * as a detached background process, write a PID + log file under
8
+ * `~/.wyrm/`, and check liveness on demand.
9
+ *
10
+ * Files (all under `~/.wyrm/`):
11
+ * wyrm-loop.pid PID of the running daemon (single-line)
12
+ * wyrm-loop.log Stdout/stderr of the daemon (rotated at 1MB)
13
+ *
14
+ * Single-instance guarantee — if a PID file exists and the process is
15
+ * alive, `start()` refuses (no fork-bomb). `restart()` is provided as
16
+ * an explicit operation.
17
+ *
18
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd.
19
+ * @license Proprietary — (c) 2026 Ghost Protocol (Pvt) Ltd. All rights reserved. See LICENSE.
20
+ */
21
+ import { spawn } from 'child_process';
22
+ import { existsSync, readFileSync, writeFileSync, statSync, openSync, closeSync, renameSync, unlinkSync, mkdirSync } from 'fs';
23
+ import { homedir } from 'os';
24
+ import { join, dirname, resolve } from 'path';
25
+ import { fileURLToPath } from 'url';
26
+ const WYRM_DIR = join(homedir(), '.wyrm');
27
+ const PID_FILE = join(WYRM_DIR, 'wyrm-loop.pid');
28
+ const LOG_FILE = join(WYRM_DIR, 'wyrm-loop.log');
29
+ const LOG_FILE_OLD = join(WYRM_DIR, 'wyrm-loop.log.1');
30
+ const MAX_LOG_BYTES = 1_000_000;
31
+ function ensureWyrmDir() {
32
+ if (!existsSync(WYRM_DIR))
33
+ mkdirSync(WYRM_DIR, { recursive: true });
34
+ }
35
+ function rotateLogIfLarge() {
36
+ try {
37
+ if (existsSync(LOG_FILE) && statSync(LOG_FILE).size > MAX_LOG_BYTES) {
38
+ if (existsSync(LOG_FILE_OLD))
39
+ unlinkSync(LOG_FILE_OLD);
40
+ renameSync(LOG_FILE, LOG_FILE_OLD);
41
+ }
42
+ }
43
+ catch { /* best-effort */ }
44
+ }
45
+ function readPid() {
46
+ try {
47
+ const raw = readFileSync(PID_FILE, 'utf-8').trim();
48
+ const pid = parseInt(raw, 10);
49
+ return Number.isFinite(pid) && pid > 0 ? pid : null;
50
+ }
51
+ catch {
52
+ return null;
53
+ }
54
+ }
55
+ function isProcessAlive(pid) {
56
+ try {
57
+ // signal 0 doesn't kill; just checks existence + permission
58
+ process.kill(pid, 0);
59
+ return true;
60
+ }
61
+ catch {
62
+ return false;
63
+ }
64
+ }
65
+ /** Find the bundled `wyrm-loop` script path. Resolves relative to this
66
+ * module so it works whether installed via npm, run from source, or
67
+ * invoked from a global symlink. */
68
+ function locateLoopBinary() {
69
+ // 1. import.meta.url → packages/mcp-server/dist/agent-daemon.js
70
+ try {
71
+ const here = fileURLToPath(import.meta.url);
72
+ const candidates = [
73
+ // installed alongside (dist/wyrm-loop.js)
74
+ resolve(dirname(here), 'wyrm-loop.js'),
75
+ // source layout
76
+ resolve(dirname(here), '..', 'dist', 'wyrm-loop.js'),
77
+ ];
78
+ for (const p of candidates) {
79
+ if (existsSync(p))
80
+ return p;
81
+ }
82
+ }
83
+ catch { /* fall through */ }
84
+ // 2. Look in PATH for the `wyrm-loop` binary (set up by `npm install -g`)
85
+ const pathDirs = (process.env.PATH ?? '').split(':');
86
+ for (const dir of pathDirs) {
87
+ const cand = join(dir, 'wyrm-loop');
88
+ if (existsSync(cand))
89
+ return cand;
90
+ }
91
+ return null;
92
+ }
93
+ export class AgentDaemon {
94
+ db;
95
+ constructor(db) {
96
+ this.db = db;
97
+ }
98
+ /** Current daemon status. Always safe to call. */
99
+ status() {
100
+ const pid = readPid();
101
+ const running = pid != null && isProcessAlive(pid);
102
+ let started_at;
103
+ let uptime_seconds;
104
+ try {
105
+ if (existsSync(PID_FILE)) {
106
+ const st = statSync(PID_FILE);
107
+ started_at = st.mtime.toISOString();
108
+ uptime_seconds = Math.round((Date.now() - st.mtime.getTime()) / 1000);
109
+ }
110
+ }
111
+ catch { /* best-effort */ }
112
+ // Read latest agent_actions row for "last action" summary
113
+ let last_action;
114
+ try {
115
+ const row = this.db.prepare(`
2
116
  SELECT actor, goal_id, action_kind, summary, result_status, ran_at
3
117
  FROM agent_actions ORDER BY id DESC LIMIT 1
4
- `).get();s&&(e={ran_at:s.ran_at,actor:s.actor,goal_id:s.goal_id,summary:`${s.action_kind}: ${s.summary}`.slice(0,200),result_status:s.result_status})}catch{}let o=0,c=0;try{o=this.db.prepare("SELECT COUNT(*) as c FROM goals WHERE status = 'active'").get().c,c=this.db.prepare("SELECT COALESCE(SUM(iterations_count), 0) as c FROM goals").get().c}catch{}return{running:r,pid:r?t:null,pid_file:i,log_file:u,started_at:r?n:void 0,uptime_seconds:r?a:void 0,last_action:e,active_goals:o,total_iterations:c}}start(t={}){T(),C();const r=this.status();if(r.running)return{ok:!0,pid:r.pid??void 0,status:r};if(l(i))try{f(i)}catch{}const n=F();if(!n)return{ok:!1,error:"Could not locate wyrm-loop binary. Run `npm install -g wyrm-mcp` or `npm run build` in packages/mcp-server."};const a=["--interval",String(t.interval_seconds??600)];t.max_steps&&a.push("--max-steps",String(t.max_steps)),t.project_path&&a.push("--project",t.project_path),t.verbose&&a.push("--verbose");let e;try{e=M(u,"a")}catch(c){return{ok:!1,error:`Could not open log file ${u}: ${c.message}`}}let o;try{o=E("node",[n,...a],{detached:!0,stdio:["ignore",e,e],env:{...process.env,WYRM_LOOP_LOG:t.verbose?"1":"0"}})}catch(c){return{ok:!1,error:`spawn failed: ${c.message}`}}if(!o.pid){try{h(e)}catch{}return{ok:!1,error:"spawn returned no PID"}}try{I(i,String(o.pid),"utf-8")}catch(c){try{process.kill(o.pid,"SIGTERM")}catch{}try{h(e)}catch{}return{ok:!1,error:`Could not write PID file: ${c.message}`}}try{h(e)}catch{}return o.unref(),{ok:!0,pid:o.pid,status:this.status()}}async stop(t={}){const r=L();if(r==null)return{ok:!0,was_running:!1};if(!y(r)){try{f(i)}catch{}return{ok:!0,was_running:!1,pid:r}}try{process.kill(r,"SIGTERM")}catch(e){return{ok:!1,was_running:!0,pid:r,error:`SIGTERM failed: ${e.message}`}}const n=Math.max(100,Math.min(t.grace_ms??3e3,3e4)),a=Date.now();for(;Date.now()-a<n&&y(r);)await new Promise(e=>{setTimeout(e,100)});if(y(r))try{process.kill(r,"SIGKILL")}catch{}try{f(i)}catch{}return{ok:!0,was_running:!0,pid:r}}async restart(t={}){return await this.stop({grace_ms:3e3}),this.start(t)}recentLog(t=40){try{return l(u)?g(u,"utf-8").split(`
5
- `).slice(-Math.max(1,Math.min(t,1e3))).join(`
6
- `):"(log file does not exist)"}catch(r){return`(could not read log: ${r.message})`}}}export{A as AgentDaemon};
118
+ `).get();
119
+ if (row)
120
+ last_action = {
121
+ ran_at: row.ran_at, actor: row.actor, goal_id: row.goal_id,
122
+ summary: `${row.action_kind}: ${row.summary}`.slice(0, 200),
123
+ result_status: row.result_status,
124
+ };
125
+ }
126
+ catch { /* table may not exist on pre-v5 DBs */ }
127
+ let active_goals = 0;
128
+ let total_iterations = 0;
129
+ try {
130
+ active_goals = this.db.prepare(`SELECT COUNT(*) as c FROM goals WHERE status = 'active'`).get().c;
131
+ total_iterations = this.db.prepare(`SELECT COALESCE(SUM(iterations_count), 0) as c FROM goals`).get().c;
132
+ }
133
+ catch { /* pre-v5 DB */ }
134
+ return {
135
+ running,
136
+ pid: running ? pid : null,
137
+ pid_file: PID_FILE,
138
+ log_file: LOG_FILE,
139
+ started_at: running ? started_at : undefined,
140
+ uptime_seconds: running ? uptime_seconds : undefined,
141
+ last_action,
142
+ active_goals,
143
+ total_iterations,
144
+ };
145
+ }
146
+ /** Start the daemon. No-op if already running. */
147
+ start(opts = {}) {
148
+ ensureWyrmDir();
149
+ rotateLogIfLarge();
150
+ const cur = this.status();
151
+ if (cur.running) {
152
+ return { ok: true, pid: cur.pid ?? undefined, status: cur };
153
+ }
154
+ // Clear stale PID file from a crashed prior run
155
+ if (existsSync(PID_FILE)) {
156
+ try {
157
+ unlinkSync(PID_FILE);
158
+ }
159
+ catch { /* ignore */ }
160
+ }
161
+ const binary = locateLoopBinary();
162
+ if (!binary) {
163
+ return { ok: false, error: 'Could not locate wyrm-loop binary. Run `npm install -g wyrm-mcp` or `npm run build` in packages/mcp-server.' };
164
+ }
165
+ const args = ['--interval', String(opts.interval_seconds ?? 600)];
166
+ if (opts.max_steps)
167
+ args.push('--max-steps', String(opts.max_steps));
168
+ if (opts.project_path)
169
+ args.push('--project', opts.project_path);
170
+ if (opts.verbose)
171
+ args.push('--verbose');
172
+ // Open the log file once, share fd with the child
173
+ let logFd;
174
+ try {
175
+ logFd = openSync(LOG_FILE, 'a');
176
+ }
177
+ catch (err) {
178
+ return { ok: false, error: `Could not open log file ${LOG_FILE}: ${err.message}` };
179
+ }
180
+ let child;
181
+ try {
182
+ child = spawn('node', [binary, ...args], {
183
+ detached: true,
184
+ stdio: ['ignore', logFd, logFd],
185
+ env: { ...process.env, WYRM_LOOP_LOG: opts.verbose ? '1' : '0' },
186
+ });
187
+ }
188
+ catch (err) {
189
+ return { ok: false, error: `spawn failed: ${err.message}` };
190
+ }
191
+ if (!child.pid) {
192
+ try {
193
+ closeSync(logFd);
194
+ }
195
+ catch { /* ignore */ }
196
+ return { ok: false, error: 'spawn returned no PID' };
197
+ }
198
+ try {
199
+ writeFileSync(PID_FILE, String(child.pid), 'utf-8');
200
+ }
201
+ catch (err) {
202
+ // Process is up but we can't track it — kill to keep state consistent
203
+ try {
204
+ process.kill(child.pid, 'SIGTERM');
205
+ }
206
+ catch { /* ignore */ }
207
+ try {
208
+ closeSync(logFd);
209
+ }
210
+ catch { /* ignore */ }
211
+ return { ok: false, error: `Could not write PID file: ${err.message}` };
212
+ }
213
+ // Close the parent's copy of the log fd — the child inherits its own
214
+ // dup via stdio. Without this, every successful spawn leaks one fd in
215
+ // the parent (the MCP server).
216
+ try {
217
+ closeSync(logFd);
218
+ }
219
+ catch { /* ignore */ }
220
+ // unref so this process doesn't wait on the child
221
+ child.unref();
222
+ // Brief settle delay so status() reflects the new state
223
+ return { ok: true, pid: child.pid, status: this.status() };
224
+ }
225
+ /** Stop the daemon. Sends SIGTERM, then SIGKILL after a grace period. */
226
+ async stop(opts = {}) {
227
+ const pid = readPid();
228
+ if (pid == null) {
229
+ return { ok: true, was_running: false };
230
+ }
231
+ if (!isProcessAlive(pid)) {
232
+ // Stale PID file
233
+ try {
234
+ unlinkSync(PID_FILE);
235
+ }
236
+ catch { /* ignore */ }
237
+ return { ok: true, was_running: false, pid };
238
+ }
239
+ try {
240
+ process.kill(pid, 'SIGTERM');
241
+ }
242
+ catch (err) {
243
+ return { ok: false, was_running: true, pid, error: `SIGTERM failed: ${err.message}` };
244
+ }
245
+ const grace = Math.max(100, Math.min(opts.grace_ms ?? 3000, 30_000));
246
+ const start = Date.now();
247
+ while (Date.now() - start < grace) {
248
+ if (!isProcessAlive(pid))
249
+ break;
250
+ await new Promise(r => { setTimeout(r, 100); });
251
+ }
252
+ if (isProcessAlive(pid)) {
253
+ try {
254
+ process.kill(pid, 'SIGKILL');
255
+ }
256
+ catch { /* may already be dead */ }
257
+ }
258
+ try {
259
+ unlinkSync(PID_FILE);
260
+ }
261
+ catch { /* ignore */ }
262
+ return { ok: true, was_running: true, pid };
263
+ }
264
+ /** Stop + Start in sequence. */
265
+ async restart(opts = {}) {
266
+ await this.stop({ grace_ms: 3000 });
267
+ return this.start(opts);
268
+ }
269
+ /** Read the last N lines of the daemon log. */
270
+ recentLog(lines = 40) {
271
+ try {
272
+ if (!existsSync(LOG_FILE))
273
+ return '(log file does not exist)';
274
+ const raw = readFileSync(LOG_FILE, 'utf-8');
275
+ const all = raw.split('\n');
276
+ return all.slice(-Math.max(1, Math.min(lines, 1000))).join('\n');
277
+ }
278
+ catch (err) {
279
+ return `(could not read log: ${err.message})`;
280
+ }
281
+ }
282
+ }
283
+ //# sourceMappingURL=agent-daemon.js.map