@makinbakin/sdk 0.0.1-rc.8 → 0.0.1-rc.9

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/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

@@ -56,48 +56,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: {

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

@@ -308,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;
@@ -464,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, RuntimeMessageToolPolicy, RuntimeMessageToolsMode, 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

@@ -441,44 +441,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 {
@@ -607,6 +656,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 {

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';