@superdoc-dev/sdk 1.19.2 → 1.20.1

package/dist/action-primitives/engine.cjs

@@ -0,0 +1,204 @@
+'use strict';
+
+var docIndex = require('./doc-index.cjs');
+var receipt = require('./receipt.cjs');
+var sessionCache = require('./session-cache.cjs');
+
+function workflowStepSuccess(value) {
+    return { ok: true, value };
+}
+function workflowStepFailure(failure) {
+    return { ok: false, failure };
+}
+function workflowNotImplementedFailure(input) {
+    return {
+        status: 'not_implemented',
+        phase: input.phase,
+        code: input.code,
+        message: input.message,
+        details: input.details,
+    };
+}
+function toIndexSummary(index) {
+    return {
+        revision: index.revision,
+        blocks: index.blocks.length,
+        lists: index.lists.length,
+        tables: index.tables.length,
+    };
+}
+function coerceErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+async function ensureDocIndex(input) {
+    const sessionState = input.cache.getState(input.documentHandle);
+    const info = await input.documentHandle.info({}, input.invokeOptions);
+    const cached = input.cache.getCachedIndex(input.documentHandle, info.revision);
+    if (cached != null) {
+        return { sessionState, info, index: cached };
+    }
+    const index = await docIndex.buildWorkflowDocIndex({
+        documentHandle: input.documentHandle,
+        documentKey: sessionState.documentKey,
+        invokeOptions: input.invokeOptions,
+        info,
+    });
+    input.cache.setCachedIndex(input.documentHandle, index);
+    return { sessionState, info, index };
+}
+function receiptFromFailure(toolName, sessionState, index, failure) {
+    const details = { code: failure.code, ...failure.details };
+    if (failure.status === 'not_implemented') {
+        return receipt.createWorkflowNotImplementedReceipt({
+            toolName,
+            sessionKey: sessionState.documentKey,
+            phase: failure.phase,
+            message: failure.message,
+            index: toIndexSummary(index),
+            details,
+        });
+    }
+    return receipt.createWorkflowFailureReceipt({
+        toolName,
+        sessionKey: sessionState.documentKey,
+        phase: failure.phase,
+        message: failure.message,
+        index: toIndexSummary(index),
+        details,
+    });
+}
+function exceptionFailure(phase, error) {
+    return {
+        status: 'failed',
+        phase,
+        code: 'WORKFLOW_ENGINE_STEP_EXCEPTION',
+        message: `Workflow engine phase "${phase}" threw unexpectedly.`,
+        details: { error: coerceErrorMessage(error) },
+    };
+}
+async function runWorkflowEngine(input) {
+    const cache = input.cache ?? sessionCache.workflowPocSessionCache;
+    const { sessionState, info, index } = await ensureDocIndex({
+        documentHandle: input.documentHandle,
+        invokeOptions: input.invokeOptions,
+        cache,
+    });
+    const context = {
+        toolName: input.toolName,
+        args: input.args,
+        documentHandle: input.documentHandle,
+        invokeOptions: input.invokeOptions,
+        sessionState,
+        info,
+        index,
+    };
+    let resolvedStep;
+    try {
+        resolvedStep = await input.hooks.resolve(context);
+    }
+    catch (error) {
+        resolvedStep = workflowStepFailure(exceptionFailure('resolve', error));
+    }
+    if (!resolvedStep.ok) {
+        return {
+            receipt: receiptFromFailure(input.toolName, sessionState, index, resolvedStep.failure),
+            index,
+            sessionState,
+        };
+    }
+    let planStep;
+    try {
+        if (input.hooks.plan == null) {
+            planStep = workflowStepSuccess({ resolved: resolvedStep.value, args: context.args });
+        }
+        else {
+            planStep = await input.hooks.plan(context, resolvedStep.value);
+        }
+    }
+    catch (error) {
+        planStep = workflowStepFailure(exceptionFailure('plan', error));
+    }
+    if (!planStep.ok) {
+        return {
+            receipt: receiptFromFailure(input.toolName, sessionState, index, planStep.failure),
+            index,
+            sessionState,
+        };
+    }
+    if (input.hooks.execute == null) {
+        const notImplemented = workflowNotImplementedFailure({
+            phase: 'execute',
+            code: 'WORKFLOW_TOOL_EXECUTE_NOT_IMPLEMENTED',
+            message: `Workflow tool "${input.toolName}" has no execute implementation yet.`,
+        });
+        return {
+            receipt: receiptFromFailure(input.toolName, sessionState, index, notImplemented),
+            index,
+            sessionState,
+        };
+    }
+    let executionStep;
+    try {
+        executionStep = await input.hooks.execute(context, resolvedStep.value, planStep.value);
+    }
+    catch (error) {
+        executionStep = workflowStepFailure(exceptionFailure('execute', error));
+    }
+    if (!executionStep.ok) {
+        return {
+            receipt: receiptFromFailure(input.toolName, sessionState, index, executionStep.failure),
+            index,
+            sessionState,
+        };
+    }
+    if (input.hooks.verify == null) {
+        const notImplemented = workflowNotImplementedFailure({
+            phase: 'verify',
+            code: 'WORKFLOW_TOOL_VERIFY_NOT_IMPLEMENTED',
+            message: `Workflow tool "${input.toolName}" has no verify implementation yet.`,
+        });
+        return {
+            receipt: receiptFromFailure(input.toolName, sessionState, index, notImplemented),
+            index,
+            sessionState,
+        };
+    }
+    let verificationStep;
+    try {
+        verificationStep = await input.hooks.verify(context, resolvedStep.value, planStep.value, executionStep.value);
+    }
+    catch (error) {
+        verificationStep = workflowStepFailure(exceptionFailure('verify', error));
+    }
+    if (!verificationStep.ok) {
+        return {
+            receipt: receiptFromFailure(input.toolName, sessionState, index, verificationStep.failure),
+            index,
+            sessionState,
+        };
+    }
+    return {
+        receipt: receipt.createWorkflowSuccessReceipt({
+            toolName: input.toolName,
+            sessionKey: sessionState.documentKey,
+            message: `Workflow tool "${input.toolName}" completed.`,
+            index: toIndexSummary(index),
+        }),
+        output: {
+            resolved: resolvedStep.value,
+            plan: planStep.value,
+            execution: executionStep.value,
+            verification: verificationStep.value,
+        },
+        index,
+        sessionState,
+    };
+}
+
+exports.runWorkflowEngine = runWorkflowEngine;
+exports.workflowNotImplementedFailure = workflowNotImplementedFailure;
+exports.workflowStepFailure = workflowStepFailure;
+exports.workflowStepSuccess = workflowStepSuccess;

package/dist/action-primitives/engine.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Shared resolve -> plan -> execute -> verify pipeline for action-primitive tools.
+ *
+ * Each workflow tool plugs in only the steps it needs. The engine owns the
+ * common concerns: reuse the indexed document snapshot, convert thrown
+ * exceptions into structured receipts, and return a stable success/failure
+ * payload shape to the caller.
+ */
+import type { BoundDocApi, DocInfoResult } from '../generated/client.js';
+import type { InvokeOptions } from '../runtime/process.js';
+import { type WorkflowDocIndex } from './doc-index.js';
+import { type WorkflowExecutionPhase, type WorkflowToolResult } from './receipt.js';
+import { type WorkflowSessionCache, type WorkflowSessionState } from './session-cache.js';
+import type { WorkflowPocToolName } from './types.js';
+export type WorkflowEngineFailure = {
+    status: 'failed' | 'not_implemented';
+    phase: WorkflowExecutionPhase;
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+};
+export type WorkflowStepResult<TValue> = {
+    ok: true;
+    value: TValue;
+} | {
+    ok: false;
+    failure: WorkflowEngineFailure;
+};
+export declare function workflowStepSuccess<TValue>(value: TValue): WorkflowStepResult<TValue>;
+export declare function workflowStepFailure(failure: WorkflowEngineFailure): WorkflowStepResult<never>;
+export declare function workflowNotImplementedFailure(input: {
+    phase: WorkflowExecutionPhase;
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}): WorkflowEngineFailure;
+export type WorkflowEngineContext = {
+    toolName: WorkflowPocToolName;
+    args: Record<string, unknown>;
+    documentHandle: BoundDocApi;
+    invokeOptions?: InvokeOptions;
+    sessionState: WorkflowSessionState;
+    info: DocInfoResult;
+    index: WorkflowDocIndex;
+};
+export type WorkflowEngineHooks<TResolved, TPlan, TExecution, TVerification> = {
+    resolve: (context: WorkflowEngineContext) => Promise<WorkflowStepResult<TResolved>>;
+    plan?: (context: WorkflowEngineContext, resolved: TResolved) => Promise<WorkflowStepResult<TPlan>>;
+    execute?: (context: WorkflowEngineContext, resolved: TResolved, plan: TPlan) => Promise<WorkflowStepResult<TExecution>>;
+    verify?: (context: WorkflowEngineContext, resolved: TResolved, plan: TPlan, execution: TExecution) => Promise<WorkflowStepResult<TVerification>>;
+};
+export type WorkflowEngineRunInput<TResolved, TPlan, TExecution, TVerification> = {
+    documentHandle: BoundDocApi;
+    toolName: WorkflowPocToolName;
+    args: Record<string, unknown>;
+    invokeOptions?: InvokeOptions;
+    cache?: WorkflowSessionCache;
+    hooks: WorkflowEngineHooks<TResolved, TPlan, TExecution, TVerification>;
+};
+export type WorkflowEngineOutput<TResolved, TPlan, TExecution, TVerification> = {
+    resolved: TResolved;
+    plan: TPlan;
+    execution: TExecution;
+    verification: TVerification;
+};
+export type WorkflowEngineRunResult<TResolved, TPlan, TExecution, TVerification> = WorkflowToolResult<WorkflowEngineOutput<TResolved, TPlan, TExecution, TVerification>> & {
+    index: WorkflowDocIndex;
+    sessionState: WorkflowSessionState;
+};
+export declare function runWorkflowEngine<TResolved, TPlan, TExecution, TVerification>(input: WorkflowEngineRunInput<TResolved, TPlan, TExecution, TVerification>): Promise<WorkflowEngineRunResult<TResolved, TPlan, TExecution, TVerification>>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/action-primitives/engine.d.ts.map

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

package/dist/action-primitives/engine.js

@@ -0,0 +1,196 @@
+import { buildWorkflowDocIndex } from './doc-index.js';
+import { createWorkflowFailureReceipt, createWorkflowNotImplementedReceipt, createWorkflowSuccessReceipt, } from './receipt.js';
+import { workflowPocSessionCache } from './session-cache.js';
+export function workflowStepSuccess(value) {
+    return { ok: true, value };
+}
+export function workflowStepFailure(failure) {
+    return { ok: false, failure };
+}
+export function workflowNotImplementedFailure(input) {
+    return {
+        status: 'not_implemented',
+        phase: input.phase,
+        code: input.code,
+        message: input.message,
+        details: input.details,
+    };
+}
+function toIndexSummary(index) {
+    return {
+        revision: index.revision,
+        blocks: index.blocks.length,
+        lists: index.lists.length,
+        tables: index.tables.length,
+    };
+}
+function coerceErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+async function ensureDocIndex(input) {
+    const sessionState = input.cache.getState(input.documentHandle);
+    const info = await input.documentHandle.info({}, input.invokeOptions);
+    const cached = input.cache.getCachedIndex(input.documentHandle, info.revision);
+    if (cached != null) {
+        return { sessionState, info, index: cached };
+    }
+    const index = await buildWorkflowDocIndex({
+        documentHandle: input.documentHandle,
+        documentKey: sessionState.documentKey,
+        invokeOptions: input.invokeOptions,
+        info,
+    });
+    input.cache.setCachedIndex(input.documentHandle, index);
+    return { sessionState, info, index };
+}
+function receiptFromFailure(toolName, sessionState, index, failure) {
+    const details = { code: failure.code, ...failure.details };
+    if (failure.status === 'not_implemented') {
+        return createWorkflowNotImplementedReceipt({
+            toolName,
+            sessionKey: sessionState.documentKey,
+            phase: failure.phase,
+            message: failure.message,
+            index: toIndexSummary(index),
+            details,
+        });
+    }
+    return createWorkflowFailureReceipt({
+        toolName,
+        sessionKey: sessionState.documentKey,
+        phase: failure.phase,
+        message: failure.message,
+        index: toIndexSummary(index),
+        details,
+    });
+}
+function exceptionFailure(phase, error) {
+    return {
+        status: 'failed',
+        phase,
+        code: 'WORKFLOW_ENGINE_STEP_EXCEPTION',
+        message: `Workflow engine phase "${phase}" threw unexpectedly.`,
+        details: { error: coerceErrorMessage(error) },
+    };
+}
+export async function runWorkflowEngine(input) {
+    const cache = input.cache ?? workflowPocSessionCache;
+    const { sessionState, info, index } = await ensureDocIndex({
+        documentHandle: input.documentHandle,
+        invokeOptions: input.invokeOptions,
+        cache,
+    });
+    const context = {
+        toolName: input.toolName,
+        args: input.args,
+        documentHandle: input.documentHandle,
+        invokeOptions: input.invokeOptions,
+        sessionState,
+        info,
+        index,
+    };
+    let resolvedStep;
+    try {
+        resolvedStep = await input.hooks.resolve(context);
+    }
+    catch (error) {
+        resolvedStep = workflowStepFailure(exceptionFailure('resolve', error));
+    }
+    if (!resolvedStep.ok) {
+        return {
+            receipt: receiptFromFailure(input.toolName, sessionState, index, resolvedStep.failure),
+            index,
+            sessionState,
+        };
+    }
+    let planStep;
+    try {
+        if (input.hooks.plan == null) {
+            planStep = workflowStepSuccess({ resolved: resolvedStep.value, args: context.args });
+        }
+        else {
+            planStep = await input.hooks.plan(context, resolvedStep.value);
+        }
+    }
+    catch (error) {
+        planStep = workflowStepFailure(exceptionFailure('plan', error));
+    }
+    if (!planStep.ok) {
+        return {
+            receipt: receiptFromFailure(input.toolName, sessionState, index, planStep.failure),
+            index,
+            sessionState,
+        };
+    }
+    if (input.hooks.execute == null) {
+        const notImplemented = workflowNotImplementedFailure({
+            phase: 'execute',
+            code: 'WORKFLOW_TOOL_EXECUTE_NOT_IMPLEMENTED',
+            message: `Workflow tool "${input.toolName}" has no execute implementation yet.`,
+        });
+        return {
+            receipt: receiptFromFailure(input.toolName, sessionState, index, notImplemented),
+            index,
+            sessionState,
+        };
+    }
+    let executionStep;
+    try {
+        executionStep = await input.hooks.execute(context, resolvedStep.value, planStep.value);
+    }
+    catch (error) {
+        executionStep = workflowStepFailure(exceptionFailure('execute', error));
+    }
+    if (!executionStep.ok) {
+        return {
+            receipt: receiptFromFailure(input.toolName, sessionState, index, executionStep.failure),
+            index,
+            sessionState,
+        };
+    }
+    if (input.hooks.verify == null) {
+        const notImplemented = workflowNotImplementedFailure({
+            phase: 'verify',
+            code: 'WORKFLOW_TOOL_VERIFY_NOT_IMPLEMENTED',
+            message: `Workflow tool "${input.toolName}" has no verify implementation yet.`,
+        });
+        return {
+            receipt: receiptFromFailure(input.toolName, sessionState, index, notImplemented),
+            index,
+            sessionState,
+        };
+    }
+    let verificationStep;
+    try {
+        verificationStep = await input.hooks.verify(context, resolvedStep.value, planStep.value, executionStep.value);
+    }
+    catch (error) {
+        verificationStep = workflowStepFailure(exceptionFailure('verify', error));
+    }
+    if (!verificationStep.ok) {
+        return {
+            receipt: receiptFromFailure(input.toolName, sessionState, index, verificationStep.failure),
+            index,
+            sessionState,
+        };
+    }
+    return {
+        receipt: createWorkflowSuccessReceipt({
+            toolName: input.toolName,
+            sessionKey: sessionState.documentKey,
+            message: `Workflow tool "${input.toolName}" completed.`,
+            index: toIndexSummary(index),
+        }),
+        output: {
+            resolved: resolvedStep.value,
+            plan: planStep.value,
+            execution: executionStep.value,
+            verification: verificationStep.value,
+        },
+        index,
+        sessionState,
+    };
+}

package/dist/action-primitives/receipt.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+const WORKFLOW_POC_PROFILE = 'workflow-poc';
+function createWorkflowReceiptBase(input) {
+    return {
+        profile: WORKFLOW_POC_PROFILE,
+        toolName: input.toolName,
+        status: input.status,
+        phase: input.phase,
+        sessionKey: input.sessionKey,
+        message: input.message,
+        index: input.index,
+        details: input.details,
+    };
+}
+function createWorkflowSuccessReceipt(input) {
+    return createWorkflowReceiptBase({
+        ...input,
+        phase: input.phase ?? 'verify',
+        status: 'success',
+    });
+}
+function createWorkflowFailureReceipt(input) {
+    return createWorkflowReceiptBase({
+        ...input,
+        status: 'failed',
+    });
+}
+function createWorkflowNotImplementedReceipt(input) {
+    return createWorkflowReceiptBase({
+        ...input,
+        status: 'not_implemented',
+    });
+}
+
+exports.WORKFLOW_POC_PROFILE = WORKFLOW_POC_PROFILE;
+exports.createWorkflowFailureReceipt = createWorkflowFailureReceipt;
+exports.createWorkflowNotImplementedReceipt = createWorkflowNotImplementedReceipt;
+exports.createWorkflowSuccessReceipt = createWorkflowSuccessReceipt;

package/dist/action-primitives/receipt.d.ts

@@ -0,0 +1,49 @@
+import type { WorkflowPocToolName } from './types.js';
+export declare const WORKFLOW_POC_PROFILE: "workflow-poc";
+export type WorkflowExecutionPhase = 'resolve' | 'plan' | 'execute' | 'verify';
+export type WorkflowReceiptStatus = 'success' | 'failed' | 'not_implemented';
+export type WorkflowIndexSummary = {
+    revision: string;
+    blocks: number;
+    lists: number;
+    tables: number;
+};
+export type WorkflowReceipt = {
+    profile: typeof WORKFLOW_POC_PROFILE;
+    toolName: WorkflowPocToolName;
+    status: WorkflowReceiptStatus;
+    phase: WorkflowExecutionPhase;
+    sessionKey: string;
+    message: string;
+    index: WorkflowIndexSummary;
+    details?: Record<string, unknown>;
+};
+export type WorkflowToolResult<TOutput = unknown> = {
+    receipt: WorkflowReceipt;
+    output?: TOutput;
+};
+export declare function createWorkflowSuccessReceipt(input: {
+    toolName: WorkflowPocToolName;
+    sessionKey: string;
+    phase?: WorkflowExecutionPhase;
+    message: string;
+    index: WorkflowIndexSummary;
+    details?: Record<string, unknown>;
+}): WorkflowReceipt;
+export declare function createWorkflowFailureReceipt(input: {
+    toolName: WorkflowPocToolName;
+    sessionKey: string;
+    phase: WorkflowExecutionPhase;
+    message: string;
+    index: WorkflowIndexSummary;
+    details?: Record<string, unknown>;
+}): WorkflowReceipt;
+export declare function createWorkflowNotImplementedReceipt(input: {
+    toolName: WorkflowPocToolName;
+    sessionKey: string;
+    phase: WorkflowExecutionPhase;
+    message: string;
+    index: WorkflowIndexSummary;
+    details?: Record<string, unknown>;
+}): WorkflowReceipt;
+//# sourceMappingURL=receipt.d.ts.map

package/dist/action-primitives/receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../../src/action-primitives/receipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,eAAO,MAAM,oBAAoB,EAAG,cAAuB,CAAC;AAE5D,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAC/E,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,QAAQ,GAAG,iBAAiB,CAAC;AAE7E,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,OAAO,oBAAoB,CAAC;IACrC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,EAAE,sBAAsB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,OAAO,GAAG,OAAO,IAAI;IAClD,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAyBF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,eAAe,CAMlB;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,sBAAsB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,eAAe,CAKlB;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,sBAAsB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,eAAe,CAKlB"}

package/dist/action-primitives/receipt.js

@@ -0,0 +1,32 @@
+export const WORKFLOW_POC_PROFILE = 'workflow-poc';
+function createWorkflowReceiptBase(input) {
+    return {
+        profile: WORKFLOW_POC_PROFILE,
+        toolName: input.toolName,
+        status: input.status,
+        phase: input.phase,
+        sessionKey: input.sessionKey,
+        message: input.message,
+        index: input.index,
+        details: input.details,
+    };
+}
+export function createWorkflowSuccessReceipt(input) {
+    return createWorkflowReceiptBase({
+        ...input,
+        phase: input.phase ?? 'verify',
+        status: 'success',
+    });
+}
+export function createWorkflowFailureReceipt(input) {
+    return createWorkflowReceiptBase({
+        ...input,
+        status: 'failed',
+    });
+}
+export function createWorkflowNotImplementedReceipt(input) {
+    return createWorkflowReceiptBase({
+        ...input,
+        status: 'not_implemented',
+    });
+}