pi-daddy 0.49.5 → 0.51.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 (160) hide show
  1. package/CHANGELOG.md +57 -1
  2. package/README.md +231 -27
  3. package/dist/governance/initiative-coordinator.d.ts +63 -0
  4. package/dist/governance/initiative-coordinator.d.ts.map +1 -0
  5. package/dist/governance/initiative-coordinator.js +364 -0
  6. package/dist/governance/initiative-coordinator.js.map +1 -0
  7. package/dist/governance/initiative-effects.d.ts +20 -0
  8. package/dist/governance/initiative-effects.d.ts.map +1 -0
  9. package/dist/governance/initiative-effects.js +108 -0
  10. package/dist/governance/initiative-effects.js.map +1 -0
  11. package/dist/governance/initiative-state.d.ts +13 -0
  12. package/dist/governance/initiative-state.d.ts.map +1 -0
  13. package/dist/governance/initiative-state.js +122 -0
  14. package/dist/governance/initiative-state.js.map +1 -0
  15. package/dist/governance/operation-artifact-io.d.ts +8 -0
  16. package/dist/governance/operation-artifact-io.d.ts.map +1 -0
  17. package/dist/governance/operation-artifact-io.js +95 -0
  18. package/dist/governance/operation-artifact-io.js.map +1 -0
  19. package/dist/governance/operation-artifact-scan.d.ts +13 -0
  20. package/dist/governance/operation-artifact-scan.d.ts.map +1 -0
  21. package/dist/governance/operation-artifact-scan.js +71 -0
  22. package/dist/governance/operation-artifact-scan.js.map +1 -0
  23. package/dist/governance/operation-artifacts.d.ts +53 -0
  24. package/dist/governance/operation-artifacts.d.ts.map +1 -0
  25. package/dist/governance/operation-artifacts.js +309 -0
  26. package/dist/governance/operation-artifacts.js.map +1 -0
  27. package/dist/governance/runtime-settlement.d.ts +2 -0
  28. package/dist/governance/runtime-settlement.d.ts.map +1 -1
  29. package/dist/governance/runtime-settlement.js +26 -0
  30. package/dist/governance/runtime-settlement.js.map +1 -1
  31. package/dist/governance/workspace-acceptance.d.ts +5 -0
  32. package/dist/governance/workspace-acceptance.d.ts.map +1 -1
  33. package/dist/governance/workspace-acceptance.js +16 -0
  34. package/dist/governance/workspace-acceptance.js.map +1 -1
  35. package/dist/index.d.ts +8 -0
  36. package/dist/index.d.ts.map +1 -1
  37. package/dist/index.js +8 -0
  38. package/dist/index.js.map +1 -1
  39. package/dist/kernel/dashboard-observation.d.ts +76 -0
  40. package/dist/kernel/dashboard-observation.d.ts.map +1 -0
  41. package/dist/kernel/dashboard-observation.js +49 -0
  42. package/dist/kernel/dashboard-observation.js.map +1 -0
  43. package/dist/kernel/dispatch-operation.d.ts +2 -0
  44. package/dist/kernel/dispatch-operation.d.ts.map +1 -1
  45. package/dist/kernel/dispatch-operation.js.map +1 -1
  46. package/dist/kernel/initiative.d.ts +94 -0
  47. package/dist/kernel/initiative.d.ts.map +1 -0
  48. package/dist/kernel/initiative.js +38 -0
  49. package/dist/kernel/initiative.js.map +1 -0
  50. package/dist/kernel/operation-artifact.d.ts +49 -0
  51. package/dist/kernel/operation-artifact.d.ts.map +1 -0
  52. package/dist/kernel/operation-artifact.js +4 -0
  53. package/dist/kernel/operation-artifact.js.map +1 -0
  54. package/dist/kernel/principal-binding.d.ts +4 -0
  55. package/dist/kernel/principal-binding.d.ts.map +1 -0
  56. package/dist/kernel/principal-binding.js +94 -0
  57. package/dist/kernel/principal-binding.js.map +1 -0
  58. package/dist/kernel/project-paths.d.ts +6 -0
  59. package/dist/kernel/project-paths.d.ts.map +1 -1
  60. package/dist/kernel/project-paths.js +12 -0
  61. package/dist/kernel/project-paths.js.map +1 -1
  62. package/dist/kernel/selected-definitions.d.ts.map +1 -1
  63. package/dist/kernel/selected-definitions.js +5 -91
  64. package/dist/kernel/selected-definitions.js.map +1 -1
  65. package/dist/kernel/workspace-diagnostics.d.ts +24 -0
  66. package/dist/kernel/workspace-diagnostics.d.ts.map +1 -0
  67. package/dist/kernel/workspace-diagnostics.js +81 -0
  68. package/dist/kernel/workspace-diagnostics.js.map +1 -0
  69. package/dist/products/activity-storage.d.ts +2 -0
  70. package/dist/products/activity-storage.d.ts.map +1 -0
  71. package/dist/products/activity-storage.js +119 -0
  72. package/dist/products/activity-storage.js.map +1 -0
  73. package/dist/products/activity-timeline.d.ts +4 -0
  74. package/dist/products/activity-timeline.d.ts.map +1 -1
  75. package/dist/products/activity-timeline.js +12 -0
  76. package/dist/products/activity-timeline.js.map +1 -1
  77. package/dist/products/dashboard-cli.d.ts +2 -0
  78. package/dist/products/dashboard-cli.d.ts.map +1 -1
  79. package/dist/products/dashboard-cli.js +50 -10
  80. package/dist/products/dashboard-cli.js.map +1 -1
  81. package/dist/products/dashboard-display-controls.d.ts.map +1 -1
  82. package/dist/products/dashboard-display-controls.js +72 -2
  83. package/dist/products/dashboard-display-controls.js.map +1 -1
  84. package/dist/products/dashboard-file-cache.d.ts +10 -0
  85. package/dist/products/dashboard-file-cache.d.ts.map +1 -0
  86. package/dist/products/dashboard-file-cache.js +38 -0
  87. package/dist/products/dashboard-file-cache.js.map +1 -0
  88. package/dist/products/dashboard-layout.d.ts +6 -0
  89. package/dist/products/dashboard-layout.d.ts.map +1 -0
  90. package/dist/products/dashboard-layout.js +45 -0
  91. package/dist/products/dashboard-layout.js.map +1 -0
  92. package/dist/products/dashboard-panels.d.ts +10 -0
  93. package/dist/products/dashboard-panels.d.ts.map +1 -0
  94. package/dist/products/dashboard-panels.js +319 -0
  95. package/dist/products/dashboard-panels.js.map +1 -0
  96. package/dist/products/dashboard-recap.d.ts +4 -0
  97. package/dist/products/dashboard-recap.d.ts.map +1 -0
  98. package/dist/products/dashboard-recap.js +47 -0
  99. package/dist/products/dashboard-recap.js.map +1 -0
  100. package/dist/products/dashboard-screen.d.ts +14 -1
  101. package/dist/products/dashboard-screen.d.ts.map +1 -1
  102. package/dist/products/dashboard-screen.js +217 -40
  103. package/dist/products/dashboard-screen.js.map +1 -1
  104. package/dist/products/dashboard-session-client.d.ts +16 -2
  105. package/dist/products/dashboard-session-client.d.ts.map +1 -1
  106. package/dist/products/dashboard-session-client.js +64 -11
  107. package/dist/products/dashboard-session-client.js.map +1 -1
  108. package/dist/products/dashboard-settings.d.ts.map +1 -1
  109. package/dist/products/dashboard-settings.js +4 -6
  110. package/dist/products/dashboard-settings.js.map +1 -1
  111. package/dist/products/ecosystem-versions.d.ts +1 -1
  112. package/dist/products/ecosystem-versions.d.ts.map +1 -1
  113. package/extensions/activity-timeline.ts +3 -1
  114. package/extensions/artifact-bridge.ts +130 -0
  115. package/extensions/dashboard-live.ts +63 -0
  116. package/extensions/dashboard-observation.ts +39 -0
  117. package/extensions/dashboard-session-server.ts +45 -3
  118. package/extensions/dashboard-sources.ts +124 -0
  119. package/extensions/delegation-artifacts.ts +133 -0
  120. package/extensions/delegation-operations.ts +42 -13
  121. package/extensions/ecosystem-versions.ts +12 -5
  122. package/extensions/grants-command.ts +34 -6
  123. package/extensions/grants.ts +9 -20
  124. package/extensions/initiative-dashboard.ts +143 -0
  125. package/extensions/initiative-handoff.ts +59 -0
  126. package/extensions/initiative-runtime.ts +444 -0
  127. package/extensions/runtime-snapshot.ts +118 -2
  128. package/extensions/session-environment.ts +13 -1
  129. package/extensions/session.ts +28 -10
  130. package/extensions/workspace-diagnostics.ts +90 -0
  131. package/package.json +1 -1
  132. package/src/governance/initiative-coordinator.ts +416 -0
  133. package/src/governance/initiative-effects.ts +146 -0
  134. package/src/governance/initiative-state.ts +144 -0
  135. package/src/governance/operation-artifact-io.ts +103 -0
  136. package/src/governance/operation-artifact-scan.ts +77 -0
  137. package/src/governance/operation-artifacts.ts +363 -0
  138. package/src/governance/runtime-settlement.ts +28 -0
  139. package/src/governance/workspace-acceptance.ts +18 -0
  140. package/src/index.ts +13 -0
  141. package/src/kernel/dashboard-observation.ts +109 -0
  142. package/src/kernel/dispatch-operation.ts +2 -0
  143. package/src/kernel/initiative.ts +126 -0
  144. package/src/kernel/operation-artifact.ts +46 -0
  145. package/src/kernel/principal-binding.ts +104 -0
  146. package/src/kernel/project-paths.ts +16 -0
  147. package/src/kernel/selected-definitions.ts +5 -100
  148. package/src/kernel/workspace-diagnostics.ts +110 -0
  149. package/src/products/activity-storage.ts +128 -0
  150. package/src/products/activity-timeline.ts +11 -0
  151. package/src/products/dashboard-cli.ts +53 -10
  152. package/src/products/dashboard-display-controls.ts +63 -2
  153. package/src/products/dashboard-file-cache.ts +38 -0
  154. package/src/products/dashboard-layout.ts +50 -0
  155. package/src/products/dashboard-panels.ts +379 -0
  156. package/src/products/dashboard-recap.ts +48 -0
  157. package/src/products/dashboard-screen.ts +266 -43
  158. package/src/products/dashboard-session-client.ts +78 -14
  159. package/src/products/dashboard-settings.ts +4 -6
  160. package/src/products/ecosystem-versions.ts +2 -1
@@ -0,0 +1,122 @@
1
+ /** Bounded private snapshot under the existing Daddy agent state; callers hold the existing OS lock. */
2
+ import { randomUUID } from "node:crypto";
3
+ import { constants, openSync, closeSync, fsyncSync, writeFileSync, renameSync, unlinkSync, realpathSync, existsSync, } from "node:fs";
4
+ import { join } from "node:path";
5
+ import { readBoundedTextSync } from "../kernel/bounded-read-sync.js";
6
+ import { initiativeStateDir } from "../kernel/project-paths.js";
7
+ import { validOperationId } from "../kernel/dispatch-operation.js";
8
+ import { validInitiativeId, validEffectReceipt, sameEffectTarget, validInitiativeTask, } from "../kernel/initiative.js";
9
+ import { artifactHash, privateArtifactDirectory } from "./operation-artifact-io.js";
10
+ const MAX_BYTES = 512 * 1024;
11
+ export const initiativeRevision = (record) => artifactHash(JSON.stringify(record));
12
+ export function initiativeLocation(directory, id, create = false) {
13
+ if (!validInitiativeId(id))
14
+ throw Error("invalid initiative identity");
15
+ const root = initiativeStateDir(realpathSync(directory));
16
+ privateArtifactDirectory(root, create);
17
+ return { root, path: join(root, artifactHash(id) + ".json") };
18
+ }
19
+ export function validateInitiative(v, id) {
20
+ const r = v;
21
+ if (!r ||
22
+ r.version !== 1 ||
23
+ r.initiativeId !== id ||
24
+ !Number.isSafeInteger(r.generation) ||
25
+ r.generation < 1 ||
26
+ !r.owner ||
27
+ typeof r.owner.sessionId !== "string" ||
28
+ !r.owner.sessionId ||
29
+ r.owner.sessionId.length > 512 ||
30
+ typeof r.owner.cwd !== "string" ||
31
+ !r.owner.cwd.startsWith("/") ||
32
+ r.owner.cwd.length > 4096 ||
33
+ !["owned", "released"].includes(r.state) ||
34
+ !Array.isArray(r.tasks) ||
35
+ r.tasks.length > 256)
36
+ throw Error("invalid initiative record");
37
+ const keys = new Set(), operations = new Set();
38
+ let attempts = 0;
39
+ for (const t of r.tasks) {
40
+ const key = JSON.stringify([t.taskId, t.taskRevision]);
41
+ if (!validInitiativeTask(t) ||
42
+ keys.has(key) ||
43
+ !Number.isSafeInteger(t.generation) ||
44
+ t.generation < 1 ||
45
+ t.generation > r.generation ||
46
+ !Array.isArray(t.attempts))
47
+ throw Error("invalid initiative task record");
48
+ keys.add(key);
49
+ for (const a of t.attempts) {
50
+ const key = JSON.stringify([a.owner?.sessionId, a.owner?.cwd, a.operationId]);
51
+ if (++attempts > 1024 ||
52
+ operations.has(key) ||
53
+ !validOperationId(a.operationId) ||
54
+ typeof a.executionId !== "string" ||
55
+ !a.executionId.startsWith("exec:") ||
56
+ a.executionId.length > 128 ||
57
+ typeof a.requestDigest !== "string" ||
58
+ !/^[a-f0-9]{64}$/.test(a.requestDigest) ||
59
+ !a.owner?.sessionId ||
60
+ a.owner.sessionId.length > 512 ||
61
+ typeof a.owner.cwd !== "string" ||
62
+ !a.owner.cwd.startsWith("/") ||
63
+ a.owner.cwd.length > 4096 ||
64
+ !["pending", "not-admitted"].includes(a.state) ||
65
+ (a.effectReceipt !== undefined && !validEffectReceipt(a.effectReceipt)) ||
66
+ (a.effectReceipt?.observation !== undefined &&
67
+ !sameEffectTarget(t.effectTarget, a.effectReceipt.observation.target)))
68
+ throw Error("invalid initiative attempt record");
69
+ operations.add(key);
70
+ }
71
+ }
72
+ return r;
73
+ }
74
+ export function readInitiativeState(directory, id) {
75
+ try {
76
+ const { path, root } = initiativeLocation(directory, id);
77
+ const record = validateInitiative(JSON.parse(readBoundedTextSync(path, { maxBytes: MAX_BYTES, confinedRoot: root }).text), id);
78
+ return { record, revision: initiativeRevision(record) };
79
+ }
80
+ catch (error) {
81
+ if (error.code === "ENOENT") {
82
+ const root = initiativeStateDir(realpathSync(directory));
83
+ if (existsSync(join(root, artifactHash(id) + ".json.initialized")))
84
+ throw Error("initiative state missing; restore trusted state");
85
+ return null;
86
+ }
87
+ throw error;
88
+ }
89
+ }
90
+ export function saveInitiative(path, root, record) {
91
+ validateInitiative(record, record.initiativeId);
92
+ const text = JSON.stringify(record) + "\n";
93
+ if (Buffer.byteLength(text) > MAX_BYTES)
94
+ throw Error("initiative record exceeds bound");
95
+ privateArtifactDirectory(root);
96
+ const temporary = path + "." + randomUUID();
97
+ const fd = openSync(temporary, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
98
+ try {
99
+ writeFileSync(fd, text);
100
+ fsyncSync(fd);
101
+ }
102
+ finally {
103
+ closeSync(fd);
104
+ }
105
+ try {
106
+ renameSync(temporary, path);
107
+ const parent = openSync(root, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
108
+ try {
109
+ fsyncSync(parent);
110
+ }
111
+ finally {
112
+ closeSync(parent);
113
+ }
114
+ }
115
+ finally {
116
+ try {
117
+ unlinkSync(temporary);
118
+ }
119
+ catch { }
120
+ }
121
+ }
122
+ //# sourceMappingURL=initiative-state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"initiative-state.js","sourceRoot":"","sources":["../../src/governance/initiative-state.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { OperationArtifactContent } from "../kernel/operation-artifact.ts";
2
+ export declare const artifactHash: (text: string) => string;
3
+ export declare const artifactJson: (value: unknown) => string;
4
+ export declare function privateArtifactDirectory(path: string, create?: boolean): string;
5
+ export declare function readArtifactBytes(reference: OperationArtifactContent, root: string, maxBytes: number): string;
6
+ /** Publish without overwrite. A losing writer may reuse only byte-identical content. */
7
+ export declare function publishArtifact(path: string, name: string, text: string, reuse?: boolean): OperationArtifactContent;
8
+ //# sourceMappingURL=operation-artifact-io.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"operation-artifact-io.d.ts","sourceRoot":"","sources":["../../src/governance/operation-artifact-io.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,WAA4D,CAAC;AACtG,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,WAAiC,CAAC;AAC7E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM,CAsB7E;AACD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,wBAAwB,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAc7G;AACD,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,UAAO,GAAG,wBAAwB,CA2ChH"}
@@ -0,0 +1,95 @@
1
+ /** Small private, immutable files. Cooperative local integrity, not a hostile same-uid boundary. */
2
+ import { createHash, randomUUID } from "node:crypto";
3
+ import { constants, openSync, closeSync, fstatSync, fsyncSync, mkdirSync, realpathSync, writeFileSync, linkSync, unlinkSync, lstatSync, } from "node:fs";
4
+ import { join, dirname } from "node:path";
5
+ import { readBoundedTextSync } from "../kernel/bounded-read-sync.js";
6
+ export const artifactHash = (text) => createHash("sha256").update(text, "utf8").digest("hex");
7
+ export const artifactJson = (value) => JSON.stringify(value) + "\n";
8
+ export function privateArtifactDirectory(path, create = false) {
9
+ if (create) {
10
+ const first = mkdirSync(path, { recursive: true, mode: 0o700 });
11
+ if (first) {
12
+ let parent = dirname(path);
13
+ while (true) {
14
+ const fd = openSync(parent, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
15
+ try {
16
+ fsyncSync(fd);
17
+ }
18
+ finally {
19
+ closeSync(fd);
20
+ }
21
+ if (parent === dirname(first))
22
+ break;
23
+ parent = dirname(parent);
24
+ }
25
+ }
26
+ }
27
+ if (realpathSync(path) !== path)
28
+ throw Error("operation artifact directory must be canonical without symlinks");
29
+ const info = lstatSync(path);
30
+ if (!info.isDirectory() || info.uid !== process.getuid?.() || info.mode & 0o077)
31
+ throw Error("operation artifact directory must be private and owned by this uid");
32
+ return path;
33
+ }
34
+ export function readArtifactBytes(reference, root, maxBytes) {
35
+ if (!reference ||
36
+ typeof reference.path !== "string" ||
37
+ !/^[a-f0-9]{64}$/.test(reference.sha256) ||
38
+ !Number.isSafeInteger(reference.bytes) ||
39
+ reference.bytes < 0 ||
40
+ reference.bytes > maxBytes)
41
+ throw Error("invalid or oversized operation artifact reference");
42
+ const text = readBoundedTextSync(reference.path, { maxBytes, confinedRoot: root }).text;
43
+ if (Buffer.byteLength(text) !== reference.bytes || artifactHash(text) !== reference.sha256)
44
+ throw Error("operation artifact content identity mismatch");
45
+ return text;
46
+ }
47
+ /** Publish without overwrite. A losing writer may reuse only byte-identical content. */
48
+ export function publishArtifact(path, name, text, reuse = true) {
49
+ privateArtifactDirectory(path);
50
+ const fd = openSync(path, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
51
+ const held = `/proc/self/fd/${fd}`;
52
+ const temporary = `${name}.${randomUUID()}.tmp`;
53
+ try {
54
+ const info = fstatSync(fd);
55
+ if (!info.isDirectory() || info.uid !== process.getuid?.() || info.mode & 0o077)
56
+ throw Error("invalid artifact owner");
57
+ const file = openSync(join(held, temporary), constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
58
+ try {
59
+ writeFileSync(file, text);
60
+ fsyncSync(file);
61
+ }
62
+ finally {
63
+ closeSync(file);
64
+ }
65
+ const reference = { path: join(path, name), sha256: artifactHash(text), bytes: Buffer.byteLength(text) };
66
+ try {
67
+ linkSync(join(held, temporary), join(held, name));
68
+ }
69
+ catch (error) {
70
+ if (error.code !== "EEXIST" || !reuse)
71
+ throw error;
72
+ readArtifactBytes(reference, path, reference.bytes);
73
+ }
74
+ fsyncSync(fd);
75
+ const current = lstatSync(path);
76
+ if (realpathSync(path) !== path || current.ino !== info.ino || current.dev !== info.dev)
77
+ throw Error("artifact directory changed before publication");
78
+ return reference;
79
+ }
80
+ finally {
81
+ try {
82
+ try {
83
+ unlinkSync(join(held, temporary));
84
+ }
85
+ catch (error) {
86
+ if (error.code !== "ENOENT")
87
+ throw error;
88
+ }
89
+ }
90
+ finally {
91
+ closeSync(fd);
92
+ }
93
+ }
94
+ }
95
+ //# sourceMappingURL=operation-artifact-io.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"operation-artifact-io.js","sourceRoot":"","sources":["../../src/governance/operation-artifact-io.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import { type OperationArtifactOwner, type OperationArtifactRef } from "../kernel/operation-artifact.ts";
2
+ export declare function operationArtifactInstance(agentDirectory: string): string;
3
+ export declare function openOperationArtifactScan(agentDirectory: string, owner: OperationArtifactOwner): {
4
+ close: () => void;
5
+ next(limit?: number): {
6
+ references: OperationArtifactRef[];
7
+ scanned: number;
8
+ uncertain: number;
9
+ issues: number;
10
+ complete: boolean;
11
+ };
12
+ };
13
+ //# sourceMappingURL=operation-artifact-scan.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"operation-artifact-scan.d.ts","sourceRoot":"","sources":["../../src/governance/operation-artifact-scan.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC1B,MAAM,iCAAiC,CAAC;AAIzC,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAMxE;AACD,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB;;;;;;;;;EAyD9F"}
@@ -0,0 +1,71 @@
1
+ /** Bounded traversal of one trusted producer owner. No recursive discovery or dispatch. */
2
+ import { opendirSync, realpathSync, statSync } from "node:fs";
3
+ import { join } from "node:path";
4
+ import { operationArtifactsDir } from "../kernel/project-paths.js";
5
+ import { MAX_OPERATION_MANIFEST_BYTES, } from "../kernel/operation-artifact.js";
6
+ import { readBoundedTextSync } from "../kernel/bounded-read-sync.js";
7
+ import { artifactHash, privateArtifactDirectory } from "./operation-artifact-io.js";
8
+ import { openOperationArtifacts } from "./operation-artifacts.js";
9
+ export function operationArtifactInstance(agentDirectory) {
10
+ const canonical = realpathSync(agentDirectory), identity = statSync(canonical, { bigint: true });
11
+ return artifactHash(JSON.stringify([canonical, identity.dev.toString(), identity.ino.toString(), identity.birthtimeNs.toString()]));
12
+ }
13
+ export function openOperationArtifactScan(agentDirectory, owner) {
14
+ const store = openOperationArtifacts(agentDirectory, owner);
15
+ const root = join(operationArtifactsDir(realpathSync(agentDirectory)), artifactHash(JSON.stringify([owner.sessionId, owner.cwd])));
16
+ let directory, complete = false;
17
+ try {
18
+ privateArtifactDirectory(root);
19
+ directory = opendirSync(root, { bufferSize: 64 });
20
+ }
21
+ catch (error) {
22
+ if (error.code !== "ENOENT")
23
+ throw error;
24
+ complete = true;
25
+ }
26
+ const close = () => {
27
+ directory?.closeSync();
28
+ directory = undefined;
29
+ complete = true;
30
+ };
31
+ return {
32
+ close,
33
+ next(limit = 32) {
34
+ if (!Number.isSafeInteger(limit) || limit < 1 || limit > 64)
35
+ throw Error("invalid artifact scan limit");
36
+ const references = [];
37
+ let scanned = 0, uncertain = 0, issues = 0;
38
+ while (!complete && scanned < limit) {
39
+ const entry = directory.readSync();
40
+ if (!entry) {
41
+ close();
42
+ break;
43
+ }
44
+ scanned++;
45
+ try {
46
+ if (!entry.isDirectory() || !/^([a-f0-9]{64})$/.test(entry.name))
47
+ throw Error("invalid entry");
48
+ const path = join(root, entry.name);
49
+ privateArtifactDirectory(path);
50
+ const admission = JSON.parse(readBoundedTextSync(join(path, "admission.json"), {
51
+ maxBytes: MAX_OPERATION_MANIFEST_BYTES,
52
+ confinedRoot: path,
53
+ }).text);
54
+ const id = admission?.request?.operationId;
55
+ if (typeof id !== "string" || artifactHash(id) !== entry.name)
56
+ throw Error("invalid identity");
57
+ const retained = store.history(id, false);
58
+ if (retained?.artifact)
59
+ references.push(retained.artifact);
60
+ else
61
+ uncertain++;
62
+ }
63
+ catch {
64
+ issues++;
65
+ }
66
+ }
67
+ return { references, scanned, uncertain, issues, complete };
68
+ },
69
+ };
70
+ }
71
+ //# sourceMappingURL=operation-artifact-scan.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"operation-artifact-scan.js","sourceRoot":"","sources":["../../src/governance/operation-artifact-scan.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ import { type OperationRequest, type OperationReference } from "../kernel/dispatch-operation.ts";
2
+ import { type OperationArtifactOwner, type OperationArtifactRef, type OperationArtifactManifest, type OperationArtifactOutcome, type RetainedOperationFinal } from "../kernel/operation-artifact.ts";
3
+ export interface ReadOperationArtifactOptions {
4
+ /** Trusted selected agent directory, never inferred from the reference. */
5
+ agentDirectory?: string;
6
+ /** Maximum returned authored bytes. Metadata has its own 64 KiB bound. */
7
+ maxBytes?: number;
8
+ }
9
+ /** Exact immutable read; a successful read is not current applicability or execution authority. */
10
+ export declare function readOperationArtifact(reference: OperationArtifactRef, options?: ReadOperationArtifactOptions): {
11
+ partial?: {
12
+ text: string;
13
+ sha256: string;
14
+ } | undefined;
15
+ final?: RetainedOperationFinal | undefined;
16
+ manifest: OperationArtifactManifest;
17
+ };
18
+ export interface OperationArtifactHistory {
19
+ operation: OperationReference;
20
+ requestDigest: string;
21
+ reason?: string;
22
+ artifact?: OperationArtifactRef;
23
+ final?: RetainedOperationFinal;
24
+ partial?: {
25
+ text: string;
26
+ sha256: string;
27
+ };
28
+ }
29
+ export declare function openOperationArtifacts(agentDirectory: string, owner: OperationArtifactOwner): {
30
+ owner: Readonly<{
31
+ sessionId: string;
32
+ cwd: string;
33
+ }>;
34
+ history: (operationId: string, includeFinal?: boolean) => OperationArtifactHistory | null;
35
+ admit(request: OperationRequest): {
36
+ operation: OperationReference;
37
+ requestDigest: string;
38
+ reason?: string;
39
+ artifact?: OperationArtifactRef;
40
+ final?: RetainedOperationFinal;
41
+ partial?: {
42
+ text: string;
43
+ sha256: string;
44
+ };
45
+ created: boolean;
46
+ } | {
47
+ created: boolean;
48
+ };
49
+ started(request: OperationRequest, cwd: string, workspaceId: string | null): void;
50
+ finish(request: OperationRequest, outcome: OperationArtifactOutcome): OperationArtifactRef;
51
+ };
52
+ export type OperationArtifactStore = ReturnType<typeof openOperationArtifacts>;
53
+ //# sourceMappingURL=operation-artifacts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"operation-artifacts.d.ts","sourceRoot":"","sources":["../../src/governance/operation-artifacts.ts"],"names":[],"mappings":"AAKA,OAAO,EAAoB,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACnH,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC5B,MAAM,iCAAiC,CAAC;AAkKzC,MAAM,WAAW,4BAA4B;IAC3C,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,mGAAmG;AACnG,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,oBAAoB,EAAE,OAAO,GAAE,4BAAiC;;cAkB1F,MAAM;gBAAU,MAAM;;;;EAQ5C;AACD,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AACD,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB;;;;;2BAI5D,MAAM,6BAAwB,wBAAwB,GAAG,IAAI;mBA8C1E,gBAAgB;mBAzDtB,kBAAkB;uBACd,MAAM;iBACZ,MAAM;mBACJ,oBAAoB;gBACvB,sBAAsB;kBACpB;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE;;;;;qBAiFvB,gBAAgB,OAAO,MAAM,eAAe,MAAM,GAAG,IAAI;oBAmB1D,gBAAgB,WAAW,wBAAwB,GAAG,oBAAoB;EA6C7F;AACD,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC"}