@oro.ad/nuxt-claude-devtools 1.2.0 → 1.3.0

package/dist/runtime/server/commands-manager.d.ts

@@ -1,3 +1,4 @@
+import { MarkdownResourceManager } from './base-resource-manager.js';
 export interface SlashCommand {
     name: string;
     path: string;
@@ -7,12 +8,18 @@ export interface SlashCommand {
     content: string;
     rawContent: string;
     updatedAt: string;
+    /** Source of the command: 'project' for local .claude/, or plugin name */
+    source?: string;
 }
-export declare class CommandsManager {
-    private commandsDir;
+interface CommandFrontmatter {
+    'description'?: string;
+    'allowed-tools'?: string;
+    'disable-model-invocation'?: boolean;
+}
+export declare class CommandsManager extends MarkdownResourceManager<SlashCommand, CommandFrontmatter> {
     constructor(projectPath: string);
-    private parseFrontmatter;
-    private buildFrontmatter;
+    protected buildFrontmatter(command: Partial<SlashCommand>): string;
+    protected toResource(name: string, frontmatter: CommandFrontmatter, body: string, rawContent: string, updatedAt: string): SlashCommand;
     getCommands(): SlashCommand[];
     getCommand(name: string): SlashCommand | null;
     saveCommand(name: string, content: string, options?: {
@@ -22,3 +29,4 @@ export declare class CommandsManager {
     }): SlashCommand;
     deleteCommand(name: string): boolean;
 }
+export {};

package/dist/runtime/server/commands-manager.js

@@ -1,132 +1,57 @@
-import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs";
-import { basename, join } from "node:path";
 import { createLogger } from "../logger.js";
+import { MarkdownResourceManager } from "./base-resource-manager.js";
+import { COMMANDS_SUBDIR } from "./constants.js";
 const log = createLogger("commands", { timestamp: true });
-export class CommandsManager {
-  commandsDir;
+export class CommandsManager extends MarkdownResourceManager {
   constructor(projectPath) {
-    this.commandsDir = join(projectPath, ".claude", "commands");
-    if (!existsSync(this.commandsDir)) {
-      mkdirSync(this.commandsDir, { recursive: true });
-      log("Created commands directory", { path: this.commandsDir });
-    }
+    super(projectPath, COMMANDS_SUBDIR, log);
   }
-  // Parse frontmatter from markdown content
-  parseFrontmatter(content) {
-    const frontmatterRegex = /^---\n((?:[^\n]*\n)*?)---\n([\s\S]*)$/;
-    const match = content.match(frontmatterRegex);
-    if (!match) {
-      return { frontmatter: {}, body: content };
-    }
-    const [, yaml, body] = match;
-    const frontmatter = {};
-    for (const line of yaml.split("\n")) {
-      const colonIndex = line.indexOf(":");
-      if (colonIndex === -1) continue;
-      const key = line.slice(0, colonIndex).trim();
-      const value = line.slice(colonIndex + 1).trim();
-      if (key === "description") {
-        frontmatter.description = value;
-      } else if (key === "allowed-tools") {
-        frontmatter["allowed-tools"] = value;
-      } else if (key === "disable-model-invocation") {
-        frontmatter["disable-model-invocation"] = value === "true";
-      }
-    }
-    return { frontmatter, body: body.trim() };
-  }
-  // Build frontmatter string
   buildFrontmatter(command) {
-    const lines = ["---"];
-    if (command.description) {
-      lines.push(`description: ${command.description}`);
-    }
-    if (command.allowedTools && command.allowedTools.length > 0) {
-      lines.push(`allowed-tools: ${command.allowedTools.join(", ")}`);
-    }
-    if (command.disableModelInvocation !== void 0) {
-      lines.push(`disable-model-invocation: ${command.disableModelInvocation}`);
-    }
-    lines.push("---");
-    return lines.join("\n");
-  }
-  // Get all slash commands
-  getCommands() {
-    const commands = [];
-    if (!existsSync(this.commandsDir)) return commands;
-    const entries = readdirSync(this.commandsDir);
-    for (const entry of entries) {
-      if (!entry.endsWith(".md")) continue;
-      const fullPath = join(this.commandsDir, entry);
-      const stat = statSync(fullPath);
-      if (stat.isDirectory()) continue;
-      const rawContent = readFileSync(fullPath, "utf-8");
-      const { frontmatter, body } = this.parseFrontmatter(rawContent);
-      commands.push({
-        name: basename(entry, ".md"),
-        path: entry,
-        description: frontmatter.description,
-        allowedTools: frontmatter["allowed-tools"] ? frontmatter["allowed-tools"].split(",").map((s) => s.trim()) : void 0,
-        disableModelInvocation: frontmatter["disable-model-invocation"],
-        content: body,
-        rawContent,
-        updatedAt: stat.mtime.toISOString()
-      });
-    }
-    return commands.sort((a, b) => a.name.localeCompare(b.name));
+    return this.buildFrontmatterLines([
+      { key: "description", value: command.description },
+      { key: "allowed-tools", value: command.allowedTools },
+      { key: "disable-model-invocation", value: command.disableModelInvocation }
+    ]);
   }
-  // Get single command
-  getCommand(name) {
-    const fileName = name.endsWith(".md") ? name : `${name}.md`;
-    const fullPath = join(this.commandsDir, fileName);
-    if (!existsSync(fullPath)) return null;
-    const stat = statSync(fullPath);
-    const rawContent = readFileSync(fullPath, "utf-8");
-    const { frontmatter, body } = this.parseFrontmatter(rawContent);
+  toResource(name, frontmatter, body, rawContent, updatedAt) {
     return {
-      name: basename(fileName, ".md"),
-      path: fileName,
+      name,
+      path: `${name}.md`,
       description: frontmatter.description,
       allowedTools: frontmatter["allowed-tools"] ? frontmatter["allowed-tools"].split(",").map((s) => s.trim()) : void 0,
       disableModelInvocation: frontmatter["disable-model-invocation"],
       content: body,
       rawContent,
-      updatedAt: stat.mtime.toISOString()
+      updatedAt
     };
   }
-  // Create or update command
+  // Public API methods
+  getCommands() {
+    return this.getAll();
+  }
+  getCommand(name) {
+    return this.getOne(name);
+  }
   saveCommand(name, content, options) {
-    const safeName = name.replace(/[^\w-]/g, "-").toLowerCase();
-    const fileName = `${safeName}.md`;
-    const fullPath = join(this.commandsDir, fileName);
+    const safeName = this.sanitizeName(name);
     const frontmatter = this.buildFrontmatter({
       description: options?.description,
       allowedTools: options?.allowedTools,
       disableModelInvocation: options?.disableModelInvocation
     });
-    const rawContent = `${frontmatter}
-
-${content}`;
-    writeFileSync(fullPath, rawContent, "utf-8");
-    log("Saved command", { name: safeName });
+    const { rawContent, updatedAt } = this.saveResource(safeName, frontmatter, content);
     return {
       name: safeName,
-      path: fileName,
+      path: `${safeName}.md`,
       description: options?.description,
       allowedTools: options?.allowedTools,
       disableModelInvocation: options?.disableModelInvocation,
       content,
       rawContent,
-      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+      updatedAt
     };
   }
-  // Delete command
   deleteCommand(name) {
-    const fileName = name.endsWith(".md") ? name : `${name}.md`;
-    const fullPath = join(this.commandsDir, fileName);
-    if (!existsSync(fullPath)) return false;
-    unlinkSync(fullPath);
-    log("Deleted command", { name });
-    return true;
+    return this.delete(name);
   }
 }

package/dist/runtime/server/constants.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Server-side constants for nuxt-claude-devtools
+ * Defines file paths, directory names, and configuration file names
+ */
+/**
+ * Claude's standard configuration directory
+ * Contains: commands, agents, skills, docs
+ * Standard location recognized by Claude CLI
+ */
+export declare const CLAUDE_DIR = ".claude";
+/**
+ * DevTools-specific data directory
+ * Contains: history.json, settings.json, share.json, llms.json
+ * Separate from .claude to avoid conflicts with Claude CLI
+ */
+export declare const DEVTOOLS_DATA_DIR = ".claude-devtools";
+/**
+ * Directory for custom slash commands
+ * Path: .claude/commands/
+ */
+export declare const COMMANDS_SUBDIR = "commands";
+/**
+ * Directory for agent definitions
+ * Path: .claude/agents/
+ */
+export declare const AGENTS_SUBDIR = "agents";
+/**
+ * Directory for skill definitions
+ * Path: .claude/skills/
+ */
+export declare const SKILLS_SUBDIR = "skills";
+/**
+ * Directory for project documentation
+ * Path: .claude/docs/
+ * Claude automatically reads files from this directory
+ */
+export declare const DOCS_SUBDIR = "docs";
+/**
+ * Project guidelines file in repository root
+ * Claude reads this file for project-specific instructions
+ */
+export declare const CLAUDE_MD_FILE = "CLAUDE.md";
+/**
+ * Skill definition file name inside skill subdirectories
+ * Path: .claude/skills/<skill-name>/SKILL.md
+ */
+export declare const SKILL_FILE = "SKILL.md";
+/**
+ * Conversation history storage
+ * Path: .claude-devtools/history.json
+ */
+export declare const HISTORY_FILE = "history.json";
+/**
+ * DevTools settings storage
+ * Path: .claude-devtools/settings.json
+ */
+export declare const SETTINGS_FILE = "settings.json";
+/**
+ * Collaborative sharing data
+ * Path: .claude-devtools/share.json
+ */
+export declare const SHARE_FILE = "share.json";
+/**
+ * External documentation sources (llms.txt URLs)
+ * Path: .claude-devtools/llms.json
+ */
+export declare const LLMS_FILE = "llms.json";
+/**
+ * Default extension for markdown resources
+ */
+export declare const MD_EXTENSION = ".md";
+/**
+ * Default plugins cache directory (relative to user home)
+ * Path: ~/.claude/plugins/cache
+ */
+export declare const DEFAULT_PLUGINS_CACHE_PATH = ".claude/plugins/cache";
+/**
+ * Plugin manifest directory name inside plugin root
+ */
+export declare const PLUGIN_MANIFEST_DIR = ".claude-plugin";
+/**
+ * Plugin manifest file name
+ */
+export declare const PLUGIN_MANIFEST_FILE = "plugin.json";
+/**
+ * Claude settings file (for reading enabled plugins)
+ * Path: ~/.claude/settings.json (user scope)
+ */
+export declare const CLAUDE_SETTINGS_FILE = "settings.json";
+/**
+ * Claude local settings file (project scope, gitignored)
+ * Path: .claude/settings.local.json
+ */
+export declare const CLAUDE_SETTINGS_LOCAL_FILE = "settings.local.json";

package/dist/runtime/server/constants.js

@@ -0,0 +1,18 @@
+export const CLAUDE_DIR = ".claude";
+export const DEVTOOLS_DATA_DIR = ".claude-devtools";
+export const COMMANDS_SUBDIR = "commands";
+export const AGENTS_SUBDIR = "agents";
+export const SKILLS_SUBDIR = "skills";
+export const DOCS_SUBDIR = "docs";
+export const CLAUDE_MD_FILE = "CLAUDE.md";
+export const SKILL_FILE = "SKILL.md";
+export const HISTORY_FILE = "history.json";
+export const SETTINGS_FILE = "settings.json";
+export const SHARE_FILE = "share.json";
+export const LLMS_FILE = "llms.json";
+export const MD_EXTENSION = ".md";
+export const DEFAULT_PLUGINS_CACHE_PATH = ".claude/plugins/cache";
+export const PLUGIN_MANIFEST_DIR = ".claude-plugin";
+export const PLUGIN_MANIFEST_FILE = "plugin.json";
+export const CLAUDE_SETTINGS_FILE = "settings.json";
+export const CLAUDE_SETTINGS_LOCAL_FILE = "settings.local.json";

package/dist/runtime/server/docs-manager.d.ts

@@ -1,3 +1,6 @@
+export declare const CRITICAL_FILES: readonly ["nuxt.config.ts", "nuxt.config.js", "app.config.ts", "app.config.js", ".nuxtrc", "tsconfig.json"];
+export declare function isCriticalFile(filePath: string): boolean;
+export declare function getCriticalFileName(filePath: string): string | null;
 export interface DocFile {
     path: string;
     name: string;
@@ -36,6 +39,10 @@ export declare class DocsManager {
         exists: boolean;
         updatedAt: string;
     };
+    private static readonly CRITICAL_FILES_START;
+    private static readonly CRITICAL_FILES_END;
+    ensureCriticalFilesSection(autoConfirm?: boolean): void;
+    private generateCriticalFilesSection;
     private loadLlmsStore;
     private saveLlmsStore;
     getLlmsSources(): LlmsSource[];

package/dist/runtime/server/docs-manager.js

@@ -1,15 +1,35 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative } from "node:path";
 import { createLogger } from "../logger.js";
+import { CLAUDE_DIR, CLAUDE_MD_FILE, DEVTOOLS_DATA_DIR, DOCS_SUBDIR, LLMS_FILE, SETTINGS_FILE } from "./constants.js";
 const log = createLogger("docs", { timestamp: true });
+export const CRITICAL_FILES = [
+  "nuxt.config.ts",
+  "nuxt.config.js",
+  "app.config.ts",
+  "app.config.js",
+  ".nuxtrc",
+  "tsconfig.json"
+];
+export function isCriticalFile(filePath) {
+  const fileName = basename(filePath);
+  return CRITICAL_FILES.includes(fileName);
+}
+export function getCriticalFileName(filePath) {
+  const fileName = basename(filePath);
+  if (CRITICAL_FILES.includes(fileName)) {
+    return fileName;
+  }
+  return null;
+}
 export class DocsManager {
   docsDir;
   llmsPath;
   projectPath;
   constructor(projectPath) {
     this.projectPath = projectPath;
-    this.docsDir = join(projectPath, ".claude", "docs");
-    this.llmsPath = join(projectPath, ".claude-devtools", "llms.json");
+    this.docsDir = join(projectPath, CLAUDE_DIR, DOCS_SUBDIR);
+    this.llmsPath = join(projectPath, DEVTOOLS_DATA_DIR, LLMS_FILE);
     if (!existsSync(this.docsDir)) {
       mkdirSync(this.docsDir, { recursive: true });
       log("Created docs directory", { path: this.docsDir });
@@ -84,7 +104,7 @@ export class DocsManager {
   }
   // ============ CLAUDE.md ============
   get claudeMdPath() {
-    return join(this.projectPath, "CLAUDE.md");
+    return join(this.projectPath, CLAUDE_MD_FILE);
   }
   // Get CLAUDE.md content
   getClaudeMd() {
@@ -110,6 +130,95 @@ export class DocsManager {
       updatedAt: (/* @__PURE__ */ new Date()).toISOString()
     };
   }
+  // Section markers for auto-generated content
+  static CRITICAL_FILES_START = "<!-- NUXT-DEVTOOLS:CRITICAL-FILES -->";
+  static CRITICAL_FILES_END = "<!-- /NUXT-DEVTOOLS:CRITICAL-FILES -->";
+  // Ensure CLAUDE.md has the critical files warning section
+  // Always updates the auto-generated section on startup to ensure latest instructions
+  ensureCriticalFilesSection(autoConfirm = false) {
+    const { content, exists } = this.getClaudeMd();
+    const criticalFilesSection = this.generateCriticalFilesSection(autoConfirm);
+    if (!exists) {
+      const newContent = `# Project Guidelines
+
+${criticalFilesSection}
+`;
+      this.saveClaudeMd(newContent);
+      log("Created CLAUDE.md with critical files section");
+      return;
+    }
+    if (content.includes(DocsManager.CRITICAL_FILES_START)) {
+      const startIdx = content.indexOf(DocsManager.CRITICAL_FILES_START);
+      const endIdx = content.indexOf(DocsManager.CRITICAL_FILES_END);
+      if (endIdx > startIdx) {
+        const before = content.substring(0, startIdx);
+        const after = content.substring(endIdx + DocsManager.CRITICAL_FILES_END.length);
+        const newContent = before + criticalFilesSection + after;
+        this.saveClaudeMd(newContent);
+        log("Updated critical files section in CLAUDE.md");
+      }
+    } else {
+      const newContent = content.trimEnd() + "\n\n" + criticalFilesSection + "\n";
+      this.saveClaudeMd(newContent);
+      log("Added critical files section to CLAUDE.md");
+    }
+  }
+  generateCriticalFilesSection(autoConfirm) {
+    const filesList = CRITICAL_FILES.map((f) => `- \`${f}\``).join("\n");
+    const settingsPath = `${DEVTOOLS_DATA_DIR}/${SETTINGS_FILE}`;
+    return `${DocsManager.CRITICAL_FILES_START}
+## \u26A0\uFE0F Critical Configuration Files
+
+The following files trigger a full Nuxt restart when modified:
+${filesList}
+
+### \u{1F534} MANDATORY CHECK (EVERY TIME, NO EXCEPTIONS)
+
+**BEFORE modifying ANY of these files, you MUST:**
+
+\`\`\`
+1. READ ${settingsPath}
+2. CHECK criticalFiles.autoConfirm value
+3. IF false OR file missing \u2192 STOP and ASK user
+4. IF true \u2192 inform user, then proceed
+\`\`\`
+
+**This check is REQUIRED every single time, even if you checked before in this session.**
+
+### Order of Operations
+
+1. **Complete ALL prerequisite tasks FIRST**
+   - Create all new files that will be referenced
+   - Install all dependencies
+   - Write all related code
+
+2. **Verify prerequisites exist**
+   - All files referenced in config change must exist
+   - All imports must be valid
+
+3. **Check settings file** (read \`${settingsPath}\`)
+
+4. **Act based on autoConfirm setting**
+
+### Example: Adding i18n locale
+
+\`\`\`
+Step 1: Create locales/es.json           \u2713 prerequisite
+Step 2: Read ${settingsPath}  \u2713 check flag
+Step 3: If autoConfirm=false \u2192 ask user
+Step 4: Update nuxt.config.ts            \u2713 only after confirmation
+\`\`\`
+
+### Current Setting
+
+**autoConfirm: ${autoConfirm ? "ENABLED" : "DISABLED"}**
+
+${autoConfirm ? "\u2192 Inform user about restart, no confirmation needed." : '\u2192 MUST ask user and WAIT for explicit "yes" before proceeding.'}
+
+---
+After restart, conversation history is preserved. User can send "continue" to resume.
+${DocsManager.CRITICAL_FILES_END}`;
+  }
   // ============ LLMS Sources ============
   loadLlmsStore() {
     try {

package/dist/runtime/server/history-manager.d.ts

@@ -21,4 +21,5 @@ export declare class HistoryManager {
     getClaudeSessionId(): string | null;
     formatHistoryForSystemPrompt(): string | null;
     hasHistoryForRecovery(): boolean;
+    savePartialAssistantMessage(message: Message): void;
 }

package/dist/runtime/server/history-manager.js

@@ -1,6 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { createLogger } from "../logger.js";
+import { DEVTOOLS_DATA_DIR, HISTORY_FILE } from "./constants.js";
 const log = createLogger("history", { timestamp: true });
 export class HistoryManager {
   storePath;
@@ -8,8 +9,8 @@ export class HistoryManager {
   projectPath;
   constructor(projectPath) {
     this.projectPath = projectPath;
-    const historyDir = join(projectPath, ".claude-devtools");
-    this.storePath = join(historyDir, "history.json");
+    const historyDir = join(projectPath, DEVTOOLS_DATA_DIR);
+    this.storePath = join(historyDir, HISTORY_FILE);
     if (!existsSync(historyDir)) {
       mkdirSync(historyDir, { recursive: true });
       log("Created history directory", { path: historyDir });
@@ -75,7 +76,8 @@ export class HistoryManager {
     conversation.messages.push(message);
     conversation.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     if (!conversation.title && message.role === "user") {
-      conversation.title = message.content.substring(0, 50) + (message.content.length > 50 ? "..." : "");
+      const content = message.content.replace(/^\[context\]\n[\s\S]*?\n\[\/context\]\n?/, "").trim();
+      conversation.title = content.substring(0, 50) + (content.length > 50 ? "..." : "");
     }
     this.saveStore();
   }
@@ -181,4 +183,24 @@ export class HistoryManager {
     const conversation = this.store.activeConversationId ? this.store.conversations.find((c) => c.id === this.store.activeConversationId) : null;
     return !!conversation && conversation.messages.length > 0;
   }
+  // Save partial assistant message (for preserving state before config changes)
+  savePartialAssistantMessage(message) {
+    const conversation = this.getActiveConversation();
+    const lastMessage = conversation.messages[conversation.messages.length - 1];
+    if (lastMessage && lastMessage.role === "assistant") {
+      lastMessage.content = message.content;
+      lastMessage.contentBlocks = message.contentBlocks;
+      lastMessage.timestamp = message.timestamp;
+      if (message.model) lastMessage.model = message.model;
+    } else {
+      conversation.messages.push(message);
+    }
+    conversation.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    try {
+      writeFileSync(this.storePath, JSON.stringify(this.store, null, 2));
+      log("Saved partial assistant message", { messageId: message.id });
+    } catch (error) {
+      log("Failed to save partial assistant message", { error });
+    }
+  }
 }

package/dist/runtime/server/plugins/socket.io.js

@@ -2,6 +2,7 @@ import { defineNitroPlugin, useRuntimeConfig } from "nitropack/runtime";
 import { Server as Engine } from "engine.io";
 import { Server } from "socket.io";
 import { defineEventHandler } from "h3";
+import { SOCKET_PATH } from "../../constants.js";
 import { createLogger } from "../../logger.js";
 import { getClaudeSessionInstance, initClaudeSession } from "../claude-session.js";
 const log = createLogger("plugin");
@@ -17,7 +18,8 @@ export default defineNitroPlugin((nitroApp) => {
     command: claudeConfig.claude.command,
     args: claudeConfig.claude.args,
     rootDir: claudeConfig.rootDir,
-    tunnelOrigin: claudeConfig.tunnelOrigin || null
+    tunnelOrigin: claudeConfig.tunnelOrigin || null,
+    pluginsCachePath: claudeConfig.pluginsCachePath || null
   });
   const engine = new Engine();
   const io = new Server();
@@ -26,7 +28,7 @@ export default defineNitroPlugin((nitroApp) => {
   if (session) {
     session.attachSocketIO(io);
   }
-  nitroApp.router.use("/__claude_devtools_socket/", defineEventHandler({
+  nitroApp.router.use(`${SOCKET_PATH}/`, defineEventHandler({
     handler(event) {
       engine.handleRequest(event.node.req, event.node.res);
       event._handled = true;
@@ -44,5 +46,5 @@ export default defineNitroPlugin((nitroApp) => {
       }
     }
   }));
-  log("Socket.IO server ready on /__claude_devtools_socket/");
+  log(`Socket.IO server ready on ${SOCKET_PATH}/`);
 });

package/dist/runtime/server/plugins-manager.d.ts

@@ -0,0 +1,84 @@
+export type PluginScope = 'user' | 'project' | 'local' | 'managed';
+export interface PluginManifest {
+    name: string;
+    version?: string;
+    description?: string;
+    author?: {
+        name?: string;
+        email?: string;
+        url?: string;
+    };
+    homepage?: string;
+    repository?: string;
+    license?: string;
+    keywords?: string[];
+}
+export interface InstalledPlugin {
+    /** Plugin identifier (name@marketplace) */
+    id: string;
+    /** Plugin name */
+    name: string;
+    /** Marketplace name */
+    marketplace: string;
+    /** Installation scope */
+    scope: PluginScope;
+    /** Whether plugin is enabled */
+    enabled: boolean;
+    /** Plugin manifest (if available from cache) */
+    manifest?: PluginManifest;
+    /** Path to plugin in cache (if found) */
+    cachePath?: string;
+}
+export interface Marketplace {
+    /** Marketplace identifier */
+    name: string;
+    /** Source (GitHub repo, URL, or local path) */
+    source: string;
+    /** Whether auto-update is enabled */
+    autoUpdate?: boolean;
+}
+export interface PluginSkill {
+    name: string;
+    description: string;
+    content: string;
+    pluginName: string;
+    /** Full invocation name: plugin-name:skill-name */
+    fullName: string;
+}
+export interface PluginCommand {
+    name: string;
+    description?: string;
+    content: string;
+    pluginName: string;
+    /** Full invocation name: plugin-name:command-name */
+    fullName: string;
+}
+export interface PluginAgent {
+    name: string;
+    description: string;
+    prompt: string;
+    pluginName: string;
+}
+export declare class PluginsManager {
+    private projectPath;
+    private pluginsCachePath;
+    private userClaudeDir;
+    constructor(projectPath: string, customCachePath?: string | null);
+    private readSettingsFile;
+    private getUserSettings;
+    private getProjectSettings;
+    private getLocalSettings;
+    private parsePluginId;
+    private findPluginInCache;
+    private readPluginManifest;
+    private normalizePluginList;
+    getInstalledPlugins(): InstalledPlugin[];
+    getMarketplaces(): Marketplace[];
+    private parseFrontmatter;
+    getPluginSkills(pluginPath: string, pluginName: string): PluginSkill[];
+    getPluginCommands(pluginPath: string, pluginName: string): PluginCommand[];
+    getPluginAgents(pluginPath: string, pluginName: string): PluginAgent[];
+    getAllPluginSkills(): PluginSkill[];
+    getAllPluginCommands(): PluginCommand[];
+    getAllPluginAgents(): PluginAgent[];
+}