@leanspec/ui 0.2.23 → 0.2.24

package/dist/lib/lib/api.d.ts

@@ -0,0 +1,135 @@
+import { APIError, BackendAdapter } from './backend-adapter';
+import { ListParams, Spec, SpecDetail, Stats, DependencyGraph, MachinesResponse, Session, SessionLog, SessionMode, RunnerDefinition, RunnerListResponse, RunnerScope, RunnerValidateResponse } from '../types/api';
+import { ChatConfig } from '../types/chat-config';
+import { ModelsRegistryResponse } from '../types/models-registry';
+import { ChatStorageInfo } from './backend-adapter/core';
+/**
+ * Project-aware API wrapper
+ * Automatically injects currentProjectId from context into backend adapter calls
+ */
+declare class ProjectAPI {
+    private backend;
+    private _currentProjectId;
+    constructor();
+    setCurrentProjectId(projectId: string | null): void;
+    setCurrentMachineId(machineId: string | null): void;
+    getCurrentProjectId(): string;
+    getMachines: () => Promise<MachinesResponse>;
+    renameMachine: (machineId: string, label: string) => Promise<void>;
+    revokeMachine: (machineId: string) => Promise<void>;
+    requestExecution: (machineId: string, payload: Record<string, unknown>) => Promise<void>;
+    getProjects: () => Promise<import('./backend-adapter').ProjectsResponse>;
+    createProject: (path: string, options?: {
+        favorite?: boolean;
+        color?: string;
+        name?: string;
+        description?: string | null;
+    }) => Promise<import('./backend-adapter').Project>;
+    updateProject: (projectId: string, updates: Parameters<BackendAdapter["updateProject"]>[1]) => Promise<import('./backend-adapter').Project | undefined>;
+    deleteProject: (projectId: string) => Promise<void>;
+    validateProject: (projectId: string) => Promise<import('./backend-adapter').ProjectValidationResponse>;
+    listDirectory: (path?: string) => Promise<import('./backend-adapter').DirectoryListResponse>;
+    getContextFiles: () => Promise<import('./backend-adapter').ContextFileListItem[]>;
+    getContextFile: (path: string) => Promise<import('./backend-adapter').ContextFileContent>;
+    getProjectContext(): Promise<import('../types/api').ProjectContext>;
+    getSpecs(params?: ListParams): Promise<Spec[]>;
+    /**
+     * Get specs with optional pre-built hierarchy tree for performance.
+     * Use hierarchy: true to get server-side computed tree structure.
+     */
+    getSpecsWithHierarchy(params?: ListParams): Promise<import('../types/api').ListSpecsResponse>;
+    getSpec(specName: string): Promise<SpecDetail>;
+    updateSpec(specName: string, updates: Partial<Pick<Spec, 'status' | 'priority' | 'tags'>> & {
+        expectedContentHash?: string;
+        parent?: string | null;
+        addDependsOn?: string[];
+        removeDependsOn?: string[];
+        force?: boolean;
+    }): Promise<void>;
+    toggleSpecChecklist(specName: string, toggles: {
+        itemText: string;
+        checked: boolean;
+    }[], options?: {
+        expectedContentHash?: string;
+        subspec?: string;
+    }): Promise<{
+        success: boolean;
+        contentHash: string;
+        toggled: {
+            itemText: string;
+            checked: boolean;
+            line: number;
+        }[];
+    }>;
+    getStats(): Promise<Stats>;
+    getProjectStats(projectId: string): Promise<Stats>;
+    getDependencies(specName?: string): Promise<DependencyGraph>;
+    listSessions(params?: {
+        specId?: string;
+        status?: string;
+        runner?: string;
+    }): Promise<Session[]>;
+    getSession(sessionId: string): Promise<Session>;
+    createSession(payload: {
+        projectPath: string;
+        specId?: string | null;
+        runner?: string;
+        mode: SessionMode;
+    }): Promise<Session>;
+    startSession(sessionId: string): Promise<Session>;
+    pauseSession(sessionId: string): Promise<Session>;
+    resumeSession(sessionId: string): Promise<Session>;
+    stopSession(sessionId: string): Promise<Session>;
+    archiveSession(sessionId: string, options?: {
+        compress?: boolean;
+    }): Promise<import('./backend-adapter').SessionArchiveResult>;
+    deleteSession(sessionId: string): Promise<void>;
+    getSessionLogs(sessionId: string): Promise<SessionLog[]>;
+    getSessionEvents(sessionId: string): Promise<import('./backend-adapter').SessionEvent[]>;
+    listAvailableRunners(projectPath?: string): Promise<string[]>;
+    listRunners(projectPath?: string, options?: {
+        skipValidation?: boolean;
+    }): Promise<RunnerListResponse>;
+    getRunner(runnerId: string, projectPath?: string): Promise<RunnerDefinition>;
+    createRunner(payload: {
+        projectPath: string;
+        runner: {
+            id: string;
+            name?: string | null;
+            command?: string | null;
+            args?: string[];
+            env?: Record<string, string>;
+        };
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    updateRunner(runnerId: string, payload: {
+        projectPath: string;
+        runner: {
+            name?: string | null;
+            command?: string | null;
+            args?: string[];
+            env?: Record<string, string>;
+        };
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    deleteRunner(runnerId: string, payload: {
+        projectPath: string;
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    validateRunner(runnerId: string, projectPath?: string): Promise<RunnerValidateResponse>;
+    setDefaultRunner(payload: {
+        projectPath: string;
+        runnerId: string;
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    getChatConfig: () => Promise<ChatConfig>;
+    updateChatConfig: (config: ChatConfig) => Promise<ChatConfig>;
+    getChatStorageInfo: () => Promise<ChatStorageInfo>;
+    getModelsProviders: (options?: {
+        agenticOnly?: boolean;
+    }) => Promise<ModelsRegistryResponse>;
+    refreshModelsRegistry: () => Promise<void>;
+    setProviderApiKey: (providerId: string, apiKey: string, baseUrl?: string) => Promise<void>;
+}
+export declare const api: ProjectAPI;
+export { APIError };

package/dist/lib/lib/backend-adapter/core.d.ts

@@ -0,0 +1,135 @@
+import { BatchMetadataResponse, ContextFileContent, ContextFileListItem, DependencyGraph, DirectoryListResponse, ListParams, Spec, SpecDetail, Stats, Project, ProjectStatsResponse, ProjectValidationResponse, ProjectsResponse, ListSpecsResponse, ProjectContext, MachinesResponse, Session, SessionArchiveResult, SessionEvent, SessionLog, SessionMode, SpecTokenResponse, SpecValidationResponse, RunnerDefinition, RunnerListResponse, RunnerScope, RunnerValidateResponse } from '../../types/api';
+import { ChatConfig } from '../../types/chat-config';
+import { ModelsRegistryResponse } from '../../types/models-registry';
+export interface ChatStorageInfo {
+    path: string;
+    sizeBytes: number;
+}
+export declare class APIError extends Error {
+    status: number;
+    constructor(status: number, message: string);
+}
+/**
+ * Backend adapter interface - abstracts the communication layer
+ * Web uses HTTP fetch, Desktop uses Tauri invoke
+ */
+export interface BackendAdapter {
+    setMachineId(machineId: string | null): void;
+    getMachines(): Promise<MachinesResponse>;
+    renameMachine(machineId: string, label: string): Promise<void>;
+    revokeMachine(machineId: string): Promise<void>;
+    requestExecution(machineId: string, payload: Record<string, unknown>): Promise<void>;
+    getProjects(): Promise<ProjectsResponse>;
+    createProject(path: string, options?: {
+        favorite?: boolean;
+        color?: string;
+        name?: string;
+        description?: string | null;
+    }): Promise<Project>;
+    updateProject(projectId: string, updates: Partial<Pick<Project, 'name' | 'color' | 'favorite' | 'description'>>): Promise<Project | undefined>;
+    deleteProject(projectId: string): Promise<void>;
+    validateProject(projectId: string): Promise<ProjectValidationResponse>;
+    getSpecs(projectId: string, params?: ListParams): Promise<Spec[]>;
+    /** Get specs with optional pre-built hierarchy tree for performance */
+    getSpecsWithHierarchy(projectId: string, params?: ListParams): Promise<ListSpecsResponse>;
+    getSpec(projectId: string, specName: string): Promise<SpecDetail>;
+    getSpecTokens(projectId: string, specName: string): Promise<SpecTokenResponse>;
+    getSpecValidation(projectId: string, specName: string): Promise<SpecValidationResponse>;
+    getBatchMetadata(projectId: string, specNames: string[]): Promise<BatchMetadataResponse>;
+    updateSpec(projectId: string, specName: string, updates: Partial<Pick<Spec, 'status' | 'priority' | 'tags'>> & {
+        expectedContentHash?: string;
+        parent?: string | null;
+        addDependsOn?: string[];
+        removeDependsOn?: string[];
+        force?: boolean;
+    }): Promise<void>;
+    toggleSpecChecklist(projectId: string, specName: string, toggles: {
+        itemText: string;
+        checked: boolean;
+    }[], options?: {
+        expectedContentHash?: string;
+        subspec?: string;
+    }): Promise<{
+        success: boolean;
+        contentHash: string;
+        toggled: {
+            itemText: string;
+            checked: boolean;
+            line: number;
+        }[];
+    }>;
+    getStats(projectId: string): Promise<Stats>;
+    getProjectStats(projectId: string): Promise<Stats>;
+    getDependencies(projectId: string, specName?: string): Promise<DependencyGraph>;
+    getContextFiles(): Promise<ContextFileListItem[]>;
+    getContextFile(path: string): Promise<ContextFileContent>;
+    getProjectContext(projectId: string): Promise<ProjectContext>;
+    listDirectory(path?: string): Promise<DirectoryListResponse>;
+    listSessions(params?: {
+        specId?: string;
+        status?: string;
+        runner?: string;
+    }): Promise<Session[]>;
+    getSession(sessionId: string): Promise<Session>;
+    createSession(payload: {
+        projectPath: string;
+        specId?: string | null;
+        runner?: string;
+        mode: SessionMode;
+    }): Promise<Session>;
+    startSession(sessionId: string): Promise<Session>;
+    pauseSession(sessionId: string): Promise<Session>;
+    resumeSession(sessionId: string): Promise<Session>;
+    stopSession(sessionId: string): Promise<Session>;
+    archiveSession(sessionId: string, options?: {
+        compress?: boolean;
+    }): Promise<SessionArchiveResult>;
+    deleteSession(sessionId: string): Promise<void>;
+    getSessionLogs(sessionId: string): Promise<SessionLog[]>;
+    getSessionEvents(sessionId: string): Promise<SessionEvent[]>;
+    listAvailableRunners(projectPath?: string): Promise<string[]>;
+    listRunners(projectPath?: string, options?: {
+        skipValidation?: boolean;
+    }): Promise<RunnerListResponse>;
+    getRunner(runnerId: string, projectPath?: string): Promise<RunnerDefinition>;
+    createRunner(payload: {
+        projectPath: string;
+        runner: {
+            id: string;
+            name?: string | null;
+            command?: string | null;
+            args?: string[];
+            env?: Record<string, string>;
+        };
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    updateRunner(runnerId: string, payload: {
+        projectPath: string;
+        runner: {
+            name?: string | null;
+            command?: string | null;
+            args?: string[];
+            env?: Record<string, string>;
+        };
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    deleteRunner(runnerId: string, payload: {
+        projectPath: string;
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    validateRunner(runnerId: string, projectPath?: string): Promise<RunnerValidateResponse>;
+    setDefaultRunner(payload: {
+        projectPath: string;
+        runnerId: string;
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    getChatConfig(): Promise<ChatConfig>;
+    updateChatConfig(config: ChatConfig): Promise<ChatConfig>;
+    getChatStorageInfo(): Promise<ChatStorageInfo>;
+    getModelsProviders(options?: {
+        agenticOnly?: boolean;
+    }): Promise<ModelsRegistryResponse>;
+    refreshModelsRegistry(): Promise<void>;
+    setProviderApiKey(providerId: string, apiKey: string, baseUrl?: string): Promise<void>;
+}
+export type { BatchMetadataResponse, ContextFileContent, ContextFileListItem, DependencyGraph, DirectoryListResponse, ListParams, Spec, SpecDetail, Stats, Project, ProjectStatsResponse, ProjectValidationResponse, ProjectsResponse, ListSpecsResponse, ProjectContext, MachinesResponse, Session, SessionArchiveResult, SessionEvent, SessionLog, SessionMode, SpecTokenResponse, SpecValidationResponse, RunnerDefinition, RunnerListResponse, RunnerScope, RunnerValidateResponse, ChatConfig, ModelsRegistryResponse, };

package/dist/lib/lib/backend-adapter/http.d.ts

@@ -0,0 +1,126 @@
+import { BackendAdapter, BatchMetadataResponse, ChatStorageInfo, ContextFileContent, ContextFileListItem, DependencyGraph, DirectoryListResponse, ListParams, Spec, SpecDetail, Stats, Project, ProjectValidationResponse, ProjectsResponse, ListSpecsResponse, ProjectContext, MachinesResponse, Session, SessionArchiveResult, SessionEvent, SessionLog, SessionMode, SpecTokenResponse, SpecValidationResponse, RunnerDefinition, RunnerListResponse, RunnerScope, RunnerValidateResponse, ChatConfig, ModelsRegistryResponse } from './core';
+/**
+ * HTTP adapter for web browser - connects to Rust HTTP server
+ */
+export declare class HttpBackendAdapter implements BackendAdapter {
+    private baseUrl;
+    private machineId;
+    constructor(baseUrl?: string);
+    setMachineId(machineId: string | null): void;
+    private fetchAPI;
+    getProjects(): Promise<ProjectsResponse>;
+    getMachines(): Promise<MachinesResponse>;
+    renameMachine(machineId: string, label: string): Promise<void>;
+    revokeMachine(machineId: string): Promise<void>;
+    requestExecution(machineId: string, payload: Record<string, unknown>): Promise<void>;
+    createProject(path: string, options?: {
+        favorite?: boolean;
+        color?: string;
+        name?: string;
+        description?: string | null;
+    }): Promise<Project>;
+    updateProject(projectId: string, updates: Partial<Pick<Project, 'name' | 'color' | 'favorite' | 'description'>>): Promise<Project | undefined>;
+    deleteProject(projectId: string): Promise<void>;
+    validateProject(projectId: string): Promise<ProjectValidationResponse>;
+    getSpecs(projectId: string, params?: ListParams): Promise<Spec[]>;
+    getSpecsWithHierarchy(projectId: string, params?: ListParams): Promise<ListSpecsResponse>;
+    getSpec(projectId: string, specName: string): Promise<SpecDetail>;
+    getSpecTokens(projectId: string, specName: string): Promise<SpecTokenResponse>;
+    getSpecValidation(projectId: string, specName: string): Promise<SpecValidationResponse>;
+    getBatchMetadata(projectId: string, specNames: string[]): Promise<BatchMetadataResponse>;
+    updateSpec(projectId: string, specName: string, updates: Partial<Pick<Spec, 'status' | 'priority' | 'tags'>> & {
+        expectedContentHash?: string;
+        parent?: string | null;
+        addDependsOn?: string[];
+        removeDependsOn?: string[];
+        force?: boolean;
+    }): Promise<void>;
+    toggleSpecChecklist(projectId: string, specName: string, toggles: {
+        itemText: string;
+        checked: boolean;
+    }[], options?: {
+        expectedContentHash?: string;
+        subspec?: string;
+    }): Promise<{
+        success: boolean;
+        contentHash: string;
+        toggled: {
+            itemText: string;
+            checked: boolean;
+            line: number;
+        }[];
+    }>;
+    getStats(projectId: string): Promise<Stats>;
+    getProjectStats(projectId: string): Promise<Stats>;
+    getDependencies(projectId: string, specName?: string): Promise<DependencyGraph>;
+    getContextFiles(): Promise<ContextFileListItem[]>;
+    getContextFile(path: string): Promise<ContextFileContent>;
+    getProjectContext(projectId: string): Promise<ProjectContext>;
+    listDirectory(path?: string): Promise<DirectoryListResponse>;
+    listSessions(params?: {
+        specId?: string;
+        status?: string;
+        runner?: string;
+    }): Promise<Session[]>;
+    getSession(sessionId: string): Promise<Session>;
+    createSession(payload: {
+        projectPath: string;
+        specId?: string | null;
+        runner?: string;
+        mode: SessionMode;
+    }): Promise<Session>;
+    startSession(sessionId: string): Promise<Session>;
+    pauseSession(sessionId: string): Promise<Session>;
+    resumeSession(sessionId: string): Promise<Session>;
+    stopSession(sessionId: string): Promise<Session>;
+    archiveSession(sessionId: string, options?: {
+        compress?: boolean;
+    }): Promise<SessionArchiveResult>;
+    deleteSession(sessionId: string): Promise<void>;
+    getSessionLogs(sessionId: string): Promise<SessionLog[]>;
+    getSessionEvents(sessionId: string): Promise<SessionEvent[]>;
+    listAvailableRunners(projectPath?: string): Promise<string[]>;
+    listRunners(projectPath?: string, options?: {
+        skipValidation?: boolean;
+    }): Promise<RunnerListResponse>;
+    getRunner(runnerId: string, projectPath?: string): Promise<RunnerDefinition>;
+    createRunner(payload: {
+        projectPath: string;
+        runner: {
+            id: string;
+            name?: string | null;
+            command?: string | null;
+            args?: string[];
+            env?: Record<string, string>;
+        };
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    updateRunner(runnerId: string, payload: {
+        projectPath: string;
+        runner: {
+            name?: string | null;
+            command?: string | null;
+            args?: string[];
+            env?: Record<string, string>;
+        };
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    deleteRunner(runnerId: string, payload: {
+        projectPath: string;
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    validateRunner(runnerId: string, projectPath?: string): Promise<RunnerValidateResponse>;
+    setDefaultRunner(payload: {
+        projectPath: string;
+        runnerId: string;
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    getChatConfig(): Promise<ChatConfig>;
+    updateChatConfig(config: ChatConfig): Promise<ChatConfig>;
+    getChatStorageInfo(): Promise<ChatStorageInfo>;
+    getModelsProviders(options?: {
+        agenticOnly?: boolean;
+    }): Promise<ModelsRegistryResponse>;
+    refreshModelsRegistry(): Promise<void>;
+    setProviderApiKey(providerId: string, apiKey: string, baseUrl?: string): Promise<void>;
+}

package/dist/lib/lib/backend-adapter/index.d.ts

@@ -0,0 +1,10 @@
+import { BackendAdapter } from './core';
+import { HttpBackendAdapter } from './http';
+import { TauriBackendAdapter } from './tauri';
+export * from './core';
+export { HttpBackendAdapter, TauriBackendAdapter };
+/**
+ * Detect environment and create appropriate backend adapter
+ */
+export declare function createBackendAdapter(): BackendAdapter;
+export declare function getBackend(): BackendAdapter;

package/dist/lib/lib/backend-adapter/tauri.d.ts

@@ -0,0 +1,121 @@
+import { BackendAdapter, BatchMetadataResponse, ContextFileContent, ContextFileListItem, DependencyGraph, DirectoryListResponse, ListParams, Spec, SpecDetail, Stats, Project, ProjectValidationResponse, ProjectsResponse, ListSpecsResponse, ProjectContext, MachinesResponse, Session, SessionArchiveResult, SessionEvent, SessionLog, SessionMode, ChatConfig, ChatStorageInfo, ModelsRegistryResponse, SpecTokenResponse, SpecValidationResponse, RunnerDefinition, RunnerListResponse, RunnerScope, RunnerValidateResponse } from './core';
+/**
+ * Tauri adapter for desktop app - uses IPC commands
+ */
+export declare class TauriBackendAdapter implements BackendAdapter {
+    setMachineId(machineId: string | null): void;
+    getMachines(): Promise<MachinesResponse>;
+    renameMachine(machineId: string, label: string): Promise<void>;
+    revokeMachine(machineId: string): Promise<void>;
+    requestExecution(machineId: string, payload: Record<string, unknown>): Promise<void>;
+    private invoke;
+    getProjects(): Promise<ProjectsResponse>;
+    createProject(path: string, options?: {
+        favorite?: boolean;
+        color?: string;
+        name?: string;
+        description?: string | null;
+    }): Promise<Project>;
+    updateProject(projectId: string, updates: Partial<Pick<Project, 'name' | 'color' | 'favorite' | 'description'>>): Promise<Project | undefined>;
+    deleteProject(projectId: string): Promise<void>;
+    validateProject(projectId: string): Promise<ProjectValidationResponse>;
+    getSpecs(projectId: string, params?: ListParams): Promise<Spec[]>;
+    getSpecsWithHierarchy(projectId: string, params?: ListParams): Promise<ListSpecsResponse>;
+    getSpec(projectId: string, specName: string): Promise<SpecDetail>;
+    getSpecTokens(projectId: string, specName: string): Promise<SpecTokenResponse>;
+    getSpecValidation(projectId: string, specName: string): Promise<SpecValidationResponse>;
+    getBatchMetadata(projectId: string, specNames: string[]): Promise<BatchMetadataResponse>;
+    updateSpec(projectId: string, specName: string, updates: Partial<Pick<Spec, 'status' | 'priority' | 'tags'>> & {
+        expectedContentHash?: string;
+        parent?: string | null;
+        addDependsOn?: string[];
+        removeDependsOn?: string[];
+        force?: boolean;
+    }): Promise<void>;
+    toggleSpecChecklist(projectId: string, specName: string, toggles: {
+        itemText: string;
+        checked: boolean;
+    }[], options?: {
+        expectedContentHash?: string;
+        subspec?: string;
+    }): Promise<{
+        success: boolean;
+        contentHash: string;
+        toggled: {
+            itemText: string;
+            checked: boolean;
+            line: number;
+        }[];
+    }>;
+    getStats(projectId: string): Promise<Stats>;
+    getProjectStats(projectId: string): Promise<Stats>;
+    getDependencies(projectId: string, specName?: string): Promise<DependencyGraph>;
+    getContextFiles(): Promise<ContextFileListItem[]>;
+    getContextFile(path: string): Promise<ContextFileContent>;
+    getProjectContext(projectId: string): Promise<ProjectContext>;
+    listDirectory(path?: string): Promise<DirectoryListResponse>;
+    listSessions(params?: {
+        specId?: string;
+        status?: string;
+        runner?: string;
+    }): Promise<Session[]>;
+    getSession(sessionId: string): Promise<Session>;
+    createSession(payload: {
+        projectPath: string;
+        specId?: string | null;
+        runner?: string;
+        mode: SessionMode;
+    }): Promise<Session>;
+    startSession(): Promise<Session>;
+    pauseSession(): Promise<Session>;
+    resumeSession(): Promise<Session>;
+    stopSession(): Promise<Session>;
+    archiveSession(): Promise<SessionArchiveResult>;
+    deleteSession(): Promise<void>;
+    getSessionLogs(): Promise<SessionLog[]>;
+    getSessionEvents(): Promise<SessionEvent[]>;
+    listAvailableRunners(projectPath?: string): Promise<string[]>;
+    listRunners(projectPath?: string, options?: {
+        skipValidation?: boolean;
+    }): Promise<RunnerListResponse>;
+    getRunner(runnerId: string, projectPath?: string): Promise<RunnerDefinition>;
+    createRunner(payload: {
+        projectPath: string;
+        runner: {
+            id: string;
+            name?: string | null;
+            command?: string | null;
+            args?: string[];
+            env?: Record<string, string>;
+        };
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    updateRunner(runnerId: string, payload: {
+        projectPath: string;
+        runner: {
+            name?: string | null;
+            command?: string | null;
+            args?: string[];
+            env?: Record<string, string>;
+        };
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    deleteRunner(runnerId: string, payload: {
+        projectPath: string;
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    validateRunner(runnerId: string, projectPath?: string): Promise<RunnerValidateResponse>;
+    setDefaultRunner(payload: {
+        projectPath: string;
+        runnerId: string;
+        scope?: RunnerScope;
+    }): Promise<RunnerListResponse>;
+    getChatConfig(): Promise<ChatConfig>;
+    updateChatConfig(config: ChatConfig): Promise<ChatConfig>;
+    getChatStorageInfo(): Promise<ChatStorageInfo>;
+    getModelsProviders(options?: {
+        agenticOnly?: boolean;
+    }): Promise<ModelsRegistryResponse>;
+    refreshModelsRegistry(): Promise<void>;
+    setProviderApiKey(providerId: string, apiKey: string, baseUrl?: string): Promise<void>;
+}

package/dist/lib/lib/badge-config.d.ts

@@ -0,0 +1,20 @@
+import { LucideIcon } from 'lucide-react';
+import { SpecPriority, SpecStatus } from '../types/specs';
+export interface BadgeConfig {
+    icon: LucideIcon;
+    label: string;
+    labelKey: string;
+    className: string;
+}
+/**
+ * Status badge configuration
+ * Used by both display badges and editors
+ */
+export declare const statusConfig: Record<SpecStatus, BadgeConfig>;
+/**
+ * Priority badge configuration
+ * Used by both display badges and editors
+ */
+export declare const priorityConfig: Record<SpecPriority, BadgeConfig>;
+export declare function getStatusLabel(status: string, t?: (key: string) => string): string;
+export declare function getPriorityLabel(priority: string, t?: (key: string) => string): string;

package/dist/lib/lib/chat-api.d.ts

@@ -0,0 +1,38 @@
+import { UIMessage } from '@ai-sdk/react';
+export interface ChatThread {
+    id: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    model: {
+        providerId: string;
+        modelId: string;
+    };
+    messageCount: number;
+    preview: string;
+}
+export interface ChatStorageInfo {
+    path: string;
+    sizeBytes: number;
+}
+export declare class ChatApi {
+    static getStorageInfo(): Promise<ChatStorageInfo>;
+    static getThreads(projectId?: string): Promise<ChatThread[]>;
+    static createThread(projectId: string, model: {
+        providerId: string;
+        modelId: string;
+    }, initialMessages?: UIMessage[]): Promise<ChatThread>;
+    static updateThread(id: string, updates: Partial<ChatThread>): Promise<ChatThread>;
+    static deleteThread(id: string): Promise<void>;
+    static getMessages(threadId: string): Promise<UIMessage[]>;
+    static saveMessages(threadId: string, messages: UIMessage[], options?: {
+        providerId?: string;
+        modelId?: string;
+    }): Promise<void>;
+    static generateTitle(options: {
+        text: string;
+        projectId?: string;
+        providerId?: string;
+        modelId?: string;
+    }): Promise<string>;
+}

package/dist/lib/lib/color-utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Utility functions for generating colors from strings
+ */
+/**
+ * Predefined color palette for projects
+ */
+export declare const PROJECT_COLORS: string[];
+/**
+ * Generate a consistent color from a string (e.g., project name)
+ */
+export declare function getColorFromString(str: string): string;
+/**
+ * Get contrasting text color for a background
+ */
+export declare function getContrastColor(hexColor?: string): string;
+/**
+ * Get initials from a name string
+ * Takes first letter of first two words, or first two letters if single word
+ */
+export declare function getInitials(name: string): string;

package/dist/lib/lib/date-utils.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Format a date as relative time (e.g., "2 days ago")
+ */
+export declare function formatRelativeTime(date: Date | string | number | null | undefined, locale?: string): string;
+/**
+ * Format a date in a readable format (e.g., "Nov 12, 2025")
+ */
+export declare function formatDate(date: Date | string | number | null | undefined, locale?: string): string;
+/**
+ * Format a date with time (e.g., "Nov 12, 2025 10:30 AM")
+ */
+export declare function formatDateTime(date: Date | string | number | null | undefined, locale?: string): string;
+/**
+ * Format duration between two dates in a human-readable format
+ */
+export declare function formatDuration(start: Date | string | number | null | undefined, end: Date | string | number | null | undefined, locale?: string): string;

package/dist/lib/lib/hierarchy.d.ts

@@ -0,0 +1,17 @@
+import { LightweightSpec } from '../types/specs';
+export type SortOption = 'id-desc' | 'id-asc' | 'updated-desc' | 'title-asc' | 'title-desc' | 'priority-desc' | 'priority-asc';
+export interface HierarchyNode extends LightweightSpec {
+    childNodes: HierarchyNode[];
+}
+/**
+ * Builds a hierarchical tree structure from a flat list of specs.
+ *
+ * @param specs Flat list of specs
+ * @param sortBy Sort option for the hierarchy nodes (default: 'id-desc')
+ * @returns Array of root nodes, each containing their children recursively
+ */
+export declare function buildHierarchy(specs: LightweightSpec[], sortBy?: SortOption): HierarchyNode[];
+/**
+ * Get all IDs of nodes that have children (expandable nodes)
+ */
+export declare function getAllParentIds(nodes: HierarchyNode[]): Set<string>;

package/dist/lib/lib/i18n.d.ts

@@ -0,0 +1,2 @@
+import { default as i18n } from 'i18next';
+export default i18n;

package/dist/lib/lib/index.d.ts

@@ -0,0 +1,5 @@
+export { cn } from './utils';
+export { formatDate, formatDateTime, formatRelativeTime, formatDuration, } from './date-utils';
+export { PROJECT_COLORS, getColorFromString, getContrastColor, getInitials, } from './color-utils';
+export { buildHierarchy, type HierarchyNode, type SortOption, getAllParentIds } from './hierarchy';
+export { statusConfig, priorityConfig, getStatusLabel, getPriorityLabel, type BadgeConfig, } from './badge-config';

package/dist/lib/lib/markdown-utils.d.ts

@@ -0,0 +1,9 @@
+export interface HeadingItem {
+    id: string;
+    text: string;
+    level: number;
+}
+/**
+ * Extract markdown headings while skipping fenced code blocks.
+ */
+export declare function extractHeadings(markdown: string): HeadingItem[];