botmux 3.9.2 → 3.10.0

package/dist/workflows/v3/portable-run-snapshot.js

@@ -0,0 +1,176 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+import { canonicalJson, computeInputHash, } from '../../utils/canonical-input-hash.js';
+import { validateDag } from './dag.js';
+export const PORTABLE_RUN_SNAPSHOT_FILE = 'portable-run.snapshot.json';
+const LEGACY_RUN_ARTIFACTS = [
+    'journal.ndjson',
+    'dag.json',
+    'bots.snapshot.json',
+    'STATE',
+];
+function canonicalClone(value) {
+    return JSON.parse(canonicalJson(value));
+}
+function normalizeProfiles(profiles) {
+    return [...profiles]
+        .sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)
+        .map(([selector, profile]) => ({
+        selector,
+        profile: canonicalClone(profile),
+    }));
+}
+function createSnapshot(dag, profiles) {
+    const normalizedDag = canonicalClone(validateDag(dag));
+    const executionProfiles = normalizeProfiles(profiles);
+    const dagHash = computeInputHash(normalizedDag);
+    const executionProfilesHash = computeInputHash(executionProfiles);
+    return {
+        schemaVersion: 1,
+        dag: normalizedDag,
+        dagHash,
+        executionProfiles,
+        executionProfilesHash,
+        definitionHash: computeInputHash({
+            dagHash,
+            executionProfilesHash,
+        }),
+    };
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function parseProfile(raw, selector) {
+    if (!isObject(raw)) {
+        throw new Error(`execution profile "${selector || '<default>'}" is not an object`);
+    }
+    const allowed = new Set([
+        'profileId',
+        'executorId',
+        'workingDirectory',
+        'model',
+        'adapterData',
+    ]);
+    const unknown = Object.keys(raw).filter((key) => !allowed.has(key));
+    if (unknown.length > 0) {
+        throw new Error(`execution profile "${selector || '<default>'}" has unknown fields: ${unknown.join(', ')}`);
+    }
+    if (typeof raw.profileId !== 'string'
+        || typeof raw.executorId !== 'string'
+        || typeof raw.workingDirectory !== 'string'
+        || (raw.model !== undefined && typeof raw.model !== 'string')) {
+        throw new Error(`execution profile "${selector || '<default>'}" is malformed`);
+    }
+    return {
+        profileId: raw.profileId,
+        executorId: raw.executorId,
+        workingDirectory: raw.workingDirectory,
+        ...(raw.model !== undefined ? { model: raw.model } : {}),
+        ...(raw.adapterData !== undefined
+            ? { adapterData: canonicalClone(raw.adapterData) }
+            : {}),
+    };
+}
+function parseSnapshot(raw) {
+    if (!isObject(raw) || raw.schemaVersion !== 1) {
+        throw new Error('unsupported or malformed snapshot schema');
+    }
+    const dag = validateDag(raw.dag);
+    if (!Array.isArray(raw.executionProfiles)) {
+        throw new Error('executionProfiles must be an array');
+    }
+    const selectors = new Set();
+    const executionProfiles = raw.executionProfiles.map((entry, index) => {
+        if (!isObject(entry) || typeof entry.selector !== 'string') {
+            throw new Error(`executionProfiles[${index}] is malformed`);
+        }
+        if (selectors.has(entry.selector)) {
+            throw new Error(`duplicate execution profile selector "${entry.selector}"`);
+        }
+        selectors.add(entry.selector);
+        return {
+            selector: entry.selector,
+            profile: parseProfile(entry.profile, entry.selector),
+        };
+    });
+    if (typeof raw.dagHash !== 'string'
+        || typeof raw.executionProfilesHash !== 'string'
+        || typeof raw.definitionHash !== 'string') {
+        throw new Error('snapshot hashes are missing');
+    }
+    const snapshot = {
+        schemaVersion: 1,
+        dag,
+        dagHash: raw.dagHash,
+        executionProfiles,
+        executionProfilesHash: raw.executionProfilesHash,
+        definitionHash: raw.definitionHash,
+    };
+    const actualDagHash = computeInputHash(snapshot.dag);
+    const actualProfilesHash = computeInputHash(snapshot.executionProfiles);
+    const actualDefinitionHash = computeInputHash({
+        dagHash: actualDagHash,
+        executionProfilesHash: actualProfilesHash,
+    });
+    if (snapshot.dagHash !== actualDagHash
+        || snapshot.executionProfilesHash !== actualProfilesHash
+        || snapshot.definitionHash !== actualDefinitionHash) {
+        throw new Error('snapshot integrity check failed');
+    }
+    return snapshot;
+}
+function readSnapshot(path) {
+    try {
+        return parseSnapshot(JSON.parse(readFileSync(path, 'utf-8')));
+    }
+    catch (error) {
+        throw new Error(`v3 runtime: frozen portable run snapshot is unreadable: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function writeSnapshotOnce(path, snapshot) {
+    try {
+        writeFileSync(path, `${JSON.stringify(snapshot, null, 2)}\n`, {
+            encoding: 'utf-8',
+            flag: 'wx',
+            mode: 0o600,
+        });
+    }
+    catch (error) {
+        if (typeof error !== 'object'
+            || error === null
+            || !('code' in error)
+            || error.code !== 'EEXIST') {
+            throw error;
+        }
+    }
+}
+/**
+ * Freeze the complete portable execution contract before the journal starts.
+ * A legacy run without this artifact cannot prove its original host profile,
+ * so recovery fails closed instead of blessing the caller's current config.
+ */
+export function assertOrCreatePortableRunSnapshot(runDir, dag, profiles) {
+    mkdirSync(runDir, { recursive: true });
+    const path = join(runDir, PORTABLE_RUN_SNAPSHOT_FILE);
+    const expected = createSnapshot(dag, profiles);
+    if (!existsSync(path)) {
+        const existingArtifact = LEGACY_RUN_ARTIFACTS.find((name) => existsSync(join(runDir, name)));
+        if (existingArtifact) {
+            throw new Error(`v3 runtime: cannot safely resume run without ${PORTABLE_RUN_SNAPSHOT_FILE} `
+                + `(found ${existingArtifact})`);
+        }
+        writeSnapshotOnce(path, expected);
+    }
+    const stored = readSnapshot(path);
+    if (stored.dagHash !== expected.dagHash) {
+        throw new Error('v3 runtime: frozen workflow definition differs from this resume request');
+    }
+    if (stored.executionProfilesHash !== expected.executionProfilesHash) {
+        throw new Error('v3 runtime: frozen execution profiles differ from this resume request');
+    }
+    return {
+        dag: stored.dag,
+        executionProfiles: new Map(stored.executionProfiles.map(({ selector, profile }) => [selector, profile])),
+    };
+}
+//# sourceMappingURL=portable-run-snapshot.js.map

package/dist/workflows/v3/portable-run-snapshot.js.map

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

package/dist/workflows/v3/portable-runtime.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Host-neutral adapter for the complete v3 Node runtime.
+ *
+ * The action realization remains single-sourced in shared-node-runtime.ts;
+ * this adapter only translates execution profiles and agent calls.
+ */
+import type { ValidateManifest } from './artifact-contract.js';
+import { type V3Dag } from './dag.js';
+import type { PortableWorkflowFinalOutput } from './portable-final-outputs.js';
+import type { AgentExecutor, AttemptLeaseProvider, ExecutionContextSnapshot, ExecutionProfileSnapshot, GateResolver, HostExecutorRegistry, HostExecutorPolicy, ProviderReconciler } from './runtime-host-contract.js';
+export interface PortableWorkflowPendingGate {
+    nodeId: string;
+    waitId: string;
+    prompt: string;
+    options: string[];
+    approveOptions: string[];
+    approvers: string[];
+    hostApproval?: {
+        attemptId: string;
+        approvalDigest: string;
+        inputHash: string;
+    };
+}
+export { readPortableWorkflowFinalOutputs, } from './portable-final-outputs.js';
+export type { PortableWorkflowFinalOutput, } from './portable-final-outputs.js';
+export type PortableWorkflowRunOutcome = {
+    reason: 'terminal';
+    runStatus: 'succeeded' | 'failed' | 'blocked' | 'cancelled';
+    failedNodeId?: string;
+    blockedNodeId?: string;
+    failureReason?: 'allSinksSkipped';
+    failureDetail?: string;
+    uncertainHostEffects?: Array<{
+        nodeId: string;
+        instanceId: string;
+        attemptId: string;
+        executor: string;
+        errorCode: string;
+    }>;
+    finalOutputs: PortableWorkflowFinalOutput[];
+    runDir: string;
+} | {
+    reason: 'awaitingGate';
+    pendingWaits: PortableWorkflowPendingGate[];
+    runDir: string;
+};
+export interface PortableWorkflowRuntimeDeps {
+    executeAgent: AgentExecutor;
+    validateManifest: ValidateManifest;
+    resolveExecutionProfile: (selector: string | undefined) => ExecutionProfileSnapshot;
+    validateExecutionProfile?: (profile: ExecutionProfileSnapshot, selector: string) => void;
+    /**
+     * Optional only for fresh process-local runs. The default provider cannot
+     * prove old attempts closed after recovery and therefore returns `unknown`.
+     * Desktop and other durable hosts must inject a durable provider.
+     */
+    attemptLeaseProvider?: AttemptLeaseProvider;
+    hostExecutors?: HostExecutorRegistry;
+    hostReconcilers?: Map<string, ProviderReconciler>;
+    hostExecutorPolicy?: HostExecutorPolicy;
+    now?: () => number;
+    resolveGate?: GateResolver;
+}
+export interface PortableWorkflowRuntimeOptions {
+    /**
+     * Durable run root. Reusing the same baseDir + dag.runId formally resumes
+     * the existing journal and does not redispatch settled nodes.
+     */
+    baseDir: string;
+    gateMode?: 'blocking' | 'suspend';
+    globalConcurrency?: number;
+    frozenExecutionProfiles?: ReadonlyMap<string, ExecutionProfileSnapshot>;
+    perProfileConcurrency?: number;
+    perExecutorConcurrency?: number;
+    cancelSignal?: AbortSignal;
+    authorizedArtifacts?: boolean;
+    executionContext?: ExecutionContextSnapshot;
+    /** @deprecated Use `executionContext`. */
+    resolvedWorkflowData?: ExecutionContextSnapshot;
+    hostResponseWaitMs?: number;
+}
+export declare function runPortableWorkflow(dag: V3Dag, deps: PortableWorkflowRuntimeDeps, options: PortableWorkflowRuntimeOptions): Promise<PortableWorkflowRunOutcome>;
+//# sourceMappingURL=portable-runtime.d.ts.map

package/dist/workflows/v3/portable-runtime.d.ts.map

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

package/dist/workflows/v3/portable-runtime.js

@@ -0,0 +1,135 @@
+/**
+ * Host-neutral adapter for the complete v3 Node runtime.
+ *
+ * The action realization remains single-sourced in shared-node-runtime.ts;
+ * this adapter only translates execution profiles and agent calls.
+ */
+import { isGoalNode, isLoopNode, validateDag, } from './dag.js';
+import { createInProcessAttemptLeaseProvider } from './in-process-attempt-lease.js';
+import { readPortableWorkflowFinalOutputs } from './portable-final-outputs.js';
+import { assertOrCreatePortableRunSnapshot } from './portable-run-snapshot.js';
+import { runWorkflow as runNodeWorkflow } from './shared-node-runtime.js';
+import { join } from 'node:path';
+export { readPortableWorkflowFinalOutputs, } from './portable-final-outputs.js';
+function defaultValidateProfile(profile, selector) {
+    if (!profile.profileId || !profile.executorId || !profile.workingDirectory) {
+        throw new Error(`v3 runtime: execution profile "${selector || '<default>'}" is incomplete`);
+    }
+}
+function botSnapshotFor(profile) {
+    return {
+        // These legacy field names are confined to this adapter. The scheduler
+        // treats them as opaque profile/executor/cwd slots.
+        larkAppId: profile.profileId,
+        cliId: profile.executorId,
+        workingDir: profile.workingDirectory,
+        ...(profile.model ? { model: profile.model } : {}),
+    };
+}
+export async function runPortableWorkflow(dag, deps, options) {
+    const normalizedDag = validateDag(dag);
+    let profiles = new Map(options.frozenExecutionProfiles ?? []);
+    const resolveProfile = (selector) => {
+        const key = selector ?? '';
+        const existing = profiles.get(key);
+        if (existing)
+            return existing;
+        if (options.frozenExecutionProfiles) {
+            throw new Error(`v3 runtime: frozen execution profiles are missing selector "${key || '<default>'}"`);
+        }
+        const profile = deps.resolveExecutionProfile(selector);
+        profiles.set(key, profile);
+        return profile;
+    };
+    for (const node of normalizedDag.nodes) {
+        if (isGoalNode(node))
+            resolveProfile(node.bot);
+        if (isLoopNode(node)) {
+            for (const bodyNode of node.body.nodes) {
+                resolveProfile(bodyNode.bot ?? node.bot);
+            }
+        }
+    }
+    const validateProfile = deps.validateExecutionProfile ?? defaultValidateProfile;
+    for (const [selector, executionProfile] of profiles) {
+        validateProfile(executionProfile, selector);
+    }
+    const frozenDefinition = assertOrCreatePortableRunSnapshot(join(options.baseDir, normalizedDag.runId), normalizedDag, profiles);
+    profiles = frozenDefinition.executionProfiles;
+    const frozenDag = frozenDefinition.dag;
+    const profileById = new Map();
+    for (const executionProfile of profiles.values()) {
+        profileById.set(executionProfile.profileId, executionProfile);
+    }
+    const requireProfile = (selector) => {
+        const key = selector ?? '';
+        const executionProfile = profiles.get(key);
+        if (!executionProfile) {
+            throw new Error(`v3 runtime: frozen execution profiles are missing selector "${key || '<default>'}"`);
+        }
+        return executionProfile;
+    };
+    const runNode = async (request) => {
+        const profile = profileById.get(request.botSnapshot.larkAppId);
+        if (!profile) {
+            throw new Error(`v3 runtime: execution profile "${request.botSnapshot.larkAppId}" was not frozen`);
+        }
+        if (!request.attemptLease) {
+            throw new Error(`v3 runtime: attempt ${request.attemptId} has no lease`);
+        }
+        return deps.executeAgent({
+            runId: request.runId,
+            attemptId: request.attemptId,
+            attemptLease: request.attemptLease,
+            node: request.node,
+            executionProfile: {
+                ...profile,
+                ...(request.botSnapshot.model ? { model: request.botSnapshot.model } : {}),
+            },
+            runDir: request.runDir,
+            attemptDir: request.attemptDir,
+            inputsPath: request.inputsPath,
+            outputDir: request.outputDir,
+            env: request.env,
+            timeoutMs: request.timeoutMs,
+            ...(request.onSessionReady ? { onSessionReady: request.onSessionReady } : {}),
+            ...(request.stdoutPath ? { stdoutPath: request.stdoutPath } : {}),
+            ...(request.stderrPath ? { stderrPath: request.stderrPath } : {}),
+        });
+    };
+    const outcome = await runNodeWorkflow(frozenDag, {
+        runNode,
+        validateManifest: deps.validateManifest,
+        resolveBotSnapshot: (selector) => botSnapshotFor(requireProfile(selector)),
+        validateExecutionSnapshot: (snapshot, selector) => {
+            const profile = profileById.get(snapshot.larkAppId);
+            if (!profile) {
+                throw new Error(`v3 runtime: profile "${snapshot.larkAppId}" is unavailable`);
+            }
+            validateProfile(profile, selector);
+        },
+        attemptLeaseProvider: deps.attemptLeaseProvider ?? createInProcessAttemptLeaseProvider(),
+        ...(deps.hostExecutors ? { hostExecutors: deps.hostExecutors } : {}),
+        ...(deps.hostReconcilers ? { hostReconcilers: deps.hostReconcilers } : {}),
+        ...(deps.hostExecutorPolicy ? { hostExecutorPolicy: deps.hostExecutorPolicy } : {}),
+        ...(deps.now ? { now: deps.now } : {}),
+        ...(deps.resolveGate ? { resolveGate: deps.resolveGate } : {}),
+    }, {
+        ...options,
+        perBotConcurrency: options.perProfileConcurrency,
+        perCliConcurrency: options.perExecutorConcurrency,
+        frozenBotSnapshots: new Map([...profiles].map(([key, profile]) => [
+            key,
+            botSnapshotFor(profile),
+        ])),
+    });
+    if (outcome.reason !== 'terminal')
+        return outcome;
+    return {
+        ...outcome,
+        finalOutputs: outcome.runStatus === 'succeeded'
+            ? await readPortableWorkflowFinalOutputs(frozenDag, outcome.runDir, deps.validateManifest)
+            : [],
+    };
+}
+//# sourceMappingURL=portable-runtime.js.map

package/dist/workflows/v3/portable-runtime.js.map

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

package/dist/workflows/v3/runtime-host-contract.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Host-neutral contracts for embedding the v3 workflow runtime.
+ *
+ * These types deliberately avoid daemon, Lark, worker-fence, and Botmux bot
+ * configuration details. A host may keep its own durable state and adapt it
+ * into this boundary.
+ */
+import type { V3GoalNode } from './dag.js';
+export interface ExecutionContextSnapshot {
+    /** Immutable workflow parameters resolved when the run is authorized. */
+    readonly params: Readonly<Record<string, unknown>>;
+    /** Immutable host identity/context values resolved when the run is authorized. */
+    readonly context: Readonly<Record<string, string>>;
+}
+/**
+ * One scheduler-owned execution lease. The id is durable while the signal is
+ * process-local; hosts should use the id for audit and the signal for teardown.
+ */
+export interface AttemptLease {
+    readonly attemptId: string;
+    readonly signal: AbortSignal;
+    /** Opaque provider token passed from the scheduler to the agent executor. */
+    readonly hostToken?: unknown;
+}
+export type AttemptLeaseCloseReason = 'pre_aborted' | 'setup_failed';
+export interface AttemptLeaseBinding {
+    runId: string;
+    attemptId: string;
+    attemptDir: string;
+}
+export interface AttemptLeaseAcquisition {
+    hostToken?: unknown;
+    /** Preserve the legacy Botmux journal marker without imposing it on hosts. */
+    auditKind: 'workerFence' | 'attemptLease';
+}
+export type AttemptLeaseDrainResult = 
+/** Exact external ownership is proven closed; journal proof precedes finalization. */
+{
+    status: 'closed';
+    finalizeAfterProof(): void;
+}
+/** `pending` is known live ownership; `unknown` means the host cannot prove either state. */
+ | {
+    status: 'pending' | 'unknown';
+};
+export interface AttemptLeaseProvider {
+    /**
+     * Durable/restartable hosts (including Desktop) must back this contract with
+     * host-owned execution state. Recovery may return `closed` only after proving
+     * the exact executor/terminal attempt stopped; `finalizeAfterProof` runs only
+     * after the workflow journal durably records that close.
+     */
+    acquire(binding: AttemptLeaseBinding): AttemptLeaseAcquisition;
+    closeBeforeExecution(binding: AttemptLeaseBinding, acquisition: AttemptLeaseAcquisition, reason: AttemptLeaseCloseReason): void;
+    drainExternallyOwned(binding: AttemptLeaseBinding): AttemptLeaseDrainResult;
+    cleanupSettled(binding: AttemptLeaseBinding, acquisition?: AttemptLeaseAcquisition): void;
+}
+export interface ExecutionProfileSnapshot {
+    /** Stable profile selector frozen for this run. */
+    readonly profileId: string;
+    /** Concurrency/capability domain, e.g. a CLI or remote execution backend. */
+    readonly executorId: string;
+    readonly workingDirectory: string;
+    readonly model?: string;
+    /**
+     * Host-owned, JSON-safe, non-secret adapter configuration. Persist stable
+     * credential references here; the executor resolves live secrets itself.
+     */
+    readonly adapterData?: unknown;
+}
+export interface AgentSessionInfo {
+    sessionId: string;
+    webPort?: number;
+    token?: string;
+}
+export interface AgentExecutionRequest {
+    runId: string;
+    attemptId: string;
+    attemptLease: AttemptLease;
+    node: V3GoalNode;
+    executionProfile: ExecutionProfileSnapshot;
+    runDir: string;
+    attemptDir: string;
+    inputsPath: string;
+    outputDir: string;
+    env: Record<string, string>;
+    timeoutMs: number;
+    onSessionReady?: (info: AgentSessionInfo & {
+        ptyLogPath?: string;
+    }) => void | Promise<void>;
+    stdoutPath?: string;
+    stderrPath?: string;
+}
+export interface AgentExecutionResult {
+    status: 'ok' | 'fail' | 'cancelled';
+    cancelReason?: unknown;
+    manifestPath: string;
+    sessionInfo?: AgentSessionInfo;
+}
+export type AgentExecutor = (request: AgentExecutionRequest) => Promise<AgentExecutionResult>;
+export type ExecutorErrorClassification = {
+    errorCode: string;
+    errorClass: 'retryable' | 'fatal' | 'userFault' | 'manual';
+    errorMessage: string;
+};
+export interface HostSideEffectExecutor<Input = unknown, Output = unknown> {
+    readonly provider: string;
+    readonly idempotencyTtlMs: number;
+    canonicalInput(input: Input): unknown;
+    validateBeforeIntent?(input: Input, nowMs: number): {
+        ok: true;
+    } | {
+        ok: false;
+        errorCode: string;
+        message: string;
+    };
+    invoke(input: Input, idempotencyKey: string): Promise<{
+        output: Output;
+        externalRefs: Record<string, unknown>;
+    }>;
+    classifyError?(error: unknown): ExecutorErrorClassification | null;
+}
+export type RegisteredHostExecutor<Input = unknown, Output = unknown> = {
+    executor: HostSideEffectExecutor<Input, Output>;
+    parseInput(input: unknown): Input;
+};
+export type HostExecutorRegistry = Map<string, RegisteredHostExecutor>;
+export type ReadOnlyLookupResult = {
+    found: true;
+    externalRefs: Record<string, unknown>;
+    evidence?: Record<string, unknown>;
+} | {
+    found: false;
+    evidence?: Record<string, unknown>;
+};
+export type IdempotentSubmitResult = {
+    ok: true;
+    externalRefs: Record<string, unknown>;
+    evidence?: Record<string, unknown>;
+} | {
+    ok: false;
+    errorCode: string;
+    errorClass: 'retryable' | 'fatal' | 'userFault' | 'manual';
+    errorMessage: string;
+    evidence?: Record<string, unknown>;
+};
+export interface ProviderReconciler {
+    readonly provider: string;
+    readonly requiresEffectInput?: boolean;
+    readOnlyLookup?(idempotencyKey: string, input: unknown): Promise<ReadOnlyLookupResult>;
+    idempotentSubmit?(idempotencyKey: string, input: unknown): Promise<IdempotentSubmitResult>;
+    canonicalInput?(input: unknown): unknown;
+}
+export interface HostExecutorPolicyRequest {
+    readonly nodeId: string;
+    readonly executor: string;
+    readonly input: unknown;
+    readonly executionContext?: ExecutionContextSnapshot;
+}
+/**
+ * Synchronous by design: authorization must finish before a prepared host
+ * effect can be committed or presented for approval.
+ */
+export type HostExecutorPolicy = (request: HostExecutorPolicyRequest) => void;
+export interface GateResolutionRequest {
+    nodeId: string;
+    prompt: string;
+    waitId: string;
+    runDir: string;
+    hostApproval?: {
+        attemptId: string;
+        approvalDigest: string;
+        inputHash: string;
+    };
+}
+export interface GateResolution {
+    resolution: 'approved' | 'rejected';
+    by: string;
+    selected?: string;
+}
+export type GateResolver = (request: GateResolutionRequest) => Promise<GateResolution>;
+//# sourceMappingURL=runtime-host-contract.d.ts.map

package/dist/workflows/v3/runtime-host-contract.d.ts.map

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

package/dist/workflows/v3/runtime-host-contract.js

@@ -0,0 +1,9 @@
+/**
+ * Host-neutral contracts for embedding the v3 workflow runtime.
+ *
+ * These types deliberately avoid daemon, Lark, worker-fence, and Botmux bot
+ * configuration details. A host may keep its own durable state and adapt it
+ * into this boundary.
+ */
+export {};
+//# sourceMappingURL=runtime-host-contract.js.map

package/dist/workflows/v3/runtime-host-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-host-contract.js","sourceRoot":"","sources":["../../../src/workflows/v3/runtime-host-contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}