@tdsoft-tech/aikit 0.1.31 → 0.1.33

package/dist/index.d.ts

@@ -1,10 +1,263 @@
 import { z } from 'zod';
 
+/**
+ * Database types for Figma data storage
+ */
+/**
+ * Figma file record in database
+ */
+interface FigmaFileRecord {
+    id: string;
+    url: string;
+    name?: string;
+    file_key: string;
+    last_analyzed?: Date;
+    created_at: Date;
+    updated_at: Date;
+}
+/**
+ * Figma screen/frame record in database
+ */
+interface FigmaScreenRecord {
+    id: string;
+    file_id: string;
+    name: string;
+    width?: number;
+    height?: number;
+    type?: string;
+    description?: string;
+    children_count?: number;
+}
+/**
+ * Figma node (component/section) record in database
+ */
+interface FigmaNodeRecord {
+    id: string;
+    file_id: string;
+    screen_id?: string;
+    parent_id?: string;
+    name: string;
+    type: string;
+    content?: string;
+    position_x?: number;
+    position_y?: number;
+    width?: number;
+    height?: number;
+    styles?: string;
+    children_ids?: string;
+}
+/**
+ * Design token record in database
+ */
+interface DesignTokenRecord {
+    id?: number;
+    file_id: string;
+    type: 'color' | 'typography' | 'spacing' | 'component';
+    name: string;
+    value: string;
+    category?: string;
+}
+/**
+ * Figma asset record in database
+ */
+interface FigmaAssetRecord {
+    id?: number;
+    file_id: string;
+    node_id: string;
+    node_name?: string;
+    node_type?: string;
+    format?: 'png' | 'svg' | 'jpg';
+    file_path?: string;
+    url?: string;
+    width?: number;
+    height?: number;
+}
+/**
+ * Query options for database operations
+ */
+interface QueryOptions {
+    limit?: number;
+    offset?: number;
+    orderBy?: string;
+    orderDirection?: 'ASC' | 'DESC';
+}
+/**
+ * Upsert result
+ */
+interface UpsertResult {
+    id: string;
+    created: boolean;
+    updated: boolean;
+}
+/**
+ * Database interface for Figma data
+ */
+interface FigmaDatabase$1 {
+    upsertFile(file: Omit<FigmaFileRecord, 'created_at' | 'updated_at'>): Promise<UpsertResult>;
+    getFile(id: string): Promise<FigmaFileRecord | null>;
+    getFileByUrl(url: string): Promise<FigmaFileRecord | null>;
+    deleteFile(id: string): Promise<boolean>;
+    listFiles(options?: QueryOptions): Promise<FigmaFileRecord[]>;
+    upsertScreen(screen: FigmaScreenRecord): Promise<UpsertResult>;
+    getScreen(id: string): Promise<FigmaScreenRecord | null>;
+    getScreensByFile(fileId: string): Promise<FigmaScreenRecord[]>;
+    deleteScreen(id: string): Promise<boolean>;
+    upsertNode(node: FigmaNodeRecord): Promise<UpsertResult>;
+    getNode(id: string): Promise<FigmaNodeRecord | null>;
+    getNodesByScreen(screenId: string): Promise<FigmaNodeRecord[]>;
+    getNodesByFile(fileId: string): Promise<FigmaNodeRecord[]>;
+    deleteNode(id: string): Promise<boolean>;
+    upsertDesignToken(token: Omit<DesignTokenRecord, 'id'>): Promise<UpsertResult>;
+    getDesignTokensByFile(fileId: string, type?: string): Promise<DesignTokenRecord[]>;
+    deleteDesignTokensByFile(fileId: string): Promise<boolean>;
+    upsertAsset(asset: Omit<FigmaAssetRecord, 'id'>): Promise<UpsertResult>;
+    getAssetsByFile(fileId: string): Promise<FigmaAssetRecord[]>;
+    deleteAssetsByFile(fileId: string): Promise<boolean>;
+    close(): Promise<void>;
+    vacuum(): Promise<void>;
+    getStats(): Promise<{
+        files: number;
+        screens: number;
+        nodes: number;
+        tokens: number;
+        assets: number;
+    }>;
+}
+
+/**
+ * SQLite-based Figma database implementation
+ */
+declare class FigmaDatabase implements FigmaDatabase$1 {
+    private db;
+    constructor(dbPath?: string);
+    /**
+     * Export database data to JSON
+     */
+    exportData(fileId?: string): Promise<{
+        files: FigmaFileRecord[];
+        screens: FigmaScreenRecord[];
+        nodes: FigmaNodeRecord[];
+        tokens: DesignTokenRecord[];
+        assets: FigmaAssetRecord[];
+        exported_at: string;
+    }>;
+    /**
+     * Import database data from JSON
+     */
+    importData(data: {
+        files: FigmaFileRecord[];
+        screens: FigmaScreenRecord[];
+        nodes: FigmaNodeRecord[];
+        tokens: DesignTokenRecord[];
+        assets: FigmaAssetRecord[];
+    }): Promise<{
+        files: number;
+        screens: number;
+        nodes: number;
+        tokens: number;
+        assets: number;
+    }>;
+    /**
+     * Utility Operations
+     */
+    upsertFile(file: Omit<FigmaFileRecord, 'created_at' | 'updated_at'>): Promise<UpsertResult>;
+    getFile(id: string): Promise<FigmaFileRecord | null>;
+    getFileByUrl(url: string): Promise<FigmaFileRecord | null>;
+    deleteFile(id: string): Promise<boolean>;
+    listFiles(options?: QueryOptions): Promise<FigmaFileRecord[]>;
+    /**
+     * Screen Operations
+     */
+    upsertScreen(screen: FigmaScreenRecord): Promise<UpsertResult>;
+    getScreen(id: string): Promise<FigmaScreenRecord | null>;
+    getScreensByFile(fileId: string): Promise<FigmaScreenRecord[]>;
+    deleteScreen(id: string): Promise<boolean>;
+    /**
+     * Node Operations
+     */
+    upsertNode(node: FigmaNodeRecord): Promise<UpsertResult>;
+    getNode(id: string): Promise<FigmaNodeRecord | null>;
+    getNodesByScreen(screenId: string): Promise<FigmaNodeRecord[]>;
+    getNodesByFile(fileId: string): Promise<FigmaNodeRecord[]>;
+    deleteNode(id: string): Promise<boolean>;
+    /**
+     * Design Token Operations
+     */
+    upsertDesignToken(token: Omit<DesignTokenRecord, 'id'>): Promise<UpsertResult>;
+    getDesignTokensByFile(fileId: string, type?: string): Promise<DesignTokenRecord[]>;
+    deleteDesignTokensByFile(fileId: string): Promise<boolean>;
+    /**
+     * Asset Operations
+     */
+    upsertAsset(asset: Omit<FigmaAssetRecord, 'id'>): Promise<UpsertResult>;
+    getAssetsByFile(fileId: string): Promise<FigmaAssetRecord[]>;
+    deleteAssetsByFile(fileId: string): Promise<boolean>;
+    /**
+     * Cache invalidation logic
+     */
+    isCacheValid(url: string, maxAgeHours?: number): Promise<boolean>;
+    /**
+     * Clear cache for a specific file
+     */
+    clearFileCache(url: string): Promise<boolean>;
+    /**
+     * Clear all expired cache entries
+     */
+    clearExpiredCache(maxAgeHours?: number): Promise<number>;
+    close(): Promise<void>;
+    vacuum(): Promise<void>;
+    getStats(): Promise<{
+        files: number;
+        screens: number;
+        nodes: number;
+        tokens: number;
+        assets: number;
+    }>;
+}
+
+/**
+ * Platform types supported by AIKit
+ */
+type PlatformType = 'opencode' | 'claude' | 'cursor';
 /**
  * AIKit Configuration Schema
  */
 declare const ConfigSchema: z.ZodObject<{
     version: z.ZodString;
+    /**
+     * Platform configuration - controls which platforms are active
+     */
+    platform: z.ZodDefault<z.ZodObject<{
+        /**
+         * Primary platform to use (affects default behavior)
+         */
+        primary: z.ZodDefault<z.ZodEnum<["opencode", "claude", "cursor"]>>;
+        /**
+         * Enable OpenCode platform support
+         * Default: true (OpenCode is the primary focus)
+         */
+        opencode: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Enable Claude Code platform support
+         * Default: false (archived, can be re-enabled later)
+         */
+        claude: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Enable Cursor platform support
+         * Default: false (opt-in)
+         */
+        cursor: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        opencode: boolean;
+        claude: boolean;
+        cursor: boolean;
+        primary: "opencode" | "claude" | "cursor";
+    }, {
+        opencode?: boolean | undefined;
+        claude?: boolean | undefined;
+        cursor?: boolean | undefined;
+        primary?: "opencode" | "claude" | "cursor" | undefined;
+    }>>;
     skills: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         directory: z.ZodOptional<z.ZodString>;
@@ -82,6 +335,16 @@ declare const ConfigSchema: z.ZodObject<{
         specFile?: string | undefined;
         reviewFile?: string | undefined;
     }>>;
+    database: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        path: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        path?: string | undefined;
+    }, {
+        path?: string | undefined;
+        enabled?: boolean | undefined;
+    }>>;
     mcp: z.ZodOptional<z.ZodObject<{
         context7: z.ZodDefault<z.ZodBoolean>;
         githubGrep: z.ZodDefault<z.ZodBoolean>;
@@ -120,6 +383,12 @@ declare const ConfigSchema: z.ZodObject<{
         maxSize?: number | undefined;
     };
     version: string;
+    platform: {
+        opencode: boolean;
+        claude: boolean;
+        cursor: boolean;
+        primary: "opencode" | "claude" | "cursor";
+    };
     beads: {
         enabled: boolean;
         autoInit: boolean;
@@ -129,6 +398,10 @@ declare const ConfigSchema: z.ZodObject<{
         specFile: string;
         reviewFile: string;
     };
+    database: {
+        enabled: boolean;
+        path?: string | undefined;
+    };
     mcp?: {
         context7: boolean;
         githubGrep: boolean;
@@ -159,6 +432,12 @@ declare const ConfigSchema: z.ZodObject<{
         enabled?: boolean | undefined;
         maxSize?: number | undefined;
     } | undefined;
+    platform?: {
+        opencode?: boolean | undefined;
+        claude?: boolean | undefined;
+        cursor?: boolean | undefined;
+        primary?: "opencode" | "claude" | "cursor" | undefined;
+    } | undefined;
     beads?: {
         enabled?: boolean | undefined;
         autoInit?: boolean | undefined;
@@ -168,6 +447,10 @@ declare const ConfigSchema: z.ZodObject<{
         specFile?: string | undefined;
         reviewFile?: string | undefined;
     } | undefined;
+    database?: {
+        path?: string | undefined;
+        enabled?: boolean | undefined;
+    } | undefined;
     mcp?: {
         context7?: boolean | undefined;
         githubGrep?: boolean | undefined;
@@ -217,13 +500,39 @@ declare class Config {
         specFile: string;
         reviewFile: string;
     };
+    get database(): {
+        enabled: boolean;
+        path?: string | undefined;
+    };
     get mode(): string | undefined;
+    get platform(): {
+        opencode: boolean;
+        claude: boolean;
+        cursor: boolean;
+        primary: "opencode" | "claude" | "cursor";
+    };
     get configPath(): string;
+    /**
+     * Check if a specific platform is enabled
+     */
+    isPlatformEnabled(platform: PlatformType): boolean;
+    /**
+     * Get the primary platform
+     */
+    getPrimaryPlatform(): PlatformType;
+    /**
+     * Get list of all enabled platforms
+     */
+    getEnabledPlatforms(): PlatformType[];
     get projectPath(): string;
     /**
      * Get path to a specific resource
      */
-    getPath(resource: 'skills' | 'agents' | 'commands' | 'tools' | 'plugins' | 'memory'): string;
+    getPath(resource: 'skills' | 'agents' | 'commands' | 'tools' | 'plugins' | 'memory' | 'database'): string;
+    /**
+     * Get database instance
+     */
+    getDatabase(): FigmaDatabase;
 }
 /**
  * Load AIKit configuration
@@ -412,15 +721,15 @@ declare const ToolConfigSchema: z.ZodObject<{
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     errorMessage: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    status: "ready" | "needs_config" | "error";
     name: string;
+    status: "ready" | "needs_config" | "error";
     description: string;
     configMethod: "oauth" | "manual" | "none";
     config?: Record<string, unknown> | undefined;
     errorMessage?: string | undefined;
 }, {
-    status: "ready" | "needs_config" | "error";
     name: string;
+    status: "ready" | "needs_config" | "error";
     description: string;
     configMethod: "oauth" | "manual" | "none";
     config?: Record<string, unknown> | undefined;
@@ -464,12 +773,18 @@ declare class ToolConfigManager {
     private determineStatus;
     /**
      * Load saved configurations
+     * Checks both global and project configs, project takes precedence
      */
     private loadConfigs;
     /**
      * Save configurations
      */
     private saveConfigs;
+    /**
+     * Configure Claude Desktop MCP server for a tool
+     * This adds the MCP server configuration to Claude Desktop's config file
+     */
+    configureMcpServer(toolName: string, apiKey: string): Promise<void>;
 }
 
 /**
@@ -1035,6 +1350,22 @@ declare const paths: {
      * Get Claude Code CLI agents directory
      */
     claudeAgents(project?: boolean): string;
+    /**
+     * Get Cursor configuration directory
+     */
+    cursorConfig(scope?: "user" | "project"): string;
+    /**
+     * Get Cursor commands directory
+     */
+    cursorCommands(project?: boolean): string;
+    /**
+     * Get Cursor skills directory
+     */
+    cursorSkills(project?: boolean): string;
+    /**
+     * Get Cursor agents directory
+     */
+    cursorAgents(project?: boolean): string;
 };
 
 /**
@@ -1043,4 +1374,4 @@ declare const paths: {
  */
 declare function getVersion(): string;
 
-export { type AIKitConfig, type Agent, AgentManager, type AgentType, AntiHallucination, BeadsIntegration, type Command, CommandRunner, Config, type Memory, MemoryManager, type Plugin, type PluginEvent, PluginSystem, type Skill, SkillEngine, type Tool, ToolRegistry, getVersion as VERSION, checkForUpdatesAsync, defineTool, loadConfig, logger, paths };
+export { type AIKitConfig, type Agent, AgentManager, type AgentType, AntiHallucination, BeadsIntegration, type Command, CommandRunner, Config, type Memory, MemoryManager, type Plugin, type PluginEvent, PluginSystem, type Skill, SkillEngine, type Tool, type ToolConfig, ToolConfigManager, ToolRegistry, type ToolStatus, getVersion as VERSION, checkForUpdatesAsync, defineTool, loadConfig, logger, paths };