@phren/cli 0.3.71 → 0.3.72

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 (107) hide show
  1. package/dist/bridge/browser-env.d.ts +5 -0
  2. package/dist/bridge/browser-env.js +86 -0
  3. package/dist/bridge/browser-protocol.d.ts +120 -0
  4. package/dist/bridge/browser-protocol.js +70 -0
  5. package/dist/bridge/browser-recordings.d.ts +63 -0
  6. package/dist/bridge/browser-recordings.js +148 -0
  7. package/dist/bridge/browser-registry.d.ts +64 -0
  8. package/dist/bridge/browser-registry.js +262 -0
  9. package/dist/bridge/browser-routes.d.ts +4 -0
  10. package/dist/bridge/browser-routes.js +39 -0
  11. package/dist/bridge/browser-shim/phren-playwright.cjs +184 -0
  12. package/dist/bridge/browser-socket.d.ts +2 -0
  13. package/dist/bridge/browser-socket.js +10 -0
  14. package/dist/bridge/browser-stream.d.ts +3 -0
  15. package/dist/bridge/browser-stream.js +129 -0
  16. package/dist/bridge/dispatch.d.ts +10 -0
  17. package/dist/bridge/dispatch.js +3 -1
  18. package/dist/bridge/dream-schedule.d.ts +133 -0
  19. package/dist/bridge/dream-schedule.js +322 -0
  20. package/dist/bridge/herdr.js +15 -6
  21. package/dist/bridge/install.js +4 -0
  22. package/dist/bridge/launch-brief.d.ts +11 -0
  23. package/dist/bridge/launch-brief.js +22 -0
  24. package/dist/bridge/pane-status.js +1 -1
  25. package/dist/bridge/server-routes.d.ts +3 -0
  26. package/dist/bridge/server-routes.js +15 -15
  27. package/dist/bridge/server-stream.d.ts +4 -0
  28. package/dist/bridge/server-stream.js +24 -5
  29. package/dist/bridge/server.js +23 -3
  30. package/dist/bridge/session-move.d.ts +10 -4
  31. package/dist/bridge/session-move.js +65 -34
  32. package/dist/bridge/simulator-stream.d.ts +2 -0
  33. package/dist/bridge/simulator-stream.js +2 -0
  34. package/dist/bridge/tab-activity.d.ts +2 -0
  35. package/dist/bridge/tab-activity.js +15 -2
  36. package/dist/bridge/task-routes.d.ts +20 -16
  37. package/dist/bridge/task-routes.js +1 -1
  38. package/dist/bridge/terminal-herdr.js +2 -1
  39. package/dist/bridge/terminal-tmux.js +2 -1
  40. package/dist/bridge/worker-reports.js +15 -3
  41. package/dist/bridge-hook.mjs +36800 -35213
  42. package/dist/capabilities/mcp.js +1 -1
  43. package/dist/cli/config-dreaming.d.ts +7 -0
  44. package/dist/cli/config-dreaming.js +72 -0
  45. package/dist/cli/config.js +6 -0
  46. package/dist/cli/dream.d.ts +59 -0
  47. package/dist/cli/dream.js +315 -0
  48. package/dist/cli/namespaces-tasks.js +14 -0
  49. package/dist/cli-registry.js +24 -1
  50. package/dist/config/dreaming.d.ts +82 -0
  51. package/dist/config/dreaming.js +195 -0
  52. package/dist/config/resolve.js +11 -0
  53. package/dist/config/schema.d.ts +4 -4
  54. package/dist/config/schema.js +157 -1
  55. package/dist/content/citation-freshness.js +6 -0
  56. package/dist/content/learning.d.ts +1 -0
  57. package/dist/content/learning.js +2 -0
  58. package/dist/data/access.d.ts +1 -1
  59. package/dist/data/access.js +3 -1
  60. package/dist/data/task-contract.d.ts +5 -4
  61. package/dist/data/tasks.d.ts +5 -0
  62. package/dist/data/tasks.js +28 -2
  63. package/dist/dream/apply.d.ts +69 -0
  64. package/dist/dream/apply.js +372 -0
  65. package/dist/dream/budget.d.ts +78 -0
  66. package/dist/dream/budget.js +180 -0
  67. package/dist/dream/collect.d.ts +86 -0
  68. package/dist/dream/collect.js +449 -0
  69. package/dist/dream/eval/dream-adapter.d.ts +16 -0
  70. package/dist/dream/eval/dream-adapter.js +21 -0
  71. package/dist/dream/eval/fixture.d.ts +53 -0
  72. package/dist/dream/eval/fixture.js +172 -0
  73. package/dist/dream/eval/index.d.ts +40 -0
  74. package/dist/dream/eval/index.js +78 -0
  75. package/dist/dream/eval/score.d.ts +34 -0
  76. package/dist/dream/eval/score.js +99 -0
  77. package/dist/dream/eval/scripted-model.d.ts +19 -0
  78. package/dist/dream/eval/scripted-model.js +70 -0
  79. package/dist/dream/pages.d.ts +68 -0
  80. package/dist/dream/pages.js +220 -0
  81. package/dist/dream/privacy.d.ts +3 -0
  82. package/dist/dream/privacy.js +18 -0
  83. package/dist/dream/prompt.d.ts +13 -0
  84. package/dist/dream/prompt.js +84 -0
  85. package/dist/dream/run.d.ts +98 -0
  86. package/dist/dream/run.js +317 -0
  87. package/dist/dream/types.d.ts +74 -0
  88. package/dist/dream/types.js +4 -0
  89. package/dist/finding/lifecycle.d.ts +2 -2
  90. package/dist/finding/lifecycle.js +5 -2
  91. package/dist/finding/versions.d.ts +4 -0
  92. package/dist/finding/versions.js +28 -0
  93. package/dist/index.js +1 -0
  94. package/dist/modules/registry.js +9 -7
  95. package/dist/project-config.d.ts +3 -0
  96. package/dist/task/merge-links.d.ts +38 -0
  97. package/dist/task/merge-links.js +45 -0
  98. package/dist/task/reconcile.d.ts +39 -0
  99. package/dist/task/reconcile.js +201 -0
  100. package/dist/task/report-links.d.ts +10 -0
  101. package/dist/task/report-links.js +47 -0
  102. package/dist/tools/config.js +46 -4
  103. package/dist/tools/dispatch.js +2 -1
  104. package/dist/tools/dream.d.ts +3 -0
  105. package/dist/tools/dream.js +123 -0
  106. package/dist/tools/tasks.js +4 -1
  107. package/package.json +1 -1
@@ -69,6 +69,10 @@ export declare function getTaskRoute(base: string, url: URL): {
69
69
  };
70
70
  items: {
71
71
  [k: string]: {
72
+ responsibility: import("../data/task-contract.js").TaskResponsibility;
73
+ readiness: "ready" | "waiting-on-human" | "waiting-on-task";
74
+ prerequisites: import("../data/task-contract.js").TaskPrerequisite[];
75
+ identity: import("../data/task-contract.js").TaskDependency | null;
72
76
  id: string;
73
77
  stableId?: string;
74
78
  identityAmbiguous?: boolean;
@@ -77,6 +81,7 @@ export declare function getTaskRoute(base: string, url: URL): {
77
81
  checked: boolean;
78
82
  priority?: "high" | "medium" | "low";
79
83
  context?: string;
84
+ links?: import("../task/merge-links.js").TaskLinks;
80
85
  pinned?: boolean;
81
86
  githubIssue?: number;
82
87
  githubUrl?: string;
@@ -95,10 +100,6 @@ export declare function getTaskRoute(base: string, url: URL): {
95
100
  taskContractRecords?: string[];
96
101
  taskContractLines?: string[];
97
102
  opaqueContinuationLines?: string[];
98
- responsibility: import("../data/task-contract.js").TaskResponsibility;
99
- readiness: "ready" | "waiting-on-human" | "waiting-on-task";
100
- prerequisites: import("../data/task-contract.js").TaskPrerequisite[];
101
- identity: import("../data/task-contract.js").TaskDependency | null;
102
103
  }[];
103
104
  };
104
105
  };
@@ -126,6 +127,10 @@ export declare function updateTaskRoute(base: string, input: unknown): {
126
127
  };
127
128
  items: {
128
129
  [k: string]: {
130
+ responsibility: import("../data/task-contract.js").TaskResponsibility;
131
+ readiness: "ready" | "waiting-on-human" | "waiting-on-task";
132
+ prerequisites: import("../data/task-contract.js").TaskPrerequisite[];
133
+ identity: import("../data/task-contract.js").TaskDependency | null;
129
134
  id: string;
130
135
  stableId?: string;
131
136
  identityAmbiguous?: boolean;
@@ -134,6 +139,7 @@ export declare function updateTaskRoute(base: string, input: unknown): {
134
139
  checked: boolean;
135
140
  priority?: "high" | "medium" | "low";
136
141
  context?: string;
142
+ links?: import("../task/merge-links.js").TaskLinks;
137
143
  pinned?: boolean;
138
144
  githubIssue?: number;
139
145
  githubUrl?: string;
@@ -152,10 +158,6 @@ export declare function updateTaskRoute(base: string, input: unknown): {
152
158
  taskContractRecords?: string[];
153
159
  taskContractLines?: string[];
154
160
  opaqueContinuationLines?: string[];
155
- responsibility: import("../data/task-contract.js").TaskResponsibility;
156
- readiness: "ready" | "waiting-on-human" | "waiting-on-task";
157
- prerequisites: import("../data/task-contract.js").TaskPrerequisite[];
158
- identity: import("../data/task-contract.js").TaskDependency | null;
159
161
  }[];
160
162
  };
161
163
  };
@@ -185,6 +187,10 @@ export declare function createTaskRoute(base: string, input: unknown): {
185
187
  };
186
188
  items: {
187
189
  [k: string]: {
190
+ responsibility: import("../data/task-contract.js").TaskResponsibility;
191
+ readiness: "ready" | "waiting-on-human" | "waiting-on-task";
192
+ prerequisites: import("../data/task-contract.js").TaskPrerequisite[];
193
+ identity: import("../data/task-contract.js").TaskDependency | null;
188
194
  id: string;
189
195
  stableId?: string;
190
196
  identityAmbiguous?: boolean;
@@ -193,6 +199,7 @@ export declare function createTaskRoute(base: string, input: unknown): {
193
199
  checked: boolean;
194
200
  priority?: "high" | "medium" | "low";
195
201
  context?: string;
202
+ links?: import("../task/merge-links.js").TaskLinks;
196
203
  pinned?: boolean;
197
204
  githubIssue?: number;
198
205
  githubUrl?: string;
@@ -211,10 +218,6 @@ export declare function createTaskRoute(base: string, input: unknown): {
211
218
  taskContractRecords?: string[];
212
219
  taskContractLines?: string[];
213
220
  opaqueContinuationLines?: string[];
214
- responsibility: import("../data/task-contract.js").TaskResponsibility;
215
- readiness: "ready" | "waiting-on-human" | "waiting-on-task";
216
- prerequisites: import("../data/task-contract.js").TaskPrerequisite[];
217
- identity: import("../data/task-contract.js").TaskDependency | null;
218
221
  }[];
219
222
  };
220
223
  };
@@ -244,6 +247,10 @@ export declare function saveTaskRoute(base: string, input: unknown): {
244
247
  };
245
248
  items: {
246
249
  [k: string]: {
250
+ responsibility: import("../data/task-contract.js").TaskResponsibility;
251
+ readiness: "ready" | "waiting-on-human" | "waiting-on-task";
252
+ prerequisites: import("../data/task-contract.js").TaskPrerequisite[];
253
+ identity: import("../data/task-contract.js").TaskDependency | null;
247
254
  id: string;
248
255
  stableId?: string;
249
256
  identityAmbiguous?: boolean;
@@ -252,6 +259,7 @@ export declare function saveTaskRoute(base: string, input: unknown): {
252
259
  checked: boolean;
253
260
  priority?: "high" | "medium" | "low";
254
261
  context?: string;
262
+ links?: import("../task/merge-links.js").TaskLinks;
255
263
  pinned?: boolean;
256
264
  githubIssue?: number;
257
265
  githubUrl?: string;
@@ -270,10 +278,6 @@ export declare function saveTaskRoute(base: string, input: unknown): {
270
278
  taskContractRecords?: string[];
271
279
  taskContractLines?: string[];
272
280
  opaqueContinuationLines?: string[];
273
- responsibility: import("../data/task-contract.js").TaskResponsibility;
274
- readiness: "ready" | "waiting-on-human" | "waiting-on-task";
275
- prerequisites: import("../data/task-contract.js").TaskPrerequisite[];
276
- identity: import("../data/task-contract.js").TaskDependency | null;
277
281
  }[];
278
282
  };
279
283
  };
@@ -152,7 +152,7 @@ export async function launchTaskRoute(base, server, input) {
152
152
  try {
153
153
  const launched = await launchSession(server, { kind: data.kind, model: data.model, effort: data.effort, account: data.account,
154
154
  permissionMode: data.permissionMode, role: "agent", cwd, label: task.text.slice(0, 200),
155
- launchId: task.launchId, brief: { id: task.launchId, text } }, { trustFolder: true });
155
+ launchId: task.launchId, brief: { id: task.launchId, text, task: task.identity } }, { trustFolder: true });
156
156
  return { ...launched, task: task.identity, taskRevision: task.revision, launchId: task.launchId, claimPreserved: true,
157
157
  state: launched.briefState === "sent" ? "started" : "uncertain" };
158
158
  }
@@ -1,3 +1,4 @@
1
+ import { browserEnv } from "./browser-env.js";
1
2
  // Herdr as the Hook's terminal provider: each method is one call on Herdr's
2
3
  // socket API. It calls herdr.ts's exported `rpc`, the seam the bridge tests
3
4
  // fake, so a test that records Herdr requests sees exactly what it did before
@@ -163,7 +164,7 @@ export const herdrTerminal = {
163
164
  },
164
165
  // What Herdr sets in its own panes (herdrPaneFromEnv reads them back).
165
166
  paneEnv(server, { workspace, tab, pane }) {
166
- return { HERDR_ENV: "1", HERDR_SOCKET_PATH: herdrSocketPath(server), HERDR_WORKSPACE_ID: workspace, HERDR_TAB_ID: tab, HERDR_PANE_ID: pane };
167
+ return { ...browserEnv(pane), HERDR_ENV: "1", HERDR_SOCKET_PATH: herdrSocketPath(server), HERDR_WORKSPACE_ID: workspace, HERDR_TAB_ID: tab, HERDR_PANE_ID: pane };
167
168
  },
168
169
  async reportAgent(server, pane, agent, state) {
169
170
  await rpc(server, "pane.report_agent", { pane_id: pane, source: PHREN_REPORT_SOURCE, agent, state });
@@ -1,3 +1,4 @@
1
+ import { browserEnv } from "./browser-env.js";
1
2
  // tmux as the Hook's terminal provider, for computers without Herdr.
2
3
  //
3
4
  // Two tmux servers are Hook servers: the owner's own (the default socket,
@@ -494,7 +495,7 @@ export const tmuxTerminal = {
494
495
  paneEnv(server, { pane }) {
495
496
  const socket = socketOf(server), folder = tmuxSocketFolders()[0];
496
497
  const file = socketPaths.get(socket) ?? (folder ? path.join(folder, socket) : undefined);
497
- return file ? { TMUX: `${file},0,0`, TMUX_PANE: toTmuxId(pane, "p") } : undefined;
498
+ return file ? { ...browserEnv(pane), TMUX: `${file},0,0`, TMUX_PANE: toTmuxId(pane, "p") } : undefined;
498
499
  },
499
500
  // A pane user option, not `select-pane -T`: agents overwrite the pane title.
500
501
  async renamePane(server, pane, label) {
@@ -1,3 +1,6 @@
1
+ import { mergeTaskIdentitySchema } from "../task/merge-links.js";
2
+ import { recordTaskPrs } from "../task/report-links.js";
3
+ import { phrenStoreRoot } from "./transcripts.js";
1
4
  import { createHash } from "node:crypto";
2
5
  import { lstat, readFile } from "node:fs/promises";
3
6
  import path from "node:path";
@@ -6,7 +9,7 @@ import { atomicInPrivateDir, BridgeError, bridgeRoot, targetSchema } from "./pro
6
9
  import { paneIdentity, findPane, snapshot, validateTarget } from "./herdr.js";
7
10
  import { originPaneSchema } from "./dispatch.js";
8
11
  import { paneTurn } from "./dispatch-returns.js";
9
- import { briefArrival, briefId } from "./launch-brief.js";
12
+ import { briefArrival, briefId, briefTask } from "./launch-brief.js";
10
13
  import { integratorSchema, prsSchema, reportText as text } from "./return-contract.js";
11
14
  export { integratorSchema, prsSchema, pullRequestSchema } from "./return-contract.js";
12
15
  // `promptSeq` is absent for a report bound by its dispatch instead of a recorded prompt (`reportWorker`).
@@ -23,7 +26,7 @@ const reportFile = (target) => path.join(bridgeRoot(), "worker-reports", `${key(
23
26
  * still reports; the evidence binds to its current turn, the one the next
24
27
  * Stop ends, and never to a prompt submitted after the report. */
25
28
  export async function reportWorker(input) {
26
- const data = z.object({ origin: originPaneSchema, prs: prsSchema, dispatch: briefId.optional() }).strict().parse(input);
29
+ const data = z.object({ origin: originPaneSchema, prs: prsSchema, task: mergeTaskIdentitySchema.optional(), dispatch: briefId.optional() }).strict().parse(input);
27
30
  const pane = findPane(await snapshot(data.origin.server), data.origin);
28
31
  if (!pane)
29
32
  throw new BridgeError(409, "The worker pane changed.");
@@ -35,7 +38,16 @@ export async function reportWorker(input) {
35
38
  if (promptSeq === undefined && !(typeof pane.terminal_id === "string" && await arrivedHere(data.dispatch ?? (record && record.session === session ? record.dispatch : undefined), target)))
36
39
  throw new BridgeError(409, "The Hook has not recorded this worker's submitted turn yet, and no dispatch it launched arrived in this pane.");
37
40
  await atomicInPrivateDir(reportFile(target), reportSchema.parse({ target, terminal: pane.terminal_id, ...(promptSeq !== undefined ? { promptSeq } : {}), prs: data.prs, at: new Date().toISOString() }));
38
- return { ok: true, target, prs: data.prs };
41
+ const dispatch = data.dispatch ?? record?.dispatch;
42
+ const task = data.task ?? (dispatch ? await briefTask(dispatch) : undefined);
43
+ let taskLinks;
44
+ try {
45
+ taskLinks = recordTaskPrs(phrenStoreRoot(), data.prs, task, dispatch);
46
+ }
47
+ catch {
48
+ taskLinks = { linked: false, error: "PR report saved, but the private task link could not be saved. Retry the report." };
49
+ }
50
+ return { ok: true, target, prs: data.prs, taskLinks };
39
51
  }
40
52
  /** Whether this Hook launched dispatch `id` and its brief arrived in exactly this pane and conversation. */
41
53
  async function arrivedHere(id, target) {