@backendkit-labs/agent-core 0.14.0

package/dist/context/stages/stage-project.js

@@ -0,0 +1,55 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStageProject = runStageProject;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const crypto_1 = require("crypto");
+const result_1 = require("@backendkit-labs/result");
+const project_key_1 = require("../../shared/utils/project-key");
+async function runStageProject(cwd, appName) {
+    const memoryDir = path.join((0, project_key_1.getProjectDir)(appName, cwd), 'memory');
+    const filePath = path.join(memoryDir, 'contexto-proyecto.md');
+    const fileResult = await (0, result_1.run)(() => fs.readFile(filePath, 'utf-8'));
+    const content = (0, result_1.isOk)(fileResult) ? fileResult.value : null;
+    const checksum = content
+        ? (0, crypto_1.createHash)('sha256').update(content, 'utf-8').digest('hex').slice(0, 16)
+        : '';
+    return {
+        checksum,
+        data: { content, filePath: content ? filePath : null, checksum },
+    };
+}
+//# sourceMappingURL=stage-project.js.map

package/dist/context/stages/stage-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-project.js","sourceRoot":"","sources":["../../../src/context/stages/stage-project.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,0CAkBC;AA9BD,gDAAkC;AAClC,2CAA6B;AAC7B,mCAAoC;AACpC,oDAAoD;AACpD,gEAA+D;AAQxD,KAAK,UAAU,eAAe,CACjC,GAAW,EACX,OAAe;IAEf,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAA,2BAAa,EAAC,OAAO,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;IAE9D,MAAM,UAAU,GAAG,MAAM,IAAA,YAAG,EAAC,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,IAAA,aAAI,EAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3D,MAAM,QAAQ,GAAG,OAAO;QACpB,CAAC,CAAC,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1E,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;QACH,QAAQ;QACR,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE;KACnE,CAAC;AACN,CAAC"}

package/dist/context/stages/stage-session.d.ts

@@ -0,0 +1,12 @@
+export interface SessionResult {
+    content: string | null;
+    filePath: string | null;
+    checksum: string;
+    currentFeature: string | null;
+    progress: string | null;
+}
+export declare function runStageSession(cwd: string, appName: string): Promise<{
+    checksum: string;
+    data: SessionResult;
+}>;
+//# sourceMappingURL=stage-session.d.ts.map

package/dist/context/stages/stage-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-session.d.ts","sourceRoot":"","sources":["../../../src/context/stages/stage-session.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAYD,wBAAsB,eAAe,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC,CAqBpD"}

package/dist/context/stages/stage-session.js

@@ -0,0 +1,69 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStageSession = runStageSession;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const crypto_1 = require("crypto");
+const result_1 = require("@backendkit-labs/result");
+const project_key_1 = require("../../shared/utils/project-key");
+function extractFeatureName(content) {
+    const match = content.match(/\*\*Nombre:\*\*\s*(.+?)(?:\n|$)/);
+    return match ? match[1].trim() : null;
+}
+function extractProgress(content) {
+    const match = content.match(/\*\*Progreso:\*\*\s*(.+?)(?:\n|$)/);
+    return match ? match[1].trim() : null;
+}
+async function runStageSession(cwd, appName) {
+    const memoryDir = path.join((0, project_key_1.getProjectDir)(appName, cwd), 'memory');
+    const filePath = path.join(memoryDir, 'session.md');
+    const fileResult = await (0, result_1.run)(() => fs.readFile(filePath, 'utf-8'));
+    const content = (0, result_1.isOk)(fileResult) ? fileResult.value : null;
+    const checksum = content
+        ? (0, crypto_1.createHash)('sha256').update(content, 'utf-8').digest('hex').slice(0, 16)
+        : '';
+    return {
+        checksum,
+        data: {
+            content,
+            filePath: content ? filePath : null,
+            checksum,
+            currentFeature: content ? extractFeatureName(content) : null,
+            progress: content ? extractProgress(content) : null,
+        },
+    };
+}
+//# sourceMappingURL=stage-session.js.map

package/dist/context/stages/stage-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-session.js","sourceRoot":"","sources":["../../../src/context/stages/stage-session.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,0CAwBC;AAhDD,gDAAkC;AAClC,2CAA6B;AAC7B,mCAAoC;AACpC,oDAAoD;AACpD,gEAA+D;AAU/D,SAAS,kBAAkB,CAAC,OAAe;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAEM,KAAK,UAAU,eAAe,CACjC,GAAW,EACX,OAAe;IAEf,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAA,2BAAa,EAAC,OAAO,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAEpD,MAAM,UAAU,GAAG,MAAM,IAAA,YAAG,EAAC,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,IAAA,aAAI,EAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3D,MAAM,QAAQ,GAAG,OAAO;QACpB,CAAC,CAAC,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1E,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;QACH,QAAQ;QACR,IAAI,EAAE;YACF,OAAO;YACP,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;YACnC,QAAQ;YACR,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;YAC5D,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;SACtD;KACJ,CAAC;AACN,CAAC"}

package/dist/delegation/DelegationBus.d.ts

@@ -0,0 +1,40 @@
+import type { AgentRegistry } from '../engine/AgentRegistry';
+import type { ToolRegistry } from '../engine/ToolRegistry';
+import type { Transport } from '../transport/Transport';
+export interface DelegationRequest {
+    agentId: string;
+    question: string;
+    context?: string;
+    relevantFiles?: string[];
+}
+export interface DelegationResult {
+    agentId: string;
+    content: string;
+    inputTokens: number;
+    outputTokens: number;
+    elapsedMs: number;
+    error?: string;
+}
+export interface DelegationBusOptions {
+    maxParallel?: number;
+    agents: AgentRegistry;
+    tools: ToolRegistry;
+    transport: Transport;
+    workingDir?: string;
+    runAgent(agentId: string, question: string, context?: string): Promise<DelegationResult>;
+}
+export declare class DelegationBus {
+    private readonly opts;
+    private readonly bulkhead;
+    constructor(opts: DelegationBusOptions);
+    /**
+     * Runs all requests concurrently, bounded by the bulkhead semaphore.
+     *
+     * Unlike the previous wave-based approach, slots free up immediately as
+     * individual agents finish — no waiting for the whole wave to complete.
+     */
+    runParallel(requests: DelegationRequest[]): Promise<DelegationResult[]>;
+    runSingle(request: DelegationRequest): Promise<DelegationResult>;
+    getBulkheadMetrics(): import("@backendkit-labs/bulkhead").BulkheadMetrics;
+}
+//# sourceMappingURL=DelegationBus.d.ts.map

package/dist/delegation/DelegationBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DelegationBus.d.ts","sourceRoot":"","sources":["../../src/delegation/DelegationBus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC5F;AAED,qBAAa,aAAa;IAGV,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAEP,IAAI,EAAE,oBAAoB;IAUvD;;;;;OAKG;IACG,WAAW,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIvE,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyCtE,kBAAkB;CAGrB"}

package/dist/delegation/DelegationBus.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DelegationBus = void 0;
+const bulkhead_1 = require("@backendkit-labs/bulkhead");
+class DelegationBus {
+    opts;
+    bulkhead;
+    constructor(opts) {
+        this.opts = opts;
+        this.bulkhead = new bulkhead_1.Bulkhead({
+            name: 'delegation-bus',
+            maxConcurrentCalls: opts.maxParallel ?? 6,
+            maxQueueSize: 50,
+            queueTimeoutMs: 120_000, // 2 min — agent calls can be long
+            rejectWhenFull: false,
+        });
+    }
+    /**
+     * Runs all requests concurrently, bounded by the bulkhead semaphore.
+     *
+     * Unlike the previous wave-based approach, slots free up immediately as
+     * individual agents finish — no waiting for the whole wave to complete.
+     */
+    async runParallel(requests) {
+        return Promise.all(requests.map(req => this.runSingle(req)));
+    }
+    async runSingle(request) {
+        const profile = this.opts.agents.get(request.agentId);
+        if (!profile) {
+            return {
+                agentId: request.agentId,
+                content: `Agent "${request.agentId}" not found in registry`,
+                inputTokens: 0,
+                outputTokens: 0,
+                elapsedMs: 0,
+                error: 'agent_not_found',
+            };
+        }
+        this.opts.transport.emit({
+            type: 'agent_switch',
+            from: 'orchestrator',
+            to: profile.id,
+            to_name: profile.name,
+            to_icon: profile.icon,
+        });
+        try {
+            return await this.bulkhead.execute(() => this.opts.runAgent(request.agentId, request.question, request.context));
+        }
+        catch (err) {
+            const message = err instanceof bulkhead_1.BulkheadRejectedError ? 'Delegation rejected: queue is full' :
+                err instanceof bulkhead_1.BulkheadTimeoutError ? 'Delegation timed out in queue' :
+                    err instanceof Error ? err.message : String(err);
+            return {
+                agentId: request.agentId,
+                content: `Error: ${message}`,
+                inputTokens: 0,
+                outputTokens: 0,
+                elapsedMs: 0,
+                error: message,
+            };
+        }
+    }
+    getBulkheadMetrics() {
+        return this.bulkhead.getMetrics();
+    }
+}
+exports.DelegationBus = DelegationBus;
+//# sourceMappingURL=DelegationBus.js.map

package/dist/delegation/DelegationBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DelegationBus.js","sourceRoot":"","sources":["../../src/delegation/DelegationBus.ts"],"names":[],"mappings":";;;AAAA,wDAAkG;AA8BlG,MAAa,aAAa;IAGO;IAFZ,QAAQ,CAAW;IAEpC,YAA6B,IAA0B;QAA1B,SAAI,GAAJ,IAAI,CAAsB;QACnD,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAQ,CAAC;YACzB,IAAI,EAAE,gBAAgB;YACtB,kBAAkB,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC;YACzC,YAAY,EAAE,EAAE;YAChB,cAAc,EAAE,OAAO,EAAE,kCAAkC;YAC3D,cAAc,EAAE,KAAK;SACxB,CAAC,CAAC;IACP,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,QAA6B;QAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAA0B;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO;gBACH,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,OAAO,EAAE,UAAU,OAAO,CAAC,OAAO,yBAAyB;gBAC3D,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,CAAC;gBACf,SAAS,EAAE,CAAC;gBACZ,KAAK,EAAE,iBAAiB;aAC3B,CAAC;QACN,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YACrB,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,cAAc;YACpB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,OAAO,EAAE,OAAO,CAAC,IAAI;YACrB,OAAO,EAAE,OAAO,CAAC,IAAI;SACxB,CAAC,CAAC;QAEH,IAAI,CAAC;YACD,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAC9B,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAC/E,CAAC;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,OAAO,GACT,GAAG,YAAY,gCAAqB,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC;gBAC7E,GAAG,YAAY,+BAAoB,CAAE,CAAC,CAAC,+BAA+B,CAAC,CAAC;oBACxE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrD,OAAO;gBACH,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,OAAO,EAAE,UAAU,OAAO,EAAE;gBAC5B,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,CAAC;gBACf,SAAS,EAAE,CAAC;gBACZ,KAAK,EAAE,OAAO;aACjB,CAAC;QACN,CAAC;IACL,CAAC;IAED,kBAAkB;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACtC,CAAC;CACJ;AAnED,sCAmEC"}

package/dist/engine/AgentEngine.d.ts

@@ -0,0 +1,212 @@
+import type { EngineOptions, SessionMemoryData } from '../types';
+import type { Transport } from '../transport/Transport';
+import type { AgentRegistry } from './AgentRegistry';
+import type { ToolRegistry } from './ToolRegistry';
+import { ProviderRegistry } from './ProviderRegistry';
+import { MCPClientManager } from '../mcp/MCPClientManager';
+import type { ObservabilityManager } from '../observability/ObservabilityManager';
+import type { MemorySystem } from '../agent-memory/MemorySystem';
+import type { WorkflowDef, WorkflowResult, WorkflowRunOptions } from '../workflow/types';
+import type { WorkflowBuilder } from '../workflow/WorkflowBuilder';
+import type { Orchestrator } from '../orchestration/orchestrator';
+import type { QAService } from '../qa/qa-service';
+import { type IterationMode, type IterationStats } from './IterationManager';
+export interface AgentEngineOptions extends EngineOptions {
+    agents: AgentRegistry;
+    tools: ToolRegistry;
+    /** Registry of all available providers */
+    providers: ProviderRegistry;
+    /** ID of the provider to use when an agent has no explicit provider set */
+    defaultProvider: string;
+    transport: Transport;
+    defaultAgentId: string;
+    /** Optional persistent memory — replaces the default in-memory SessionMemory */
+    sessionMemory?: SessionMemoryData;
+    /** Orchestrator para clasificacion de tareas, risk scoring y FSM */
+    orchestrator?: Orchestrator;
+    /** QA service para revisar respuestas y registrar gates */
+    qaService?: QAService;
+    /** Si true, deshabilita las revisiones de QA automaticas */
+    noQA?: boolean;
+    /** Callback invocado cuando el QA genera una revision */
+    onQAReview?: (review: string) => void;
+    /** MCP client manager — connects to external MCP servers and registers their tools */
+    mcpManager?: MCPClientManager;
+    /**
+     * Called before executing write/execute tools (write_file, edit_file, run_command) when
+     * iteration mode is 'manual'. Return 'approve' to run, 'approve_all' to run and disable
+     * further prompts this session, 'reject' to skip the tool call.
+     */
+    onToolApproval?: (toolName: string, agentId: string, argsPreview: string) => Promise<import('../types').ToolApprovalDecision>;
+    /**
+     * Iteration mode. Default: 'interactive'.
+     *   interactive  — pauses every maxIterations steps and calls onIterationLimit so the
+     *                  user can inspect progress and decide whether to continue (+batchSize more)
+     *   auto         — never pauses; runs until the agent finishes or hits the global cap (1000)
+     *   step-by-step — calls onStep after every single iteration; maximum user control
+     */
+    iterationMode?: IterationMode;
+    /**
+     * Called when maxIterations is reached in interactive mode.
+     * Return true to continue (+25 iterations), false to stop.
+     */
+    onIterationLimit?: (stats: IterationStats) => Promise<boolean>;
+    /**
+     * Called after every iteration in step-by-step mode.
+     * Return true to continue, false to stop.
+     */
+    onStep?: (stats: IterationStats) => Promise<boolean>;
+    /** Observability manager — pre-created and transport-wrapped by createBaseEngine */
+    observabilityManager?: ObservabilityManager;
+    /** Advanced memory system — episodic/semantic/procedural */
+    memorySystem?: MemorySystem;
+    /** Called once on the first run/runWorkflow to load discovered agents from disk or remote. */
+    loadAgents?: () => Promise<import('../types').AgentProfile[]>;
+    /**
+     * Path to an append-only NDJSON file for tool call audit records.
+     * Each executed tool call is appended as one JSON line with: ts, session, agent, tool, inputPreview, success, durationMs.
+     * Directory is created automatically. Optional — no audit file written when absent.
+     */
+    auditLog?: string;
+}
+export declare class AgentEngine {
+    private readonly opts;
+    private readonly memory;
+    private readonly bus;
+    private readonly skillActivator;
+    private currentAgentId;
+    private messages;
+    private aborted;
+    private abortController;
+    private allSkills;
+    private iterationManager;
+    private activeSkillAddition;
+    private yamlSkillsLoaded;
+    private mcpInitialized;
+    private mcpInitAttempts;
+    private mcpRegisteredServers;
+    private mcpTriggers;
+    private mcpToolTriggers;
+    private approvalDisabled;
+    private static readonly WRITE_TOOLS;
+    /** Tracks what each MCP server blocked/assigned so it can be fully reverted on disconnect. */
+    private mcpAgentBlocks;
+    /**
+     * Commands that always require user approval regardless of iteration mode or
+     * approvalDisabled flag. These are irreversible or high-blast-radius operations:
+     * installing new packages, removing packages, running destructive npm scripts.
+     */
+    private static readonly ALWAYS_ASK_PATTERNS;
+    private agentsLoaded;
+    private memoryContextBlock;
+    constructor(opts: AgentEngineOptions);
+    /** Access the observability manager when configured via createBaseEngine({ observability }). */
+    get observability(): ObservabilityManager | undefined;
+    /** Access the MCP client manager to inspect connected servers and their tools. */
+    getMCPManager(): MCPClientManager | undefined;
+    /**
+     * Updates the working directory used by tools and the system prompt.
+     * Call after a workspace/project switch so file operations target the new
+     * project root without recreating the entire engine.
+     * Also triggers a skill reload so project-scoped skills are refreshed.
+     */
+    updateWorkingDir(newCwd: string): void;
+    /**
+     * Marks YAML skills as stale so the next run() reloads them from disk.
+     * Call after installing, creating, or generating skills so changes take effect
+     * without restarting the engine.
+     * Built-in (in-memory) skills are never affected — only the YAML layers are reloaded.
+     */
+    reloadSkills(): void;
+    /**
+     * Direct single-turn LLM call — no tools, no conversation history, no transport events.
+     * Useful for slash commands that need AI-generated content (e.g. /skills generate).
+     * Uses the engine's default provider and model.
+     */
+    callLLM(prompt: string): Promise<string>;
+    private getProviderForProfile;
+    run(input: string): Promise<void>;
+    runWorkflow(defOrBuilder: WorkflowDef | WorkflowBuilder, opts?: WorkflowRunOptions): Promise<WorkflowResult>;
+    abort(): void;
+    /** Change the iteration mode at runtime — takes effect on the next run(). */
+    setIterationMode(mode: IterationMode): void;
+    /** Returns the current iteration mode. */
+    getIterationMode(): IterationMode;
+    /** Delete persisted history file and reset in-memory conversation. */
+    clearHistory(): void;
+    /** Serialize current conversation to disk (called automatically after each run). */
+    private saveHistory;
+    /**
+     * Trim conversation history to maxContextMessages by dropping oldest messages
+     * at a user-turn boundary. Preserves all assistant↔tool pairs intact.
+     */
+    private trimHistory;
+    private ensureAgentsLoaded;
+    private ensureMCPInitialized;
+    private registerMCPAgent;
+    /**
+     * mode='tools' (default): assigns MCP tools directly to local agent allowedTools.
+     * Also applies blocksCommands to those agents while the server is connected —
+     * forcing them to use the MCP tools instead of equivalent shell commands.
+     * Both tool assignments and command blocks are tracked so they can be
+     * fully reverted when the server disconnects via unregisterMCPServer().
+     */
+    private registerMCPToolPack;
+    /**
+     * mode='agent': wraps the MCP server as a delegatable agent in the roster.
+     * Use only when the remote service has its own reasoning layer or its output
+     * is so large it needs a dedicated summarization turn.
+     */
+    private registerMCPAgentWrapper;
+    private findMCPRoute;
+    switchAgent(agentId: string): void;
+    private getCurrentProfile;
+    private buildAgentRoster;
+    private buildSystemPrompt;
+    /**
+     * Converts an OrchestrationResult into a system-prompt section that tells the
+     * default agent which specialists to use, in what order, and what gates apply.
+     * This closes the gap between the deterministic policy layer and the LLM layer.
+     */
+    private buildOrchestrationBrief;
+    private resolvesDelegateTo;
+    private getToolsForAgent;
+    /**
+     * Merges the orchestrator's current-turn analysis with the explicit context the
+     * LLM provided in the ask_agent call. The analysis (streamBuffer) gives specialists
+     * the reasoning and data the orchestrator gathered before delegating.
+     */
+    private buildSubAgentContext;
+    private runLoop;
+    private runAgentInternal;
+    /**
+     * Unified tool execution used by both runLoop (primary agent) and
+     * runAgentInternal (sub-agents via ask_agent).
+     * Handles: allowedTools authorization → onToolApproval gate → execute → audit → transport.
+     */
+    private executeToolCall;
+    private runToolDef;
+    /**
+     * Returns true when a tool call matches a high-blast-radius pattern that
+     * always requires explicit approval — cannot be bypassed by approve_all or
+     * auto iteration mode.
+     */
+    private requiresAlwaysAsk;
+    /**
+     * Disconnects an MCP server at runtime — reverts all tool assignments and
+     * command blocks it applied to local agents. After calling this, agents that
+     * had tools from this server lose them from allowedTools, and any commands
+     * that were blocked via blocksCommands are unblocked.
+     *
+     * For mode='agent' servers, the wrapper agent is also removed from the roster.
+     * For mode='tools' servers, agents fall back to shell commands automatically.
+     */
+    unregisterMCPServer(serverName: string): void;
+    /** Disable approval gate for the rest of this session (approve_all). */
+    disableToolApproval(): void;
+    /** Re-enable approval gate (e.g. after /iteration manual). */
+    enableToolApproval(): void;
+    private writeAuditRecord;
+    private buildContext;
+}
+//# sourceMappingURL=AgentEngine.d.ts.map

package/dist/engine/AgentEngine.d.ts.map

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