import type { AgentEnvironmentCreation, AgentEnvironmentStatus, AgentSessionStatus, PlacementInfo } from "@tangle-network/agent-interface/environment-provider";
import type { SandboxCreateReceiptLike, SandboxInstanceLike } from "./tangle-types.js";
export declare function nonEmptyString(value: unknown): string | undefined;
export declare function optionalNonEmptyString(value: unknown, label: string): string | undefined;
export declare function placementInfoFromLoopPlacement(placement: unknown, box: SandboxInstanceLike): PlacementInfo;
export declare function statusFromUnknown(status: unknown): AgentEnvironmentStatus;
export declare function sessionStatusFromUnknown(status: unknown): AgentSessionStatus;
/**
 * Bind a session-wide status payload to one exact execution.
 *
 * The Sandbox status endpoint reports the whole session. Its execution
 * identity fields — activeExecutionId, latestExecutionId, runControlRef,
 * failureReason.executionId — are the only proof of which execution the
 * lifecycle state describes. A payload that names a different execution, or
 * none, must not be attributed to the exact run, so the result degrades to
 * "unknown" instead of fabricating an execution-scoped answer.
 */
export declare function executionBoundSessionStatus(payload: unknown, executionId: string): AgentSessionStatus;
/**
 * Map the platform create receipt to the environment creation verdict. An
 * `unknown` outcome, a null receipt, and an SDK without receipts all leave the
 * verdict absent, so a consumer cannot read them as proof of creation.
 */
export declare function creationFromSandboxCreateReceipt(receipt: SandboxCreateReceiptLike | null | undefined): AgentEnvironmentCreation | undefined;