@developerz.ai/aitm 0.0.0

package/dist/config/config-loader.d.ts

@@ -0,0 +1,25 @@
+import { type McpServers } from '../mcp/schema.ts';
+import { type CliOverrides, type ConfigFile, type ResolvedConfig } from './schema.ts';
+type WarnFn = (msg: string) => void;
+export type ConfigLoaderOptions = {
+    warn?: WarnFn;
+};
+export declare class ConfigLoader {
+    private readonly cwd;
+    private readonly homeDir;
+    private readonly env;
+    private readonly warn;
+    constructor(cwd: string, homeDir: string, env: Record<string, string | undefined>, options?: ConfigLoaderOptions);
+    resolve(cliOverrides: CliOverrides): Promise<ResolvedConfig>;
+    readGlobal(): Promise<ConfigFile | null>;
+    readProject(): Promise<ConfigFile | null>;
+    readClaudeProjectMcp(): Promise<McpServers | null>;
+    readClaudeUserMcp(): Promise<McpServers | null>;
+    writeSnapshot(resolved: ResolvedConfig, stateDir: string): Promise<void>;
+    private readMcpEnvelope;
+    private resolveMcpServers;
+    private readConfigFile;
+    private resolveApiKey;
+    private resolveModels;
+}
+export {};

package/dist/config/config-loader.js

@@ -0,0 +1,275 @@
+// docs/config.md §"Resolution order", docs/auth.md §"LLM provider"
+// Only module allowed to read ~/.aitm.json and .ai-task-master/config.json.
+// Merge order: defaults < global < project < env < CLI flags. Frozen snapshot written by writeSnapshot().
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { ZodError, z } from 'zod';
+import { DEFAULT_MODELS } from "../credentials/defaults.js";
+import { atomicWrite } from "../fs/atomic-write.js";
+import { McpServersSchema } from "../mcp/schema.js";
+import { ConfigFileSchema, } from "./schema.js";
+const GLOBAL_FILE = '.aitm.json';
+const PROJECT_DIR = '.ai-task-master';
+const PROJECT_FILE = 'config.json';
+const SNAPSHOT_FILE = 'config.snapshot.json';
+// Claude Code's standard MCP config files. Discovering these lets users plug aitm into
+// the same MCP servers their Claude Code session already uses, without re-declaring them.
+// Refs: https://code.claude.com/docs/en/mcp ("Project scope" = .mcp.json in project root;
+// "User scope" = ~/.claude.json with an mcpServers key).
+const CLAUDE_PROJECT_MCP_FILE = '.mcp.json';
+const CLAUDE_USER_FILE = '.claude.json';
+const KNOWN_KEYS = new Set([
+    'openrouterApiKey',
+    'models',
+    'maxPrs',
+    'maxSessions',
+    'autoMerge',
+    'mergeMethod',
+    'stylePath',
+    'logLevel',
+    'concurrency',
+    'mcpServers',
+]);
+const DEFAULTS = {
+    maxPrs: 5,
+    maxSessions: null,
+    autoMerge: true,
+    mergeMethod: 'squash',
+    stylePath: null,
+    logLevel: 'info',
+    concurrency: 1,
+};
+export class ConfigLoader {
+    cwd;
+    homeDir;
+    env;
+    warn;
+    constructor(cwd, homeDir, env, options) {
+        this.cwd = cwd;
+        this.homeDir = homeDir;
+        this.env = env;
+        this.warn = options?.warn ?? ((msg) => process.stderr.write(`${msg}\n`));
+    }
+    async resolve(cliOverrides) {
+        const global = await this.readGlobal();
+        const project = await this.readProject();
+        const claudeUser = await this.readClaudeUserMcp();
+        const claudeProject = await this.readClaudeProjectMcp();
+        const { apiKey, apiKeySource } = this.resolveApiKey(global, project);
+        if (apiKey === undefined || apiKeySource === undefined) {
+            throw new Error('No OpenRouter API key found. Set OPENROUTER_API_KEY env, or add ' +
+                '"openrouterApiKey" to ~/.aitm.json or ./.ai-task-master/config.json.');
+        }
+        const { mcpServers, mcpServerSources } = this.resolveMcpServers({
+            aitmGlobal: global?.mcpServers,
+            aitmProject: project?.mcpServers,
+            claudeUser,
+            claudeProject,
+        });
+        return {
+            openrouterApiKey: apiKey,
+            apiKeySource,
+            models: this.resolveModels(global, project, cliOverrides),
+            maxPrs: pick(cliOverrides.maxPrs, project?.maxPrs, global?.maxPrs, DEFAULTS.maxPrs),
+            maxSessions: pickNullable(cliOverrides.maxSessions, project?.maxSessions, global?.maxSessions, DEFAULTS.maxSessions),
+            autoMerge: pick(cliOverrides.autoMerge, project?.autoMerge, global?.autoMerge, DEFAULTS.autoMerge),
+            mergeMethod: pick(cliOverrides.mergeMethod, project?.mergeMethod, global?.mergeMethod, DEFAULTS.mergeMethod),
+            stylePath: pickNullable(cliOverrides.stylePath, project?.stylePath, global?.stylePath, DEFAULTS.stylePath),
+            // logLevel is not exposed via CliOverrides — project/global only.
+            logLevel: pick(undefined, project?.logLevel, global?.logLevel, DEFAULTS.logLevel),
+            concurrency: pick(cliOverrides.concurrency, project?.concurrency, global?.concurrency, DEFAULTS.concurrency),
+            mcpServers,
+            mcpServerSources,
+        };
+    }
+    async readGlobal() {
+        return this.readConfigFile(join(this.homeDir, GLOBAL_FILE));
+    }
+    async readProject() {
+        return this.readConfigFile(join(this.cwd, PROJECT_DIR, PROJECT_FILE));
+    }
+    // Read Claude Code's project-scoped MCP file (./.mcp.json). Schema is permissive:
+    // we only extract `mcpServers`, ignore any other keys Claude Code may add.
+    async readClaudeProjectMcp() {
+        return this.readMcpEnvelope(join(this.cwd, CLAUDE_PROJECT_MCP_FILE));
+    }
+    // Read Claude Code's user-scoped config (~/.claude.json) and extract the `mcpServers`
+    // block, if any. ~/.claude.json holds many unrelated keys (auth tokens, history); we
+    // intentionally read it but only consume `mcpServers`.
+    async readClaudeUserMcp() {
+        return this.readMcpEnvelope(join(this.homeDir, CLAUDE_USER_FILE));
+    }
+    // Frozen run snapshot. API key value is replaced by its source label so the
+    // file is safe to inspect; only the resolution source is recorded.
+    async writeSnapshot(resolved, stateDir) {
+        const redacted = {
+            ...resolved,
+            openrouterApiKey: `<from ${resolved.apiKeySource}>`,
+        };
+        const path = join(stateDir, SNAPSHOT_FILE);
+        await atomicWrite(path, `${JSON.stringify(redacted, null, 2)}\n`);
+    }
+    // Reads any JSON file whose only field we care about is `mcpServers` (Claude Code's
+    // .mcp.json or the much larger ~/.claude.json). Missing file → null. Malformed JSON
+    // is a hard error — we don't want to silently ignore a corrupted user file.
+    async readMcpEnvelope(path) {
+        let raw;
+        try {
+            raw = await readFile(path, 'utf8');
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return null;
+            throw err;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`${path}: invalid JSON — ${msg}`);
+        }
+        const envelope = McpEnvelopeSchema.safeParse(parsed);
+        if (!envelope.success) {
+            throw new Error(`${path}: ${formatZodError(envelope.error)}`);
+        }
+        return envelope.data.mcpServers ?? null;
+    }
+    resolveMcpServers(sources) {
+        // Precedence, lowest → highest:
+        //   1. ~/.claude.json (user-scoped Claude Code config)
+        //   2. ~/.aitm.json   (user-scoped aitm config)
+        //   3. ./.mcp.json    (project-scoped Claude Code config, checked into git)
+        //   4. ./.ai-task-master/config.json (project-scoped aitm config — final word)
+        // Same name in two places: higher precedence wins; the lower is shadowed with a warn.
+        const layers = [
+            ['claude-user', sources.claudeUser],
+            ['aitm-global', sources.aitmGlobal],
+            ['claude-mcp-project', sources.claudeProject],
+            ['aitm-project', sources.aitmProject],
+        ];
+        const merged = {};
+        const sourceMap = {};
+        for (const [label, servers] of layers) {
+            if (!servers)
+                continue;
+            for (const [name, server] of Object.entries(servers)) {
+                if (name in merged) {
+                    this.warn(`mcp server "${name}" from ${label} shadows entry from ${sourceMap[name]}`);
+                }
+                merged[name] = server;
+                sourceMap[name] = label;
+            }
+        }
+        return { mcpServers: merged, mcpServerSources: sourceMap };
+    }
+    async readConfigFile(path) {
+        let raw;
+        try {
+            raw = await readFile(path, 'utf8');
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return null;
+            throw err;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`${path}: invalid JSON — ${msg}`);
+        }
+        let validated;
+        try {
+            validated = ConfigFileSchema.parse(parsed);
+        }
+        catch (err) {
+            if (err instanceof ZodError) {
+                throw new Error(`${path}: ${formatZodError(err)}`);
+            }
+            throw err;
+        }
+        for (const k of Object.keys(validated)) {
+            if (!KNOWN_KEYS.has(k)) {
+                this.warn(`${path}: unknown config key "${k}" — ignored`);
+            }
+        }
+        return validated;
+    }
+    resolveApiKey(global, project) {
+        if (project?.openrouterApiKey) {
+            return { apiKey: project.openrouterApiKey, apiKeySource: 'project' };
+        }
+        if (global?.openrouterApiKey) {
+            return { apiKey: global.openrouterApiKey, apiKeySource: 'global' };
+        }
+        const envKey = this.env.OPENROUTER_API_KEY;
+        if (envKey) {
+            return { apiKey: envKey, apiKeySource: 'env' };
+        }
+        return { apiKey: undefined, apiKeySource: undefined };
+    }
+    resolveModels(global, project, cliOverrides) {
+        const merged = {
+            generic: DEFAULT_MODELS.generic,
+            smart: DEFAULT_MODELS.smart,
+            coding: DEFAULT_MODELS.coding,
+            fast: DEFAULT_MODELS.fast,
+        };
+        for (const src of [global?.models, project?.models]) {
+            if (!src)
+                continue;
+            if (src.generic)
+                merged.generic = src.generic;
+            if (src.smart)
+                merged.smart = src.smart;
+            if (src.coding)
+                merged.coding = src.coding;
+            if (src.fast)
+                merged.fast = src.fast;
+        }
+        // --model pins the `generic` tier — the fallback every other capability
+        // inherits when not explicitly set. See docs/config.md §"Per-role models".
+        if (cliOverrides.model)
+            merged.generic = cliOverrides.model;
+        return merged;
+    }
+}
+function pick(cli, project, global, fallback) {
+    if (cli !== undefined)
+        return cli;
+    if (project !== undefined)
+        return project;
+    if (global !== undefined)
+        return global;
+    return fallback;
+}
+function pickNullable(cli, project, global, fallback) {
+    if (cli !== undefined)
+        return cli;
+    if (project !== undefined)
+        return project;
+    if (global !== undefined)
+        return global;
+    return fallback;
+}
+function isNotFound(err) {
+    return (typeof err === 'object' &&
+        err !== null &&
+        'code' in err &&
+        err.code === 'ENOENT');
+}
+function formatZodError(err) {
+    return err.issues.map((i) => `${i.path.join('.') || '<root>'}: ${i.message}`).join('; ');
+}
+// Permissive envelope for Claude Code config files: we only extract `mcpServers` and
+// ignore every other key (~/.claude.json especially has many auth/history fields).
+const McpEnvelopeSchema = z
+    .object({
+    mcpServers: McpServersSchema.optional(),
+})
+    .passthrough();
+//# sourceMappingURL=config-loader.js.map

package/dist/config/config-loader.js.map

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

package/dist/config/config-writer.d.ts

@@ -0,0 +1,14 @@
+import { type ConfigFile } from './schema.ts';
+export type ConfigScope = 'global' | 'project';
+export declare class ConfigWriter {
+    private readonly cwd;
+    private readonly homeDir;
+    constructor(cwd: string, homeDir: string);
+    set(scope: ConfigScope, key: string, value: unknown): Promise<ConfigFile>;
+    unset(scope: ConfigScope, key: string): Promise<ConfigFile>;
+    get(scope: ConfigScope, key: string): Promise<unknown>;
+    list(scope: ConfigScope): Promise<ConfigFile>;
+    private filePath;
+    private readRaw;
+    private validateAndPersist;
+}

package/dist/config/config-writer.js

@@ -0,0 +1,178 @@
+// docs/commands/config.md, docs/config.md
+// Mutates ~/.aitm.json (or, with --project, ./.ai-task-master/config.json) for `aitm config set/unset`.
+// Atomic write: temp file + rename. Refuses to write unknown top-level keys.
+import { mkdir, readFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { ZodError } from 'zod';
+import { atomicWrite } from "../fs/atomic-write.js";
+import { ConfigFileSchema } from "./schema.js";
+const GLOBAL_FILE = '.aitm.json';
+const PROJECT_DIR = '.ai-task-master';
+const PROJECT_FILE = 'config.json';
+const KNOWN_KEYS = new Set([
+    'openrouterApiKey',
+    'models',
+    'maxPrs',
+    'maxSessions',
+    'autoMerge',
+    'mergeMethod',
+    'stylePath',
+    'logLevel',
+    'concurrency',
+    'mcpServers',
+]);
+export class ConfigWriter {
+    cwd;
+    homeDir;
+    constructor(cwd, homeDir) {
+        this.cwd = cwd;
+        this.homeDir = homeDir;
+    }
+    async set(scope, key, value) {
+        const parts = splitKey(key);
+        const top = parts[0];
+        if (!KNOWN_KEYS.has(top)) {
+            throw new Error(unknownKeyMessage(top));
+        }
+        const file = await this.readRaw(scope);
+        setDottedKey(file, parts, parseValue(value));
+        return this.validateAndPersist(scope, file);
+    }
+    async unset(scope, key) {
+        const parts = splitKey(key);
+        const file = await this.readRaw(scope);
+        unsetDottedKey(file, parts);
+        return this.validateAndPersist(scope, file);
+    }
+    async get(scope, key) {
+        const parts = splitKey(key);
+        const file = await this.readRaw(scope);
+        return getDottedKey(file, parts);
+    }
+    async list(scope) {
+        const file = await this.readRaw(scope);
+        return validateSchema(file, this.filePath(scope));
+    }
+    filePath(scope) {
+        return scope === 'global'
+            ? join(this.homeDir, GLOBAL_FILE)
+            : join(this.cwd, PROJECT_DIR, PROJECT_FILE);
+    }
+    async readRaw(scope) {
+        const path = this.filePath(scope);
+        let raw;
+        try {
+            raw = await readFile(path, 'utf8');
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return {};
+            throw err;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`${path}: invalid JSON — ${msg}`);
+        }
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error(`${path}: expected a JSON object at the top level`);
+        }
+        return parsed;
+    }
+    async validateAndPersist(scope, file) {
+        const path = this.filePath(scope);
+        const validated = validateSchema(file, path);
+        if (scope === 'project') {
+            await mkdir(dirname(path), { recursive: true });
+        }
+        await atomicWrite(path, `${JSON.stringify(validated, null, 2)}\n`);
+        return validated;
+    }
+}
+function validateSchema(file, path) {
+    try {
+        return ConfigFileSchema.parse(file);
+    }
+    catch (err) {
+        if (err instanceof ZodError) {
+            throw new Error(`${path}: ${formatZodError(err)}`);
+        }
+        throw err;
+    }
+}
+function parseValue(v) {
+    if (typeof v !== 'string')
+        return v;
+    try {
+        return JSON.parse(v);
+    }
+    catch {
+        // Bare strings ("squash", "sk-or-...") aren't valid JSON; treat them as literal strings.
+        return v;
+    }
+}
+function splitKey(key) {
+    const parts = key.split('.');
+    if (parts.length === 0 || parts.some((p) => p === '')) {
+        throw new Error(`Invalid config key: "${key}"`);
+    }
+    const [first, ...rest] = parts;
+    if (first === undefined) {
+        throw new Error(`Invalid config key: "${key}"`);
+    }
+    return [first, ...rest];
+}
+function setDottedKey(obj, parts, value) {
+    const [first, ...rest] = parts;
+    if (first === undefined)
+        return;
+    if (rest.length === 0) {
+        obj[first] = value;
+        return;
+    }
+    const existing = obj[first];
+    const sub = existing !== null && typeof existing === 'object' && !Array.isArray(existing)
+        ? existing
+        : {};
+    obj[first] = sub;
+    setDottedKey(sub, rest, value);
+}
+function unsetDottedKey(obj, parts) {
+    const [first, ...rest] = parts;
+    if (first === undefined)
+        return;
+    if (rest.length === 0) {
+        delete obj[first];
+        return;
+    }
+    const next = obj[first];
+    if (next === null || typeof next !== 'object' || Array.isArray(next))
+        return;
+    unsetDottedKey(next, rest);
+}
+function getDottedKey(obj, parts) {
+    let cur = obj;
+    for (const p of parts) {
+        if (cur === null || typeof cur !== 'object' || Array.isArray(cur))
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+function unknownKeyMessage(top) {
+    const allowed = [...KNOWN_KEYS].sort().join(', ');
+    return `Unknown config key "${top}". Allowed top-level keys: ${allowed}`;
+}
+function isNotFound(err) {
+    return (typeof err === 'object' &&
+        err !== null &&
+        'code' in err &&
+        err.code === 'ENOENT');
+}
+function formatZodError(err) {
+    return err.issues.map((i) => `${i.path.join('.') || '<root>'}: ${i.message}`).join('; ');
+}
+//# sourceMappingURL=config-writer.js.map

package/dist/config/config-writer.js.map

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

package/dist/config/schema.d.ts

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+export declare const CapabilityModelsSchema: z.ZodObject<{
+    generic: z.ZodOptional<z.ZodString>;
+    smart: z.ZodOptional<z.ZodString>;
+    coding: z.ZodOptional<z.ZodString>;
+    fast: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type CapabilityModels = z.infer<typeof CapabilityModelsSchema>;
+export type Capability = 'generic' | 'smart' | 'coding' | 'fast';
+export declare const LogLevelSchema: z.ZodEnum<{
+    debug: "debug";
+    info: "info";
+    warn: "warn";
+    error: "error";
+}>;
+export declare const MergeMethodSchema: z.ZodEnum<{
+    squash: "squash";
+    merge: "merge";
+    rebase: "rebase";
+}>;
+export declare const ConfigFileSchema: z.ZodObject<{
+    openrouterApiKey: z.ZodOptional<z.ZodString>;
+    models: z.ZodOptional<z.ZodObject<{
+        generic: z.ZodOptional<z.ZodString>;
+        smart: z.ZodOptional<z.ZodString>;
+        coding: z.ZodOptional<z.ZodString>;
+        fast: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    maxPrs: z.ZodOptional<z.ZodNumber>;
+    maxSessions: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    autoMerge: z.ZodOptional<z.ZodBoolean>;
+    mergeMethod: z.ZodOptional<z.ZodEnum<{
+        squash: "squash";
+        merge: "merge";
+        rebase: "rebase";
+    }>>;
+    stylePath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    logLevel: z.ZodOptional<z.ZodEnum<{
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+        error: "error";
+    }>>;
+    concurrency: z.ZodOptional<z.ZodNumber>;
+    mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodLiteral<"stdio">>;
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"sse">;
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"http">;
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>]>>>;
+}, z.core.$loose>;
+export type ConfigFile = z.infer<typeof ConfigFileSchema>;
+export type CliOverrides = {
+    maxPrs?: number;
+    maxSessions?: number | null;
+    autoMerge?: boolean;
+    mergeMethod?: 'squash' | 'merge' | 'rebase';
+    stylePath?: string | null;
+    model?: string;
+    concurrency?: number;
+};
+export type ResolvedConfig = {
+    openrouterApiKey: string;
+    apiKeySource: 'project' | 'global' | 'env';
+    models: Required<Pick<CapabilityModels, 'generic' | 'smart' | 'coding' | 'fast'>>;
+    maxPrs: number;
+    maxSessions: number | null;
+    autoMerge: boolean;
+    mergeMethod: 'squash' | 'merge' | 'rebase';
+    stylePath: string | null;
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    concurrency: number;
+    mcpServers: import('../mcp/schema.ts').McpServers;
+    mcpServerSources: Record<string, McpServerSource>;
+};
+export type McpServerSource = 'aitm-global' | 'aitm-project' | 'claude-mcp-project' | 'claude-user';

package/dist/config/schema.js

@@ -0,0 +1,38 @@
+// docs/config.md §Schema, docs/auth.md §LLM provider
+// Models are configured by *capability tier*, not by subagent role. The mapping
+// role → tier lives in src/credentials/credentials.ts.
+//   generic — fallback for anything not otherwise specified
+//   smart   — best reasoning (Planner, Reviewer)
+//   coding  — code generation / edits (Worker)
+//   fast    — cheap routing / summarization (Orchestrator, toModelOutput compaction)
+import { z } from 'zod';
+import { McpServersSchema } from "../mcp/schema.js";
+export const CapabilityModelsSchema = z
+    .object({
+    generic: z.string().optional(),
+    smart: z.string().optional(),
+    coding: z.string().optional(),
+    fast: z.string().optional(),
+})
+    .passthrough();
+export const LogLevelSchema = z.enum(['debug', 'info', 'warn', 'error']);
+export const MergeMethodSchema = z.enum(['squash', 'merge', 'rebase']);
+export const ConfigFileSchema = z
+    .object({
+    openrouterApiKey: z.string().optional(),
+    models: CapabilityModelsSchema.optional(),
+    maxPrs: z.number().int().positive().optional(),
+    maxSessions: z.number().int().positive().nullable().optional(),
+    autoMerge: z.boolean().optional(),
+    mergeMethod: MergeMethodSchema.optional(),
+    stylePath: z.string().nullable().optional(),
+    logLevel: LogLevelSchema.optional(),
+    // How many PR groups may have a Worker running at the same time. Default 1 = sequential.
+    // See src/loop/work-loop.ts and src/workspace/worktree-pool.ts.
+    concurrency: z.number().int().positive().optional(),
+    // External MCP servers to mount into subagent tool surfaces (client only — aitm is never
+    // exposed as an MCP server). See docs/mcp.md and src/mcp/schema.ts.
+    mcpServers: McpServersSchema.optional(),
+})
+    .passthrough();
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,gFAAgF;AAChF,uDAAuD;AACvD,4DAA4D;AAC5D,iDAAiD;AACjD,+CAA+C;AAC/C,qFAAqF;AAErF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC;KACD,WAAW,EAAE,CAAC;AAKjB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEvE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,MAAM,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9D,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,WAAW,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;IACnC,yFAAyF;IACzF,gEAAgE;IAChE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACnD,yFAAyF;IACzF,oEAAoE;IACpE,UAAU,EAAE,gBAAgB,CAAC,QAAQ,EAAE;CACxC,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/credentials/credentials.d.ts

@@ -0,0 +1,15 @@
+import type { LanguageModel } from 'ai';
+import type { Capability, ResolvedConfig } from '../config/schema.ts';
+export type Role = 'planner' | 'worker' | 'reviewer' | 'orchestrator';
+export declare const ROLE_CAPABILITY: Readonly<Record<Role, Capability>>;
+export type ModelHandles = Record<Role, LanguageModel>;
+export declare class Credentials {
+    private readonly resolved;
+    private providerInstance;
+    constructor(resolved: ResolvedConfig);
+    handles(): ModelHandles;
+    modelFor(role: Role): LanguageModel;
+    modelForCapability(capability: Capability): LanguageModel;
+    static assertApiKeyPresent(resolved: ResolvedConfig): void;
+    private provider;
+}