pith-ui 0.1.0 → 0.1.1

package/API.md

@@ -1,6 +1,6 @@
 # Public API reference
 
-Generated for `pith-ui@0.1.0` by `node scripts/api-docs.ts` from TypeScript declaration emit. Do not edit this file by hand. The installed public declarations are authoritative; this reference reproduces every public declaration, including all 73 create/install/mount factories and their state, options, callback and handle types.
+Generated for `pith-ui@0.1.1` by `node scripts/api-docs.ts` from TypeScript declaration emit. Do not edit this file by hand. The installed public declarations are authoritative; this reference reproduces every public declaration, including all 73 create/install/mount factories and their state, options, callback and handle types.
 
 Use the [catalog](https://github.com/minifish-org/pith-ui/blob/main/docs/catalog.md) to choose a complete block first, then inspect its exact signature and linked types here. Gallery links are related experiences; adapter APIs may point to their preferred replacement. Source links point to the implementation, not a second usage contract.
 
@@ -17,7 +17,7 @@ Regenerate: `node scripts/api-docs.ts`. Verify without writing: `node scripts/ap
 | [`createArtifactPanel`](#createartifactpanel) | [artifact-panel](https://minifish-org.github.io/pith-ui/?item=artifact-panel) |
 | [`createAttachments`](#createattachments) | [attachments](https://minifish-org.github.io/pith-ui/?item=attachments) |
 | [`createBranchHistory`](#createbranchhistory) | [branch-history](https://minifish-org.github.io/pith-ui/?item=branch-history) |
-| [`createButton`](#createbutton) | [actions](https://minifish-org.github.io/pith-ui/?item=actions), [button](https://minifish-org.github.io/pith-ui/?item=button), [confirmation](https://minifish-org.github.io/pith-ui/?item=confirmation), [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu), [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader), [copy-feedback](https://minifish-org.github.io/pith-ui/?item=copy-feedback), [dialog](https://minifish-org.github.io/pith-ui/?item=dialog), [drop-feedback](https://minifish-org.github.io/pith-ui/?item=drop-feedback), [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog), [foundation-colors](https://minifish-org.github.io/pith-ui/?item=foundation-colors), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [image-viewer](https://minifish-org.github.io/pith-ui/?item=image-viewer), [list-row](https://minifish-org.github.io/pith-ui/?item=list-row), [resources-panel](https://minifish-org.github.io/pith-ui/?item=resources-panel), [runtime-panel](https://minifish-org.github.io/pith-ui/?item=runtime-panel), [text-edit-dialog](https://minifish-org.github.io/pith-ui/?item=text-edit-dialog), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar) |
+| [`createButton`](#createbutton) | [actions](https://minifish-org.github.io/pith-ui/?item=actions), [button](https://minifish-org.github.io/pith-ui/?item=button), [confirmation](https://minifish-org.github.io/pith-ui/?item=confirmation), [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu), [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader), [copy-feedback](https://minifish-org.github.io/pith-ui/?item=copy-feedback), [dialog](https://minifish-org.github.io/pith-ui/?item=dialog), [drop-feedback](https://minifish-org.github.io/pith-ui/?item=drop-feedback), [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog), [foundation-colors](https://minifish-org.github.io/pith-ui/?item=foundation-colors), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [image-viewer](https://minifish-org.github.io/pith-ui/?item=image-viewer), [list-row](https://minifish-org.github.io/pith-ui/?item=list-row), [runtime-panel](https://minifish-org.github.io/pith-ui/?item=runtime-panel), [text-edit-dialog](https://minifish-org.github.io/pith-ui/?item=text-edit-dialog), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar) |
 | [`createCheckbox`](#createcheckbox) | [checkbox](https://minifish-org.github.io/pith-ui/?item=checkbox), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion) |
 | [`createCollectionState`](#createcollectionstate) | [collection-state](https://minifish-org.github.io/pith-ui/?item=collection-state) |
 | [`createCompletionNotices`](#createcompletionnotices) | [completion-notices](https://minifish-org.github.io/pith-ui/?item=completion-notices) |
@@ -77,7 +77,7 @@ Regenerate: `node scripts/api-docs.ts`. Verify without writing: `node scripts/ap
 | [`createTextEditDialog`](#createtexteditdialog) | [pending-messages](https://minifish-org.github.io/pith-ui/?item=pending-messages), [text-edit-dialog](https://minifish-org.github.io/pith-ui/?item=text-edit-dialog) |
 | [`createTextInput`](#createtextinput) | [form-section](https://minifish-org.github.io/pith-ui/?item=form-section), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [popover](https://minifish-org.github.io/pith-ui/?item=popover), [text-input](https://minifish-org.github.io/pith-ui/?item=text-input) |
 | [`createToolbar`](#createtoolbar) | [button](https://minifish-org.github.io/pith-ui/?item=button), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [icon-button](https://minifish-org.github.io/pith-ui/?item=icon-button), [icons](https://minifish-org.github.io/pith-ui/?item=icons), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar) |
-| [`createUpdatePanel`](#createupdatepanel) | [updates](https://minifish-org.github.io/pith-ui/?item=updates) |
+| [`createUpdatePanel`](#createupdatepanel) | [settings-panel](https://minifish-org.github.io/pith-ui/?item=settings-panel), [updates](https://minifish-org.github.io/pith-ui/?item=updates) |
 | [`createWelcomeView`](#createwelcomeview) | [welcome](https://minifish-org.github.io/pith-ui/?item=welcome) |
 | [`createWorkspaceNavigation`](#createworkspacenavigation) | [workspace-navigation](https://minifish-org.github.io/pith-ui/?item=workspace-navigation) |
 | [`createWorkspacePicker`](#createworkspacepicker) | [workspace-picker](https://minifish-org.github.io/pith-ui/?item=workspace-picker) |
@@ -90,7 +90,7 @@ Regenerate: `node scripts/api-docs.ts`. Verify without writing: `node scripts/ap
 
 ### createAttachments
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L63)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L66)
 
 ```ts
 export declare function createAttachments(options?: {
@@ -106,7 +106,7 @@ Related gallery: [attachments](https://minifish-org.github.io/pith-ui/?item=atta
 
 ### createDropFeedback
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L53)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L56)
 
 ```ts
 export declare function createDropFeedback(options: {
@@ -123,7 +123,7 @@ Related gallery: [drop-feedback](https://minifish-org.github.io/pith-ui/?item=dr
 
 ### createPendingMessages
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L10)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L11)
 
 ```ts
 export declare function createPendingMessages(options?: PendingMessagesOptions): UIBlock<PendingMessagesState>;
@@ -135,7 +135,7 @@ Related gallery: [pending-messages](https://minifish-org.github.io/pith-ui/?item
 
 ### AttachmentItem
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L51)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L54)
 
 ```ts
 export interface AttachmentItem {
@@ -147,7 +147,7 @@ export interface AttachmentItem {
 
 ### AttachmentsState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L62)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L65)
 
 ```ts
 export interface AttachmentsState {
@@ -160,7 +160,7 @@ Referenced public types and APIs: [`AttachmentItem`](#attachmentitem).
 
 ### PendingMessage
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L4)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L5)
 
 ```ts
 export interface PendingMessage {
@@ -173,7 +173,7 @@ export interface PendingMessage {
 
 ### PendingMessagesOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L6)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L7)
 
 ```ts
 export interface PendingMessagesOptions {
@@ -184,7 +184,7 @@ export interface PendingMessagesOptions {
 
 ### PendingMessagesState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L6)
 
 ```ts
 export interface PendingMessagesState {
@@ -254,19 +254,19 @@ export interface TextRange {
 
 ### createConversationView
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L34)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L43)
 
 ```ts
-export declare function createConversationView(options?: ConversationViewOptions): UIBlock<ConversationViewState>;
+export declare function createConversationView(options?: ConversationViewOptions): ConversationViewBlock;
 ```
 
-Referenced public types and APIs: [`ConversationViewOptions`](#conversationviewoptions), [`ConversationViewState`](#conversationviewstate), [`UIBlock`](#uiblock).
+Referenced public types and APIs: [`ConversationViewBlock`](#conversationviewblock), [`ConversationViewOptions`](#conversationviewoptions).
 
 Related gallery: [conversation-messages](https://minifish-org.github.io/pith-ui/?item=conversation-messages), [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion).
 
 ### ConversationAction
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L25)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L26)
 
 ```ts
 export interface ConversationAction {
@@ -276,9 +276,34 @@ export interface ConversationAction {
 }
 ```
 
+### ConversationActionAvailability
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L27)
+
+```ts
+export interface ConversationActionAvailability {
+    copy?: boolean;
+    edit?: boolean;
+    branch?: boolean;
+}
+```
+
+### ConversationImageState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L28)
+
+```ts
+export type ConversationImageState = {
+    status: 'ready';
+    src: string;
+} | {
+    status: 'unavailable';
+};
+```
+
 ### ConversationMessage
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L7)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L8)
 
 ```ts
 /** UI data only. Hosts decide copy/edit/branch eligibility and resolve images. */
@@ -312,16 +337,31 @@ export interface ConversationMessage {
 
 Related gallery: [conversation-messages](https://minifish-org.github.io/pith-ui/?item=conversation-messages), [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader).
 
+### ConversationViewBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L29)
+
+```ts
+export interface ConversationViewBlock extends UIBlock<ConversationViewState> {
+    /** Disabled state, separate from whether an action exists for a message. */
+    updateActionAvailability(disabled: Readonly<ConversationActionAvailability>): void;
+    images(): readonly HTMLImageElement[];
+    setImageState(image: HTMLImageElement, state: ConversationImageState): void;
+}
+```
+
+Referenced public types and APIs: [`ConversationActionAvailability`](#conversationactionavailability), [`ConversationImageState`](#conversationimagestate), [`ConversationViewState`](#conversationviewstate), [`UIBlock`](#uiblock).
+
 ### ConversationViewOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L26)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L35)
 
 ```ts
 export interface ConversationViewOptions {
     container?: HTMLElement;
     markdown?: (conversationId: string) => MarkdownOptions;
-    onAction?: (action: ConversationAction) => void;
-    onCopyCode?: (text: string) => void;
+    onAction?: (action: ConversationAction, button: HTMLButtonElement) => void;
+    onCopyCode?: (text: string, button: HTMLButtonElement) => void;
 }
 ```
 
@@ -329,7 +369,7 @@ Referenced public types and APIs: [`ConversationAction`](#conversationaction), [
 
 ### ConversationViewState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L19)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L20)
 
 ```ts
 export interface ConversationViewState {
@@ -346,7 +386,7 @@ Referenced public types and APIs: [`ConversationMessage`](#conversationmessage).
 
 ### createImageViewer
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/image-viewer.ts#L8)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/image-viewer.ts#L9)
 
 ```ts
 /** A modal above either a generated-file preview or a conversation attachment. */
@@ -364,14 +404,16 @@ Related gallery: [image-viewer](https://minifish-org.github.io/pith-ui/?item=ima
 
 ### installImageViewer
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/image-viewer.ts#L87)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/image-viewer.ts#L88)
 
 ```ts
-export declare function installImageViewer(dialog: HTMLDialogElement): {
+export declare function installImageViewer(dialog: HTMLDialogElement, options?: {
+    triggerRoot?: HTMLElement;
+}): {
+    destroy(): void;
     element: HTMLDialogElement;
     open(target: HTMLImageElement | ImageViewerInput): void;
     close: () => void;
-    destroy(): void;
 };
 ```
 
@@ -381,7 +423,7 @@ Related gallery: [image-viewer](https://minifish-org.github.io/pith-ui/?item=ima
 
 ### ImageViewerInput
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/image-viewer.ts#L4)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/image-viewer.ts#L5)
 
 ```ts
 export interface ImageViewerInput {
@@ -393,7 +435,7 @@ export interface ImageViewerInput {
 
 ### ImageViewerOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/image-viewer.ts#L3)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/image-viewer.ts#L4)
 
 ```ts
 export interface ImageViewerOptions {
@@ -451,7 +493,7 @@ Referenced public types and APIs: [`MarkdownOptions`](#markdownoptions).
 
 ### createPagedPreview
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L30)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L31)
 
 ```ts
 export declare function createPagedPreview(options: PagedPreviewOptions): UIBlock<PagedPreviewState>;
@@ -463,7 +505,7 @@ Related gallery: [markdown-content](https://minifish-org.github.io/pith-ui/?item
 
 ### mountPagedPreview
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L59)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L60)
 
 ```ts
 export declare function mountPagedPreview(container: HTMLElement, text: string, kind: PreviewKind): void;
@@ -475,7 +517,7 @@ Related gallery: [markdown-content](https://minifish-org.github.io/pith-ui/?item
 
 ### PagedPreviewOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L28)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L29)
 
 ```ts
 export interface PagedPreviewOptions extends PagedPreviewState {
@@ -488,7 +530,7 @@ Referenced public types and APIs: [`PagedPreviewState`](#pagedpreviewstate).
 
 ### PagedPreviewState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L27)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L28)
 
 ```ts
 export interface PagedPreviewState {
@@ -501,7 +543,7 @@ Referenced public types and APIs: [`PreviewKind`](#previewkind).
 
 ### PreviewKind
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L26)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L27)
 
 ```ts
 export type PreviewKind = 'text' | 'markdown' | 'diff';
@@ -509,7 +551,7 @@ export type PreviewKind = 'text' | 'markdown' | 'diff';
 
 ### previewPageBytes
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L6)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L7)
 
 ```ts
 export declare const previewPageBytes: number;
@@ -517,7 +559,7 @@ export declare const previewPageBytes: number;
 
 ### previewPageRanges
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L8)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L9)
 
 ```ts
 export declare function previewPageRanges(bytes: Uint8Array, window?: number): Array<[
@@ -700,7 +742,7 @@ export declare function element<K extends keyof HTMLElementTagNameMap>(tag: K, c
 
 Referenced public types and APIs: [`DOMChild`](#domchild).
 
-Related gallery: [actions](https://minifish-org.github.io/pith-ui/?item=actions), [artifact-panel](https://minifish-org.github.io/pith-ui/?item=artifact-panel), [button](https://minifish-org.github.io/pith-ui/?item=button), [collection-state](https://minifish-org.github.io/pith-ui/?item=collection-state), [completion-notices](https://minifish-org.github.io/pith-ui/?item=completion-notices), [composer](https://minifish-org.github.io/pith-ui/?item=composer), [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu), [conversation-messages](https://minifish-org.github.io/pith-ui/?item=conversation-messages), [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader), [copy-feedback](https://minifish-org.github.io/pith-ui/?item=copy-feedback), [dialog](https://minifish-org.github.io/pith-ui/?item=dialog), [disclosure](https://minifish-org.github.io/pith-ui/?item=disclosure), [drop-feedback](https://minifish-org.github.io/pith-ui/?item=drop-feedback), [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog), [file-actions](https://minifish-org.github.io/pith-ui/?item=file-actions), [file-preview](https://minifish-org.github.io/pith-ui/?item=file-preview), [form-section](https://minifish-org.github.io/pith-ui/?item=form-section), [foundation-borders](https://minifish-org.github.io/pith-ui/?item=foundation-borders), [foundation-colors](https://minifish-org.github.io/pith-ui/?item=foundation-colors), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [foundation-surfaces](https://minifish-org.github.io/pith-ui/?item=foundation-surfaces), [foundation-typography](https://minifish-org.github.io/pith-ui/?item=foundation-typography), [icon-button](https://minifish-org.github.io/pith-ui/?item=icon-button), [icons](https://minifish-org.github.io/pith-ui/?item=icons), [image-viewer](https://minifish-org.github.io/pith-ui/?item=image-viewer), [list-row](https://minifish-org.github.io/pith-ui/?item=list-row), [mcp-connections](https://minifish-org.github.io/pith-ui/?item=mcp-connections), [model-picker](https://minifish-org.github.io/pith-ui/?item=model-picker), [pending-messages](https://minifish-org.github.io/pith-ui/?item=pending-messages), [permission-control](https://minifish-org.github.io/pith-ui/?item=permission-control), [popover](https://minifish-org.github.io/pith-ui/?item=popover), [provider-resource-actions](https://minifish-org.github.io/pith-ui/?item=provider-resource-actions), [resource-editor](https://minifish-org.github.io/pith-ui/?item=resource-editor), [resources-panel](https://minifish-org.github.io/pith-ui/?item=resources-panel), [runtime-panel](https://minifish-org.github.io/pith-ui/?item=runtime-panel), [scroll-area](https://minifish-org.github.io/pith-ui/?item=scroll-area), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar), [updates](https://minifish-org.github.io/pith-ui/?item=updates), [workspace-navigation](https://minifish-org.github.io/pith-ui/?item=workspace-navigation).
+Related gallery: [actions](https://minifish-org.github.io/pith-ui/?item=actions), [artifact-panel](https://minifish-org.github.io/pith-ui/?item=artifact-panel), [button](https://minifish-org.github.io/pith-ui/?item=button), [collection-state](https://minifish-org.github.io/pith-ui/?item=collection-state), [completion-notices](https://minifish-org.github.io/pith-ui/?item=completion-notices), [composer](https://minifish-org.github.io/pith-ui/?item=composer), [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu), [conversation-messages](https://minifish-org.github.io/pith-ui/?item=conversation-messages), [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader), [copy-feedback](https://minifish-org.github.io/pith-ui/?item=copy-feedback), [dialog](https://minifish-org.github.io/pith-ui/?item=dialog), [disclosure](https://minifish-org.github.io/pith-ui/?item=disclosure), [drop-feedback](https://minifish-org.github.io/pith-ui/?item=drop-feedback), [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog), [file-actions](https://minifish-org.github.io/pith-ui/?item=file-actions), [file-preview](https://minifish-org.github.io/pith-ui/?item=file-preview), [form-section](https://minifish-org.github.io/pith-ui/?item=form-section), [foundation-borders](https://minifish-org.github.io/pith-ui/?item=foundation-borders), [foundation-colors](https://minifish-org.github.io/pith-ui/?item=foundation-colors), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [foundation-surfaces](https://minifish-org.github.io/pith-ui/?item=foundation-surfaces), [foundation-typography](https://minifish-org.github.io/pith-ui/?item=foundation-typography), [icon-button](https://minifish-org.github.io/pith-ui/?item=icon-button), [icons](https://minifish-org.github.io/pith-ui/?item=icons), [image-viewer](https://minifish-org.github.io/pith-ui/?item=image-viewer), [list-row](https://minifish-org.github.io/pith-ui/?item=list-row), [mcp-connections](https://minifish-org.github.io/pith-ui/?item=mcp-connections), [pending-messages](https://minifish-org.github.io/pith-ui/?item=pending-messages), [permission-control](https://minifish-org.github.io/pith-ui/?item=permission-control), [popover](https://minifish-org.github.io/pith-ui/?item=popover), [provider-resource-actions](https://minifish-org.github.io/pith-ui/?item=provider-resource-actions), [resources-panel](https://minifish-org.github.io/pith-ui/?item=resources-panel), [runtime-panel](https://minifish-org.github.io/pith-ui/?item=runtime-panel), [scroll-area](https://minifish-org.github.io/pith-ui/?item=scroll-area), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar), [updates](https://minifish-org.github.io/pith-ui/?item=updates), [workspace-navigation](https://minifish-org.github.io/pith-ui/?item=workspace-navigation).
 
 ### escape
 
@@ -775,7 +817,7 @@ Related gallery: [foundation-focus](https://minifish-org.github.io/pith-ui/?item
 
 ### createArtifactPanel
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L30)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L33)
 
 ```ts
 export declare function createArtifactPanel(options: ArtifactPanelOptions): {
@@ -793,7 +835,7 @@ Related gallery: [artifact-panel](https://minifish-org.github.io/pith-ui/?item=a
 
 ### createFileActions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L16)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L19)
 
 ```ts
 export declare function createFileActions(options: FileActionOptions): {
@@ -808,7 +850,7 @@ Related gallery: [file-actions](https://minifish-org.github.io/pith-ui/?item=fil
 
 ### createFilePreview
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L153)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L179)
 
 ```ts
 export declare function createFilePreview(options?: FilePreviewOptions): {
@@ -830,13 +872,14 @@ Related gallery: [file-preview](https://minifish-org.github.io/pith-ui/?item=fil
 
 ### createResourcesPanel
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L94)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L105)
 
 ```ts
 export declare function createResourcesPanel(options?: ResourcesPanelOptions): {
     element: HTMLElement;
-    open(workspaceName: string, toolbar: Node): void;
+    open(workspaceName: string, toolbar?: Node): void;
     setError(message: string): void;
+    setCreateDisabled(disabled: boolean): void;
     update(state: Readonly<ResourcesPanelState>): void;
     destroy(): void;
 };
@@ -848,7 +891,7 @@ Related gallery: [resources-panel](https://minifish-org.github.io/pith-ui/?item=
 
 ### ArtifactPanelOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L29)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L32)
 
 ```ts
 export interface ArtifactPanelOptions {
@@ -857,12 +900,13 @@ export interface ArtifactPanelOptions {
     toggle: HTMLElement;
     count: HTMLElement;
     headingId?: string;
+    dismissExclusions?: readonly HTMLElement[];
 }
 ```
 
 ### ArtifactPanelState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L28)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L31)
 
 ```ts
 export interface ArtifactPanelState {
@@ -879,7 +923,7 @@ export interface ArtifactPanelState {
 
 ### FileActionOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L7)
 
 ```ts
 export interface FileActionOptions {
@@ -894,7 +938,7 @@ export interface FileActionOptions {
 
 ### fileActionsMarkup
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L10)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L12)
 
 ```ts
 export declare function fileActionsMarkup(options: FileActionOptions): string;
@@ -904,7 +948,7 @@ Referenced public types and APIs: [`FileActionOptions`](#fileactionoptions).
 
 ### FilePreviewOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L152)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L178)
 
 ```ts
 export interface FilePreviewOptions {
@@ -918,7 +962,7 @@ export interface FilePreviewOptions {
 
 ### FilePreviewState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L151)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L177)
 
 ```ts
 export interface FilePreviewState {
@@ -935,7 +979,7 @@ Referenced public types and APIs: [`PreviewKind`](#previewkind).
 
 ### ResourceDisplayEntry
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L88)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L99)
 
 ```ts
 export interface ResourceDisplayEntry {
@@ -950,7 +994,7 @@ export interface ResourceDisplayEntry {
 
 ### ResourcesPanelOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L93)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L104)
 
 ```ts
 export interface ResourcesPanelOptions {
@@ -960,12 +1004,14 @@ export interface ResourcesPanelOptions {
     listId?: string;
     errorId?: string;
     onClose?: () => void;
+    onRefresh?: () => void;
+    onCreate?: (kind: 'instructions' | 'skill' | 'template') => void;
 }
 ```
 
 ### ResourcesPanelState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L89)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L100)
 
 ```ts
 export interface ResourcesPanelState {
@@ -974,6 +1020,7 @@ export interface ResourcesPanelState {
     templates: readonly ResourceDisplayEntry[];
     diagnostics: readonly string[];
     createInstructions?: Node;
+    canCreateInstructions?: boolean;
 }
 ```
 
@@ -983,7 +1030,7 @@ Referenced public types and APIs: [`ResourceDisplayEntry`](#resourcedisplayentry
 
 ### createCompletionNotices
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L120)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L123)
 
 ```ts
 export declare function createCompletionNotices(options?: {
@@ -999,7 +1046,7 @@ Related gallery: [completion-notices](https://minifish-org.github.io/pith-ui/?it
 
 ### createCopyFeedback
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L159)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L166)
 
 ```ts
 export declare function createCopyFeedback(options: {
@@ -1016,7 +1063,7 @@ Related gallery: [copy-feedback](https://minifish-org.github.io/pith-ui/?item=co
 
 ### createCostLedger
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L21)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L23)
 
 ```ts
 export declare function createCostLedger(options?: {
@@ -1037,7 +1084,7 @@ Related gallery: [cost-ledger](https://minifish-org.github.io/pith-ui/?item=cost
 
 ### createUpdatePanel
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L80)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L82)
 
 ```ts
 export declare function createUpdatePanel(options?: {
@@ -1058,11 +1105,11 @@ export declare function createUpdatePanel(options?: {
 
 Referenced public types and APIs: [`UpdatePanelState`](#updatepanelstate).
 
-Related gallery: [updates](https://minifish-org.github.io/pith-ui/?item=updates).
+Related gallery: [settings-panel](https://minifish-org.github.io/pith-ui/?item=settings-panel), [updates](https://minifish-org.github.io/pith-ui/?item=updates).
 
 ### CompletionNoticeDisplay
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L113)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L116)
 
 ```ts
 export interface CompletionNoticeDisplay {
@@ -1077,7 +1124,7 @@ Related gallery: [completion-notices](https://minifish-org.github.io/pith-ui/?it
 
 ### CostLedgerState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L20)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L22)
 
 ```ts
 export interface CostLedgerState {
@@ -1090,7 +1137,7 @@ Referenced public types and APIs: [`CostRequestDisplay`](#costrequestdisplay).
 
 ### CostRequestDisplay
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L15)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L17)
 
 ```ts
 export interface CostRequestDisplay {
@@ -1120,7 +1167,7 @@ export interface CostRequestDisplay {
 
 ### CostSummaryDisplay
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L6)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L8)
 
 ```ts
 export interface CostSummaryDisplay {
@@ -1136,7 +1183,7 @@ export interface CostSummaryDisplay {
 
 ### formatCost
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L7)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L9)
 
 ```ts
 export declare function formatCost(cost: CostSummaryDisplay | undefined, latestTask?: boolean): string;
@@ -1146,7 +1193,7 @@ Referenced public types and APIs: [`CostSummaryDisplay`](#costsummarydisplay).
 
 ### historyStatusMarkup
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L114)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L117)
 
 ```ts
 export declare function historyStatusMarkup(status: 'approval' | 'running' | 'unread' | 'idle'): string;
@@ -1156,7 +1203,7 @@ Related gallery: [completion-notices](https://minifish-org.github.io/pith-ui/?it
 
 ### UpdatePanelState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L79)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L81)
 
 ```ts
 export interface UpdatePanelState {
@@ -1173,35 +1220,44 @@ export interface UpdatePanelState {
 
 ### createProviderActions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L16)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L28)
 
 ```ts
-export declare function createProviderActions(state: ProviderActionsState, options?: {
-    onAction?: (action: string, target: DOMStringMap) => void;
-}): UIBlock<ProviderActionsState>;
+export declare function createProviderActions(state: ProviderActionsState, options?: FeatureActionOptions): UIBlock<ProviderActionsState>;
 ```
 
-Referenced public types and APIs: [`ProviderActionsState`](#provideractionsstate), [`UIBlock`](#uiblock).
+Referenced public types and APIs: [`FeatureActionOptions`](#featureactionoptions), [`ProviderActionsState`](#provideractionsstate), [`UIBlock`](#uiblock).
 
 Related gallery: [provider-resource-actions](https://minifish-org.github.io/pith-ui/?item=provider-resource-actions).
 
 ### createResourceActions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L17)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L29)
 
 ```ts
-export declare function createResourceActions(state: ResourceActionsState, options?: {
-    onAction?: (action: string, target: DOMStringMap) => void;
-}): UIBlock<ResourceActionsState>;
+export declare function createResourceActions(state: ResourceActionsState, options?: FeatureActionOptions): UIBlock<ResourceActionsState>;
 ```
 
-Referenced public types and APIs: [`ResourceActionsState`](#resourceactionsstate), [`UIBlock`](#uiblock).
+Referenced public types and APIs: [`FeatureActionOptions`](#featureactionoptions), [`ResourceActionsState`](#resourceactionsstate), [`UIBlock`](#uiblock).
 
 Related gallery: [provider-resource-actions](https://minifish-org.github.io/pith-ui/?item=provider-resource-actions), [resources-panel](https://minifish-org.github.io/pith-ui/?item=resources-panel).
 
+### FeatureActionOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L11)
+
+```ts
+export interface FeatureActionOptions {
+    onAction?: (action: string, target: DOMStringMap) => ReturnType<UIAction>;
+    onError?: (message: string) => void;
+}
+```
+
+Referenced public types and APIs: [`UIAction`](#uiaction).
+
 ### providerActionsMarkup
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L6)
 
 ```ts
 export declare function providerActionsMarkup(provider: ProviderActionsState): string;
@@ -1211,7 +1267,7 @@ Referenced public types and APIs: [`ProviderActionsState`](#provideractionsstate
 
 ### ProviderActionsState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L3)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L4)
 
 ```ts
 export interface ProviderActionsState {
@@ -1224,7 +1280,7 @@ export interface ProviderActionsState {
 
 ### resourceActionsMarkup
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L6)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L7)
 
 ```ts
 export declare function resourceActionsMarkup(kind: string, resource: {
@@ -1235,7 +1291,7 @@ export declare function resourceActionsMarkup(kind: string, resource: {
 
 ### ResourceActionsState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L4)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L5)
 
 ```ts
 export interface ResourceActionsState {
@@ -1252,24 +1308,25 @@ export interface ResourceActionsState {
 
 ### createCustomConnectionEditor
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L26)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L28)
 
 ```ts
 export declare function createCustomConnectionEditor(state: CustomConnectionState, options?: {
     idPrefix?: string;
+    onSubmit?: (draft: CustomConnectionDraft) => ActionResult | Promise<ActionResult>;
 }): UIBlock<CustomConnectionState> & {
     read(): CustomConnectionDraft;
     readonly form: HTMLFormElement;
 };
 ```
 
-Referenced public types and APIs: [`CustomConnectionDraft`](#customconnectiondraft), [`CustomConnectionState`](#customconnectionstate), [`UIBlock`](#uiblock).
+Referenced public types and APIs: [`ActionResult`](#actionresult), [`CustomConnectionDraft`](#customconnectiondraft), [`CustomConnectionState`](#customconnectionstate), [`UIBlock`](#uiblock).
 
 Related gallery: [custom-connection](https://minifish-org.github.io/pith-ui/?item=custom-connection).
 
 ### createCustomModelRow
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L11)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L12)
 
 ```ts
 export declare function createCustomModelRow(model: CustomModelRowState, index?: number): UIBlock<CustomModelRowState> & {
@@ -1284,7 +1341,7 @@ Related gallery: [custom-connection](https://minifish-org.github.io/pith-ui/?ite
 
 ### CustomConnectionDraft
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L7)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L8)
 
 ```ts
 export interface CustomConnectionDraft {
@@ -1300,7 +1357,7 @@ Referenced public types and APIs: [`CustomModelDraft`](#custommodeldraft).
 
 ### CustomConnectionState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L6)
 
 ```ts
 export interface CustomConnectionState {
@@ -1318,7 +1375,7 @@ Referenced public types and APIs: [`CustomModelValue`](#custommodelvalue).
 
 ### CustomModelDraft
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L6)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L7)
 
 ```ts
 export interface CustomModelDraft {
@@ -1340,7 +1397,7 @@ export interface CustomModelDraft {
 
 ### CustomModelRowState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L10)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L11)
 
 ```ts
 export interface CustomModelRowState extends CustomModelValue {
@@ -1353,7 +1410,7 @@ Referenced public types and APIs: [`CustomModelValue`](#custommodelvalue).
 
 ### CustomModelValue
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L4)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L5)
 
 ```ts
 export interface CustomModelValue {
@@ -1376,13 +1433,14 @@ export interface CustomModelValue {
 
 ### createFeatureDialogFrame
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L8)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L10)
 
 ```ts
 export declare function createFeatureDialogFrame(options?: FeatureDialogOptions): UIBlock<FeatureDialogState> & {
     open(state: FeatureDialogState): void;
     close(): void;
     fail(message: string): void;
+    isOpen(): boolean;
 };
 ```
 
@@ -1392,7 +1450,7 @@ Related gallery: [feature-dialog](https://minifish-org.github.io/pith-ui/?item=f
 
 ### createFeatureStatus
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L38)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L57)
 
 ```ts
 export declare function createFeatureStatus(state: {
@@ -1410,7 +1468,7 @@ Related gallery: [feature-dialog](https://minifish-org.github.io/pith-ui/?item=f
 
 ### createSDKDialogElements
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L43)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L63)
 
 ```ts
 export declare function createSDKDialogElements(options?: {
@@ -1428,7 +1486,7 @@ Related gallery: [feature-dialog](https://minifish-org.github.io/pith-ui/?item=f
 
 ### DialogContent
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L7)
 
 ```ts
 export interface DialogContent {
@@ -1439,7 +1497,7 @@ export interface DialogContent {
 
 ### FeatureDialogOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L7)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L9)
 
 ```ts
 export interface FeatureDialogOptions {
@@ -1449,12 +1507,13 @@ export interface FeatureDialogOptions {
     titleId?: string;
     errorId?: string;
     eyebrow?: string;
+    onClose?: () => void;
 }
 ```
 
 ### FeatureDialogState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L6)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L8)
 
 ```ts
 export interface FeatureDialogState {
@@ -1512,31 +1571,52 @@ Referenced public types and APIs: [`BranchHistoryNode`](#branchhistorynode).
 
 ### createModelEditor
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L9)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L37)
 
 ```ts
 export declare function createModelEditor(initial: ModelEditorState, options?: {
     prefix?: string;
     element?: HTMLElement;
     onChange?: (selection: ModelSelection) => void;
-}): UIBlock<ModelEditorState> & {
+}): ModelEditorBlock;
+```
+
+Referenced public types and APIs: [`ModelEditorBlock`](#modeleditorblock), [`ModelEditorState`](#modeleditorstate), [`ModelSelection`](#modelselection).
+
+Related gallery: [model-picker](https://minifish-org.github.io/pith-ui/?item=model-picker).
+
+### ModelEditorBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L30)
+
+```ts
+export interface ModelEditorBlock extends UIBlock<ModelEditorState> {
     read(): ModelSelection;
-};
+    reset(selection: ModelSelection): void;
+    focus(): void;
+}
 ```
 
 Referenced public types and APIs: [`ModelEditorState`](#modeleditorstate), [`ModelSelection`](#modelselection), [`UIBlock`](#uiblock).
 
-Related gallery: [model-picker](https://minifish-org.github.io/pith-ui/?item=model-picker).
+### modelEditorMarkup
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L36)
+
+```ts
+export declare function modelEditorMarkup(prefix: string): string;
+```
 
 ### ModelEditorState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L6)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L19)
 
 ```ts
 export interface ModelEditorState {
     providers: readonly ModelProviderOption[] | null;
     models: readonly ModelOption[] | null;
     selection: ModelSelection;
+    disabled?: boolean;
 }
 ```
 
@@ -1544,7 +1624,7 @@ Referenced public types and APIs: [`ModelOption`](#modeloption), [`ModelProvider
 
 ### ModelOption
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L10)
 
 ```ts
 export interface ModelOption {
@@ -1573,7 +1653,7 @@ export interface ModelProviderOption {
 
 ### ModelSelection
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L7)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L25)
 
 ```ts
 export interface ModelSelection {
@@ -1585,7 +1665,7 @@ export interface ModelSelection {
 
 ### thinkingLabel
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L8)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L35)
 
 ```ts
 export declare function thinkingLabel(level: string): string;
@@ -1595,7 +1675,7 @@ export declare function thinkingLabel(level: string): string;
 
 ### createMCPConnectionList
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L130)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L191)
 
 ```ts
 export declare function createMCPConnectionList(initial: MCPConnectionListState): UIBlock<MCPConnectionListState>;
@@ -1607,43 +1687,47 @@ Related gallery: [mcp-connections](https://minifish-org.github.io/pith-ui/?item=
 
 ### createMCPConnectionsPanel
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L95)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L138)
 
 ```ts
-export declare function createMCPConnectionsPanel(state?: FormFeedback, options?: FormOptions): MCPConnectionsPanel;
+export declare function createMCPConnectionsPanel(state?: MCPConnectionsState, options?: FormOptions & {
+    onSubmit?: (draft: MCPConnectionDraft) => ActionResult | Promise<ActionResult>;
+}): MCPConnectionsPanel;
 ```
 
-Referenced public types and APIs: [`FormFeedback`](#formfeedback), [`FormOptions`](#formoptions), [`MCPConnectionsPanel`](#mcpconnectionspanel).
+Referenced public types and APIs: [`ActionResult`](#actionresult), [`FormOptions`](#formoptions), [`MCPConnectionDraft`](#mcpconnectiondraft), [`MCPConnectionsPanel`](#mcpconnectionspanel), [`MCPConnectionsState`](#mcpconnectionsstate).
 
 Related gallery: [mcp-connections](https://minifish-org.github.io/pith-ui/?item=mcp-connections).
 
 ### createModelPicker
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L121)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L174)
 
 ```ts
-export declare function createModelPicker(state?: FormFeedback, options?: FormOptions): FormDOMBlock<FormFeedback>;
+export declare function createModelPicker(state?: ModelPickerState, options?: FormOptions & {
+    onSubmit?: (selection: ModelSelection) => ActionResult | Promise<ActionResult>;
+}): ModelPicker;
 ```
 
-Referenced public types and APIs: [`FormDOMBlock`](#formdomblock), [`FormFeedback`](#formfeedback), [`FormOptions`](#formoptions).
+Referenced public types and APIs: [`ActionResult`](#actionresult), [`FormOptions`](#formoptions), [`ModelPicker`](#modelpicker), [`ModelPickerState`](#modelpickerstate), [`ModelSelection`](#modelselection).
 
 Related gallery: [model-picker](https://minifish-org.github.io/pith-ui/?item=model-picker).
 
 ### createSettingsPanel
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L37)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L45)
 
 ```ts
-export declare function createSettingsPanel(state: SettingsPanelState, options?: FormOptions): FormDOMBlock<SettingsPanelState>;
+export declare function createSettingsPanel(state: SettingsPanelState, options?: SettingsPanelOptions): SettingsPanel;
 ```
 
-Referenced public types and APIs: [`FormDOMBlock`](#formdomblock), [`FormOptions`](#formoptions), [`SettingsPanelState`](#settingspanelstate).
+Referenced public types and APIs: [`SettingsPanel`](#settingspanel), [`SettingsPanelOptions`](#settingspaneloptions), [`SettingsPanelState`](#settingspanelstate).
 
 Related gallery: [settings-panel](https://minifish-org.github.io/pith-ui/?item=settings-panel).
 
 ### FormDOMBlock
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L6)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L9)
 
 ```ts
 export interface FormDOMBlock<State extends FormFeedback> extends UIBlock<State> {
@@ -1656,7 +1740,7 @@ Referenced public types and APIs: [`FormFeedback`](#formfeedback), [`UIBlock`](#
 
 ### FormFeedback
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L8)
 
 ```ts
 export interface FormFeedback {
@@ -1667,7 +1751,7 @@ export interface FormFeedback {
 
 ### FormOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L36)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L39)
 
 ```ts
 export interface FormOptions {
@@ -1675,9 +1759,31 @@ export interface FormOptions {
 }
 ```
 
+### MCPConnectionDraft
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L135)
+
+```ts
+export interface MCPConnectionDraft {
+    name: string;
+    type: 'http' | 'stdio';
+    url: string;
+    oauth: boolean;
+    oauthClientId: string;
+    oauthScope: string;
+    command: string;
+    args: string;
+    enabled: boolean;
+    bearerToken: string;
+    clearBearerToken: boolean;
+    env: string;
+    clearEnv: boolean;
+}
+```
+
 ### MCPConnectionItem
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L124)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L185)
 
 ```ts
 export interface MCPConnectionItem {
@@ -1699,7 +1805,7 @@ export interface MCPConnectionItem {
 
 ### MCPConnectionListState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L128)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L189)
 
 ```ts
 export interface MCPConnectionListState extends FormFeedback {
@@ -1711,20 +1817,37 @@ Referenced public types and APIs: [`FormFeedback`](#formfeedback), [`MCPConnecti
 
 ### MCPConnectionsPanel
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L94)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L137)
 
 ```ts
-export interface MCPConnectionsPanel extends FormDOMBlock<FormFeedback> {
+export interface MCPConnectionsPanel extends FormDOMBlock<MCPConnectionsState> {
     renderType(): void;
     edit(value?: MCPEditorValue): void;
+    read(): MCPConnectionDraft;
+    clearBearerToken(): void;
+    clearSecrets(): void;
+    toggleEnvironment(): void;
+    readonly list: HTMLElement;
 }
 ```
 
-Referenced public types and APIs: [`FormDOMBlock`](#formdomblock), [`FormFeedback`](#formfeedback), [`MCPEditorValue`](#mcpeditorvalue).
+Referenced public types and APIs: [`FormDOMBlock`](#formdomblock), [`MCPConnectionDraft`](#mcpconnectiondraft), [`MCPConnectionsState`](#mcpconnectionsstate), [`MCPEditorValue`](#mcpeditorvalue).
+
+### MCPConnectionsState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L136)
+
+```ts
+export interface MCPConnectionsState extends FormFeedback {
+    formError?: string;
+}
+```
+
+Referenced public types and APIs: [`FormFeedback`](#formfeedback).
 
 ### MCPEditorValue
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L93)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L134)
 
 ```ts
 export interface MCPEditorValue {
@@ -1742,32 +1865,142 @@ export interface MCPEditorValue {
 }
 ```
 
-### modelEditorMarkup
+### ModelPicker
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L120)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L173)
 
 ```ts
-export declare function modelEditorMarkup(prefix: string): string;
+export interface ModelPicker extends FormDOMBlock<ModelPickerState> {
+    read(): ModelSelection;
+    reset(selection: ModelSelection): void;
+    focus(): void;
+}
 ```
 
+Referenced public types and APIs: [`FormDOMBlock`](#formdomblock), [`ModelPickerState`](#modelpickerstate), [`ModelSelection`](#modelselection).
+
+### ModelPickerState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L172)
+
+```ts
+export interface ModelPickerState extends FormFeedback {
+    editor?: ModelEditorState;
+    loading?: boolean;
+}
+```
+
+Referenced public types and APIs: [`FormFeedback`](#formfeedback), [`ModelEditorState`](#modeleditorstate).
+
+### SettingsCredentialView
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L42)
+
+```ts
+export interface SettingsCredentialView {
+    status: string;
+    hidden: boolean;
+    required: boolean;
+    placeholder: string;
+    removeVisible: boolean;
+    hint?: string;
+    actions?: Node;
+}
+```
+
+### SettingsDraft
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L40)
+
+```ts
+export interface SettingsDraft {
+    provider: string;
+    baseUrl: string;
+    apiKey: string;
+}
+```
+
+### SettingsPanel
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L43)
+
+```ts
+export interface SettingsPanel extends FormDOMBlock<SettingsPanelState> {
+    read(): SettingsDraft;
+    setProviders(providers: readonly SettingsProviderOption[], selected?: string): void;
+    resetProvider(value: {
+        provider: string;
+        baseUrl: string;
+        clearKey?: boolean;
+        collapseAdvanced?: boolean;
+    }): void;
+    setCredential(view: SettingsCredentialView): void;
+    clearSecrets(): void;
+    readonly updates: HTMLElement;
+}
+```
+
+Referenced public types and APIs: [`FormDOMBlock`](#formdomblock), [`SettingsCredentialView`](#settingscredentialview), [`SettingsDraft`](#settingsdraft), [`SettingsPanelState`](#settingspanelstate), [`SettingsProviderOption`](#settingsprovideroption).
+
+### SettingsPanelOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L44)
+
+```ts
+export interface SettingsPanelOptions extends FormOptions {
+    onAppearanceChange?: (mode: string) => void;
+    onProviderChange?: (provider: string) => void;
+    onDraftChange?: (draft: SettingsDraft) => void;
+    onSubmit?: (draft: SettingsDraft) => ActionResult | Promise<ActionResult>;
+    onTest?: (draft: SettingsDraft) => void;
+    onRemoveKey?: (draft: SettingsDraft) => ActionResult | Promise<ActionResult>;
+}
+```
+
+Referenced public types and APIs: [`ActionResult`](#actionresult), [`FormOptions`](#formoptions), [`SettingsDraft`](#settingsdraft).
+
 ### SettingsPanelState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L35)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L38)
 
 ```ts
 export interface SettingsPanelState extends FormFeedback {
     baseUrl: string;
     hasApiKey: boolean;
+    ready?: boolean;
+    testing?: boolean;
+    appearance?: {
+        mode: 'light' | 'dark' | 'system';
+        disabled?: boolean;
+        error?: string;
+    };
+    testResult?: {
+        message: string;
+        ok?: boolean;
+    };
 }
 ```
 
 Referenced public types and APIs: [`FormFeedback`](#formfeedback).
 
+### SettingsProviderOption
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L41)
+
+```ts
+export interface SettingsProviderOption {
+    id: string;
+    name: string;
+    configured?: boolean;
+    signedIn?: boolean;
+}
+```
+
 ## src/forms/provider-login.ts
 
 ### createProviderLoginPanel
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/provider-login.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/provider-login.ts#L6)
 
 ```ts
 export declare function createProviderLoginPanel(initial: ProviderLoginState, options?: {
@@ -1784,7 +2017,7 @@ Related gallery: [provider-login](https://minifish-org.github.io/pith-ui/?item=p
 
 ### ProviderLoginState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/provider-login.ts#L4)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/provider-login.ts#L5)
 
 ```ts
 export interface ProviderLoginState {
@@ -1807,28 +2040,38 @@ export interface ProviderLoginState {
 
 ### createResourceEditor
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/resource-editor.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/resource-editor.ts#L7)
 
 ```ts
 export declare function createResourceEditor(state: ResourceEditorState, options?: {
     idPrefix?: string;
+    onSubmit?: (draft: ResourceDraft) => ActionResult | Promise<ActionResult>;
+    onDelete?: () => void;
 }): UIBlock<ResourceEditorState> & {
-    read(): {
-        name: string;
-        content: string;
-    };
+    read(): ResourceDraft;
     readonly form: HTMLFormElement;
     readonly removeButton: HTMLButtonElement | null;
 };
 ```
 
-Referenced public types and APIs: [`ResourceEditorState`](#resourceeditorstate), [`UIBlock`](#uiblock).
+Referenced public types and APIs: [`ActionResult`](#actionresult), [`ResourceDraft`](#resourcedraft), [`ResourceEditorState`](#resourceeditorstate), [`UIBlock`](#uiblock).
 
 Related gallery: [resource-editor](https://minifish-org.github.io/pith-ui/?item=resource-editor).
 
+### ResourceDraft
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/resource-editor.ts#L6)
+
+```ts
+export interface ResourceDraft {
+    name: string;
+    content: string;
+}
+```
+
 ### ResourceEditorState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/resource-editor.ts#L4)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/resource-editor.ts#L5)
 
 ```ts
 export interface ResourceEditorState {
@@ -1836,6 +2079,7 @@ export interface ResourceEditorState {
     workspacePath: string;
     path?: string;
     kind: string;
+    name?: string;
     content: string;
     editable: boolean;
     workspaceBusy: boolean;
@@ -1848,7 +2092,7 @@ export interface ResourceEditorState {
 
 ### createContextMenu
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/context-menu.ts#L7)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/context-menu.ts#L9)
 
 ```ts
 export declare function createContextMenu(options?: {
@@ -1867,10 +2111,11 @@ Related gallery: [context-menu](https://minifish-org.github.io/pith-ui/?item=con
 
 ### ContextMenuItem
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/context-menu.ts#L2)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/context-menu.ts#L4)
 
 ```ts
 export interface ContextMenuItem {
+    id?: string;
     label: string;
     action?: string;
     sdkAction?: string;
@@ -1885,7 +2130,7 @@ export interface ContextMenuItem {
 
 ### ContextMenuState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/context-menu.ts#L6)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/context-menu.ts#L8)
 
 ```ts
 export interface ContextMenuState {
@@ -1900,24 +2145,19 @@ Referenced public types and APIs: [`ContextMenuItem`](#contextmenuitem).
 
 ### createRenameConversation
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L63)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L85)
 
 ```ts
-export declare function createRenameConversation(initial: RenameConversationState, options?: {
-    idPrefix?: string;
-}): UIBlock<RenameConversationState> & {
-    readonly input: HTMLInputElement;
-    readonly form: HTMLFormElement;
-};
+export declare function createRenameConversation(initial: RenameConversationState, options?: RenameConversationOptions): RenameConversationBlock;
 ```
 
-Referenced public types and APIs: [`RenameConversationState`](#renameconversationstate), [`UIBlock`](#uiblock).
+Referenced public types and APIs: [`RenameConversationBlock`](#renameconversationblock), [`RenameConversationOptions`](#renameconversationoptions), [`RenameConversationState`](#renameconversationstate).
 
 Related gallery: [rename-conversation](https://minifish-org.github.io/pith-ui/?item=rename-conversation).
 
 ### createWorkspaceNavigation
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L9)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L11)
 
 ```ts
 export declare function createWorkspaceNavigation(initial: WorkspaceNavigationState, options?: {
@@ -1934,25 +2174,19 @@ Related gallery: [workspace-navigation](https://minifish-org.github.io/pith-ui/?
 
 ### createWorkspacePicker
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L70)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L137)
 
 ```ts
-export declare function createWorkspacePicker(initial: WorkspacePickerState, options?: {
-    idPrefix?: string;
-}): UIBlock<WorkspacePickerState> & {
-    readonly input: HTMLInputElement;
-    readonly form: HTMLFormElement;
-    readonly pickButton: HTMLButtonElement;
-};
+export declare function createWorkspacePicker(initial: WorkspacePickerState, options?: WorkspacePickerOptions): WorkspacePickerBlock;
 ```
 
-Referenced public types and APIs: [`UIBlock`](#uiblock), [`WorkspacePickerState`](#workspacepickerstate).
+Referenced public types and APIs: [`WorkspacePickerBlock`](#workspacepickerblock), [`WorkspacePickerOptions`](#workspacepickeroptions), [`WorkspacePickerState`](#workspacepickerstate).
 
 Related gallery: [workspace-picker](https://minifish-org.github.io/pith-ui/?item=workspace-picker).
 
 ### NavigationConversation
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L4)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L6)
 
 ```ts
 export interface NavigationConversation {
@@ -1966,7 +2200,7 @@ export interface NavigationConversation {
 
 ### NavigationWorkspace
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L7)
 
 ```ts
 export interface NavigationWorkspace {
@@ -1982,9 +2216,55 @@ export interface NavigationWorkspace {
 
 Referenced public types and APIs: [`NavigationConversation`](#navigationconversation).
 
+### RenameConversationBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L76)
+
+```ts
+export interface RenameConversationBlock extends UIBlock<RenameConversationState> {
+    readonly input: HTMLInputElement;
+    readonly form: HTMLFormElement;
+    read(): RenameConversationDraft;
+    reset(state: RenameConversationState): void;
+    open(state?: RenameConversationState): void;
+    close(): void;
+    focus(): void;
+}
+```
+
+Referenced public types and APIs: [`RenameConversationDraft`](#renameconversationdraft), [`RenameConversationState`](#renameconversationstate), [`UIBlock`](#uiblock).
+
+### RenameConversationDraft
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L67)
+
+```ts
+export interface RenameConversationDraft {
+    id: string;
+    title: string;
+}
+```
+
+### RenameConversationOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L68)
+
+```ts
+export interface RenameConversationOptions {
+    idPrefix?: string;
+    dialog?: HTMLDialogElement;
+    unavailable?: () => boolean;
+    onSubmit?: (draft: RenameConversationDraft) => Promise<ActionResult> | ActionResult;
+    onSubmitted?: () => void;
+    onCancel?: () => void;
+}
+```
+
+Referenced public types and APIs: [`ActionResult`](#actionresult), [`RenameConversationDraft`](#renameconversationdraft).
+
 ### RenameConversationState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L62)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L66)
 
 ```ts
 export interface RenameConversationState {
@@ -1997,7 +2277,7 @@ export interface RenameConversationState {
 
 ### WorkspaceNavigationState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L6)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L8)
 
 ```ts
 export interface WorkspaceNavigationState {
@@ -2009,9 +2289,52 @@ export interface WorkspaceNavigationState {
 
 Referenced public types and APIs: [`NavigationWorkspace`](#navigationworkspace).
 
+### WorkspacePickerBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L127)
+
+```ts
+export interface WorkspacePickerBlock extends UIBlock<WorkspacePickerState> {
+    readonly input: HTMLInputElement;
+    readonly form: HTMLFormElement;
+    readonly pickButton: HTMLButtonElement;
+    read(): {
+        path: string;
+    };
+    reset(path?: string): void;
+    open(): void;
+    close(): void;
+    focus(): void;
+}
+```
+
+Referenced public types and APIs: [`UIBlock`](#uiblock), [`WorkspacePickerState`](#workspacepickerstate).
+
+### WorkspacePickerOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L117)
+
+```ts
+export interface WorkspacePickerOptions {
+    idPrefix?: string;
+    dialog?: HTMLDialogElement;
+    unavailable?: () => boolean;
+    onSubmit?: (path: string) => Promise<ActionResult> | ActionResult;
+    onPick?: () => Promise<{
+        path?: string;
+        error?: string;
+    }>;
+    onSelect?: (id: string) => void;
+    onSubmitted?: () => void;
+    onCancel?: () => void;
+}
+```
+
+Referenced public types and APIs: [`ActionResult`](#actionresult).
+
 ### WorkspacePickerState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L69)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L116)
 
 ```ts
 export interface WorkspacePickerState {
@@ -2029,7 +2352,7 @@ export interface WorkspacePickerState {
 
 ### createActions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L346)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L294)
 
 ```ts
 export declare function createActions(options?: ActionsState & {
@@ -2043,7 +2366,7 @@ Related gallery: [actions](https://minifish-org.github.io/pith-ui/?item=actions)
 
 ### createButton
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L21)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L25)
 
 ```ts
 export declare function createButton(options: ButtonOptions): ButtonBlock;
@@ -2051,11 +2374,11 @@ export declare function createButton(options: ButtonOptions): ButtonBlock;
 
 Referenced public types and APIs: [`ButtonBlock`](#buttonblock), [`ButtonOptions`](#buttonoptions).
 
-Related gallery: [actions](https://minifish-org.github.io/pith-ui/?item=actions), [button](https://minifish-org.github.io/pith-ui/?item=button), [confirmation](https://minifish-org.github.io/pith-ui/?item=confirmation), [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu), [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader), [copy-feedback](https://minifish-org.github.io/pith-ui/?item=copy-feedback), [dialog](https://minifish-org.github.io/pith-ui/?item=dialog), [drop-feedback](https://minifish-org.github.io/pith-ui/?item=drop-feedback), [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog), [foundation-colors](https://minifish-org.github.io/pith-ui/?item=foundation-colors), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [image-viewer](https://minifish-org.github.io/pith-ui/?item=image-viewer), [list-row](https://minifish-org.github.io/pith-ui/?item=list-row), [resources-panel](https://minifish-org.github.io/pith-ui/?item=resources-panel), [runtime-panel](https://minifish-org.github.io/pith-ui/?item=runtime-panel), [text-edit-dialog](https://minifish-org.github.io/pith-ui/?item=text-edit-dialog), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar).
+Related gallery: [actions](https://minifish-org.github.io/pith-ui/?item=actions), [button](https://minifish-org.github.io/pith-ui/?item=button), [confirmation](https://minifish-org.github.io/pith-ui/?item=confirmation), [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu), [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader), [copy-feedback](https://minifish-org.github.io/pith-ui/?item=copy-feedback), [dialog](https://minifish-org.github.io/pith-ui/?item=dialog), [drop-feedback](https://minifish-org.github.io/pith-ui/?item=drop-feedback), [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog), [foundation-colors](https://minifish-org.github.io/pith-ui/?item=foundation-colors), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [image-viewer](https://minifish-org.github.io/pith-ui/?item=image-viewer), [list-row](https://minifish-org.github.io/pith-ui/?item=list-row), [runtime-panel](https://minifish-org.github.io/pith-ui/?item=runtime-panel), [text-edit-dialog](https://minifish-org.github.io/pith-ui/?item=text-edit-dialog), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar).
 
 ### createCheckbox
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L294)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L247)
 
 ```ts
 export declare function createCheckbox(options: CheckboxState & {
@@ -2070,7 +2393,7 @@ Related gallery: [checkbox](https://minifish-org.github.io/pith-ui/?item=checkbo
 
 ### createCollectionState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L382)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L331)
 
 ```ts
 export declare function createCollectionState(options: CollectionState & {
@@ -2085,7 +2408,7 @@ Related gallery: [collection-state](https://minifish-org.github.io/pith-ui/?item
 
 ### createConfirmDialog
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L513)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L446)
 
 ```ts
 export declare function createConfirmDialog(options: ConfirmState & {
@@ -2108,7 +2431,7 @@ Related gallery: [confirmation](https://minifish-org.github.io/pith-ui/?item=con
 
 ### createDialog
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L404)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L353)
 
 ```ts
 export declare function createDialog(options: DialogOptions): DialogBlock;
@@ -2120,7 +2443,7 @@ Related gallery: [dialog](https://minifish-org.github.io/pith-ui/?item=dialog).
 
 ### createDisclosure
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L353)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L302)
 
 ```ts
 export declare function createDisclosure(options: DisclosureState & {
@@ -2136,7 +2459,7 @@ Related gallery: [disclosure](https://minifish-org.github.io/pith-ui/?item=discl
 
 ### createDivider
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L100)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L73)
 
 ```ts
 export declare function createDivider(state?: {
@@ -2152,7 +2475,7 @@ Related gallery: [divider](https://minifish-org.github.io/pith-ui/?item=divider)
 
 ### createField
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L146)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L120)
 
 ```ts
 export declare function createField(options: FieldState & {
@@ -2166,7 +2489,7 @@ Related gallery: [number-input](https://minifish-org.github.io/pith-ui/?item=num
 
 ### createFormSection
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L338)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L286)
 
 ```ts
 export declare function createFormSection(options: FormSectionState & {
@@ -2180,7 +2503,7 @@ Related gallery: [form-section](https://minifish-org.github.io/pith-ui/?item=for
 
 ### createIcon
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L89)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L62)
 
 ```ts
 export declare function createIcon(state: IconState): UIBlock<IconState>;
@@ -2192,7 +2515,7 @@ Related gallery: [foundation-sizing](https://minifish-org.github.io/pith-ui/?ite
 
 ### createIconButton
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L67)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L40)
 
 ```ts
 export declare function createIconButton(options: ButtonOptions & {
@@ -2206,7 +2529,7 @@ Related gallery: [icon-button](https://minifish-org.github.io/pith-ui/?item=icon
 
 ### createKeyValue
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L107)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L80)
 
 ```ts
 export declare function createKeyValue(options: KeyValueState): UIBlock<KeyValueState>;
@@ -2218,7 +2541,7 @@ Related gallery: [foundation-motion](https://minifish-org.github.io/pith-ui/?ite
 
 ### createListRow
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L367)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L316)
 
 ```ts
 export declare function createListRow(options: ListRowState & {
@@ -2232,7 +2555,7 @@ Related gallery: [collection-state](https://minifish-org.github.io/pith-ui/?item
 
 ### createMenu
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L585)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L518)
 
 ```ts
 export declare function createMenu(options: MenuState): PopoverBlock & UIBlock<MenuState>;
@@ -2244,7 +2567,7 @@ Related gallery: [menu](https://minifish-org.github.io/pith-ui/?item=menu).
 
 ### createNotice
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L310)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L262)
 
 ```ts
 export declare function createNotice(state: NoticeState): UIBlock<NoticeState>;
@@ -2256,7 +2579,7 @@ Related gallery: [notice](https://minifish-org.github.io/pith-ui/?item=notice).
 
 ### createNumberInput
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L225)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L186)
 
 ```ts
 export declare const createNumberInput: (options: InputOptions) => InputBlock;
@@ -2268,7 +2591,7 @@ Related gallery: [number-input](https://minifish-org.github.io/pith-ui/?item=num
 
 ### createPopover
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L560)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L493)
 
 ```ts
 export declare function createPopover(options: PopoverState & {
@@ -2283,7 +2606,7 @@ Related gallery: [popover](https://minifish-org.github.io/pith-ui/?item=popover)
 
 ### createProgress
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L327)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L275)
 
 ```ts
 export declare function createProgress(state: ProgressState): UIBlock<ProgressState>;
@@ -2295,7 +2618,7 @@ Related gallery: [progress](https://minifish-org.github.io/pith-ui/?item=progres
 
 ### createScrollArea
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L129)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L103)
 
 ```ts
 export declare function createScrollArea(options: ScrollAreaState & {
@@ -2309,7 +2632,7 @@ Related gallery: [scroll-area](https://minifish-org.github.io/pith-ui/?item=scro
 
 ### createSearchInput
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L224)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L185)
 
 ```ts
 export declare const createSearchInput: (options: InputOptions) => InputBlock;
@@ -2321,7 +2644,7 @@ Related gallery: [search-input](https://minifish-org.github.io/pith-ui/?item=sea
 
 ### createSecretInput
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L228)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L189)
 
 ```ts
 export declare function createSecretInput(options: InputOptions): InputBlock;
@@ -2333,7 +2656,7 @@ Related gallery: [secret-input](https://minifish-org.github.io/pith-ui/?item=sec
 
 ### createSelect
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L256)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L217)
 
 ```ts
 export declare function createSelect(options: SelectOptions): SelectBlock;
@@ -2345,7 +2668,7 @@ Related gallery: [foundation-sizing](https://minifish-org.github.io/pith-ui/?ite
 
 ### createStatus
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L321)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L268)
 
 ```ts
 export declare function createStatus(state: StatusState): UIBlock<StatusState>;
@@ -2357,7 +2680,7 @@ Related gallery: [status](https://minifish-org.github.io/pith-ui/?item=status).
 
 ### createTextAction
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L80)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L53)
 
 ```ts
 export declare function createTextAction(options: ButtonOptions): ButtonBlock;
@@ -2369,7 +2692,7 @@ Related gallery: [text-action](https://minifish-org.github.io/pith-ui/?item=text
 
 ### createTextArea
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L226)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L187)
 
 ```ts
 export declare const createTextArea: (options: InputOptions) => InputBlock;
@@ -2381,7 +2704,7 @@ Related gallery: [foundation-typography](https://minifish-org.github.io/pith-ui/
 
 ### createTextEditDialog
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L462)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L395)
 
 ```ts
 export declare function createTextEditDialog(options?: TextEditOptions): TextEditBlock;
@@ -2393,7 +2716,7 @@ Related gallery: [pending-messages](https://minifish-org.github.io/pith-ui/?item
 
 ### createTextInput
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L223)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L184)
 
 ```ts
 export declare const createTextInput: (options: InputOptions) => InputBlock;
@@ -2405,7 +2728,7 @@ Related gallery: [form-section](https://minifish-org.github.io/pith-ui/?item=for
 
 ### createToolbar
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L122)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L95)
 
 ```ts
 export declare function createToolbar(options: ToolbarState & {
@@ -2419,7 +2742,7 @@ Related gallery: [button](https://minifish-org.github.io/pith-ui/?item=button),
 
 ### ActionsState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L345)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L293)
 
 ```ts
 export interface ActionsState {
@@ -2429,7 +2752,7 @@ export interface ActionsState {
 
 ### ButtonBlock
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L19)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L23)
 
 ```ts
 export interface ButtonBlock extends UIBlock<ButtonState> {
@@ -2441,7 +2764,7 @@ Referenced public types and APIs: [`ButtonState`](#buttonstate), [`UIBlock`](#ui
 
 ### ButtonOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L14)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L18)
 
 ```ts
 export interface ButtonOptions extends ButtonState {
@@ -2455,7 +2778,7 @@ Referenced public types and APIs: [`ButtonState`](#buttonstate), [`UIAction`](#u
 
 ### ButtonState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L7)
 
 ```ts
 export interface ButtonState {
@@ -2466,6 +2789,8 @@ export interface ButtonState {
     pending?: boolean;
     icon?: string;
     title?: string;
+    /** Secondary product action, including the accepted compact application style. */
+    appearance?: 'standard' | 'secondary';
 }
 ```
 
@@ -2473,7 +2798,7 @@ Referenced public types and APIs: [`Density`](#density), [`Intent`](#intent).
 
 ### CheckboxBlock
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L288)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L241)
 
 ```ts
 export interface CheckboxBlock extends UIBlock<CheckboxState> {
@@ -2488,7 +2813,7 @@ Referenced public types and APIs: [`CheckboxState`](#checkboxstate), [`UIBlock`]
 
 ### CheckboxState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L287)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L240)
 
 ```ts
 export interface CheckboxState {
@@ -2500,7 +2825,7 @@ export interface CheckboxState {
 
 ### CollectionState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L381)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L330)
 
 ```ts
 export interface CollectionState {
@@ -2512,7 +2837,7 @@ export interface CollectionState {
 
 ### ConfirmBlock
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L512)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L445)
 
 ```ts
 export interface ConfirmBlock extends UIBlock<ConfirmState> {
@@ -2521,6 +2846,7 @@ export interface ConfirmBlock extends UIBlock<ConfirmState> {
     readonly cancelButton: HTMLButtonElement;
     open(state?: ConfirmState): void;
     close(): void;
+    refreshAvailability(): void;
 }
 ```
 
@@ -2528,7 +2854,7 @@ Referenced public types and APIs: [`ConfirmState`](#confirmstate), [`UIBlock`](#
 
 ### ConfirmState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L511)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L444)
 
 ```ts
 export interface ConfirmState extends DialogState {
@@ -2545,7 +2871,7 @@ Referenced public types and APIs: [`DialogState`](#dialogstate).
 
 ### DialogBlock
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L398)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L347)
 
 ```ts
 export interface DialogBlock extends UIBlock<DialogState> {
@@ -2560,7 +2886,7 @@ Referenced public types and APIs: [`DialogState`](#dialogstate), [`UIBlock`](#ui
 
 ### DialogOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L397)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L346)
 
 ```ts
 export interface DialogOptions extends DialogState {
@@ -2576,7 +2902,7 @@ Referenced public types and APIs: [`DialogState`](#dialogstate).
 
 ### DialogState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L396)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L345)
 
 ```ts
 export interface DialogState {
@@ -2589,7 +2915,7 @@ export interface DialogState {
 
 ### DisclosureBlock
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L352)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L301)
 
 ```ts
 export interface DisclosureBlock extends UIBlock<DisclosureState> {
@@ -2602,7 +2928,7 @@ Referenced public types and APIs: [`DisclosureState`](#disclosurestate), [`UIBlo
 
 ### DisclosureState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L351)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L300)
 
 ```ts
 export interface DisclosureState {
@@ -2614,7 +2940,7 @@ export interface DisclosureState {
 
 ### FieldBlock
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L142)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L116)
 
 ```ts
 export interface FieldBlock extends UIBlock<FieldState> {
@@ -2626,7 +2952,7 @@ Referenced public types and APIs: [`FieldState`](#fieldstate), [`UIBlock`](#uibl
 
 ### FieldState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L135)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L109)
 
 ```ts
 export interface FieldState {
@@ -2640,7 +2966,7 @@ export interface FieldState {
 
 ### FormSectionState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L337)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L285)
 
 ```ts
 export interface FormSectionState {
@@ -2651,7 +2977,7 @@ export interface FormSectionState {
 
 ### IconState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L88)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L61)
 
 ```ts
 export interface IconState {
@@ -2663,7 +2989,7 @@ export interface IconState {
 
 ### InputBlock
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L191)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L155)
 
 ```ts
 export interface InputBlock extends UIBlock<InputState> {
@@ -2678,7 +3004,7 @@ Referenced public types and APIs: [`InputState`](#inputstate), [`UIBlock`](#uibl
 
 ### InputOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L182)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L146)
 
 ```ts
 export interface InputOptions extends InputState {
@@ -2696,7 +3022,7 @@ Referenced public types and APIs: [`InputState`](#inputstate).
 
 ### InputState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L177)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L141)
 
 ```ts
 export interface InputState extends FieldState {
@@ -2710,7 +3036,7 @@ Referenced public types and APIs: [`Density`](#density), [`FieldState`](#fieldst
 
 ### KeyValueState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L106)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L79)
 
 ```ts
 export interface KeyValueState {
@@ -2724,7 +3050,7 @@ export interface KeyValueState {
 
 ### ListRowState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L366)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L315)
 
 ```ts
 export interface ListRowState {
@@ -2738,7 +3064,7 @@ export interface ListRowState {
 
 ### MenuItem
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L583)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L516)
 
 ```ts
 export interface MenuItem {
@@ -2755,7 +3081,7 @@ Referenced public types and APIs: [`Intent`](#intent), [`UIAction`](#uiaction).
 
 ### MenuState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L584)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L517)
 
 ```ts
 export interface MenuState extends PopoverState {
@@ -2767,7 +3093,7 @@ Referenced public types and APIs: [`MenuItem`](#menuitem), [`PopoverState`](#pop
 
 ### NoticeState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L309)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L261)
 
 ```ts
 export interface NoticeState {
@@ -2778,7 +3104,7 @@ export interface NoticeState {
 
 ### PopoverBlock
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L553)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L486)
 
 ```ts
 export interface PopoverBlock extends UIBlock<PopoverState> {
@@ -2794,7 +3120,7 @@ Referenced public types and APIs: [`PopoverState`](#popoverstate), [`UIBlock`](#
 
 ### PopoverState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L552)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L485)
 
 ```ts
 export interface PopoverState {
@@ -2805,7 +3131,7 @@ export interface PopoverState {
 
 ### ProgressState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L326)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L274)
 
 ```ts
 export interface ProgressState {
@@ -2817,7 +3143,7 @@ export interface ProgressState {
 
 ### ScrollAreaState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L128)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L102)
 
 ```ts
 export interface ScrollAreaState {
@@ -2828,7 +3154,7 @@ export interface ScrollAreaState {
 
 ### SelectBlock
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L250)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L211)
 
 ```ts
 export interface SelectBlock extends UIBlock<SelectState> {
@@ -2843,7 +3169,7 @@ Referenced public types and APIs: [`SelectState`](#selectstate), [`UIBlock`](#ui
 
 ### SelectOption
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L247)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L208)
 
 ```ts
 export interface SelectOption {
@@ -2855,7 +3181,7 @@ export interface SelectOption {
 
 ### SelectOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L249)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L210)
 
 ```ts
 export interface SelectOptions extends SelectState {
@@ -2870,7 +3196,7 @@ Referenced public types and APIs: [`SelectState`](#selectstate).
 
 ### SelectState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L248)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L209)
 
 ```ts
 export interface SelectState extends FieldState {
@@ -2883,7 +3209,7 @@ Referenced public types and APIs: [`Density`](#density), [`FieldState`](#fieldst
 
 ### StatusState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L320)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L267)
 
 ```ts
 export interface StatusState {
@@ -2894,7 +3220,7 @@ export interface StatusState {
 
 ### TextEditBlock
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L453)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L386)
 
 ```ts
 export interface TextEditBlock extends Omit<UIBlock<TextEditState>, 'element'> {
@@ -2912,7 +3238,7 @@ Referenced public types and APIs: [`TextEditInput`](#texteditinput), [`TextEditS
 
 ### TextEditInput
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L444)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L377)
 
 ```ts
 export interface TextEditInput {
@@ -2925,7 +3251,7 @@ export interface TextEditInput {
 
 ### TextEditOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L445)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L378)
 
 ```ts
 export interface TextEditOptions extends Partial<TextEditState> {
@@ -2949,7 +3275,7 @@ Referenced public types and APIs: [`ActionResult`](#actionresult), [`TextEditSta
 
 ### TextEditState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L443)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L376)
 
 ```ts
 export interface TextEditState extends DialogState {
@@ -2966,7 +3292,7 @@ Referenced public types and APIs: [`DialogState`](#dialogstate).
 
 ### ToolbarState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L121)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L94)
 
 ```ts
 export interface ToolbarState {
@@ -2981,7 +3307,7 @@ Referenced public types and APIs: [`Density`](#density).
 
 ### createApprovalPanel
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/approval.ts#L7)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/approval.ts#L8)
 
 ```ts
 export declare function createApprovalPanel(initial: ApprovalPanelState, options?: {
@@ -2997,7 +3323,7 @@ Related gallery: [approval-panel](https://minifish-org.github.io/pith-ui/?item=a
 
 ### ApprovalPanelState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/approval.ts#L6)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/approval.ts#L7)
 
 ```ts
 export interface ApprovalPanelState {
@@ -3010,7 +3336,7 @@ Referenced public types and APIs: [`ApprovalView`](#approvalview).
 
 ### ApprovalView
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/approval.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/approval.ts#L6)
 
 ```ts
 export interface ApprovalView {
@@ -3033,23 +3359,21 @@ export interface ApprovalView {
 
 ### createFullAccessConfirmation
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L7)
 
 ```ts
-export declare function createFullAccessConfirmation(initial: FullAccessState, options?: {
-    idPrefix?: string;
-}): UIBlock<FullAccessState> & {
+export declare function createFullAccessConfirmation(initial: FullAccessState, options?: FullAccessOptions): UIBlock<FullAccessState> & {
     readonly confirmButton: HTMLButtonElement;
 };
 ```
 
-Referenced public types and APIs: [`FullAccessState`](#fullaccessstate), [`UIBlock`](#uiblock).
+Referenced public types and APIs: [`FullAccessOptions`](#fullaccessoptions), [`FullAccessState`](#fullaccessstate), [`UIBlock`](#uiblock).
 
 Related gallery: [full-access-confirmation](https://minifish-org.github.io/pith-ui/?item=full-access-confirmation).
 
 ### createPermissionControl
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L19)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L24)
 
 ```ts
 export declare function createPermissionControl(initial: PermissionControlState, options?: {
@@ -3065,7 +3389,7 @@ Related gallery: [permission-control](https://minifish-org.github.io/pith-ui/?it
 
 ### createTaskFailure
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L12)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L17)
 
 ```ts
 export declare function createTaskFailure(initial: TaskFailureState, options?: {
@@ -3080,9 +3404,22 @@ Referenced public types and APIs: [`TaskFailureState`](#taskfailurestate), [`UIB
 
 Related gallery: [task-failure](https://minifish-org.github.io/pith-ui/?item=task-failure).
 
+### FullAccessOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L6)
+
+```ts
+export interface FullAccessOptions {
+    idPrefix?: string;
+    onConfirm?: () => ActionResult | Promise<ActionResult>;
+}
+```
+
+Referenced public types and APIs: [`ActionResult`](#actionresult).
+
 ### FullAccessState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L4)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L5)
 
 ```ts
 export interface FullAccessState {
@@ -3094,7 +3431,7 @@ export interface FullAccessState {
 
 ### PermissionControlState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L18)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L23)
 
 ```ts
 export interface PermissionControlState {
@@ -3106,7 +3443,7 @@ export interface PermissionControlState {
 
 ### TaskFailureState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L11)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L16)
 
 ```ts
 export interface TaskFailureState {
@@ -3194,7 +3531,7 @@ Related gallery: [foundation-colors](https://minifish-org.github.io/pith-ui/?ite
 
 ### createComposerView
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L14)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L31)
 
 ```ts
 export declare function createComposerView(options?: ComposerViewOptions): {
@@ -3205,6 +3542,7 @@ export declare function createComposerView(options?: ComposerViewOptions): {
     reset(value: string): void;
     focus: () => void;
     resize: () => void;
+    pickImages(): void;
     destroy(): void;
 };
 ```
@@ -3215,22 +3553,51 @@ Related gallery: [composer](https://minifish-org.github.io/pith-ui/?item=compose
 
 ### createWorkspaceShell
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L67)
-
-```ts
-export declare function createWorkspaceShell(options: WorkspaceShellOptions): UIBlock<WorkspaceShellState> & {
-    composer: ReturnType<typeof createComposerView>;
-    part<T extends HTMLElement = HTMLElement>(name: string): T;
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L115)
+
+```ts
+export declare function createWorkspaceShell(options: WorkspaceShellOptions): {
+    element: HTMLDivElement;
+    composer: {
+        element: HTMLFormElement;
+        input: HTMLTextAreaElement;
+        update: (state: ComposerViewState) => void;
+        getValue: () => string;
+        reset(value: string): void;
+        focus: () => void;
+        resize: () => void;
+        pickImages(): void;
+        destroy(): void;
+    };
+    part: <T extends HTMLElement = HTMLElement>(name: string) => T;
+    update(state: Readonly<WorkspaceShellState>): void;
+    setSidebarOpen: (open: boolean) => void;
+    openDialog(name: WorkspaceDialogName): void;
+    closeDialog(name: WorkspaceDialogName): void;
+    isDialogOpen(name: WorkspaceDialogName): boolean;
+    updateActionAvailability(unavailable: (scope: ActionScope) => boolean, root?: ParentNode): void;
+    destroy(): void;
 };
 ```
 
-Referenced public types and APIs: [`UIBlock`](#uiblock), [`WorkspaceShellOptions`](#workspaceshelloptions), [`WorkspaceShellState`](#workspaceshellstate), [`createComposerView`](#createcomposerview).
+Referenced public types and APIs: [`ActionScope`](#actionscope), [`ComposerViewState`](#composerviewstate), [`WorkspaceDialogName`](#workspacedialogname), [`WorkspaceShellOptions`](#workspaceshelloptions), [`WorkspaceShellState`](#workspaceshellstate).
 
 Related gallery: [workspace-chat](https://minifish-org.github.io/pith-ui/?item=workspace-chat).
 
+### ActionScope
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L112)
+
+```ts
+export interface ActionScope {
+    kind: 'global' | 'conversation' | 'workspace' | 'active';
+    id?: string;
+}
+```
+
 ### ComposerViewOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L13)
 
 ```ts
 export interface ComposerViewOptions {
@@ -3238,6 +3605,10 @@ export interface ComposerViewOptions {
     onSubmit?: (text: string) => void | ActionResult | Promise<void | ActionResult>;
     onStop?: () => void | ActionResult | Promise<void | ActionResult>;
     onInput?: (text: string) => void;
+    onModel?: () => void;
+    onAttach?: () => void;
+    onImages?: (files: File[]) => void;
+    onThinkingChange?: (value: string) => void;
 }
 ```
 
@@ -3245,7 +3616,7 @@ Referenced public types and APIs: [`ActionResult`](#actionresult).
 
 ### ComposerViewState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L4)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L7)
 
 ```ts
 export interface ComposerViewState {
@@ -3254,28 +3625,64 @@ export interface ComposerViewState {
     readOnly?: boolean;
     action?: 'send' | 'queue' | 'stop';
     actionDisabled?: boolean;
+    model?: {
+        label: string;
+        description: string;
+        disabled?: boolean;
+    };
+    thinking?: {
+        options: readonly {
+            value: string;
+            label: string;
+        }[];
+        value: string;
+        disabled?: boolean;
+    };
 }
 ```
 
+### WorkspaceDialogName
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L111)
+
+```ts
+export type WorkspaceDialogName = 'model' | 'settings' | 'workspace' | 'permissions' | 'delete' | 'rename' | 'queue-edit' | 'message-edit' | 'resources' | 'connections' | 'preview' | 'image';
+```
+
 ### WorkspaceShellOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L65)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L113)
 
 ```ts
 export interface WorkspaceShellOptions {
     brand: Node;
     prefix?: string;
+    composer?: ComposerViewOptions;
+    onDialogClose?: (name: WorkspaceDialogName) => void;
+    onSearch?: (query: string) => void;
+    onBusyAction?: (key: string) => void;
 }
 ```
 
+Referenced public types and APIs: [`ComposerViewOptions`](#composerviewoptions), [`WorkspaceDialogName`](#workspacedialogname).
+
 ### WorkspaceShellState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L66)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L114)
 
 ```ts
 export interface WorkspaceShellState {
     workspace?: string;
     conversation?: string;
     reconnecting?: boolean;
+    error?: {
+        message: string;
+        hidden?: boolean;
+    };
+    busy?: {
+        key: string;
+        message: string;
+        actionLabel: string;
+    } | null;
 }
 ```