@vibesdotdev/external 0.0.0-stage → 1.0.0-rc.0

package/dist/detection/config-document.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Read a host's config file by the format its manifest declares.
+ *
+ * Codex and Grok keep `config.toml`; Claude, Cursor and most editors keep
+ * JSON or JSONC. Detection reads each with its own parser, so a valid TOML
+ * file is never mistaken for malformed JSON (and reported absent). A file
+ * that does not parse is refused `INVALID_INPUT` `host-config-invalid`,
+ * carrying the path and format but never the file's text. A YAML config is
+ * refused `UNAVAILABLE` `host-config-format-unsupported`: External declares
+ * no YAML parser.
+ */
+import { ownValue, type ConfigObject, type ConfigValue } from '../plugins/installers/config-value.ts';
+import type { ConfigFormat } from './types.ts';
+/** One value in a parsed host config (JSON or TOML): the installers' config value contract. */
+export type ConfigNode = ConfigValue;
+/** A table (object) in a parsed host config. */
+export type ConfigTable = ConfigObject;
+/** A parsed host config: a JSON object or a TOML table. */
+export type HostConfigDocument = ConfigTable;
+/** `node` when it is a table (an object that is not an array), else `undefined`. */
+export declare function configTable(node: ConfigNode | undefined): ConfigTable | undefined;
+/** `table[key]` only when it is the table's own entry. */
+export declare const configEntry: typeof ownValue;
+/**
+ * JSONC to JSON: `//` and `/* *\/` comments outside strings and trailing
+ * commas before `}` or `]` are removed; string contents are kept verbatim.
+ */
+export declare function stripJsonc(text: string): string;
+/** Parse a host config's text by its declared format; see the module comment for refusals. */
+export declare function parseHostConfig(text: string, path: string, format: ConfigFormat): HostConfigDocument;
+//# sourceMappingURL=config-document.d.ts.map

package/dist/detection/config-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-document.d.ts","sourceRoot":"","sources":["../../src/detection/config-document.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAAkB,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACtH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,+FAA+F;AAC/F,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC;AAErC,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC;AAEvC,2DAA2D;AAC3D,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAE7C,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAEjF;AAED,0DAA0D;AAC1D,eAAO,MAAM,WAAW,iBAAW,CAAC;AAWpC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAqED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,kBAAkB,CAuBpG"}

package/dist/detection/config-document.js

@@ -0,0 +1,138 @@
+/**
+ * Read a host's config file by the format its manifest declares.
+ *
+ * Codex and Grok keep `config.toml`; Claude, Cursor and most editors keep
+ * JSON or JSONC. Detection reads each with its own parser, so a valid TOML
+ * file is never mistaken for malformed JSON (and reported absent). A file
+ * that does not parse is refused `INVALID_INPUT` `host-config-invalid`,
+ * carrying the path and format but never the file's text. A YAML config is
+ * refused `UNAVAILABLE` `host-config-format-unsupported`: External declares
+ * no YAML parser.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError, CaughtFailureSchema, isCapabilityError } from '@vibesdotdev/kernel';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { parseTomlDocument } from "../utils/toml.js";
+import { isConfigObject, ownValue } from "../plugins/installers/config-value.js";
+/** A JSON value as a host config holds it. */
+const JsonDocumentSchema = z.record(z.string(), JsonValueSchema);
+/** `node` when it is a table (an object that is not an array), else `undefined`. */
+export function configTable(node) {
+    return isConfigObject(node) ? node : undefined;
+}
+/** `table[key]` only when it is the table's own entry. */
+export const configEntry = ownValue;
+function configRefusal(path, format, line) {
+    return new CapabilityError(`The ${format} config at ${path} does not parse.`, 'INVALID_INPUT', {
+        reason: 'host-config-invalid',
+        retryable: false,
+        recoveryHint: 'Fix or remove the file, then re-run.',
+        details: line === undefined ? { path, format } : { path, format, line }
+    });
+}
+/**
+ * JSONC to JSON: `//` and `/* *\/` comments outside strings and trailing
+ * commas before `}` or `]` are removed; string contents are kept verbatim.
+ */
+export function stripJsonc(text) {
+    return dropTrailingCommas(dropComments(text));
+}
+/** Copy a JSON string literal starting at `index`; returns the index after it. */
+function stringEnd(text, index) {
+    let cursor = index + 1;
+    while (cursor < text.length && text[cursor] !== '"')
+        cursor += text[cursor] === '\\' ? 2 : 1;
+    return cursor + 1;
+}
+function dropComments(text) {
+    let out = '';
+    let index = 0;
+    while (index < text.length) {
+        const char = text[index] ?? '';
+        if (char === '"') {
+            const end = stringEnd(text, index);
+            out += text.slice(index, end);
+            index = end;
+        }
+        else if (char === '/' && text[index + 1] === '/') {
+            while (index < text.length && text[index] !== '\n')
+                index += 1;
+        }
+        else if (char === '/' && text[index + 1] === '*') {
+            const end = text.indexOf('*/', index + 2);
+            index = end < 0 ? text.length : end + 2;
+        }
+        else {
+            out += char;
+            index += 1;
+        }
+    }
+    return out;
+}
+function dropTrailingCommas(text) {
+    let out = '';
+    let index = 0;
+    while (index < text.length) {
+        const char = text[index] ?? '';
+        if (char === '"') {
+            const end = stringEnd(text, index);
+            out += text.slice(index, end);
+            index = end;
+            continue;
+        }
+        if (char === ',') {
+            let next = index + 1;
+            while (/\s/.test(text[next] ?? ''))
+                next += 1;
+            if (text[next] === '}' || text[next] === ']') {
+                index += 1;
+                continue;
+            }
+        }
+        out += char;
+        index += 1;
+    }
+    return out;
+}
+function parseJsonDocument(text, path, format) {
+    let raw;
+    try {
+        raw = JSON.parse(format === 'jsonc' ? stripJsonc(text) : text);
+    }
+    catch (error) {
+        if (CaughtFailureSchema.parse(error) instanceof SyntaxError)
+            throw configRefusal(path, format);
+        throw error;
+    }
+    const parsed = JsonDocumentSchema.safeParse(raw);
+    if (!parsed.success)
+        throw configRefusal(path, format);
+    return parsed.data;
+}
+/** Parse a host config's text by its declared format; see the module comment for refusals. */
+export function parseHostConfig(text, path, format) {
+    switch (format) {
+        case 'json':
+        case 'jsonc':
+            return parseJsonDocument(text, path, format);
+        case 'toml':
+            try {
+                return parseTomlDocument(text);
+            }
+            catch (error) {
+                const failure = CaughtFailureSchema.parse(error);
+                if (failure instanceof Error && isCapabilityError(failure) && failure.reason === 'toml-invalid') {
+                    const line = z.object({ line: z.number() }).safeParse(failure.details);
+                    throw configRefusal(path, format, line.success ? line.data.line : undefined);
+                }
+                throw error;
+            }
+        case 'yaml':
+            throw new CapabilityError(`The yaml config at ${path} cannot be read: External declares no YAML parser.`, 'UNAVAILABLE', {
+                reason: 'host-config-format-unsupported',
+                retryable: false,
+                details: { path, format }
+            });
+    }
+}
+//# sourceMappingURL=config-document.js.map

package/dist/detection/config-document.js.map

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

package/dist/detection/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Agent Detection Module
+ *
+ * Provides detection capabilities for AI coding assistants.
+ */
+export type { AgentId, AgentCategory, McpTransport, ConfigFormat, AgentMetadata, AgentInstallation, AgentMcpState, AgentDetectionResult, AgentDetector, DetectionSummary } from './types.ts';
+export { agentIdSchema, agentCategorySchema, mcpTransportSchema, configFormatSchema } from './types.ts';
+export { BaseAgentDetector } from './base.ts';
+export { detectInstallationFromManifest } from './manifest-detector-helpers.ts';
+export { detectFromRegistry, detectFromRuntime, detectMcpFromRegistry, detectToolFromRegistry, getUnconfiguredFromRegistry, getAvailableManifests, getMcpCapableManifests, getAvailableManifestsFromRuntime, getMcpCapableManifestsFromRuntime, createDetectorFromManifest, type ManifestBasedDetector, type RegistryDetectionResult, type RegistryDetectionSummary } from './service.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/detection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/detection/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACX,OAAO,EACP,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAGhF,OAAO,EACN,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,gCAAgC,EAChC,iCAAiC,EACjC,0BAA0B,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,MAAM,cAAc,CAAC"}

package/dist/detection/index.js

@@ -0,0 +1,13 @@
+/**
+ * Agent Detection Module
+ *
+ * Provides detection capabilities for AI coding assistants.
+ */
+export { agentIdSchema, agentCategorySchema, mcpTransportSchema, configFormatSchema } from "./types.js";
+// Base class
+export { BaseAgentDetector } from "./base.js";
+// Manifest-driven installation probe shared by detectors and MCP state.
+export { detectInstallationFromManifest } from "./manifest-detector-helpers.js";
+// Service (runtime-backed detection only)
+export { detectFromRegistry, detectFromRuntime, detectMcpFromRegistry, detectToolFromRegistry, getUnconfiguredFromRegistry, getAvailableManifests, getMcpCapableManifests, getAvailableManifestsFromRuntime, getMcpCapableManifestsFromRuntime, createDetectorFromManifest } from "./service.js";
+//# sourceMappingURL=index.js.map

package/dist/detection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/detection/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,MAAM,YAAY,CAAC;AAEpB,aAAa;AACb,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,wEAAwE;AACxE,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAEhF,0CAA0C;AAC1C,OAAO,EACN,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,gCAAgC,EAChC,iCAAiC,EACjC,0BAA0B,EAI1B,MAAM,cAAc,CAAC"}

package/dist/detection/manifest-detector-helpers.d.ts

@@ -0,0 +1,45 @@
+import { type ValueFreeFailure } from '@vibesdotdev/kernel';
+import type { AgentCategory, AgentInstallation, ConfigFormat } from './types.ts';
+import { type ConfigTable, type HostConfigDocument } from './config-document.ts';
+import type { ExternalHostManifest, ToolCategory } from '../plugins/schemas/manifest.ts';
+import { type PathTemplateRoots } from '../external-tool/path-template.ts';
+export declare function resolveManifestPath(template: string, roots: PathTemplateRoots): string;
+export declare function mapCategory(category: ToolCategory): AgentCategory;
+export declare function getPrimaryConfigFormat(manifest: ExternalHostManifest): ConfigFormat;
+/**
+ * The manifest's config path for a scope: the platform's entry, else the
+ * scope's, else the first; `undefined` when the manifest declares no config.
+ */
+export declare function findConfigPathFromManifest(manifest: ExternalHostManifest, global: boolean, roots: PathTemplateRoots): string | undefined;
+/**
+ * {@link findConfigPathFromManifest}, refused `NOT_FOUND` `host-config-undeclared`
+ * when the manifest declares no config.
+ */
+export declare function getConfigPathFromManifest(manifest: ExternalHostManifest, global: boolean, roots: PathTemplateRoots): string;
+/** Whether a config names our MCP server, and that server's entry when it is a table. */
+export interface McpServerLookup {
+    readonly configured: boolean;
+    readonly serverConfig: ConfigTable | undefined;
+}
+/**
+ * Find `serverName` under a config's MCP-servers section. `mcpPath` is a
+ * literal key (VS Code's `"cline.mcpServers"`), else a dotted path whose
+ * `name[]` segment searches an array for the entry named `serverName`.
+ * A servers map without our server is NOT configured.
+ */
+export declare function checkMcpServerConfigAtPath(config: HostConfigDocument | null, mcpPath: string, serverName?: string): McpServerLookup;
+/**
+ * Installation detection resolves global (home-rooted) manifest paths only:
+ * `roots` are the host's home-side template roots, handed in.
+ */
+export declare function detectInstallationFromManifest(manifest: ExternalHostManifest, helpers: {
+    commandExists(command: string): Promise<boolean>;
+    getCommandPath(command: string): Promise<string | undefined>;
+    getCommandVersion(command: string, versionFlag?: string): Promise<string | undefined>;
+    /** What the command prints for these arguments, run as an argv array; `undefined` when unknown. */
+    getCommandOutput(command: string, args: readonly string[]): Promise<string | undefined>;
+    reportProbeFailure?(message: string, failure: ValueFreeFailure): void;
+    fileExists(path: string): Promise<boolean>;
+    listDir?(path: string): Promise<string[]>;
+}, roots: Omit<PathTemplateRoots, 'projectDir'>): Promise<AgentInstallation>;
+//# sourceMappingURL=manifest-detector-helpers.d.ts.map

package/dist/detection/manifest-detector-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-detector-helpers.d.ts","sourceRoot":"","sources":["../../src/detection/manifest-detector-helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAA0D,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACpH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAA6C,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC5H,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAGhG,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAEtF;AACD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,aAAa,CAWjE;AACD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,YAAY,CAGnF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,iBAAiB,GACtB,MAAM,GAAG,SAAS,CASpB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,iBAAiB,GACtB,MAAM,CAOR;AAED,yFAAyF;AACzF,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC;CAC/C;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,kBAAkB,GAAG,IAAI,EACjC,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,MAAgB,GAC1B,eAAe,CAqBjB;AAOD;;;GAGG;AACH,wBAAsB,8BAA8B,CACnD,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE;IACR,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7D,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtF,mGAAmG;IACnG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACxF,kBAAkB,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACtE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1C,EACD,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,GAC1C,OAAO,CAAC,iBAAiB,CAAC,CA2E5B"}

package/dist/detection/manifest-detector-helpers.js

@@ -0,0 +1,198 @@
+import { join } from '@vibesdotdev/filesystem';
+import { CapabilityError, CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import { configEntry, configTable } from "./config-document.js";
+import { resolvePathTemplate } from "../external-tool/path-template.js";
+export function resolveManifestPath(template, roots) {
+    return resolvePathTemplate(template, roots);
+}
+export function mapCategory(category) {
+    switch (category) {
+        case 'cli':
+            return 'cli';
+        case 'ide-extension':
+            return 'ide-extension';
+        case 'ide-native':
+            return 'ide-native';
+        default:
+            return 'cli';
+    }
+}
+export function getPrimaryConfigFormat(manifest) {
+    const globalConfig = manifest.configs.find((c) => c.scope === 'global');
+    return globalConfig?.format ?? 'json';
+}
+/**
+ * The manifest's config path for a scope: the platform's entry, else the
+ * scope's, else the first; `undefined` when the manifest declares no config.
+ */
+export function findConfigPathFromManifest(manifest, global, roots) {
+    const scope = global ? 'global' : 'project';
+    const platform = roots.platform;
+    const configDef = manifest.configs.find((c) => c.scope === scope && (!c.platform || c.platform === 'all' || c.platform === platform));
+    const fallback = configDef ?? manifest.configs.find((c) => c.scope === scope) ?? manifest.configs[0];
+    return fallback ? resolveManifestPath(fallback.path, roots) : undefined;
+}
+/**
+ * {@link findConfigPathFromManifest}, refused `NOT_FOUND` `host-config-undeclared`
+ * when the manifest declares no config.
+ */
+export function getConfigPathFromManifest(manifest, global, roots) {
+    const path = findConfigPathFromManifest(manifest, global, roots);
+    if (path !== undefined)
+        return path;
+    throw new CapabilityError('The external host declares no config file.', 'NOT_FOUND', {
+        reason: 'host-config-undeclared',
+        retryable: false
+    });
+}
+/**
+ * Find `serverName` under a config's MCP-servers section. `mcpPath` is a
+ * literal key (VS Code's `"cline.mcpServers"`), else a dotted path whose
+ * `name[]` segment searches an array for the entry named `serverName`.
+ * A servers map without our server is NOT configured.
+ */
+export function checkMcpServerConfigAtPath(config, mcpPath, serverName = 'vibes') {
+    const absent = { configured: false, serverConfig: undefined };
+    if (!config)
+        return absent;
+    const literal = configTable(configEntry(config, mcpPath));
+    if (literal)
+        return serverIn(literal, serverName);
+    let current = config;
+    for (const part of mcpPath.split('.')) {
+        const table = configTable(current);
+        if (!table)
+            return absent;
+        if (part.endsWith('[]')) {
+            const entries = configEntry(table, part.slice(0, -2));
+            if (!Array.isArray(entries))
+                return absent;
+            const match = entries.map(configTable).find((entry) => entry !== undefined && configEntry(entry, 'name') === serverName);
+            return match ? { configured: true, serverConfig: match } : absent;
+        }
+        current = configEntry(table, part);
+    }
+    const servers = configTable(current);
+    return servers ? serverIn(servers, serverName) : absent;
+}
+function serverIn(servers, serverName) {
+    if (!Object.hasOwn(servers, serverName))
+        return { configured: false, serverConfig: undefined };
+    return { configured: true, serverConfig: configTable(servers[serverName]) };
+}
+/**
+ * Installation detection resolves global (home-rooted) manifest paths only:
+ * `roots` are the host's home-side template roots, handed in.
+ */
+export async function detectInstallationFromManifest(manifest, helpers, roots) {
+    const detection = manifest.detection;
+    const globalRoots = {
+        platform: roots.platform,
+        userHome: roots.userHome,
+        configHome: roots.configHome,
+        appData: roots.appData
+    };
+    if (detection.command) {
+        const exists = await helpers.commandExists(detection.command);
+        if (exists)
+            return buildInstallResultFromCommand(manifest, detection.command, helpers, globalRoots);
+        if (detection.altCommands) {
+            for (const alt of detection.altCommands) {
+                const altExists = await helpers.commandExists(alt);
+                if (altExists)
+                    return buildInstallResultFromCommand(manifest, alt, helpers, globalRoots);
+            }
+        }
+    }
+    // Platform-keyed GUI-app detection (e.g. Windsurf: no CLI, a per-OS app path).
+    const platformPath = detection.platformPaths?.[roots.platform];
+    if (platformPath?.binaryPath) {
+        const binaryPath = resolveManifestPath(platformPath.binaryPath, globalRoots);
+        if (await helpers.fileExists(binaryPath)) {
+            const configDir = platformPath.configDir
+                ? resolveManifestPath(platformPath.configDir, globalRoots)
+                : undefined;
+            return {
+                installed: true,
+                installPath: binaryPath,
+                configPath: configDir && (await helpers.fileExists(configDir))
+                    ? configDir
+                    : findConfigPathFromManifest(manifest, true, globalRoots)
+            };
+        }
+    }
+    // Editor-extension detection (e.g. Cline: a VS Code extension folder by prefix).
+    if (detection.extensionMatch && helpers.listDir) {
+        const dir = resolveManifestPath(detection.extensionMatch.dir, globalRoots);
+        const entries = await helpers.listDir(dir);
+        const match = entries.find((e) => detection.extensionMatch.prefixes.some((prefix) => e.startsWith(prefix)));
+        if (match) {
+            return {
+                installed: true,
+                installPath: join(dir, match),
+                configPath: findConfigPathFromManifest(manifest, true, globalRoots)
+            };
+        }
+    }
+    if (detection.configDir) {
+        const configPath = resolveManifestPath(detection.configDir, globalRoots);
+        if (await helpers.fileExists(configPath)) {
+            return { installed: true, configPath: findConfigPathFromManifest(manifest, true, globalRoots) };
+        }
+    }
+    if (detection.binaryPath) {
+        const binaryPath = resolveManifestPath(detection.binaryPath, globalRoots);
+        if (await helpers.fileExists(binaryPath)) {
+            return {
+                installed: true,
+                installPath: binaryPath,
+                configPath: findConfigPathFromManifest(manifest, true, globalRoots)
+            };
+        }
+    }
+    return { installed: false };
+}
+async function buildInstallResultFromCommand(manifest, command, helpers, roots) {
+    const [version, installPath] = await Promise.all([
+        getVersionFromCommand(manifest, command, helpers),
+        helpers.getCommandPath(command)
+    ]);
+    return {
+        installed: true,
+        version,
+        installPath,
+        configPath: findConfigPathFromManifest(manifest, true, roots)
+    };
+}
+async function getVersionFromCommand(manifest, command, helpers) {
+    const detection = manifest.detection;
+    if (!detection.versionArgs)
+        return helpers.getCommandVersion(command);
+    const stdout = await helpers.getCommandOutput(command, detection.versionArgs);
+    if (stdout === undefined)
+        return undefined;
+    if (!detection.versionRegex)
+        return stdout.trim();
+    const matched = matchVersionPattern(detection.versionRegex, stdout);
+    if ('failed' in matched) {
+        helpers.reportProbeFailure?.('manifest version pattern does not compile', matched.failed);
+        return undefined;
+    }
+    return matched.version;
+}
+/**
+ * Group 1 of a manifest's version pattern over bounded probe output. The
+ * pattern is manifest data: one that does not compile reads as an unknown
+ * version and is logged by its reason only.
+ */
+function matchVersionPattern(pattern, output) {
+    let compiled;
+    try {
+        compiled = new RegExp(pattern);
+    }
+    catch (error) {
+        return { failed: valueFreeFailure(CaughtFailureSchema.parse(error)) };
+    }
+    return { version: output.match(compiled)?.[1] };
+}
+//# sourceMappingURL=manifest-detector-helpers.js.map

package/dist/detection/manifest-detector-helpers.js.map

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

package/dist/detection/manifest-detector.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Manifest-Based Detector
+ *
+ * Creates detectors from external tool manifests, eliminating
+ * the need for separate detector definitions.
+ */
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import { BaseAgentDetector } from './base.ts';
+import type { AgentMetadata, AgentInstallation, AgentMcpState, AgentDetector } from './types.ts';
+import type { ExternalHostManifest } from '../plugins/schemas/manifest.ts';
+import type { PathTemplateRoots } from '../external-tool/path-template.ts';
+/**
+ * Create an AgentDetector from an ExternalHostManifest
+ */
+export declare class ManifestBasedDetector extends BaseAgentDetector implements AgentDetector {
+    readonly metadata: AgentMetadata;
+    private readonly manifest;
+    /** The host's home-side template roots, handed in by the detector's owner. */
+    private readonly homeRoots;
+    constructor(manifest: ExternalHostManifest, roots: Omit<PathTemplateRoots, 'projectDir'>, runtime: RuntimeRef);
+    private buildMetadata;
+    detectInstallation(): Promise<AgentInstallation>;
+    getMcpState(projectDir?: string): Promise<AgentMcpState>;
+    getConfigPath(global: boolean, projectDir?: string): string;
+    /**
+     * Get the manifest this detector was created from
+     */
+    getManifest(): ExternalHostManifest;
+}
+/**
+ * Create a detector from a manifest
+ */
+export declare function createDetectorFromManifest(manifest: ExternalHostManifest, roots: Omit<PathTemplateRoots, 'projectDir'>, runtime: RuntimeRef): ManifestBasedDetector;
+//# sourceMappingURL=manifest-detector.d.ts.map

package/dist/detection/manifest-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-detector.d.ts","sourceRoot":"","sources":["../../src/detection/manifest-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,KAAK,EACX,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAU3E;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,iBAAkB,YAAW,aAAa;IACpF,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;gBAGjE,QAAQ,EAAE,oBAAoB,EAC9B,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,EAC5C,OAAO,EAAE,UAAU;IAapB,OAAO,CAAC,aAAa;IAcrB,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAY1C,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAyE9D,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IAI3D;;OAEG;IACH,WAAW,IAAI,oBAAoB;CAGnC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,oBAAoB,EAC9B,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,EAC5C,OAAO,EAAE,UAAU,GACjB,qBAAqB,CAEvB"}

package/dist/detection/manifest-detector.js

@@ -0,0 +1,123 @@
+/**
+ * Manifest-Based Detector
+ *
+ * Creates detectors from external tool manifests, eliminating
+ * the need for separate detector definitions.
+ */
+import { BaseAgentDetector } from "./base.js";
+import { hasPublishedBearer } from "../plugins/installers/mcp/environment.js";
+import { checkMcpServerConfigAtPath, detectInstallationFromManifest, getConfigPathFromManifest, getPrimaryConfigFormat, mapCategory, resolveManifestPath } from "./manifest-detector-helpers.js";
+/**
+ * Create an AgentDetector from an ExternalHostManifest
+ */
+export class ManifestBasedDetector extends BaseAgentDetector {
+    metadata;
+    manifest;
+    /** The host's home-side template roots, handed in by the detector's owner. */
+    homeRoots;
+    constructor(manifest, roots, runtime) {
+        super(runtime);
+        this.manifest = manifest;
+        this.homeRoots = {
+            platform: roots.platform,
+            userHome: roots.userHome,
+            configHome: roots.configHome,
+            appData: roots.appData
+        };
+        this.metadata = this.buildMetadata();
+    }
+    buildMetadata() {
+        const m = this.manifest;
+        return {
+            id: m.id,
+            name: m.name,
+            description: m.description,
+            category: mapCategory(m.category),
+            website: m.website,
+            supportsMcp: m.mcp.supported,
+            mcpTransports: m.mcp.transports,
+            configFormat: getPrimaryConfigFormat(m)
+        };
+    }
+    detectInstallation() {
+        return detectInstallationFromManifest(this.manifest, {
+            commandExists: (c) => this.commandExists(c),
+            getCommandPath: (c) => this.getCommandPath(c),
+            getCommandVersion: (c, flag) => this.getCommandVersion(c, flag),
+            getCommandOutput: (c, args) => this.getCommandOutput(c, args),
+            reportProbeFailure: (message, failure) => this.reportProbeFailure(message, failure),
+            fileExists: (p) => this.fileExists(p),
+            listDir: (p) => this.listDir(p)
+        }, this.homeRoots);
+    }
+    async getMcpState(projectDir) {
+        if (!this.manifest.mcp.supported) {
+            return {
+                configured: false,
+                hasAuthToken: false
+            };
+        }
+        // Find config with MCP path — platform-filtered, so a multi-platform
+        // manifest (windsurf/cline declare a global config per OS) doesn't read
+        // e.g. the darwin path on Linux. Uses the SAME POSIX→linux normalization as
+        // detectInstallationFromManifest, so detection and MCP-state agree on
+        // non-darwin/non-win32 POSIX (else a tool reads installed-but-unconfigured).
+        const platformKey = this.homeRoots.platform;
+        const matchesPlatform = (c) => !c.platform || c.platform === 'all' || c.platform === platformKey;
+        const globalConfig = this.manifest.configs.find((c) => c.scope === 'global' && c.mcpPath && matchesPlatform(c));
+        const projectConfig = this.manifest.configs.find((c) => c.scope === 'project' && c.mcpPath && matchesPlatform(c));
+        // Check project config first if available
+        if (projectConfig && projectDir) {
+            const projectPath = resolveManifestPath(projectConfig.path, {
+                ...this.homeRoots,
+                projectDir
+            });
+            const config = await this.readConfig(projectPath, projectConfig.format);
+            const { configured, serverConfig } = checkMcpServerConfigAtPath(config, projectConfig.mcpPath, 'vibes');
+            if (configured) {
+                return {
+                    configured: true,
+                    serverName: 'vibes',
+                    transport: this.manifest.mcp.transports[0],
+                    hasAuthToken: this.hasAuthTokenInConfig(serverConfig),
+                    publishedBearer: hasPublishedBearer(serverConfig),
+                    configPath: projectPath
+                };
+            }
+        }
+        // Fall back to global config
+        if (globalConfig) {
+            const globalPath = resolveManifestPath(globalConfig.path, this.homeRoots);
+            const config = await this.readConfig(globalPath, globalConfig.format);
+            const { configured, serverConfig } = checkMcpServerConfigAtPath(config, globalConfig.mcpPath, 'vibes');
+            return {
+                configured,
+                serverName: configured ? 'vibes' : undefined,
+                transport: configured ? this.manifest.mcp.transports[0] : undefined,
+                hasAuthToken: this.hasAuthTokenInConfig(serverConfig),
+                publishedBearer: hasPublishedBearer(serverConfig),
+                configPath: configured ? globalPath : undefined
+            };
+        }
+        return {
+            configured: false,
+            hasAuthToken: false
+        };
+    }
+    getConfigPath(global, projectDir) {
+        return getConfigPathFromManifest(this.manifest, global, { ...this.homeRoots, projectDir });
+    }
+    /**
+     * Get the manifest this detector was created from
+     */
+    getManifest() {
+        return this.manifest;
+    }
+}
+/**
+ * Create a detector from a manifest
+ */
+export function createDetectorFromManifest(manifest, roots, runtime) {
+    return new ManifestBasedDetector(manifest, roots, runtime);
+}
+//# sourceMappingURL=manifest-detector.js.map