agent-embassy 1.7.1 → 1.8.1

package/dist/src/gateway/state-v2-to-v3.d.ts

@@ -0,0 +1,23 @@
+export declare const gatewayStateV2ToV3FaultStages: readonly ["before_backup_write", "before_backup_file_sync", "before_backup_directory_sync", "before_backup_readback", "before_target_write", "before_target_file_sync", "before_target_rename", "after_target_rename", "before_target_directory_sync", "before_target_readback"];
+export type GatewayStateV2ToV3FaultStage = (typeof gatewayStateV2ToV3FaultStages)[number];
+export type GatewayStateV2ToV3Dependencies = Readonly<{
+    fault?: (stage: GatewayStateV2ToV3FaultStage) => void | Promise<void>;
+    now?: () => Date;
+    randomId?: () => string;
+    renameState?: (source: string, target: string) => Promise<void>;
+}>;
+export type GatewayStateV2ToV3Result = Readonly<{
+    /** Safe for normalized CLI output; contains no native or route identity. */
+    backupFile: string;
+    /** Internal readback correlation. Public surfaces must never print it. */
+    commitId: string;
+    commitSequence: number;
+}>;
+/**
+ * One-shot release-owned offline conversion. Callers must resolve the normal
+ * configured state directory before entering; this API never starts providers,
+ * helpers, discovery, the control socket, or the broker runtime.
+ */
+export declare function convertGatewayStateV2ToV3(options: Readonly<{
+    stateDir: string;
+}>, dependencies?: GatewayStateV2ToV3Dependencies): Promise<GatewayStateV2ToV3Result>;