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

package/dist/pack/build.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Build agent packs from runtime tool catalog + external tier definitions.
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { ExternalHostManifest } from '../plugins/schemas/manifest.ts';
+import { type ToolTier } from '../schemas/tiers.ts';
+import type { AgentPack, AgentPackProfile } from './schema.ts';
+export interface BuildAgentPackOptions {
+    runtime: VibesRuntime;
+    hostId: string;
+    manifest: ExternalHostManifest;
+    tier?: ToolTier;
+    /** MCP catalog (`full` | `minimal` | `presence` | `code`). Defaults to full. */
+    mcpClientId?: string;
+    profile?: AgentPackProfile;
+    vibesPath?: string;
+    /** Absolute project root the install names; pins the MCP server with `--workspace-root`. */
+    projectDir?: string;
+    /**
+     * The bound workspace root, whose local MCP host an http server config
+     * dials. Required for a local http transport.
+     */
+    workspaceRoot?: string;
+    /**
+     * The declared hosted `mcp` service origin (`resolveHostedMcpOrigin`), which
+     * a non-local http server config dials.
+     */
+    hostedMcpOrigin?: string;
+    /**
+     * The local MCP URL the caller resolved through the runtime
+     * (`installLocalMcpUrl`), which a local http server config dials.
+     */
+    localMcpUrl?: string;
+    agentsMd?: string | null;
+    authToken?: string;
+    transport?: 'stdio' | 'http' | 'sse';
+}
+/** Build a validated agent pack synchronously, preserving the existing host-entry contract. */
+export declare function buildAgentPack(options: BuildAgentPackOptions): AgentPack;
+/** Build a pack after resolving local MCP claims through the handed runtime. */
+export declare function buildAgentPackAsync(options: BuildAgentPackOptions): Promise<AgentPack>;
+/**
+ * Skill filter for {@link generateSkills} from a pack.
+ */
+export declare function skillFilterFromPack(pack: AgentPack): {
+    ids: string[];
+} | undefined;
+//# sourceMappingURL=build.d.ts.map

package/dist/pack/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/pack/build.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAS3E,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EACX,SAAS,EACT,gBAAgB,EAGhB,MAAM,aAAa,CAAC;AAOrB,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;CACrC;AA0HD,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,CA0BxE;AAED,gFAAgF;AAChF,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAS5F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAGlF"}

package/dist/pack/build.js

@@ -0,0 +1,171 @@
+/**
+ * Build agent packs from runtime tool catalog + external tier definitions.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { getPathRoots } from '@vibesdotdev/paths';
+import { buildMcpIdentityEnv, getMcpEnvironmentConfig, mcpEnvironmentTier, pinWorkspaceRoot, resolveLocalMcpUrlForRuntime } from "../plugins/installers/mcp/environment.js";
+import { isToolInTier } from "../schemas/tiers.js";
+import { AgentPackProfileSchema, AgentPackSchema } from "./schema.js";
+import { hookEntriesFromEvents } from "./emitters/hooks.js";
+import { splitCommand } from "../config/binary-detection.js";
+import { externalHostIdentityId } from "../external-tool/runtime.js";
+import { hostPlatformKey } from "../external-tool/path-template.js";
+function inferProfile(manifest) {
+    const declared = AgentPackProfileSchema.safeParse(manifest.metadata?.agentPackProfile);
+    if (declared.success)
+        return declared.data;
+    switch (manifest.category) {
+        case 'cli':
+            return manifest.hooks.supported ? 'cli-hooks-rich' : 'ide-mcp-first';
+        case 'ide-native':
+        case 'ide-extension':
+            return 'ide-mcp-first';
+        default:
+            return 'ide-mcp-first';
+    }
+}
+function toolIdToSkillName(toolId) {
+    const normalized = toolId.replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+    return normalized.length > 0 ? normalized.slice(0, 64) : 'vibes-tool';
+}
+/** The `tools/tool` descriptor fields a pack skill entry reads. */
+const PackToolDescriptorSchema = z.object({
+    id: z.string().min(1),
+    description: z.string().optional(),
+    name: z.string().optional()
+});
+function listPackSkills(runtime, tier) {
+    if (!runtime.hasKind('tools/tool'))
+        return [];
+    const skills = [];
+    for (const candidate of runtime.query('tools/tool').enabled().descriptors()) {
+        // One malformed descriptor is skipped, never the whole pack.
+        const parsed = PackToolDescriptorSchema.safeParse(candidate);
+        if (!parsed.success)
+            continue;
+        const descriptor = parsed.data;
+        if (!isToolInTier(descriptor.id, tier))
+            continue;
+        const skillName = toolIdToSkillName(descriptor.id);
+        skills.push({
+            toolId: descriptor.id,
+            skillName,
+            description: descriptor.description ?? descriptor.name ?? descriptor.id,
+            tier
+        });
+    }
+    return skills;
+}
+function buildMcpServer(manifest, options) {
+    const serverName = manifest.mcp.defaultServerName ?? 'vibes';
+    // The MCP origin follows the host's declared environment tier, the SAME
+    // fact getEnvironmentConfig reads: a local tier dials the workspace's MCP
+    // host, a non-local tier the declared hosted `mcp` service the caller resolved.
+    const environmentTier = mcpEnvironmentTier(options.runtime.declaredScope);
+    if (options.hostedMcpOrigin)
+        environmentTier.hostedMcpOrigin = options.hostedMcpOrigin;
+    const catalogId = options.mcpClientId ?? 'full';
+    const identityId = externalHostIdentityId(manifest);
+    const { userHome, vibesHome } = getPathRoots(options.runtime);
+    const environment = {
+        ...environmentTier,
+        userHome,
+        vibesHome,
+        platform: hostPlatformKey(options.runtime)
+    };
+    if (options.localMcpUrl)
+        environment.localMcpUrl = options.localMcpUrl;
+    if (options.workspaceRoot)
+        environment.workspaceRoot = options.workspaceRoot;
+    const envConfig = getMcpEnvironmentConfig(environment, catalogId, identityId);
+    const transport = options.transport ?? manifest.mcp.transports[0] ?? 'stdio';
+    if (transport === 'http' && !envConfig.httpUrl) {
+        throw environmentTier.isLocal
+            ? new CapabilityError('A local http MCP config dials the MCP host of a workspace, and none was given.', 'INVALID_INPUT', {
+                reason: 'workspace-root-required',
+                recoveryHint: 'Pass the workspace root, or install from inside a workspace.'
+            })
+            : new CapabilityError('A hosted http MCP config dials the declared mcp service, and this host declares none.', 'NOT_FOUND', {
+                reason: 'hosted-mcp-undeclared',
+                recoveryHint: "Select a service catalog that declares the 'mcp' infra/service for this environment."
+            });
+    }
+    const sourceCommand = options.vibesPath ? splitCommand(options.vibesPath.trim()) : [];
+    const command = sourceCommand[0] ?? envConfig.command;
+    const args = pinWorkspaceRoot([...(sourceCommand.length > 0 ? sourceCommand.slice(1) : []), ...envConfig.args], options.projectDir);
+    // Identity env is always written from provider descriptor data. VIBES_HOME
+    // pins the runtime's vibes home; a known project root is pinned in argv.
+    const identityEnv = buildMcpIdentityEnv({
+        clientId: options.hostId,
+        harnessId: identityId,
+        agentId: identityId,
+        catalogId,
+        vibesHome
+    });
+    // No bearer is published into the server env (R3): the spawned `vibes` MCP
+    // server resolves the caller's bearer from its own host's declared
+    // capability. Only a remote http server gets the explicit token, as its
+    // Authorization header below.
+    const env = { ...identityEnv };
+    const server = {
+        name: serverName,
+        transport,
+        command,
+        args,
+        env
+    };
+    if (transport === 'http' && envConfig.httpUrl) {
+        server.url = envConfig.httpUrl;
+        if (options.authToken) {
+            server.headers = { Authorization: `Bearer ${options.authToken}` };
+        }
+    }
+    return server;
+}
+/** Build a validated agent pack synchronously, preserving the existing host-entry contract. */
+export function buildAgentPack(options) {
+    const tier = options.tier ?? 'default';
+    const profile = options.profile ?? inferProfile(options.manifest);
+    const mcpServers = options.manifest.mcp.supported
+        ? [buildMcpServer(options.manifest, options)]
+        : [];
+    const hooks = options.manifest.hooks.supported && options.manifest.hooks.events.length > 0
+        ? hookEntriesFromEvents(options.manifest.hooks.events, {
+            vibesPath: options.vibesPath
+        })
+        : [];
+    const pack = {
+        version: 1,
+        hostId: options.hostId,
+        profile,
+        tier,
+        context: options.agentsMd !== undefined ? { agentsMd: options.agentsMd } : undefined,
+        skills: listPackSkills(options.runtime, tier),
+        mcpServers,
+        hooks,
+        permissions: []
+    };
+    return AgentPackSchema.parse(pack);
+}
+/** Build a pack after resolving local MCP claims through the handed runtime. */
+export async function buildAgentPackAsync(options) {
+    if (!options.manifest.mcp.supported || options.localMcpUrl || !options.workspaceRoot ||
+        !mcpEnvironmentTier(options.runtime.declaredScope).isLocal)
+        return buildAgentPack(options);
+    const { vibesHome } = getPathRoots(options.runtime);
+    const localMcpUrl = await resolveLocalMcpUrlForRuntime(options.runtime, {
+        workspaceRoot: options.workspaceRoot,
+        vibesHome
+    });
+    return buildAgentPack({ ...options, localMcpUrl });
+}
+/**
+ * Skill filter for {@link generateSkills} from a pack.
+ */
+export function skillFilterFromPack(pack) {
+    if (pack.skills.length === 0)
+        return undefined;
+    return { ids: pack.skills.map((s) => s.toolId) };
+}
+//# sourceMappingURL=build.js.map

package/dist/pack/build.js.map

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

package/dist/pack/emitters/hooks.d.ts

@@ -0,0 +1,14 @@
+/** Hook entries for agent packs, projected from provider descriptor events. */
+import type { HookEvent } from '../../plugins/schemas/manifest.ts';
+import type { AgentPackHookEntry } from '../schema.ts';
+export interface HookEntriesOptions {
+    vibesPath?: string;
+}
+export declare function hookEntriesFromEvents(events: readonly HookEvent[], options?: HookEntriesOptions): AgentPackHookEntry[];
+/**
+ * Shell hook script body delegating to the vendor-neutral Vibes hook bridge:
+ * the shared dispatcher under `vibesHome` (the runtime's `paths/roots`), baked
+ * in rather than re-derived from the firing process's environment.
+ */
+export declare function shellDelegatorHookScript(vibesHome: string, event: HookEvent, target: string): string;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/pack/emitters/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/pack/emitters/hooks.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,MAAM,WAAW,kBAAkB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,OAAO,GAAE,kBAAuB,GAC9B,kBAAkB,EAAE,CAGtB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,GACZ,MAAM,CAER"}

package/dist/pack/emitters/hooks.js

@@ -0,0 +1,15 @@
+/** Hook entries for agent packs, projected from provider descriptor events. */
+import { hookDelegatorScript, hookDispatchShellPath } from "../../hooks/dispatch-script.js";
+export function hookEntriesFromEvents(events, options = {}) {
+    const vibesPath = options.vibesPath ?? 'vibes';
+    return events.map((event) => ({ event, vibesPath, matcher: '' }));
+}
+/**
+ * Shell hook script body delegating to the vendor-neutral Vibes hook bridge:
+ * the shared dispatcher under `vibesHome` (the runtime's `paths/roots`), baked
+ * in rather than re-derived from the firing process's environment.
+ */
+export function shellDelegatorHookScript(vibesHome, event, target) {
+    return hookDelegatorScript(hookDispatchShellPath(vibesHome), event, target);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/pack/emitters/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/pack/emitters/hooks.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAI/E,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAM5F,MAAM,UAAU,qBAAqB,CACpC,MAA4B,EAC5B,UAA8B,EAAE;IAEhC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC;IAC/C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACvC,SAAiB,EACjB,KAAgB,EAChB,MAAc;IAEd,OAAO,mBAAmB,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAC7E,CAAC"}

package/dist/pack/emitters/json.d.ts

@@ -0,0 +1,10 @@
+/**
+ * JSON MCP block preview for agent packs (Cursor, Antigravity, VS Code, …).
+ */
+import type { ExternalHostManifest } from '../../plugins/schemas/manifest.ts';
+import type { AgentPack } from '../schema.ts';
+/**
+ * Emit a JSON object string for the host MCP config file (mcpServers section).
+ */
+export declare function emitJsonMcpBlock(pack: AgentPack, mcpPath?: string, manifest?: ExternalHostManifest): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/pack/emitters/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/pack/emitters/json.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9C;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,SAAS,EACf,OAAO,SAAe,EACtB,QAAQ,CAAC,EAAE,oBAAoB,GAC7B,MAAM,CAMR"}

package/dist/pack/emitters/json.js

@@ -0,0 +1,17 @@
+/**
+ * JSON MCP block preview for agent packs (Cursor, Antigravity, VS Code, …).
+ */
+import { mcpServerConfigFromPack } from "../mcp.js";
+import { setOwn } from "../../plugins/installers/config-value.js";
+/**
+ * Emit a JSON object string for the host MCP config file (mcpServers section).
+ */
+export function emitJsonMcpBlock(pack, mcpPath = 'mcpServers', manifest) {
+    const servers = {};
+    for (const server of pack.mcpServers)
+        setOwn(servers, server.name, mcpServerConfigFromPack(server, { manifest }));
+    const root = {};
+    setOwn(root, mcpPath, servers);
+    return `${JSON.stringify(root, null, 2)}\n`;
+}
+//# sourceMappingURL=json.js.map

package/dist/pack/emitters/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/pack/emitters/json.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,MAAM,EAAqB,MAAM,0CAA0C,CAAC;AAErF;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC/B,IAAe,EACf,OAAO,GAAG,YAAY,EACtB,QAA+B;IAE/B,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,UAAU;QAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,uBAAuB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAClH,MAAM,IAAI,GAAiB,EAAE,CAAC;IAC9B,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC"}

package/dist/pack/emitters/registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Agent pack emitter registry — manifest-driven MCP/skills/hooks emission.
+ */
+import type { ExternalHostManifest } from '../../plugins/schemas/manifest.ts';
+import type { AgentPack } from '../schema.ts';
+import type { ConfigObject } from '../../plugins/installers/config-value.ts';
+export type PackEmitterSurface = 'mcp' | 'skills' | 'hooks' | 'permissions';
+export interface PackEmitContext {
+    pack: AgentPack;
+    manifest: ExternalHostManifest;
+    /** Prefer global config when installing for user home */
+    global?: boolean;
+}
+/**
+ * Resolve MCP server record for the primary pack server using host manifest rules.
+ */
+export declare function resolveMcpServerConfig(pack: AgentPack, manifest: ExternalHostManifest): ConfigObject | undefined;
+/**
+ * Emit MCP config text for dry-run / docs / snapshot sidecars.
+ */
+export declare function emitMcpBlock(ctx: PackEmitContext): string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/pack/emitters/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/pack/emitters/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAK7E,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAQD;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,oBAAoB,GAC5B,YAAY,GAAG,SAAS,CAI1B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAezD"}

package/dist/pack/emitters/registry.js

@@ -0,0 +1,38 @@
+/**
+ * Agent pack emitter registry — manifest-driven MCP/skills/hooks emission.
+ */
+import { mcpServerConfigFromPack } from "../mcp.js";
+import { emitJsonMcpBlock } from "./json.js";
+import { emitTomlMcpBlock } from "./toml.js";
+import { emitYamlMcpBlock } from "./yaml.js";
+function primaryConfig(manifest, global = true) {
+    return (manifest.configs.find((c) => c.scope === (global ? 'global' : 'project')) ?? manifest.configs[0]);
+}
+/**
+ * Resolve MCP server record for the primary pack server using host manifest rules.
+ */
+export function resolveMcpServerConfig(pack, manifest) {
+    const primary = pack.mcpServers[0];
+    if (!primary)
+        return undefined;
+    return mcpServerConfigFromPack(primary, { manifest });
+}
+/**
+ * Emit MCP config text for dry-run / docs / snapshot sidecars.
+ */
+export function emitMcpBlock(ctx) {
+    const config = primaryConfig(ctx.manifest, ctx.global ?? true);
+    const format = config?.format ?? 'json';
+    const mcpPath = config?.mcpPath ?? 'mcpServers';
+    switch (format) {
+        case 'toml':
+            return emitTomlMcpBlock(ctx.pack, ctx.manifest);
+        case 'yaml':
+            return emitYamlMcpBlock(ctx.pack, ctx.manifest);
+        case 'json':
+        case 'jsonc':
+        default:
+            return emitJsonMcpBlock(ctx.pack, mcpPath, ctx.manifest);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/pack/emitters/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/pack/emitters/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAW7C,SAAS,aAAa,CAAC,QAA8B,EAAE,MAAM,GAAG,IAAI;IACnE,OAAO,CACN,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAChG,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACrC,IAAe,EACf,QAA8B;IAE9B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,uBAAuB,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAoB;IAChD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,MAAM,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,YAAY,CAAC;IAEhD,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,MAAM;YACV,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjD,KAAK,MAAM;YACV,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjD,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC;QACb;YACC,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC;AACF,CAAC"}

package/dist/pack/emitters/toml.d.ts

@@ -0,0 +1,8 @@
+/**
+ * TOML snippet emitter for agent packs (Grok Build, Codex-style hosts).
+ */
+import type { ExternalHostManifest } from '../../plugins/schemas/manifest.ts';
+import type { AgentPack } from '../schema.ts';
+/** Render MCP block as TOML for dry-run / docs. */
+export declare function emitTomlMcpBlock(pack: AgentPack, manifest?: ExternalHostManifest): string;
+//# sourceMappingURL=toml.d.ts.map

package/dist/pack/emitters/toml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toml.d.ts","sourceRoot":"","sources":["../../../src/pack/emitters/toml.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAsB,MAAM,cAAc,CAAC;AAiBlE,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAGzF"}

package/dist/pack/emitters/toml.js

@@ -0,0 +1,28 @@
+/**
+ * TOML snippet emitter for agent packs (Grok Build, Codex-style hosts).
+ */
+import { mcpServerConfigFromPack, mcpServerFields, snippetKey } from "../mcp.js";
+function formatTomlServer(server, manifest) {
+    const fields = mcpServerFields(mcpServerConfigFromPack(server, { manifest }));
+    const lines = [`[mcp_servers.${snippetKey(server.name)}]`];
+    if (fields.command !== undefined)
+        lines.push(`command = ${JSON.stringify(fields.command)}`);
+    if (fields.args)
+        lines.push(`args = [${fields.args.map((arg) => JSON.stringify(arg)).join(', ')}]`);
+    if (fields.env) {
+        lines.push('env = {');
+        for (const [key, value] of fields.env)
+            lines.push(`  ${snippetKey(key)} = ${JSON.stringify(value)},`);
+        lines.push('}');
+    }
+    if (fields.url)
+        lines.push(`${fields.url.key} = ${JSON.stringify(fields.url.value)}`);
+    return lines.join('\n');
+}
+/** Render MCP block as TOML for dry-run / docs. */
+export function emitTomlMcpBlock(pack, manifest) {
+    if (pack.mcpServers.length === 0)
+        return '';
+    return pack.mcpServers.map((s) => formatTomlServer(s, manifest)).join('\n\n');
+}
+//# sourceMappingURL=toml.js.map

package/dist/pack/emitters/toml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toml.js","sourceRoot":"","sources":["../../../src/pack/emitters/toml.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEjF,SAAS,gBAAgB,CAAC,MAA0B,EAAE,QAA+B;IACpF,MAAM,MAAM,GAAG,eAAe,CAAC,uBAAuB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,CAAC,gBAAgB,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5F,IAAI,MAAM,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpG,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,MAAM,CAAC,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,gBAAgB,CAAC,IAAe,EAAE,QAA+B;IAChF,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/E,CAAC"}

package/dist/pack/emitters/yaml.d.ts

@@ -0,0 +1,8 @@
+/**
+ * YAML snippet emitter for agent packs (Hermes, Continue-style hosts).
+ */
+import type { ExternalHostManifest } from '../../plugins/schemas/manifest.ts';
+import type { AgentPack } from '../schema.ts';
+/** Render MCP block as YAML for dry-run / docs. */
+export declare function emitYamlMcpBlock(pack: AgentPack, manifest?: ExternalHostManifest): string;
+//# sourceMappingURL=yaml.d.ts.map

package/dist/pack/emitters/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../../src/pack/emitters/yaml.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAsB,MAAM,cAAc,CAAC;AAgBlE,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAGzF"}

package/dist/pack/emitters/yaml.js

@@ -0,0 +1,27 @@
+/**
+ * YAML snippet emitter for agent packs (Hermes, Continue-style hosts).
+ */
+import { mcpServerConfigFromPack, mcpServerFields, snippetKey } from "../mcp.js";
+function formatYamlServer(server, manifest) {
+    const fields = mcpServerFields(mcpServerConfigFromPack(server, { manifest }));
+    const lines = ['mcp_servers:', `  ${snippetKey(server.name)}:`];
+    if (fields.command !== undefined)
+        lines.push(`    command: ${JSON.stringify(fields.command)}`);
+    if (fields.args)
+        lines.push(`    args: [${fields.args.map((arg) => JSON.stringify(arg)).join(', ')}]`);
+    if (fields.env) {
+        lines.push('    env:');
+        for (const [key, value] of fields.env)
+            lines.push(`      ${snippetKey(key)}: ${JSON.stringify(value)}`);
+    }
+    if (fields.url)
+        lines.push(`    ${fields.url.key}: ${JSON.stringify(fields.url.value)}`);
+    return lines.join('\n');
+}
+/** Render MCP block as YAML for dry-run / docs. */
+export function emitYamlMcpBlock(pack, manifest) {
+    if (pack.mcpServers.length === 0)
+        return '';
+    return pack.mcpServers.map((s) => formatYamlServer(s, manifest)).join('\n\n');
+}
+//# sourceMappingURL=yaml.js.map

package/dist/pack/emitters/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../../src/pack/emitters/yaml.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEjF,SAAS,gBAAgB,CAAC,MAA0B,EAAE,QAA+B;IACpF,MAAM,MAAM,GAAG,eAAe,CAAC,uBAAuB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,CAAC,cAAc,EAAE,KAAK,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/F,IAAI,MAAM,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvG,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzG,CAAC;IACD,IAAI,MAAM,CAAC,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,gBAAgB,CAAC,IAAe,EAAE,QAA+B;IAChF,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/E,CAAC"}

package/dist/pack/index.d.ts

@@ -0,0 +1,11 @@
+export { AgentPackSchema, validateAgentPack, type AgentPack, type AgentPackProfile, type AgentPackSkillEntry, type AgentPackMcpServer, type AgentPackHookEntry } from './schema.ts';
+export { buildAgentPack, buildAgentPackAsync, skillFilterFromPack, type BuildAgentPackOptions } from './build.ts';
+export { mcpServerConfigFromPack, type McpServerConfigFromPackOptions } from './mcp.ts';
+export { emitMcpBlock, resolveMcpServerConfig, type PackEmitContext, type PackEmitterSurface } from './emitters/registry.ts';
+export { writeAgentPackSnapshot, type WriteAgentPackSnapshotOptions } from './persist.ts';
+export { runAdapterCodegen, type AdapterCodegenId, type AdapterCodegenOptions } from './adapter-codegen.ts';
+export { hookEntriesFromEvents, shellDelegatorHookScript, type HookEntriesOptions } from './emitters/hooks.ts';
+export { emitTomlMcpBlock } from './emitters/toml.ts';
+export { emitYamlMcpBlock } from './emitters/yaml.ts';
+export { emitJsonMcpBlock } from './emitters/json.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pack/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAClH,OAAO,EACN,uBAAuB,EACvB,KAAK,8BAA8B,EACnC,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,YAAY,EACZ,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,KAAK,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC5G,OAAO,EACN,qBAAqB,EACrB,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/pack/index.js

@@ -0,0 +1,11 @@
+export { AgentPackSchema, validateAgentPack } from "./schema.js";
+export { buildAgentPack, buildAgentPackAsync, skillFilterFromPack } from "./build.js";
+export { mcpServerConfigFromPack } from "./mcp.js";
+export { emitMcpBlock, resolveMcpServerConfig } from "./emitters/registry.js";
+export { writeAgentPackSnapshot } from "./persist.js";
+export { runAdapterCodegen } from "./adapter-codegen.js";
+export { hookEntriesFromEvents, shellDelegatorHookScript } from "./emitters/hooks.js";
+export { emitTomlMcpBlock } from "./emitters/toml.js";
+export { emitYamlMcpBlock } from "./emitters/yaml.js";
+export { emitJsonMcpBlock } from "./emitters/json.js";
+//# sourceMappingURL=index.js.map

package/dist/pack/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pack/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,iBAAiB,EAMjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,EAA8B,MAAM,YAAY,CAAC;AAClH,OAAO,EACN,uBAAuB,EAEvB,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,YAAY,EACZ,sBAAsB,EAGtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAsC,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAqD,MAAM,sBAAsB,CAAC;AAC5G,OAAO,EACN,qBAAqB,EACrB,wBAAwB,EAExB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/pack/mcp.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Apply agent-pack MCP server entries to host config records.
+ */
+import type { ExternalHostManifest } from '../plugins/schemas/manifest.ts';
+import type { AgentPackMcpServer } from './schema.ts';
+import { type ConfigObject } from '../plugins/installers/config-value.ts';
+export interface McpServerConfigFromPackOptions {
+    manifest?: ExternalHostManifest;
+}
+/**
+ * Convert pack MCP server entry to installer server config object.
+ */
+export declare function mcpServerConfigFromPack(server: AgentPackMcpServer, options?: McpServerConfigFromPackOptions): ConfigObject;
+/** The fields a text emitter renders from one server entry. */
+export interface McpServerFields {
+    readonly command?: string;
+    readonly args?: readonly string[];
+    readonly env?: ReadonlyArray<readonly [string, string]>;
+    readonly url?: {
+        readonly key: 'url' | 'serverUrl';
+        readonly value: string;
+    };
+}
+/** Read an entry's renderable fields; values of the wrong shape are left out, never coerced. */
+export declare function mcpServerFields(config: ConfigObject): McpServerFields;
+/** A key as TOML/YAML text: bare when it is letters, digits, `_` or `-`, else JSON-quoted. */
+export declare function snippetKey(key: string): string;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/pack/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/pack/mcp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAiE,KAAK,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAEzI,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAUD;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,8BAAmC,GAC1C,YAAY,CA+Bd;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,GAAG,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,KAAK,GAAG,WAAW,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAiBrE;AAED,8FAA8F;AAC9F,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/pack/mcp.js

@@ -0,0 +1,70 @@
+/**
+ * Apply agent-pack MCP server entries to host config records.
+ */
+import * as z from 'zod/v4';
+import { buildStdioConfig } from "../plugins/installers/mcp/environment.js";
+import { copyConfigObject, isConfigString, ownObject, ownValue, setOwn } from "../plugins/installers/config-value.js";
+/** The manifest metadata this module reads: which key a host's config names an HTTP MCP server's URL by. */
+const HttpUrlKeyMetadataSchema = z.object({ mcpHttpUrlKey: z.enum(['url', 'serverUrl']).optional() });
+function httpUrlKey(manifest) {
+    const metadata = HttpUrlKeyMetadataSchema.safeParse(manifest?.metadata ?? {});
+    return metadata.success ? (metadata.data.mcpHttpUrlKey ?? 'url') : 'url';
+}
+/**
+ * Convert pack MCP server entry to installer server config object.
+ */
+export function mcpServerConfigFromPack(server, options = {}) {
+    const { manifest } = options;
+    if (server.transport === 'http' && server.url) {
+        const config = { type: 'http' };
+        setOwn(config, httpUrlKey(manifest), server.url);
+        if (server.headers)
+            config.headers = { ...server.headers };
+        return config;
+    }
+    // Preserve the full pack env (identity: VIBES_AGENT_ID / VIBES_HOME; a
+    // project root rides argv as --workspace-root). A published bearer never survives this hop (R3):
+    // buildStdioConfig drops it and the stdio server resolves its own.
+    const config = buildStdioConfig({ command: server.command, args: server.args, httpUrl: server.url }, server.env ? { ...server.env } : undefined);
+    const template = manifest?.integration?.mcp?.configTemplate;
+    if (!template)
+        return config;
+    // Host-specific policy (timeouts, required, etc.) supplies defaults, while
+    // the agent pack owns the resolved executable and argv. Reversing this
+    // order silently replaced source-local paths with stale installed binaries.
+    const merged = copyConfigObject(template);
+    for (const [key, value] of Object.entries(config))
+        setOwn(merged, key, value);
+    const templateEnv = ownObject(template, 'env');
+    const configEnv = ownObject(config, 'env');
+    // Pack identity env wins over any stale template env keys.
+    if (templateEnv || configEnv)
+        setOwn(merged, 'env', { ...templateEnv, ...configEnv });
+    return merged;
+}
+/** Read an entry's renderable fields; values of the wrong shape are left out, never coerced. */
+export function mcpServerFields(config) {
+    const fields = {};
+    const command = ownValue(config, 'command');
+    if (isConfigString(command))
+        fields.command = command;
+    const args = ownValue(config, 'args');
+    if (Array.isArray(args))
+        fields.args = args.filter(isConfigString);
+    const env = ownObject(config, 'env');
+    if (env) {
+        fields.env = Object.entries(env).flatMap(([key, value]) => isConfigString(value) ? [[key, value]] : []);
+    }
+    const serverUrl = ownValue(config, 'serverUrl');
+    const url = ownValue(config, 'url');
+    if (isConfigString(serverUrl))
+        fields.url = { key: 'serverUrl', value: serverUrl };
+    else if (isConfigString(url))
+        fields.url = { key: 'url', value: url };
+    return fields;
+}
+/** A key as TOML/YAML text: bare when it is letters, digits, `_` or `-`, else JSON-quoted. */
+export function snippetKey(key) {
+    return /^[A-Za-z0-9_-]+$/.test(key) ? key : JSON.stringify(key);
+}
+//# sourceMappingURL=mcp.js.map