@nomix-ai/nomix-harness 0.2.5 → 0.2.6

package/dist/kernel/cordis-client-runner/lib/client.js

@@ -1137,7 +1137,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 			{
 				key: "locale",
 				summary: "Dictionary registry plus locale preference.",
-				description: "Dictionary registry plus locale preference. Lookup chain per key: the entry's namespace in the active locale -> that namespace's zh fallback -> the shared common namespace (active, then zh) -> the key itself (missing text stays visible, fail loud in the UI rather than blank). Reads go through getLocale; writes only through setLocale; continuous sync through the `locale/change` event, or through the LocaleFace getSnapshot/subscribe pair the render machinery consumes (installed via `ctx.slots.installLocale`).",
+				description: "Dictionary registry plus locale preference. Lookup chain per key: the entry's namespace in the active locale -> that namespace's en fallback -> the shared common namespace (active, then en) -> the key itself (missing text stays visible, fail loud in the UI rather than blank). Reads go through getLocale; writes only through setLocale; continuous sync through the `locale/change` event, or through the LocaleFace getSnapshot/subscribe pair the render machinery consumes (installed via `ctx.slots.installLocale`).",
 				methods: [
 					{
 						signature: "getLocale(): LocaleSnapshot",
@@ -1162,7 +1162,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 					},
 					{
 						signature: "setLocale(id: string): void",
-						description: "Switch the active locale — the only user preference write entry.",
+						description: "Switch the active locale — the only user preference write entry.\n\nThe durable write happens even when the id already matches the active locale, because the active value may be a provisional browser-derived or fallback resolution that nothing has stored yet. Picking the language already on screen is still an explicit choice, and it must survive a different browser sharing the same NOMIX home. Only the render notification is conditional: republishing an unchanged locale would churn every subscriber for nothing.",
 						parameters: [{
 							name: "id",
 							description: "a registered locale id; unknown ids throw."
@@ -1734,7 +1734,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 			},
 			{
 				name: "ISession",
-				declaration: "export interface ISession {\n    readonly sessionId: SessionId;\n    readonly projections: ProjectionsFace;\n    prompt(content: PromptContentPart[], mode: 'queue' | 'steer'): Promise<RpcResult<{\n        accepted: true;\n    }>>;\n    readAttachment(attachmentId: AttachmentIdType): Promise<RpcResult<{\n        attachment: ImageAttachmentRef;\n        data: Uint8Array;\n    }>>;\n    updateQueue(itemId: MessageId, action: QueueAction): Promise<RpcResult<{\n        accepted: true;\n    }>>;\n    cancel(): Promise<RpcResult<{\n        accepted: true;\n    }>>;\n    rename(title: string): Promise<RpcResult<{\n        title: string;\n        seq: number;\n    }>>;\n    loadOlder(): Promise<void>;\n    command(line: string): Promise<RemoteResult<{\n        matched: boolean;\n    }>>;\n}"
+				declaration: "export interface ISession {\n    readonly sessionId: SessionId;\n    readonly projections: ProjectionsFace;\n    prompt(content: PromptContentPart[], mode: 'queue' | 'steer', signal?: AbortSignal): Promise<RpcResult<{\n        accepted: true;\n    }>>;\n    readAttachment(attachmentId: AttachmentIdType): Promise<RpcResult<{\n        attachment: ImageAttachmentRef;\n        data: Uint8Array;\n    }>>;\n    updateQueue(itemId: MessageId, action: QueueAction): Promise<RpcResult<{\n        accepted: true;\n    }>>;\n    cancel(): Promise<RpcResult<{\n        accepted: true;\n    }>>;\n    rename(title: string): Promise<RpcResult<{\n        title: string;\n        seq: number;\n    }>>;\n    loadOlder(): Promise<void>;\n    command(line: string): Promise<RemoteResult<{\n        matched: boolean;\n    }>>;\n}"
 			},
 			{
 				name: "KeyPropsOf",
@@ -2190,7 +2190,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-message-feedback MessageFeedbackActions id 'feedback'"],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.chat.assistant-actions', () => ctx.slots.register(\n      { name: 'conversation.chat.assistant-actions', 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:109"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:148"
 			},
 			{
 				key: "conversation.chat.commandview",
@@ -2222,7 +2222,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('conversation.chat.commandview', () => ctx.slots.register(\n      { name: 'conversation.chat.commandview', key: '<one key the owner dispatches>' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-conversation/src/client/contract/slots.ts:94"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:133"
 			},
 			{
 				key: "conversation.chat.node",
@@ -2236,10 +2236,10 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 					type: "string",
 					doc: "Your cell key: the entry renders where the owner dispatches this exact key. Registering an already-occupied key replaces that occupant."
 				}],
-				ownerProps: ["/** Stable owner currency delivered to one keyed Chat business renderer. */\nexport interface ChatNodeOwnerProps {\n  /** Selected Tool call, when the shared details store names one. */\n  selectedCallId?: CallId | undefined\n  /** Session workspace root; Tool summaries display paths relative to it. */\n  cwd?: string | undefined\n  openFile: (path: string) => void\n  inspectCall: (callId: CallId) => void\n  forkAt: (seq: number) => void\n  /** Resolve a session-authorized historical image for inline display. */\n  loadImage: (attachment: ImageAttachmentRef) => Promise<string>\n  fileMentions: (owner: TurnTailOwnerProps) => MarkdownFileMentions | undefined\n}"],
+				ownerProps: ["/** Stable owner currency delivered to one keyed Chat business renderer. */\nexport interface ChatNodeOwnerProps {\n  /** Selected Tool call, when the shared details store names one. */\n  selectedCallId?: CallId | undefined\n  /** Session workspace root; Tool summaries display paths relative to it. */\n  cwd?: string | undefined\n  openFile: (path: string) => void\n  inspectCall: (callId: CallId) => void\n  forkAt: (seq: number) => void\n  /** Render a historical image group through the attachment slot. */\n  renderMessageImages: RenderMessageImages\n  fileMentions: (owner: TurnTailOwnerProps) => MarkdownFileMentions | undefined\n}"],
 				ownerPropsReferences: [
-					"ImageAttachmentRef",
 					"MarkdownFileMentions",
+					"RenderMessageImages",
 					"TurnTailOwnerProps"
 				],
 				standardProps: [
@@ -2274,7 +2274,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.chat.node', () => ctx.slots.register(\n      { name: 'conversation.chat.node', key: '<one key the owner dispatches>' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-conversation/src/client/contract/slots.ts:78"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:115"
 			},
 			{
 				key: "conversation.chat.turnTail",
@@ -2306,7 +2306,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-deliverables ProducedFiles"],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.chat.turnTail', () => ctx.slots.register(\n      { name: 'conversation.chat.turnTail', select: owner => null },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-conversation/src/client/contract/slots.ts:101"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:140"
 			},
 			{
 				key: "conversation.composer",
@@ -2342,7 +2342,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('conversation.composer', () => ctx.slots.register(\n      { name: 'conversation.composer', select: owner => null },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-conversation/src/client/contract/slots.ts:132"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:171"
 			},
 			{
 				key: "conversation.composer.bar",
@@ -2369,7 +2369,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-conversation InputBar"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.composer.bar', () => ctx.slots.register(\n      { name: 'conversation.composer.bar' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-conversation/src/client/contract/slots.ts:201"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:245"
 			},
 			{
 				key: "conversation.composer.dock",
@@ -2415,7 +2415,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-conversation StatsLine id 'stats'"],
 				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:170"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:214"
 			},
 			{
 				key: "conversation.details.tool",
@@ -2442,7 +2442,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-tool ToolDetails"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.details.tool', () => ctx.slots.register(\n      { name: 'conversation.details.tool' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-conversation/src/client/contract/slots.ts:124"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:163"
 			},
 			{
 				key: "conversation.hero.agentPreset",
@@ -2461,7 +2461,26 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-agent-preset AgentPresetSeat"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.hero.agentPreset', () => ctx.slots.register(\n      { name: 'conversation.hero.agentPreset' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-conversation/src/client/contract/slots.ts:145"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:189"
+			},
+			{
+				key: "conversation.hero.brand.mark",
+				kind: "single",
+				scope: "root",
+				summary: "Brand mark leading the blank-session headline.",
+				doc: "Brand mark leading the blank-session headline. Declared by this\npackage's `conversation` entry; the shell supplies a fish fallback.",
+				registerOptions: [],
+				ownerProps: ["/** Presentation props supplied to the blank-session brand-mark occupant. */\nexport interface HeroBrandMarkOwnerProps {\n  /** Requested square edge in pixels. */\n  size: number\n  /** Host CSS class for preserving the default hero mark color and hover motion. */\n  className?: string | undefined\n}"],
+				ownerPropsReferences: [],
+				standardProps: ["useSessions: SnapshotSelectorHook<SessionListState>", "useWorkspaces: SnapshotSelectorHook<import('./workspaces/service.ts').WorkspaceListState>"],
+				keyDomain: "",
+				hookContext: "",
+				slotInject: "",
+				declaredBy: "an entry in 'conversation' (client-ui-conversation), so it exists while that entry is mounted",
+				occupants: ["client-ui-brand-official OfficialBrandMark"],
+				replaceRisk: "shadows-shipped-ui",
+				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.hero.brand.mark', () => ctx.slots.register(\n      { name: 'conversation.hero.brand.mark' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:183"
 			},
 			{
 				key: "conversation.hero.workspace",
@@ -2480,7 +2499,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-workspace WorkspacePicker"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.hero.workspace', () => ctx.slots.register(\n      { name: 'conversation.hero.workspace' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-conversation/src/client/contract/slots.ts:139"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:178"
 			},
 			{
 				key: "conversation.hero.workspace.directoryFlow",
@@ -2499,7 +2518,34 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-directory-picker-browse BrowseDirectoryFlow", "client-ui-directory-picker-native NativeDirectoryFlow"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.hero.workspace.directoryFlow', () => ctx.slots.register(\n      { name: 'conversation.hero.workspace.directoryFlow' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-workspace/src/client/contract/slots.ts:56"
+				source: "packages/client/ui-workspace/src/client/contract/slots.ts:57"
+			},
+			{
+				key: "conversation.input.attachments",
+				kind: "single",
+				scope: "session-maybe",
+				summary: "Optional draft-image rail, drop target, and preview surface inside the composer.",
+				doc: "Optional draft-image rail, drop target, and preview surface inside the composer.",
+				registerOptions: [],
+				ownerProps: ["/** Input state handed to the optional attachment presentation plugin. */\nexport interface ComposerAttachmentsOwnerProps {\n  /** Browser-owned draft images in input order. */\n  attachments: readonly ComposerAttachment[]\n  /** Whether a document-level file drop may add images now. */\n  canAcceptDrop: boolean\n  /** Add one dropped batch through the composer's validation path. */\n  onAddImages: (files: readonly File[]) => void\n  /** Remove one draft image through the conversation service. */\n  onRemoveImage: (id: DraftAttachmentId) => void\n  /** Display-ready limits for the drop invitation. */\n  dropLimits?: { readonly count: number; readonly size: string } | undefined\n}"],
+				ownerPropsReferences: ["ComposerAttachment", "DraftAttachmentId"],
+				standardProps: [
+					"useSessions: SnapshotSelectorHook<SessionListState>",
+					"useWorkspaces: SnapshotSelectorHook<import('./workspaces/service.ts').WorkspaceListState>",
+					"useSession: MaybeSnapshotSelectorHook<ConversationSnapshot>",
+					"sessionId: SessionId | undefined",
+					"useProjection: UseProjection",
+					"useInput: MaybeSnapshotSelectorHook<InputState>",
+					"inputActions: InputActions | undefined"
+				],
+				keyDomain: "",
+				hookContext: "",
+				slotInject: "",
+				declaredBy: "an entry in 'conversation.composer.bar' (client-ui-conversation), so it exists while that entry is mounted",
+				occupants: ["client-ui-attachment ComposerAttachments"],
+				replaceRisk: "shadows-shipped-ui",
+				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.input.attachments', () => ctx.slots.register(\n      { name: 'conversation.input.attachments' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:247"
 			},
 			{
 				key: "conversation.input.dock",
@@ -2549,7 +2595,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('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}",
-				source: "packages/client/ui-conversation/src/client/contract/slots.ts:161"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:205"
 			},
 			{
 				key: "conversation.input.left",
@@ -2595,7 +2641,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('conversation.input.left', () => ctx.slots.register(\n      { name: 'conversation.input.left', 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:179"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:223"
 			},
 			{
 				key: "conversation.input.model",
@@ -2622,7 +2668,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-model-selection ModelSelect"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.input.model', () => ctx.slots.register(\n      { name: 'conversation.input.model' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-conversation/src/client/contract/slots.ts:221"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:271"
 			},
 			{
 				key: "conversation.input.overlay",
@@ -2695,7 +2741,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-plan PlanChip"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.input.plan', () => ctx.slots.register(\n      { name: 'conversation.input.plan' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-conversation/src/client/contract/slots.ts:211"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:261"
 			},
 			{
 				key: "conversation.input.right",
@@ -2741,7 +2787,34 @@ 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('conversation.input.right', () => ctx.slots.register(\n      { name: 'conversation.input.right', 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:187"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:231"
+			},
+			{
+				key: "conversation.message.images",
+				kind: "single",
+				scope: "session",
+				summary: "Optional renderer for one consecutive group of durable message images.",
+				doc: "Optional renderer for one consecutive group of durable message images.",
+				registerOptions: [],
+				ownerProps: ["/** Historical image group handed to the optional attachment presentation plugin. */\nexport interface MessageImagesOwnerProps {\n  /** Consecutive image blocks rendered as one gallery. */\n  images: readonly { readonly attachment: ImageAttachmentRef }[]\n  /** Session-authorized durable image loader. */\n  loadImage: (attachment: ImageAttachmentRef) => Promise<string>\n  /** Message-side alignment. */\n  align: 'start' | 'end'\n}"],
+				ownerPropsReferences: ["ImageAttachmentRef", "Message"],
+				standardProps: [
+					"useSessions: SnapshotSelectorHook<SessionListState>",
+					"useWorkspaces: SnapshotSelectorHook<import('./workspaces/service.ts').WorkspaceListState>",
+					"useSession: SnapshotSelectorHook<ConversationSnapshot>",
+					"sessionId: SessionId",
+					"useProjection: UseProjection",
+					"useInput: SnapshotSelectorHook<InputState>",
+					"inputActions: InputActions"
+				],
+				keyDomain: "",
+				hookContext: "",
+				slotInject: "",
+				declaredBy: "an entry in 'conversation.view' (client-ui-conversation), so it exists while that entry is mounted",
+				occupants: ["client-ui-attachment MessageImages"],
+				replaceRisk: "shadows-shipped-ui",
+				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.message.images', () => ctx.slots.register(\n      { name: 'conversation.message.images' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:124"
 			},
 			{
 				key: "conversation.session",
@@ -2768,7 +2841,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-conversation ConversationSession"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.session', () => ctx.slots.register(\n      { name: 'conversation.session' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-conversation/src/client/contract/slots.ts:44"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:71"
 			},
 			{
 				key: "conversation.session.header",
@@ -2795,7 +2868,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-conversation ConversationSessionHeader"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.session.header', () => ctx.slots.register(\n      { name: 'conversation.session.header' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-conversation/src/client/contract/slots.ts:52"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:79"
 			},
 			{
 				key: "conversation.session.header.actions",
@@ -2838,14 +2911,37 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				hookContext: "",
 				slotInject: "",
 				declaredBy: "an entry in 'conversation.session.header' (client-ui-conversation), so it exists while that entry is mounted",
-				occupants: [
-					"client-ui-agent-preset AgentPresetLabel id 'agent-preset'",
-					"client-ui-jobs JobListAction id 'job-list'",
-					"client-ui-subagent SubagentCatalogAction id 'subagent-catalog'"
-				],
+				occupants: ["client-ui-agent-preset AgentPresetLabel id 'agent-preset'", "client-ui-jobs JobListAction id 'job-list'"],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.session.header.actions', () => ctx.slots.register(\n      { name: 'conversation.session.header.actions', 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:63"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:100"
+			},
+			{
+				key: "conversation.session.header.lineage",
+				kind: "single",
+				scope: "session",
+				summary: "One breadcrumb title and its lineage controls.",
+				doc: "One breadcrumb title and its lineage controls. The render site keeps\nthe ordinary title as fallback; an occupant receives plain title data\nand may replace a subagent title with one combined navigation control.",
+				registerOptions: [],
+				ownerProps: ["/** Plain breadcrumb data handed to the optional lineage renderer. */\nexport interface ConversationHeaderLineageOwnerProps {\n  /** Session represented by this breadcrumb title. */\n  lineageSessionId: SessionId\n  /** Display title available to a renderer that combines the title with a control. */\n  displayTitle: string\n  /** Navigate to an ancestor title when its combined control is clicked. */\n  openTitle?: () => void\n}"],
+				ownerPropsReferences: ["SessionId"],
+				standardProps: [
+					"useSessions: SnapshotSelectorHook<SessionListState>",
+					"useWorkspaces: SnapshotSelectorHook<import('./workspaces/service.ts').WorkspaceListState>",
+					"useSession: SnapshotSelectorHook<ConversationSnapshot>",
+					"sessionId: SessionId",
+					"useProjection: UseProjection",
+					"useInput: SnapshotSelectorHook<InputState>",
+					"inputActions: InputActions"
+				],
+				keyDomain: "",
+				hookContext: "",
+				slotInject: "",
+				declaredBy: "an entry in 'conversation.session.header' (client-ui-conversation), so it exists while that entry is mounted",
+				occupants: ["client-ui-subagent SubagentHeaderLineage"],
+				replaceRisk: "shadows-shipped-ui",
+				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.session.header.lineage', () => ctx.slots.register(\n      { name: 'conversation.session.header.lineage' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:85"
 			},
 			{
 				key: "conversation.session.header.utilities",
@@ -2891,7 +2987,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["session-log-export SessionLogDownloadHeaderAction id 'session-log-download'"],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.session.header.utilities', () => ctx.slots.register(\n      { name: 'conversation.session.header.utilities', 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:68"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:105"
 			},
 			{
 				key: "conversation.view",
@@ -2937,7 +3033,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-conversation ChatView id 'chat'", "client-ui-trajectory TrajectoryView id 'trajectory'"],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('conversation.view', () => ctx.slots.register(\n      { name: 'conversation.view', 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:76"
+				source: "packages/client/ui-conversation/src/client/contract/slots.ts:113"
 			},
 			{
 				key: "details",
@@ -3328,6 +3424,44 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('sidebar', () => ctx.slots.register(\n      { name: 'sidebar' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
 				source: "packages/client/ui-layout/src/client/index.ts:49"
 			},
+			{
+				key: "sidebar.brand.mark",
+				kind: "single",
+				scope: "root",
+				summary: "Brand mark rendered in the expanded brand row and collapsed rail.",
+				doc: "Brand mark rendered in the expanded brand row and collapsed rail.\nDeclared by this package's `sidebar` entry; deployments may replace\nthe shell's fish fallback without replacing the surrounding controls.",
+				registerOptions: [],
+				ownerProps: ["/** Geometry supplied to the sidebar brand-mark occupant. */\nexport interface SidebarBrandMarkOwnerProps {\n  /** Requested square edge in pixels. */\n  size: number\n}"],
+				ownerPropsReferences: [],
+				standardProps: ["useSessions: SnapshotSelectorHook<SessionListState>", "useWorkspaces: SnapshotSelectorHook<import('./workspaces/service.ts').WorkspaceListState>"],
+				keyDomain: "",
+				hookContext: "",
+				slotInject: "",
+				declaredBy: "an entry in 'sidebar' (client-ui-sidebar), so it exists while that entry is mounted",
+				occupants: ["client-ui-brand-official OfficialBrandMark"],
+				replaceRisk: "shadows-shipped-ui",
+				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('sidebar.brand.mark', () => ctx.slots.register(\n      { name: 'sidebar.brand.mark' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
+				source: "packages/client/ui-sidebar/src/client/contract/slots.ts:23"
+			},
+			{
+				key: "sidebar.brand.name",
+				kind: "single",
+				scope: "root",
+				summary: "Brand name rendered beside the expanded mark.",
+				doc: "Brand name rendered beside the expanded mark. Declared by this\npackage's `sidebar` entry; the shell supplies a generic text fallback.",
+				registerOptions: [],
+				ownerProps: ["/** Empty owner share for the sidebar brand-name occupant. */\nexport interface SidebarBrandNameOwnerProps {\n  /** Marker field: the occupant owns its own content and width. */\n  children?: never\n}"],
+				ownerPropsReferences: [],
+				standardProps: ["useSessions: SnapshotSelectorHook<SessionListState>", "useWorkspaces: SnapshotSelectorHook<import('./workspaces/service.ts').WorkspaceListState>"],
+				keyDomain: "",
+				hookContext: "",
+				slotInject: "",
+				declaredBy: "an entry in 'sidebar' (client-ui-sidebar), so it exists while that entry is mounted",
+				occupants: ["client-ui-brand-official OfficialBrandName"],
+				replaceRisk: "shadows-shipped-ui",
+				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('sidebar.brand.name', () => ctx.slots.register(\n      { name: 'sidebar.brand.name' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
+				source: "packages/client/ui-sidebar/src/client/contract/slots.ts:28"
+			},
 			{
 				key: "sidebar.footer.action",
 				kind: "list",
@@ -3364,7 +3498,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-cordis CordisPanel id 'cordis-panel'"],
 				replaceRisk: "none",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('sidebar.footer.action', () => ctx.slots.register(\n      { name: 'sidebar.footer.action', id: 'my-entry', order: 100, label: 'My entry' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-sidebar/src/client/contract/slots.ts:35"
+				source: "packages/client/ui-sidebar/src/client/contract/slots.ts:46"
 			},
 			{
 				key: "sidebar.settings",
@@ -3383,7 +3517,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-settings-general SettingsRoot"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('sidebar.settings', () => ctx.slots.register(\n      { name: 'sidebar.settings' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-sidebar/src/client/contract/slots.ts:30"
+				source: "packages/client/ui-sidebar/src/client/contract/slots.ts:41"
 			},
 			{
 				key: "sidebar.workspaces",
@@ -3402,7 +3536,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-workspace WorkspaceBrowser"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('sidebar.workspaces', () => ctx.slots.register(\n      { name: 'sidebar.workspaces' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-sidebar/src/client/contract/slots.ts:24"
+				source: "packages/client/ui-sidebar/src/client/contract/slots.ts:35"
 			},
 			{
 				key: "sidebar.workspaces.directoryFlow",
@@ -3421,7 +3555,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				occupants: ["client-ui-directory-picker-browse BrowseDirectoryFlow", "client-ui-directory-picker-native NativeDirectoryFlow"],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('sidebar.workspaces.directoryFlow', () => ctx.slots.register(\n      { name: 'sidebar.workspaces.directoryFlow' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-workspace/src/client/contract/slots.ts:58"
+				source: "packages/client/ui-workspace/src/client/contract/slots.ts:59"
 			},
 			{
 				key: "tool.call.toolview",
@@ -3435,7 +3569,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 					type: "string",
 					doc: "Your cell key: the entry renders where the owner dispatches this exact key. Registering an already-occupied key replaces that occupant."
 				}],
-				ownerProps: ["/** Standard owner currency supplied to every atomic Tool view. */\nexport interface ToolCallOwnerProps {\n  /** Tool call identity, stable across running and settled forms. */\n  callId: string\n  /** Wire Tool name and keyed dispatch value. */\n  toolName: string\n  /** Frozen running call or settled result node. */\n  block: ToolCallBlock\n  /** Session workspace root for relative summaries. */\n  cwd?: string | undefined\n  /** Open a Tool argument path through the Host. */\n  openFile: (path: string) => void\n  /** Inspect this call in the trajectory view when available. */\n  inspect?: (() => void) | undefined\n}"],
+				ownerProps: ["/** Standard owner currency supplied to every atomic Tool view. */\nexport interface ToolCallOwnerProps {\n  /** Tool call identity, stable across running and settled forms. */\n  callId: string\n  /** Wire Tool name and keyed dispatch value. */\n  toolName: string\n  /** Frozen running call or settled result node. */\n  block: ToolCallBlock\n  /** Session workspace root for relative summaries. */\n  cwd?: string | undefined\n  /** Host account home; POSIX home-rooted summaries display as `~`. */\n  home?: string | undefined\n  /** Open a Tool argument path through the Host. */\n  openFile: (path: string) => void\n  /** Inspect this call in the trajectory view when available. */\n  inspect?: (() => void) | undefined\n}"],
 				ownerPropsReferences: ["Wire"],
 				standardProps: [
 					"useSessions: SnapshotSelectorHook<SessionListState>",
@@ -3469,7 +3603,7 @@ call: (method, args = null) => env.invoke(method, args) }, harnessTrap(), ...Obj
 				],
 				replaceRisk: "shadows-shipped-ui",
 				example: "return {\n  inject: ['slots'],\n  apply(ctx) {\n    ctx.slots.inject('tool.call.toolview', () => ctx.slots.register(\n      { name: 'tool.call.toolview', key: '<one key the owner dispatches>' },\n      () => React.createElement('div', null, 'hello'),\n    ))\n  },\n}",
-				source: "packages/client/ui-tool/src/client/contract/slots.ts:23"
+				source: "packages/client/ui-tool/src/client/contract/slots.ts:24"
 			},
 			{
 				key: "tool.view.cordis",

package/dist/kernel/cordis-client-runner/lib/types/client/api-catalog.js

@@ -38,7 +38,7 @@ export const SERVICE_API = [
     {
         key: 'locale',
         summary: 'Dictionary registry plus locale preference.',
-        description: 'Dictionary registry plus locale preference. Lookup chain per key: the entry\'s namespace in the active locale -> that namespace\'s zh fallback -> the shared common namespace (active, then zh) -> the key itself (missing text stays visible, fail loud in the UI rather than blank). Reads go through getLocale; writes only through setLocale; continuous sync through the `locale/change` event, or through the LocaleFace getSnapshot/subscribe pair the render machinery consumes (installed via `ctx.slots.installLocale`).',
+        description: 'Dictionary registry plus locale preference. Lookup chain per key: the entry\'s namespace in the active locale -> that namespace\'s en fallback -> the shared common namespace (active, then en) -> the key itself (missing text stays visible, fail loud in the UI rather than blank). Reads go through getLocale; writes only through setLocale; continuous sync through the `locale/change` event, or through the LocaleFace getSnapshot/subscribe pair the render machinery consumes (installed via `ctx.slots.installLocale`).',
         methods: [
             {
                 signature: 'getLocale(): LocaleSnapshot',
@@ -60,7 +60,7 @@ export const SERVICE_API = [
             },
             {
                 signature: 'setLocale(id: string): void',
-                description: 'Switch the active locale — the only user preference write entry.',
+                description: 'Switch the active locale — the only user preference write entry.\n\nThe durable write happens even when the id already matches the active locale, because the active value may be a provisional browser-derived or fallback resolution that nothing has stored yet. Picking the language already on screen is still an explicit choice, and it must survive a different browser sharing the same NOMIX home. Only the render notification is conditional: republishing an unchanged locale would churn every subscriber for nothing.',
                 parameters: [{ name: 'id', description: 'a registered locale id; unknown ids throw.' }],
             },
             {
@@ -501,7 +501,7 @@ export const TYPE_API = [
     },
     {
         name: 'ISession',
-        declaration: 'export interface ISession {\n    readonly sessionId: SessionId;\n    readonly projections: ProjectionsFace;\n    prompt(content: PromptContentPart[], mode: \'queue\' | \'steer\'): Promise<RpcResult<{\n        accepted: true;\n    }>>;\n    readAttachment(attachmentId: AttachmentIdType): Promise<RpcResult<{\n        attachment: ImageAttachmentRef;\n        data: Uint8Array;\n    }>>;\n    updateQueue(itemId: MessageId, action: QueueAction): Promise<RpcResult<{\n        accepted: true;\n    }>>;\n    cancel(): Promise<RpcResult<{\n        accepted: true;\n    }>>;\n    rename(title: string): Promise<RpcResult<{\n        title: string;\n        seq: number;\n    }>>;\n    loadOlder(): Promise<void>;\n    command(line: string): Promise<RemoteResult<{\n        matched: boolean;\n    }>>;\n}',
+        declaration: 'export interface ISession {\n    readonly sessionId: SessionId;\n    readonly projections: ProjectionsFace;\n    prompt(content: PromptContentPart[], mode: \'queue\' | \'steer\', signal?: AbortSignal): Promise<RpcResult<{\n        accepted: true;\n    }>>;\n    readAttachment(attachmentId: AttachmentIdType): Promise<RpcResult<{\n        attachment: ImageAttachmentRef;\n        data: Uint8Array;\n    }>>;\n    updateQueue(itemId: MessageId, action: QueueAction): Promise<RpcResult<{\n        accepted: true;\n    }>>;\n    cancel(): Promise<RpcResult<{\n        accepted: true;\n    }>>;\n    rename(title: string): Promise<RpcResult<{\n        title: string;\n        seq: number;\n    }>>;\n    loadOlder(): Promise<void>;\n    command(line: string): Promise<RemoteResult<{\n        matched: boolean;\n    }>>;\n}',
     },
     {
         name: 'KeyPropsOf',