@sentropic/h2a-runtime 0.81.0

package/dist/migrate.d.ts

@@ -0,0 +1,125 @@
+/**
+ * remote migrate — convenience wrapper for round-tripping a local CLI session
+ * to a remote (SCW k8s) session and back.
+ *
+ * Forward (local → remote):
+ *   1. Resolve remote URL.
+ *   2. Ensure the cwd is linked to a workspace (reads .remote/workspace.json).
+ *   3. Push the workspace archive (project files, honours .gitignore).
+ *   4. Create a remote session for <profile> bound to that workspace.
+ *   5. Hand off the current terminal to the remote session via `attach`.
+ *      The attach call blocks until the session ends or the user detaches
+ *      (Ctrl+P Ctrl+Q). There is no separate process to kill — `migrate`
+ *      itself IS the process holding the terminal, and attach takes it over.
+ *
+ * Back (remote → local):
+ *   1. Resolve URL + workspace.
+ *   2. Pull the workspace + conversation state (3-way merge).
+ *   3. Restore conversation state to the local HOME.
+ *   4. Stop the remote session.
+ *   5. Print the exact local CLI command to resume from the restored state.
+ *      We do NOT spawn the CLI — we print the command so the user can run it.
+ */
+import { type OnConflict } from "./session-restore.js";
+export type MigrateForwardOptions = {
+    /** CLI profile to start on the remote (e.g. "claude", "codex"). */
+    readonly profile: string;
+    /** Remote control-plane URL. Required — callers must resolve the default. */
+    readonly remoteUrl: string;
+    /**
+     * Workspace id override. When set, the cwd does not need an existing
+     * .remote/workspace.json (one is created/reused for that id).
+     * When absent, the .remote/workspace.json for the cwd is used or a new
+     * workspace is created and linked.
+     */
+    readonly workspaceId?: string;
+    /**
+     * Whether to pass a --resume/<conv-id> flag to the remote CLI.
+     * Pass `true` for the most-recent conversation, or a specific id string.
+     */
+    readonly resume?: string | true;
+    /**
+     * When true, do NOT hijack the current terminal: push + create the remote
+     * session, print the `remote attach` command, and return. Used to migrate
+     * many sessions non-interactively and to let YOUR terminal reconnect to the
+     * remote session itself (rather than this process taking it over).
+     */
+    readonly noAttach?: boolean;
+    /**
+     * Revive a session on the EXISTING workspace without re-pushing the project
+     * (preserves work done remotely) — for bringing a session back after an
+     * accidental exit. Path/HOME parity + resume still apply; the conversation is
+     * the one already on the retained PVC.
+     */
+    readonly reconnect?: boolean;
+    /** Tool CLIs whose local auth to also bundle into the Pod (scw, gh, aws, …). */
+    readonly tools?: ReadonlyArray<string>;
+    /** Inject a custom fetch for tests. */
+    readonly fetchImpl?: typeof fetch;
+    /** Override process.cwd() for tests. */
+    readonly cwd?: string;
+    /** Override process.stderr.write for tests. */
+    readonly stderr?: NodeJS.WriteStream;
+};
+export type MigrateForwardResult = {
+    /** The workspace id that was used/created. */
+    readonly workspaceId: string;
+    /** The remote session id that was created. */
+    readonly sessionId: string;
+};
+export type MigrateBackOptions = {
+    /** Remote control-plane URL. Required — callers must resolve the default. */
+    readonly remoteUrl: string;
+    /** Workspace id override; falls back to .remote/workspace.json. */
+    readonly workspaceId?: string;
+    /** Known remote session id (from lineage incarnation). When set, skips the
+     * list-sessions round-trip and targets this session directly. */
+    readonly sessionId?: string;
+    /**
+     * Conflict resolution for diverged conversations: "backup" | "keep-local".
+     * Defaults to "block" (leaves diverged files untouched, exits non-zero).
+     */
+    readonly onConflict?: OnConflict;
+    /** Inject a custom fetch for tests. */
+    readonly fetchImpl?: typeof fetch;
+    /** Override process.cwd() for tests. */
+    readonly cwd?: string;
+    /** Override HOME for session restore in tests. */
+    readonly home?: string;
+    /** Override process.stderr.write for tests. */
+    readonly stderr?: NodeJS.WriteStream;
+    /** Override process.stdout.write for tests. */
+    readonly stdout?: NodeJS.WriteStream;
+};
+export type MigrateBackResult = {
+    /** The workspace id that was pulled. */
+    readonly workspaceId: string;
+    /** The session id that was stopped, if any. */
+    readonly stoppedSessionId?: string;
+    /** The resume command to print for the user. */
+    readonly resumeCommand: string;
+    /** Whether there were unresolved merge conflicts. */
+    readonly hasConflicts: boolean;
+};
+/**
+ * Forward: migrate the current local session to a remote k8s session.
+ *
+ * Steps: link workspace → push files → create remote session → attach terminal.
+ *
+ * Terminal handoff: `migrateForward` calls `attach`, which hijacks the current
+ * process's stdin/stdout in raw mode and blocks until the remote session ends
+ * or the user presses Ctrl+P Ctrl+Q to detach. There is no separate process
+ * involved — this function IS the process holding the terminal.
+ */
+export declare function migrateForward(options: MigrateForwardOptions): Promise<MigrateForwardResult>;
+/**
+ * Back: pull the remote session back to local.
+ *
+ * Steps: pull workspace + conversation state → stop remote session → print
+ * resume command.
+ *
+ * We do NOT spawn the local CLI — we print the resume command so the user
+ * retains control of when and how they restart.
+ */
+export declare function migrateBack(options: MigrateBackOptions): Promise<MigrateBackResult>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA4CH,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAa/E,MAAM,MAAM,qBAAqB,GAAG;IAClC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,uCAAuC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,wCAAwC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;qEACiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,uCAAuC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,wCAAwC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IACrC,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,gDAAgD;IAChD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC,CAAC;AAuWF;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA8M/B;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAsH5B"}