@phren/cli 0.3.10 → 0.3.12

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 (184) hide show
  1. package/dist/bridge/agent-hook-stores.d.ts +3 -0
  2. package/dist/bridge/agent-hook-stores.js +5 -0
  3. package/dist/bridge/agent-hooks.d.ts +159 -5
  4. package/dist/bridge/agent-hooks.js +663 -49
  5. package/dist/bridge/approval-summary.d.ts +16 -0
  6. package/dist/bridge/approval-summary.js +133 -0
  7. package/dist/bridge/authority-command.d.ts +20 -0
  8. package/dist/bridge/authority-command.js +120 -0
  9. package/dist/bridge/authority.d.ts +223 -0
  10. package/dist/bridge/authority.js +231 -0
  11. package/dist/bridge/claude-account-setup.d.ts +14 -0
  12. package/dist/bridge/claude-account-setup.js +69 -0
  13. package/dist/bridge/claude-accounts.d.ts +49 -0
  14. package/dist/bridge/claude-accounts.js +195 -0
  15. package/dist/bridge/code-routes.js +2 -2
  16. package/dist/bridge/codex-app-server.d.ts +144 -0
  17. package/dist/bridge/codex-app-server.js +319 -0
  18. package/dist/bridge/codex-auth-refresh.d.ts +33 -0
  19. package/dist/bridge/codex-auth-refresh.js +71 -0
  20. package/dist/bridge/codex-question-reply.d.ts +16 -0
  21. package/dist/bridge/codex-question-reply.js +57 -0
  22. package/dist/bridge/codex-review-mode.d.ts +10 -0
  23. package/dist/bridge/codex-review-mode.js +74 -0
  24. package/dist/bridge/codex-servers.d.ts +217 -0
  25. package/dist/bridge/codex-servers.js +636 -0
  26. package/dist/bridge/command.js +94 -4
  27. package/dist/bridge/computer-identity.d.ts +75 -0
  28. package/dist/bridge/computer-identity.js +166 -0
  29. package/dist/bridge/conductor-group.d.ts +91 -8
  30. package/dist/bridge/conductor-group.js +105 -9
  31. package/dist/bridge/conductor-role.d.ts +94 -0
  32. package/dist/bridge/conductor-role.js +176 -0
  33. package/dist/bridge/conductor-sets.d.ts +20 -0
  34. package/dist/bridge/conductor-sets.js +59 -0
  35. package/dist/bridge/dispatch-command.d.ts +3 -0
  36. package/dist/bridge/dispatch-command.js +75 -11
  37. package/dist/bridge/dispatch-returns.d.ts +123 -19
  38. package/dist/bridge/dispatch-returns.js +357 -50
  39. package/dist/bridge/dispatch.d.ts +103 -2
  40. package/dist/bridge/dispatch.js +272 -40
  41. package/dist/bridge/fanout-messages.js +2 -2
  42. package/dist/bridge/fanouts.d.ts +7 -1
  43. package/dist/bridge/fanouts.js +40 -5
  44. package/dist/bridge/folder-trust.d.ts +56 -0
  45. package/dist/bridge/folder-trust.js +195 -0
  46. package/dist/bridge/grants.d.ts +22 -1
  47. package/dist/bridge/grants.js +57 -9
  48. package/dist/bridge/hand-off.d.ts +21 -9
  49. package/dist/bridge/hand-off.js +58 -45
  50. package/dist/bridge/harness-status.d.ts +11 -0
  51. package/dist/bridge/harness-status.js +32 -0
  52. package/dist/bridge/harnesses.d.ts +39 -0
  53. package/dist/bridge/harnesses.js +65 -0
  54. package/dist/bridge/health.d.ts +2 -0
  55. package/dist/bridge/health.js +1 -1
  56. package/dist/bridge/herdr.d.ts +11 -2
  57. package/dist/bridge/herdr.js +98 -23
  58. package/dist/bridge/hook-fast.d.ts +4 -0
  59. package/dist/bridge/hook-fast.js +68 -0
  60. package/dist/bridge/install.d.ts +16 -1
  61. package/dist/bridge/install.js +88 -21
  62. package/dist/bridge/launch-brief.d.ts +96 -0
  63. package/dist/bridge/launch-brief.js +164 -0
  64. package/dist/bridge/model-switch.d.ts +3 -0
  65. package/dist/bridge/model-switch.js +17 -1
  66. package/dist/bridge/models.d.ts +8 -4
  67. package/dist/bridge/models.js +24 -8
  68. package/dist/bridge/mux-wire.d.ts +9 -0
  69. package/dist/bridge/mux-wire.js +19 -0
  70. package/dist/bridge/opencode-pane-server.d.ts +113 -0
  71. package/dist/bridge/opencode-pane-server.js +332 -0
  72. package/dist/bridge/opencode-panes.d.ts +111 -0
  73. package/dist/bridge/opencode-panes.js +295 -0
  74. package/dist/bridge/pane-accounts.d.ts +8 -0
  75. package/dist/bridge/pane-accounts.js +46 -0
  76. package/dist/bridge/prompt-startup.d.ts +5 -0
  77. package/dist/bridge/prompt-startup.js +24 -0
  78. package/dist/bridge/protocol.d.ts +5 -0
  79. package/dist/bridge/protocol.js +4 -0
  80. package/dist/bridge/push.d.ts +5 -4
  81. package/dist/bridge/push.js +6 -4
  82. package/dist/bridge/questions.d.ts +37 -2
  83. package/dist/bridge/questions.js +158 -15
  84. package/dist/bridge/resources.d.ts +125 -0
  85. package/dist/bridge/resources.js +314 -0
  86. package/dist/bridge/schedule-format.d.ts +2 -0
  87. package/dist/bridge/schedule-format.js +3 -0
  88. package/dist/bridge/schedule-launch.d.ts +2 -1
  89. package/dist/bridge/schedule-launch.js +23 -53
  90. package/dist/bridge/schedule-watch.d.ts +10 -1
  91. package/dist/bridge/schedule-watch.js +54 -2
  92. package/dist/bridge/server-launch.d.ts +22 -5
  93. package/dist/bridge/server-launch.js +225 -29
  94. package/dist/bridge/server-overview.d.ts +8 -2
  95. package/dist/bridge/server-overview.js +26 -5
  96. package/dist/bridge/server-pane-routes.d.ts +2 -0
  97. package/dist/bridge/server-pane-routes.js +145 -15
  98. package/dist/bridge/server-routes.d.ts +11 -1
  99. package/dist/bridge/server-routes.js +195 -36
  100. package/dist/bridge/server-stream.d.ts +2 -0
  101. package/dist/bridge/server-stream.js +22 -8
  102. package/dist/bridge/server.d.ts +6 -1
  103. package/dist/bridge/server.js +47 -12
  104. package/dist/bridge/session-activity.d.ts +81 -0
  105. package/dist/bridge/session-activity.js +117 -0
  106. package/dist/bridge/session-rename.d.ts +48 -0
  107. package/dist/bridge/session-rename.js +190 -0
  108. package/dist/bridge/session-servers.js +2 -2
  109. package/dist/bridge/settings-switch.d.ts +60 -0
  110. package/dist/bridge/settings-switch.js +287 -0
  111. package/dist/bridge/speech-voice.d.ts +55 -0
  112. package/dist/bridge/speech-voice.js +132 -0
  113. package/dist/bridge/speech.d.ts +70 -11
  114. package/dist/bridge/speech.js +169 -41
  115. package/dist/bridge/terminal-herdr.js +9 -3
  116. package/dist/bridge/terminal-tmux.d.ts +3 -3
  117. package/dist/bridge/terminal-tmux.js +24 -9
  118. package/dist/bridge/terminal.d.ts +27 -4
  119. package/dist/bridge/terminal.js +8 -1
  120. package/dist/bridge/transcript-claude.js +62 -12
  121. package/dist/bridge/transcript-codex.d.ts +0 -2
  122. package/dist/bridge/transcript-codex.js +29 -4
  123. package/dist/bridge/transcript-preview.d.ts +1 -0
  124. package/dist/bridge/transcript-preview.js +24 -4
  125. package/dist/bridge/transcripts.d.ts +15 -2
  126. package/dist/bridge/transcripts.js +47 -16
  127. package/dist/bridge/turn-records.d.ts +85 -0
  128. package/dist/bridge/turn-records.js +143 -0
  129. package/dist/bridge/uploads.d.ts +3 -0
  130. package/dist/bridge/uploads.js +14 -0
  131. package/dist/bridge/usage.d.ts +73 -28
  132. package/dist/bridge/usage.js +313 -340
  133. package/dist/bridge-hook.mjs +24624 -18450
  134. package/dist/cli/claude-unmanaged.d.ts +12 -0
  135. package/dist/cli/claude-unmanaged.js +105 -0
  136. package/dist/cli/schedules.js +2 -1
  137. package/dist/cli/session-start.js +10 -1
  138. package/dist/cli/session-stop.js +9 -1
  139. package/dist/cli-registry.d.ts +2 -0
  140. package/dist/cli-registry.js +37 -5
  141. package/dist/computers/command.d.ts +6 -0
  142. package/dist/computers/command.js +152 -0
  143. package/dist/computers/mcp.d.ts +1 -0
  144. package/dist/computers/mcp.js +97 -0
  145. package/dist/computers/read.d.ts +85 -0
  146. package/dist/computers/read.js +177 -0
  147. package/dist/data/task-receipts.d.ts +19 -0
  148. package/dist/data/task-receipts.js +68 -0
  149. package/dist/data/tasks.js +4 -1
  150. package/dist/entrypoint.js +10 -0
  151. package/dist/fanout/adapters/claude.js +15 -2
  152. package/dist/fanout/adapters/types.d.ts +6 -0
  153. package/dist/fanout/launcher.d.ts +5 -1
  154. package/dist/fanout/launcher.js +34 -3
  155. package/dist/fanout/picker.js +3 -2
  156. package/dist/fanout/usage.js +1 -1
  157. package/dist/generated/memory-ui-graph.browser.js +63 -63
  158. package/dist/graph-core/model.js +24 -3
  159. package/dist/graph-core/types.d.ts +4 -1
  160. package/dist/graph-core/types.js +1 -0
  161. package/dist/init/init-preset.js +7 -3
  162. package/dist/init/init-uninstall.js +2 -11
  163. package/dist/init/teardown.d.ts +3 -0
  164. package/dist/init/teardown.js +47 -0
  165. package/dist/link/context.js +21 -9
  166. package/dist/mcp/plugin-mode.js +1 -1
  167. package/dist/memory-ui-graph.runtime.js +63 -63
  168. package/dist/modules/code-package.d.ts +1 -0
  169. package/dist/modules/code-package.js +36 -7
  170. package/dist/modules/registry.js +14 -13
  171. package/dist/profile-store.d.ts +6 -0
  172. package/dist/profile-store.js +25 -1
  173. package/dist/shell/graph/glyphs.js +4 -0
  174. package/dist/shell/graph/graph-view.js +2 -0
  175. package/dist/status.js +7 -1
  176. package/dist/sync/task-claim.js +3 -2
  177. package/dist/task/lifecycle.js +25 -4
  178. package/dist/test-global-setup.js +5 -0
  179. package/dist/tools/dispatch.js +35 -2
  180. package/dist/tools/tasks.js +10 -1
  181. package/package.json +1 -1
  182. package/plugins/opencode/phren-transcript.js +87 -4
  183. package/starter/global/skills/conductor/SKILL.md +17 -2
  184. package/starter/global/skills/fanout/SKILL.md +3 -0
@@ -0,0 +1,12 @@
1
+ export interface ClaudeHookPayload {
2
+ session_id?: string;
3
+ transcript_path?: string;
4
+ cwd?: string;
5
+ }
6
+ export declare function readClaudeHookPayload(): ClaudeHookPayload | undefined;
7
+ /** Returns true for a recognized unmanaged headless worker, even when already registered. */
8
+ export declare function registerUnmanagedClaude(payload: ClaudeHookPayload | undefined, store: string, cwd: string, env?: NodeJS.ProcessEnv, processInfo?: {
9
+ pid: number;
10
+ headless: boolean;
11
+ }): boolean;
12
+ export declare function finishUnmanagedClaude(payload: ClaudeHookPayload | undefined, store: string): boolean;
@@ -0,0 +1,105 @@
1
+ import { execFileSync } from "node:child_process";
2
+ import * as fs from "node:fs";
3
+ import * as path from "node:path";
4
+ import { homedir } from "node:os";
5
+ import { jobsRoot, listJobs, readJob, writeManifest } from "../fanout/launcher.js";
6
+ import { uuid } from "../fanout/adapters/types.js";
7
+ export function readClaudeHookPayload() {
8
+ if (process.stdin.isTTY)
9
+ return;
10
+ try {
11
+ return JSON.parse(fs.readFileSync(0, "utf8"));
12
+ }
13
+ catch {
14
+ return;
15
+ }
16
+ }
17
+ function claudeProcess() {
18
+ let pid = process.ppid;
19
+ for (let depth = 0; depth < 8 && pid > 1; depth++) {
20
+ let row;
21
+ try {
22
+ row = execFileSync("ps", ["-o", "ppid=,comm=,tty=", "-p", String(pid)], { encoding: "utf8", timeout: 1_000 }).trim();
23
+ }
24
+ catch {
25
+ return;
26
+ }
27
+ const match = /^(\d+)\s+(\S+)\s+(\S+)$/.exec(row);
28
+ if (!match)
29
+ return;
30
+ if (path.basename(match[2]) === "claude")
31
+ return { pid, headless: match[3] === "?" || match[3] === "??" };
32
+ pid = Number(match[1]);
33
+ }
34
+ }
35
+ function nativePath(file, session) {
36
+ const root = path.join(homedir(), ".claude", "projects");
37
+ if (!path.isAbsolute(file) || path.basename(file) !== `${session}.jsonl` || !file.startsWith(root + path.sep))
38
+ return false;
39
+ try {
40
+ return fs.realpathSync(path.dirname(file)).startsWith(fs.realpathSync(root) + path.sep);
41
+ }
42
+ catch {
43
+ return false;
44
+ }
45
+ }
46
+ /** Returns true for a recognized unmanaged headless worker, even when already registered. */
47
+ export function registerUnmanagedClaude(payload, store, cwd, env = process.env, processInfo) {
48
+ if (env.PHREN_FANOUT_JOB || env.PHREN_FANOUT_DIR)
49
+ return false;
50
+ const session = uuid(payload?.session_id);
51
+ const transcript = payload?.transcript_path;
52
+ const parentCodex = uuid(env.CODEX_THREAD_ID || env.CODEX_SESSION_ID);
53
+ const parentClaude = uuid(env.CLAUDE_CODE_SESSION_ID);
54
+ const parent = parentCodex ? { provider: "codex", session: parentCodex }
55
+ : parentClaude && parentClaude !== session ? { provider: "claude", session: parentClaude } : undefined;
56
+ if (!session || !parent || typeof transcript !== "string" || !nativePath(transcript, session))
57
+ return false;
58
+ const running = processInfo ?? claudeProcess();
59
+ if (!running?.pid || !(running.headless || env.CLAUDE_CODE_ENTRYPOINT?.startsWith("sdk-")))
60
+ return false;
61
+ const root = jobsRoot(store), id = `claude-unmanaged-${session}`;
62
+ if (fs.existsSync(root) && fs.realpathSync(root) !== path.join(fs.realpathSync(store), ".runtime", "agent-fanouts"))
63
+ return false;
64
+ if (fs.existsSync(root) && listJobs(store).some(job => job.provider === "claude" && job.session === session))
65
+ return true;
66
+ const job = path.join(root, id);
67
+ fs.mkdirSync(root, { recursive: true, mode: 0o700 });
68
+ fs.chmodSync(root, 0o700);
69
+ try {
70
+ fs.mkdirSync(job, { mode: 0o700 });
71
+ }
72
+ catch (error) {
73
+ if (error.code === "EEXIST")
74
+ return true;
75
+ throw error;
76
+ }
77
+ const now = new Date().toISOString(), worktree = path.resolve(payload?.cwd || cwd);
78
+ fs.writeFileSync(path.join(job, "events.jsonl"), "", { mode: 0o600 });
79
+ writeManifest(job, { schemaVersion: 1, id, parent, provider: "claude", session,
80
+ taskLabel: `Claude worker · ${path.basename(worktree)}`, cwd: worktree, worktree,
81
+ eventLog: "events.jsonl", nativeTranscript: transcript, unmanagedPid: running.pid,
82
+ createdAt: now, startedAt: now, updatedAt: now, status: "running" });
83
+ return true;
84
+ }
85
+ export function finishUnmanagedClaude(payload, store) {
86
+ const session = uuid(payload?.session_id);
87
+ if (!session)
88
+ return false;
89
+ const id = `claude-unmanaged-${session}`, job = path.join(jobsRoot(store), id);
90
+ let manifest;
91
+ try {
92
+ manifest = readJob(store, id);
93
+ }
94
+ catch {
95
+ return false;
96
+ }
97
+ if (!manifest.nativeTranscript || (payload?.transcript_path && manifest.nativeTranscript !== payload.transcript_path))
98
+ return false;
99
+ if (manifest.status === "running") {
100
+ const now = new Date().toISOString();
101
+ writeManifest(job, { ...manifest, status: "completed", updatedAt: now, finishedAt: now, exitCode: 0 });
102
+ fs.writeFileSync(path.join(job, "exit.txt"), "0\n", { mode: 0o600 });
103
+ }
104
+ return true;
105
+ }
@@ -71,7 +71,8 @@ async function add(store, args) {
71
71
  const now = new Date().toISOString();
72
72
  const schedule = {
73
73
  id: newScheduleId(file.schedules.map(item => item.id)), name, enabled: true, computer, harness,
74
- ...(option(args, "--model") ? { model: option(args, "--model") } : {}), every, prompt, createdAt: now, updatedAt: now,
74
+ ...(option(args, "--model") ? { model: option(args, "--model") } : {}),
75
+ ...(option(args, "--account") ? { account: option(args, "--account") } : {}), every, prompt, createdAt: now, updatedAt: now,
75
76
  ...(option(args, "--at") ? { at: option(args, "--at") } : {}),
76
77
  ...(option(args, "--days") ? { days: option(args, "--days").split(",").map(day => day.trim().toLowerCase()) } : {}),
77
78
  ...(option(args, "--interval") ? { interval: option(args, "--interval") } : {}),
@@ -6,7 +6,7 @@ import { moduleEnabled } from "../modules/runtime.js";
6
6
  import * as fs from "fs";
7
7
  import * as path from "path";
8
8
  import * as crypto from "crypto";
9
- import { buildHookContext, handleGuardSkip, debugLog, appendAuditLog, runtimeFile, sessionMarker, getProjectDirs, findProjectNameCaseInsensitive, projectSlugFromPath, updateRuntimeHealth, withFileLock, detectProject, isProjectHookEnabled, readProjectConfig, getProjectSourcePath, detectProjectDir, ensureLocalGitRepo, isProjectTracked, repairPreexistingInstall, errorMessage, resolveRuntimeProfile, } from "./hooks-context.js";
9
+ import { buildHookContext, handleGuardSkip, debugLog, appendAuditLog, runtimeFile, sessionMarker, getProjectDirs, findProjectNameCaseInsensitive, projectSlugFromPath, updateRuntimeHealth, withFileLock, detectProject, isProjectHookEnabled, readProjectConfig, getProjectSourcePath, detectProjectDir, ensureLocalGitRepo, isProjectTracked, repairPreexistingInstall, errorMessage, getPhrenPath, resolveRuntimeProfile, } from "./hooks-context.js";
10
10
  import { TASKS_FILENAME } from "../data/tasks.js";
11
11
  import { FINDINGS_FILENAME } from "../data/access.js";
12
12
  import { readInstallPreferences } from "../init/preferences.js";
@@ -15,6 +15,7 @@ import { sessionFileForId, readSessionStateFile, writeSessionStateFile, } from "
15
15
  import { runBestEffortGit, countUnsyncedCommits, pullAtSessionStart } from "./session-git.js";
16
16
  import { scheduleBackgroundMaintenance } from "./session-background.js";
17
17
  import { runDoctor } from "./hooks-context.js";
18
+ import { readClaudeHookPayload, registerUnmanagedClaude } from "./claude-unmanaged.js";
18
19
  const SESSION_START_ONBOARDING_MARKER = "session-start-onboarding-v1";
19
20
  const SYNC_WARN_MARKER = "sync-broken-warned-v1";
20
21
  function projectHasBootstrapSignals(phrenPath, project) {
@@ -107,6 +108,14 @@ export function getSessionStartOnboardingNotice(phrenPath, cwd, activeProject) {
107
108
  ].join("\n");
108
109
  }
109
110
  export async function handleHookSessionStart() {
111
+ const payload = readClaudeHookPayload();
112
+ // A hand-rolled claude -p worker registers under its launcher, then gets the usual context.
113
+ try {
114
+ registerUnmanagedClaude(payload, getPhrenPath(), process.cwd());
115
+ }
116
+ catch (err) {
117
+ debugLog(`hook-session-start worker registration failed: ${errorMessage(err)}`);
118
+ }
110
119
  const startedAt = new Date().toISOString();
111
120
  const ctx = buildHookContext();
112
121
  const { phrenPath, cwd, activeProject, manifest } = ctx;
@@ -14,6 +14,7 @@ import { spawnDetachedChild } from "../shared/process.js";
14
14
  import { resolveManagementCapabilities } from "../init/management-preset.js";
15
15
  import { aheadBehind, logSyncOutcome } from "../sync/outcome.js";
16
16
  import { storeCommitMessage } from "../machine-identity.js";
17
+ import { finishUnmanagedClaude } from "./claude-unmanaged.js";
17
18
  // ── Utility ─────────────────────────────────────────────────────────────────
18
19
  /** Read JSON from stdin if it's not a TTY. Returns null if stdin is a TTY or parsing fails. */
19
20
  function readStdinJson() {
@@ -173,6 +174,14 @@ function getSessionCap() {
173
174
  }
174
175
  // ── Hook stop handler ───────────────────────────────────────────────────────
175
176
  export async function handleHookStop() {
177
+ // Stop is the terminal event for a one-shot Claude print session.
178
+ const stdinPayload = readStdinJson();
179
+ try {
180
+ finishUnmanagedClaude(stdinPayload ?? undefined, getPhrenPath());
181
+ }
182
+ catch (err) {
183
+ debugLog(`hook-stop worker finish failed: ${errorMessage(err)}`);
184
+ }
176
185
  const ctx = buildHookContext();
177
186
  const { phrenPath, activeProject, manifest } = ctx;
178
187
  const now = new Date().toISOString();
@@ -197,7 +206,6 @@ export async function handleHookStop() {
197
206
  }
198
207
  // Read stdin early — it's a stream and can only be consumed once.
199
208
  // Needed for auto-capture transcript_path parsing.
200
- const stdinPayload = readStdinJson();
201
209
  const taskSessionId = typeof stdinPayload?.session_id === "string" ? stdinPayload.session_id : undefined;
202
210
  const taskLevel = getProactivityLevelForTask(phrenPath);
203
211
  if (taskSessionId && taskLevel !== "high") {
@@ -34,6 +34,8 @@ export interface Command {
34
34
  subcommands?: Subcommand[];
35
35
  featured?: boolean;
36
36
  hidden?: boolean;
37
+ /** Runs without a Phren store: dispatch never finds, activates or tracks one. */
38
+ standalone?: boolean;
37
39
  run: RunFn;
38
40
  }
39
41
  export declare const ENV_HELP = "Environment variables:\n PHREN_PATH Override phren directory (default: ~/.phren)\n PHREN_PROFILE Active profile name\n PHREN_DEBUG Enable debug logging (set to 1)\n PHREN_PULL_INTERVAL_SECONDS Remote check interval in seconds (default: off; 0 disables)\n\n Embeddings:\n PHREN_OLLAMA_URL Ollama base URL (default: http://localhost:11434, 'off' to disable)\n PHREN_EMBEDDING_API_URL OpenAI-compatible /embeddings endpoint\n PHREN_EMBEDDING_API_KEY API key for embedding endpoint\n PHREN_EMBEDDING_MODEL Embedding model (default: nomic-embed-text)\n\n Context injection:\n PHREN_CONTEXT_TOKEN_BUDGET Max tokens injected per prompt (default: 550)\n PHREN_MAX_INJECT_TOKENS Hard cap on total injected tokens (default: 2000)\n PHREN_HOOK_TIMEOUT_MS Hook subprocess timeout in ms (default: 14000)\n\n Feature flags:\n PHREN_FEATURE_AGENTS=1 Show running coding agents on the graph\n PHREN_FEATURE_TOOL_HOOK=0 Skip the PostToolUse subprocess (perf)\n PHREN_FEATURE_AUTO_EXTRACT=0 Disable auto memory extraction\n PHREN_FEATURE_AUTO_CAPTURE=1 Extract insights from conversations\n PHREN_FEATURE_SEMANTIC_DEDUP=1 LLM-based dedup on add_finding\n PHREN_FEATURE_HYBRID_SEARCH=0 Disable TF-IDF cosine fallback\n\n Run 'phren help all' to see everything.\n";
@@ -66,7 +66,7 @@ const PROJECTS_SUBCOMMANDS = [
66
66
  ];
67
67
  const SCHEDULE_SUBCOMMANDS = [
68
68
  { name: "list", usage: "phren schedule list [project]", summary: "List scheduled prompts" },
69
- { name: "add", usage: "phren schedule add <project> --name <name> --harness <name> --computer <name> [--model <model>] --every <kind> [timing] (--prompt <text>|--prompt-file <path>)", summary: "Add a scheduled prompt" },
69
+ { name: "add", usage: "phren schedule add <project> --name <name> --harness <name> --computer <name> [--model <model>] [--account <id>] --every <kind> [timing] (--prompt <text>|--prompt-file <path>)", summary: "Add a scheduled prompt" },
70
70
  { name: "remove", usage: "phren schedule remove <project> <id>", summary: "Remove a scheduled prompt" },
71
71
  { name: "enable", usage: "phren schedule enable <project> <id>", summary: "Resume a scheduled prompt" },
72
72
  { name: "disable", usage: "phren schedule disable <project> <id>", summary: "Pause a scheduled prompt" },
@@ -141,14 +141,17 @@ export const REGISTRY = [
141
141
  },
142
142
  },
143
143
  {
144
- name: "bridge", topic: "setup", usage: "phren bridge <install|status|doctor|update|rollback|uninstall|enroll-computer|discover|link|fanouts archive|speech-key set>",
144
+ name: "bridge", topic: "setup", usage: "phren bridge <install|status|doctor|update|rollback|uninstall|enroll-computer|accounts|discover|link|fanouts archive|speech-key set|speech-voice|speech-model>",
145
145
  summary: "Install Phren Hook and enroll phone or computer connections",
146
146
  subcommands: [
147
147
  { name: "enroll-computer", usage: "phren bridge enroll-computer <name> [--accept <public-key-file>]", summary: "Print or accept a restricted computer dispatch key" },
148
+ { name: "accounts", usage: "phren bridge accounts [add <slug> [--label <name>] | label <id> <label>]", summary: "List this computer's harnesses and Claude accounts, add a Claude account home, or label one" },
148
149
  { name: "discover", usage: "phren bridge discover", summary: "List computers you already reach over ssh that run Phren Hook and are not linked" },
149
150
  { name: "link", usage: "phren bridge link <ssh-host> [--name <name>] [--as <name>] [--back-address <address>] [--yes]", summary: "Link this computer and an ssh host both ways in one step, after confirming" },
150
151
  { name: "fanouts archive", usage: "phren bridge fanouts archive [--dry-run] [--parent <session-id>] [--older-than <minutes>]", summary: "Archive finished fan-out jobs older than 24 hours, or one parent chat's, or older than N minutes" },
151
152
  { name: "speech-key set", usage: "phren bridge speech-key set", summary: "Store this computer's ElevenLabs key for spoken replies and dictation (read from stdin, mode 600)" },
153
+ { name: "speech-voice", usage: "phren bridge speech-voice [show | set <voice-id> | clear]", summary: "Show or set the ElevenLabs voice talk mode speaks with; kept across install and update" },
154
+ { name: "speech-model", usage: "phren bridge speech-model [show | set <model-id> | clear]", summary: "Show or set the ElevenLabs model talk mode speaks with (default eleven_v4_turbo); kept across install and update" },
152
155
  ],
153
156
  run: async (args) => {
154
157
  const { runBridge } = await import("./bridge/command.js");
@@ -157,7 +160,7 @@ export const REGISTRY = [
157
160
  },
158
161
  },
159
162
  {
160
- name: "dispatch", topic: "core", usage: "phren dispatch <computer|anywhere> <project> --label <label> --prompt <brief> [--harness codex|claude|opencode] [--model <model>]",
163
+ name: "dispatch", topic: "core", usage: "phren dispatch <computer|anywhere> <project> --label <label> --prompt <brief> [--harness codex|claude|opencode] [--model <model>] [--effort <effort>] [--account <id>] [--permission-mode <mode>]",
161
164
  summary: "Dispatch a worker brief through Phren Hook",
162
165
  subcommands: [{ name: "status", usage: "phren dispatch status", summary: "List local dispatch receipts" },
163
166
  { name: "returns", usage: "phren dispatch returns", summary: "List unread worker returns (done, needs you, blocked, gone) and mark them read" },
@@ -165,7 +168,20 @@ export const REGISTRY = [
165
168
  run: async (args) => (await import("./bridge/dispatch-command.js")).runDispatch(args),
166
169
  },
167
170
  {
168
- name: "hand-off", topic: "core", usage: "phren hand-off <computer|local> --session <id> --text <prompt>",
171
+ name: "computers", topic: "core", standalone: true,
172
+ usage: "phren computers [<name>] [--resources] [--pick [mac|linux|any]] [--exclude a,b] [--local] [--json] | phren computers mcp",
173
+ summary: "Each computer's load, memory, disk, battery and heavy jobs from Phren Hook, without Phren memory; `mcp` serves them read-only to agents",
174
+ subcommands: [{ name: "mcp", usage: "phren computers mcp", summary: "Stdio MCP server: list_computers, get_resources, pick_computer, get_usage (read-only, no memory)" }],
175
+ run: async (args) => (await import("./computers/command.js")).runComputers(args),
176
+ },
177
+ {
178
+ name: "usage", topic: "core", standalone: true,
179
+ usage: "phren usage [--per-computer] [--computer <name>] [--local] [--json]",
180
+ summary: "Agent usage per harness (limits, resets, spend) across computers from Phren Hook, without Phren memory",
181
+ run: async (args) => (await import("./computers/command.js")).runUsage(args),
182
+ },
183
+ {
184
+ name: "hand-off", topic: "core", usage: "phren hand-off <computer|local> --session <id> --text <prompt> [--account <id>]",
169
185
  summary: "Send work to an existing agent session through Phren Hook",
170
186
  run: async (args) => (await import("./bridge/dispatch-command.js")).runHandOff(args),
171
187
  },
@@ -176,12 +192,28 @@ export const REGISTRY = [
176
192
  },
177
193
  {
178
194
  name: "conductor", topic: "core", usage: "phren conductor <subcommand>",
179
- summary: "Manage conductor standing grants",
195
+ summary: "Make or stop this computer's conductor, list linked computer sets, and manage standing grants",
180
196
  subcommands: [
197
+ { name: "status", usage: "phren conductor status", summary: "This computer's conductor and the set name it holds" },
198
+ { name: "make", usage: "phren conductor make [--pane <id>] [--mux herdr:<name>|tmux:<name>]", summary: "Make the agent in this pane (or --pane) this computer's conductor" },
199
+ { name: "stop", usage: "phren conductor stop [--pane <id>]", summary: "End this computer's conductor role; the agent keeps running" },
200
+ { name: "sets", usage: "phren conductor sets [--json] | phren conductor sets name <name>|--clear", summary: "List linked computer sets with reachability and conductors, or name this computer's set" },
181
201
  { name: "grants", usage: "phren conductor grants [list|add|remove]", summary: "List, add, or remove conductor grants" },
182
202
  ],
183
203
  run: async (args) => (await import("./bridge/dispatch-command.js")).runConductor(args),
184
204
  },
205
+ {
206
+ name: "authority", topic: "core", usage: "phren authority [list | show <project> | set <project> ... | clear <project> | confirm <project> <actions>]",
207
+ summary: "Read the owner's release authority policy; the owner changes it or confirms an ask-first release",
208
+ subcommands: [
209
+ { name: "list", usage: "phren authority list", summary: "Every project the policy names, and confirmations waiting to be used" },
210
+ { name: "show", usage: "phren authority show <project>", summary: "One project's go and ask-first actions, ceiling, and the line to quote in a brief" },
211
+ { name: "set", usage: "phren authority set <project> [--default go|ask] [--go <actions>] [--ask <actions>] [--max-permission-mode <mode>|none] [--note <text>]", summary: "Change a project's entry (owner, interactive terminal)" },
212
+ { name: "clear", usage: "phren authority clear <project>", summary: "Remove a project's entry (owner, interactive terminal)" },
213
+ { name: "confirm", usage: "phren authority confirm <project> <actions> [--minutes <n>]", summary: "Let one agent dispatch do ask-first release actions (owner, interactive terminal)" },
214
+ ],
215
+ run: async (args) => (await import("./bridge/authority-command.js")).runAuthority(args),
216
+ },
185
217
  // Setup (featured: init, quickstart)
186
218
  {
187
219
  name: "init",
@@ -0,0 +1,6 @@
1
+ import { type HarnessUsage } from "./read.js";
2
+ import type { ComputerResources } from "../bridge/resources.js";
3
+ export declare function formatResources(name: string, r: ComputerResources, detail: boolean): string[];
4
+ export declare function formatHarness(h: HarnessUsage): string[];
5
+ export declare function runComputers(args: string[]): Promise<number>;
6
+ export declare function runUsage(args: string[]): Promise<number>;
@@ -0,0 +1,152 @@
1
+ import { combineUsage, describe, findComputer, pickComputer, readComputers, readUsage } from "./read.js";
2
+ /**
3
+ * `phren computers` and `phren usage`: read-only, answered by the Phren Hook
4
+ * alone. They run without a Phren store (the registry marks them
5
+ * standalone), so someone with no memory, findings or tasks can use them.
6
+ */
7
+ const GB = 1024 ** 3;
8
+ const flag = (args, name) => args.includes(name);
9
+ function option(args, name) {
10
+ const at = args.indexOf(name);
11
+ if (at >= 0)
12
+ return args[at + 1];
13
+ const inline = args.find(arg => arg.startsWith(`${name}=`));
14
+ return inline?.slice(name.length + 1);
15
+ }
16
+ function gauge(value) {
17
+ const filled = Math.round(Math.max(0, Math.min(1, value)) * 5);
18
+ return "▰".repeat(filled) + "▱".repeat(5 - filled);
19
+ }
20
+ function durationText(seconds) {
21
+ const days = Math.floor(seconds / 86400), hours = Math.floor(seconds % 86400 / 3600);
22
+ return days ? `${days}d ${hours}h` : `${hours}h ${Math.floor(seconds % 3600 / 60)}m`;
23
+ }
24
+ export function formatResources(name, r, detail) {
25
+ const lines = [`${name} ${gauge(r.pressure.overall)} ${r.level}${r.warnings.length ? ` (${r.warnings.join(", ")})` : ""}`];
26
+ lines.push(` cpu load ${r.cpu.load1} / ${r.cpu.load5} / ${r.cpu.load15} on ${r.cpu.cores} cores (${r.cpu.loadPerCore}× per core)`);
27
+ const memory = [r.memory.availablePercent !== undefined ? `${r.memory.availablePercent}% free` : "", r.memory.pressure ? `pressure ${r.memory.pressure}` : "",
28
+ `${(r.memory.totalBytes / GB).toFixed(0)} GB`, r.memory.swapUsedBytes ? `swap ${(r.memory.swapUsedBytes / GB).toFixed(1)} GB` : ""].filter(Boolean);
29
+ lines.push(` memory ${memory.join(", ")}`);
30
+ if (r.disk)
31
+ lines.push(` disk ${(r.disk.freeBytes / GB).toFixed(1)} GB free of ${(r.disk.totalBytes / GB).toFixed(0)} GB (home volume)`);
32
+ if (r.battery)
33
+ lines.push(` battery ${r.battery.percent}%${r.battery.charging ? ", charging" : ""}${r.battery.onAC ? ", on AC" : ", on battery"}`);
34
+ lines.push(` uptime ${durationText(r.uptimeSeconds)}`);
35
+ if (detail || r.heavy.length) {
36
+ const heavy = detail ? r.heavy : r.heavy.slice(0, 4);
37
+ if (heavy.length)
38
+ lines.push(" heavy");
39
+ for (const job of heavy) {
40
+ const pane = job.pane ? ` ${[job.pane.workspace, job.pane.pane, job.pane.agent].filter(Boolean).join(" · ")}` : "";
41
+ lines.push(` ${job.name.padEnd(22)} ${String(job.cpuPercent).padStart(6)}% cpu ${(job.memoryBytes / GB).toFixed(1).padStart(5)} GB${job.processes > 1 ? ` ×${job.processes}` : ""}${pane}`);
42
+ }
43
+ if (!detail && r.heavy.length > heavy.length)
44
+ lines.push(` … ${r.heavy.length - heavy.length} more (phren computers --resources <name>)`);
45
+ }
46
+ return lines;
47
+ }
48
+ export function formatHarness(h) {
49
+ const lines = [` ${h.harness}`];
50
+ for (const w of h.windows) {
51
+ const used = w.usedPercent !== undefined ? `${w.usedPercent}% used` : w.usedUSD !== undefined ? `$${w.usedUSD.toFixed(2)}${w.limitUSD !== undefined ? ` of $${w.limitUSD.toFixed(2)}` : ""}` : "";
52
+ lines.push(` ${w.name.padEnd(30)} ${used.padEnd(18)}${w.resetsIn ? `resets in ${w.resetsIn}` : ""}`);
53
+ }
54
+ if (h.spend)
55
+ lines.push(` spend ${h.spend.period.replace(/_/g, " ").padEnd(24)} $${h.spend.amountUSD.toFixed(2)}`);
56
+ if (h.message)
57
+ lines.push(` ${h.message}`);
58
+ return lines;
59
+ }
60
+ export async function runComputers(args) {
61
+ if (args[0] === "mcp") {
62
+ await (await import("./mcp.js")).serveComputersMcp();
63
+ return 0;
64
+ }
65
+ const json = flag(args, "--json");
66
+ const pick = flag(args, "--pick") ? (option(args, "--pick") && !option(args, "--pick").startsWith("-") ? option(args, "--pick") : "mac") : undefined;
67
+ const named = args.find((arg, index) => !arg.startsWith("-") && !["--pick", "--exclude"].includes(args[index - 1] ?? ""));
68
+ const report = await readComputers({ peers: !flag(args, "--local") });
69
+ if (pick) {
70
+ if (!["mac", "linux", "any"].includes(pick)) {
71
+ console.error("--pick takes mac, linux or any.");
72
+ return 1;
73
+ }
74
+ const result = pickComputer(report.computers, pick, (option(args, "--exclude") ?? "").split(",").filter(Boolean));
75
+ if (json)
76
+ console.log(JSON.stringify({ pick: result.pick?.name ?? null, reason: result.reason, ranked: result.ranked }, null, 2));
77
+ else {
78
+ console.log(result.reason);
79
+ for (const item of result.ranked.slice(1))
80
+ console.log(` then ${item.name}: ${item.why}`);
81
+ }
82
+ return result.pick ? 0 : 1;
83
+ }
84
+ const chosen = named ? findComputer(report.computers, named) : undefined;
85
+ if (named && !chosen) {
86
+ console.error(`No computer named ${named}. Known: ${report.computers.map(c => c.name).join(", ")}`);
87
+ return 1;
88
+ }
89
+ const list = chosen ? [chosen] : report.computers;
90
+ if (json) {
91
+ console.log(JSON.stringify({ computers: list, ...(report.hookError ? { hookError: report.hookError } : {}), ...(report.peerError ? { peerError: report.peerError } : {}) }, null, 2));
92
+ return 0;
93
+ }
94
+ const detail = Boolean(chosen) || flag(args, "--resources") && list.length === 1;
95
+ if (report.hookError)
96
+ console.log(`${report.hookError} Showing this computer only.\n`);
97
+ for (const computer of list) {
98
+ if (!computer.resources) {
99
+ console.log(`${computer.name} offline: ${computer.error ?? "unavailable"}\n`);
100
+ continue;
101
+ }
102
+ if (!flag(args, "--resources") && !chosen)
103
+ console.log(`${computer.name.padEnd(28)} ${gauge(computer.resources.pressure.overall)} ${computer.resources.level.padEnd(9)} ${describe(computer.resources)}`);
104
+ else
105
+ console.log(formatResources(computer.name, computer.resources, detail).join("\n") + "\n");
106
+ }
107
+ if (report.peerError)
108
+ console.log(`\nLinked computers unavailable: ${report.peerError}`);
109
+ return 0;
110
+ }
111
+ export async function runUsage(args) {
112
+ if (args[0] === "mcp") {
113
+ await (await import("./mcp.js")).serveComputersMcp();
114
+ return 0;
115
+ }
116
+ const json = flag(args, "--json");
117
+ const report = await readUsage({ peers: !flag(args, "--local") });
118
+ const named = option(args, "--computer");
119
+ const computers = named ? report.computers.filter(c => c.name.toLowerCase().startsWith(named.toLowerCase())) : report.computers;
120
+ if (named && !computers.length) {
121
+ console.error(`No computer named ${named}. Known: ${report.computers.map(c => c.name).join(", ")}`);
122
+ return 1;
123
+ }
124
+ const combined = named ? combineUsage(computers.flatMap(c => c.harnesses ? [c.harnesses] : [])) : report.combined;
125
+ if (json) {
126
+ console.log(JSON.stringify({ computers, combined, ...(report.hookError ? { hookError: report.hookError } : {}) }, null, 2));
127
+ return report.hookError ? 1 : 0;
128
+ }
129
+ if (report.hookError) {
130
+ console.error(report.hookError);
131
+ return 1;
132
+ }
133
+ if (!flag(args, "--per-computer")) {
134
+ console.log(`Usage across ${computers.filter(c => c.harnesses).length} computer(s)`);
135
+ for (const h of combined)
136
+ console.log(formatHarness(h).join("\n"));
137
+ const offline = computers.filter(c => c.error);
138
+ if (offline.length)
139
+ console.log(`\nNot reporting: ${offline.map(c => `${c.name} (${c.error})`).join("; ")}`);
140
+ return 0;
141
+ }
142
+ for (const computer of computers) {
143
+ console.log(computer.name);
144
+ if (computer.error) {
145
+ console.log(` ${computer.error}`);
146
+ continue;
147
+ }
148
+ for (const h of computer.harnesses ?? [])
149
+ console.log(formatHarness(h).join("\n"));
150
+ }
151
+ return 0;
152
+ }
@@ -0,0 +1 @@
1
+ export declare function serveComputersMcp(): Promise<void>;
@@ -0,0 +1,97 @@
1
+ import { VERSION } from "../package-metadata.js";
2
+ import { combineUsage, describe, findComputer, pickComputer, readComputers, readUsage } from "./read.js";
3
+ /**
4
+ * `phren computers mcp`: a stdio MCP server with four read-only tools over
5
+ * the Phren Hook: list computers, one computer's resources, the least-loaded
6
+ * computer, and agent usage. It never opens a Phren store and has no memory,
7
+ * finding or task tools, so it can be handed to an agent that must not see
8
+ * them. Register it with `claude mcp add phren-computers -- phren computers mcp`.
9
+ */
10
+ const INSTRUCTIONS = [
11
+ "Read-only view of the owner's computers and agent usage, answered by the Phren Hook.",
12
+ "Before a heavy job (Xcode or simulator tests, emulators, Gradle), call pick_computer and run it there; check get_resources before starting a second heavy job on a computer.",
13
+ "A computer whose level is 'stressed' (load above twice its cores, under 10 GB free disk, or critical memory) should not get new heavy work.",
14
+ "get_usage shows each harness's limits, windows and time until reset; a harness that reports nothing says so.",
15
+ ].join(" ");
16
+ const text = (value) => ({ content: [{ type: "text", text: JSON.stringify(value, null, 2) }] });
17
+ const failure = (message) => ({ content: [{ type: "text", text: message }], isError: true });
18
+ const readOnly = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
19
+ export async function serveComputersMcp() {
20
+ const [{ McpServer }, { StdioServerTransport }, { z }] = await Promise.all([
21
+ import("@modelcontextprotocol/sdk/server/mcp.js"),
22
+ import("@modelcontextprotocol/sdk/server/stdio.js"),
23
+ import("zod"),
24
+ ]);
25
+ const server = new McpServer({ name: "phren-computers", version: VERSION }, { instructions: INSTRUCTIONS });
26
+ server.registerTool("list_computers", {
27
+ title: "List computers",
28
+ description: "Every computer this Hook knows (this one and each linked one): online, platform, load level, CPU load against cores, free memory and disk, warnings. Read-only.",
29
+ inputSchema: z.object({}),
30
+ annotations: readOnly,
31
+ }, async () => {
32
+ const report = await readComputers();
33
+ return text({
34
+ computers: report.computers.map(c => c.resources ? {
35
+ name: c.name, local: c.local, online: true, platform: c.resources.platform, level: c.resources.level, warnings: c.resources.warnings,
36
+ pressure: c.resources.pressure.overall, cores: c.resources.cpu.cores, load1: c.resources.cpu.load1,
37
+ memoryFreePercent: c.resources.memory.availablePercent, diskFreeGB: c.resources.disk ? Math.round(c.resources.disk.freeBytes / 1024 ** 3 * 10) / 10 : undefined,
38
+ heavyJobs: c.resources.heavy.length, summary: describe(c.resources),
39
+ } : { name: c.name, local: c.local, online: false, error: c.error }),
40
+ ...(report.hookError ? { hookError: report.hookError } : {}), ...(report.peerError ? { peerError: report.peerError } : {}),
41
+ });
42
+ });
43
+ server.registerTool("get_resources", {
44
+ title: "Get a computer's resources",
45
+ description: "One computer's live resources: load averages and cores, memory, free disk on the home volume, battery, uptime, and heavy jobs (simulators, emulators, xcodebuild, Gradle, agent workers) with the terminal pane that started each where known. Omit computer for this one. Read-only.",
46
+ inputSchema: z.object({ computer: z.string().max(253).optional().describe("Computer name (or prefix) from list_computers; omit for this computer.") }),
47
+ annotations: readOnly,
48
+ }, async ({ computer }) => {
49
+ const report = await readComputers({ peers: Boolean(computer) });
50
+ const found = findComputer(report.computers, computer);
51
+ if (!found)
52
+ return failure(`No computer named ${computer}. Known: ${report.computers.map(c => c.name).join(", ")}`);
53
+ return text(found.resources ? { name: found.name, local: found.local, ...found.resources } : { name: found.name, online: false, error: found.error });
54
+ });
55
+ server.registerTool("pick_computer", {
56
+ title: "Pick the least-loaded computer",
57
+ description: "The least-loaded online computer for a heavy job, with the ranking and why. Defaults to Macs (Xcode, simulators). Read-only; it starts nothing.",
58
+ inputSchema: z.object({
59
+ platform: z.enum(["mac", "linux", "any"]).optional().describe("mac (default), linux or any."),
60
+ exclude: z.array(z.string().max(253)).max(32).optional().describe("Computer names to leave out."),
61
+ }),
62
+ annotations: readOnly,
63
+ }, async ({ platform, exclude }) => {
64
+ const result = pickComputer((await readComputers()).computers, platform ?? "mac", exclude ?? []);
65
+ return text({ pick: result.pick?.name ?? null, reason: result.reason, ranked: result.ranked });
66
+ });
67
+ server.registerTool("get_usage", {
68
+ title: "Get agent usage",
69
+ description: "Agent usage per harness (Claude, Codex, GitHub Copilot, OpenCode incl. DeepSeek via its local spend, OpenCode Go, OpenRouter): limits and windows with percent used and time until reset, and recent spend where the harness reports it. Per computer and combined. A harness that reports nothing says so. No credentials are ever included. Read-only.",
70
+ inputSchema: z.object({
71
+ computer: z.string().max(253).optional().describe("Only this computer (name or prefix)."),
72
+ view: z.enum(["combined", "per-computer", "both"]).optional().describe("combined (default), per-computer or both."),
73
+ }),
74
+ annotations: readOnly,
75
+ }, async ({ computer, view }) => {
76
+ const report = await readUsage();
77
+ if (report.hookError)
78
+ return failure(report.hookError);
79
+ const computers = computer ? report.computers.filter(c => c.name.toLowerCase().startsWith(computer.toLowerCase())) : report.computers;
80
+ if (computer && !computers.length)
81
+ return failure(`No computer named ${computer}. Known: ${report.computers.map(c => c.name).join(", ")}`);
82
+ const combined = computer ? combineUsage(computers.flatMap(c => c.harnesses ? [c.harnesses] : [])) : report.combined;
83
+ const mode = view ?? "combined";
84
+ return text({
85
+ ...(mode !== "per-computer" ? { combined } : {}),
86
+ ...(mode !== "combined" ? { computers } : { computersReporting: computers.map(c => c.error ? `${c.name} (not reporting: ${c.error})` : c.name) }),
87
+ });
88
+ });
89
+ const transport = new StdioServerTransport();
90
+ // The CLI exits once a command returns, so serve until the client hangs up.
91
+ let hangUp = () => { };
92
+ const closed = new Promise(resolve => { hangUp = resolve; process.stdin.once("end", resolve); });
93
+ await server.connect(transport);
94
+ server.server.onclose = hangUp;
95
+ console.error("phren-computers MCP server running (read-only, no memory)");
96
+ await closed;
97
+ }
@@ -0,0 +1,85 @@
1
+ import type { ComputerResources } from "../bridge/resources.js";
2
+ import type { AccountUsage, UsageWindow } from "../bridge/usage.js";
3
+ import type { Json } from "../bridge/protocol.js";
4
+ /**
5
+ * The memory-free computers surface: every read goes to the local Hook's
6
+ * socket (`GET /v1/resources?peers=1`, `GET /v1/usage?peers=1`), which answers
7
+ * for itself and asks each linked computer over its pinned SSH pipe. Nothing
8
+ * here opens, needs or reports a Phren store, findings or tasks, and nothing
9
+ * writes: `phren computers`, `phren usage` and `phren computers mcp` share it.
10
+ */
11
+ export interface ComputerReport {
12
+ name: string;
13
+ /** This computer, the one whose Hook answered. */
14
+ local: boolean;
15
+ online: boolean;
16
+ resources?: ComputerResources;
17
+ error?: string;
18
+ }
19
+ /** Every harness the Hook reads usage for, in the order people look for them. */
20
+ export declare const USAGE_SOURCES: readonly ["claude", "codex", "copilot", "opencode", "opencode-go", "openrouter"];
21
+ export declare const HARNESS_NAMES: Record<string, string>;
22
+ export interface HarnessUsage {
23
+ source: string;
24
+ harness: string;
25
+ windows: Array<UsageWindow & {
26
+ resetsIn?: string;
27
+ }>;
28
+ spend?: AccountUsage["spend"];
29
+ updatedAt?: string;
30
+ /** What the harness said, or why it gave nothing. Never a guess. */
31
+ message?: string;
32
+ }
33
+ export interface UsageReport {
34
+ computers: Array<{
35
+ name: string;
36
+ local: boolean;
37
+ harnesses?: HarnessUsage[];
38
+ error?: string;
39
+ }>;
40
+ /** Across computers: account limits from the freshest report, local spend summed. */
41
+ combined: HarnessUsage[];
42
+ }
43
+ type Request = (route: string) => Promise<Json>;
44
+ export declare function readComputers(options?: {
45
+ peers?: boolean;
46
+ request?: Request;
47
+ localFallback?: () => Promise<ComputerResources>;
48
+ }): Promise<{
49
+ computers: ComputerReport[];
50
+ hookError?: string;
51
+ peerError?: string;
52
+ }>;
53
+ export declare function findComputer(computers: ComputerReport[], name: string | undefined): ComputerReport | undefined;
54
+ export type PlatformChoice = "mac" | "linux" | "any";
55
+ /**
56
+ * The least-loaded online computer: stressed ones last, then by overall
57
+ * pressure, then load per core, then free disk. Each candidate carries why.
58
+ */
59
+ export declare function pickComputer(computers: ComputerReport[], platform?: PlatformChoice, exclude?: string[]): {
60
+ pick?: ComputerReport;
61
+ reason: string;
62
+ ranked: Array<{
63
+ name: string;
64
+ score: number;
65
+ level: string;
66
+ why: string;
67
+ }>;
68
+ };
69
+ export declare function describe(r: ComputerResources): string;
70
+ export declare function resetsIn(resetsAt: string | undefined, now?: number): string | undefined;
71
+ /**
72
+ * Account limits are the same account seen from each computer, so the
73
+ * freshest report with windows stands. OpenCode's cost ledger is per
74
+ * computer, so its spend adds up; OpenRouter's is one key, reported once.
75
+ */
76
+ export declare function combineUsage(perComputer: HarnessUsage[][]): HarnessUsage[];
77
+ export declare function readUsage(options?: {
78
+ peers?: boolean;
79
+ request?: Request;
80
+ now?: number;
81
+ }): Promise<UsageReport & {
82
+ hookError?: string;
83
+ peerError?: string;
84
+ }>;
85
+ export {};