@osolmaz/pi-workflows 0.12.0 → 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";
@@ -231,37 +245,34 @@ export type DecisionPresentation = {
   blocks: DecisionPresentationBlock[];
 };
 
-export type LegacyHumanDecisionPrompt = {
-  title: string;
-  body: unknown;
-  subject?: never;
-  presentation?: never;
-  revision?: never;
-  /** Optional absolute expiry. An expired request cannot accept an answer. */
-  expiresAt?: string;
-};
-
-export type PresentedHumanDecisionPrompt<TSubject = unknown> = {
+export type HumanDecisionPrompt<TSubject = unknown> = {
   title: string;
   subject: TSubject;
   presentation: DecisionPresentation;
-  body?: never;
   /** Positive revision of the decision subject and presentation. Defaults to 1. */
   revision?: number;
   /** Optional absolute expiry. An expired request cannot accept an answer. */
   expiresAt?: string;
 };
 
-export type HumanDecisionPrompt = LegacyHumanDecisionPrompt | PresentedHumanDecisionPrompt;
-
 export type HumanDecisionAudience =
   | string
   | ((context: WorkflowNodeContext) => MaybePromise<string>);
 
+export type HumanDecisionTimeout = {
+  afterMs: number;
+  response: HumanDecisionResponse;
+};
+
+export type HumanDecisionTimeoutPolicy =
+  | HumanDecisionTimeout
+  | ((context: WorkflowNodeContext) => MaybePromise<HumanDecisionTimeout | undefined>);
+
 export type HumanDecisionNodeContract = {
   audience: HumanDecisionAudience;
   choices: HumanDecisionChoiceMap;
   request: (context: WorkflowNodeContext) => MaybePromise<HumanDecisionPrompt>;
+  onTimeout?: HumanDecisionTimeoutPolicy;
 };
 
 type HumanDecisionRequestCommon = {
@@ -276,15 +287,11 @@ type HumanDecisionRequestCommon = {
   choices: HumanDecisionChoiceMap;
   createdAt: string;
   expiresAt?: string;
+  defaultResponse?: HumanDecisionResponse;
 };
 
-export type HumanDecisionRequestV1 = HumanDecisionRequestCommon & {
+export type HumanDecisionRequest = HumanDecisionRequestCommon & {
   schema: "pi-workflows.human-decision-request.v1";
-  body: unknown;
-};
-
-export type HumanDecisionRequestV2 = HumanDecisionRequestCommon & {
-  schema: "pi-workflows.human-decision-request.v2";
   subject: unknown;
   presentation: DecisionPresentation;
   revision: number;
@@ -292,11 +299,9 @@ export type HumanDecisionRequestV2 = HumanDecisionRequestCommon & {
   presentationDigest: string;
 };
 
-export type HumanDecisionRequest = HumanDecisionRequestV1 | HumanDecisionRequestV2;
-
 /**
  * Complete operator-facing request passed to a decision channel. It excludes
- * the canonical subject and legacy body by design.
+ * the canonical subject by design.
  */
 export type HumanDecisionChannelRequest = HumanDecisionRequestCommon & {
   schema: "pi-workflows.human-decision-channel-request.v1";
@@ -324,69 +329,62 @@ export type HumanDecisionSubmission = HumanDecisionResponse & {
   idempotencyKey: string;
 };
 
-type AcceptedHumanDecisionCommon = {
+type ResolvedHumanDecisionCommon = {
   decisionId: string;
   requestDigest: string;
   response: HumanDecisionResponse;
-  source: HumanDecisionAnswerSource;
-  idempotencyKey: string;
+  provenance: "human" | "timeout";
   acceptedAt: string;
   answerDigest: string;
 };
 
-export type AcceptedHumanDecisionV1 = AcceptedHumanDecisionCommon & {
-  schema: "pi-workflows.human-decision-accepted.v1";
+type AcceptedHumanDecisionCommon = ResolvedHumanDecisionCommon & {
+  provenance: "human";
+  source: HumanDecisionAnswerSource;
+  idempotencyKey: string;
+};
+
+type DefaultedHumanDecisionCommon = ResolvedHumanDecisionCommon & {
+  provenance: "timeout";
 };
 
-export type AcceptedHumanDecisionV2 = AcceptedHumanDecisionCommon & {
-  schema: "pi-workflows.human-decision-accepted.v2";
+export type AcceptedHumanDecision = AcceptedHumanDecisionCommon & {
+  schema: "pi-workflows.human-decision-accepted.v1";
   subjectDigest: string;
   presentationDigest: string;
   revision: number;
 };
 
-export type AcceptedHumanDecision = AcceptedHumanDecisionV1 | AcceptedHumanDecisionV2;
+export type DefaultedHumanDecision = DefaultedHumanDecisionCommon & {
+  schema: "pi-workflows.human-decision-accepted.v1";
+  subjectDigest: string;
+  presentationDigest: string;
+  revision: number;
+};
+export type ResolvedHumanDecision = AcceptedHumanDecision | DefaultedHumanDecision;
 
 type HumanDecisionReceiptCommon = {
   decisionId: string;
   requestDigest: string;
   nodeId: string;
   response: HumanDecisionResponse;
+  provenance: "human" | "timeout";
   acceptedAt: string;
   answerDigest: string;
 };
 
-export type HumanDecisionReceiptV1 = HumanDecisionReceiptCommon & {
+export type HumanDecisionReceipt = HumanDecisionReceiptCommon & {
   schema: "pi-workflows.human-decision-receipt.v1";
-};
-
-export type HumanDecisionReceiptV2 = HumanDecisionReceiptCommon & {
-  schema: "pi-workflows.human-decision-receipt.v2";
   subjectDigest: string;
   presentationDigest: string;
   revision: number;
 };
 
-export type HumanDecisionReceipt = HumanDecisionReceiptV1 | HumanDecisionReceiptV2;
-
-export type HumanDecisionDeliveryRecordV1 = {
+export type HumanDecisionDeliveryRecord = {
   schema: "pi-workflows.human-decision-delivery.v1";
   attemptId: string;
   decisionId: string;
   requestDigest: string;
-  channel: string;
-  state: "intent" | "confirmed" | "failed" | "unknown";
-  createdAt: string;
-  finishedAt?: string;
-  messageCount?: number;
-  errorCode?: string;
-};
-
-export type HumanDecisionDeliveryRecordV2 = {
-  schema: "pi-workflows.human-decision-delivery.v2";
-  attemptId: string;
-  decisionId: string;
-  requestDigest: string;
   presentationDigest: string;
   channel: string;
   phase: "intent" | "part" | "complete";
@@ -401,10 +399,6 @@ export type HumanDecisionDeliveryRecordV2 = {
   errorCode?: string;
 };
 
-export type HumanDecisionDeliveryRecord =
-  | HumanDecisionDeliveryRecordV1
-  | HumanDecisionDeliveryRecordV2;
-
 export type HumanDecisionSettlementRecord = {
   schema: "pi-workflows.human-decision-settlement.v1";
   attemptId: string;
@@ -429,6 +423,7 @@ export type HumanDecisionContinuationRecord = {
   schema: "pi-workflows.human-decision-continuation.v1";
   decisionId: string;
   requestDigest: string;
+  provenance: "human" | "timeout";
   parentRunId: string;
   runId: string;
   createdAt: string;
@@ -548,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
@@ -564,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;
@@ -621,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;
 };
@@ -665,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;
@@ -719,7 +689,7 @@ export type WorkflowNodeSnapshot = {
   timeoutMs?: number | null;
   statusDetail?: string;
   summary?: string;
-  expectedOutput?: string;
+  expectedOutput?: AgentExpectedOutput;
   actionExecution?: "function" | "shell";
   mountPath?: string[];
   localNodeId?: string;
@@ -728,6 +698,8 @@ export type WorkflowNodeSnapshot = {
     audience: string;
     dynamicAudience?: boolean;
     choices: HumanDecisionChoiceMap;
+    onTimeout?: HumanDecisionTimeout;
+    dynamicTimeout?: boolean;
   };
 };
 
@@ -775,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>;
@@ -825,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. */
@@ -859,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. */
@@ -886,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.
@@ -895,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>;
 }
 
@@ -926,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/builtins/sanity-check-session.d.ts

@@ -1,17 +0,0 @@
-export type IsolatedReviewRequest = {
-    id: string;
-    prompt: string;
-};
-export type PiInvocation = {
-    command: string;
-    prefixArgs: string[];
-};
-export type IsolatedReviewOptions = {
-    invocation?: PiInvocation;
-    timeoutMs?: number;
-    maxOutputChars?: number;
-    maxConcurrency?: number;
-};
-export declare function runIsolatedReviewSessions(requests: IsolatedReviewRequest[], cwd: string, signal: AbortSignal, options?: IsolatedReviewOptions): Promise<Record<string, unknown>>;
-export declare function resolvePiInvocation(): PiInvocation;
-export declare function parsePiJsonOutput(stdout: string): unknown;

package/dist/builtins/sanity-check-session.js

@@ -1,168 +0,0 @@
-import fs from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-import { runCommandBatch } from "../workflows/command-batch.js";
-import { extractJsonValue } from "../workflows/json.js";
-const SESSION_TIMEOUT_MS = 15 * 60_000;
-const SESSION_OUTPUT_CHARS = 1_000_000;
-const MAX_PROMPT_CHARS = 96_000;
-const MAX_ERROR_CHARS = 2_000;
-export async function runIsolatedReviewSessions(requests, cwd, signal, options = {}) {
-    if (requests.length === 0)
-        return {};
-    const ids = new Set();
-    for (const request of requests) {
-        if (!/^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$/.test(request.id)) {
-            throw new Error(`Invalid isolated review id: ${request.id}`);
-        }
-        if (ids.has(request.id))
-            throw new Error(`Duplicate isolated review id: ${request.id}`);
-        ids.add(request.id);
-        if (request.prompt.length > MAX_PROMPT_CHARS) {
-            throw new Error(`Isolated review prompt ${request.id} exceeds ${MAX_PROMPT_CHARS} characters`);
-        }
-    }
-    const promptDir = await fs.mkdtemp(path.join(os.tmpdir(), "pi-sanity-check-"));
-    try {
-        const invocation = options.invocation ?? resolvePiInvocation();
-        const items = await Promise.all(requests.map(async (request) => {
-            const promptPath = path.join(promptDir, `${request.id}.md`);
-            await fs.writeFile(promptPath, request.prompt, { encoding: "utf8", mode: 0o600 });
-            return {
-                id: request.id,
-                command: invocation.command,
-                args: [
-                    ...invocation.prefixArgs,
-                    "--mode",
-                    "json",
-                    "--print",
-                    "--no-session",
-                    "--no-extensions",
-                    "--no-skills",
-                    "--no-context-files",
-                    "--tools",
-                    "read,grep,find,ls",
-                    `@${promptPath}`,
-                    "Follow the attached review instructions and return only the requested JSON.",
-                ],
-                cwd,
-                timeoutMs: options.timeoutMs ?? SESSION_TIMEOUT_MS,
-                maxOutputChars: options.maxOutputChars ?? SESSION_OUTPUT_CHARS,
-            };
-        }));
-        const batch = await runCommandBatch({
-            items,
-            maxConcurrency: options.maxConcurrency ?? requests.length,
-        }, { signal });
-        const outputs = {};
-        for (const item of batch.items) {
-            outputs[item.id] = parseSessionResult(item);
-        }
-        return outputs;
-    }
-    finally {
-        await fs.rm(promptDir, { recursive: true, force: true });
-    }
-}
-export function resolvePiInvocation() {
-    const currentScript = process.argv[1];
-    const isBunVirtualScript = currentScript?.startsWith("/$bunfs/root/");
-    const scriptName = currentScript === undefined ? "" : path.basename(currentScript).toLowerCase();
-    const isPiPackageCli = scriptName === "cli.js" &&
-        currentScript?.split(path.sep).some((segment) => segment === "pi-coding-agent");
-    const isPiScript = /^(pi|pi\.[cm]?js)$/.test(scriptName) || isPiPackageCli;
-    if (currentScript && !isBunVirtualScript && isPiScript) {
-        return {
-            command: process.execPath,
-            prefixArgs: [currentScript, ...inheritedPiArgs(process.argv.slice(2))],
-        };
-    }
-    const execName = path.basename(process.execPath).toLowerCase();
-    if (/^pi(\.exe)?$/.test(execName)) {
-        return { command: process.execPath, prefixArgs: inheritedPiArgs(process.argv.slice(1)) };
-    }
-    return { command: "pi", prefixArgs: [] };
-}
-export function parsePiJsonOutput(stdout) {
-    let finalText = "";
-    for (const line of stdout.split("\n")) {
-        if (!line.trim())
-            continue;
-        let event;
-        try {
-            event = JSON.parse(line);
-        }
-        catch {
-            continue;
-        }
-        if (event.type !== "message_end" || !isRecord(event.message))
-            continue;
-        const message = event.message;
-        if (message.role !== "assistant")
-            continue;
-        if (message.stopReason === "error" || message.stopReason === "aborted") {
-            throw new Error(boundedError(typeof message.errorMessage === "string"
-                ? message.errorMessage
-                : `Pi session stopped with ${String(message.stopReason)}`));
-        }
-        const text = messageText(message.content);
-        if (text.trim())
-            finalText = text;
-    }
-    if (!finalText)
-        throw new Error("Isolated Pi session returned no assistant JSON output");
-    return extractJsonValue(finalText);
-}
-function parseSessionResult(result) {
-    if (result.outcome !== "succeeded") {
-        throw new Error(`Isolated Pi session ${result.id} ${result.outcome}: ${boundedError(result.error ?? result.stderr)}`);
-    }
-    if (result.stdoutTruncated) {
-        throw new Error(`Isolated Pi session ${result.id} exceeded its output limit`);
-    }
-    try {
-        return parsePiJsonOutput(result.stdout);
-    }
-    catch (error) {
-        throw new Error(`Isolated Pi session ${result.id} returned invalid output: ${boundedError(errorMessage(error))}`);
-    }
-}
-function inheritedPiArgs(args) {
-    const inherited = [];
-    for (let index = 0; index < args.length; index += 1) {
-        const arg = args[index];
-        if (arg === "--offline") {
-            inherited.push(arg);
-            continue;
-        }
-        if (arg !== "--provider" && arg !== "--model" && arg !== "--thinking")
-            continue;
-        const value = args[index + 1];
-        if (value !== undefined) {
-            inherited.push(arg, value);
-            index += 1;
-        }
-    }
-    return inherited;
-}
-function messageText(content) {
-    if (typeof content === "string")
-        return content;
-    if (!Array.isArray(content))
-        return "";
-    return content
-        .map((part) => isRecord(part) && part.type === "text" && typeof part.text === "string" ? part.text : "")
-        .filter(Boolean)
-        .join("\n");
-}
-function isRecord(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function errorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-function boundedError(message) {
-    const value = message.trim() || "unknown failure";
-    return value.length <= MAX_ERROR_CHARS ? value : `${value.slice(0, MAX_ERROR_CHARS)}…`;
-}
-//# sourceMappingURL=sanity-check-session.js.map

package/dist/builtins/sanity-check-session.js.map

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

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>;