@obora/runtime 0.1.0

package/dist/_legacy/workflow/types/workflow.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Workflow type definitions for obora-kit
+ * @module @obora/core/types/workflow
+ */
+/**
+ * Workflow execution mode
+ */
+export type WorkflowMode = "auto" | "supervised" | "gated" | "manual";
+/**
+ * Workflow configuration options
+ */
+export interface WorkflowConfig {
+    /** Number of retry attempts for failed steps */
+    retry?: number;
+    /** Delay between retries (e.g., "5s", "1m") */
+    retry_delay?: string;
+    /** Continue execution on step failure */
+    continue_on_error?: boolean;
+    /** Maximum concurrent steps */
+    max_parallel?: number;
+}
+/**
+ * Step definition within a workflow
+ */
+export type GateType = "human-approval" | "consensus" | "external";
+export interface StateBinding {
+    source: string;
+    target: string;
+    transform?: string;
+    condition?: string;
+}
+export interface ConsensusVoterSpec {
+    id: string;
+    weight?: number;
+    role?: "ai" | "human" | "service";
+    required?: boolean;
+}
+export interface ConsensusConfig {
+    type: "majority" | "unanimous" | "weighted" | "score-threshold" | "custom";
+    voters?: ConsensusVoterSpec[];
+    min?: number;
+    of?: number;
+    threshold?: number;
+    timeout?: string;
+    best_effort?: string[];
+    custom?: string;
+}
+export interface GateConfig {
+    timeout?: string;
+    fallback?: "fail" | "escalate" | "auto-approve";
+    escalation_to?: string;
+}
+export interface ToolPolicyOverride {
+    name: string;
+    effect: "allow" | "deny" | "transform" | "gate";
+}
+export interface PolicyOverride {
+    sandbox?: string;
+    tools_override?: ToolPolicyOverride[];
+}
+export type BackEdgeEscalation = "human" | "dlq" | "fail";
+export interface StepOnFailConfig {
+    goto: string;
+    max_iterations: number;
+    escalate_on_exhaust: BackEdgeEscalation;
+    cooldown_ms: number;
+    reset_state: boolean;
+    max_cost: number | null;
+    /**
+     * null means inherit `escalate_on_exhaust`.
+     */
+    max_cost_escalation: BackEdgeEscalation | null;
+}
+export interface Step {
+    /** Unique name for the step */
+    name: string;
+    /** Agent responsible for executing the step */
+    agent: string;
+    /** Optional description of the step */
+    description?: string;
+    /** Optional provider override for this step */
+    provider?: string;
+    /** Optional model override for this step */
+    model?: string;
+    /** Explicit dependencies on other steps */
+    depends_on?: string[];
+    /** Input files or artifacts required */
+    inputs?: string[];
+    /** Output files or artifacts produced */
+    outputs?: string[];
+    /** Timeout for the step (e.g., "5m", "1h") */
+    timeout?: string;
+    /** Optional skills to activate for this step */
+    skills?: string[];
+    /** Optional tool whitelist */
+    tools?: string[];
+    /** State binding declarations */
+    bindings?: StateBinding[];
+    /** Step consensus configuration */
+    consensus?: ConsensusConfig;
+    /** Step gate type */
+    gate?: GateType;
+    /** Step gate details */
+    gate_config?: GateConfig;
+    /** Collaboration pattern */
+    pattern?: string;
+    /** Pattern participant mapping */
+    participants?: Record<string, string>;
+    /** Step policy override */
+    policy?: PolicyOverride;
+    /** Conditional back-edge on failure */
+    on_fail?: StepOnFailConfig;
+    /** Step-specific configuration (legacy/backward compatibility) */
+    config?: Record<string, unknown>;
+}
+/**
+ * Complete workflow definition
+ */
+export interface AuditConfig {
+    store: "duckdb" | "sqlite" | "custom";
+    path?: string;
+    retention?: string;
+    custom?: string;
+}
+export interface RecoveryStrategyConfig {
+    on_fail: "retry" | "rollback" | "escalate" | "alternative" | "custom";
+    max_retries?: number;
+    backoff?: "linear" | "exponential";
+    backoff_base?: string;
+    to?: string;
+    fallback?: Omit<Step, "depends_on">;
+    custom?: string;
+}
+export interface Workflow {
+    /** Workflow name */
+    name: string;
+    /** Workflow version */
+    version?: string;
+    /** Optional description */
+    description?: string;
+    /** Execution mode */
+    mode?: WorkflowMode;
+    /** Global workflow configuration */
+    config?: WorkflowConfig;
+    /** Workflow-level policy path */
+    policy?: string;
+    /** List of steps */
+    steps: Step[];
+    /** Workflow-level recovery by step name */
+    recovery?: Record<string, RecoveryStrategyConfig>;
+    /** Workflow-level audit configuration */
+    audit?: AuditConfig;
+}
+/**
+ * Dependency map: step name -> list of dependency step names
+ */
+export type DependencyMap = Map<string, string[]>;
+/**
+ * Parser options
+ */
+export interface ParserOptions {
+    /** Enable strict mode (throw on unknown fields) */
+    strict?: boolean;
+    /** Callback for warnings */
+    onWarning?: (warning: string) => void;
+}
+/**
+ * Parse result with warnings
+ */
+export interface ParseResult<T> {
+    data: T;
+    warnings: string[];
+}

package/dist/_legacy/workflow/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function greet(name: string): string;
+export declare function log(message: string): void;

package/dist/_legacy/workflow/validator/workflow-validator.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Workflow validator using JSON Schema and graph analysis
+ * @module @obora/core/validator/workflow-validator
+ */
+import type { Step, Workflow } from "../types/workflow.js";
+/**
+ * Error code enum for validation errors
+ */
+export declare enum ValidationErrorCode {
+    INVALID_SCHEMA = "INVALID_SCHEMA",
+    CIRCULAR_DEPENDENCY = "CIRCULAR_DEPENDENCY",
+    MISSING_REFERENCE = "MISSING_REFERENCE",
+    SELF_REFERENCE = "SELF_REFERENCE",
+    INVALID_EXECUTION_LEVEL = "INVALID_EXECUTION_LEVEL"
+}
+/**
+ * Validation error details
+ */
+export interface ValidationError {
+    /** Error code */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** JSON path to the error location */
+    path: string;
+    /** Line number (if available) */
+    line?: number;
+    /** Column number (if available) */
+    column?: number;
+    /** Suggested fix */
+    suggestion?: string;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    isValid: boolean;
+    /** List of errors */
+    errors: ValidationError[];
+    /** List of warnings */
+    warnings: ValidationError[];
+}
+/**
+ * Validate workflow using JSON Schema
+ */
+export declare function validateSchema(workflow: unknown): ValidationError[];
+/**
+ * Check for circular dependencies using graph module
+ */
+export declare function validateCircularDependencies(steps: Step[]): ValidationError[];
+/**
+ * Check for self-references
+ */
+export declare function validateSelfReferences(steps: Step[]): ValidationError[];
+/**
+ * Check for missing references
+ */
+export declare function validateMissingReferences(steps: Step[]): ValidationError[];
+/**
+ * Check for unresolved inputs
+ */
+export declare function validateInputs(steps: Step[]): ValidationError[];
+/**
+ * Full workflow validation
+ */
+export declare function validateWorkflow(workflow: Workflow): ValidationResult;
+/**
+ * Parse and validate workflow from YAML string
+ */
+export declare function parseAndValidate(yamlContent: string): ValidationResult;

package/dist/artifacts/index.d.ts

@@ -0,0 +1,2 @@
+export type { ArtifactRecord as BlobArtifactRecord, ArtifactStore } from "./types.js";
+export { LocalFileArtifactStore } from "./local-file-artifact-store.js";

package/dist/artifacts/local-file-artifact-store.d.ts

@@ -0,0 +1,22 @@
+import type { ArtifactRecord, ArtifactStore } from "./types.js";
+interface LocalFileArtifactStoreOptions {
+    basePath?: string;
+}
+export declare class LocalFileArtifactStore implements ArtifactStore {
+    private readonly basePath;
+    constructor(options?: LocalFileArtifactStoreOptions);
+    save(runId: string, stepName: string, name: string, data: Buffer, mime: string): Promise<ArtifactRecord>;
+    get(artifactId: string): Promise<{
+        record: ArtifactRecord;
+        data: Buffer;
+    }>;
+    list(runId: string, stepName?: string): Promise<ArtifactRecord[]>;
+    delete(artifactId: string): Promise<void>;
+    private scanMetaFiles;
+    private walk;
+    private metaPath;
+    private sanitizeSegment;
+    private resolveInsideBase;
+    private cleanupIfEmpty;
+}
+export {};

package/dist/artifacts/types.d.ts

@@ -0,0 +1,19 @@
+export interface ArtifactRecord {
+    id: string;
+    runId: string;
+    stepName: string;
+    name: string;
+    mime: string;
+    size: number;
+    path: string;
+    createdAt: string;
+}
+export interface ArtifactStore {
+    save(runId: string, stepName: string, name: string, data: Buffer, mime: string): Promise<ArtifactRecord>;
+    get(artifactId: string): Promise<{
+        record: ArtifactRecord;
+        data: Buffer;
+    }>;
+    list(runId: string, stepName?: string): Promise<ArtifactRecord[]>;
+    delete(artifactId: string): Promise<void>;
+}

package/dist/audit/AuditReplay.d.ts

@@ -0,0 +1,4 @@
+import type { AuditEvent } from "./types.js";
+import type { StorageAdapter, StructuredAuditEvent } from "../storage/types.js";
+export declare function toStructuredAuditEvent(runId: string, event: AuditEvent): StructuredAuditEvent;
+export declare function persistStructuredAuditEvent(adapter: StorageAdapter | undefined, runId: string, event: AuditEvent): Promise<void>;

package/dist/audit/AuditStore.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @deprecated DuckDB-based AuditStore has been removed.
+ *
+ * For testing, use InMemoryAuditStore from './InMemoryAuditStore.js'.
+ * For production, use SQLiteStorageAdapter from '../storage/sqlite-adapter.js'.
+ *
+ * @throws Always throws an error when instantiated.
+ */
+export type { Project, WorkflowRun, StepExecution, Metric, } from "../_legacy/database/src/duckdb-client.js";
+declare class DeprecatedAuditStore {
+    constructor();
+}
+export { DeprecatedAuditStore as AuditStore };

package/dist/audit/AuditTrail.d.ts

@@ -0,0 +1,28 @@
+import type { AuditEvent, AuditFilter } from "./types.js";
+export type ReplayMode = "event-playback" | "re-execution";
+export interface ReplayOptions {
+    mode?: ReplayMode;
+    executionId: string;
+    speed?: number;
+    onEvent?: (event: AuditEvent, index: number) => void | Promise<void>;
+}
+export interface ReplayResult {
+    mode: "event-playback";
+    executionId: string;
+    totalEvents: number;
+    startedAt: Date;
+    completedAt: Date;
+    durationMs: number;
+    sequence: AuditEvent[];
+}
+export interface AuditTrail {
+    record(event: AuditEvent): Promise<void>;
+    query(filter: AuditFilter): Promise<AuditEvent[]>;
+    replay(options: ReplayOptions): Promise<ReplayResult>;
+    export(executionId: string, format: "json" | "csv"): Promise<string>;
+}
+export interface AuditRecorder {
+    recordToolCall(toolName: string, params: unknown, result: unknown, durationMs: number): Promise<void>;
+    recordStateChange(path: string, oldValue: unknown, newValue: unknown): Promise<void>;
+    recordError(code: string, message: string, context?: unknown): Promise<void>;
+}

package/dist/audit/DefaultAuditRecorder.d.ts

@@ -0,0 +1,10 @@
+import type { AuditRecorder, AuditTrail } from "./AuditTrail.js";
+export declare class DefaultAuditRecorder implements AuditRecorder {
+    private readonly trail;
+    private readonly executionId;
+    private readonly cellId;
+    constructor(trail: AuditTrail, executionId: string, cellId: string);
+    recordToolCall(toolName: string, params: unknown, result: unknown, durationMs: number): Promise<void>;
+    recordStateChange(path: string, oldValue: unknown, newValue: unknown): Promise<void>;
+    recordError(code: string, message: string, context?: unknown): Promise<void>;
+}

package/dist/audit/EventBusAdapter.d.ts

@@ -0,0 +1,12 @@
+import type { AuditTrail } from "./AuditTrail.js";
+import { EventBus } from "./event-bus.js";
+export declare class EventBusAdapter {
+    private readonly eventBus;
+    private readonly trail;
+    private readonly fallbackExecutionId;
+    private unsubscribe?;
+    constructor(eventBus: EventBus, trail: AuditTrail, fallbackExecutionId?: string);
+    start(): void;
+    stop(): void;
+    private handleEvent;
+}

package/dist/audit/InMemoryAuditStore.d.ts

@@ -0,0 +1,9 @@
+import type { AuditTrail, ReplayOptions, ReplayResult } from "./AuditTrail.js";
+import type { AuditEvent, AuditFilter } from "./types.js";
+export declare class InMemoryAuditStore implements AuditTrail {
+    private events;
+    record(event: AuditEvent): Promise<void>;
+    query(filter?: AuditFilter): Promise<AuditEvent[]>;
+    replay(options: ReplayOptions): Promise<ReplayResult>;
+    export(executionId: string, format: "json" | "csv"): Promise<string>;
+}

package/dist/audit/ReExecutionDiffReport.d.ts

@@ -0,0 +1,24 @@
+import type { AuditEvent } from "./types.js";
+import type { ReExecutionPlan } from "./ReExecutionPlanner.js";
+export interface ReExecutionDiffReport {
+    executionId: string;
+    reExecutionId?: string;
+    plan: ReExecutionPlan;
+    differences: StepDiff[];
+    summary: {
+        total_steps: number;
+        changed: number;
+        unchanged: number;
+        skipped: number;
+        new: number;
+        removed: number;
+    };
+}
+export interface StepDiff {
+    stepName: string;
+    status: "unchanged" | "changed" | "new" | "removed" | "skipped";
+    originalOutput?: unknown;
+    reExecutionOutput?: unknown;
+    diffDetails?: string;
+}
+export declare function createDiffReport(plan: ReExecutionPlan, originalEvents: AuditEvent[], reExecutionEvents?: AuditEvent[]): ReExecutionDiffReport;

package/dist/audit/ReExecutionPlanner.d.ts

@@ -0,0 +1,30 @@
+import type { AuditTrail } from "./AuditTrail.js";
+export interface ReExecutionPlan {
+    executionId: string;
+    originalWorkflow: string;
+    workflowVersion?: string;
+    snapshotRef?: string;
+    mode: "full" | "from_checkpoint";
+    startFromStep?: string;
+    restoredState?: Record<string, unknown>;
+    stepsToRerun: string[];
+    stepsToSkip: string[];
+    nonDeterminismWarnings: NonDeterminismWarning[];
+    createdAt: Date;
+}
+export interface NonDeterminismWarning {
+    type: "model_change" | "time_drift" | "policy_change" | "state_external" | "tool_output";
+    description: string;
+    stepName?: string;
+    severity: "info" | "warning" | "critical";
+}
+export interface ReExecutionPlannerOptions {
+    mode: "full" | "from_checkpoint";
+    checkpointStep?: string;
+    detectNonDeterminism?: boolean;
+}
+export declare class ReExecutionPlanner {
+    private readonly auditTrail;
+    constructor(auditTrail: AuditTrail);
+    createPlan(executionId: string, options: ReExecutionPlannerOptions): Promise<ReExecutionPlan>;
+}

package/dist/audit/ReExecutionRuntime.d.ts

@@ -0,0 +1,35 @@
+import type { AuditTrail } from "./AuditTrail.js";
+import { type ReExecutionDiffReport } from "./ReExecutionDiffReport.js";
+import { type ReExecutionPlan, ReExecutionPlanner } from "./ReExecutionPlanner.js";
+export interface ReExecutionOptions {
+    executionId: string;
+    mode: "full" | "from_checkpoint";
+    checkpointStep?: string;
+    detectNonDeterminism?: boolean;
+    dryRun?: boolean;
+    onStepComplete?: (stepName: string, result: StepReExecutionResult) => void | Promise<void>;
+}
+export interface StepReExecutionResult {
+    stepName: string;
+    status: "done" | "failed" | "skipped";
+    output?: unknown;
+    matchesOriginal?: boolean;
+    diff?: string;
+}
+export interface ReExecutionResult {
+    reExecutionId: string;
+    originalExecutionId: string;
+    workflowVersion?: string;
+    snapshotRef?: string;
+    plan: ReExecutionPlan;
+    stepResults: StepReExecutionResult[];
+    diffReport: ReExecutionDiffReport;
+    success: boolean;
+    completedAt: Date;
+}
+export declare class ReExecutionRuntime {
+    private readonly auditTrail;
+    private readonly planner;
+    constructor(auditTrail: AuditTrail, planner: ReExecutionPlanner);
+    reexecute(options: ReExecutionOptions): Promise<ReExecutionResult>;
+}

package/dist/audit/database-api.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @deprecated DuckDB database API has been removed.
+ *
+ * For testing, use InMemoryAuditStore from './InMemoryAuditStore.js'.
+ * For production, use SQLiteStorageAdapter from '../storage/sqlite-adapter.js'.
+ */
+export type { Project, WorkflowRun, StepExecution, Metric, } from "../_legacy/database/src/duckdb-client.js";
+export declare const OboraDatabase: {
+    new (): {};
+};
+export declare const insertProject: () => never;
+export declare const getProject: () => never;
+export declare const getProjectByPath: () => never;
+export declare const listProjects: () => never;
+export declare const updateProject: () => never;
+export declare const deleteProject: () => never;
+export declare const insertWorkflowRun: () => never;
+export declare const getWorkflowRun: () => never;
+export declare const listWorkflowRuns: () => never;
+export declare const updateWorkflowRunStatus: () => never;
+export declare const deleteWorkflowRun: () => never;
+export declare const insertStepExecution: () => never;
+export declare const getStepExecution: () => never;
+export declare const listStepExecutions: () => never;
+export declare const updateStepExecutionStatus: () => never;
+export declare const incrementStepRetry: () => never;
+export declare const deleteStepExecutions: () => never;
+export declare const insertMetric: () => never;
+export declare const getMetricsForRun: () => never;
+export declare const getMetricsForStep: () => never;
+export declare const aggregateMetric: () => never;
+export declare const deleteMetrics: () => never;

package/dist/audit/database-index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Entry point for @obora/database.
+ * Public API only.
+ */
+export * from "./public-api.js";

package/dist/audit/event-bus.d.ts

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

package/dist/audit/event-factory.d.ts

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

package/dist/audit/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./types.js";
+export * from "./AuditTrail.js";
+export * from "./InMemoryAuditStore.js";
+export * from "./DefaultAuditRecorder.js";
+export * from "./EventBusAdapter.js";
+export * from "./ReExecutionPlanner.js";
+export * from "./ReExecutionDiffReport.js";
+export * from "./ReExecutionRuntime.js";
+export * from "./AuditReplay.js";
+export * from "./event-bus.js";
+export * from "./event-factory.js";
+export * from "./tkg/index.js";

package/dist/audit/testing.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Testing helpers for @obora/runtime
+ *
+ * @internal This module is intended for tests only and is not part of the public API surface.
+ * @deprecated DuckDB-based testing helpers are deprecated. Use InMemoryAuditStore instead.
+ */
+/**
+ * @deprecated DuckDB support has been removed. Use InMemoryAuditStore for tests.
+ * @throws Always throws an error explaining the deprecation.
+ */
+export declare function getDatabase(_dbPath?: string): never;
+/**
+ * @deprecated DuckDB support has been removed.
+ */
+export declare function resetDatabase(): void;

package/dist/audit/tkg/InMemoryTKG.d.ts

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

package/dist/audit/tkg/JsonFileReflectorStateStore.d.ts

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

package/dist/audit/tkg/ObserverReflector.d.ts

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

package/dist/audit/tkg/index.d.ts

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

package/dist/audit/types.d.ts

@@ -0,0 +1,23 @@
+export type AuditEventType = "execution_start" | "execution_end" | "step_start" | "step_end" | "cell_start" | "cell_end" | "tool_call" | "tool_result" | "llm_request" | "llm_response" | "policy_check" | "policy_deny" | "state_change" | "consensus_vote" | "consensus_result" | "gate_wait" | "gate_resolve" | "gate_assignment_created" | "gate_assignment_reassigned" | "gate_assignment_expired" | "gate_approval_decision" | "gate_sla_warning" | "gate_sla_expired" | "recovery_start" | "recovery_end" | "snapshot_create" | "snapshot_restore" | "plugin_load" | "plugin_unload" | "reexecution_start" | "reexecution_step_start" | "reexecution_step_end" | "reexecution_diff" | "reexecution_end" | "workflow.back_edge_triggered" | "workflow.back_edge_exhausted" | "workflow.back_edge_cost_exceeded" | "workflow.step_starvation_warning" | "error";
+export interface AuditEvent {
+    id: string;
+    executionId: string;
+    cellId?: string;
+    timestamp: Date;
+    type: AuditEventType;
+    data: unknown;
+    metadata?: {
+        model?: string;
+        tokens?: number;
+        durationMs?: number;
+        costUsd?: number;
+    };
+}
+export interface AuditFilter {
+    executionId?: string;
+    cellId?: string;
+    type?: AuditEventType | AuditEventType[];
+    from?: Date;
+    to?: Date;
+    limit?: number;
+}