@tangle-network/agent-interface 0.45.0 → 0.46.1

package/dist/environment-provider.d.ts

@@ -1,730 +1,3 @@
-import { z } from "zod";
-import type { AgentProfile, AgentProfileCapabilities, AgentProfileValidationResult } from "./agent-profile.js";
-import type { AgentCandidateTermination } from "./agent-candidate.js";
-import type { InputPart, StreamEvent, TokenUsage } from "./index.js";
-import { type InteractionAcknowledgement, type InteractionCapabilities, type InteractionResponseCommand } from "./interaction.js";
-import { type ContextTransferReceipt, type ContextTransferRequest, type NativeContextBoundaryProof, type NativeContextContinuationRequest, type NativeContextContinuationTurn } from "./portable-context.js";
-import { type AgentRunCancellationAcknowledgement, type AgentRunCancellationRequest, type AgentRunControlRef } from "./runtime-control.js";
-import type { AgentWorkspaceBranching } from "./workspace-branching.js";
-/** Portable profile reference: inline profile or provider catalog id. */
-export type AgentProfileRef = AgentProfile | string;
-export type AgentEnvironmentStatus = "pending" | "provisioning" | "running" | "stopped" | "failed" | "expired" | "unknown";
-export type AgentSessionStatus = AgentEnvironmentStatus | "completed" | "cancelled";
-export interface WorkspaceRequest {
-    /** Provider-specific environment/template id, for example "universal". */
-    environment?: string;
-    /** Container image or image alias when the provider supports image-backed workspaces. */
-    image?: string;
-    /** Repository to clone or mount before the agent runs. */
-    repoUrl?: string;
-    /** Git ref for {@link repoUrl}. */
-    gitRef?: string;
-    /** Initial working directory inside the environment. */
-    cwd?: string;
-    /** Opaque provider-native workspace fields. */
-    providerOptions?: Record<string, unknown>;
-}
-export interface ResourceRequest {
-    cpu?: number;
-    memoryMb?: number;
-    diskMb?: number;
-    gpu?: string;
-    providerOptions?: Record<string, unknown>;
-}
-export interface AgentEnvironmentQuery {
-    name?: string;
-    metadata?: Record<string, unknown>;
-    providerOptions?: Record<string, unknown>;
-}
-export interface AgentEnvironmentSummary {
-    id: string;
-    provider: string;
-    name?: string;
-    status?: AgentEnvironmentStatus;
-    metadata?: Record<string, unknown>;
-}
-export interface ExecRequest {
-    cwd?: string;
-    env?: Record<string, string>;
-    timeoutMs?: number;
-    signal?: AbortSignal;
-}
-export interface ExecResult {
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-}
-export type AgentExactProcessEgressMode = "blocked" | "strict";
-/**
- * Outbound network policy for an exact process environment. `blocked` denies
- * every protocol. `strict` permits only the named domains; direct-address,
- * alternate-protocol, and cross-environment bypasses must fail.
- */
-export type AgentExactProcessEgressPolicy = {
-    mode: "blocked";
-} | {
-    mode: "strict";
-    allowDomains: readonly string[];
-};
-/** Explicit portable limits for an exact process environment. */
-export interface AgentExactProcessResources {
-    /** Positive CPU core count. */
-    cpu: number;
-    /** Positive integer mebibytes of memory. */
-    memoryMb: number;
-    /** Positive integer mebibytes of disk. */
-    diskMb: number;
-}
-/** Terminal or running state reported by an exact process host. */
-export interface AgentExactProcessStatus {
-    pid: number;
-    running: boolean;
-    /** -1 while running; the exact process exit code after termination. */
-    exitCode: number;
-    exitSignal?: string;
-    /** Required after termination; absent only while running. */
-    termination?: AgentCandidateTermination;
-}
-/** Recoverable handle for one shell-free process. */
-export interface AgentExactProcess {
-    readonly pid: number;
-    status(): Promise<AgentExactProcessStatus>;
-    wait(): Promise<AgentCandidateTermination>;
-    /** Force-stop the full process tree. Idempotent after the process exits. */
-    kill(): Promise<void>;
-    /** Each iteration replays buffered UTF-8 stdout, then continues until exit. */
-    stdout(): AsyncIterable<string>;
-    /** Each iteration replays buffered UTF-8 stderr, then continues until exit. */
-    stderr(): AsyncIterable<string>;
-}
-/** Shell-free launch whose environment replaces, rather than extends, ambient variables. */
-export interface AgentExactProcessLaunch {
-    /** Absolute path unless {@link env} supplies an explicit `PATH`. */
-    executable: string;
-    args: readonly string[];
-    cwd: string;
-    env: Readonly<Record<string, string>>;
-    stdin?: string;
-    /** Positive integer milliseconds, or zero to disable the process timeout. */
-    timeoutMs: number;
-}
-export interface AgentExactProcessManager {
-    list(): Promise<AgentExactProcessStatus[]>;
-    get(pid: number): Promise<AgentExactProcess | null>;
-    /** Providers must honor the abort signal when supplied. */
-    spawn(input: AgentExactProcessLaunch, options?: {
-        signal?: AbortSignal;
-    }): Promise<AgentExactProcess>;
-}
-/**
- * Fresh environment with no provider-managed user workload.
- *
- * Authenticated provider control services may exist, but no customer workload
- * ingress or provider-managed user process may exist. The launched process
- * sees only its supplied environment variables, with no ambient or injected
- * secrets.
- */
-export interface AgentExactProcessEnvironment {
-    readonly id: string;
-    readonly provider: string;
-    readonly metadata?: Record<string, unknown>;
-    readonly process: AgentExactProcessManager;
-    /** Write exact bytes to an absolute path with a POSIX mode from 0 through 07777. Providers must honor the abort signal when supplied. */
-    writeFile(path: string, bytes: Uint8Array, options: {
-        mode: number;
-        signal?: AbortSignal;
-    }): Promise<void>;
-    /** Read exact bytes or fail before content is loaded when the file exceeds maxBytes. */
-    readFile(path: string, options: {
-        maxBytes: number;
-        signal?: AbortSignal;
-    }): Promise<Uint8Array>;
-    destroy(): Promise<void>;
-}
-export interface AgentExactProcessEnvironmentQuery {
-    /** Every supplied key/value must match persisted environment metadata exactly. */
-    metadata?: Record<string, unknown>;
-    providerOptions?: Record<string, unknown>;
-}
-/** Input for a fresh environment with no provider-managed agent process. */
-export interface CreateAgentExactProcessEnvironmentInput {
-    /** Provider-specific immutable image reference. */
-    image: string;
-    egress: AgentExactProcessEgressPolicy;
-    /** Positive integer milliseconds. */
-    maxLifetimeMs: number;
-    /** Positive integer milliseconds when supplied. */
-    provisionTimeoutMs?: number;
-    /** Required limits; exact execution never inherits provider defaults. */
-    resources: AgentExactProcessResources;
-    metadata: Record<string, unknown>;
-    idempotencyKey: string;
-    signal?: AbortSignal;
-    /** Provider-native fields may narrow, but never weaken, the isolation contract. */
-    providerOptions?: Record<string, unknown>;
-}
-/** Optional all-or-nothing exact process capability of an environment provider. */
-export interface AgentExactProcessProvider {
-    /**
-     * Repeating the same idempotency key and input returns the same environment.
-     * Reusing the key with any different create input must fail.
-     * Unsupported egress modes must fail instead of weakening the policy.
-     */
-    create(input: CreateAgentExactProcessEnvironmentInput): Promise<AgentExactProcessEnvironment>;
-    /** Ordinary environments must return null. */
-    get(id: string): Promise<AgentExactProcessEnvironment | null>;
-    /** Return every matching exact environment; providers own any native pagination. */
-    list(query?: AgentExactProcessEnvironmentQuery): Promise<AgentExactProcessEnvironment[]>;
-}
-export interface CheckpointRequest {
-    name?: string;
-    metadata?: Record<string, unknown>;
-}
-export interface CheckpointRef {
-    id: string;
-    provider?: string;
-    metadata?: Record<string, unknown>;
-}
-export interface ForkRequest {
-    name?: string;
-    metadata?: Record<string, unknown>;
-}
-export interface PlacementInfo {
-    kind: "local" | "sandbox" | "fleet" | "provider";
-    sandboxId?: string;
-    fleetId?: string;
-    machineId?: string;
-    region?: string;
-    providerMetadata?: Record<string, unknown>;
-}
-export interface AgentTurnInput {
-    prompt?: string;
-    parts?: InputPart[];
-    sessionId?: string;
-    model?: string;
-    timeoutMs?: number;
-    executionId?: string;
-    lastEventId?: string;
-    turnId?: string;
-    detach?: boolean;
-    /** Stable coordinates for a retained run when one already exists. */
-    controlRef?: AgentRunControlRef;
-    /** Approved portable history for a fresh provider session. */
-    contextTransfer?: ContextTransferRequest;
-    /** Verified same-session continuation; never carries duplicate history. */
-    nativeContinuation?: NativeContextContinuationRequest;
-    context?: Record<string, unknown>;
-    signal?: AbortSignal;
-    providerOptions?: Record<string, unknown>;
-}
-export interface AgentTurnResult {
-    text: string;
-    success: boolean;
-    error?: string;
-    sessionId?: string;
-    usage?: TokenUsage;
-    metadata?: Record<string, unknown>;
-    events?: AgentEnvironmentEvent[];
-    contextTransferReceipt?: ContextTransferReceipt;
-}
-/** Runtime validator for a provider turn returned from durable continuation. */
-export declare const AgentTurnResultSchema: z.ZodObject<{
-    text: z.ZodString;
-    success: z.ZodBoolean;
-    error: z.ZodOptional<z.ZodString>;
-    sessionId: z.ZodOptional<z.ZodString>;
-    usage: z.ZodOptional<z.ZodObject<{
-        inputTokens: z.ZodNumber;
-        outputTokens: z.ZodNumber;
-        totalTokens: z.ZodOptional<z.ZodNumber>;
-        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
-        cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
-        reasoningTokens: z.ZodOptional<z.ZodNumber>;
-        cost: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strict>>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    events: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        type: z.ZodString;
-        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        id: z.ZodOptional<z.ZodString>;
-        normalized: z.ZodOptional<z.ZodType<StreamEvent, unknown, z.core.$ZodTypeInternals<StreamEvent, unknown>>>;
-        usage: z.ZodOptional<z.ZodObject<{
-            inputTokens: z.ZodNumber;
-            outputTokens: z.ZodNumber;
-            totalTokens: z.ZodOptional<z.ZodNumber>;
-            cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
-            cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
-            reasoningTokens: z.ZodOptional<z.ZodNumber>;
-            cost: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strict>>;
-        providerEvent: z.ZodOptional<z.ZodUnknown>;
-    }, z.core.$strict>>>;
-    contextTransferReceipt: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        status: z.ZodLiteral<"accepted" | "replayed">;
-        operationId: z.ZodString;
-        requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-        planDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-        contextDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-        destination: z.ZodObject<{
-            runner: z.ZodString;
-            provider: z.ZodOptional<z.ZodString>;
-            model: z.ZodOptional<z.ZodString>;
-            profileDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
-        }, z.core.$strict>;
-        provider: z.ZodString;
-        environmentId: z.ZodString;
-        sessionId: z.ZodString;
-        sessionCreatedForOperationId: z.ZodString;
-        sessionCreatedAt: z.ZodISODateTime;
-        transferredMessageIds: z.ZodArray<z.ZodString>;
-        omittedMessageIds: z.ZodArray<z.ZodString>;
-        admittedAt: z.ZodISODateTime;
-    }, z.core.$strict>, z.ZodObject<{
-        status: z.ZodLiteral<"accepted" | "replayed">;
-        operationId: z.ZodString;
-        requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-        planDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-        contextDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-        destination: z.ZodObject<{
-            runner: z.ZodString;
-            provider: z.ZodOptional<z.ZodString>;
-            model: z.ZodOptional<z.ZodString>;
-            profileDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
-        }, z.core.$strict>;
-        provider: z.ZodString;
-        environmentId: z.ZodString;
-        sessionId: z.ZodString;
-        sessionCreatedForOperationId: z.ZodString;
-        sessionCreatedAt: z.ZodISODateTime;
-        transferredMessageIds: z.ZodArray<z.ZodString>;
-        omittedMessageIds: z.ZodArray<z.ZodString>;
-        admittedAt: z.ZodISODateTime;
-    }, z.core.$strict>], "status">>;
-}, z.core.$strict>;
-/** Durable provider result for one digest-bound native continuation operation. */
-export declare const AgentNativeContextContinuationResultSchema: z.ZodUnion<readonly [z.ZodObject<{
-    acknowledgement: z.ZodIntersection<z.ZodObject<{
-        operationId: z.ZodString;
-        requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-        status: z.ZodEnum<{
-            conflict: "conflict";
-            accepted: "accepted";
-            transport_failure: "transport_failure";
-            replayed: "replayed";
-            boundary_mismatch: "boundary_mismatch";
-            unverified: "unverified";
-            unknown_session: "unknown_session";
-        }>;
-        historyMessagesSent: z.ZodNumber;
-        existingRequestDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
-        actualBoundary: z.ZodOptional<z.ZodObject<{
-            runId: z.ZodString;
-            provider: z.ZodString;
-            environmentId: z.ZodString;
-            sessionId: z.ZodString;
-            boundary: z.ZodDiscriminatedUnion<[z.ZodObject<{
-                kind: z.ZodLiteral<"token">;
-                token: z.ZodString;
-            }, z.core.$strict>, z.ZodObject<{
-                kind: z.ZodLiteral<"revision">;
-                revision: z.ZodString;
-            }, z.core.$strict>, z.ZodObject<{
-                kind: z.ZodLiteral<"digest">;
-                digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-            }, z.core.$strict>, z.ZodObject<{
-                kind: z.ZodLiteral<"messages">;
-                messageIds: z.ZodArray<z.ZodString>;
-                digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-            }, z.core.$strict>], "kind">;
-            observedAt: z.ZodISODateTime;
-        }, z.core.$strict>>;
-        message: z.ZodOptional<z.ZodString>;
-        retryable: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strict>, z.ZodObject<{
-        status: z.ZodEnum<{
-            accepted: "accepted";
-            replayed: "replayed";
-        }>;
-    }, z.core.$strip>>;
-    result: z.ZodObject<{
-        text: z.ZodString;
-        success: z.ZodBoolean;
-        error: z.ZodOptional<z.ZodString>;
-        sessionId: z.ZodOptional<z.ZodString>;
-        usage: z.ZodOptional<z.ZodObject<{
-            inputTokens: z.ZodNumber;
-            outputTokens: z.ZodNumber;
-            totalTokens: z.ZodOptional<z.ZodNumber>;
-            cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
-            cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
-            reasoningTokens: z.ZodOptional<z.ZodNumber>;
-            cost: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strict>>;
-        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        events: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            type: z.ZodString;
-            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-            id: z.ZodOptional<z.ZodString>;
-            normalized: z.ZodOptional<z.ZodType<StreamEvent, unknown, z.core.$ZodTypeInternals<StreamEvent, unknown>>>;
-            usage: z.ZodOptional<z.ZodObject<{
-                inputTokens: z.ZodNumber;
-                outputTokens: z.ZodNumber;
-                totalTokens: z.ZodOptional<z.ZodNumber>;
-                cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
-                cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
-                reasoningTokens: z.ZodOptional<z.ZodNumber>;
-                cost: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strict>>;
-            providerEvent: z.ZodOptional<z.ZodUnknown>;
-        }, z.core.$strict>>>;
-        contextTransferReceipt: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            status: z.ZodLiteral<"accepted" | "replayed">;
-            operationId: z.ZodString;
-            requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-            planDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-            contextDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-            destination: z.ZodObject<{
-                runner: z.ZodString;
-                provider: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-                profileDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
-            }, z.core.$strict>;
-            provider: z.ZodString;
-            environmentId: z.ZodString;
-            sessionId: z.ZodString;
-            sessionCreatedForOperationId: z.ZodString;
-            sessionCreatedAt: z.ZodISODateTime;
-            transferredMessageIds: z.ZodArray<z.ZodString>;
-            omittedMessageIds: z.ZodArray<z.ZodString>;
-            admittedAt: z.ZodISODateTime;
-        }, z.core.$strict>, z.ZodObject<{
-            status: z.ZodLiteral<"accepted" | "replayed">;
-            operationId: z.ZodString;
-            requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-            planDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-            contextDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-            destination: z.ZodObject<{
-                runner: z.ZodString;
-                provider: z.ZodOptional<z.ZodString>;
-                model: z.ZodOptional<z.ZodString>;
-                profileDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
-            }, z.core.$strict>;
-            provider: z.ZodString;
-            environmentId: z.ZodString;
-            sessionId: z.ZodString;
-            sessionCreatedForOperationId: z.ZodString;
-            sessionCreatedAt: z.ZodISODateTime;
-            transferredMessageIds: z.ZodArray<z.ZodString>;
-            omittedMessageIds: z.ZodArray<z.ZodString>;
-            admittedAt: z.ZodISODateTime;
-        }, z.core.$strict>], "status">>;
-    }, z.core.$strict>;
-    controlRef: z.ZodObject<{
-        runId: z.ZodString;
-        provider: z.ZodString;
-        environmentId: z.ZodString;
-        sessionId: z.ZodOptional<z.ZodString>;
-        executionId: z.ZodOptional<z.ZodString>;
-        requestDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
-    }, z.core.$strict>;
-}, z.core.$strict>, z.ZodObject<{
-    acknowledgement: z.ZodIntersection<z.ZodObject<{
-        operationId: z.ZodString;
-        requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-        status: z.ZodEnum<{
-            conflict: "conflict";
-            accepted: "accepted";
-            transport_failure: "transport_failure";
-            replayed: "replayed";
-            boundary_mismatch: "boundary_mismatch";
-            unverified: "unverified";
-            unknown_session: "unknown_session";
-        }>;
-        historyMessagesSent: z.ZodNumber;
-        existingRequestDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
-        actualBoundary: z.ZodOptional<z.ZodObject<{
-            runId: z.ZodString;
-            provider: z.ZodString;
-            environmentId: z.ZodString;
-            sessionId: z.ZodString;
-            boundary: z.ZodDiscriminatedUnion<[z.ZodObject<{
-                kind: z.ZodLiteral<"token">;
-                token: z.ZodString;
-            }, z.core.$strict>, z.ZodObject<{
-                kind: z.ZodLiteral<"revision">;
-                revision: z.ZodString;
-            }, z.core.$strict>, z.ZodObject<{
-                kind: z.ZodLiteral<"digest">;
-                digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-            }, z.core.$strict>, z.ZodObject<{
-                kind: z.ZodLiteral<"messages">;
-                messageIds: z.ZodArray<z.ZodString>;
-                digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-            }, z.core.$strict>], "kind">;
-            observedAt: z.ZodISODateTime;
-        }, z.core.$strict>>;
-        message: z.ZodOptional<z.ZodString>;
-        retryable: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strict>, z.ZodObject<{
-        status: z.ZodEnum<{
-            conflict: "conflict";
-            transport_failure: "transport_failure";
-            boundary_mismatch: "boundary_mismatch";
-            unverified: "unverified";
-            unknown_session: "unknown_session";
-        }>;
-    }, z.core.$strip>>;
-}, z.core.$strict>]>;
-export type AgentNativeContextContinuationResult = z.infer<typeof AgentNativeContextContinuationResultSchema>;
-/** Runtime-only controls kept outside the digest-bound user turn. */
-export interface AgentNativeContextContinuationOptions {
-    turn: NativeContextContinuationTurn;
-    timeoutMs?: number;
-    signal?: AbortSignal;
-}
-/** Cross-check a successful result against its exact request and retained session. */
-export declare function agentNativeContextContinuationResultMatchesRequest(request: NativeContextContinuationRequest, outcome: AgentNativeContextContinuationResult): boolean;
-export interface AgentSessionRef {
-    id: string;
-    provider?: string;
-    controlRef?: AgentRunControlRef;
-    contextTransferReceipt?: ContextTransferReceipt;
-    metadata?: Record<string, unknown>;
-}
-export interface AgentEnvironmentEvent {
-    type: string;
-    data: Record<string, unknown>;
-    id?: string;
-    normalized?: StreamEvent;
-    usage?: TokenUsage;
-    providerEvent?: unknown;
-}
-export interface AgentSession {
-    readonly id: string;
-    readonly controlRef?: AgentRunControlRef;
-    status(): Promise<AgentSessionStatus | null>;
-    events(options?: {
-        /** Exclusive stable event id previously emitted by this session. */
-        since?: string;
-        /** Provider execution selected by the durable control reference, when required. */
-        executionId?: string;
-        signal?: AbortSignal;
-    }): AsyncIterable<AgentEnvironmentEvent>;
-    result(): Promise<AgentTurnResult>;
-    prompt(input: AgentTurnInput): Promise<AgentTurnResult>;
-    respondToInteraction?(command: InteractionResponseCommand, options?: {
-        signal?: AbortSignal;
-    }): Promise<InteractionAcknowledgement>;
-    contextBoundary?(options?: {
-        signal?: AbortSignal;
-    }): Promise<NativeContextBoundaryProof | null>;
-    /**
-     * Atomically verify the boundary and admit one digest-bound continuation.
-     * Repeating an operation id with the same request returns the original result;
-     * repeating it with a different request returns a conflict without dispatch.
-     */
-    continueNative?(request: NativeContextContinuationRequest, options: AgentNativeContextContinuationOptions): Promise<AgentNativeContextContinuationResult>;
-    /** Retry-safe cancellation bound to one exact run and caller operation. */
-    cancelRun?(request: AgentRunCancellationRequest, options?: {
-        signal?: AbortSignal;
-    }): Promise<AgentRunCancellationAcknowledgement>;
-    cancel(): Promise<void>;
-}
-export interface AgentEnvironment {
-    readonly id: string;
-    readonly provider: string;
-    readonly name?: string;
-    status(): Promise<AgentEnvironmentStatus>;
-    stream(input: AgentTurnInput): AsyncIterable<AgentEnvironmentEvent>;
-    dispatch?(input: AgentTurnInput): Promise<AgentSessionRef>;
-    session?(id: string, options?: {
-        controlRef?: AgentRunControlRef;
-    }): AgentSession;
-    respondToInteraction?(command: InteractionResponseCommand, options?: {
-        signal?: AbortSignal;
-    }): Promise<InteractionAcknowledgement>;
-    read?(path: string, options?: {
-        sessionId?: string;
-    }): Promise<string>;
-    write?(path: string, content: string, options?: {
-        sessionId?: string;
-    }): Promise<void>;
-    exec?(command: string, options?: ExecRequest): Promise<ExecResult>;
-    checkpoint?(options?: CheckpointRequest): Promise<CheckpointRef>;
-    fork?(checkpoint: CheckpointRef, options?: ForkRequest): Promise<AgentEnvironment>;
-    /** Durable, retry-safe checkpoint and environment-fork operations. */
-    readonly workspaceBranching?: AgentWorkspaceBranching;
-    placement?(): Promise<PlacementInfo>;
-    refresh?(): Promise<void>;
-    destroy?(): Promise<void>;
-}
-export interface AgentEnvironmentCapabilities {
-    profile: AgentProfileCapabilities;
-    streaming: {
-        live: boolean;
-        replay: boolean;
-        detach: boolean;
-        turnIdempotency: boolean;
-    };
-    sessions: {
-        continue: boolean;
-        list: boolean;
-        messages: boolean;
-    };
-    /** Present only when every retained-run identity and retry promise is implemented. */
-    retainedControl?: {
-        exactRunIdentity: boolean;
-        resultIdentity: boolean;
-        eventIdentity: boolean;
-        cancellationIdempotency: boolean;
-    };
-    /** Absent when verified, retry-safe same-session continuation is unsupported. */
-    nativeContinuation?: {
-        /** Boundary comparison and operation admission are one atomic provider action. */
-        atomicBoundary: boolean;
-        /** Operation id + request digest recover retries and reject changed input. */
-        requestIdempotency: boolean;
-    };
-    /** Absent when the provider cannot originate or answer interactions. */
-    interactions?: InteractionCapabilities;
-    workspace: {
-        read: boolean;
-        write: boolean;
-        exec: boolean;
-        git: boolean;
-        upload: boolean;
-        download: boolean;
-    };
-    branching: {
-        checkpoint: boolean;
-        fork: boolean;
-        /** True only when key + canonical request digest semantics are implemented. */
-        retrySafe?: boolean;
-        /** True only when operations can be recovered by idempotency key. */
-        lookup?: boolean;
-        /** True only when checkpoints and forked environments have confirmed cleanup. */
-        cleanup?: boolean;
-    };
-    placement: boolean;
-    usage: boolean;
-    confidential: boolean;
-    /** Present only when {@link AgentEnvironmentProvider.exactProcess} is implemented. */
-    exactProcess?: {
-        egress: readonly AgentExactProcessEgressMode[];
-    };
-}
-/** Strict runtime validator for provider capability negotiation. */
-export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
-    profile: z.ZodObject<{
-        namedProfiles: z.ZodBoolean;
-        systemPrompt: z.ZodObject<{
-            replace: z.ZodBoolean;
-            append: z.ZodBoolean;
-        }, z.core.$strict>;
-        instructions: z.ZodBoolean;
-        tools: z.ZodBoolean;
-        permissions: z.ZodBoolean;
-        mcp: z.ZodBoolean;
-        subagents: z.ZodBoolean;
-        resources: z.ZodObject<{
-            files: z.ZodBoolean;
-            instructions: z.ZodBoolean;
-            tools: z.ZodOptional<z.ZodBoolean>;
-            skills: z.ZodOptional<z.ZodBoolean>;
-            agents: z.ZodOptional<z.ZodBoolean>;
-            commands: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strict>;
-        hooks: z.ZodOptional<z.ZodBoolean>;
-        modes: z.ZodOptional<z.ZodBoolean>;
-        runtimeUpdate: z.ZodBoolean;
-        validation: z.ZodBoolean;
-        extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strict>;
-    streaming: z.ZodObject<{
-        live: z.ZodBoolean;
-        replay: z.ZodBoolean;
-        detach: z.ZodBoolean;
-        turnIdempotency: z.ZodBoolean;
-    }, z.core.$strict>;
-    sessions: z.ZodObject<{
-        continue: z.ZodBoolean;
-        list: z.ZodBoolean;
-        messages: z.ZodBoolean;
-    }, z.core.$strict>;
-    retainedControl: z.ZodOptional<z.ZodObject<{
-        exactRunIdentity: z.ZodBoolean;
-        resultIdentity: z.ZodBoolean;
-        eventIdentity: z.ZodBoolean;
-        cancellationIdempotency: z.ZodBoolean;
-    }, z.core.$strict>>;
-    nativeContinuation: z.ZodOptional<z.ZodObject<{
-        atomicBoundary: z.ZodBoolean;
-        requestIdempotency: z.ZodBoolean;
-    }, z.core.$strict>>;
-    interactions: z.ZodOptional<z.ZodObject<{
-        kinds: z.ZodArray<z.ZodString>;
-        answerFieldTypes: z.ZodArray<z.ZodEnum<{
-            number: "number";
-            boolean: "boolean";
-            text: "text";
-            select: "select";
-            secret: "secret";
-        }>>;
-        responseScopes: z.ZodArray<z.ZodEnum<{
-            interaction: "interaction";
-            session: "session";
-            persistent: "persistent";
-        }>>;
-        secretAnswers: z.ZodBoolean;
-        concurrentRequests: z.ZodBoolean;
-        replay: z.ZodBoolean;
-        responseIdempotency: z.ZodBoolean;
-    }, z.core.$strict>>;
-    workspace: z.ZodObject<{
-        read: z.ZodBoolean;
-        write: z.ZodBoolean;
-        exec: z.ZodBoolean;
-        git: z.ZodBoolean;
-        upload: z.ZodBoolean;
-        download: z.ZodBoolean;
-    }, z.core.$strict>;
-    branching: z.ZodObject<{
-        checkpoint: z.ZodBoolean;
-        fork: z.ZodBoolean;
-        retrySafe: z.ZodOptional<z.ZodBoolean>;
-        lookup: z.ZodOptional<z.ZodBoolean>;
-        cleanup: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strict>;
-    placement: z.ZodBoolean;
-    usage: z.ZodBoolean;
-    confidential: z.ZodBoolean;
-    exactProcess: z.ZodOptional<z.ZodObject<{
-        egress: z.ZodArray<z.ZodEnum<{
-            blocked: "blocked";
-            strict: "strict";
-        }>>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-export interface CreateAgentEnvironmentInput {
-    profile: AgentProfileRef;
-    /** Agent backend inside the provider, for example "opencode" or "codex". */
-    backend?: string;
-    workspace?: WorkspaceRequest;
-    resources?: ResourceRequest;
-    env?: Record<string, string>;
-    secrets?: string[] | Record<string, string>;
-    metadata?: Record<string, unknown>;
-    name?: string;
-    idempotencyKey?: string;
-    signal?: AbortSignal;
-    providerOptions?: Record<string, unknown>;
-}
-export interface AgentEnvironmentProvider {
-    readonly name: string;
-    readonly exactProcess?: AgentExactProcessProvider;
-    capabilities(): AgentEnvironmentCapabilities | Promise<AgentEnvironmentCapabilities>;
-    validateProfile?(profile: AgentProfileRef): AgentProfileValidationResult | Promise<AgentProfileValidationResult>;
-    create(input: CreateAgentEnvironmentInput): Promise<AgentEnvironment>;
-    get?(id: string): Promise<AgentEnvironment | null>;
-    list?(query?: AgentEnvironmentQuery): Promise<AgentEnvironmentSummary[]>;
-}
+export * from "./environment-requests.js";
+export * from "./environment-exact-process.js";
+export * from "./environment-runtime.js";