@orcareplay/schema 0.1.0

package/dist/constants.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Runtime constants mirroring the normative JSON Schema in `schema/`.
+ *
+ * The TypeScript types in `types.ts` are derived from these arrays, and
+ * `test/schema-parity.test.ts` proves the arrays equal the schema enums. That gives the
+ * same drift protection as codegen without a build step that can silently break.
+ */
+export declare const SCHEMA_VERSION = "0.1.0";
+export declare const EVENT_TYPES: readonly ["run.start", "run.end", "model.request", "model.response", "tool.call", "tool.result", "mcp.request", "mcp.response", "shell.exec", "shell.result", "fs.snapshot", "fs.change", "net.request", "net.response", "error", "divergence", "checkpoint", "fork", "route.decision", "session.snapshot", "note"];
+export declare const ACTORS: readonly ["agent", "harness", "model", "orca", "gateway", "tool", "user"];
+export declare const DIVERGENCE_LEVELS: readonly ["minor", "major"];
+/** Match rungs from spec §4. Rung 1 is an exact canonical-hash match. */
+export declare const MATCH_RUNGS: readonly [1, 2, 3, 4];
+/** Payloads larger than this (serialized bytes) MUST spill to a blob. Spec §2.2. */
+export declare const INLINE_PAYLOAD_LIMIT = 4096;
+export declare const RUN_ID_PATTERN: RegExp;
+export declare const BLOB_REF_PATTERN: RegExp;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,eAAO,MAAM,WAAW,qTAsBd,CAAC;AAEX,eAAO,MAAM,MAAM,2EAA4E,CAAC;AAEhG,eAAO,MAAM,iBAAiB,6BAA8B,CAAC;AAE7D,yEAAyE;AACzE,eAAO,MAAM,WAAW,uBAAwB,CAAC;AAEjD,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,eAAO,MAAM,cAAc,QAAyB,CAAC;AACrD,eAAO,MAAM,gBAAgB,QAA0B,CAAC"}

package/dist/constants.js

@@ -0,0 +1,40 @@
+/**
+ * Runtime constants mirroring the normative JSON Schema in `schema/`.
+ *
+ * The TypeScript types in `types.ts` are derived from these arrays, and
+ * `test/schema-parity.test.ts` proves the arrays equal the schema enums. That gives the
+ * same drift protection as codegen without a build step that can silently break.
+ */
+export const SCHEMA_VERSION = '0.1.0';
+export const EVENT_TYPES = [
+    'run.start',
+    'run.end',
+    'model.request',
+    'model.response',
+    'tool.call',
+    'tool.result',
+    'mcp.request',
+    'mcp.response',
+    'shell.exec',
+    'shell.result',
+    'fs.snapshot',
+    'fs.change',
+    'net.request',
+    'net.response',
+    'error',
+    'divergence',
+    'checkpoint',
+    'fork',
+    'route.decision',
+    'session.snapshot',
+    'note',
+];
+export const ACTORS = ['agent', 'harness', 'model', 'orca', 'gateway', 'tool', 'user'];
+export const DIVERGENCE_LEVELS = ['minor', 'major'];
+/** Match rungs from spec §4. Rung 1 is an exact canonical-hash match. */
+export const MATCH_RUNGS = [1, 2, 3, 4];
+/** Payloads larger than this (serialized bytes) MUST spill to a blob. Spec §2.2. */
+export const INLINE_PAYLOAD_LIMIT = 4096;
+export const RUN_ID_PATTERN = /^run_[0-9a-f]{6,32}$/;
+export const BLOB_REF_PATTERN = /^sha256:[0-9a-f]{64}$/;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW;IACX,SAAS;IACT,eAAe;IACf,gBAAgB;IAChB,WAAW;IACX,aAAa;IACb,aAAa;IACb,cAAc;IACd,YAAY;IACZ,cAAc;IACd,aAAa;IACb,WAAW;IACX,aAAa;IACb,cAAc;IACd,OAAO;IACP,YAAY;IACZ,YAAY;IACZ,MAAM;IACN,gBAAgB;IAChB,kBAAkB;IAClB,MAAM;CACE,CAAC;AAEX,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAEhG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,OAAO,CAAU,CAAC;AAE7D,yEAAyE;AACzE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,CAAC;AAEjD,oFAAoF;AACpF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC,MAAM,CAAC,MAAM,cAAc,GAAG,sBAAsB,CAAC;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './constants.js';
+export * from './types.js';
+export * from './validate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './constants.js';
+export * from './types.js';
+export * from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+import type { ACTORS, DIVERGENCE_LEVELS, EVENT_TYPES } from './constants.js';
+export type EventType = (typeof EVENT_TYPES)[number];
+export type Actor = (typeof ACTORS)[number];
+export type DivergenceLevel = (typeof DIVERGENCE_LEVELS)[number];
+/** A reference to a content-addressed payload. Spec §2.2. */
+export interface BlobRef {
+    $blob: string;
+    bytes: number;
+    media_type?: string;
+}
+export type Payload = BlobRef | Record<string, unknown> | unknown[] | string | number | boolean;
+/** One line of events.jsonl. Spec §2.1. */
+export interface TraceEvent {
+    seq: number;
+    ts: string;
+    mono_us: number;
+    turn: number;
+    type: EventType;
+    actor: Actor;
+    causes?: number[];
+    attrs?: Record<string, unknown>;
+    payload?: Payload;
+    redacted?: string[];
+}
+export interface AdapterInfo {
+    id: string;
+    version?: string;
+    harness_version?: string;
+}
+export interface GitInfo {
+    head?: string;
+    branch?: string;
+    dirty?: boolean;
+}
+export interface Manifest {
+    schema_version: string;
+    run_id: string;
+    created_at: string;
+    ended_at?: string;
+    orca_version: string;
+    adapter: AdapterInfo;
+    argv: string[];
+    cwd: string;
+    env_allowlisted?: Record<string, string>;
+    git?: GitInfo;
+    platform?: {
+        os: string;
+        arch: string;
+        node: string;
+    };
+    counts?: {
+        events: number;
+        blobs: number;
+    };
+    redaction?: {
+        policy_version: number;
+        rules_fired?: Record<string, number>;
+    };
+    /** Set on forked runs. */
+    parent_run?: string;
+    fork_point?: number;
+    fork_model?: string;
+    exit_code?: number;
+    integrity?: {
+        events_sha256: string;
+        blob_count: number;
+    };
+}
+export interface RedactionRecord {
+    rule: string;
+    identifier: string;
+    placeholder: string;
+    count: number;
+}
+export interface RedactionsFile {
+    policy_version: number;
+    records: RedactionRecord[];
+}
+export declare function isBlobRef(value: unknown): value is BlobRef;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7E,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5C,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,6DAA6D;AAC7D,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhG,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,SAAS,CAAC,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC7E,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAO1D"}

package/dist/types.js

@@ -0,0 +1,7 @@
+export function isBlobRef(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.$blob === 'string' &&
+        typeof value.bytes === 'number');
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA2EA,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAiB,CAAC,KAAK,KAAK,QAAQ;QAC5C,OAAQ,KAAiB,CAAC,KAAK,KAAK,QAAQ,CAC7C,CAAC;AACJ,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,13 @@
+import type { Manifest, TraceEvent } from './types.js';
+declare const eventSchema: Record<string, unknown>;
+declare const manifestSchema: Record<string, unknown>;
+export { eventSchema, manifestSchema };
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare function validateEvent(value: unknown): ValidationResult;
+export declare function validateManifest(value: unknown): ValidationResult;
+export declare function assertEvent(value: unknown): asserts value is TraceEvent;
+export declare function assertManifest(value: unknown): asserts value is Manifest;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAKvD,QAAA,MAAM,WAAW,EAA6C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACtF,QAAA,MAAM,cAAc,EAAgD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5F,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;AAQvC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAWD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAE9D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAEjE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAGvE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAGxE"}

package/dist/validate.js

@@ -0,0 +1,38 @@
+import { createRequire } from 'node:module';
+import { Ajv2020 } from 'ajv/dist/2020.js';
+import addFormats from 'ajv-formats';
+const require = createRequire(import.meta.url);
+/* eslint-disable @typescript-eslint/no-var-requires */
+const eventSchema = require('../schema/event.schema.json');
+const manifestSchema = require('../schema/manifest.schema.json');
+export { eventSchema, manifestSchema };
+const ajv = new Ajv2020({ allErrors: true, strict: false });
+addFormats.default(ajv);
+const validateEventFn = ajv.compile(eventSchema);
+const validateManifestFn = ajv.compile(manifestSchema);
+function toResult(ok, errors) {
+    if (ok)
+        return { valid: true, errors: [] };
+    const list = errors ?? [];
+    return {
+        valid: false,
+        errors: list.map((e) => `${e.instancePath || '/'} ${e.message ?? 'invalid'}`.trim()),
+    };
+}
+export function validateEvent(value) {
+    return toResult(validateEventFn(value), validateEventFn.errors);
+}
+export function validateManifest(value) {
+    return toResult(validateManifestFn(value), validateManifestFn.errors);
+}
+export function assertEvent(value) {
+    const r = validateEvent(value);
+    if (!r.valid)
+        throw new Error(`invalid trace event: ${r.errors.join('; ')}`);
+}
+export function assertManifest(value) {
+    const r = validateManifest(value);
+    if (!r.valid)
+        throw new Error(`invalid manifest: ${r.errors.join('; ')}`);
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,UAAU,MAAM,aAAa,CAAC;AAGrC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,uDAAuD;AACvD,MAAM,WAAW,GAAG,OAAO,CAAC,6BAA6B,CAA4B,CAAC;AACtF,MAAM,cAAc,GAAG,OAAO,CAAC,gCAAgC,CAA4B,CAAC;AAE5F,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;AAEvC,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5D,UAAU,CAAC,OAAO,CAAC,GAAY,CAAC,CAAC;AAEjC,MAAM,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AACjD,MAAM,kBAAkB,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;AAOvD,SAAS,QAAQ,CAAC,EAAW,EAAE,MAAe;IAC5C,IAAI,EAAE;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAI,MAA+D,IAAI,EAAE,CAAC;IACpF,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC;KACrF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAY,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,QAAQ,CAAC,kBAAkB,CAAC,KAAK,CAAY,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,MAAM,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@orcareplay/schema",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "Apache-2.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./schema/*": "./schema/*"
+  },
+  "files": [
+    "dist",
+    "schema"
+  ],
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1"
+  }
+}

package/schema/event.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://orcareplay.dev/schema/v0/event.schema.json",
+  "title": "Orca Trace Event",
+  "type": "object",
+  "required": ["seq", "ts", "mono_us", "turn", "type", "actor"],
+  "additionalProperties": false,
+  "properties": {
+    "seq": { "type": "integer", "minimum": 0 },
+    "ts": { "type": "string", "format": "date-time" },
+    "mono_us": { "type": "integer", "minimum": 0 },
+    "turn": { "type": "integer", "minimum": 0 },
+    "type": {
+      "type": "string",
+      "enum": [
+        "run.start",
+        "run.end",
+        "model.request",
+        "model.response",
+        "tool.call",
+        "tool.result",
+        "mcp.request",
+        "mcp.response",
+        "shell.exec",
+        "shell.result",
+        "fs.snapshot",
+        "fs.change",
+        "net.request",
+        "net.response",
+        "error",
+        "divergence",
+        "checkpoint",
+        "fork",
+        "route.decision",
+        "session.snapshot",
+        "note"
+      ]
+    },
+    "actor": {
+      "type": "string",
+      "enum": ["agent", "harness", "model", "orca", "gateway", "tool", "user"]
+    },
+    "causes": { "type": "array", "items": { "type": "integer", "minimum": 0 } },
+    "attrs": { "type": "object" },
+    "payload": {
+      "oneOf": [
+        { "$ref": "#/$defs/blobRef" },
+        { "not": { "type": "object", "required": ["$blob"] } }
+      ]
+    },
+    "redacted": { "type": "array", "items": { "type": "string" } }
+  },
+  "$defs": {
+    "blobRef": {
+      "type": "object",
+      "required": ["$blob", "bytes"],
+      "additionalProperties": false,
+      "properties": {
+        "$blob": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+        "bytes": { "type": "integer", "minimum": 0 },
+        "media_type": { "type": "string" }
+      }
+    }
+  }
+}

package/schema/manifest.schema.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://orcareplay.dev/schema/v0/manifest.schema.json",
+  "title": "Orca Trace Manifest",
+  "type": "object",
+  "required": ["schema_version", "run_id", "created_at", "orca_version", "adapter", "argv", "cwd"],
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": { "type": "string" },
+    "run_id": { "type": "string", "pattern": "^run_[0-9a-f]{6,32}$" },
+    "created_at": { "type": "string", "format": "date-time" },
+    "ended_at": { "type": "string", "format": "date-time" },
+    "orca_version": { "type": "string" },
+    "adapter": {
+      "type": "object",
+      "required": ["id"],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string" },
+        "version": { "type": "string" },
+        "harness_version": { "type": "string" }
+      }
+    },
+    "argv": { "type": "array", "items": { "type": "string" } },
+    "cwd": { "type": "string" },
+    "env_allowlisted": { "type": "object", "additionalProperties": { "type": "string" } },
+    "git": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "head": { "type": "string" },
+        "branch": { "type": "string" },
+        "dirty": { "type": "boolean" }
+      }
+    },
+    "platform": {
+      "type": "object",
+      "required": ["os", "arch", "node"],
+      "additionalProperties": false,
+      "properties": {
+        "os": { "type": "string" },
+        "arch": { "type": "string" },
+        "node": { "type": "string" }
+      }
+    },
+    "counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": { "events": { "type": "integer" }, "blobs": { "type": "integer" } }
+    },
+    "redaction": {
+      "type": "object",
+      "required": ["policy_version"],
+      "additionalProperties": false,
+      "properties": {
+        "policy_version": { "type": "integer" },
+        "rules_fired": { "type": "object", "additionalProperties": { "type": "integer" } }
+      }
+    },
+    "parent_run": { "type": "string", "pattern": "^run_[0-9a-f]{6,32}$" },
+    "fork_point": { "type": "integer", "minimum": 0 },
+    "fork_model": { "type": "string" },
+    "exit_code": { "type": "integer" },
+    "integrity": {
+      "type": "object",
+      "required": ["events_sha256", "blob_count"],
+      "additionalProperties": false,
+      "properties": {
+        "events_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "blob_count": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}