@backendkit-labs/agent-core 0.14.0

package/dist/triggers/WebhookServer.d.ts

@@ -0,0 +1,23 @@
+type WebhookHandler = (body: unknown, headers: Record<string, string>) => void;
+/**
+ * Lightweight HTTP server that routes POST requests to registered webhook handlers.
+ * Supports GitHub-style HMAC-SHA256 signature verification.
+ */
+export declare class WebhookServer {
+    private readonly port;
+    private readonly routes;
+    private server;
+    private readonly maxBodyBytes;
+    constructor(port: number, opts?: {
+        maxBodyBytes?: number;
+    });
+    register(path: string, handler: WebhookHandler, secret?: string): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private handleRequest;
+    private readBody;
+    private normalizeHeaders;
+    private verifySignature;
+}
+export {};
+//# sourceMappingURL=WebhookServer.d.ts.map

package/dist/triggers/WebhookServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookServer.d.ts","sourceRoot":"","sources":["../../src/triggers/WebhookServer.ts"],"names":[],"mappings":"AAGA,KAAK,cAAc,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AAU/E;;;GAGG;AACH,qBAAa,aAAa;IAKV,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAET,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;IAI3E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAItE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAUP,aAAa;IAoC3B,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,eAAe;CAQ1B"}

package/dist/triggers/WebhookServer.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookServer = void 0;
+const http_1 = __importDefault(require("http"));
+const crypto_1 = __importDefault(require("crypto"));
+const DEFAULT_MAX_BODY_BYTES = 1 * 1024 * 1024; // 1 MB
+/**
+ * Lightweight HTTP server that routes POST requests to registered webhook handlers.
+ * Supports GitHub-style HMAC-SHA256 signature verification.
+ */
+class WebhookServer {
+    port;
+    routes = [];
+    server = null;
+    maxBodyBytes;
+    constructor(port, opts) {
+        this.port = port;
+        this.maxBodyBytes = opts?.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES;
+    }
+    register(path, handler, secret) {
+        this.routes.push({ path, secret, handler });
+    }
+    start() {
+        return new Promise((resolve, reject) => {
+            this.server = http_1.default.createServer((req, res) => {
+                this.handleRequest(req, res).catch(err => {
+                    if (!res.headersSent) {
+                        const status = err.code === 413 ? 413 : 500;
+                        res.writeHead(status);
+                        res.end(status === 413 ? 'Payload Too Large' : 'Internal Server Error');
+                    }
+                    if (err.code !== 413) {
+                        console.error('[WebhookServer]', err);
+                    }
+                });
+            });
+            this.server.listen(this.port, () => resolve());
+            this.server.once('error', reject);
+        });
+    }
+    stop() {
+        return new Promise((resolve, reject) => {
+            if (!this.server) {
+                resolve();
+                return;
+            }
+            this.server.close(err => err ? reject(err) : resolve());
+            this.server = null;
+        });
+    }
+    // ── Private ────────────────────────────────────────────────────────────────
+    async handleRequest(req, res) {
+        if (req.method !== 'POST') {
+            res.writeHead(405);
+            res.end('Method Not Allowed');
+            return;
+        }
+        const route = this.routes.find(r => r.path === req.url);
+        if (!route) {
+            res.writeHead(404);
+            res.end('Not Found');
+            return;
+        }
+        const rawBody = await this.readBody(req);
+        const headers = this.normalizeHeaders(req.headers);
+        if (route.secret) {
+            const sig = headers['x-hub-signature-256'];
+            if (!sig || !this.verifySignature(route.secret, rawBody, sig)) {
+                res.writeHead(401);
+                res.end('Unauthorized');
+                return;
+            }
+        }
+        let body;
+        try {
+            body = JSON.parse(rawBody);
+        }
+        catch {
+            body = rawBody;
+        }
+        // Respond immediately — handler runs asynchronously
+        res.writeHead(202);
+        res.end('Accepted');
+        route.handler(body, headers);
+    }
+    readBody(req) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            let totalBytes = 0;
+            req.on('data', (chunk) => {
+                totalBytes += chunk.length;
+                if (totalBytes > this.maxBodyBytes) {
+                    req.destroy();
+                    reject(Object.assign(new Error('Request body too large'), { code: 413 }));
+                    return;
+                }
+                chunks.push(chunk);
+            });
+            req.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+            req.on('error', reject);
+        });
+    }
+    normalizeHeaders(raw) {
+        const out = {};
+        for (const [k, v] of Object.entries(raw)) {
+            if (typeof v === 'string')
+                out[k] = v;
+            else if (Array.isArray(v))
+                out[k] = v.join(', ');
+        }
+        return out;
+    }
+    verifySignature(secret, body, signature) {
+        const expected = `sha256=${crypto_1.default.createHmac('sha256', secret).update(body).digest('hex')}`;
+        try {
+            return crypto_1.default.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.WebhookServer = WebhookServer;
+//# sourceMappingURL=WebhookServer.js.map

package/dist/triggers/WebhookServer.js.map

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

package/dist/triggers/createAutonomousAgent.d.ts

@@ -0,0 +1,49 @@
+import type { BaseEngineOptions } from '../engine/createBaseEngine';
+import type { AgentEngine } from '../engine/AgentEngine';
+import type { TriggerConfig } from './types';
+export interface AutonomousAgentOptions extends BaseEngineOptions {
+    /**
+     * Describes what the agent monitors/accomplishes.
+     * Appended to the project context so agents understand their purpose.
+     */
+    goal?: string;
+    /** Triggers that activate the agent. */
+    triggers: TriggerConfig[];
+    /** HTTP port for webhook triggers. Default: 3000. */
+    webhookPort?: number;
+}
+export interface AutonomousAgent {
+    /** Underlying engine — available for direct engine.run() or engine.runWorkflow() calls. */
+    engine: AgentEngine;
+    /** Start all trigger listeners (webhook server, cron scheduler, event subscriptions). */
+    start(): Promise<void>;
+    /** Stop all trigger listeners and free resources. */
+    stop(): Promise<void>;
+    /**
+     * Emit an event on the process-wide EventBus.
+     * Activates any event trigger subscribed to the given topic.
+     */
+    emit(topic: string, data: unknown, source?: string): void;
+}
+/**
+ * Creates an agent that activates on external events instead of requiring
+ * manual engine.run() calls.
+ *
+ * @example
+ * const agent = createAutonomousAgent({
+ *   providers: { claude: new AnthropicProvider(API_KEY) },
+ *   defaultProvider: 'claude',
+ *   agents: [monitorAgent],
+ *   goal: 'Monitor PRs and flag security issues',
+ *   triggers: [
+ *     { type: 'webhook',  path: '/github/pr',   secret: GITHUB_SECRET },
+ *     { type: 'schedule', cron: '0 9 * * 1-5',  task: 'Send daily digest' },
+ *     { type: 'event',    topic: 'ci.failed',   source: 'github-actions' },
+ *   ],
+ * });
+ *
+ * await agent.start();
+ * process.on('SIGTERM', () => agent.stop());
+ */
+export declare function createAutonomousAgent(opts: AutonomousAgentOptions): AutonomousAgent;
+//# sourceMappingURL=createAutonomousAgent.d.ts.map

package/dist/triggers/createAutonomousAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAutonomousAgent.d.ts","sourceRoot":"","sources":["../../src/triggers/createAutonomousAgent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC7D;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC5B,2FAA2F;IAC3F,MAAM,EAAE,WAAW,CAAC;IACpB,yFAAyF;IACzF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,qDAAqD;IACrD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,eAAe,CAuBnF"}

package/dist/triggers/createAutonomousAgent.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAutonomousAgent = createAutonomousAgent;
+const createBaseEngine_1 = require("../engine/createBaseEngine");
+const StdoutTransport_1 = require("../transport/StdoutTransport");
+const TriggerManager_1 = require("./TriggerManager");
+/**
+ * Creates an agent that activates on external events instead of requiring
+ * manual engine.run() calls.
+ *
+ * @example
+ * const agent = createAutonomousAgent({
+ *   providers: { claude: new AnthropicProvider(API_KEY) },
+ *   defaultProvider: 'claude',
+ *   agents: [monitorAgent],
+ *   goal: 'Monitor PRs and flag security issues',
+ *   triggers: [
+ *     { type: 'webhook',  path: '/github/pr',   secret: GITHUB_SECRET },
+ *     { type: 'schedule', cron: '0 9 * * 1-5',  task: 'Send daily digest' },
+ *     { type: 'event',    topic: 'ci.failed',   source: 'github-actions' },
+ *   ],
+ * });
+ *
+ * await agent.start();
+ * process.on('SIGTERM', () => agent.stop());
+ */
+function createAutonomousAgent(opts) {
+    const transport = opts.transport ?? new StdoutTransport_1.StdoutTransport();
+    const projectContext = [
+        opts.projectContext,
+        opts.goal ? `Agent goal: ${opts.goal}` : undefined,
+    ].filter(Boolean).join('\n\n') || undefined;
+    const engine = (0, createBaseEngine_1.createBaseEngine)({ ...opts, transport, projectContext });
+    const manager = new TriggerManager_1.TriggerManager(engine, opts.triggers, opts.webhookPort ?? 3000, transport);
+    return {
+        engine,
+        start: () => manager.start(),
+        stop: () => manager.stop(),
+        emit: (topic, data, source) => manager.emit(topic, data, source),
+    };
+}
+//# sourceMappingURL=createAutonomousAgent.js.map

package/dist/triggers/createAutonomousAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAutonomousAgent.js","sourceRoot":"","sources":["../../src/triggers/createAutonomousAgent.ts"],"names":[],"mappings":";;AAqDA,sDAuBC;AA5ED,iEAA8D;AAG9D,kEAA+D;AAC/D,qDAAkD;AA6BlD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,qBAAqB,CAAC,IAA4B;IAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,iCAAe,EAAE,CAAC;IAE1D,MAAM,cAAc,GAAG;QACnB,IAAI,CAAC,cAAc;QACnB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;KACrD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;IAE5C,MAAM,MAAM,GAAG,IAAA,mCAAgB,EAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;IAExE,MAAM,OAAO,GAAG,IAAI,+BAAc,CAC9B,MAAM,EACN,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,WAAW,IAAI,IAAI,EACxB,SAAS,CACZ,CAAC;IAEF,OAAO;QACH,MAAM;QACN,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;QAC5B,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE;QAC1B,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC;KACnE,CAAC;AACN,CAAC"}

package/dist/triggers/index.d.ts

@@ -0,0 +1,8 @@
+export { createAutonomousAgent } from './createAutonomousAgent';
+export type { AutonomousAgentOptions, AutonomousAgent } from './createAutonomousAgent';
+export { EventBus } from './EventBus';
+export type { EventPayload } from './EventBus';
+export { TriggerManager } from './TriggerManager';
+export { WebhookServer } from './WebhookServer';
+export type { TriggerConfig, ScheduleTriggerConfig, WebhookTriggerConfig, EventTriggerConfig } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/triggers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}

package/dist/triggers/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookServer = exports.TriggerManager = exports.EventBus = exports.createAutonomousAgent = void 0;
+var createAutonomousAgent_1 = require("./createAutonomousAgent");
+Object.defineProperty(exports, "createAutonomousAgent", { enumerable: true, get: function () { return createAutonomousAgent_1.createAutonomousAgent; } });
+var EventBus_1 = require("./EventBus");
+Object.defineProperty(exports, "EventBus", { enumerable: true, get: function () { return EventBus_1.EventBus; } });
+var TriggerManager_1 = require("./TriggerManager");
+Object.defineProperty(exports, "TriggerManager", { enumerable: true, get: function () { return TriggerManager_1.TriggerManager; } });
+var WebhookServer_1 = require("./WebhookServer");
+Object.defineProperty(exports, "WebhookServer", { enumerable: true, get: function () { return WebhookServer_1.WebhookServer; } });
+//# sourceMappingURL=index.js.map

package/dist/triggers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/triggers/index.ts"],"names":[],"mappings":";;;AAAA,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAE9B,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AAEjB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA"}

package/dist/triggers/types.d.ts

@@ -0,0 +1,35 @@
+export type TriggerConfig = ScheduleTriggerConfig | WebhookTriggerConfig | EventTriggerConfig;
+export interface ScheduleTriggerConfig {
+    type: 'schedule';
+    /** Standard 5-field cron expression (e.g. '0 9 * * 1-5'). */
+    cron: string;
+    /** Prompt passed to engine.run() each time the schedule fires. */
+    task: string;
+    /** IANA timezone (e.g. 'America/New_York'). Defaults to system timezone. */
+    timezone?: string;
+}
+export interface WebhookTriggerConfig {
+    type: 'webhook';
+    /** URL path to listen on (e.g. '/github/pr'). Must start with '/'. */
+    path: string;
+    /** HMAC-SHA256 secret for GitHub-style signature verification (X-Hub-Signature-256). */
+    secret?: string;
+    /**
+     * Build the prompt from the request body and headers.
+     * Defaults to a JSON dump of the body prefixed with the path.
+     */
+    buildPrompt?: (body: unknown, headers: Record<string, string>) => string;
+}
+export interface EventTriggerConfig {
+    type: 'event';
+    /** Topic name to subscribe to (e.g. 'ci.failed'). */
+    topic: string;
+    /** Only fire when the event payload's source field matches. */
+    source?: string;
+    /**
+     * Build the prompt from the event payload.
+     * Defaults to a JSON dump prefixed with the topic.
+     */
+    buildPrompt?: (payload: unknown) => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/triggers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/triggers/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,kBAAkB,CAAC;AAE9F,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC;CAC5E;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;CAC9C"}

package/dist/triggers/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/triggers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/triggers/types.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,256 @@
+export interface AgentProfile {
+    id: string;
+    name: string;
+    icon: string;
+    description: string;
+    systemPrompt: string;
+    allowedTools: string[];
+    /** Agent IDs this agent can delegate to. Use ['*'] to allow delegation to all registered agents. */
+    delegatesTo?: string[] | ['*'];
+    suppressDefaultOutput?: boolean;
+    provider?: string;
+    /** Where this agent was loaded from */
+    source?: 'builtin' | 'global' | 'project' | 'registry' | 'mcp';
+    /** Additional instructions appended to the base system prompt when this agent is active. */
+    systemPromptAddition?: string;
+    /**
+     * Shell binaries this agent is NOT allowed to execute via run_command,
+     * even if they are on the global COMMAND_ALLOWLIST.
+     * Used to steer agents toward MCP tools when an equivalent capability exists.
+     * Example: blockedCommands: ['docker'] forces data/backend to use pg_create
+     * instead of running docker commands directly.
+     */
+    blockedCommands?: string[];
+}
+export type JSONSchema = Record<string, unknown>;
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: JSONSchema;
+    execute(args: unknown, ctx: ExecutionContext): Promise<string>;
+}
+export interface ExecutionContext {
+    agentId: string;
+    sessionId: string;
+    workingDir?: string;
+    memory: SessionMemoryData;
+    store?: ProjectStoreData;
+    askAgent(agentId: string, question: string, context?: string): Promise<string>;
+    /** Direct LLM call — single user prompt, returns text. Used by routing/compaction tools. */
+    llmCall?(prompt: string): Promise<string>;
+    /** Emit a compacting progress event to the display layer. */
+    emitCompacting?(phase: 'start' | 'done' | 'fail', label: string): void;
+    /** Advanced three-tier memory (episodic/semantic/procedural). Present when configured via createBaseEngine({ memorySystem }). */
+    advancedMemory?: import('../agent-memory/MemorySystem').MemorySystem;
+    /**
+     * Shell binaries this agent is not allowed to run. Populated from the
+     * agent profile's blockedCommands field. Enforced by run_command.
+     */
+    blockedCommands?: string[];
+}
+export interface SessionMemoryData {
+    get(key: string): string | undefined;
+    set(key: string, value: string): void;
+    getAll(): Record<string, string>;
+}
+/** Fields the agent can update in memory/session.md via the update_session tool. */
+export interface SessionUpdates {
+    /** Replace the Current Feature section — what is being worked on + progress */
+    feature?: string;
+    /** Append bullets to Decisions — key choices made (accumulates over time) */
+    decisions?: string[];
+    /** Replace Active Issues section — current blockers or open items */
+    issues?: string[];
+    /** Append bullets to Engine Learnings — non-obvious codebase discoveries (accumulates) */
+    learnings?: string[];
+    /** Replace Next Steps section — what needs to happen after this */
+    next_steps?: string[];
+}
+export interface ProjectStoreData {
+    /** Absolute path to the project memory directory (~/.{appName}/projects/{key}). Read-only. */
+    readonly projectDir?: string;
+    appendContext(content: string): void;
+    appendLearning(content: string): void;
+    saveAudit(agentId: string, content: string): void;
+    getContext(): string;
+    getLearnings(): string;
+    /** Returns combined global + project agent-notes for a given agent id. */
+    getAgentNotes?(agentId: string): string;
+    listAudits(): string[];
+    getLatestAudit(agentId: string): string | null;
+    appendUserPreference(content: string): void;
+    updateSession(updates: SessionUpdates): void;
+}
+export interface ModelConfig {
+    provider: 'deepseek' | 'openai' | 'anthropic' | string;
+    id: string;
+    apiKey?: string;
+    baseUrl?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+export interface LLMMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | null;
+    tool_calls?: LLMToolCall[];
+    tool_call_id?: string;
+}
+export interface LLMToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface LLMStreamCallbacks {
+    onChunk?(delta: string): void;
+    onToolCall?(name: string, args: string, id: string): void;
+    onDone(message: LLMMessage): void;
+    onError(err: Error): void;
+    /** Optional — providers that know token usage should call this so cost tracking works. */
+    onMetrics?(inputTokens: number, outputTokens: number): void;
+    /**
+     * Optional AbortSignal. Pass to the underlying HTTP request so that
+     * AgentEngine.abort() cancels the in-flight stream immediately.
+     * Providers that don't support it can safely ignore it.
+     */
+    signal?: AbortSignal;
+}
+export interface LLMProvider {
+    chat(messages: LLMMessage[], tools: ToolDefinition[], callbacks: LLMStreamCallbacks): Promise<void>;
+}
+export type ToolApprovalDecision = 'approve' | 'approve_all' | 'reject';
+export type AgentEvent = {
+    type: 'ready';
+} | {
+    type: 'token';
+    content: string;
+    agent_id?: string;
+} | {
+    type: 'tool_call';
+    name: string;
+    args_preview?: string;
+} | {
+    type: 'tool_result';
+    name: string;
+    success: boolean;
+    preview?: string;
+} | {
+    type: 'tool_approval_request';
+    tool_name: string;
+    agent_id: string;
+    args_preview: string;
+} | {
+    type: 'agent_switch';
+    from: string;
+    to: string;
+    to_name?: string;
+    to_icon?: string;
+} | {
+    type: 'block_start';
+    agent_id: string;
+    agent_name?: string;
+    agent_icon?: string;
+} | {
+    type: 'block_end';
+    status: 'ok' | 'error';
+    agent_id?: string;
+} | {
+    type: 'thinking';
+    label: string;
+} | {
+    type: 'metrics';
+    input_tokens: number;
+    output_tokens: number;
+    cost_usd?: number;
+} | {
+    type: 'done';
+} | {
+    type: 'error';
+    message: string;
+} | {
+    type: 'system';
+    level: 'info' | 'warn' | 'error';
+    text: string;
+} | {
+    type: 'workflow_start';
+    name: string;
+} | {
+    type: 'workflow_step_start';
+    step: string;
+    agent: string;
+} | {
+    type: 'workflow_step_complete';
+    step: string;
+    success: boolean;
+} | {
+    type: 'workflow_approval_required';
+    step: string;
+} | {
+    type: 'workflow_complete';
+    name: string;
+    status: 'completed' | 'failed' | 'rejected';
+} | {
+    type: 'compacting';
+    label: string;
+    phase: 'start' | 'done' | 'fail';
+};
+import type { Skill } from '../skills/types';
+export type { Skill };
+export interface EngineOptions {
+    model: ModelConfig;
+    maxIterations?: number;
+    maxParallelAgents?: number;
+    /**
+     * Maximum number of messages to keep in the conversation history.
+     * When exceeded, the oldest messages are dropped at the next user-turn boundary
+     * to avoid orphaning tool call / tool result pairs.
+     * Emits a 'system' warn event when trimming occurs.
+     * Default: unlimited (undefined).
+     *
+     * Recommended: 100–200 for interactive agents; 40–60 for long-running autonomous agents.
+     */
+    maxContextMessages?: number;
+    workingDir?: string;
+    sessionId?: string;
+    /** Context injected into every agent system prompt (USER.md + AGENT.md + memory/contexto-proyecto.md + learnings.md + memory/session.md + audits/lecciones-aprendidas.md) */
+    projectContext?: string;
+    /** Persistent store for context, learnings, audits and logs */
+    store?: ProjectStoreData;
+    /**
+     * Pre-loaded skills (builtins + any statically provided skills).
+     * Injected into the system prompt per-run based on trigger + stack matching.
+     */
+    skills?: Skill[];
+    /**
+     * Stack identifiers detected from the project (e.g. ['node', 'typescript']).
+     * Used as the language gate when activating pack skills.
+     */
+    detectedStack?: string[];
+    /**
+     * Called once on the first run() to load user YAML skills from disk
+     * (global, packs and project layers). Results are merged with skills[].
+     */
+    loadSkills?: () => Promise<Skill[]>;
+    /**
+     * Path to a JSON file where conversation history is persisted between sessions.
+     * On construction the engine loads the file into this.messages (non-system messages only).
+     * After each run() the conversation is saved, capped at maxContextMessages (default 100).
+     * Use engine.clearHistory() to wipe both in-memory and on-disk state.
+     * When absent, conversation history is lost when the engine is destroyed.
+     */
+    historyPath?: string;
+    /**
+     * Number of recent messages from the orchestrator's conversation to inject
+     * into each sub-agent call before the delegated question. Gives specialist
+     * agents visibility into previous tool results (file reads, command outputs,
+     * prior LLM responses) without requiring the orchestrator to copy-paste data.
+     *
+     * Sliced at a user-turn boundary to avoid orphaning tool call/result pairs.
+     * Default: 0 (sub-agents only see their own question + explicit context).
+     * Recommended: 10–20 for complex multi-turn tasks.
+     */
+    subAgentContextMessages?: number;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,4 @@
+"use strict";
+// ─── Agent Profile ────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA,iFAAiF"}

package/dist/workflow/WorkflowBuilder.d.ts

@@ -0,0 +1,22 @@
+import type { AgentRef, WorkflowDef } from './types';
+export interface StepOptions {
+    /** Prompt passed to the agent. */
+    input: string;
+    /** Step IDs this step waits for. Parallel by default when no deps. */
+    dependsOn?: string[];
+    /** Pause for human approval before this step executes. */
+    requireApproval?: boolean;
+}
+export declare class WorkflowBuilder {
+    private readonly _name;
+    private readonly _steps;
+    constructor(_name: string);
+    step(id: string, agentRef: AgentRef, opts: StepOptions): this;
+    build(): WorkflowDef;
+    private validate;
+}
+/** Creates a new workflow builder. */
+export declare function workflow(name: string): WorkflowBuilder;
+/** Creates an agent reference for use in workflow step definitions. */
+export declare function agent(id: string): AgentRef;
+//# sourceMappingURL=WorkflowBuilder.d.ts.map

package/dist/workflow/WorkflowBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowBuilder.d.ts","sourceRoot":"","sources":["../../src/workflow/WorkflowBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAmB,MAAM,SAAS,CAAC;AAEtE,MAAM,WAAW,WAAW;IACxB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,qBAAa,eAAe;IAGZ,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAEnB,KAAK,EAAE,MAAM;IAE1C,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI;IAc7D,KAAK,IAAI,WAAW;IAKpB,OAAO,CAAC,QAAQ;CA+BnB;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAEtD;AAED,uEAAuE;AACvE,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAE1C"}