agent-embassy 1.7.1 → 1.8.0

package/dist/src/gateway/cli-copy.en.d.ts

@@ -1,19 +1,17 @@
 export declare const callerIdentityConflictHintEn = "both agent identities were inherited; the Codex App Server daemon may have been started inside an agent session. From a normal terminal, run: codex app-server daemon restart";
 export declare const cliCopyEn: {
-    readonly "help.usage": "Embassy — local messaging for Claude Code and Codex\n\nUsage:\n  embassy <command> [options] [--lang en|zh-CN]\n\nCommands:\n  serve [--inbound open] Run the socket-only broker (paired inbound by default)\n  health                 Check broker health\n  status                 Read the public status snapshot\n  doctor                 Diagnose Codex Desktop attachment\n  refresh-dashboard      Publish both static dashboard files\n  dashboard --live [--port <n>]\n                         Open live status and bounded route consent\n  register-codex         Register or succeed a Codex task\n  unregister-codex       Unregister the current Codex task\n  select-claude          Select a discovered Claude session\n  unselect-claude        Clear the Claude selection\n  pair [--from <alias> --to <alias>] Add one cross-provider consent edge\n  unpair [--from <alias> --to <alias>] Remove one cross-provider consent edge\n  send-to-claude         Send stdin to the selected Claude route\n  send-to-codex          Send stdin to a registered Codex route\n  reply                  Reply with a conversation token\n  delivery-status        Read a delivery token\n  wait-delivery          Wait for terminal delivery status\n  untrack                Close one active progress watch\n\nOptions:\n  --lang en|zh-CN        Localize user-facing text\n  --port <n>             Live dashboard port, 1024–65535 (default 41961)\n  --version, -v          Print the version\n  --help, -h             Show this help\n";
+    readonly "help.usage": "Embassy — local messaging for Claude Code and Codex\n\nUsage:\n  embassy <command> [options] [--lang en|zh-CN]\n\nCommands:\n  serve [--inbound open] Run the socket-only broker (paired inbound by default)\n  health                 Check broker health\n  status                 Read the public status snapshot\n  doctor                 Diagnose Codex Desktop attachment\n  convert-state-v2-to-v3 Convert stopped-broker state after making a backup\n  refresh-dashboard      Refresh discovery and publish both static dashboards\n  dashboard --live [--port <n>]\n                         Open live status and bounded route consent\n  register-codex         Register or succeed a Codex task\n  unregister-codex       Unregister the current Codex task\n  select-claude          Select a discovered Claude session\n  unselect-claude        Clear the Claude selection\n  pair [--from <alias> --to <alias>] Add one cross-provider consent edge\n  unpair [--from <alias> --to <alias>] Remove one cross-provider consent edge\n  send-to-claude         Send stdin to the selected Claude route\n  send-to-codex          Send stdin to a registered Codex route\n  reply                  Reply with a conversation token\n  delivery-status        Read a delivery token\n  wait-delivery          Wait for terminal delivery status\n  untrack                Close one active progress watch\n\nOptions:\n  --lang en|zh-CN        Localize user-facing text\n  --port <n>             Live dashboard port, 1024–65535 (default 41961)\n  --version, -v          Print the version\n  --help, -h             Show this help\n";
     readonly "hint.dashboardLiveRequired": "dashboard requires --live; static files are published by serve and refresh-dashboard.";
     readonly "hint.dashboardPortInUse": "live dashboard port {port} is already in use; close the holding process or choose another with --port <n>.";
     readonly "hint.controlInvalidResponse": "client/broker version skew is likely; rebuild or repoint this client to the broker's Embassy installation, then retry.";
     readonly "hint.messageTooLarge": "message exceeds the 16 KiB acceptance cap; shorten or split it. For long prose, pipe the body from a file.";
     readonly "hint.progressWatchOwnerConflict": "this pair already has a watch owned by the other participant; ask that owner to run `embassy untrack --conversation <conversation-token>` first.";
-    readonly "hint.codexSplitBrain": "Desktop is on a private App Server; its tasks are unreachable by Embassy. Relaunch: /usr/bin/open --env CODEX_APP_SERVER_USE_LOCAL_DAEMON=1 -a ChatGPT";
-    readonly "hint.codexOrphaned": "the daemon is running but no Desktop client is attached; threads cannot load. Run: /usr/bin/open --env CODEX_APP_SERVER_USE_LOCAL_DAEMON=1 -a ChatGPT, then open your Codex task.";
     readonly "error.input": "request rejected.";
     readonly "error.decision": "gateway rejected the request.";
     readonly "error.unavailable": "gateway unavailable.";
     readonly "error.ambiguous": "outcome ambiguous; do not retry automatically.";
     readonly "error.failure": "command failed.";
     readonly "error.unsafe": "gateway state directory or socket has unexpected permissions or ownership. Verify nothing else controls that path before running embassy serve.";
-    readonly "error.tokenUnknown": "delivery token not recognized; it may have expired or belong to a previous gateway session.";
+    readonly "error.tokenUnknown": "delivery token not recognized; it may have expired or left bounded retention.";
     readonly "error.deliveryTimeout": "the delivery has not settled yet; the gateway is still running. Check again later with embassy delivery-status.";
 };

package/dist/src/gateway/cli-copy.en.js

@@ -10,7 +10,8 @@ Commands:
   health                 Check broker health
   status                 Read the public status snapshot
   doctor                 Diagnose Codex Desktop attachment
-  refresh-dashboard      Publish both static dashboard files
+  convert-state-v2-to-v3 Convert stopped-broker state after making a backup
+  refresh-dashboard      Refresh discovery and publish both static dashboards
   dashboard --live [--port <n>]
                          Open live status and bounded route consent
   register-codex         Register or succeed a Codex task
@@ -37,15 +38,13 @@ Options:
     "hint.controlInvalidResponse": "client/broker version skew is likely; rebuild or repoint this client to the broker's Embassy installation, then retry.",
     "hint.messageTooLarge": "message exceeds the 16 KiB acceptance cap; shorten or split it. For long prose, pipe the body from a file.",
     "hint.progressWatchOwnerConflict": "this pair already has a watch owned by the other participant; ask that owner to run `embassy untrack --conversation <conversation-token>` first.",
-    "hint.codexSplitBrain": "Desktop is on a private App Server; its tasks are unreachable by Embassy. Relaunch: /usr/bin/open --env CODEX_APP_SERVER_USE_LOCAL_DAEMON=1 -a ChatGPT",
-    "hint.codexOrphaned": "the daemon is running but no Desktop client is attached; threads cannot load. Run: /usr/bin/open --env CODEX_APP_SERVER_USE_LOCAL_DAEMON=1 -a ChatGPT, then open your Codex task.",
     "error.input": "request rejected.",
     "error.decision": "gateway rejected the request.",
     "error.unavailable": "gateway unavailable.",
     "error.ambiguous": "outcome ambiguous; do not retry automatically.",
     "error.failure": "command failed.",
     "error.unsafe": "gateway state directory or socket has unexpected permissions or ownership. Verify nothing else controls that path before running embassy serve.",
-    "error.tokenUnknown": "delivery token not recognized; it may have expired or belong to a previous gateway session.",
+    "error.tokenUnknown": "delivery token not recognized; it may have expired or left bounded retention.",
     "error.deliveryTimeout": "the delivery has not settled yet; the gateway is still running. Check again later with embassy delivery-status.",
 };
 //# sourceMappingURL=cli-copy.en.js.map

package/dist/src/gateway/cli-copy.en.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-copy.en.js","sourceRoot":"","sources":["../../../src/gateway/cli-copy.en.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,4BAA4B,GACvC,+KAA+K,CAAC;AAElL,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Bf;IACC,4BAA4B,EAC1B,uFAAuF;IACzF,yBAAyB,EACvB,4GAA4G;IAC9G,6BAA6B,EAC3B,wHAAwH;IAC1H,sBAAsB,EACpB,4GAA4G;IAC9G,iCAAiC,EAC/B,kJAAkJ;IACpJ,sBAAsB,EACpB,wJAAwJ;IAC1J,oBAAoB,EAClB,mLAAmL;IACrL,aAAa,EAAE,mBAAmB;IAClC,gBAAgB,EAAE,+BAA+B;IACjD,mBAAmB,EAAE,sBAAsB;IAC3C,iBAAiB,EAAE,gDAAgD;IACnE,eAAe,EAAE,iBAAiB;IAClC,cAAc,EACZ,iJAAiJ;IACnJ,oBAAoB,EAClB,6FAA6F;IAC/F,uBAAuB,EACrB,iHAAiH;CACzF,CAAC"}
+{"version":3,"file":"cli-copy.en.js","sourceRoot":"","sources":["../../../src/gateway/cli-copy.en.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,4BAA4B,GACvC,+KAA+K,CAAC;AAElL,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCf;IACC,4BAA4B,EAC1B,uFAAuF;IACzF,yBAAyB,EACvB,4GAA4G;IAC9G,6BAA6B,EAC3B,wHAAwH;IAC1H,sBAAsB,EACpB,4GAA4G;IAC9G,iCAAiC,EAC/B,kJAAkJ;IACpJ,aAAa,EAAE,mBAAmB;IAClC,gBAAgB,EAAE,+BAA+B;IACjD,mBAAmB,EAAE,sBAAsB;IAC3C,iBAAiB,EAAE,gDAAgD;IACnE,eAAe,EAAE,iBAAiB;IAClC,cAAc,EACZ,iJAAiJ;IACnJ,oBAAoB,EAClB,+EAA+E;IACjF,uBAAuB,EACrB,iHAAiH;CACzF,CAAC"}

package/dist/src/gateway/cli-copy.js

@@ -7,8 +7,6 @@ export const cliCopyKeys = [
     "hint.controlInvalidResponse",
     "hint.messageTooLarge",
     "hint.progressWatchOwnerConflict",
-    "hint.codexSplitBrain",
-    "hint.codexOrphaned",
     "error.input",
     "error.decision",
     "error.unavailable",

package/dist/src/gateway/cli-copy.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-copy.js","sourceRoot":"","sources":["../../../src/gateway/cli-copy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,YAAY;IACZ,4BAA4B;IAC5B,yBAAyB;IACzB,6BAA6B;IAC7B,sBAAsB;IACtB,iCAAiC;IACjC,sBAAsB;IACtB,oBAAoB;IACpB,aAAa;IACb,gBAAgB;IAChB,mBAAmB;IACnB,iBAAiB;IACjB,eAAe;IACf,cAAc;IACd,oBAAoB;IACpB,uBAAuB;CACf,CAAC;AAQX,MAAM,UAAU,UAAU,CAAC,MAAuB;IAChD,OAAO,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC"}
+{"version":3,"file":"cli-copy.js","sourceRoot":"","sources":["../../../src/gateway/cli-copy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,YAAY;IACZ,4BAA4B;IAC5B,yBAAyB;IACzB,6BAA6B;IAC7B,sBAAsB;IACtB,iCAAiC;IACjC,aAAa;IACb,gBAAgB;IAChB,mBAAmB;IACnB,iBAAiB;IACjB,eAAe;IACf,cAAc;IACd,oBAAoB;IACpB,uBAAuB;CACf,CAAC;AAQX,MAAM,UAAU,UAAU,CAAC,MAAuB;IAChD,OAAO,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC"}

package/dist/src/gateway/cli-copy.zh-CN.d.ts

@@ -1,19 +1,17 @@
 export declare const callerIdentityConflictHintZhCn = "\u540C\u65F6\u7EE7\u627F\u4E86\u4E24\u79CD\u4EE3\u7406\u8EAB\u4EFD\uFF1BCodex App Server \u5B88\u62A4\u8FDB\u7A0B\u53EF\u80FD\u662F\u5728\u4EE3\u7406\u4F1A\u8BDD\u5185\u542F\u52A8\u7684\u3002\u8BF7\u5728\u666E\u901A\u7EC8\u7AEF\u4E2D\u8FD0\u884C\uFF1Acodex app-server daemon restart";
 export declare const cliCopyZhCn: {
-    readonly "help.usage": "Embassy — Claude Code 与 Codex 的本地消息通道\n\n用法：\n  embassy <command> [options] [--lang en|zh-CN]\n\n命令：\n  serve [--inbound open] 在前台运行仅使用套接字的代理（默认配对入站）\n  health                 检查代理健康状态\n  status                 读取公开状态快照\n  doctor                 诊断 Codex 桌面应用连接状态\n  refresh-dashboard      发布两份静态仪表盘文件\n  dashboard --live [--port <n>]\n                         打开实时状态与有限路由同意操作\n  register-codex         注册或继任 Codex 任务\n  unregister-codex       注销当前 Codex 任务\n  select-claude          选择已发现的 Claude 会话\n  unselect-claude        清除 Claude 选择\n  pair [--from <别名> --to <别名>] 添加一条跨提供商同意边\n  unpair [--from <别名> --to <别名>] 移除一条跨提供商同意边\n  send-to-claude         将标准输入发送到所选 Claude 路由\n  send-to-codex          将标准输入发送到已注册 Codex 路由\n  reply                  使用会话令牌回复\n  delivery-status        读取投递令牌状态\n  wait-delivery          等待终结投递状态\n  untrack                关闭一个活跃的进度监视\n\n选项：\n  --lang en|zh-CN        本地化面向用户的文本\n  --port <n>             实时仪表盘端口，1024–65535（默认 41961）\n  --version, -v          输出版本\n  --help, -h             显示此帮助\n";
+    readonly "help.usage": "Embassy — Claude Code 与 Codex 的本地消息通道\n\n用法：\n  embassy <command> [options] [--lang en|zh-CN]\n\n命令：\n  serve [--inbound open] 在前台运行仅使用套接字的代理（默认配对入站）\n  health                 检查代理健康状态\n  status                 读取公开状态快照\n  doctor                 诊断 Codex 桌面应用连接状态\n  convert-state-v2-to-v3 备份后转换已停止代理的状态\n  refresh-dashboard      刷新发现结果并发布两份静态仪表盘\n  dashboard --live [--port <n>]\n                         打开实时状态与有限路由同意操作\n  register-codex         注册或继任 Codex 任务\n  unregister-codex       注销当前 Codex 任务\n  select-claude          选择已发现的 Claude 会话\n  unselect-claude        清除 Claude 选择\n  pair [--from <别名> --to <别名>] 添加一条跨提供商同意边\n  unpair [--from <别名> --to <别名>] 移除一条跨提供商同意边\n  send-to-claude         将标准输入发送到所选 Claude 路由\n  send-to-codex          将标准输入发送到已注册 Codex 路由\n  reply                  使用会话令牌回复\n  delivery-status        读取投递令牌状态\n  wait-delivery          等待终结投递状态\n  untrack                关闭一个活跃的进度监视\n\n选项：\n  --lang en|zh-CN        本地化面向用户的文本\n  --port <n>             实时仪表盘端口，1024–65535（默认 41961）\n  --version, -v          输出版本\n  --help, -h             显示此帮助\n";
     readonly "hint.dashboardLiveRequired": "dashboard 需要 --live；静态文件由 serve 和 refresh-dashboard 发布。";
     readonly "hint.dashboardPortInUse": "实时仪表盘端口 {port} 已被占用；请关闭占用进程，或使用 --port <n> 选择其他端口。";
     readonly "hint.controlInvalidResponse": "客户端与网关进程的版本可能不一致；请重新构建客户端，或将其重新指向网关进程所使用的 Embassy 安装，然后重试。";
     readonly "hint.messageTooLarge": "消息超过 16 KiB 接收上限；请缩短消息或将其拆分。对于长篇内容，请通过管道从文件传入正文。";
     readonly "hint.progressWatchOwnerConflict": "此配对已有由另一参与方拥有的监视；请先让该所有者运行 `embassy untrack --conversation <conversation-token>`。";
-    readonly "hint.codexSplitBrain": "桌面应用正在使用私有 App Server；Embassy 无法访问其任务。请重新启动：/usr/bin/open --env CODEX_APP_SERVER_USE_LOCAL_DAEMON=1 -a ChatGPT";
-    readonly "hint.codexOrphaned": "守护进程正在运行，但没有桌面客户端连接；线程无法加载。请运行：/usr/bin/open --env CODEX_APP_SERVER_USE_LOCAL_DAEMON=1 -a ChatGPT，然后打开你的 Codex 任务。";
     readonly "error.input": "请求被拒绝。";
     readonly "error.decision": "网关拒绝了该请求。";
     readonly "error.unavailable": "网关不可用。";
     readonly "error.ambiguous": "结果不确定；请勿自动重试。";
     readonly "error.failure": "命令失败。";
     readonly "error.unsafe": "网关状态目录或套接字的权限或所有者异常。请先确认该路径未被其他进程控制，再运行 embassy serve。";
-    readonly "error.tokenUnknown": "无法识别该投递令牌；它可能已过期，或属于上一次网关会话。";
+    readonly "error.tokenUnknown": "无法识别该投递令牌；它可能已过期，或已超出有界保留范围。";
     readonly "error.deliveryTimeout": "该投递尚未结算；网关仍在运行。请稍后使用 embassy delivery-status 再次查询。";
 };

package/dist/src/gateway/cli-copy.zh-CN.js

@@ -10,7 +10,8 @@ export const cliCopyZhCn = {
   health                 检查代理健康状态
   status                 读取公开状态快照
   doctor                 诊断 Codex 桌面应用连接状态
-  refresh-dashboard      发布两份静态仪表盘文件
+  convert-state-v2-to-v3 备份后转换已停止代理的状态
+  refresh-dashboard      刷新发现结果并发布两份静态仪表盘
   dashboard --live [--port <n>]
                          打开实时状态与有限路由同意操作
   register-codex         注册或继任 Codex 任务
@@ -37,15 +38,13 @@ export const cliCopyZhCn = {
     "hint.controlInvalidResponse": "客户端与网关进程的版本可能不一致；请重新构建客户端，或将其重新指向网关进程所使用的 Embassy 安装，然后重试。",
     "hint.messageTooLarge": "消息超过 16 KiB 接收上限；请缩短消息或将其拆分。对于长篇内容，请通过管道从文件传入正文。",
     "hint.progressWatchOwnerConflict": "此配对已有由另一参与方拥有的监视；请先让该所有者运行 `embassy untrack --conversation <conversation-token>`。",
-    "hint.codexSplitBrain": "桌面应用正在使用私有 App Server；Embassy 无法访问其任务。请重新启动：/usr/bin/open --env CODEX_APP_SERVER_USE_LOCAL_DAEMON=1 -a ChatGPT",
-    "hint.codexOrphaned": "守护进程正在运行，但没有桌面客户端连接；线程无法加载。请运行：/usr/bin/open --env CODEX_APP_SERVER_USE_LOCAL_DAEMON=1 -a ChatGPT，然后打开你的 Codex 任务。",
     "error.input": "请求被拒绝。",
     "error.decision": "网关拒绝了该请求。",
     "error.unavailable": "网关不可用。",
     "error.ambiguous": "结果不确定；请勿自动重试。",
     "error.failure": "命令失败。",
     "error.unsafe": "网关状态目录或套接字的权限或所有者异常。请先确认该路径未被其他进程控制，再运行 embassy serve。",
-    "error.tokenUnknown": "无法识别该投递令牌；它可能已过期，或属于上一次网关会话。",
+    "error.tokenUnknown": "无法识别该投递令牌；它可能已过期，或已超出有界保留范围。",
     "error.deliveryTimeout": "该投递尚未结算；网关仍在运行。请稍后使用 embassy delivery-status 再次查询。",
 };
 //# sourceMappingURL=cli-copy.zh-CN.js.map

package/dist/src/gateway/cli-copy.zh-CN.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-copy.zh-CN.js","sourceRoot":"","sources":["../../../src/gateway/cli-copy.zh-CN.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,8BAA8B,GACzC,yFAAyF,CAAC;AAE5F,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Bf;IACC,4BAA4B,EAC1B,yDAAyD;IAC3D,yBAAyB,EACvB,oDAAoD;IACtD,6BAA6B,EAC3B,4DAA4D;IAC9D,sBAAsB,EACpB,kDAAkD;IACpD,iCAAiC,EAC/B,mFAAmF;IACrF,sBAAsB,EACpB,gHAAgH;IAClH,oBAAoB,EAClB,oHAAoH;IACtH,aAAa,EAAE,QAAQ;IACvB,gBAAgB,EAAE,WAAW;IAC7B,mBAAmB,EAAE,QAAQ;IAC7B,iBAAiB,EAAE,eAAe;IAClC,eAAe,EAAE,OAAO;IACxB,cAAc,EACZ,wDAAwD;IAC1D,oBAAoB,EAAE,8BAA8B;IACpD,uBAAuB,EACrB,oDAAoD;CAC5B,CAAC"}
+{"version":3,"file":"cli-copy.zh-CN.js","sourceRoot":"","sources":["../../../src/gateway/cli-copy.zh-CN.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,8BAA8B,GACzC,yFAAyF,CAAC;AAE5F,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCf;IACC,4BAA4B,EAC1B,yDAAyD;IAC3D,yBAAyB,EACvB,oDAAoD;IACtD,6BAA6B,EAC3B,4DAA4D;IAC9D,sBAAsB,EACpB,kDAAkD;IACpD,iCAAiC,EAC/B,mFAAmF;IACrF,aAAa,EAAE,QAAQ;IACvB,gBAAgB,EAAE,WAAW;IAC7B,mBAAmB,EAAE,QAAQ;IAC7B,iBAAiB,EAAE,eAAe;IAClC,eAAe,EAAE,OAAO;IACxB,cAAc,EACZ,wDAAwD;IAC1D,oBAAoB,EAAE,8BAA8B;IACpD,uBAAuB,EACrB,oDAAoD;CAC5B,CAAC"}

package/dist/src/gateway/cli.d.ts

@@ -3,8 +3,9 @@ import { type GatewayControlMethod, type GatewayControlResponse, type SendGatewa
 import { type GatewayConfig } from "./config.js";
 import { type LiveDashboardCommandOutcome, type LiveDashboardCommandOptions } from "./live-dashboard-command.js";
 import { type GatewayServerOptions } from "./server.js";
-export declare const EMBASSY_VERSION = "1.7.1";
-export declare const gatewayCliCommands: readonly ["serve", "health", "status", "doctor", "delivery-status", "wait-delivery", "untrack", "refresh-dashboard", "dashboard", "register-codex", "unregister-codex", "select-claude", "unselect-claude", "pair", "unpair", "send-to-claude", "send-to-codex", "reply"];
+import { type GatewayStateV2ToV3Result } from "./state-v2-to-v3.js";
+export declare const EMBASSY_VERSION = "1.8.0";
+export declare const gatewayCliCommands: readonly ["serve", "health", "status", "doctor", "convert-state-v2-to-v3", "delivery-status", "wait-delivery", "untrack", "refresh-dashboard", "dashboard", "register-codex", "unregister-codex", "select-claude", "unselect-claude", "pair", "unpair", "send-to-claude", "send-to-codex", "reply"];
 export type GatewayCliCommand = (typeof gatewayCliCommands)[number];
 export declare const gatewayCliExitCodes: Readonly<{
     readonly ok: 0;
@@ -20,6 +21,9 @@ type Writable = {
 type GatewayControlSender = <M extends GatewayControlMethod>(options: SendGatewayControlRequestOptions<M>) => Promise<GatewayControlResponse<M>>;
 type GatewayServerRunner = (options: GatewayServerOptions) => Promise<void>;
 type LiveDashboardRunner = (options: LiveDashboardCommandOptions) => Promise<LiveDashboardCommandOutcome | void>;
+type GatewayStateConverter = (options: Readonly<{
+    stateDir: string;
+}>) => Promise<GatewayStateV2ToV3Result>;
 export type GatewayCliDependencies = {
     env?: NodeJS.ProcessEnv;
     stdin?: AsyncIterable<unknown>;
@@ -29,6 +33,7 @@ export type GatewayCliDependencies = {
     sendRequest?: GatewayControlSender;
     runServer?: GatewayServerRunner;
     runLiveDashboard?: LiveDashboardRunner;
+    convertState?: GatewayStateConverter;
     serverSignal?: AbortSignal;
     liveDashboardSignal?: AbortSignal;
     validateControlSocket?: (stateDir: string, socketPath: string) => Promise<void>;