@osolmaz/pi-workflows 0.12.1 → 0.13.0

package/src/workflows/types.ts

@@ -97,21 +97,35 @@ export type WorkflowEdge =
       };
     };
 
-/**
- * A model-shaped step. The engine sends the prompt into the pi conversation
- * and the model completes the step by calling the `workflow` tool with a JSON
- * output. `expectedOutput` is appended to the step contract so the model
- * knows what shape to submit. `validate` may reject (throw) or normalize the
- * submitted output; rejections are surfaced to the model so it can retry
- * within the same step.
- */
-export type AgentNodeDefinition = WorkflowNodeCommon & {
+/** A visible assistant response used as the accepted agent-node output. */
+export type AssistantMessageOutput = {
+  kind: "assistant-message";
+  /** Optional author-supplied character limit. Omission adds no workflow limit. */
+  maxChars?: number;
+};
+
+export type AgentExpectedOutput = string | AssistantMessageOutput;
+
+type AgentNodeBase = WorkflowNodeCommon & {
   nodeType: "agent";
   prompt: (context: WorkflowNodeContext) => MaybePromise<string>;
+};
+
+/** The existing workflow-tool submission form. */
+export type SubmittedAgentNodeDefinition = AgentNodeBase & {
   expectedOutput?: string;
   validate?: (output: unknown, context: WorkflowNodeContext) => MaybePromise<unknown>;
 };
 
+/** A model turn whose normal visible assistant text becomes the node output. */
+export type AssistantAgentNodeDefinition = AgentNodeBase & {
+  expectedOutput: AssistantMessageOutput;
+  validate?: never;
+};
+
+/** A model-shaped step with either submitted or visible assistant output. */
+export type AgentNodeDefinition = SubmittedAgentNodeDefinition | AssistantAgentNodeDefinition;
+
 /** A pure local function: shape inputs, route, format, derive values. */
 export type ComputeNodeDefinition = WorkflowNodeCommon & {
   nodeType: "compute";
@@ -529,7 +543,7 @@ export type WorkflowDefinition<
   /**
    * Optional instructions for a normal assistant response after the run ends.
    * The Pi extension resolves this only after the final state is persisted;
-   * the engine and run bundle remain presentation-agnostic.
+   * the engine and durable store remain presentation-agnostic.
    */
   presentationPrompt?:
     | string
@@ -545,27 +559,7 @@ export type WorkflowDefinition<
 
 export type WorkflowNodeOutcome = "ok" | "timed_out" | "failed" | "cancelled";
 
-/**
- * Reference to a content-addressed file under the bundle's `artifacts/`
- * directory. Large string leaves inside persisted values are replaced by
- * `{ "$artifact": ArtifactRef }` at write time (see `docs/run-bundles.md`).
- */
-export type ArtifactRef = {
-  /** Bundle-relative path, `artifacts/sha256-<64 hex>.txt`. */
-  path: string;
-  mediaType: string;
-  bytes: number;
-  /** Hex digest of the artifact bytes. */
-  sha256: string;
-};
-
-/** The sentinel wrapper that replaces an externalized value. */
-export type ArtifactValue = { $artifact: ArtifactRef };
-
-/**
- * Explicit linkage from a workflow attempt to the Pi conversation slice it
- * produced. Ids address entries in `session/entries.ndjson` by Pi entry id.
- */
+/** Explicit linkage from a workflow attempt to the Pi conversation slice it produced. */
 export type ConversationRange = {
   /** First Pi session entry id of the attempt. */
   firstEntryId: string;
@@ -602,14 +596,13 @@ export type WorkflowStepRecord = {
   outcome: WorkflowNodeOutcome;
   startedAt: string;
   finishedAt: string;
-  /**
-   * Full prompt text for agent steps, `null` for other node types. In a
-   * persisted bundle a large prompt may be an `ArtifactValue`.
-   */
-  prompt: string | ArtifactValue | null;
+  /** Full prompt text for agent steps, `null` for other node types. */
+  prompt: string | null;
   output: unknown;
   error?: string;
   action?: WorkflowActionReceipt;
+  /** Receipt for a visible assistant-message completion. */
+  assistantMessage?: AssistantMessageReceipt;
   /** For agent steps recorded inside a Pi conversation. */
   conversation?: ConversationRange;
 };
@@ -646,11 +639,7 @@ export type WorkflowCompositionSnapshot = {
 
 export type WorkflowRunState = {
   schema: "pi-workflows.run-state.v1";
-  /**
-   * `seq` of the trace event this projection reflects. `trace.ndjson` is the
-   * source of truth; a state whose `traceSeq` is older than the trace tail is
-   * a stale projection.
-   */
+  /** Resource revision of the event reflected by this projection. */
   traceSeq: number;
   runId: string;
   workflowName: string;
@@ -700,7 +689,7 @@ export type WorkflowNodeSnapshot = {
   timeoutMs?: number | null;
   statusDetail?: string;
   summary?: string;
-  expectedOutput?: string;
+  expectedOutput?: AgentExpectedOutput;
   actionExecution?: "function" | "shell";
   mountPath?: string[];
   localNodeId?: string;
@@ -758,7 +747,7 @@ export type WorkflowSessionBinding = {
 export type WorkflowSessionEntryRecord = {
   /** Starts at 1, increases by exactly 1 within the file. */
   seq: number;
-  /** When the entry was recorded into the bundle. */
+  /** When the entry was recorded in workflow state. */
   at: string;
   /** Verbatim Pi session entry (has its own id/parentId/timestamp). */
   entry: Record<string, unknown>;
@@ -808,32 +797,21 @@ export type WorkflowSessionCapture = {
 
 export type WorkflowTraceEventDraft = Omit<WorkflowTraceEvent, "seq" | "at" | "runId">;
 
-export type WorkflowRunManifest = {
-  schema: "pi-workflows.run-bundle.v1";
+export type WorkflowRunResult = {
   runId: string;
-  workflowName: string;
-  runTitle?: string;
-  workflowSource?: WorkflowSource;
-  workflowSources?: WorkflowMountedSource[];
-  definitionDigest?: string;
-  startedAt: string;
-  finishedAt?: string;
-  status: WorkflowRunStatus;
-  traceSchema: "pi-workflows.trace-event.v1";
-  paths: {
-    workflow: string;
-    state: string;
-    trace: string;
-    /** Bundle-relative session directory, present once a session is bound. */
-    session?: string;
-    /** Bundle-relative artifacts directory, present once a value was externalized. */
-    artifacts?: string;
-  };
+  state: WorkflowRunState;
 };
 
-export type WorkflowRunResult = {
-  runDir: string;
-  state: WorkflowRunState;
+export type AgentStepCompletion = "submit" | "assistant";
+
+export type AssistantMessageReceipt = {
+  sha256: string;
+  /** Pi session entry containing the visible response, when available. */
+  entryId?: string;
+  /** Present only when the workflow author supplied a limit. */
+  maxChars?: number;
+  /** True when recovery adopted an already visible response. */
+  recovered?: boolean;
 };
 
 /** The step contract handed to the executor alongside the prompt. */
@@ -842,7 +820,9 @@ export type AgentStepContract = {
   workflowName: string;
   nodeId: string;
   attemptId: string;
+  completion: AgentStepCompletion;
   expectedOutput?: string;
+  maxOutputChars?: number;
 };
 
 /** Optional human-facing labels for an agent step. They never affect execution. */
@@ -869,6 +849,8 @@ export type AgentStepRequest = {
 
 export type AgentStepSubmission = {
   output: unknown;
+  /** Receipt for a visible assistant response. */
+  assistantMessage?: AssistantMessageReceipt;
   /**
    * The Pi conversation slice this step produced, when the executor records
    * one. Persisted verbatim into the step record and terminal node event.
@@ -878,10 +860,15 @@ export type AgentStepSubmission = {
 
 /**
  * Runs one agent step to completion. Implementations deliver the prompt to
- * the model and resolve once a submission has been accepted via `accept`.
+ * the model and resolve once the configured output has been accepted.
  * Must reject with an `AbortError`-like error when `signal` aborts.
  */
 export interface AgentStepExecutor {
+  /**
+   * `visible` supports assistant-message output. `park` asks the engine to
+   * leave the run claimable for an origin session. Omission is unsupported.
+   */
+  readonly assistantMessageMode?: "visible" | "park" | "unsupported";
   runAgentStep(request: AgentStepRequest, signal: AbortSignal): Promise<AgentStepSubmission>;
 }
 
@@ -909,26 +896,19 @@ export type WorkflowEngineOptions = {
   executor: AgentStepExecutor;
   /** Durable destination for notify nodes. Required when a workflow uses one. */
   notificationSink?: WorkflowNotificationSink;
-  /** Root directory for run bundles. Defaults to `~/.pi/agent/workflows/runs`. */
-  outputRoot?: string;
-  /**
-   * Shared run store. Pass the same instance used by a session recorder so
-   * trace sequence numbers stay single-writer. Defaults to a new store on
-   * `outputRoot`.
-   */
+  /** Canonical SQLite database. Defaults to `~/.pi/agent/workflows/state.sqlite`. */
+  databasePath?: string;
+  /** Shared SQLite run store. */
   store?: import("./store.js").WorkflowRunStore;
   /**
-   * Awaited after `run_started` is persisted, before any node executes. This
-   * is where a session recorder binds, so `session_bound` lands at the start
-   * of the trace and can never trail the terminal event.
+   * Awaited after `run_started` is persisted, before any node executes.
    */
-  onRunStarted?: (runDir: string, state: WorkflowRunState) => MaybePromise<void>;
+  onRunStarted?: (runId: string, state: WorkflowRunState) => MaybePromise<void>;
   /**
    * Awaited before the terminal snapshot is persisted. This is where a
-   * session recorder stops and drains, so the bundle is immutable the moment
-   * the terminal event exists. Errors are swallowed: finishing the run wins.
+   * session recorder stops and drains. Errors are swallowed: finishing the run wins.
    */
-  onRunFinishing?: (runDir: string, state: WorkflowRunState) => MaybePromise<void>;
+  onRunFinishing?: (runId: string, state: WorkflowRunState) => MaybePromise<void>;
   /** Default per-node timeout. Defaults to 15 minutes. */
   defaultNodeTimeoutMs?: number;
   /** Guard against unbounded graph loops. Defaults to 100 executed steps. */

package/dist/workflows/artifacts.d.ts

@@ -1,40 +0,0 @@
-import type { ArtifactRef, ArtifactValue } from "./types.js";
-/**
- * Value externalization for run bundles (see docs/run-bundles.md): string
- * leaves larger than the threshold are written once, content-addressed, under
- * `artifacts/` and replaced by `{ "$artifact": ref }`. Because artifacts are
- * immutable and deduplicated by hash, the same output appearing in `outputs`,
- * `results`, `steps`, and the trace costs one file plus small references.
- */
-export declare const ARTIFACT_THRESHOLD_BYTES = 4096;
-export declare const ARTIFACTS_DIR = "artifacts";
-export declare function isArtifactValue(value: unknown): value is ArtifactValue;
-/**
- * Writes externalized string leaves for one run bundle. Instances serialize
- * their writes and deduplicate by content hash, so encoding the same large
- * string in several value positions touches the filesystem once.
- */
-export declare class ArtifactWriter {
-    private readonly runDir;
-    private readonly written;
-    private chain;
-    private dirCreated;
-    constructor(runDir: string);
-    /** True once any artifact exists for this run. */
-    get hasArtifacts(): boolean;
-    externalize(text: string): Promise<ArtifactValue>;
-}
-/**
- * Encode a persisted value: externalize large string leaves and escape
- * single-key `$artifact`/`$escaped` objects so the sentinel stays
- * unambiguous. Returns the original value when nothing changed.
- */
-export declare function encodeValue(value: unknown, writer: ArtifactWriter, thresholdBytes?: number): Promise<unknown>;
-/**
- * Walk a persisted value, replacing every `$artifact` sentinel via `resolve`
- * and unwrapping `$escaped` objects. `resolve` may return the artifact
- * contents or a placeholder; it receives the reference untouched.
- */
-export declare function decodeValueWith(value: unknown, resolve: (ref: ArtifactRef) => unknown): unknown;
-/** Resolve every artifact reference in `value` by reading the bundle files. */
-export declare function resolveArtifacts(value: unknown, runDir: string): Promise<unknown>;

package/dist/workflows/artifacts.js

@@ -1,155 +0,0 @@
-import { createHash } from "node:crypto";
-import fs from "node:fs/promises";
-import path from "node:path";
-/**
- * Value externalization for run bundles (see docs/run-bundles.md): string
- * leaves larger than the threshold are written once, content-addressed, under
- * `artifacts/` and replaced by `{ "$artifact": ref }`. Because artifacts are
- * immutable and deduplicated by hash, the same output appearing in `outputs`,
- * `results`, `steps`, and the trace costs one file plus small references.
- */
-export const ARTIFACT_THRESHOLD_BYTES = 4096;
-export const ARTIFACTS_DIR = "artifacts";
-const ARTIFACT_KEY = "$artifact";
-const ESCAPED_KEY = "$escaped";
-export function isArtifactValue(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        !Array.isArray(value) &&
-        Object.keys(value).length === 1 &&
-        ARTIFACT_KEY in value);
-}
-function isEscapedValue(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        !Array.isArray(value) &&
-        Object.keys(value).length === 1 &&
-        ESCAPED_KEY in value);
-}
-/** True for a single-key object that would be misread as a sentinel. */
-function needsEscape(value) {
-    const keys = Object.keys(value);
-    return keys.length === 1 && (keys[0] === ARTIFACT_KEY || keys[0] === ESCAPED_KEY);
-}
-/**
- * Writes externalized string leaves for one run bundle. Instances serialize
- * their writes and deduplicate by content hash, so encoding the same large
- * string in several value positions touches the filesystem once.
- */
-export class ArtifactWriter {
-    runDir;
-    written = new Set();
-    chain = Promise.resolve();
-    dirCreated = false;
-    constructor(runDir) {
-        this.runDir = runDir;
-    }
-    /** True once any artifact exists for this run. */
-    get hasArtifacts() {
-        return this.written.size > 0;
-    }
-    async externalize(text) {
-        const bytes = Buffer.from(text, "utf8");
-        const sha256 = createHash("sha256").update(bytes).digest("hex");
-        const relativePath = `${ARTIFACTS_DIR}/sha256-${sha256}.txt`;
-        const task = this.chain.then(async () => {
-            if (this.written.has(sha256)) {
-                return;
-            }
-            if (!this.dirCreated) {
-                await fs.mkdir(path.join(this.runDir, ARTIFACTS_DIR), { recursive: true, mode: 0o700 });
-                this.dirCreated = true;
-            }
-            const filePath = path.join(this.runDir, relativePath);
-            // Content-addressed files are immutable; an existing file is complete
-            // unless a previous crash left a partial write, which the temp-rename
-            // pattern prevents.
-            const tempPath = `${filePath}.${process.pid}.tmp`;
-            await fs.writeFile(tempPath, bytes, { mode: 0o600 });
-            await fs.rename(tempPath, filePath);
-            this.written.add(sha256);
-        });
-        this.chain = task.catch(() => undefined);
-        await task;
-        return {
-            $artifact: {
-                path: relativePath,
-                mediaType: "text/plain",
-                bytes: bytes.byteLength,
-                sha256,
-            },
-        };
-    }
-}
-/**
- * Encode a persisted value: externalize large string leaves and escape
- * single-key `$artifact`/`$escaped` objects so the sentinel stays
- * unambiguous. Returns the original value when nothing changed.
- */
-export async function encodeValue(value, writer, thresholdBytes = ARTIFACT_THRESHOLD_BYTES) {
-    if (typeof value === "string") {
-        if (Buffer.byteLength(value, "utf8") <= thresholdBytes) {
-            return value;
-        }
-        return await writer.externalize(value);
-    }
-    if (Array.isArray(value)) {
-        const encoded = await Promise.all(value.map((item) => encodeValue(item, writer, thresholdBytes)));
-        return encoded.some((item, index) => item !== value[index]) ? encoded : value;
-    }
-    if (typeof value === "object" && value !== null) {
-        const record = value;
-        const entries = await Promise.all(Object.entries(record).map(async ([key, item]) => [key, await encodeValue(item, writer, thresholdBytes)]));
-        const changed = entries.some(([key, item]) => item !== record[key]);
-        const encoded = changed ? Object.fromEntries(entries) : record;
-        return needsEscape(record) ? { [ESCAPED_KEY]: encoded } : encoded;
-    }
-    return value;
-}
-/**
- * Walk a persisted value, replacing every `$artifact` sentinel via `resolve`
- * and unwrapping `$escaped` objects. `resolve` may return the artifact
- * contents or a placeholder; it receives the reference untouched.
- */
-export function decodeValueWith(value, resolve) {
-    if (isArtifactValue(value)) {
-        return resolve(value.$artifact);
-    }
-    if (isEscapedValue(value)) {
-        // The unwrapped object is user data: process its children but do not
-        // re-test the object itself as a sentinel.
-        return decodeChildren(value.$escaped, resolve);
-    }
-    if (Array.isArray(value)) {
-        return value.map((item) => decodeValueWith(item, resolve));
-    }
-    if (typeof value === "object" && value !== null) {
-        return decodeChildren(value, resolve);
-    }
-    return value;
-}
-function decodeChildren(record, resolve) {
-    return Object.fromEntries(Object.entries(record).map(([key, item]) => [key, decodeValueWith(item, resolve)]));
-}
-/** Resolve every artifact reference in `value` by reading the bundle files. */
-export async function resolveArtifacts(value, runDir) {
-    const refs = [];
-    decodeValueWith(value, (ref) => {
-        refs.push(ref);
-        return null;
-    });
-    const contents = new Map();
-    for (const ref of refs) {
-        if (contents.has(ref.path)) {
-            continue;
-        }
-        const resolved = path.resolve(runDir, ref.path);
-        // A reference must never escape the bundle directory.
-        if (!resolved.startsWith(path.resolve(runDir) + path.sep)) {
-            throw new Error(`Artifact path escapes the bundle: ${ref.path}`);
-        }
-        contents.set(ref.path, await fs.readFile(resolved, "utf8"));
-    }
-    return decodeValueWith(value, (ref) => contents.get(ref.path) ?? null);
-}
-//# sourceMappingURL=artifacts.js.map

package/dist/workflows/artifacts.js.map

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

package/dist/workflows/migrate-sources.d.ts

@@ -1,42 +0,0 @@
-import type { BuiltinWorkflowCatalog } from "./catalog.js";
-import { WorkflowRunStore } from "./store.js";
-export type LegacySourceMigrationQueue = {
-    repairCanonicalWorkflowSourceRun(options: {
-        runId: string;
-        workflowName: string;
-        workflowSourceRef: string;
-        runnerId: string;
-        claimToken: string;
-        leaseMs: number;
-    }): "unchanged" | "claimed" | false;
-    claimLegacyWorkflowSourceRun(options: {
-        runId: string;
-        workflowName: string;
-        oldWorkflowPath: string;
-        workflowSourceRef: string;
-        runnerId: string;
-        claimToken: string;
-        leaseMs: number;
-    }): boolean;
-    parkWorkflowRun(options: {
-        runId: string;
-        claimToken: string;
-    }): boolean;
-    getWorkflowRun(runId: string): {
-        status: "queued" | "starting" | "running" | "parked" | "done" | "failed" | "cancelled";
-    } | undefined;
-    setWorkflowRunOriginSession?(runId: string, originSessionId: string): boolean;
-};
-export type LegacySourceMigrationResult = {
-    migratedRunIds: string[];
-    blocked: {
-        runId: string;
-        reason: string;
-    }[];
-};
-/** One bounded migration for nonterminal runs created before canonical sources. */
-export declare function migrateLegacyWorkflowSources(options: {
-    catalog: BuiltinWorkflowCatalog;
-    store?: WorkflowRunStore;
-    queue?: LegacySourceMigrationQueue;
-}): Promise<LegacySourceMigrationResult>;

package/dist/workflows/migrate-sources.js

@@ -1,133 +0,0 @@
-import { randomUUID } from "node:crypto";
-import fs from "node:fs/promises";
-import path from "node:path";
-import { WorkflowRunStore, listRunBundles } from "./store.js";
-const MIGRATION_LEASE_MS = 30_000;
-/** One bounded migration for nonterminal runs created before canonical sources. */
-export async function migrateLegacyWorkflowSources(options) {
-    const store = options.store ?? new WorkflowRunStore();
-    const result = { migratedRunIds: [], blocked: [] };
-    for (const bundle of await listRunBundles(store.outputRoot)) {
-        const state = bundle.state;
-        if (state.status !== "running" && state.status !== "waiting")
-            continue;
-        if (options.queue?.setWorkflowRunOriginSession !== undefined &&
-            bundle.sessionBinding !== null) {
-            options.queue.setWorkflowRunOriginSession(state.runId, bundle.sessionBinding.piSessionId);
-        }
-        if (state.workflowSource !== undefined) {
-            if (options.queue === undefined)
-                continue;
-            const claimToken = randomUUID();
-            const repaired = options.queue.repairCanonicalWorkflowSourceRun({
-                runId: state.runId,
-                workflowName: state.workflowName,
-                workflowSourceRef: sourceRef(state.workflowSource),
-                runnerId: `source-migration-${process.pid}`,
-                claimToken,
-                leaseMs: MIGRATION_LEASE_MS,
-            });
-            if (repaired === false) {
-                // Another runner can own a canonical run during startup. Its source is
-                // already safe; the normal queue lease will make it claimable later.
-            }
-            else if (repaired === "claimed" &&
-                !options.queue.parkWorkflowRun({ runId: state.runId, claimToken })) {
-                result.blocked.push({
-                    runId: state.runId,
-                    reason: "canonical queue repair could not release its claim",
-                });
-            }
-            continue;
-        }
-        if (state.workflowPath === undefined || state.workflowHash === undefined) {
-            result.blocked.push({ runId: state.runId, reason: "legacy workflow identity is incomplete" });
-            continue;
-        }
-        const legacyPath = {
-            workflowName: state.workflowName,
-            workflowPath: state.workflowPath,
-        };
-        const pathEntry = options.catalog.legacyPathEntry(legacyPath);
-        let workflowSource;
-        let workflowSourceRef;
-        if (pathEntry === undefined) {
-            workflowSource = {
-                kind: "file",
-                path: path.resolve(state.workflowPath),
-                hash: state.workflowHash,
-            };
-            workflowSourceRef = workflowSource.path;
-        }
-        else {
-            const legacy = options.catalog.matchLegacy({
-                ...legacyPath,
-                workflowHash: state.workflowHash,
-            });
-            if (legacy === undefined) {
-                const reason = `legacy built-in ${pathEntry.id} has an unknown source revision`;
-                result.blocked.push({ runId: state.runId, reason });
-                continue;
-            }
-            workflowSource = {
-                kind: "builtin",
-                id: legacy.entry.id,
-                revision: legacy.revision,
-            };
-            workflowSourceRef = legacy.entry.ref;
-        }
-        const claimToken = randomUUID();
-        const queueIsDone = options.queue?.getWorkflowRun(state.runId)?.status === "done";
-        if (options.queue !== undefined &&
-            !queueIsDone &&
-            !options.queue.claimLegacyWorkflowSourceRun({
-                runId: state.runId,
-                workflowName: state.workflowName,
-                oldWorkflowPath: state.workflowPath,
-                workflowSourceRef,
-                runnerId: `source-migration-${process.pid}`,
-                claimToken,
-                leaseMs: MIGRATION_LEASE_MS,
-            })) {
-            result.blocked.push({
-                runId: state.runId,
-                reason: "matching queue row is active or unavailable",
-            });
-            continue;
-        }
-        const migrated = {
-            ...state,
-            workflowSource,
-        };
-        delete migrated.workflowPath;
-        delete migrated.workflowHash;
-        const migratedManifest = {
-            ...bundle.manifest,
-            workflowSource: migrated.workflowSource,
-        };
-        delete migratedManifest.workflowPath;
-        // State is the migration commit point. Queue and manifest updates are
-        // idempotent, so a crash before this write can safely retry.
-        await writeJsonAtomic(path.join(bundle.runDir, "manifest.json"), migratedManifest);
-        await writeJsonAtomic(path.join(bundle.runDir, "state.json"), migrated);
-        if (options.queue !== undefined &&
-            !queueIsDone &&
-            !options.queue.parkWorkflowRun({ runId: state.runId, claimToken })) {
-            result.blocked.push({
-                runId: state.runId,
-                reason: "migration completed but its queue claim could not be released",
-            });
-        }
-        result.migratedRunIds.push(state.runId);
-    }
-    return result;
-}
-function sourceRef(source) {
-    return source.kind === "builtin" ? `builtin:${source.id}` : source.path;
-}
-async function writeJsonAtomic(filePath, value) {
-    const tempPath = `${filePath}.${process.pid}.${randomUUID()}.source-migration.tmp`;
-    await fs.writeFile(tempPath, `${JSON.stringify(value, null, 2)}\n`, { mode: 0o600 });
-    await fs.rename(tempPath, filePath);
-}
-//# sourceMappingURL=migrate-sources.js.map

package/dist/workflows/migrate-sources.js.map

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