pi-daddy 0.18.1 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (218) hide show
  1. package/CHANGELOG.md +201 -0
  2. package/README.md +136 -23
  3. package/contracts/ledger/v2/README.md +59 -0
  4. package/contracts/ledger/v2/fixtures/capability-decision.json +95 -0
  5. package/contracts/ledger/v2/fixtures/check-receipt.json +40 -0
  6. package/contracts/ledger/v2/fixtures/child-lifecycle.json +42 -0
  7. package/contracts/ledger/v2/fixtures/workspace-lease.json +41 -0
  8. package/contracts/ledger/v2/ledger-event.schema.json +633 -0
  9. package/contracts/ledger/v3/README.md +36 -0
  10. package/contracts/ledger/v3/fixtures/capability-decision.json +98 -0
  11. package/contracts/ledger/v3/fixtures/check-receipt.json +42 -0
  12. package/contracts/ledger/v3/fixtures/child-lifecycle.json +45 -0
  13. package/contracts/ledger/v3/fixtures/workflow-fact.json +41 -0
  14. package/contracts/ledger/v3/fixtures/workspace-lease.json +43 -0
  15. package/contracts/ledger/v3/ledger-event.schema.json +930 -0
  16. package/dist/approval-prompt.d.ts +2 -1
  17. package/dist/approval-prompt.d.ts.map +1 -1
  18. package/dist/approval-prompt.js +9 -0
  19. package/dist/approval-prompt.js.map +1 -1
  20. package/dist/approval.d.ts +4 -2
  21. package/dist/approval.d.ts.map +1 -1
  22. package/dist/approval.js +4 -0
  23. package/dist/approval.js.map +1 -1
  24. package/dist/capabilities.d.ts +90 -0
  25. package/dist/capabilities.d.ts.map +1 -1
  26. package/dist/capabilities.js +114 -3
  27. package/dist/capabilities.js.map +1 -1
  28. package/dist/catalog.d.ts +15 -1
  29. package/dist/catalog.d.ts.map +1 -1
  30. package/dist/catalog.js +54 -3
  31. package/dist/catalog.js.map +1 -1
  32. package/dist/check-runner.d.ts.map +1 -1
  33. package/dist/check-runner.js +19 -7
  34. package/dist/check-runner.js.map +1 -1
  35. package/dist/cli.d.ts.map +1 -1
  36. package/dist/cli.js +21 -1
  37. package/dist/cli.js.map +1 -1
  38. package/dist/correlation.d.ts.map +1 -1
  39. package/dist/correlation.js +10 -0
  40. package/dist/correlation.js.map +1 -1
  41. package/dist/dashboard-cli.d.ts +18 -0
  42. package/dist/dashboard-cli.d.ts.map +1 -0
  43. package/dist/dashboard-cli.js +154 -0
  44. package/dist/dashboard-cli.js.map +1 -0
  45. package/dist/dashboard-handshake.d.ts +37 -0
  46. package/dist/dashboard-handshake.d.ts.map +1 -0
  47. package/dist/dashboard-handshake.js +127 -0
  48. package/dist/dashboard-handshake.js.map +1 -0
  49. package/dist/dashboard-herdr.d.ts +54 -0
  50. package/dist/dashboard-herdr.d.ts.map +1 -0
  51. package/dist/dashboard-herdr.js +286 -0
  52. package/dist/dashboard-herdr.js.map +1 -0
  53. package/dist/dashboard-projection.d.ts +73 -0
  54. package/dist/dashboard-projection.d.ts.map +1 -0
  55. package/dist/dashboard-projection.js +294 -0
  56. package/dist/dashboard-projection.js.map +1 -0
  57. package/dist/dashboard-render.d.ts +10 -0
  58. package/dist/dashboard-render.d.ts.map +1 -0
  59. package/dist/dashboard-render.js +208 -0
  60. package/dist/dashboard-render.js.map +1 -0
  61. package/dist/definitions.d.ts.map +1 -1
  62. package/dist/definitions.js +7 -1
  63. package/dist/definitions.js.map +1 -1
  64. package/dist/delegate-types.d.ts +6 -2
  65. package/dist/delegate-types.d.ts.map +1 -1
  66. package/dist/delegate-types.js.map +1 -1
  67. package/dist/delegate.d.ts.map +1 -1
  68. package/dist/delegate.js +34 -4
  69. package/dist/delegate.js.map +1 -1
  70. package/dist/delegation-approval.d.ts.map +1 -1
  71. package/dist/delegation-approval.js +37 -12
  72. package/dist/delegation-approval.js.map +1 -1
  73. package/dist/execution-id.d.ts +6 -0
  74. package/dist/execution-id.d.ts.map +1 -0
  75. package/dist/execution-id.js +13 -0
  76. package/dist/execution-id.js.map +1 -0
  77. package/dist/executor.d.ts +2 -1
  78. package/dist/executor.d.ts.map +1 -1
  79. package/dist/executor.js +1 -0
  80. package/dist/executor.js.map +1 -1
  81. package/dist/grant-env.d.ts +2 -0
  82. package/dist/grant-env.d.ts.map +1 -1
  83. package/dist/grant-env.js +26 -3
  84. package/dist/grant-env.js.map +1 -1
  85. package/dist/index.d.ts +4 -1
  86. package/dist/index.d.ts.map +1 -1
  87. package/dist/index.js +4 -1
  88. package/dist/index.js.map +1 -1
  89. package/dist/init.d.ts +13 -1
  90. package/dist/init.d.ts.map +1 -1
  91. package/dist/init.js +35 -2
  92. package/dist/init.js.map +1 -1
  93. package/dist/lease-helper.d.ts +58 -0
  94. package/dist/lease-helper.d.ts.map +1 -0
  95. package/dist/lease-helper.js +94 -0
  96. package/dist/lease-helper.js.map +1 -0
  97. package/dist/lease-record.d.ts +15 -3
  98. package/dist/lease-record.d.ts.map +1 -1
  99. package/dist/lease-record.js.map +1 -1
  100. package/dist/ledger-events.d.ts +59 -15
  101. package/dist/ledger-events.d.ts.map +1 -1
  102. package/dist/ledger-events.js +67 -5
  103. package/dist/ledger-events.js.map +1 -1
  104. package/dist/ledger-identifiers.d.ts +7 -0
  105. package/dist/ledger-identifiers.d.ts.map +1 -0
  106. package/dist/ledger-identifiers.js +20 -0
  107. package/dist/ledger-identifiers.js.map +1 -0
  108. package/dist/ledger-report.d.ts +5 -2
  109. package/dist/ledger-report.d.ts.map +1 -1
  110. package/dist/ledger-report.js +38 -14
  111. package/dist/ledger-report.js.map +1 -1
  112. package/dist/ledger-v3-validation.d.ts +11 -0
  113. package/dist/ledger-v3-validation.d.ts.map +1 -0
  114. package/dist/ledger-v3-validation.js +265 -0
  115. package/dist/ledger-v3-validation.js.map +1 -0
  116. package/dist/ledger.d.ts +27 -9
  117. package/dist/ledger.d.ts.map +1 -1
  118. package/dist/ledger.js +38 -6
  119. package/dist/ledger.js.map +1 -1
  120. package/dist/propagation.d.ts +19 -1
  121. package/dist/propagation.d.ts.map +1 -1
  122. package/dist/propagation.js +23 -1
  123. package/dist/propagation.js.map +1 -1
  124. package/dist/refusals.d.ts +1 -1
  125. package/dist/refusals.d.ts.map +1 -1
  126. package/dist/refusals.js +1 -0
  127. package/dist/refusals.js.map +1 -1
  128. package/dist/resolve.d.ts +10 -0
  129. package/dist/resolve.d.ts.map +1 -1
  130. package/dist/resolve.js +27 -3
  131. package/dist/resolve.js.map +1 -1
  132. package/dist/routing-authority.d.ts +71 -0
  133. package/dist/routing-authority.d.ts.map +1 -0
  134. package/dist/routing-authority.js +100 -0
  135. package/dist/routing-authority.js.map +1 -0
  136. package/dist/run-child.d.ts +3 -1
  137. package/dist/run-child.d.ts.map +1 -1
  138. package/dist/run-child.js +30 -2
  139. package/dist/run-child.js.map +1 -1
  140. package/dist/run-herdr.d.ts +2 -0
  141. package/dist/run-herdr.d.ts.map +1 -1
  142. package/dist/run-herdr.js +8 -0
  143. package/dist/run-herdr.js.map +1 -1
  144. package/dist/skill-packages.d.ts +11 -5
  145. package/dist/skill-packages.d.ts.map +1 -1
  146. package/dist/skill-packages.js +20 -11
  147. package/dist/skill-packages.js.map +1 -1
  148. package/dist/workflow-fact-id.d.ts +4 -0
  149. package/dist/workflow-fact-id.d.ts.map +1 -0
  150. package/dist/workflow-fact-id.js +14 -0
  151. package/dist/workflow-fact-id.js.map +1 -0
  152. package/dist/workflow-facts.d.ts +34 -0
  153. package/dist/workflow-facts.d.ts.map +1 -0
  154. package/dist/workflow-facts.js +43 -0
  155. package/dist/workflow-facts.js.map +1 -0
  156. package/dist/workspace-lease.d.ts +15 -3
  157. package/dist/workspace-lease.d.ts.map +1 -1
  158. package/dist/workspace-lease.js +81 -24
  159. package/dist/workspace-lease.js.map +1 -1
  160. package/dist/workspace.d.ts +25 -0
  161. package/dist/workspace.d.ts.map +1 -1
  162. package/dist/workspace.js +142 -5
  163. package/dist/workspace.js.map +1 -1
  164. package/extensions/chain-ledger.ts +4 -0
  165. package/extensions/chain-plan.ts +98 -0
  166. package/extensions/delegate-chain.ts +63 -122
  167. package/extensions/delegation-ledger.ts +60 -0
  168. package/extensions/delegation.ts +20 -14
  169. package/extensions/execute-child.ts +85 -21
  170. package/extensions/execution-occurrence.ts +20 -0
  171. package/extensions/grants-command.ts +33 -4
  172. package/extensions/grants.ts +50 -1
  173. package/extensions/init-command.ts +33 -2
  174. package/extensions/run-delegation.ts +36 -56
  175. package/extensions/session-report.ts +13 -20
  176. package/extensions/session.ts +16 -3
  177. package/extensions/workspace-runtime.ts +44 -4
  178. package/herdr-plugin/herdr-plugin.toml +18 -0
  179. package/package.json +22 -5
  180. package/src/approval-prompt.ts +2 -1
  181. package/src/approval.ts +4 -2
  182. package/src/capabilities.ts +120 -4
  183. package/src/catalog.ts +62 -4
  184. package/src/check-runner.ts +24 -8
  185. package/src/cli.ts +24 -1
  186. package/src/correlation.ts +11 -0
  187. package/src/dashboard-cli.ts +171 -0
  188. package/src/dashboard-handshake.ts +185 -0
  189. package/src/dashboard-herdr.ts +355 -0
  190. package/src/dashboard-projection.ts +390 -0
  191. package/src/dashboard-render.ts +254 -0
  192. package/src/definitions.ts +7 -1
  193. package/src/delegate-types.ts +6 -2
  194. package/src/delegate.ts +43 -4
  195. package/src/delegation-approval.ts +37 -12
  196. package/src/execution-id.ts +18 -0
  197. package/src/executor.ts +2 -1
  198. package/src/grant-env.ts +39 -7
  199. package/src/index.ts +26 -0
  200. package/src/init.ts +40 -2
  201. package/src/lease-helper.ts +97 -0
  202. package/src/lease-record.ts +15 -3
  203. package/src/ledger-events.ts +116 -28
  204. package/src/ledger-identifiers.ts +21 -0
  205. package/src/ledger-report.ts +40 -19
  206. package/src/ledger-v3-validation.ts +266 -0
  207. package/src/ledger.ts +75 -12
  208. package/src/propagation.ts +24 -1
  209. package/src/refusals.ts +1 -0
  210. package/src/resolve.ts +29 -3
  211. package/src/routing-authority.ts +121 -0
  212. package/src/run-child.ts +35 -3
  213. package/src/run-herdr.ts +9 -0
  214. package/src/skill-packages.ts +20 -13
  215. package/src/workflow-fact-id.ts +16 -0
  216. package/src/workflow-facts.ts +65 -0
  217. package/src/workspace-lease.ts +84 -24
  218. package/src/workspace.ts +179 -6
@@ -0,0 +1,127 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
3
+ import { dirname, resolve } from "node:path";
4
+ import { DASHBOARD_PLUGIN_ID, dashboardHerdrExec, dashboardPaneStatePath, inspectDashboardPlugin, linkDashboardPlugin, openOrReuseDashboard, verifyHerdrHost, } from "./dashboard-herdr.js";
5
+ import { DASHBOARD_PROTOCOL_VERSION } from "./dashboard-cli.js";
6
+ export function dashboardPreferencePath(agentDir) {
7
+ return resolve(agentDir, "pi-daddy", "dashboard-preference.json");
8
+ }
9
+ async function loadPreference(path) {
10
+ try {
11
+ const parsed = JSON.parse(await readFile(path, "utf8"));
12
+ if (parsed?.version !== 1 || !Number.isInteger(parsed.protocol) ||
13
+ !["not-now", "never"].includes(parsed.choice)) {
14
+ throw new Error("unsupported preference shape");
15
+ }
16
+ return parsed;
17
+ }
18
+ catch (error) {
19
+ if (error.code === "ENOENT")
20
+ return null;
21
+ throw new Error(`dashboard preference ${path} is corrupt or unreadable: ${error instanceof Error ? error.message : String(error)}`);
22
+ }
23
+ }
24
+ async function savePreference(path, choice) {
25
+ const preference = {
26
+ version: 1,
27
+ protocol: DASHBOARD_PROTOCOL_VERSION,
28
+ choice,
29
+ recordedAt: new Date().toISOString(),
30
+ };
31
+ await mkdir(dirname(path), { recursive: true });
32
+ const temporary = `${path}.${process.pid}.${randomUUID()}.tmp`;
33
+ await writeFile(temporary, `${JSON.stringify(preference, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
34
+ await rename(temporary, path);
35
+ }
36
+ function quote(value) {
37
+ return `'${value.replaceAll("'", `'"'"'`)}'`;
38
+ }
39
+ export async function offerDashboardHandshake(input) {
40
+ if (input.mode !== "tui")
41
+ return "not-applicable";
42
+ const exec = input.exec ?? dashboardHerdrExec;
43
+ const host = await verifyHerdrHost({ env: input.env, pid: input.pid, exec });
44
+ if (!host.ok)
45
+ return "not-applicable";
46
+ try {
47
+ const preference = await loadPreference(input.preferencePath);
48
+ if (preference)
49
+ return "suppressed";
50
+ const plugin = await inspectDashboardPlugin(exec, input.pluginRoot);
51
+ if (plugin.state === "compatible")
52
+ return "already-installed";
53
+ if (plugin.state !== "absent") {
54
+ input.ui.notify(`pi-daddy dashboard: ${plugin.diagnostic}`, "error");
55
+ return "failed";
56
+ }
57
+ const choice = await input.ui.select("Herdr detected. Install and open the pi-daddy dashboard?", ["Install and open", "Not now", "Never ask"]);
58
+ if (choice !== "Install and open" && choice !== "Not now" && choice !== "Never ask") {
59
+ // Escape, timeout and UI teardown return undefined. None is an operator choice, so none may become a
60
+ // durable preference merely because the dialog disappeared.
61
+ input.ui.notify("pi-daddy dashboard: installation prompt dismissed; no preference was stored.", "info");
62
+ return "deferred";
63
+ }
64
+ if (choice !== "Install and open") {
65
+ const recorded = choice === "Never ask" ? "never" : "not-now";
66
+ await savePreference(input.preferencePath, recorded);
67
+ input.ui.notify(recorded === "never"
68
+ ? "pi-daddy dashboard: startup installation prompt disabled. /grants dashboard remains available."
69
+ : "pi-daddy dashboard: not installed. /grants dashboard will report the manual setup when requested.", "info");
70
+ return "deferred";
71
+ }
72
+ await linkDashboardPlugin(input.pluginRoot, exec);
73
+ const linked = await inspectDashboardPlugin(exec, input.pluginRoot);
74
+ if (linked.state !== "compatible")
75
+ throw new Error(linked.diagnostic);
76
+ const opened = await openOrReuseDashboard({
77
+ exec,
78
+ host: host.host,
79
+ ledgerPath: input.ledgerPath ?? "",
80
+ cwd: input.cwd,
81
+ statePath: input.paneStatePath,
82
+ pluginRoot: input.pluginRoot,
83
+ allowInactive: true,
84
+ });
85
+ input.ui.notify(`pi-daddy dashboard ${opened.kind} in pane ${opened.paneId} without changing focus.`, "info");
86
+ return "installed";
87
+ }
88
+ catch (error) {
89
+ input.ui.notify(`pi-daddy dashboard setup failed: ${error instanceof Error ? error.message : String(error)}`, "error");
90
+ return "failed";
91
+ }
92
+ }
93
+ export async function openDashboardCommand(input) {
94
+ const exec = input.exec ?? dashboardHerdrExec;
95
+ // Order is deliberate: a server elsewhere must not make an outside-pi command look hosted.
96
+ const host = await verifyHerdrHost({ env: input.env, pid: input.pid, exec });
97
+ if (!host.ok)
98
+ throw new Error(host.diagnostic);
99
+ if (!input.ledgerPath?.trim()) {
100
+ throw new Error("no pi-daddy ledger is configured — set PI_GRANTS_LEDGER, then retry /grants dashboard");
101
+ }
102
+ const plugin = await inspectDashboardPlugin(exec, input.pluginRoot);
103
+ if (plugin.state === "absent") {
104
+ throw new Error(`the pi-daddy Herdr plugin is not installed. Nothing was installed automatically. Run: ` +
105
+ `herdr plugin link ${quote(resolve(input.pluginRoot))} --enabled`);
106
+ }
107
+ if (plugin.state === "disabled") {
108
+ throw new Error(`the pi-daddy Herdr plugin is disabled. Run: herdr plugin enable ${DASHBOARD_PLUGIN_ID}`);
109
+ }
110
+ if (plugin.state !== "compatible")
111
+ throw new Error(plugin.diagnostic);
112
+ return openOrReuseDashboard({
113
+ exec,
114
+ host: host.host,
115
+ ledgerPath: input.ledgerPath,
116
+ cwd: input.cwd,
117
+ statePath: input.paneStatePath,
118
+ pluginRoot: input.pluginRoot,
119
+ });
120
+ }
121
+ export function defaultDashboardPaths(agentDir) {
122
+ return {
123
+ preferencePath: dashboardPreferencePath(agentDir),
124
+ paneStatePath: dashboardPaneStatePath(agentDir),
125
+ };
126
+ }
127
+ //# sourceMappingURL=dashboard-handshake.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dashboard-handshake.js","sourceRoot":"","sources":["../src/dashboard-handshake.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,54 @@
1
+ import { type HerdrExec } from "./herdr-cli.ts";
2
+ export declare const DASHBOARD_PLUGIN_ID = "pi-daddy.dashboard";
3
+ export declare const DASHBOARD_PLUGIN_ENTRYPOINT = "dashboard";
4
+ export declare const DASHBOARD_HERDR_TIMEOUT_MS = 3000;
5
+ /** Dashboard control calls are UI operations and must never hang pi session start. */
6
+ export declare const dashboardHerdrExec: HerdrExec;
7
+ export interface HerdrHost {
8
+ paneId: string;
9
+ tabId: string;
10
+ workspaceId: string;
11
+ }
12
+ export type HerdrHostResult = {
13
+ ok: true;
14
+ host: HerdrHost;
15
+ diagnostic: string;
16
+ } | {
17
+ ok: false;
18
+ diagnostic: string;
19
+ host?: undefined;
20
+ };
21
+ export declare function verifyHerdrHost(options?: {
22
+ env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
23
+ pid?: number;
24
+ exec?: HerdrExec;
25
+ }): Promise<HerdrHostResult>;
26
+ export type DashboardPluginState = "absent" | "disabled" | "compatible" | "incompatible" | "unavailable";
27
+ export interface DashboardPluginStatus {
28
+ state: DashboardPluginState;
29
+ diagnostic: string;
30
+ plugin?: Record<string, unknown>;
31
+ }
32
+ export declare function inspectDashboardPlugin(exec?: HerdrExec, expectedPluginRoot?: string): Promise<DashboardPluginStatus>;
33
+ export declare function linkDashboardPlugin(pluginRoot: string, exec?: HerdrExec): Promise<void>;
34
+ export interface DashboardOpenInput {
35
+ exec?: HerdrExec;
36
+ host: HerdrHost;
37
+ ledgerPath: string;
38
+ cwd: string;
39
+ statePath: string;
40
+ /** Expected bundled root; same-id plugins from another package are not invoked. */
41
+ pluginRoot?: string;
42
+ /** Installation handshake may open an explanatory pane before a ledger exists. */
43
+ allowInactive?: boolean;
44
+ }
45
+ export interface DashboardOpenResult {
46
+ kind: "opened" | "reused";
47
+ paneId: string;
48
+ tabId: string;
49
+ workspaceId: string;
50
+ visibleBesideCaller: boolean;
51
+ }
52
+ export declare function openOrReuseDashboard(input: DashboardOpenInput): Promise<DashboardOpenResult>;
53
+ export declare function dashboardPaneStatePath(agentDir: string): string;
54
+ //# sourceMappingURL=dashboard-herdr.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dashboard-herdr.d.ts","sourceRoot":"","sources":["../src/dashboard-herdr.ts"],"names":[],"mappings":"AAUA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG5D,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AACxD,eAAO,MAAM,2BAA2B,cAAc,CAAC;AACvD,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD,sFAAsF;AACtF,eAAO,MAAM,kBAAkB,EAAE,SAO/B,CAAC;AAEH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AASxD,wBAAsB,eAAe,CAAC,OAAO,GAAE;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,CAAC;CACb,GAAG,OAAO,CAAC,eAAe,CAAC,CA6ChC;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,cAAc,GAAG,aAAa,CAAC;AACzG,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAQD,wBAAsB,sBAAsB,CAC1C,IAAI,GAAE,SAA8B,EACpC,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAwChC;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,SAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjH;AAmFD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AACD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4FlG;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/D"}
@@ -0,0 +1,286 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { execFile } from "node:child_process";
3
+ import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
4
+ import { dirname, resolve } from "node:path";
5
+ import { ENV_DASHBOARD_KEY, ENV_DASHBOARD_LEDGER, ENV_DASHBOARD_PROTOCOL, DASHBOARD_PROTOCOL_VERSION, } from "./dashboard-cli.js";
6
+ import { parseReply } from "./herdr-cli.js";
7
+ import { withFileLock } from "./file-lock.js";
8
+ export const DASHBOARD_PLUGIN_ID = "pi-daddy.dashboard";
9
+ export const DASHBOARD_PLUGIN_ENTRYPOINT = "dashboard";
10
+ export const DASHBOARD_HERDR_TIMEOUT_MS = 3_000;
11
+ /** Dashboard control calls are UI operations and must never hang pi session start. */
12
+ export const dashboardHerdrExec = (args) => new Promise((settle) => {
13
+ execFile("herdr", args, { timeout: DASHBOARD_HERDR_TIMEOUT_MS, maxBuffer: 4 * 1024 * 1024 }, (error, stdout, stderr) => {
14
+ const raw = error?.code;
15
+ const code = typeof raw === "number" ? raw : error ? 1 : 0;
16
+ const failure = error ? `${typeof raw === "string" ? `${raw}: ` : ""}${error.message}` : "";
17
+ settle({ code, stdout: String(stdout), stderr: String(stderr) || failure });
18
+ });
19
+ });
20
+ function nested(record, key) {
21
+ const value = record?.[key];
22
+ return value !== null && typeof value === "object" && !Array.isArray(value)
23
+ ? value
24
+ : undefined;
25
+ }
26
+ export async function verifyHerdrHost(options = {}) {
27
+ const env = options.env ?? process.env;
28
+ const pid = options.pid ?? process.pid;
29
+ const exec = options.exec ?? dashboardHerdrExec;
30
+ const paneId = env.HERDR_PANE_ID?.trim();
31
+ const tabId = env.HERDR_TAB_ID?.trim();
32
+ const workspaceId = env.HERDR_WORKSPACE_ID?.trim();
33
+ if (env.HERDR_ENV !== "1" || !paneId || !tabId || !workspaceId) {
34
+ return {
35
+ ok: false,
36
+ diagnostic: "this pi session is not hosted inside Herdr (no complete HERDR pane identity). " +
37
+ "A reachable Herdr server elsewhere is not sufficient.",
38
+ };
39
+ }
40
+ try {
41
+ const current = parseReply(await exec(["pane", "current", "--pane", paneId]));
42
+ if (current.error)
43
+ return { ok: false, diagnostic: `Herdr could not verify this pane: ${current.error}` };
44
+ const pane = nested(current.result, "pane");
45
+ if (pane?.pane_id !== paneId || pane.tab_id !== tabId || pane.workspace_id !== workspaceId) {
46
+ return { ok: false, diagnostic: "Herdr's pane identity does not match this pi process environment." };
47
+ }
48
+ const processReply = parseReply(await exec(["pane", "process-info", "--pane", paneId]));
49
+ if (processReply.error)
50
+ return { ok: false, diagnostic: `Herdr could not inspect this pane process: ${processReply.error}` };
51
+ const info = nested(processReply.result, "process_info");
52
+ if (info?.pane_id !== paneId) {
53
+ return { ok: false, diagnostic: "Herdr returned process information for another pane." };
54
+ }
55
+ const processes = Array.isArray(info.foreground_processes) ? info.foreground_processes : [];
56
+ const containsPi = processes.some((entry) => {
57
+ const process = entry;
58
+ return process.pid === pid;
59
+ });
60
+ if (!containsPi) {
61
+ return {
62
+ ok: false,
63
+ diagnostic: `Herdr pane ${paneId} does not contain this pi process (${pid}); refusing to target another pane.`,
64
+ };
65
+ }
66
+ return { ok: true, host: { paneId, tabId, workspaceId }, diagnostic: `hosted in Herdr pane ${paneId}` };
67
+ }
68
+ catch (error) {
69
+ return { ok: false, diagnostic: `Herdr host verification failed: ${error instanceof Error ? error.message : String(error)}` };
70
+ }
71
+ }
72
+ function protocolMajor(version) {
73
+ if (typeof version !== "string")
74
+ return null;
75
+ const match = /^(\d+)\./.exec(version);
76
+ return match ? Number(match[1]) : null;
77
+ }
78
+ export async function inspectDashboardPlugin(exec = dashboardHerdrExec, expectedPluginRoot) {
79
+ try {
80
+ const parsed = parseReply(await exec(["plugin", "list", "--json"]));
81
+ if (parsed.error)
82
+ return { state: "unavailable", diagnostic: `Herdr plugin registry unavailable: ${parsed.error}` };
83
+ const plugins = Array.isArray(parsed.result?.plugins) ? parsed.result.plugins : [];
84
+ const plugin = plugins.find((candidate) => candidate.plugin_id === DASHBOARD_PLUGIN_ID);
85
+ if (!plugin)
86
+ return { state: "absent", diagnostic: `Herdr plugin ${DASHBOARD_PLUGIN_ID} is not installed.` };
87
+ // Provenance and protocol precede enabled state. Suggesting `plugin enable` for a same-id plugin from
88
+ // another package would ask the operator to activate software this package explicitly refuses to invoke.
89
+ if (expectedPluginRoot && (typeof plugin.plugin_root !== "string" || resolve(plugin.plugin_root) !== resolve(expectedPluginRoot))) {
90
+ return {
91
+ state: "incompatible",
92
+ diagnostic: `Herdr plugin ${DASHBOARD_PLUGIN_ID} is linked from a different package; relink the bundled copy.`,
93
+ plugin,
94
+ };
95
+ }
96
+ const major = protocolMajor(plugin.version);
97
+ if (major !== DASHBOARD_PROTOCOL_VERSION) {
98
+ return {
99
+ state: "incompatible",
100
+ diagnostic: `Herdr plugin ${DASHBOARD_PLUGIN_ID} uses protocol ${major ?? "unknown"}; ` +
101
+ `this pi-daddy core requires ${DASHBOARD_PROTOCOL_VERSION}. Relink both from the same package.`,
102
+ plugin,
103
+ };
104
+ }
105
+ if (plugin.enabled !== true) {
106
+ return { state: "disabled", diagnostic: `Herdr plugin ${DASHBOARD_PLUGIN_ID} is installed but disabled.`, plugin };
107
+ }
108
+ const warnings = Array.isArray(plugin.warnings) ? plugin.warnings.filter((value) => typeof value === "string") : [];
109
+ return {
110
+ state: "compatible",
111
+ diagnostic: warnings.length > 0
112
+ ? `Herdr plugin ${DASHBOARD_PLUGIN_ID} is installed with warnings: ${warnings.join("; ")}`
113
+ : `Herdr plugin ${DASHBOARD_PLUGIN_ID} is ready.`,
114
+ plugin,
115
+ };
116
+ }
117
+ catch (error) {
118
+ return { state: "unavailable", diagnostic: `Herdr plugin discovery failed: ${error instanceof Error ? error.message : String(error)}` };
119
+ }
120
+ }
121
+ export async function linkDashboardPlugin(pluginRoot, exec = dashboardHerdrExec) {
122
+ const parsed = parseReply(await exec(["plugin", "link", resolve(pluginRoot), "--enabled"]));
123
+ if (parsed.error)
124
+ throw new Error(`Herdr could not link the bundled dashboard plugin: ${parsed.error}`);
125
+ }
126
+ function isStoredPane(value) {
127
+ if (!value || typeof value !== "object" || Array.isArray(value))
128
+ return false;
129
+ const pane = value;
130
+ return Object.keys(pane).every((key) => [
131
+ "paneId", "terminalId", "tabId", "workspaceId", "ledgerPath", "updatedAt",
132
+ ].includes(key)) &&
133
+ ["paneId", "terminalId", "tabId", "workspaceId", "updatedAt"].every((field) => typeof pane[field] === "string" && pane[field] !== "") && typeof pane.ledgerPath === "string" && Number.isFinite(Date.parse(String(pane.updatedAt)));
134
+ }
135
+ function isPaneStore(value) {
136
+ if (!value || typeof value !== "object" || Array.isArray(value))
137
+ return false;
138
+ const store = value;
139
+ if (store.version !== 1 || !store.panes || typeof store.panes !== "object" || Array.isArray(store.panes))
140
+ return false;
141
+ return Object.keys(store).every((key) => ["version", "panes"].includes(key)) &&
142
+ Object.entries(store.panes).every(([key, pane]) => /^[a-f0-9]{64}$/.test(key) && isStoredPane(pane));
143
+ }
144
+ async function loadStore(path) {
145
+ try {
146
+ const parsed = JSON.parse(await readFile(path, "utf8"));
147
+ if (!isPaneStore(parsed))
148
+ throw new Error("unsupported dashboard pane store shape");
149
+ return parsed;
150
+ }
151
+ catch (error) {
152
+ if (error.code === "ENOENT")
153
+ return { version: 1, panes: {} };
154
+ throw new Error(`dashboard pane state ${path} is corrupt or unreadable: ${error instanceof Error ? error.message : String(error)}`);
155
+ }
156
+ }
157
+ async function saveStore(path, store) {
158
+ await mkdir(dirname(path), { recursive: true });
159
+ const temporary = `${path}.${process.pid}.${randomUUID()}.tmp`;
160
+ await writeFile(temporary, `${JSON.stringify(store, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
161
+ await rename(temporary, path);
162
+ }
163
+ function paneFrom(result) {
164
+ return nested(result, "pane") ?? nested(nested(result, "plugin_pane"), "pane");
165
+ }
166
+ async function locateStoredPane(stored, exec) {
167
+ const direct = parseReply(await exec(["pane", "get", stored.paneId]));
168
+ const pane = direct.error ? undefined : paneFrom(direct.result);
169
+ if (pane?.terminal_id === stored.terminalId)
170
+ return pane;
171
+ // A moved pane receives a new public id, possibly in another workspace; terminal_id is the stable handle.
172
+ const listed = parseReply(await exec(["pane", "list"]));
173
+ if (listed.error || !Array.isArray(listed.result?.panes))
174
+ return undefined;
175
+ return listed.result.panes.find((candidate) => candidate.terminal_id === stored.terminalId);
176
+ }
177
+ async function dashboardProcessIsLive(paneId, exec) {
178
+ const parsed = parseReply(await exec(["pane", "process-info", "--pane", paneId]));
179
+ if (parsed.error)
180
+ throw new Error(`could not verify existing dashboard process: ${parsed.error}`);
181
+ const info = nested(parsed.result, "process_info");
182
+ if (info?.pane_id !== paneId)
183
+ throw new Error("Herdr returned process information for another dashboard pane");
184
+ const processes = Array.isArray(info.foreground_processes) ? info.foreground_processes : [];
185
+ return processes.some((process) => {
186
+ const argv = Array.isArray(process.argv) ? process.argv.filter((value) => typeof value === "string").join(" ") : "";
187
+ return String(process.name ?? "").startsWith("pi-daddy-dashboard") ||
188
+ String(process.cmdline ?? "").includes("dashboard-cli.js") || argv.includes("dashboard-cli.js");
189
+ });
190
+ }
191
+ async function closeUntrackedPane(paneId, exec) {
192
+ const closed = await exec(["plugin", "pane", "close", paneId]).catch(() => undefined);
193
+ return closed ? parseReply(closed).error : "Herdr close command failed";
194
+ }
195
+ export async function openOrReuseDashboard(input) {
196
+ if (!input.ledgerPath.trim() && !input.allowInactive) {
197
+ throw new Error("no pi-daddy ledger is configured; set PI_GRANTS_LEDGER first");
198
+ }
199
+ const exec = input.exec ?? dashboardHerdrExec;
200
+ const ledgerPath = input.ledgerPath.trim() ? resolve(input.cwd, input.ledgerPath) : "";
201
+ const cwd = resolve(input.cwd);
202
+ const key = createHash("sha256")
203
+ .update(`${input.host.workspaceId}\0${input.host.tabId}\0${ledgerPath}`, "utf8")
204
+ .digest("hex");
205
+ await mkdir(dirname(input.statePath), { recursive: true });
206
+ return withFileLock(input.statePath, "pi-daddy dashboard pane state", async () => {
207
+ const plugin = await inspectDashboardPlugin(exec, input.pluginRoot);
208
+ if (plugin.state !== "compatible")
209
+ throw new Error(plugin.diagnostic);
210
+ const store = await loadStore(input.statePath);
211
+ const stored = store.panes[key];
212
+ if (stored) {
213
+ if (stored.workspaceId !== input.host.workspaceId || stored.tabId !== input.host.tabId ||
214
+ stored.ledgerPath !== ledgerPath) {
215
+ throw new Error(`dashboard pane state ${input.statePath} is corrupt: stored workspace/tab/ledger identity mismatch`);
216
+ }
217
+ const pane = await locateStoredPane(stored, exec);
218
+ if (pane && typeof pane.pane_id === "string" && pane.tab_id === input.host.tabId &&
219
+ pane.workspace_id === input.host.workspaceId && await dashboardProcessIsLive(pane.pane_id, exec)) {
220
+ stored.paneId = pane.pane_id;
221
+ stored.tabId = pane.tab_id;
222
+ stored.workspaceId = pane.workspace_id;
223
+ stored.updatedAt = new Date().toISOString();
224
+ await saveStore(input.statePath, store);
225
+ return {
226
+ kind: "reused",
227
+ paneId: stored.paneId,
228
+ tabId: stored.tabId,
229
+ workspaceId: stored.workspaceId,
230
+ visibleBesideCaller: stored.tabId === input.host.tabId,
231
+ };
232
+ }
233
+ delete store.panes[key];
234
+ }
235
+ const args = [
236
+ "plugin", "pane", "open", "--plugin", DASHBOARD_PLUGIN_ID,
237
+ "--entrypoint", DASHBOARD_PLUGIN_ENTRYPOINT, "--placement", "split",
238
+ "--workspace", input.host.workspaceId, "--target-pane", input.host.paneId,
239
+ "--direction", "right", "--cwd", cwd,
240
+ ...(ledgerPath ? ["--env", `${ENV_DASHBOARD_LEDGER}=${ledgerPath}`] : []),
241
+ "--env", `${ENV_DASHBOARD_PROTOCOL}=${DASHBOARD_PROTOCOL_VERSION}`,
242
+ "--env", `${ENV_DASHBOARD_KEY}=${key}`,
243
+ "--no-focus",
244
+ ];
245
+ const opened = parseReply(await exec(args));
246
+ if (opened.error)
247
+ throw new Error(`Herdr could not open the pi-daddy dashboard: ${opened.error}`);
248
+ const pane = paneFrom(opened.result);
249
+ if (!pane || typeof pane.pane_id !== "string" || typeof pane.terminal_id !== "string" ||
250
+ typeof pane.tab_id !== "string" || typeof pane.workspace_id !== "string") {
251
+ throw new Error("Herdr opened the plugin but returned no complete pane identity");
252
+ }
253
+ if (pane.workspace_id !== input.host.workspaceId || pane.tab_id !== input.host.tabId) {
254
+ const closeError = await closeUntrackedPane(pane.pane_id, exec);
255
+ throw new Error(`Herdr returned the dashboard pane in another workspace or tab; ` +
256
+ (closeError ? `the wrong-host pane also could not be closed (${closeError})` : "the wrong-host pane was closed"));
257
+ }
258
+ store.panes[key] = {
259
+ paneId: pane.pane_id,
260
+ terminalId: pane.terminal_id,
261
+ tabId: pane.tab_id,
262
+ workspaceId: pane.workspace_id,
263
+ ledgerPath,
264
+ updatedAt: new Date().toISOString(),
265
+ };
266
+ try {
267
+ await saveStore(input.statePath, store);
268
+ }
269
+ catch (error) {
270
+ const closeError = await closeUntrackedPane(pane.pane_id, exec);
271
+ throw new Error(`dashboard pane identity could not be persisted (${String(error)}); ` +
272
+ (closeError ? `the new pane also could not be closed (${closeError})` : "the untracked pane was closed"));
273
+ }
274
+ return {
275
+ kind: "opened",
276
+ paneId: pane.pane_id,
277
+ tabId: pane.tab_id,
278
+ workspaceId: pane.workspace_id,
279
+ visibleBesideCaller: pane.tab_id === input.host.tabId,
280
+ };
281
+ });
282
+ }
283
+ export function dashboardPaneStatePath(agentDir) {
284
+ return resolve(agentDir, "pi-daddy", "dashboard-panes.json");
285
+ }
286
+ //# sourceMappingURL=dashboard-herdr.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dashboard-herdr.js","sourceRoot":"","sources":["../src/dashboard-herdr.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,73 @@
1
+ import type { CorrelationMetadata } from "./correlation.ts";
2
+ export type DashboardState = "authorised" | "starting" | "running" | "completed" | "failed" | "refused" | "incomplete" | "historical";
3
+ export interface DashboardRuntimeIdentity {
4
+ herdrPaneId?: string;
5
+ herdrAgentName?: string;
6
+ }
7
+ export interface DashboardNode {
8
+ executionId: string;
9
+ parentExecutionId: string | null;
10
+ logicalParentId?: string;
11
+ logicalChildId: string;
12
+ depth: number;
13
+ agentName: string;
14
+ state: DashboardState;
15
+ provenance: "pi-daddy-enforced" | "historical-unjoinable";
16
+ startedAt: string;
17
+ endedAt?: string;
18
+ updatedAt: string;
19
+ durationMs: number;
20
+ effectiveGrant: string[];
21
+ denied: string[];
22
+ executor?: "process" | "herdr";
23
+ workspace?: {
24
+ id: string;
25
+ access: "read" | "write";
26
+ root: string;
27
+ };
28
+ runtime?: DashboardRuntimeIdentity;
29
+ correlation?: CorrelationMetadata;
30
+ refusal?: {
31
+ code?: string;
32
+ message?: string;
33
+ };
34
+ }
35
+ export interface DashboardWorkflowFact {
36
+ factId: string;
37
+ source: string;
38
+ provenance: "planned" | "observed" | "controller-validated";
39
+ kind: "workflow_phase" | "inline_skill" | "transition";
40
+ subject: string;
41
+ state: "pending" | "observed" | "started" | "completed" | "blocked";
42
+ runId: string;
43
+ correlation: CorrelationMetadata;
44
+ }
45
+ export interface DashboardWorkflow {
46
+ runId: string;
47
+ label: string;
48
+ assurance?: string;
49
+ phases: string[];
50
+ /** Correlation is supplied by a caller. It is a label, never controller validation or enforcement. */
51
+ provenance: "caller-declared";
52
+ }
53
+ export interface DashboardCorruptLine {
54
+ line: number;
55
+ /** Raw corrupt content is deliberately excluded: it may contain forbidden task/output text. */
56
+ reason: string;
57
+ }
58
+ export interface DashboardProjection {
59
+ nodes: DashboardNode[];
60
+ workflows: DashboardWorkflow[];
61
+ workflowFacts: DashboardWorkflowFact[];
62
+ corrupt: DashboardCorruptLine[];
63
+ orphanEvents: number;
64
+ active: number;
65
+ maxDepth: number;
66
+ }
67
+ export interface DashboardProjectionOptions {
68
+ now?: Date;
69
+ /** A decision with no start is briefly authorised, then incomplete. */
70
+ startGraceMs?: number;
71
+ }
72
+ export declare function parseDashboardLedger(text: string, options?: DashboardProjectionOptions): DashboardProjection;
73
+ //# sourceMappingURL=dashboard-projection.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dashboard-projection.d.ts","sourceRoot":"","sources":["../src/dashboard-projection.ts"],"names":[],"mappings":"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"}