@opengeni/contracts 0.50.0 → 1.0.0

package/dist/sandbox-recovery.d.ts

@@ -0,0 +1,146 @@
+import { z } from "zod";
+/** Public, content-free selection. Never include native provider bindings. */
+export declare const SandboxRecoverySelection: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    sessionId: z.ZodString;
+    sandboxGroupId: z.ZodString;
+    leaseId: z.ZodString;
+    routeEpoch: z.ZodNumber;
+    authorityEpoch: z.ZodNumber;
+    leaseEpoch: z.ZodNumber;
+    workspaceGeneration: z.ZodNumber;
+    archiveGeneration: z.ZodNumber;
+    artifactId: z.ZodString;
+    revision: z.ZodString;
+    capturedAt: z.ZodString;
+}, z.core.$strict>;
+export type SandboxRecoverySelection = z.infer<typeof SandboxRecoverySelection>;
+export declare const SandboxRecoveryProjection: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    status: z.ZodEnum<{
+        blocked: "blocked";
+        consent_accepted: "consent_accepted";
+        eligible: "eligible";
+        restored: "restored";
+        restoring: "restoring";
+        unsupported: "unsupported";
+    }>;
+    reason: z.ZodNullable<z.ZodString>;
+    checkpoint: z.ZodNullable<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        sessionId: z.ZodString;
+        sandboxGroupId: z.ZodString;
+        leaseId: z.ZodString;
+        routeEpoch: z.ZodNumber;
+        authorityEpoch: z.ZodNumber;
+        leaseEpoch: z.ZodNumber;
+        workspaceGeneration: z.ZodNumber;
+        archiveGeneration: z.ZodNumber;
+        artifactId: z.ZodString;
+        revision: z.ZodString;
+        capturedAt: z.ZodString;
+    }, z.core.$strict>>;
+    operationId: z.ZodNullable<z.ZodString>;
+    automaticAvailable: z.ZodOptional<z.ZodBoolean>;
+    automaticLane: z.ZodOptional<z.ZodEnum<{
+        checkpoint: "checkpoint";
+        fresh_workspace: "fresh_workspace";
+    }>>;
+    availableAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SandboxRecoveryProjection = z.infer<typeof SandboxRecoveryProjection>;
+/** Why a definitively lost managed sandbox continues on an empty workspace. */
+export declare const SandboxFreshWorkspaceReason: z.ZodEnum<{
+    archive_unavailable: "archive_unavailable";
+    archive_unverified: "archive_unverified";
+    checkpoint_restore_failed: "checkpoint_restore_failed";
+    checkpoint_unrestorable: "checkpoint_unrestorable";
+}>;
+export type SandboxFreshWorkspaceReason = z.infer<typeof SandboxFreshWorkspaceReason>;
+/** Durable, content-free fresh-workspace decision for one group member. */
+export declare const SandboxFreshWorkspaceRecovery: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    sessionId: z.ZodString;
+    sandboxGroupId: z.ZodString;
+    leaseId: z.ZodString;
+    leaseEpoch: z.ZodNumber;
+    workspaceGeneration: z.ZodNumber;
+    archiveGeneration: z.ZodNullable<z.ZodNumber>;
+    lostAt: z.ZodString;
+    reason: z.ZodEnum<{
+        archive_unavailable: "archive_unavailable";
+        archive_unverified: "archive_unverified";
+        checkpoint_restore_failed: "checkpoint_restore_failed";
+        checkpoint_unrestorable: "checkpoint_unrestorable";
+    }>;
+}, z.core.$strict>;
+export type SandboxFreshWorkspaceRecovery = z.infer<typeof SandboxFreshWorkspaceRecovery>;
+export declare const SandboxRecoveryRequest: z.ZodObject<{
+    operationId: z.ZodString;
+    acceptHistoricalCheckpoint: z.ZodLiteral<true>;
+    selection: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        sessionId: z.ZodString;
+        sandboxGroupId: z.ZodString;
+        leaseId: z.ZodString;
+        routeEpoch: z.ZodNumber;
+        authorityEpoch: z.ZodNumber;
+        leaseEpoch: z.ZodNumber;
+        workspaceGeneration: z.ZodNumber;
+        archiveGeneration: z.ZodNumber;
+        artifactId: z.ZodString;
+        revision: z.ZodString;
+        capturedAt: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type SandboxRecoveryRequest = z.infer<typeof SandboxRecoveryRequest>;
+export declare const SandboxRecoveryResponse: z.ZodObject<{
+    outcome: z.ZodEnum<{
+        accepted: "accepted";
+        replayed: "replayed";
+    }>;
+    operationId: z.ZodString;
+    recovery: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        status: z.ZodEnum<{
+            blocked: "blocked";
+            consent_accepted: "consent_accepted";
+            eligible: "eligible";
+            restored: "restored";
+            restoring: "restoring";
+            unsupported: "unsupported";
+        }>;
+        reason: z.ZodNullable<z.ZodString>;
+        checkpoint: z.ZodNullable<z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            sessionId: z.ZodString;
+            sandboxGroupId: z.ZodString;
+            leaseId: z.ZodString;
+            routeEpoch: z.ZodNumber;
+            authorityEpoch: z.ZodNumber;
+            leaseEpoch: z.ZodNumber;
+            workspaceGeneration: z.ZodNumber;
+            archiveGeneration: z.ZodNumber;
+            artifactId: z.ZodString;
+            revision: z.ZodString;
+            capturedAt: z.ZodString;
+        }, z.core.$strict>>;
+        operationId: z.ZodNullable<z.ZodString>;
+        automaticAvailable: z.ZodOptional<z.ZodBoolean>;
+        automaticLane: z.ZodOptional<z.ZodEnum<{
+            checkpoint: "checkpoint";
+            fresh_workspace: "fresh_workspace";
+        }>>;
+        availableAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type SandboxRecoveryResponse = z.infer<typeof SandboxRecoveryResponse>;
+/** Re-injected from durable receipts on every attempt, not lossy transcript state. */
+export declare function sandboxRecoveryDiscontinuity(selection: SandboxRecoverySelection): string;
+/** Stable tail instructions, sourced from a durable system recovery receipt.
+ * `shared` names the sandbox this session shares with other sessions; every
+ * member of that group receives its own receipt for the same selection. */
+export declare function automaticSandboxRecoveryDiscontinuity(selection: SandboxRecoverySelection, scope?: "session" | "shared"): string;
+/** Stable tail instructions for continuing on a new empty workspace. The text
+ * is true on every later turn too: it names the loss, not the current tree. */
+export declare function freshWorkspaceSandboxRecoveryDiscontinuity(recovery: SandboxFreshWorkspaceRecovery): string;

package/dist/sandbox-snapshots.d.ts

@@ -40,6 +40,45 @@ export type NativeSnapshotDescriptor = {
     workspacePersistence?: string;
 };
 export type WorkspaceArchiveDescriptor = TarWorkspaceArchiveDescriptor | NativeSnapshotDescriptor;
+export declare const WORKSPACE_ARCHIVE_OBJECT_REF_SCHEMA: "sandbox_archive_object_v1";
+/** Compact object-storage locator for portable tar bytes. The SHA-256/size in
+ * `workspaceArchiveMeta` remain the verification authority. */
+export type WorkspaceArchiveObjectRef = {
+    schema: typeof WORKSPACE_ARCHIVE_OBJECT_REF_SCHEMA;
+    key: string;
+    sha256: string;
+    bytes: number;
+    backend: string;
+};
+export type WorkspaceArchiveObjectKey = {
+    accountId: string;
+    workspaceId: string;
+    sandboxGroupId: string;
+    revision: string;
+    uploadId: string | null;
+};
+export declare function parseWorkspaceArchiveObjectKey(value: unknown): WorkspaceArchiveObjectKey | null;
+export declare function parseWorkspaceArchiveObjectRef(value: unknown): WorkspaceArchiveObjectRef | null;
+export declare function workspaceArchiveObjectKey(input: {
+    accountId: string;
+    workspaceId: string;
+    sandboxGroupId: string;
+    revision: string;
+    /** New upload invocations supply a fresh randomUUID; omission is legacy-only. */
+    uploadId?: string;
+}): string;
+/** Bind a stored locator to its publication/restore scope and verified tar
+ * descriptor. A logical revision never substitutes for the exact physical key. */
+export declare function validateWorkspaceArchiveObjectRef(value: unknown, input: {
+    accountId: string;
+    workspaceId: string;
+    sandboxGroupId: string;
+    descriptor: WorkspaceArchiveDescriptor;
+}): WorkspaceArchiveObjectRef | null;
+export declare function workspaceArchivePayloadPresent(sessionState: Record<string, unknown> | null | undefined): boolean;
+/** Restore may inline object bytes in memory for hydrate. That copy must never
+ *  be published onto a lease when a durable object-storage ref exists. */
+export declare function omitInlineWorkspaceArchiveWhenObjectRefPresent(sessionState: Record<string, unknown>): Record<string, unknown>;
 export declare const NATIVE_SNAPSHOT_PREFIXES: ReadonlyArray<{
     provider: NativeSnapshotProvider;
     prefix: string;

package/dist/session-final-reply.d.ts

@@ -0,0 +1,6 @@
+/** A response-quality notice, not a failed turn or a completed deliverable. */
+export declare const EMPTY_FINAL_REPLY_NOTICE = "The model returned no final reply after a reply reminder. Completed work is preserved; the goal and later updates are unaffected.";
+export type EmptyFinalReplyCompletion = {
+    emptyFinalReply: true;
+};
+export declare function turnCompletedWithEmptyFinalReply(payload: unknown): boolean;

package/dist/session-final-reply.js

@@ -0,0 +1,9 @@
+import {
+  EMPTY_FINAL_REPLY_NOTICE,
+  turnCompletedWithEmptyFinalReply
+} from "./chunk-KHHZTBP7.js";
+export {
+  EMPTY_FINAL_REPLY_NOTICE,
+  turnCompletedWithEmptyFinalReply
+};
+//# sourceMappingURL=session-final-reply.js.map

package/dist/session-final-reply.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/session-goal-reports.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export declare const SessionGoalReportRequirement: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strict>;
+export type SessionGoalReportRequirement = z.infer<typeof SessionGoalReportRequirement>;
+export declare const SessionGoalReportRequirements: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strict>>;
+export declare const SessionGoalReportDelivery: z.ZodObject<{
+    requirementId: z.ZodString;
+    artifactId: z.ZodString;
+    inspectionReceiptId: z.ZodString;
+}, z.core.$strict>;
+export type SessionGoalReportDelivery = z.infer<typeof SessionGoalReportDelivery>;
+export declare const SessionGoalReportDeliveries: z.ZodArray<z.ZodObject<{
+    requirementId: z.ZodString;
+    artifactId: z.ZodString;
+    inspectionReceiptId: z.ZodString;
+}, z.core.$strict>>;