@deepseek-ai/dsh-cordis-client-runner 0.2.0-rc.2 → 0.2.1-alpha.1

package/README.i18n.yaml

@@ -75,5 +75,5 @@
   en: a728aeb4aa18db7d
   zh: b596309cd6707da7
 /deepseek-ai-dsh-cordis-client-runner/known-limitations-and-deferred-work/dev-note:
-  en: c4cff307d238c93a
-  zh: d1a9ff4164056741
+  en: e67f633dc6fe7773
+  zh: 3bb0c20c93f16f98

package/README.md

@@ -143,5 +143,3 @@ These limits define where the browser half needs special care. They are current
 None.
 
 </details>
-
-**Runtime invariant:** No companion is published. The owned relation (a live Plugin's loader entry exists exactly while one Plugin Run ID is live) is browser-only state reachable through the client half's service, which the node-plane companion cannot observe. The relation is asserted by the package's own load/teardown coverage instead.

package/README.zh.md

@@ -143,5 +143,3 @@ React 可能在加载成功后失败。Client 报告其拥有的每个 entry 失
 无。
 
 </details>
-
-**运行时不变式：** 不发布伴生入口。所属关系（一个 live Plugin 的 loader entry 仅在一个 Plugin Run ID 存活期间存在）是只能通过 Client 半服务访问的浏览器侧状态，Node 平面的伴生入口无法观察。该关系改由本包自己的装载与拆除测试直接断言。

package/lib/client.js

@@ -1530,11 +1530,14 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 						returns: "a Session already addressable through the Session Controller."
 					},
 					{
-						signature: "startSession(workspaceId?: WorkspaceId): void",
+						signature: "startSession(workspaceId?: WorkspaceId, options?: StartSessionOptions): void",
 						description: "Start a New Session flow and navigate to its Session; a creation the Host refuses is shown through the Workspace notice and leaves the selection as it was.",
 						parameters: [{
 							name: "workspaceId",
 							description: "explicit target; absent inherits the current or most recent Workspace."
+						}, {
+							name: "options",
+							description: "initial content; existing text or attachments are preserved unless clearPreviousDraft is true."
 						}]
 					},
 					{
@@ -1814,6 +1817,10 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				name: "ConnectionStateSource",
 				declaration: "export interface ConnectionStateSource {\n    getSnapshot(): ConnectionState | undefined;\n    subscribe(listener: () => void): () => void;\n}"
 			},
+			{
+				name: "DraftInitializationOptions",
+				declaration: "export interface DraftInitializationOptions {\n    readonly prompt?: string;\n    readonly clearPreviousDraft?: boolean;\n}"
+			},
 			{
 				name: "EntryKeyOf",
 				declaration: "export type EntryKeyOf<K extends keyof SlotMap & string> = SlotMap[K] extends {\n    kind: 'keyed';\n    keyProps: infer P extends object;\n} ? keyof P & string : string;"
@@ -2202,6 +2209,10 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				name: "SnapshotSelectorHook",
 				declaration: "export type SnapshotSelectorHook<T> = <S>(sel: (s: T) => S, eq?: (a: S, b: S) => boolean) => S;"
 			},
+			{
+				name: "StartSessionOptions",
+				declaration: "export type StartSessionOptions = DraftInitializationOptions;"
+			},
 			{
 				name: "StoreDecl",
 				declaration: "export type StoreDecl = StoreHandle<any, any> | StoreFactory;"
@@ -2749,7 +2760,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				hookContext: "",
 				slotInject: "",
 				declaredBy: "an entry in 'conversation.composer.bar' (client-ui-conversation), so it exists while that entry is mounted",
-				occupants: ["client-ui-chat StatsPills id 'stats'"],
+				occupants: ["client-ui-chat ActivityPill id 'activity'", "client-ui-chat UsagePill id 'usage'"],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.composer.dock', () => ctx.slots.register(\n      { name: 'conversation.composer.dock', id: 'my-entry', order: 100, label: 'My entry' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
 				source: "packages/client/ui-conversation/src/client/contract/slots.ts:199"
@@ -3052,7 +3063,8 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: [
 					"client-ui-conversation QueueDock id 'queue'",
 					"client-ui-conversation TodoDock id 'todo'",
-					"client-ui-goal GoalDock id 'goal'"
+					"client-ui-goal GoalDock id 'goal'",
+					"experimental-client-ui-claude-code-mods Band id 'claude-code-mods'"
 				],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.input.dock', () => ctx.slots.register(\n      { name: 'conversation.input.dock', id: 'my-entry', order: 100, label: 'My entry' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
@@ -3949,6 +3961,52 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('main.conversation', () => ctx.slots.register(\n      { name: 'main.conversation' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
 				source: "packages/client/ui-conversation/src/client/contract/slots.ts:131"
 			},
+			{
+				key: "plugins.add.actions",
+				kind: "list",
+				scope: "root",
+				summary: "Additional MenuItemButton rows after installation: 72px high, with a title and a description capped at two lines.",
+				doc: "Additional MenuItemButton rows after installation: 72px high, with a title and a description capped at two lines.",
+				registerOptions: [
+					{
+						name: "id",
+						requirement: "required",
+						type: "string",
+						doc: "Your cell key. Use an id of your own: a fresh id is added beside the shipped entries, while reusing a shipped id puts you in THAT cell and replaces it. Owners that filter by id address you by it."
+					},
+					{
+						name: "order",
+						requirement: "optional",
+						type: "number",
+						doc: "Position among the entries, ascending (default 0)."
+					},
+					{
+						name: "label",
+						requirement: "optional",
+						type: "string | (() => string)",
+						doc: "Display text where the owner projects one (nav rows, tabs). A thunk is re-read on every projection, so localized text follows the active locale without re-registering."
+					}
+				],
+				ownerProps: ["/** Add-plugin menu actions, independent of any selected bundle or Session. */\nexport interface PluginAddActionsProps {\n  /** Close the add-plugin menu before starting the contributed action. */\n  readonly onDismiss: () => void\n}"],
+				ownerPropsReferences: [],
+				standardProps: [
+					"useResource: UseResource",
+					"useWorkspaces: SnapshotSelectorHook<WorkspaceSnapshot>",
+					"usePanelInfo: UsePanelInfo",
+					"useSessions: UseSessions",
+					"useSessionStatus: UseSessionStatus",
+					"useSessionRetainInfo: UseSessionRetainInfo",
+					"useWorkspaces: SnapshotSelectorHook<WorkspaceSnapshot>"
+				],
+				keyDomain: "",
+				hookContext: "",
+				slotInject: "",
+				declaredBy: "an entry in 'main' (client-ui-plugin-manager), so it exists while that entry is mounted",
+				occupants: ["client-ui-agent-preset CreatePluginMenuItem id 'create-plugin'"],
+				replaceRisk: "none",
+				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('plugins.add.actions', () => ctx.slots.register(\n      { name: 'plugins.add.actions', id: 'my-entry', order: 100, label: 'My entry' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
+				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:84"
+			},
 			{
 				key: "plugins.bundle.activation",
 				kind: "keyed",
@@ -3979,7 +4037,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["experimental-client-ui-voice-input VoiceSetupPrompt key '@deepseek-ai/dsh-experimental-voice-input-bundle'"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('plugins.bundle.activation', () => ctx.slots.register(\n      { name: 'plugins.bundle.activation', key: '<one key the owner dispatches>' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:78"
+				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:86"
 			},
 			{
 				key: "plugins.bundle.config",
@@ -4011,7 +4069,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["experimental-client-ui-voice-input VoicePreparation key '@deepseek-ai/dsh-experimental-voice-input-bundle'"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('plugins.bundle.config', () => ctx.slots.register(\n      { name: 'plugins.bundle.config', key: '<one key the owner dispatches>' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:94"
+				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:102"
 			},
 			{
 				key: "plugins.detail.actions",
@@ -4057,7 +4115,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: [],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('plugins.detail.actions', () => ctx.slots.register(\n      { name: 'plugins.detail.actions', id: 'my-entry', order: 100, label: 'My entry' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:108"
+				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:116"
 			},
 			{
 				key: "plugins.detail.badge",
@@ -4103,7 +4161,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: [],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('plugins.detail.badge', () => ctx.slots.register(\n      { name: 'plugins.detail.badge', id: 'my-entry', order: 100, label: 'My entry' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:113"
+				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:121"
 			},
 			{
 				key: "plugins.detail.section",
@@ -4149,7 +4207,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: [],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('plugins.detail.section', () => ctx.slots.register(\n      { name: 'plugins.detail.section', id: 'my-entry', order: 100, label: 'My entry' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:120"
+				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:128"
 			},
 			{
 				key: "plugins.item",
@@ -4200,7 +4258,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('plugins.item', () => ctx.slots.register(\n      { name: 'plugins.item', id: 'my-entry', order: 100, label: 'My entry' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:88"
+				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:96"
 			},
 			{
 				key: "plugins.row.config",
@@ -4232,7 +4290,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: [],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('plugins.row.config', () => ctx.slots.register(\n      { name: 'plugins.row.config', key: '<one key the owner dispatches>' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:102"
+				source: "packages/client/ui-plugin-manager/src/client/slot-contract.ts:110"
 			},
 			{
 				key: "rightbar",
@@ -4785,6 +4843,33 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('settings.trigger', () => ctx.slots.register(\n      { name: 'settings.trigger' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
 				source: "packages/client/ui-settings/src/client/contract/slots.ts:27"
 			},
+			{
+				key: "shell.bottom",
+				kind: "single",
+				scope: "root",
+				summary: "Full-width bottom content below all three columns.",
+				doc: "Full-width bottom content below all three columns. Its rendered height\nreduces the columns' available height; empty content reserves no space.\nThe occupant owns its height, visibility, and controls. It receives no\nSession binding and remains mounted across main-panel navigation.",
+				registerOptions: [],
+				ownerProps: [],
+				ownerPropsReferences: [],
+				standardProps: [
+					"useResource: UseResource",
+					"useWorkspaces: SnapshotSelectorHook<WorkspaceSnapshot>",
+					"usePanelInfo: UsePanelInfo",
+					"useSessions: UseSessions",
+					"useSessionStatus: UseSessionStatus",
+					"useSessionRetainInfo: UseSessionRetainInfo",
+					"useWorkspaces: SnapshotSelectorHook<WorkspaceSnapshot>"
+				],
+				keyDomain: "",
+				hookContext: "",
+				slotInject: "",
+				declaredBy: "an entry in 'root' (client-ui-layout), so it exists while that entry is mounted",
+				occupants: ["experimental-inspector InspectorPage"],
+				replaceRisk: "shadows-shipped-ui",
+				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('shell.bottom', () => ctx.slots.register(\n      { name: 'shell.bottom' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
+				source: "packages/client/ui-layout/src/client/index.ts:94"
+			},
 			{
 				key: "shell.leading",
 				kind: "single",
@@ -4810,7 +4895,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-sidebar HeaderLeadingControls"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('shell.leading', () => ctx.slots.register(\n      { name: 'shell.leading' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-layout/src/client/index.ts:112"
+				source: "packages/client/ui-layout/src/client/index.ts:119"
 			},
 			{
 				key: "shell.overlay",
@@ -4867,7 +4952,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('shell.overlay', () => ctx.slots.register(\n      { name: 'shell.overlay', id: 'my-entry', order: 100, label: 'My entry' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-layout/src/client/index.ts:98"
+				source: "packages/client/ui-layout/src/client/index.ts:105"
 			},
 			{
 				key: "shell.quota-notice",
@@ -5153,7 +5238,8 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 					"client-ui-sidebar-files FilesBody",
 					"client-ui-sidebar-right GuideBody",
 					"client-ui-sidebar-terminal LazyTerminalBody",
-					"client-ui-subagent SidebarChatTab"
+					"client-ui-subagent SidebarChatTab",
+					"experimental-session-inspector SessionInspectorView"
 				],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('sidebar.right.pane.tab', () => ctx.slots.register(\n      { name: 'sidebar.right.pane.tab', key: '<one key the owner dispatches>' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
@@ -5962,14 +6048,14 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-attachment MessageImages"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('tool.call.images', () => ctx.slots.register(\n      { name: 'tool.call.images' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-tool/src/client/contract/slots.ts:46"
+				source: "packages/client/ui-tool/src/client/contract/slots.ts:44"
 			},
 			{
 				key: "tool.call.toolview",
 				kind: "keyed",
 				scope: "session",
 				summary: "Keyed Tool call view dispatched by wire Tool name.",
-				doc: "Keyed Tool call view dispatched by wire Tool name. Any name is allowed,\nincluding tools registered by your package. Register with\n`key: '<tool name>'`; a typo never renders.\n\nRegistering an occupied key replaces its view; unclaimed keys use the\ngeneric row. The owner supplies the call identity and frozen running\nor settled node through explicit phase props. Preparing blocks have no dispatched\narguments; useToolCallArgumentsPartial optionally subscribes to their raw prefix.",
+				doc: "Keyed Tool call view dispatched by wire Tool name. Any name is allowed,\nincluding tools registered by your package. Register with\n`key: '<tool name>'`; a typo never renders.\n\nRegistering an occupied key replaces its view; unclaimed keys use the\ngeneric row. The owner supplies the call identity and running\nor settled node through explicit phase props. Every stage supplies\n`name` and a lazy `args` view; preparing arguments may be incomplete.",
 				registerOptions: [{
 					name: "key",
 					requirement: "required",
@@ -6007,8 +6093,8 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 					"useTrajectory: UseTrajectory"
 				],
 				keyDomain: "open: any string the owner dispatches (no compile-time key set), already taken: ask_user_question, bash, cordis_define, cordis_inspect_list, cordis_inspect_query, cordis_inspect_self, cordis_run, cordis_stop, cordis_undefine, create_goal, edit, get_goal, glob, grep, interrupt_agent, job_kill, job_list, job_output, list_agents, list_subagent_models, lsp, present, ralph, read, read_image, schedule_create, schedule_delete, schedule_list, schedule_update, send_message, session_event_read, session_event_search, session_event_trace, session_search, session_trace, skill, spawn_teammate, subagent, team_task_create, team_task_get, team_task_list, team_task_update, terminal_close, terminal_list, terminal_open, terminal_read, terminal_signal, todo_write, update_goal, wait_agent, web_fetch, web_search, workflow, write",
-				hookContext: "ToolCallHookContext",
-				slotInject: "ToolCallInjected",
+				hookContext: "",
+				slotInject: "",
 				declaredBy: "an entry in 'conversation.chat.node' (client-ui-tool), so it exists while that entry is mounted",
 				occupants: [
 					"client-ui-deliverables PresentRow key 'present'",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-cordis-client-runner",
   "description": "Browser half of dynamic dual-half plugin packages: event subscription, closure evaluation, guard facade, and loader entries",
-  "version": "0.2.0-rc.2",
+  "version": "0.2.1-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -38,18 +38,18 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
-    "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
-    "@deepseek-ai/dsh-client-modules": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-api-remotes": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.2",
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-client-ui-theme": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-util-values": "0.2.0-rc.2"
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
+    "@deepseek-ai/dsh-api-remotes": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-modules": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-alpha.1",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-theme": "0.2.1-alpha.1"
   },
   "files": [
     "lib/index.js",