@osolmaz/pi-workflows 0.10.0 → 0.11.1

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 (135) hide show
  1. package/README.md +32 -14
  2. package/dist/builtins/autodoc.workflow.d.ts +58 -0
  3. package/dist/builtins/autodoc.workflow.js +266 -0
  4. package/dist/builtins/autodoc.workflow.js.map +1 -0
  5. package/dist/builtins/autoimplement.workflow.d.ts +212 -11
  6. package/dist/builtins/autoimplement.workflow.js +431 -22
  7. package/dist/builtins/autoimplement.workflow.js.map +1 -1
  8. package/dist/builtins/{autodevise.workflow.d.ts → autoplan.workflow.d.ts} +9 -9
  9. package/dist/builtins/{autodevise.workflow.js → autoplan.workflow.js} +20 -20
  10. package/dist/builtins/autoplan.workflow.js.map +1 -0
  11. package/dist/builtins/catalog.js +8 -4
  12. package/dist/builtins/catalog.js.map +1 -1
  13. package/dist/builtins/index.d.ts +6 -3
  14. package/dist/builtins/index.js +5 -2
  15. package/dist/builtins/index.js.map +1 -1
  16. package/dist/builtins/monitor.workflow.d.ts +4 -0
  17. package/dist/builtins/monitor.workflow.js +134 -9
  18. package/dist/builtins/monitor.workflow.js.map +1 -1
  19. package/dist/builtins/plan-approval.workflow.d.ts +83 -0
  20. package/dist/builtins/plan-approval.workflow.js +148 -0
  21. package/dist/builtins/plan-approval.workflow.js.map +1 -0
  22. package/dist/builtins/plan-presentation.d.ts +7 -0
  23. package/dist/builtins/plan-presentation.js +44 -0
  24. package/dist/builtins/plan-presentation.js.map +1 -0
  25. package/dist/extension/decision-channels.d.ts +132 -0
  26. package/dist/extension/decision-channels.js +1082 -0
  27. package/dist/extension/decision-channels.js.map +1 -0
  28. package/dist/extension/index.d.ts +1 -0
  29. package/dist/extension/index.js +426 -11
  30. package/dist/extension/index.js.map +1 -1
  31. package/dist/extension/widget.js +26 -2
  32. package/dist/extension/widget.js.map +1 -1
  33. package/dist/extension/workflow-tool.d.ts +1 -37
  34. package/dist/extension/workflow-tool.js +1 -42
  35. package/dist/extension/workflow-tool.js.map +1 -1
  36. package/dist/herdr/setup.d.ts +13 -1
  37. package/dist/herdr/setup.js +349 -36
  38. package/dist/herdr/setup.js.map +1 -1
  39. package/dist/host/rpc-bridge.js +4 -21
  40. package/dist/host/rpc-bridge.js.map +1 -1
  41. package/dist/render/graph-render.js +33 -8
  42. package/dist/render/graph-render.js.map +1 -1
  43. package/dist/viewer/cli.d.ts +1 -0
  44. package/dist/viewer/cli.js +21 -10
  45. package/dist/viewer/cli.js.map +1 -1
  46. package/dist/viewer/render.js +36 -2
  47. package/dist/viewer/render.js.map +1 -1
  48. package/dist/workflows/composition.js +15 -1
  49. package/dist/workflows/composition.js.map +1 -1
  50. package/dist/workflows/decision-presentation.d.ts +18 -0
  51. package/dist/workflows/decision-presentation.js +417 -0
  52. package/dist/workflows/decision-presentation.js.map +1 -0
  53. package/dist/workflows/engine.d.ts +2 -1
  54. package/dist/workflows/engine.js +86 -4
  55. package/dist/workflows/engine.js.map +1 -1
  56. package/dist/workflows/human-decision.d.ts +87 -0
  57. package/dist/workflows/human-decision.js +583 -0
  58. package/dist/workflows/human-decision.js.map +1 -0
  59. package/dist/workflows/index.d.ts +3 -1
  60. package/dist/workflows/index.js +2 -0
  61. package/dist/workflows/index.js.map +1 -1
  62. package/dist/workflows/schema.js +15 -0
  63. package/dist/workflows/schema.js.map +1 -1
  64. package/dist/workflows/store.js +7 -0
  65. package/dist/workflows/store.js.map +1 -1
  66. package/dist/workflows/tool-input.d.ts +72 -0
  67. package/dist/workflows/tool-input.js +141 -0
  68. package/dist/workflows/tool-input.js.map +1 -0
  69. package/dist/workflows/types.d.ts +223 -0
  70. package/docs/HUMAN_DECISIONS.md +371 -0
  71. package/docs/HUMAN_DECISION_PRESENTATIONS.md +323 -0
  72. package/docs/MONITOR.md +17 -6
  73. package/docs/WORKFLOW_COMPOSITION.md +13 -6
  74. package/docs/plans/2026-08-19-human-decision-gates-plan.md +296 -0
  75. package/docs/plans/2026-08-19-human-decision-presentations-plan.md +172 -0
  76. package/docs/plans/2026-08-19-provider-compatible-workflow-tool-schema-plan.md +45 -0
  77. package/docs/plans/2026-08-19-workflow-composition-plan.md +25 -17
  78. package/docs/plans/2026-08-20-autoimplement-blocker-challenge-plan.md +138 -0
  79. package/docs/plans/2026-08-20-herdr-plugin-sync-plan.md +104 -0
  80. package/docs/run-bundles.md +23 -2
  81. package/docs/workflows.md +47 -5
  82. package/examples/workflows/approved-plan.workflow.ts +58 -0
  83. package/examples/workflows/autoplan.workflow.ts +1 -0
  84. package/examples/workflows/human-decision.workflow.ts +62 -0
  85. package/herdr-plugin.toml +1 -1
  86. package/package.json +2 -1
  87. package/schemas/decision-presentation-v1.schema.json +83 -0
  88. package/schemas/human-decision-accepted-v1.schema.json +44 -0
  89. package/schemas/human-decision-accepted-v2.schema.json +50 -0
  90. package/schemas/human-decision-answer-attempt-v1.schema.json +37 -0
  91. package/schemas/human-decision-cancellation-v1.schema.json +15 -0
  92. package/schemas/human-decision-continuation-v1.schema.json +16 -0
  93. package/schemas/human-decision-delivery-v1.schema.json +28 -0
  94. package/schemas/human-decision-delivery-v2.schema.json +36 -0
  95. package/schemas/human-decision-receipt-v1.schema.json +33 -0
  96. package/schemas/human-decision-receipt-v2.schema.json +39 -0
  97. package/schemas/human-decision-request-v1.schema.json +59 -0
  98. package/schemas/human-decision-request-v2.schema.json +69 -0
  99. package/schemas/human-decision-resolution-v1.schema.json +27 -0
  100. package/schemas/human-decision-resolution-v2.schema.json +27 -0
  101. package/schemas/human-decision-settlement-v1.schema.json +28 -0
  102. package/skills/autodoc/SKILL.md +43 -0
  103. package/skills/autoimplement/SKILL.md +58 -0
  104. package/skills/autoimplement/agents/openai.yaml +4 -0
  105. package/skills/autoplan/SKILL.md +25 -0
  106. package/skills/monitor/SKILL.md +3 -1
  107. package/skills/pi-workflows/SKILL.md +3 -3
  108. package/src/builtins/autodoc.workflow.ts +325 -0
  109. package/src/builtins/autoimplement.workflow.ts +493 -23
  110. package/src/builtins/{autodevise.workflow.ts → autoplan.workflow.ts} +32 -32
  111. package/src/builtins/catalog.ts +8 -4
  112. package/src/builtins/index.ts +25 -6
  113. package/src/builtins/monitor.workflow.ts +162 -8
  114. package/src/builtins/plan-approval.workflow.ts +190 -0
  115. package/src/builtins/plan-presentation.ts +57 -0
  116. package/src/extension/decision-channels.ts +1533 -0
  117. package/src/extension/index.ts +499 -9
  118. package/src/extension/widget.ts +39 -2
  119. package/src/extension/workflow-tool.ts +5 -81
  120. package/src/herdr/setup.ts +429 -39
  121. package/src/host/rpc-bridge.ts +7 -30
  122. package/src/render/graph-render.ts +40 -3
  123. package/src/viewer/cli.ts +22 -10
  124. package/src/viewer/render.ts +56 -3
  125. package/src/workflows/composition.ts +16 -1
  126. package/src/workflows/decision-presentation.ts +501 -0
  127. package/src/workflows/engine.ts +108 -4
  128. package/src/workflows/human-decision.ts +819 -0
  129. package/src/workflows/index.ts +69 -0
  130. package/src/workflows/schema.ts +17 -0
  131. package/src/workflows/store.ts +8 -0
  132. package/src/workflows/tool-input.ts +202 -0
  133. package/src/workflows/types.ts +265 -0
  134. package/dist/builtins/autodevise.workflow.js.map +0 -1
  135. package/examples/workflows/autodevise.workflow.ts +0 -1
@@ -2,41 +2,204 @@ import { spawnSync } from "node:child_process";
2
2
  import fs from "node:fs";
3
3
  import path from "node:path";
4
4
  import { HERDR_PLUGIN_ID } from "./constants.js";
5
- export function setupHerdrPlugin(packageRoot, spawn = runCommand) {
6
- const root = path.resolve(packageRoot);
7
- const manifest = path.join(root, "herdr-plugin.toml");
8
- if (!fs.existsSync(manifest)) {
9
- throw new Error(`Herdr plugin manifest not found: ${manifest}`);
5
+ const PACKAGE_NAME = "@osolmaz/pi-workflows";
6
+ const MANIFEST_NAME = "herdr-plugin.toml";
7
+ const VIEWER_PATH = "plugins/herdr/viewer.mjs";
8
+ const RESULT_SCHEMA = "pi-workflows.herdr-sync.v1";
9
+ const MAX_COMMAND_OUTPUT_BYTES = 1024 * 1024;
10
+ export function syncHerdrPlugin(packageRoot, spawn = runCommand) {
11
+ const expected = preflightPackage(packageRoot);
12
+ const initial = inspectHerdr(spawn, true);
13
+ if (!initial.available) {
14
+ return result("unavailable", false, expected.version, undefined);
10
15
  }
11
- const listed = spawn("herdr", ["plugin", "list", "--plugin", HERDR_PLUGIN_ID, "--json"]);
12
- if (listed.error)
13
- throw new Error(`Could not run Herdr: ${listed.error.message}`);
14
- if (listed.status !== 0) {
15
- throw new Error(`Could not inspect Herdr plugins: ${bounded(listed.stderr || listed.stdout)}`);
16
+ const installed = initial.plugin;
17
+ if (installed === undefined) {
18
+ const linked = mutate(spawn, "link", [expected.root]);
19
+ const adopted = verifyOrExplain(spawn, expected);
20
+ if (adopted.plugin !== undefined && matchesExpected(adopted.plugin, expected, true)) {
21
+ return result("linked", true, expected.version, adopted.plugin);
22
+ }
23
+ throw mutationError("link", linked, adopted.problem);
16
24
  }
17
- const installed = installedPlugin(listed.stdout);
18
- if (installed !== undefined) {
19
- if (path.resolve(installed.root) !== root) {
20
- throw new Error(`Herdr plugin ${HERDR_PLUGIN_ID} is already registered from ${installed.root}. Unlink it before linking ${root}.`);
25
+ if (matchesExpected(installed, expected, true)) {
26
+ return result("unchanged", false, expected.version, installed);
27
+ }
28
+ if (matchesExpected(installed, expected, false) && !installed.enabled) {
29
+ const enabled = mutate(spawn, "enable", [HERDR_PLUGIN_ID]);
30
+ const adopted = verifyOrExplain(spawn, expected);
31
+ if (adopted.plugin !== undefined && matchesExpected(adopted.plugin, expected, true)) {
32
+ return result("enabled", true, expected.version, adopted.plugin);
21
33
  }
22
- if (installed.enabled) {
23
- return { changed: false, message: `Herdr plugin ${HERDR_PLUGIN_ID} is already linked.` };
34
+ throw mutationError("enable", enabled, adopted.problem);
35
+ }
36
+ const rollback = rollbackTarget(installed);
37
+ const unlinked = mutate(spawn, "unlink", [HERDR_PLUGIN_ID]);
38
+ const afterUnlink = inspectHerdr(spawn, false);
39
+ if (!afterUnlink.available)
40
+ throw new Error("Herdr became unavailable during synchronization.");
41
+ if (afterUnlink.plugin !== undefined) {
42
+ if (matchesExpected(afterUnlink.plugin, expected, true)) {
43
+ return result("relinked", true, expected.version, afterUnlink.plugin);
24
44
  }
25
- const enabled = spawn("herdr", ["plugin", "enable", HERDR_PLUGIN_ID]);
26
- if (enabled.error)
27
- throw new Error(`Could not run Herdr: ${enabled.error.message}`);
28
- if (enabled.status !== 0) {
29
- throw new Error(`Could not enable the Herdr plugin: ${bounded(enabled.stderr || enabled.stdout)}`);
45
+ throw mutationError("unlink the stale registration", unlinked, "Herdr still reports a conflicting registration.");
46
+ }
47
+ const linked = mutate(spawn, "link", [expected.root]);
48
+ const adopted = verifyOrExplain(spawn, expected);
49
+ if (adopted.plugin !== undefined && matchesExpected(adopted.plugin, expected, true)) {
50
+ return result("relinked", true, expected.version, adopted.plugin);
51
+ }
52
+ const rollbackMessage = restorePrevious(spawn, expected, rollback);
53
+ throw new Error(`${mutationError("link the current package", linked, adopted.problem).message} ${rollbackMessage}`);
54
+ }
55
+ /** Compatibility alias for callers that used the original setup API. */
56
+ export function setupHerdrPlugin(packageRoot, spawn = runCommand) {
57
+ return syncHerdrPlugin(packageRoot, spawn);
58
+ }
59
+ function preflightPackage(packageRoot) {
60
+ const requestedRoot = path.resolve(packageRoot);
61
+ let root;
62
+ try {
63
+ root = fs.realpathSync(requestedRoot);
64
+ }
65
+ catch (error) {
66
+ throw new Error(`Pi Workflows package root is missing: ${requestedRoot}`, { cause: error });
67
+ }
68
+ if (!fs.statSync(root).isDirectory()) {
69
+ throw new Error(`Pi Workflows package root is not a directory: ${requestedRoot}`);
70
+ }
71
+ const packagePath = checkedRegularFile(root, "package.json");
72
+ const manifestPath = checkedRegularFile(root, MANIFEST_NAME);
73
+ const packageJson = parseJsonObject(fs.readFileSync(packagePath, "utf8"), "package.json");
74
+ if (packageJson["name"] !== PACKAGE_NAME) {
75
+ throw new Error(`Unexpected Pi Workflows package name in ${packagePath}.`);
76
+ }
77
+ const packageVersion = packageJson["version"];
78
+ if (typeof packageVersion !== "string" || packageVersion.length === 0) {
79
+ throw new Error(`Pi Workflows package version is missing in ${packagePath}.`);
80
+ }
81
+ const manifest = fs.readFileSync(manifestPath, "utf8");
82
+ const topLevelManifest = manifest.split(/^\s*\[\[/mu, 1)[0] ?? "";
83
+ const pluginId = tomlString(topLevelManifest, "id", manifestPath);
84
+ const pluginVersion = tomlString(topLevelManifest, "version", manifestPath);
85
+ tomlString(topLevelManifest, "min_herdr_version", manifestPath);
86
+ const platforms = tomlStringArray(topLevelManifest, "platforms", manifestPath);
87
+ const command = tomlStringArray(manifest, "command", manifestPath);
88
+ if (pluginId !== HERDR_PLUGIN_ID) {
89
+ throw new Error(`Unexpected Herdr plugin ID in ${manifestPath}.`);
90
+ }
91
+ if (pluginVersion !== packageVersion) {
92
+ throw new Error(`Herdr plugin version does not match package version ${packageVersion}.`);
93
+ }
94
+ const platform = process.platform === "darwin" ? "macos" : process.platform;
95
+ if (!platforms.includes(platform)) {
96
+ throw new Error(`Herdr plugin does not support platform ${platform}.`);
97
+ }
98
+ if (command.length !== 2 || command[0] !== "node" || command[1] !== VIEWER_PATH) {
99
+ throw new Error(`Unexpected Herdr plugin viewer command in ${manifestPath}.`);
100
+ }
101
+ checkedRegularFile(root, VIEWER_PATH);
102
+ return { root, manifestPath, version: packageVersion };
103
+ }
104
+ function checkedRegularFile(root, relativePath) {
105
+ const target = path.resolve(root, relativePath);
106
+ if (!isWithin(root, target)) {
107
+ throw new Error(`Package file escapes the package root: ${relativePath}`);
108
+ }
109
+ const stat = statOrThrow(target, `Package file ${relativePath}`);
110
+ if (!stat.isFile() || stat.isSymbolicLink()) {
111
+ throw new Error(`Package file is not a regular file: ${relativePath}`);
112
+ }
113
+ const real = fs.realpathSync(target);
114
+ if (!isWithin(root, real)) {
115
+ throw new Error(`Package file resolves outside the package root: ${relativePath}`);
116
+ }
117
+ return real;
118
+ }
119
+ function isWithin(root, target) {
120
+ const relative = path.relative(root, target);
121
+ return relative === "" || (!relative.startsWith(`..${path.sep}`) && relative !== "..");
122
+ }
123
+ function statOrThrow(target, label) {
124
+ try {
125
+ return fs.lstatSync(target);
126
+ }
127
+ catch (error) {
128
+ throw new Error(`${label} is missing: ${target}`, { cause: error });
129
+ }
130
+ }
131
+ function parseJsonObject(text, label) {
132
+ let value;
133
+ try {
134
+ value = JSON.parse(text);
135
+ }
136
+ catch (error) {
137
+ throw new Error(`${label} is not valid JSON.`, { cause: error });
138
+ }
139
+ if (!isRecord(value))
140
+ throw new Error(`${label} must contain a JSON object.`);
141
+ return value;
142
+ }
143
+ function tomlString(text, key, manifestPath) {
144
+ const expressions = matches(text, new RegExp(String.raw `^\s*${escapeRegExp(key)}\s*=\s*("(?:[^"\\]|\\.)*")\s*(?:#.*)?$`, "gmu"));
145
+ if (expressions.length !== 1) {
146
+ throw new Error(`Herdr manifest must contain one ${key} string: ${manifestPath}`);
147
+ }
148
+ try {
149
+ const value = JSON.parse(expressions[0]);
150
+ if (typeof value !== "string" || value.length === 0)
151
+ throw new Error("empty string");
152
+ return value;
153
+ }
154
+ catch (error) {
155
+ throw new Error(`Herdr manifest has an invalid ${key} string: ${manifestPath}`, {
156
+ cause: error,
157
+ });
158
+ }
159
+ }
160
+ function tomlStringArray(text, key, manifestPath) {
161
+ const expressions = matches(text, new RegExp(String.raw `^\s*${escapeRegExp(key)}\s*=\s*(\[(?:[^\]"\\]|"(?:[^"\\]|\\.)*")*\])\s*(?:#.*)?$`, "gmu"));
162
+ if (expressions.length !== 1) {
163
+ throw new Error(`Herdr manifest must contain one ${key} string array: ${manifestPath}`);
164
+ }
165
+ try {
166
+ const value = JSON.parse(expressions[0]);
167
+ if (!Array.isArray(value) ||
168
+ value.length === 0 ||
169
+ value.some((item) => typeof item !== "string")) {
170
+ throw new Error("invalid string array");
30
171
  }
31
- return { changed: true, message: `Enabled Herdr plugin ${HERDR_PLUGIN_ID}.` };
172
+ return value;
173
+ }
174
+ catch (error) {
175
+ throw new Error(`Herdr manifest has an invalid ${key} string array: ${manifestPath}`, {
176
+ cause: error,
177
+ });
178
+ }
179
+ }
180
+ function matches(text, expression) {
181
+ const values = [];
182
+ for (const match of text.matchAll(expression)) {
183
+ const value = match[1];
184
+ if (value !== undefined)
185
+ values.push(value);
32
186
  }
33
- const linked = spawn("herdr", ["plugin", "link", root]);
34
- if (linked.error)
35
- throw new Error(`Could not run Herdr: ${linked.error.message}`);
36
- if (linked.status !== 0) {
37
- throw new Error(`Could not link the Herdr plugin: ${bounded(linked.stderr || linked.stdout)}`);
187
+ return values;
188
+ }
189
+ function escapeRegExp(value) {
190
+ return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
191
+ }
192
+ function inspectHerdr(spawn, allowUnavailable) {
193
+ const listed = spawn("herdr", ["plugin", "list", "--plugin", HERDR_PLUGIN_ID, "--json"]);
194
+ if (listed.error !== undefined) {
195
+ if (allowUnavailable && errorCode(listed.error) === "ENOENT")
196
+ return { available: false };
197
+ throw new Error(`Could not run Herdr: ${listed.error.message}`);
198
+ }
199
+ if (listed.status !== 0) {
200
+ throw new Error(`Could not inspect Herdr plugins: ${bounded(listed.stderr || listed.stdout)}`);
38
201
  }
39
- return { changed: true, message: `Linked Herdr plugin ${HERDR_PLUGIN_ID} from ${root}.` };
202
+ return { available: true, plugin: installedPlugin(listed.stdout) };
40
203
  }
41
204
  function installedPlugin(stdout) {
42
205
  let value;
@@ -46,25 +209,172 @@ function installedPlugin(stdout) {
46
209
  catch {
47
210
  throw new Error("Herdr returned invalid plugin JSON.");
48
211
  }
49
- if (!isRecord(value) || !isRecord(value.result) || !Array.isArray(value.result.plugins)) {
212
+ if (!isRecord(value) ||
213
+ !isRecord(value["result"]) ||
214
+ !Array.isArray(value["result"]["plugins"])) {
50
215
  throw new Error("Herdr returned an invalid plugin list.");
51
216
  }
52
- for (const plugin of value.result.plugins) {
53
- if (isRecord(plugin) &&
54
- plugin.plugin_id === HERDR_PLUGIN_ID &&
55
- typeof plugin.plugin_root === "string" &&
56
- typeof plugin.enabled === "boolean") {
57
- return { root: plugin.plugin_root, enabled: plugin.enabled };
217
+ const candidates = value["result"]["plugins"].filter((plugin) => isRecord(plugin) && plugin["plugin_id"] === HERDR_PLUGIN_ID);
218
+ if (candidates.length > 1) {
219
+ throw new Error(`Herdr returned duplicate records for ${HERDR_PLUGIN_ID}.`);
220
+ }
221
+ const candidate = candidates[0];
222
+ if (candidate === undefined)
223
+ return undefined;
224
+ if (!isRecord(candidate) ||
225
+ typeof candidate["plugin_root"] !== "string" ||
226
+ typeof candidate["manifest_path"] !== "string" ||
227
+ typeof candidate["version"] !== "string" ||
228
+ typeof candidate["enabled"] !== "boolean") {
229
+ throw new Error(`Herdr returned an incomplete record for ${HERDR_PLUGIN_ID}.`);
230
+ }
231
+ return {
232
+ root: normalizedPath(candidate["plugin_root"]),
233
+ manifestPath: normalizedPath(candidate["manifest_path"]),
234
+ version: candidate["version"],
235
+ enabled: candidate["enabled"],
236
+ warnings: pluginWarnings(candidate),
237
+ };
238
+ }
239
+ function pluginWarnings(plugin) {
240
+ const warnings = [];
241
+ for (const key of ["warning", "manifest_warning"]) {
242
+ const value = plugin[key];
243
+ if (typeof value === "string" && value.trim().length > 0)
244
+ warnings.push(value.trim());
245
+ }
246
+ const many = plugin["warnings"];
247
+ if (many !== undefined) {
248
+ if (!Array.isArray(many) || many.some((item) => typeof item !== "string")) {
249
+ throw new Error(`Herdr returned invalid warnings for ${HERDR_PLUGIN_ID}.`);
58
250
  }
251
+ warnings.push(...many.filter((item) => item.trim().length > 0).map((item) => item.trim()));
59
252
  }
60
- return undefined;
253
+ return warnings;
254
+ }
255
+ function matchesExpected(installed, expected, requireEnabled) {
256
+ return (installed.root === normalizedPath(expected.root) &&
257
+ installed.manifestPath === normalizedPath(expected.manifestPath) &&
258
+ installed.version === expected.version &&
259
+ (!requireEnabled || installed.enabled) &&
260
+ installed.warnings.length === 0);
261
+ }
262
+ function rollbackTarget(installed) {
263
+ try {
264
+ const previous = preflightPackage(installed.root);
265
+ return matchesExpected(installed, previous, installed.enabled)
266
+ ? { package: previous, enabled: installed.enabled }
267
+ : undefined;
268
+ }
269
+ catch {
270
+ return undefined;
271
+ }
272
+ }
273
+ function restorePrevious(spawn, expected, previous) {
274
+ if (previous === undefined)
275
+ return "The previous registration could not be restored.";
276
+ try {
277
+ const current = inspectHerdr(spawn, false);
278
+ if (!current.available)
279
+ return "Herdr became unavailable; the previous registration was not restored.";
280
+ if (current.plugin !== undefined) {
281
+ if (!matchesExpected(current.plugin, expected, current.plugin.enabled)) {
282
+ return "A different registration appeared; the previous registration was not restored.";
283
+ }
284
+ const removed = mutate(spawn, "unlink", [HERDR_PLUGIN_ID]);
285
+ if (!removed.ok)
286
+ return `The previous registration was not restored: ${removed.error}`;
287
+ }
288
+ const args = previous.enabled ? [previous.package.root] : [previous.package.root, "--disabled"];
289
+ const restored = mutate(spawn, "link", args);
290
+ if (!restored.ok)
291
+ return `The previous registration was not restored: ${restored.error}`;
292
+ const verified = inspectHerdr(spawn, false);
293
+ if (verified.available &&
294
+ verified.plugin !== undefined &&
295
+ matchesExpected(verified.plugin, previous.package, previous.enabled) &&
296
+ verified.plugin.enabled === previous.enabled) {
297
+ return "The previous registration was restored.";
298
+ }
299
+ return "Herdr did not verify the restored registration.";
300
+ }
301
+ catch (error) {
302
+ return `The previous registration was not restored: ${bounded(errorMessage(error))}`;
303
+ }
304
+ }
305
+ function verifyOrExplain(spawn, expected) {
306
+ try {
307
+ const inspected = inspectHerdr(spawn, false);
308
+ if (!inspected.available)
309
+ return { problem: "Herdr became unavailable." };
310
+ if (inspected.plugin === undefined)
311
+ return { problem: "Herdr reports no plugin registration." };
312
+ if (matchesExpected(inspected.plugin, expected, true)) {
313
+ return { plugin: inspected.plugin, problem: "" };
314
+ }
315
+ return {
316
+ plugin: inspected.plugin,
317
+ problem: "Herdr did not report the expected healthy registration.",
318
+ };
319
+ }
320
+ catch (error) {
321
+ return { problem: errorMessage(error) };
322
+ }
323
+ }
324
+ function mutate(spawn, action, args) {
325
+ const changed = spawn("herdr", ["plugin", action, ...args]);
326
+ if (changed.error !== undefined)
327
+ return { ok: false, error: changed.error.message };
328
+ if (changed.status !== 0) {
329
+ return { ok: false, error: bounded(changed.stderr || changed.stdout) };
330
+ }
331
+ return { ok: true };
332
+ }
333
+ function mutationError(action, mutation, verification) {
334
+ const command = mutation.ok ? "The command completed" : `The command failed: ${mutation.error}`;
335
+ return new Error(`Could not ${action} the Herdr plugin. ${command}. ${verification}`);
336
+ }
337
+ function result(status, changed, expectedVersion, effective) {
338
+ const messages = {
339
+ linked: `Linked Herdr plugin ${HERDR_PLUGIN_ID}.`,
340
+ relinked: `Repaired Herdr plugin ${HERDR_PLUGIN_ID}.`,
341
+ enabled: `Enabled Herdr plugin ${HERDR_PLUGIN_ID}.`,
342
+ unchanged: `Herdr plugin ${HERDR_PLUGIN_ID} is current.`,
343
+ unavailable: "Herdr is not installed; plugin synchronization was skipped.",
344
+ };
345
+ return {
346
+ schema: RESULT_SCHEMA,
347
+ status,
348
+ changed,
349
+ pluginId: HERDR_PLUGIN_ID,
350
+ expectedVersion,
351
+ effectiveVersion: effective?.version ?? null,
352
+ enabled: effective?.enabled ?? null,
353
+ runningPiProcessesNeedReload: true,
354
+ message: messages[status],
355
+ };
61
356
  }
62
357
  function runCommand(command, args) {
63
358
  return spawnSync(command, [...args], {
64
359
  encoding: "utf8",
65
360
  stdio: ["ignore", "pipe", "pipe"],
361
+ maxBuffer: MAX_COMMAND_OUTPUT_BYTES,
362
+ shell: false,
66
363
  });
67
364
  }
365
+ function errorCode(error) {
366
+ const value = error;
367
+ return typeof value.code === "string" ? value.code : undefined;
368
+ }
369
+ function normalizedPath(value) {
370
+ const resolved = path.resolve(value);
371
+ try {
372
+ return fs.realpathSync(resolved);
373
+ }
374
+ catch {
375
+ return resolved;
376
+ }
377
+ }
68
378
  function bounded(value) {
69
379
  const compact = value
70
380
  .replace(/[\r\n\t]+/gu, " ")
@@ -72,6 +382,9 @@ function bounded(value) {
72
382
  .trim();
73
383
  return compact.length <= 300 ? compact : `${compact.slice(0, 299)}…`;
74
384
  }
385
+ function errorMessage(error) {
386
+ return error instanceof Error ? error.message : String(error);
387
+ }
75
388
  function isRecord(value) {
76
389
  return typeof value === "object" && value !== null && !Array.isArray(value);
77
390
  }
@@ -1 +1 @@
1
- {"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/herdr/setup.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/herdr/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAyB,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAC7C,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAC1C,MAAM,WAAW,GAAG,0BAA0B,CAAC;AAC/C,MAAM,aAAa,GAAG,4BAAqC,CAAC;AAC5D,MAAM,wBAAwB,GAAG,IAAI,GAAG,IAAI,CAAC;AAwC7C,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,KAAK,GAAU,UAAU;IAC5E,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,aAAa,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IACjC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACjD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;YACpF,OAAO,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,eAAe,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;QAC/C,OAAO,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,eAAe,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACtE,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACjD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;YACpF,OAAO,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,CAAC,WAAW,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAChG,IAAI,WAAW,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACrC,IAAI,eAAe,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;YACxD,OAAO,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,aAAa,CACjB,+BAA+B,EAC/B,QAAQ,EACR,iDAAiD,CAClD,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACjD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;QACpF,OAAO,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,eAAe,GAAG,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACnE,MAAM,IAAI,KAAK,CACb,GAAG,aAAa,CAAC,0BAA0B,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,IAAI,eAAe,EAAE,CACnG,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,KAAK,GAAU,UAAU;IAC7E,OAAO,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAChD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,yCAAyC,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,iDAAiD,aAAa,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,eAAe,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC;IAC1F,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,YAAY,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,2CAA2C,WAAW,GAAG,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,cAAc,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,8CAA8C,WAAW,GAAG,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACvD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,MAAM,QAAQ,GAAG,UAAU,CAAC,gBAAgB,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,UAAU,CAAC,gBAAgB,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IAC5E,UAAU,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,eAAe,CAAC,gBAAgB,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IACnE,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,iCAAiC,YAAY,GAAG,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,aAAa,KAAK,cAAc,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,uDAAuD,cAAc,GAAG,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC5E,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,0CAA0C,QAAQ,GAAG,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,6CAA6C,YAAY,GAAG,CAAC,CAAC;IAChF,CAAC;IACD,kBAAkB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACtC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAE,YAAoB;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,0CAA0C,YAAY,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,gBAAgB,YAAY,EAAE,CAAC,CAAC;IACjE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,uCAAuC,YAAY,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,mDAAmD,YAAY,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,MAAc;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,QAAQ,KAAK,IAAI,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,KAAa;IAChD,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,gBAAgB,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,KAAa;IAClD,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,qBAAqB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8BAA8B,CAAC,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,GAAW,EAAE,YAAoB;IACjE,MAAM,WAAW,GAAG,OAAO,CACzB,IAAI,EACJ,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,OAAO,YAAY,CAAC,GAAG,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAC9F,CAAC;IACF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,YAAY,YAAY,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAW,CAAC,CAAC;QAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QACrF,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,YAAY,YAAY,EAAE,EAAE;YAC9E,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,GAAW,EAAE,YAAoB;IACtE,MAAM,WAAW,GAAG,OAAO,CACzB,IAAI,EACJ,IAAI,MAAM,CACR,MAAM,CAAC,GAAG,CAAA,OAAO,YAAY,CAAC,GAAG,CAAC,0DAA0D,EAC5F,KAAK,CACN,CACF,CAAC;IACF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,kBAAkB,YAAY,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAW,CAAC,CAAC;QAC5D,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACrB,KAAK,CAAC,MAAM,KAAK,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAC9C,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,KAAiB,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,kBAAkB,YAAY,EAAE,EAAE;YACpF,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,UAAkB;IAC/C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,YAAY,CAAC,KAAY,EAAE,gBAAyB;IAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzF,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,gBAAgB,IAAI,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ;YAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,eAAe,CAAC,MAAc;IACrC,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAY,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,IACE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAChB,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,EAC1C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAClD,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,eAAe,CACxE,CAAC;IACF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,wCAAwC,eAAe,GAAG,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC9C,IACE,CAAC,QAAQ,CAAC,SAAS,CAAC;QACpB,OAAO,SAAS,CAAC,aAAa,CAAC,KAAK,QAAQ;QAC5C,OAAO,SAAS,CAAC,eAAe,CAAC,KAAK,QAAQ;QAC9C,OAAO,SAAS,CAAC,SAAS,CAAC,KAAK,QAAQ;QACxC,OAAO,SAAS,CAAC,SAAS,CAAC,KAAK,SAAS,EACzC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,eAAe,GAAG,CAAC,CAAC;IACjF,CAAC;IACD,OAAO;QACL,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC9C,YAAY,EAAE,cAAc,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACxD,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC;QAC7B,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC;QAC7B,QAAQ,EAAE,cAAc,CAAC,SAAS,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,MAA+B;IACrD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAU,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,KAAK,CAAC,uCAAuC,eAAe,GAAG,CAAC,CAAC;QAC7E,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,eAAe,CACtB,SAA0B,EAC1B,QAAuB,EACvB,cAAuB;IAEvB,OAAO,CACL,SAAS,CAAC,IAAI,KAAK,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChD,SAAS,CAAC,YAAY,KAAK,cAAc,CAAC,QAAQ,CAAC,YAAY,CAAC;QAChE,SAAS,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO;QACtC,CAAC,CAAC,cAAc,IAAI,SAAS,CAAC,OAAO,CAAC;QACtC,SAAS,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAChC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,SAA0B;IAChD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO,eAAe,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC;YAC5D,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE;YACnD,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,KAAY,EACZ,QAAuB,EACvB,QAAoC;IAEpC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,kDAAkD,CAAC;IACtF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,SAAS;YACpB,OAAO,uEAAuE,CAAC;QACjF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvE,OAAO,gFAAgF,CAAC;YAC1F,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;YAC3D,IAAI,CAAC,OAAO,CAAC,EAAE;gBAAE,OAAO,+CAA+C,OAAO,CAAC,KAAK,EAAE,CAAC;QACzF,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAChG,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,+CAA+C,QAAQ,CAAC,KAAK,EAAE,CAAC;QACzF,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC5C,IACE,QAAQ,CAAC,SAAS;YAClB,QAAQ,CAAC,MAAM,KAAK,SAAS;YAC7B,eAAe,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC;YACpE,QAAQ,CAAC,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO,EAC5C,CAAC;YACD,OAAO,yCAAyC,CAAC;QACnD,CAAC;QACD,OAAO,iDAAiD,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,+CAA+C,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IACvF,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,KAAY,EACZ,QAAuB;IAEvB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,CAAC,SAAS;YAAE,OAAO,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;QAC1E,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;QAChG,IAAI,eAAe,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;YACtD,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACnD,CAAC;QACD,OAAO;YACL,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,OAAO,EAAE,yDAAyD;SACnE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,KAAY,EAAE,MAAc,EAAE,IAAuB;IACnE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IACpF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,aAAa,CAAC,MAAc,EAAE,QAAwB,EAAE,YAAoB;IACnF,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,uBAAuB,QAAQ,CAAC,KAAK,EAAE,CAAC;IAChG,OAAO,IAAI,KAAK,CAAC,aAAa,MAAM,sBAAsB,OAAO,KAAK,YAAY,EAAE,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,MAAM,CACb,MAAuB,EACvB,OAAgB,EAChB,eAAuB,EACvB,SAAsC;IAEtC,MAAM,QAAQ,GAAoC;QAChD,MAAM,EAAE,uBAAuB,eAAe,GAAG;QACjD,QAAQ,EAAE,yBAAyB,eAAe,GAAG;QACrD,OAAO,EAAE,wBAAwB,eAAe,GAAG;QACnD,SAAS,EAAE,gBAAgB,eAAe,cAAc;QACxD,WAAW,EAAE,6DAA6D;KAC3E,CAAC;IACF,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,MAAM;QACN,OAAO;QACP,QAAQ,EAAE,eAAe;QACzB,eAAe;QACf,gBAAgB,EAAE,SAAS,EAAE,OAAO,IAAI,IAAI;QAC5C,OAAO,EAAE,SAAS,EAAE,OAAO,IAAI,IAAI;QACnC,4BAA4B,EAAE,IAAI;QAClC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,OAAe,EAAE,IAAuB;IAC1D,OAAO,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE;QACnC,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,SAAS,EAAE,wBAAwB;QACnC,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,KAAY;IAC7B,MAAM,KAAK,GAAG,KAAmC,CAAC;IAClD,OAAO,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACjE,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,MAAM,OAAO,GAAG,KAAK;SAClB,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;IACV,OAAO,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;AACvE,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}
@@ -1,5 +1,4 @@
1
- import { StringEnum } from "@earendil-works/pi-ai";
2
- import { Type } from "typebox";
1
+ import { parseWorkflowSubmissionInput, WorkflowSubmissionToolParameters, } from "../workflows/tool-input.js";
3
2
  export const RPC_SUBMISSION_PREFIX = "PI_WORKFLOWS_STEP_SUBMISSION ";
4
3
  /**
5
4
  * Loaded into headless `pi --mode rpc` children spawned by the standalone
@@ -16,25 +15,9 @@ export default function piWorkflowsRpcBridge(pi) {
16
15
  "Only call this tool when a workflow step contract in the conversation asks you to.",
17
16
  "Pass the exact step and attempt ids from the contract.",
18
17
  ].join(" "),
19
- parameters: Type.Union([
20
- Type.Object({
21
- action: StringEnum(["update"]),
22
- step: Type.String(),
23
- attempt: Type.String(),
24
- update: Type.Object({
25
- type: Type.String(),
26
- key: Type.String(),
27
- data: Type.Record(Type.String(), Type.Unknown()),
28
- }, { additionalProperties: false }),
29
- }, { additionalProperties: false }),
30
- Type.Object({
31
- action: StringEnum(["submit"]),
32
- step: Type.String({ description: "Step id from the workflow step contract" }),
33
- attempt: Type.String({ description: "Attempt id from the workflow step contract" }),
34
- output: Type.Unknown({ description: "Step output matching the expected shape" }),
35
- }, { additionalProperties: false }),
36
- ]),
37
- async execute(toolCallId, params) {
18
+ parameters: WorkflowSubmissionToolParameters,
19
+ async execute(toolCallId, rawParams) {
20
+ const params = parseWorkflowSubmissionInput(rawParams);
38
21
  process.stderr.write(`${RPC_SUBMISSION_PREFIX}${JSON.stringify({ ...params, idempotencyKey: toolCallId })}\n`);
39
22
  return {
40
23
  content: [
@@ -1 +1 @@
1
- {"version":3,"file":"rpc-bridge.js","sourceRoot":"","sources":["../../src/host/rpc-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,MAAM,CAAC,MAAM,qBAAqB,GAAG,+BAA+B,CAAC;AAErE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,EAAgB;IAC3D,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE;YACX,uEAAuE;YACvE,oFAAoF;YACpF,wDAAwD;SACzD,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC;YACrB,IAAI,CAAC,MAAM,CACT;gBACE,MAAM,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAU,CAAC;gBACvC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;gBACnB,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;gBACtB,MAAM,EAAE,IAAI,CAAC,MAAM,CACjB;oBACE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;oBACnB,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE;oBAClB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;iBACjD,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC;aACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC;YACD,IAAI,CAAC,MAAM,CACT;gBACE,MAAM,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAU,CAAC;gBACvC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;gBAC7E,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4CAA4C,EAAE,CAAC;gBACnF,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;aACjF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC;SACF,CAAC;QACF,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM;YAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,qBAAqB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,IAAI,CACzF,CAAC;YACF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EACF,MAAM,CAAC,MAAM,KAAK,QAAQ;4BACxB,CAAC,CAAC,sDAAsD;4BACxD,CAAC,CAAC,2EAA2E;qBAClF;iBACF;gBACD,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
1
+ {"version":3,"file":"rpc-bridge.js","sourceRoot":"","sources":["../../src/host/rpc-bridge.ts"],"names":[],"mappings":"AACA,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,4BAA4B,CAAC;AAEpC,MAAM,CAAC,MAAM,qBAAqB,GAAG,+BAA+B,CAAC;AAErE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,EAAgB;IAC3D,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE;YACX,uEAAuE;YACvE,oFAAoF;YACpF,wDAAwD;SACzD,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,UAAU,EAAE,gCAAgC;QAC5C,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS;YACjC,MAAM,MAAM,GAAG,4BAA4B,CAAC,SAAS,CAAC,CAAC;YACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,qBAAqB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,IAAI,CACzF,CAAC;YACF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EACF,MAAM,CAAC,MAAM,KAAK,QAAQ;4BACxB,CAAC,CAAC,sDAAsD;4BACxD,CAAC,CAAC,2EAA2E;qBAClF;iBACF;gBACD,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
@@ -144,7 +144,7 @@ function cardMetrics(view) {
144
144
  measure(`${nodeTypeBadge("checkpoint")} ${STATUS_GLYPHS[status]} ${STATUS_LABELS[status]}`);
145
145
  }
146
146
  for (const [nodeId, node] of Object.entries(snapshot.nodes)) {
147
- measure(sanitizeText(nodeId));
147
+ measure(sanitizeText(hierarchicalNodeLabel(nodeId, node)));
148
148
  measure(nodeTypeBadge(node.nodeType, node.actionExecution));
149
149
  const labels = nodeBranchLabels(view, nodeId);
150
150
  branchRows = Math.max(branchRows, labels.length);
@@ -205,13 +205,38 @@ function renderCellText(view, cell, visibleSteps, atLatestStep, now, nodeStyle,
205
205
  const durationMs = Date.parse(attempt.finishedAt) - Date.parse(attempt.startedAt);
206
206
  elapsed = formatDuration(durationMs);
207
207
  }
208
- const detail = atLatestStep && state.currentNode === nodeId && state.statusDetail
209
- ? sanitizeText(state.statusDetail)
210
- : node?.statusDetail
211
- ? sanitizeText(node.statusDetail)
212
- : node?.summary
213
- ? sanitizeText(node.summary)
214
- : "";
208
+ const human = node?.humanDecision;
209
+ const waitingSchema = state.waitingOn === nodeId &&
210
+ state.finalOutput !== null &&
211
+ typeof state.finalOutput === "object"
212
+ ? state.finalOutput.schema
213
+ : undefined;
214
+ const waitingRequest = waitingSchema === "pi-workflows.human-decision-request.v1" ||
215
+ waitingSchema === "pi-workflows.human-decision-request.v2"
216
+ ? state.finalOutput
217
+ : undefined;
218
+ const selected = human !== undefined &&
219
+ state.humanDecision !== undefined &&
220
+ state.humanDecision.nodeId === nodeId
221
+ ? human.choices[state.humanDecision.response.choice]
222
+ : undefined;
223
+ const humanDetail = human === undefined
224
+ ? undefined
225
+ : state.waitingOn === nodeId
226
+ ? `human decision · ${sanitizeText(typeof waitingRequest?.audience === "string" ? waitingRequest.audience : human.audience)}${typeof waitingRequest?.presentation?.summary === "string" ? ` · ${sanitizeText(waitingRequest.presentation.summary)}` : ""} · ${Object.values(human.choices)
227
+ .map((choice) => sanitizeText(choice.label))
228
+ .join(" / ")}${typeof waitingRequest?.presentationDigest === "string" ? ` · ${waitingRequest.presentationDigest.slice(7, 19)}` : ""}`
229
+ : selected !== undefined
230
+ ? `human: ${sanitizeText(selected.label)}`
231
+ : undefined;
232
+ const detail = humanDetail ??
233
+ (atLatestStep && state.currentNode === nodeId && state.statusDetail
234
+ ? sanitizeText(state.statusDetail)
235
+ : node?.statusDetail
236
+ ? sanitizeText(node.statusDetail)
237
+ : node?.summary
238
+ ? sanitizeText(node.summary)
239
+ : "");
215
240
  const branchLines = Array.from({ length: metrics.branchRows }, (_, index) => labels[index] ? `◇ ${labels[index]}` : "");
216
241
  const count = atLatestStep && state.currentNode === nodeId ? Math.max(attempts, 1) : attempts;
217
242
  const timing = attempt || count > 0 ? `${count} attempt${count === 1 ? "" : "s"} · ${elapsed}` : "not visited";