pith-ui 0.1.4 → 0.2.0-app.2

package/APP-API.md

@@ -0,0 +1,2023 @@
+# Application API reference
+
+Generated for `pith-ui@0.2.0-app.2` by `node scripts/api-docs.ts` from TypeScript declaration emit. Do not edit this file by hand. The installed `dist/app/index.d.ts` is authoritative. This reference indexes all 101 direct `pith-ui/app` exports and 17 supporting types reachable from their signatures.
+
+Read [APP.md](./APP.md) for the approved consumption contract, ownership and lifecycle rules. Pith Desk imports only `pith-ui/app` and `pith-ui/styles.css`; the separate general [API.md](./API.md) does not expand that boundary.
+
+Only names in the public export index may be imported from `pith-ui/app`. Supporting declarations explain the complete signature graph; they are not additional exports or extension points. Platform types such as `HTMLElement` (the sole mount), `Blob` and `File` retain their standard meanings.
+
+`SettingsCredential` omits the `actions` member of its supporting `SettingsCredentialView`; that supporting member does not permit a Node slot in the application API. Supply typed `providerActions`. All source links below refer to this exact package version tag.
+
+Regenerate: `node scripts/api-docs.ts`. Verify both references and the contract version links without writing: `node scripts/api-docs.ts --check`.
+
+## Public export index
+
+| Export | Kind |
+|---|---|
+| [`ActionResult`](#actionresult) | Type |
+| [`AppArtifactsState`](#appartifactsstate) | Type |
+| [`AppFileAction`](#appfileaction) | Type |
+| [`AppFileOwner`](#appfileowner) | Type |
+| [`AppFilePreviewState`](#appfilepreviewstate) | Type |
+| [`AppFileTarget`](#appfiletarget) | Type |
+| [`AppResourceEditorState`](#appresourceeditorstate) | Type |
+| [`AppResourceEntry`](#appresourceentry) | Type |
+| [`AppResourceKind`](#appresourcekind) | Type |
+| [`AppResourceTarget`](#appresourcetarget) | Type |
+| [`Appearance`](#appearance) | Type |
+| [`Application`](#application) | Type |
+| [`ApplicationBrand`](#applicationbrand) | Type |
+| [`ApplicationConversation`](#applicationconversation) | Type |
+| [`ApplicationHost`](#applicationhost) | Type |
+| [`ApplicationOptions`](#applicationoptions) | Type |
+| [`ApplicationState`](#applicationstate) | Type |
+| [`ApplicationWorkspace`](#applicationworkspace) | Type |
+| [`ApprovalPanelState`](#approvalpanelstate) | Type |
+| [`ArtifactsCallbacks`](#artifactscallbacks) | Type |
+| [`AttachmentsState`](#attachmentsstate) | Type |
+| [`BranchHistoryState`](#branchhistorystate) | Type |
+| [`CompletionNoticeDisplay`](#completionnoticedisplay) | Type |
+| [`ComposerViewState`](#composerviewstate) | Type |
+| [`ConfirmationState`](#confirmationstate) | Type |
+| [`ConversationAction`](#conversationaction) | Type |
+| [`ConversationActionAvailability`](#conversationactionavailability) | Type |
+| [`ConversationMessage`](#conversationmessage) | Type |
+| [`ConversationNavigationAction`](#conversationnavigationaction) | Type |
+| [`ConversationState`](#conversationstate) | Type |
+| [`CostLedgerState`](#costledgerstate) | Type |
+| [`CustomConnectionCallbacks`](#customconnectioncallbacks) | Type |
+| [`CustomConnectionDraft`](#customconnectiondraft) | Type |
+| [`CustomConnectionSession`](#customconnectionsession) | Type |
+| [`CustomConnectionState`](#customconnectionstate) | Type |
+| [`FileActionResult`](#fileactionresult) | Type |
+| [`FileCapabilities`](#filecapabilities) | Type |
+| [`FilePreviewCallbacks`](#filepreviewcallbacks) | Type |
+| [`FilePreviewInput`](#filepreviewinput) | Type |
+| [`FilePreviewSession`](#filepreviewsession) | Type |
+| [`FilesScene`](#filesscene) | Type |
+| [`FullAccessState`](#fullaccessstate) | Type |
+| [`ImageTarget`](#imagetarget) | Type |
+| [`LoadingSession`](#loadingsession) | Type |
+| [`LoadingState`](#loadingstate) | Type |
+| [`MCPCallbacks`](#mcpcallbacks) | Type |
+| [`MCPConnectionAction`](#mcpconnectionaction) | Type |
+| [`MCPConnectionDraft`](#mcpconnectiondraft) | Type |
+| [`MCPConnectionItem`](#mcpconnectionitem) | Type |
+| [`MCPConnectionTarget`](#mcpconnectiontarget) | Type |
+| [`MCPConnectionsState`](#mcpconnectionsstate) | Type |
+| [`MCPEditorValue`](#mcpeditorvalue) | Type |
+| [`MCPSession`](#mcpsession) | Type |
+| [`MessageEditorSession`](#messageeditorsession) | Type |
+| [`MessageEditorState`](#messageeditorstate) | Type |
+| [`ModelCallbacks`](#modelcallbacks) | Type |
+| [`ModelPickerState`](#modelpickerstate) | Type |
+| [`ModelSelection`](#modelselection) | Type |
+| [`ModelSession`](#modelsession) | Type |
+| [`NavigationState`](#navigationstate) | Type |
+| [`NavigationStatus`](#navigationstatus) | Type |
+| [`PendingMessagesState`](#pendingmessagesstate) | Type |
+| [`PermissionControlState`](#permissioncontrolstate) | Type |
+| [`ProviderAction`](#provideraction) | Type |
+| [`ProviderActionTarget`](#provideractiontarget) | Type |
+| [`ProviderActionsState`](#provideractionsstate) | Type |
+| [`ProviderLoginCallbacks`](#providerlogincallbacks) | Type |
+| [`ProviderLoginSession`](#providerloginsession) | Type |
+| [`ProviderLoginState`](#providerloginstate) | Type |
+| [`RenameConversationDraft`](#renameconversationdraft) | Type |
+| [`RenameConversationState`](#renameconversationstate) | Type |
+| [`ResourceActionResult`](#resourceactionresult) | Type |
+| [`ResourceDraft`](#resourcedraft) | Type |
+| [`ResourceEditorCallbacks`](#resourceeditorcallbacks) | Type |
+| [`ResourceEditorSession`](#resourceeditorsession) | Type |
+| [`ResourcesCallbacks`](#resourcescallbacks) | Type |
+| [`ResourcesScene`](#resourcesscene) | Type |
+| [`ResourcesSession`](#resourcessession) | Type |
+| [`ResourcesState`](#resourcesstate) | Type |
+| [`RuntimePanelState`](#runtimepanelstate) | Type |
+| [`SceneSession`](#scenesession) | Type |
+| [`SettingsCallbacks`](#settingscallbacks) | Type |
+| [`SettingsCredential`](#settingscredential) | Type |
+| [`SettingsDraft`](#settingsdraft) | Type |
+| [`SettingsPanelState`](#settingspanelstate) | Type |
+| [`SettingsProviderOption`](#settingsprovideroption) | Type |
+| [`SettingsScene`](#settingsscene) | Type |
+| [`SettingsSession`](#settingssession) | Type |
+| [`TaskFailureState`](#taskfailurestate) | Type |
+| [`UpdateAction`](#updateaction) | Type |
+| [`UpdatePanelState`](#updatepanelstate) | Type |
+| [`WelcomeState`](#welcomestate) | Type |
+| [`WorkspaceAction`](#workspaceaction) | Type |
+| [`WorkspaceAvailability`](#workspaceavailability) | Type |
+| [`WorkspaceCallbacks`](#workspacecallbacks) | Type |
+| [`WorkspacePickerState`](#workspacepickerstate) | Type |
+| [`WorkspaceScene`](#workspacescene) | Type |
+| [`WorkspaceShellState`](#workspaceshellstate) | Type |
+| [`createApplication`](#createapplication) | Application factory |
+| [`formatCost`](#formatcost) | Pure formatter |
+| [`thinkingLabel`](#thinkinglabel) | Pure formatter |
+
+## Supporting type index
+
+- [`ApprovalView`](#approvalview)
+- [`AttachmentItem`](#attachmentitem)
+- [`BranchHistoryNode`](#branchhistorynode)
+- [`CostRequestDisplay`](#costrequestdisplay)
+- [`CostSummaryDisplay`](#costsummarydisplay)
+- [`CustomModelDraft`](#custommodeldraft)
+- [`CustomModelValue`](#custommodelvalue)
+- [`FormFeedback`](#formfeedback)
+- [`HostResult`](#hostresult)
+- [`LocalContentLink`](#localcontentlink)
+- [`ModelEditorState`](#modeleditorstate)
+- [`ModelOption`](#modeloption)
+- [`ModelProviderOption`](#modelprovideroption)
+- [`PendingMessage`](#pendingmessage)
+- [`SettingsCredentialView`](#settingscredentialview)
+- [`SettingsViewSession`](#settingsviewsession)
+- [`Submission`](#submission)
+
+## Public declarations
+
+### AppArtifactsState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/files.ts#L38)
+
+```ts
+export interface AppArtifactsState {
+    readonly ownerId: string;
+    readonly files: readonly {
+        readonly name: string;
+        readonly path: string;
+    }[];
+    readonly loading: boolean;
+    readonly error: string;
+    readonly copyMode: 'file' | 'path';
+    readonly disabled?: boolean;
+}
+```
+
+### AppFileAction
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/files.ts#L8)
+
+```ts
+export type AppFileAction = 'open' | 'reveal' | 'copy' | 'copy-path';
+```
+
+### AppFileOwner
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/files.ts#L10)
+
+```ts
+export interface AppFileOwner {
+    readonly kind: 'artifact';
+    readonly id: string;
+}
+```
+
+### AppFilePreviewState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/files.ts#L13)
+
+```ts
+export interface AppFilePreviewState {
+    readonly kind: 'text' | 'markdown' | 'diff' | 'image';
+    readonly text?: string;
+    readonly imageSrc?: string;
+    readonly imageAlt?: string;
+    readonly truncated?: boolean;
+    readonly error?: string;
+    readonly disabled?: boolean;
+}
+```
+
+### AppFileTarget
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/files.ts#L11)
+
+```ts
+export interface AppFileTarget {
+    readonly owner: AppFileOwner;
+    readonly name: string;
+    readonly path: string;
+}
+```
+
+Referenced types and APIs: [`AppFileOwner`](#appfileowner).
+
+### ArtifactsCallbacks
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/files.ts#L46)
+
+```ts
+export interface ArtifactsCallbacks {
+    onPreview?: (target: AppFileTarget) => FileActionResult;
+    onFileAction?: (action: AppFileAction, target: AppFileTarget) => FileActionResult;
+}
+```
+
+Referenced types and APIs: [`AppFileAction`](#appfileaction), [`AppFileTarget`](#appfiletarget), [`FileActionResult`](#fileactionresult).
+
+### FileActionResult
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/files.ts#L9)
+
+```ts
+export type FileActionResult = void | ActionResult | Promise<void | ActionResult>;
+```
+
+Referenced types and APIs: [`ActionResult`](#actionresult).
+
+### FileCapabilities
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/files.ts#L12)
+
+```ts
+export interface FileCapabilities {
+    readonly open?: boolean;
+    readonly reveal?: boolean;
+    readonly copyMode?: 'file' | 'path' | 'none';
+}
+```
+
+### FilePreviewCallbacks
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/files.ts#L26)
+
+```ts
+export interface FilePreviewCallbacks {
+    onFileAction?: (action: AppFileAction, target: AppFileTarget) => FileActionResult;
+    onCopyCode?: (text: string) => FileActionResult;
+    onClose?: () => void;
+}
+```
+
+Referenced types and APIs: [`AppFileAction`](#appfileaction), [`AppFileTarget`](#appfiletarget), [`FileActionResult`](#fileactionresult).
+
+### FilePreviewInput
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/files.ts#L22)
+
+```ts
+export interface FilePreviewInput extends AppFileTarget {
+    readonly capabilities: FileCapabilities;
+    readonly content?: AppFilePreviewState;
+}
+```
+
+Referenced types and APIs: [`AppFilePreviewState`](#appfilepreviewstate), [`AppFileTarget`](#appfiletarget), [`FileCapabilities`](#filecapabilities).
+
+### FilePreviewSession
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/files.ts#L31)
+
+```ts
+export interface FilePreviewSession {
+    update(state: Readonly<AppFilePreviewState>): void;
+    fail(message: string): void;
+    close(): void;
+    isOpen(): boolean;
+    destroy(): void;
+}
+```
+
+Referenced types and APIs: [`AppFilePreviewState`](#appfilepreviewstate).
+
+### FilesScene
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/files.ts#L50)
+
+```ts
+export interface FilesScene {
+    updateArtifacts(state: Readonly<AppArtifactsState>, callbacks?: ArtifactsCallbacks): void;
+    closeArtifacts(): void;
+    areArtifactsOpen(): boolean;
+    openPreview(input: Readonly<FilePreviewInput>, callbacks?: FilePreviewCallbacks): FilePreviewSession;
+    destroy(): void;
+}
+```
+
+Referenced types and APIs: [`AppArtifactsState`](#appartifactsstate), [`ArtifactsCallbacks`](#artifactscallbacks), [`FilePreviewCallbacks`](#filepreviewcallbacks), [`FilePreviewInput`](#filepreviewinput), [`FilePreviewSession`](#filepreviewsession).
+
+### createApplication
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/index.ts#L58)
+
+```ts
+/** The only DOM argument is the application mount. Scenes return semantic ports. */
+export declare function createApplication(mount: HTMLElement, options?: ApplicationOptions): Application;
+```
+
+Referenced types and APIs: [`Application`](#application), [`ApplicationOptions`](#applicationoptions).
+
+Related gallery: [application-reference](https://minifish-org.github.io/pith-ui/?item=application-reference).
+
+### Application
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/index.ts#L40)
+
+```ts
+export interface Application {
+    readonly workspace: WorkspaceScene;
+    readonly settings: SettingsScene;
+    readonly resources: ResourcesScene;
+    readonly files: FilesScene;
+    read(): ApplicationState;
+    setAppearance(appearance: Appearance): void;
+    downloadFile(file: {
+        readonly blob: Blob;
+        readonly name: string;
+    }): Promise<ActionResult>;
+    destroy(): void;
+}
+```
+
+Referenced types and APIs: [`ActionResult`](#actionresult), [`Appearance`](#appearance), [`ApplicationState`](#applicationstate), [`FilesScene`](#filesscene), [`ResourcesScene`](#resourcesscene), [`SettingsScene`](#settingsscene), [`WorkspaceScene`](#workspacescene).
+
+### ApplicationBrand
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/index.ts#L22)
+
+```ts
+export interface ApplicationBrand {
+    readonly name: string;
+    readonly qualifier?: string;
+    readonly mark?: {
+        readonly src: string;
+        readonly darkSrc?: string;
+        readonly alt: string;
+    };
+}
+```
+
+### ApplicationHost
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/index.ts#L27)
+
+```ts
+export interface ApplicationHost {
+    copyText?(text: string): HostResult;
+    openExternal?(url: string): HostResult;
+}
+```
+
+Referenced types and APIs: [`HostResult`](#hostresult).
+
+### ApplicationOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/index.ts#L32)
+
+```ts
+export interface ApplicationOptions {
+    readonly brand?: ApplicationBrand;
+    readonly appearance?: Appearance;
+    readonly host?: ApplicationHost;
+    readonly workspace?: WorkspaceCallbacks;
+    readonly onUIStateChange?: (state: ApplicationState) => void;
+    readonly onError?: (message: string) => void;
+}
+```
+
+Referenced types and APIs: [`Appearance`](#appearance), [`ApplicationBrand`](#applicationbrand), [`ApplicationHost`](#applicationhost), [`ApplicationState`](#applicationstate), [`WorkspaceCallbacks`](#workspacecallbacks).
+
+### ApplicationState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/index.ts#L31)
+
+```ts
+export interface ApplicationState {
+    readonly hasModal: boolean;
+    readonly appearance: Appearance;
+}
+```
+
+Referenced types and APIs: [`Appearance`](#appearance).
+
+### AppResourceEditorState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/resources.ts#L52)
+
+```ts
+export interface AppResourceEditorState {
+    readonly workspaceId: string;
+    readonly workspacePath: string;
+    readonly path?: string;
+    readonly kind: AppResourceKind;
+    readonly name?: string;
+    readonly content: string;
+    readonly editable: boolean;
+    readonly workspaceBusy: boolean;
+    readonly error?: string;
+    readonly disabled?: boolean;
+}
+```
+
+Referenced types and APIs: [`AppResourceKind`](#appresourcekind).
+
+### AppResourceEntry
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/resources.ts#L13)
+
+```ts
+export interface AppResourceEntry {
+    readonly name: string;
+    readonly path: string;
+    readonly description?: string;
+    readonly content?: string;
+}
+```
+
+### AppResourceKind
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/resources.ts#L11)
+
+```ts
+export type AppResourceKind = 'instructions' | 'skill' | 'template';
+```
+
+### AppResourceTarget
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/resources.ts#L19)
+
+```ts
+export interface AppResourceTarget {
+    readonly workspaceId: string;
+    readonly kind: AppResourceKind;
+    readonly name: string;
+    readonly path: string;
+}
+```
+
+Referenced types and APIs: [`AppResourceKind`](#appresourcekind).
+
+### ResourceActionResult
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/resources.ts#L12)
+
+```ts
+export type ResourceActionResult = void | ActionResult | Promise<void | ActionResult>;
+```
+
+Referenced types and APIs: [`ActionResult`](#actionresult).
+
+### ResourceEditorCallbacks
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/resources.ts#L64)
+
+```ts
+export interface ResourceEditorCallbacks {
+    onSubmit?: (draft: ResourceDraft) => ActionResult | Promise<ActionResult>;
+    onDelete?: (target: AppResourceTarget) => ResourceActionResult;
+    onClose?: () => void;
+}
+```
+
+Referenced types and APIs: [`ActionResult`](#actionresult), [`AppResourceTarget`](#appresourcetarget), [`ResourceActionResult`](#resourceactionresult), [`ResourceDraft`](#resourcedraft).
+
+### ResourceEditorSession
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/resources.ts#L69)
+
+```ts
+export interface ResourceEditorSession {
+    read(): ResourceDraft;
+    update(state: Readonly<AppResourceEditorState>): void;
+    fail(message: string): void;
+    close(): void;
+    isOpen(): boolean;
+    destroy(): void;
+}
+```
+
+Referenced types and APIs: [`AppResourceEditorState`](#appresourceeditorstate), [`ResourceDraft`](#resourcedraft).
+
+### ResourcesCallbacks
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/resources.ts#L36)
+
+```ts
+export interface ResourcesCallbacks {
+    onRefresh?: () => ResourceActionResult;
+    onCreate?: (kind: AppResourceKind) => ResourceActionResult;
+    onUse?: (target: AppResourceTarget) => ResourceActionResult;
+    onEdit?: (target: AppResourceTarget) => ResourceActionResult;
+    onFileAction?: (action: 'open' | 'reveal', target: AppResourceTarget) => ResourceActionResult;
+    onClose?: () => void;
+}
+```
+
+Referenced types and APIs: [`AppResourceKind`](#appresourcekind), [`AppResourceTarget`](#appresourcetarget), [`ResourceActionResult`](#resourceactionresult).
+
+### ResourcesScene
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/resources.ts#L77)
+
+```ts
+export interface ResourcesScene {
+    openEditorLoading(state: Readonly<LoadingState> & {
+        readonly kind: AppResourceKind;
+        readonly path?: string;
+    }, callbacks?: {
+        onClose?: () => void;
+    }): LoadingSession;
+    open(state: Readonly<ResourcesState>, callbacks?: ResourcesCallbacks): ResourcesSession;
+    openEditor(state: Readonly<AppResourceEditorState>, callbacks?: ResourceEditorCallbacks): ResourceEditorSession;
+    destroy(): void;
+}
+```
+
+Referenced types and APIs: [`AppResourceEditorState`](#appresourceeditorstate), [`AppResourceKind`](#appresourcekind), [`LoadingSession`](#loadingsession), [`LoadingState`](#loadingstate), [`ResourceEditorCallbacks`](#resourceeditorcallbacks), [`ResourceEditorSession`](#resourceeditorsession), [`ResourcesCallbacks`](#resourcescallbacks), [`ResourcesSession`](#resourcessession), [`ResourcesState`](#resourcesstate).
+
+### ResourcesSession
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/resources.ts#L44)
+
+```ts
+export interface ResourcesSession {
+    read(): Readonly<ResourcesState>;
+    update(state: Readonly<ResourcesState>): void;
+    fail(message: string): void;
+    close(): void;
+    isOpen(): boolean;
+    destroy(): void;
+}
+```
+
+Referenced types and APIs: [`ResourcesState`](#resourcesstate).
+
+### ResourcesState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/resources.ts#L25)
+
+```ts
+export interface ResourcesState {
+    readonly workspace: {
+        readonly id: string;
+        readonly name: string;
+        readonly path: string;
+    };
+    readonly instructions: readonly AppResourceEntry[];
+    readonly skills: readonly AppResourceEntry[];
+    readonly templates: readonly AppResourceEntry[];
+    readonly diagnostics: readonly string[];
+    readonly canCreateInstructions?: boolean;
+    readonly loading?: boolean;
+    readonly error?: string;
+    readonly busy?: boolean;
+}
+```
+
+Referenced types and APIs: [`AppResourceEntry`](#appresourceentry).
+
+### LoadingSession
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/session.ts#L5)
+
+```ts
+export interface LoadingSession {
+    update(state: Readonly<LoadingState>): void;
+    fail(message: string): void;
+    isOpen(): boolean;
+    close(): void;
+    destroy(): void;
+}
+```
+
+Referenced types and APIs: [`LoadingState`](#loadingstate).
+
+### LoadingState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/session.ts#L4)
+
+```ts
+export interface LoadingState {
+    readonly error?: string;
+}
+```
+
+### CustomConnectionCallbacks
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L68)
+
+```ts
+export interface CustomConnectionCallbacks {
+    onSubmit?: Submission<CustomConnectionDraft>;
+    onClose?: () => void;
+}
+```
+
+Referenced types and APIs: [`CustomConnectionDraft`](#customconnectiondraft), [`Submission`](#submission).
+
+### CustomConnectionSession
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L69)
+
+```ts
+export interface CustomConnectionSession extends SettingsViewSession<CustomConnectionState> {
+    read(): CustomConnectionDraft;
+    clearSecrets(): void;
+}
+```
+
+Referenced types and APIs: [`CustomConnectionDraft`](#customconnectiondraft), [`CustomConnectionState`](#customconnectionstate), [`SettingsViewSession`](#settingsviewsession).
+
+### MCPCallbacks
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L52)
+
+```ts
+export interface MCPCallbacks {
+    onSubmit?: Submission<MCPConnectionDraft>;
+    onConnectionAction?: (action: MCPConnectionAction, target: MCPConnectionTarget) => HostResult;
+    onRefresh?: () => HostResult;
+    onNew?: () => HostResult;
+    onClose?: () => void;
+}
+```
+
+Referenced types and APIs: [`HostResult`](#hostresult), [`MCPConnectionAction`](#mcpconnectionaction), [`MCPConnectionDraft`](#mcpconnectiondraft), [`MCPConnectionTarget`](#mcpconnectiontarget), [`Submission`](#submission).
+
+### MCPSession
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L59)
+
+```ts
+export interface MCPSession extends SettingsViewSession<MCPConnectionsState> {
+    read(): MCPConnectionDraft;
+    edit(value?: Readonly<MCPEditorValue>): void;
+    setConnections(entries: readonly MCPConnectionItem[]): void;
+    clearBearerToken(): void;
+    clearSecrets(): void;
+}
+```
+
+Referenced types and APIs: [`MCPConnectionDraft`](#mcpconnectiondraft), [`MCPConnectionItem`](#mcpconnectionitem), [`MCPConnectionsState`](#mcpconnectionsstate), [`MCPEditorValue`](#mcpeditorvalue), [`SettingsViewSession`](#settingsviewsession).
+
+### ModelCallbacks
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L66)
+
+```ts
+export interface ModelCallbacks {
+    onSubmit?: Submission<ModelSelection>;
+    onClose?: () => void;
+}
+```
+
+Referenced types and APIs: [`ModelSelection`](#modelselection), [`Submission`](#submission).
+
+### ModelSession
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L67)
+
+```ts
+export interface ModelSession extends SettingsViewSession<ModelPickerState> {
+    read(): ModelSelection;
+    reset(selection: Readonly<ModelSelection>): void;
+    focus(): void;
+}
+```
+
+Referenced types and APIs: [`ModelPickerState`](#modelpickerstate), [`ModelSelection`](#modelselection), [`SettingsViewSession`](#settingsviewsession).
+
+### ProviderLoginCallbacks
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L70)
+
+```ts
+export interface ProviderLoginCallbacks {
+    onAnswer?: (answer: string) => HostResult;
+    onCancel?: () => HostResult;
+    onClose?: () => void;
+}
+```
+
+Referenced types and APIs: [`HostResult`](#hostresult).
+
+### ProviderLoginSession
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L71)
+
+```ts
+export interface ProviderLoginSession extends SettingsViewSession<ProviderLoginState> {
+}
+```
+
+Referenced types and APIs: [`ProviderLoginState`](#providerloginstate), [`SettingsViewSession`](#settingsviewsession).
+
+### SettingsCallbacks
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L28)
+
+```ts
+export interface SettingsCallbacks {
+    onSubmit?: Submission<SettingsDraft>;
+    onRemoveKey?: Submission<SettingsDraft>;
+    onTest?: (draft: SettingsDraft) => HostResult;
+    onCancelTest?: () => HostResult;
+    onAppearanceChange?: (appearance: Appearance) => HostResult;
+    onProviderChange?: (provider: string) => HostResult;
+    onDraftChange?: (draft: SettingsDraft) => void;
+    onProviderAction?: (action: ProviderAction, target: ProviderActionTarget) => HostResult;
+    onUpdateAction?: (action: UpdateAction) => HostResult;
+    onCreateConnection?: () => HostResult;
+    onDiagnostics?: () => HostResult;
+    onClose?: () => void;
+}
+```
+
+Referenced types and APIs: [`Appearance`](#appearance), [`HostResult`](#hostresult), [`ProviderAction`](#provideraction), [`ProviderActionTarget`](#provideractiontarget), [`SettingsDraft`](#settingsdraft), [`Submission`](#submission), [`UpdateAction`](#updateaction).
+
+### SettingsCredential
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L26)
+
+```ts
+export interface SettingsCredential extends Omit<SettingsCredentialView, 'actions'> {
+    providerActions?: Readonly<ProviderActionsState>;
+}
+```
+
+Referenced types and APIs: [`ProviderActionsState`](#provideractionsstate), [`SettingsCredentialView`](#settingscredentialview).
+
+### SettingsScene
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L72)
+
+```ts
+export interface SettingsScene {
+    openConnectionLoading(state: Readonly<LoadingState> & {
+        readonly editing: boolean;
+    }, callbacks?: {
+        onClose?: () => void;
+    }): LoadingSession;
+    openSettings(state: Readonly<SettingsPanelState>, callbacks?: SettingsCallbacks): SettingsSession;
+    openConnections(state?: Readonly<MCPConnectionsState>, callbacks?: MCPCallbacks): MCPSession;
+    openModels(state: Readonly<ModelPickerState>, callbacks?: ModelCallbacks): ModelSession;
+    openCustomConnection(state: Readonly<CustomConnectionState>, callbacks?: CustomConnectionCallbacks): CustomConnectionSession;
+    openProviderLogin(state: Readonly<ProviderLoginState>, callbacks?: ProviderLoginCallbacks): ProviderLoginSession;
+    destroy(): void;
+}
+```
+
+Referenced types and APIs: [`CustomConnectionCallbacks`](#customconnectioncallbacks), [`CustomConnectionSession`](#customconnectionsession), [`CustomConnectionState`](#customconnectionstate), [`LoadingSession`](#loadingsession), [`LoadingState`](#loadingstate), [`MCPCallbacks`](#mcpcallbacks), [`MCPConnectionsState`](#mcpconnectionsstate), [`MCPSession`](#mcpsession), [`ModelCallbacks`](#modelcallbacks), [`ModelPickerState`](#modelpickerstate), [`ModelSession`](#modelsession), [`ProviderLoginCallbacks`](#providerlogincallbacks), [`ProviderLoginSession`](#providerloginsession), [`ProviderLoginState`](#providerloginstate), [`SettingsCallbacks`](#settingscallbacks), [`SettingsPanelState`](#settingspanelstate), [`SettingsSession`](#settingssession).
+
+### SettingsSession
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L42)
+
+```ts
+export interface SettingsSession extends SettingsViewSession<SettingsPanelState> {
+    read(): SettingsDraft;
+    setProviders(providers: readonly SettingsProviderOption[], selected?: string): void;
+    resetProvider(value: {
+        provider: string;
+        baseUrl: string;
+        clearKey?: boolean;
+        collapseAdvanced?: boolean;
+    }): void;
+    setCredential(view: Readonly<SettingsCredential>): void;
+    updateUpdates(state: Readonly<UpdatePanelState>): void;
+    setUpdatePending(pending: boolean): void;
+    setUpdateError(message: string, options?: {
+        allowCheckRetry?: boolean;
+    }): void;
+    clearSecrets(): void;
+}
+```
+
+Referenced types and APIs: [`SettingsCredential`](#settingscredential), [`SettingsDraft`](#settingsdraft), [`SettingsPanelState`](#settingspanelstate), [`SettingsProviderOption`](#settingsprovideroption), [`SettingsViewSession`](#settingsviewsession), [`UpdatePanelState`](#updatepanelstate).
+
+### UpdateAction
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L27)
+
+```ts
+export type UpdateAction = 'check' | 'install';
+```
+
+### ApplicationConversation
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L22)
+
+```ts
+export interface ApplicationConversation {
+    readonly id: string;
+    readonly title?: string;
+    readonly active: boolean;
+    readonly status?: NavigationStatus;
+    readonly actions?: {
+        readonly rename?: boolean;
+        readonly history?: boolean;
+        readonly export?: boolean;
+        readonly delete?: boolean;
+    };
+}
+```
+
+Referenced types and APIs: [`NavigationStatus`](#navigationstatus).
+
+### ApplicationWorkspace
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L26)
+
+```ts
+export interface ApplicationWorkspace {
+    readonly id: string;
+    readonly name: string;
+    readonly path: string;
+    readonly selected: boolean;
+    readonly children: readonly ApplicationConversation[];
+    readonly canRemove?: boolean;
+}
+```
+
+Referenced types and APIs: [`ApplicationConversation`](#applicationconversation).
+
+### ConfirmationState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L79)
+
+```ts
+export interface ConfirmationState {
+    readonly title: string;
+    readonly action: string;
+    readonly description: {
+        readonly before: string;
+        readonly subject?: string;
+        readonly after?: string;
+    };
+    readonly hint?: string;
+    readonly error?: string;
+    readonly disabled?: boolean;
+}
+```
+
+### ConversationNavigationAction
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L35)
+
+```ts
+export type ConversationNavigationAction = 'rename' | 'history' | 'export' | 'delete';
+```
+
+### ConversationState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L32)
+
+```ts
+export interface ConversationState {
+    readonly id: string;
+    readonly messages: readonly ConversationMessage[];
+    readonly working: boolean;
+}
+```
+
+Referenced types and APIs: [`ConversationMessage`](#conversationmessage).
+
+### ImageTarget
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L33)
+
+```ts
+export interface ImageTarget {
+    readonly conversationId: string;
+    readonly messageId: string;
+    readonly index: number;
+}
+```
+
+### MessageEditorSession
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L78)
+
+```ts
+export interface MessageEditorSession extends SceneSession<MessageEditorState> {
+    read(): string;
+    reset(value: string): void;
+    focus(): void;
+}
+```
+
+Referenced types and APIs: [`MessageEditorState`](#messageeditorstate), [`SceneSession`](#scenesession).
+
+### MessageEditorState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L73)
+
+```ts
+export interface MessageEditorState {
+    readonly title: string;
+    readonly value: string;
+    readonly description?: string;
+    readonly note?: string;
+    readonly submitLabel?: string;
+    readonly disabled?: boolean;
+    readonly pending?: boolean;
+    readonly inputDisabled?: boolean;
+    readonly error?: string;
+}
+```
+
+### NavigationState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L31)
+
+```ts
+export interface NavigationState {
+    readonly groups: readonly ApplicationWorkspace[];
+    readonly empty: 'workspaces' | 'search' | null;
+    readonly disabled?: boolean;
+}
+```
+
+Referenced types and APIs: [`ApplicationWorkspace`](#applicationworkspace).
+
+### NavigationStatus
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L21)
+
+```ts
+export interface NavigationStatus {
+    readonly kind: 'approval' | 'running' | 'unread' | 'idle';
+}
+```
+
+### SceneSession
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L66)
+
+```ts
+export interface SceneSession<State> {
+    update(state: Readonly<State>): void;
+    close(): void;
+    isOpen(): boolean;
+    fail(message: string): void;
+    destroy(): void;
+}
+```
+
+### WorkspaceAction
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L34)
+
+```ts
+export type WorkspaceAction = 'workspace' | 'resources' | 'connections' | 'settings' | 'model' | 'compact' | 'continue' | 'diagnostics';
+```
+
+### WorkspaceAvailability
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L84)
+
+```ts
+export interface WorkspaceAvailability {
+    /** A host mutation blocks actions in every scope. A running task is scoped below. */
+    readonly busy?: boolean;
+    /** Global actions only; unrelated inactive targets keep their own availability. */
+    readonly global?: boolean;
+    readonly active?: boolean;
+    readonly conversations?: readonly string[];
+    readonly workspaces?: readonly string[];
+}
+```
+
+### WorkspaceCallbacks
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L36)
+
+```ts
+export interface WorkspaceCallbacks {
+    onAction?(action: WorkspaceAction): HostResult;
+    onSubmit?(text: string): HostResult;
+    onStop?(): HostResult;
+    onInput?(text: string): void;
+    onBlur?(): void;
+    onImages?(files: File[]): void;
+    onThinkingChange?(value: string): void;
+    onBusyAction?(key: string): void;
+    onSearch?(query: string): void;
+    onSelectConversation?(id: string): void;
+    onSelectWorkspace?(id: string): void;
+    onNewConversation?(workspaceId: string): void;
+    onConversationAction?(action: ConversationNavigationAction, id: string): HostResult;
+    onWorkspaceAction?(action: 'remove', id: string): HostResult;
+    onMessageAction?(action: ConversationAction): HostResult;
+    onCopyCode?(text: string): HostResult;
+    resolveLocalLink?(href: string, conversationId: string): LocalContentLink | null;
+    onLocalFile?(target: LocalContentLink): HostResult;
+    onLoadImage?(target: ImageTarget): Promise<Blob | null>;
+    onQueueAction?(action: 'edit' | 'delete' | 'steer', id: string): void;
+    onRemoveAttachment?(id: string): void;
+    onDropReferences?(input: {
+        readonly paths: readonly string[];
+        readonly uris?: string;
+        readonly hasUnidentifiedFiles: boolean;
+    }): void;
+    onPermissionChange?(value: string): void;
+    onApproval?(id: string, action: 'deny' | 'always' | 'allow'): void;
+    onCompletionOpen?(id: string): void;
+    onCompletionDismiss?(runId: string): void;
+    onCostsChange?(): void;
+    onError?(message: string): void;
+}
+```
+
+Referenced types and APIs: [`ConversationAction`](#conversationaction), [`ConversationNavigationAction`](#conversationnavigationaction), [`HostResult`](#hostresult), [`ImageTarget`](#imagetarget), [`LocalContentLink`](#localcontentlink), [`WorkspaceAction`](#workspaceaction).
+
+### WorkspaceScene
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/workspace.ts#L91)
+
+```ts
+export interface WorkspaceScene {
+    updateShell(state: Readonly<WorkspaceShellState>): void;
+    updateComposer(state: Readonly<ComposerViewState>): void;
+    readDraft(): string;
+    resetDraft(text: string): void;
+    focusComposer(): void;
+    pickImages(): void;
+    insertReferences(paths: readonly string[]): void;
+    receiveNativeDrop(input: {
+        readonly paths: readonly string[];
+        readonly x: number;
+        readonly y: number;
+    }): void;
+    setDropPending(pending: boolean): void;
+    updateNavigation(state: Readonly<NavigationState>): void;
+    search(query: string): void;
+    closeNavigationMenu(): void;
+    setSidebarOpen(open: boolean): void;
+    updateConversation(state: Readonly<ConversationState>): void;
+    updateMessageAvailability(state: Readonly<ConversationActionAvailability>): void;
+    pruneConversations(ids: readonly string[]): void;
+    updateWelcome(state: Readonly<WelcomeState>): void;
+    followLatest(): void;
+    openFind(): void;
+    closeFind(): void;
+    updatePending(state: Readonly<PendingMessagesState>): void;
+    updateAttachments(state: Readonly<AttachmentsState>): void;
+    updateImageGuidance(message: string): void;
+    updatePermission(state: Readonly<PermissionControlState>): void;
+    updateApproval(state: Readonly<ApprovalPanelState>): void;
+    updateFailure(state: Readonly<TaskFailureState>): void;
+    updateRuntime(state: Readonly<RuntimePanelState>): void;
+    updateTiming(value: {
+        summary: string;
+        duration: string;
+        speed: string;
+    }): void;
+    updateNotices(state: readonly CompletionNoticeDisplay[]): void;
+    updateAvailability(state: Readonly<WorkspaceAvailability>): void;
+    readCosts(): {
+        readonly open: boolean;
+        readonly runtimeOpen: boolean;
+    };
+    updateCosts(state: {
+        readonly visible: boolean;
+        readonly report?: CostLedgerState;
+        readonly loading?: boolean;
+        readonly error?: string;
+    }): void;
+    resetCosts(): void;
+    openMessageEditor(state: MessageEditorState, callbacks?: {
+        onSubmit?(text: string): ActionResult | Promise<ActionResult>;
+        onInput?(text: string): void;
+        onClose?(): void;
+    }): MessageEditorSession;
+    openQueueEditor(state: MessageEditorState, callbacks?: {
+        onSubmit?(text: string): ActionResult | Promise<ActionResult>;
+        onInput?(text: string): void;
+        onClose?(): void;
+    }): MessageEditorSession;
+    openConfirmation(state: ConfirmationState, callbacks: {
+        onConfirm(): ActionResult | Promise<ActionResult>;
+        onClose?(): void;
+    }): SceneSession<ConfirmationState>;
+    openWorkspacePicker(state: WorkspacePickerState, callbacks?: {
+        onSubmit?(path: string): ActionResult | Promise<ActionResult>;
+        onPick?(): Promise<{
+            path?: string;
+            error?: string;
+        }>;
+        onSelect?(id: string): void;
+        onClose?(): void;
+    }): SceneSession<WorkspacePickerState> & {
+        read(): {
+            path: string;
+        };
+        reset(path?: string): void;
+        focus(): void;
+    };
+    openRename(state: RenameConversationState, callbacks?: {
+        onSubmit?(draft: RenameConversationDraft): ActionResult | Promise<ActionResult>;
+        onClose?(): void;
+    }): SceneSession<RenameConversationState> & {
+        read(): RenameConversationDraft;
+        reset(state: RenameConversationState): void;
+        focus(): void;
+    };
+    openFullAccess(state: FullAccessState, callbacks: {
+        onConfirm(): ActionResult | Promise<ActionResult>;
+        onClose?(): void;
+    }): SceneSession<FullAccessState>;
+    openHistory(state: BranchHistoryState, callbacks?: {
+        onContinue?(nodeId: string): HostResult;
+        onClose?(): void;
+    }): SceneSession<BranchHistoryState>;
+    destroy(): void;
+}
+```
+
+Referenced types and APIs: [`ActionResult`](#actionresult), [`ApprovalPanelState`](#approvalpanelstate), [`AttachmentsState`](#attachmentsstate), [`BranchHistoryState`](#branchhistorystate), [`CompletionNoticeDisplay`](#completionnoticedisplay), [`ComposerViewState`](#composerviewstate), [`ConfirmationState`](#confirmationstate), [`ConversationActionAvailability`](#conversationactionavailability), [`ConversationState`](#conversationstate), [`CostLedgerState`](#costledgerstate), [`FullAccessState`](#fullaccessstate), [`HostResult`](#hostresult), [`MessageEditorSession`](#messageeditorsession), [`MessageEditorState`](#messageeditorstate), [`NavigationState`](#navigationstate), [`PendingMessagesState`](#pendingmessagesstate), [`PermissionControlState`](#permissioncontrolstate), [`RenameConversationDraft`](#renameconversationdraft), [`RenameConversationState`](#renameconversationstate), [`RuntimePanelState`](#runtimepanelstate), [`SceneSession`](#scenesession), [`TaskFailureState`](#taskfailurestate), [`WelcomeState`](#welcomestate), [`WorkspaceAvailability`](#workspaceavailability), [`WorkspacePickerState`](#workspacepickerstate), [`WorkspaceShellState`](#workspaceshellstate).
+
+### AttachmentsState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/composer.ts#L66)
+
+```ts
+export interface AttachmentsState {
+    items: readonly AttachmentItem[];
+    disabled?: boolean;
+}
+```
+
+Referenced types and APIs: [`AttachmentItem`](#attachmentitem).
+
+### PendingMessagesState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/composer.ts#L7)
+
+```ts
+export interface PendingMessagesState {
+    items: readonly PendingMessage[];
+    running: boolean;
+    busy: boolean;
+}
+```
+
+Referenced types and APIs: [`PendingMessage`](#pendingmessage).
+
+### ConversationAction
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/content/conversation-view.ts#L26)
+
+```ts
+export interface ConversationAction {
+    action: 'copy' | 'edit' | 'branch';
+    messageId: string;
+    branchKey?: string;
+}
+```
+
+### ConversationActionAvailability
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/content/conversation-view.ts#L27)
+
+```ts
+export interface ConversationActionAvailability {
+    copy?: boolean;
+    edit?: boolean;
+    branch?: boolean;
+}
+```
+
+### ConversationMessage
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/content/conversation-view.ts#L8)
+
+```ts
+/** UI data only. Hosts decide copy/edit/branch eligibility and resolve images. */
+export interface ConversationMessage {
+    id: string;
+    role: string;
+    text: string;
+    timestamp?: number;
+    toolName?: string;
+    toolCallId?: string;
+    status?: string;
+    images?: Array<{
+        index: number;
+        mimeType?: string;
+    }>;
+    command?: {
+        text: string;
+        cwd: string;
+        exitCode?: number;
+    };
+    actions?: {
+        copy?: boolean | string;
+        edit?: boolean;
+        branch?: {
+            key: string;
+            label?: string;
+        };
+    };
+}
+```
+
+### WelcomeState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/content/welcome.ts#L5)
+
+```ts
+export interface WelcomeState {
+    workspace?: {
+        name: string;
+        path: string;
+    };
+    hasApiKey: boolean;
+    hasConnections: boolean;
+    modelName: string;
+}
+```
+
+### ActionResult
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/core.ts#L8)
+
+```ts
+export type ActionResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+```
+
+### CompletionNoticeDisplay
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/files/systems.ts#L112)
+
+```ts
+export interface CompletionNoticeDisplay {
+    id: string;
+    runID: string;
+    title: string;
+    workspace: string;
+}
+```
+
+### CostLedgerState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/files/systems.ts#L23)
+
+```ts
+export interface CostLedgerState {
+    unknownRequests: number;
+    requests: readonly CostRequestDisplay[] | null;
+}
+```
+
+Referenced types and APIs: [`CostRequestDisplay`](#costrequestdisplay).
+
+### formatCost
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/files/systems.ts#L10)
+
+```ts
+export declare function formatCost(cost: CostSummaryDisplay | undefined, latestTask?: boolean): string;
+```
+
+Referenced types and APIs: [`CostSummaryDisplay`](#costsummarydisplay).
+
+### UpdatePanelState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/files/systems.ts#L77)
+
+```ts
+export interface UpdatePanelState {
+    version: string;
+    enabled: boolean;
+    phase: string;
+    availableVersion: string;
+    progress: number;
+    message: string;
+}
+```
+
+### ProviderAction
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/actions.ts#L8)
+
+```ts
+export type ProviderAction = 'login' | 'logout' | 'custom' | 'remove-connection';
+```
+
+### ProviderActionsState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/actions.ts#L5)
+
+```ts
+export interface ProviderActionsState {
+    id: string;
+    oauth: boolean;
+    signedIn: boolean;
+    custom: boolean;
+    disabled?: boolean;
+}
+```
+
+### ProviderActionTarget
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/actions.ts#L10)
+
+```ts
+export interface ProviderActionTarget {
+    readonly id: string;
+}
+```
+
+### CustomConnectionDraft
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/custom-connection.ts#L8)
+
+```ts
+export interface CustomConnectionDraft {
+    name: string;
+    baseUrl: string;
+    api: string;
+    apiKey: string;
+    models: CustomModelDraft[];
+}
+```
+
+Referenced types and APIs: [`CustomModelDraft`](#custommodeldraft).
+
+### CustomConnectionState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/custom-connection.ts#L6)
+
+```ts
+export interface CustomConnectionState {
+    name: string;
+    baseUrl: string;
+    api: string;
+    editing: boolean;
+    models: readonly CustomModelValue[];
+    error?: string;
+    disabled?: boolean;
+}
+```
+
+Referenced types and APIs: [`CustomModelValue`](#custommodelvalue).
+
+### BranchHistoryState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/history.ts#L6)
+
+```ts
+export interface BranchHistoryState {
+    nodes: readonly BranchHistoryNode[] | null;
+    error?: string;
+    loading?: boolean;
+}
+```
+
+Referenced types and APIs: [`BranchHistoryNode`](#branchhistorynode).
+
+### ModelSelection
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/model-editor.ts#L25)
+
+```ts
+export interface ModelSelection {
+    provider: string;
+    model: string;
+    thinkingLevel: string;
+}
+```
+
+### thinkingLabel
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/model-editor.ts#L35)
+
+```ts
+export declare function thinkingLabel(level: string): string;
+```
+
+### MCPConnectionAction
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/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/v0.2.0-app.2/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/v0.2.0-app.2/src/forms/panels.ts#L193)
+
+```ts
+export interface MCPConnectionItem {
+    name: string;
+    type: string;
+    url?: string;
+    command?: string;
+    args?: readonly string[];
+    enabled: boolean;
+    hasBearerToken?: boolean;
+    status?: string;
+    statusLabel: string;
+    envKeys?: readonly string[];
+    error?: string;
+    oauth?: boolean;
+    signedIn?: boolean;
+}
+```
+
+### MCPConnectionsState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/panels.ts#L144)
+
+```ts
+export interface MCPConnectionsState extends FormFeedback {
+    formError?: string;
+}
+```
+
+Referenced types and APIs: [`FormFeedback`](#formfeedback).
+
+### MCPConnectionTarget
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/panels.ts#L199)
+
+```ts
+export interface MCPConnectionTarget {
+    readonly name: string;
+}
+```
+
+### MCPEditorValue
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/panels.ts#L142)
+
+```ts
+export interface MCPEditorValue {
+    name: string;
+    type: string;
+    url?: string;
+    oauth?: boolean;
+    oauthClientId?: string;
+    oauthScope?: string;
+    command?: string;
+    args?: readonly string[];
+    enabled?: boolean;
+    hasBearerToken?: boolean;
+    envKeys?: readonly string[];
+}
+```
+
+### ModelPickerState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/panels.ts#L180)
+
+```ts
+export interface ModelPickerState extends FormFeedback {
+    editor?: ModelEditorState;
+    loading?: boolean;
+}
+```
+
+Referenced types and APIs: [`FormFeedback`](#formfeedback), [`ModelEditorState`](#modeleditorstate).
+
+### SettingsDraft
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/panels.ts#L42)
+
+```ts
+export interface SettingsDraft {
+    provider: string;
+    baseUrl: string;
+    apiKey: string;
+}
+```
+
+### SettingsPanelState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/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 types and APIs: [`FormFeedback`](#formfeedback).
+
+### SettingsProviderOption
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/panels.ts#L43)
+
+```ts
+export interface SettingsProviderOption {
+    id: string;
+    name: string;
+    configured?: boolean;
+    signedIn?: boolean;
+}
+```
+
+### ProviderLoginState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/provider-login.ts#L7)
+
+```ts
+export interface ProviderLoginState {
+    phase: string;
+    message: string;
+    url?: string;
+    code?: string;
+    prompt?: string;
+    promptType?: string;
+    options?: readonly {
+        id: string;
+        label: string;
+    }[] | null;
+    error?: string;
+    disabled?: boolean;
+}
+```
+
+### ResourceDraft
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/resource-editor.ts#L6)
+
+```ts
+export interface ResourceDraft {
+    name: string;
+    content: string;
+}
+```
+
+### RenameConversationDraft
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/navigation/navigation.ts#L83)
+
+```ts
+export interface RenameConversationDraft {
+    id: string;
+    title: string;
+}
+```
+
+### RenameConversationState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/navigation/navigation.ts#L82)
+
+```ts
+export interface RenameConversationState {
+    id: string;
+    title: string;
+    error?: string;
+    disabled?: boolean;
+}
+```
+
+### WorkspacePickerState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/navigation/navigation.ts#L130)
+
+```ts
+export interface WorkspacePickerState {
+    workspaces: readonly {
+        id: string;
+        name: string;
+        path: string;
+    }[];
+    error?: string;
+    disabled?: boolean;
+}
+```
+
+### ApprovalPanelState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/tasks/approval.ts#L7)
+
+```ts
+export interface ApprovalPanelState {
+    approval: ApprovalView | null;
+    disabled?: boolean;
+}
+```
+
+Referenced types and APIs: [`ApprovalView`](#approvalview).
+
+### FullAccessState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/tasks/permission.ts#L7)
+
+```ts
+export interface FullAccessState {
+    title?: string;
+    error?: string;
+    disabled?: boolean;
+}
+```
+
+### PermissionControlState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/tasks/permission.ts#L39)
+
+```ts
+export interface PermissionControlState {
+    mode: string;
+    description: string;
+    disabled?: boolean;
+}
+```
+
+### TaskFailureState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/tasks/permission.ts#L18)
+
+```ts
+export interface TaskFailureState {
+    visible: boolean;
+    message: string;
+    advice: string;
+    canContinue: boolean;
+    workspaceId?: string;
+}
+```
+
+### RuntimePanelState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/tasks/runtime.ts#L5)
+
+```ts
+export interface RuntimePanelState {
+    visible: boolean;
+    summary: string;
+    duration: string;
+    speed: string;
+    provider?: string;
+    thinkingLevel?: string;
+    inputTokens: string;
+    outputTokens: string;
+    cacheRead: string;
+    cacheWrite: string;
+    contextTokens: string;
+    contextWindow: string;
+    compactions: string;
+    toolFailures: string;
+    recordedCost: string;
+    latestCost: string;
+}
+```
+
+### Appearance
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/theme.ts#L1)
+
+```ts
+export type Appearance = 'light' | 'dark' | 'system';
+```
+
+### ComposerViewState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/workspace.ts#L9)
+
+```ts
+export interface ComposerViewState {
+    placeholder?: string;
+    disabled?: boolean;
+    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;
+    };
+}
+```
+
+### WorkspaceShellState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/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;
+}
+```
+
+## Supporting declarations
+
+### HostResult
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/internal.ts#L12)
+
+```ts
+export type HostResult = void | ActionResult | Promise<void | ActionResult>;
+```
+
+Referenced types and APIs: [`ActionResult`](#actionresult).
+
+### SettingsViewSession
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L19)
+
+```ts
+/** Session methods address one owned opening, never a later use of its window. */
+export interface SettingsViewSession<State> {
+    update(state: Readonly<State>): void;
+    fail(message: string): void;
+    close(): void;
+    isOpen(): boolean;
+    destroy(): void;
+}
+```
+
+### Submission
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/app/settings.ts#L16)
+
+```ts
+type Submission<Value> = (value: Value) => ActionResult | Promise<ActionResult>;
+```
+
+Referenced types and APIs: [`ActionResult`](#actionresult).
+
+### AttachmentItem
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/composer.ts#L55)
+
+```ts
+export interface AttachmentItem {
+    id: string;
+    url: string;
+    name: string;
+}
+```
+
+### PendingMessage
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/composer.ts#L6)
+
+```ts
+export interface PendingMessage {
+    id: string;
+    text: string;
+    mode: string;
+    imageCount?: number;
+}
+```
+
+### LocalContentLink
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/content/markdown.ts#L5)
+
+```ts
+export interface LocalContentLink {
+    path: string;
+    conversationId: string;
+}
+```
+
+### CostRequestDisplay
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/files/systems.ts#L18)
+
+```ts
+export interface CostRequestDisplay {
+    id: string;
+    purpose: string;
+    status: string;
+    provider: string;
+    providerName?: string;
+    model: string;
+    modelName?: string;
+    time: string;
+    source: string;
+    price: unknown;
+    known: boolean;
+    usage: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+        reasoning?: number;
+        cost: {
+            total: number;
+        };
+    };
+}
+```
+
+### CostSummaryDisplay
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/files/systems.ts#L9)
+
+```ts
+export interface CostSummaryDisplay {
+    unavailable?: boolean;
+    requestCount: number;
+    unknownRequests: number;
+    runRequests: number;
+    runUnknownRequests: number;
+    total: number;
+    runTotal: number;
+}
+```
+
+### CustomModelDraft
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/custom-connection.ts#L7)
+
+```ts
+export interface CustomModelDraft {
+    sourceIndex: number;
+    id: string;
+    name: string;
+    contextWindow: number;
+    maxTokens: number;
+    reasoning: boolean;
+    images: boolean;
+    prices: {
+        input: string;
+        output: string;
+        cacheRead: string;
+        cacheWrite: string;
+    };
+}
+```
+
+### CustomModelValue
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/custom-connection.ts#L5)
+
+```ts
+export interface CustomModelValue {
+    id: string;
+    name?: string;
+    contextWindow?: number;
+    maxTokens?: number;
+    reasoning?: boolean;
+    input?: readonly string[];
+    cost?: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+}
+```
+
+### BranchHistoryNode
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/history.ts#L5)
+
+```ts
+export interface BranchHistoryNode {
+    id: string;
+    role: string;
+    text: string;
+    active: boolean;
+}
+```
+
+### ModelEditorState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/model-editor.ts#L19)
+
+```ts
+export interface ModelEditorState {
+    providers: readonly ModelProviderOption[] | null;
+    models: readonly ModelOption[] | null;
+    selection: ModelSelection;
+    disabled?: boolean;
+}
+```
+
+Referenced types and APIs: [`ModelOption`](#modeloption), [`ModelProviderOption`](#modelprovideroption), [`ModelSelection`](#modelselection).
+
+### ModelOption
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/model-editor.ts#L10)
+
+```ts
+export interface ModelOption {
+    id: string;
+    name: string;
+    provider: string;
+    thinkingLevels?: readonly string[] | null;
+    supportsImages: boolean;
+    contextWindow: number;
+    maxTokens: number;
+}
+```
+
+### ModelProviderOption
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/model-editor.ts#L4)
+
+```ts
+export interface ModelProviderOption {
+    id: string;
+    name: string;
+    model?: string;
+    thinkingLevel?: string;
+}
+```
+
+### FormFeedback
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/panels.ts#L10)
+
+```ts
+export interface FormFeedback {
+    error?: string;
+    disabled?: boolean;
+}
+```
+
+### SettingsCredentialView
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/forms/panels.ts#L44)
+
+```ts
+export interface SettingsCredentialView {
+    status: string;
+    hidden: boolean;
+    required: boolean;
+    placeholder: string;
+    removeVisible: boolean;
+    hint?: string;
+    actions?: Node;
+}
+```
+
+### ApprovalView
+
+[Source](https://github.com/minifish-org/pith-ui/blob/v0.2.0-app.2/src/tasks/approval.ts#L6)
+
+```ts
+export interface ApprovalView {
+    id: string;
+    toolName: string;
+    warning?: string;
+    canAlwaysAllow: boolean;
+    argsText: string;
+    preview?: {
+        kind: string;
+        path: string;
+        error?: string;
+        diff?: string;
+        truncated?: boolean;
+    };
+}
+```