@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,395 @@
|
|
|
1
|
+
// Copyright (c) 2026 Hellmai Ltd
|
|
2
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
import { randomUUID } from 'node:crypto';
|
|
4
|
+
import { intersectToolScopes } from './scope-intersection.js';
|
|
5
|
+
import { TOOL_TRACE_KINDS } from '../event-kinds.js';
|
|
6
|
+
import { ExecutionContextSchema, ToolOutputSchema, ToolScopeSchema, TOOL_ERROR_CODES, TOOL_HANDLER_KINDS, } from '../kernel.schemas.js';
|
|
7
|
+
import { DEFAULT_KERNEL_RUNTIME_VERSION, DEFAULT_WORKSPACE_CONFIG_HASH, EXECUTION_METADATA_KEYS, KERNEL_POLICY_IDS, RESERVED_FRAMEWORK_SCOPE_GLOB, RESERVED_FRAMEWORK_SCOPE_PREFIX, RESERVED_FRAMEWORK_SCOPE_ROOT, SHA256_HEX_REGEX, } from '../shared-constants.js';
|
|
8
|
+
import { EvidenceStore } from '../evidence/evidence-store.js';
|
|
9
|
+
import { ToolRegistry } from './tool-registry.js';
|
|
10
|
+
import { DefaultSubprocessDispatcher } from './subprocess-dispatcher.js';
|
|
11
|
+
function resolveMetadata(context) {
|
|
12
|
+
if (!context.metadata || typeof context.metadata !== 'object') {
|
|
13
|
+
return {};
|
|
14
|
+
}
|
|
15
|
+
return context.metadata;
|
|
16
|
+
}
|
|
17
|
+
function parseScopeList(candidate, fallback) {
|
|
18
|
+
const parsed = ToolScopeSchema.array().safeParse(candidate);
|
|
19
|
+
if (parsed.success) {
|
|
20
|
+
return parsed.data;
|
|
21
|
+
}
|
|
22
|
+
return fallback;
|
|
23
|
+
}
|
|
24
|
+
function parseOptionalString(candidate) {
|
|
25
|
+
return typeof candidate === 'string' && candidate.trim().length > 0 ? candidate : undefined;
|
|
26
|
+
}
|
|
27
|
+
function normalizeScopePattern(pattern) {
|
|
28
|
+
return pattern.replaceAll('\\', '/').replace(/^\.\//, '');
|
|
29
|
+
}
|
|
30
|
+
function isReservedFrameworkWriteScope(scope) {
|
|
31
|
+
if (scope.type !== 'path' || scope.access !== 'write') {
|
|
32
|
+
return false;
|
|
33
|
+
}
|
|
34
|
+
const normalized = normalizeScopePattern(scope.pattern);
|
|
35
|
+
return (normalized === RESERVED_FRAMEWORK_SCOPE_ROOT ||
|
|
36
|
+
normalized.startsWith(RESERVED_FRAMEWORK_SCOPE_PREFIX));
|
|
37
|
+
}
|
|
38
|
+
function collectReservedFrameworkWriteScopes(scopes) {
|
|
39
|
+
const blocked = scopes
|
|
40
|
+
.filter((scope) => isReservedFrameworkWriteScope(scope))
|
|
41
|
+
.map((scope) => normalizeScopePattern(scope.pattern));
|
|
42
|
+
return [...new Set(blocked)];
|
|
43
|
+
}
|
|
44
|
+
export async function allowAllPolicyHook() {
|
|
45
|
+
return [
|
|
46
|
+
{
|
|
47
|
+
policy_id: KERNEL_POLICY_IDS.ALLOW_ALL,
|
|
48
|
+
decision: 'allow',
|
|
49
|
+
reason: 'Phase 2 default allow-all policy',
|
|
50
|
+
},
|
|
51
|
+
];
|
|
52
|
+
}
|
|
53
|
+
export class ToolHost {
|
|
54
|
+
registry;
|
|
55
|
+
evidenceStore;
|
|
56
|
+
subprocessDispatcher;
|
|
57
|
+
policyHook;
|
|
58
|
+
runtimeVersion;
|
|
59
|
+
now;
|
|
60
|
+
onTraceError;
|
|
61
|
+
constructor(options) {
|
|
62
|
+
if (!options.policyHook) {
|
|
63
|
+
throw new Error('ToolHost requires an explicit policyHook. ' +
|
|
64
|
+
'Use allowAllPolicyHook for development or provide a production policy.');
|
|
65
|
+
}
|
|
66
|
+
this.registry = options.registry;
|
|
67
|
+
this.evidenceStore = options.evidenceStore;
|
|
68
|
+
this.subprocessDispatcher = options.subprocessDispatcher ?? new DefaultSubprocessDispatcher();
|
|
69
|
+
this.policyHook = options.policyHook;
|
|
70
|
+
this.runtimeVersion = options.runtimeVersion ?? DEFAULT_KERNEL_RUNTIME_VERSION;
|
|
71
|
+
this.now = options.now ?? (() => new Date());
|
|
72
|
+
this.onTraceError = options.onTraceError;
|
|
73
|
+
}
|
|
74
|
+
async onStartup() {
|
|
75
|
+
return this.evidenceStore.reconcileOrphanedStarts();
|
|
76
|
+
}
|
|
77
|
+
async onShutdown() {
|
|
78
|
+
return this.evidenceStore.reconcileOrphanedStarts();
|
|
79
|
+
}
|
|
80
|
+
async execute(name, input, ctx) {
|
|
81
|
+
const context = ExecutionContextSchema.parse(ctx);
|
|
82
|
+
const capability = this.registry.lookup(name);
|
|
83
|
+
if (!capability) {
|
|
84
|
+
return {
|
|
85
|
+
success: false,
|
|
86
|
+
error: {
|
|
87
|
+
code: TOOL_ERROR_CODES.TOOL_NOT_FOUND,
|
|
88
|
+
message: `Tool "${name}" is not registered`,
|
|
89
|
+
},
|
|
90
|
+
};
|
|
91
|
+
}
|
|
92
|
+
const metadata = resolveMetadata(context);
|
|
93
|
+
const { scopeRequested, scopeAllowed, scopeEnforced, reservedFrameworkWriteScopes } = this.resolveScope(capability, context, metadata);
|
|
94
|
+
const { dataHash: inputHash, dataRef: inputRef } = await this.evidenceStore.persistData(input);
|
|
95
|
+
const receiptId = randomUUID();
|
|
96
|
+
const startedAt = this.now().getTime();
|
|
97
|
+
const timestamp = new Date(startedAt).toISOString();
|
|
98
|
+
const workspaceConfigHashCandidate = parseOptionalString(metadata[EXECUTION_METADATA_KEYS.WORKSPACE_CONFIG_HASH]);
|
|
99
|
+
const workspaceConfigHash = workspaceConfigHashCandidate && SHA256_HEX_REGEX.test(workspaceConfigHashCandidate)
|
|
100
|
+
? workspaceConfigHashCandidate
|
|
101
|
+
: DEFAULT_WORKSPACE_CONFIG_HASH;
|
|
102
|
+
const runtimeVersion = parseOptionalString(metadata[EXECUTION_METADATA_KEYS.RUNTIME_VERSION]) ?? this.runtimeVersion;
|
|
103
|
+
const packVersion = parseOptionalString(metadata[EXECUTION_METADATA_KEYS.PACK_VERSION]);
|
|
104
|
+
const packIntegrity = parseOptionalString(metadata[EXECUTION_METADATA_KEYS.PACK_INTEGRITY]);
|
|
105
|
+
const packId = capability.pack ?? parseOptionalString(metadata[EXECUTION_METADATA_KEYS.PACK_ID]);
|
|
106
|
+
try {
|
|
107
|
+
await this.evidenceStore.appendTrace({
|
|
108
|
+
schema_version: 1,
|
|
109
|
+
kind: TOOL_TRACE_KINDS.TOOL_CALL_STARTED,
|
|
110
|
+
receipt_id: receiptId,
|
|
111
|
+
run_id: context.run_id,
|
|
112
|
+
task_id: context.task_id,
|
|
113
|
+
session_id: context.session_id,
|
|
114
|
+
timestamp,
|
|
115
|
+
tool_name: capability.name,
|
|
116
|
+
execution_mode: capability.handler.kind,
|
|
117
|
+
scope_requested: scopeRequested,
|
|
118
|
+
scope_allowed: scopeAllowed,
|
|
119
|
+
scope_enforced: scopeEnforced,
|
|
120
|
+
input_hash: inputHash,
|
|
121
|
+
input_ref: inputRef,
|
|
122
|
+
tool_version: capability.version,
|
|
123
|
+
pack_id: packId,
|
|
124
|
+
pack_version: packVersion,
|
|
125
|
+
pack_integrity: packIntegrity,
|
|
126
|
+
workspace_config_hash: workspaceConfigHash,
|
|
127
|
+
runtime_version: runtimeVersion,
|
|
128
|
+
});
|
|
129
|
+
}
|
|
130
|
+
catch (error) {
|
|
131
|
+
// Started trace failure must not prevent tool execution.
|
|
132
|
+
this.onTraceError?.(error);
|
|
133
|
+
}
|
|
134
|
+
const authResult = await this.authorize({
|
|
135
|
+
receiptId,
|
|
136
|
+
startedAt,
|
|
137
|
+
capability,
|
|
138
|
+
input,
|
|
139
|
+
context,
|
|
140
|
+
scopeRequested,
|
|
141
|
+
scopeAllowed,
|
|
142
|
+
scopeEnforced,
|
|
143
|
+
reservedFrameworkWriteScopes,
|
|
144
|
+
});
|
|
145
|
+
if (authResult.denied) {
|
|
146
|
+
return authResult.output;
|
|
147
|
+
}
|
|
148
|
+
const parsedInput = capability.input_schema.safeParse(input);
|
|
149
|
+
if (!parsedInput.success) {
|
|
150
|
+
const invalidInputOutput = {
|
|
151
|
+
success: false,
|
|
152
|
+
error: {
|
|
153
|
+
code: TOOL_ERROR_CODES.INVALID_INPUT,
|
|
154
|
+
message: parsedInput.error.message,
|
|
155
|
+
},
|
|
156
|
+
};
|
|
157
|
+
try {
|
|
158
|
+
await this.recordDeniedTrace({
|
|
159
|
+
receiptId,
|
|
160
|
+
startedAt,
|
|
161
|
+
result: 'failure',
|
|
162
|
+
scopeEnforcementNote: 'Input validation failed before dispatch.',
|
|
163
|
+
policyDecisions: authResult.policyDecisions,
|
|
164
|
+
});
|
|
165
|
+
}
|
|
166
|
+
catch (error) {
|
|
167
|
+
// Denied trace failure must not suppress the denial output.
|
|
168
|
+
this.onTraceError?.(error);
|
|
169
|
+
}
|
|
170
|
+
return invalidInputOutput;
|
|
171
|
+
}
|
|
172
|
+
let output = await this.dispatch(capability, parsedInput.data, context, scopeEnforced);
|
|
173
|
+
output = this.normalizeOutput(output, capability);
|
|
174
|
+
try {
|
|
175
|
+
await this.recordTrace({
|
|
176
|
+
receiptId,
|
|
177
|
+
startedAt,
|
|
178
|
+
output,
|
|
179
|
+
policyDecisions: authResult.policyDecisions,
|
|
180
|
+
});
|
|
181
|
+
}
|
|
182
|
+
catch (error) {
|
|
183
|
+
// Trace recording failure must not swallow the tool execution result.
|
|
184
|
+
// The tool output is more important to the caller than the audit trail.
|
|
185
|
+
this.onTraceError?.(error);
|
|
186
|
+
}
|
|
187
|
+
return output;
|
|
188
|
+
}
|
|
189
|
+
resolveScope(capability, context, metadata) {
|
|
190
|
+
const workspaceAllowed = parseScopeList(metadata[EXECUTION_METADATA_KEYS.WORKSPACE_ALLOWED_SCOPES], context.allowed_scopes);
|
|
191
|
+
const laneAllowed = parseScopeList(metadata[EXECUTION_METADATA_KEYS.LANE_ALLOWED_SCOPES], context.allowed_scopes);
|
|
192
|
+
const taskDeclared = parseScopeList(metadata[EXECUTION_METADATA_KEYS.TASK_DECLARED_SCOPES], context.allowed_scopes);
|
|
193
|
+
const scopeRequested = capability.required_scopes;
|
|
194
|
+
const reservedFrameworkWriteScopes = collectReservedFrameworkWriteScopes(scopeRequested);
|
|
195
|
+
const scopeAllowed = intersectToolScopes({
|
|
196
|
+
workspaceAllowed,
|
|
197
|
+
laneAllowed,
|
|
198
|
+
taskDeclared,
|
|
199
|
+
toolRequired: scopeRequested,
|
|
200
|
+
});
|
|
201
|
+
const scopeEnforced = scopeAllowed;
|
|
202
|
+
return { scopeRequested, scopeAllowed, scopeEnforced, reservedFrameworkWriteScopes };
|
|
203
|
+
}
|
|
204
|
+
async authorize(params) {
|
|
205
|
+
const { receiptId, startedAt, capability, input, context, scopeRequested, scopeAllowed, scopeEnforced, reservedFrameworkWriteScopes, } = params;
|
|
206
|
+
if (reservedFrameworkWriteScopes.length > 0) {
|
|
207
|
+
const output = {
|
|
208
|
+
success: false,
|
|
209
|
+
error: {
|
|
210
|
+
code: TOOL_ERROR_CODES.SCOPE_DENIED,
|
|
211
|
+
message: `Reserved scope violation: pack/tool write scopes under ${RESERVED_FRAMEWORK_SCOPE_GLOB} are not allowed.`,
|
|
212
|
+
details: {
|
|
213
|
+
reserved_scopes: reservedFrameworkWriteScopes,
|
|
214
|
+
},
|
|
215
|
+
},
|
|
216
|
+
};
|
|
217
|
+
try {
|
|
218
|
+
await this.recordDeniedTrace({
|
|
219
|
+
receiptId,
|
|
220
|
+
startedAt,
|
|
221
|
+
result: 'denied',
|
|
222
|
+
scopeEnforcementNote: `Denied by reserved framework boundary: ${RESERVED_FRAMEWORK_SCOPE_GLOB} is framework-owned.`,
|
|
223
|
+
policyDecisions: [
|
|
224
|
+
{
|
|
225
|
+
policy_id: KERNEL_POLICY_IDS.SCOPE_RESERVED_PATH,
|
|
226
|
+
decision: 'deny',
|
|
227
|
+
reason: `Pack/tool declared write scope targets reserved ${RESERVED_FRAMEWORK_SCOPE_GLOB} namespace`,
|
|
228
|
+
},
|
|
229
|
+
],
|
|
230
|
+
});
|
|
231
|
+
}
|
|
232
|
+
catch (error) {
|
|
233
|
+
// Denied trace failure must not suppress the denial output.
|
|
234
|
+
this.onTraceError?.(error);
|
|
235
|
+
}
|
|
236
|
+
return { denied: true, output };
|
|
237
|
+
}
|
|
238
|
+
if (scopeEnforced.length === 0) {
|
|
239
|
+
const output = {
|
|
240
|
+
success: false,
|
|
241
|
+
error: {
|
|
242
|
+
code: TOOL_ERROR_CODES.SCOPE_DENIED,
|
|
243
|
+
message: 'Scope intersection denied: no allowed scopes remain after intersection.',
|
|
244
|
+
details: {
|
|
245
|
+
scope_requested: scopeRequested,
|
|
246
|
+
scope_allowed: scopeAllowed,
|
|
247
|
+
},
|
|
248
|
+
},
|
|
249
|
+
};
|
|
250
|
+
try {
|
|
251
|
+
await this.recordDeniedTrace({
|
|
252
|
+
receiptId,
|
|
253
|
+
startedAt,
|
|
254
|
+
result: 'denied',
|
|
255
|
+
scopeEnforcementNote: 'Denied by hard boundary: empty scope intersection.',
|
|
256
|
+
policyDecisions: [
|
|
257
|
+
{
|
|
258
|
+
policy_id: KERNEL_POLICY_IDS.SCOPE_BOUNDARY,
|
|
259
|
+
decision: 'deny',
|
|
260
|
+
reason: 'No intersecting scopes after scope resolution',
|
|
261
|
+
},
|
|
262
|
+
],
|
|
263
|
+
});
|
|
264
|
+
}
|
|
265
|
+
catch (error) {
|
|
266
|
+
// Denied trace failure must not suppress the denial output.
|
|
267
|
+
this.onTraceError?.(error);
|
|
268
|
+
}
|
|
269
|
+
return { denied: true, output };
|
|
270
|
+
}
|
|
271
|
+
const policyDecisions = await this.policyHook({
|
|
272
|
+
capability,
|
|
273
|
+
input,
|
|
274
|
+
context,
|
|
275
|
+
scopeEnforced,
|
|
276
|
+
});
|
|
277
|
+
if (policyDecisions.some((decision) => decision.decision === 'deny')) {
|
|
278
|
+
const output = {
|
|
279
|
+
success: false,
|
|
280
|
+
error: {
|
|
281
|
+
code: TOOL_ERROR_CODES.POLICY_DENIED,
|
|
282
|
+
message: 'Policy hook denied tool execution.',
|
|
283
|
+
},
|
|
284
|
+
};
|
|
285
|
+
try {
|
|
286
|
+
await this.recordDeniedTrace({
|
|
287
|
+
receiptId,
|
|
288
|
+
startedAt,
|
|
289
|
+
result: 'denied',
|
|
290
|
+
scopeEnforcementNote: 'Denied by policy hook decision.',
|
|
291
|
+
policyDecisions,
|
|
292
|
+
});
|
|
293
|
+
}
|
|
294
|
+
catch (error) {
|
|
295
|
+
// Denied trace failure must not suppress the denial output.
|
|
296
|
+
this.onTraceError?.(error);
|
|
297
|
+
}
|
|
298
|
+
return { denied: true, output };
|
|
299
|
+
}
|
|
300
|
+
return { denied: false, policyDecisions };
|
|
301
|
+
}
|
|
302
|
+
async dispatch(capability, input, context, scopeEnforced) {
|
|
303
|
+
try {
|
|
304
|
+
if (capability.handler.kind === TOOL_HANDLER_KINDS.IN_PROCESS) {
|
|
305
|
+
return await capability.handler.fn(input, context);
|
|
306
|
+
}
|
|
307
|
+
return await this.subprocessDispatcher.dispatch({
|
|
308
|
+
capability,
|
|
309
|
+
input,
|
|
310
|
+
context,
|
|
311
|
+
scopeEnforced,
|
|
312
|
+
});
|
|
313
|
+
}
|
|
314
|
+
catch (error) {
|
|
315
|
+
return {
|
|
316
|
+
success: false,
|
|
317
|
+
error: {
|
|
318
|
+
code: TOOL_ERROR_CODES.TOOL_EXECUTION_FAILED,
|
|
319
|
+
message: error.message,
|
|
320
|
+
},
|
|
321
|
+
};
|
|
322
|
+
}
|
|
323
|
+
}
|
|
324
|
+
normalizeOutput(output, capability) {
|
|
325
|
+
const normalizedOutputResult = ToolOutputSchema.safeParse(output);
|
|
326
|
+
if (!normalizedOutputResult.success) {
|
|
327
|
+
return {
|
|
328
|
+
success: false,
|
|
329
|
+
error: {
|
|
330
|
+
code: TOOL_ERROR_CODES.INVALID_OUTPUT,
|
|
331
|
+
message: normalizedOutputResult.error.message,
|
|
332
|
+
},
|
|
333
|
+
};
|
|
334
|
+
}
|
|
335
|
+
let normalized = normalizedOutputResult.data;
|
|
336
|
+
if (capability.output_schema && normalized.success) {
|
|
337
|
+
const parsedData = capability.output_schema.safeParse(normalized.data);
|
|
338
|
+
if (!parsedData.success) {
|
|
339
|
+
normalized = {
|
|
340
|
+
success: false,
|
|
341
|
+
error: {
|
|
342
|
+
code: TOOL_ERROR_CODES.INVALID_OUTPUT,
|
|
343
|
+
message: parsedData.error.message,
|
|
344
|
+
},
|
|
345
|
+
};
|
|
346
|
+
}
|
|
347
|
+
}
|
|
348
|
+
return normalized;
|
|
349
|
+
}
|
|
350
|
+
async recordDeniedTrace(params) {
|
|
351
|
+
const finishedAt = this.now();
|
|
352
|
+
await this.evidenceStore.appendTrace({
|
|
353
|
+
schema_version: 1,
|
|
354
|
+
kind: TOOL_TRACE_KINDS.TOOL_CALL_FINISHED,
|
|
355
|
+
receipt_id: params.receiptId,
|
|
356
|
+
timestamp: finishedAt.toISOString(),
|
|
357
|
+
result: params.result,
|
|
358
|
+
duration_ms: finishedAt.getTime() - params.startedAt,
|
|
359
|
+
scope_enforcement_note: params.scopeEnforcementNote,
|
|
360
|
+
policy_decisions: params.policyDecisions,
|
|
361
|
+
artifacts_written: [],
|
|
362
|
+
});
|
|
363
|
+
}
|
|
364
|
+
async recordTrace(params) {
|
|
365
|
+
const { receiptId, startedAt, output, policyDecisions } = params;
|
|
366
|
+
const outputRef = output.data === undefined ? undefined : await this.evidenceStore.persistData(output.data);
|
|
367
|
+
const outputHash = outputRef?.dataHash;
|
|
368
|
+
const outputReference = outputRef?.dataRef;
|
|
369
|
+
const result = output.success
|
|
370
|
+
? 'success'
|
|
371
|
+
: output.error?.code === TOOL_ERROR_CODES.SCOPE_DENIED
|
|
372
|
+
? 'denied'
|
|
373
|
+
: 'failure';
|
|
374
|
+
const finishedAt = this.now();
|
|
375
|
+
await this.evidenceStore.appendTrace({
|
|
376
|
+
schema_version: 1,
|
|
377
|
+
kind: TOOL_TRACE_KINDS.TOOL_CALL_FINISHED,
|
|
378
|
+
receipt_id: receiptId,
|
|
379
|
+
timestamp: finishedAt.toISOString(),
|
|
380
|
+
result,
|
|
381
|
+
duration_ms: finishedAt.getTime() - startedAt,
|
|
382
|
+
output_hash: outputHash,
|
|
383
|
+
output_ref: outputReference,
|
|
384
|
+
scope_enforcement_note: result === 'success'
|
|
385
|
+
? 'Allowed by scope intersection and policy.'
|
|
386
|
+
: 'Denied or failed during execution.',
|
|
387
|
+
policy_decisions: policyDecisions,
|
|
388
|
+
artifacts_written: Array.isArray(output.metadata?.artifacts_written) &&
|
|
389
|
+
output.metadata?.artifacts_written.every((artifact) => typeof artifact === 'string')
|
|
390
|
+
? output.metadata.artifacts_written
|
|
391
|
+
: [],
|
|
392
|
+
});
|
|
393
|
+
}
|
|
394
|
+
}
|
|
395
|
+
//# sourceMappingURL=tool-host.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tool-host.js","sourceRoot":"","sources":["../../src/tool-host/tool-host.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { type ToolCapability } from '../kernel.schemas.js';
|
|
2
|
+
export declare class ToolRegistry {
|
|
3
|
+
private readonly capabilities;
|
|
4
|
+
register(capability: unknown): ToolCapability;
|
|
5
|
+
lookup(name: string): ToolCapability | null;
|
|
6
|
+
list(): ToolCapability[];
|
|
7
|
+
validate(capability: unknown): ToolCapability;
|
|
8
|
+
}
|
|
9
|
+
//# sourceMappingURL=tool-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/tool-host/tool-registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEjF,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqC;IAElE,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,cAAc;IAS7C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAI3C,IAAI,IAAI,cAAc,EAAE;IAIxB,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,cAAc;CAO9C"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
// Copyright (c) 2026 Hellmai Ltd
|
|
2
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
import { ToolCapabilitySchema } from '../kernel.schemas.js';
|
|
4
|
+
export class ToolRegistry {
|
|
5
|
+
capabilities = new Map();
|
|
6
|
+
register(capability) {
|
|
7
|
+
const validated = this.validate(capability);
|
|
8
|
+
if (this.capabilities.has(validated.name)) {
|
|
9
|
+
throw new Error(`Tool "${validated.name}" is already registered`);
|
|
10
|
+
}
|
|
11
|
+
this.capabilities.set(validated.name, validated);
|
|
12
|
+
return validated;
|
|
13
|
+
}
|
|
14
|
+
lookup(name) {
|
|
15
|
+
return this.capabilities.get(name) ?? null;
|
|
16
|
+
}
|
|
17
|
+
list() {
|
|
18
|
+
return [...this.capabilities.values()];
|
|
19
|
+
}
|
|
20
|
+
validate(capability) {
|
|
21
|
+
const parsed = ToolCapabilitySchema.safeParse(capability);
|
|
22
|
+
if (!parsed.success) {
|
|
23
|
+
throw new Error(`ToolCapability validation failed: ${parsed.error.message}`);
|
|
24
|
+
}
|
|
25
|
+
return parsed.data;
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
//# sourceMappingURL=tool-registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../src/tool-host/tool-registry.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,sCAAsC;AAEtC,OAAO,EAAE,oBAAoB,EAAuB,MAAM,sBAAsB,CAAC;AAEjF,MAAM,OAAO,YAAY;IACN,YAAY,GAAG,IAAI,GAAG,EAA0B,CAAC;IAElE,QAAQ,CAAC,UAAmB;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,SAAS,SAAS,CAAC,IAAI,yBAAyB,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACjD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAC7C,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,QAAQ,CAAC,UAAmB;QAC1B,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;CACF"}
|
package/package.json
ADDED
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@lumenflow/kernel",
|
|
3
|
+
"version": "3.0.0",
|
|
4
|
+
"description": "Domain-agnostic runtime primitives and contracts for LumenFlow",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"lumenflow",
|
|
7
|
+
"kernel",
|
|
8
|
+
"runtime",
|
|
9
|
+
"schemas"
|
|
10
|
+
],
|
|
11
|
+
"homepage": "https://github.com/hellmai/lumenflow",
|
|
12
|
+
"repository": {
|
|
13
|
+
"type": "git",
|
|
14
|
+
"url": "https://github.com/hellmai/lumenflow.git",
|
|
15
|
+
"directory": "packages/@lumenflow/kernel"
|
|
16
|
+
},
|
|
17
|
+
"license": "Apache-2.0",
|
|
18
|
+
"author": {
|
|
19
|
+
"name": "HellmAI",
|
|
20
|
+
"url": "https://hellm.ai"
|
|
21
|
+
},
|
|
22
|
+
"type": "module",
|
|
23
|
+
"exports": {
|
|
24
|
+
".": "./dist/index.js",
|
|
25
|
+
"./event-kinds": "./dist/event-kinds.js",
|
|
26
|
+
"./schemas": "./dist/kernel.schemas.js",
|
|
27
|
+
"./canonical-json": "./dist/canonical-json.js",
|
|
28
|
+
"./event-store": "./dist/event-store/index.js",
|
|
29
|
+
"./evidence": "./dist/evidence/index.js",
|
|
30
|
+
"./pack": "./dist/pack/index.js",
|
|
31
|
+
"./policy": "./dist/policy/index.js",
|
|
32
|
+
"./runtime": "./dist/runtime/index.js",
|
|
33
|
+
"./sandbox": "./dist/sandbox/index.js",
|
|
34
|
+
"./shared-constants": "./dist/shared-constants.js",
|
|
35
|
+
"./state-machine": "./dist/state-machine/index.js",
|
|
36
|
+
"./tool-host": "./dist/tool-host/index.js"
|
|
37
|
+
},
|
|
38
|
+
"main": "./dist/index.js",
|
|
39
|
+
"types": "./dist/index.d.ts",
|
|
40
|
+
"files": [
|
|
41
|
+
"dist",
|
|
42
|
+
"LICENSE.md",
|
|
43
|
+
"README.md"
|
|
44
|
+
],
|
|
45
|
+
"dependencies": {
|
|
46
|
+
"micromatch": "^4.0.8",
|
|
47
|
+
"yaml": "^2.8.2",
|
|
48
|
+
"zod": "^4.3.6"
|
|
49
|
+
},
|
|
50
|
+
"devDependencies": {
|
|
51
|
+
"@vitest/coverage-v8": "^4.0.18",
|
|
52
|
+
"fast-check": "^4.5.3",
|
|
53
|
+
"typescript": "^5.9.3",
|
|
54
|
+
"vitest": "^4.0.18"
|
|
55
|
+
},
|
|
56
|
+
"engines": {
|
|
57
|
+
"node": ">=22"
|
|
58
|
+
},
|
|
59
|
+
"publishConfig": {
|
|
60
|
+
"access": "public"
|
|
61
|
+
},
|
|
62
|
+
"scripts": {
|
|
63
|
+
"build": "tsc",
|
|
64
|
+
"build:dist": "tsc -p tsconfig.build.json",
|
|
65
|
+
"pack:dist": "pnpm pack",
|
|
66
|
+
"clean": "rm -rf dist *.tgz",
|
|
67
|
+
"test": "vitest run",
|
|
68
|
+
"lint": "eslint src --quiet --rule no-console:off --rule @typescript-eslint/no-unused-vars:off --rule sonarjs/concise-regex:off",
|
|
69
|
+
"typecheck": "tsc --noEmit"
|
|
70
|
+
}
|
|
71
|
+
}
|