@makinbakin/sdk 0.0.1-rc.18 → 0.0.1-rc.19

package/_internal/app/components/confirm-dialog.d.ts

@@ -0,0 +1,33 @@
+import type { ReactNode } from 'react';
+export interface ConfirmDialogProps {
+    /** Whether the dialog is shown. Controlled by the caller (e.g. `open={!!target}`). */
+    open: boolean;
+    title: ReactNode;
+    /** Body copy. Rendered inside DialogDescription (a `<p>`) — pass inline content; use `<span className="block">` for secondary lines. */
+    description?: ReactNode;
+    /** Confirm button label (default "Delete"). */
+    confirmLabel?: string;
+    /** Confirm label while busy (default = confirmLabel); a spinner is prepended. */
+    busyLabel?: string;
+    /** Cancel button label (default "Cancel"). */
+    cancelLabel?: string;
+    /** Cancel button variant (default "outline"). */
+    cancelVariant?: 'outline' | 'ghost';
+    /** Disables both buttons and shows a spinner on confirm while the action is in flight. */
+    busy?: boolean;
+    /** Inline error shown above the footer. */
+    error?: string | null;
+    /** Test id forwarded to the confirm button. */
+    confirmTestId?: string;
+    /** DialogContent className override (default width is `sm:max-w-sm`). */
+    className?: string;
+    onConfirm: () => void;
+    onCancel: () => void;
+}
+/**
+ * A controlled confirmation dialog for destructive actions — the consolidation of
+ * six near-identical hand-rolled delete dialogs. The caller owns visibility (`open`)
+ * and the busy/error state of the in-flight action; the dialog never closes itself
+ * while `busy` so an action can't be cancelled mid-flight.
+ */
+export declare function ConfirmDialog({ open, title, description, confirmLabel, busyLabel, cancelLabel, cancelVariant, busy, error, confirmTestId, className, onConfirm, onCancel, }: ConfirmDialogProps): import("react/jsx-runtime").JSX.Element;

package/_internal/app/components/empty-state.d.ts

@@ -1,10 +1,19 @@
-import type { LucideIcon } from 'lucide-react';
+import type { ComponentType, ReactNode } from 'react';
 interface EmptyStateProps {
-    icon?: LucideIcon;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
     title: string;
-    description?: string;
-    action?: React.ReactNode;
+    description?: ReactNode;
+    action?: ReactNode;
     className?: string;
+    /**
+     * Visual size.
+     * - `default` — compact rounded chip + small title (the original SDK look).
+     * - `panel` — larger rounded-2xl chip + semibold title for full-tab empty
+     *   surfaces (folded in from the team plugin's former local variant).
+     */
+    variant?: 'default' | 'panel';
 }
-export declare function EmptyState({ icon: Icon, title, description, action, className }: EmptyStateProps): import("react/jsx-runtime").JSX.Element;
+export declare function EmptyState({ icon: Icon, title, description, action, className, variant }: EmptyStateProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -5,19 +5,12 @@ interface AuditEntry {
     agent: string;
     data: Record<string, unknown>;
 }
-interface ReindexProgressEntry {
-    indexed: number;
-    done: boolean;
-}
 interface ContentStore extends ContentState {
     loading: boolean;
     auditEntries: AuditEntry[];
     activityEvents: ActivityEvent[];
     sseConnected: boolean;
-    taskboardVersion: number;
-    doctorVersion: number;
     debug: boolean;
-    reindexProgress: Record<string, ReindexProgressEntry>;
     setFiles: (files: Record<string, string>) => void;
     updateFile: (key: string, content: string) => void;
     setHeartbeats: (heartbeats: Record<string, Heartbeat>) => void;
@@ -26,12 +19,8 @@ interface ContentStore extends ContentState {
     appendActivityEvent: (event: ActivityEvent) => void;
     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;
-    clearReindexProgress: () => void;
     initialize: () => Promise<void>;
 }
 export declare const useContentStore: import("zustand").UseBoundStore<import("zustand").StoreApi<ContentStore>>;

package/_internal/app/hooks/use-horizontal-resize.d.ts

@@ -0,0 +1,22 @@
+import { type ResizeHandleProps } from './use-resizable-pane';
+interface Options {
+    defaultWidth: number;
+    minWidth: number;
+    maxWidth: number;
+    /** When set, width is persisted in localStorage under `bakin-hresize:${storageKey}`. */
+    storageKey?: string;
+}
+interface Return {
+    width: number;
+    setWidth: (w: number) => void;
+    handleProps: ResizeHandleProps;
+}
+/**
+ * Resize a right-anchored panel by dragging its left edge. The handle lives at
+ * the left of the element; dragging left grows the panel, dragging right
+ * shrinks it. Keyboard: ArrowLeft/ArrowRight (Shift for a larger step). The
+ * companion to {@link useVerticalResize} for side-by-side split panes; both are
+ * thin wrappers over {@link useResizablePane}.
+ */
+export declare function useHorizontalResize({ defaultWidth, minWidth, maxWidth, storageKey }: Options): Return;
+export {};

package/_internal/app/hooks/use-json-fetch.d.ts

@@ -0,0 +1,21 @@
+export interface UseJsonFetchResult<T> {
+    /** Parsed JSON body, or null before the first successful load. */
+    data: T | null;
+    /** True while a request is in flight. */
+    loading: boolean;
+    /** Error message on a non-2xx response or a network/parse failure; null otherwise. */
+    error: string | null;
+    /** Re-run the fetch (e.g. after a mutation). */
+    refresh: () => void;
+}
+/**
+ * Cancellable JSON GET with the standard `{ data, loading, error, refresh }` lifecycle —
+ * the consolidation of the `let cancelled = false` fetch-in-useEffect boilerplate scattered
+ * across plugin components. Aborts the in-flight request on unmount or when `url` changes,
+ * so it never sets state after unmount.
+ *
+ * Pass `url = null` to skip fetching (e.g. until an id is known); `data` resets to null and
+ * `loading` is false while skipped. `opts` is read per-request but does NOT re-trigger on its
+ * own identity — change `url` or call `refresh()` to re-fetch.
+ */
+export declare function useJsonFetch<T>(url: string | null, opts?: RequestInit): UseJsonFetchResult<T>;

package/_internal/app/hooks/use-plugin-event.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Subscribe to server-pushed plugin events over the shell's SINGLE EventSource.
+ *
+ * The shell owns one `/api/events` connection (`use-sse.ts`) with reconnect +
+ * backoff. Plugins used to each open their own `new EventSource('/api/events')`
+ * — N connections, no reconnect. Instead the shell fans every
+ * `{ type: 'plugin-event', event, … }` payload into this process-global emitter,
+ * and components subscribe by event name here. The handler receives the full
+ * payload so it can filter on `assetId`/`taskId`/etc.
+ */
+export type PluginEventPayload = Record<string, unknown> & {
+    event?: string;
+};
+type Handler = (payload: PluginEventPayload) => void;
+/** Called by the shell SSE handler for every `plugin-event` payload. */
+export declare function emitPluginEvent(payload: PluginEventPayload): void;
+/** Run `handler` whenever the server pushes a plugin event named `event`. */
+export declare function usePluginEvent(event: string, handler: Handler): void;
+export {};

package/_internal/app/hooks/use-resizable-pane.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared core for the two split-pane resize hooks. A pane is anchored to the
+ * trailing edge (bottom for 'y', right for 'x') and resized by dragging the
+ * divider on its leading edge — dragging toward that edge (up / left) grows it.
+ * {@link useVerticalResize} and {@link useHorizontalResize} are thin wrappers;
+ * keep all drag / persistence / a11y logic here so it lives in exactly one place.
+ */
+export type ResizeAxis = 'x' | 'y';
+interface CoreOptions {
+    axis: ResizeAxis;
+    defaultSize: number;
+    minSize: number;
+    maxSize: number;
+    /** localStorage key suffix; persisted under `${storagePrefix}${storageKey}`. */
+    storageKey?: string;
+    storagePrefix: string;
+}
+export interface ResizeHandleProps {
+    role: 'separator';
+    tabIndex: 0;
+    'aria-orientation': 'horizontal' | 'vertical';
+    'aria-valuenow': number;
+    'aria-valuemin': number;
+    'aria-valuemax': number;
+    onMouseDown: (e: React.MouseEvent) => void;
+    onTouchStart: (e: React.TouchEvent) => void;
+    onKeyDown: (e: React.KeyboardEvent) => void;
+}
+export interface ResizablePane {
+    size: number;
+    setSize: (n: number) => void;
+    handleProps: ResizeHandleProps;
+}
+export declare function useResizablePane({ axis, defaultSize, minSize, maxSize, storageKey, storagePrefix }: CoreOptions): ResizablePane;
+export {};

package/_internal/app/hooks/use-task-run-history.d.ts

@@ -1,3 +1,11 @@
+/** Task-level terminal outcome (mirrors plugins/tasks TaskOutcome). */
+export interface TaskOutcome {
+    state: 'done' | 'blocked' | 'archived' | 'in_progress';
+    /** Set when state === 'done' and a completion row exists. */
+    completedAt?: string;
+    /** Agent that recorded the completion, when known. */
+    agent?: string;
+}
 /** One dispatch attempt for a task (mirrors plugins/tasks TaskRunEntry). */
 export interface TaskRunEntry {
     runId: string;
@@ -10,8 +18,9 @@ export interface TaskRunEntry {
     settleReason?: string;
     durationMs?: number;
 }
-/** Fetch a task's dispatch run history (newest-first) from the execution ledger. */
+/** Fetch a task's dispatch run history (newest-first) + task outcome from the execution ledger. */
 export declare function useTaskRunHistory(taskId: string | null, limit?: number): {
     runs: TaskRunEntry[];
+    outcome: TaskOutcome | undefined;
     loading: boolean;
 };

package/_internal/app/hooks/use-vertical-resize.d.ts

@@ -1,3 +1,4 @@
+import { type ResizeHandleProps } from './use-resizable-pane';
 interface Options {
     defaultHeight: number;
     minHeight: number;
@@ -5,18 +6,16 @@ interface Options {
     /** When set, height is persisted in localStorage under `bakin-vresize:${storageKey}`. */
     storageKey?: string;
 }
-interface HandleProps {
-    onMouseDown: (e: React.MouseEvent) => void;
-    onTouchStart: (e: React.TouchEvent) => void;
-}
 interface Return {
     height: number;
     setHeight: (h: number) => void;
-    handleProps: HandleProps;
+    handleProps: ResizeHandleProps;
 }
 /**
- * Resize a panel by dragging its top edge. The handle lives at the top of the
- * element; dragging upward grows the panel, dragging downward shrinks it.
+ * Resize a bottom-anchored panel by dragging its top edge. The handle lives at
+ * the top of the element; dragging upward grows the panel, dragging downward
+ * shrinks it. Keyboard: ArrowUp/ArrowDown (Shift for a larger step). Thin
+ * wrapper over {@link useResizablePane}.
  */
 export declare function useVerticalResize({ defaultHeight, minHeight, maxHeight, storageKey }: Options): Return;
 export {};

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

@@ -1,72 +1,8 @@
-export interface TaskLogEntry {
-    timestamp: string;
-    author: string;
-    message: string;
-    data?: Record<string, unknown>;
-}
-export interface Task {
-    id: string;
-    title: string;
-    agent?: string;
-    checked: boolean;
-    date?: string;
-    blockedReason?: string;
-    description?: string;
-    log?: TaskLogEntry[];
-}
-export interface TaskColumns {
-    inProgress: Task[];
-    todo: Task[];
-    done: Task[];
-    blocked: Task[];
-}
-export interface TaskBoard {
-    columns: TaskColumns;
-    timestamp?: string;
-}
-export type ColumnId = keyof TaskColumns;
-export interface CalendarEvent {
-    time?: string;
-    text: string;
-}
-export interface CalendarDay {
-    date: string;
-    label?: string;
-    events: CalendarEvent[];
-}
-export interface RecurringEvent {
-    schedule: string;
-    text: string;
-}
-export interface MemoryEntry {
-    type: 'decision' | 'learned' | 'note';
-    text: string;
-}
-export interface MemoryDay {
-    date: string;
-    entries: MemoryEntry[];
-}
 export interface Heartbeat {
     status: 'working' | 'idle' | 'down';
     currentTask?: string;
     timestamp: string;
 }
-export interface ProjectMeta {
-    filename: string;
-    title: string;
-    status?: string;
-    content: string;
-}
-export interface OfficeData {
-    asciiMap: string;
-    statusTable: {
-        agent: string;
-        status: string;
-        task: string;
-        heartbeat: string;
-    }[];
-    history: string[];
-}
 export interface ActivityEvent {
     id: string;
     ts: string;

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

@@ -58,11 +58,34 @@ export interface MessageArgs extends RuntimeMessageToolPolicy {
      * same agentId + threadId pair to the same provider/runtime session.
      */
     threadId?: string;
+    /**
+     * Per-turn model override (`provider/model` id). Omit to use the agent's
+     * configured model. The caller (Bakin's routing policy) resolves it.
+     */
+    model?: string;
+    /**
+     * Per-turn thinking level. Omit to use the runtime/agent default.
+     */
+    thinking?: string;
     metadata?: RuntimeMetadata;
 }
+/** Token usage for one agent turn, when the runtime reports it. */
+export interface MessageUsage {
+    input?: number;
+    output?: number;
+    total?: number;
+    /** Cached-input tokens read (priced far below fresh input when known). */
+    cacheRead?: number;
+    /** Cached-input tokens written (cache creation). */
+    cacheWrite?: number;
+    /** Resolved model the runtime ran, when known. */
+    model?: string;
+}
 export interface MessageResult {
     id: string;
     content?: string;
+    /** Per-turn token usage, omitted when the runtime reported none. */
+    usage?: MessageUsage;
     metadata?: RuntimeMetadata;
 }
 export interface RuntimeToolActivity {
@@ -229,6 +252,19 @@ export interface RuntimeSession {
     updatedAt?: string;
     metadata?: RuntimeMetadata;
 }
+export interface RuntimeSessionStoreStats {
+    agentId: string;
+    /** Live entries in the runtime's session store for this agent. */
+    storeEntries: number;
+    /**
+     * Top-level files in the agent's sessions directory (session artifacts,
+     * including the store itself) — cache subtrees are excluded so the
+     * orphaned-artifact ratio stays meaningful.
+     */
+    fileCount: number;
+    /** Total bytes of the agent's sessions directory, subtrees included. */
+    diskBytes: number;
+}
 export interface RuntimeMemoryTier {
     id: string;
     label: string;
@@ -338,6 +374,13 @@ export interface RuntimeImageGenerateInput {
     resolution?: string;
     outputFormat?: RuntimeImageOutputFormat;
     background?: RuntimeImageBackground;
+    /**
+     * Reference/context image file paths conditioning the generation. The caller
+     * (Bakin) resolves managed asset ids to concrete paths before the adapter
+     * sees them. Native generation has no file input, so a generate carrying
+     * references is routed through the edit-style invocation (#418).
+     */
+    referenceImages?: string[];
     timeoutMs?: number;
     metadata?: RuntimeMetadata;
 }
@@ -456,6 +499,12 @@ export interface AgentRuntimeAdapter {
     sessions: {
         list(agentId?: string): Promise<RuntimeSession[]>;
         get(sessionId: string): Promise<RuntimeSession | null>;
+        /**
+         * Per-agent session-store disk stats. Optional: runtimes without a
+         * file-backed session store omit it, and callers must treat absence
+         * as "stats unavailable" — skip, never error.
+         */
+        storeStats?(): Promise<RuntimeSessionStoreStats[]>;
     };
     memory: {
         listTiers(): Promise<RuntimeMemoryTier[]>;
@@ -486,6 +535,16 @@ export interface AgentRuntimeAdapter {
         }): Promise<RuntimeAvailableModel[]>;
     };
     images?: RuntimeImagesAccess;
+    /**
+     * Access to the runtime's private media store (e.g. channel attachments).
+     * `resolveUri` maps a runtime-private URI (OpenClaw's `media://…`) to an
+     * absolute local file path; null for unknown schemes or missing files —
+     * never throws for not-found. Optional: runtimes without a media store
+     * omit it, and callers must treat absence as "cannot resolve".
+     */
+    media?: {
+        resolveUri(uri: string): Promise<string | null>;
+    };
     cron: {
         list(): Promise<CronJob[]>;
         get(id: string): Promise<CronJob | null>;

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

@@ -4,4 +4,4 @@ export { hasChannelCapability } from './capabilities';
 export { RuntimeError, RuntimeTurnError } from './errors';
 export type { RuntimeErrorKind, RuntimeErrorOptions, RuntimeProviderInfo, RuntimeTurnDiagnosis, RuntimeTurnFailureReason, } from './errors';
 export { getRuntimeMainAgent, getRuntimeMainAgentId, getRuntimeMainAgentName, selectRuntimeMainAgent, } from './helpers';
-export type { AgentRuntimeAdapter, ApprovalDelivery, ApprovalOption, ApprovalPatch, ApprovalRenderRef, ApprovalRenderResult, ApprovalResolveEvent, ApprovalResponse, CancelApprovalArgs, ChannelInfo, ChannelMessageArgs, ChatChunk, ContentDeliveryArgs, CreateApprovalArgs, CreateCronJobInput, CreateRuntimeAgentInput, CronJob, CronRun, DeliveryResult, DurableApprovalRecord, EditApprovalArgs, 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, ToolResult, UpdateCronJobInput, UpdateRuntimeAgentInput, WorkspaceFile, } from './concepts';
+export type { AgentRuntimeAdapter, ApprovalDelivery, ApprovalOption, ApprovalPatch, ApprovalRenderRef, ApprovalRenderResult, ApprovalResolveEvent, ApprovalResponse, CancelApprovalArgs, ChannelInfo, ChannelMessageArgs, ChatChunk, ContentDeliveryArgs, CreateApprovalArgs, CreateCronJobInput, CreateRuntimeAgentInput, CronJob, CronRun, DeliveryResult, DurableApprovalRecord, EditApprovalArgs, MessageArgs, MessageResult, MessageUsage, 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, RuntimeSessionStoreStats, RuntimeSkill, ToolResult, UpdateCronJobInput, UpdateRuntimeAgentInput, WorkspaceFile, } from './concepts';

package/_internal/core/format.d.ts

@@ -1,5 +1,14 @@
 /** Human-readable relative time from an ISO timestamp */
 export declare function formatAge(timestamp: string): string;
+/**
+ * Human-readable absolute date+time with calendar awareness:
+ * "Today 3:45 PM" / "Yesterday 9:02 AM" / "Jan 5 3:45 PM", carrying the year
+ * only for prior-year timestamps (a bare "Jan 5" is ambiguous once runs and
+ * completions outlive the calendar). Falls back to the raw input if unparseable.
+ */
+export declare function formatDateTime(timestamp: string): string;
+/** Human-readable elapsed duration from a millisecond count ("850ms" / "42s" / "3m 5s"); null when undefined. */
+export declare function formatDuration(ms?: number): string | null;
 /** Human-readable file size */
 export declare function formatSize(bytes: number): string;
 /** Check if a heartbeat timestamp is stale (> 15 min) */