gate-evm-tools 1.0.26 → 1.0.28

package/dist-runtime/workflow/lib/executionPlan.js

@@ -0,0 +1,450 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.releaseExecutionPlanRelativePath = exports.loadReleaseExecutionPlan = exports.writeReleaseExecutionPlan = exports.ReleaseExecutionPlanner = exports.ExecutionSegmentDeferred = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+class ExecutionSegmentDeferred extends Error {
+    transactionId;
+    constructor(transactionId) {
+        super(`Execution is waiting for the preceding external segment before ${transactionId}`);
+        this.transactionId = transactionId;
+        this.name = "ExecutionSegmentDeferred";
+    }
+}
+exports.ExecutionSegmentDeferred = ExecutionSegmentDeferred;
+const SAFE_ID = /^[A-Za-z0-9][A-Za-z0-9_-]{0,199}$/;
+const ADDRESS = /^0x[0-9a-fA-F]{40}$/;
+const DATA = /^0x(?:[0-9a-fA-F]{2})*$/;
+const HASH = /^[0-9a-f]{64}$/;
+const safeId = (value, label) => {
+    if (typeof value !== "string" || !SAFE_ID.test(value)) {
+        throw new Error(`${label} must match ${SAFE_ID}`);
+    }
+    return value;
+};
+const address = (value, label) => {
+    if (typeof value !== "string" || !ADDRESS.test(value)) {
+        throw new Error(`${label} must be an EVM address`);
+    }
+    if (value.toLowerCase() === "0x0000000000000000000000000000000000000000") {
+        throw new Error(`${label} must be non-zero`);
+    }
+    return value.toLowerCase();
+};
+const value = (raw, label) => {
+    if (typeof raw !== "string" || !/^(?:0[xX][0-9a-fA-F]+|[0-9]+)$/.test(raw)) {
+        throw new Error(`${label} must be a nonnegative integer string`);
+    }
+    return BigInt(raw).toString(10);
+};
+const data = (raw, label) => {
+    if (typeof raw !== "string" || !DATA.test(raw)) {
+        throw new Error(`${label} must be canonical byte calldata`);
+    }
+    return raw.toLowerCase();
+};
+const factoryDeps = (raw, label) => {
+    if (!Array.isArray(raw))
+        throw new Error(`${label} must be an array`);
+    const seen = new Set();
+    const normalized = [];
+    for (const [index, dependency] of raw.entries()) {
+        if (typeof dependency !== "string" || !/^0x(?:[0-9a-fA-F]{2})+$/.test(dependency)) {
+            throw new Error(`${label}[${index}] must be non-empty byte-aligned bytecode`);
+        }
+        const value = dependency.toLowerCase();
+        const hash = crypto_1.default
+            .createHash("sha256")
+            .update(Buffer.from(value.slice(2), "hex"))
+            .digest("hex");
+        if (seen.has(hash))
+            continue;
+        seen.add(hash);
+        normalized.push(value);
+    }
+    return normalized;
+};
+const exactKeys = (value, expected, label) => {
+    const actual = Object.keys(value).sort();
+    const wanted = [...expected].sort();
+    if (actual.length !== wanted.length || actual.some((key, index) => key !== wanted[index])) {
+        throw new Error(`${label} contains unsupported or missing fields`);
+    }
+};
+const record = (raw, label) => {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error(`${label} must be an object`);
+    }
+    return raw;
+};
+const normalizeTransaction = (raw, index, strict) => {
+    const input = record(raw, `transactions[${index}]`);
+    const isZkSync = input.scheme === "zksync-eravm";
+    if (input.scheme !== undefined && !isZkSync) {
+        throw new Error(`transactions[${index}].scheme must be zksync-eravm when present`);
+    }
+    if (isZkSync && input.factoryDeps === undefined) {
+        throw new Error(`transactions[${index}].factoryDeps is required for zkSync`);
+    }
+    if (!isZkSync && input.factoryDeps !== undefined) {
+        throw new Error(`transactions[${index}].factoryDeps is only supported for zkSync`);
+    }
+    if (strict) {
+        exactKeys(input, [
+            "transactionId",
+            "stepId",
+            "transactionIndex",
+            "route",
+            "executor",
+            "to",
+            "value",
+            "data",
+            "operation",
+            ...(isZkSync ? ["scheme", "factoryDeps"] : []),
+        ], `transactions[${index}]`);
+    }
+    if (input.transactionIndex !== index) {
+        throw new Error(`transactions[${index}].transactionIndex must equal ${index}`);
+    }
+    if (input.route !== "operator" && input.route !== "external") {
+        throw new Error(`transactions[${index}].route is invalid`);
+    }
+    if (input.operation !== 0 && input.operation !== 1) {
+        throw new Error(`transactions[${index}].operation must be 0 or 1`);
+    }
+    return {
+        transactionId: safeId(input.transactionId, `transactions[${index}].transactionId`),
+        stepId: safeId(input.stepId, `transactions[${index}].stepId`),
+        transactionIndex: index,
+        route: input.route,
+        executor: address(input.executor, `transactions[${index}].executor`),
+        to: address(input.to, `transactions[${index}].to`),
+        value: value(input.value, `transactions[${index}].value`),
+        data: data(input.data, `transactions[${index}].data`),
+        operation: input.operation,
+        ...(isZkSync ? {
+            scheme: "zksync-eravm",
+            factoryDeps: factoryDeps(input.factoryDeps, `transactions[${index}].factoryDeps`),
+        } : {}),
+    };
+};
+const normalizeBody = (raw, strict) => {
+    const input = record(raw, "execution plan");
+    if (strict) {
+        exactKeys(input, [
+            "version",
+            "taskId",
+            "target",
+            "executionId",
+            "releaseKind",
+            "operator",
+            "transactions",
+        ], "execution plan body");
+    }
+    if (input.version !== 1)
+        throw new Error("execution plan version must be 1");
+    if (input.releaseKind !== "development" && input.releaseKind !== "admin_release") {
+        throw new Error("execution plan releaseKind is invalid");
+    }
+    if (!Array.isArray(input.transactions)) {
+        throw new Error("execution plan transactions must be an array");
+    }
+    const operator = address(input.operator, "execution plan operator");
+    const transactions = input.transactions.map((transaction, index) => (normalizeTransaction(transaction, index, strict)));
+    const transactionIds = new Set();
+    for (const transaction of transactions) {
+        if (transactionIds.has(transaction.transactionId)) {
+            throw new Error(`execution plan contains duplicate transactionId ${transaction.transactionId}`);
+        }
+        transactionIds.add(transaction.transactionId);
+        if (transaction.route === "operator" && transaction.executor !== operator) {
+            throw new Error(`operator transaction ${transaction.transactionId} must use the plan operator`);
+        }
+        if (transaction.route === "external" && transaction.executor === operator) {
+            throw new Error(`external transaction ${transaction.transactionId} cannot use the plan operator`);
+        }
+    }
+    if (input.releaseKind === "development"
+        && transactions.some((transaction) => transaction.route === "external")) {
+        throw new Error("development execution plans cannot contain external transactions");
+    }
+    return {
+        version: 1,
+        taskId: safeId(input.taskId, "execution plan taskId"),
+        target: safeId(input.target, "execution plan target"),
+        executionId: safeId(input.executionId, "execution plan executionId"),
+        releaseKind: input.releaseKind,
+        operator,
+        transactions,
+    };
+};
+const hashBody = (body) => {
+    return crypto_1.default.createHash("sha256").update(JSON.stringify(body)).digest("hex");
+};
+const confinedPath = (root, taskDir, target, executionId) => {
+    const resolvedRoot = path_1.default.resolve(root);
+    const resolvedTask = path_1.default.resolve(taskDir);
+    const relativeTask = path_1.default.relative(resolvedRoot, resolvedTask);
+    if (relativeTask === "" || relativeTask.startsWith("..") || path_1.default.isAbsolute(relativeTask)) {
+        throw new Error("execution plan task directory must be inside the project root");
+    }
+    const filePath = path_1.default.join(resolvedTask, "results", target, executionId, "execution-plan.json");
+    const relativeFile = path_1.default.relative(resolvedTask, filePath);
+    if (relativeFile.startsWith("..") || path_1.default.isAbsolute(relativeFile)) {
+        throw new Error("execution plan path escapes the task directory");
+    }
+    return filePath;
+};
+const assertNoSymlinks = (root, target) => {
+    const resolvedRoot = path_1.default.resolve(root);
+    const resolvedTarget = path_1.default.resolve(target);
+    const relative = path_1.default.relative(resolvedRoot, resolvedTarget);
+    if (relative.startsWith("..") || path_1.default.isAbsolute(relative)) {
+        throw new Error("execution plan path escapes its trusted root");
+    }
+    let current = resolvedRoot;
+    if (fs_1.default.existsSync(current) && fs_1.default.lstatSync(current).isSymbolicLink()) {
+        throw new Error("execution plan path contains a symlink");
+    }
+    for (const segment of relative.split(path_1.default.sep).filter(Boolean)) {
+        current = path_1.default.join(current, segment);
+        if (fs_1.default.existsSync(current) && fs_1.default.lstatSync(current).isSymbolicLink()) {
+            throw new Error("execution plan path contains a symlink");
+        }
+    }
+};
+const writeExclusive = (filePath, value) => {
+    fs_1.default.mkdirSync(path_1.default.dirname(filePath), { recursive: true });
+    let descriptor;
+    try {
+        descriptor = fs_1.default.openSync(filePath, "wx", 0o600);
+    }
+    catch (error) {
+        throw error;
+    }
+    try {
+        fs_1.default.writeFileSync(descriptor, JSON.stringify(value, null, 2) + "\n");
+        fs_1.default.fsyncSync(descriptor);
+    }
+    catch (error) {
+        fs_1.default.closeSync(descriptor);
+        fs_1.default.unlinkSync(filePath);
+        throw error;
+    }
+    fs_1.default.closeSync(descriptor);
+};
+class ReleaseExecutionPlanner {
+    body;
+    expected;
+    transactions = [];
+    segmentedExecution;
+    completedTransactions;
+    segmentEnd;
+    constructor(input) {
+        const body = normalizeBody({
+            version: 1,
+            taskId: input.taskId,
+            target: input.target,
+            executionId: input.executionId,
+            releaseKind: input.releaseKind,
+            operator: input.operator,
+            transactions: [],
+        }, false);
+        this.body = {
+            version: 1,
+            taskId: body.taskId,
+            target: body.target,
+            executionId: body.executionId,
+            releaseKind: body.releaseKind,
+            operator: body.operator,
+        };
+        if (input.expectedPlan) {
+            const expected = normalizeBody(input.expectedPlan, false);
+            for (const key of ["taskId", "target", "executionId", "releaseKind", "operator"]) {
+                if (expected[key] !== this.body[key]) {
+                    throw new Error(`locked execution plan ${key} does not match the runtime`);
+                }
+            }
+            this.expected = expected;
+        }
+        this.segmentedExecution = input.segmentedExecution === true;
+        this.completedTransactions = input.completedTransactions ?? [];
+        if (this.segmentedExecution && !this.expected) {
+            throw new Error("segmented execution requires a locked execution plan");
+        }
+        if (!this.segmentedExecution && this.completedTransactions.length > 0) {
+            throw new Error("completed transactions require segmented execution");
+        }
+        if (this.expected) {
+            if (this.completedTransactions.length > this.expected.transactions.length) {
+                throw new Error("completed transactions exceed the execution plan");
+            }
+            for (const [index, completed] of this.completedTransactions.entries()) {
+                if (completed.transactionId !== this.expected.transactions[index]?.transactionId
+                    || typeof completed.transactionHash !== "string"
+                    || !/^0x[0-9a-fA-F]{64}$/.test(completed.transactionHash)) {
+                    throw new Error("completed transactions must form a contiguous plan prefix");
+                }
+            }
+        }
+        const expectedTransactions = this.expected?.transactions ?? [];
+        let segmentEnd = this.completedTransactions.length;
+        if (this.segmentedExecution && segmentEnd < expectedTransactions.length) {
+            if (expectedTransactions[segmentEnd].route === "operator") {
+                while (segmentEnd < expectedTransactions.length
+                    && expectedTransactions[segmentEnd].route === "operator")
+                    segmentEnd += 1;
+            }
+            while (segmentEnd < expectedTransactions.length
+                && expectedTransactions[segmentEnd].route === "external")
+                segmentEnd += 1;
+        }
+        else if (!this.segmentedExecution) {
+            segmentEnd = Number.MAX_SAFE_INTEGER;
+        }
+        this.segmentEnd = segmentEnd;
+    }
+    add(input) {
+        const index = this.transactions.length;
+        const stepId = safeId(input.stepId, "planned transaction stepId");
+        const executor = address(input.executor, "planned transaction executor");
+        const transaction = normalizeTransaction({
+            transactionId: `tx-${String(index + 1).padStart(4, "0")}-${stepId}`,
+            stepId,
+            transactionIndex: index,
+            route: executor === this.body.operator ? "operator" : "external",
+            executor,
+            to: input.to,
+            value: input.value,
+            data: input.data,
+            operation: input.operation,
+            ...(input.scheme === undefined ? {} : { scheme: input.scheme }),
+            ...(input.factoryDeps === undefined ? {} : { factoryDeps: input.factoryDeps }),
+        }, index, false);
+        if (this.body.releaseKind === "development" && transaction.route === "external") {
+            throw new Error("development execution plans cannot contain external transactions");
+        }
+        const expected = this.expected?.transactions[index];
+        if (this.expected && (!expected || JSON.stringify(expected) !== JSON.stringify(transaction))) {
+            throw new Error(`transaction ${transaction.transactionId} does not match locked execution plan`);
+        }
+        if (this.segmentedExecution && index >= this.segmentEnd) {
+            throw new ExecutionSegmentDeferred(transaction.transactionId);
+        }
+        this.transactions.push(transaction);
+        const completed = this.completedTransactions[index];
+        if (completed) {
+            return {
+                ...transaction,
+                executionAction: "replay",
+                transactionHash: completed.transactionHash.toLowerCase(),
+            };
+        }
+        return {
+            ...transaction,
+            executionAction: transaction.route === "external" ? "package" : "execute",
+        };
+    }
+    complete(options = {}) {
+        if (this.expected
+            && this.transactions.length !== this.expected.transactions.length
+            && options.allowPartial !== true) {
+            throw new Error("execution did not consume every locked transaction");
+        }
+        if (options.allowPartial === true && !this.segmentedExecution) {
+            throw new Error("partial execution plan completion requires segmented execution");
+        }
+        return normalizeBody({
+            ...this.body,
+            transactions: this.transactions,
+        }, false);
+    }
+}
+exports.ReleaseExecutionPlanner = ReleaseExecutionPlanner;
+const writeReleaseExecutionPlan = (input) => {
+    const body = normalizeBody(input.plan, false);
+    const filePath = confinedPath(input.root, input.taskDir, body.target, body.executionId);
+    assertNoSymlinks(input.root, filePath);
+    const plan = {
+        ...body,
+        planHash: hashBody(body),
+        createdAt: new Date().toISOString(),
+    };
+    if (fs_1.default.existsSync(filePath)) {
+        const existing = (0, exports.loadReleaseExecutionPlan)({
+            root: input.root,
+            taskDir: input.taskDir,
+            target: body.target,
+            executionId: body.executionId,
+        });
+        if (existing.planHash === plan.planHash)
+            return existing;
+        throw new Error("execution plan already exists with different content");
+    }
+    writeExclusive(filePath, plan);
+    return plan;
+};
+exports.writeReleaseExecutionPlan = writeReleaseExecutionPlan;
+const loadReleaseExecutionPlan = (input) => {
+    const target = safeId(input.target, "execution plan target");
+    const executionId = safeId(input.executionId, "execution plan executionId");
+    const filePath = confinedPath(input.root, input.taskDir, target, executionId);
+    assertNoSymlinks(input.root, filePath);
+    let parsed;
+    try {
+        parsed = JSON.parse(fs_1.default.readFileSync(filePath, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`Cannot load execution plan: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const inputPlan = record(parsed, "execution plan");
+    exactKeys(inputPlan, [
+        "version",
+        "taskId",
+        "target",
+        "executionId",
+        "releaseKind",
+        "operator",
+        "transactions",
+        "planHash",
+        "createdAt",
+    ], "execution plan");
+    const body = normalizeBody({
+        version: inputPlan.version,
+        taskId: inputPlan.taskId,
+        target: inputPlan.target,
+        executionId: inputPlan.executionId,
+        releaseKind: inputPlan.releaseKind,
+        operator: inputPlan.operator,
+        transactions: inputPlan.transactions,
+    }, true);
+    if (body.target !== target || body.executionId !== executionId) {
+        throw new Error("execution plan path identity does not match its contents");
+    }
+    if (typeof inputPlan.createdAt !== "string" || !Number.isFinite(Date.parse(inputPlan.createdAt))) {
+        throw new Error("execution plan createdAt must be an ISO timestamp");
+    }
+    const calculatedHash = hashBody(body);
+    if (typeof inputPlan.planHash !== "string" || !HASH.test(inputPlan.planHash)) {
+        throw new Error("execution plan planHash is invalid");
+    }
+    if (inputPlan.planHash !== calculatedHash) {
+        throw new Error("execution plan hash does not match its contents");
+    }
+    if (input.expectedHash !== undefined && input.expectedHash !== calculatedHash) {
+        throw new Error("execution plan hash does not match the parameter lock");
+    }
+    return {
+        ...body,
+        planHash: calculatedHash,
+        createdAt: inputPlan.createdAt,
+    };
+};
+exports.loadReleaseExecutionPlan = loadReleaseExecutionPlan;
+const releaseExecutionPlanRelativePath = (taskDir, plan) => path_1.default.relative(taskDir, path_1.default.join(taskDir, "results", plan.target, plan.executionId, "execution-plan.json")).split(path_1.default.sep).join("/");
+exports.releaseExecutionPlanRelativePath = releaseExecutionPlanRelativePath;
+//# sourceMappingURL=executionPlan.js.map

package/dist-runtime/workflow/lib/executionPlan.js.map

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

package/dist-runtime/workflow/lib/executionProgress.d.ts

@@ -0,0 +1,5 @@
+import type { CompletedExecutionTransaction, ReleaseExecutionPlan } from "./executionPlan";
+export declare const loadCompletedExecutionPrefix: (input: {
+    taskDir: string;
+    plan: ReleaseExecutionPlan;
+}) => CompletedExecutionTransaction[];

package/dist-runtime/workflow/lib/executionProgress.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadCompletedExecutionPrefix = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const operatorExecution_1 = require("./operatorExecution");
+const TRANSACTION_HASH = /^0x[0-9a-fA-F]{64}$/;
+const reconciliationPath = (taskDir, plan) => path_1.default.join(taskDir, "results", plan.target, plan.executionId, "external-reconciliation.json");
+const readReconciliationMatches = (taskDir, plan) => {
+    const filePath = reconciliationPath(taskDir, plan);
+    if (!fs_1.default.existsSync(filePath))
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(fs_1.default.readFileSync(filePath, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`external reconciliation report is invalid: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("external reconciliation report must be an object");
+    }
+    const report = parsed;
+    if (report.version !== 1
+        || report.taskId !== plan.taskId
+        || report.target !== plan.target
+        || report.executionId !== plan.executionId
+        || report.executionPlanHash !== plan.planHash
+        || !Array.isArray(report.matches)) {
+        throw new Error("external reconciliation report does not match the execution plan");
+    }
+    if (report.status === "failed") {
+        throw new Error("failed external reconciliation cannot be resumed");
+    }
+    return report.matches;
+};
+const loadCompletedExecutionPrefix = (input) => {
+    const operatorPath = path_1.default.join(input.taskDir, "results", input.plan.target, input.plan.executionId, "operator-execution.json");
+    const operatorResult = fs_1.default.existsSync(operatorPath)
+        ? (0, operatorExecution_1.loadOperatorExecutionResult)({ taskDir: input.taskDir, plan: input.plan })
+        : undefined;
+    const evidence = new Map();
+    for (const receipt of operatorResult?.receipts ?? []) {
+        evidence.set(receipt.transactionId, receipt);
+    }
+    const seenMatches = new Set();
+    for (const match of readReconciliationMatches(input.taskDir, input.plan)) {
+        const transactionIndex = match.transactionIndex;
+        const expected = Number.isSafeInteger(transactionIndex)
+            ? input.plan.transactions[transactionIndex]
+            : undefined;
+        if (!expected
+            || match.transactionId !== expected.transactionId
+            || match.route !== expected.route
+            || String(match.executor).toLowerCase() !== expected.executor
+            || typeof match.transactionHash !== "string"
+            || !TRANSACTION_HASH.test(match.transactionHash)
+            || (match.receiptStatus !== 0 && match.receiptStatus !== 1)
+            || typeof match.finalized !== "boolean"
+            || seenMatches.has(expected.transactionId)) {
+            throw new Error("external reconciliation matches do not bind the execution plan");
+        }
+        seenMatches.add(expected.transactionId);
+        if (match.receiptStatus === 0) {
+            throw new Error(`reverted transaction ${expected.transactionId} cannot be resumed`);
+        }
+        if (expected.route === "operator") {
+            const receipt = evidence.get(expected.transactionId);
+            if (receipt && receipt.transactionHash !== match.transactionHash.toLowerCase()) {
+                throw new Error(`operator reconciliation hash differs for ${expected.transactionId}`);
+            }
+            continue;
+        }
+        if (match.finalized) {
+            evidence.set(expected.transactionId, {
+                transactionId: expected.transactionId,
+                transactionHash: match.transactionHash.toLowerCase(),
+            });
+        }
+    }
+    const completed = [];
+    let prefixEnded = false;
+    for (const transaction of input.plan.transactions) {
+        const item = evidence.get(transaction.transactionId);
+        if (!item) {
+            prefixEnded = true;
+            continue;
+        }
+        if (prefixEnded) {
+            throw new Error("execution evidence must form a contiguous plan prefix");
+        }
+        completed.push(item);
+    }
+    return completed;
+};
+exports.loadCompletedExecutionPrefix = loadCompletedExecutionPrefix;
+//# sourceMappingURL=executionProgress.js.map

package/dist-runtime/workflow/lib/executionProgress.js.map

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

package/dist-runtime/workflow/lib/external.d.ts

@@ -0,0 +1,62 @@
+import type { ReleaseExecutionPlan } from "./executionPlan";
+export interface ExternalCall {
+    transactionId: string;
+    stepId: string;
+    to: string;
+    value: string;
+    data: string;
+    operation: 0 | 1;
+    scheme?: "zksync-eravm";
+    factoryDeps?: string[];
+    method: string;
+    args: unknown[];
+    executor: string;
+    reason: string;
+}
+export interface ExternalExecutionGroup {
+    groupId: string;
+    executor: string;
+    transactionIds: string[];
+    calls: ExternalCall[];
+}
+export interface ExternalExecutionSegment {
+    segmentId: string;
+    transactionStartIndex: number;
+    transactionIds: string[];
+    handoffBlock: number;
+    groups: ExternalExecutionGroup[];
+    createdAt: string;
+}
+export interface ExternalExecutionPackage {
+    version: 1;
+    taskId: string;
+    target: string;
+    executionId: string;
+    operator: string;
+    executionPlanHash: string;
+    segments: ExternalExecutionSegment[];
+    createdAt: string;
+    updatedAt: string;
+}
+export declare class ExternalExecutionRequired extends Error {
+    readonly stepId: string;
+    readonly calls: ExternalCall[];
+    constructor(stepId: string, calls: ExternalCall[]);
+}
+export declare const loadExternalExecutionPackage: (input: {
+    taskDir: string;
+    plan: ReleaseExecutionPlan;
+}) => {
+    filePath: string;
+    package: ExternalExecutionPackage;
+} | undefined;
+export declare const writeExternalExecutionPackage: (input: {
+    taskDir: string;
+    plan: ReleaseExecutionPlan;
+    handoffBlock: number;
+    calls: ExternalCall[];
+    now?: () => string;
+}) => {
+    filePath: string;
+    package: ExternalExecutionPackage;
+};