synapsexcoder 6.0.0

package/dist/docs/site-builder.js

@@ -0,0 +1,229 @@
+/**
+ * Documentation Site Builder
+ *
+ * Builds a complete static documentation site from markdown files.
+ * Processes source docs, generates HTML pages, builds navigation,
+ * creates search index, and outputs to a build directory.
+ *
+ * @module docs/site-builder
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, statSync } from "fs";
+import { join, relative, sep } from "path";
+import { DocGenerator } from "./doc-generator.js";
+/**
+ * Static documentation site builder.
+ * Reads markdown files, converts to HTML, generates navigation and search index.
+ */
+export class SiteBuilder {
+    options;
+    generator;
+    constructor(options, generator) {
+        this.options = {
+            siteTitle: "SynapseXcoder Documentation",
+            includePatterns: ["**/*.md"],
+            excludePaths: [],
+            includeDrafts: false,
+            ...options,
+        };
+        this.generator = generator ?? new DocGenerator();
+    }
+    /**
+     * Build the documentation site.
+     */
+    build() {
+        const startTime = Date.now();
+        const errors = [];
+        const generatedFiles = [];
+        // Ensure output directory exists
+        if (!existsSync(this.options.outputDir)) {
+            mkdirSync(this.options.outputDir, { recursive: true });
+        }
+        // Discover and process markdown files
+        const markdownFiles = this.discoverFiles();
+        const pages = [];
+        for (const filePath of markdownFiles) {
+            try {
+                const raw = readFileSync(filePath, "utf-8");
+                const slug = this.filePathToSlug(filePath);
+                const page = this.generator.parseMarkdown(slug, raw);
+                if (page.frontmatter.draft && !this.options.includeDrafts) {
+                    continue;
+                }
+                pages.push(page);
+            }
+            catch (err) {
+                errors.push(`Error processing ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // Build navigation
+        const navEntries = this.buildNav(pages);
+        const navHtml = this.generator.renderNav(navEntries, "");
+        // Generate pages
+        for (const page of pages) {
+            try {
+                const title = page.frontmatter.title ?? page.fileName;
+                const pageNav = this.generator.renderNav(navEntries, page.slug);
+                const html = this.generator.wrapInTemplate(title, page.html, pageNav);
+                // Preserve directory structure in output
+                const outputPath = join(this.options.outputDir, `${page.slug}.html`);
+                const outputDir = outputPath.substring(0, outputPath.lastIndexOf(sep));
+                if (!existsSync(outputDir)) {
+                    mkdirSync(outputDir, { recursive: true });
+                }
+                writeFileSync(outputPath, html, "utf-8");
+                generatedFiles.push(outputPath);
+            }
+            catch (err) {
+                errors.push(`Error generating ${page.slug}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // Generate search index
+        try {
+            const searchIndex = this.generator.generateSearchIndex(pages);
+            const indexPath = join(this.options.outputDir, "search-index.json");
+            writeFileSync(indexPath, searchIndex, "utf-8");
+            generatedFiles.push(indexPath);
+        }
+        catch (err) {
+            errors.push(`Error generating search index: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Generate landing page
+        try {
+            this.generateLandingPage(pages, navEntries);
+            generatedFiles.push(join(this.options.outputDir, "index.html"));
+        }
+        catch (err) {
+            errors.push(`Error generating landing page: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return {
+            pageCount: pages.length,
+            outputDir: this.options.outputDir,
+            generatedFiles,
+            durationMs: Date.now() - startTime,
+            errors,
+        };
+    }
+    /**
+     * Set a custom DocGenerator (for testing).
+     */
+    setGenerator(generator) {
+        this.generator = generator;
+    }
+    // ── File Discovery ──
+    discoverFiles() {
+        const results = [];
+        const excludeSet = new Set(this.options.excludePaths ?? []);
+        const walkDir = (dir) => {
+            let entries;
+            try {
+                entries = readdirSync(dir);
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                const fullPath = join(dir, entry);
+                const relPath = relative(this.options.sourceDir, fullPath);
+                // Check exclusion
+                if (excludeSet.has(relPath) || excludeSet.has(entry)) {
+                    continue;
+                }
+                try {
+                    const stats = statSync(fullPath);
+                    if (stats.isDirectory()) {
+                        walkDir(fullPath);
+                    }
+                    else if (stats.isFile() && entry.endsWith(".md")) {
+                        results.push(fullPath);
+                    }
+                }
+                catch {
+                    // skip inaccessible
+                }
+            }
+        };
+        if (existsSync(this.options.sourceDir)) {
+            walkDir(this.options.sourceDir);
+        }
+        return results;
+    }
+    // ── Slug Generation ──
+    filePathToSlug(filePath) {
+        const rel = relative(this.options.sourceDir, filePath);
+        // Remove .md extension and normalize path separators
+        return rel.replace(/\.md$/i, "").replace(/\\/g, "/");
+    }
+    // ── Navigation Builder ──
+    buildNav(pages) {
+        const navMap = new Map();
+        for (const page of pages) {
+            if (page.frontmatter.draft && !this.options.includeDrafts)
+                continue;
+            const title = page.frontmatter.title ?? page.fileName;
+            navMap.set(page.slug, {
+                title,
+                slug: page.slug,
+                category: page.frontmatter.category,
+                order: page.frontmatter.order ?? 999,
+            });
+        }
+        return [...navMap.values()].sort((a, b) => {
+            // Sort by category then order
+            if (a.category !== b.category) {
+                if (!a.category)
+                    return 1;
+                if (!b.category)
+                    return -1;
+                return a.category.localeCompare(b.category);
+            }
+            return a.order - b.order;
+        });
+    }
+    // ── Landing Page ──
+    generateLandingPage(pages, navEntries) {
+        const categories = new Map();
+        const uncategorized = [];
+        for (const page of pages) {
+            if (page.frontmatter.draft)
+                continue;
+            if (page.frontmatter.category) {
+                const list = categories.get(page.frontmatter.category) ?? [];
+                list.push(page);
+                categories.set(page.frontmatter.category, list);
+            }
+            else {
+                uncategorized.push(page);
+            }
+        }
+        const parts = [
+            `<h1>${this.options.siteTitle}</h1>`,
+            "<p>Welcome to the SynapseXcoder documentation site.</p>",
+        ];
+        if (uncategorized.length > 0) {
+            parts.push("<h2>Pages</h2><ul>");
+            for (const page of uncategorized.sort((a, b) => (a.frontmatter.order ?? 999) - (b.frontmatter.order ?? 999))) {
+                const desc = page.frontmatter.description
+                    ? ` — ${page.frontmatter.description}`
+                    : "";
+                parts.push(`<li><a href="${page.slug}.html">${page.frontmatter.title ?? page.fileName}</a>${desc}</li>`);
+            }
+            parts.push("</ul>");
+        }
+        for (const [category, catPages] of categories) {
+            parts.push(`<h2>${category}</h2><ul>`);
+            for (const page of catPages.sort((a, b) => (a.frontmatter.order ?? 999) - (b.frontmatter.order ?? 999))) {
+                const desc = page.frontmatter.description
+                    ? ` — ${page.frontmatter.description}`
+                    : "";
+                parts.push(`<li><a href="${page.slug}.html">${page.frontmatter.title ?? page.fileName}</a>${desc}</li>`);
+            }
+            parts.push("</ul>");
+        }
+        parts.push(`<p>Total: ${pages.length} pages — <a href="search-index.json">Search Index</a></p>`);
+        const content = parts.join("\n");
+        const nav = this.generator.renderNav(navEntries, "index");
+        const html = this.generator.wrapInTemplate(this.options.siteTitle, content, nav);
+        writeFileSync(join(this.options.outputDir, "index.html"), html, "utf-8");
+    }
+}
+//# sourceMappingURL=site-builder.js.map

package/dist/docs/site-builder.js.map

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

package/dist/ecosystem/adapters/claude-adapter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Claude Ecosystem Adapter
+ *
+ * Maps operations to Anthropic Claude's tool ecosystem:
+ * - text_editor_20250124 (file view/str_replace/insert/create)
+ * - computer_20250124 (GUI automation, screenshots)
+ * - Custom function calling for search/execution
+ *
+ * 5 Laws of Elegant Defense:
+ * - Computer use is gated behind availability check
+ * - Tool mapping reflects Claude's actual API capabilities
+ */
+import type { EcosystemAdapter, EcosystemCapabilities, EcosystemToolMap, RouteRequest, RouteResponse } from "../ecosystem-types.js";
+export declare class ClaudeAdapter implements EcosystemAdapter {
+    readonly id: "claude";
+    readonly name = "Claude (Anthropic)";
+    readonly capabilities: EcosystemCapabilities;
+    readonly toolMap: EcosystemToolMap;
+    private computerUseEnabled;
+    constructor(opts?: {
+        computerUseEnabled?: boolean;
+    });
+    isAvailable(): boolean;
+    resolveTool(operation: string): string | null;
+    route(request: RouteRequest): Promise<RouteResponse>;
+    getConfigurationHelp(): string[];
+    private generateClaudeInstructions;
+}
+//# sourceMappingURL=claude-adapter.d.ts.map

package/dist/ecosystem/adapters/claude-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-adapter.d.ts","sourceRoot":"","sources":["../../../src/ecosystem/adapters/claude-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,MAAM,uBAAuB,CAAC;AA+B/B,qBAAa,aAAc,YAAW,gBAAgB;IACpD,QAAQ,CAAC,EAAE,EAAG,QAAQ,CAAU;IAChC,QAAQ,CAAC,IAAI,wBAAwB;IACrC,QAAQ,CAAC,YAAY,wBAAgB;IACrC,QAAQ,CAAC,OAAO,mBAAY;IAE5B,OAAO,CAAC,kBAAkB,CAAS;gBAEvB,IAAI,CAAC,EAAE;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE;IAInD,WAAW,IAAI,OAAO;IAMtB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAiBvC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA4B1D,oBAAoB,IAAI,MAAM,EAAE;IAiBhC,OAAO,CAAC,0BAA0B;CAanC"}

package/dist/ecosystem/adapters/claude-adapter.js

@@ -0,0 +1,116 @@
+/**
+ * Claude Ecosystem Adapter
+ *
+ * Maps operations to Anthropic Claude's tool ecosystem:
+ * - text_editor_20250124 (file view/str_replace/insert/create)
+ * - computer_20250124 (GUI automation, screenshots)
+ * - Custom function calling for search/execution
+ *
+ * 5 Laws of Elegant Defense:
+ * - Computer use is gated behind availability check
+ * - Tool mapping reflects Claude's actual API capabilities
+ */
+const CAPABILITIES = {
+    webSearch: false,
+    codeExecution: false,
+    fileRead: true,
+    fileWrite: true,
+    codebaseSearch: false,
+    grepSearch: false,
+    imageAnalysis: true,
+    terminalAccess: false,
+    uiGeneration: false,
+    toolOrchestration: true,
+    semanticSearch: false,
+    browserAutomation: true,
+};
+const TOOL_MAP = {
+    webSearch: "tool_use",
+    fetchUrl: "tool_use",
+    readFile: "text_editor_20250124",
+    writeFile: "text_editor_20250124",
+    listDir: "tool_use",
+    grepSearch: "tool_use",
+    semanticSearch: "tool_use",
+    executeCode: "computer_20250124",
+    terminalExec: "computer_20250124",
+    imageAnalysis: "computer_20250124",
+    fileEdit: "text_editor_20250124",
+};
+export class ClaudeAdapter {
+    id = "claude";
+    name = "Claude (Anthropic)";
+    capabilities = CAPABILITIES;
+    toolMap = TOOL_MAP;
+    computerUseEnabled = false;
+    constructor(opts) {
+        this.computerUseEnabled = opts?.computerUseEnabled ?? false;
+    }
+    isAvailable() {
+        // Claude is available if the API key is configured
+        // For stand-alone mode, return true (routing layer checks config)
+        return true;
+    }
+    resolveTool(operation) {
+        const toolKey = Object.keys(TOOL_MAP).find((key) => key.toLowerCase() === operation.toLowerCase());
+        if (!toolKey)
+            return null;
+        const resolved = TOOL_MAP[toolKey];
+        // Computer use tools require the flag to be enabled
+        if (resolved === "computer_20250124" && !this.computerUseEnabled) {
+            return null;
+        }
+        return resolved;
+    }
+    async route(request) {
+        const tool = this.resolveTool(request.preferredTool ?? "fileEdit");
+        if (!tool) {
+            return {
+                success: false,
+                data: null,
+                handledBy: "claude",
+                toolUsed: request.preferredTool ?? "unknown",
+                durationMs: 0,
+                error: "Requested tool is not supported or computer use is disabled",
+            };
+        }
+        return {
+            success: true,
+            data: {
+                ecosystem: "claude",
+                tool,
+                prompt: request.prompt,
+                instructions: this.generateClaudeInstructions(request.prompt, tool),
+            },
+            handledBy: "claude",
+            toolUsed: tool,
+            durationMs: 0,
+        };
+    }
+    getConfigurationHelp() {
+        const help = [
+            "Set ANTHROPIC_API_KEY environment variable for API access",
+            "Use anthropic_version header for API versioning",
+            "Tool calls are wrapped in tool_use content blocks with unique IDs",
+            "text_editor_20250124 replaces legacy str_replace_20241022",
+        ];
+        if (!this.computerUseEnabled) {
+            help.push("Computer use (computer_20250124) is DISABLED — enable via constructor option");
+        }
+        return help;
+    }
+    generateClaudeInstructions(prompt, tool) {
+        return [
+            `Execute using Claude Anthropic Messages API`,
+            `Tool: ${tool}`,
+            ``,
+            `Prompt: ${prompt}`,
+            ``,
+            `API Format:`,
+            `- Tool calls wrapped in {"type": "tool_use", "name": "${tool}", "input": {…}}`,
+            `- text_editor commands: view, str_replace, insert, create`,
+            `- Screenshot before GUI interaction when using computer_20250124`,
+        ].join("\n");
+    }
+}
+//# sourceMappingURL=claude-adapter.js.map

package/dist/ecosystem/adapters/claude-adapter.js.map

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

package/dist/ecosystem/adapters/cursor-adapter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Cursor Ecosystem Adapter
+ *
+ * Maps operations to Cursor IDE's tool ecosystem:
+ * - codebase_search (semantic)
+ * - grep_search (exact patterns)
+ * - read_file / edit_file / search_replace (file ops)
+ * - run_terminal_cmd (execution)
+ * - create_diagram (visualization)
+ *
+ * 5 Laws of Elegant Defense:
+ * - Tool resolution falls back gracefully for unknown operations
+ * - Capability profile reflects Cursor's actual strengths
+ */
+import type { EcosystemAdapter, EcosystemCapabilities, EcosystemToolMap, RouteRequest, RouteResponse } from "../ecosystem-types.js";
+export declare class CursorAdapter implements EcosystemAdapter {
+    readonly id: "cursor";
+    readonly name = "Cursor IDE";
+    readonly capabilities: EcosystemCapabilities;
+    readonly toolMap: EcosystemToolMap;
+    isAvailable(): boolean;
+    resolveTool(operation: string): string | null;
+    route(request: RouteRequest): Promise<RouteResponse>;
+    getConfigurationHelp(): string[];
+    private generateCursorInstructions;
+}
+//# sourceMappingURL=cursor-adapter.d.ts.map

package/dist/ecosystem/adapters/cursor-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-adapter.d.ts","sourceRoot":"","sources":["../../../src/ecosystem/adapters/cursor-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,MAAM,uBAAuB,CAAC;AA+B/B,qBAAa,aAAc,YAAW,gBAAgB;IACpD,QAAQ,CAAC,EAAE,EAAG,QAAQ,CAAU;IAChC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,YAAY,wBAAgB;IACrC,QAAQ,CAAC,OAAO,mBAAY;IAE5B,WAAW,IAAI,OAAO;IAKtB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOvC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAkB1D,oBAAoB,IAAI,MAAM,EAAE;IAQhC,OAAO,CAAC,0BAA0B;CAcnC"}

package/dist/ecosystem/adapters/cursor-adapter.js

@@ -0,0 +1,93 @@
+/**
+ * Cursor Ecosystem Adapter
+ *
+ * Maps operations to Cursor IDE's tool ecosystem:
+ * - codebase_search (semantic)
+ * - grep_search (exact patterns)
+ * - read_file / edit_file / search_replace (file ops)
+ * - run_terminal_cmd (execution)
+ * - create_diagram (visualization)
+ *
+ * 5 Laws of Elegant Defense:
+ * - Tool resolution falls back gracefully for unknown operations
+ * - Capability profile reflects Cursor's actual strengths
+ */
+const CAPABILITIES = {
+    webSearch: true,
+    codeExecution: false,
+    fileRead: true,
+    fileWrite: true,
+    codebaseSearch: true,
+    grepSearch: true,
+    imageAnalysis: false,
+    terminalAccess: true,
+    uiGeneration: false,
+    toolOrchestration: true,
+    semanticSearch: true,
+    browserAutomation: false,
+};
+const TOOL_MAP = {
+    webSearch: "web_search",
+    fetchUrl: "web_search",
+    readFile: "read_file",
+    writeFile: "edit_file",
+    listDir: "list_dir",
+    grepSearch: "grep_search",
+    semanticSearch: "codebase_search",
+    executeCode: "run_terminal_cmd",
+    terminalExec: "run_terminal_cmd",
+    imageAnalysis: "view_image",
+    fileEdit: "edit_file",
+};
+export class CursorAdapter {
+    id = "cursor";
+    name = "Cursor IDE";
+    capabilities = CAPABILITIES;
+    toolMap = TOOL_MAP;
+    isAvailable() {
+        // Cursor is always available as an IDE environment
+        return true;
+    }
+    resolveTool(operation) {
+        const toolKey = Object.keys(TOOL_MAP).find((key) => key.toLowerCase() === operation.toLowerCase());
+        return toolKey ? TOOL_MAP[toolKey] : null;
+    }
+    async route(request) {
+        const tool = this.resolveTool(request.preferredTool ?? "fileEdit");
+        // Simulate routing — in production, this would invoke Cursor-native tools
+        return {
+            success: true,
+            data: {
+                ecosystem: "cursor",
+                tool,
+                prompt: request.prompt,
+                instructions: this.generateCursorInstructions(request.prompt, tool ?? "read_file"),
+            },
+            handledBy: "cursor",
+            toolUsed: tool ?? "read_file",
+            durationMs: 0,
+        };
+    }
+    getConfigurationHelp() {
+        return [
+            "Cursor IDE is auto-detected — no additional configuration needed",
+            "Ensure Cursor agent mode is enabled for tool orchestration",
+            "Use 'explanation' parameter for better traceability",
+        ];
+    }
+    generateCursorInstructions(prompt, tool) {
+        const commandPrefix = prompt.startsWith("/") ? "" : "/";
+        return [
+            `Execute in Cursor using tool: ${tool}`,
+            ``,
+            `Prompt: ${commandPrefix}${prompt}`,
+            ``,
+            `Available Cursor tools for this operation:`,
+            `- codebase_search (semantic lookup)`,
+            `- grep_search (exact pattern matching)`,
+            `- run_terminal_cmd (terminal execution)`,
+            `- edit_file / search_replace (file editing)`,
+        ].join("\n");
+    }
+}
+//# sourceMappingURL=cursor-adapter.js.map

package/dist/ecosystem/adapters/cursor-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-adapter.js","sourceRoot":"","sources":["../../../src/ecosystem/adapters/cursor-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,MAAM,YAAY,GAA0B;IAC1C,SAAS,EAAE,IAAI;IACf,aAAa,EAAE,KAAK;IACpB,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,IAAI;IACf,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,IAAI;IACpB,YAAY,EAAE,KAAK;IACnB,iBAAiB,EAAE,IAAI;IACvB,cAAc,EAAE,IAAI;IACpB,iBAAiB,EAAE,KAAK;CACzB,CAAC;AAEF,MAAM,QAAQ,GAAqB;IACjC,SAAS,EAAE,YAAY;IACvB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,WAAW;IACrB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,aAAa;IACzB,cAAc,EAAE,iBAAiB;IACjC,WAAW,EAAE,kBAAkB;IAC/B,YAAY,EAAE,kBAAkB;IAChC,aAAa,EAAE,YAAY;IAC3B,QAAQ,EAAE,WAAW;CACtB,CAAC;AAEF,MAAM,OAAO,aAAa;IACf,EAAE,GAAG,QAAiB,CAAC;IACvB,IAAI,GAAG,YAAY,CAAC;IACpB,YAAY,GAAG,YAAY,CAAC;IAC5B,OAAO,GAAG,QAAQ,CAAC;IAE5B,WAAW;QACT,mDAAmD;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW,CAAC,SAAiB;QAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CACxC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CACvD,CAAC;QACF,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAiC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAqB;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,aAAa,IAAI,UAAU,CAAC,CAAC;QAEnE,0EAA0E;QAC1E,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE;gBACJ,SAAS,EAAE,QAAQ;gBACnB,IAAI;gBACJ,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,YAAY,EAAE,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,IAAI,WAAW,CAAC;aACnF;YACD,SAAS,EAAE,QAAQ;YACnB,QAAQ,EAAE,IAAI,IAAI,WAAW;YAC7B,UAAU,EAAE,CAAC;SACd,CAAC;IACJ,CAAC;IAED,oBAAoB;QAClB,OAAO;YACL,kEAAkE;YAClE,4DAA4D;YAC5D,qDAAqD;SACtD,CAAC;IACJ,CAAC;IAEO,0BAA0B,CAAC,MAAc,EAAE,IAAY;QAC7D,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACxD,OAAO;YACL,iCAAiC,IAAI,EAAE;YACvC,EAAE;YACF,WAAW,aAAa,GAAG,MAAM,EAAE;YACnC,EAAE;YACF,4CAA4C;YAC5C,qCAAqC;YACrC,wCAAwC;YACxC,yCAAyC;YACzC,6CAA6C;SAC9C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;CACF"}

package/dist/ecosystem/adapters/v0-adapter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * v0 Ecosystem Adapter
+ *
+ * Maps operations to Vercel v0's tool ecosystem:
+ * - SearchWeb / FetchFromWeb (web)
+ * - ReadFile / SearchRepo / GrepRepo / LSRepo (codebase)
+ * - GetOrRequestIntegration / TodoManager (integrations)
+ * - GenerateDesignInspiration / InspectSite (design)
+ *
+ * 5 Laws of Elegant Defense:
+ * - Structured output with required task tracking headers
+ * - CodeProject compatibility notes in routing instructions
+ */
+import type { EcosystemAdapter, EcosystemCapabilities, EcosystemToolMap, RouteRequest, RouteResponse } from "../ecosystem-types.js";
+export declare class V0Adapter implements EcosystemAdapter {
+    readonly id: "v0";
+    readonly name = "v0 (Vercel)";
+    readonly capabilities: EcosystemCapabilities;
+    readonly toolMap: EcosystemToolMap;
+    private isFirstParty;
+    constructor(opts?: {
+        isFirstParty?: boolean;
+    });
+    isAvailable(): boolean;
+    resolveTool(operation: string): string | null;
+    route(request: RouteRequest): Promise<RouteResponse>;
+    getConfigurationHelp(): string[];
+    generateV0Instructions(prompt: string, tool: string): string;
+}
+//# sourceMappingURL=v0-adapter.d.ts.map

package/dist/ecosystem/adapters/v0-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v0-adapter.d.ts","sourceRoot":"","sources":["../../../src/ecosystem/adapters/v0-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,MAAM,uBAAuB,CAAC;AA+B/B,qBAAa,SAAU,YAAW,gBAAgB;IAChD,QAAQ,CAAC,EAAE,EAAG,IAAI,CAAU;IAC5B,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,YAAY,wBAAgB;IACrC,QAAQ,CAAC,OAAO,mBAAY;IAE5B,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE;IAI7C,WAAW,IAAI,OAAO;IAKtB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOvC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAwB1D,oBAAoB,IAAI,MAAM,EAAE;IAgBhC,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;CA0B7D"}