@runfile-ai/schemas 0.2.0 → 0.5.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/dist/canonical.d.ts +29 -3
- package/dist/canonical.d.ts.map +1 -1
- package/dist/canonical.js +43 -5
- package/dist/canonical.js.map +1 -1
- package/dist/event.d.ts +108 -78
- package/dist/event.d.ts.map +1 -1
- package/dist/event.js +21 -8
- package/dist/event.js.map +1 -1
- package/dist/evidence.d.ts +115 -90
- package/dist/evidence.d.ts.map +1 -1
- package/dist/ingest.d.ts +326 -221
- package/dist/ingest.d.ts.map +1 -1
- package/dist/ingest.js +2 -0
- package/dist/ingest.js.map +1 -1
- package/dist/manifest.d.ts +2 -2
- package/generated/json-schema/event.json +22 -3
- package/generated/json-schema/evidence.json +22 -3
- package/generated/json-schema/ingest.json +20 -3
- package/package.json +1 -1
package/dist/canonical.d.ts
CHANGED
|
@@ -21,10 +21,36 @@ export { stringify as canonicalStringify };
|
|
|
21
21
|
*/
|
|
22
22
|
export declare function canonicalSha256(value: unknown): string;
|
|
23
23
|
/**
|
|
24
|
-
*
|
|
24
|
+
* Fields NOT covered by `event_hash`.
|
|
25
25
|
*
|
|
26
|
-
*
|
|
27
|
-
*
|
|
26
|
+
* The hash commits to the SDK-authored capture fields only — never the
|
|
27
|
+
* server-set ones. This is what makes the chain work end to end:
|
|
28
|
+
* - the SDK can reproduce the hash, so `prev_event_hash_intent` (the previous
|
|
29
|
+
* event's `event_hash` as the SDK computed it) is a real integrity claim,
|
|
30
|
+
* not noise — a mismatch is a genuine `chain_break`;
|
|
31
|
+
* - fields written AFTER the hash is computed (`merkle_inclusion` by the
|
|
32
|
+
* Merkle Builder, server-appended `anomaly_flags`) don't retroactively
|
|
33
|
+
* invalidate it, so the Verifier re-checks the same bytes the server hashed.
|
|
34
|
+
*
|
|
35
|
+
* Exclusion-based (not a whitelist) so additive minor-version fields are
|
|
36
|
+
* hash-protected automatically. This set is the cross-language chain contract —
|
|
37
|
+
* the TS reference here, `canonical.go`, and `canonical.py` MUST agree, and the
|
|
38
|
+
* Verifier CLI must use the same projection. Changing it is chain-breaking:
|
|
39
|
+
* bump the schema major and re-anchor.
|
|
40
|
+
*/
|
|
41
|
+
export declare const NON_HASHED_EVENT_FIELDS: readonly ["event_hash", "tenant_id", "received_at", "anomaly_flags", "merkle_inclusion", "prev_event_hash_intent"];
|
|
42
|
+
/**
|
|
43
|
+
* Projects an event onto the fields covered by `event_hash` — i.e. drops the
|
|
44
|
+
* server-set / transport-only fields in {@link NON_HASHED_EVENT_FIELDS}. Every
|
|
45
|
+
* consumer hashes `canonicalEventForHash(event)`, so they agree regardless of
|
|
46
|
+
* which server-set fields happen to be present on the object.
|
|
47
|
+
*/
|
|
48
|
+
export declare function canonicalEventForHash<T extends {
|
|
49
|
+
event_hash?: unknown;
|
|
50
|
+
}>(event: T): Record<string, unknown>;
|
|
51
|
+
/**
|
|
52
|
+
* Computes the `event_hash` for a RunfileEvent: SHA-256 over the canonical JSON
|
|
53
|
+
* of {@link canonicalEventForHash}(event).
|
|
28
54
|
*/
|
|
29
55
|
export declare function computeEventHash<T extends {
|
|
30
56
|
event_hash?: unknown;
|
package/dist/canonical.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMhD;AAED,+EAA+E;AAC/E,OAAO,EAAE,SAAS,IAAI,kBAAkB,EAAE,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,
|
|
1
|
+
{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMhD;AAED,+EAA+E;AAC/E,OAAO,EAAE,SAAS,IAAI,kBAAkB,EAAE,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,uBAAuB,oHAO1B,CAAC;AAIX;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,EACtE,KAAK,EAAE,CAAC,GACP,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAErF"}
|
package/dist/canonical.js
CHANGED
|
@@ -34,13 +34,51 @@ function sha256Hex(input) {
|
|
|
34
34
|
return createHash('sha256').update(input).digest('hex');
|
|
35
35
|
}
|
|
36
36
|
/**
|
|
37
|
-
*
|
|
37
|
+
* Fields NOT covered by `event_hash`.
|
|
38
38
|
*
|
|
39
|
-
*
|
|
40
|
-
*
|
|
39
|
+
* The hash commits to the SDK-authored capture fields only — never the
|
|
40
|
+
* server-set ones. This is what makes the chain work end to end:
|
|
41
|
+
* - the SDK can reproduce the hash, so `prev_event_hash_intent` (the previous
|
|
42
|
+
* event's `event_hash` as the SDK computed it) is a real integrity claim,
|
|
43
|
+
* not noise — a mismatch is a genuine `chain_break`;
|
|
44
|
+
* - fields written AFTER the hash is computed (`merkle_inclusion` by the
|
|
45
|
+
* Merkle Builder, server-appended `anomaly_flags`) don't retroactively
|
|
46
|
+
* invalidate it, so the Verifier re-checks the same bytes the server hashed.
|
|
47
|
+
*
|
|
48
|
+
* Exclusion-based (not a whitelist) so additive minor-version fields are
|
|
49
|
+
* hash-protected automatically. This set is the cross-language chain contract —
|
|
50
|
+
* the TS reference here, `canonical.go`, and `canonical.py` MUST agree, and the
|
|
51
|
+
* Verifier CLI must use the same projection. Changing it is chain-breaking:
|
|
52
|
+
* bump the schema major and re-anchor.
|
|
53
|
+
*/
|
|
54
|
+
export const NON_HASHED_EVENT_FIELDS = [
|
|
55
|
+
'event_hash', // the hash field itself
|
|
56
|
+
'tenant_id', // server-resolved from the API key, never SDK-sent
|
|
57
|
+
'received_at', // server receive stamp
|
|
58
|
+
'anomaly_flags', // server may append flags after the hash is computed
|
|
59
|
+
'merkle_inclusion', // populated later by the Merkle Builder
|
|
60
|
+
'prev_event_hash_intent', // wire-only advisory; the hash commits to prev_event_hash
|
|
61
|
+
];
|
|
62
|
+
const NON_HASHED = new Set(NON_HASHED_EVENT_FIELDS);
|
|
63
|
+
/**
|
|
64
|
+
* Projects an event onto the fields covered by `event_hash` — i.e. drops the
|
|
65
|
+
* server-set / transport-only fields in {@link NON_HASHED_EVENT_FIELDS}. Every
|
|
66
|
+
* consumer hashes `canonicalEventForHash(event)`, so they agree regardless of
|
|
67
|
+
* which server-set fields happen to be present on the object.
|
|
68
|
+
*/
|
|
69
|
+
export function canonicalEventForHash(event) {
|
|
70
|
+
const out = {};
|
|
71
|
+
for (const [key, value] of Object.entries(event)) {
|
|
72
|
+
if (!NON_HASHED.has(key))
|
|
73
|
+
out[key] = value;
|
|
74
|
+
}
|
|
75
|
+
return out;
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Computes the `event_hash` for a RunfileEvent: SHA-256 over the canonical JSON
|
|
79
|
+
* of {@link canonicalEventForHash}(event).
|
|
41
80
|
*/
|
|
42
81
|
export function computeEventHash(event) {
|
|
43
|
-
|
|
44
|
-
return canonicalSha256(rest);
|
|
82
|
+
return canonicalSha256(canonicalEventForHash(event));
|
|
45
83
|
}
|
|
46
84
|
//# sourceMappingURL=canonical.js.map
|
package/dist/canonical.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,UAAU,EAAmB,MAAM,aAAa,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,SAAS,CAAC,iEAAiE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAC/E,OAAO,EAAE,SAAS,IAAI,kBAAkB,EAAE,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,UAAU,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,SAAS,SAAS,CAAC,KAAiB;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,
|
|
1
|
+
{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,UAAU,EAAmB,MAAM,aAAa,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,SAAS,CAAC,iEAAiE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAC/E,OAAO,EAAE,SAAS,IAAI,kBAAkB,EAAE,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,UAAU,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,SAAS,SAAS,CAAC,KAAiB;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,YAAY,EAAE,qCAAqC;IACnD,WAAW,EAAE,iEAAiE;IAC9E,aAAa,EAAE,mCAAmC;IAClD,eAAe,EAAE,+DAA+D;IAChF,kBAAkB,EAAE,+CAA+C;IACnE,wBAAwB,EAAE,2DAA2D;CAC7E,CAAC;AAEX,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,uBAAuB,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAQ;IAER,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC7C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAqC,KAAQ;IAC3E,OAAO,eAAe,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;AACvD,CAAC"}
|
package/dist/event.d.ts
CHANGED
|
@@ -257,15 +257,18 @@ export type RedactionApplied = z.infer<typeof RedactionAppliedSchema>;
|
|
|
257
257
|
export declare const PayloadEncryptionSchema: z.ZodObject<{
|
|
258
258
|
algorithm: z.ZodLiteral<"aes-256-gcm">;
|
|
259
259
|
data_key_wrapped: z.ZodString;
|
|
260
|
-
|
|
260
|
+
key_id: z.ZodOptional<z.ZodString>;
|
|
261
|
+
nonce: z.ZodString;
|
|
261
262
|
}, "strict", z.ZodTypeAny, {
|
|
262
263
|
algorithm: "aes-256-gcm";
|
|
263
264
|
data_key_wrapped: string;
|
|
264
|
-
|
|
265
|
+
nonce: string;
|
|
266
|
+
key_id?: string | undefined;
|
|
265
267
|
}, {
|
|
266
268
|
algorithm: "aes-256-gcm";
|
|
267
269
|
data_key_wrapped: string;
|
|
268
|
-
|
|
270
|
+
nonce: string;
|
|
271
|
+
key_id?: string | undefined;
|
|
269
272
|
}>;
|
|
270
273
|
export type PayloadEncryption = z.infer<typeof PayloadEncryptionSchema>;
|
|
271
274
|
export declare const PayloadRefSchema: z.ZodObject<{
|
|
@@ -275,15 +278,18 @@ export declare const PayloadRefSchema: z.ZodObject<{
|
|
|
275
278
|
encryption: z.ZodObject<{
|
|
276
279
|
algorithm: z.ZodLiteral<"aes-256-gcm">;
|
|
277
280
|
data_key_wrapped: z.ZodString;
|
|
278
|
-
|
|
281
|
+
key_id: z.ZodOptional<z.ZodString>;
|
|
282
|
+
nonce: z.ZodString;
|
|
279
283
|
}, "strict", z.ZodTypeAny, {
|
|
280
284
|
algorithm: "aes-256-gcm";
|
|
281
285
|
data_key_wrapped: string;
|
|
282
|
-
|
|
286
|
+
nonce: string;
|
|
287
|
+
key_id?: string | undefined;
|
|
283
288
|
}, {
|
|
284
289
|
algorithm: "aes-256-gcm";
|
|
285
290
|
data_key_wrapped: string;
|
|
286
|
-
|
|
291
|
+
nonce: string;
|
|
292
|
+
key_id?: string | undefined;
|
|
287
293
|
}>;
|
|
288
294
|
content_type: z.ZodOptional<z.ZodEnum<["application/json", "text/plain", "application/vnd.runfile.llm-request+json", "application/vnd.runfile.llm-response+json", "application/vnd.runfile.tool-call+json", "application/vnd.runfile.tool-result+json", "application/vnd.runfile.state-snapshot+json", "application/vnd.runfile.framework-signal+json"]>>;
|
|
289
295
|
redaction_applied: z.ZodOptional<z.ZodObject<{
|
|
@@ -306,7 +312,8 @@ export declare const PayloadRefSchema: z.ZodObject<{
|
|
|
306
312
|
encryption: {
|
|
307
313
|
algorithm: "aes-256-gcm";
|
|
308
314
|
data_key_wrapped: string;
|
|
309
|
-
|
|
315
|
+
nonce: string;
|
|
316
|
+
key_id?: string | undefined;
|
|
310
317
|
};
|
|
311
318
|
content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
|
|
312
319
|
redaction_applied?: {
|
|
@@ -321,7 +328,8 @@ export declare const PayloadRefSchema: z.ZodObject<{
|
|
|
321
328
|
encryption: {
|
|
322
329
|
algorithm: "aes-256-gcm";
|
|
323
330
|
data_key_wrapped: string;
|
|
324
|
-
|
|
331
|
+
nonce: string;
|
|
332
|
+
key_id?: string | undefined;
|
|
325
333
|
};
|
|
326
334
|
content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
|
|
327
335
|
redaction_applied?: {
|
|
@@ -393,18 +401,18 @@ export declare const OtelAttributesSchema: z.ZodObject<{
|
|
|
393
401
|
extra?: Record<string, string | number | boolean> | undefined;
|
|
394
402
|
}>;
|
|
395
403
|
export type OtelAttributes = z.infer<typeof OtelAttributesSchema>;
|
|
396
|
-
export declare const AnomalyCodeEnum: z.ZodEnum<["missing_ambient_context", "chain_break", "out_of_order_arrival", "model_version_drift", "unknown_agent_identity", "data_classification_mismatch", "policy_threshold_without_hitl", "unauthorized_tool_invocation", "redaction_policy_mismatch", "schema_version_warning", "agent_identity_mismatch_with_run", "suspension_sla_exceeded", "apparent_crash_detected", "active_duration_exceeds_threshold", "framework_signal_unrecognised", "otel_attribute_missing", "delegation_loop_detected"]>;
|
|
404
|
+
export declare const AnomalyCodeEnum: z.ZodEnum<["missing_ambient_context", "chain_break", "sequence_gap", "causality_violation", "out_of_order_arrival", "model_version_drift", "unknown_agent_identity", "data_classification_mismatch", "policy_threshold_without_hitl", "unauthorized_tool_invocation", "redaction_policy_mismatch", "schema_version_warning", "agent_identity_mismatch_with_run", "suspension_sla_exceeded", "apparent_crash_detected", "active_duration_exceeds_threshold", "framework_signal_unrecognised", "otel_attribute_missing", "delegation_loop_detected"]>;
|
|
397
405
|
export declare const AnomalySeverityEnum: z.ZodEnum<["info", "warning", "error", "critical"]>;
|
|
398
406
|
export declare const AnomalyFlagSchema: z.ZodObject<{
|
|
399
|
-
code: z.ZodEnum<["missing_ambient_context", "chain_break", "out_of_order_arrival", "model_version_drift", "unknown_agent_identity", "data_classification_mismatch", "policy_threshold_without_hitl", "unauthorized_tool_invocation", "redaction_policy_mismatch", "schema_version_warning", "agent_identity_mismatch_with_run", "suspension_sla_exceeded", "apparent_crash_detected", "active_duration_exceeds_threshold", "framework_signal_unrecognised", "otel_attribute_missing", "delegation_loop_detected"]>;
|
|
407
|
+
code: z.ZodEnum<["missing_ambient_context", "chain_break", "sequence_gap", "causality_violation", "out_of_order_arrival", "model_version_drift", "unknown_agent_identity", "data_classification_mismatch", "policy_threshold_without_hitl", "unauthorized_tool_invocation", "redaction_policy_mismatch", "schema_version_warning", "agent_identity_mismatch_with_run", "suspension_sla_exceeded", "apparent_crash_detected", "active_duration_exceeds_threshold", "framework_signal_unrecognised", "otel_attribute_missing", "delegation_loop_detected"]>;
|
|
400
408
|
severity: z.ZodEnum<["info", "warning", "error", "critical"]>;
|
|
401
409
|
detail: z.ZodOptional<z.ZodString>;
|
|
402
410
|
}, "strict", z.ZodTypeAny, {
|
|
403
|
-
code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
411
|
+
code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
404
412
|
severity: "info" | "warning" | "error" | "critical";
|
|
405
413
|
detail?: string | undefined;
|
|
406
414
|
}, {
|
|
407
|
-
code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
415
|
+
code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
408
416
|
severity: "info" | "warning" | "error" | "critical";
|
|
409
417
|
detail?: string | undefined;
|
|
410
418
|
}>;
|
|
@@ -615,10 +623,10 @@ export declare const RunfileRunSchema: z.ZodObject<{
|
|
|
615
623
|
merkle_root: string;
|
|
616
624
|
}>, "many">>;
|
|
617
625
|
}, "strict", z.ZodTypeAny, {
|
|
626
|
+
tenant_id: string;
|
|
618
627
|
agent_identity: string;
|
|
619
628
|
run_id: string;
|
|
620
629
|
schema_version: string;
|
|
621
|
-
tenant_id: string;
|
|
622
630
|
lifecycle_state: "awaiting_webhook" | "awaiting_schedule" | "active" | "awaiting_human" | "ended";
|
|
623
631
|
started_at: string;
|
|
624
632
|
redaction_policy_version: string;
|
|
@@ -670,10 +678,10 @@ export declare const RunfileRunSchema: z.ZodObject<{
|
|
|
670
678
|
merkle_root: string;
|
|
671
679
|
}[] | undefined;
|
|
672
680
|
}, {
|
|
681
|
+
tenant_id: string;
|
|
673
682
|
agent_identity: string;
|
|
674
683
|
run_id: string;
|
|
675
684
|
schema_version: string;
|
|
676
|
-
tenant_id: string;
|
|
677
685
|
lifecycle_state: "awaiting_webhook" | "awaiting_schedule" | "active" | "awaiting_human" | "ended";
|
|
678
686
|
started_at: string;
|
|
679
687
|
redaction_policy_version: string;
|
|
@@ -727,10 +735,13 @@ export declare const RunfileRunSchema: z.ZodObject<{
|
|
|
727
735
|
}>;
|
|
728
736
|
export type RunfileRun = z.infer<typeof RunfileRunSchema>;
|
|
729
737
|
/**
|
|
730
|
-
* RunfileEvent — a single action captured within a Run.
|
|
731
|
-
*
|
|
732
|
-
* `
|
|
733
|
-
* `
|
|
738
|
+
* RunfileEvent — a single action captured within a Run. Ordered within a process segment
|
|
739
|
+
* by `local_seq` (a monotonic capture counter the SDK assigns) and hash-chained in that
|
|
740
|
+
* order via `prev_event_hash` → `event_hash`; the total order within a segment is
|
|
741
|
+
* `(run_id, segment_index, local_seq)`. Causally linked via `parent_event_id` (the
|
|
742
|
+
* execution DAG); concurrent operations grouped via `parallel_group_id`. Segments
|
|
743
|
+
* (separated by suspend/resume) are stitched by the `run_resume` event's `prev_event_hash`
|
|
744
|
+
* referencing the `run_suspend` event. Committed to a daily Merkle root.
|
|
734
745
|
*
|
|
735
746
|
* Conditional-required fields (enforced via superRefine below):
|
|
736
747
|
* - kind=llm_call → model_ref required
|
|
@@ -749,6 +760,8 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
749
760
|
run_id: z.ZodString;
|
|
750
761
|
parent_event_id: z.ZodNullable<z.ZodString>;
|
|
751
762
|
parallel_group_id: z.ZodOptional<z.ZodString>;
|
|
763
|
+
segment_index: z.ZodNumber;
|
|
764
|
+
local_seq: z.ZodNumber;
|
|
752
765
|
captured_at: z.ZodString;
|
|
753
766
|
received_at: z.ZodString;
|
|
754
767
|
wall_clock_source: z.ZodEnum<["aws_time_sync", "ntp", "host_system", "unknown"]>;
|
|
@@ -986,15 +999,18 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
986
999
|
encryption: z.ZodObject<{
|
|
987
1000
|
algorithm: z.ZodLiteral<"aes-256-gcm">;
|
|
988
1001
|
data_key_wrapped: z.ZodString;
|
|
989
|
-
|
|
1002
|
+
key_id: z.ZodOptional<z.ZodString>;
|
|
1003
|
+
nonce: z.ZodString;
|
|
990
1004
|
}, "strict", z.ZodTypeAny, {
|
|
991
1005
|
algorithm: "aes-256-gcm";
|
|
992
1006
|
data_key_wrapped: string;
|
|
993
|
-
|
|
1007
|
+
nonce: string;
|
|
1008
|
+
key_id?: string | undefined;
|
|
994
1009
|
}, {
|
|
995
1010
|
algorithm: "aes-256-gcm";
|
|
996
1011
|
data_key_wrapped: string;
|
|
997
|
-
|
|
1012
|
+
nonce: string;
|
|
1013
|
+
key_id?: string | undefined;
|
|
998
1014
|
}>;
|
|
999
1015
|
content_type: z.ZodOptional<z.ZodEnum<["application/json", "text/plain", "application/vnd.runfile.llm-request+json", "application/vnd.runfile.llm-response+json", "application/vnd.runfile.tool-call+json", "application/vnd.runfile.tool-result+json", "application/vnd.runfile.state-snapshot+json", "application/vnd.runfile.framework-signal+json"]>>;
|
|
1000
1016
|
redaction_applied: z.ZodOptional<z.ZodObject<{
|
|
@@ -1017,7 +1033,8 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1017
1033
|
encryption: {
|
|
1018
1034
|
algorithm: "aes-256-gcm";
|
|
1019
1035
|
data_key_wrapped: string;
|
|
1020
|
-
|
|
1036
|
+
nonce: string;
|
|
1037
|
+
key_id?: string | undefined;
|
|
1021
1038
|
};
|
|
1022
1039
|
content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
|
|
1023
1040
|
redaction_applied?: {
|
|
@@ -1032,7 +1049,8 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1032
1049
|
encryption: {
|
|
1033
1050
|
algorithm: "aes-256-gcm";
|
|
1034
1051
|
data_key_wrapped: string;
|
|
1035
|
-
|
|
1052
|
+
nonce: string;
|
|
1053
|
+
key_id?: string | undefined;
|
|
1036
1054
|
};
|
|
1037
1055
|
content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
|
|
1038
1056
|
redaction_applied?: {
|
|
@@ -1105,15 +1123,15 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1105
1123
|
redaction_policy_version: z.ZodString;
|
|
1106
1124
|
regulatory_scope_version: z.ZodOptional<z.ZodString>;
|
|
1107
1125
|
anomaly_flags: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
1108
|
-
code: z.ZodEnum<["missing_ambient_context", "chain_break", "out_of_order_arrival", "model_version_drift", "unknown_agent_identity", "data_classification_mismatch", "policy_threshold_without_hitl", "unauthorized_tool_invocation", "redaction_policy_mismatch", "schema_version_warning", "agent_identity_mismatch_with_run", "suspension_sla_exceeded", "apparent_crash_detected", "active_duration_exceeds_threshold", "framework_signal_unrecognised", "otel_attribute_missing", "delegation_loop_detected"]>;
|
|
1126
|
+
code: z.ZodEnum<["missing_ambient_context", "chain_break", "sequence_gap", "causality_violation", "out_of_order_arrival", "model_version_drift", "unknown_agent_identity", "data_classification_mismatch", "policy_threshold_without_hitl", "unauthorized_tool_invocation", "redaction_policy_mismatch", "schema_version_warning", "agent_identity_mismatch_with_run", "suspension_sla_exceeded", "apparent_crash_detected", "active_duration_exceeds_threshold", "framework_signal_unrecognised", "otel_attribute_missing", "delegation_loop_detected"]>;
|
|
1109
1127
|
severity: z.ZodEnum<["info", "warning", "error", "critical"]>;
|
|
1110
1128
|
detail: z.ZodOptional<z.ZodString>;
|
|
1111
1129
|
}, "strict", z.ZodTypeAny, {
|
|
1112
|
-
code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
1130
|
+
code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
1113
1131
|
severity: "info" | "warning" | "error" | "critical";
|
|
1114
1132
|
detail?: string | undefined;
|
|
1115
1133
|
}, {
|
|
1116
|
-
code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
1134
|
+
code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
1117
1135
|
severity: "info" | "warning" | "error" | "critical";
|
|
1118
1136
|
detail?: string | undefined;
|
|
1119
1137
|
}>, "many">>;
|
|
@@ -1136,14 +1154,16 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1136
1154
|
}>>;
|
|
1137
1155
|
}, "strict", z.ZodTypeAny, {
|
|
1138
1156
|
event_hash: string;
|
|
1157
|
+
tenant_id: string;
|
|
1158
|
+
received_at: string;
|
|
1139
1159
|
run_id: string;
|
|
1140
1160
|
event_id: string;
|
|
1141
1161
|
schema_version: string;
|
|
1142
|
-
tenant_id: string;
|
|
1143
1162
|
redaction_policy_version: string;
|
|
1144
1163
|
parent_event_id: string | null;
|
|
1164
|
+
segment_index: number;
|
|
1165
|
+
local_seq: number;
|
|
1145
1166
|
captured_at: string;
|
|
1146
|
-
received_at: string;
|
|
1147
1167
|
wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
|
|
1148
1168
|
sdk: {
|
|
1149
1169
|
framework: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "manual" | "langgraph_js" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "pydantic_ai" | "crewai" | "mcp_client" | "otel_generic";
|
|
@@ -1168,6 +1188,16 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1168
1188
|
duration_ms?: number | undefined;
|
|
1169
1189
|
};
|
|
1170
1190
|
prev_event_hash: string;
|
|
1191
|
+
anomaly_flags?: {
|
|
1192
|
+
code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
1193
|
+
severity: "info" | "warning" | "error" | "critical";
|
|
1194
|
+
detail?: string | undefined;
|
|
1195
|
+
}[] | undefined;
|
|
1196
|
+
merkle_inclusion?: {
|
|
1197
|
+
manifest_uri: string;
|
|
1198
|
+
leaf_index: number;
|
|
1199
|
+
merkle_root: string;
|
|
1200
|
+
} | undefined;
|
|
1171
1201
|
decision?: {
|
|
1172
1202
|
outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
|
|
1173
1203
|
outcome_label?: string | undefined;
|
|
@@ -1232,7 +1262,8 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1232
1262
|
encryption: {
|
|
1233
1263
|
algorithm: "aes-256-gcm";
|
|
1234
1264
|
data_key_wrapped: string;
|
|
1235
|
-
|
|
1265
|
+
nonce: string;
|
|
1266
|
+
key_id?: string | undefined;
|
|
1236
1267
|
};
|
|
1237
1268
|
content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
|
|
1238
1269
|
redaction_applied?: {
|
|
@@ -1262,26 +1293,18 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1262
1293
|
gen_ai_conversation_id?: string | undefined;
|
|
1263
1294
|
extra?: Record<string, string | number | boolean> | undefined;
|
|
1264
1295
|
} | undefined;
|
|
1265
|
-
anomaly_flags?: {
|
|
1266
|
-
code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
1267
|
-
severity: "info" | "warning" | "error" | "critical";
|
|
1268
|
-
detail?: string | undefined;
|
|
1269
|
-
}[] | undefined;
|
|
1270
|
-
merkle_inclusion?: {
|
|
1271
|
-
manifest_uri: string;
|
|
1272
|
-
leaf_index: number;
|
|
1273
|
-
merkle_root: string;
|
|
1274
|
-
} | undefined;
|
|
1275
1296
|
}, {
|
|
1276
1297
|
event_hash: string;
|
|
1298
|
+
tenant_id: string;
|
|
1299
|
+
received_at: string;
|
|
1277
1300
|
run_id: string;
|
|
1278
1301
|
event_id: string;
|
|
1279
1302
|
schema_version: string;
|
|
1280
|
-
tenant_id: string;
|
|
1281
1303
|
redaction_policy_version: string;
|
|
1282
1304
|
parent_event_id: string | null;
|
|
1305
|
+
segment_index: number;
|
|
1306
|
+
local_seq: number;
|
|
1283
1307
|
captured_at: string;
|
|
1284
|
-
received_at: string;
|
|
1285
1308
|
wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
|
|
1286
1309
|
sdk: {
|
|
1287
1310
|
framework: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "manual" | "langgraph_js" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "pydantic_ai" | "crewai" | "mcp_client" | "otel_generic";
|
|
@@ -1306,6 +1329,16 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1306
1329
|
duration_ms?: number | undefined;
|
|
1307
1330
|
};
|
|
1308
1331
|
prev_event_hash: string;
|
|
1332
|
+
anomaly_flags?: {
|
|
1333
|
+
code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
1334
|
+
severity: "info" | "warning" | "error" | "critical";
|
|
1335
|
+
detail?: string | undefined;
|
|
1336
|
+
}[] | undefined;
|
|
1337
|
+
merkle_inclusion?: {
|
|
1338
|
+
manifest_uri: string;
|
|
1339
|
+
leaf_index: number;
|
|
1340
|
+
merkle_root: string;
|
|
1341
|
+
} | undefined;
|
|
1309
1342
|
decision?: {
|
|
1310
1343
|
outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
|
|
1311
1344
|
outcome_label?: string | undefined;
|
|
@@ -1370,7 +1403,8 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1370
1403
|
encryption: {
|
|
1371
1404
|
algorithm: "aes-256-gcm";
|
|
1372
1405
|
data_key_wrapped: string;
|
|
1373
|
-
|
|
1406
|
+
nonce: string;
|
|
1407
|
+
key_id?: string | undefined;
|
|
1374
1408
|
};
|
|
1375
1409
|
content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
|
|
1376
1410
|
redaction_applied?: {
|
|
@@ -1400,26 +1434,18 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1400
1434
|
gen_ai_conversation_id?: string | undefined;
|
|
1401
1435
|
extra?: Record<string, string | number | boolean> | undefined;
|
|
1402
1436
|
} | undefined;
|
|
1403
|
-
anomaly_flags?: {
|
|
1404
|
-
code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
1405
|
-
severity: "info" | "warning" | "error" | "critical";
|
|
1406
|
-
detail?: string | undefined;
|
|
1407
|
-
}[] | undefined;
|
|
1408
|
-
merkle_inclusion?: {
|
|
1409
|
-
manifest_uri: string;
|
|
1410
|
-
leaf_index: number;
|
|
1411
|
-
merkle_root: string;
|
|
1412
|
-
} | undefined;
|
|
1413
1437
|
}>, {
|
|
1414
1438
|
event_hash: string;
|
|
1439
|
+
tenant_id: string;
|
|
1440
|
+
received_at: string;
|
|
1415
1441
|
run_id: string;
|
|
1416
1442
|
event_id: string;
|
|
1417
1443
|
schema_version: string;
|
|
1418
|
-
tenant_id: string;
|
|
1419
1444
|
redaction_policy_version: string;
|
|
1420
1445
|
parent_event_id: string | null;
|
|
1446
|
+
segment_index: number;
|
|
1447
|
+
local_seq: number;
|
|
1421
1448
|
captured_at: string;
|
|
1422
|
-
received_at: string;
|
|
1423
1449
|
wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
|
|
1424
1450
|
sdk: {
|
|
1425
1451
|
framework: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "manual" | "langgraph_js" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "pydantic_ai" | "crewai" | "mcp_client" | "otel_generic";
|
|
@@ -1444,6 +1470,16 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1444
1470
|
duration_ms?: number | undefined;
|
|
1445
1471
|
};
|
|
1446
1472
|
prev_event_hash: string;
|
|
1473
|
+
anomaly_flags?: {
|
|
1474
|
+
code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
1475
|
+
severity: "info" | "warning" | "error" | "critical";
|
|
1476
|
+
detail?: string | undefined;
|
|
1477
|
+
}[] | undefined;
|
|
1478
|
+
merkle_inclusion?: {
|
|
1479
|
+
manifest_uri: string;
|
|
1480
|
+
leaf_index: number;
|
|
1481
|
+
merkle_root: string;
|
|
1482
|
+
} | undefined;
|
|
1447
1483
|
decision?: {
|
|
1448
1484
|
outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
|
|
1449
1485
|
outcome_label?: string | undefined;
|
|
@@ -1508,7 +1544,8 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1508
1544
|
encryption: {
|
|
1509
1545
|
algorithm: "aes-256-gcm";
|
|
1510
1546
|
data_key_wrapped: string;
|
|
1511
|
-
|
|
1547
|
+
nonce: string;
|
|
1548
|
+
key_id?: string | undefined;
|
|
1512
1549
|
};
|
|
1513
1550
|
content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
|
|
1514
1551
|
redaction_applied?: {
|
|
@@ -1538,26 +1575,18 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1538
1575
|
gen_ai_conversation_id?: string | undefined;
|
|
1539
1576
|
extra?: Record<string, string | number | boolean> | undefined;
|
|
1540
1577
|
} | undefined;
|
|
1541
|
-
anomaly_flags?: {
|
|
1542
|
-
code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
1543
|
-
severity: "info" | "warning" | "error" | "critical";
|
|
1544
|
-
detail?: string | undefined;
|
|
1545
|
-
}[] | undefined;
|
|
1546
|
-
merkle_inclusion?: {
|
|
1547
|
-
manifest_uri: string;
|
|
1548
|
-
leaf_index: number;
|
|
1549
|
-
merkle_root: string;
|
|
1550
|
-
} | undefined;
|
|
1551
1578
|
}, {
|
|
1552
1579
|
event_hash: string;
|
|
1580
|
+
tenant_id: string;
|
|
1581
|
+
received_at: string;
|
|
1553
1582
|
run_id: string;
|
|
1554
1583
|
event_id: string;
|
|
1555
1584
|
schema_version: string;
|
|
1556
|
-
tenant_id: string;
|
|
1557
1585
|
redaction_policy_version: string;
|
|
1558
1586
|
parent_event_id: string | null;
|
|
1587
|
+
segment_index: number;
|
|
1588
|
+
local_seq: number;
|
|
1559
1589
|
captured_at: string;
|
|
1560
|
-
received_at: string;
|
|
1561
1590
|
wall_clock_source: "unknown" | "aws_time_sync" | "ntp" | "host_system";
|
|
1562
1591
|
sdk: {
|
|
1563
1592
|
framework: "langgraph" | "openai_agents" | "claude_agent_sdk" | "vercel_ai_sdk" | "manual" | "langgraph_js" | "openai_agents_js" | "anthropic_claude" | "anthropic_claude_js" | "mastra" | "pydantic_ai" | "crewai" | "mcp_client" | "otel_generic";
|
|
@@ -1582,6 +1611,16 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1582
1611
|
duration_ms?: number | undefined;
|
|
1583
1612
|
};
|
|
1584
1613
|
prev_event_hash: string;
|
|
1614
|
+
anomaly_flags?: {
|
|
1615
|
+
code: "missing_ambient_context" | "chain_break" | "sequence_gap" | "causality_violation" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
1616
|
+
severity: "info" | "warning" | "error" | "critical";
|
|
1617
|
+
detail?: string | undefined;
|
|
1618
|
+
}[] | undefined;
|
|
1619
|
+
merkle_inclusion?: {
|
|
1620
|
+
manifest_uri: string;
|
|
1621
|
+
leaf_index: number;
|
|
1622
|
+
merkle_root: string;
|
|
1623
|
+
} | undefined;
|
|
1585
1624
|
decision?: {
|
|
1586
1625
|
outcome: "custom" | "approved" | "denied" | "escalated" | "deferred" | "no_action";
|
|
1587
1626
|
outcome_label?: string | undefined;
|
|
@@ -1646,7 +1685,8 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1646
1685
|
encryption: {
|
|
1647
1686
|
algorithm: "aes-256-gcm";
|
|
1648
1687
|
data_key_wrapped: string;
|
|
1649
|
-
|
|
1688
|
+
nonce: string;
|
|
1689
|
+
key_id?: string | undefined;
|
|
1650
1690
|
};
|
|
1651
1691
|
content_type?: "application/json" | "text/plain" | "application/vnd.runfile.llm-request+json" | "application/vnd.runfile.llm-response+json" | "application/vnd.runfile.tool-call+json" | "application/vnd.runfile.tool-result+json" | "application/vnd.runfile.state-snapshot+json" | "application/vnd.runfile.framework-signal+json" | undefined;
|
|
1652
1692
|
redaction_applied?: {
|
|
@@ -1676,16 +1716,6 @@ export declare const RunfileEventSchema: z.ZodEffects<z.ZodObject<{
|
|
|
1676
1716
|
gen_ai_conversation_id?: string | undefined;
|
|
1677
1717
|
extra?: Record<string, string | number | boolean> | undefined;
|
|
1678
1718
|
} | undefined;
|
|
1679
|
-
anomaly_flags?: {
|
|
1680
|
-
code: "missing_ambient_context" | "chain_break" | "out_of_order_arrival" | "model_version_drift" | "unknown_agent_identity" | "data_classification_mismatch" | "policy_threshold_without_hitl" | "unauthorized_tool_invocation" | "redaction_policy_mismatch" | "schema_version_warning" | "agent_identity_mismatch_with_run" | "suspension_sla_exceeded" | "apparent_crash_detected" | "active_duration_exceeds_threshold" | "framework_signal_unrecognised" | "otel_attribute_missing" | "delegation_loop_detected";
|
|
1681
|
-
severity: "info" | "warning" | "error" | "critical";
|
|
1682
|
-
detail?: string | undefined;
|
|
1683
|
-
}[] | undefined;
|
|
1684
|
-
merkle_inclusion?: {
|
|
1685
|
-
manifest_uri: string;
|
|
1686
|
-
leaf_index: number;
|
|
1687
|
-
merkle_root: string;
|
|
1688
|
-
} | undefined;
|
|
1689
1719
|
}>;
|
|
1690
1720
|
export type RunfileEvent = z.infer<typeof RunfileEventSchema>;
|
|
1691
1721
|
export declare const ZERO_PREV_HASH: `sha256:${string}`;
|
package/dist/event.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCpB,CAAC;AACL,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,cAAc,kdA4BzB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD,eAAO,MAAM,iBAAiB,sEAAoE,CAAC;AAEnG,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;EAOd,CAAC;AACZ,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,sBAAsB,iGASjC,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;EAUf,CAAC;AACZ,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,iBAAiB,+GAS5B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYhB,CAAC;AACZ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,mBAAmB,mFAO9B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;EAShB,CAAC;AACZ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAMtD,eAAO,MAAM,oBAAoB,mKAQ/B,CAAC;AAEH,eAAO,MAAM,aAAa,yGAQxB,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAMvB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,mBAAmB,mEAAiE,CAAC;AAElG,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQzB,CAAC;AACZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,iBAAiB,iLAS5B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAOrB,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,6BAA6B,4GAMxC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAOzB,CAAC;AACZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,0BAA0B,+EAKrC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAOtB,CAAC;AACZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,eAAe,8TAS1B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAMxB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,uBAAuB
|
|
1
|
+
{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"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"}
|