@phren/cli 0.2.15 → 0.2.16
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.
- package/README.md +2 -2
- package/dist/agent-instructions.d.ts +12 -0
- package/dist/agent-instructions.js +52 -0
- package/dist/bridge/agent-hook-stores.d.ts +32 -0
- package/dist/bridge/agent-hook-stores.js +67 -0
- package/dist/bridge/agent-hooks.d.ts +193 -2
- package/dist/bridge/agent-hooks.js +1045 -38
- package/dist/bridge/canary.d.ts +27 -0
- package/dist/bridge/canary.js +189 -0
- package/dist/bridge/changes.d.ts +57 -0
- package/dist/bridge/changes.js +403 -0
- package/dist/bridge/client.d.ts +3 -0
- package/dist/bridge/client.js +36 -0
- package/dist/bridge/code-note.d.ts +22 -0
- package/dist/bridge/code-note.js +42 -0
- package/dist/bridge/code-routes.d.ts +133 -0
- package/dist/bridge/code-routes.js +319 -0
- package/dist/bridge/codex-threads.d.ts +27 -0
- package/dist/bridge/codex-threads.js +442 -0
- package/dist/bridge/command.d.ts +7 -0
- package/dist/bridge/command.js +50 -5
- package/dist/bridge/computer-names.d.ts +4 -0
- package/dist/bridge/computer-names.js +16 -0
- package/dist/bridge/computers.d.ts +9 -0
- package/dist/bridge/computers.js +111 -0
- package/dist/bridge/context.d.ts +14 -0
- package/dist/bridge/context.js +149 -0
- package/dist/bridge/dispatch-command.d.ts +3 -0
- package/dist/bridge/dispatch-command.js +93 -0
- package/dist/bridge/dispatch-hosts.d.ts +23 -0
- package/dist/bridge/dispatch-hosts.js +25 -0
- package/dist/bridge/dispatch-returns.d.ts +123 -0
- package/dist/bridge/dispatch-returns.js +279 -0
- package/dist/bridge/dispatch-tree.d.ts +54 -0
- package/dist/bridge/dispatch-tree.js +198 -0
- package/dist/bridge/dispatch.d.ts +207 -0
- package/dist/bridge/dispatch.js +261 -0
- package/dist/bridge/enroll.d.ts +31 -0
- package/dist/bridge/enroll.js +236 -0
- package/dist/bridge/fanout-messages.d.ts +74 -0
- package/dist/bridge/fanout-messages.js +230 -0
- package/dist/bridge/fanouts.d.ts +160 -0
- package/dist/bridge/fanouts.js +702 -0
- package/dist/bridge/file-range.d.ts +16 -0
- package/dist/bridge/file-range.js +90 -0
- package/dist/bridge/files.d.ts +20 -0
- package/dist/bridge/files.js +54 -0
- package/dist/bridge/git-publish.d.ts +23 -0
- package/dist/bridge/git-publish.js +145 -0
- package/dist/bridge/git-worktrees.d.ts +21 -0
- package/dist/bridge/git-worktrees.js +150 -0
- package/dist/bridge/git.d.ts +54 -0
- package/dist/bridge/git.js +552 -0
- package/dist/bridge/grants.d.ts +31 -0
- package/dist/bridge/grants.js +181 -0
- package/dist/bridge/hand-off.d.ts +79 -0
- package/dist/bridge/hand-off.js +151 -0
- package/dist/bridge/health.d.ts +128 -0
- package/dist/bridge/health.js +260 -0
- package/dist/bridge/herdr.d.ts +79 -6
- package/dist/bridge/herdr.js +292 -27
- package/dist/bridge/hook-main.js +2 -0
- package/dist/bridge/install.d.ts +32 -1
- package/dist/bridge/install.js +225 -38
- package/dist/bridge/launch-worktree.d.ts +21 -0
- package/dist/bridge/launch-worktree.js +70 -0
- package/dist/bridge/limits.d.ts +20 -0
- package/dist/bridge/limits.js +65 -0
- package/dist/bridge/locate.d.ts +16 -0
- package/dist/bridge/locate.js +75 -0
- package/dist/bridge/metrics.d.ts +29 -0
- package/dist/bridge/metrics.js +71 -0
- package/dist/bridge/model-switch.d.ts +35 -0
- package/dist/bridge/model-switch.js +250 -0
- package/dist/bridge/models.d.ts +46 -0
- package/dist/bridge/models.js +257 -0
- package/dist/bridge/opencode-approvals.d.ts +6 -0
- package/dist/bridge/opencode-approvals.js +60 -0
- package/dist/bridge/pane-text.d.ts +15 -0
- package/dist/bridge/pane-text.js +23 -0
- package/dist/bridge/peers.d.ts +27 -0
- package/dist/bridge/peers.js +130 -0
- package/dist/bridge/projects.d.ts +12 -1
- package/dist/bridge/projects.js +268 -20
- package/dist/bridge/protocol.d.ts +35 -2
- package/dist/bridge/protocol.js +42 -7
- package/dist/bridge/push.d.ts +83 -0
- package/dist/bridge/push.js +199 -0
- package/dist/bridge/questions.d.ts +38 -0
- package/dist/bridge/questions.js +205 -0
- package/dist/bridge/schedule-format.d.ts +103 -0
- package/dist/bridge/schedule-format.js +266 -0
- package/dist/bridge/schedule-launch.d.ts +11 -0
- package/dist/bridge/schedule-launch.js +169 -0
- package/dist/bridge/schedule-watch.d.ts +52 -0
- package/dist/bridge/schedule-watch.js +242 -0
- package/dist/bridge/schedules.d.ts +48 -0
- package/dist/bridge/schedules.js +205 -0
- package/dist/bridge/server-launch.d.ts +14 -0
- package/dist/bridge/server-launch.js +218 -0
- package/dist/bridge/server-overview.d.ts +45 -0
- package/dist/bridge/server-overview.js +102 -0
- package/dist/bridge/server-pane-routes.d.ts +29 -0
- package/dist/bridge/server-pane-routes.js +400 -0
- package/dist/bridge/server-routes.d.ts +106 -0
- package/dist/bridge/server-routes.js +538 -0
- package/dist/bridge/server-stream.d.ts +46 -0
- package/dist/bridge/server-stream.js +253 -0
- package/dist/bridge/server.d.ts +3 -15
- package/dist/bridge/server.js +162 -264
- package/dist/bridge/session-servers.d.ts +24 -0
- package/dist/bridge/session-servers.js +136 -0
- package/dist/bridge/side-questions.d.ts +74 -0
- package/dist/bridge/side-questions.js +252 -0
- package/dist/bridge/simulators.d.ts +28 -0
- package/dist/bridge/simulators.js +198 -0
- package/dist/bridge/speech-transcribe.d.ts +24 -0
- package/dist/bridge/speech-transcribe.js +124 -0
- package/dist/bridge/speech.d.ts +35 -0
- package/dist/bridge/speech.js +98 -0
- package/dist/bridge/steps.d.ts +13 -0
- package/dist/bridge/steps.js +222 -0
- package/dist/bridge/tab-activity.d.ts +18 -0
- package/dist/bridge/tab-activity.js +99 -0
- package/dist/bridge/terminal-choice.d.ts +64 -0
- package/dist/bridge/terminal-choice.js +281 -0
- package/dist/bridge/transcript-claude.d.ts +22 -0
- package/dist/bridge/transcript-claude.js +353 -0
- package/dist/bridge/transcript-codex.d.ts +30 -0
- package/dist/bridge/transcript-codex.js +282 -0
- package/dist/bridge/transcript-copilot.d.ts +4 -0
- package/dist/bridge/transcript-copilot.js +14 -0
- package/dist/bridge/transcript-opencode.d.ts +5 -0
- package/dist/bridge/transcript-opencode.js +26 -0
- package/dist/bridge/transcript-preview.d.ts +94 -0
- package/dist/bridge/transcript-preview.js +476 -0
- package/dist/bridge/transcripts.d.ts +81 -4
- package/dist/bridge/transcripts.js +332 -67
- package/dist/bridge/transport.d.ts +3 -0
- package/dist/bridge/transport.js +96 -15
- package/dist/bridge/uploads.d.ts +15 -0
- package/dist/bridge/uploads.js +44 -2
- package/dist/bridge/usage.d.ts +124 -0
- package/dist/bridge/usage.js +859 -0
- package/dist/bridge-hook.mjs +41246 -21385
- package/dist/cli/actions.js +14 -1
- package/dist/cli/config-proactivity.d.ts +3 -1
- package/dist/cli/config-proactivity.js +35 -3
- package/dist/cli/config.js +4 -1
- package/dist/cli/extract.js +3 -6
- package/dist/cli/govern.js +5 -2
- package/dist/cli/hooks-globs.js +1 -1
- package/dist/cli/hooks.d.ts +1 -1
- package/dist/cli/hooks.js +9 -7
- package/dist/cli/namespaces-projects.js +12 -6
- package/dist/cli/namespaces-store.js +37 -6
- package/dist/cli/namespaces-tasks.js +1 -1
- package/dist/cli/schedules.d.ts +1 -0
- package/dist/cli/schedules.js +164 -0
- package/dist/cli/session-background.js +1 -1
- package/dist/cli/session-git.d.ts +8 -5
- package/dist/cli/session-git.js +45 -120
- package/dist/cli/session-start.js +3 -1
- package/dist/cli/session-stop.js +19 -8
- package/dist/cli/team.js +13 -10
- package/dist/cli-handlers.d.ts +1 -1
- package/dist/cli-handlers.js +8 -4
- package/dist/cli-help.d.ts +5 -4
- package/dist/cli-help.js +15 -15
- package/dist/cli-registry.d.ts +4 -1
- package/dist/cli-registry.js +119 -6
- package/dist/content/archive.js +2 -2
- package/dist/content/citation.d.ts +11 -0
- package/dist/content/citation.js +18 -0
- package/dist/content/learning.js +2 -0
- package/dist/content/summarize.d.ts +14 -15
- package/dist/content/summarize.js +60 -5
- package/dist/content/validate.d.ts +3 -1
- package/dist/content/validate.js +26 -8
- package/dist/core/project-registry.d.ts +26 -0
- package/dist/core/project-registry.js +573 -0
- package/dist/core/project.js +2 -3
- package/dist/data/access.d.ts +7 -1
- package/dist/data/access.js +13 -3
- package/dist/data/tasks.d.ts +18 -3
- package/dist/data/tasks.js +8 -7
- package/dist/entrypoint.js +44 -10
- package/dist/fanout/adapters/claude.d.ts +2 -0
- package/dist/fanout/adapters/claude.js +7 -0
- package/dist/fanout/adapters/codex.d.ts +2 -0
- package/dist/fanout/adapters/codex.js +9 -0
- package/dist/fanout/adapters/opencode.d.ts +4 -0
- package/dist/fanout/adapters/opencode.js +9 -0
- package/dist/fanout/adapters/types.d.ts +21 -0
- package/dist/fanout/adapters/types.js +3 -0
- package/dist/fanout/command.d.ts +2 -0
- package/dist/fanout/command.js +78 -0
- package/dist/fanout/launcher.d.ts +27 -0
- package/dist/fanout/launcher.js +156 -0
- package/dist/fanout/opencode-serve.d.ts +24 -0
- package/dist/fanout/opencode-serve.js +191 -0
- package/dist/fanout/picker.d.ts +91 -0
- package/dist/fanout/picker.js +51 -0
- package/dist/fanout/usage.d.ts +5 -0
- package/dist/fanout/usage.js +51 -0
- package/dist/fanout/watchdog.d.ts +10 -0
- package/dist/fanout/watchdog.js +27 -0
- package/dist/filenames.d.ts +9 -0
- package/dist/filenames.js +11 -0
- package/dist/finding/context.js +4 -22
- package/dist/generated/memory-ui-graph.browser.js +279 -283
- package/dist/governance/policy-constants.d.ts +11 -0
- package/dist/governance/policy-constants.js +9 -0
- package/dist/governance/policy.d.ts +5 -8
- package/dist/governance/policy.js +7 -5
- package/dist/graph-core/camera.d.ts +24 -0
- package/dist/graph-core/camera.js +18 -0
- package/dist/graph-core/index.d.ts +2 -0
- package/dist/graph-core/index.js +2 -0
- package/dist/graph-core/labels.d.ts +77 -0
- package/dist/graph-core/labels.js +124 -0
- package/dist/graph-core/model.d.ts +13 -0
- package/dist/graph-core/model.js +33 -0
- package/dist/graph-core/types.d.ts +2 -0
- package/dist/home-paths.d.ts +7 -0
- package/dist/home-paths.js +21 -0
- package/dist/hooks.d.ts +3 -0
- package/dist/hooks.js +13 -0
- package/dist/index.js +24 -2
- package/dist/init/guard-globals.d.ts +1 -1
- package/dist/init/guard-globals.js +4 -4
- package/dist/init/init-configure.js +3 -3
- package/dist/init/init-uninstall.js +2 -2
- package/dist/init/init-walkthrough.js +1 -1
- package/dist/init/init.js +26 -6
- package/dist/init/management-preset.d.ts +1 -1
- package/dist/init/management-preset.js +2 -2
- package/dist/init/preferences.js +1 -1
- package/dist/init/self-wiring.js +1 -1
- package/dist/init/setup.d.ts +3 -26
- package/dist/init/setup.js +49 -588
- package/dist/init/shared.js +2 -0
- package/dist/init/store-gitignore.d.ts +1 -1
- package/dist/init/store-gitignore.js +2 -0
- package/dist/init/teardown.d.ts +1 -1
- package/dist/init/teardown.js +2 -2
- package/dist/link/context.js +1 -1
- package/dist/link/doctor.d.ts +22 -1
- package/dist/link/doctor.js +100 -54
- package/dist/link/link.js +29 -61
- package/dist/link/refresh.js +2 -2
- package/dist/link/skills.js +26 -5
- package/dist/machine-identity.d.ts +3 -0
- package/dist/machine-identity.js +6 -0
- package/dist/mcp/profile.d.ts +2 -15
- package/dist/mcp/profile.js +64 -9
- package/dist/memory-ui-graph.runtime.js +279 -283
- package/dist/modules/code-package.d.ts +16 -0
- package/dist/modules/code-package.js +152 -0
- package/dist/modules/command.d.ts +2 -0
- package/dist/modules/command.js +67 -0
- package/dist/modules/config.d.ts +4 -0
- package/dist/modules/config.js +70 -0
- package/dist/modules/manifest.d.ts +41 -0
- package/dist/modules/manifest.js +1 -0
- package/dist/modules/provision.d.ts +3 -0
- package/dist/modules/provision.js +84 -0
- package/dist/modules/registry.d.ts +16 -0
- package/dist/modules/registry.js +250 -0
- package/dist/modules/runtime.d.ts +15 -0
- package/dist/modules/runtime.js +59 -0
- package/dist/package-metadata.js +10 -2
- package/dist/phren-dotenv.js +4 -2
- package/dist/phren-paths.d.ts +3 -2
- package/dist/phren-paths.js +4 -5
- package/dist/profile-store.js +4 -5
- package/dist/project-config.d.ts +19 -1
- package/dist/project-config.js +29 -3
- package/dist/project-topics.js +4 -4
- package/dist/provider-adapters.js +1 -4
- package/dist/query-correlation.js +6 -6
- package/dist/session/artifacts.js +5 -5
- package/dist/session/checkpoints.js +5 -0
- package/dist/session/utils.d.ts +2 -2
- package/dist/session/utils.js +6 -6
- package/dist/shared/content.d.ts +1 -1
- package/dist/shared/content.js +1 -1
- package/dist/shared/data-utils.js +1 -1
- package/dist/shared/fragment-graph.d.ts +1 -1
- package/dist/shared/fragment-graph.js +5 -5
- package/dist/shared/index.js +48 -7
- package/dist/shared/retrieval.d.ts +18 -1
- package/dist/shared/retrieval.js +100 -11
- package/dist/shared/search-fallback.js +4 -6
- package/dist/shared/sqljs.d.ts +2 -0
- package/dist/shared/sqljs.js +4 -2
- package/dist/shared.d.ts +0 -1
- package/dist/shared.js +0 -1
- package/dist/shell/input.d.ts +1 -5
- package/dist/shell/input.js +16 -10
- package/dist/shell/palette.d.ts +2 -2
- package/dist/shell/palette.js +3 -7
- package/dist/shell/render.d.ts +3 -1
- package/dist/shell/render.js +4 -4
- package/dist/shell/shell.js +4 -1
- package/dist/shell/types.d.ts +1 -0
- package/dist/shell/types.js +4 -0
- package/dist/shell/view.d.ts +0 -4
- package/dist/shell/view.js +19 -27
- package/dist/skill/registry.js +25 -17
- package/dist/skill/state.d.ts +3 -0
- package/dist/skill/state.js +13 -7
- package/dist/status.js +38 -17
- package/dist/store-registry.d.ts +44 -18
- package/dist/store-registry.js +169 -60
- package/dist/store-weight.d.ts +1 -6
- package/dist/store-weight.js +4 -2
- package/dist/sync/auth-doctor.d.ts +8 -0
- package/dist/sync/auth-doctor.js +27 -0
- package/dist/sync/auth.d.ts +27 -0
- package/dist/sync/auth.js +114 -0
- package/dist/sync/conflict-resolve.d.ts +9 -0
- package/dist/sync/conflict-resolve.js +146 -0
- package/dist/sync/git-state.d.ts +4 -0
- package/dist/sync/git-state.js +49 -0
- package/dist/sync/outcome.d.ts +34 -0
- package/dist/sync/outcome.js +57 -0
- package/dist/sync/pull.d.ts +15 -7
- package/dist/sync/pull.js +84 -35
- package/dist/sync/store-merge.d.ts +29 -0
- package/dist/sync/store-merge.js +137 -0
- package/dist/sync/task-merge.d.ts +22 -0
- package/dist/sync/task-merge.js +158 -0
- package/dist/task/github.js +1 -1
- package/dist/task/lifecycle.d.ts +5 -0
- package/dist/task/lifecycle.js +67 -23
- package/dist/terminal-text.d.ts +5 -0
- package/dist/terminal-text.js +11 -0
- package/dist/test-global-setup.js +7 -0
- package/dist/tool-registry.d.ts +1 -1
- package/dist/tool-registry.js +3 -1
- package/dist/tools/code.d.ts +3 -0
- package/dist/tools/code.js +178 -0
- package/dist/tools/config.js +5 -0
- package/dist/tools/data.js +14 -7
- package/dist/tools/dispatch.d.ts +2 -0
- package/dist/tools/dispatch.js +66 -0
- package/dist/tools/finding.js +43 -41
- package/dist/tools/ops.js +5 -2
- package/dist/tools/search.js +21 -8
- package/dist/tools/session.js +21 -22
- package/dist/tools/tasks.js +8 -2
- package/dist/tools/types.d.ts +2 -2
- package/dist/tools/types.js +2 -2
- package/dist/ui/assets.js +1 -1
- package/dist/ui/data.js +14 -15
- package/dist/ui/deep-void.d.ts +1 -1
- package/dist/ui/deep-void.js +0 -1
- package/dist/ui/graph-chrome.d.ts +1 -1
- package/dist/ui/graph-chrome.js +51 -0
- package/dist/ui/page.js +5 -5
- package/dist/ui/scripts.js +67 -30
- package/dist/ui/server.js +34 -6
- package/dist/update.js +1 -1
- package/dist/utils-fts.js +1 -0
- package/dist/utils-helpers.d.ts +7 -0
- package/dist/utils-helpers.js +17 -0
- package/dist/utils.d.ts +1 -1
- package/dist/utils.js +1 -1
- package/package.json +45 -3
- package/plugins/opencode/phren-transcript.js +340 -0
- package/starter/README.md +4 -4
- package/starter/global/{CLAUDE.md → AGENTS.md} +2 -2
- package/starter/global/skills/conductor/SKILL.md +106 -0
- package/starter/global/skills/fanout/SKILL.md +20 -0
- package/starter/global/skills/phren-discover/SKILL.md +6 -6
- package/starter/global/skills/phren-init/SKILL.md +4 -4
- package/starter/global/skills/phren-sync/SKILL.md +3 -3
- package/starter/templates/frontend/reference/README.md +1 -1
- package/starter/templates/library/reference/README.md +1 -1
- package/starter/templates/monorepo/reference/README.md +1 -1
- package/starter/templates/python-project/reference/README.md +1 -1
- /package/starter/templates/frontend/{CLAUDE.md → AGENTS.md} +0 -0
- /package/starter/templates/library/{CLAUDE.md → AGENTS.md} +0 -0
- /package/starter/templates/monorepo/{CLAUDE.md → AGENTS.md} +0 -0
- /package/starter/templates/python-project/{CLAUDE.md → AGENTS.md} +0 -0
|
@@ -0,0 +1,253 @@
|
|
|
1
|
+
import { WebSocket } from "ws";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
import { logger } from "../logger.js";
|
|
4
|
+
import { queuedQuestion, threadHealth } from "./codex-threads.js";
|
|
5
|
+
import { SNAPSHOT_SHARE_MS, trustedDirectory, validateTarget } from "./herdr.js";
|
|
6
|
+
import { repositoryBranch } from "./projects.js";
|
|
7
|
+
import { BridgeError, MAX_FRAME, object, targetFromURL } from "./protocol.js";
|
|
8
|
+
import { TranscriptPreviewStream } from "./transcript-preview.js";
|
|
9
|
+
import { childAgent, childAgentTree, refreshTranscript, TranscriptReader, transcriptPath } from "./transcripts.js";
|
|
10
|
+
import { countTick } from "./metrics.js";
|
|
11
|
+
function send(socket, frame) {
|
|
12
|
+
if (socket.readyState !== WebSocket.OPEN)
|
|
13
|
+
return;
|
|
14
|
+
const data = JSON.stringify(frame);
|
|
15
|
+
if (Buffer.byteLength(data) > MAX_FRAME || socket.bufferedAmount > MAX_FRAME) {
|
|
16
|
+
socket.close(1009, "Reconnect to resume the conversation");
|
|
17
|
+
return;
|
|
18
|
+
}
|
|
19
|
+
socket.send(data);
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Why a transcript or status stream closed. Only a real target change (the
|
|
23
|
+
* 409 validation) says the conversation changed; I/O, parse and git failures
|
|
24
|
+
* keep their own words, with absolute paths cut to their last component and
|
|
25
|
+
* the reason bounded to WebSocket's 123-byte close limit.
|
|
26
|
+
*/
|
|
27
|
+
export function streamCloseReason(error) {
|
|
28
|
+
if (error instanceof BridgeError && error.status === 409)
|
|
29
|
+
return "The conversation changed; refresh";
|
|
30
|
+
const code = error?.code;
|
|
31
|
+
const first = (error instanceof Error ? error.message : String(error)).split("\n")[0]
|
|
32
|
+
.replace(/[\x00-\x1f\x7f]/g, " ").replace(/(?:~|\/)[^\s'",:]*\/([^\s'",:/]+)/g, "$1").trim();
|
|
33
|
+
let reason = error instanceof BridgeError ? first
|
|
34
|
+
: `Stream failed: ${typeof code === "string" && !first.startsWith(code) ? `${code} ` : ""}${first || "unknown error"}`;
|
|
35
|
+
while (Buffer.byteLength(reason) > 123)
|
|
36
|
+
reason = reason.slice(0, -1);
|
|
37
|
+
return reason;
|
|
38
|
+
}
|
|
39
|
+
export function transcriptStreams(ctx) {
|
|
40
|
+
const { modules, agentHooks, codexQuestions, sideQuestions, info, activeCapabilities } = ctx;
|
|
41
|
+
/** A conversation the agent has identified but not written yet (Claude
|
|
42
|
+
* Code creates its file on the first turn) is an empty transcript, not a
|
|
43
|
+
* missing one: `reader` stays undefined until the file appears. */
|
|
44
|
+
async function conversationReader(target) {
|
|
45
|
+
try {
|
|
46
|
+
const reader = new TranscriptReader(await transcriptPath(target.source, target.session), target.source, undefined, modules.has("git") ? agentHooks.changes.view(`${target.source}:${target.session}`) : undefined);
|
|
47
|
+
return { reader, source: target.source, session: target.session };
|
|
48
|
+
}
|
|
49
|
+
catch (error) {
|
|
50
|
+
if (error instanceof BridgeError && error.status === 404)
|
|
51
|
+
return { source: target.source, session: target.session };
|
|
52
|
+
throw error;
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
const emptyPage = { entries: [], totalLines: 0, startLine: 0, hasMore: false, reset: true };
|
|
56
|
+
/** The transcript of an agent the conversation spawned. The child is a
|
|
57
|
+
* parent-scoped id from `/v1/subagents`; the file is only ever reached
|
|
58
|
+
* through the relation, never by a path or session the phone names. */
|
|
59
|
+
async function childConversationReader(target, child) {
|
|
60
|
+
const relation = childAgent(await childAgentTree(target.source, target.session), child);
|
|
61
|
+
if (!relation)
|
|
62
|
+
throw new BridgeError(404, "This child agent does not belong to the selected conversation.");
|
|
63
|
+
const reader = new TranscriptReader(relation.transcript, relation.provider, undefined, undefined, relation.provider === "claude", relation.cwd);
|
|
64
|
+
return { reader, source: relation.provider, session: relation.id };
|
|
65
|
+
}
|
|
66
|
+
async function stream(client, url) {
|
|
67
|
+
const abort = new AbortController();
|
|
68
|
+
let reader, timer;
|
|
69
|
+
let unwatch;
|
|
70
|
+
let busy = false, ready = false, first = true;
|
|
71
|
+
let awaitingTranscript = false, lastTranscriptLookup = 0;
|
|
72
|
+
let initialPane;
|
|
73
|
+
const pending = [];
|
|
74
|
+
const stop = () => { abort.abort(); clearInterval(timer); unwatch?.(); pending.length = 0; };
|
|
75
|
+
client.once("close", stop);
|
|
76
|
+
client.once("error", stop);
|
|
77
|
+
// Even rejected upgrades may already contain invalid WebSocket frames.
|
|
78
|
+
// Handle their errors before parsing any untrusted destination fields.
|
|
79
|
+
const target = targetFromURL(url);
|
|
80
|
+
const previews = new TranscriptPreviewStream(target);
|
|
81
|
+
// A child agent's transcript streams through the same socket, bound to
|
|
82
|
+
// the parent conversation: the parent target is what gets revalidated
|
|
83
|
+
// each tick, and the frames name the child by its parent-scoped id.
|
|
84
|
+
const child = url.pathname === "/v1/transcripts" ? url.searchParams.get("child") : null;
|
|
85
|
+
const cursor = url.pathname === "/v1/transcripts" ? url.searchParams.get("afterLine") : null;
|
|
86
|
+
// Side answers (Claude's `/btw`) ride the parent conversation's stream
|
|
87
|
+
// for a phone that asked for them; an older phone rejects unknown frames.
|
|
88
|
+
const sideAnswers = url.pathname === "/v1/transcripts" && child === null && url.searchParams.get("sideAnswers") === "1";
|
|
89
|
+
const sentSide = new Map();
|
|
90
|
+
// The first frame stays a backlog for protocol compatibility, but a
|
|
91
|
+
// reconnect only reads rows beyond the phone's retained raw-line cursor.
|
|
92
|
+
let resumeAfterLine = cursor === null ? undefined : z.coerce.number().int().nonnegative().max(4_294_967_295).parse(cursor);
|
|
93
|
+
let conversation = { source: target.source, session: target.session };
|
|
94
|
+
// The transcript file of a fresh conversation appears with its first
|
|
95
|
+
// turn; until then the socket carries an empty backlog and keeps looking.
|
|
96
|
+
const findTranscript = async () => {
|
|
97
|
+
if (Date.now() - lastTranscriptLookup < 2_000)
|
|
98
|
+
return;
|
|
99
|
+
lastTranscriptLookup = Date.now();
|
|
100
|
+
const opened = await conversationReader(target);
|
|
101
|
+
if (opened.reader) {
|
|
102
|
+
reader = opened.reader;
|
|
103
|
+
conversation = { source: opened.source, session: opened.session };
|
|
104
|
+
awaitingTranscript = false;
|
|
105
|
+
}
|
|
106
|
+
};
|
|
107
|
+
const tick = async () => {
|
|
108
|
+
if (busy || !ready || abort.signal.aborted)
|
|
109
|
+
return;
|
|
110
|
+
busy = true;
|
|
111
|
+
try {
|
|
112
|
+
if (first || pending.length === 0) {
|
|
113
|
+
const pane = first ? initialPane : await validateTarget(target, false, false, SNAPSHOT_SHARE_MS);
|
|
114
|
+
if (awaitingTranscript)
|
|
115
|
+
await findTranscript();
|
|
116
|
+
if (awaitingTranscript) {
|
|
117
|
+
if (first)
|
|
118
|
+
send(client, { ...emptyPage, type: "backlog", ...conversation });
|
|
119
|
+
}
|
|
120
|
+
else if (reader) {
|
|
121
|
+
await refreshTranscript(reader.file, conversation.source, conversation.session);
|
|
122
|
+
if (first && child === null && target.source === "claude" && resumeAfterLine !== undefined) {
|
|
123
|
+
// A reconnect cursor can omit the current user row entirely.
|
|
124
|
+
// Seed only ephemeral turn state from the bounded recent tail.
|
|
125
|
+
previews.observe((await new TranscriptReader(reader.file, conversation.source).read(undefined, abort.signal)).entries);
|
|
126
|
+
}
|
|
127
|
+
const page = resumeAfterLine === undefined
|
|
128
|
+
? await reader.read(undefined, abort.signal)
|
|
129
|
+
: await reader.readAfter(resumeAfterLine, abort.signal);
|
|
130
|
+
resumeAfterLine = undefined;
|
|
131
|
+
if (child === null)
|
|
132
|
+
previews.observe(page.entries, page.reset);
|
|
133
|
+
const preview = child === null ? await previews.update(pane.agent_status, reader.file) : undefined;
|
|
134
|
+
// `activityVerb` stays for phones that predate `activity`.
|
|
135
|
+
const activity = previews.activity ? { activityVerb: previews.activity.verb, activity: { ...previews.activity } }
|
|
136
|
+
: previews.verb ? { activityVerb: previews.verb } : {};
|
|
137
|
+
if (first || page.entries.length || page.reset)
|
|
138
|
+
send(client, { ...page, ...preview, ...activity, type: first || page.reset ? "backlog" : "append", ...conversation });
|
|
139
|
+
else if (preview)
|
|
140
|
+
send(client, { type: "preview", ...conversation, ...preview, ...activity });
|
|
141
|
+
}
|
|
142
|
+
else {
|
|
143
|
+
let pendingApproval = agentHooks.approval(target);
|
|
144
|
+
const pendingQuestions = target.source === "codex" ? await codexQuestions.pending(target).catch(() => undefined) : undefined;
|
|
145
|
+
const cwd = await trustedDirectory(pane).catch(() => undefined);
|
|
146
|
+
const branch = modules.has("git") && cwd ? await repositoryBranch(cwd) : undefined;
|
|
147
|
+
const waiting = !pendingApproval && ["blocked", "waiting"].includes(String(pane.agent_status));
|
|
148
|
+
// Claude Code's auto-mode fallback, opencode and Codex draw a
|
|
149
|
+
// numbered dialog in the pane with no PermissionRequest hook
|
|
150
|
+
// behind it: read the pane (at most once per three seconds) and
|
|
151
|
+
// publish the dialog as the same terminal choice shape the phone
|
|
152
|
+
// answers. Codex also resolves the real terminal choices for a held
|
|
153
|
+
// approval; a structured question keeps its own answer channel.
|
|
154
|
+
if (["claude", "opencode", "codex"].includes(target.source)) {
|
|
155
|
+
await agentHooks.syncTerminalDialog(target, waiting && !pendingQuestions?.length);
|
|
156
|
+
pendingApproval = agentHooks.approval(target);
|
|
157
|
+
}
|
|
158
|
+
const hookPrompt = waiting ? agentHooks.terminalPrompt(target) : undefined;
|
|
159
|
+
// Codex 0.155's queued follow-up question never becomes a held
|
|
160
|
+
// PermissionRequest: it lives as a thread item the terminal shows
|
|
161
|
+
// under "Queued follow-up inputs". With nothing else to ask, read
|
|
162
|
+
// its text and options and publish them as the same choice shape
|
|
163
|
+
// the phone already answers with keys (alt+up, then the option).
|
|
164
|
+
const terminalPrompt = hookPrompt
|
|
165
|
+
?? (waiting && target.source === "codex" && !pendingQuestions?.length
|
|
166
|
+
? await queuedQuestion(target.session).then(queued => queued ? {
|
|
167
|
+
toolName: "Question", message: queued.title, queued: true,
|
|
168
|
+
choice: { title: queued.title, options: queued.options },
|
|
169
|
+
} : undefined).catch(() => undefined)
|
|
170
|
+
: undefined);
|
|
171
|
+
const historyHealth = target.source === "codex" ? await threadHealth(target.session, pane.agent_status) : { stalled: false };
|
|
172
|
+
send(client, { agentStatus: { source: target.source, session: target.session,
|
|
173
|
+
status: pendingApproval ? "waiting" : pane.agent_status, pendingApproval, pendingQuestions, terminalPrompt,
|
|
174
|
+
...(waiting && agentHooks.passwordPrompt(target) ? { passwordPrompt: true } : {}),
|
|
175
|
+
compacting: agentHooks.compacting(target),
|
|
176
|
+
...(historyHealth.stalled ? { historyStalled: true, historyStalledSince: historyHealth.since } : {}),
|
|
177
|
+
modules: info.modules, store: info.store, profile: info.profile, generation: info.generation,
|
|
178
|
+
capabilities: { ...activeCapabilities, asyncQuestions: target.source === "codex" && codexQuestions.available }, branch } });
|
|
179
|
+
}
|
|
180
|
+
if (sideAnswers && sideQuestions) {
|
|
181
|
+
for (const { revision, ...side } of sideQuestions.list(target)) {
|
|
182
|
+
if (sentSide.get(side.id) === revision)
|
|
183
|
+
continue;
|
|
184
|
+
sentSide.set(side.id, revision);
|
|
185
|
+
send(client, { type: "side-answer", ...conversation, ...side });
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
first = false;
|
|
189
|
+
}
|
|
190
|
+
while (pending.length && reader && !abort.signal.aborted) {
|
|
191
|
+
const before = pending.shift();
|
|
192
|
+
await validateTarget(target, false, false, SNAPSHOT_SHARE_MS);
|
|
193
|
+
const page = await reader.read(before, abort.signal);
|
|
194
|
+
send(client, { ...page, type: "older", ...conversation });
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
catch (error) {
|
|
198
|
+
const reason = streamCloseReason(error);
|
|
199
|
+
if (!(error instanceof BridgeError && error.status === 409))
|
|
200
|
+
logger.warn("stream", `${url.pathname} closed: ${reason}`);
|
|
201
|
+
stop();
|
|
202
|
+
client.close(1011, reason);
|
|
203
|
+
}
|
|
204
|
+
finally {
|
|
205
|
+
busy = false;
|
|
206
|
+
if (pending.length)
|
|
207
|
+
void tick();
|
|
208
|
+
}
|
|
209
|
+
};
|
|
210
|
+
client.on("message", bytes => {
|
|
211
|
+
try {
|
|
212
|
+
const message = object(JSON.parse(bytes.toString()));
|
|
213
|
+
if (message.type !== "older" || url.pathname !== "/v1/transcripts" || abort.signal.aborted)
|
|
214
|
+
return;
|
|
215
|
+
const before = z.number().int().positive().parse(message.beforeLine);
|
|
216
|
+
if (pending.length >= 8)
|
|
217
|
+
throw new Error("History queue is full");
|
|
218
|
+
if (!pending.includes(before))
|
|
219
|
+
pending.push(before);
|
|
220
|
+
void tick();
|
|
221
|
+
}
|
|
222
|
+
catch {
|
|
223
|
+
stop();
|
|
224
|
+
client.close(1008, "Invalid history request");
|
|
225
|
+
}
|
|
226
|
+
});
|
|
227
|
+
try {
|
|
228
|
+
initialPane = await validateTarget(target);
|
|
229
|
+
if (abort.signal.aborted)
|
|
230
|
+
return;
|
|
231
|
+
unwatch = agentHooks.watch(target);
|
|
232
|
+
if (url.pathname === "/v1/transcripts") {
|
|
233
|
+
const opened = child === null ? await conversationReader(target) : await childConversationReader(target, child);
|
|
234
|
+
reader = opened.reader;
|
|
235
|
+
conversation = { source: opened.source, session: opened.session };
|
|
236
|
+
awaitingTranscript = child === null && !reader;
|
|
237
|
+
lastTranscriptLookup = Date.now();
|
|
238
|
+
}
|
|
239
|
+
if (abort.signal.aborted) {
|
|
240
|
+
stop();
|
|
241
|
+
return;
|
|
242
|
+
}
|
|
243
|
+
ready = true;
|
|
244
|
+
timer = setInterval(() => { countTick(url.pathname === "/v1/transcripts" ? "stream-transcripts" : "stream-status"); void tick(); }, reader || awaitingTranscript ? 500 : 1500);
|
|
245
|
+
await tick();
|
|
246
|
+
}
|
|
247
|
+
catch (error) {
|
|
248
|
+
stop();
|
|
249
|
+
throw error;
|
|
250
|
+
}
|
|
251
|
+
}
|
|
252
|
+
return { conversationReader, childConversationReader, emptyPage, stream };
|
|
253
|
+
}
|
package/dist/bridge/server.d.ts
CHANGED
|
@@ -1,16 +1,4 @@
|
|
|
1
|
-
export
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
images: boolean;
|
|
5
|
-
prompt: boolean;
|
|
6
|
-
stop: boolean;
|
|
7
|
-
terminal: string;
|
|
8
|
-
herdr: boolean;
|
|
9
|
-
diff: boolean;
|
|
10
|
-
webServers: boolean;
|
|
11
|
-
activity: boolean;
|
|
12
|
-
approvals: boolean;
|
|
13
|
-
questions: boolean;
|
|
14
|
-
providers: string[];
|
|
15
|
-
};
|
|
1
|
+
export { capabilities, capabilitiesForModules, requireRoute } from "./server-routes.js";
|
|
2
|
+
export { streamCloseReason } from "./server-stream.js";
|
|
3
|
+
export { herdrAgentName, launchSession } from "./server-launch.js";
|
|
16
4
|
export declare function serve(version: string): Promise<void>;
|