@makinbakin/sdk 0.0.1-rc.1 → 0.0.1-rc.11

package/README.md

@@ -86,6 +86,7 @@ component for a slot via `registerPlugin({ slots: { 'slot-name': Component } })`
 | `task-assets`         | Task drawer, asset attachments section                   |
 | `task-sidebar`        | Task drawer sidebar (custom panels for a plugin's tasks) |
 | `home-widget`         | Dashboard home widget grid                               |
+| `nav-badge-providers` | Background hook runners (render `null`) that drive `setNavBadge` |
 | `page:/<route>`       | Full-page mount at `<route>`                             |
 
 ## Sub-path imports

package/_internal/app/components/agent-select.d.ts

@@ -1,6 +1,11 @@
-interface AgentSelectProps {
+import type { AriaAttributes } from 'react';
+interface AgentSelectProps extends Pick<AriaAttributes, 'aria-describedby' | 'aria-invalid'> {
+    id?: string;
     value: string;
     onValueChange: (value: string) => void;
+    /** Include the workflow/task runtime assignee token (`$assigned`) */
+    includeAssigned?: boolean;
+    assignedLabel?: string;
     /** Show a "None" / "Unassigned" option at the top (default: false) */
     allowNone?: boolean;
     /** Label for the none option (default: "Unassigned") */
@@ -11,5 +16,5 @@ interface AgentSelectProps {
     agentIds?: string[];
     className?: string;
 }
-export declare function AgentSelect({ value, onValueChange, allowNone, noneLabel, placeholder, agentIds, className, }: AgentSelectProps): import("react/jsx-runtime").JSX.Element;
+export declare function AgentSelect({ value, onValueChange, includeAssigned, assignedLabel, allowNone, noneLabel, placeholder, agentIds, className, id, 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, }: AgentSelectProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/_internal/app/components/ui/button.d.ts

@@ -1,7 +1,7 @@
 import { Button as ButtonPrimitive } from "@base-ui/react/button";
 import { type VariantProps } from "class-variance-authority";
 declare const buttonVariants: (props?: ({
-    variant?: "destructive" | "link" | "default" | "outline" | "secondary" | "ghost" | "warning" | "accent" | null | undefined;
+    variant?: "info" | "destructive" | "link" | "default" | "outline" | "secondary" | "ghost" | "warning" | "accent" | null | undefined;
     size?: "default" | "sm" | "lg" | "icon" | "xs" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare function Button({ className, variant, size, ...props }: ButtonPrimitive.Props & VariantProps<typeof buttonVariants>): import("react/jsx-runtime").JSX.Element;

package/_internal/app/hooks/use-content-store.d.ts

@@ -15,6 +15,7 @@ interface ContentStore extends ContentState {
     activityEvents: ActivityEvent[];
     sseConnected: boolean;
     taskboardVersion: number;
+    doctorVersion: number;
     debug: boolean;
     reindexProgress: Record<string, ReindexProgressEntry>;
     setFiles: (files: Record<string, string>) => void;
@@ -26,6 +27,7 @@ interface ContentStore extends ContentState {
     setActivityEvents: (events: ActivityEvent[]) => void;
     setSseConnected: (connected: boolean) => void;
     bumpTaskboard: () => void;
+    bumpDoctor: () => void;
     setDebug: (debug: boolean) => void;
     toggleDebug: () => void;
     setReindexProgress: (table: string, indexed: number, done: boolean) => void;

package/_internal/app/hooks/use-nav-badge.d.ts

@@ -0,0 +1,13 @@
+import { type NavBadge } from '@makinbakin/sdk';
+/**
+ * Sync a nav item's badge to the value passed each render. Calls
+ * `setNavBadge(pluginId, navItemId, badge)` only when the badge's value
+ * actually changes — the effect is keyed on a serialization of `count` +
+ * `tone`, not the object identity (which a parent recreates every render).
+ *
+ * This is the recommended glue for a badge provider: keep your own summary
+ * hook (fetch + refresh) per plugin, derive a `NavBadge | null`, and pass it
+ * here. Teardown is handled by `unregisterPlugin`, so this does not clear on
+ * unmount (which would flicker on dev hot-reload).
+ */
+export declare function useNavBadge(pluginId: string, navItemId: string, badge: NavBadge | null): void;

package/_internal/app/types/index.d.ts

@@ -2,6 +2,7 @@ export interface TaskLogEntry {
     timestamp: string;
     author: string;
     message: string;
+    data?: Record<string, unknown>;
 }
 export interface Task {
     id: string;
@@ -56,48 +57,6 @@ export interface ProjectMeta {
     status?: string;
     content: string;
 }
-export interface AssetVariantMeta {
-    role: 'thumbnail' | 'optimized' | 'webp';
-    path: string;
-    filename: string;
-    size: number;
-    mimeType: string;
-}
-export interface AssetMeta {
-    path: string;
-    filename: string;
-    type: 'text' | 'images' | 'video' | 'audio' | 'plans' | 'research' | 'pdf' | 'data' | 'other';
-    mimeType: string;
-    size: number;
-    mtimeMs?: number;
-    metadata: {
-        agent: string;
-        taskId: string | null;
-        created: string;
-        tool?: string;
-        description?: string;
-        tags?: string[];
-        originalFilename?: string;
-    };
-    variants?: AssetVariantMeta[];
-}
-export interface TrashedAssetMeta {
-    filename: string;
-    originalFilename: string;
-    type: string;
-    mimeType: string;
-    size: number;
-    deletedAt: string;
-    expiresAt: string;
-    metadata: {
-        agent: string;
-        taskId: string | null;
-        created: string;
-        tool?: string;
-        description?: string;
-        tags?: string[];
-    } | null;
-}
 export interface OfficeData {
     asciiMap: string;
     statusTable: {
@@ -118,6 +77,7 @@ export interface ActivityEvent {
     taskTitle?: string;
     eventName?: string;
     duplicate?: boolean;
+    data?: Record<string, unknown>;
 }
 export interface ContentState {
     files: Record<string, string>;

package/_internal/core/adapters/runtime/concepts.d.ts

@@ -38,7 +38,19 @@ export interface WorkspaceFile {
     updatedAt?: string;
     metadata?: RuntimeMetadata;
 }
-export interface MessageArgs {
+export type RuntimeMessageToolsMode = 'auto' | 'none';
+export interface RuntimeMessageToolPolicy {
+    /**
+     * Controls whether runtime-native tools are available for this agent turn.
+     * `none` disables tools. Omit or use `auto` for runtime/provider defaults.
+     */
+    toolsMode?: RuntimeMessageToolsMode;
+    /** Optional runtime-native tool allowlist for this turn. */
+    toolsAllow?: string[];
+    /** Optional runtime-native tool denylist for this turn. */
+    toolsDeny?: string[];
+}
+export interface MessageArgs extends RuntimeMessageToolPolicy {
     agentId: string;
     content: string;
     /**
@@ -296,6 +308,94 @@ export interface RuntimeAvailableModel {
     tags?: string[];
     metadata?: RuntimeMetadata;
 }
+export type RuntimeImageOutputFormat = 'png' | 'jpeg' | 'jpg' | 'webp';
+export type RuntimeImageBackground = 'transparent' | 'opaque' | 'auto';
+/**
+ * Image capability is intentionally all-optional. A thin runtime that exposes a
+ * single image tool maps on by filling minimal fields (e.g. one synthesized
+ * provider with a defaultModel); a rich runtime fills more. Consumers MUST
+ * treat a sparse capability as normal and never require a field a thin runtime
+ * cannot provide — gaps are filled below, in the adapter/shim, not pushed up
+ * into plugins. See .claude/specs/media-generation-adapter-architecture.md.
+ */
+export interface RuntimeImageProviderCapabilities {
+    generate?: {
+        maxCount?: number;
+        supportsSize?: boolean;
+        supportsAspectRatio?: boolean;
+        supportsResolution?: boolean;
+    };
+    edit?: {
+        enabled?: boolean;
+        maxCount?: number;
+        maxInputImages?: number;
+        supportsSize?: boolean;
+        supportsAspectRatio?: boolean;
+        supportsResolution?: boolean;
+    };
+    geometry?: {
+        sizes?: string[];
+        aspectRatios?: string[];
+        resolutions?: string[];
+    };
+    output?: {
+        formats?: string[];
+        qualities?: string[];
+        backgrounds?: string[];
+    };
+    metadata?: RuntimeMetadata;
+}
+export interface RuntimeImageProvider {
+    id: string;
+    label?: string;
+    defaultModel?: string;
+    models?: string[];
+    available?: boolean;
+    configured?: boolean;
+    selected?: boolean;
+    capabilities?: RuntimeImageProviderCapabilities;
+    metadata?: RuntimeMetadata;
+}
+export interface RuntimeImageGenerateInput {
+    prompt: string;
+    provider?: string;
+    model?: string;
+    count?: number;
+    width?: number;
+    height?: number;
+    size?: string;
+    aspectRatio?: string;
+    resolution?: string;
+    outputFormat?: RuntimeImageOutputFormat;
+    background?: RuntimeImageBackground;
+    timeoutMs?: number;
+    metadata?: RuntimeMetadata;
+}
+export interface RuntimeImageEditInput extends RuntimeImageGenerateInput {
+    files: string[];
+}
+export interface RuntimeImageFile {
+    filePath: string;
+    mimeType?: string;
+    width?: number;
+    height?: number;
+    provider?: string;
+    model?: string;
+    url?: string;
+    metadata?: RuntimeMetadata;
+}
+export interface RuntimeImageGenerationResult {
+    images: RuntimeImageFile[];
+    provider?: string;
+    model?: string;
+    providerText?: string;
+    metadata?: RuntimeMetadata;
+}
+export interface RuntimeImagesAccess {
+    providers(): Promise<RuntimeImageProvider[]>;
+    generate(input: RuntimeImageGenerateInput): Promise<RuntimeImageGenerationResult>;
+    edit(input: RuntimeImageEditInput): Promise<RuntimeImageGenerationResult>;
+}
 export interface TaskDispatchArgs {
     bakinTaskId: string;
     agentId?: string;
@@ -452,6 +552,7 @@ export interface AgentRuntimeAdapter {
             includeUnavailable?: boolean;
         }): Promise<RuntimeAvailableModel[]>;
     };
+    images?: RuntimeImagesAccess;
     tasks: {
         dispatch(args: TaskDispatchArgs): Promise<TaskDispatchResult>;
         getExecutionStatus(flowId: string): Promise<TaskExecutionStatus>;

package/_internal/core/adapters/runtime/index.d.ts

@@ -2,4 +2,4 @@ export type { AdapterAuditEvent, AdapterHealthCheckDefinition, AdapterHealthChec
 export type { ChannelCapability } from './capabilities';
 export { hasChannelCapability } from './capabilities';
 export { getRuntimeMainAgent, getRuntimeMainAgentId, getRuntimeMainAgentName, selectRuntimeMainAgent, } from './helpers';
-export type { AgentRuntimeAdapter, ApprovalDelivery, ApprovalOption, ApprovalPatch, ApprovalRenderRef, ApprovalRenderResult, ApprovalResolveEvent, ApprovalResponse, CancelApprovalArgs, ChannelInfo, ChannelInteractionEvent, ChannelMessageArgs, ChannelMessageEvent, ChatChunk, ContentDeliveryArgs, CreateApprovalArgs, CreateCronJobInput, CreateRuntimeAgentInput, CronJob, CronRun, DeliveryResult, DurableApprovalRecord, EditApprovalArgs, ListExecutionsOpts, MessageArgs, MessageResult, NotificationArgs, ResolveApprovalArgs, RuntimeAgent, RuntimeAllowlistPatch, RuntimeToolActivity, RuntimeAvailableModel, RuntimeConfigAccess, RuntimeMemoryEntry, RuntimeMemoryEntryStat, RuntimeMemoryPathMatch, RuntimeMemoryReadRange, RuntimeMemorySearchResult, RuntimeMemoryTier, RuntimeMetadata, RuntimePermissionPatch, RawCronSnapshot, RuntimeSession, RuntimeSkill, TaskDispatchArgs, TaskDispatchResult, TaskExecutionEvent, TaskExecutionStatus, ToolDefinition, ToolResult, UpdateCronJobInput, UpdateRuntimeAgentInput, WorkspaceFile, } from './concepts';
+export type { AgentRuntimeAdapter, ApprovalDelivery, ApprovalOption, ApprovalPatch, ApprovalRenderRef, ApprovalRenderResult, ApprovalResolveEvent, ApprovalResponse, CancelApprovalArgs, ChannelInfo, ChannelInteractionEvent, ChannelMessageArgs, ChannelMessageEvent, ChatChunk, ContentDeliveryArgs, CreateApprovalArgs, CreateCronJobInput, CreateRuntimeAgentInput, CronJob, CronRun, DeliveryResult, DurableApprovalRecord, EditApprovalArgs, ListExecutionsOpts, MessageArgs, MessageResult, NotificationArgs, ResolveApprovalArgs, RuntimeAgent, RuntimeAllowlistPatch, RuntimeToolActivity, RuntimeAvailableModel, RuntimeConfigAccess, RuntimeImageBackground, RuntimeImageEditInput, RuntimeImageFile, RuntimeImageGenerateInput, RuntimeImageGenerationResult, RuntimeImageOutputFormat, RuntimeImageProvider, RuntimeImageProviderCapabilities, RuntimeImagesAccess, RuntimeMemoryEntry, RuntimeMemoryEntryStat, RuntimeMemoryPathMatch, RuntimeMemoryReadRange, RuntimeMemorySearchResult, RuntimeMemoryTier, RuntimeMessageToolPolicy, RuntimeMessageToolsMode, RuntimeMetadata, RuntimePermissionPatch, RawCronSnapshot, RuntimeSession, RuntimeSkill, TaskDispatchArgs, TaskDispatchResult, TaskExecutionEvent, TaskExecutionStatus, ToolDefinition, ToolResult, UpdateCronJobInput, UpdateRuntimeAgentInput, WorkspaceFile, } from './concepts';

package/_internal/core/plugin-types.d.ts

@@ -109,6 +109,16 @@ export interface SkillDefinition {
     instructions: string;
     output_schema?: Record<string, unknown>;
     source?: string;
+    /** Absolute source markdown file path when the skill was loaded from a managed package/plugin file. */
+    sourcePath?: string;
+}
+export interface WorkflowLayoutInput {
+    positions?: Record<string, {
+        x: number;
+        y: number;
+        [key: string]: unknown;
+    }>;
+    [key: string]: unknown;
 }
 export interface WorkflowDefinitionInput {
     /** Stable workflow id. Falls back to slug(name) when omitted. */
@@ -117,7 +127,9 @@ export interface WorkflowDefinitionInput {
     description: string;
     version: number;
     inputs?: Record<string, unknown>;
+    layout?: WorkflowLayoutInput;
     steps: unknown[];
+    [key: string]: unknown;
 }
 export interface ActivityAPI {
     /** Log a human-readable message to the live activity feed */
@@ -431,44 +443,93 @@ export interface PluginTaskService {
     }): Promise<PluginTask[]>;
     appendLog(id: string, entry: TaskLogEntry): Promise<void>;
 }
-export interface AssetVariantMeta {
-    role: 'thumbnail' | 'optimized' | 'webp';
-    path: string;
-    filename: string;
-    size: number;
+/** The asset type taxonomy (mirrors ASSET_TYPES in the assets plugin). */
+export type AssetTypeName = 'text' | 'images' | 'video' | 'audio' | 'plans' | 'research' | 'pdf' | 'data' | 'other';
+/** Per-version generation provenance (matches the manifest's `generation` block). */
+export interface AssetGenerationInfo {
+    provider: string;
+    model: string;
+    surface: string;
+    quality: string;
+    routeSource: string;
+    routeReason?: string;
+}
+/** Create a new versioned asset (v1) from a source file. */
+export interface AssetCreateInput {
+    sourceFilePath: string;
+    type: AssetTypeName;
+    agent: string;
+    taskId: string | null;
+    slug?: string;
+    op?: 'generate' | 'upload' | 'import';
+    tool?: string | null;
+    prompt?: string | null;
+    promptHash?: string | null;
+    description?: string;
+    tags?: string[];
+    source?: {
+        kind: 'generated' | 'upload' | 'import' | 'clipboard' | 'workspace-file';
+        path: string | null;
+    };
+    generation?: AssetGenerationInfo | null;
+}
+/** Append a new version to an existing asset. */
+export interface AssetVersionCreateInput {
+    sourceFilePath: string;
+    op?: 'edit' | 'generate' | 'upload' | 'import';
+    tool?: string | null;
+    prompt?: string | null;
+    promptHash?: string | null;
+    description?: string;
+    tags?: string[];
+    generation?: AssetGenerationInfo | null;
+}
+/** Render a derived export of a version (keyed/idempotent by surface). */
+export interface AssetExportRequest {
+    fromVersion?: number;
+    surface: string;
+    format: 'jpg' | 'png' | 'webp';
+    width: number;
+    height: number;
+    quality?: number;
+}
+export interface VersionedAssetRef {
+    assetId: string;
+    version: number;
+}
+export interface AssetVersionFileRef {
+    absPath: string;
     mimeType: string;
+    version: number;
 }
-export interface AssetMeta {
-    path: string;
-    filename: string;
-    type: 'text' | 'images' | 'video' | 'audio' | 'plans' | 'research' | 'pdf' | 'data' | 'other';
+/** Current-version summary of an asset, addressed by id. */
+export interface AssetSummary {
+    assetId: string;
+    type: AssetTypeName;
+    agent: string;
+    taskId: string | null;
+    created: string;
+    updated: string;
+    currentVersion: number;
+    versionCount: number;
+    description: string;
+    tags: string[];
     mimeType: string;
+    width: number | null;
+    height: number | null;
     size: number;
-    mtimeMs?: number;
-    metadata: {
-        agent: string;
-        taskId: string | null;
-        created: string;
-        tool?: string;
-        description?: string;
-        tags?: string[];
-        originalFilename?: string;
-    };
-    variants?: AssetVariantMeta[];
-}
-export interface AssetFileRef {
-    kind: 'asset';
-    filename: string;
-    mimeType?: string;
+    hasThumb: boolean;
 }
 export interface AssetsAPI {
-    getByFilename(filename: string): Promise<AssetMeta | null>;
-    list(filter?: {
-        type?: AssetMeta['type'];
-        taskId?: string | null;
-    }): Promise<AssetMeta[]>;
-    exists(filename: string): Promise<boolean>;
-    fileRef(filename: string): Promise<AssetFileRef>;
+    createAsset(input: AssetCreateInput): Promise<VersionedAssetRef>;
+    /** Read an asset's current-version summary by id (metadata: type/description/tags/etc.), or null. */
+    getAsset(assetId: string): Promise<AssetSummary | null>;
+    addVersion(assetId: string, input: AssetVersionCreateInput): Promise<VersionedAssetRef>;
+    addExport(assetId: string, input: AssetExportRequest): Promise<{
+        name: string;
+        file: string;
+    }>;
+    resolveVersionFile(assetId: string, version?: number): Promise<AssetVersionFileRef | null>;
 }
 /** Field type for search content type schemas */
 export interface SearchSchemaField {
@@ -597,6 +658,8 @@ export interface SearchResult {
     fields: Record<string, unknown>;
     /** Cross-encoder reranker score (present when a reranker was used). */
     rerankScore?: number;
+    /** Per-index score breakdown (e.g. { full_text_index_v0, assets_text, assets_visual }). */
+    indexScores?: Record<string, number>;
 }
 /** Search response from a query */
 export interface SearchResponse {
@@ -720,6 +783,13 @@ export interface FileBackedContentTypeDefinition extends SearchContentTypeDefini
      * own initial population (rare).
      */
     buildOnStartup?: boolean;
+    /**
+     * Keep indexed documents that are not represented by a matched file when
+     * verifyExists(key) still returns true. Use this only for hybrid content
+     * types that combine file-backed rows with registry/runtime rows in the
+     * same table.
+     */
+    preserveVirtualDocuments?: boolean;
 }
 /** Search API provided to plugins via ctx.search */
 export interface SearchAPI {

package/_internal/plugins/team/types.d.ts

@@ -67,12 +67,13 @@ export interface SkillSummary {
  * client doesn't reach across the package boundary for types.
  *
  * The server today returns 4 states (`absent | unmanaged | adopted | managed`).
- * `drifted` and `update-available` are declared on the badge component for
- * forward-compat — wiring handles them but the API doesn't yet emit them.
+ * `drifted` and `update-available` are display states layered on top of the
+ * server row when diagnostics or update checks report additional status.
  */
 export interface PackageStateRow {
     agentId: string;
     state: 'absent' | 'unmanaged' | 'adopted' | 'managed' | 'drifted' | 'update-available';
+    version?: string;
     packageId?: string;
     entry?: {
         source: string;
@@ -82,6 +83,15 @@ export interface PackageStateRow {
         version?: string;
         dependencies?: string[];
     };
+    updateStatus?: {
+        currentVersion: string;
+        latestVersion: string | null;
+        currentCommitSha: string;
+        latestCommitSha: string | null;
+        upgradeAvailable: boolean;
+        checkedAt: string;
+        error?: string;
+    };
 }
 /**
  * Single message from a runtime session JSONL. Used by the Active Context

package/components/index.d.ts

@@ -6,29 +6,64 @@
  * not include layout chrome (sidebar, header, toaster) — those are Bakin's
  * shell, not plugin-author territory.
  */
+/** Round avatar image for an agent, falls back to initials. */
 export { AgentAvatar } from '../_internal/app/components/agent-avatar';
+/** Multi-select facet filter scoped to agents. */
 export { AgentFilter } from '../_internal/app/components/agent-filter';
+/** Single-agent picker dropdown for form fields. */
 export { AgentSelect } from '../_internal/app/components/agent-select';
-export { AgentDot, AgentStatus } from '../_internal/app/components/agent-status';
+/** Small status dot showing an agent's online/offline state. */
+export { AgentDot } from '../_internal/app/components/agent-status';
+/** Compound agent status (dot + label + last-seen timestamp). */
+export { AgentStatus } from '../_internal/app/components/agent-status';
+/** Right-side slide-out drawer with backdrop and focus trap. */
 export { BakinDrawer } from '../_internal/app/components/bakin-drawer';
+/** Color picker swatch grid for tag/agent color assignment. */
 export { ColorPicker } from '../_internal/app/components/color-picker';
+/** Centered empty-state component with icon, title, and CTA. */
 export { EmptyState } from '../_internal/app/components/empty-state';
+/** Inline error banner with dismiss + retry actions. */
 export { ErrorBanner } from '../_internal/app/components/error-banner';
+/** Full-page error state with title, description, and retry button. */
 export { ErrorState } from '../_internal/app/components/error-state';
+/** Popover multi-select facet filter (column, owner, tag, etc.). */
 export { FacetFilter } from '../_internal/app/components/facet-filter';
 export type { FacetOption } from '../_internal/app/components/facet-filter';
+/** Chat + plan-proposal review panel for brainstorm sessions. */
 export { IntegratedBrainstorm } from '../_internal/app/components/integrated-brainstorm';
 export type { BrainstormMessage, IntegratedBrainstormProps, BrainstormOnSend, SendContext, AssistantTransformed, BrainstormActivityInput, BrainstormActivityStorageInput, BrainstormActivityStorageRecord, BrainstormTimelineActivityInput, BrainstormTimelineMessageInput, } from '../_internal/app/components/integrated-brainstorm';
-export { brainstormActivityMessageFromCustom, brainstormThreadId, normalizeBrainstormActivityForStorage, normalizeBrainstormActivityMessageForStorage, readBrainstormSseResponse, runtimeChunkToBrainstormActivity, toBrainstormTimeline, } from '../_internal/app/components/integrated-brainstorm';
+/** Convert a custom activity message back into a brainstorm activity. */
+export { brainstormActivityMessageFromCustom } from '../_internal/app/components/integrated-brainstorm';
+/** Compute the canonical thread ID for a brainstorm session. */
+export { brainstormThreadId } from '../_internal/app/components/integrated-brainstorm';
+/** Normalize a brainstorm activity payload for persistence. */
+export { normalizeBrainstormActivityForStorage } from '../_internal/app/components/integrated-brainstorm';
+/** Normalize a single brainstorm message for persistence. */
+export { normalizeBrainstormActivityMessageForStorage } from '../_internal/app/components/integrated-brainstorm';
+/** Read an SSE response stream into brainstorm activity events. */
+export { readBrainstormSseResponse } from '../_internal/app/components/integrated-brainstorm';
+/** Convert a runtime chat chunk to a brainstorm activity event. */
+export { runtimeChunkToBrainstormActivity } from '../_internal/app/components/integrated-brainstorm';
+/** Fold a brainstorm session's events into a renderable timeline. */
+export { toBrainstormTimeline } from '../_internal/app/components/integrated-brainstorm';
+/** Render markdown content with syntax highlighting and link handling. */
 export { MarkdownContent } from '../_internal/app/components/markdown-content';
+/** Editable markdown text area with preview toggle. */
 export { MarkdownEditor } from '../_internal/app/components/markdown-editor';
+/** Model picker dropdown listing available models from the catalog. */
 export { ModelSelect } from '../_internal/app/components/model-select';
+/** Standard plugin page wrapper with header, content area, and toaster. */
 export { PageLayout } from '../_internal/app/components/page-layout';
+/** Plugin page header with title, count badge, search, and action buttons. */
 export { PluginHeader } from '../_internal/app/components/plugin-header';
+/** Render a settings form from a PluginSettingsSchema definition. */
 export { PluginSettingsRenderer } from '../_internal/app/components/plugin-settings-renderer';
 export type { PluginSettingsSchema } from '../_internal/app/components/plugin-settings-renderer';
+/** Sortable table column header with ascending/descending indicator. */
 export { SortableHead } from '../_internal/app/components/sortable-head';
 export type { SortDir } from '../_internal/app/components/sortable-head';
+/** Tab list with animated underline indicator. */
 export { UnderlineTabs } from '../_internal/app/components/underline-tabs';
 export type { UnderlineTab } from '../_internal/app/components/underline-tabs';
+/** Icon component for a notification channel (Discord, Slack, email, etc.). */
 export { ChannelIcon } from '../_internal/plugins/workflows/hooks/channel-icon';