@backendkit-labs/agent-coding 0.14.0

package/dist/index.d.ts

@@ -0,0 +1,160 @@
+import { createBaseEngine, ReflectionEngine, type Transport, type CapabilityMatrix, type PolicyRule, type MCPServerConfig } from '@backendkit-labs/agent-core';
+export type { AgentEngine } from '@backendkit-labs/agent-core';
+export * from './skills';
+export { CODING_CAPABILITY_MATRIX } from './orchestration/capability-matrix';
+export { DeepSeekProvider } from './providers/DeepSeekProvider';
+export { OpenAICompatibleProvider } from './providers/OpenAICompatibleProvider';
+export { AnthropicProvider } from './providers/AnthropicProvider';
+export { CODING_AGENTS } from './agents/profiles';
+export { AgentLoader } from './agents/AgentLoader';
+export type { AgentLoaderOptions } from './agents/AgentLoader';
+export { InitWorkflow } from './workflows/InitWorkflow';
+export type { InitMode } from './workflows/InitWorkflow';
+export { ProjectStore } from './store/ProjectStore';
+export { PersistentMemory } from './store/PersistentMemory';
+export { ConfigLoader } from './config/ConfigLoader';
+export type { BkAgentConfig } from './config/ConfigLoader';
+export * from './tools/read-file';
+export * from './tools/write-file';
+export * from './tools/edit-file';
+export * from './tools/list-directory';
+export * from './tools/run-command';
+export * from './tools/search-files';
+export * from './tools/save-context';
+export * from './tools/save-learning';
+export * from './tools/save-audit';
+export * from './tools/save-user-preference';
+export * from './tools/update-session';
+export declare const CODING_TOOLS: import("@backendkit-labs/agent-core").ToolDefinition[];
+export interface OpenAICompatibleConfig {
+    apiKey: string;
+    model?: string;
+    baseUrl?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+export interface AnthropicConfig {
+    apiKey: string;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+export type ProvidersConfig = {
+    deepseek?: OpenAICompatibleConfig;
+    openai?: OpenAICompatibleConfig;
+    anthropic?: AnthropicConfig;
+    kimi?: OpenAICompatibleConfig;
+    grok?: OpenAICompatibleConfig;
+    [key: string]: OpenAICompatibleConfig | AnthropicConfig | undefined;
+};
+export interface OrchestrationOptions {
+    /**
+     * Enable automatic QA review for responses with substantial code.
+     * The qa-engineer agent is triggered automatically for high-risk tasks.
+     * Requires the default provider to be configured (used for QA LLM calls).
+     * Default: true when orchestration is enabled.
+     */
+    enableQA?: boolean;
+    /** Disable QA reviews even when enableQA is true. */
+    noQA?: boolean;
+    /** Called when QA generates an inline review. */
+    onQAReview?: (review: string) => void;
+    /**
+     * Capability matrix mapping agent IDs to the technical domains they own.
+     * Used for automatic agent selection based on detected domains.
+     * Defaults to CODING_CAPABILITY_MATRIX (all 10 coding agents).
+     */
+    capabilityMatrix?: CapabilityMatrix;
+    /** Extra policy rules merged with the default built-in rules. */
+    customRules?: PolicyRule[];
+    /**
+     * Activa el Reflection Engine para auto-aprendizaje cross-sprint.
+     *
+     * - `true` — crea un ReflectionEngine con defaults (persiste en ~/.{appName}/)
+     * - `ReflectionEngine` — usa la instancia provista (control total sobre config y paths)
+     *
+     * Cuando está activo, al finalizar cada sprint con hallazgos:
+     *   1. Los findings se acumulan en el FailureCatalog por proyecto
+     *   2. Patrones con ≥3 ocurrencias (high/critical) se promueven a PolicyRules
+     *   3. lecciones-aprendidas.md se actualiza con historial cross-sprint
+     *
+     * Requiere que `orchestration` esté habilitado.
+     */
+    reflection?: boolean | ReflectionEngine;
+}
+export interface CodingEngineOptions {
+    providers: ProvidersConfig;
+    defaultProvider: string;
+    defaultAgent?: string;
+    workingDir?: string;
+    maxIterations?: number;
+    maxParallelAgents?: number;
+    transport?: Transport;
+    /**
+     * App name used to derive the home config directory (~/.{appName}/).
+     * Defaults to 'bk-agent'. Set this to your own app name when building on top of the framework.
+     */
+    appName?: string;
+    /** Skip creating a ProjectStore (e.g. for testing) */
+    disablePersistence?: boolean;
+    /**
+     * External MCP servers to connect to on first run.
+     * Tools are discovered lazily and made available to all agents.
+     *
+     * @example
+     * mcpServers: [
+     *   { name: 'github',   command: 'npx', args: ['@modelcontextprotocol/server-github'],   env: { GITHUB_TOKEN: '...' } },
+     *   { name: 'postgres', command: 'npx', args: ['@modelcontextprotocol/server-postgres'],  env: { DATABASE_URL: '...' } },
+     *   { name: 'slack',    command: 'npx', args: ['@modelcontextprotocol/server-slack'],     env: { SLACK_TOKEN: '...' } },
+     * ]
+     */
+    mcpServers?: MCPServerConfig[];
+    /**
+     * Number of recent messages from the orchestrator's conversation to inject
+     * into each sub-agent call. Gives specialists visibility into previously
+     * gathered data (file reads, command outputs) without requiring the
+     * orchestrator to copy it manually. Sliced at a user-turn boundary.
+     * Default: 0. Recommended: 10–20 for complex multi-turn tasks.
+     */
+    subAgentContextMessages?: number;
+    /**
+     * Called before executing write/execute tools (write_file, edit_file, run_command) when
+     * iteration mode is manual. Return 'approve', 'approve_all', or 'reject'.
+     */
+    onToolApproval?: (toolName: string, agentId: string, argsPreview: string) => Promise<import('@backendkit-labs/agent-core').ToolApprovalDecision>;
+    /**
+     * Called when maxIterations is reached in 'interactive' mode.
+     * Return true to continue, false to stop.
+     */
+    onIterationLimit?: (stats: import('@backendkit-labs/agent-core').IterationStats) => Promise<boolean>;
+    /**
+     * Called after every single iteration in 'step-by-step' mode.
+     * Return true to continue, false to stop.
+     */
+    onStep?: (stats: import('@backendkit-labs/agent-core').IterationStats) => Promise<boolean>;
+    /**
+     * Activate the Orchestrator pipeline:
+     * intent detection → domain detection → risk scoring → policy engine → FSM gates.
+     *
+     * Pass `true` for all defaults, or an object for fine-grained control.
+     *
+     * @example
+     * // Simple activation
+     * orchestration: true
+     *
+     * @example
+     * // With QA auto-review disabled
+     * orchestration: { enableQA: false }
+     *
+     * @example
+     * // Custom capability matrix and extra policy rules
+     * orchestration: {
+     *   capabilityMatrix: { 'my-agent': { owns: ['backend'], skills: [], baseWeight: 0.9 } },
+     *   customRules: [{ if: { domain: 'security' }, then: { mustInclude: ['security'] } }],
+     * }
+     */
+    orchestration?: boolean | OrchestrationOptions;
+}
+export declare function createCodingEngine(opts: CodingEngineOptions): ReturnType<typeof createBaseEngine>;
+export declare function createCodingEngineFromConfig(overrides?: Partial<CodingEngineOptions>): ReturnType<typeof createBaseEngine>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,340 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODING_TOOLS = exports.ConfigLoader = exports.PersistentMemory = exports.ProjectStore = exports.InitWorkflow = exports.AgentLoader = exports.CODING_AGENTS = exports.AnthropicProvider = exports.OpenAICompatibleProvider = exports.DeepSeekProvider = exports.CODING_CAPABILITY_MATRIX = void 0;
+exports.createCodingEngine = createCodingEngine;
+exports.createCodingEngineFromConfig = createCodingEngineFromConfig;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const agent_core_1 = require("@backendkit-labs/agent-core");
+const capability_matrix_1 = require("./orchestration/capability-matrix");
+const skills_1 = require("./skills");
+const OpenAICompatibleProvider_1 = require("./providers/OpenAICompatibleProvider");
+const AnthropicProvider_1 = require("./providers/AnthropicProvider");
+const profiles_1 = require("./agents/profiles");
+const AgentLoader_1 = require("./agents/AgentLoader");
+const read_file_1 = require("./tools/read-file");
+const write_file_1 = require("./tools/write-file");
+const edit_file_1 = require("./tools/edit-file");
+const list_directory_1 = require("./tools/list-directory");
+const run_command_1 = require("./tools/run-command");
+const search_files_1 = require("./tools/search-files");
+const save_context_1 = require("./tools/save-context");
+const save_learning_1 = require("./tools/save-learning");
+const save_audit_1 = require("./tools/save-audit");
+const save_user_preference_1 = require("./tools/save-user-preference");
+const update_session_1 = require("./tools/update-session");
+const ProjectStore_1 = require("./store/ProjectStore");
+const PersistentMemory_1 = require("./store/PersistentMemory");
+const ConfigLoader_1 = require("./config/ConfigLoader");
+// ── Stack detection ───────────────────────────────────────────────────────────
+const STACK_INDICATORS = [
+    { file: 'package.json', stack: 'node' },
+    { file: 'tsconfig.json', stack: 'typescript' },
+    { file: 'requirements.txt', stack: 'python' },
+    { file: 'pyproject.toml', stack: 'python' },
+    { file: 'pom.xml', stack: 'java' },
+    { file: 'build.gradle', stack: 'java' },
+    { file: 'build.gradle.kts', stack: 'kotlin' }, // Kotlin DSL gradle
+    { file: 'settings.gradle.kts', stack: 'kotlin' }, // Android / Kotlin Multiplatform
+    { file: 'Cargo.toml', stack: 'rust' },
+    { file: 'go.mod', stack: 'go' },
+    { file: 'composer.json', stack: 'php' },
+    { file: 'Gemfile', stack: 'ruby' },
+    { file: 'mix.exs', stack: 'elixir' },
+];
+function detectProjectStack(cwd) {
+    const stacks = [];
+    for (const { file, stack } of STACK_INDICATORS) {
+        if ((0, fs_1.existsSync)((0, path_1.join)(cwd, file)) && !stacks.includes(stack)) {
+            stacks.push(stack);
+        }
+    }
+    return stacks;
+}
+// ── Re-exports ────────────────────────────────────────────────────────────────
+__exportStar(require("./skills"), exports);
+var capability_matrix_2 = require("./orchestration/capability-matrix");
+Object.defineProperty(exports, "CODING_CAPABILITY_MATRIX", { enumerable: true, get: function () { return capability_matrix_2.CODING_CAPABILITY_MATRIX; } });
+var DeepSeekProvider_1 = require("./providers/DeepSeekProvider");
+Object.defineProperty(exports, "DeepSeekProvider", { enumerable: true, get: function () { return DeepSeekProvider_1.DeepSeekProvider; } });
+var OpenAICompatibleProvider_2 = require("./providers/OpenAICompatibleProvider");
+Object.defineProperty(exports, "OpenAICompatibleProvider", { enumerable: true, get: function () { return OpenAICompatibleProvider_2.OpenAICompatibleProvider; } });
+var AnthropicProvider_2 = require("./providers/AnthropicProvider");
+Object.defineProperty(exports, "AnthropicProvider", { enumerable: true, get: function () { return AnthropicProvider_2.AnthropicProvider; } });
+var profiles_2 = require("./agents/profiles");
+Object.defineProperty(exports, "CODING_AGENTS", { enumerable: true, get: function () { return profiles_2.CODING_AGENTS; } });
+var AgentLoader_2 = require("./agents/AgentLoader");
+Object.defineProperty(exports, "AgentLoader", { enumerable: true, get: function () { return AgentLoader_2.AgentLoader; } });
+var InitWorkflow_1 = require("./workflows/InitWorkflow");
+Object.defineProperty(exports, "InitWorkflow", { enumerable: true, get: function () { return InitWorkflow_1.InitWorkflow; } });
+var ProjectStore_2 = require("./store/ProjectStore");
+Object.defineProperty(exports, "ProjectStore", { enumerable: true, get: function () { return ProjectStore_2.ProjectStore; } });
+var PersistentMemory_2 = require("./store/PersistentMemory");
+Object.defineProperty(exports, "PersistentMemory", { enumerable: true, get: function () { return PersistentMemory_2.PersistentMemory; } });
+var ConfigLoader_2 = require("./config/ConfigLoader");
+Object.defineProperty(exports, "ConfigLoader", { enumerable: true, get: function () { return ConfigLoader_2.ConfigLoader; } });
+__exportStar(require("./tools/read-file"), exports);
+__exportStar(require("./tools/write-file"), exports);
+__exportStar(require("./tools/edit-file"), exports);
+__exportStar(require("./tools/list-directory"), exports);
+__exportStar(require("./tools/run-command"), exports);
+__exportStar(require("./tools/search-files"), exports);
+__exportStar(require("./tools/save-context"), exports);
+__exportStar(require("./tools/save-learning"), exports);
+__exportStar(require("./tools/save-audit"), exports);
+__exportStar(require("./tools/save-user-preference"), exports);
+__exportStar(require("./tools/update-session"), exports);
+// ── Tool sets ─────────────────────────────────────────────────────────────────
+exports.CODING_TOOLS = [
+    read_file_1.readFileTool,
+    write_file_1.writeFileTool,
+    edit_file_1.editFileTool,
+    list_directory_1.listDirectoryTool,
+    run_command_1.runCommandTool,
+    search_files_1.searchFilesTool,
+    save_context_1.saveContextTool,
+    save_learning_1.saveLearningTool,
+    save_audit_1.saveAuditTool,
+    save_audit_1.getLatestAuditTool,
+    save_audit_1.listAuditsTool,
+    save_user_preference_1.saveUserPreferenceTool,
+    update_session_1.updateSessionTool,
+];
+const KNOWN_BASE_URLS = {
+    deepseek: 'https://api.deepseek.com/v1',
+    openai: 'https://api.openai.com/v1',
+    kimi: 'https://api.moonshot.cn/v1',
+    grok: 'https://api.x.ai/v1',
+};
+const DEFAULT_MODELS = {
+    deepseek: 'deepseek-chat',
+    openai: 'gpt-4o',
+    anthropic: 'claude-sonnet-4-6',
+    kimi: 'moonshot-v1-8k',
+    grok: 'grok-3',
+};
+// ── Factory ───────────────────────────────────────────────────────────────────
+function createCodingEngine(opts) {
+    const cwd = opts.workingDir ?? process.cwd();
+    const appName = opts.appName ?? 'bk-agent';
+    // ── Agents (builtins + global + project overrides) ────────────────────────
+    const allAgents = AgentLoader_1.AgentLoader.load({ appName, cwd, builtins: profiles_1.CODING_AGENTS });
+    // ── Providers (instantiate from config) ───────────────────────────────────
+    const providers = {};
+    for (const [id, config] of Object.entries(opts.providers)) {
+        if (!config)
+            continue;
+        if (id === 'anthropic') {
+            const cfg = config;
+            providers[id] = new AnthropicProvider_1.AnthropicProvider({
+                apiKey: cfg.apiKey,
+                model: cfg.model ?? DEFAULT_MODELS.anthropic,
+                maxTokens: cfg.maxTokens,
+                temperature: cfg.temperature,
+            });
+        }
+        else {
+            const cfg = config;
+            const baseUrl = cfg.baseUrl ?? KNOWN_BASE_URLS[id];
+            if (!baseUrl)
+                throw new Error(`Provider "${id}" requires a baseUrl`);
+            providers[id] = new OpenAICompatibleProvider_1.OpenAICompatibleProvider({
+                apiKey: cfg.apiKey,
+                baseUrl,
+                model: cfg.model ?? DEFAULT_MODELS[id] ?? 'gpt-4o',
+                maxTokens: cfg.maxTokens,
+                temperature: cfg.temperature,
+            });
+        }
+    }
+    // ── Persistent store + memory ─────────────────────────────────────────────
+    let store;
+    let memory;
+    let projectContext;
+    let auditLog;
+    let historyPath;
+    let memorySystem;
+    if (!opts.disablePersistence) {
+        store = new ProjectStore_1.ProjectStore(cwd, appName);
+        memory = new PersistentMemory_1.PersistentMemory(store.projectDir);
+        auditLog = (0, path_1.join)(store.projectDir, 'audits', 'tool-calls.ndjson');
+        historyPath = (0, path_1.join)(store.projectDir, 'memory', 'history.json');
+        // Summarize old episodes with the LLM when they pile up.
+        // Runs async (fire-and-forget) so it never blocks a tool call.
+        const episodicSummarizeFn = async (episodes) => {
+            const provider = providers[opts.defaultProvider] ?? Object.values(providers)[0];
+            if (!provider)
+                return episodes.map(e => e.content).join(' | ');
+            const list = episodes.map((e, i) => `${i + 1}. ${e.content}${e.tags.length ? ` [${e.tags.join(', ')}]` : ''}`).join('\n');
+            const prompt = `Summarize these agent experiences into ONE concise paragraph (max 120 words). ` +
+                `Preserve key facts, patterns, and outcomes:\n\n${list}`;
+            let result = '';
+            await provider.chat([{ role: 'user', content: prompt }], [], { onChunk: (d) => { result += d; }, onToolCall: () => { }, onDone: () => { }, onError: () => { } });
+            return result.trim() || episodes.map(e => e.content).join(' | ');
+        };
+        memorySystem = (0, agent_core_1.createMemorySystem)({
+            episodic: { provider: 'json', path: (0, path_1.join)(store.projectDir, 'memory', 'episodes.json') },
+            semantic: { provider: 'json', path: (0, path_1.join)(store.projectDir, 'memory', 'knowledge.json') },
+            procedural: { provider: 'json', path: (0, path_1.join)(store.projectDir, 'memory', 'patterns.json') },
+            retention: { maxEpisodes: 500, summarizeAfter: 50, summarizeFn: episodicSummarizeFn },
+        });
+        const agentMdPath = (0, path_1.join)(cwd, 'AGENT.md');
+        const agentMd = (0, fs_1.existsSync)(agentMdPath)
+            ? (0, fs_1.readFileSync)(agentMdPath, 'utf-8').trim()
+            : undefined;
+        const projectDir = (0, agent_core_1.getProjectDir)(appName, cwd);
+        const pipelineParts = [];
+        const tryRead = (p) => (0, fs_1.existsSync)(p) ? (0, fs_1.readFileSync)(p, 'utf-8').trim() : null;
+        const sesion = tryRead((0, path_1.join)(projectDir, 'memory', 'session.md'));
+        if (sesion)
+            pipelineParts.push(`## Current Session\n${sesion}`);
+        const lecciones = tryRead((0, path_1.join)(projectDir, 'audits', 'lecciones-aprendidas.md'));
+        if (lecciones)
+            pipelineParts.push(`## Lecciones Aprendidas\n${lecciones}`);
+        const storeCtx = store.buildSystemContext(agentMd) || '';
+        const pipelineCtx = pipelineParts.join('\n\n');
+        projectContext = [storeCtx, pipelineCtx].filter(Boolean).join('\n\n') || undefined;
+    }
+    // ── Stack detection ───────────────────────────────────────────────────────
+    const detectedStack = detectProjectStack(cwd);
+    if (detectedStack.length > 0) {
+        const stackSection = `## Detected Project Stack\n${detectedStack.join(', ')}`;
+        projectContext = projectContext ? `${projectContext}\n\n${stackSection}` : stackSection;
+    }
+    // ── Skills (3-layer: builtins in-memory + YAML lazy-loaded) ──────────────
+    const builtinSkills = [
+        ...skills_1.GLOBAL_BUILTIN_SKILLS,
+        ...skills_1.NODE_PACK_SKILLS,
+        ...skills_1.GO_PACK_SKILLS,
+        ...skills_1.JAVA_PACK_SKILLS,
+        ...skills_1.KOTLIN_PACK_SKILLS,
+        ...skills_1.PYTHON_PACK_SKILLS,
+    ];
+    const skillLoader = opts.disablePersistence ? undefined : new agent_core_1.SkillLoader(appName);
+    const loadSkills = skillLoader
+        ? async () => {
+            const loaded = await skillLoader.loadAll(cwd, store?.projectDir);
+            return [...loaded.global, ...loaded.packs, ...loaded.projectConfig, ...loaded.project];
+        }
+        : undefined;
+    // ── Orchestrator (optional — activated via opts.orchestration) ────────────
+    let orchestrator;
+    let qaService;
+    let noQA;
+    let onQAReview;
+    if (opts.orchestration) {
+        const orchOpts = typeof opts.orchestration === 'boolean' ? {} : opts.orchestration;
+        // Adapt the default LLM provider to the simpler LLMChatClient interface
+        // used by Orchestrator (intent detection) and QAService (inline review).
+        const defaultProviderInstance = providers[opts.defaultProvider];
+        const llmClient = defaultProviderInstance
+            ? (0, agent_core_1.adaptProviderToLLMClient)(defaultProviderInstance)
+            : undefined;
+        orchestrator = new agent_core_1.Orchestrator({
+            appName,
+            projectRoot: cwd,
+            client: llmClient,
+            capabilityMatrix: orchOpts.capabilityMatrix ?? capability_matrix_1.CODING_CAPABILITY_MATRIX,
+            customRules: orchOpts.customRules,
+        });
+        // reflection defaults to true when orchestration is on — the feedback loop
+        // (findings → catalog → patterns → manifest.yaml → PolicyStep) is now complete.
+        const reflectionOpt = orchOpts.reflection ?? true;
+        if (reflectionOpt) {
+            const re = reflectionOpt instanceof agent_core_1.ReflectionEngine
+                ? reflectionOpt
+                : new agent_core_1.ReflectionEngine({ projectRoot: cwd, appName });
+            // initialize() carga el catálogo desde disco; corre en background porque
+            // el primer completeSprint() no ocurre hasta después del primer run LLM.
+            re.initialize().catch(() => { });
+            orchestrator.getAuditReporter().connectReflectionEngine(re);
+        }
+        noQA = orchOpts.noQA;
+        onQAReview = orchOpts.onQAReview;
+        // QAService: auto-builds when enableQA is not explicitly false and LLM is available.
+        // Uses the qa-engineer agent's system prompt as the base for QA review calls.
+        if (orchOpts.enableQA !== false && llmClient) {
+            const qaProfile = allAgents.find(a => a.id === 'qa-engineer');
+            qaService = new agent_core_1.QAService({
+                client: llmClient,
+                basePrompt: () => qaProfile?.systemPrompt ?? '',
+                allAgents,
+                noQA: orchOpts.noQA,
+                onQAReview: orchOpts.onQAReview,
+            });
+        }
+    }
+    // ── Seed global directory structure on first run (fire-and-forget) ───────
+    // Creates ~/.{appName}/ with agents, skills, workspaces.json, agent-notes/,
+    // and projects/{cwd}/memory+audits dirs. Idempotent — skips existing files.
+    (0, agent_core_1.runGlobalSeed)(appName, cwd, {
+        agents: allAgents.filter(a => a.source === 'builtin'),
+        skills: builtinSkills,
+    }).catch(err => console.warn(`[${appName}] seed warning: ${err.message}`));
+    // ── Delegate engine assembly to createBaseEngine ──────────────────────────
+    return (0, agent_core_1.createBaseEngine)({
+        providers,
+        defaultProvider: opts.defaultProvider,
+        agents: allAgents,
+        tools: exports.CODING_TOOLS,
+        defaultAgent: opts.defaultAgent ?? 'general',
+        transport: opts.transport,
+        workingDir: cwd,
+        maxIterations: opts.maxIterations ?? 100,
+        maxParallelAgents: opts.maxParallelAgents ?? 6,
+        store,
+        projectContext,
+        skills: builtinSkills,
+        detectedStack,
+        loadSkills,
+        ...(memory ? { sessionMemory: memory } : {}),
+        ...(auditLog ? { auditLog } : {}),
+        ...(orchestrator ? { orchestrator } : {}),
+        ...(qaService ? { qaService } : {}),
+        ...(noQA !== undefined ? { noQA } : {}),
+        ...(onQAReview ? { onQAReview } : {}),
+        ...(opts.mcpServers?.length ? { mcpServers: opts.mcpServers } : {}),
+        ...(opts.onToolApproval ? { onToolApproval: opts.onToolApproval } : {}),
+        ...(opts.onIterationLimit ? { onIterationLimit: opts.onIterationLimit } : {}),
+        ...(opts.onStep ? { onStep: opts.onStep } : {}),
+        ...(opts.subAgentContextMessages ? { subAgentContextMessages: opts.subAgentContextMessages } : {}),
+        ...(memorySystem ? { memorySystem } : {}),
+        ...(historyPath ? { historyPath } : {}),
+    });
+}
+// ── Config-based factory (reads ~/.bk-agent/config.json) ─────────────────────
+function createCodingEngineFromConfig(overrides = {}) {
+    const appName = overrides.appName ?? 'bk-agent';
+    const loader = new ConfigLoader_1.ConfigLoader(appName);
+    const config = loader.load();
+    if (!config.defaultProvider) {
+        throw new Error(`No provider configured. Set DEEPSEEK_API_KEY or add providers to ${loader.configPath}`);
+    }
+    const providers = {};
+    for (const [id, cfg] of Object.entries(config.providers ?? {})) {
+        if (cfg?.apiKey)
+            providers[id] = cfg;
+    }
+    return createCodingEngine({
+        providers,
+        defaultProvider: config.defaultProvider,
+        ...(config.mcpServers?.length ? { mcpServers: config.mcpServers } : {}),
+        ...overrides,
+        appName,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/orchestration/capability-matrix.d.ts

@@ -0,0 +1,10 @@
+import type { CapabilityMatrix } from '@backendkit-labs/agent-core';
+/**
+ * Default capability matrix for the 10 coding agents.
+ *
+ * Maps each agent to the technical domains it owns so the Orchestrator
+ * can route tasks to the most relevant specialist automatically.
+ * Override via CodingEngineOptions.orchestration.capabilityMatrix.
+ */
+export declare const CODING_CAPABILITY_MATRIX: CapabilityMatrix;
+//# sourceMappingURL=capability-matrix.d.ts.map

package/dist/orchestration/capability-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-matrix.d.ts","sourceRoot":"","sources":["../../src/orchestration/capability-matrix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,gBAoCtC,CAAC"}

package/dist/orchestration/capability-matrix.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODING_CAPABILITY_MATRIX = void 0;
+/**
+ * Default capability matrix for the 10 coding agents.
+ *
+ * Maps each agent to the technical domains it owns so the Orchestrator
+ * can route tasks to the most relevant specialist automatically.
+ * Override via CodingEngineOptions.orchestration.capabilityMatrix.
+ */
+exports.CODING_CAPABILITY_MATRIX = {
+    'architecture': {
+        owns: ['architecture', 'design', 'resilience'],
+        skills: ['adr-generation', 'c4-diagram', 'trade-off-analysis'],
+        baseWeight: 0.9,
+    },
+    'backend': {
+        owns: ['backend', 'messaging'],
+        skills: ['api-design', 'orm-patterns'],
+        baseWeight: 0.9,
+    },
+    'frontend': {
+        owns: ['frontend'],
+        skills: ['component-design', 'a11y-review'],
+        baseWeight: 0.9,
+    },
+    'security': {
+        owns: ['security'],
+        skills: ['owasp-review', 'threat-model'],
+        baseWeight: 1.0,
+    },
+    'qa-engineer': {
+        owns: ['testing'],
+        skills: ['code-review', 'test-strategy'],
+        baseWeight: 0.9,
+    },
+    'infrastructure': {
+        owns: ['devops'],
+        skills: ['iac-review', 'ci-cd-setup'],
+        baseWeight: 0.9,
+    },
+    'data': {
+        owns: ['data', 'database'],
+        skills: ['schema-design', 'query-optimization'],
+        baseWeight: 0.8,
+    },
+};
+//# sourceMappingURL=capability-matrix.js.map

package/dist/orchestration/capability-matrix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-matrix.js","sourceRoot":"","sources":["../../src/orchestration/capability-matrix.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACU,QAAA,wBAAwB,GAAqB;IACtD,cAAc,EAAE;QACZ,IAAI,EAAE,CAAC,cAAc,EAAE,QAAQ,EAAE,YAAY,CAAC;QAC9C,MAAM,EAAE,CAAC,gBAAgB,EAAE,YAAY,EAAE,oBAAoB,CAAC;QAC9D,UAAU,EAAE,GAAG;KAClB;IACD,SAAS,EAAE;QACP,IAAI,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;QAC9B,MAAM,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC;QACtC,UAAU,EAAE,GAAG;KAClB;IACD,UAAU,EAAE;QACR,IAAI,EAAE,CAAC,UAAU,CAAC;QAClB,MAAM,EAAE,CAAC,kBAAkB,EAAE,aAAa,CAAC;QAC3C,UAAU,EAAE,GAAG;KAClB;IACD,UAAU,EAAE;QACR,IAAI,EAAE,CAAC,UAAU,CAAC;QAClB,MAAM,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC;QACxC,UAAU,EAAE,GAAG;KAClB;IACD,aAAa,EAAE;QACX,IAAI,EAAE,CAAC,SAAS,CAAC;QACjB,MAAM,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC;QACxC,UAAU,EAAE,GAAG;KAClB;IACD,gBAAgB,EAAE;QACd,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;QACrC,UAAU,EAAE,GAAG;KAClB;IACD,MAAM,EAAE;QACJ,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;QAC1B,MAAM,EAAE,CAAC,eAAe,EAAE,oBAAoB,CAAC;QAC/C,UAAU,EAAE,GAAG;KAClB;CACJ,CAAC"}

package/dist/providers/AnthropicProvider.d.ts

@@ -0,0 +1,20 @@
+import type { LLMProvider, LLMMessage, LLMStreamCallbacks, ToolDefinition } from '@backendkit-labs/agent-core';
+export interface AnthropicProviderOptions {
+    apiKey: string;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+    /** Max retry attempts on transient errors (429, 5xx). Default: 3. */
+    maxRetries?: number;
+}
+export declare class AnthropicProvider implements LLMProvider {
+    private readonly client;
+    private readonly model;
+    private readonly maxTokens;
+    private readonly temperature;
+    private readonly maxRetries;
+    constructor(opts: AnthropicProviderOptions);
+    chat(messages: LLMMessage[], tools: ToolDefinition[], callbacks: LLMStreamCallbacks): Promise<void>;
+    private stream;
+}
+//# sourceMappingURL=AnthropicProvider.d.ts.map

package/dist/providers/AnthropicProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnthropicProvider.d.ts","sourceRoot":"","sources":["../../src/providers/AnthropicProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE/G,MAAM,WAAW,wBAAwB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAqFD,qBAAa,iBAAkB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,IAAI,EAAE,wBAAwB;IAQpC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;YAoC3F,MAAM;CAsEvB"}