@wrenai/genbi 0.0.4 → 0.0.5

package/dist-server/server/managed-wren-runtime.d.ts

@@ -0,0 +1,116 @@
+import { z } from "zod";
+import type { NativeWrenRuntime } from "./native-wren-runtime.js";
+declare const managedWrenManifestSchema: z.ZodObject<{
+    schema: z.ZodLiteral<1>;
+    activation: z.ZodEnum<{
+        approved: "approved";
+        staged: "staged";
+    }>;
+    platform: z.ZodLiteral<"darwin-arm64">;
+    compatibility: z.ZodObject<{
+        genbi: z.ZodString;
+        profile: z.ZodLiteral<"genbi-native-v4">;
+        wren: z.ZodString;
+    }, z.core.$strict>;
+    python: z.ZodObject<{
+        implementation: z.ZodLiteral<"cpython">;
+        version: z.ZodString;
+        upstream: z.ZodObject<{
+            release: z.ZodString;
+            url: z.ZodString;
+            sha256: z.ZodString;
+        }, z.core.$strict>;
+        mirror: z.ZodObject<{
+            url: z.ZodString;
+            sha256: z.ZodString;
+        }, z.core.$strict>;
+        interpreterPath: z.ZodString;
+    }, z.core.$strict>;
+    wheels: z.ZodArray<z.ZodObject<{
+        distribution: z.ZodString;
+        version: z.ZodString;
+        filename: z.ZodString;
+        url: z.ZodString;
+        sourceUrl: z.ZodString;
+        sha256: z.ZodString;
+    }, z.core.$strict>>;
+    runtime: z.ZodObject<{
+        pythonArchivePath: z.ZodString;
+        venvInterpreterPath: z.ZodString;
+        launcherPath: z.ZodString;
+        module: z.ZodLiteral<"wren.cli:app">;
+        packagePath: z.ZodString;
+        sitePackagesPath: z.ZodString;
+        pythonTreeSha256: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"staged">]>;
+        packageTreeSha256: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"staged">]>;
+        sitePackagesTreeSha256: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"staged">]>;
+        closureSha256: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"staged">]>;
+    }, z.core.$strict>;
+    licenseApproval: z.ZodObject<{
+        state: z.ZodEnum<{
+            approved: "approved";
+            pending: "pending";
+        }>;
+        evidence: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    approvedManifest: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        sha256: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ManagedWrenManifest = Readonly<z.infer<typeof managedWrenManifestSchema>>;
+export declare class ManagedWrenRuntimeError extends Error {
+    readonly code: ManagedWrenFailureCode;
+    constructor(code: ManagedWrenFailureCode, message?: ManagedWrenFailureCode);
+}
+export type ManagedWrenFailureCode = "codex_wren_manifest_missing" | "codex_wren_manifest_invalid" | "codex_wren_platform_unsupported" | "codex_wren_runtime_unprovisioned" | "codex_wren_provision_failed" | "codex_wren_interpreter_mismatch" | "codex_wren_launcher_mismatch" | "codex_wren_package_mismatch" | "codex_wren_closure_mismatch";
+export interface ManagedWrenRuntimeRecord extends NativeWrenRuntime {
+    readonly manifest_digest: string;
+    readonly generation_root: string;
+    readonly closure_digest: string;
+    readonly package_digest: string;
+}
+export declare function defaultManagedWrenRoot(): string;
+export declare function managedWrenManifestPath(root?: string): string;
+export declare function readManagedWrenManifest(root?: string): ManagedWrenManifest;
+export declare function manifestDigest(manifest: ManagedWrenManifest): string;
+export declare const managedWrenTreeDigest: (root: string) => string;
+/**
+ * Remove only records that were previously returned by this module and that
+ * the caller has established are neither active nor required for rollback.
+ *
+ * Generation selection belongs to the host/session lifecycle, not to a
+ * directory sweep: accepting arbitrary paths here would make cleanup an
+ * unsafe deletion primitive.  A concurrent provisioner conservatively blocks
+ * cleanup altogether; it can retry after the writer releases its lock.
+ */
+export declare function cleanupManagedWrenGenerations(options: {
+    readonly runtimeRoot?: string;
+    readonly candidates: readonly ManagedWrenRuntimeRecord[];
+    readonly retainManifestDigests: readonly string[];
+}): readonly string[];
+/** Revalidate a record before every native Codex launch. */
+export declare function resolveManagedWrenRuntime(options?: {
+    readonly packageRoot?: string;
+    readonly runtimeRoot?: string;
+}): ManagedWrenRuntimeRecord;
+/**
+ * Readiness is deliberately resolve-only: checking any RuntimeHost backend
+ * must neither create the GenBI runtime root nor fetch/install managed bytes.
+ * An explicit future first-use path may call the exported provisioner below.
+ */
+export declare function managedWrenReadinessFailure(options?: {
+    readonly packageRoot?: string;
+    readonly runtimeRoot?: string;
+}): ManagedWrenFailureCode | undefined;
+/**
+ * Provision is intentionally unavailable for a staged manifest. A release can
+ * only turn this on after the protected licence approval job writes an approved
+ * manifest with release-attested digests.
+ */
+export declare function provisionManagedWrenRuntime(options?: {
+    readonly packageRoot?: string;
+    readonly runtimeRoot?: string;
+}): Promise<ManagedWrenRuntimeRecord>;
+export declare function managedWrenClosureDigest(manifest: ManagedWrenManifest): string;
+export {};