@supacloud/compiler 0.26.0 → 0.27.2

package/dist/delivery-bundle.d.ts

@@ -5,3 +5,4 @@ export interface BundledDeliveryTarget {
     runtimeImports: string[];
 }
 export declare function bundleDeliveryTarget(name: string, code: string, project: string, generatedDirectory: string, options: DeliveryOptions): Promise<BundledDeliveryTarget>;
+export declare function bundleDeliveryTargetInProcess(name: string, code: string, project: string, generatedDirectory: string, options: DeliveryOptions): Promise<BundledDeliveryTarget>;

package/dist/delivery-context.d.ts

@@ -0,0 +1,15 @@
+import { type ExecutionContextPack } from "./execution-context";
+export declare class DeliveryContextError extends Error {
+    readonly code: "DELIVERY_CONTEXT_INVALID" | "DELIVERY_CONTEXT_IDENTITY_MISMATCH" | "DELIVERY_CONTEXT_INTEGRITY_FAILED";
+    constructor(code: "DELIVERY_CONTEXT_INVALID" | "DELIVERY_CONTEXT_IDENTITY_MISMATCH" | "DELIVERY_CONTEXT_INTEGRITY_FAILED");
+}
+export interface DeliveryExecutionContextPack extends Omit<ExecutionContextPack, "correlation"> {
+    correlation: "verified-build-snapshot";
+    delivery: {
+        target: string;
+        objectId: string;
+        artifactVerified: true;
+    };
+}
+/** Local artifact integrity only. Caller-supplied events do not attest execution or deployment. */
+export declare function createDeliveryExecutionContextPack(manifestPath: string, target: string, subject: string, observations: unknown, requestId: string): Promise<DeliveryExecutionContextPack>;

package/dist/delivery-files.d.ts

@@ -1,17 +1 @@
-import type { DeliveryObject } from "./delivery-build-schema";
-export declare const digest: (value: string | Uint8Array) => string;
-export declare function canonical(value: unknown): string;
-export declare function inside(parent: string, path: string): boolean;
-export declare function exists(path: string): Promise<boolean>;
-/** The anchor must already be canonical; reject links in every descendant component. */
-export declare function noLinks(anchor: string, path: string): Promise<void>;
-export declare function readOwned(anchor: string, path: string): Promise<Uint8Array>;
-export declare function reserveOutput(project: string, requested: string): Promise<{
-    path: string;
-    release(): Promise<void>;
-}>;
-export declare function writeArtifact(root: string, path: string, content: string | Uint8Array): Promise<void>;
-export declare function artifactInventory(root: string): Promise<DeliveryObject["files"]>;
-/** Snapshot application sources before graph analysis, excluding generated output. */
-export declare function sourceInventory(root: string, output: string): Promise<Map<string, string>>;
-export declare function publishPointer(root: string, content: string): Promise<boolean>;
+export * from "@supacloud/delivery/files";

package/dist/delivery-http.d.ts

@@ -0,0 +1,2 @@
+/** Append a typed host boundary without changing the target's module ownership. */
+export declare function renderDeliveryHttpEntry(generatedDirectory: string, hostPath: string): string;

package/dist/delivery-imports.d.ts

@@ -0,0 +1,2 @@
+/** Resolve private literal-only import wrappers without permitting an open dependency set. */
+export declare function staticDeliveryImports(path: string, contents: Uint8Array): Uint8Array;

package/dist/delivery-migration-archive.d.ts

@@ -0,0 +1,2 @@
+export { readDeliveryMigrationArchive } from "@supacloud/delivery";
+export type { DeliveryMigrationArchive } from "@supacloud/delivery";

package/dist/delivery-migrations.d.ts

@@ -0,0 +1,16 @@
+import type { DeliveryOptions } from "./delivery-schema";
+type MigrationInput = NonNullable<NonNullable<DeliveryOptions["build"]>["migrations"]>[number];
+/** Archive declared SQL, without interpreting compatibility or authorizing execution. */
+export declare function prepareDeliveryMigrations(project: string, generatedRoot: string, declarations?: readonly MigrationInput[]): Promise<{
+    entries: {
+        version: string;
+        name: string;
+        executor: MigrationInput["executor"];
+        path: string;
+        sha256: string;
+        bytes: number;
+    }[];
+    files: Map<string, Uint8Array<ArrayBufferLike>>;
+    inputs: Map<string, string>;
+}>;
+export {};

package/dist/delivery-readiness.d.ts

@@ -0,0 +1,4 @@
+import { APPLICATION_RUNTIME_PROBE_PATH } from "@supacloud/delivery";
+export { APPLICATION_RUNTIME_PROBE_PATH };
+/** Inline the small host contract so detached apps need no extra runtime package. */
+export declare function renderDeliveryRuntimeIdentity(): string;

package/dist/delivery-render.d.ts

@@ -2,4 +2,12 @@ import type { ApplicationGraph } from "./types";
 import type { DeliveryTarget } from "./delivery-schema";
 import { type GenerateOptions } from "./generate";
 /** Keep conservative service factories while restricting exposed route/job descriptors. */
-export declare function renderDeliveryTarget(graph: ApplicationGraph, target: DeliveryTarget, options: GenerateOptions): import("./generate").RenderedArtifacts;
+export declare function renderDeliveryTarget(graph: ApplicationGraph, target: DeliveryTarget, options: GenerateOptions): {
+    executionSnapshot: string;
+    applicationCode: string;
+    manifestJson: string;
+    contractsManifestJson: string;
+    clientCode?: string;
+    openApiCode?: string;
+    permissionsCode?: string;
+};

package/dist/delivery-schema.d.ts

@@ -1,186 +1 @@
-import { type Static } from "@sinclair/typebox";
-export declare const DeliveryFilePathSchema: import("@sinclair/typebox").TString;
-export declare const DeliveryOptionsSchema: import("@sinclair/typebox").TObject<{
-    version: import("@sinclair/typebox").TLiteral<1>;
-    targets: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        name: import("@sinclair/typebox").TString;
-        kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"api">, import("@sinclair/typebox").TLiteral<"jobs">, import("@sinclair/typebox").TLiteral<"webhook">]>;
-        modules: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-        isolation: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shared">, import("@sinclair/typebox").TLiteral<"process">]>>;
-        capabilities: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
-    }>>>;
-    runtime: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-        processIsolation: import("@sinclair/typebox").TBoolean;
-        durableQueue: import("@sinclair/typebox").TBoolean;
-        capabilities: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-    }>>;
-    build: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-        minify: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
-        environmentContract: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        assets: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-            target: import("@sinclair/typebox").TString;
-            source: import("@sinclair/typebox").TString;
-            path: import("@sinclair/typebox").TString;
-        }>>>;
-    }>>;
-}>;
-export type DeliveryOptions = Static<typeof DeliveryOptionsSchema>;
-export declare const DeliveryDiagnosticSchema: import("@sinclair/typebox").TObject<{
-    severity: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"error">, import("@sinclair/typebox").TLiteral<"warn">]>;
-    code: import("@sinclair/typebox").TString;
-    message: import("@sinclair/typebox").TString;
-    suggestion: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    file: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    line: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
-}>;
-export declare const DeliveryTargetSchema: import("@sinclair/typebox").TObject<{
-    name: import("@sinclair/typebox").TString;
-    kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"api">, import("@sinclair/typebox").TLiteral<"jobs">, import("@sinclair/typebox").TLiteral<"webhook">]>;
-    isolation: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shared">, import("@sinclair/typebox").TLiteral<"process">]>;
-    roots: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-    modules: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        name: import("@sinclair/typebox").TString;
-        reason: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"owner">, import("@sinclair/typebox").TLiteral<"dependency">]>;
-        importedBy: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-    }>>;
-    routes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        module: import("@sinclair/typebox").TString;
-        controller: import("@sinclair/typebox").TString;
-        handler: import("@sinclair/typebox").TString;
-        method: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"GET">, import("@sinclair/typebox").TLiteral<"POST">, import("@sinclair/typebox").TLiteral<"PUT">, import("@sinclair/typebox").TLiteral<"PATCH">, import("@sinclair/typebox").TLiteral<"DELETE">, import("@sinclair/typebox").TLiteral<"HEAD">, import("@sinclair/typebox").TLiteral<"OPTIONS">]>;
-        path: import("@sinclair/typebox").TString;
-        command: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        reason: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"default-http">, import("@sinclair/typebox").TLiteral<"explicit-module">]>;
-    }>>;
-    jobs: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        module: import("@sinclair/typebox").TString;
-        name: import("@sinclair/typebox").TString;
-        className: import("@sinclair/typebox").TString;
-        serviceKey: import("@sinclair/typebox").TString;
-        reason: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"declared-job">, import("@sinclair/typebox").TLiteral<"explicit-module">]>;
-    }>>;
-    externalTokens: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-    requirements: import("@sinclair/typebox").TObject<{
-        processIsolation: import("@sinclair/typebox").TBoolean;
-        durableQueue: import("@sinclair/typebox").TBoolean;
-        capabilities: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-    }>;
-    runtimeStatus: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"unchecked">, import("@sinclair/typebox").TLiteral<"declared-compatible">]>;
-}>;
-export declare const DeliveryPlanSchema: import("@sinclair/typebox").TObject<{
-    schemaVersion: import("@sinclair/typebox").TLiteral<1>;
-    policyVersion: import("@sinclair/typebox").TLiteral<"module-workload-v1">;
-    digestScope: import("@sinclair/typebox").TLiteral<"topology-only">;
-    topologyDigest: import("@sinclair/typebox").TString;
-    deploymentReady: import("@sinclair/typebox").TLiteral<false>;
-    targets: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        name: import("@sinclair/typebox").TString;
-        kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"api">, import("@sinclair/typebox").TLiteral<"jobs">, import("@sinclair/typebox").TLiteral<"webhook">]>;
-        isolation: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shared">, import("@sinclair/typebox").TLiteral<"process">]>;
-        roots: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-        modules: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-            name: import("@sinclair/typebox").TString;
-            reason: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"owner">, import("@sinclair/typebox").TLiteral<"dependency">]>;
-            importedBy: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-        }>>;
-        routes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-            module: import("@sinclair/typebox").TString;
-            controller: import("@sinclair/typebox").TString;
-            handler: import("@sinclair/typebox").TString;
-            method: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"GET">, import("@sinclair/typebox").TLiteral<"POST">, import("@sinclair/typebox").TLiteral<"PUT">, import("@sinclair/typebox").TLiteral<"PATCH">, import("@sinclair/typebox").TLiteral<"DELETE">, import("@sinclair/typebox").TLiteral<"HEAD">, import("@sinclair/typebox").TLiteral<"OPTIONS">]>;
-            path: import("@sinclair/typebox").TString;
-            command: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-            reason: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"default-http">, import("@sinclair/typebox").TLiteral<"explicit-module">]>;
-        }>>;
-        jobs: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-            module: import("@sinclair/typebox").TString;
-            name: import("@sinclair/typebox").TString;
-            className: import("@sinclair/typebox").TString;
-            serviceKey: import("@sinclair/typebox").TString;
-            reason: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"declared-job">, import("@sinclair/typebox").TLiteral<"explicit-module">]>;
-        }>>;
-        externalTokens: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-        requirements: import("@sinclair/typebox").TObject<{
-            processIsolation: import("@sinclair/typebox").TBoolean;
-            durableQueue: import("@sinclair/typebox").TBoolean;
-            capabilities: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-        }>;
-        runtimeStatus: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"unchecked">, import("@sinclair/typebox").TLiteral<"declared-compatible">]>;
-    }>>;
-}>;
-export declare const DeliveryPlanResultSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
-    ok: import("@sinclair/typebox").TLiteral<true>;
-    plan: import("@sinclair/typebox").TObject<{
-        schemaVersion: import("@sinclair/typebox").TLiteral<1>;
-        policyVersion: import("@sinclair/typebox").TLiteral<"module-workload-v1">;
-        digestScope: import("@sinclair/typebox").TLiteral<"topology-only">;
-        topologyDigest: import("@sinclair/typebox").TString;
-        deploymentReady: import("@sinclair/typebox").TLiteral<false>;
-        targets: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-            name: import("@sinclair/typebox").TString;
-            kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"api">, import("@sinclair/typebox").TLiteral<"jobs">, import("@sinclair/typebox").TLiteral<"webhook">]>;
-            isolation: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"shared">, import("@sinclair/typebox").TLiteral<"process">]>;
-            roots: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-            modules: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-                name: import("@sinclair/typebox").TString;
-                reason: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"owner">, import("@sinclair/typebox").TLiteral<"dependency">]>;
-                importedBy: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-            }>>;
-            routes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-                module: import("@sinclair/typebox").TString;
-                controller: import("@sinclair/typebox").TString;
-                handler: import("@sinclair/typebox").TString;
-                method: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"GET">, import("@sinclair/typebox").TLiteral<"POST">, import("@sinclair/typebox").TLiteral<"PUT">, import("@sinclair/typebox").TLiteral<"PATCH">, import("@sinclair/typebox").TLiteral<"DELETE">, import("@sinclair/typebox").TLiteral<"HEAD">, import("@sinclair/typebox").TLiteral<"OPTIONS">]>;
-                path: import("@sinclair/typebox").TString;
-                command: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-                reason: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"default-http">, import("@sinclair/typebox").TLiteral<"explicit-module">]>;
-            }>>;
-            jobs: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-                module: import("@sinclair/typebox").TString;
-                name: import("@sinclair/typebox").TString;
-                className: import("@sinclair/typebox").TString;
-                serviceKey: import("@sinclair/typebox").TString;
-                reason: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"declared-job">, import("@sinclair/typebox").TLiteral<"explicit-module">]>;
-            }>>;
-            externalTokens: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-            requirements: import("@sinclair/typebox").TObject<{
-                processIsolation: import("@sinclair/typebox").TBoolean;
-                durableQueue: import("@sinclair/typebox").TBoolean;
-                capabilities: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-            }>;
-            runtimeStatus: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"unchecked">, import("@sinclair/typebox").TLiteral<"declared-compatible">]>;
-        }>>;
-    }>;
-    diagnostics: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        severity: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"error">, import("@sinclair/typebox").TLiteral<"warn">]>;
-        code: import("@sinclair/typebox").TString;
-        message: import("@sinclair/typebox").TString;
-        suggestion: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        file: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        line: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
-    }>>;
-    written: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-}>, import("@sinclair/typebox").TObject<{
-    ok: import("@sinclair/typebox").TLiteral<false>;
-    plan: import("@sinclair/typebox").TNull;
-    diagnostics: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        severity: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"error">, import("@sinclair/typebox").TLiteral<"warn">]>;
-        code: import("@sinclair/typebox").TString;
-        message: import("@sinclair/typebox").TString;
-        suggestion: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        file: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        line: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
-    }>>;
-    written: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
-}>]>;
-export type DeliveryTarget = Static<typeof DeliveryTargetSchema>;
-export type DeliveryPlan = Static<typeof DeliveryPlanSchema>;
-export type DeliveryDiagnostic = Static<typeof DeliveryDiagnosticSchema>;
-export type DeliveryPlanResult = Static<typeof DeliveryPlanResultSchema>;
-export declare class DeliveryConfigurationError extends Error {
-    readonly code = "delivery-config-invalid";
-    constructor();
-}
-export declare function parseDeliveryOptions(value: unknown): DeliveryOptions;
-/** Validate plans received from files/messages before using their typed contract. */
-export declare function parseDeliveryPlanResult(value: unknown): DeliveryPlanResult;
+export * from "@supacloud/delivery/schema";

package/dist/delivery-worker.d.ts

@@ -0,0 +1,2 @@
+/** The host owns polling and receipts; this entry owns only process lifetime. */
+export declare function renderDeliveryWorkerEntry(generatedDirectory: string, hostPath: string): string;

package/dist/execution-context.d.ts

@@ -0,0 +1,68 @@
+import type { ExecutionPlan } from "./inspect";
+import { type ExecutionSnapshot } from "./execution-snapshot";
+import type { ApplicationGraph } from "./types";
+export declare const EXECUTION_CONTEXT_LIMITS: {
+    readonly inputBytes: number;
+    readonly inputEvents: number;
+    readonly outputBytes: number;
+    readonly events: number;
+    readonly modules: number;
+    readonly files: number;
+    readonly diagnostics: number;
+    readonly plans: number;
+};
+interface ExecutionMetadata {
+    kind: "route" | "command" | "job";
+    operation: string;
+    stage: string;
+    phase: "started" | "succeeded" | "failed";
+    requestId?: string;
+    durationMs?: number;
+}
+export declare class ExecutionContextError extends Error {
+    readonly code: "EXECUTION_METADATA_INVALID" | "EXECUTION_METADATA_UNREADABLE" | "EXECUTION_CONTEXT_NOT_FOUND" | "EXECUTION_CONTEXT_TOO_LARGE";
+    constructor(code: "EXECUTION_METADATA_INVALID" | "EXECUTION_METADATA_UNREADABLE" | "EXECUTION_CONTEXT_NOT_FOUND" | "EXECUTION_CONTEXT_TOO_LARGE");
+}
+export interface ExecutionContextPack {
+    version: 1;
+    subject: string;
+    requestId: string;
+    correlation: "current-graph-only";
+    deploymentVerified: false;
+    eventsTrusted: false;
+    modules: Array<{
+        name: string;
+        file?: string;
+    }>;
+    files: string[];
+    executionPlans: ExecutionPlan[];
+    events: Array<ExecutionMetadata & {
+        index: number;
+        module: string;
+    }>;
+    diagnostics: Array<{
+        code: string;
+        severity: "error" | "warn";
+        file?: string;
+        line?: number;
+        repair?: {
+            type: string;
+            readiness: "preview" | "input-required" | "manual";
+        };
+    }>;
+    omitted: {
+        events: number;
+        modules: number;
+        files: number;
+        diagnostics: number;
+        plans: number;
+        unmatchedEvents: number;
+    };
+    limits: typeof EXECUTION_CONTEXT_LIMITS;
+}
+/** Read only a bounded regular file; parse failures never echo file contents or paths. */
+export declare function readExecutionMetadata(path: string): Promise<unknown>;
+/** Structural correlation only. Observations are untrusted hints, not audit or deployment receipts. */
+export declare function createExecutionContextPack(graph: ApplicationGraph, subject: string, observations: unknown, requestId: string): ExecutionContextPack;
+export declare function executionContextFromSnapshot(snapshot: ExecutionSnapshot, subject: string, observations: unknown, requestId: string): ExecutionContextPack;
+export {};

package/dist/execution-snapshot.d.ts

@@ -0,0 +1,44 @@
+import { Type, type Static } from "typebox";
+import type { ApplicationGraph } from "./types";
+declare const SnapshotSchema: Type.TObject<{
+    version: Type.TLiteral<1>;
+    plans: Type.TArray<Type.TObject<{
+        module: Type.TString;
+        kind: Type.TUnion<[Type.TLiteral<"route">, Type.TLiteral<"command">, Type.TLiteral<"job">]>;
+        name: Type.TString;
+        command: Type.TOptional<Type.TString>;
+        stages: Type.TArray<Type.TString>;
+    }>>;
+    commandAliases: Type.TArray<Type.TObject<{
+        module: Type.TString;
+        name: Type.TString;
+        alias: Type.TString;
+    }>>;
+    contexts: Type.TArray<Type.TObject<{
+        subject: Type.TString;
+        aliases: Type.TArray<Type.TString>;
+        modules: Type.TArray<Type.TObject<{
+            name: Type.TString;
+            file: Type.TOptional<Type.TString>;
+        }>>;
+        files: Type.TArray<Type.TString>;
+        diagnostics: Type.TArray<Type.TObject<{
+            code: Type.TString;
+            severity: Type.TUnion<[Type.TLiteral<"error">, Type.TLiteral<"warn">]>;
+            file: Type.TOptional<Type.TString>;
+            line: Type.TOptional<Type.TInteger>;
+            repair: Type.TOptional<Type.TObject<{
+                type: Type.TString;
+                readiness: Type.TUnion<[Type.TLiteral<"preview">, Type.TLiteral<"input-required">, Type.TLiteral<"manual">]>;
+            }>>;
+        }>>;
+    }>>;
+}>;
+export type ExecutionSnapshot = Static<typeof SnapshotSchema>;
+export declare const EXECUTION_SNAPSHOT_MAX_BYTES = 1048576;
+export declare function executionSourceFile(file: string | undefined): string | undefined;
+/** Persist structural metadata only, never expressions, request data or diagnostic messages. */
+export declare function createExecutionSnapshot(graph: ApplicationGraph, subjects?: string[]): ExecutionSnapshot;
+export declare function parseExecutionSnapshot(value: unknown): ExecutionSnapshot;
+export declare function serializedExecutionSnapshot(graph: ApplicationGraph): string;
+export {};

package/dist/index.d.ts

@@ -1,12 +1,16 @@
 export { analyzeProject } from "./analyze";
 export { createDeliveryPlan, planDeliveryProject, formatDeliveryPlan } from "./delivery-plan";
 export { buildDeliveryProject } from "./delivery-build";
+export { readDeliveryMigrationArchive } from "./delivery-migration-archive";
+export type { DeliveryMigrationArchive } from "./delivery-migration-archive";
 export { DeliveryBuildManifestSchema, DeliveryBuildResultSchema, parseDeliveryBuildManifest, parseDeliveryBuildResult } from "./delivery-build-schema";
 export type { DeliveryBuildManifest, DeliveryBuildResult, DeliveryObject } from "./delivery-build-schema";
 export { DeliveryOptionsSchema, DeliveryPlanSchema, DeliveryPlanResultSchema, DeliveryTargetSchema, DeliveryConfigurationError, parseDeliveryOptions, parseDeliveryPlanResult, } from "./delivery-schema";
 export type { DeliveryOptions, DeliveryPlan, DeliveryPlanResult, DeliveryTarget, DeliveryDiagnostic } from "./delivery-schema";
 export { generateFeatureSource, validateFeatureSpec } from "./feature";
 export { applyDiagnosticFix } from "./fixes";
+export { createExecutionContextPack, readExecutionMetadata, EXECUTION_CONTEXT_LIMITS, ExecutionContextError } from "./execution-context";
+export type { ExecutionContextPack } from "./execution-context";
 export type { AppliedDiagnosticFix, ApplyDiagnosticFixOptions } from "./fixes";
 export { createDiagnosticRepairPlan } from "./repair-plan";
 export type { DiagnosticRepair } from "./repair-plan";