@obora/runtime 0.1.0

package/dist/state/snapshot/snapshot-serializer.d.ts

@@ -0,0 +1 @@
+export * from "../../_legacy/blackboard/snapshot/snapshot-serializer.js";

package/dist/state/snapshot/snapshot-validator.d.ts

@@ -0,0 +1 @@
+export * from "../../_legacy/blackboard/snapshot/snapshot-validator.js";

package/dist/state/snapshot/type-guards.d.ts

@@ -0,0 +1 @@
+export * from "../../_legacy/blackboard/snapshot/type-guards.js";

package/dist/state/snapshot/types.d.ts

@@ -0,0 +1 @@
+export * from "../../_legacy/blackboard/snapshot/types.js";

package/dist/state/snapshot/utils.d.ts

@@ -0,0 +1 @@
+export * from "../../_legacy/blackboard/snapshot/utils.js";

package/dist/state/tkg.d.ts

@@ -0,0 +1 @@
+export * from "../_legacy/blackboard/core/tkg.js";

package/dist/state/types/agent.d.ts

@@ -0,0 +1 @@
+export * from "../../_legacy/blackboard/types/agent.js";

package/dist/state/types/base.d.ts

@@ -0,0 +1 @@
+export * from "../../_legacy/blackboard/types/base.js";

package/dist/state/types/blackboard.d.ts

@@ -0,0 +1 @@
+export * from "../../_legacy/blackboard/types/blackboard.js";

package/dist/state/types/decision.d.ts

@@ -0,0 +1 @@
+export * from "../../_legacy/blackboard/types/decision.js";

package/dist/state/types/index.d.ts

@@ -0,0 +1 @@
+export * from "../../_legacy/blackboard/types/index.js";

package/dist/state/types/knowledge.d.ts

@@ -0,0 +1 @@
+export * from "../../_legacy/blackboard/types/knowledge.js";

package/dist/state/types/message.d.ts

@@ -0,0 +1 @@
+export * from "../../_legacy/blackboard/types/message.js";

package/dist/state/types/task.d.ts

@@ -0,0 +1 @@
+export * from "../../_legacy/blackboard/types/task.js";

package/dist/state/types/tkg.d.ts

@@ -0,0 +1 @@
+export * from "../../_legacy/blackboard/types/tkg.js";

package/dist/state/versioning.d.ts

@@ -0,0 +1 @@
+export * from "../_legacy/blackboard/core/versioning.js";

package/dist/storage/index.d.ts

@@ -0,0 +1,3 @@
+export type { StorageAdapter, RunRecord, StepRecord, ArtifactRecord, RunFilter, CheckpointRecord, CostRecord, CostSummary, StructuredAuditEvent, Checkpointable, CheckpointableFactory, ResumeOptions, } from "./types.js";
+export { InMemoryStorageAdapter } from "./inmemory-adapter.js";
+export { SQLiteStorageAdapter, type SQLiteStorageAdapterOptions } from "./sqlite-adapter.js";

package/dist/storage/inmemory-adapter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * M6-01: InMemoryStorageAdapter — Test/dev adapter
+ */
+import type { StorageAdapter, RunRecord, StepRecord, ArtifactRecord, RunFilter, CheckpointRecord, CostRecord, CostSummary, StructuredAuditEvent } from "./types.js";
+export declare class InMemoryStorageAdapter implements StorageAdapter {
+    private readonly runs;
+    private readonly steps;
+    private readonly artifacts;
+    private readonly checkpoints;
+    private readonly costs;
+    private readonly auditEvents;
+    saveRun(record: RunRecord): Promise<void>;
+    getRun(runId: string): Promise<RunRecord | null>;
+    listRuns(filter: RunFilter): Promise<RunRecord[]>;
+    saveStep(record: StepRecord): Promise<void>;
+    getSteps(runId: string): Promise<StepRecord[]>;
+    saveArtifact(record: ArtifactRecord): Promise<ArtifactRecord>;
+    getArtifacts(runId: string, stepName?: string): Promise<ArtifactRecord[]>;
+    deleteArtifact(artifactId: string): Promise<void>;
+    saveCheckpoint(record: CheckpointRecord): Promise<void>;
+    getLatestCheckpoint(runId: string): Promise<CheckpointRecord | null>;
+    saveCost(record: CostRecord): Promise<void>;
+    getCosts(runId: string, stepName?: string): Promise<CostRecord[]>;
+    getRunCostSummary(runId: string): Promise<CostSummary>;
+    saveAuditEvent(event: StructuredAuditEvent): Promise<void>;
+    getAuditTimeline(runId: string, stepName?: string): Promise<StructuredAuditEvent[]>;
+}

package/dist/storage/sqlite-adapter.d.ts

@@ -0,0 +1,43 @@
+/**
+ * M6-01: SQLiteStorageAdapter — Default persistence adapter using better-sqlite3
+ */
+import type { StorageAdapter, RunRecord, StepRecord, ArtifactRecord, RunFilter, CheckpointRecord, CostRecord, CostSummary, StructuredAuditEvent } from "./types.js";
+export interface SQLiteStorageAdapterOptions {
+    path: string;
+}
+export declare class SQLiteStorageAdapter implements StorageAdapter {
+    private readonly options;
+    private db;
+    private initialized;
+    constructor(options: SQLiteStorageAdapterOptions);
+    private ensureInitialized;
+    private createTables;
+    saveRun(record: RunRecord): Promise<void>;
+    getRun(runId: string): Promise<RunRecord | null>;
+    listRuns(filter: RunFilter): Promise<RunRecord[]>;
+    saveStep(record: StepRecord): Promise<void>;
+    getSteps(runId: string): Promise<StepRecord[]>;
+    saveArtifact(record: ArtifactRecord): Promise<ArtifactRecord>;
+    getArtifacts(runId: string, stepName?: string): Promise<ArtifactRecord[]>;
+    deleteArtifact(artifactId: string): Promise<void>;
+    saveCheckpoint(record: CheckpointRecord): Promise<void>;
+    getLatestCheckpoint(runId: string): Promise<CheckpointRecord | null>;
+    saveCost(record: CostRecord): Promise<void>;
+    getCosts(runId: string, stepName?: string): Promise<CostRecord[]>;
+    getRunCostSummary(runId: string): Promise<CostSummary>;
+    saveAuditEvent(event: StructuredAuditEvent): Promise<void>;
+    getAuditTimeline(runId: string, stepName?: string): Promise<StructuredAuditEvent[]>;
+    private toCheckpointRecord;
+    /** Close the database connection */
+    close(): void;
+    /**
+     * Safely parse a JSON string, returning a descriptive error on failure
+     * instead of crashing with a generic SyntaxError.
+     */
+    private safeJsonParse;
+    private toRunRecord;
+    private toStepRecord;
+    private toArtifactRecord;
+    private toCostRecord;
+    private toStructuredAuditEvent;
+}

package/dist/storage/types.d.ts

@@ -0,0 +1,129 @@
+/**
+ * M6-01: Run Persistence Layer — Core types
+ *
+ * SSOT: m6-production-memory-design.md § T1 핵심 인터페이스
+ */
+export interface RunRecord {
+    id: string;
+    workflowName: string;
+    status: "running" | "completed" | "failed" | "suspended" | "aborted";
+    input: Record<string, unknown>;
+    startedAt: string;
+    completedAt?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface StepRecord {
+    id: string;
+    runId: string;
+    stepName: string;
+    status: "running" | "completed" | "failed" | "skipped";
+    input?: Record<string, unknown>;
+    output?: Record<string, unknown>;
+    error?: {
+        code: string;
+        message: string;
+        stack?: string;
+    };
+    startedAt: string;
+    completedAt?: string;
+    durationMs?: number;
+}
+export interface ArtifactRecord {
+    id: string;
+    runId: string;
+    stepName: string;
+    name: string;
+    mimeType: string;
+    sizeBytes: number;
+    storageRef: string;
+    createdAt: string;
+    deletedAt?: string;
+}
+export interface RunFilter {
+    status?: RunRecord["status"];
+    workflowName?: string;
+    from?: string;
+    to?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface CheckpointRecord {
+    id: string;
+    runId: string;
+    stepName: string;
+    stateSnapshot: unknown;
+    completedSteps: string[];
+    policyHash: string;
+    createdAt: string;
+}
+export interface CostRecord {
+    id: string;
+    runId: string;
+    stepName: string;
+    model: string;
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    costUsd: number;
+    latencyMs: number;
+    createdAt: string;
+}
+export interface CostSummary {
+    totalTokens: number;
+    totalCostUsd: number;
+    byStep: Array<{
+        stepName: string;
+        tokens: number;
+        costUsd: number;
+    }>;
+    byModel: Array<{
+        model: string;
+        tokens: number;
+        costUsd: number;
+    }>;
+}
+export interface StructuredAuditEvent {
+    id: string;
+    runId: string;
+    stepName: string;
+    timestamp: string;
+    category: "consensus" | "policy" | "execution" | "recovery";
+    action: string;
+    actor: string;
+    detail: Record<string, unknown>;
+    vote?: {
+        decision: "approve" | "reject" | "abstain";
+        confidence?: number;
+        reasoning?: string;
+    };
+}
+export interface Checkpointable {
+    readonly schemaVersion: number;
+    toCheckpoint(): Record<string, unknown> & {
+        schemaVersion: number;
+    };
+}
+export interface CheckpointableFactory<T> {
+    fromCheckpoint(snapshot: Record<string, unknown>): T;
+}
+export interface ResumeOptions {
+    fromStep?: string;
+    driftPolicy?: "reject" | "warn" | "ignore";
+}
+export interface StorageAdapter {
+    saveRun(record: RunRecord): Promise<void>;
+    getRun(runId: string): Promise<RunRecord | null>;
+    listRuns(filter: RunFilter): Promise<RunRecord[]>;
+    saveStep(record: StepRecord): Promise<void>;
+    getSteps(runId: string): Promise<StepRecord[]>;
+    saveArtifact(record: ArtifactRecord): Promise<ArtifactRecord>;
+    getArtifacts(runId: string, stepName?: string): Promise<ArtifactRecord[]>;
+    deleteArtifact(artifactId: string): Promise<void>;
+    saveCheckpoint(record: CheckpointRecord): Promise<void>;
+    getLatestCheckpoint(runId: string): Promise<CheckpointRecord | null>;
+    saveCost(record: CostRecord): Promise<void>;
+    getCosts(runId: string, stepName?: string): Promise<CostRecord[]>;
+    getRunCostSummary(runId: string): Promise<CostSummary>;
+    saveAuditEvent(event: StructuredAuditEvent): Promise<void>;
+    getAuditTimeline(runId: string, stepName?: string): Promise<StructuredAuditEvent[]>;
+}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@obora/runtime",
+  "version": "0.1.0",
+  "description": "AI Control Runtime — deterministic orchestration for non-deterministic AI",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/__tests__/**",
+    "!dist/**/*.test.*",
+    "!dist/**/*-e2e.test.*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly --declaration --declarationMap false --outDir dist --noCheck",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.typecheck.json"
+  },
+  "dependencies": {
+    "@mariozechner/pi-agent-core": "^0.52.12",
+    "@mariozechner/pi-ai": "^0.52.12",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "pako": "^2.1.0",
+    "yaml": "^2.8.2"
+  },
+  "devDependencies": {
+    "@obora/adapters": "workspace:*",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.0.0",
+    "@types/pako": "^2.0.4",
+    "better-sqlite3": "^12.6.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.9"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "ai",
+    "runtime",
+    "control",
+    "orchestration",
+    "policy",
+    "audit",
+    "multi-agent"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/obora-labs/obora-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/obora-labs/obora-kit/issues"
+  },
+  "homepage": "https://github.com/obora-labs/obora-kit#readme",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}