@lumenflow/kernel 3.0.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 (127) hide show
  1. package/LICENSE.md +190 -0
  2. package/README.md +26 -0
  3. package/dist/canonical-json.d.ts +7 -0
  4. package/dist/canonical-json.d.ts.map +1 -0
  5. package/dist/canonical-json.js +50 -0
  6. package/dist/canonical-json.js.map +1 -0
  7. package/dist/event-kinds.d.ts +32 -0
  8. package/dist/event-kinds.d.ts.map +1 -0
  9. package/dist/event-kinds.js +49 -0
  10. package/dist/event-kinds.js.map +1 -0
  11. package/dist/event-store/index.d.ts +64 -0
  12. package/dist/event-store/index.d.ts.map +1 -0
  13. package/dist/event-store/index.js +634 -0
  14. package/dist/event-store/index.js.map +1 -0
  15. package/dist/evidence/evidence-store.d.ts +78 -0
  16. package/dist/evidence/evidence-store.d.ts.map +1 -0
  17. package/dist/evidence/evidence-store.js +409 -0
  18. package/dist/evidence/evidence-store.js.map +1 -0
  19. package/dist/evidence/fs-helpers.d.ts +13 -0
  20. package/dist/evidence/fs-helpers.d.ts.map +1 -0
  21. package/dist/evidence/fs-helpers.js +38 -0
  22. package/dist/evidence/fs-helpers.js.map +1 -0
  23. package/dist/evidence/index.d.ts +3 -0
  24. package/dist/evidence/index.d.ts.map +1 -0
  25. package/dist/evidence/index.js +5 -0
  26. package/dist/evidence/index.js.map +1 -0
  27. package/dist/index.d.ts +17 -0
  28. package/dist/index.d.ts.map +1 -0
  29. package/dist/index.js +19 -0
  30. package/dist/index.js.map +1 -0
  31. package/dist/kernel.schemas.d.ts +642 -0
  32. package/dist/kernel.schemas.d.ts.map +1 -0
  33. package/dist/kernel.schemas.js +331 -0
  34. package/dist/kernel.schemas.js.map +1 -0
  35. package/dist/pack/hash.d.ts +7 -0
  36. package/dist/pack/hash.d.ts.map +1 -0
  37. package/dist/pack/hash.js +56 -0
  38. package/dist/pack/hash.js.map +1 -0
  39. package/dist/pack/index.d.ts +4 -0
  40. package/dist/pack/index.d.ts.map +1 -0
  41. package/dist/pack/index.js +6 -0
  42. package/dist/pack/index.js.map +1 -0
  43. package/dist/pack/manifest.d.ts +100 -0
  44. package/dist/pack/manifest.d.ts.map +1 -0
  45. package/dist/pack/manifest.js +50 -0
  46. package/dist/pack/manifest.js.map +1 -0
  47. package/dist/pack/pack-loader.d.ts +108 -0
  48. package/dist/pack/pack-loader.d.ts.map +1 -0
  49. package/dist/pack/pack-loader.js +282 -0
  50. package/dist/pack/pack-loader.js.map +1 -0
  51. package/dist/policy/approval-event.d.ts +29 -0
  52. package/dist/policy/approval-event.d.ts.map +1 -0
  53. package/dist/policy/approval-event.js +17 -0
  54. package/dist/policy/approval-event.js.map +1 -0
  55. package/dist/policy/index.d.ts +3 -0
  56. package/dist/policy/index.d.ts.map +1 -0
  57. package/dist/policy/index.js +5 -0
  58. package/dist/policy/index.js.map +1 -0
  59. package/dist/policy/policy-engine.d.ts +52 -0
  60. package/dist/policy/policy-engine.d.ts.map +1 -0
  61. package/dist/policy/policy-engine.js +83 -0
  62. package/dist/policy/policy-engine.js.map +1 -0
  63. package/dist/runtime/index.d.ts +2 -0
  64. package/dist/runtime/index.d.ts.map +1 -0
  65. package/dist/runtime/index.js +4 -0
  66. package/dist/runtime/index.js.map +1 -0
  67. package/dist/runtime/kernel-runtime.d.ts +170 -0
  68. package/dist/runtime/kernel-runtime.d.ts.map +1 -0
  69. package/dist/runtime/kernel-runtime.js +751 -0
  70. package/dist/runtime/kernel-runtime.js.map +1 -0
  71. package/dist/sandbox/bwrap-invocation.d.ts +13 -0
  72. package/dist/sandbox/bwrap-invocation.d.ts.map +1 -0
  73. package/dist/sandbox/bwrap-invocation.js +105 -0
  74. package/dist/sandbox/bwrap-invocation.js.map +1 -0
  75. package/dist/sandbox/index.d.ts +5 -0
  76. package/dist/sandbox/index.d.ts.map +1 -0
  77. package/dist/sandbox/index.js +7 -0
  78. package/dist/sandbox/index.js.map +1 -0
  79. package/dist/sandbox/profile.d.ts +32 -0
  80. package/dist/sandbox/profile.d.ts.map +1 -0
  81. package/dist/sandbox/profile.js +101 -0
  82. package/dist/sandbox/profile.js.map +1 -0
  83. package/dist/sandbox/subprocess-dispatcher.d.ts +38 -0
  84. package/dist/sandbox/subprocess-dispatcher.d.ts.map +1 -0
  85. package/dist/sandbox/subprocess-dispatcher.js +145 -0
  86. package/dist/sandbox/subprocess-dispatcher.js.map +1 -0
  87. package/dist/sandbox/tool-runner-worker.d.ts +54 -0
  88. package/dist/sandbox/tool-runner-worker.d.ts.map +1 -0
  89. package/dist/sandbox/tool-runner-worker.js +159 -0
  90. package/dist/sandbox/tool-runner-worker.js.map +1 -0
  91. package/dist/shared-constants.d.ts +48 -0
  92. package/dist/shared-constants.d.ts.map +1 -0
  93. package/dist/shared-constants.js +49 -0
  94. package/dist/shared-constants.js.map +1 -0
  95. package/dist/state-machine/index.d.ts +30 -0
  96. package/dist/state-machine/index.d.ts.map +1 -0
  97. package/dist/state-machine/index.js +92 -0
  98. package/dist/state-machine/index.js.map +1 -0
  99. package/dist/tool-host/builtins/capabilities.d.ts +20 -0
  100. package/dist/tool-host/builtins/capabilities.d.ts.map +1 -0
  101. package/dist/tool-host/builtins/capabilities.js +211 -0
  102. package/dist/tool-host/builtins/capabilities.js.map +1 -0
  103. package/dist/tool-host/builtins/index.d.ts +2 -0
  104. package/dist/tool-host/builtins/index.d.ts.map +1 -0
  105. package/dist/tool-host/builtins/index.js +4 -0
  106. package/dist/tool-host/builtins/index.js.map +1 -0
  107. package/dist/tool-host/index.d.ts +5 -0
  108. package/dist/tool-host/index.d.ts.map +1 -0
  109. package/dist/tool-host/index.js +7 -0
  110. package/dist/tool-host/index.js.map +1 -0
  111. package/dist/tool-host/scope-intersection.d.ts +10 -0
  112. package/dist/tool-host/scope-intersection.d.ts.map +1 -0
  113. package/dist/tool-host/scope-intersection.js +188 -0
  114. package/dist/tool-host/scope-intersection.js.map +1 -0
  115. package/dist/tool-host/subprocess-dispatcher.d.ts +14 -0
  116. package/dist/tool-host/subprocess-dispatcher.d.ts.map +1 -0
  117. package/dist/tool-host/subprocess-dispatcher.js +14 -0
  118. package/dist/tool-host/subprocess-dispatcher.js.map +1 -0
  119. package/dist/tool-host/tool-host.d.ts +42 -0
  120. package/dist/tool-host/tool-host.d.ts.map +1 -0
  121. package/dist/tool-host/tool-host.js +395 -0
  122. package/dist/tool-host/tool-host.js.map +1 -0
  123. package/dist/tool-host/tool-registry.d.ts +9 -0
  124. package/dist/tool-host/tool-registry.d.ts.map +1 -0
  125. package/dist/tool-host/tool-registry.js +28 -0
  126. package/dist/tool-host/tool-registry.js.map +1 -0
  127. package/package.json +71 -0
@@ -0,0 +1,331 @@
1
+ // Copyright (c) 2026 Hellmai Ltd
2
+ // SPDX-License-Identifier: Apache-2.0
3
+ import { z } from 'zod';
4
+ import { KERNEL_EVENT_KINDS, TOOL_TRACE_KINDS } from './event-kinds.js';
5
+ import { SHA256_HEX_REGEX, SHA256_INTEGRITY_REGEX } from './shared-constants.js';
6
+ const ISO_DATETIME_SCHEMA = z.string().datetime();
7
+ const SEMVER_REGEX = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z-.]+)?(?:\+[0-9A-Za-z-.]+)?$/;
8
+ const SEMVER_MESSAGE = 'Expected semantic version';
9
+ export const RUN_STATUSES = {
10
+ PLANNED: 'planned',
11
+ EXECUTING: 'executing',
12
+ PAUSED: 'paused',
13
+ FAILED: 'failed',
14
+ SUCCEEDED: 'succeeded',
15
+ };
16
+ export const RUN_STATUS_VALUES = [
17
+ RUN_STATUSES.PLANNED,
18
+ RUN_STATUSES.EXECUTING,
19
+ RUN_STATUSES.PAUSED,
20
+ RUN_STATUSES.FAILED,
21
+ RUN_STATUSES.SUCCEEDED,
22
+ ];
23
+ export const TOOL_HANDLER_KINDS = {
24
+ IN_PROCESS: 'in-process',
25
+ SUBPROCESS: 'subprocess',
26
+ };
27
+ export const TOOL_HANDLER_KIND_VALUES = [
28
+ TOOL_HANDLER_KINDS.IN_PROCESS,
29
+ TOOL_HANDLER_KINDS.SUBPROCESS,
30
+ ];
31
+ export const TOOL_ERROR_CODES = {
32
+ TOOL_NOT_FOUND: 'TOOL_NOT_FOUND',
33
+ SCOPE_DENIED: 'SCOPE_DENIED',
34
+ POLICY_DENIED: 'POLICY_DENIED',
35
+ INVALID_INPUT: 'INVALID_INPUT',
36
+ INVALID_OUTPUT: 'INVALID_OUTPUT',
37
+ TOOL_EXECUTION_FAILED: 'TOOL_EXECUTION_FAILED',
38
+ };
39
+ export const ToolScopePathSchema = z.object({
40
+ type: z.literal('path'),
41
+ pattern: z.string().min(1),
42
+ access: z.enum(['read', 'write']),
43
+ });
44
+ export const ToolScopeNetworkSchema = z.object({
45
+ type: z.literal('network'),
46
+ posture: z.enum(['off', 'full']),
47
+ });
48
+ export const ToolScopeSchema = z.discriminatedUnion('type', [
49
+ ToolScopePathSchema,
50
+ ToolScopeNetworkSchema,
51
+ ]);
52
+ const AcceptanceSchema = z.union([
53
+ z.array(z.string().min(1)).min(1),
54
+ z.record(z.string().min(1), z.array(z.string().min(1)).min(1)),
55
+ ]);
56
+ export const TaskSpecSchema = z.object({
57
+ id: z.string().min(1),
58
+ workspace_id: z.string().min(1),
59
+ lane_id: z.string().min(1),
60
+ domain: z.string().min(1),
61
+ title: z.string().min(1),
62
+ description: z.string().min(1),
63
+ acceptance: AcceptanceSchema,
64
+ declared_scopes: z.array(ToolScopeSchema),
65
+ expected_artifacts: z.array(z.string().min(1)).optional(),
66
+ risk: z.enum(['low', 'medium', 'high', 'critical']),
67
+ blocks: z.array(z.string().min(1)).optional(),
68
+ blocked_by: z.array(z.string().min(1)).optional(),
69
+ extensions: z.record(z.string(), z.unknown()).optional(),
70
+ type: z.string().min(1),
71
+ priority: z.enum(['P0', 'P1', 'P2', 'P3']),
72
+ created: z.string().date(),
73
+ labels: z.array(z.string().min(1)).optional(),
74
+ });
75
+ export const RunSchema = z.object({
76
+ run_id: z.string().min(1),
77
+ task_id: z.string().min(1),
78
+ status: z.enum(RUN_STATUS_VALUES),
79
+ started_at: ISO_DATETIME_SCHEMA,
80
+ completed_at: ISO_DATETIME_SCHEMA.optional(),
81
+ by: z.string().min(1),
82
+ session_id: z.string().min(1),
83
+ });
84
+ export const TaskStateSchema = z.object({
85
+ task_id: z.string().min(1),
86
+ status: z.enum(['ready', 'active', 'blocked', 'waiting', 'done']),
87
+ claimed_at: ISO_DATETIME_SCHEMA.optional(),
88
+ claimed_by: z.string().min(1).optional(),
89
+ session_id: z.string().min(1).optional(),
90
+ blocked_reason: z.string().min(1).optional(),
91
+ completed_at: ISO_DATETIME_SCHEMA.optional(),
92
+ current_run: RunSchema.optional(),
93
+ run_count: z.number().int().nonnegative(),
94
+ domain_state: z.record(z.string(), z.unknown()).optional(),
95
+ });
96
+ export const PackPinSchema = z.object({
97
+ id: z.string().min(1),
98
+ version: z.string().regex(SEMVER_REGEX, SEMVER_MESSAGE),
99
+ integrity: z.union([
100
+ z.literal('dev'),
101
+ z.string().regex(SHA256_INTEGRITY_REGEX, 'Expected dev or sha256:<64-hex>'),
102
+ ]),
103
+ source: z.enum(['local', 'git', 'registry']),
104
+ url: z.string().url().optional(),
105
+ /** Registry base URL override. When omitted, uses PackLoader's defaultRegistryUrl. */
106
+ registry_url: z.string().url().optional(),
107
+ });
108
+ export const LaneSpecSchema = z.object({
109
+ id: z.string().min(1),
110
+ title: z.string().min(1),
111
+ allowed_scopes: z.array(ToolScopeSchema).default([]),
112
+ wip_limit: z.number().int().positive().optional(),
113
+ policy_overrides: z.record(z.string(), z.unknown()).optional(),
114
+ });
115
+ export const WorkspaceSpecSchema = z.object({
116
+ id: z.string().min(1),
117
+ name: z.string().min(1),
118
+ packs: z.array(PackPinSchema),
119
+ lanes: z.array(LaneSpecSchema),
120
+ policies: z.record(z.string(), z.unknown()).optional(),
121
+ security: z.object({
122
+ allowed_scopes: z.array(ToolScopeSchema),
123
+ network_default: z.enum(['off', 'full']),
124
+ deny_overlays: z.array(z.string().min(1)),
125
+ }),
126
+ memory_namespace: z.string().min(1),
127
+ event_namespace: z.string().min(1),
128
+ });
129
+ const KernelEventBaseSchema = z.object({
130
+ schema_version: z.literal(1),
131
+ timestamp: ISO_DATETIME_SCHEMA,
132
+ });
133
+ const TaskEventBaseSchema = KernelEventBaseSchema.extend({
134
+ task_id: z.string().min(1),
135
+ });
136
+ const RunEventBaseSchema = TaskEventBaseSchema.extend({
137
+ run_id: z.string().min(1),
138
+ });
139
+ const TaskCreatedEventSchema = TaskEventBaseSchema.extend({
140
+ kind: z.literal(KERNEL_EVENT_KINDS.TASK_CREATED),
141
+ spec_hash: z.string().regex(SHA256_HEX_REGEX),
142
+ });
143
+ const TaskClaimedEventSchema = TaskEventBaseSchema.extend({
144
+ kind: z.literal(KERNEL_EVENT_KINDS.TASK_CLAIMED),
145
+ by: z.string().min(1),
146
+ session_id: z.string().min(1),
147
+ domain_data: z.record(z.string(), z.unknown()).optional(),
148
+ });
149
+ const TaskBlockedEventSchema = TaskEventBaseSchema.extend({
150
+ kind: z.literal(KERNEL_EVENT_KINDS.TASK_BLOCKED),
151
+ reason: z.string().min(1),
152
+ });
153
+ const TaskUnblockedEventSchema = TaskEventBaseSchema.extend({
154
+ kind: z.literal(KERNEL_EVENT_KINDS.TASK_UNBLOCKED),
155
+ });
156
+ const TaskWaitingEventSchema = TaskEventBaseSchema.extend({
157
+ kind: z.literal(KERNEL_EVENT_KINDS.TASK_WAITING),
158
+ reason: z.string().min(1),
159
+ wait_for: z.string().min(1).optional(),
160
+ });
161
+ const TaskResumedEventSchema = TaskEventBaseSchema.extend({
162
+ kind: z.literal(KERNEL_EVENT_KINDS.TASK_RESUMED),
163
+ });
164
+ const TaskCompletedEventSchema = TaskEventBaseSchema.extend({
165
+ kind: z.literal(KERNEL_EVENT_KINDS.TASK_COMPLETED),
166
+ evidence_refs: z.array(z.string().min(1)).optional(),
167
+ });
168
+ const TaskReleasedEventSchema = TaskEventBaseSchema.extend({
169
+ kind: z.literal(KERNEL_EVENT_KINDS.TASK_RELEASED),
170
+ reason: z.string().min(1),
171
+ });
172
+ const TaskDelegatedEventSchema = TaskEventBaseSchema.extend({
173
+ kind: z.literal(KERNEL_EVENT_KINDS.TASK_DELEGATED),
174
+ parent_task_id: z.string().min(1),
175
+ delegation_id: z.string().min(1),
176
+ });
177
+ const RunStartedEventSchema = RunEventBaseSchema.extend({
178
+ kind: z.literal(KERNEL_EVENT_KINDS.RUN_STARTED),
179
+ by: z.string().min(1),
180
+ session_id: z.string().min(1),
181
+ });
182
+ const RunPausedEventSchema = RunEventBaseSchema.extend({
183
+ kind: z.literal(KERNEL_EVENT_KINDS.RUN_PAUSED),
184
+ reason: z.string().min(1),
185
+ });
186
+ const RunFailedEventSchema = RunEventBaseSchema.extend({
187
+ kind: z.literal(KERNEL_EVENT_KINDS.RUN_FAILED),
188
+ reason: z.string().min(1),
189
+ evidence_refs: z.array(z.string().min(1)).optional(),
190
+ });
191
+ const RunSucceededEventSchema = RunEventBaseSchema.extend({
192
+ kind: z.literal(KERNEL_EVENT_KINDS.RUN_SUCCEEDED),
193
+ evidence_refs: z.array(z.string().min(1)).optional(),
194
+ });
195
+ const WorkspaceUpdatedEventSchema = KernelEventBaseSchema.extend({
196
+ kind: z.literal(KERNEL_EVENT_KINDS.WORKSPACE_UPDATED),
197
+ config_hash: z.string().regex(SHA256_HEX_REGEX),
198
+ changes_summary: z.string().min(1),
199
+ });
200
+ const WorkspaceWarningEventSchema = KernelEventBaseSchema.extend({
201
+ kind: z.literal(KERNEL_EVENT_KINDS.WORKSPACE_WARNING),
202
+ message: z.string().min(1),
203
+ });
204
+ const SpecTamperedEventSchema = KernelEventBaseSchema.extend({
205
+ kind: z.literal(KERNEL_EVENT_KINDS.SPEC_TAMPERED),
206
+ spec: z.enum(['task', 'workspace']),
207
+ id: z.string().min(1),
208
+ expected_hash: z.string().regex(SHA256_HEX_REGEX),
209
+ actual_hash: z.string().regex(SHA256_HEX_REGEX),
210
+ });
211
+ const CheckpointEventSchema = TaskEventBaseSchema.extend({
212
+ kind: z.literal(KERNEL_EVENT_KINDS.CHECKPOINT),
213
+ run_id: z.string().min(1).optional(),
214
+ note: z.string().min(1),
215
+ progress: z.string().min(1).optional(),
216
+ });
217
+ export const KernelEventSchema = z.discriminatedUnion('kind', [
218
+ TaskCreatedEventSchema,
219
+ TaskClaimedEventSchema,
220
+ TaskBlockedEventSchema,
221
+ TaskUnblockedEventSchema,
222
+ TaskWaitingEventSchema,
223
+ TaskResumedEventSchema,
224
+ TaskCompletedEventSchema,
225
+ TaskReleasedEventSchema,
226
+ TaskDelegatedEventSchema,
227
+ RunStartedEventSchema,
228
+ RunPausedEventSchema,
229
+ RunFailedEventSchema,
230
+ RunSucceededEventSchema,
231
+ WorkspaceUpdatedEventSchema,
232
+ WorkspaceWarningEventSchema,
233
+ SpecTamperedEventSchema,
234
+ CheckpointEventSchema,
235
+ ]);
236
+ export const PolicyDecisionSchema = z.object({
237
+ policy_id: z.string().min(1),
238
+ decision: z.enum(['allow', 'deny']),
239
+ reason: z.string().min(1).optional(),
240
+ });
241
+ export const ToolCallStartedSchema = z.object({
242
+ schema_version: z.literal(1),
243
+ kind: z.literal(TOOL_TRACE_KINDS.TOOL_CALL_STARTED),
244
+ receipt_id: z.string().min(1),
245
+ run_id: z.string().min(1),
246
+ task_id: z.string().min(1),
247
+ session_id: z.string().min(1),
248
+ timestamp: ISO_DATETIME_SCHEMA,
249
+ tool_name: z.string().min(1),
250
+ execution_mode: z.enum(TOOL_HANDLER_KIND_VALUES),
251
+ scope_requested: z.array(ToolScopeSchema),
252
+ scope_allowed: z.array(ToolScopeSchema),
253
+ scope_enforced: z.array(ToolScopeSchema),
254
+ input_hash: z.string().regex(SHA256_HEX_REGEX),
255
+ input_ref: z.string().min(1),
256
+ tool_version: z.string().regex(SEMVER_REGEX, SEMVER_MESSAGE),
257
+ pack_id: z.string().min(1).optional(),
258
+ pack_version: z.string().regex(SEMVER_REGEX, SEMVER_MESSAGE).optional(),
259
+ pack_integrity: z.string().optional(),
260
+ workspace_config_hash: z.string().regex(SHA256_HEX_REGEX),
261
+ runtime_version: z.string().min(1),
262
+ });
263
+ export const ToolCallFinishedSchema = z.object({
264
+ schema_version: z.literal(1),
265
+ kind: z.literal(TOOL_TRACE_KINDS.TOOL_CALL_FINISHED),
266
+ receipt_id: z.string().min(1),
267
+ timestamp: ISO_DATETIME_SCHEMA,
268
+ result: z.enum(['success', 'failure', 'denied', 'crashed']),
269
+ duration_ms: z.number().int().nonnegative(),
270
+ output_hash: z.string().regex(SHA256_HEX_REGEX).optional(),
271
+ output_ref: z.string().min(1).optional(),
272
+ redaction_summary: z.string().min(1).optional(),
273
+ scope_enforcement_note: z.string().min(1).optional(),
274
+ policy_decisions: z.array(PolicyDecisionSchema),
275
+ artifacts_written: z.array(z.string().min(1)).optional(),
276
+ });
277
+ export const ToolTraceEntrySchema = z.discriminatedUnion('kind', [
278
+ ToolCallStartedSchema,
279
+ ToolCallFinishedSchema,
280
+ ]);
281
+ export const ToolErrorSchema = z.object({
282
+ code: z.string().min(1),
283
+ message: z.string().min(1),
284
+ details: z.record(z.string(), z.unknown()).optional(),
285
+ });
286
+ export const ToolOutputSchema = z.object({
287
+ success: z.boolean(),
288
+ data: z.unknown().optional(),
289
+ error: ToolErrorSchema.optional(),
290
+ metadata: z.record(z.string(), z.unknown()).optional(),
291
+ });
292
+ export const ExecutionContextSchema = z.object({
293
+ run_id: z.string().min(1),
294
+ task_id: z.string().min(1),
295
+ session_id: z.string().min(1),
296
+ allowed_scopes: z.array(ToolScopeSchema),
297
+ metadata: z.record(z.string(), z.unknown()).optional(),
298
+ });
299
+ const ZodSchemaSchema = z.custom((value) => value instanceof z.ZodType, {
300
+ message: 'Expected a Zod schema',
301
+ });
302
+ export const InProcessToolHandlerSchema = z.object({
303
+ kind: z.literal(TOOL_HANDLER_KINDS.IN_PROCESS),
304
+ fn: z.custom((value) => typeof value === 'function', {
305
+ message: 'Expected an async tool function',
306
+ }),
307
+ });
308
+ export const SubprocessToolHandlerSchema = z.object({
309
+ kind: z.literal(TOOL_HANDLER_KINDS.SUBPROCESS),
310
+ entry: z.string().min(1),
311
+ });
312
+ export const ToolHandlerSchema = z.discriminatedUnion('kind', [
313
+ InProcessToolHandlerSchema,
314
+ SubprocessToolHandlerSchema,
315
+ ]);
316
+ export const ToolCapabilitySchema = z.object({
317
+ name: z.string().min(1),
318
+ domain: z.string().min(1),
319
+ version: z.string().regex(SEMVER_REGEX, SEMVER_MESSAGE),
320
+ input_schema: ZodSchemaSchema,
321
+ output_schema: ZodSchemaSchema.optional(),
322
+ permission: z.enum(['read', 'write', 'admin']),
323
+ required_scopes: z.array(ToolScopeSchema),
324
+ handler: ToolHandlerSchema,
325
+ description: z.string().min(1),
326
+ pack: z.string().min(1).optional(),
327
+ });
328
+ export function toMcpJsonSchema(schema) {
329
+ return z.toJSONSchema(schema);
330
+ }
331
+ //# sourceMappingURL=kernel.schemas.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kernel.schemas.js","sourceRoot":"","sources":["../src/kernel.schemas.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ export interface ComputeDeterministicPackHashInput {
2
+ packRoot: string;
3
+ exclusions?: string[];
4
+ }
5
+ export declare function listPackFiles(packRoot: string, exclusions?: string[]): Promise<string[]>;
6
+ export declare function computeDeterministicPackHash(input: ComputeDeterministicPackHashInput): Promise<string>;
7
+ //# sourceMappingURL=hash.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/pack/hash.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAiCD,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAAM,EAAuB,GACxC,OAAO,CAAC,MAAM,EAAE,CAAC,CAInB;AAED,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAAC,MAAM,CAAC,CAiBjB"}
@@ -0,0 +1,56 @@
1
+ // Copyright (c) 2026 Hellmai Ltd
2
+ // SPDX-License-Identifier: Apache-2.0
3
+ import { createHash } from 'node:crypto';
4
+ import { readdir, readFile } from 'node:fs/promises';
5
+ import path from 'node:path';
6
+ import { SHA256_ALGORITHM, UTF8_ENCODING } from '../shared-constants.js';
7
+ const NULL_BYTE_BUFFER = Buffer.from([0]);
8
+ const DEFAULT_EXCLUSIONS = ['node_modules/', '.git/', 'dist/', '.DS_Store'];
9
+ function normalizeRelativePath(root, absolutePath) {
10
+ return path.relative(root, absolutePath).split(path.sep).join('/');
11
+ }
12
+ function shouldExclude(relativePath, exclusions) {
13
+ return exclusions.some((excluded) => {
14
+ if (excluded.endsWith('/')) {
15
+ return relativePath.startsWith(excluded);
16
+ }
17
+ return relativePath === excluded || relativePath.endsWith(`/${excluded}`);
18
+ });
19
+ }
20
+ async function collectFilesRecursive(root, directory) {
21
+ const entries = await readdir(directory, { withFileTypes: true });
22
+ const sortedEntries = [...entries].sort((left, right) => left.name.localeCompare(right.name));
23
+ const files = [];
24
+ for (const entry of sortedEntries) {
25
+ const absolutePath = path.join(directory, entry.name);
26
+ const relativePath = normalizeRelativePath(root, absolutePath);
27
+ if (entry.isDirectory()) {
28
+ files.push(...(await collectFilesRecursive(root, absolutePath)));
29
+ continue;
30
+ }
31
+ files.push(relativePath);
32
+ }
33
+ return files;
34
+ }
35
+ export async function listPackFiles(packRoot, exclusions = DEFAULT_EXCLUSIONS) {
36
+ const absoluteRoot = path.resolve(packRoot);
37
+ const allFiles = await collectFilesRecursive(absoluteRoot, absoluteRoot);
38
+ return allFiles.filter((relativePath) => !shouldExclude(relativePath, exclusions)).sort();
39
+ }
40
+ export async function computeDeterministicPackHash(input) {
41
+ const absoluteRoot = path.resolve(input.packRoot);
42
+ const files = await listPackFiles(absoluteRoot, input.exclusions || DEFAULT_EXCLUSIONS);
43
+ const digestChunks = [];
44
+ for (const relativePath of files) {
45
+ const fileContents = await readFile(path.join(absoluteRoot, relativePath));
46
+ const fileHash = createHash(SHA256_ALGORITHM).update(fileContents).digest('hex');
47
+ digestChunks.push(Buffer.from(relativePath, UTF8_ENCODING));
48
+ digestChunks.push(NULL_BYTE_BUFFER);
49
+ digestChunks.push(Buffer.from(fileHash, UTF8_ENCODING));
50
+ digestChunks.push(NULL_BYTE_BUFFER);
51
+ }
52
+ return createHash(SHA256_ALGORITHM)
53
+ .update(digestChunks.length === 0 ? Buffer.alloc(0) : Buffer.concat(digestChunks))
54
+ .digest('hex');
55
+ }
56
+ //# sourceMappingURL=hash.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/pack/hash.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export * from './hash.js';
2
+ export * from './manifest.js';
3
+ export * from './pack-loader.js';
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pack/index.ts"],"names":[],"mappings":"AAGA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}
@@ -0,0 +1,6 @@
1
+ // Copyright (c) 2026 Hellmai Ltd
2
+ // SPDX-License-Identifier: Apache-2.0
3
+ export * from './hash.js';
4
+ export * from './manifest.js';
5
+ export * from './pack-loader.js';
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pack/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,sCAAsC;AAEtC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}
@@ -0,0 +1,100 @@
1
+ import { z } from 'zod';
2
+ export declare const DomainPackToolSchema: z.ZodObject<{
3
+ name: z.ZodString;
4
+ entry: z.ZodString;
5
+ permission: z.ZodDefault<z.ZodEnum<{
6
+ read: "read";
7
+ write: "write";
8
+ admin: "admin";
9
+ }>>;
10
+ required_scopes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
11
+ type: z.ZodLiteral<"path">;
12
+ pattern: z.ZodString;
13
+ access: z.ZodEnum<{
14
+ read: "read";
15
+ write: "write";
16
+ }>;
17
+ }, z.core.$strip>, z.ZodObject<{
18
+ type: z.ZodLiteral<"network">;
19
+ posture: z.ZodEnum<{
20
+ off: "off";
21
+ full: "full";
22
+ }>;
23
+ }, z.core.$strip>], "type">>;
24
+ internal_only: z.ZodOptional<z.ZodBoolean>;
25
+ input_schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
26
+ output_schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
27
+ }, z.core.$strip>;
28
+ export declare const DomainPackPolicySchema: z.ZodObject<{
29
+ id: z.ZodString;
30
+ trigger: z.ZodEnum<{
31
+ on_tool_request: "on_tool_request";
32
+ on_claim: "on_claim";
33
+ on_completion: "on_completion";
34
+ on_evidence_added: "on_evidence_added";
35
+ }>;
36
+ decision: z.ZodEnum<{
37
+ allow: "allow";
38
+ deny: "deny";
39
+ }>;
40
+ reason: z.ZodOptional<z.ZodString>;
41
+ }, z.core.$strip>;
42
+ export declare const DomainPackLaneTemplateSchema: z.ZodObject<{
43
+ id: z.ZodString;
44
+ title: z.ZodOptional<z.ZodString>;
45
+ description: z.ZodOptional<z.ZodString>;
46
+ }, z.core.$strip>;
47
+ export declare const DomainPackManifestSchema: z.ZodObject<{
48
+ id: z.ZodString;
49
+ version: z.ZodString;
50
+ task_types: z.ZodArray<z.ZodString>;
51
+ tools: z.ZodArray<z.ZodObject<{
52
+ name: z.ZodString;
53
+ entry: z.ZodString;
54
+ permission: z.ZodDefault<z.ZodEnum<{
55
+ read: "read";
56
+ write: "write";
57
+ admin: "admin";
58
+ }>>;
59
+ required_scopes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
60
+ type: z.ZodLiteral<"path">;
61
+ pattern: z.ZodString;
62
+ access: z.ZodEnum<{
63
+ read: "read";
64
+ write: "write";
65
+ }>;
66
+ }, z.core.$strip>, z.ZodObject<{
67
+ type: z.ZodLiteral<"network">;
68
+ posture: z.ZodEnum<{
69
+ off: "off";
70
+ full: "full";
71
+ }>;
72
+ }, z.core.$strip>], "type">>;
73
+ internal_only: z.ZodOptional<z.ZodBoolean>;
74
+ input_schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
75
+ output_schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
76
+ }, z.core.$strip>>;
77
+ policies: z.ZodArray<z.ZodObject<{
78
+ id: z.ZodString;
79
+ trigger: z.ZodEnum<{
80
+ on_tool_request: "on_tool_request";
81
+ on_claim: "on_claim";
82
+ on_completion: "on_completion";
83
+ on_evidence_added: "on_evidence_added";
84
+ }>;
85
+ decision: z.ZodEnum<{
86
+ allow: "allow";
87
+ deny: "deny";
88
+ }>;
89
+ reason: z.ZodOptional<z.ZodString>;
90
+ }, z.core.$strip>>;
91
+ evidence_types: z.ZodDefault<z.ZodArray<z.ZodString>>;
92
+ state_aliases: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
93
+ lane_templates: z.ZodDefault<z.ZodArray<z.ZodObject<{
94
+ id: z.ZodString;
95
+ title: z.ZodOptional<z.ZodString>;
96
+ description: z.ZodOptional<z.ZodString>;
97
+ }, z.core.$strip>>>;
98
+ }, z.core.$strip>;
99
+ export type DomainPackManifest = z.infer<typeof DomainPackManifestSchema>;
100
+ //# sourceMappingURL=manifest.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/pack/manifest.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;iBAU/B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;iBAUjC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;iBAIvC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}
@@ -0,0 +1,50 @@
1
+ // Copyright (c) 2026 Hellmai Ltd
2
+ // SPDX-License-Identifier: Apache-2.0
3
+ import { z } from 'zod';
4
+ import { POLICY_TRIGGERS } from '../policy/policy-engine.js';
5
+ import { ToolScopeSchema } from '../kernel.schemas.js';
6
+ const SEMVER_REGEX = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z-.]+)?(?:\+[0-9A-Za-z-.]+)?$/;
7
+ const SEMVER_MESSAGE = 'Expected semantic version';
8
+ /**
9
+ * JSON Schema representation for optional tool input/output declarations in pack manifests.
10
+ * When present, the kernel uses these for validation instead of the default accept-anything schema.
11
+ */
12
+ const JsonSchemaObjectSchema = z.record(z.string(), z.unknown());
13
+ export const DomainPackToolSchema = z.object({
14
+ name: z.string().min(1),
15
+ entry: z.string().min(1),
16
+ permission: z.enum(['read', 'write', 'admin']).default('read'),
17
+ required_scopes: z.array(ToolScopeSchema).min(1),
18
+ internal_only: z.boolean().optional(),
19
+ /** Optional JSON Schema for tool input validation. */
20
+ input_schema: JsonSchemaObjectSchema.optional(),
21
+ /** Optional JSON Schema for tool output validation. */
22
+ output_schema: JsonSchemaObjectSchema.optional(),
23
+ });
24
+ export const DomainPackPolicySchema = z.object({
25
+ id: z.string().min(1),
26
+ trigger: z.enum([
27
+ POLICY_TRIGGERS.ON_TOOL_REQUEST,
28
+ POLICY_TRIGGERS.ON_CLAIM,
29
+ POLICY_TRIGGERS.ON_COMPLETION,
30
+ POLICY_TRIGGERS.ON_EVIDENCE_ADDED,
31
+ ]),
32
+ decision: z.enum(['allow', 'deny']),
33
+ reason: z.string().min(1).optional(),
34
+ });
35
+ export const DomainPackLaneTemplateSchema = z.object({
36
+ id: z.string().min(1),
37
+ title: z.string().min(1).optional(),
38
+ description: z.string().min(1).optional(),
39
+ });
40
+ export const DomainPackManifestSchema = z.object({
41
+ id: z.string().min(1),
42
+ version: z.string().regex(SEMVER_REGEX, SEMVER_MESSAGE),
43
+ task_types: z.array(z.string().min(1)).min(1),
44
+ tools: z.array(DomainPackToolSchema),
45
+ policies: z.array(DomainPackPolicySchema),
46
+ evidence_types: z.array(z.string().min(1)).default([]),
47
+ state_aliases: z.record(z.string().min(1), z.string().min(1)).default({}),
48
+ lane_templates: z.array(DomainPackLaneTemplateSchema).default([]),
49
+ });
50
+ //# sourceMappingURL=manifest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/pack/manifest.ts"],"names":[],"mappings":"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"}