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

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

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

package/dist/detection/service.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Agent Detection Service
+ *
+ * Provides high-level detection operations using runtime-discovered
+ * `external/host` assets.
+ *
+ * Use:
+ * - `detectFromRegistry()` - Detect all tools using manifests
+ * - `detectMcpFromRegistry()` - Detect MCP-capable tools
+ * - `detectToolFromRegistry()` - Detect a specific tool
+ * - `getUnconfiguredFromRegistry()` - Get tools needing configuration
+ */
+import type { AgentDetectionResult } from './types.ts';
+import type { ExternalHostManifest } from '../plugins/schemas/manifest.ts';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+export interface DetectionSummary {
+    detected: AgentDetectionResult[];
+    installedCount: number;
+    mcpConfiguredCount: number;
+    timestamp: Date;
+}
+/**
+ * Detection result with manifest reference
+ */
+export interface RegistryDetectionResult extends AgentDetectionResult {
+    manifest: ExternalHostManifest;
+}
+/**
+ * Registry detection summary
+ */
+export interface RegistryDetectionSummary {
+    detected: RegistryDetectionResult[];
+    installedCount: number;
+    mcpConfiguredCount: number;
+    timestamp: Date;
+}
+/**
+ * Detect all tools using the registry
+ * This uses manifests as the source of truth for tool metadata
+ */
+export declare function detectFromRegistry(runtime: VibesRuntime, projectDir?: string, options?: {
+    mcpOnly?: boolean;
+}): Promise<RegistryDetectionSummary>;
+/**
+ * Detect all tools via runtime-discovered `external/host` assets.
+ *
+ * @preferred Use this name in new code.
+ */
+export declare function detectFromRuntime(runtime: VibesRuntime, projectDir?: string, options?: {
+    mcpOnly?: boolean;
+}): Promise<RegistryDetectionSummary>;
+/**
+ * Detect MCP-capable tools using the registry
+ */
+export declare function detectMcpFromRegistry(runtime: VibesRuntime, projectDir?: string): Promise<RegistryDetectionSummary>;
+/**
+ * Detect MCP-capable tools via runtime-discovered `external/host` assets.
+ *
+ * @preferred Use this name in new code.
+ */
+export declare function detectMcpFromRuntime(runtime: VibesRuntime, projectDir?: string): Promise<RegistryDetectionSummary>;
+/**
+ * Detect a specific tool using its manifest from the registry
+ */
+export declare function detectToolFromRegistry(runtime: VibesRuntime, toolId: string, projectDir?: string): Promise<RegistryDetectionResult | null>;
+/**
+ * Detect a specific tool via runtime-discovered `external/host` assets.
+ *
+ * @preferred Use this name in new code.
+ */
+export declare function detectToolFromRuntime(runtime: VibesRuntime, toolId: string, projectDir?: string): Promise<RegistryDetectionResult | null>;
+/**
+ * Get unconfigured tools using the registry
+ */
+export declare function getUnconfiguredFromRegistry(runtime: VibesRuntime, projectDir?: string): Promise<RegistryDetectionResult[]>;
+/**
+ * Get unconfigured tools via runtime-discovered `external/host` assets.
+ *
+ * @preferred Use this name in new code.
+ */
+export declare function getUnconfiguredFromRuntime(runtime: VibesRuntime, projectDir?: string): Promise<RegistryDetectionResult[]>;
+/**
+ * Get all available tool manifests from the registry
+ */
+export declare function getAvailableManifests(runtime: VibesRuntime): Promise<ExternalHostManifest[]>;
+/**
+ * Get all available tool manifests via runtime-discovered `external/host` assets.
+ *
+ * @preferred Use this name in new code.
+ */
+export declare function getAvailableManifestsFromRuntime(runtime: VibesRuntime): Promise<ExternalHostManifest[]>;
+/**
+ * Get MCP-capable tool manifests from the registry
+ */
+export declare function getMcpCapableManifests(runtime: VibesRuntime): Promise<ExternalHostManifest[]>;
+export declare function getMcpCapableManifestsFromRuntime(runtime: VibesRuntime): Promise<ExternalHostManifest[]>;
+export type { AgentDetector } from './types.ts';
+export { createDetectorFromManifest, type ManifestBasedDetector } from './manifest-detector.ts';
+//# sourceMappingURL=service.d.ts.map

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

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

package/dist/detection/service.js

@@ -0,0 +1,124 @@
+/**
+ * Agent Detection Service
+ *
+ * Provides high-level detection operations using runtime-discovered
+ * `external/host` assets.
+ *
+ * Use:
+ * - `detectFromRegistry()` - Detect all tools using manifests
+ * - `detectMcpFromRegistry()` - Detect MCP-capable tools
+ * - `detectToolFromRegistry()` - Detect a specific tool
+ * - `getUnconfiguredFromRegistry()` - Get tools needing configuration
+ */
+import { ExternalHostDescriptorSchema } from "../external-tool/schemas/tool.js";
+import { resolveExternalHostImplementation } from "../external-tool/runtime.js";
+async function listExternalHostDescriptors(runtime) {
+    const raw = runtime.query('external/host').enabled().descriptors();
+    return raw.map((d) => ExternalHostDescriptorSchema.parse(d));
+}
+/**
+ * Detect all tools using the registry
+ * This uses manifests as the source of truth for tool metadata
+ */
+export async function detectFromRegistry(runtime, projectDir, options) {
+    const descriptors = await listExternalHostDescriptors(runtime);
+    const selected = options?.mcpOnly
+        ? descriptors.filter((d) => d.manifest.mcp.supported)
+        : descriptors;
+    const results = await Promise.all(selected.map(async (descriptor) => {
+        const externalTool = await resolveExternalHostImplementation(runtime, descriptor.id);
+        const result = await externalTool.detect(projectDir);
+        return { ...result, manifest: descriptor.manifest };
+    }));
+    const detected = results.filter((r) => r.installation.installed);
+    return {
+        detected,
+        installedCount: detected.length,
+        mcpConfiguredCount: detected.filter((r) => r.mcpState.configured).length,
+        timestamp: new Date()
+    };
+}
+/**
+ * Detect all tools via runtime-discovered `external/host` assets.
+ *
+ * @preferred Use this name in new code.
+ */
+export function detectFromRuntime(runtime, projectDir, options) {
+    return detectFromRegistry(runtime, projectDir, options);
+}
+/**
+ * Detect MCP-capable tools using the registry
+ */
+export function detectMcpFromRegistry(runtime, projectDir) {
+    return detectFromRegistry(runtime, projectDir, { mcpOnly: true });
+}
+/**
+ * Detect MCP-capable tools via runtime-discovered `external/host` assets.
+ *
+ * @preferred Use this name in new code.
+ */
+export function detectMcpFromRuntime(runtime, projectDir) {
+    return detectMcpFromRegistry(runtime, projectDir);
+}
+/**
+ * Detect a specific tool using its manifest from the registry
+ */
+export async function detectToolFromRegistry(runtime, toolId, projectDir) {
+    const descriptors = await listExternalHostDescriptors(runtime);
+    const descriptor = descriptors.find((d) => d.id === toolId);
+    if (!descriptor)
+        return null;
+    const externalTool = await resolveExternalHostImplementation(runtime, descriptor.id);
+    const result = await externalTool.detect(projectDir);
+    return { ...result, manifest: descriptor.manifest };
+}
+/**
+ * Detect a specific tool via runtime-discovered `external/host` assets.
+ *
+ * @preferred Use this name in new code.
+ */
+export function detectToolFromRuntime(runtime, toolId, projectDir) {
+    return detectToolFromRegistry(runtime, toolId, projectDir);
+}
+/**
+ * Get unconfigured tools using the registry
+ */
+export async function getUnconfiguredFromRegistry(runtime, projectDir) {
+    const summary = await detectMcpFromRegistry(runtime, projectDir);
+    return summary.detected.filter((r) => !r.mcpState.configured);
+}
+/**
+ * Get unconfigured tools via runtime-discovered `external/host` assets.
+ *
+ * @preferred Use this name in new code.
+ */
+export function getUnconfiguredFromRuntime(runtime, projectDir) {
+    return getUnconfiguredFromRegistry(runtime, projectDir);
+}
+/**
+ * Get all available tool manifests from the registry
+ */
+export async function getAvailableManifests(runtime) {
+    const descriptors = await listExternalHostDescriptors(runtime);
+    return descriptors.map((d) => d.manifest);
+}
+/**
+ * Get all available tool manifests via runtime-discovered `external/host` assets.
+ *
+ * @preferred Use this name in new code.
+ */
+export function getAvailableManifestsFromRuntime(runtime) {
+    return getAvailableManifests(runtime);
+}
+/**
+ * Get MCP-capable tool manifests from the registry
+ */
+export async function getMcpCapableManifests(runtime) {
+    const descriptors = await listExternalHostDescriptors(runtime);
+    return descriptors.filter((d) => d.manifest.mcp.supported).map((d) => d.manifest);
+}
+export function getMcpCapableManifestsFromRuntime(runtime) {
+    return getMcpCapableManifests(runtime);
+}
+export { createDetectorFromManifest } from "./manifest-detector.js";
+//# sourceMappingURL=service.js.map

package/dist/detection/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/detection/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EACN,4BAA4B,EAE5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,iCAAiC,EAAE,MAAM,6BAA6B,CAAC;AAEhF,KAAK,UAAU,2BAA2B,CACzC,OAAqB;IAErB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC;IACnE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AA4BD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,OAAqB,EACrB,UAAmB,EACnB,OAA+B;IAE/B,MAAM,WAAW,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,OAAO,EAAE,OAAO;QAChC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;QACrD,CAAC,CAAC,WAAW,CAAC;IAEf,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE;QACjC,MAAM,YAAY,GAAG,MAAM,iCAAiC,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;QACrF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACrD,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC;IACrD,CAAC,CAAC,CACF,CAAC;IAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAEjE,OAAO;QACN,QAAQ;QACR,cAAc,EAAE,QAAQ,CAAC,MAAM;QAC/B,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,MAAM;QACxE,SAAS,EAAE,IAAI,IAAI,EAAE;KACrB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAChC,OAAqB,EACrB,UAAmB,EACnB,OAA+B;IAE/B,OAAO,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACpC,OAAqB,EACrB,UAAmB;IAEnB,OAAO,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CACnC,OAAqB,EACrB,UAAmB;IAEnB,OAAO,qBAAqB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,OAAqB,EACrB,MAAc,EACd,UAAmB;IAEnB,MAAM,WAAW,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAC5D,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE7B,MAAM,YAAY,GAAG,MAAM,iCAAiC,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;IACrF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACrD,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACpC,OAAqB,EACrB,MAAc,EACd,UAAmB;IAEnB,OAAO,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAChD,OAAqB,EACrB,UAAmB;IAEnB,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACjE,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACzC,OAAqB,EACrB,UAAmB;IAEnB,OAAO,2BAA2B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAqB;IAChE,MAAM,WAAW,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC/D,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAAC,OAAqB;IACrE,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAAqB;IACjE,MAAM,WAAW,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC/D,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,OAAqB;IACtE,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC;AAID,OAAO,EAAE,0BAA0B,EAA8B,MAAM,wBAAwB,CAAC"}

package/dist/detection/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Agent Detection Types
+ *
+ * Defines interfaces for detecting AI coding assistants and their configurations.
+ */
+import * as z from 'zod/v4';
+/**
+ * External tool descriptor ID.
+ */
+export declare const agentIdSchema: z.ZodString;
+export type AgentId = z.infer<typeof agentIdSchema>;
+/**
+ * Agent category for grouping similar agents
+ */
+export declare const agentCategorySchema: z.ZodEnum<{
+    cli: "cli";
+    "ide-extension": "ide-extension";
+    "ide-native": "ide-native";
+}>;
+export type AgentCategory = z.infer<typeof agentCategorySchema>;
+/**
+ * MCP transport support
+ */
+export declare const mcpTransportSchema: z.ZodEnum<{
+    http: "http";
+    stdio: "stdio";
+    sse: "sse";
+}>;
+export type McpTransport = z.infer<typeof mcpTransportSchema>;
+/**
+ * Configuration file format
+ */
+export declare const configFormatSchema: z.ZodEnum<{
+    json: "json";
+    yaml: "yaml";
+    jsonc: "jsonc";
+    toml: "toml";
+}>;
+export type ConfigFormat = z.infer<typeof configFormatSchema>;
+/**
+ * Agent metadata - static information about an agent
+ */
+export interface AgentMetadata {
+    id: AgentId;
+    name: string;
+    description: string;
+    category: AgentCategory;
+    website: string;
+    supportsMcp: boolean;
+    mcpTransports: McpTransport[];
+    configFormat: ConfigFormat;
+}
+/**
+ * Installation detection result
+ */
+export interface AgentInstallation {
+    installed: boolean;
+    version?: string;
+    installPath?: string;
+    configPath?: string;
+}
+/**
+ * MCP configuration state for an agent
+ */
+export interface AgentMcpState {
+    configured: boolean;
+    serverName?: string;
+    transport?: McpTransport;
+    hasAuthToken: boolean;
+    /** A leftover `VIBES_AUTH_TOKEN` an older install published; a reinstall removes it. */
+    publishedBearer?: boolean;
+    configPath?: string;
+}
+/**
+ * Complete detection result for an agent
+ */
+export interface AgentDetectionResult {
+    agent: AgentMetadata;
+    installation: AgentInstallation;
+    mcpState: AgentMcpState;
+}
+/**
+ * Agent detector interface - each agent implements this
+ */
+export interface AgentDetector {
+    readonly metadata: AgentMetadata;
+    /**
+     * Check if the agent is installed on this system
+     */
+    detectInstallation(): Promise<AgentInstallation>;
+    /**
+     * Check the current MCP configuration state
+     */
+    getMcpState(projectDir?: string): Promise<AgentMcpState>;
+    /**
+     * Get the path to the config file
+     */
+    getConfigPath(global: boolean, projectDir?: string): string;
+    /**
+     * Full detection combining installation and MCP state
+     */
+    detect(projectDir?: string): Promise<AgentDetectionResult>;
+}
+/**
+ * Detection summary across all agents
+ */
+export interface DetectionSummary {
+    detected: AgentDetectionResult[];
+    installedCount: number;
+    mcpConfiguredCount: number;
+    timestamp: Date;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/detection/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;GAEG;AACH,eAAO,MAAM,aAAa,aAGe,CAAC;AAC1C,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;EAI9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;EAAmC,CAAC;AACnE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;EAA4C,CAAC;AAC5E,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,YAAY,EAAE,YAAY,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,wFAAwF;IACxF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,iBAAiB,CAAC;IAChC,QAAQ,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAEjC;;OAEG;IACH,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEjD;;OAEG;IACH,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEzD;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE5D;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,IAAI,CAAC;CAChB"}

package/dist/detection/types.js

@@ -0,0 +1,30 @@
+/**
+ * Agent Detection Types
+ *
+ * Defines interfaces for detecting AI coding assistants and their configurations.
+ */
+import * as z from 'zod/v4';
+/**
+ * External tool descriptor ID.
+ */
+export const agentIdSchema = z
+    .string()
+    .regex(/^[a-z][a-z0-9-]*$/)
+    .describe('External tool descriptor ID');
+/**
+ * Agent category for grouping similar agents
+ */
+export const agentCategorySchema = z.enum([
+    'cli', // Command-line tools
+    'ide-extension', // IDE extensions (Continue, Cline)
+    'ide-native' // IDEs with built-in AI (Cursor, Windsurf, Zed)
+]);
+/**
+ * MCP transport support
+ */
+export const mcpTransportSchema = z.enum(['stdio', 'http', 'sse']);
+/**
+ * Configuration file format
+ */
+export const configFormatSchema = z.enum(['json', 'toml', 'yaml', 'jsonc']);
+//# sourceMappingURL=types.js.map

package/dist/detection/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/detection/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC5B,MAAM,EAAE;KACR,KAAK,CAAC,mBAAmB,CAAC;KAC1B,QAAQ,CAAC,6BAA6B,CAAC,CAAC;AAG1C;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC;IACzC,KAAK,EAAE,qBAAqB;IAC5B,eAAe,EAAE,mCAAmC;IACpD,YAAY,CAAC,gDAAgD;CAC7D,CAAC,CAAC;AAGH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAGnE;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC"}

package/dist/dev.external.descriptor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * External CLI Group Descriptor
+ *
+ * Group for projecting Vibes capabilities into external tools.
+ */
+import type { CLIGroupAssetDescriptor } from '@vibesdotdev/cli/schemas/types';
+declare const descriptor: CLIGroupAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=dev.external.descriptor.d.ts.map

package/dist/dev.external.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.external.descriptor.d.ts","sourceRoot":"","sources":["../src/dev.external.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,QAAA,MAAM,UAAU,EAAE,uBAUjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/dev.external.descriptor.js

@@ -0,0 +1,17 @@
+/**
+ * External CLI Group Descriptor
+ *
+ * Group for projecting Vibes capabilities into external tools.
+ */
+const descriptor = {
+    kind: 'cli/group',
+    id: 'dev.external',
+    name: 'external',
+    description: 'Project Vibes into external tools via adapters: MCP, skills, hooks, plugins, and presets',
+    parent: 'dev',
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=dev.external.descriptor.js.map

package/dist/dev.external.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.external.descriptor.js","sourceRoot":"","sources":["../src/dev.external.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,GAA4B;IAC3C,IAAI,EAAE,WAAW;IACjB,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,UAAU;IAChB,WAAW,EACV,0FAA0F;IAC3F,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/external.ambient.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=external.ambient.docs.descriptor.d.ts.map

package/dist/docs/external.ambient.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.ambient.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/external.ambient.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,QAAA,MAAM,UAAU,EAAE,mBA0GjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/external.ambient.docs.descriptor.js

@@ -0,0 +1,109 @@
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'external.ambient',
+    title: 'Ambient Agent Awareness',
+    summary: 'Account-wide live agent sessions, collision awareness, and ephemeral agent messaging',
+    tags: ['external', 'ambient', 'collision', 'awareness', 'multi-agent'],
+    parent: 'external',
+    order: 3,
+    surfaces: ['cli', 'web', 'in-app', 'mcp'],
+    hardware: ['consumer'],
+    enabled: true,
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: `---
+title: Ambient Agent Awareness
+summary: Account-wide live agent sessions, collision awareness, and ephemeral agent messaging
+tags: [external, ambient, collision, awareness, multi-agent]
+parent: external
+order: 3
+surfaces: [cli, web, in-app, mcp]
+hardware: [consumer]
+---
+
+Agents working in the same tree — on the same machine or across the fleet — should
+know about each other *at the moment it matters*, and be able to talk. The product is
+ephemeral knowledge delivered as a tight, informative update. The one enforcement is
+the native-edit lock described under "Native edits and hooks": a file another
+participant holds is refused, naming the holder.
+
+## How it works
+
+Three runtime subscriptions define the tool, optional watcher, and drain paths:
+
+1. **Tool path** (\`external.file-access.ambient\`) — fires on \`tools.tool.afterExecute\`
+   filtered to \`workspace-fs\`. Records the touch and injects the collision notice
+   directly into the tool result.
+
+2. **Filesystem watcher path** (\`external.file-access.ambient-fs\`) — fires on
+   \`filesystem.fragment.invalidate\` with \`reason: 'watch'\`. Disabled in production. Workspace must stop publishing gone paths and exclude .vibes/ before re-enablement. Explicit fixture activation records touches and queues notices through the registered subscription.
+
+3. **Drain** (\`external.file-access.ambient-drain\`) — fires on every
+   \`tools.tool.afterExecute\` with no filter. Drains the pending-notices queue
+   and injects any queued notice/messages into the current tool result. This is
+   how a \`brain.pulse\` or \`session.status\` call delivers a collision notice
+   that was queued 500ms earlier by the filesystem watcher.
+
+## Native edits and hooks
+
+Claude Code's Edit/Write and Codex's apply_patch bypass \`workspace-fs\`, so the
+harness hooks carry the same exchange:
+
+- **PreToolUse** locks each file a native edit writes through \`workspace-lock\`, as
+  the conversation's seat (the same participant its MCP connection resolves). A file
+  another participant holds refuses the edit and names the holder and the
+  \`workspace-lock\` request to ask for it.
+- **PostToolUse** counts successful edits and retains paths, without consuming participant-bound output.
+- **UserPromptSubmit, Stop** claim messages and drain every queued batch in order once. Nothing pending adds no bytes.
+- **Self-review**: after \`selfReviewEveryEdits\` native edits (default 10; 0 turns it
+  off), and at Stop when edits happened since the last review, the hook injects the
+  \`selfReviewPromptId\` prompt (default \`guardrails.self-review\`).
+
+All of it is the \`collaboration\` value of the \`external\` config: \`nativeEditLocks\`,
+\`editTools\`, \`lockTtlMs\`, \`ambientDelivery\`, \`selfReviewEveryEdits\`,
+\`selfReviewAtStop\`, \`selfReviewPromptId\`. Each has a default.
+
+## Notice format
+
+\`\`\`
+Heads up — 3 others editing this file (wupatki, now): 3b3961fe, ec1ef981, 32dc43b3 +5
+\`\`\`
+
+One line. Count first. Session IDs in short form (8 chars). Machine and time once.
+Work item inline when available. Capped at 3 named peers with \`+N\` tail.
+
+## Identity
+
+When no bound session is available, all three handlers on the handed runtime share a single per-runtime
+UUID owned by the activated ExternalClient via \`getAmbientSessionId(runtime)\`. The same client owns projection batches, collision history and identity caches. Machine identity lasts for that runtime; checkout entries refresh after two seconds, and reset/disposal affect only their owner. This ensures the filesystem watcher's
+\`setPending\` and the drain's \`drainPending\` coordinate under the same identity.
+
+## CLI
+
+| Command | Purpose |
+|---------|---------|
+| \`vibes who\` | Account-wide roster across linked environments; reports agent id, model, provider, session id, and session length |
+
+## Swappable implementations
+
+- \`external/collision-filter\` — decides which peers are relevant (default: same
+  workspace, recent, not self)
+- \`external/notice-formatter\` — renders the one-line notice (default: terse format
+  shown above)
+- \`external/touch-projection\` — batched push + bounded read to the cloud endpoint
+- \`external/message-transport\` — local SQLite + remote cloud for agent-to-agent
+  messaging
+- \`external/agent-roster-provider\` — publishes and lists ephemeral live
+  agent-session facts for the authenticated account; local file touches remain
+  a collision fallback, not the account roster authority
+
+## Design
+
+See [docs/architecture/AMBIENT-AGENT-AWARENESS.md](../../docs/architecture/AMBIENT-AGENT-AWARENESS.md)
+for the full SPEC delta, ownership model, and noise budget.
+`
+    }
+};
+export default descriptor;
+//# sourceMappingURL=external.ambient.docs.descriptor.js.map

package/dist/docs/external.ambient.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.ambient.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/external.ambient.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,yBAAyB;IAChC,OAAO,EAAE,sFAAsF;IAC/F,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,CAAC;IACtE,MAAM,EAAE,UAAU;IAClB,KAAK,EAAE,CAAC;IACR,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC;IACzC,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0FT;KACC;CACD,CAAC;AAEF,eAAe,UAAU,CAAC"}