@interf/compiler 0.1.12 → 0.2.1

package/dist/lib/runtime-runs.js

@@ -0,0 +1,337 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { join, relative } from "node:path";
+import chalk from "chalk";
+import { countFilesRecursive } from "./filesystem.js";
+import { buildRuntimeExecutorInfo, } from "./executors.js";
+import { RuntimeRunSchema, } from "./schema.js";
+import { getWorkflowStageDefinition, getWorkflowStages, getWorkflowStagePosition, } from "./workflow-definitions.js";
+import { eventLogPath, logsDirPath, promptLogPath, runHistoryPath, runPath, stageContractPath, statusLogPath, } from "./runtime-paths.js";
+import { warnInterf } from "./logger.js";
+export function loadRuntimeRun(dirPath) {
+    const path = runPath(dirPath);
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(path, "utf8"));
+        const parsed = RuntimeRunSchema.safeParse(raw);
+        if (parsed.success) {
+            return parsed.data;
+        }
+        return normalizeRuntimeRunRecord(raw);
+    }
+    catch (error) {
+        warnInterf(`Warning: failed to read runtime run at ${path}: ${error instanceof Error ? error.message : String(error)}`);
+        return null;
+    }
+}
+export function saveRuntimeRun(dirPath, run) {
+    mkdirSync(join(dirPath, ".interf"), { recursive: true });
+    writeFileSync(runPath(dirPath), JSON.stringify(run, null, 2) + "\n");
+}
+export function writeStageContract(dirPath, contract) {
+    mkdirSync(join(dirPath, ".interf"), { recursive: true });
+    const path = stageContractPath(dirPath);
+    writeFileSync(path, JSON.stringify(contract, null, 2) + "\n");
+    return path;
+}
+export async function runExecutorStage(options) {
+    const run = startRuntimeRun(options);
+    const prompt = options.buildPrompt(run.contract_path);
+    writeRuntimeRunPrompt(options.knowledgeBasePath, run.run_id, prompt);
+    const code = await options.executor.execute(options.knowledgeBasePath, prompt, {
+        eventLogPath: eventLogPath(options.knowledgeBasePath, run.run_id),
+        statusLogPath: statusLogPath(options.knowledgeBasePath, run.run_id),
+        completionCheck: options.completionCheck,
+    });
+    finalizeRuntimeRun(options.knowledgeBasePath, code);
+    return code;
+}
+export async function runExecutorSummarizeStage(options) {
+    const run = startRuntimeRun(options);
+    const prompt = options.buildPrompt(run.contract_path);
+    let lastReported = 0;
+    writeRuntimeRunPrompt(options.knowledgeBasePath, run.run_id, prompt);
+    const progressPromise = options.executor.execute(options.knowledgeBasePath, prompt, {
+        eventLogPath: eventLogPath(options.knowledgeBasePath, run.run_id),
+        statusLogPath: statusLogPath(options.knowledgeBasePath, run.run_id),
+        completionCheck: options.completionCheck,
+    });
+    const timer = setInterval(() => {
+        const currentSummaryCount = countFilesRecursive(join(options.knowledgeBasePath, "summaries"));
+        const completed = Math.max(0, Math.min(options.targetCount, currentSummaryCount - options.startingSummaryCount));
+        if (completed <= lastReported)
+            return;
+        lastReported = completed;
+        updateRuntimeRun(options.knowledgeBasePath, {
+            counts: {
+                ...run.counts,
+                completed_summaries: completed,
+                target_summaries: options.targetCount,
+            },
+            summary: `${options.stageLabel} ${completed}/${options.targetCount} source files into summaries.`,
+        });
+        console.log(chalk.dim(`  STATUS: wrote ${completed}/${options.targetCount} summaries`));
+    }, 10000);
+    try {
+        const code = await progressPromise;
+        finalizeRuntimeRun(options.knowledgeBasePath, code);
+        return code;
+    }
+    finally {
+        clearInterval(timer);
+    }
+}
+export function beginRuntimeRun(dirPath, run) {
+    saveRuntimeRun(dirPath, run);
+    return run;
+}
+export function updateRuntimeRun(dirPath, patch) {
+    const current = loadRuntimeRun(dirPath);
+    if (!current)
+        return null;
+    const next = {
+        ...current,
+        ...patch,
+        updated_at: new Date().toISOString(),
+    };
+    saveRuntimeRun(dirPath, next);
+    return next;
+}
+export function markRuntimeRunFailedAfterValidation(dirPath, summary) {
+    const current = loadRuntimeRun(dirPath);
+    if (!current)
+        return null;
+    const finishedAt = current.finished_at ?? new Date().toISOString();
+    const next = {
+        ...current,
+        status: "failed",
+        updated_at: new Date().toISOString(),
+        finished_at: finishedAt,
+        exit_code: 1,
+        error: summary,
+        summary,
+    };
+    saveRuntimeRun(dirPath, next);
+    replaceOrAppendRunHistoryEntry(dirPath, next);
+    return next;
+}
+export function markRuntimeRunSucceededAfterValidation(dirPath, summary) {
+    const current = loadRuntimeRun(dirPath);
+    if (!current)
+        return null;
+    const finishedAt = current.finished_at ?? new Date().toISOString();
+    const next = {
+        ...current,
+        status: "succeeded",
+        updated_at: new Date().toISOString(),
+        finished_at: finishedAt,
+        exit_code: 0,
+        error: null,
+        summary,
+    };
+    saveRuntimeRun(dirPath, next);
+    replaceOrAppendRunHistoryEntry(dirPath, next);
+    return next;
+}
+function startRuntimeRun(options) {
+    const runId = createRunId();
+    const generatedAt = new Date().toISOString();
+    const workflowStages = getWorkflowStages(options.targetType, options.workflow, options.workflowSourcePath);
+    const stagePosition = getWorkflowStagePosition(options.targetType, options.workflow, options.stage, options.workflowSourcePath);
+    const stageDefinition = getWorkflowStageDefinition(options.targetType, options.workflow, options.stage, options.workflowSourcePath);
+    const contract = {
+        kind: "interf-stage-contract",
+        version: 1,
+        generated_at: generatedAt,
+        run_id: runId,
+        target_type: options.targetType,
+        target_name: options.knowledgeBaseName,
+        workflow: {
+            id: options.workflow,
+            stage_index: stagePosition?.stageIndex ?? null,
+            stage_total: stagePosition?.stageTotal ?? workflowStages.length,
+            stages: stagePosition?.stages ?? workflowStages,
+        },
+        stage: options.stage,
+        stage_label: stageDefinition?.label ?? options.stageLabel,
+        contract_type: options.contractType,
+        executor: buildRuntimeExecutorInfo(options.executor),
+        instructions: options.contract.instructions,
+        counts: options.contract.counts,
+        ...(options.contract.acceptance ? { acceptance: options.contract.acceptance } : {}),
+        artifacts: options.contract.artifacts,
+        policies: options.contract.policies,
+    };
+    const contractPath = writeStageContract(options.knowledgeBasePath, contract);
+    const run = {
+        kind: "interf-run",
+        version: 1,
+        run_id: runId,
+        target_type: options.targetType,
+        target_name: options.knowledgeBaseName,
+        workflow: options.workflow,
+        stage: options.stage,
+        stage_label: stageDefinition?.label ?? options.stageLabel,
+        contract_type: options.contractType,
+        status: "running",
+        executor: buildRuntimeExecutorInfo(options.executor),
+        started_at: generatedAt,
+        updated_at: generatedAt,
+        finished_at: null,
+        contract_path: relativeContractPath(contractPath, options.knowledgeBasePath),
+        counts: { ...contract.counts },
+        output_artifacts: [...contract.artifacts.writes],
+        logs: {
+            prompt_path: relative(options.knowledgeBasePath, promptLogPath(options.knowledgeBasePath, runId)),
+            event_stream_path: relative(options.knowledgeBasePath, eventLogPath(options.knowledgeBasePath, runId)),
+            status_path: relative(options.knowledgeBasePath, statusLogPath(options.knowledgeBasePath, runId)),
+        },
+        summary: options.summary,
+        exit_code: null,
+        error: null,
+    };
+    return beginRuntimeRun(options.knowledgeBasePath, run);
+}
+function finalizeRuntimeRun(dirPath, code) {
+    const current = loadRuntimeRun(dirPath);
+    if (!current)
+        return null;
+    const finishedAt = new Date().toISOString();
+    const next = {
+        ...current,
+        status: code === 0 ? "succeeded" : "failed",
+        updated_at: finishedAt,
+        finished_at: finishedAt,
+        exit_code: code,
+        error: code === 0 ? null : `Executor exited with code ${code}.`,
+        summary: code === 0
+            ? `${current.stage_label} completed successfully.`
+            : `${current.stage_label} failed with exit code ${code}.`,
+    };
+    saveRuntimeRun(dirPath, next);
+    appendFileSync(runHistoryPath(dirPath), JSON.stringify(next) + "\n");
+    return next;
+}
+function writeRuntimeRunPrompt(dirPath, runId, prompt) {
+    mkdirSync(logsDirPath(dirPath), { recursive: true });
+    writeFileSync(promptLogPath(dirPath, runId), `${prompt}\n`);
+}
+function relativeContractPath(contractPath, knowledgeBasePath) {
+    return relative(knowledgeBasePath, contractPath);
+}
+function createRunId() {
+    return `run_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+function normalizeRuntimeRunRecord(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const record = raw;
+    const executor = record.executor;
+    if (record.kind !== "interf-run" ||
+        typeof record.version !== "number" ||
+        typeof record.run_id !== "string" ||
+        (record.target_type !== "knowledge-base" && record.target_type !== "interface") ||
+        typeof record.target_name !== "string" ||
+        typeof record.workflow !== "string" ||
+        typeof record.stage !== "string" ||
+        !executor ||
+        typeof executor !== "object" ||
+        typeof record.started_at !== "string" ||
+        typeof record.updated_at !== "string" ||
+        typeof record.contract_path !== "string" ||
+        typeof record.summary !== "string") {
+        return null;
+    }
+    const executorRecord = executor;
+    const normalized = {
+        kind: "interf-run",
+        version: record.version,
+        run_id: record.run_id,
+        target_type: record.target_type,
+        target_name: record.target_name,
+        workflow: record.workflow,
+        stage: record.stage,
+        stage_label: typeof record.stage_label === "string" ? record.stage_label : record.stage,
+        contract_type: typeof record.contract_type === "string"
+            ? record.contract_type
+            : inferRuntimeContractType(record.target_type, record.stage),
+        status: normalizeRuntimeRunStatus(record),
+        executor: {
+            kind: executorRecord.kind,
+            name: executorRecord.name,
+            display_name: executorRecord.display_name,
+            command: typeof executorRecord.command === "string" ? executorRecord.command : null,
+            model: typeof executorRecord.model === "string" ? executorRecord.model : null,
+            effort: typeof executorRecord.effort === "string" ? executorRecord.effort : null,
+            profile: typeof executorRecord.profile === "string" ? executorRecord.profile : null,
+            timeout_ms: typeof executorRecord.timeout_ms === "number" ? executorRecord.timeout_ms : null,
+        },
+        started_at: record.started_at,
+        updated_at: record.updated_at,
+        finished_at: typeof record.finished_at === "string" ? record.finished_at : null,
+        contract_path: record.contract_path,
+        counts: record.counts && typeof record.counts === "object" ? record.counts : {},
+        output_artifacts: Array.isArray(record.output_artifacts) ? record.output_artifacts : [],
+        logs: record.logs && typeof record.logs === "object"
+            ? record.logs
+            : undefined,
+        summary: record.summary,
+        exit_code: typeof record.exit_code === "number" ? record.exit_code : null,
+        error: typeof record.error === "string" ? record.error : null,
+    };
+    const parsed = RuntimeRunSchema.safeParse(normalized);
+    return parsed.success ? parsed.data : null;
+}
+function normalizeRuntimeRunStatus(record) {
+    const status = record.status;
+    if (status === "running" || status === "succeeded" || status === "failed") {
+        return status;
+    }
+    if (typeof record.exit_code === "number") {
+        return record.exit_code === 0 ? "succeeded" : "failed";
+    }
+    if (typeof record.error === "string" && record.error.length > 0) {
+        return "failed";
+    }
+    return "running";
+}
+function inferRuntimeContractType(targetType, stage) {
+    if (targetType === "knowledge-base") {
+        return stage === "compile" ? "kb-knowledge-layer" : "kb-file-evidence";
+    }
+    if (stage === "create-interface")
+        return "interface-plan";
+    if (stage === "analyze")
+        return "interface-analysis";
+    if (stage === "compile")
+        return "interface-output";
+    return "interface-retrieval";
+}
+function replaceOrAppendRunHistoryEntry(dirPath, run) {
+    const historyPath = runHistoryPath(dirPath);
+    if (!existsSync(historyPath)) {
+        appendFileSync(historyPath, JSON.stringify(run) + "\n");
+        return;
+    }
+    const raw = readFileSync(historyPath, "utf8");
+    const lines = raw.split("\n").filter((line) => line.trim().length > 0);
+    let replaced = false;
+    const nextLines = lines.map((line) => {
+        try {
+            const entry = JSON.parse(line);
+            if (entry.run_id === run.run_id) {
+                replaced = true;
+                return JSON.stringify(run);
+            }
+        }
+        catch {
+            // Preserve malformed history lines as-is instead of rewriting unrelated data.
+        }
+        return line;
+    });
+    if (!replaced) {
+        nextLines.push(JSON.stringify(run));
+    }
+    writeFileSync(historyPath, `${nextLines.join("\n")}\n`);
+}
+//# sourceMappingURL=runtime-runs.js.map

package/dist/lib/runtime-runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-runs.js","sourceRoot":"","sources":["../../src/lib/runtime-runs.ts"],"names":[],"mappings":"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"}

package/dist/lib/runtime-types.d.ts

@@ -0,0 +1,42 @@
+import { type WorkflowExecutor } from "./executors.js";
+import { type WorkflowId, type RuntimeContractType, type RuntimeRun, type RuntimeStage, type RuntimeStageAcceptance, type RuntimeStageContract, type RuntimeStageInstructions, type RuntimeTargetType } from "./schema.js";
+export type RuntimeRunStatus = "running" | "succeeded" | "failed";
+export type RuntimeStageContractDraft = Omit<RuntimeStageContract, "kind" | "version" | "generated_at" | "run_id" | "target_type" | "target_name" | "workflow" | "stage" | "stage_label" | "contract_type" | "executor">;
+export interface RuntimeStageExecutionOptions {
+    executor: WorkflowExecutor;
+    knowledgeBasePath: string;
+    targetType: RuntimeTargetType;
+    knowledgeBaseName: string;
+    workflow: WorkflowId;
+    workflowSourcePath?: string;
+    stage: RuntimeStage;
+    stageLabel: string;
+    contractType: RuntimeContractType;
+    summary: string;
+    contract: RuntimeStageContractDraft;
+    buildPrompt: (contractPath: string) => string;
+    completionCheck?: (() => boolean) | null;
+}
+export interface RuntimeSummarizeExecutionOptions extends RuntimeStageExecutionOptions {
+    startingSummaryCount: number;
+    targetCount: number;
+}
+export interface RuntimeStageAcceptanceValidation {
+    ok: boolean;
+    summary: string;
+    failures: string[];
+}
+export interface KnowledgeBaseSummarizeContractOptions {
+    knowledgeBaseName: string;
+    targetCount: number;
+    expectedSummaryTotal: number;
+    sourcePath: string;
+    planPath: string;
+    workflowNotes?: string[];
+    localSkillDocs?: string[];
+    instructions: RuntimeStageInstructions;
+    acceptance?: RuntimeStageAcceptance;
+}
+export interface RuntimeRunPatch extends Partial<Pick<RuntimeRun, "counts" | "summary" | "status" | "error" | "exit_code" | "finished_at">> {
+}
+//# sourceMappingURL=runtime-types.d.ts.map

package/dist/lib/runtime-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-types.d.ts","sourceRoot":"","sources":["../../src/lib/runtime-types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElE,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,oBAAoB,EAClB,MAAM,GACN,SAAS,GACT,cAAc,GACd,QAAQ,GACR,aAAa,GACb,aAAa,GACb,UAAU,GACV,OAAO,GACP,aAAa,GACb,eAAe,GACf,UAAU,CACb,CAAC;AAEF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,UAAU,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,eAAe,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,gCAAiC,SAAQ,4BAA4B;IACpF,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gCAAgC;IAC/C,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,qCAAqC;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,wBAAwB,CAAC;IACvC,UAAU,CAAC,EAAE,sBAAsB,CAAC;CACrC;AAED,MAAM,WAAW,eAAgB,SAAQ,OAAO,CAC9C,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa,CAAC,CAC1F;CAAG"}

package/dist/lib/runtime-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-types.js.map

package/dist/lib/runtime-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-types.js","sourceRoot":"","sources":["../../src/lib/runtime-types.ts"],"names":[],"mappings":""}

package/dist/lib/runtime.d.ts

@@ -1,59 +1,7 @@
-import { type WorkflowExecutor } from "./executors.js";
-import { type WorkflowId, type RuntimeContractType, type RuntimeStageAcceptance, type RuntimeRun, type RuntimeStage, type RuntimeStageContract, type RuntimeStageInstructions, type RuntimeTargetType } from "./schema.js";
-export type RuntimeRunStatus = "running" | "succeeded" | "failed";
-export type RuntimeStageContractDraft = Omit<RuntimeStageContract, "kind" | "version" | "generated_at" | "run_id" | "target_type" | "target_name" | "workflow" | "stage" | "stage_label" | "contract_type" | "executor">;
-export interface RuntimeStageExecutionOptions {
-    executor: WorkflowExecutor;
-    knowledgeBasePath: string;
-    targetType: RuntimeTargetType;
-    knowledgeBaseName: string;
-    workflow: WorkflowId;
-    workflowSourcePath?: string;
-    stage: RuntimeStage;
-    stageLabel: string;
-    contractType: RuntimeContractType;
-    summary: string;
-    contract: RuntimeStageContractDraft;
-    buildPrompt: (contractPath: string) => string;
-    completionCheck?: (() => boolean) | null;
-}
-export interface RuntimeSummarizeExecutionOptions extends RuntimeStageExecutionOptions {
-    startingSummaryCount: number;
-    targetCount: number;
-}
-export interface RuntimeStageAcceptanceValidation {
-    ok: boolean;
-    summary: string;
-    failures: string[];
-}
-export interface KnowledgeBaseSummarizeContractOptions {
-    knowledgeBaseName: string;
-    targetCount: number;
-    sourcePath: string;
-    planPath: string;
-    workflowNotes?: string[];
-    localSkillDocs?: string[];
-    instructions: RuntimeStageInstructions;
-    acceptance?: RuntimeStageAcceptance;
-}
-export declare function runPath(dirPath: string): string;
-export declare function runHistoryPath(dirPath: string): string;
-export declare function stageContractPath(dirPath: string): string;
-export declare function logsDirPath(dirPath: string): string;
-export declare function promptLogPath(dirPath: string, runId: string): string;
-export declare function eventLogPath(dirPath: string, runId: string): string;
-export declare function statusLogPath(dirPath: string, runId: string): string;
-export declare function loadRuntimeRun(dirPath: string): RuntimeRun | null;
-export declare function saveRuntimeRun(dirPath: string, run: RuntimeRun): void;
-export declare function writeStageContract(dirPath: string, contract: RuntimeStageContract): string;
-export declare function validateStageContractAcceptance(dirPath: string, contract?: RuntimeStageContract | null): RuntimeStageAcceptanceValidation;
-export declare function buildStagePrompt(instructions: RuntimeStageInstructions, contractPath: string, statusLines: string[]): string;
-export declare function buildKnowledgeBaseSummarizeContract(options: KnowledgeBaseSummarizeContractOptions): RuntimeStageContractDraft;
-export declare function runExecutorStage(options: RuntimeStageExecutionOptions): Promise<number>;
-export declare function runExecutorSummarizeStage(options: RuntimeSummarizeExecutionOptions): Promise<number>;
-export declare function beginRuntimeRun(dirPath: string, run: RuntimeRun): RuntimeRun;
-export declare function updateRuntimeRun(dirPath: string, patch: Partial<Pick<RuntimeRun, "counts" | "summary" | "status" | "error" | "exit_code" | "finished_at">>): RuntimeRun | null;
-export declare function markRuntimeRunFailedAfterValidation(dirPath: string, summary: string): RuntimeRun | null;
-export declare function markRuntimeRunSucceededAfterValidation(dirPath: string, summary: string): RuntimeRun | null;
-export declare function runtimeRunStdoutContains(dirPath: string, needle: string): boolean;
+export type { KnowledgeBaseSummarizeContractOptions, RuntimeRunPatch, RuntimeRunStatus, RuntimeStageAcceptanceValidation, RuntimeStageContractDraft, RuntimeStageExecutionOptions, RuntimeSummarizeExecutionOptions, } from "./runtime-types.js";
+export { eventLogPath, logsDirPath, promptLogPath, runHistoryPath, runPath, stageContractPath, statusLogPath, } from "./runtime-paths.js";
+export { validateStageContractAcceptance } from "./runtime-acceptance.js";
+export { buildStagePrompt } from "./runtime-prompt.js";
+export { buildKnowledgeBaseSummarizeContract } from "./runtime-contracts.js";
+export { beginRuntimeRun, loadRuntimeRun, markRuntimeRunFailedAfterValidation, markRuntimeRunSucceededAfterValidation, runExecutorStage, runExecutorSummarizeStage, saveRuntimeRun, updateRuntimeRun, writeStageContract, } from "./runtime-runs.js";
 //# sourceMappingURL=runtime.d.ts.map

package/dist/lib/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/lib/runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/lib/runtime.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qCAAqC,EACrC,eAAe,EACf,gBAAgB,EAChB,gCAAgC,EAChC,yBAAyB,EACzB,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,cAAc,EACd,OAAO,EACP,iBAAiB,EACjB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,mCAAmC,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EACL,eAAe,EACf,cAAc,EACd,mCAAmC,EACnC,sCAAsC,EACtC,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}