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

package/README.md

@@ -9,6 +9,12 @@ runtime React + `@makinbakin/sdk/*` are externalized and resolved through
 the host's import map — so plugins don't ship a second copy of any of
 them.
 
+Full SDK docs:
+
+- [SDK overview](https://makinbakin.com/docs/extending/sdk/overview/)
+- [SDK reference](https://makinbakin.com/docs/reference/generated/sdk/)
+- [Build a plugin](https://makinbakin.com/docs/extending/plugins/build/)
+
 ## Install
 
 ```sh
@@ -26,7 +32,7 @@ the actual instances at runtime.
 bakin plugins scaffold my-plugin
 cd my-plugin
 bun install
-bakin plugins install .
+bakin plugins install --dev .
 ```
 
 ## Minimal client entry
@@ -80,21 +86,26 @@ 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
 
-The `exports` map covers these sub-paths:
+The public npm package exposes these sub-paths:
 
 | Import path              | What it exposes                              |
 | ------------------------ | -------------------------------------------- |
-| `@makinbakin/sdk`             | `registerPlugin`, top-level re-exports       |
-| `@makinbakin/sdk/ui`          | Base UI components (buttons, cards, inputs)  |
-| `@makinbakin/sdk/hooks`       | Shared React hooks (useQueryState, useDebug) |
-| `@makinbakin/sdk/components`  | Higher-level shell components                |
-| `@makinbakin/sdk/slots`       | Slot runtime + provider                      |
-| `@makinbakin/sdk/types`       | TypeScript types (`BakinPlugin`, `PluginContext`, etc.) |
-| `@makinbakin/sdk/utils`       | Shared utilities                             |
+| `@makinbakin/sdk` | Plugin registration, route helpers, top-level exports |
+| `@makinbakin/sdk/ui` | Base UI components |
+| `@makinbakin/sdk/hooks` | Shared React hooks |
+| `@makinbakin/sdk/components` | Higher-level shell components |
+| `@makinbakin/sdk/slots` | Slot runtime and provider |
+| `@makinbakin/sdk/types` | TypeScript contract types |
+| `@makinbakin/sdk/utils` | Shared utilities |
+| `@makinbakin/sdk/metadata` | Docs-aware contract metadata helpers |
+| `@makinbakin/sdk/routing` | Typed declarative route helpers |
+
+Use `@makinbakin/sdk/*` imports for external plugin code.
 
 ## Repository
 
@@ -104,4 +115,4 @@ This package is developed alongside Bakin in the
 
 ## License
 
-MIT © markhayden
+Apache-2.0

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/integrated-brainstorm/activity.d.ts

@@ -0,0 +1,23 @@
+import type { RuntimeChatChunk } from '@makinbakin/sdk/types';
+import type { BrainstormMessage } from './types';
+export interface BrainstormActivityInput {
+    kind: string;
+    content: string;
+    data?: unknown;
+}
+export interface BrainstormTimelineMessageInput {
+    id: string;
+    role: 'user' | 'assistant' | 'agent';
+    content: string;
+    timestamp?: string;
+}
+export interface BrainstormTimelineActivityInput extends BrainstormActivityInput {
+    id: string;
+    timestamp?: string;
+}
+export declare function runtimeChunkToBrainstormActivity(chunk: RuntimeChatChunk): BrainstormActivityInput | null;
+export declare function brainstormActivityMessageFromCustom(name: string, data: unknown): BrainstormMessage | null;
+export declare function toBrainstormTimeline(agentId: string, input: {
+    messages: BrainstormTimelineMessageInput[];
+    activities?: BrainstormTimelineActivityInput[];
+}): BrainstormMessage[];

package/_internal/app/components/integrated-brainstorm/index.d.ts

@@ -1,3 +1,8 @@
 import type { IntegratedBrainstormProps } from './types';
 export type { BrainstormMessage, IntegratedBrainstormProps, BrainstormOnSend, SendContext, AssistantTransformed, } from './types';
-export declare function IntegratedBrainstorm({ messages, onMessagesChange, onSend, agentId, onAgentChange, label, icon, placeholder, emptyState, collapsible, defaultOpen, conversationStartHeight, minHeight, maxHeight, maxInputHeight, storageKey, fitParent, showHeader, readOnly, readOnlyNotice, transformAssistantMessage, }: IntegratedBrainstormProps): import("react/jsx-runtime").JSX.Element;
+export { brainstormActivityMessageFromCustom, runtimeChunkToBrainstormActivity, toBrainstormTimeline, } from './activity';
+export { brainstormThreadId, normalizeBrainstormActivityForStorage, normalizeBrainstormActivityMessageForStorage, } from './session';
+export type { BrainstormActivityInput, BrainstormTimelineActivityInput, BrainstormTimelineMessageInput, } from './activity';
+export type { BrainstormActivityStorageInput, BrainstormActivityStorageRecord, } from './session';
+export { readBrainstormSseResponse } from './sse';
+export declare function IntegratedBrainstorm({ messages, onMessagesChange, onSend, agentId, onAgentChange, label, icon, placeholder, emptyState, collapsible, defaultOpen, defaultHeight, minHeight, maxHeight, maxInputHeight, storageKey, fitParent, showHeader, readOnly, readOnlyNotice, transformAssistantMessage, }: IntegratedBrainstormProps): import("react/jsx-runtime").JSX.Element;

package/_internal/app/components/integrated-brainstorm/session.d.ts

@@ -0,0 +1,16 @@
+import type { BrainstormMessage } from './types';
+export interface BrainstormActivityStorageInput {
+    id?: string;
+    kind?: string;
+    content?: string;
+    data?: unknown;
+    timestamp?: string;
+}
+export interface BrainstormActivityStorageRecord {
+    kind: string;
+    content: string;
+    data?: unknown;
+}
+export declare function brainstormThreadId(scope: string, entityId: string, agentId: string): string;
+export declare function normalizeBrainstormActivityForStorage(activity: BrainstormActivityStorageInput): BrainstormActivityStorageRecord | null;
+export declare function normalizeBrainstormActivityMessageForStorage(activity: BrainstormActivityStorageInput): Pick<BrainstormMessage, 'role' | 'kind' | 'content' | 'data'> | null;

package/_internal/app/components/integrated-brainstorm/sse.d.ts

@@ -0,0 +1,8 @@
+import type { SendContext } from './types';
+interface BrainstormSseReadOptions {
+    onCustomEvent?: (event: string, data: unknown) => boolean | void;
+}
+export declare function readBrainstormSseResponse(response: Response, ctx: SendContext, options?: BrainstormSseReadOptions): Promise<{
+    content: string;
+}>;
+export {};

package/_internal/app/components/integrated-brainstorm/types.d.ts

@@ -2,9 +2,11 @@ import type { LucideIcon } from 'lucide-react';
 import type { ReactNode } from 'react';
 export interface BrainstormMessage {
     id: string;
-    role: 'user' | 'assistant';
+    role: 'user' | 'assistant' | 'activity';
     content: string;
     agentId?: string;
+    kind?: 'runtime_status' | 'tool_call' | 'error' | string;
+    data?: unknown;
     timestamp?: string;
 }
 export interface SendContext {
@@ -38,16 +40,16 @@ export interface IntegratedBrainstormProps {
     position?: 'bottom';
     collapsible?: boolean;
     defaultOpen?: boolean;
-    conversationStartHeight?: number;
+    defaultHeight?: number;
     minHeight?: number;
     maxHeight?: number;
     maxInputHeight?: number;
     storageKey?: string;
     /**
      * Fill parent height via flex-1/h-full instead of a fixed pixel height.
-     * Drops the drag handle (nothing to drag against) and disables auto-expand
-     * (already full-size). Use when the panel IS the pane — e.g. a dedicated
-     * chat route — rather than a bottom sheet above other content.
+     * Drops the drag handle because there is nothing fixed to drag against. Use
+     * when the panel IS the pane — e.g. a dedicated chat route — rather than a
+     * bottom sheet above other content.
      */
     fitParent?: boolean;
     /**

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

@@ -1,7 +1,7 @@
 import { useRender } from "@base-ui/react/use-render";
 import { type VariantProps } from "class-variance-authority";
 declare const badgeVariants: (props?: ({
-    variant?: "link" | "destructive" | "default" | "outline" | "secondary" | "ghost" | null | undefined;
+    variant?: "destructive" | "link" | "default" | "outline" | "secondary" | "ghost" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare function Badge({ className, variant, render, ...props }: useRender.ComponentProps<"span"> & VariantProps<typeof badgeVariants>): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
 export { Badge, badgeVariants };

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?: "link" | "destructive" | "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

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

@@ -38,9 +38,25 @@ 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;
+    /**
+     * Adapter-neutral durable conversation key. Runtime adapters should map the
+     * same agentId + threadId pair to the same provider/runtime session.
+     */
     threadId?: string;
     metadata?: RuntimeMetadata;
 }
@@ -49,10 +65,22 @@ export interface MessageResult {
     content?: string;
     metadata?: RuntimeMetadata;
 }
+export interface RuntimeToolActivity {
+    phase: 'call' | 'result';
+    callId?: string;
+    toolName: string;
+    status?: 'running' | 'completed' | 'failed' | string;
+    summary?: string;
+    inputPreview?: string;
+    outputPreview?: string;
+    durationMs?: number;
+    exitCode?: number;
+    metadata?: RuntimeMetadata;
+}
 export interface ChatChunk {
     type: 'text' | 'tool' | 'status' | 'done' | 'error';
     content?: string;
-    data?: unknown;
+    data?: RuntimeMetadata | RuntimeToolActivity;
 }
 export interface ToolDefinition {
     name: string;
@@ -280,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;
@@ -436,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, 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/constants.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Core branding and identity constants for Bakin.
+ *
+ * Change these values to rebrand the entire application.
+ * Every file that needs the app name, slug, or paths imports from here.
+ */
+export declare const APP_NAME = "Bakin";
+export declare const APP_SLUG = "bakin";
+export { APP_VERSION } from './generated-version';
+export declare const APP_HOME_DEFAULT = "~/.bakin";
+export declare const CONFIG_FILE = "bakin.config.ts";
+export declare const PLUGIN_MANIFEST_FILE = "bakin-plugin.json";
+export declare const MAIN_AGENT_ROLE = "orchestrator";
+export declare const DEFAULT_PORT = 3737;
+export declare const ENV_PREFIX = "BAKIN";

package/_internal/core/content-dir.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Resolve the content directory path.
+ */
+export declare function getContentDir(): string;
+/**
+ * Whether the content dir is inside the supported Bakin home contract.
+ */
+export declare function isUsingBakinHome(): boolean;
+/**
+ * Reset the resolved content dir (for testing).
+ */
+export declare function resetContentDir(): void;
+/**
+ * Well-known content paths. Agents and CLI use these instead of constructing paths.
+ */
+export interface BakinPaths {
+    home: string;
+    memoryLog: string;
+    audit: string;
+    assets: string;
+    'assets.store': string;
+    'assets.inbox': string;
+    'assets.trash': string;
+    agents: string;
+    personas: string;
+    team: string;
+    heartbeats: string;
+    inbox: string;
+    tasks: string;
+    workflows: string;
+    settings: string;
+    logs: string;
+}
+export declare function getBakinPaths(): BakinPaths;
+/**
+ * Initialize the ~/.bakin/ directory structure.
+ * Called by `bakin mkdir` CLI command or on first run.
+ */
+export declare function initBakinHome(targetDir?: string): {
+    created: string[];
+    seeded: string[];
+};

package/_internal/core/generated-version.d.ts

@@ -0,0 +1 @@
+export declare const APP_VERSION = "0.0.0-dev";

package/_internal/core/logger.d.ts

@@ -0,0 +1,8 @@
+declare function createLogger(module: string): {
+    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 type Logger = ReturnType<typeof createLogger>;
+export { createLogger };