@theihtisham/agent-shadow-brain 7.1.4 → 7.22.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 (275) hide show
  1. package/CHANGELOG.md +478 -462
  2. package/README.md +97 -24
  3. package/dist/brain/auto-update.js +1 -1
  4. package/dist/brain/auto-update.js.map +1 -1
  5. package/dist/brain/brain-portability.js +1 -1
  6. package/dist/brain/brain-portability.js.map +1 -1
  7. package/dist/brain/client-integrations.js +1 -1
  8. package/dist/brain/client-integrations.js.map +1 -1
  9. package/dist/brain/context-assembly.d.ts +10 -0
  10. package/dist/brain/context-assembly.d.ts.map +1 -1
  11. package/dist/brain/context-assembly.js +15 -6
  12. package/dist/brain/context-assembly.js.map +1 -1
  13. package/dist/brain/context-efficiency.d.ts +48 -0
  14. package/dist/brain/context-efficiency.d.ts.map +1 -0
  15. package/dist/brain/context-efficiency.js +34 -0
  16. package/dist/brain/context-efficiency.js.map +1 -0
  17. package/dist/brain/context-request.d.ts +1 -1
  18. package/dist/brain/context-request.d.ts.map +1 -1
  19. package/dist/brain/context-request.js +4 -2
  20. package/dist/brain/context-request.js.map +1 -1
  21. package/dist/brain/context-retrieval.d.ts +1 -1
  22. package/dist/brain/context-retrieval.d.ts.map +1 -1
  23. package/dist/brain/context-retrieval.js +2 -1
  24. package/dist/brain/context-retrieval.js.map +1 -1
  25. package/dist/brain/feature-settings.d.ts +5 -0
  26. package/dist/brain/feature-settings.d.ts.map +1 -1
  27. package/dist/brain/feature-settings.js +8 -2
  28. package/dist/brain/feature-settings.js.map +1 -1
  29. package/dist/brain/global-brain.d.ts +1 -1
  30. package/dist/brain/global-brain.d.ts.map +1 -1
  31. package/dist/brain/global-brain.js +1 -0
  32. package/dist/brain/global-brain.js.map +1 -1
  33. package/dist/brain/managed-project-skills.d.ts +48 -0
  34. package/dist/brain/managed-project-skills.d.ts.map +1 -0
  35. package/dist/brain/managed-project-skills.js +230 -0
  36. package/dist/brain/managed-project-skills.js.map +1 -0
  37. package/dist/brain/mcp-presence.d.ts +50 -0
  38. package/dist/brain/mcp-presence.d.ts.map +1 -0
  39. package/dist/brain/mcp-presence.js +214 -0
  40. package/dist/brain/mcp-presence.js.map +1 -0
  41. package/dist/brain/mcp-server.d.ts +12 -0
  42. package/dist/brain/mcp-server.d.ts.map +1 -1
  43. package/dist/brain/mcp-server.js +177 -31
  44. package/dist/brain/mcp-server.js.map +1 -1
  45. package/dist/brain/mcp-stdio.d.ts +1 -1
  46. package/dist/brain/mcp-stdio.d.ts.map +1 -1
  47. package/dist/brain/mcp-stdio.js +19 -1
  48. package/dist/brain/mcp-stdio.js.map +1 -1
  49. package/dist/brain/memory-annotations.d.ts +2 -0
  50. package/dist/brain/memory-annotations.d.ts.map +1 -1
  51. package/dist/brain/memory-annotations.js +13 -0
  52. package/dist/brain/memory-annotations.js.map +1 -1
  53. package/dist/brain/memory-inspection.d.ts +1 -0
  54. package/dist/brain/memory-inspection.d.ts.map +1 -1
  55. package/dist/brain/memory-inspection.js +1 -1
  56. package/dist/brain/memory-inspection.js.map +1 -1
  57. package/dist/brain/memory-mcp-content.d.ts +4 -2
  58. package/dist/brain/memory-mcp-content.d.ts.map +1 -1
  59. package/dist/brain/memory-mcp-content.js +20 -16
  60. package/dist/brain/memory-mcp-content.js.map +1 -1
  61. package/dist/brain/model-registry.d.ts +4 -5
  62. package/dist/brain/model-registry.d.ts.map +1 -1
  63. package/dist/brain/model-registry.js +22 -207
  64. package/dist/brain/model-registry.js.map +1 -1
  65. package/dist/brain/model-usage.d.ts +66 -0
  66. package/dist/brain/model-usage.d.ts.map +1 -0
  67. package/dist/brain/model-usage.js +246 -0
  68. package/dist/brain/model-usage.js.map +1 -0
  69. package/dist/brain/native-codex.d.ts +105 -0
  70. package/dist/brain/native-codex.d.ts.map +1 -0
  71. package/dist/brain/native-codex.js +292 -0
  72. package/dist/brain/native-codex.js.map +1 -0
  73. package/dist/brain/native-session-import.d.ts +56 -0
  74. package/dist/brain/native-session-import.d.ts.map +1 -0
  75. package/dist/brain/native-session-import.js +307 -0
  76. package/dist/brain/native-session-import.js.map +1 -0
  77. package/dist/brain/orchestrator.js +1 -1
  78. package/dist/brain/orchestrator.js.map +1 -1
  79. package/dist/brain/project-feedback.d.ts +1 -1
  80. package/dist/brain/project-feedback.d.ts.map +1 -1
  81. package/dist/brain/project-feedback.js +19 -8
  82. package/dist/brain/project-feedback.js.map +1 -1
  83. package/dist/brain/project-hub-contract.d.ts +6 -0
  84. package/dist/brain/project-hub-contract.d.ts.map +1 -1
  85. package/dist/brain/project-hub-contract.js +2 -1
  86. package/dist/brain/project-hub-contract.js.map +1 -1
  87. package/dist/brain/project-hub-mcp.d.ts +14 -0
  88. package/dist/brain/project-hub-mcp.d.ts.map +1 -1
  89. package/dist/brain/project-hub-mcp.js +6 -1
  90. package/dist/brain/project-hub-mcp.js.map +1 -1
  91. package/dist/brain/project-hub-store.d.ts +14 -2
  92. package/dist/brain/project-hub-store.d.ts.map +1 -1
  93. package/dist/brain/project-hub-store.js +70 -2
  94. package/dist/brain/project-hub-store.js.map +1 -1
  95. package/dist/brain/project-hub.d.ts +5 -0
  96. package/dist/brain/project-hub.d.ts.map +1 -1
  97. package/dist/brain/project-hub.js +23 -1
  98. package/dist/brain/project-hub.js.map +1 -1
  99. package/dist/brain/project-kit.d.ts +10 -0
  100. package/dist/brain/project-kit.d.ts.map +1 -1
  101. package/dist/brain/project-kit.js +80 -16
  102. package/dist/brain/project-kit.js.map +1 -1
  103. package/dist/brain/project-policy-delivery.d.ts +8 -0
  104. package/dist/brain/project-policy-delivery.d.ts.map +1 -0
  105. package/dist/brain/project-policy-delivery.js +38 -0
  106. package/dist/brain/project-policy-delivery.js.map +1 -0
  107. package/dist/brain/project-policy.d.ts +88 -0
  108. package/dist/brain/project-policy.d.ts.map +1 -0
  109. package/dist/brain/project-policy.js +267 -0
  110. package/dist/brain/project-policy.js.map +1 -0
  111. package/dist/brain/project-session-contract.d.ts +180 -0
  112. package/dist/brain/project-session-contract.d.ts.map +1 -0
  113. package/dist/brain/project-session-contract.js +50 -0
  114. package/dist/brain/project-session-contract.js.map +1 -0
  115. package/dist/brain/project-session-mcp.d.ts +145 -0
  116. package/dist/brain/project-session-mcp.d.ts.map +1 -0
  117. package/dist/brain/project-session-mcp.js +58 -0
  118. package/dist/brain/project-session-mcp.js.map +1 -0
  119. package/dist/brain/project-sessions.d.ts +97 -0
  120. package/dist/brain/project-sessions.d.ts.map +1 -0
  121. package/dist/brain/project-sessions.js +223 -0
  122. package/dist/brain/project-sessions.js.map +1 -0
  123. package/dist/brain/project-source-contract.d.ts +109 -0
  124. package/dist/brain/project-source-contract.d.ts.map +1 -0
  125. package/dist/brain/project-source-contract.js +2 -0
  126. package/dist/brain/project-source-contract.js.map +1 -0
  127. package/dist/brain/project-source-intake.d.ts +26 -0
  128. package/dist/brain/project-source-intake.d.ts.map +1 -0
  129. package/dist/brain/project-source-intake.js +457 -0
  130. package/dist/brain/project-source-intake.js.map +1 -0
  131. package/dist/cli.js +1 -1
  132. package/dist/cli.js.map +1 -1
  133. package/dist/context-cli.d.ts.map +1 -1
  134. package/dist/context-cli.js +9 -3
  135. package/dist/context-cli.js.map +1 -1
  136. package/dist/dashboard/brain-hub-actions.d.ts.map +1 -1
  137. package/dist/dashboard/brain-hub-actions.js +232 -135
  138. package/dist/dashboard/brain-hub-actions.js.map +1 -1
  139. package/dist/dashboard/brain-hub-agent-dock.d.ts +2 -0
  140. package/dist/dashboard/brain-hub-agent-dock.d.ts.map +1 -0
  141. package/dist/dashboard/brain-hub-agent-dock.js +255 -0
  142. package/dist/dashboard/brain-hub-agent-dock.js.map +1 -0
  143. package/dist/dashboard/brain-hub-brand-icons.d.ts +2 -0
  144. package/dist/dashboard/brain-hub-brand-icons.d.ts.map +1 -0
  145. package/dist/dashboard/brain-hub-brand-icons.js +9 -0
  146. package/dist/dashboard/brain-hub-brand-icons.js.map +1 -0
  147. package/dist/dashboard/brain-hub-client.d.ts.map +1 -1
  148. package/dist/dashboard/brain-hub-client.js +433 -333
  149. package/dist/dashboard/brain-hub-client.js.map +1 -1
  150. package/dist/dashboard/brain-hub-context.d.ts +2 -0
  151. package/dist/dashboard/brain-hub-context.d.ts.map +1 -0
  152. package/dist/dashboard/brain-hub-context.js +37 -0
  153. package/dist/dashboard/brain-hub-context.js.map +1 -0
  154. package/dist/dashboard/brain-hub-controls.d.ts +2 -0
  155. package/dist/dashboard/brain-hub-controls.d.ts.map +1 -0
  156. package/dist/dashboard/brain-hub-controls.js +63 -0
  157. package/dist/dashboard/brain-hub-controls.js.map +1 -0
  158. package/dist/dashboard/brain-hub-exchanges.d.ts +2 -0
  159. package/dist/dashboard/brain-hub-exchanges.d.ts.map +1 -0
  160. package/dist/dashboard/brain-hub-exchanges.js +82 -0
  161. package/dist/dashboard/brain-hub-exchanges.js.map +1 -0
  162. package/dist/dashboard/brain-hub-graph.d.ts.map +1 -1
  163. package/dist/dashboard/brain-hub-graph.js +236 -74
  164. package/dist/dashboard/brain-hub-graph.js.map +1 -1
  165. package/dist/dashboard/brain-hub-html.d.ts.map +1 -1
  166. package/dist/dashboard/brain-hub-html.js +56 -1
  167. package/dist/dashboard/brain-hub-html.js.map +1 -1
  168. package/dist/dashboard/brain-hub-knowledge.d.ts +2 -0
  169. package/dist/dashboard/brain-hub-knowledge.d.ts.map +1 -0
  170. package/dist/dashboard/brain-hub-knowledge.js +33 -0
  171. package/dist/dashboard/brain-hub-knowledge.js.map +1 -0
  172. package/dist/dashboard/brain-hub-live.d.ts +2 -0
  173. package/dist/dashboard/brain-hub-live.d.ts.map +1 -0
  174. package/dist/dashboard/brain-hub-live.js +151 -0
  175. package/dist/dashboard/brain-hub-live.js.map +1 -0
  176. package/dist/dashboard/brain-hub-managed-skills.d.ts +2 -0
  177. package/dist/dashboard/brain-hub-managed-skills.d.ts.map +1 -0
  178. package/dist/dashboard/brain-hub-managed-skills.js +20 -0
  179. package/dist/dashboard/brain-hub-managed-skills.js.map +1 -0
  180. package/dist/dashboard/brain-hub-native.d.ts +2 -0
  181. package/dist/dashboard/brain-hub-native.d.ts.map +1 -0
  182. package/dist/dashboard/brain-hub-native.js +44 -0
  183. package/dist/dashboard/brain-hub-native.js.map +1 -0
  184. package/dist/dashboard/brain-hub-project-views.d.ts.map +1 -1
  185. package/dist/dashboard/brain-hub-project-views.js +78 -77
  186. package/dist/dashboard/brain-hub-project-views.js.map +1 -1
  187. package/dist/dashboard/brain-hub-sessions.d.ts +2 -0
  188. package/dist/dashboard/brain-hub-sessions.d.ts.map +1 -0
  189. package/dist/dashboard/brain-hub-sessions.js +40 -0
  190. package/dist/dashboard/brain-hub-sessions.js.map +1 -0
  191. package/dist/dashboard/brain-hub-usage.d.ts +2 -0
  192. package/dist/dashboard/brain-hub-usage.d.ts.map +1 -0
  193. package/dist/dashboard/brain-hub-usage.js +28 -0
  194. package/dist/dashboard/brain-hub-usage.js.map +1 -0
  195. package/dist/dashboard/brain-hub-views.d.ts.map +1 -1
  196. package/dist/dashboard/brain-hub-views.js +151 -146
  197. package/dist/dashboard/brain-hub-views.js.map +1 -1
  198. package/dist/dashboard/live-workspace-html.js +1039 -1039
  199. package/dist/dashboard/managed-project-skills-api.d.ts +29 -0
  200. package/dist/dashboard/managed-project-skills-api.d.ts.map +1 -0
  201. package/dist/dashboard/managed-project-skills-api.js +28 -0
  202. package/dist/dashboard/managed-project-skills-api.js.map +1 -0
  203. package/dist/dashboard/native-codex-api.d.ts +83 -0
  204. package/dist/dashboard/native-codex-api.d.ts.map +1 -0
  205. package/dist/dashboard/native-codex-api.js +91 -0
  206. package/dist/dashboard/native-codex-api.js.map +1 -0
  207. package/dist/dashboard/project-file-watch.d.ts +46 -0
  208. package/dist/dashboard/project-file-watch.d.ts.map +1 -0
  209. package/dist/dashboard/project-file-watch.js +221 -0
  210. package/dist/dashboard/project-file-watch.js.map +1 -0
  211. package/dist/dashboard/project-live-stream.d.ts +33 -0
  212. package/dist/dashboard/project-live-stream.d.ts.map +1 -0
  213. package/dist/dashboard/project-live-stream.js +233 -0
  214. package/dist/dashboard/project-live-stream.js.map +1 -0
  215. package/dist/dashboard/project-policy-api.d.ts +37 -0
  216. package/dist/dashboard/project-policy-api.d.ts.map +1 -0
  217. package/dist/dashboard/project-policy-api.js +31 -0
  218. package/dist/dashboard/project-policy-api.js.map +1 -0
  219. package/dist/dashboard/project-session-api.d.ts +28 -0
  220. package/dist/dashboard/project-session-api.d.ts.map +1 -0
  221. package/dist/dashboard/project-session-api.js +84 -0
  222. package/dist/dashboard/project-session-api.js.map +1 -0
  223. package/dist/dashboard/project-source-api.d.ts +11 -0
  224. package/dist/dashboard/project-source-api.d.ts.map +1 -0
  225. package/dist/dashboard/project-source-api.js +67 -0
  226. package/dist/dashboard/project-source-api.js.map +1 -0
  227. package/dist/dashboard/project-workspace.d.ts.map +1 -1
  228. package/dist/dashboard/project-workspace.js +18 -0
  229. package/dist/dashboard/project-workspace.js.map +1 -1
  230. package/dist/dashboard/server.d.ts.map +1 -1
  231. package/dist/dashboard/server.js +64 -25
  232. package/dist/dashboard/server.js.map +1 -1
  233. package/dist/dashboard/v6-dashboard-html.d.ts +1 -1
  234. package/dist/dashboard/v6-dashboard-html.d.ts.map +1 -1
  235. package/dist/dashboard/v6-dashboard-html.js +4261 -4309
  236. package/dist/dashboard/v6-dashboard-html.js.map +1 -1
  237. package/dist/dashboard/workspace-api.d.ts.map +1 -1
  238. package/dist/dashboard/workspace-api.js +105 -23
  239. package/dist/dashboard/workspace-api.js.map +1 -1
  240. package/dist/dashboard/workspace-status.d.ts +3 -0
  241. package/dist/dashboard/workspace-status.d.ts.map +1 -1
  242. package/dist/dashboard/workspace-status.js +4 -3
  243. package/dist/dashboard/workspace-status.js.map +1 -1
  244. package/dist/project-cli.js +1 -1
  245. package/dist/project-cli.js.map +1 -1
  246. package/docs/BRAND_ASSETS.md +36 -0
  247. package/docs/FEATURES_AND_LIMITS.md +29 -24
  248. package/docs/INTEGRATIONS.md +4 -2
  249. package/docs/LEARNING.md +1 -1
  250. package/docs/PROJECT_KIT.md +6 -1
  251. package/docs/QUICKSTART.md +62 -44
  252. package/docs/README.md +36 -33
  253. package/docs/SESSIONS.md +77 -0
  254. package/docs/SOURCE_INTAKE.md +33 -0
  255. package/docs/STATS.md +21 -21
  256. package/docs/VISUAL_GUIDE_v7.22.0.md +73 -0
  257. package/docs/WORKFLOW_INTEGRATION.md +3 -1
  258. package/docs/WORKSPACE.md +63 -37
  259. package/docs/assets/7.22.0-agent-dock-mobile.png +0 -0
  260. package/docs/assets/7.22.0-agent-dock.gif +0 -0
  261. package/docs/assets/7.22.0-agent-dock.png +0 -0
  262. package/docs/assets/7.22.0-hub-exchange.png +0 -0
  263. package/docs/assets/7.22.0-hub-exchanges.gif +0 -0
  264. package/docs/assets/7.22.0-hub-graph.png +0 -0
  265. package/docs/assets/7.22.0-hub-mobile-empty.png +0 -0
  266. package/docs/assets/7.22.0-managed-skills.png +0 -0
  267. package/docs/assets/7.22.0-plain-evidence.png +0 -0
  268. package/docs/assets/7.22.0-project-controls.png +0 -0
  269. package/docs/assets/7.22.0-sessions.png +0 -0
  270. package/docs/assets/7.22.0-teach-brain.png +0 -0
  271. package/docs/launch/RELEASE_ACCEPTANCE_v7.22.0.md +48 -0
  272. package/docs/launch/RELEASE_NOTES_v7.22.0.md +53 -0
  273. package/docs/launch/RESEARCH_AND_PLAN_v7.22.0.md +672 -0
  274. package/package.json +135 -130
  275. package/skills/shadow-workflow/SKILL.md +2 -0
@@ -0,0 +1,267 @@
1
+ import * as fs from 'node:fs';
2
+ import { createHash, randomUUID } from 'node:crypto';
3
+ import { join } from 'node:path';
4
+ import { setTimeout as delay } from 'node:timers/promises';
5
+ import { z } from 'zod';
6
+ import { ensureProjectDirectory, projectLocalPath } from './project-kit-paths.js';
7
+ import { matchesFileIdentity } from './file-identity.js';
8
+ const filename = '.shadow-brain/project-policy.json';
9
+ const lockKind = 'project-policy-lock';
10
+ const lockOwner = z.strictObject({ kind: z.literal(lockKind), pid: z.number().int().min(1).max(0x7fffffff) });
11
+ const maximumBytes = 128 * 1024;
12
+ const maximumOverrides = 512;
13
+ export const PROJECT_CONTEXT_LIMITS = Object.freeze({ maxTokens: 12000, maxEntries: 30 });
14
+ const context = z.strictObject({ maxTokens: z.number().int().min(200).max(PROJECT_CONTEXT_LIMITS.maxTokens),
15
+ maxEntries: z.number().int().min(1).max(PROJECT_CONTEXT_LIMITS.maxEntries) });
16
+ const label = z.string().regex(/^[a-z0-9][a-z0-9_. -]{0,63}$/u).refine(value => value.trim() === value);
17
+ const id = z.string().uuid();
18
+ const role = z.enum(['lead', 'worker', 'observer']);
19
+ const revision = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER - 1);
20
+ const key = z.string().regex(/^(?:session|source|native):[0-9a-f-]{36,64}$/u);
21
+ const policy = z.strictObject({
22
+ schemaVersion: z.literal(1), projectId: z.string().regex(/^[a-f0-9]{16}$/u), revision,
23
+ updatedAt: z.iso.datetime().nullable(), context,
24
+ tools: z.array(z.strictObject({ tool: label, enabled: z.boolean() })).max(maximumOverrides),
25
+ chats: z.array(z.strictObject({ key, shareContext: z.boolean() })).max(maximumOverrides),
26
+ roles: z.array(z.strictObject({ sessionId: id, role })).max(maximumOverrides),
27
+ });
28
+ const base = { expectedRevision: revision };
29
+ export const projectPolicyCommand = z.discriminatedUnion('kind', [
30
+ z.strictObject({ ...base, kind: z.literal('set-context-limits'), context }),
31
+ z.strictObject({ ...base, kind: z.literal('set-tool-participation'), tool: label, enabled: z.boolean() }),
32
+ z.strictObject({ ...base, kind: z.literal('set-chat-sharing'), sessionId: id, shareContext: z.boolean() }),
33
+ z.strictObject({ ...base, kind: z.literal('set-session-role'), sessionId: id, role: role.nullable() }),
34
+ ]);
35
+ export class ProjectPolicyError extends Error {
36
+ constructor(code, message, status) {
37
+ super(message);
38
+ this.code = code;
39
+ this.status = status;
40
+ }
41
+ }
42
+ const unavailable = () => new ProjectPolicyError('PROJECT_POLICY_UNAVAILABLE', 'Project controls are unreadable. Check the project policy file before continuing.', 503);
43
+ const conflict = () => new ProjectPolicyError('PROJECT_POLICY_CONFLICT', 'Project controls changed. Reload them and retry.', 409);
44
+ const duplicate = (items, identity) => new Set(items.map(identity)).size !== items.length;
45
+ function reclaimAbandonedLock(filename) {
46
+ let fd;
47
+ try {
48
+ const before = fs.lstatSync(filename, { bigint: true, throwIfNoEntry: false });
49
+ if (!before?.isFile() || before.nlink !== 1n || before.size === 0n || before.size > 128n)
50
+ return false;
51
+ fd = fs.openSync(filename, fs.constants.O_RDONLY | (fs.constants.O_NOFOLLOW ?? 0));
52
+ const owner = fs.fstatSync(fd, { bigint: true });
53
+ if (!matchesFileIdentity(filename, owner, before))
54
+ return false;
55
+ const bytes = Buffer.alloc(129);
56
+ const count = fs.readSync(fd, bytes, 0, bytes.length, 0);
57
+ if (BigInt(count) !== owner.size || count > 128)
58
+ return false;
59
+ const info = lockOwner.safeParse(JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes.subarray(0, count))));
60
+ if (!info.success)
61
+ return false;
62
+ try {
63
+ process.kill(info.data.pid, 0);
64
+ return false;
65
+ }
66
+ catch (error) {
67
+ if (error.code !== 'ESRCH')
68
+ return false;
69
+ }
70
+ fs.closeSync(fd);
71
+ fd = undefined;
72
+ const current = fs.lstatSync(filename, { bigint: true, throwIfNoEntry: false });
73
+ if (!matchesFileIdentity(filename, owner, current) || current?.mtimeNs !== owner.mtimeNs || current?.size !== owner.size)
74
+ return false;
75
+ fs.unlinkSync(filename);
76
+ return true;
77
+ }
78
+ catch {
79
+ return false;
80
+ }
81
+ finally {
82
+ if (fd !== undefined)
83
+ fs.closeSync(fd);
84
+ }
85
+ }
86
+ export const toolPolicyLabel = (tool) => tool.toLowerCase().trim();
87
+ export function toolParticipates(snapshot, tool) {
88
+ return snapshot.tools.find(item => item.tool === toolPolicyLabel(tool))?.enabled !== false;
89
+ }
90
+ export function nativeChatKey(tool, sessionId) {
91
+ return 'native:' + createHash('sha256').update(JSON.stringify([toolPolicyLabel(tool), sessionId])).digest('hex');
92
+ }
93
+ export function projectChatKey(session) {
94
+ if (session.native)
95
+ return nativeChatKey(session.native.tool, session.native.sessionId);
96
+ if (session.sourceId)
97
+ return 'source:' + session.sourceId;
98
+ return 'session:' + session.id;
99
+ }
100
+ export function disabledChatKeys(snapshot) {
101
+ return new Set(snapshot.chats.filter(item => !item.shareContext).map(item => item.key));
102
+ }
103
+ export function hiddenChatSessions(snapshot, sessions) {
104
+ const keys = disabledChatKeys(snapshot);
105
+ if (!keys.size)
106
+ return new Set();
107
+ const hidden = new Set(sessions.filter(item => keys.has(projectChatKey(item))).map(item => item.id));
108
+ // A resumed child includes an ancestor checkpoint. Worker links without a handoff do not copy text.
109
+ for (let changed = true; changed;) {
110
+ changed = false;
111
+ for (const item of sessions)
112
+ if (item.resumedFrom && hidden.has(item.resumedFrom.sessionId) && !hidden.has(item.id)) {
113
+ hidden.add(item.id);
114
+ changed = true;
115
+ }
116
+ }
117
+ return hidden;
118
+ }
119
+ export class ProjectPolicyStore {
120
+ constructor(root, projectId) {
121
+ this.root = root;
122
+ this.projectId = projectId;
123
+ }
124
+ get() {
125
+ try {
126
+ const file = projectLocalPath(this.root, filename);
127
+ const info = fs.lstatSync(file, { bigint: true, throwIfNoEntry: false });
128
+ if (!info)
129
+ return { schemaVersion: 1, projectId: this.projectId, revision: 0, updatedAt: null,
130
+ context: { ...PROJECT_CONTEXT_LIMITS }, tools: [], chats: [], roles: [] };
131
+ if (!info.isFile() || info.nlink !== 1n || info.size > maximumBytes)
132
+ throw unavailable();
133
+ const fd = fs.openSync(file, fs.constants.O_RDONLY | (fs.constants.O_NOFOLLOW ?? 0));
134
+ let content;
135
+ try {
136
+ const opened = fs.fstatSync(fd, { bigint: true });
137
+ const latest = fs.lstatSync(file, { bigint: true, throwIfNoEntry: false });
138
+ if (!opened.isFile() || opened.nlink !== 1n || opened.size > maximumBytes ||
139
+ !matchesFileIdentity(file, opened, latest) || !matchesFileIdentity(file, info, latest))
140
+ throw unavailable();
141
+ const expected = Number(opened.size);
142
+ const buffer = Buffer.alloc(expected + 1);
143
+ let length = 0;
144
+ while (length < buffer.length) {
145
+ const read = fs.readSync(fd, buffer, length, buffer.length - length, length);
146
+ if (!read)
147
+ break;
148
+ length += read;
149
+ }
150
+ if (length !== expected)
151
+ throw unavailable();
152
+ content = buffer.subarray(0, expected);
153
+ }
154
+ finally {
155
+ fs.closeSync(fd);
156
+ }
157
+ const data = policy.parse(JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(content)));
158
+ if (data.projectId !== this.projectId || data.revision < 1 || !data.updatedAt ||
159
+ duplicate(data.tools, item => item.tool) || duplicate(data.chats, item => item.key) ||
160
+ duplicate(data.roles, item => item.sessionId))
161
+ throw unavailable();
162
+ return data;
163
+ }
164
+ catch (error) {
165
+ if (error instanceof ProjectPolicyError)
166
+ throw error;
167
+ throw unavailable();
168
+ }
169
+ }
170
+ async update(input, session) {
171
+ const parsed = projectPolicyCommand.safeParse(input);
172
+ if (!parsed.success)
173
+ throw new ProjectPolicyError('PROJECT_POLICY_INVALID', 'Send a valid project control change and current revision.', 400);
174
+ const command = parsed.data;
175
+ if ('sessionId' in command && session?.id !== command.sessionId) {
176
+ throw new ProjectPolicyError('PROJECT_POLICY_SESSION_NOT_FOUND', 'Select a known project session.', 404);
177
+ }
178
+ const parent = ensureProjectDirectory(this.root, '.shadow-brain');
179
+ const filename = projectLocalPath(this.root, '.shadow-brain/project-policy.json');
180
+ const lock = projectLocalPath(this.root, '.shadow-brain/project-policy.lock');
181
+ const deadline = performance.now() + 1200;
182
+ let fd;
183
+ for (;;) {
184
+ try {
185
+ fd = fs.openSync(lock, 'wx', 0o600);
186
+ break;
187
+ }
188
+ catch (error) {
189
+ if (error.code !== 'EEXIST')
190
+ throw unavailable();
191
+ if (performance.now() >= deadline)
192
+ throw conflict();
193
+ if (reclaimAbandonedLock(lock))
194
+ continue;
195
+ await delay(20);
196
+ }
197
+ }
198
+ let owner;
199
+ let temporary;
200
+ try {
201
+ owner = fs.fstatSync(fd, { bigint: true });
202
+ fs.writeFileSync(fd, JSON.stringify({ kind: lockKind, pid: process.pid }));
203
+ fs.fsyncSync(fd);
204
+ const current = this.get();
205
+ if (command.expectedRevision !== current.revision)
206
+ throw conflict();
207
+ let next = { ...current };
208
+ if (command.kind === 'set-context-limits')
209
+ next.context = command.context;
210
+ else if (command.kind === 'set-tool-participation')
211
+ next.tools = [
212
+ ...current.tools.filter(item => item.tool !== command.tool), ...(!command.enabled ? [{ tool: command.tool, enabled: false }] : []),
213
+ ].sort((a, b) => a.tool.localeCompare(b.tool));
214
+ else if (command.kind === 'set-chat-sharing') {
215
+ const key = projectChatKey(session);
216
+ next.chats = [...current.chats.filter(item => item.key !== key), ...(!command.shareContext ? [{ key, shareContext: false }] : [])]
217
+ .sort((a, b) => a.key.localeCompare(b.key));
218
+ }
219
+ else
220
+ next.roles = [...current.roles.filter(item => item.sessionId !== command.sessionId),
221
+ ...(command.role ? [{ sessionId: command.sessionId, role: command.role }] : [])].sort((a, b) => a.sessionId.localeCompare(b.sessionId));
222
+ if (JSON.stringify(next) === JSON.stringify(current))
223
+ return current;
224
+ if (current.revision >= Number.MAX_SAFE_INTEGER - 1)
225
+ throw conflict();
226
+ const result = policy.safeParse({ ...next, revision: current.revision + 1, updatedAt: new Date().toISOString() });
227
+ if (!result.success)
228
+ throw new ProjectPolicyError('PROJECT_POLICY_LIMIT', 'This project reached its control limit.', 422);
229
+ next = result.data;
230
+ const payload = JSON.stringify(next);
231
+ if (Buffer.byteLength(payload) + 1 > maximumBytes)
232
+ throw new ProjectPolicyError('PROJECT_POLICY_LIMIT', 'This project reached its control limit.', 422);
233
+ temporary = join(parent, 'project-policy.' + randomUUID() + '.tmp');
234
+ const output = fs.openSync(temporary, 'wx', 0o600);
235
+ try {
236
+ fs.writeFileSync(output, payload + '\n');
237
+ fs.fsyncSync(output);
238
+ }
239
+ finally {
240
+ fs.closeSync(output);
241
+ }
242
+ fs.renameSync(temporary, filename);
243
+ temporary = undefined;
244
+ return next;
245
+ }
246
+ catch (error) {
247
+ if (error instanceof ProjectPolicyError)
248
+ throw error;
249
+ throw unavailable();
250
+ }
251
+ finally {
252
+ try {
253
+ if (temporary)
254
+ fs.unlinkSync(temporary);
255
+ }
256
+ catch { /* Preserve the transaction failure. */ }
257
+ fs.closeSync(fd);
258
+ try {
259
+ const latest = fs.lstatSync(lock, { bigint: true, throwIfNoEntry: false });
260
+ if (owner && matchesFileIdentity(lock, owner, latest))
261
+ fs.unlinkSync(lock);
262
+ }
263
+ catch { /* Never remove a replacement lock. */ }
264
+ }
265
+ }
266
+ }
267
+ //# sourceMappingURL=project-policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-policy.js","sourceRoot":"","sources":["../../src/brain/project-policy.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,180 @@
1
+ import { z } from 'zod';
2
+ import type { NativeSessionSnapshot } from './native-session-import.js';
3
+ export declare const SESSION_LIMITS: Readonly<{
4
+ sessions: 150;
5
+ messages: 200;
6
+ page: 25;
7
+ messagePageBytes: number;
8
+ checkpoints: 40;
9
+ operations: 20000;
10
+ recentMs: number;
11
+ }>;
12
+ export declare const sessionOperationKey: z.ZodString;
13
+ declare const status: z.ZodEnum<{
14
+ completed: "completed";
15
+ working: "working";
16
+ waiting: "waiting";
17
+ }>;
18
+ declare const role: z.ZodEnum<{
19
+ user: "user";
20
+ note: "note";
21
+ assistant: "assistant";
22
+ }>;
23
+ export declare const openSessionInput: z.ZodObject<{
24
+ hostSessionId: z.ZodOptional<z.ZodString>;
25
+ parentSessionId: z.ZodOptional<z.ZodString>;
26
+ key: z.ZodString;
27
+ title: z.ZodString;
28
+ goal: z.ZodString;
29
+ }, z.core.$strict>;
30
+ export declare const sessionMessageWindow: z.ZodObject<{
31
+ before: z.ZodOptional<z.ZodString>;
32
+ limit: z.ZodDefault<z.ZodNumber>;
33
+ }, z.core.$strict>;
34
+ export declare const recordSessionInput: z.ZodDiscriminatedUnion<[z.ZodObject<{
35
+ kind: z.ZodLiteral<"status">;
36
+ key: z.ZodString;
37
+ status: z.ZodEnum<{
38
+ completed: "completed";
39
+ working: "working";
40
+ waiting: "waiting";
41
+ }>;
42
+ expectedRevision: z.ZodOptional<z.ZodNumber>;
43
+ }, z.core.$strict>, z.ZodObject<{
44
+ kind: z.ZodLiteral<"message">;
45
+ key: z.ZodString;
46
+ role: z.ZodEnum<{
47
+ user: "user";
48
+ note: "note";
49
+ assistant: "assistant";
50
+ }>;
51
+ text: z.ZodString;
52
+ expectedRevision: z.ZodOptional<z.ZodNumber>;
53
+ }, z.core.$strict>, z.ZodObject<{
54
+ kind: z.ZodLiteral<"checkpoint">;
55
+ key: z.ZodString;
56
+ summary: z.ZodString;
57
+ decisions: z.ZodDefault<z.ZodArray<z.ZodString>>;
58
+ completed: z.ZodDefault<z.ZodArray<z.ZodString>>;
59
+ nextSteps: z.ZodDefault<z.ZodArray<z.ZodString>>;
60
+ evidence: z.ZodDefault<z.ZodArray<z.ZodString>>;
61
+ expectedRevision: z.ZodOptional<z.ZodNumber>;
62
+ }, z.core.$strict>], "kind">;
63
+ export declare const resumeSessionFields: {
64
+ hostSessionId: z.ZodOptional<z.ZodString>;
65
+ parentSessionId: z.ZodOptional<z.ZodString>;
66
+ key: z.ZodString;
67
+ checkpointId: z.ZodString;
68
+ sha256: z.ZodString;
69
+ title: z.ZodOptional<z.ZodString>;
70
+ };
71
+ export declare const resumeSessionInput: z.ZodObject<{
72
+ hostSessionId: z.ZodOptional<z.ZodString>;
73
+ parentSessionId: z.ZodOptional<z.ZodString>;
74
+ key: z.ZodString;
75
+ checkpointId: z.ZodString;
76
+ sha256: z.ZodString;
77
+ title: z.ZodOptional<z.ZodString>;
78
+ }, z.core.$strict>;
79
+ export declare const importSessionInput: z.ZodObject<{
80
+ key: z.ZodString;
81
+ sourceId: z.ZodString;
82
+ title: z.ZodOptional<z.ZodString>;
83
+ goal: z.ZodOptional<z.ZodString>;
84
+ }, z.core.$strict>;
85
+ export declare const transcriptInput: z.ZodObject<{
86
+ id: z.ZodString;
87
+ name: z.ZodString;
88
+ items: z.ZodArray<z.ZodObject<{
89
+ id: z.ZodString;
90
+ locator: z.ZodString;
91
+ role: z.ZodEnum<{
92
+ user: "user";
93
+ note: "note";
94
+ assistant: "assistant";
95
+ }>;
96
+ originalRole: z.ZodString;
97
+ text: z.ZodString;
98
+ }, z.core.$strict>>;
99
+ }, z.core.$strict>;
100
+ export declare const sessionActorInput: z.ZodObject<{
101
+ id: z.ZodString;
102
+ kind: z.ZodEnum<{
103
+ agent: "agent";
104
+ user: "user";
105
+ }>;
106
+ tool: z.ZodString;
107
+ }, z.core.$strict>;
108
+ export declare const SESSION_OPERATOR: Readonly<{
109
+ readonly id: "Operator";
110
+ readonly kind: "user";
111
+ readonly tool: "portal";
112
+ }>;
113
+ export declare class ProjectSessionError extends Error {
114
+ readonly code: string;
115
+ readonly status: number;
116
+ constructor(code: string, message: string, status: number);
117
+ }
118
+ export declare function sessionInput<T>(schema: z.ZodType<T>, raw: unknown): T;
119
+ export type SessionActor = z.infer<typeof sessionActorInput>;
120
+ export interface SessionRecord {
121
+ id: string;
122
+ title: string;
123
+ goal: string;
124
+ actor: SessionActor;
125
+ hostSessionId: string | null;
126
+ reportedStatus: z.infer<typeof status>;
127
+ statusReportedBy: SessionActor;
128
+ createdAt: string;
129
+ updatedAt: string;
130
+ lastReportedAt: string;
131
+ revision: number;
132
+ parentSessionId: string | null;
133
+ resumedFrom: {
134
+ sessionId: string;
135
+ checkpointId: string;
136
+ } | null;
137
+ latestCheckpointId: string | null;
138
+ sourceId: string | null;
139
+ native?: Omit<NativeSessionSnapshot, 'messages'> & {
140
+ previousSnapshotId: string | null;
141
+ };
142
+ }
143
+ export interface SessionMessage {
144
+ id: string;
145
+ role: z.infer<typeof role>;
146
+ actor: SessionActor;
147
+ text: string;
148
+ createdAt: string;
149
+ source?: {
150
+ sourceId: string;
151
+ itemId: string;
152
+ locator: string;
153
+ originalRole: string;
154
+ };
155
+ native?: {
156
+ id: string;
157
+ locator: string;
158
+ sha256: string;
159
+ createdAt: string | null;
160
+ };
161
+ }
162
+ export interface SessionCheckpoint {
163
+ id: string;
164
+ sessionId: string;
165
+ revision: number;
166
+ actor: SessionActor;
167
+ summary: string;
168
+ decisions: string[];
169
+ completed: string[];
170
+ nextSteps: string[];
171
+ evidence: string[];
172
+ createdAt: string;
173
+ sha256: string;
174
+ }
175
+ export type SessionPresence = 'recent' | 'stale' | 'completed';
176
+ export type SessionSummary = SessionRecord & {
177
+ presence: SessionPresence;
178
+ };
179
+ export {};
180
+ //# sourceMappingURL=project-session-contract.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-session-contract.d.ts","sourceRoot":"","sources":["../../src/brain/project-session-contract.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ import { z } from 'zod';
2
+ import { hubId } from './project-hub-contract.js';
3
+ export const SESSION_LIMITS = Object.freeze({ sessions: 150, messages: 200, page: 25, messagePageBytes: 32 * 1024, checkpoints: 40, operations: 20000, recentMs: 5 * 60000 });
4
+ const controls = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/u;
5
+ const text = (maximum) => z.string().trim().min(1).max(maximum).refine(value => !controls.test(value), 'Use ordinary text.');
6
+ const label = (maximum) => text(maximum).refine(value => !/[\r\n\t]/u.test(value), 'Use a single line.');
7
+ const key = z.string().regex(/^[A-Za-z0-9_-]{12,100}$/u);
8
+ export const sessionOperationKey = key;
9
+ const digest = z.string().regex(/^[0-9a-f]{64}$/u);
10
+ const title = label(160);
11
+ const goal = text(1200);
12
+ const hostSessionId = label(128);
13
+ const sessionOptions = { hostSessionId: hostSessionId.optional(), parentSessionId: hubId.optional() };
14
+ const expectedRevision = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER).optional();
15
+ const status = z.enum(['working', 'waiting', 'completed']);
16
+ const role = z.enum(['user', 'assistant', 'note']);
17
+ const messageText = z.string().min(1).max(8000).refine(value => value.trim().length > 0 && !controls.test(value), 'Use ordinary text.');
18
+ export const openSessionInput = z.strictObject({ key, title, goal, ...sessionOptions });
19
+ export const sessionMessageWindow = z.strictObject({ before: hubId.optional(), limit: z.number().int().min(1).max(SESSION_LIMITS.page).default(SESSION_LIMITS.page) });
20
+ export const recordSessionInput = z.discriminatedUnion('kind', [
21
+ z.strictObject({ kind: z.literal('status'), key, status, expectedRevision }),
22
+ z.strictObject({ kind: z.literal('message'), key, role, text: messageText, expectedRevision }),
23
+ z.strictObject({ kind: z.literal('checkpoint'), key, summary: text(4000), decisions: z.array(text(600)).max(8).default([]),
24
+ completed: z.array(text(600)).max(8).default([]), nextSteps: z.array(text(600)).max(8).default([]),
25
+ evidence: z.array(label(240)).max(8).default([]), expectedRevision }).refine(value => Buffer.byteLength(JSON.stringify(value)) <= 16 * 1024, 'Keep the checkpoint within 16 KiB.'),
26
+ ]);
27
+ export const resumeSessionFields = { key, checkpointId: hubId, sha256: digest, title: title.optional(), ...sessionOptions };
28
+ export const resumeSessionInput = z.strictObject(resumeSessionFields);
29
+ export const importSessionInput = z.strictObject({ key, sourceId: hubId, title: title.optional(), goal: goal.optional() });
30
+ export const transcriptInput = z.strictObject({ id: hubId, name: label(240), items: z.array(z.strictObject({
31
+ id: label(240), locator: label(240), role, originalRole: label(40), text: messageText,
32
+ })).min(1).max(SESSION_LIMITS.messages) });
33
+ export const sessionActorInput = z.strictObject({ id: label(160), kind: z.enum(['user', 'agent']), tool: label(64) });
34
+ export const SESSION_OPERATOR = Object.freeze({ id: 'Operator', kind: 'user', tool: 'portal' });
35
+ export class ProjectSessionError extends Error {
36
+ constructor(code, message, status) {
37
+ super(message);
38
+ this.code = code;
39
+ this.status = status;
40
+ this.name = 'ProjectSessionError';
41
+ }
42
+ }
43
+ export function sessionInput(schema, raw) {
44
+ const parsed = schema.safeParse(raw);
45
+ if (parsed.success)
46
+ return parsed.data;
47
+ const path = parsed.error.issues[0].path.join('.');
48
+ throw new ProjectSessionError('SESSION_INVALID_INPUT', path ? 'Check the ' + path + ' field.' : 'Send a valid project session request.', 400);
49
+ }
50
+ //# sourceMappingURL=project-session-contract.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-session-contract.js","sourceRoot":"","sources":["../../src/brain/project-session-contract.ts"],"names":[],"mappings":"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"}