@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.
- package/LICENSE.md +190 -0
- package/README.md +26 -0
- package/dist/canonical-json.d.ts +7 -0
- package/dist/canonical-json.d.ts.map +1 -0
- package/dist/canonical-json.js +50 -0
- package/dist/canonical-json.js.map +1 -0
- package/dist/event-kinds.d.ts +32 -0
- package/dist/event-kinds.d.ts.map +1 -0
- package/dist/event-kinds.js +49 -0
- package/dist/event-kinds.js.map +1 -0
- package/dist/event-store/index.d.ts +64 -0
- package/dist/event-store/index.d.ts.map +1 -0
- package/dist/event-store/index.js +634 -0
- package/dist/event-store/index.js.map +1 -0
- package/dist/evidence/evidence-store.d.ts +78 -0
- package/dist/evidence/evidence-store.d.ts.map +1 -0
- package/dist/evidence/evidence-store.js +409 -0
- package/dist/evidence/evidence-store.js.map +1 -0
- package/dist/evidence/fs-helpers.d.ts +13 -0
- package/dist/evidence/fs-helpers.d.ts.map +1 -0
- package/dist/evidence/fs-helpers.js +38 -0
- package/dist/evidence/fs-helpers.js.map +1 -0
- package/dist/evidence/index.d.ts +3 -0
- package/dist/evidence/index.d.ts.map +1 -0
- package/dist/evidence/index.js +5 -0
- package/dist/evidence/index.js.map +1 -0
- package/dist/index.d.ts +17 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +19 -0
- package/dist/index.js.map +1 -0
- package/dist/kernel.schemas.d.ts +642 -0
- package/dist/kernel.schemas.d.ts.map +1 -0
- package/dist/kernel.schemas.js +331 -0
- package/dist/kernel.schemas.js.map +1 -0
- package/dist/pack/hash.d.ts +7 -0
- package/dist/pack/hash.d.ts.map +1 -0
- package/dist/pack/hash.js +56 -0
- package/dist/pack/hash.js.map +1 -0
- package/dist/pack/index.d.ts +4 -0
- package/dist/pack/index.d.ts.map +1 -0
- package/dist/pack/index.js +6 -0
- package/dist/pack/index.js.map +1 -0
- package/dist/pack/manifest.d.ts +100 -0
- package/dist/pack/manifest.d.ts.map +1 -0
- package/dist/pack/manifest.js +50 -0
- package/dist/pack/manifest.js.map +1 -0
- package/dist/pack/pack-loader.d.ts +108 -0
- package/dist/pack/pack-loader.d.ts.map +1 -0
- package/dist/pack/pack-loader.js +282 -0
- package/dist/pack/pack-loader.js.map +1 -0
- package/dist/policy/approval-event.d.ts +29 -0
- package/dist/policy/approval-event.d.ts.map +1 -0
- package/dist/policy/approval-event.js +17 -0
- package/dist/policy/approval-event.js.map +1 -0
- package/dist/policy/index.d.ts +3 -0
- package/dist/policy/index.d.ts.map +1 -0
- package/dist/policy/index.js +5 -0
- package/dist/policy/index.js.map +1 -0
- package/dist/policy/policy-engine.d.ts +52 -0
- package/dist/policy/policy-engine.d.ts.map +1 -0
- package/dist/policy/policy-engine.js +83 -0
- package/dist/policy/policy-engine.js.map +1 -0
- package/dist/runtime/index.d.ts +2 -0
- package/dist/runtime/index.d.ts.map +1 -0
- package/dist/runtime/index.js +4 -0
- package/dist/runtime/index.js.map +1 -0
- package/dist/runtime/kernel-runtime.d.ts +170 -0
- package/dist/runtime/kernel-runtime.d.ts.map +1 -0
- package/dist/runtime/kernel-runtime.js +751 -0
- package/dist/runtime/kernel-runtime.js.map +1 -0
- package/dist/sandbox/bwrap-invocation.d.ts +13 -0
- package/dist/sandbox/bwrap-invocation.d.ts.map +1 -0
- package/dist/sandbox/bwrap-invocation.js +105 -0
- package/dist/sandbox/bwrap-invocation.js.map +1 -0
- package/dist/sandbox/index.d.ts +5 -0
- package/dist/sandbox/index.d.ts.map +1 -0
- package/dist/sandbox/index.js +7 -0
- package/dist/sandbox/index.js.map +1 -0
- package/dist/sandbox/profile.d.ts +32 -0
- package/dist/sandbox/profile.d.ts.map +1 -0
- package/dist/sandbox/profile.js +101 -0
- package/dist/sandbox/profile.js.map +1 -0
- package/dist/sandbox/subprocess-dispatcher.d.ts +38 -0
- package/dist/sandbox/subprocess-dispatcher.d.ts.map +1 -0
- package/dist/sandbox/subprocess-dispatcher.js +145 -0
- package/dist/sandbox/subprocess-dispatcher.js.map +1 -0
- package/dist/sandbox/tool-runner-worker.d.ts +54 -0
- package/dist/sandbox/tool-runner-worker.d.ts.map +1 -0
- package/dist/sandbox/tool-runner-worker.js +159 -0
- package/dist/sandbox/tool-runner-worker.js.map +1 -0
- package/dist/shared-constants.d.ts +48 -0
- package/dist/shared-constants.d.ts.map +1 -0
- package/dist/shared-constants.js +49 -0
- package/dist/shared-constants.js.map +1 -0
- package/dist/state-machine/index.d.ts +30 -0
- package/dist/state-machine/index.d.ts.map +1 -0
- package/dist/state-machine/index.js +92 -0
- package/dist/state-machine/index.js.map +1 -0
- package/dist/tool-host/builtins/capabilities.d.ts +20 -0
- package/dist/tool-host/builtins/capabilities.d.ts.map +1 -0
- package/dist/tool-host/builtins/capabilities.js +211 -0
- package/dist/tool-host/builtins/capabilities.js.map +1 -0
- package/dist/tool-host/builtins/index.d.ts +2 -0
- package/dist/tool-host/builtins/index.d.ts.map +1 -0
- package/dist/tool-host/builtins/index.js +4 -0
- package/dist/tool-host/builtins/index.js.map +1 -0
- package/dist/tool-host/index.d.ts +5 -0
- package/dist/tool-host/index.d.ts.map +1 -0
- package/dist/tool-host/index.js +7 -0
- package/dist/tool-host/index.js.map +1 -0
- package/dist/tool-host/scope-intersection.d.ts +10 -0
- package/dist/tool-host/scope-intersection.d.ts.map +1 -0
- package/dist/tool-host/scope-intersection.js +188 -0
- package/dist/tool-host/scope-intersection.js.map +1 -0
- package/dist/tool-host/subprocess-dispatcher.d.ts +14 -0
- package/dist/tool-host/subprocess-dispatcher.d.ts.map +1 -0
- package/dist/tool-host/subprocess-dispatcher.js +14 -0
- package/dist/tool-host/subprocess-dispatcher.js.map +1 -0
- package/dist/tool-host/tool-host.d.ts +42 -0
- package/dist/tool-host/tool-host.d.ts.map +1 -0
- package/dist/tool-host/tool-host.js +395 -0
- package/dist/tool-host/tool-host.js.map +1 -0
- package/dist/tool-host/tool-registry.d.ts +9 -0
- package/dist/tool-host/tool-registry.d.ts.map +1 -0
- package/dist/tool-host/tool-registry.js +28 -0
- package/dist/tool-host/tool-registry.js.map +1 -0
- 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 @@
|
|
|
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 @@
|
|
|
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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"}
|