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

package/dist/external-tool/path-template.d.ts

@@ -0,0 +1,54 @@
+import { getPathRoots } from '@vibesdotdev/paths';
+/**
+ * The roots a path template resolves against, all handed in by the caller that
+ * holds the runtime; nothing here reads the host.
+ *
+ * - `userHome`: the runtime's `paths/roots` user home (`${HOME}`).
+ * - `configHome` / `appData`: the host's config homes (`${XDG_CONFIG_HOME}`,
+ *   `${APPDATA}`), as {@link hostTemplateRoots} reads them.
+ * - `projectDir`: the project a project-scoped path lives in (the caller's,
+ *   else the bound `runtime/workspace-path`).
+ * - `platform`: the host platform key manifests select per-OS entries by.
+ */
+export interface PathTemplateRoots {
+    readonly platform: PlatformKey;
+    readonly userHome: string;
+    readonly configHome: string;
+    readonly appData: string;
+    readonly projectDir?: string;
+}
+/** A manifest platform key. */
+export type PlatformKey = 'darwin' | 'win32' | 'linux';
+/**
+ * Map a host platform to a manifest platform key. Any non-darwin, non-win32
+ * POSIX (freebsd, openbsd, …) is `linux`, so detection and config resolution
+ * agree on every POSIX host.
+ */
+export declare function resolvePlatformKey(platform: string): PlatformKey;
+/**
+ * The platform key of `runtime`'s host, from its declared host facts. A host
+ * that declares no platform is refused `UNAVAILABLE` `host-platform-undeclared`.
+ */
+export declare function hostPlatformKey(runtime: Pick<PathTemplateRuntime, 'localEnvironment'>): PlatformKey;
+/** What {@link hostTemplateRoots} reads: the runtime's path roots, environment and host platform. */
+export type PathTemplateRuntime = NonNullable<Parameters<typeof getPathRoots>[0]> & {
+    getEnv(key: string): string | undefined;
+    readonly localEnvironment: {
+        getPlatform?(): string;
+    };
+};
+/**
+ * The home-side template roots of `runtime`'s host: `paths/roots` userHome,
+ * and the config homes its environment captured (`XDG_CONFIG_HOME`,
+ * `APPDATA`: OS facts like `HOME`), else their platform definitions under the
+ * user home.
+ */
+export declare function hostTemplateRoots(runtime: PathTemplateRuntime): Omit<PathTemplateRoots, 'projectDir'>;
+/**
+ * Resolve path template variables for external integration.
+ *
+ * Supports: ${HOME}, ${CWD}, ${XDG_CONFIG_HOME}, ${APPDATA}. `${CWD}` and a
+ * relative result resolve against the project directory, which must be given.
+ */
+export declare function resolvePathTemplate(template: string, roots: PathTemplateRoots): string;
+//# sourceMappingURL=path-template.d.ts.map

package/dist/external-tool/path-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-template.d.ts","sourceRoot":"","sources":["../../src/external-tool/path-template.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,+BAA+B;AAC/B,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAEhE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,GAAG,WAAW,CASnG;AAED,qGAAqG;AACrG,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;IACnF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,gBAAgB,EAAE;QAAE,WAAW,CAAC,IAAI,MAAM,CAAA;KAAE,CAAC;CACtD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAQrG;AAgBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAQtF"}

package/dist/external-tool/path-template.js

@@ -0,0 +1,65 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { getPathRoots } from '@vibesdotdev/paths';
+import { isAbsolute, join, resolve } from '@vibesdotdev/filesystem';
+/**
+ * Map a host platform to a manifest platform key. Any non-darwin, non-win32
+ * POSIX (freebsd, openbsd, …) is `linux`, so detection and config resolution
+ * agree on every POSIX host.
+ */
+export function resolvePlatformKey(platform) {
+    return platform === 'darwin' ? 'darwin' : platform === 'win32' ? 'win32' : 'linux';
+}
+/**
+ * The platform key of `runtime`'s host, from its declared host facts. A host
+ * that declares no platform is refused `UNAVAILABLE` `host-platform-undeclared`.
+ */
+export function hostPlatformKey(runtime) {
+    const platform = runtime.localEnvironment.getPlatform?.();
+    if (platform === undefined) {
+        throw new CapabilityError('The runtime host declares no platform.', 'UNAVAILABLE', {
+            reason: 'host-platform-undeclared',
+            retryable: false
+        });
+    }
+    return resolvePlatformKey(platform);
+}
+/**
+ * The home-side template roots of `runtime`'s host: `paths/roots` userHome,
+ * and the config homes its environment captured (`XDG_CONFIG_HOME`,
+ * `APPDATA`: OS facts like `HOME`), else their platform definitions under the
+ * user home.
+ */
+export function hostTemplateRoots(runtime) {
+    const { userHome } = getPathRoots(runtime);
+    return {
+        platform: hostPlatformKey(runtime),
+        userHome,
+        configHome: runtime.getEnv('XDG_CONFIG_HOME')?.trim() || join(userHome, '.config'),
+        appData: runtime.getEnv('APPDATA')?.trim() || join(userHome, 'AppData', 'Roaming')
+    };
+}
+function requireProjectDir(template, roots) {
+    const projectDir = roots.projectDir?.trim();
+    if (projectDir)
+        return projectDir;
+    throw new CapabilityError(`The path template ${template} is project-relative and no project directory was given.`, 'INVALID_INPUT', {
+        reason: 'project-dir-required',
+        recoveryHint: 'Pass the project directory, or run inside a workspace so it is bound.',
+        details: { template }
+    });
+}
+/**
+ * Resolve path template variables for external integration.
+ *
+ * Supports: ${HOME}, ${CWD}, ${XDG_CONFIG_HOME}, ${APPDATA}. `${CWD}` and a
+ * relative result resolve against the project directory, which must be given.
+ */
+export function resolvePathTemplate(template, roots) {
+    const expanded = template
+        .replace(/\$\{HOME\}/g, roots.userHome)
+        .replace(/\$\{CWD\}/g, () => requireProjectDir(template, roots))
+        .replace(/\$\{XDG_CONFIG_HOME\}/g, roots.configHome)
+        .replace(/\$\{APPDATA\}/g, roots.appData);
+    return isAbsolute(expanded) ? expanded : resolve(requireProjectDir(template, roots), expanded);
+}
+//# sourceMappingURL=path-template.js.map

package/dist/external-tool/path-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-template.js","sourceRoot":"","sources":["../../src/external-tool/path-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAwBpE;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IAClD,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AACpF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAsD;IACrF,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC;IAC1D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,eAAe,CAAC,wCAAwC,EAAE,aAAa,EAAE;YAClF,MAAM,EAAE,0BAA0B;YAClC,SAAS,EAAE,KAAK;SAChB,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAQD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA4B;IAC7D,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO;QACN,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC;QAClC,QAAQ;QACR,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC;QAClF,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;KAClF,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB,EAAE,KAAwB;IACpE,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IAC5C,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,MAAM,IAAI,eAAe,CACxB,qBAAqB,QAAQ,0DAA0D,EACvF,eAAe,EACf;QACC,MAAM,EAAE,sBAAsB;QAC9B,YAAY,EAAE,uEAAuE;QACrF,OAAO,EAAE,EAAE,QAAQ,EAAE;KACrB,CACD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,KAAwB;IAC7E,MAAM,QAAQ,GAAG,QAAQ;SACvB,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC;SACtC,OAAO,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;SAC/D,OAAO,CAAC,wBAAwB,EAAE,KAAK,CAAC,UAAU,CAAC;SACnD,OAAO,CAAC,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAE3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC;AAChG,CAAC"}

package/dist/external-tool/runtime.d.ts

@@ -0,0 +1,38 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { ExternalHost } from './interfaces/tool.ts';
+import { type ExternalHostDescriptor } from './schemas/tool.ts';
+import type { ExternalHostManifest } from '../plugins/schemas/manifest.ts';
+export type ExternalRuntimeLoader = () => Promise<{
+    impl: unknown;
+    meta?: {
+        id: string;
+        kind: string;
+        priority: number;
+    };
+}>;
+/** Register provider-owned host metadata and its lazy implementation. */
+export declare function registerExternalHost(runtime: RuntimeRef, descriptor: ExternalHostDescriptor, load: ExternalRuntimeLoader): Promise<void>;
+/** Query the live runtime catalog. This is the only External tool inventory. */
+export declare function listExternalHostDescriptors(runtime: RuntimeRef): ExternalHostDescriptor[];
+/**
+ * The recovery for a hook target no host registers: a harness's hooks fire
+ * wherever it runs, but only a workspace whose composition selects the
+ * provider's External projection registers its host.
+ */
+export declare const UNKNOWN_EXTERNAL_TARGET_HINT: string;
+/** Resolve ids and provider-declared names without a Framework alias table. */
+export declare function resolveExternalHostDescriptor(runtime: RuntimeRef, input: string): ExternalHostDescriptor | undefined;
+/** Provider-declared executable identity, falling back to the canonical runtime id. */
+export declare function externalHostIdentityId(manifest: ExternalHostManifest): string;
+/**
+ * The `external/host` implementation registered under `id`, admitted against
+ * the host contract; one that does not provide it is refused `INVALID_INPUT`
+ * `external-host-implementation-invalid`.
+ */
+export declare function resolveExternalHostImplementation(runtime: RuntimeRef, id: string): Promise<ExternalHost>;
+/** Resolve the selected descriptor's scoped implementation from the runtime. */
+export declare function resolveExternalHost(runtime: RuntimeRef, input: string): Promise<{
+    descriptor: ExternalHostDescriptor;
+    implementation: ExternalHost;
+} | undefined>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/external-tool/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/external-tool/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAgC,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAG3E,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,CAAC;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD,CAAC,CAAC;AAcH,yEAAyE;AACzE,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,sBAAsB,EAClC,IAAI,EAAE,qBAAqB,GACzB,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,gFAAgF;AAChF,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,UAAU,GAAG,sBAAsB,EAAE,CAMzF;AAMD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,QAEsF,CAAC;AAEhI,+EAA+E;AAC/E,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,MAAM,GACX,sBAAsB,GAAG,SAAS,CAMpC;AAED,uFAAuF;AACvF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAE7E;AASD;;;;GAIG;AACH,wBAAsB,iCAAiC,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAW9G;AAED,gFAAgF;AAChF,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,UAAU,EAAE,sBAAsB,CAAC;IAAC,cAAc,EAAE,YAAY,CAAA;CAAE,GAAG,SAAS,CAAC,CAI3F"}

package/dist/external-tool/runtime.js

@@ -0,0 +1,89 @@
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { ExternalHostDescriptorSchema } from "./schemas/tool.js";
+import { resolveExternalCLIProjector } from "../runtime/external-surface-projector.js";
+const consumerConstraint = { constraint: { hardware: ['consumer'] } };
+function hostInputs(descriptor) {
+    return [
+        descriptor.id,
+        descriptor.manifest.shortName,
+        ...(descriptor.manifest.hostAliases ?? [])
+    ]
+        .filter((candidate) => Boolean(candidate?.trim()))
+        .map((candidate) => candidate.trim().toLowerCase());
+}
+/** Register provider-owned host metadata and its lazy implementation. */
+export async function registerExternalHost(runtime, descriptor, load) {
+    const identities = new Set(hostInputs(descriptor));
+    const registeredHosts = runtime
+        .query('external/host')
+        .descriptors()
+        .map((candidate) => ExternalHostDescriptorSchema.parse(candidate));
+    for (const existing of registeredHosts) {
+        const collision = hostInputs(existing).find((candidate) => identities.has(candidate));
+        if (collision) {
+            throw new CapabilityError(`External host '${descriptor.id}' conflicts with '${existing.id}' on runtime identity '${collision}'`, 'CONFLICT', { reason: 'external-host-identity-conflict', retryable: false, details: { id: descriptor.id, existing: existing.id, identity: collision } });
+        }
+    }
+    runtime.registerDescriptor('external/host', descriptor);
+    runtime.registerLoader('external/host', descriptor.id, load, consumerConstraint);
+    const projector = await resolveExternalCLIProjector(runtime);
+    projector?.projectHost(descriptor);
+}
+/** Query the live runtime catalog. This is the only External tool inventory. */
+export function listExternalHostDescriptors(runtime) {
+    return runtime
+        .query('external/host')
+        .enabled()
+        .descriptors()
+        .map((descriptor) => ExternalHostDescriptorSchema.parse(descriptor));
+}
+function matchesToolInput(descriptor, normalized) {
+    return hostInputs(descriptor).includes(normalized);
+}
+/**
+ * The recovery for a hook target no host registers: a harness's hooks fire
+ * wherever it runs, but only a workspace whose composition selects the
+ * provider's External projection registers its host.
+ */
+export const UNKNOWN_EXTERNAL_TARGET_HINT = "This workspace's plugin composition registers no such external host: add the provider's External plugin " +
+    "(its package's `external/plugin` export) to the workspace's vibes.config plugins, then restart the workspace runtime daemon.";
+/** Resolve ids and provider-declared names without a Framework alias table. */
+export function resolveExternalHostDescriptor(runtime, input) {
+    const normalized = input.trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    return listExternalHostDescriptors(runtime).find((descriptor) => matchesToolInput(descriptor, normalized));
+}
+/** Provider-declared executable identity, falling back to the canonical runtime id. */
+export function externalHostIdentityId(manifest) {
+    return manifest.detection.command?.trim() || manifest.id;
+}
+/** The methods every `external/host` implementation provides (the {@link ExternalHost} contract callers rely on). */
+const HOST_METHODS = ['detect', 'checkMcp', 'installMcp', 'getHooksDir', 'getSkillsDir', 'getConfigPath'];
+const ExternalHostImplementationSchema = z.custom((value) => value instanceof Object && HOST_METHODS.every((method) => method in value && Object(value)[method] instanceof Function));
+/**
+ * The `external/host` implementation registered under `id`, admitted against
+ * the host contract; one that does not provide it is refused `INVALID_INPUT`
+ * `external-host-implementation-invalid`.
+ */
+export async function resolveExternalHostImplementation(runtime, id) {
+    const implementation = await runtime.query('external/host').withId(id).resolve();
+    const parsed = ExternalHostImplementationSchema.safeParse(implementation);
+    if (!parsed.success) {
+        throw new CapabilityError('The external/host implementation does not provide the host contract.', 'INVALID_INPUT', {
+            reason: 'external-host-implementation-invalid',
+            retryable: false,
+            details: { id }
+        });
+    }
+    return parsed.data;
+}
+/** Resolve the selected descriptor's scoped implementation from the runtime. */
+export async function resolveExternalHost(runtime, input) {
+    const descriptor = resolveExternalHostDescriptor(runtime, input);
+    if (!descriptor)
+        return undefined;
+    return { descriptor, implementation: await resolveExternalHostImplementation(runtime, descriptor.id) };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/external-tool/runtime.js.map

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

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

@@ -0,0 +1,269 @@
+import * as z from 'zod/v4';
+import { type ExternalHostManifest } from '../../plugins/schemas/manifest.ts';
+export declare const ExternalHostAdapterSupportSchema: z.ZodObject<{
+    adapter: z.ZodString;
+    supported: z.ZodBoolean;
+    config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ExternalHostAdapterSupport = z.infer<typeof ExternalHostAdapterSupportSchema>;
+export declare const ExternalHostDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: 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/host">;
+    manifest: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0">;
+        id: z.ZodString;
+        name: z.ZodString;
+        hostAliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        shortName: z.ZodOptional<z.ZodString>;
+        description: z.ZodString;
+        category: z.ZodEnum<{
+            cli: "cli";
+            "ide-extension": "ide-extension";
+            "ide-native": "ide-native";
+        }>;
+        website: z.ZodURL;
+        platforms: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            all: "all";
+            win32: "win32";
+            darwin: "darwin";
+            linux: "linux";
+        }>>>;
+        configs: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            format: z.ZodEnum<{
+                json: "json";
+                yaml: "yaml";
+                jsonc: "jsonc";
+                toml: "toml";
+            }>;
+            scope: z.ZodEnum<{
+                global: "global";
+                project: "project";
+            }>;
+            platform: z.ZodOptional<z.ZodEnum<{
+                all: "all";
+                win32: "win32";
+                darwin: "darwin";
+                linux: "linux";
+            }>>;
+            mcpPath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        assets: z.ZodOptional<z.ZodObject<{
+            hooks: z.ZodOptional<z.ZodString>;
+            plugins: z.ZodOptional<z.ZodString>;
+            commands: z.ZodOptional<z.ZodString>;
+            agents: z.ZodOptional<z.ZodString>;
+            templates: z.ZodOptional<z.ZodString>;
+            skills: z.ZodOptional<z.ZodString>;
+            settings: z.ZodOptional<z.ZodString>;
+            globalSettings: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        mcp: z.ZodObject<{
+            supported: z.ZodBoolean;
+            transports: z.ZodArray<z.ZodEnum<{
+                http: "http";
+                stdio: "stdio";
+                sse: "sse";
+            }>>;
+            defaultServerName: z.ZodDefault<z.ZodString>;
+            projectConfig: z.ZodDefault<z.ZodBoolean>;
+            envVarsInConfig: z.ZodDefault<z.ZodBoolean>;
+            options: z.ZodOptional<z.ZodObject<{
+                startupTimeout: z.ZodOptional<z.ZodNumber>;
+                toolTimeout: z.ZodOptional<z.ZodNumber>;
+                autoRestart: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        hooks: z.ZodObject<{
+            supported: z.ZodBoolean;
+            events: z.ZodArray<z.ZodEnum<{
+                "session.start": "session.start";
+                "session.end": "session.end";
+                "prompt.submit": "prompt.submit";
+                "tool.before": "tool.before";
+                "tool.after": "tool.after";
+                "context.beforeCompact": "context.beforeCompact";
+                "context.afterCompact": "context.afterCompact";
+                "permission.request": "permission.request";
+                "agent.stop": "agent.stop";
+                "subagent.stop": "subagent.stop";
+                notification: "notification";
+            }>>;
+            nativeEventMap: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<{
+                "session.start": "session.start";
+                "session.end": "session.end";
+                "prompt.submit": "prompt.submit";
+                "tool.before": "tool.before";
+                "tool.after": "tool.after";
+                "context.beforeCompact": "context.beforeCompact";
+                "context.afterCompact": "context.afterCompact";
+                "permission.request": "permission.request";
+                "agent.stop": "agent.stop";
+                "subagent.stop": "subagent.stop";
+                notification: "notification";
+            }>>>;
+            format: z.ZodOptional<z.ZodEnum<{
+                json: "json";
+                typescript: "typescript";
+                shell: "shell";
+                python: "python";
+            }>>;
+            structuredInput: z.ZodDefault<z.ZodBoolean>;
+            canModify: z.ZodDefault<z.ZodBoolean>;
+            trust: z.ZodOptional<z.ZodObject<{
+                step: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        plugins: z.ZodObject<{
+            supported: z.ZodBoolean;
+            format: z.ZodOptional<z.ZodEnum<{
+                typescript: "typescript";
+                python: "python";
+                javascript: "javascript";
+                lua: "lua";
+            }>>;
+            entryPoint: z.ZodOptional<z.ZodString>;
+            manifestFile: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        skills: z.ZodDefault<z.ZodObject<{
+            supported: z.ZodBoolean;
+            format: z.ZodDefault<z.ZodEnum<{
+                "agents-md": "agents-md";
+            }>>;
+            projectScoped: z.ZodDefault<z.ZodBoolean>;
+            globalPath: z.ZodOptional<z.ZodString>;
+            projectPath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        detection: z.ZodObject<{
+            command: z.ZodOptional<z.ZodString>;
+            altCommands: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            configDir: z.ZodOptional<z.ZodString>;
+            binaryPath: z.ZodOptional<z.ZodString>;
+            versionArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            versionRegex: z.ZodOptional<z.ZodString>;
+            platformPaths: z.ZodOptional<z.ZodObject<{
+                darwin: z.ZodOptional<z.ZodObject<{
+                    binaryPath: z.ZodOptional<z.ZodString>;
+                    configDir: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                linux: z.ZodOptional<z.ZodObject<{
+                    binaryPath: z.ZodOptional<z.ZodString>;
+                    configDir: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                win32: z.ZodOptional<z.ZodObject<{
+                    binaryPath: z.ZodOptional<z.ZodString>;
+                    configDir: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            extensionMatch: z.ZodOptional<z.ZodObject<{
+                dir: z.ZodString;
+                prefixes: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        launch: z.ZodOptional<z.ZodObject<{
+            defaultMode: z.ZodDefault<z.ZodString>;
+            modes: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+                command: z.ZodOptional<z.ZodString>;
+                argv: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    when: z.ZodString;
+                    args: z.ZodArray<z.ZodString>;
+                }, z.core.$strip>]>>;
+                stdin: z.ZodDefault<z.ZodEnum<{
+                    null: "null";
+                    inherit: "inherit";
+                }>>;
+                structuredOutput: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodString;
+                    schemaTarget: z.ZodOptional<z.ZodEnum<{
+                        "draft-2020-12": "draft-2020-12";
+                        "draft-7": "draft-7";
+                    }>>;
+                    wrap: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>]>>;
+        }, z.core.$strip>>;
+        integration: z.ZodObject<{
+            mcp: z.ZodOptional<z.ZodObject<{
+                installer: z.ZodOptional<z.ZodString>;
+                configTemplate: z.ZodOptional<z.ZodRecord<z.ZodString, 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>>>>;
+            }, z.core.$strip>>;
+            hooks: z.ZodOptional<z.ZodObject<{
+                installer: z.ZodOptional<z.ZodString>;
+                templates: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+                    "session.start": "session.start";
+                    "session.end": "session.end";
+                    "prompt.submit": "prompt.submit";
+                    "tool.before": "tool.before";
+                    "tool.after": "tool.after";
+                    "context.beforeCompact": "context.beforeCompact";
+                    "context.afterCompact": "context.afterCompact";
+                    "permission.request": "permission.request";
+                    "agent.stop": "agent.stop";
+                    "subagent.stop": "subagent.stop";
+                    notification: "notification";
+                }> & z.core.$partial, z.ZodString>>;
+                handlerOptions: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+                    "session.start": "session.start";
+                    "session.end": "session.end";
+                    "prompt.submit": "prompt.submit";
+                    "tool.before": "tool.before";
+                    "tool.after": "tool.after";
+                    "context.beforeCompact": "context.beforeCompact";
+                    "context.afterCompact": "context.afterCompact";
+                    "permission.request": "permission.request";
+                    "agent.stop": "agent.stop";
+                    "subagent.stop": "subagent.stop";
+                    notification: "notification";
+                }> & z.core.$partial, z.ZodRecord<z.ZodString, 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>>>>>;
+                hookAdapterId: z.ZodOptional<z.ZodString>;
+                workspaceRootEnv: z.ZodOptional<z.ZodString>;
+                defaultPromptPolicy: z.ZodDefault<z.ZodEnum<{
+                    default: "default";
+                    none: "none";
+                    "custom-only": "custom-only";
+                }>>;
+            }, z.core.$strip>>;
+            plugins: z.ZodOptional<z.ZodObject<{
+                installer: z.ZodOptional<z.ZodString>;
+                template: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            presets: z.ZodOptional<z.ZodObject<{
+                available: z.ZodArray<z.ZodString>;
+                default: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        version: z.ZodDefault<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    adapters: z.ZodArray<z.ZodObject<{
+        adapter: z.ZodString;
+        supported: z.ZodBoolean;
+        config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ExternalHostDescriptor = z.infer<typeof ExternalHostDescriptorSchema>;
+export declare function adapterSupportFromManifest(manifest: ExternalHostManifest): ExternalHostAdapterSupport[];
+export declare function externalHostDescriptorFromManifest(manifest: ExternalHostManifest, overrides?: Partial<Omit<ExternalHostDescriptor, 'kind' | 'manifest' | 'id' | 'name' | 'description'>>): ExternalHostDescriptor;
+export declare function createExternalHostDescriptor(input: Omit<ExternalHostDescriptor, 'kind'> & {
+    kind?: 'external/host';
+}): ExternalHostDescriptor;
+//# sourceMappingURL=tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/external-tool/schemas/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EACN,KAAK,oBAAoB,EAEzB,MAAM,mCAAmC,CAAC;AAM3C,eAAO,MAAM,gCAAgC;;;;iBAK3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAWlF,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,oBAAoB,GAC5B,0BAA0B,EAAE,CAgC9B;AAED,wBAAgB,kCAAkC,CACjD,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,CAAC,EAAE,OAAO,CAClB,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,aAAa,CAAC,CACjF,GACC,sBAAsB,CAYxB;AAED,wBAAgB,4BAA4B,CAC3C,KAAK,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,eAAe,CAAA;CAAE,GACtE,sBAAsB,CAUxB"}

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

@@ -0,0 +1,77 @@
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+import { externalHostManifestSchema } from "../../plugins/schemas/manifest.js";
+import { ExternalAdapterIdSchema } from "../../external-adapter/schemas/adapter.js";
+export const ExternalHostAdapterSupportSchema = z.object({
+    adapter: ExternalAdapterIdSchema,
+    supported: z.boolean(),
+    /** Target-native spec/configuration needed to project this adapter into the tool. */
+    config: z.record(z.string(), z.unknown()).default({})
+});
+export const ExternalHostDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('external/host'),
+    manifest: externalHostManifestSchema,
+    adapters: z.array(ExternalHostAdapterSupportSchema)
+});
+function supportedAdapter(adapter, supported, config) {
+    if (!supported)
+        return undefined;
+    return { adapter, supported, config };
+}
+export function adapterSupportFromManifest(manifest) {
+    const adapters = [
+        supportedAdapter('mcp', manifest.mcp.supported, {
+            capabilities: manifest.mcp,
+            configs: manifest.configs
+                .filter((config) => Boolean(config.mcpPath))
+                .map((config) => ({
+                path: config.path,
+                format: config.format,
+                scope: config.scope,
+                platform: config.platform,
+                mcpPath: config.mcpPath
+            })),
+            integration: manifest.integration.mcp
+        }),
+        supportedAdapter('skills', manifest.skills.supported, {
+            capabilities: manifest.skills,
+            assets: { skills: manifest.assets?.skills }
+        }),
+        supportedAdapter('hooks', manifest.hooks.supported, {
+            capabilities: manifest.hooks,
+            assets: { hooks: manifest.assets?.hooks },
+            integration: manifest.integration.hooks
+        }),
+        supportedAdapter('plugins', manifest.plugins.supported, {
+            capabilities: manifest.plugins,
+            assets: { plugins: manifest.assets?.plugins },
+            integration: manifest.integration.plugins
+        })
+    ];
+    return adapters.filter((adapter) => Boolean(adapter));
+}
+export function externalHostDescriptorFromManifest(manifest, overrides) {
+    return createExternalHostDescriptor({
+        id: manifest.id,
+        name: manifest.name,
+        description: manifest.description,
+        tags: ['external', 'host', 'dev'],
+        hardware: ['consumer'],
+        enabled: true,
+        manifest,
+        adapters: adapterSupportFromManifest(manifest),
+        ...overrides
+    });
+}
+export function createExternalHostDescriptor(input) {
+    const result = ExternalHostDescriptorSchema.safeParse({
+        ...input,
+        kind: 'external/host'
+    });
+    if (!result.success) {
+        const issues = result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join(', ');
+        throw new Error(`Invalid external/host descriptor '${input.id}': ${issues}`);
+    }
+    return result.data;
+}
+//# sourceMappingURL=tool.js.map

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

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

package/dist/external.plugin.d.ts

@@ -0,0 +1,4 @@
+export { enforceFileAccessRetention, FILE_ACCESS_RETENTION_INTERVAL_MS, AGENT_ROSTER_HEARTBEAT_INTERVAL_MS, FILE_ACCESS_RETENTION_TIMEOUT_MS, AGENT_ROSTER_HEARTBEAT_TIMEOUT_MS } from './client/lifecycle.ts';
+export declare const externalPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default externalPlugin;
+//# sourceMappingURL=external.plugin.d.ts.map

package/dist/external.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.plugin.d.ts","sourceRoot":"","sources":["../src/external.plugin.ts"],"names":[],"mappings":"AAqCA,OAAO,EAAE,0BAA0B,EAAE,iCAAiC,EAAE,kCAAkC,EAAE,gCAAgC,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AA0D/M,eAAO,MAAM,cAAc,6CA8NzB,CAAC;AAEH,eAAe,cAAc,CAAC"}