@a1st/aix-core 0.0.3

package/dist/json.js

@@ -0,0 +1,123 @@
+/**
+ * Deep merge two JSON objects. By default:
+ * - Objects are recursively merged
+ * - Arrays and primitives are replaced (new value wins)
+ *
+ * Use the `resolver` option to customize merge behavior per-key.
+ *
+ * @example
+ * ```ts
+ * // Default behavior
+ * deepMergeJson({ a: { x: 1 } }, { a: { y: 2 } })
+ * // => { a: { x: 1, y: 2 } }
+ *
+ * // With custom resolver - replace entire object at specific path
+ * deepMergeJson(base, override, {
+ *   resolver: ({ path }) => path[0] === 'servers' ? 'replace' : undefined
+ * })
+ * ```
+ */
+export function deepMergeJson(base, override, options = {}) {
+    return mergeRecursive(base, override, [], options.resolver);
+}
+function mergeRecursive(base, override, path, resolver) {
+    const result = { ...base };
+    for (const [key, newValue] of Object.entries(override)) {
+        const oldValue = result[key], context = { key, path, oldValue, newValue }, strategy = resolver?.(context) ?? getDefaultStrategy(oldValue, newValue);
+        switch (strategy) {
+            case 'keep':
+                // Keep old value, do nothing
+                break;
+            case 'replace':
+                // Replace entirely with new value
+                result[key] = newValue;
+                break;
+            case 'merge':
+            default:
+                // Default merge behavior
+                if (isPlainObject(newValue)) {
+                    if (isPlainObject(oldValue)) {
+                        result[key] = mergeRecursive(oldValue, newValue, [...path, key], resolver);
+                    }
+                    else {
+                        result[key] = newValue;
+                    }
+                }
+                else {
+                    result[key] = newValue;
+                }
+                break;
+        }
+    }
+    return result;
+}
+/**
+ * Determine the default merge strategy based on value types.
+ */
+function getDefaultStrategy(oldValue, newValue) {
+    // If both are objects, merge them
+    if (isPlainObject(oldValue) && isPlainObject(newValue)) {
+        return 'merge';
+    }
+    // Otherwise replace (arrays, primitives, type mismatches)
+    return 'replace';
+}
+/**
+ * Check if a value is a plain object (not null, not array).
+ */
+function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/**
+ * Create a merge resolver that replaces values at specific paths. Paths are matched by joining with
+ * dots, e.g., `['mcpServers', '*']` matches any key under `mcpServers`.
+ *
+ * @example
+ * ```ts
+ * // Replace entire MCP server objects instead of merging them
+ * const resolver = createPathResolver({
+ *   'mcpServers.*': 'replace',
+ *   'context_servers.*': 'replace',
+ * });
+ * ```
+ */
+export function createPathResolver(rules) {
+    return ({ key, path }) => {
+        const fullPath = [...path, key].join('.');
+        // Check for exact match first
+        if (rules[fullPath]) {
+            return rules[fullPath];
+        }
+        // Check for wildcard matches (e.g., 'mcpServers.*')
+        for (const [pattern, strategy] of Object.entries(rules)) {
+            if (matchesPattern(fullPath, pattern)) {
+                return strategy;
+            }
+        }
+        return undefined;
+    };
+}
+/**
+ * Match a path against a pattern with wildcard support.
+ * - `*` matches any single segment
+ * - `**` matches any number of segments (not implemented yet)
+ */
+function matchesPattern(path, pattern) {
+    const pathParts = path.split('.'), patternParts = pattern.split('.');
+    if (pathParts.length !== patternParts.length) {
+        return false;
+    }
+    return patternParts.every((part, i) => part === '*' || part === pathParts[i]);
+}
+/**
+ * Pre-built merge resolver for MCP config files. Replaces entire server objects instead of merging
+ * them, since a server definition from aix should completely override any existing definition with
+ * the same name.
+ *
+ * Works with both standard MCP format (`mcpServers.*`) and Zed format (`context_servers.*`).
+ */
+export const mcpConfigMergeResolver = createPathResolver({
+    'mcpServers.*': 'replace',
+    'context_servers.*': 'replace',
+});
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

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

package/dist/loader.d.ts

@@ -0,0 +1,35 @@
+import { type AiJsonConfig } from '@a1st/aix-schema';
+export interface LoadedConfig {
+    path: string;
+    config: AiJsonConfig;
+    source: 'file' | 'package.json' | 'remote';
+    /** Warning messages generated during config loading */
+    warnings?: string[];
+    /** Path to ai.local.json if it was merged */
+    localPath?: string;
+    /** Whether local overrides were applied */
+    hasLocalOverrides?: boolean;
+}
+export interface LoadConfigOptions {
+    /** Explicit path to local config file (existing behavior) */
+    explicitPath?: string;
+    /** Remote URL, git shorthand, or local path to load config from */
+    remoteSource?: string;
+    /** Starting directory for discovery and relative path resolution */
+    startDir?: string;
+}
+/**
+ * Load config from various sources: remote URL, git shorthand, local path, or discovery.
+ * @param options - Load options (new API)
+ * @param explicitPath - Deprecated: use options.explicitPath instead
+ * @param startDir - Deprecated: use options.startDir instead
+ */
+export declare function loadConfig(options?: LoadConfigOptions | string, startDir?: string): Promise<LoadedConfig | undefined>;
+/**
+ * Load config or throw if not found.
+ * @param options - Load options (new API)
+ * @param explicitPath - Deprecated: use options.explicitPath instead
+ * @param startDir - Deprecated: use options.startDir instead
+ */
+export declare function requireConfig(options?: LoadConfigOptions | string, startDir?: string): Promise<LoadedConfig>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AACA,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AASpF,MAAM,WAAW,YAAY;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,QAAQ,CAAC;IAC3C,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAC/B,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC7B,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,EACpC,QAAQ,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CA4BnC;AAkID;;;;;GAKG;AACH,wBAAsB,aAAa,CAChC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,EACpC,QAAQ,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC,CAWvB"}

package/dist/loader.js

@@ -0,0 +1,147 @@
+import { dirname } from 'pathe';
+import { parseConfig, parseLocalConfig } from '@a1st/aix-schema';
+import { discoverConfig, parseConfigContent } from './discovery.js';
+import { resolveExtends } from './inheritance.js';
+import { ConfigNotFoundError, ConfigParseError } from './errors.js';
+import { extractValidationIssues, toConfigValidationError } from './format-error.js';
+import { loadFromSource } from './remote-loader.js';
+import { mergeConfigs } from './merge.js';
+/**
+ * Load config from various sources: remote URL, git shorthand, local path, or discovery.
+ * @param options - Load options (new API)
+ * @param explicitPath - Deprecated: use options.explicitPath instead
+ * @param startDir - Deprecated: use options.startDir instead
+ */
+export async function loadConfig(options, startDir) {
+    // Handle legacy API: loadConfig(explicitPath?, startDir?)
+    let opts;
+    if (typeof options === 'string' || options === undefined) {
+        opts = {
+            explicitPath: options,
+            startDir: startDir ?? process.cwd(),
+        };
+    }
+    else {
+        opts = { startDir: process.cwd(), ...options };
+    }
+    const { explicitPath, remoteSource, startDir: cwd = process.cwd() } = opts;
+    // If remoteSource is provided, load from URL/git/path
+    if (remoteSource) {
+        return loadFromRemoteSource(remoteSource, cwd);
+    }
+    // Existing discovery behavior
+    const discovered = await discoverConfig(cwd, explicitPath);
+    if (!discovered) {
+        return undefined;
+    }
+    return loadFromDiscovered(discovered);
+}
+/**
+ * Load config from a remote source (URL, git shorthand, or local path).
+ */
+async function loadFromRemoteSource(source, cwd) {
+    const remote = await loadFromSource(source, cwd), resolved = await resolveExtends(remote.content, {
+        baseDir: remote.baseUrl,
+        isRemote: remote.isRemote,
+    });
+    let validated;
+    try {
+        validated = parseConfig(resolved);
+    }
+    catch (error) {
+        const validationError = toConfigValidationError(error);
+        if (validationError) {
+            throw validationError;
+        }
+        throw new ConfigParseError(error instanceof Error ? error.message : String(error), source);
+    }
+    // Map source type to LoadedConfig source
+    const sourceType = remote.source === 'local' ? 'file' : 'remote';
+    return {
+        path: source,
+        config: validated,
+        source: sourceType,
+    };
+}
+/**
+ * Merge local config overrides into a base config.
+ * @returns The merged config and whether local overrides were applied
+ */
+function mergeLocalOverrides(baseConfig, localContent, localPath) {
+    const localParsed = parseConfigContent(localContent);
+    try {
+        const localValidated = parseLocalConfig(localParsed);
+        return {
+            config: mergeConfigs(baseConfig, localValidated),
+            hasLocalOverrides: true,
+        };
+    }
+    catch (error) {
+        if (error instanceof Error && 'issues' in error) {
+            const zodError = error, issues = extractValidationIssues(zodError, localParsed);
+            throw new ConfigParseError('Validation failed', localPath, issues);
+        }
+        if (error instanceof Error) {
+            throw new ConfigParseError(error.message, localPath);
+        }
+        throw error;
+    }
+}
+/**
+ * Load config from a discovered local config.
+ */
+async function loadFromDiscovered(discovered) {
+    try {
+        const parsed = parseConfigContent(discovered.content), baseDir = dirname(discovered.path), resolved = await resolveExtends(parsed, { baseDir });
+        let validated = parseConfig(resolved);
+        const warnings = [];
+        if (discovered.packageJsonAlsoHasAi) {
+            warnings.push('Both ai.json and package.json "ai" field exist. Using ai.json (package.json "ai" field is ignored).');
+        }
+        // Merge local overrides if present
+        let localPath;
+        let hasLocalOverrides = false;
+        if (discovered.localContent) {
+            const localFilePath = discovered.localPath ?? 'ai.local.json', merged = mergeLocalOverrides(validated, discovered.localContent, localFilePath);
+            validated = merged.config;
+            localPath = discovered.localPath;
+            hasLocalOverrides = merged.hasLocalOverrides;
+        }
+        return {
+            path: discovered.path,
+            config: validated,
+            source: discovered.source,
+            ...(warnings.length > 0 && { warnings }),
+            ...(localPath && { localPath }),
+            ...(hasLocalOverrides && { hasLocalOverrides }),
+        };
+    }
+    catch (error) {
+        const validationError = toConfigValidationError(error);
+        if (validationError) {
+            throw validationError;
+        }
+        if (error instanceof ConfigParseError) {
+            throw error;
+        }
+        if (error instanceof Error) {
+            throw new ConfigParseError(error.message, discovered.path);
+        }
+        throw error;
+    }
+}
+/**
+ * Load config or throw if not found.
+ * @param options - Load options (new API)
+ * @param explicitPath - Deprecated: use options.explicitPath instead
+ * @param startDir - Deprecated: use options.startDir instead
+ */
+export async function requireConfig(options, startDir) {
+    const result = await loadConfig(options, startDir);
+    if (!result) {
+        const searchPath = typeof options === 'string' ? options : (options?.explicitPath ?? options?.remoteSource);
+        throw new ConfigNotFoundError(searchPath);
+    }
+    return result;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/mcp/env.d.ts

@@ -0,0 +1,28 @@
+export interface EnvResolutionOptions {
+    env?: Record<string, string | undefined>;
+    throwOnMissing?: boolean;
+}
+/**
+ * Resolve ${VAR} syntax in a string value
+ */
+export declare function resolveEnvVars(value: string, options?: EnvResolutionOptions): string;
+/**
+ * Resolve ${VAR} syntax in all values of an object
+ */
+export declare function resolveEnvObject(obj: Record<string, string>, options?: EnvResolutionOptions): Record<string, string>;
+/**
+ * Check if a string contains unresolved ${VAR} references
+ */
+export declare function hasUnresolvedEnvVars(value: string): boolean;
+/**
+ * Extract all ${VAR} variable names from a string
+ */
+export declare function extractEnvVarNames(value: string): string[];
+/**
+ * Validate that all referenced env vars are defined
+ */
+export declare function validateEnvVars(value: string, env?: Record<string, string | undefined>): {
+    valid: boolean;
+    missing: string[];
+};
+//# sourceMappingURL=env.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/mcp/env.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAexF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,OAAO,GAAE,oBAAyB,GAClC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIxB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAI1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC5B,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACrD;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAQvC"}

package/dist/mcp/env.js

@@ -0,0 +1,47 @@
+const ENV_VAR_PATTERN = /\$\{([^}]+)\}/g;
+/**
+ * Resolve ${VAR} syntax in a string value
+ */
+export function resolveEnvVars(value, options = {}) {
+    const env = options.env ?? process.env, throwOnMissing = options.throwOnMissing ?? false;
+    return value.replace(ENV_VAR_PATTERN, (match, varName) => {
+        const resolved = env[varName];
+        if (resolved === undefined) {
+            if (throwOnMissing) {
+                throw new Error(`Environment variable not found: ${varName}`);
+            }
+            return match;
+        }
+        return resolved;
+    });
+}
+/**
+ * Resolve ${VAR} syntax in all values of an object
+ */
+export function resolveEnvObject(obj, options = {}) {
+    return Object.fromEntries(Object.entries(obj).map(([key, value]) => [key, resolveEnvVars(value, options)]));
+}
+/**
+ * Check if a string contains unresolved ${VAR} references
+ */
+export function hasUnresolvedEnvVars(value) {
+    return ENV_VAR_PATTERN.test(value);
+}
+/**
+ * Extract all ${VAR} variable names from a string
+ */
+export function extractEnvVarNames(value) {
+    const matches = value.matchAll(new RegExp(ENV_VAR_PATTERN.source, 'g'));
+    return [...matches].map((m) => m[1]).filter((name) => name !== undefined);
+}
+/**
+ * Validate that all referenced env vars are defined
+ */
+export function validateEnvVars(value, env = process.env) {
+    const names = extractEnvVarNames(value), missing = names.filter((name) => env[name] === undefined);
+    return {
+        valid: missing.length === 0,
+        missing,
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/mcp/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/mcp/env.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAOzC;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,UAAgC,EAAE;IAC7E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAChC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;IAEvD,OAAO,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,OAAe,EAAE,EAAE;QAC9D,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;QAE9B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,cAAc,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,mCAAmC,OAAO,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,OAAO,KAAK,CAAC;QAChB,CAAC;QACD,OAAO,QAAQ,CAAC;IACnB,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC7B,GAA2B,EAC3B,UAAgC,EAAE;IAElC,OAAO,MAAM,CAAC,WAAW,CACtB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAClF,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAC/C,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAExE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAC7F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC5B,KAAa,EACb,MAA0C,OAAO,CAAC,GAAG;IAErD,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,EACjC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;IAEhE,OAAO;QACJ,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;QAC3B,OAAO;KACT,CAAC;AACL,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,4 @@
+export { resolveEnvVars, resolveEnvObject, hasUnresolvedEnvVars, extractEnvVarNames, validateEnvVars, type EnvResolutionOptions, } from './env.js';
+export { serverTemplates, getServerTemplate, listServerTemplates, createFromTemplate, } from './templates.js';
+export { getTransport, type McpTransport, type StdioTransport, type HttpTransport } from './normalize.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACJ,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,KAAK,oBAAoB,GAC3B,MAAM,UAAU,CAAC;AAElB,OAAO,EACJ,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,4 @@
+export { resolveEnvVars, resolveEnvObject, hasUnresolvedEnvVars, extractEnvVarNames, validateEnvVars, } from './env.js';
+export { serverTemplates, getServerTemplate, listServerTemplates, createFromTemplate, } from './templates.js';
+export { getTransport } from './normalize.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACJ,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,GAEjB,MAAM,UAAU,CAAC;AAElB,OAAO,EACJ,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAA8D,MAAM,gBAAgB,CAAC"}

package/dist/mcp/normalize.d.ts

@@ -0,0 +1,33 @@
+import type { McpServerConfig } from '@a1st/aix-schema';
+/**
+ * Stdio transport representation (for internal use).
+ */
+export interface StdioTransport {
+    type: 'stdio';
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    shell?: boolean;
+}
+/**
+ * HTTP transport representation (for internal use).
+ */
+export interface HttpTransport {
+    type: 'http';
+    url: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    validateOrigin?: boolean;
+}
+/**
+ * Transport union type (for internal use).
+ */
+export type McpTransport = StdioTransport | HttpTransport;
+/**
+ * Extract transport info from an MCP server config.
+ * - Stdio: { command: "...", args: [...] }
+ * - HTTP: { url: "https://..." }
+ */
+export declare function getTransport(config: McpServerConfig): McpTransport;
+//# sourceMappingURL=normalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/mcp/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,aAAa,CAAC;AAuB1D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CAyBlE"}

package/dist/mcp/normalize.js

@@ -0,0 +1,29 @@
+/**
+ * Extract transport info from an MCP server config.
+ * - Stdio: { command: "...", args: [...] }
+ * - HTTP: { url: "https://..." }
+ */
+export function getTransport(config) {
+    // Use 'in' check for type narrowing
+    if ('command' in config) {
+        const stdio = config;
+        return {
+            type: 'stdio',
+            command: stdio.command,
+            args: stdio.args,
+            env: stdio.env,
+            cwd: stdio.cwd,
+            shell: stdio.shell,
+        };
+    }
+    // Must be HTTP
+    const http = config;
+    return {
+        type: 'http',
+        url: http.url,
+        headers: http.headers,
+        timeout: http.timeout,
+        validateOrigin: http.validateOrigin,
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/mcp/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/mcp/normalize.ts"],"names":[],"mappings":"AAmDA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAuB;IACjD,oCAAoC;IACpC,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAqC,CAAC;QAEpD,OAAO;YACJ,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;SACpB,CAAC;IACL,CAAC;IAED,eAAe;IACf,MAAM,IAAI,GAAG,MAAoC,CAAC;IAElD,OAAO;QACJ,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,cAAc,EAAE,IAAI,CAAC,cAAc;KACrC,CAAC;AACL,CAAC"}

package/dist/mcp/templates.d.ts

@@ -0,0 +1,18 @@
+import type { McpServerConfig } from '@a1st/aix-schema';
+/**
+ * Pre-configured templates for common MCP servers.
+ */
+export declare const serverTemplates: Record<string, Partial<McpServerConfig>>;
+/**
+ * Get a server template by name
+ */
+export declare function getServerTemplate(name: string): Partial<McpServerConfig> | undefined;
+/**
+ * List all available template names
+ */
+export declare function listServerTemplates(): string[];
+/**
+ * Create a server config from a template with overrides
+ */
+export declare function createFromTemplate(templateName: string, overrides?: Partial<McpServerConfig>): McpServerConfig;
+//# sourceMappingURL=templates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/mcp/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,CAiCpE,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,CAEpF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAC/B,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,OAAO,CAAC,eAAe,CAAM,GACxC,eAAe,CAejB"}

package/dist/mcp/templates.js

@@ -0,0 +1,66 @@
+/**
+ * Pre-configured templates for common MCP servers.
+ */
+export const serverTemplates = {
+    github: {
+        command: 'npx',
+        args: ['@modelcontextprotocol/server-github'],
+        env: { GITHUB_TOKEN: '${GITHUB_TOKEN}' },
+    },
+    filesystem: {
+        command: 'npx',
+        args: ['@modelcontextprotocol/server-filesystem'],
+    },
+    postgres: {
+        command: 'npx',
+        args: ['@modelcontextprotocol/server-postgres'],
+        env: { DATABASE_URL: '${DATABASE_URL}' },
+    },
+    sqlite: {
+        command: 'npx',
+        args: ['@modelcontextprotocol/server-sqlite'],
+        env: { SQLITE_PATH: '${SQLITE_PATH}' },
+    },
+    memory: {
+        command: 'npx',
+        args: ['@modelcontextprotocol/server-memory'],
+    },
+    brave: {
+        command: 'npx',
+        args: ['@modelcontextprotocol/server-brave-search'],
+        env: { BRAVE_API_KEY: '${BRAVE_API_KEY}' },
+    },
+    puppeteer: {
+        command: 'npx',
+        args: ['@modelcontextprotocol/server-puppeteer'],
+    },
+};
+/**
+ * Get a server template by name
+ */
+export function getServerTemplate(name) {
+    return serverTemplates[name];
+}
+/**
+ * List all available template names
+ */
+export function listServerTemplates() {
+    return Object.keys(serverTemplates);
+}
+/**
+ * Create a server config from a template with overrides
+ */
+export function createFromTemplate(templateName, overrides = {}) {
+    const template = serverTemplates[templateName];
+    if (!template) {
+        throw new Error(`Unknown server template: ${templateName}`);
+    }
+    if (!('command' in template)) {
+        throw new Error(`Template "${templateName}" is missing required 'command' field`);
+    }
+    return {
+        ...template,
+        ...overrides,
+    };
+}
+//# sourceMappingURL=templates.js.map

package/dist/mcp/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/mcp/templates.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAA6C;IACtE,MAAM,EAAE;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,qCAAqC,CAAC;QAC7C,GAAG,EAAE,EAAE,YAAY,EAAE,iBAAiB,EAAE;KAC1C;IACD,UAAU,EAAE;QACT,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,yCAAyC,CAAC;KACnD;IACD,QAAQ,EAAE;QACP,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,uCAAuC,CAAC;QAC/C,GAAG,EAAE,EAAE,YAAY,EAAE,iBAAiB,EAAE;KAC1C;IACD,MAAM,EAAE;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,qCAAqC,CAAC;QAC7C,GAAG,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE;KACxC;IACD,MAAM,EAAE;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,qCAAqC,CAAC;KAC/C;IACD,KAAK,EAAE;QACJ,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,2CAA2C,CAAC;QACnD,GAAG,EAAE,EAAE,aAAa,EAAE,kBAAkB,EAAE;KAC5C;IACD,SAAS,EAAE;QACR,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,wCAAwC,CAAC;KAClD;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC3C,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IAChC,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAC/B,YAAoB,EACpB,YAAsC,EAAE;IAExC,MAAM,QAAQ,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;IAE/C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4BAA4B,YAAY,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,CAAC,CAAC,SAAS,IAAI,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,aAAa,YAAY,uCAAuC,CAAC,CAAC;IACrF,CAAC;IAED,OAAO;QACJ,GAAG,QAAQ;QACX,GAAG,SAAS;KACK,CAAC;AACxB,CAAC"}

package/dist/merge.d.ts

@@ -0,0 +1,29 @@
+import type { AiJsonConfig } from '@a1st/aix-schema';
+/**
+ * Valid scopes for filtering config sections.
+ */
+export type ConfigScope = 'rules' | 'mcp' | 'skills' | 'editors' | 'prompts';
+/**
+ * Filter a config to only include the specified scopes.
+ * @param config - Full config
+ * @param scopes - Scopes to include (if empty, returns empty partial)
+ * @returns Partial config with only specified sections
+ */
+export declare function filterConfigByScopes(config: AiJsonConfig, scopes: ConfigScope[]): Partial<AiJsonConfig>;
+/**
+ * Merge two AiJsonConfig objects. Remote config wins on conflicts.
+ *
+ * Merge strategy:
+ * - `skills`: Object merge by key, replace entire value on key conflict
+ * - `rules`: Object merge by key, replace entire value on key conflict
+ * - `prompts`: Object merge by key, replace entire value on key conflict
+ * - `mcp`: Object merge by key, replace entire value on key conflict
+ * - `editors`: Object merge by key, deep merge on key conflict
+ * - `$schema`, `extends`: Remote wins
+ *
+ * @param local - Existing local config
+ * @param remote - Remote config to merge in (may be partial if scope-filtered)
+ * @returns Merged config
+ */
+export declare function mergeConfigs(local: AiJsonConfig, remote: Partial<AiJsonConfig>): AiJsonConfig;
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAA8B,MAAM,kBAAkB,CAAC;AAGjF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7E;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACjC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,WAAW,EAAE,GACrB,OAAO,CAAC,YAAY,CAAC,CAsCvB;AAiDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAyD7F"}