@makinbakin/sdk 0.0.0-bootstrap.0 → 0.0.1-rc.10

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 */
@@ -128,6 +140,12 @@ export interface ActivityAPI {
     /** Log a structured audit event */
     audit(event: string, agent: string, data?: Record<string, unknown>): void;
 }
+export interface PluginLogger {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, errorOrData?: unknown, data?: Record<string, unknown>): void;
+    error(message: string, errorOrData?: unknown, data?: Record<string, unknown>): void;
+}
 export interface HookAPI {
     /** Register a handler for a named hook. Returns unsubscribe function. */
     register(name: string, handler: (data: any) => any, metadata?: HookRegistrationMetadata): () => void;
@@ -218,6 +236,33 @@ export interface HealthCheckResult {
     message: string;
     autoFixable: boolean;
 }
+export type HealthRepairSafety = 'safe' | 'manual' | 'destructive';
+export interface HealthRepairChange {
+    kind: 'file' | 'setting' | 'service' | 'runtime' | 'task' | 'other';
+    target: string;
+    action: 'create' | 'update' | 'delete' | 'install' | 'invoke';
+    description: string;
+}
+export interface HealthRepairPlanItem {
+    id: string;
+    checkId: string;
+    title: string;
+    reason: string;
+    safety: HealthRepairSafety;
+    requiresConfirmation: boolean;
+    changes: HealthRepairChange[];
+}
+export interface HealthRepairApplyResult {
+    id: string;
+    checkId: string;
+    status: 'applied' | 'skipped' | 'failed';
+    message: string;
+    changes: HealthRepairChange[];
+}
+export interface HealthRepairHandler {
+    plan(rows: HealthCheckResult[]): Promise<HealthRepairPlanItem[]>;
+    apply(items: HealthRepairPlanItem[]): Promise<HealthRepairApplyResult[]>;
+}
 /**
  * Input shape plugins pass to `ctx.registerHealthCheck`. The plugin id is
  * auto-namespaced as `{pluginId}.{id}`. `run()` returns an array so one
@@ -234,12 +279,15 @@ export interface PluginHealthCheckInput {
      */
     run: () => Promise<HealthCheckResult[]>;
     /**
-     * Advisory flag for admin UIs: `true` if `run()` may perform safe
-     * auto-fixes internally. Pure metadata in v1 — the orchestrator always
-     * invokes every registered check regardless of this value. Plugins that
-     * do internal auto-fixes gate on `getSettings().doctor.*` themselves.
+     * Legacy advisory flag for older admin surfaces. New code should derive
+     * repairability from `repair`.
      */
     autoFix?: boolean;
+    /**
+     * Optional explicit repair contract. Diagnostics call only `run()`; repair
+     * flows call `plan()` first, then `apply()` after explicit confirmation.
+     */
+    repair?: HealthRepairHandler;
 }
 export interface HealthCheckDef extends PluginHealthCheckInput {
     runtime: 'plugin';
@@ -306,6 +354,8 @@ export interface PluginContext {
     updateSettings(patch: Record<string, unknown>): void;
     /** Structured activity logging */
     activity: ActivityAPI;
+    /** Plugin-scoped server log. Prefer this over console.* for lifecycle logs. */
+    log?: PluginLogger;
     /** Cross-plugin hook registration */
     hooks: HookAPI;
     /** Adapter-backed search — register content types, index, query */
@@ -328,10 +378,19 @@ export interface PluginTask {
     workflowId?: string;
     scheduleJobId?: string;
     projectId?: string;
+    availableAt?: string;
+    dueAt?: string;
+    source?: PluginTaskSource;
     order?: number;
     createdAt?: string;
     updatedAt?: string;
 }
+export interface PluginTaskSource {
+    pluginId?: string;
+    entityType?: string;
+    entityId?: string;
+    purpose?: string;
+}
 export interface TaskLogEntry {
     timestamp: string;
     author: string;
@@ -349,6 +408,9 @@ export interface PluginTaskCreateInput {
     workflowId?: string;
     projectId?: string;
     parentId?: string | null;
+    availableAt?: string;
+    dueAt?: string;
+    source?: PluginTaskSource;
     skipWorkflowReason?: string;
 }
 export interface PluginTaskUpdateInput {
@@ -364,6 +426,9 @@ export interface PluginTaskUpdateInput {
     scheduleJobId?: string;
     projectId?: string;
     parentId?: string | null;
+    availableAt?: string | null;
+    dueAt?: string | null;
+    source?: PluginTaskSource | null;
 }
 export interface PluginTaskService {
     create(input: PluginTaskCreateInput): Promise<PluginTask>;
@@ -378,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 {
@@ -544,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 {
@@ -667,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 {
@@ -818,6 +941,14 @@ export interface PluginManifestSignature {
     publicKey: string;
     signature: string;
 }
+export interface SecretDeclaration {
+    /** Canonical environment variable name, for example `ANTHROPIC_API_KEY`. */
+    name: string;
+    /** Human-readable setup note. Never include a secret value here. */
+    description: string;
+    /** Missing required secrets should be reported by setup/health checks. Defaults to true. */
+    required: boolean;
+}
 export interface PluginManifest {
     id: string;
     name: string;
@@ -829,7 +960,7 @@ export interface PluginManifest {
         client?: string;
     };
     contentFiles?: string[];
-    secrets?: string[];
+    secrets?: SecretDeclaration[];
     tests?: string;
     dependencies?: string[];
     permissions?: string[];

package/_internal/core/routing/index.d.ts

@@ -2,7 +2,7 @@
  * `@bakin/core/routing` — typed route contracts.
  *
  * Re-exports the route types and authoring helpers used by both the host and
- * plugin authors (via `@bakin/sdk/routing`).
+ * plugin authors (via `@makinbakin/sdk/routing`).
  */
 export type { HttpMethod, HttpStatus, RouteContext, PluginContextLite, CoreContext, JsonBodySpec, MultipartBodySpec, RawBodySpec, NoBodySpec, BodySpec, JsonResponseSpec, NoContentResponseSpec, NonJsonResponseSpec, ResponseSpec, ParsedInput, APIRoute, PluginWithRoutes, } from './types';
 export { defineRoute, defineCoreRoute, definePlugin } from './define';

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

@@ -1,33 +1,69 @@
 /**
- * `@bakin/sdk/components` — shared layout + compound components.
+ * `@makinbakin/sdk/components` — shared layout + compound components.
  *
  * Plugin-author-visible components that wrap shadcn primitives with Bakin-
  * specific behavior (headers, filters, markdown, agent displays, etc.). Does
  * 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, } from '../_internal/app/components/integrated-brainstorm';
+export type { BrainstormMessage, IntegratedBrainstormProps, BrainstormOnSend, SendContext, AssistantTransformed, BrainstormActivityInput, BrainstormActivityStorageInput, BrainstormActivityStorageRecord, BrainstormTimelineActivityInput, BrainstormTimelineMessageInput, } 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';