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

package/dist/external-adapter/descriptors.d.ts

@@ -0,0 +1,133 @@
+export declare const mcpExternalAdapterDescriptor: {
+    id: string;
+    kind: "external/adapter";
+    adapter: string;
+    description: string;
+    operations: string[];
+    spec: {
+        [x: string]: unknown;
+        protocol: string;
+        manifestField: string;
+        writesLocalFiles: boolean;
+        projectScoped: boolean;
+        composesWith: string[];
+    };
+    name?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+export declare const skillsExternalAdapterDescriptor: {
+    id: string;
+    kind: "external/adapter";
+    adapter: string;
+    description: string;
+    operations: string[];
+    spec: {
+        [x: string]: unknown;
+        protocol: string;
+        manifestField: string;
+        writesLocalFiles: boolean;
+        projectScoped: boolean;
+        composesWith: string[];
+    };
+    name?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+export declare const hooksExternalAdapterDescriptor: {
+    id: string;
+    kind: "external/adapter";
+    adapter: string;
+    description: string;
+    operations: string[];
+    spec: {
+        [x: string]: unknown;
+        protocol: string;
+        manifestField: string;
+        writesLocalFiles: boolean;
+        projectScoped: boolean;
+        composesWith: string[];
+    };
+    name?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+export declare const pluginsExternalAdapterDescriptor: {
+    id: string;
+    kind: "external/adapter";
+    adapter: string;
+    description: string;
+    operations: string[];
+    spec: {
+        [x: string]: unknown;
+        protocol: string;
+        manifestField: string;
+        writesLocalFiles: boolean;
+        projectScoped: boolean;
+        composesWith: string[];
+    };
+    name?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+//# sourceMappingURL=descriptors.d.ts.map

package/dist/external-adapter/descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors.d.ts","sourceRoot":"","sources":["../../src/external-adapter/descriptors.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiBvC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgB1C,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBzC,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgB3C,CAAC"}

package/dist/external-adapter/descriptors.js

@@ -0,0 +1,70 @@
+import { createExternalAdapterDescriptor } from "./schemas/adapter.js";
+export const mcpExternalAdapterDescriptor = createExternalAdapterDescriptor({
+    id: 'mcp',
+    name: 'MCP',
+    description: 'Projects Vibes tools and runtime capabilities through Model Context Protocol config.',
+    adapter: 'mcp',
+    operations: ['status', 'apply', 'remove'],
+    tags: ['external', 'adapter', 'mcp'],
+    hardware: ['consumer'],
+    enabled: true,
+    spec: {
+        protocol: 'model-context-protocol',
+        manifestField: 'mcp',
+        writesLocalFiles: true,
+        projectScoped: true,
+        composesWith: ['tools/mcp', 'tools/tool']
+    }
+});
+export const skillsExternalAdapterDescriptor = createExternalAdapterDescriptor({
+    id: 'skills',
+    name: 'Agent Skills',
+    description: 'Projects Vibes tool and workflow descriptors into target-native skill files.',
+    adapter: 'skills',
+    operations: ['status', 'apply'],
+    tags: ['external', 'adapter', 'skills'],
+    hardware: ['consumer'],
+    enabled: true,
+    spec: {
+        protocol: 'agent-skills',
+        manifestField: 'skills',
+        writesLocalFiles: true,
+        projectScoped: true,
+        composesWith: ['tools/tool', '@vibesdotdev/tools/adapters/skill']
+    }
+});
+export const hooksExternalAdapterDescriptor = createExternalAdapterDescriptor({
+    id: 'hooks',
+    name: 'Hooks',
+    description: 'Projects external tool lifecycle events into Vibes runtime hook calls.',
+    adapter: 'hooks',
+    operations: ['status', 'generate', 'apply', 'remove'],
+    tags: ['external', 'adapter', 'hooks'],
+    hardware: ['consumer'],
+    enabled: true,
+    spec: {
+        protocol: 'tool-hooks',
+        manifestField: 'hooks',
+        writesLocalFiles: true,
+        projectScoped: true,
+        composesWith: ['runtime/subscription', 'tools/tool', 'logging/output']
+    }
+});
+export const pluginsExternalAdapterDescriptor = createExternalAdapterDescriptor({
+    id: 'plugins',
+    name: 'Plugins',
+    description: 'Projects Vibes integration glue into target-native plugin formats.',
+    adapter: 'plugins',
+    operations: ['status'],
+    tags: ['external', 'adapter', 'plugins'],
+    hardware: ['consumer'],
+    enabled: true,
+    spec: {
+        protocol: 'tool-plugin',
+        manifestField: 'plugins',
+        writesLocalFiles: true,
+        projectScoped: true,
+        composesWith: ['external/pack']
+    }
+});
+//# sourceMappingURL=descriptors.js.map

package/dist/external-adapter/descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors.js","sourceRoot":"","sources":["../../src/external-adapter/descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,CAAC,MAAM,4BAA4B,GAAG,+BAA+B,CAAC;IAC3E,EAAE,EAAE,KAAK;IACT,IAAI,EAAE,KAAK;IACX,WAAW,EACV,sFAAsF;IACvF,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC;IACzC,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC;IACpC,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE;QACL,QAAQ,EAAE,wBAAwB;QAClC,aAAa,EAAE,KAAK;QACpB,gBAAgB,EAAE,IAAI;QACtB,aAAa,EAAE,IAAI;QACnB,YAAY,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;KACzC;CACD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,+BAA+B,CAAC;IAC9E,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,8EAA8E;IAC3F,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC/B,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC;IACvC,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE;QACL,QAAQ,EAAE,cAAc;QACxB,aAAa,EAAE,QAAQ;QACvB,gBAAgB,EAAE,IAAI;QACtB,aAAa,EAAE,IAAI;QACnB,YAAY,EAAE,CAAC,YAAY,EAAE,mCAAmC,CAAC;KACjE;CACD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,8BAA8B,GAAG,+BAA+B,CAAC;IAC7E,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,wEAAwE;IACrF,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC;IACrD,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC;IACtC,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE;QACL,QAAQ,EAAE,YAAY;QACtB,aAAa,EAAE,OAAO;QACtB,gBAAgB,EAAE,IAAI;QACtB,aAAa,EAAE,IAAI;QACnB,YAAY,EAAE,CAAC,sBAAsB,EAAE,YAAY,EAAE,gBAAgB,CAAC;KACtE;CACD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gCAAgC,GAAG,+BAA+B,CAAC;IAC/E,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,oEAAoE;IACjF,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,CAAC,QAAQ,CAAC;IACtB,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC;IACxC,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE;QACL,QAAQ,EAAE,aAAa;QACvB,aAAa,EAAE,SAAS;QACxB,gBAAgB,EAAE,IAAI;QACtB,aAAa,EAAE,IAAI;QACnB,YAAY,EAAE,CAAC,eAAe,CAAC;KAC/B;CACD,CAAC,CAAC"}

package/dist/external-adapter/implementations.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The built-in `external/adapter` implementations: MCP, skills, hooks and
+ * plugins, each projecting one artifact family onto the selected host. An
+ * operation an adapter does not declare is refused `INVALID_INPUT`
+ * `external-adapter-operation-unsupported`.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { ExternalAdapter } from './schemas/adapter.ts';
+export declare function mcpExternalAdapter(runtime: RuntimeRef): ExternalAdapter;
+export declare function skillsExternalAdapter(runtime: RuntimeRef): ExternalAdapter;
+export declare function hooksExternalAdapter(runtime: RuntimeRef): ExternalAdapter;
+export declare function pluginsExternalAdapter(runtime: RuntimeRef): ExternalAdapter;
+//# sourceMappingURL=implementations.d.ts.map

package/dist/external-adapter/implementations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementations.d.ts","sourceRoot":"","sources":["../../src/external-adapter/implementations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,sBAAsB,CAAC;AA2BlF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,GAAG,eAAe,CAqBvE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,eAAe,CAY1E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,eAAe,CAkBzE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,GAAG,eAAe,CAS3E"}

package/dist/external-adapter/implementations.js

@@ -0,0 +1,97 @@
+/**
+ * The built-in `external/adapter` implementations: MCP, skills, hooks and
+ * plugins, each projecting one artifact family onto the selected host. An
+ * operation an adapter does not declare is refused `INVALID_INPUT`
+ * `external-adapter-operation-unsupported`.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { resolveExternalHostImplementation } from "../external-tool/runtime.js";
+function host(runtime, input) {
+    return resolveExternalHostImplementation(runtime, input.hostId);
+}
+async function scope(runtime, input) {
+    const workspacePath = runtime.hasContext('runtime/workspace-path')
+        ? await runtime.context('runtime/workspace-path')
+        : undefined;
+    return { global: input.global === true, projectDir: input.projectDir ?? workspacePath ?? '.' };
+}
+function unsupported(adapter, operation) {
+    return new CapabilityError(`The ${adapter} adapter does not support '${operation}'.`, 'INVALID_INPUT', {
+        reason: 'external-adapter-operation-unsupported',
+        retryable: false,
+        details: { adapter, operation }
+    });
+}
+export function mcpExternalAdapter(runtime) {
+    return {
+        async execute(operation, input) {
+            const target = await host(runtime, input);
+            const selected = await scope(runtime, input);
+            if (operation === 'status')
+                return target.checkMcp(selected);
+            if (operation === 'apply') {
+                return target.installMcp({
+                    ...selected,
+                    authToken: input.authToken,
+                    transport: input.transport,
+                    dryRun: input.dryRun === true,
+                    force: input.force === true,
+                    mcpClientId: input.mcpClientId,
+                    vibesPath: input.vibesPath ?? 'vibes'
+                });
+            }
+            if (operation === 'remove')
+                return target.uninstallMcp(selected.global, selected.projectDir);
+            throw unsupported('mcp', operation);
+        }
+    };
+}
+export function skillsExternalAdapter(runtime) {
+    return {
+        async execute(operation, input) {
+            const target = await host(runtime, input);
+            const selected = await scope(runtime, input);
+            if (operation === 'status')
+                return { path: target.getSkillsDir(selected.global, selected.projectDir) };
+            if (operation === 'apply') {
+                return target.generateSkills({ ...selected, dryRun: input.dryRun === true, outputDir: input.outputDir });
+            }
+            throw unsupported('skills', operation);
+        }
+    };
+}
+export function hooksExternalAdapter(runtime) {
+    return {
+        async execute(operation, input) {
+            const target = await host(runtime, input);
+            const selected = await scope(runtime, input);
+            if (operation === 'status')
+                return { path: target.getHooksDir(selected.global, selected.projectDir) };
+            const options = {
+                ...selected,
+                dryRun: input.dryRun === true,
+                force: input.force === true,
+                vibesPath: input.vibesPath ?? 'vibes'
+            };
+            if (operation === 'generate')
+                return target.generateHooks(options);
+            if (operation === 'apply')
+                return target.installHooks(options);
+            if (operation === 'remove')
+                return target.uninstallHooks(selected.global, selected.projectDir);
+            throw unsupported('hooks', operation);
+        }
+    };
+}
+export function pluginsExternalAdapter(runtime) {
+    return {
+        async execute(operation, input) {
+            if (operation !== 'status')
+                throw unsupported('plugins', operation);
+            const target = await host(runtime, input);
+            const selected = await scope(runtime, input);
+            return { path: target.getPluginsDir(selected.projectDir) };
+        }
+    };
+}
+//# sourceMappingURL=implementations.js.map

package/dist/external-adapter/implementations.js.map

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

package/dist/external-adapter/schemas/adapter.d.ts

@@ -0,0 +1,66 @@
+import * as z from 'zod/v4';
+import type { ExternalHost } from '../../external-tool/interfaces/tool.ts';
+export declare const ExternalAdapterIdSchema: z.ZodString;
+export type ExternalAdapterId = z.infer<typeof ExternalAdapterIdSchema>;
+export declare const ExternalAdapterDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"external/adapter">;
+    adapter: z.ZodString;
+    description: z.ZodString;
+    operations: z.ZodArray<z.ZodString>;
+    spec: z.ZodObject<{
+        protocol: z.ZodString;
+        manifestField: z.ZodString;
+        writesLocalFiles: z.ZodDefault<z.ZodBoolean>;
+        projectScoped: z.ZodDefault<z.ZodBoolean>;
+        composesWith: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export type ExternalAdapterDescriptor = z.infer<typeof ExternalAdapterDescriptorSchema>;
+/** What an adapter operation is asked to do: the host, the scope and the operation's options. */
+export declare const ExternalAdapterInputSchema: z.ZodObject<{
+    hostId: z.ZodString;
+    global: z.ZodOptional<z.ZodBoolean>;
+    projectDir: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+    force: z.ZodOptional<z.ZodBoolean>;
+    vibesPath: z.ZodOptional<z.ZodString>;
+    authToken: z.ZodOptional<z.ZodString>;
+    transport: z.ZodOptional<z.ZodEnum<{
+        http: "http";
+        stdio: "stdio";
+        sse: "sse";
+    }>>;
+    mcpClientId: z.ZodOptional<z.ZodString>;
+    outputDir: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>;
+export type ExternalAdapterInput = z.infer<typeof ExternalAdapterInputSchema>;
+/** What an adapter operation answers: the host operation's own result. */
+export type ExternalAdapterResult = Awaited<ReturnType<ExternalHost['checkMcp']>> | Awaited<ReturnType<ExternalHost['installMcp']>> | Awaited<ReturnType<ExternalHost['uninstallMcp']>> | Awaited<ReturnType<ExternalHost['generateSkills']>> | Awaited<ReturnType<ExternalHost['generateHooks']>> | Awaited<ReturnType<ExternalHost['installHooks']>> | Awaited<ReturnType<ExternalHost['uninstallHooks']>> | {
+    readonly path: string | undefined;
+};
+export interface ExternalAdapter {
+    execute(operation: string, input: ExternalAdapterInput): Promise<ExternalAdapterResult>;
+}
+export declare function createExternalAdapterDescriptor(input: Omit<ExternalAdapterDescriptor, 'kind'> & {
+    kind?: 'external/adapter';
+}): ExternalAdapterDescriptor;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/external-adapter/schemas/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/external-adapter/schemas/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAE3E,eAAO,MAAM,uBAAuB,aAAwC,CAAC;AAC7E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmB1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,iGAAiG;AACjG,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;qQAaZ,CAAC;AAC5B,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,0EAA0E;AAC1E,MAAM,MAAM,qBAAqB,GAC9B,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,GAC7C,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,GAC/C,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,GACjD,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,GACnD,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,GACjD,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,eAAe;IAC/B,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACxF;AAED,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,IAAI,CAAC,yBAAyB,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,kBAAkB,CAAA;CAAE,GAC5E,yBAAyB,CAa3B"}

package/dist/external-adapter/schemas/adapter.js

@@ -0,0 +1,55 @@
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+export const ExternalAdapterIdSchema = z.string().regex(/^[a-z][a-z0-9-]*$/);
+export const ExternalAdapterDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('external/adapter'),
+    adapter: ExternalAdapterIdSchema,
+    description: z.string(),
+    operations: z.array(z.string().regex(/^[a-z][a-z0-9-]*$/)).min(1),
+    spec: z
+        .object({
+        /** Human-readable protocol or artifact family this adapter projects. */
+        protocol: z.string(),
+        /** Manifest field that declares per-tool support for this adapter. */
+        manifestField: z.string(),
+        /** Whether this adapter writes local files as part of installation. */
+        writesLocalFiles: z.boolean().default(true),
+        /** Whether this adapter can be installed at project scope. */
+        projectScoped: z.boolean().default(false),
+        /** Runtime kind(s) or package surfaces this adapter composes with. */
+        composesWith: z.array(z.string()).default([])
+    })
+        .passthrough()
+});
+/** What an adapter operation is asked to do: the host, the scope and the operation's options. */
+export const ExternalAdapterInputSchema = z
+    .object({
+    hostId: z.string().min(1),
+    global: z.boolean().optional(),
+    projectDir: z.string().optional(),
+    dryRun: z.boolean().optional(),
+    force: z.boolean().optional(),
+    vibesPath: z.string().optional(),
+    authToken: z.string().optional(),
+    transport: z.enum(['stdio', 'http', 'sse']).optional(),
+    mcpClientId: z.string().optional(),
+    outputDir: z.string().optional()
+})
+    .catchall(JsonValueSchema);
+export function createExternalAdapterDescriptor(input) {
+    const result = ExternalAdapterDescriptorSchema.safeParse({
+        ...input,
+        kind: 'external/adapter'
+    });
+    if (!result.success) {
+        throw new CapabilityError(`Invalid external/adapter descriptor '${input.id}'.`, 'INVALID_INPUT', {
+            reason: 'external-adapter-descriptor-invalid',
+            retryable: false,
+            details: { id: input.id, issues: result.error.issues.map((issue) => issue.path.join('.')) }
+        });
+    }
+    return result.data;
+}
+//# sourceMappingURL=adapter.js.map

package/dist/external-adapter/schemas/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/external-adapter/schemas/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;AAG7E,MAAM,CAAC,MAAM,+BAA+B,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC7E,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACnC,OAAO,EAAE,uBAAuB;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,IAAI,EAAE,CAAC;SACL,MAAM,CAAC;QACP,wEAAwE;QACxE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,sEAAsE;QACtE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;QACzB,uEAAuE;QACvE,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3C,8DAA8D;QAC9D,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QACzC,sEAAsE;QACtE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;KAC7C,CAAC;SACD,WAAW,EAAE;CACf,CAAC,CAAC;AAIH,iGAAiG;AACjG,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACzC,MAAM,CAAC;IACP,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC;KACD,QAAQ,CAAC,eAAe,CAAC,CAAC;AAkB5B,MAAM,UAAU,+BAA+B,CAC9C,KAA8E;IAE9E,MAAM,MAAM,GAAG,+BAA+B,CAAC,SAAS,CAAC;QACxD,GAAG,KAAK;QACR,IAAI,EAAE,kBAAkB;KACxB,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,eAAe,CAAC,wCAAwC,KAAK,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE;YAChG,MAAM,EAAE,qCAAqC;YAC7C,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE;SAC3F,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACpB,CAAC"}