pith-ui 0.1.0 → 0.1.4

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.4` 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,13 +17,13 @@ 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) |
 | [`createComposerView`](#createcomposerview) | [composer](https://minifish-org.github.io/pith-ui/?item=composer), [drop-feedback](https://minifish-org.github.io/pith-ui/?item=drop-feedback) |
 | [`createConfirmDialog`](#createconfirmdialog) | [confirmation](https://minifish-org.github.io/pith-ui/?item=confirmation) |
-| [`createContextMenu`](#createcontextmenu) | [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu) |
+| [`createContextMenu`](#createcontextmenu) | [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu), [workspace-navigation](https://minifish-org.github.io/pith-ui/?item=workspace-navigation) |
 | [`createConversationView`](#createconversationview) | [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) |
 | [`createCopyFeedback`](#createcopyfeedback) | [copy-feedback](https://minifish-org.github.io/pith-ui/?item=copy-feedback) |
 | [`createCostLedger`](#createcostledger) | [cost-ledger](https://minifish-org.github.io/pith-ui/?item=cost-ledger) |
@@ -47,7 +47,7 @@ Regenerate: `node scripts/api-docs.ts`. Verify without writing: `node scripts/ap
 | [`createListRow`](#createlistrow) | [collection-state](https://minifish-org.github.io/pith-ui/?item=collection-state), [list-row](https://minifish-org.github.io/pith-ui/?item=list-row) |
 | [`createMCPConnectionList`](#createmcpconnectionlist) | [mcp-connections](https://minifish-org.github.io/pith-ui/?item=mcp-connections) |
 | [`createMCPConnectionsPanel`](#createmcpconnectionspanel) | [mcp-connections](https://minifish-org.github.io/pith-ui/?item=mcp-connections) |
-| [`createMenu`](#createmenu) | [menu](https://minifish-org.github.io/pith-ui/?item=menu) |
+| [`createMenu`](#createmenu) | [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [menu](https://minifish-org.github.io/pith-ui/?item=menu) |
 | [`createModelEditor`](#createmodeleditor) | [model-picker](https://minifish-org.github.io/pith-ui/?item=model-picker) |
 | [`createModelPicker`](#createmodelpicker) | [model-picker](https://minifish-org.github.io/pith-ui/?item=model-picker) |
 | [`createNotice`](#createnotice) | [notice](https://minifish-org.github.io/pith-ui/?item=notice) |
@@ -68,7 +68,7 @@ Regenerate: `node scripts/api-docs.ts`. Verify without writing: `node scripts/ap
 | [`createScrollArea`](#createscrollarea) | [scroll-area](https://minifish-org.github.io/pith-ui/?item=scroll-area) |
 | [`createSearchInput`](#createsearchinput) | [search-input](https://minifish-org.github.io/pith-ui/?item=search-input) |
 | [`createSecretInput`](#createsecretinput) | [secret-input](https://minifish-org.github.io/pith-ui/?item=secret-input) |
-| [`createSelect`](#createselect) | [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [select](https://minifish-org.github.io/pith-ui/?item=select) |
+| [`createSelect`](#createselect) | [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [select](https://minifish-org.github.io/pith-ui/?item=select) |
 | [`createSettingsPanel`](#createsettingspanel) | [settings-panel](https://minifish-org.github.io/pith-ui/?item=settings-panel) |
 | [`createStatus`](#createstatus) | [status](https://minifish-org.github.io/pith-ui/?item=status) |
 | [`createTaskFailure`](#createtaskfailure) | [task-failure](https://minifish-org.github.io/pith-ui/?item=task-failure) |
@@ -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#L67)
 
 ```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#L57)
 
 ```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#L12)
 
 ```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#L55)
 
 ```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#L66)
 
 ```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#L6)
 
 ```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#L8)
 
 ```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#L7)
 
 ```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#L10)
 
 ```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#L94)
 
 ```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#L6)
 
 ```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#L5)
 
 ```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,12 +517,12 @@ 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 {
     container?: HTMLElement;
-    onCopyCode?: (text: string) => void;
+    onCopyCode?: (text: string, button: HTMLButtonElement) => void;
 }
 ```
 
@@ -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<[
@@ -530,7 +572,7 @@ export declare function previewPageRanges(bytes: Uint8Array, window?: number): A
 
 ### createWelcomeView
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/welcome.ts#L17)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/welcome.ts#L18)
 
 ```ts
 export declare function createWelcomeView(options?: WelcomeOptions): UIBlock<WelcomeState>;
@@ -542,7 +584,7 @@ Related gallery: [welcome](https://minifish-org.github.io/pith-ui/?item=welcome)
 
 ### WelcomeOptions
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/welcome.ts#L10)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/welcome.ts#L11)
 
 ```ts
 export interface WelcomeOptions {
@@ -555,7 +597,7 @@ export interface WelcomeOptions {
 
 ### WelcomeState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/welcome.ts#L4)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/welcome.ts#L5)
 
 ```ts
 export interface WelcomeState {
@@ -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-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-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#L43)
 
 ```ts
 export declare function createArtifactPanel(options: ArtifactPanelOptions): {
@@ -793,11 +835,12 @@ 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#L21)
 
 ```ts
 export declare function createFileActions(options: FileActionOptions): {
     element: HTMLElement;
+    setDisabled(disabled: boolean): void;
     destroy(): void;
 };
 ```
@@ -808,7 +851,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#L232)
 
 ```ts
 export declare function createFilePreview(options?: FilePreviewOptions): {
@@ -830,13 +873,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#L113)
 
 ```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 +892,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#L42)
 
 ```ts
 export interface ArtifactPanelOptions {
@@ -857,12 +901,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#L41)
 
 ```ts
 export interface ArtifactPanelState {
@@ -879,7 +924,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#L9)
 
 ```ts
 export interface FileActionOptions {
@@ -894,7 +939,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#L14)
 
 ```ts
 export declare function fileActionsMarkup(options: FileActionOptions): string;
@@ -904,7 +949,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#L231)
 
 ```ts
 export interface FilePreviewOptions {
@@ -913,12 +958,13 @@ export interface FilePreviewOptions {
     dialogId?: string;
     bodyId?: string;
     onClose?: () => void;
+    onCopyCode?: (text: string, button: HTMLButtonElement) => void;
 }
 ```
 
 ### 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#L230)
 
 ```ts
 export interface FilePreviewState {
@@ -935,7 +981,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#L107)
 
 ```ts
 export interface ResourceDisplayEntry {
@@ -950,7 +996,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#L112)
 
 ```ts
 export interface ResourcesPanelOptions {
@@ -960,12 +1006,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#L108)
 
 ```ts
 export interface ResourcesPanelState {
@@ -974,6 +1022,7 @@ export interface ResourcesPanelState {
     templates: readonly ResourceDisplayEntry[];
     diagnostics: readonly string[];
     createInstructions?: Node;
+    canCreateInstructions?: boolean;
 }
 ```
 
@@ -983,7 +1032,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#L119)
 
 ```ts
 export declare function createCompletionNotices(options?: {
@@ -999,7 +1048,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#L157)
 
 ```ts
 export declare function createCopyFeedback(options: {
@@ -1016,7 +1065,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#L24)
 
 ```ts
 export declare function createCostLedger(options?: {
@@ -1037,7 +1086,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#L78)
 
 ```ts
 export declare function createUpdatePanel(options?: {
@@ -1058,11 +1107,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#L112)
 
 ```ts
 export interface CompletionNoticeDisplay {
@@ -1077,7 +1126,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#L23)
 
 ```ts
 export interface CostLedgerState {
@@ -1090,7 +1139,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#L18)
 
 ```ts
 export interface CostRequestDisplay {
@@ -1120,7 +1169,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#L9)
 
 ```ts
 export interface CostSummaryDisplay {
@@ -1136,7 +1185,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#L10)
 
 ```ts
 export declare function formatCost(cost: CostSummaryDisplay | undefined, latestTask?: boolean): string;
@@ -1146,7 +1195,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#L113)
 
 ```ts
 export declare function historyStatusMarkup(status: 'approval' | 'running' | 'unread' | 'idle'): string;
@@ -1156,7 +1205,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#L77)
 
 ```ts
 export interface UpdatePanelState {
@@ -1173,35 +1222,64 @@ 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#L38)
 
 ```ts
-export declare function createProviderActions(state: ProviderActionsState, options?: {
-    onAction?: (action: string, target: DOMStringMap) => void;
-}): UIBlock<ProviderActionsState>;
+export declare function createProviderActions(state: ProviderActionsState, options?: ProviderActionOptions): UIBlock<ProviderActionsState>;
 ```
 
-Referenced public types and APIs: [`ProviderActionsState`](#provideractionsstate), [`UIBlock`](#uiblock).
+Referenced public types and APIs: [`ProviderActionOptions`](#provideractionoptions), [`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#L46)
 
 ```ts
-export declare function createResourceActions(state: ResourceActionsState, options?: {
-    onAction?: (action: string, target: DOMStringMap) => void;
-}): UIBlock<ResourceActionsState>;
+export declare function createResourceActions(state: ResourceActionsState, options?: ResourceActionOptions): UIBlock<ResourceActionsState>;
 ```
 
-Referenced public types and APIs: [`ResourceActionsState`](#resourceactionsstate), [`UIBlock`](#uiblock).
+Referenced public types and APIs: [`ResourceActionOptions`](#resourceactionoptions), [`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#L17)
+
+```ts
+export interface FeatureActionOptions {
+    onAction?: (action: string, target: DOMStringMap) => ReturnType<UIAction>;
+    onError?: (message: string) => void;
+}
+```
+
+Referenced public types and APIs: [`UIAction`](#uiaction).
+
+### ProviderAction
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L8)
+
+```ts
+export type ProviderAction = 'login' | 'logout' | 'custom' | 'remove-connection';
+```
+
+### ProviderActionOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L18)
+
+```ts
+export interface ProviderActionOptions extends FeatureActionOptions {
+    onProviderAction?: (action: ProviderAction, target: ProviderActionTarget) => ReturnType<UIAction>;
+}
+```
+
+Referenced public types and APIs: [`FeatureActionOptions`](#featureactionoptions), [`ProviderAction`](#provideraction), [`ProviderActionTarget`](#provideractiontarget), [`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#L12)
 
 ```ts
 export declare function providerActionsMarkup(provider: ProviderActionsState): string;
@@ -1211,7 +1289,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#L5)
 
 ```ts
 export interface ProviderActionsState {
@@ -1222,9 +1300,39 @@ export interface ProviderActionsState {
 }
 ```
 
+### ProviderActionTarget
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L10)
+
+```ts
+export interface ProviderActionTarget {
+    readonly id: string;
+}
+```
+
+### ResourceAction
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L9)
+
+```ts
+export type ResourceAction = 'use-resource' | 'resource';
+```
+
+### ResourceActionOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L19)
+
+```ts
+export interface ResourceActionOptions extends FeatureActionOptions {
+    onResourceAction?: (action: ResourceAction, target: ResourceActionTarget) => ReturnType<UIAction>;
+}
+```
+
+Referenced public types and APIs: [`FeatureActionOptions`](#featureactionoptions), [`ResourceAction`](#resourceaction), [`ResourceActionTarget`](#resourceactiontarget), [`UIAction`](#uiaction).
+
 ### 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#L14)
 
 ```ts
 export declare function resourceActionsMarkup(kind: string, resource: {
@@ -1235,7 +1343,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#L7)
 
 ```ts
 export interface ResourceActionsState {
@@ -1248,28 +1356,53 @@ export interface ResourceActionsState {
 }
 ```
 
+### ResourceActionTarget
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L11)
+
+```ts
+export interface ResourceActionTarget {
+    readonly workspaceId: string;
+    readonly kind: string;
+    readonly resource: {
+        readonly name: string;
+        readonly path: string;
+    };
+    readonly command?: string;
+}
+```
+
+### ResourceKind
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L6)
+
+```ts
+export type ResourceKind = 'instructions' | 'skill' | 'template';
+```
+
 ## src/forms/custom-connection.ts
 
 ### 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 +1417,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 +1433,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 +1451,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 +1473,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 +1486,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 +1509,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 +1526,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 +1544,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 +1562,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 +1573,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 +1583,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 {
@@ -1469,10 +1604,10 @@ Referenced public types and APIs: [`DialogContent`](#dialogcontent).
 
 ### createBranchHistory
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/history.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/history.ts#L8)
 
 ```ts
-export declare function createBranchHistory(state: BranchHistoryState, options?: {
+export declare function createBranchHistory(initial: BranchHistoryState, options?: {
     onContinue?: (id: string) => void | Promise<void>;
 }): UIBlock<BranchHistoryState>;
 ```
@@ -1483,7 +1618,7 @@ Related gallery: [branch-history](https://minifish-org.github.io/pith-ui/?item=b
 
 ### BranchHistoryNode
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/history.ts#L3)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/history.ts#L5)
 
 ```ts
 export interface BranchHistoryNode {
@@ -1496,7 +1631,7 @@ export interface BranchHistoryNode {
 
 ### BranchHistoryState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/history.ts#L4)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/history.ts#L6)
 
 ```ts
 export interface BranchHistoryState {
@@ -1512,31 +1647,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 +1700,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 +1729,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 +1741,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,55 +1751,59 @@ 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#L202)
 
 ```ts
-export declare function createMCPConnectionList(initial: MCPConnectionListState): UIBlock<MCPConnectionListState>;
+export declare function createMCPConnectionList(initial: MCPConnectionListState, options?: MCPConnectionListOptions): UIBlock<MCPConnectionListState>;
 ```
 
-Referenced public types and APIs: [`MCPConnectionListState`](#mcpconnectionliststate), [`UIBlock`](#uiblock).
+Referenced public types and APIs: [`MCPConnectionListOptions`](#mcpconnectionlistoptions), [`MCPConnectionListState`](#mcpconnectionliststate), [`UIBlock`](#uiblock).
 
 Related gallery: [mcp-connections](https://minifish-org.github.io/pith-ui/?item=mcp-connections).
 
 ### 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#L146)
 
 ```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#L182)
 
 ```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#L47)
 
 ```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#L11)
 
 ```ts
 export interface FormDOMBlock<State extends FormFeedback> extends UIBlock<State> {
@@ -1656,7 +1816,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#L10)
 
 ```ts
 export interface FormFeedback {
@@ -1667,7 +1827,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#L41)
 
 ```ts
 export interface FormOptions {
@@ -1675,9 +1835,39 @@ export interface FormOptions {
 }
 ```
 
+### MCPConnectionAction
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L198)
+
+```ts
+export type MCPConnectionAction = 'mcp-login' | 'mcp-logout' | 'mcp-edit' | 'mcp-toggle' | 'mcp-remove';
+```
+
+### MCPConnectionDraft
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L143)
+
+```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#L193)
 
 ```ts
 export interface MCPConnectionItem {
@@ -1697,9 +1887,21 @@ export interface MCPConnectionItem {
 }
 ```
 
+### MCPConnectionListOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L200)
+
+```ts
+export interface MCPConnectionListOptions {
+    onAction?: (action: MCPConnectionAction, target: MCPConnectionTarget) => ReturnType<UIAction>;
+}
+```
+
+Referenced public types and APIs: [`MCPConnectionAction`](#mcpconnectionaction), [`MCPConnectionTarget`](#mcpconnectiontarget), [`UIAction`](#uiaction).
+
 ### 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#L197)
 
 ```ts
 export interface MCPConnectionListState extends FormFeedback {
@@ -1711,20 +1913,47 @@ 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#L145)
 
 ```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), [`MCPConnectionDraft`](#mcpconnectiondraft), [`MCPConnectionsState`](#mcpconnectionsstate), [`MCPEditorValue`](#mcpeditorvalue).
+
+### MCPConnectionsState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L144)
+
+```ts
+export interface MCPConnectionsState extends FormFeedback {
+    formError?: string;
 }
 ```
 
-Referenced public types and APIs: [`FormDOMBlock`](#formdomblock), [`FormFeedback`](#formfeedback), [`MCPEditorValue`](#mcpeditorvalue).
+Referenced public types and APIs: [`FormFeedback`](#formfeedback).
+
+### MCPConnectionTarget
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L199)
+
+```ts
+export interface MCPConnectionTarget {
+    readonly name: string;
+}
+```
 
 ### 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#L142)
 
 ```ts
 export interface MCPEditorValue {
@@ -1742,32 +1971,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#L181)
 
 ```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#L180)
+
+```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#L44)
+
+```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#L42)
+
+```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#L45)
+
+```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#L46)
+
+```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#L40)
 
 ```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#L43)
+
+```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#L8)
 
 ```ts
 export declare function createProviderLoginPanel(initial: ProviderLoginState, options?: {
@@ -1784,7 +2123,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#L7)
 
 ```ts
 export interface ProviderLoginState {
@@ -1807,28 +2146,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 +2185,7 @@ export interface ResourceEditorState {
     workspacePath: string;
     path?: string;
     kind: string;
+    name?: string;
     content: string;
     editable: boolean;
     workspaceBusy: boolean;
@@ -1848,7 +2198,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#L11)
 
 ```ts
 export declare function createContextMenu(options?: {
@@ -1856,21 +2206,22 @@ export declare function createContextMenu(options?: {
     onDismiss?: (restoreFocus: boolean) => void;
     onAction?: (item: ContextMenuItem) => void;
 }): UIBlock<ContextMenuState> & {
-    open(trigger: HTMLElement, state: ContextMenuState): void;
+    open(trigger: HTMLElement, state: ContextMenuState, options?: ContextMenuOpenOptions): void;
     close(restoreFocus?: boolean): void;
 };
 ```
 
-Referenced public types and APIs: [`ContextMenuItem`](#contextmenuitem), [`ContextMenuState`](#contextmenustate), [`UIBlock`](#uiblock).
+Referenced public types and APIs: [`ContextMenuItem`](#contextmenuitem), [`ContextMenuOpenOptions`](#contextmenuopenoptions), [`ContextMenuState`](#contextmenustate), [`UIBlock`](#uiblock).
 
-Related gallery: [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu).
+Related gallery: [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu), [workspace-navigation](https://minifish-org.github.io/pith-ui/?item=workspace-navigation).
 
 ### 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#L5)
 
 ```ts
 export interface ContextMenuItem {
+    id?: string;
     label: string;
     action?: string;
     sdkAction?: string;
@@ -1883,9 +2234,22 @@ export interface ContextMenuItem {
 }
 ```
 
+### ContextMenuOpenOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/context-menu.ts#L10)
+
+```ts
+export interface ContextMenuOpenOptions {
+    point?: {
+        x: number;
+        y: number;
+    };
+}
+```
+
 ### 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#L9)
 
 ```ts
 export interface ContextMenuState {
@@ -1900,24 +2264,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#L101)
 
 ```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#L17)
 
 ```ts
 export declare function createWorkspaceNavigation(initial: WorkspaceNavigationState, options?: {
@@ -1925,34 +2284,29 @@ export declare function createWorkspaceNavigation(initial: WorkspaceNavigationSt
     idPrefix?: string;
     onToggle?: (id: string) => void;
     onSelect?: (id: string) => void;
+    onAction?: (action: WorkspaceNavigationAction) => void;
 }): UIBlock<WorkspaceNavigationState>;
 ```
 
-Referenced public types and APIs: [`UIBlock`](#uiblock), [`WorkspaceNavigationState`](#workspacenavigationstate).
+Referenced public types and APIs: [`UIBlock`](#uiblock), [`WorkspaceNavigationAction`](#workspacenavigationaction), [`WorkspaceNavigationState`](#workspacenavigationstate).
 
 Related gallery: [workspace-navigation](https://minifish-org.github.io/pith-ui/?item=workspace-navigation).
 
 ### 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#L151)
 
 ```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#L8)
 
 ```ts
 export interface NavigationConversation {
@@ -1966,7 +2320,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#L9)
 
 ```ts
 export interface NavigationWorkspace {
@@ -1982,9 +2336,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#L92)
+
+```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#L83)
+
+```ts
+export interface RenameConversationDraft {
+    id: string;
+    title: string;
+}
+```
+
+### RenameConversationOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L84)
+
+```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#L82)
 
 ```ts
 export interface RenameConversationState {
@@ -1995,9 +2395,28 @@ export interface RenameConversationState {
 }
 ```
 
+### WorkspaceNavigationAction
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L11)
+
+```ts
+export type WorkspaceNavigationAction = {
+    action: 'add-workspace';
+    trigger: HTMLButtonElement;
+} | {
+    action: 'new-conversation' | 'workspace-menu';
+    workspaceId: string;
+    trigger: HTMLButtonElement;
+} | {
+    action: 'conversation-menu';
+    conversationId: string;
+    trigger: HTMLButtonElement;
+};
+```
+
 ### 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#L10)
 
 ```ts
 export interface WorkspaceNavigationState {
@@ -2009,9 +2428,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#L141)
+
+```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#L131)
+
+```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#L130)
 
 ```ts
 export interface WorkspacePickerState {
@@ -2029,7 +2491,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#L319)
 
 ```ts
 export declare function createActions(options?: ActionsState & {
@@ -2043,7 +2505,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#L27)
 
 ```ts
 export declare function createButton(options: ButtonOptions): ButtonBlock;
@@ -2051,11 +2513,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#L272)
 
 ```ts
 export declare function createCheckbox(options: CheckboxState & {
@@ -2070,7 +2532,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#L356)
 
 ```ts
 export declare function createCollectionState(options: CollectionState & {
@@ -2085,7 +2547,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#L472)
 
 ```ts
 export declare function createConfirmDialog(options: ConfirmState & {
@@ -2108,7 +2570,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#L378)
 
 ```ts
 export declare function createDialog(options: DialogOptions): DialogBlock;
@@ -2120,7 +2582,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#L327)
 
 ```ts
 export declare function createDisclosure(options: DisclosureState & {
@@ -2136,7 +2598,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#L75)
 
 ```ts
 export declare function createDivider(state?: {
@@ -2152,7 +2614,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#L119)
 
 ```ts
 export declare function createField(options: FieldState & {
@@ -2166,7 +2628,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#L311)
 
 ```ts
 export declare function createFormSection(options: FormSectionState & {
@@ -2180,7 +2642,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#L64)
 
 ```ts
 export declare function createIcon(state: IconState): UIBlock<IconState>;
@@ -2192,7 +2654,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#L42)
 
 ```ts
 export declare function createIconButton(options: ButtonOptions & {
@@ -2206,7 +2668,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#L82)
 
 ```ts
 export declare function createKeyValue(options: KeyValueState): UIBlock<KeyValueState>;
@@ -2218,7 +2680,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#L341)
 
 ```ts
 export declare function createListRow(options: ListRowState & {
@@ -2232,19 +2694,19 @@ 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#L531)
 
 ```ts
-export declare function createMenu(options: MenuState): PopoverBlock & UIBlock<MenuState>;
+export declare function createMenu(options: MenuOptions): PopoverBlock & UIBlock<MenuState>;
 ```
 
-Referenced public types and APIs: [`MenuState`](#menustate), [`PopoverBlock`](#popoverblock), [`UIBlock`](#uiblock).
+Referenced public types and APIs: [`MenuOptions`](#menuoptions), [`MenuState`](#menustate), [`PopoverBlock`](#popoverblock), [`UIBlock`](#uiblock).
 
-Related gallery: [menu](https://minifish-org.github.io/pith-ui/?item=menu).
+Related gallery: [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [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#L287)
 
 ```ts
 export declare function createNotice(state: NoticeState): UIBlock<NoticeState>;
@@ -2256,7 +2718,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#L185)
 
 ```ts
 export declare const createNumberInput: (options: InputOptions) => InputBlock;
@@ -2268,7 +2730,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#L514)
 
 ```ts
 export declare function createPopover(options: PopoverState & {
@@ -2283,7 +2745,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#L300)
 
 ```ts
 export declare function createProgress(state: ProgressState): UIBlock<ProgressState>;
@@ -2295,7 +2757,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#L102)
 
 ```ts
 export declare function createScrollArea(options: ScrollAreaState & {
@@ -2309,7 +2771,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#L184)
 
 ```ts
 export declare const createSearchInput: (options: InputOptions) => InputBlock;
@@ -2321,7 +2783,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#L188)
 
 ```ts
 export declare function createSecretInput(options: InputOptions): InputBlock;
@@ -2333,7 +2795,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#L226)
 
 ```ts
 export declare function createSelect(options: SelectOptions): SelectBlock;
@@ -2341,11 +2803,11 @@ export declare function createSelect(options: SelectOptions): SelectBlock;
 
 Referenced public types and APIs: [`SelectBlock`](#selectblock), [`SelectOptions`](#selectoptions).
 
-Related gallery: [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [select](https://minifish-org.github.io/pith-ui/?item=select).
+Related gallery: [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [select](https://minifish-org.github.io/pith-ui/?item=select).
 
 ### 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#L293)
 
 ```ts
 export declare function createStatus(state: StatusState): UIBlock<StatusState>;
@@ -2357,7 +2819,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#L55)
 
 ```ts
 export declare function createTextAction(options: ButtonOptions): ButtonBlock;
@@ -2369,7 +2831,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#L186)
 
 ```ts
 export declare const createTextArea: (options: InputOptions) => InputBlock;
@@ -2381,7 +2843,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#L420)
 
 ```ts
 export declare function createTextEditDialog(options?: TextEditOptions): TextEditBlock;
@@ -2393,7 +2855,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#L183)
 
 ```ts
 export declare const createTextInput: (options: InputOptions) => InputBlock;
@@ -2405,7 +2867,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#L94)
 
 ```ts
 export declare function createToolbar(options: ToolbarState & {
@@ -2419,7 +2881,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#L318)
 
 ```ts
 export interface ActionsState {
@@ -2429,7 +2891,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#L25)
 
 ```ts
 export interface ButtonBlock extends UIBlock<ButtonState> {
@@ -2441,7 +2903,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#L20)
 
 ```ts
 export interface ButtonOptions extends ButtonState {
@@ -2455,7 +2917,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#L9)
 
 ```ts
 export interface ButtonState {
@@ -2466,6 +2928,8 @@ export interface ButtonState {
     pending?: boolean;
     icon?: string;
     title?: string;
+    /** Secondary product action, including the accepted compact application style. */
+    appearance?: 'standard' | 'secondary';
 }
 ```
 
@@ -2473,7 +2937,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#L266)
 
 ```ts
 export interface CheckboxBlock extends UIBlock<CheckboxState> {
@@ -2488,7 +2952,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#L265)
 
 ```ts
 export interface CheckboxState {
@@ -2500,7 +2964,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#L355)
 
 ```ts
 export interface CollectionState {
@@ -2512,7 +2976,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#L471)
 
 ```ts
 export interface ConfirmBlock extends UIBlock<ConfirmState> {
@@ -2521,6 +2985,7 @@ export interface ConfirmBlock extends UIBlock<ConfirmState> {
     readonly cancelButton: HTMLButtonElement;
     open(state?: ConfirmState): void;
     close(): void;
+    refreshAvailability(): void;
 }
 ```
 
@@ -2528,7 +2993,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#L470)
 
 ```ts
 export interface ConfirmState extends DialogState {
@@ -2545,7 +3010,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#L372)
 
 ```ts
 export interface DialogBlock extends UIBlock<DialogState> {
@@ -2560,7 +3025,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#L371)
 
 ```ts
 export interface DialogOptions extends DialogState {
@@ -2576,7 +3041,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#L370)
 
 ```ts
 export interface DialogState {
@@ -2589,7 +3054,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#L326)
 
 ```ts
 export interface DisclosureBlock extends UIBlock<DisclosureState> {
@@ -2602,7 +3067,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#L325)
 
 ```ts
 export interface DisclosureState {
@@ -2614,7 +3079,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#L115)
 
 ```ts
 export interface FieldBlock extends UIBlock<FieldState> {
@@ -2626,7 +3091,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#L108)
 
 ```ts
 export interface FieldState {
@@ -2640,7 +3105,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#L310)
 
 ```ts
 export interface FormSectionState {
@@ -2651,7 +3116,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#L63)
 
 ```ts
 export interface IconState {
@@ -2663,7 +3128,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#L154)
 
 ```ts
 export interface InputBlock extends UIBlock<InputState> {
@@ -2678,7 +3143,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#L145)
 
 ```ts
 export interface InputOptions extends InputState {
@@ -2696,7 +3161,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#L140)
 
 ```ts
 export interface InputState extends FieldState {
@@ -2710,7 +3175,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#L81)
 
 ```ts
 export interface KeyValueState {
@@ -2724,7 +3189,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#L340)
 
 ```ts
 export interface ListRowState {
@@ -2738,7 +3203,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#L528)
 
 ```ts
 export interface MenuItem {
@@ -2753,9 +3218,21 @@ export interface MenuItem {
 
 Referenced public types and APIs: [`Intent`](#intent), [`UIAction`](#uiaction).
 
+### MenuOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L530)
+
+```ts
+export interface MenuOptions extends MenuState {
+    onError?: (message: string) => void;
+}
+```
+
+Referenced public types and APIs: [`MenuState`](#menustate).
+
 ### 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#L529)
 
 ```ts
 export interface MenuState extends PopoverState {
@@ -2767,7 +3244,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#L286)
 
 ```ts
 export interface NoticeState {
@@ -2778,7 +3255,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#L507)
 
 ```ts
 export interface PopoverBlock extends UIBlock<PopoverState> {
@@ -2794,7 +3271,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#L506)
 
 ```ts
 export interface PopoverState {
@@ -2805,7 +3282,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#L299)
 
 ```ts
 export interface ProgressState {
@@ -2817,7 +3294,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#L101)
 
 ```ts
 export interface ScrollAreaState {
@@ -2828,13 +3305,15 @@ 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#L218)
 
 ```ts
 export interface SelectBlock extends UIBlock<SelectState> {
     readonly control: HTMLSelectElement;
     getValue(): string;
+    getValues(): string[];
     reset(value: string): void;
+    resetValues(values: readonly string[]): void;
     focus(): void;
 }
 ```
@@ -2843,7 +3322,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,12 +3334,14 @@ 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 {
     value?: string;
+    values?: readonly string[];
     onChange?: (value: string) => void;
+    onValuesChange?: (values: readonly string[]) => void;
     multiple?: boolean;
     size?: number;
 }
@@ -2870,7 +3351,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 +3364,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#L292)
 
 ```ts
 export interface StatusState {
@@ -2894,7 +3375,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#L411)
 
 ```ts
 export interface TextEditBlock extends Omit<UIBlock<TextEditState>, 'element'> {
@@ -2912,7 +3393,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#L402)
 
 ```ts
 export interface TextEditInput {
@@ -2925,7 +3406,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#L403)
 
 ```ts
 export interface TextEditOptions extends Partial<TextEditState> {
@@ -2949,7 +3430,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#L401)
 
 ```ts
 export interface TextEditState extends DialogState {
@@ -2966,7 +3447,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#L93)
 
 ```ts
 export interface ToolbarState {
@@ -2981,7 +3462,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 +3478,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 +3491,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 +3514,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#L9)
 
 ```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#L40)
 
 ```ts
 export declare function createPermissionControl(initial: PermissionControlState, options?: {
@@ -3065,7 +3544,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#L19)
 
 ```ts
 export declare function createTaskFailure(initial: TaskFailureState, options?: {
@@ -3080,9 +3559,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#L8)
+
+```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#L7)
 
 ```ts
 export interface FullAccessState {
@@ -3094,7 +3586,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#L39)
 
 ```ts
 export interface PermissionControlState {
@@ -3106,7 +3598,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#L18)
 
 ```ts
 export interface TaskFailureState {
@@ -3122,7 +3614,7 @@ export interface TaskFailureState {
 
 ### createRuntimePanel
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/runtime.ts#L5)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/runtime.ts#L6)
 
 ```ts
 export declare function createRuntimePanel(initial: RuntimePanelState, options?: {
@@ -3144,7 +3636,7 @@ Related gallery: [runtime-panel](https://minifish-org.github.io/pith-ui/?item=ru
 
 ### RuntimePanelState
 
-[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/runtime.ts#L4)
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/runtime.ts#L5)
 
 ```ts
 export interface RuntimePanelState {
@@ -3194,7 +3686,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#L33)
 
 ```ts
 export declare function createComposerView(options?: ComposerViewOptions): {
@@ -3205,6 +3697,7 @@ export declare function createComposerView(options?: ComposerViewOptions): {
     reset(value: string): void;
     focus: () => void;
     resize: () => void;
+    pickImages(): void;
     destroy(): void;
 };
 ```
@@ -3215,22 +3708,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#L121)
+
+```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#L118)
+
+```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#L15)
 
 ```ts
 export interface ComposerViewOptions {
@@ -3238,6 +3760,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 +3771,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#L9)
 
 ```ts
 export interface ComposerViewState {
@@ -3254,28 +3780,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#L117)
+
+```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#L119)
 
 ```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#L120)
 
 ```ts
 export interface WorkspaceShellState {
     workspace?: string;
     conversation?: string;
     reconnecting?: boolean;
+    error?: {
+        message: string;
+        hidden?: boolean;
+    };
+    busy?: {
+        key: string;
+        message: string;
+        actionLabel: string;
+    } | null;
 }
 ```