paseo-plugin-zcode-provider 0.4.4 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/NOTICE.md +2 -2
  2. package/README.md +14 -12
  3. package/client/account.tsx +13 -22
  4. package/index.server.ts +1 -3
  5. package/package.json +4 -4
  6. package/paseo-plugin.json +1 -1
  7. package/server/build-info.ts +1 -1
  8. package/server/diagnostics.ts +4 -1
  9. package/server/discovery/manifest.ts +2 -2
  10. package/server/errors.ts +1 -0
  11. package/server/host/bridge.ts +3 -0
  12. package/server/mapping.ts +23 -6
  13. package/server/provider-status.ts +3 -3
  14. package/server/provider.ts +16 -1
  15. package/server/runtime/pins.ts +3 -3
  16. package/server/session.ts +49 -13
  17. package/server/turn-failure.ts +6 -1
  18. package/server/usage.ts +1 -3
  19. package/server/vendor/zcode/NOTICE.md +1 -1
  20. package/server/vendor/zcode/packages/rpc/src/channelClient.ts +18 -3
  21. package/server/vendor/zcode/packages/rpc/src/channelServer.ts +32 -12
  22. package/server/vendor/zcode/packages/rpc/src/channels.shared.ts +8 -1
  23. package/server/vendor/zcode/packages/rpc/src/serialization.ts +9 -3
  24. package/server/vendor/zcode/packages/shared/src/browser-use/command-metadata.ts +2 -0
  25. package/server/vendor/zcode/packages/shared/src/browser-use/commands.ts +2 -0
  26. package/server/vendor/zcode/packages/shared/src/browser-use/result.ts +4 -0
  27. package/server/vendor/zcode/packages/shared/src/gen-ui/contract.ts +246 -0
  28. package/server/vendor/zcode/packages/shared/src/gen-ui/tweakProtocol.ts +143 -0
  29. package/server/vendor/zcode/packages/shared/src/{localTtft.ts → local-ttft/contract.ts} +56 -1
  30. package/server/vendor/zcode/packages/shared/src/mcp-apps/contract.ts +8 -0
  31. package/server/vendor/zcode/packages/shared/src/official-mcp-auth.ts +8 -0
  32. package/server/vendor/zcode/packages/shared/src/protocol.ts +2 -0
  33. package/server/vendor/zcode/packages/shared/src/request-security-edition/verification-policy.ts +9 -1
  34. package/server/vendor/zcode/packages/shared/src/runtimeEnv.ts +10 -0
  35. package/server/vendor/zcode/packages/shared/src/server-remote.ts +2 -0
  36. package/server/vendor/zcode/packages/shared/src/source-server/compatibility.ts +11 -0
  37. package/server/vendor/zcode/packages/shared/src/source-server/contracts.ts +21 -1
  38. package/server/vendor/zcode/packages/shared/src/source-server/errorCodes.ts +27 -9
  39. package/server/vendor/zcode/packages/shared/src/subagent-profile.ts +5 -0
  40. package/server/vendor/zcode/packages/shared/src/validationAppSettings.ts +1 -0
  41. package/server/vendor/zcode/packages/shared/src/zcode-protocol/index.ts +164 -11
  42. package/server/vendor/zcode/packages/shared/src/zcode-protocol-legacy-types.ts +1 -0
  43. package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/apply.ts +4 -2
  44. package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/command.ts +11 -7
  45. package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/delta.ts +2 -0
  46. package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/input-intent.ts +2 -0
  47. package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/rows.ts +19 -1
  48. package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/snapshot.ts +11 -0
  49. package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/transport.ts +20 -1
  50. package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/workflow-row-meta.ts +8 -0
  51. package/server/vendor/zcode/provenance.json +71 -63
@@ -44,7 +44,12 @@ export const LOCAL_TTFT_CLOCK_TTL_MS = 60_000;
44
44
  const time = z.number().finite().nonnegative();
45
45
  const identifier = z.string().min(1).max(128);
46
46
  export const localTtftContextSchema = z
47
- .object({ version: z.literal(1), observationId: z.string().uuid() })
47
+ .object({
48
+ version: z.literal(1),
49
+ observationId: z.string().uuid(),
50
+ // 本地默认采集不能顺带开启云端;在一次发送开始时冻结出口选择。
51
+ localOnly: z.literal(true).optional(),
52
+ })
48
53
  .strict();
49
54
  export type LocalTtftContext = z.infer<typeof localTtftContextSchema>;
50
55
  export const localTtftClockSchema = z
@@ -123,6 +128,7 @@ export const localTtftRecordSchema = z
123
128
  .object({
124
129
  version: z.literal(1),
125
130
  observationId: z.string().uuid(),
131
+ localOnly: z.literal(true).optional(),
126
132
  commandId: identifier.optional(),
127
133
  sessionId: identifier.optional(),
128
134
  turnId: identifier.optional(),
@@ -190,3 +196,52 @@ export type LocalTtftBatch = z.infer<typeof localTtftBatchSchema>;
190
196
  export function localTtftNow(): number {
191
197
  return performance.timeOrigin + performance.now();
192
198
  }
199
+
200
+ /** 有界异步诊断队列;文件 I/O 由宿主 adapter 注入,不参与业务等待。 */
201
+ export function createLocalTtftLogQueue(
202
+ write: (entries: readonly { path: string; line: string }[], dropped: number) => Promise<void>,
203
+ maxChars = 262_144,
204
+ ) {
205
+ let entries: { path: string; line: string }[] = [];
206
+ let chars = 0;
207
+ let dropped = 0;
208
+ let draining: Promise<void> | undefined;
209
+ const drain = async () => {
210
+ while (entries.length) {
211
+ const batch = entries;
212
+ entries = [];
213
+ chars = 0;
214
+ try {
215
+ await write(batch, dropped);
216
+ } catch {
217
+ dropped += batch.length;
218
+ }
219
+ }
220
+ };
221
+ const schedule = () => {
222
+ draining ??= Promise.resolve()
223
+ .then(drain)
224
+ .finally(() => {
225
+ draining = undefined;
226
+ // drain 的 Promise 收口前仍可能有新记录进入,不能让它等下一次业务日志才落盘。
227
+ if (entries.length) schedule();
228
+ });
229
+ };
230
+ return {
231
+ enqueue(entry: { path: string; line: string }): void {
232
+ if (chars + entry.line.length > maxChars) {
233
+ dropped++;
234
+ return;
235
+ }
236
+ entries.push(entry);
237
+ chars += entry.line.length;
238
+ schedule();
239
+ },
240
+ async flush(): Promise<void> {
241
+ while (draining) await draining;
242
+ },
243
+ get dropped(): number {
244
+ return dropped;
245
+ },
246
+ };
247
+ }
@@ -98,6 +98,8 @@ export interface McpAppResourceMeta {
98
98
  heightHint?: number;
99
99
  minFrameHeight?: number;
100
100
  showInline?: boolean;
101
+ /** 资源级显式后台保留申请;缺省不保留,实际回收由宿主裁决。 */
102
+ backgroundRetention?: boolean;
101
103
  }
102
104
  /** 随沙箱句柄回到 renderer 的资源级呈现信息;CSP 与放宽只在 main 生效,不回传。 */
103
105
  export type PluginSandboxResourceMeta = Omit<McpAppResourceMeta, "csp" | "cspRelaxations">;
@@ -152,6 +154,11 @@ export {
152
154
  export const MCP_APPS_WIDGET_STATE_EXPERIMENTAL_KEY = "zcode/widgetState";
153
155
  export const MCP_APPS_RESOURCE_SUBSCRIBE_EXPERIMENTAL_KEY = "zcode/resourceSubscribe";
154
156
  export const MCP_APPS_SURFACE_EXPERIMENTAL_KEY = "zcode/surface";
157
+ /**
158
+ * 宿主允许插件文档内部创建子 frame(srcdoc / about:blank 预览、声明的 frameDomains)而不把它当作页面重载撤销实例。
159
+ * 旧宿主会在子 frame 导航时停止页面;需要嵌套预览的插件据此键降级,而不是创建 frame 后被释放。
160
+ */
161
+ export const MCP_APPS_NESTED_FRAMES_EXPERIMENTAL_KEY = "zcode/nestedFrames";
155
162
  /**
156
163
  * ZCode 扩展方法 `ui/set-widget-state { widgetState }`(MCP Apps 无 widgetState):页面把界面状态交给宿主
157
164
  * renderer 内存保存(不持久化,会话内重挂载可恢复);初值经 hostContext 的 `zcode/widgetState` 键随握手下发。
@@ -245,6 +252,7 @@ export interface PluginSandboxRegisterRequestPayload {
245
252
  minFrameHeight?: number;
246
253
  /** 资源级强制常驻标记,随句柄 resourceMeta 回 renderer。 */
247
254
  showInline?: boolean;
255
+ backgroundRetention?: boolean;
248
256
  }
249
257
  /** host 内部使用的登记输入:去掉传输层 requestId。 */
250
258
  export type PluginSandboxRegisterInput = Omit<PluginSandboxRegisterRequestPayload, "requestId">;
@@ -93,6 +93,14 @@ export const OFFICIAL_MCP_AUTH_PORT_FAILURE_REASONS = [
93
93
  export type OfficialMcpAuthPortFailureReason =
94
94
  (typeof OFFICIAL_MCP_AUTH_PORT_FAILURE_REASONS)[number];
95
95
 
96
+ /**
97
+ * 身份头的消费方类型。`mcp-server` 是官方 MCP(缺省,旧版 agent 不带该字段);
98
+ * `plugin-command` 是官方插件的命令进程,经 agent 侧代理端点访问 zcode-server(技术方案 5.8)。
99
+ */
100
+ export const OFFICIAL_AUTH_CONSUMER_KINDS = ["mcp-server", "plugin-command"] as const;
101
+
102
+ export type OfficialAuthConsumerKind = (typeof OFFICIAL_AUTH_CONSUMER_KINDS)[number];
103
+
96
104
  /** MCP adapter 侧的完整失败分类,包含网络层结果。仅用于 record status 与日志。 */
97
105
  export type OfficialMcpAuthFailureKind =
98
106
  | OfficialMcpAuthFailureReason
@@ -194,6 +194,8 @@ export interface RemoteWorkspaceSessionSnapshot {
194
194
  lastConnectionStatus: "connected" | "failed";
195
195
  /** 最近一次失败原因;成功后清空 */
196
196
  lastConnectionError?: string;
197
+ /** 最近一次失败的错误码,与 lastConnectionError 同写同清;等待点也写成失败,只看文案分不清两类 */
198
+ lastConnectionErrorCode?: string;
197
199
  }
198
200
 
199
201
  export interface LocalWorkspaceSessionEntry {
@@ -11,6 +11,11 @@ export function readRequestVerificationConfig(
11
11
  ): RequestVerificationConfig | null {
12
12
  return null;
13
13
  }
14
+ export function readValidatedRequestVerificationConfig(
15
+ _configs: RequestVerificationClientConfig | null | undefined,
16
+ ): RequestVerificationConfig | null {
17
+ return null;
18
+ }
14
19
  export function requestVerificationClaimHeaders(
15
20
  _proof: RequestVerificationProof,
16
21
  ): Record<string, string> {
@@ -26,7 +31,10 @@ export function allowRequestVerificationHeaders(
26
31
  ): Record<string, string> {
27
32
  return {};
28
33
  }
29
- export function requiresRequestVerification(_access: { mode: string } | undefined): boolean {
34
+ export function requiresRequestVerification(
35
+ _access: { mode: string } | undefined,
36
+ _config?: RequestVerificationConfig | null,
37
+ ): boolean {
30
38
  return false;
31
39
  }
32
40
  export function isRequestVerificationMessage(_message: string): boolean {
@@ -12,6 +12,10 @@ export const ZCODE_TOOL_ENV_PASSTHROUGH_ENV_KEY = "ZCODE_TOOL_ENV_PASSTHROUGH_JS
12
12
  export const ZCODE_DESKTOP_CONTEXT_PROMPT_ENABLED_ENV = "ZCODE_DESKTOP_CONTEXT_PROMPT_ENABLED";
13
13
  export const ZCODE_CUA_PRODUCT_HELPER_ENV_KEY = "ZCODE_CUA_PRODUCT_HELPER";
14
14
  export const ZCODE_CUA_BROKER_SOCKET_ENV_KEY = "ZCODE_CUA_PERMISSION_BROKER_SOCKET";
15
+ // 官方命令端点(agent 侧代理,技术方案 5.8):地址与 session token 只由 agent 按 session 注入
16
+ // Bash/tool 子进程,不随 agent 全局 env 继承。
17
+ export const ZCODE_OFFICIAL_ENDPOINT_ENV_KEY = "ZCODE_OFFICIAL_ENDPOINT";
18
+ export const ZCODE_OFFICIAL_ENDPOINT_TOKEN_ENV_KEY = "ZCODE_OFFICIAL_ENDPOINT_TOKEN";
15
19
  /** Shared node_repl host marker; unlike the broker bearer values it is not a secret. */
16
20
  export const ZCODE_CUA_NODE_REPL_HOST_ENV_KEY = "ZCODE_CUA_NODE_REPL_HOST";
17
21
  // One-knob local-development bundle. Setting ZCODE_CUA_DEV_MODE implies the internal feature
@@ -70,6 +74,10 @@ const SANITIZED_RUNTIME_ENV_KEYS = [
70
74
  "ZCODE_CUA_PERMISSION_BROKER_TOKEN",
71
75
  "ZCODE_CUA_PERMISSION_BROKER_REFRESH_MARKER",
72
76
  "ZCODE_CUA_PLUGIN_AUTHORITY",
77
+ // 官方命令端点的地址与 token 属于某一个 session,由 agent 定向注入;从父进程继承来的
78
+ // 值(例如嵌套运行的 agent)一律剔除,避免一个 session 拿着另一个 session 的 token。
79
+ ZCODE_OFFICIAL_ENDPOINT_ENV_KEY,
80
+ ZCODE_OFFICIAL_ENDPOINT_TOKEN_ENV_KEY,
73
81
  // Agent OTLP Endpoint/Auth/Identity 只属于 CLI telemetry bootstrap,不能继续泄漏给
74
82
  // Bash、MCP 或模型工具子进程。sanitize 前会捕获到本进程私有 Map,供 Agent 启动边界读取。
75
83
  "OTEL_EXPORTER_OTLP_ENDPOINT",
@@ -101,6 +109,8 @@ const NON_TOOL_PASSTHROUGH_RUNTIME_ENV_KEYS = [
101
109
  ZCODE_CUA_BROKER_SOCKET_ENV_KEY,
102
110
  "ZCODE_CUA_PERMISSION_BROKER_REFRESH_MARKER",
103
111
  "ZCODE_CUA_PLUGIN_AUTHORITY",
112
+ ZCODE_OFFICIAL_ENDPOINT_ENV_KEY,
113
+ ZCODE_OFFICIAL_ENDPOINT_TOKEN_ENV_KEY,
104
114
  ZCODE_REMOTE_RUNTIME_NETWORK_AUTHORITY_ENV_KEY,
105
115
  ZCODE_REMOTE_HTTP_PROXY_ENV_KEY,
106
116
  ZCODE_REMOTE_NO_PROXY_ENV_KEY,
@@ -42,6 +42,7 @@ export const serverRemoteInfoSchema = z.object({
42
42
  virtualProjects: z.literal(true).optional(),
43
43
  // 旧 Server 缺少新增 dynamic event,必须先声明能力再订阅,避免异常打进对端读循环。
44
44
  processResourceTelemetry: z.boolean().optional(),
45
+ remoteConversationTelemetry: z.boolean().optional(),
45
46
  }),
46
47
  });
47
48
 
@@ -65,6 +66,7 @@ export const serverRemoteInfoOutputSchema = z
65
66
  virtualProjects: z.literal(true).optional(),
66
67
  // 输入和严格输出保持同一能力合同,否则新 Server 会在监听前被自身 schema 拒绝。
67
68
  processResourceTelemetry: z.boolean().optional(),
69
+ remoteConversationTelemetry: z.boolean().optional(),
68
70
  })
69
71
  .strict(),
70
72
  })
@@ -8,6 +8,17 @@ export const ZCODE_MIN_COMPATIBLE_VERSION =
8
8
  ? __ZCODE_MIN_COMPATIBLE_VERSION__
9
9
  : ZCODE_VERSION;
10
10
 
11
+ /**
12
+ * 远端服务支持设备卡停止 / 重启合同(`zcode stop --wait` 等,RDLC-01)的首个版本,桌面端据此做版本门禁。
13
+ * 取首个包含本合同的正式版 3.17.0。不提升最低兼容版本。
14
+ *
15
+ * Bug 原因:曾先后取 3.16.2(根版本占位)和 3.16.3(假设下一次发版包含本合同)。实际 v3.16.3 从 release 分支发布、
16
+ * 不含本合同,两次都等于已发布、不支持本合同的版本:旧 CLI 把 `stop --wait` 当成 ack 型 stop、把 `restart` 当成只换 Core,
17
+ * 桌面端收不到最终状态而报失败,但远端已执行停止或换 Core。
18
+ * 只看版本号区分不开开发中与已发布的同号版本,因此取实际首发版本;根版本升到 3.17.0 前开发构建也会显示禁用。
19
+ */
20
+ export const SOURCE_SERVER_LIFECYCLE_CONTROL_MIN_VERSION = "3.17.0";
21
+
11
22
  export const compatibilityManifestSchema = z
12
23
  .object({
13
24
  schemaVersion: z.literal(1),
@@ -127,11 +127,19 @@ export const sourceServerUpdateRequestSchema = z
127
127
  .object({
128
128
  profileId: nonEmptyStringSchema,
129
129
  force: z.boolean().optional(),
130
+ /** 用户已确认把较新的远端切换到本机 Desktop 版本;方向由远端 CLI 判定。 */
131
+ allowDowngrade: z.boolean().optional(),
130
132
  expectedTarget: sourceServerUpdateTargetSchema.optional(),
131
133
  })
132
134
  .strict();
133
135
  export type SourceServerUpdateRequest = z.input<typeof sourceServerUpdateRequestSchema>;
134
136
 
137
+ /**
138
+ * 设备级生命周期操作(停止、重启远端服务,RDLC-01)只接收设备身份;具体走哪条连接由 Host 路由,
139
+ * Renderer 不传 profileId。
140
+ */
141
+ export const sourceServerLifecycleSourceIdSchema = z.string().uuid();
142
+
135
143
  const connectionProfileBaseShape = {
136
144
  profileId: z.string().uuid(),
137
145
  sourceServerId: z.string().uuid().optional(),
@@ -302,6 +310,16 @@ export const sourceServerRunningTaskSchema = z
302
310
  export type SourceServerRunningTask = z.infer<typeof sourceServerRunningTaskSchema>;
303
311
  export const sourceServerRunningTasksSchema = z.array(sourceServerRunningTaskSchema);
304
312
 
313
+ /**
314
+ * 停止 / 重启远端服务确认前按设备读取的运行中任务(RDLC-01)。`available: false` 表示设备没有提供
315
+ * 可信清单(远端输出 null、命令失败或输出不符 schema),不能当作“没有任务”;空数组才是没有任务。
316
+ */
317
+ export const sourceServerRunningTasksResultSchema = z.discriminatedUnion("available", [
318
+ z.object({ available: z.literal(true), tasks: sourceServerRunningTasksSchema }).strict(),
319
+ z.object({ available: z.literal(false) }).strict(),
320
+ ]);
321
+ export type SourceServerRunningTasksResult = z.infer<typeof sourceServerRunningTasksResultSchema>;
322
+
305
323
  /** 只读安装预览;sizeBytes 是安装包实际大小,不代表解压后的磁盘占用。 */
306
324
  export const sourceServerInstallPreviewSchema = z
307
325
  .object({
@@ -323,6 +341,8 @@ export const sourceServerConnectionStateSnapshotSchema = z
323
341
  availableVersion: nonEmptyStringSchema.optional(),
324
342
  minimumVersion: nonEmptyStringSchema.optional(),
325
343
  upgradeTarget: z.enum(["controller", "server"]).optional(),
344
+ /** 远端当前 release 由显式降级安装时,被替换的版本;向导据此不自动升级。 */
345
+ downgradedFrom: nonEmptyStringSchema.optional(),
326
346
  errorCode: publicZCodeErrorCodeSchema.optional(),
327
347
  retryable: z.boolean().optional(),
328
348
  installPreview: sourceServerInstallPreviewSchema.optional(),
@@ -413,7 +433,7 @@ export type SourceServerInstallProgress = z.infer<typeof sourceServerInstallProg
413
433
  export const sourceServerOperationLogSchema = z
414
434
  .object({
415
435
  profileId: z.string().uuid(),
416
- operation: z.enum(["connect", "update"]),
436
+ operation: z.enum(["connect", "update", "stop", "restart"]),
417
437
  phase: nonEmptyStringSchema,
418
438
  level: z.enum(["info", "warn", "error"]),
419
439
  message: z.string(),
@@ -1,15 +1,14 @@
1
1
  import { z } from "zod";
2
2
 
3
- export const SOURCE_SERVER_INSTALL_REQUIRED_ERROR_CODE =
4
- "source-server-install-required" as const;
5
- export const SOURCE_SERVER_UPGRADE_REQUIRED_ERROR_CODE =
6
- "source-server-upgrade-required" as const;
3
+ export const SOURCE_SERVER_INSTALL_REQUIRED_ERROR_CODE = "source-server-install-required" as const;
4
+ export const SOURCE_SERVER_UPGRADE_REQUIRED_ERROR_CODE = "source-server-upgrade-required" as const;
7
5
  export const SOURCE_SERVER_UPDATE_RUNNING_TASKS_ERROR_CODE =
8
6
  "source-server-update-running-tasks" as const;
7
+ export const SOURCE_SERVER_DOWNGRADE_UNCONFIRMED_ERROR_CODE =
8
+ "source-server-downgrade-unconfirmed" as const;
9
9
  export const WORKSPACE_TASK_IDENTITY_CONFLICT_ERROR_CODE =
10
10
  "workspace-task-identity-conflict" as const;
11
- export const WORKSPACE_CONFIG_FILE_CONFLICT_ERROR_CODE =
12
- "workspace-config-file-conflict" as const;
11
+ export const WORKSPACE_CONFIG_FILE_CONFLICT_ERROR_CODE = "workspace-config-file-conflict" as const;
13
12
  export const WORKSPACE_MIGRATION_PLAN_DIVERGED_ERROR_CODE =
14
13
  "workspace-migration-plan-diverged" as const;
15
14
  export const WORKSPACE_SESSION_GENERATION_CHANGED_ERROR_CODE =
@@ -19,6 +18,14 @@ export const REMOTE_WORKSPACE_BIND_SESSION_MISSING_ERROR_CODE =
19
18
  "remote-workspace-bind-session-missing" as const;
20
19
  export const REMOTE_WORKSPACE_DIRECTORY_UNAVAILABLE_ERROR_CODE =
21
20
  "remote-workspace-directory-unavailable" as const;
21
+ /** 远端读取项目目录超过截止时间仍没有返回;目录本身未必不可用,可重试。 */
22
+ export const REMOTE_WORKSPACE_DIRECTORY_UNRESPONSIVE_ERROR_CODE =
23
+ "remote-workspace-directory-unresponsive" as const;
24
+ /**
25
+ * 打开远程项目目录(读取目录 + 登记身份)的截止时间,超时报
26
+ * REMOTE_WORKSPACE_DIRECTORY_UNRESPONSIVE_ERROR_CODE。Main 的 bind 兜底必须晚于它。
27
+ */
28
+ export const REMOTE_WORKSPACE_PREPARATION_TIMEOUT_MS = 30_000;
22
29
  export const REMOTE_RECOVERY_BUDGET_EXHAUSTED_ERROR_CODE =
23
30
  "remote-recovery-budget-exhausted" as const;
24
31
  export const SOURCE_SERVER_IDENTITY_CHANGE_PENDING_ERROR_CODE =
@@ -29,9 +36,16 @@ export const SOURCE_SERVER_REMOVE_CALLBACK_FAILED_ERROR_CODE =
29
36
  "source-server-remove-callback-failed" as const;
30
37
  export const SOURCE_SERVER_REMOVE_PERSIST_FAILED_ERROR_CODE =
31
38
  "source-server-remove-persist-failed" as const;
39
+ /** 远端 Supervisor 停止 Core 失败并进入 stop-failed,仍持有 data-root 锁(R2 §8.1)。 */
40
+ export const SOURCE_SERVER_STOP_FAILED_ERROR_CODE = "source-server-stop-failed" as const;
41
+ /** 远端 Supervisor 在 control 超时内没有应答;CLI 不强杀它(R2 §8.1)。 */
42
+ export const SOURCE_SERVER_CONTROL_UNRESPONSIVE_ERROR_CODE =
43
+ "source-server-control-unresponsive" as const;
32
44
 
33
45
  export const PUBLIC_ZCODE_ERROR_CODES = [
34
46
  "remote-authentication-failed",
47
+ // 服务器在密码之后还要求交互验证(例如动态口令);当前只支持密码、私钥与 SSH agent。
48
+ "remote-authentication-unsupported",
35
49
  "remote-host-unreachable",
36
50
  "remote-connection-timeout",
37
51
  "remote-host-not-found",
@@ -42,11 +56,14 @@ export const PUBLIC_ZCODE_ERROR_CODES = [
42
56
  "remote-install-failed",
43
57
  "remote-space-insufficient",
44
58
  "remote-permission-denied",
59
+ // 远端系统或架构不在支持范围(Windows 原生主机、非 x64/arm64);重试和改用直接下载都无效。
60
+ "remote-platform-unsupported",
45
61
  "remote-connection-canceled",
46
62
  "remote-connection-unknown",
47
63
  SOURCE_SERVER_INSTALL_REQUIRED_ERROR_CODE,
48
64
  SOURCE_SERVER_UPGRADE_REQUIRED_ERROR_CODE,
49
65
  SOURCE_SERVER_UPDATE_RUNNING_TASKS_ERROR_CODE,
66
+ SOURCE_SERVER_DOWNGRADE_UNCONFIRMED_ERROR_CODE,
50
67
  WORKSPACE_TASK_IDENTITY_CONFLICT_ERROR_CODE,
51
68
  WORKSPACE_CONFIG_FILE_CONFLICT_ERROR_CODE,
52
69
  WORKSPACE_MIGRATION_PLAN_DIVERGED_ERROR_CODE,
@@ -54,11 +71,14 @@ export const PUBLIC_ZCODE_ERROR_CODES = [
54
71
  REMOTE_BIND_CANCELED_ERROR_CODE,
55
72
  REMOTE_WORKSPACE_BIND_SESSION_MISSING_ERROR_CODE,
56
73
  REMOTE_WORKSPACE_DIRECTORY_UNAVAILABLE_ERROR_CODE,
74
+ REMOTE_WORKSPACE_DIRECTORY_UNRESPONSIVE_ERROR_CODE,
57
75
  REMOTE_RECOVERY_BUDGET_EXHAUSTED_ERROR_CODE,
58
76
  SOURCE_SERVER_IDENTITY_CHANGE_PENDING_ERROR_CODE,
59
77
  SOURCE_SERVER_REMOVE_CALLBACK_MISSING_ERROR_CODE,
60
78
  SOURCE_SERVER_REMOVE_CALLBACK_FAILED_ERROR_CODE,
61
79
  SOURCE_SERVER_REMOVE_PERSIST_FAILED_ERROR_CODE,
80
+ SOURCE_SERVER_STOP_FAILED_ERROR_CODE,
81
+ SOURCE_SERVER_CONTROL_UNRESPONSIVE_ERROR_CODE,
62
82
  ] as const;
63
83
 
64
84
  export type PublicZCodeErrorCode = (typeof PUBLIC_ZCODE_ERROR_CODES)[number];
@@ -67,8 +87,6 @@ export const publicZCodeErrorCodeSchema = z.enum(PUBLIC_ZCODE_ERROR_CODES);
67
87
 
68
88
  const publicZCodeErrorCodeSet = new Set<string>(PUBLIC_ZCODE_ERROR_CODES);
69
89
 
70
- export function isPublicZCodeErrorCode(
71
- value: unknown,
72
- ): value is PublicZCodeErrorCode {
90
+ export function isPublicZCodeErrorCode(value: unknown): value is PublicZCodeErrorCode {
73
91
  return typeof value === "string" && publicZCodeErrorCodeSet.has(value);
74
92
  }
@@ -18,6 +18,11 @@ export interface AgentProfile {
18
18
  name: string;
19
19
  path?: string;
20
20
  permissionMode?: AgentPermissionMode;
21
+ /**
22
+ * permissionMode 只能收紧父会话模式。插件 loader 在 CLI 进程内设置;
23
+ * 不进入下方跨进程 schema,若被跨边界发送,strict schema 会直接拒绝。
24
+ */
25
+ permissionModeRestrictOnly?: boolean;
21
26
  skills?: readonly string[];
22
27
  source: AgentProfileSource;
23
28
  systemPrompt: string;
@@ -141,6 +141,7 @@ const appWorkspaceSessionEntrySchema = z.discriminatedUnion("kind", [
141
141
  lastOpenedAt: z.number().int().nonnegative(),
142
142
  lastConnectionStatus: z.enum(["connected", "failed"]),
143
143
  lastConnectionError: z.string().optional(),
144
+ lastConnectionErrorCode: z.string().optional(),
144
145
  }),
145
146
  ]);
146
147