@deepseek-ai/dsh-api-remotes 0.1.3-alpha.2 → 0.1.5-alpha.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/api/remotes/README.md
-README.md: 1a6c311db9d456db17d942b56cc133799f355a88
-README.zh.md: cba94598868db8401ea512bdb6c274fa2fe098e5
+README.md: 52ef6223f4d7770224df1b1c5d783962c55f73f6
+README.zh.md: eab5d2c6642a7899fac60d8c666ee55057eaea05

package/README.md

@@ -42,7 +42,7 @@ This package owns no physical transport or Host service discovery. It projects t
 
 The listener signature is not restated here. Each allowlisted event's Cordis `Events` declaration lives in its owner package's client-safe `./types` export, and both faces of this package pull those declarations in. The Host face additionally asserts every entry against `TypertForwardableEventEntry`: an `emit` entry must be a declared one-way event, while a `waterfall` entry must be a declared Agent-scoped waterfall whose final parameter is its same-result `next()` callback.
 
-The Host entry registers an independent allowlist listener set and queue for each Client stream. It rejects non-JSON ordinary-event arguments before enqueueing. For a waterfall, it projects only the top-level Agent identity and JSON request fields; a Client result must also be lossless JSON, while `next()` delegates to the following Host listener. The source attaches all listeners synchronously before `ctx.typertGateway.registerRemoteEvents()` exposes Gateway's internal `$events` logical stream, so its first `ready` item proves that incremental delivery is active and carries the Host home for Client path display. Withdrawing the registration aborts active streams.
+The Host entry registers an independent allowlist listener set and queue for each Client stream. It rejects non-JSON ordinary-event arguments before enqueueing. For a waterfall, it projects only the top-level Agent identity and JSON request fields; a Client result must also be lossless JSON, while `next()` delegates to the following Host listener. Each scoped waterfall request must carry its routed Agent directly as `request.agent`; the Host rejects a missing or mismatched identity before forwarding. The source attaches all listeners synchronously before `ctx.typertGateway.registerRemoteEvents()` exposes Gateway's internal `$events` logical stream, so its first `ready` item proves that incremental delivery is active and carries the Host home for Client path display. Withdrawing the registration aborts active streams.
 
 <a id="build-boundary"></a>
 ## Build boundary

package/README.zh.md

@@ -42,7 +42,7 @@ Client 组合挂载 Commands、凭据、settings、Goal、动态 Cordis、文件
 
 监听器签名不在此处重写。名单内每条事件的 Cordis `Events` 声明都住在其 owner 包 client-safe 的 `./types` 出口，本包两个 face 都把那些声明纳入编译面。Host face 还会把每个条目断言给 `TypertForwardableEventEntry`：`emit` 条目必须是已声明的单向事件，`waterfall` 条目则必须是已声明的 Agent-scoped waterfall，且其最后一个参数是返回相同结果类型的 `next()` 回调。
 
-Host entry 为每条 Client stream 独立注册 allowlist listener 和队列，并在普通事件入队前拒绝非 JSON 参数。对于 waterfall，它只投影顶层 Agent 身份与 JSON 请求字段；Client 结果也必须能无损表示为 JSON，而 `next()` 会委托给后续 Host listener。该 source 在 `ctx.typertGateway.registerRemoteEvents()` 暴露 Gateway 内部的 `$events` logical stream 前同步挂好所有 listener，因此首个 `ready` 项既能证明增量投递已就绪，也会携带供 Client 显示路径的 Host home。撤回注册会中止活动 stream。
+Host entry 为每条 Client stream 独立注册 allowlist listener 和队列，并在普通事件入队前拒绝非 JSON 参数。对于 waterfall，它只投影顶层 Agent 身份与 JSON 请求字段；Client 结果也必须能无损表示为 JSON，而 `next()` 会委托给后续 Host listener。每个作用域 waterfall 请求都必须以 `request.agent` 直接携带路由所用的 Agent；Host 会在转发前拒绝缺失或不匹配的身份。该 source 在 `ctx.typertGateway.registerRemoteEvents()` 暴露 Gateway 内部的 `$events` logical stream 前同步挂好所有 listener，因此首个 `ready` 项既能证明增量投递已就绪，也会携带供 Client 显示路径的 Host home。撤回注册会中止活动 stream。
 
 <a id="build-boundary"></a>
 ## 构建边界

package/lib/client.js

@@ -4334,7 +4334,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		const _deepseek_ai_dsh_agent_presets_agentPresets_select_parameter_0$schema = intersection(string(), unknown());
 		const _deepseek_ai_dsh_agent_presets_agentPresets_select_parameter_1$schema = string();
 		const _deepseek_ai_dsh_agent_presets_agentPresets_select_result$schema = string();
-		const TYPERT_REMOTE$12 = {
+		const TYPERT_REMOTE$13 = {
 			package: "@deepseek-ai/dsh-agent-presets",
 			descriptors: [
 				{
@@ -4543,7 +4543,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				"attachments": boolean().readonly().optional()
 			}).readonly().optional()
 		}));
-		const TYPERT_REMOTE$11 = {
+		const TYPERT_REMOTE$12 = {
 			package: "@deepseek-ai/dsh-commands",
 			descriptors: [{
 				id: "@deepseek-ai/dsh-commands#commands/execute",
@@ -4939,7 +4939,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			})),
 			"revision": number()
 		});
-		const TYPERT_REMOTE$10 = {
+		const TYPERT_REMOTE$11 = {
 			package: "@deepseek-ai/dsh-api-settings-controller",
 			descriptors: [
 				{
@@ -5341,6 +5341,27 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"id": intersection(string(), unknown()).readonly(),
 			"revision": number().readonly()
 		});
+		const _deepseek_ai_dsh_goal_goals_get_parameter_0$schema = intersection(string(), unknown());
+		const _deepseek_ai_dsh_goal_goals_get_result$schema = union([_undefined(), object({
+			"roundsStarted": number().readonly(),
+			"createdAt": number().readonly(),
+			"updatedAt": number().readonly(),
+			"activation": union([literal("armed"), literal("disarmed")]).readonly(),
+			"objective": string().readonly(),
+			"phase": union([
+				literal("active"),
+				literal("paused"),
+				literal("blocked"),
+				literal("complete")
+			]).readonly(),
+			"blockedReason": object({
+				"code": string().readonly(),
+				"message": string().readonly()
+			}).readonly().optional(),
+			"maxGoalRounds": number().readonly(),
+			"id": intersection(string(), unknown()).readonly(),
+			"revision": number().readonly()
+		})]);
 		const _deepseek_ai_dsh_goal_goals_pause_parameter_0$schema = intersection(string(), unknown());
 		const _deepseek_ai_dsh_goal_goals_pause_parameter_1$schema = object({
 			"id": intersection(string(), unknown()).readonly(),
@@ -5391,7 +5412,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"id": intersection(string(), unknown()).readonly(),
 			"revision": number().readonly()
 		});
-		const TYPERT_REMOTE$9 = {
+		const TYPERT_REMOTE$10 = {
 			package: "@deepseek-ai/dsh-goal",
 			descriptors: [
 				{
@@ -5431,7 +5452,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/goal/goal/src/index.ts",
-						"line": 431,
+						"line": 433,
 						"column": 3
 					}
 				},
@@ -5472,7 +5493,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/goal/goal/src/index.ts",
-						"line": 389,
+						"line": 391,
 						"column": 3
 					}
 				},
@@ -5514,7 +5535,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/goal/goal/src/index.ts",
-						"line": 623,
+						"line": 647,
 						"column": 3
 					}
 				},
@@ -5568,7 +5589,39 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/goal/goal/src/index.ts",
-						"line": 327,
+						"line": 329,
+						"column": 3
+					}
+				},
+				{
+					id: "@deepseek-ai/dsh-goal#goals/get",
+					service: "goals",
+					namespace: "goals",
+					method: "get",
+					invocation: { kind: "direct" },
+					scope: {
+						context: "agent",
+						wire: "agentId"
+					},
+					parameters: [{
+						name: "agent",
+						wire: "agentId",
+						source: "lookup",
+						lookup: "agent",
+						codec: {
+							mode: "strict",
+							typeSymbol: "@deepseek-ai/dsh-session/types#SessionId",
+							schema: _deepseek_ai_dsh_goal_goals_get_parameter_0$schema
+						}
+					}],
+					result: {
+						mode: "strict",
+						typeSymbol: "@deepseek-ai/dsh-goal#goals/get:result",
+						schema: _deepseek_ai_dsh_goal_goals_get_result$schema
+					},
+					sourceLocation: {
+						"file": "packages/goal/goal/src/index.ts",
+						"line": 277,
 						"column": 3
 					}
 				},
@@ -5609,7 +5662,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/goal/goal/src/index.ts",
-						"line": 350,
+						"line": 352,
 						"column": 3
 					}
 				},
@@ -5650,7 +5703,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/goal/goal/src/index.ts",
-						"line": 362,
+						"line": 364,
 						"column": 3
 					}
 				}
@@ -5682,7 +5735,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"id": string(),
 			"name": string()
 		}));
-		const TYPERT_REMOTE$8 = {
+		const TYPERT_REMOTE$9 = {
 			package: "@deepseek-ai/dsh-llm",
 			descriptors: [
 				{
@@ -5719,7 +5772,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/llm/llm/src/index.ts",
-						"line": 625,
+						"line": 628,
 						"column": 9
 					}
 				},
@@ -5737,7 +5790,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/llm/llm/src/index.ts",
-						"line": 538,
+						"line": 541,
 						"column": 3
 					}
 				},
@@ -5755,7 +5808,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/llm/llm/src/index.ts",
-						"line": 466,
+						"line": 469,
 						"column": 3
 					}
 				}
@@ -6089,7 +6142,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"reason": literal("plugin-missing"),
 			"message": string()
 		})]);
-		const TYPERT_REMOTE$7 = {
+		const TYPERT_REMOTE$8 = {
 			package: "@deepseek-ai/dsh-cordis-host-runner",
 			descriptors: [
 				{
@@ -6690,7 +6743,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				}
 			]
 		};
-		const TYPERT_REMOTE$6 = {
+		const TYPERT_REMOTE$7 = {
 			package: "@deepseek-ai/dsh-host-plugin-inventory",
 			descriptors: [{
 				id: "@deepseek-ai/dsh-host-plugin-inventory#pluginInventory/list",
@@ -6843,7 +6896,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				})
 			]).readonly()
 		})]);
-		const TYPERT_REMOTE$5 = {
+		const TYPERT_REMOTE$6 = {
 			package: "@deepseek-ai/dsh-message-feedback",
 			descriptors: [
 				{
@@ -6944,7 +6997,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				"bytes": number()
 			}).readonly()
 		});
-		const TYPERT_REMOTE$4 = {
+		const TYPERT_REMOTE$5 = {
 			package: "@deepseek-ai/dsh-client-file-upload",
 			descriptors: [{
 				id: "@deepseek-ai/dsh-client-file-upload#fileUploads/upload",
@@ -7001,7 +7054,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"sameWorkspace": boolean(),
 			"createdAt": number()
 		}));
-		const TYPERT_REMOTE$3 = {
+		const TYPERT_REMOTE$4 = {
 			package: "@deepseek-ai/dsh-session-reference",
 			descriptors: [{
 				id: "@deepseek-ai/dsh-session-reference#sessionReferenceResolver/candidates",
@@ -7109,7 +7162,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"clientTimeZone": string().readonly().optional()
 		});
 		const _deepseek_ai_dsh_subagent_subagents_prompt_result$schema = object({ "messageId": intersection(string(), unknown()).readonly() });
-		const TYPERT_REMOTE$2 = {
+		const TYPERT_REMOTE$3 = {
 			package: "@deepseek-ai/dsh-subagent",
 			descriptors: [
 				{
@@ -7384,6 +7437,26 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					"projections": record(intersection(string(), unknown()), object({
 						"asOfSeq": number().readonly(),
 						"values": intersection(object({
+							"inbox": object({
+								"next-turn": array(union([
+									literal(null),
+									string(),
+									number(),
+									literal(false),
+									literal(true),
+									array(lazy(() => JsonValueRemoteCodec$schema4)),
+									record(string(), lazy(() => JsonValueRemoteCodec$schema4))
+								])).readonly(),
+								"next-step": array(union([
+									literal(null),
+									string(),
+									number(),
+									literal(false),
+									literal(true),
+									array(lazy(() => JsonValueRemoteCodec$schema4)),
+									record(string(), lazy(() => JsonValueRemoteCodec$schema4))
+								])).readonly()
+							}).optional(),
 							"agentPreset": union([literal(null), string()]).optional(),
 							"title": union([literal(null), string()]).optional(),
 							"todos": union([literal(null), array(object({
@@ -7575,12 +7648,24 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 						record(string(), lazy(() => JsonValueRemoteCodec$schema3))
 					]).readonly(),
 					"ignorable": literal(true).readonly().optional(),
-					"sourceEventSeqs": array(number()).readonly().optional(),
-					"surfaceOp": union([literal("append"), object({
-						"op": literal("replace").readonly(),
-						"start": number().readonly(),
-						"end": number().readonly()
-					})]).readonly().optional()
+					"sourceEventSeqs": union([
+						literal(null),
+						string(),
+						number(),
+						literal(false),
+						literal(true),
+						array(lazy(() => JsonValueRemoteCodec$schema3)),
+						record(string(), lazy(() => JsonValueRemoteCodec$schema3))
+					]).readonly().optional(),
+					"surfaceOp": union([
+						literal(null),
+						string(),
+						number(),
+						literal(false),
+						literal(true),
+						array(lazy(() => JsonValueRemoteCodec$schema3)),
+						record(string(), lazy(() => JsonValueRemoteCodec$schema3))
+					]).readonly().optional()
 				}).readonly()
 			}),
 			object({
@@ -7613,18 +7698,50 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 							record(string(), lazy(() => JsonValueRemoteCodec$schema3))
 						]).readonly(),
 						"ignorable": literal(true).readonly().optional(),
-						"sourceEventSeqs": array(number()).readonly().optional(),
-						"surfaceOp": union([literal("append"), object({
-							"op": literal("replace").readonly(),
-							"start": number().readonly(),
-							"end": number().readonly()
-						})]).readonly().optional()
+						"sourceEventSeqs": union([
+							literal(null),
+							string(),
+							number(),
+							literal(false),
+							literal(true),
+							array(lazy(() => JsonValueRemoteCodec$schema3)),
+							record(string(), lazy(() => JsonValueRemoteCodec$schema3))
+						]).readonly().optional(),
+						"surfaceOp": union([
+							literal(null),
+							string(),
+							number(),
+							literal(false),
+							literal(true),
+							array(lazy(() => JsonValueRemoteCodec$schema3)),
+							record(string(), lazy(() => JsonValueRemoteCodec$schema3))
+						]).readonly().optional()
 					}).readonly()
 				})).readonly(),
 				"hasMore": boolean().readonly(),
 				"projections": object({
 					"asOfSeq": number().readonly(),
 					"values": intersection(object({
+						"inbox": object({
+							"next-turn": array(union([
+								literal(null),
+								string(),
+								number(),
+								literal(false),
+								literal(true),
+								array(lazy(() => JsonValueRemoteCodec$schema3)),
+								record(string(), lazy(() => JsonValueRemoteCodec$schema3))
+							])).readonly(),
+							"next-step": array(union([
+								literal(null),
+								string(),
+								number(),
+								literal(false),
+								literal(true),
+								array(lazy(() => JsonValueRemoteCodec$schema3)),
+								record(string(), lazy(() => JsonValueRemoteCodec$schema3))
+							])).readonly()
+						}).optional(),
 						"agentPreset": union([literal(null), string()]).optional(),
 						"title": union([literal(null), string()]).optional(),
 						"todos": union([literal(null), array(object({
@@ -7793,6 +7910,26 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"projections": object({
 				"asOfSeq": number().readonly(),
 				"values": intersection(object({
+					"inbox": object({
+						"next-turn": array(union([
+							literal(null),
+							string(),
+							number(),
+							literal(false),
+							literal(true),
+							array(lazy(() => JsonValueRemoteCodec$schema)),
+							record(string(), lazy(() => JsonValueRemoteCodec$schema))
+						])).readonly(),
+						"next-step": array(union([
+							literal(null),
+							string(),
+							number(),
+							literal(false),
+							literal(true),
+							array(lazy(() => JsonValueRemoteCodec$schema)),
+							record(string(), lazy(() => JsonValueRemoteCodec$schema))
+						])).readonly()
+					}).optional(),
 					"agentPreset": union([literal(null), string()]).optional(),
 					"title": union([literal(null), string()]).optional(),
 					"todos": union([literal(null), array(object({
@@ -7947,12 +8084,24 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 						record(string(), lazy(() => JsonValueRemoteCodec$schema2))
 					]).readonly(),
 					"ignorable": literal(true).readonly().optional(),
-					"sourceEventSeqs": array(number()).readonly().optional(),
-					"surfaceOp": union([literal("append"), object({
-						"op": literal("replace").readonly(),
-						"start": number().readonly(),
-						"end": number().readonly()
-					})]).readonly().optional()
+					"sourceEventSeqs": union([
+						literal(null),
+						string(),
+						number(),
+						literal(false),
+						literal(true),
+						array(lazy(() => JsonValueRemoteCodec$schema2)),
+						record(string(), lazy(() => JsonValueRemoteCodec$schema2))
+					]).readonly().optional(),
+					"surfaceOp": union([
+						literal(null),
+						string(),
+						number(),
+						literal(false),
+						literal(true),
+						array(lazy(() => JsonValueRemoteCodec$schema2)),
+						record(string(), lazy(() => JsonValueRemoteCodec$schema2))
+					]).readonly().optional()
 				}).readonly()
 			})).readonly(),
 			"hasMore": boolean().readonly()
@@ -8081,7 +8230,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"whenToUse": string().readonly().optional(),
 			"modelInvocable": boolean().readonly()
 		})).readonly() });
-		const TYPERT_REMOTE$1 = {
+		const TYPERT_REMOTE$2 = {
 			package: "@deepseek-ai/dsh-api-session-controller",
 			descriptors: [
 				{
@@ -8149,7 +8298,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 340,
+						"line": 342,
 						"column": 3
 					}
 				},
@@ -8176,7 +8325,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 360,
+						"line": 362,
 						"column": 3
 					}
 				},
@@ -8194,7 +8343,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 265,
+						"line": 267,
 						"column": 3
 					}
 				},
@@ -8214,7 +8363,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 393,
+						"line": 395,
 						"column": 3
 					}
 				},
@@ -8241,7 +8390,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 237,
+						"line": 239,
 						"column": 3
 					}
 				},
@@ -8270,7 +8419,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 383,
+						"line": 385,
 						"column": 3
 					}
 				},
@@ -8297,7 +8446,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 318,
+						"line": 320,
 						"column": 3
 					}
 				},
@@ -8325,7 +8474,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 216,
+						"line": 218,
 						"column": 9
 					}
 				},
@@ -8343,7 +8492,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 256,
+						"line": 258,
 						"column": 3
 					}
 				},
@@ -8371,7 +8520,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 277,
+						"line": 279,
 						"column": 9
 					}
 				},
@@ -8399,7 +8548,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 371,
+						"line": 373,
 						"column": 3
 					}
 				},
@@ -8427,7 +8576,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 329,
+						"line": 331,
 						"column": 3
 					}
 				},
@@ -8454,7 +8603,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 308,
+						"line": 310,
 						"column": 3
 					}
 				},
@@ -8482,7 +8631,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 227,
+						"line": 229,
 						"column": 3
 					}
 				},
@@ -8509,7 +8658,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 247,
+						"line": 249,
 						"column": 3
 					}
 				},
@@ -8536,7 +8685,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/api/session-controller/src/index.ts",
-						"line": 350,
+						"line": 352,
 						"column": 3
 					}
 				},
@@ -8677,7 +8826,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"createdAt": string().readonly(),
 			"updatedAt": string().readonly()
 		}).readonly() });
-		const TYPERT_REMOTE = {
+		const TYPERT_REMOTE$1 = {
 			package: "@deepseek-ai/dsh-api-workspace-controller",
 			descriptors: [
 				{
@@ -8949,6 +9098,303 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			]
 		};
 		//#endregion
+		//#region ../workspace-files/lib/typert.remote-client.js
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_changes_parameter_0$schema = intersection(string(), unknown());
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_changes_result$schema = union([object({ "kind": literal("ready").readonly() }), object({
+			"kind": literal("change").readonly(),
+			"change": union([object({
+				"absolutePath": string().readonly(),
+				"version": string().readonly()
+			}), object({
+				"absolutePath": string().readonly(),
+				"absent": literal(true).readonly()
+			})]).readonly()
+		})]);
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_list_parameter_0$schema = intersection(string(), unknown());
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_list_parameter_1$schema = string();
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_list_result$schema = object({
+			"path": string().readonly(),
+			"entries": array(object({
+				"name": string().readonly(),
+				"type": union([
+					literal("file"),
+					literal("directory"),
+					literal("other")
+				]).readonly(),
+				"size": number().readonly().optional()
+			})).readonly(),
+			"truncated": boolean().readonly()
+		});
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_read_parameter_0$schema = intersection(string(), unknown());
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_read_parameter_1$schema = string();
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_read_parameter_2$schema = object({
+			"offset": number().readonly().optional(),
+			"limit": number().readonly().optional()
+		});
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_read_result$schema = object({
+			"offset": number().readonly(),
+			"text": string().readonly(),
+			"lines": number().readonly(),
+			"eof": boolean().readonly(),
+			"absolutePath": string().readonly(),
+			"version": string().readonly(),
+			"bytes": number().readonly().optional()
+		});
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_readBytes_parameter_0$schema = intersection(string(), unknown());
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_readBytes_parameter_1$schema = string();
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_readBytes_parameter_2$schema = object({
+			"offset": number().readonly().optional(),
+			"length": number().readonly().optional()
+		});
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_readBytes_result$schema = object({
+			"offset": number().readonly(),
+			"data": string().readonly(),
+			"eof": boolean().readonly(),
+			"absolutePath": string().readonly(),
+			"version": string().readonly(),
+			"bytes": number().readonly().optional()
+		});
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_stat_parameter_0$schema = intersection(string(), unknown());
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_stat_parameter_1$schema = string();
+		const _deepseek_ai_dsh_api_workspace_files_workspaceFiles_stat_result$schema = object({
+			"absolutePath": string().readonly(),
+			"version": string().readonly(),
+			"bytes": number().readonly().optional()
+		});
+		const TYPERT_REMOTE = {
+			package: "@deepseek-ai/dsh-api-workspace-files",
+			descriptors: [
+				{
+					id: "@deepseek-ai/dsh-api-workspace-files#workspaceFiles/changes",
+					service: "workspaceFiles",
+					namespace: "workspaceFiles",
+					method: "changes",
+					mode: "stream",
+					invocation: { kind: "direct" },
+					scope: {
+						context: "agent",
+						wire: "agentId"
+					},
+					parameters: [{
+						name: "agent",
+						wire: "agentId",
+						source: "lookup",
+						lookup: "agent",
+						codec: {
+							mode: "strict",
+							typeSymbol: "@deepseek-ai/dsh-session/types#SessionId",
+							schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_changes_parameter_0$schema
+						}
+					}],
+					cancellation: { parameter: "signal" },
+					result: {
+						mode: "strict",
+						typeSymbol: "@deepseek-ai/dsh-api-workspace-files/types#WorkspaceFileWatchFrame",
+						schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_changes_result$schema
+					},
+					sourceLocation: {
+						"file": "packages/api/workspace-files/src/index.ts",
+						"line": 274,
+						"column": 3
+					}
+				},
+				{
+					id: "@deepseek-ai/dsh-api-workspace-files#workspaceFiles/list",
+					service: "workspaceFiles",
+					namespace: "workspaceFiles",
+					method: "list",
+					invocation: { kind: "direct" },
+					scope: {
+						context: "agent",
+						wire: "agentId"
+					},
+					parameters: [{
+						name: "agent",
+						wire: "agentId",
+						source: "lookup",
+						lookup: "agent",
+						codec: {
+							mode: "strict",
+							typeSymbol: "@deepseek-ai/dsh-session/types#SessionId",
+							schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_list_parameter_0$schema
+						}
+					}, {
+						name: "path",
+						wire: "path",
+						source: "json",
+						codec: {
+							mode: "strict",
+							typeSymbol: "@deepseek-ai/dsh-api-workspace-files#workspaceFiles/list:path",
+							schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_list_parameter_1$schema
+						}
+					}],
+					cancellation: { parameter: "signal" },
+					result: {
+						mode: "strict",
+						typeSymbol: "@deepseek-ai/dsh-api-workspace-files/types#WorkspaceDirectoryListing",
+						schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_list_result$schema
+					},
+					sourceLocation: {
+						"file": "packages/api/workspace-files/src/index.ts",
+						"line": 246,
+						"column": 9
+					}
+				},
+				{
+					id: "@deepseek-ai/dsh-api-workspace-files#workspaceFiles/read",
+					service: "workspaceFiles",
+					namespace: "workspaceFiles",
+					method: "read",
+					invocation: { kind: "direct" },
+					scope: {
+						context: "agent",
+						wire: "agentId"
+					},
+					parameters: [
+						{
+							name: "agent",
+							wire: "agentId",
+							source: "lookup",
+							lookup: "agent",
+							codec: {
+								mode: "strict",
+								typeSymbol: "@deepseek-ai/dsh-session/types#SessionId",
+								schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_read_parameter_0$schema
+							}
+						},
+						{
+							name: "path",
+							wire: "path",
+							source: "json",
+							codec: {
+								mode: "strict",
+								typeSymbol: "@deepseek-ai/dsh-api-workspace-files#workspaceFiles/read:path",
+								schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_read_parameter_1$schema
+							}
+						},
+						{
+							name: "range",
+							wire: "range",
+							source: "json",
+							codec: {
+								mode: "strict",
+								typeSymbol: "@deepseek-ai/dsh-api-workspace-files/types#WorkspaceFileRange",
+								schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_read_parameter_2$schema
+							}
+						}
+					],
+					cancellation: { parameter: "signal" },
+					result: {
+						mode: "strict",
+						typeSymbol: "@deepseek-ai/dsh-api-workspace-files/types#WorkspaceFileText",
+						schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_read_result$schema
+					},
+					sourceLocation: {
+						"file": "packages/api/workspace-files/src/index.ts",
+						"line": 197,
+						"column": 9
+					}
+				},
+				{
+					id: "@deepseek-ai/dsh-api-workspace-files#workspaceFiles/readBytes",
+					service: "workspaceFiles",
+					namespace: "workspaceFiles",
+					method: "readBytes",
+					invocation: { kind: "direct" },
+					scope: {
+						context: "agent",
+						wire: "agentId"
+					},
+					parameters: [
+						{
+							name: "agent",
+							wire: "agentId",
+							source: "lookup",
+							lookup: "agent",
+							codec: {
+								mode: "strict",
+								typeSymbol: "@deepseek-ai/dsh-session/types#SessionId",
+								schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_readBytes_parameter_0$schema
+							}
+						},
+						{
+							name: "path",
+							wire: "path",
+							source: "json",
+							codec: {
+								mode: "strict",
+								typeSymbol: "@deepseek-ai/dsh-api-workspace-files#workspaceFiles/readBytes:path",
+								schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_readBytes_parameter_1$schema
+							}
+						},
+						{
+							name: "range",
+							wire: "range",
+							source: "json",
+							codec: {
+								mode: "strict",
+								typeSymbol: "@deepseek-ai/dsh-api-workspace-files/types#WorkspaceByteRange",
+								schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_readBytes_parameter_2$schema
+							}
+						}
+					],
+					cancellation: { parameter: "signal" },
+					result: {
+						mode: "strict",
+						typeSymbol: "@deepseek-ai/dsh-api-workspace-files/types#WorkspaceFileBytes",
+						schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_readBytes_result$schema
+					},
+					sourceLocation: {
+						"file": "packages/api/workspace-files/src/index.ts",
+						"line": 217,
+						"column": 9
+					}
+				},
+				{
+					id: "@deepseek-ai/dsh-api-workspace-files#workspaceFiles/stat",
+					service: "workspaceFiles",
+					namespace: "workspaceFiles",
+					method: "stat",
+					invocation: { kind: "direct" },
+					scope: {
+						context: "agent",
+						wire: "agentId"
+					},
+					parameters: [{
+						name: "agent",
+						wire: "agentId",
+						source: "lookup",
+						lookup: "agent",
+						codec: {
+							mode: "strict",
+							typeSymbol: "@deepseek-ai/dsh-session/types#SessionId",
+							schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_stat_parameter_0$schema
+						}
+					}, {
+						name: "path",
+						wire: "path",
+						source: "json",
+						codec: {
+							mode: "strict",
+							typeSymbol: "@deepseek-ai/dsh-api-workspace-files#workspaceFiles/stat:path",
+							schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_stat_parameter_1$schema
+						}
+					}],
+					cancellation: { parameter: "signal" },
+					result: {
+						mode: "strict",
+						typeSymbol: "@deepseek-ai/dsh-api-workspace-files/types#WorkspaceFileStat",
+						schema: _deepseek_ai_dsh_api_workspace_files_workspaceFiles_stat_result$schema
+					},
+					sourceLocation: {
+						"file": "packages/api/workspace-files/src/index.ts",
+						"line": 233,
+						"column": 9
+					}
+				}
+			]
+		};
+		//#endregion
 		//#region lib/types/client/index.js
 		/** Platform-neutral assembly of generated Host Remote contributions. */
 		/** Required service: the typed Client Remote contribution mount. */
@@ -8962,6 +9408,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			const disposers = [];
 			try {
 				for (const contribution of [
+					TYPERT_REMOTE$13,
 					TYPERT_REMOTE$12,
 					TYPERT_REMOTE$11,
 					TYPERT_REMOTE$10,

package/lib/index.js

@@ -51,6 +51,10 @@ const API_REMOTE_FORWARDED_EVENTS = [
 		event: "credentials/reference-updated",
 		mode: "emit"
 	},
+	{
+		event: "goal/activation-changed",
+		mode: "emit"
+	},
 	{
 		event: "cordis/request-run",
 		mode: "emit"
@@ -109,13 +113,14 @@ function remoteEventSource(ctx) {
 				});
 			}));
 			return ctx.on(event, (function(request, next) {
-				const subject = carrierKeyOf(this);
-				if (subject === void 0) return next();
-				const value = Reflect.get(subject, "ctx");
-				if (typeof value !== "object" || value === null) throw new TypeError(`forwarded scoped event ${JSON.stringify(event)} has no live Context`);
+				const carrierAgent = carrierKeyOf(this);
+				if (carrierAgent === void 0) return next();
+				const agent = request.agent;
+				if (agent === void 0 || agent !== carrierAgent) throw new TypeError(`forwarded scoped event ${JSON.stringify(event)} must carry its Agent directly`);
 				return forwardWaterfall(queue, event, request, {
-					value,
-					subject
+					value: agent.ctx,
+					subject: agent,
+					agentId: agent.id
 				}, next);
 			}));
 		});

package/lib/types/client/index.d.ts

@@ -18,6 +18,8 @@ export type {} from '@deepseek-ai/dsh-api-session-controller/remote';
 export type * from '@deepseek-ai/dsh-api-session-controller/types';
 export type {} from '@deepseek-ai/dsh-api-workspace-controller/remote';
 export type * from '@deepseek-ai/dsh-api-workspace-controller/types';
+export type {} from '@deepseek-ai/dsh-api-workspace-files/remote';
+export type * from '@deepseek-ai/dsh-api-workspace-files/types';
 export type { SessionJob as JobView } from '@deepseek-ai/dsh-api-session-controller/types';
 export type { ApiRemoteForwardedEvent } from '../types.ts';
 export type {} from '@deepseek-ai/dsh-commands/types';

package/lib/types/client/index.js

@@ -12,6 +12,7 @@ import sessionReferencesRemote from '@deepseek-ai/dsh-session-reference/remote';
 import subagentsRemote from '@deepseek-ai/dsh-subagent/remote';
 import sessionRemote from '@deepseek-ai/dsh-api-session-controller/remote';
 import workspaceRemote from '@deepseek-ai/dsh-api-workspace-controller/remote';
+import workspaceFilesRemote from '@deepseek-ai/dsh-api-workspace-files/remote';
 /** Required service: the typed Client Remote contribution mount. */
 export const inject = ['remote'];
 /**
@@ -25,7 +26,7 @@ export async function apply(ctx) {
         for (const contribution of [
             agentPresetsRemote, commandsRemote, settingsControllerRemote, goalsRemote, llmRemote, dynamicRemote,
             pluginInventoryRemote, messageFeedbackRemote, fileUploadsRemote, sessionReferencesRemote,
-            subagentsRemote, sessionRemote, workspaceRemote,
+            subagentsRemote, sessionRemote, workspaceRemote, workspaceFilesRemote,
         ]) {
             disposers.push(await ctx.remote.$mount(contribution));
         }

package/lib/types/index.js

@@ -22,14 +22,14 @@ function remoteEventSource(ctx) {
                 }));
             }
             return ctx.on(event, (function (request, next) {
-                const subject = carrierKeyOf(this);
-                if (subject === undefined)
+                const carrierAgent = carrierKeyOf(this);
+                if (carrierAgent === undefined)
                     return next();
-                const value = Reflect.get(subject, 'ctx');
-                if (typeof value !== 'object' || value === null) {
-                    throw new TypeError(`forwarded scoped event ${JSON.stringify(event)} has no live Context`);
+                const agent = request.agent;
+                if (agent === undefined || agent !== carrierAgent) {
+                    throw new TypeError(`forwarded scoped event ${JSON.stringify(event)} must carry its Agent directly`);
                 }
-                return forwardWaterfall(queue, event, request, { value: value, subject }, next);
+                return forwardWaterfall(queue, event, request, { value: agent.ctx, subject: agent, agentId: agent.id }, next);
             }));
         });
         return queue.iterate(signal, () => {

package/lib/types/remote-events.d.ts

@@ -36,6 +36,9 @@ export declare const API_REMOTE_FORWARDED_EVENTS: readonly [{
 }, {
     readonly event: "credentials/reference-updated";
     readonly mode: "emit";
+}, {
+    readonly event: "goal/activation-changed";
+    readonly mode: "emit";
 }, {
     readonly event: "cordis/request-run";
     readonly mode: "emit";

package/lib/types/remote-events.js

@@ -19,6 +19,7 @@ export const API_REMOTE_FORWARDED_EVENTS = [
     { event: 'api-session/status', mode: 'emit' },
     { event: 'commands/change', mode: 'emit' },
     { event: 'credentials/reference-updated', mode: 'emit' },
+    { event: 'goal/activation-changed', mode: 'emit' },
     { event: 'cordis/request-run', mode: 'emit' },
     { event: 'cordis/request-run-resolved', mode: 'emit' },
     { event: 'cordis/dynamic-package', mode: 'emit' },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-api-remotes",
   "description": "Remote BFF assembly for application-selected Host capabilities",
-  "version": "0.1.3-alpha.2",
+  "version": "0.1.5-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -46,39 +46,41 @@
     "lib/types/**/*.d.ts"
   ],
   "dependencies": {
-    "@deepseek-ai/dsh-session": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-util-values": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-deque": "^0.1.3-alpha.2"
+    "@deepseek-ai/dsh-deque": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-util-values": "^0.1.5-alpha.1"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-scope": "^0.1.3-alpha.2"
+    "@deepseek-ai/dsh-scope": "^0.1.5-alpha.1"
   },
   "devDependencies": {
     "zod": "^4.4.3",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-api-gateway": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-api-settings-controller": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-commands": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-cordis-host-runner": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-credentials": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-file-reference": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-host-plugin-inventory": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-message-feedback": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-session-reference": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-subagent": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-user-approval": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-user-questions": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-goal": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-scope": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-file-upload": "^0.1.3-alpha.2"
+    "@deepseek-ai/dsh-agent": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-api-gateway": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-api-settings-controller": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-commands": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-cordis-host-runner": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-credentials": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-file-reference": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-goal": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-host-plugin-inventory": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-message-feedback": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session-reference": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-settings": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-user-questions": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-file-upload": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-scope": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-api-workspace-files": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-user-approval": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-subagent": "^0.1.5-alpha.1"
   },
   "scripts": {
     "bundle": "tsdown",