@fiducian/runtime 0.4.0

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+import { Conductor, CONTEXT_HEADER, contextFromHeader, headerFromContext, Actorchestra, actorchestra, type StoryContext, type TraceEvent, type Violation } from "@fiducian/conductor";
+import { compileMonitor, evaluateTrace } from "@fiducian/compiler";
+import { parseWaltzFile, type PropertySpec } from "@fiducian/spec";
+import { type AlertOptions } from "@fiducian/alerts";
+export interface FiduciaTraceOptions {
+    spec: PropertySpec;
+    conductor?: Conductor;
+    alerts?: AlertOptions;
+    onViolation?: (violation: Violation) => void;
+}
+export declare class FiduciaTrace {
+    readonly conductor: Conductor;
+    readonly spec: PropertySpec;
+    private monitor;
+    private violations;
+    private passedContexts;
+    private readonly alerts?;
+    private readonly onViolation?;
+    constructor(options: FiduciaTraceOptions);
+    static fromFile(specPath: string): FiduciaTrace;
+    startStory(parentContext?: string): StoryContext;
+    startStoryWithId(contextId: string, parentContext?: string): StoryContext;
+    emit(ctx: StoryContext, message: Omit<TraceEvent, "contextId" | "timestamp" | "op"> & {
+        op?: string;
+    }): TraceEvent;
+    private handleEvent;
+    getViolations(): Violation[];
+    hasPassed(contextId: string): boolean;
+    evaluateRecorded(): ReturnType<typeof evaluateTrace>;
+    exportTraceJsonl(): string;
+}
+export interface HttpLikeRequest {
+    headers: Record<string, string | string[] | undefined>;
+}
+export declare function extractContext(req: HttpLikeRequest): StoryContext | undefined;
+export declare function attachContext(ctx: StoryContext, headers: Record<string, string>): Record<string, string>;
+export declare function middleware(ct: FiduciaTrace): (req: HttpLikeRequest, run: (ctx: StoryContext) => void) => StoryContext;
+export { Conductor, CONTEXT_HEADER, contextFromHeader, headerFromContext, Actorchestra, actorchestra, compileMonitor, evaluateTrace, parseWaltzFile, };
+export type { StoryContext, TraceEvent, Violation, PropertySpec };
+export type { AlertOptions } from "@fiducian/alerts";
+export { notifyTraceResult, notifyViolations } from "@fiducian/alerts";

package/dist/index.js

@@ -0,0 +1,85 @@
+import { readFileSync } from "node:fs";
+import { Conductor, CONTEXT_HEADER, contextFromHeader, headerFromContext, Actorchestra, actorchestra, } from "@fiducian/conductor";
+import { compileMonitor, evaluateTrace } from "@fiducian/compiler";
+import { parseWaltzFile } from "@fiducian/spec";
+import { notifyViolations } from "@fiducian/alerts";
+export class FiduciaTrace {
+    conductor;
+    spec;
+    monitor;
+    violations = [];
+    passedContexts = new Set();
+    alerts;
+    onViolation;
+    constructor(options) {
+        this.conductor = options.conductor ?? new Conductor();
+        this.spec = options.spec;
+        this.alerts = options.alerts;
+        this.onViolation = options.onViolation;
+        this.monitor = compileMonitor(this.spec);
+        this.conductor.subscribe((event) => this.handleEvent(event));
+    }
+    static fromFile(specPath) {
+        const source = readFileSync(specPath, "utf8");
+        return new FiduciaTrace({ spec: parseWaltzFile(source) });
+    }
+    startStory(parentContext) {
+        return this.conductor.startStory(parentContext);
+    }
+    startStoryWithId(contextId, parentContext) {
+        return this.conductor.startStoryWithId(contextId, parentContext);
+    }
+    emit(ctx, message) {
+        return this.conductor.emit(ctx, {
+            op: message.op ?? "send",
+            from: message.from,
+            to: message.to,
+            payload: message.payload,
+        });
+    }
+    handleEvent(event) {
+        const state = this.monitor.onEvent(event);
+        if (state.violation) {
+            this.violations.push(state.violation);
+            this.onViolation?.(state.violation);
+            if (this.alerts) {
+                void notifyViolations([state.violation], this.alerts);
+            }
+        }
+        if (state.status === "passed") {
+            this.passedContexts.add(event.contextId);
+        }
+    }
+    getViolations() {
+        return [...this.violations];
+    }
+    hasPassed(contextId) {
+        return this.passedContexts.has(contextId);
+    }
+    evaluateRecorded() {
+        return evaluateTrace(this.spec, [...this.conductor.getEvents()]);
+    }
+    exportTraceJsonl() {
+        return this.conductor
+            .getEvents()
+            .map((e) => JSON.stringify(e))
+            .join("\n");
+    }
+}
+export function extractContext(req) {
+    const raw = req.headers[CONTEXT_HEADER];
+    const header = Array.isArray(raw) ? raw[0] : raw;
+    return contextFromHeader(header);
+}
+export function attachContext(ctx, headers) {
+    return { ...headers, [CONTEXT_HEADER]: headerFromContext(ctx) };
+}
+export function middleware(ct) {
+    return (req, run) => {
+        const ctx = extractContext(req) ?? ct.startStory();
+        run(ctx);
+        return ctx;
+    };
+}
+export { Conductor, CONTEXT_HEADER, contextFromHeader, headerFromContext, Actorchestra, actorchestra, compileMonitor, evaluateTrace, parseWaltzFile, };
+export { notifyTraceResult, notifyViolations } from "@fiducian/alerts";

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@fiducian/runtime",
+  "version": "0.4.0",
+  "description": "FiduciaTrace runtime integration for live causal chain checking",
+  "license": "AGPL-3.0-or-later",
+  "keywords": ["fiducia", "fiducia", "runtime", "microservices", "agents"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thesnmc/Fiducian.git",
+    "directory": "trace/packages/runtime"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": ["dist"],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@fiducian/alerts": "0.4.0",
+    "@fiducian/conductor": "0.4.0",
+    "@fiducian/compiler": "0.4.0",
+    "@fiducian/spec": "0.4.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node --test dist/**/*.test.js",
+    "prepublishOnly": "npm run build"
+  }
+}