oxe-cc 0.9.3 → 1.0.0

package/lib/runtime/context/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./context-pack-builder"), exports);

package/lib/runtime/delivery/branch-manager.d.ts

@@ -0,0 +1,19 @@
+export interface BranchInfo {
+    name: string;
+    current: boolean;
+    commit: string;
+}
+export declare class BranchManager {
+    private readonly projectRoot;
+    constructor(projectRoot: string);
+    currentBranch(): string;
+    currentCommit(): string;
+    createSessionBranch(sessionId: string): string;
+    createOxeBranch(name: string, base?: string): string;
+    switchTo(branchName: string): void;
+    deleteBranch(name: string, force?: boolean): void;
+    listOxeBranches(): BranchInfo[];
+    mergeWorktreeBranch(worktreeBranch: string, targetBranch: string): void;
+    branchExists(name: string): boolean;
+    private git;
+}

package/lib/runtime/delivery/branch-manager.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BranchManager = void 0;
+const child_process_1 = require("child_process");
+class BranchManager {
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    currentBranch() {
+        return this.git(['rev-parse', '--abbrev-ref', 'HEAD']).trim();
+    }
+    currentCommit() {
+        return this.git(['rev-parse', 'HEAD']).trim();
+    }
+    createSessionBranch(sessionId) {
+        const name = `oxe/${sessionId}`;
+        this.git(['checkout', '-b', name]);
+        return name;
+    }
+    createOxeBranch(name, base) {
+        const fullName = name.startsWith('oxe/') ? name : `oxe/${name}`;
+        if (base) {
+            this.git(['checkout', '-b', fullName, base]);
+        }
+        else {
+            this.git(['checkout', '-b', fullName]);
+        }
+        return fullName;
+    }
+    switchTo(branchName) {
+        this.git(['checkout', branchName]);
+    }
+    deleteBranch(name, force = false) {
+        const flag = force ? '-D' : '-d';
+        this.git(['branch', flag, name]);
+    }
+    listOxeBranches() {
+        const raw = this.git(['branch', '--list', 'oxe/*', '--format=%(refname:short) %(objectname:short) %(HEAD)']);
+        return raw
+            .split('\n')
+            .filter(Boolean)
+            .map((line) => {
+            const parts = line.trim().split(/\s+/);
+            return {
+                name: parts[0],
+                commit: parts[1] ?? '',
+                current: parts[2] === '*',
+            };
+        });
+    }
+    mergeWorktreeBranch(worktreeBranch, targetBranch) {
+        const saved = this.currentBranch();
+        try {
+            this.git(['checkout', targetBranch]);
+            this.git(['merge', '--no-ff', worktreeBranch, '-m', `oxe: merge ${worktreeBranch}`]);
+        }
+        finally {
+            try {
+                this.git(['checkout', saved]);
+            }
+            catch { /* best effort */ }
+        }
+    }
+    branchExists(name) {
+        const result = (0, child_process_1.spawnSync)('git', ['rev-parse', '--verify', name], {
+            cwd: this.projectRoot,
+            encoding: 'utf8',
+        });
+        return result.status === 0;
+    }
+    git(args) {
+        return (0, child_process_1.execFileSync)('git', args, {
+            cwd: this.projectRoot,
+            encoding: 'utf8',
+        });
+    }
+}
+exports.BranchManager = BranchManager;

package/lib/runtime/delivery/ci-checks.d.ts

@@ -0,0 +1,34 @@
+import type { EvidenceStore } from '../evidence/evidence-store';
+export type CICheckStatus = 'pass' | 'fail' | 'skip' | 'error';
+export interface CICheckContext {
+    projectRoot: string;
+    sessionId: string | null;
+    runId?: string;
+    evidenceStore?: EvidenceStore;
+}
+export interface CICheckResult {
+    check: string;
+    status: CICheckStatus;
+    message: string;
+    details?: unknown;
+}
+export interface CICheck {
+    name: string;
+    description: string;
+    run(ctx: CICheckContext): Promise<CICheckResult>;
+}
+export declare const planConsistencyCheck: CICheck;
+export declare const verifyAcceptanceCheck: CICheck;
+export declare const policyCheck: CICheck;
+export declare const securityBaselineCheck: CICheck;
+export declare const runtimeEvidenceIntegrityCheck: CICheck;
+export declare const OXE_CI_CHECKS: CICheck[];
+export declare function runCIChecks(ctx: CICheckContext, checks?: CICheck[]): Promise<CICheckResult[]>;
+export declare function summarizeCIResults(results: CICheckResult[]): {
+    total: number;
+    pass: number;
+    fail: number;
+    skip: number;
+    error: number;
+    allPassed: boolean;
+};

package/lib/runtime/delivery/ci-checks.js

@@ -0,0 +1,209 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OXE_CI_CHECKS = exports.runtimeEvidenceIntegrityCheck = exports.securityBaselineCheck = exports.policyCheck = exports.verifyAcceptanceCheck = exports.planConsistencyCheck = void 0;
+exports.runCIChecks = runCIChecks;
+exports.summarizeCIResults = summarizeCIResults;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+// ─── Check: plan-consistency ─────────────────────────────────────────────────
+exports.planConsistencyCheck = {
+    name: 'oxe-plan-consistency',
+    description: 'Verifies ACTIVE-RUN.json exists and has a compiled ExecutionGraph',
+    async run(ctx) {
+        const activeRunPath = ctx.sessionId
+            ? path_1.default.join(ctx.projectRoot, '.oxe', ctx.sessionId, 'execution', 'ACTIVE-RUN.json')
+            : path_1.default.join(ctx.projectRoot, '.oxe', 'ACTIVE-RUN.json');
+        if (!fs_1.default.existsSync(activeRunPath)) {
+            return { check: this.name, status: 'skip', message: 'No ACTIVE-RUN.json found' };
+        }
+        try {
+            const raw = JSON.parse(fs_1.default.readFileSync(activeRunPath, 'utf8'));
+            const hasGraph = raw.compiled_graph && typeof raw.compiled_graph === 'object';
+            const hasRunId = typeof raw.run_id === 'string';
+            if (!hasRunId) {
+                return { check: this.name, status: 'fail', message: 'ACTIVE-RUN.json missing run_id', details: raw };
+            }
+            if (!hasGraph) {
+                return { check: this.name, status: 'fail', message: 'No compiled ExecutionGraph found in ACTIVE-RUN.json', details: { run_id: raw.run_id } };
+            }
+            return { check: this.name, status: 'pass', message: `Run ${String(raw.run_id)} has compiled graph` };
+        }
+        catch (err) {
+            return { check: this.name, status: 'error', message: `Failed to parse ACTIVE-RUN.json: ${String(err)}` };
+        }
+    },
+};
+// ─── Check: verify-acceptance ────────────────────────────────────────────────
+exports.verifyAcceptanceCheck = {
+    name: 'oxe-verify-acceptance',
+    description: 'Checks that VERIFY.md exists and contains no failed criteria',
+    async run(ctx) {
+        const verifyPath = ctx.sessionId
+            ? path_1.default.join(ctx.projectRoot, '.oxe', ctx.sessionId, 'verification', 'VERIFY.md')
+            : path_1.default.join(ctx.projectRoot, '.oxe', 'VERIFY.md');
+        if (!fs_1.default.existsSync(verifyPath)) {
+            return { check: this.name, status: 'skip', message: 'No VERIFY.md found — run /oxe-verify first' };
+        }
+        const content = fs_1.default.readFileSync(verifyPath, 'utf8');
+        const failLines = content.split('\n').filter((l) => l.includes('✗ FAIL'));
+        const passLines = content.split('\n').filter((l) => l.includes('✓ PASS'));
+        if (failLines.length > 0) {
+            return {
+                check: this.name,
+                status: 'fail',
+                message: `${failLines.length} acceptance criteria failed`,
+                details: { failed: failLines, passed: passLines.length },
+            };
+        }
+        if (passLines.length === 0) {
+            return { check: this.name, status: 'skip', message: 'VERIFY.md has no pass/fail markers' };
+        }
+        return { check: this.name, status: 'pass', message: `${passLines.length} acceptance criteria passed` };
+    },
+};
+// ─── Check: policy ───────────────────────────────────────────────────────────
+exports.policyCheck = {
+    name: 'oxe-policy',
+    description: 'Checks that no gates are pending (unresolved human approval)',
+    async run(ctx) {
+        const gatesPath = ctx.sessionId
+            ? path_1.default.join(ctx.projectRoot, '.oxe', ctx.sessionId, 'execution', 'GATES.json')
+            : path_1.default.join(ctx.projectRoot, '.oxe', 'execution', 'GATES.json');
+        if (!fs_1.default.existsSync(gatesPath)) {
+            return { check: this.name, status: 'pass', message: 'No pending gates' };
+        }
+        try {
+            const gates = JSON.parse(fs_1.default.readFileSync(gatesPath, 'utf8'));
+            const pending = gates.filter((g) => g.status === 'pending');
+            if (pending.length > 0) {
+                return {
+                    check: this.name,
+                    status: 'fail',
+                    message: `${pending.length} unresolved gate(s)`,
+                    details: pending.map((g) => ({ gate_id: g.gate_id, scope: g.scope })),
+                };
+            }
+            return { check: this.name, status: 'pass', message: 'All gates resolved' };
+        }
+        catch (err) {
+            return { check: this.name, status: 'error', message: `Failed to read GATES.json: ${String(err)}` };
+        }
+    },
+};
+// ─── Check: security-baseline ────────────────────────────────────────────────
+const SECRET_PATTERNS = [
+    /(?:password|passwd|secret|api[_-]?key|auth[_-]?token)\s*[:=]\s*['"]?\S{8,}/i,
+    /(?:AKIA|ASIA)[A-Z0-9]{16}/,
+    /-----BEGIN (?:RSA|EC|OPENSSH) PRIVATE KEY-----/,
+];
+exports.securityBaselineCheck = {
+    name: 'oxe-security-baseline',
+    description: 'Scans evidence artifacts for common secret patterns',
+    async run(ctx) {
+        if (!ctx.evidenceStore || !ctx.runId) {
+            return { check: this.name, status: 'skip', message: 'No evidence store or run ID provided' };
+        }
+        const evidenceDir = path_1.default.join(ctx.projectRoot, '.oxe', 'evidence', 'runs', ctx.runId);
+        if (!fs_1.default.existsSync(evidenceDir)) {
+            return { check: this.name, status: 'skip', message: 'No evidence found for this run' };
+        }
+        const findings = [];
+        walkDir(evidenceDir, (filePath) => {
+            if (filePath.endsWith('.json') || filePath.endsWith('.patch') || filePath.endsWith('.txt')) {
+                try {
+                    const content = fs_1.default.readFileSync(filePath, 'utf8');
+                    for (const pattern of SECRET_PATTERNS) {
+                        if (pattern.test(content)) {
+                            findings.push(`${path_1.default.basename(filePath)}: matches pattern ${pattern.source.slice(0, 40)}`);
+                            break;
+                        }
+                    }
+                }
+                catch { /* skip unreadable */ }
+            }
+        });
+        if (findings.length > 0) {
+            return { check: this.name, status: 'fail', message: `Secret patterns detected in ${findings.length} evidence file(s)`, details: findings };
+        }
+        return { check: this.name, status: 'pass', message: 'No secret patterns detected in evidence' };
+    },
+};
+// ─── Check: runtime-evidence-integrity ───────────────────────────────────────
+exports.runtimeEvidenceIntegrityCheck = {
+    name: 'oxe-runtime-evidence-integrity',
+    description: 'Validates that all evidence index files are valid JSON and files exist on disk',
+    async run(ctx) {
+        if (!ctx.runId) {
+            return { check: this.name, status: 'skip', message: 'No run ID provided' };
+        }
+        const runEvidenceDir = path_1.default.join(ctx.projectRoot, '.oxe', 'evidence', 'runs', ctx.runId);
+        if (!fs_1.default.existsSync(runEvidenceDir)) {
+            return { check: this.name, status: 'skip', message: 'No evidence directory for this run' };
+        }
+        const errors = [];
+        let indexCount = 0;
+        let evidenceCount = 0;
+        walkDir(runEvidenceDir, (filePath) => {
+            if (path_1.default.basename(filePath) !== 'index.json')
+                return;
+            indexCount++;
+            try {
+                const items = JSON.parse(fs_1.default.readFileSync(filePath, 'utf8'));
+                for (const item of items) {
+                    evidenceCount++;
+                    const absPath = path_1.default.join(ctx.projectRoot, item.path);
+                    if (!fs_1.default.existsSync(absPath)) {
+                        errors.push(`Missing file for ${item.evidence_id}: ${item.path}`);
+                    }
+                }
+            }
+            catch (err) {
+                errors.push(`Corrupt index at ${filePath}: ${String(err)}`);
+            }
+        });
+        if (errors.length > 0) {
+            return { check: this.name, status: 'fail', message: `${errors.length} integrity error(s)`, details: errors };
+        }
+        return {
+            check: this.name,
+            status: indexCount === 0 ? 'skip' : 'pass',
+            message: `${evidenceCount} evidence artifact(s) across ${indexCount} index(es) — all valid`,
+        };
+    },
+};
+// ─── Suite ───────────────────────────────────────────────────────────────────
+exports.OXE_CI_CHECKS = [
+    exports.planConsistencyCheck,
+    exports.verifyAcceptanceCheck,
+    exports.policyCheck,
+    exports.securityBaselineCheck,
+    exports.runtimeEvidenceIntegrityCheck,
+];
+async function runCIChecks(ctx, checks = exports.OXE_CI_CHECKS) {
+    const results = [];
+    for (const check of checks) {
+        results.push(await check.run(ctx));
+    }
+    return results;
+}
+function summarizeCIResults(results) {
+    const counts = { total: results.length, pass: 0, fail: 0, skip: 0, error: 0 };
+    for (const r of results)
+        counts[r.status]++;
+    return { ...counts, allPassed: counts.fail === 0 && counts.error === 0 };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function walkDir(dir, visitor) {
+    if (!fs_1.default.existsSync(dir))
+        return;
+    for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+        const full = path_1.default.join(dir, entry.name);
+        if (entry.isDirectory())
+            walkDir(full, visitor);
+        else
+            visitor(full);
+    }
+}

package/lib/runtime/delivery/index.d.ts

@@ -0,0 +1,3 @@
+export * from './branch-manager';
+export * from './pr-manager';
+export * from './ci-checks';

package/lib/runtime/delivery/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./branch-manager"), exports);
+__exportStar(require("./pr-manager"), exports);
+__exportStar(require("./ci-checks"), exports);

package/lib/runtime/delivery/pr-manager.d.ts

@@ -0,0 +1,30 @@
+export interface PRDraftOptions {
+    title: string;
+    body: string;
+    base?: string;
+    head?: string;
+    draft?: boolean;
+}
+export interface PRInfo {
+    number: number;
+    title: string;
+    url: string;
+    state: string;
+    draft: boolean;
+    head: string;
+    base: string;
+}
+export interface PRResult {
+    success: boolean;
+    url?: string;
+    error?: string;
+    pr?: PRInfo;
+}
+export declare class PRManager {
+    private readonly projectRoot;
+    constructor(projectRoot: string);
+    isAvailable(): boolean;
+    createDraft(opts: PRDraftOptions): PRResult;
+    view(prNumberOrUrl: string | number): PRResult;
+    mergePR(prNumber: number, method?: 'merge' | 'squash' | 'rebase'): PRResult;
+}

package/lib/runtime/delivery/pr-manager.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRManager = void 0;
+const child_process_1 = require("child_process");
+function isGhAvailable(cwd) {
+    const result = (0, child_process_1.spawnSync)('gh', ['--version'], { cwd, encoding: 'utf8' });
+    return result.status === 0;
+}
+class PRManager {
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    isAvailable() {
+        return isGhAvailable(this.projectRoot);
+    }
+    createDraft(opts) {
+        if (!this.isAvailable()) {
+            return { success: false, error: 'gh CLI not available — install from https://cli.github.com' };
+        }
+        const args = [
+            'pr', 'create',
+            '--title', opts.title,
+            '--body', opts.body,
+        ];
+        if (opts.draft !== false)
+            args.push('--draft');
+        if (opts.base)
+            args.push('--base', opts.base);
+        if (opts.head)
+            args.push('--head', opts.head);
+        const result = (0, child_process_1.spawnSync)('gh', args, {
+            cwd: this.projectRoot,
+            encoding: 'utf8',
+        });
+        if (result.status !== 0) {
+            return { success: false, error: result.stderr?.trim() ?? 'gh pr create failed' };
+        }
+        const url = result.stdout?.trim();
+        return { success: true, url };
+    }
+    view(prNumberOrUrl) {
+        if (!this.isAvailable()) {
+            return { success: false, error: 'gh CLI not available' };
+        }
+        const result = (0, child_process_1.spawnSync)('gh', ['pr', 'view', String(prNumberOrUrl), '--json', 'number,title,url,state,isDraft,headRefName,baseRefName'], { cwd: this.projectRoot, encoding: 'utf8' });
+        if (result.status !== 0) {
+            return { success: false, error: result.stderr?.trim() };
+        }
+        try {
+            const raw = JSON.parse(result.stdout);
+            return {
+                success: true,
+                url: raw.url,
+                pr: {
+                    number: raw.number,
+                    title: raw.title,
+                    url: raw.url,
+                    state: raw.state.toLowerCase(),
+                    draft: raw.isDraft,
+                    head: raw.headRefName,
+                    base: raw.baseRefName,
+                },
+            };
+        }
+        catch {
+            return { success: false, error: 'Failed to parse gh output' };
+        }
+    }
+    mergePR(prNumber, method = 'merge') {
+        if (!this.isAvailable()) {
+            return { success: false, error: 'gh CLI not available' };
+        }
+        const result = (0, child_process_1.spawnSync)('gh', ['pr', 'merge', String(prNumber), `--${method}`, '--delete-branch'], {
+            cwd: this.projectRoot,
+            encoding: 'utf8',
+        });
+        return result.status === 0
+            ? { success: true }
+            : { success: false, error: result.stderr?.trim() };
+    }
+}
+exports.PRManager = PRManager;

package/lib/runtime/events/bus.d.ts

@@ -0,0 +1,9 @@
+import type { OxeEvent } from './envelope';
+import type { EventType } from './catalog';
+export type EventInput = Partial<Omit<OxeEvent, 'type'>> & {
+    type: EventType;
+};
+export declare function appendEvent(projectRoot: string, sessionId: string | null, input: EventInput, causationId?: string): OxeEvent;
+export declare function readEvents(projectRoot: string, sessionId: string | null): OxeEvent[];
+export declare function filterByRun(events: OxeEvent[], runId: string): OxeEvent[];
+export declare function filterByWorkItem(events: OxeEvent[], workItemId: string): OxeEvent[];

package/lib/runtime/events/bus.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appendEvent = appendEvent;
+exports.readEvents = readEvents;
+exports.filterByRun = filterByRun;
+exports.filterByWorkItem = filterByWorkItem;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+function loadOperationalModule() {
+    const candidates = [
+        path_1.default.resolve(__dirname, '../../../bin/lib/oxe-operational.cjs'),
+        path_1.default.resolve(__dirname, '../../../../bin/lib/oxe-operational.cjs'),
+        path_1.default.resolve(__dirname, '../../../../../bin/lib/oxe-operational.cjs'),
+    ];
+    for (const candidate of candidates) {
+        if (!fs_1.default.existsSync(candidate))
+            continue;
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        return require(candidate);
+    }
+    throw new Error(`Unable to locate oxe-operational.cjs from ${__dirname}`);
+}
+const operational = loadOperationalModule();
+function fromOperationalEvent(raw) {
+    return {
+        id: String(raw.event_id || ''),
+        type: String(raw.type || 'RunStarted'),
+        timestamp: String(raw.timestamp || new Date().toISOString()),
+        session_id: raw.session_id ?? null,
+        run_id: raw.run_id ?? null,
+        work_item_id: raw.work_item_id ?? raw.task_id ?? null,
+        attempt_id: raw.attempt_id ?? null,
+        causation_id: raw.causation_id ?? null,
+        correlation_id: raw.correlation_id ?? null,
+        payload: raw.payload && typeof raw.payload === 'object' ? raw.payload : {},
+    };
+}
+function appendEvent(projectRoot, sessionId, input, causationId) {
+    const event = operational.appendEvent(projectRoot, sessionId, {
+        event_id: input.id,
+        type: input.type,
+        timestamp: input.timestamp,
+        run_id: input.run_id ?? null,
+        work_item_id: input.work_item_id ?? null,
+        attempt_id: input.attempt_id ?? null,
+        causation_id: input.causation_id ?? causationId ?? null,
+        correlation_id: input.correlation_id ?? null,
+        payload: input.payload && typeof input.payload === 'object' ? input.payload : {},
+    });
+    return fromOperationalEvent(event);
+}
+function readEvents(projectRoot, sessionId) {
+    return operational.readEvents(projectRoot, sessionId).map(fromOperationalEvent);
+}
+function filterByRun(events, runId) {
+    return events.filter((e) => e.run_id === runId);
+}
+function filterByWorkItem(events, workItemId) {
+    return events.filter((e) => e.work_item_id === workItemId);
+}

package/lib/runtime/events/catalog.d.ts

@@ -0,0 +1,3 @@
+export declare const EVENT_TYPES: readonly ["SessionCreated", "RunStarted", "GraphCompiled", "WorkItemReady", "WorkspaceAllocated", "AttemptStarted", "ToolInvoked", "ToolCompleted", "ToolFailed", "EvidenceCollected", "PolicyEvaluated", "GateRequested", "GateResolved", "VerificationStarted", "VerificationCompleted", "RetryScheduled", "WorkItemCompleted", "WorkItemBlocked", "RunCompleted", "RetroPublished", "LessonPromoted"];
+export type EventType = (typeof EVENT_TYPES)[number];
+export declare function isValidEventType(type: string): type is EventType;

package/lib/runtime/events/catalog.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVENT_TYPES = void 0;
+exports.isValidEventType = isValidEventType;
+exports.EVENT_TYPES = [
+    'SessionCreated',
+    'RunStarted',
+    'GraphCompiled',
+    'WorkItemReady',
+    'WorkspaceAllocated',
+    'AttemptStarted',
+    'ToolInvoked',
+    'ToolCompleted',
+    'ToolFailed',
+    'EvidenceCollected',
+    'PolicyEvaluated',
+    'GateRequested',
+    'GateResolved',
+    'VerificationStarted',
+    'VerificationCompleted',
+    'RetryScheduled',
+    'WorkItemCompleted',
+    'WorkItemBlocked',
+    'RunCompleted',
+    'RetroPublished',
+    'LessonPromoted',
+];
+function isValidEventType(type) {
+    return exports.EVENT_TYPES.includes(type);
+}

package/lib/runtime/events/envelope.d.ts

@@ -0,0 +1,13 @@
+import type { EventType } from './catalog';
+export interface OxeEvent {
+    id: string;
+    type: EventType;
+    timestamp: string;
+    session_id: string | null;
+    run_id: string | null;
+    work_item_id: string | null;
+    attempt_id: string | null;
+    causation_id: string | null;
+    correlation_id: string | null;
+    payload: Record<string, unknown>;
+}

package/lib/runtime/events/envelope.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/runtime/events/index.d.ts

@@ -0,0 +1,3 @@
+export * from './catalog';
+export * from './envelope';
+export * from './bus';

package/lib/runtime/events/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./catalog"), exports);
+__exportStar(require("./envelope"), exports);
+__exportStar(require("./bus"), exports);