agent-switchboard 0.1.27 → 0.1.28

package/dist/marketplace/plugin-loader.js

@@ -0,0 +1,178 @@
+/**
+ * Plugin component loader: extracts commands, agents, skills, and hooks from a
+ * resolved plugin directory and maps them to ASB library entry formats.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { hookFileSchema } from '../hooks/schema.js';
+import { parseLibraryMarkdown } from '../library/parser.js';
+import { parseSkillMarkdown } from '../skills/parser.js';
+const SKILL_FILE = 'SKILL.md';
+function isMarkdownFile(name) {
+    const ext = path.extname(name).toLowerCase();
+    return ext === '.md' || ext === '.markdown';
+}
+function toId(fileName) {
+    return path.basename(fileName, path.extname(fileName));
+}
+/**
+ * Load all components (commands, agents, skills) from a single plugin directory.
+ * The namespace is the plugin name, producing IDs like "plugin-name:component-id".
+ */
+export function loadPluginComponents(plugin) {
+    const namespace = plugin.name;
+    const result = { commands: [], agents: [], skills: [], hooks: [] };
+    result.commands = loadMarkdownEntries(path.join(plugin.localPath, 'commands'), namespace, 'command');
+    result.agents = loadMarkdownEntries(path.join(plugin.localPath, 'agents'), namespace, 'agent');
+    result.skills = loadSkillEntries(plugin.localPath, namespace);
+    result.hooks = loadHookEntries(plugin.localPath, namespace);
+    return result;
+}
+/**
+ * Load markdown-based library entries (commands or agents) from a directory.
+ */
+function loadMarkdownEntries(directory, namespace, kind) {
+    if (!fs.existsSync(directory) || !fs.statSync(directory).isDirectory()) {
+        return [];
+    }
+    const entries = fs.readdirSync(directory, { withFileTypes: true });
+    const result = [];
+    for (const entry of entries) {
+        if (!entry.isFile() || !isMarkdownFile(entry.name))
+            continue;
+        const absolutePath = path.join(directory, entry.name);
+        const rawContent = fs.readFileSync(absolutePath, 'utf-8');
+        try {
+            const parsed = parseLibraryMarkdown(rawContent);
+            const bareId = toId(entry.name);
+            const id = `${namespace}:${bareId}`;
+            result.push({
+                id,
+                bareId,
+                namespace,
+                source: directory,
+                filePath: absolutePath,
+                metadata: parsed.metadata,
+                content: parsed.content,
+            });
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to parse plugin ${kind} "${entry.name}": ${msg}`);
+        }
+    }
+    return result;
+}
+/**
+ * Load skill entries from a plugin's skills/ directory.
+ * Each subdirectory containing SKILL.md is a skill bundle.
+ */
+function loadSkillEntries(pluginDir, namespace) {
+    const skillsDir = path.join(pluginDir, 'skills');
+    if (!fs.existsSync(skillsDir) || !fs.statSync(skillsDir).isDirectory()) {
+        return [];
+    }
+    const result = [];
+    const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const skillDir = path.join(skillsDir, entry.name);
+        const skillPath = path.join(skillDir, SKILL_FILE);
+        if (!fs.existsSync(skillPath))
+            continue;
+        try {
+            const rawContent = fs.readFileSync(skillPath, 'utf-8');
+            const parsed = parseSkillMarkdown(rawContent);
+            const bareId = entry.name;
+            const id = `${namespace}:${bareId}`;
+            result.push({
+                id,
+                bareId,
+                namespace,
+                source: skillsDir,
+                dirPath: skillDir,
+                skillPath,
+                metadata: parsed.metadata,
+                content: parsed.content,
+            });
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to parse plugin skill "${entry.name}": ${msg}`);
+        }
+    }
+    return result;
+}
+/**
+ * Load hook entries from a plugin's hooks/ directory.
+ * Supports both single-file hooks (*.json) and bundle hooks (subdirs with hook.json).
+ * Claude Code plugins typically have hooks/hooks.json + script files at the same level.
+ */
+function loadHookEntries(pluginDir, namespace) {
+    const hooksDir = path.join(pluginDir, 'hooks');
+    if (!fs.existsSync(hooksDir) || !fs.statSync(hooksDir).isDirectory()) {
+        return [];
+    }
+    const result = [];
+    const entries = fs.readdirSync(hooksDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isFile() && path.extname(entry.name).toLowerCase() === '.json') {
+            const absolutePath = path.join(hooksDir, entry.name);
+            const rawContent = fs.readFileSync(absolutePath, 'utf-8');
+            try {
+                const parsed = hookFileSchema.parse(JSON.parse(rawContent));
+                const bareId = path.basename(entry.name, '.json');
+                const id = `${namespace}:${bareId}`;
+                // Detect if script files exist alongside the JSON (bundle-like plugin layout)
+                const hasScripts = entries.some((e) => e.isFile() && !e.name.endsWith('.json'));
+                result.push({
+                    id,
+                    bareId,
+                    namespace,
+                    source: hooksDir,
+                    filePath: absolutePath,
+                    name: parsed.name,
+                    description: parsed.description,
+                    hooks: parsed.hooks,
+                    isBundle: hasScripts,
+                    dirPath: hasScripts ? hooksDir : undefined,
+                });
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                throw new Error(`Failed to parse plugin hook "${entry.name}": ${msg}`);
+            }
+        }
+        else if (entry.isDirectory()) {
+            const hookJsonPath = path.join(hooksDir, entry.name, 'hook.json');
+            if (!fs.existsSync(hookJsonPath))
+                continue;
+            try {
+                const rawContent = fs.readFileSync(hookJsonPath, 'utf-8');
+                const parsed = hookFileSchema.parse(JSON.parse(rawContent));
+                const bareId = entry.name;
+                const id = `${namespace}:${bareId}`;
+                const bundleDir = path.join(hooksDir, entry.name);
+                result.push({
+                    id,
+                    bareId,
+                    namespace,
+                    source: hooksDir,
+                    filePath: hookJsonPath,
+                    name: parsed.name,
+                    description: parsed.description,
+                    hooks: parsed.hooks,
+                    isBundle: true,
+                    dirPath: bundleDir,
+                });
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                throw new Error(`Failed to parse plugin hook bundle "${entry.name}": ${msg}`);
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=plugin-loader.js.map

package/dist/marketplace/plugin-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.js","sourceRoot":"","sources":["../../src/marketplace/plugin-loader.ts"],"names":[],"mappings":"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"}

package/dist/marketplace/reader.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Marketplace reader: detects and parses Claude Code marketplace repositories.
+ *
+ * A marketplace is a repository containing `.claude-plugin/marketplace.json`.
+ * Each plugin is either a relative path within the same repo or a standalone
+ * directory with `.claude-plugin/plugin.json`.
+ */
+import { type PluginManifest } from './schemas.js';
+export interface ResolvedPlugin {
+    name: string;
+    description?: string;
+    version?: string;
+    /** Absolute path to the plugin root directory */
+    localPath: string;
+    /** Plugin manifest if `.claude-plugin/plugin.json` exists */
+    manifest?: PluginManifest;
+    /** Whether plugin is in strict mode */
+    strict: boolean;
+}
+export interface MarketplaceReadResult {
+    name: string;
+    owner: {
+        name: string;
+        email?: string;
+    };
+    plugins: ResolvedPlugin[];
+    warnings: string[];
+}
+/**
+ * Check whether a local path is a Claude Code marketplace (has .claude-plugin/marketplace.json).
+ */
+export declare function isMarketplace(localPath: string): boolean;
+/**
+ * Read and resolve a marketplace, returning all resolvable plugins with metadata.
+ */
+export declare function readMarketplace(localPath: string): MarketplaceReadResult;

package/dist/marketplace/reader.js

@@ -0,0 +1,90 @@
+/**
+ * Marketplace reader: detects and parses Claude Code marketplace repositories.
+ *
+ * A marketplace is a repository containing `.claude-plugin/marketplace.json`.
+ * Each plugin is either a relative path within the same repo or a standalone
+ * directory with `.claude-plugin/plugin.json`.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { marketplaceManifestSchema, pluginManifestSchema, } from './schemas.js';
+const MARKETPLACE_MANIFEST = '.claude-plugin/marketplace.json';
+const PLUGIN_MANIFEST = '.claude-plugin/plugin.json';
+/**
+ * Check whether a local path is a Claude Code marketplace (has .claude-plugin/marketplace.json).
+ */
+export function isMarketplace(localPath) {
+    const manifestPath = path.join(localPath, MARKETPLACE_MANIFEST);
+    return fs.existsSync(manifestPath);
+}
+/**
+ * Read and resolve a marketplace, returning all resolvable plugins with metadata.
+ */
+export function readMarketplace(localPath) {
+    const manifestPath = path.join(localPath, MARKETPLACE_MANIFEST);
+    const warnings = [];
+    const raw = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+    const manifest = marketplaceManifestSchema.parse(raw);
+    const pluginRoot = manifest.metadata?.pluginRoot ?? '';
+    const plugins = [];
+    for (const entry of manifest.plugins) {
+        const resolved = resolvePluginDir(localPath, pluginRoot, entry.name, entry.source);
+        if (!resolved) {
+            warnings.push(`Plugin "${entry.name}": unsupported source type, skipped`);
+            continue;
+        }
+        if (!fs.existsSync(resolved)) {
+            warnings.push(`Plugin "${entry.name}": directory not found at ${resolved}`);
+            continue;
+        }
+        const pluginManifest = readPluginManifest(resolved);
+        plugins.push({
+            name: entry.name,
+            description: entry.description ?? pluginManifest?.description,
+            version: entry.version ?? pluginManifest?.version,
+            localPath: resolved,
+            manifest: pluginManifest ?? undefined,
+            strict: entry.strict,
+        });
+    }
+    return {
+        name: manifest.name,
+        owner: manifest.owner,
+        plugins,
+        warnings,
+    };
+}
+/**
+ * Resolve a plugin source to a local absolute path.
+ * Only supports relative paths and local `path` sources for MVP.
+ * GitHub/git/npm/pip sources return null with a warning.
+ */
+function resolvePluginDir(marketplaceRoot, pluginRoot, _pluginName, source) {
+    if (typeof source === 'string') {
+        if (source.startsWith('./') || source.startsWith('../') || !source.includes(':')) {
+            return path.resolve(marketplaceRoot, pluginRoot, source);
+        }
+        return null;
+    }
+    if (source.path && typeof source.path === 'string') {
+        return path.resolve(marketplaceRoot, pluginRoot, source.path);
+    }
+    // npm, pip, github, git sources are not supported in MVP
+    return null;
+}
+/**
+ * Read optional `.claude-plugin/plugin.json` from a plugin directory.
+ */
+function readPluginManifest(pluginDir) {
+    const manifestPath = path.join(pluginDir, PLUGIN_MANIFEST);
+    if (!fs.existsSync(manifestPath))
+        return null;
+    try {
+        const raw = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+        return pluginManifestSchema.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=reader.js.map

package/dist/marketplace/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../src/marketplace/reader.ts"],"names":[],"mappings":"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"}