@backendkit-labs/agent-core 0.14.0

package/dist/engine/createBaseEngine.d.ts

@@ -0,0 +1,169 @@
+import { AgentEngine } from './AgentEngine';
+import type { AgentProfile, LLMProvider, ToolDefinition, SessionMemoryData, ProjectStoreData, Skill } from '../types';
+import type { Transport } from '../transport/Transport';
+import type { Orchestrator } from '../orchestration/orchestrator';
+import type { QAService } from '../qa/qa-service';
+import type { MCPServerConfig } from '../mcp/types';
+import type { ObservabilityConfig } from '../observability/types';
+import type { MemorySystem } from '../agent-memory/MemorySystem';
+import type { AgentDiscoveryConfig } from '../agent-discovery/types';
+export interface BaseEngineOptions {
+    /**
+     * Pre-instantiated LLM providers keyed by provider ID.
+     * The caller is responsible for creating the provider instances
+     * (e.g. new AnthropicProvider(...), new OpenAICompatibleProvider(...)).
+     */
+    providers: Record<string, LLMProvider>;
+    /** ID of the provider to use by default. Must exist in providers. */
+    defaultProvider: string;
+    /** Agents to register. Empty by default — caller adds their own agents. */
+    agents?: AgentProfile[];
+    /** Tools to make available to agents. Empty by default. */
+    tools?: ToolDefinition[];
+    /**
+     * Agent ID that receives the first message and orchestrates the session.
+     * Defaults to the first agent's ID, or 'general' if no agents are provided.
+     */
+    defaultAgent?: string;
+    /** How events (tokens, tool calls, errors) are delivered. Defaults to StdoutTransport. */
+    transport?: Transport;
+    /** Max LLM iterations per run() call. Default: 100. */
+    maxIterations?: number;
+    /** Max parallel agent delegations via ask_agent. Default: 6. */
+    maxParallelAgents?: number;
+    /**
+     * Maximum number of messages to keep in conversation history (sliding window).
+     * Oldest messages are dropped at user-turn boundaries to avoid orphaning tool
+     * call / result pairs. A 'system' warn event is emitted when trimming occurs.
+     * Default: unlimited. Recommended: 100 for interactive agents, 40–60 for
+     * long-running autonomous agents.
+     */
+    maxContextMessages?: number;
+    /** Absolute path used as the working directory for tool calls. */
+    workingDir?: string;
+    /** Injected into every agent system prompt (stack, AGENT.md, session, etc.). */
+    projectContext?: string;
+    /** Pre-loaded skills. Injected per-run based on trigger + stack matching. */
+    skills?: Skill[];
+    /** Stack identifiers for skill language gating (e.g. ['node', 'typescript']). */
+    detectedStack?: string[];
+    /**
+     * Called once on first run() to load additional skills from disk.
+     * Results are merged with skills[].
+     */
+    loadSkills?: () => Promise<Skill[]>;
+    /** Custom session memory. Defaults to in-memory SessionMemory. */
+    sessionMemory?: SessionMemoryData;
+    /** Persistent project store (context, learnings, audits). Optional. */
+    store?: ProjectStoreData;
+    /** Session ID for tracking and correlation. */
+    sessionId?: string;
+    /**
+     * Orchestrator for pre-LLM task classification:
+     * intent detection → domain detection → risk scoring → policy engine → FSM gates.
+     * When provided, General receives domain/risk context before each run.
+     * Use createOrchestratedCodingEngine() or pass directly for full control.
+     */
+    orchestrator?: Orchestrator;
+    /**
+     * QA service for automatic code review after high-risk responses.
+     * Requires orchestrator to be set. When active, the qa-engineer agent
+     * is automatically triggered for responses with substantial code.
+     */
+    qaService?: QAService;
+    /** Disable automatic QA reviews even when qaService is configured. */
+    noQA?: boolean;
+    /** Called when QA generates an inline review. */
+    onQAReview?: (review: string) => void;
+    /**
+     * Observability: tracing, metrics, and cost/budget tracking.
+     * Wraps the transport transparently — no changes to existing code needed.
+     *
+     * @example
+     * observability: {
+     *   tracing: { exporter: 'console' },
+     *   costTracker: {
+     *     ...MODEL_PRICING['claude-sonnet-4-6'],
+     *     budget: { perRun: 0.50, perDay: 10.00 },
+     *     onBudgetExceeded: (u) => { engine.abort(); console.warn('Budget exceeded', u); },
+     *   },
+     *   metrics: { onSnapshot: (s) => console.log('runs:', s.runs.total) },
+     * }
+     */
+    observability?: ObservabilityConfig;
+    /**
+     * Agent discovery — load agents from local directories and/or a remote registry.
+     * Discovered agents are merged with statically provided agents[] on the first run().
+     *
+     * Local directories scanned:
+     *   ~/.{appName}/agents/               ← global (shared across projects)
+     *   {workingDir}/.{appName}/agents/    ← project-local (git-tracked)
+     *
+     * @example
+     * agentDiscovery: {
+     *   appName: 'my-app',
+     *   remote: 'https://registry.backendkit.dev/agents',
+     *   install: ['@bk/agent-devops-aws', '@bk/agent-mobile-android'],
+     * }
+     */
+    agentDiscovery?: AgentDiscoveryConfig;
+    /**
+     * 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 into the ask_agent context field.
+     * Sliced at a user-turn boundary. Default: 0.
+     */
+    subAgentContextMessages?: number;
+    /**
+     * Path to a JSON file where conversation history is persisted between sessions.
+     * Loaded on construction; saved after each run() capped at maxContextMessages.
+     * Use engine.clearHistory() to wipe both in-memory and on-disk state.
+     */
+    historyPath?: string;
+    /**
+     * Advanced three-tier memory system (episodic / semantic / procedural).
+     * When provided, memory tools are auto-registered and the context block
+     * is injected into every agent system prompt.
+     *
+     * @example
+     * memorySystem: createMemorySystem({
+     *   episodic:   { provider: 'json', path: '~/.bk/episodes.json' },
+     *   semantic:   { provider: 'json', path: '~/.bk/knowledge.json', embedFn: myEmbedder },
+     *   retention:  { maxEpisodes: 1000 },
+     * })
+     */
+    memorySystem?: MemorySystem;
+    /**
+     * External MCP servers to connect to.
+     * Tools are discovered on the first run() call (lazy connection) and
+     * made available to all agents in the session.
+     *
+     * @example
+     * mcpServers: [
+     *   { name: 'github',   command: 'npx', args: ['@modelcontextprotocol/server-github'],   env: { GITHUB_TOKEN } },
+     *   { name: 'postgres', command: 'npx', args: ['@modelcontextprotocol/server-postgres'],  env: { DATABASE_URL } },
+     * ]
+     */
+    mcpServers?: MCPServerConfig[];
+    /**
+     * Path to an append-only NDJSON file for automatic tool call audit records.
+     * Each tool execution appends one JSON line: ts, session, agent, tool, input (truncated), success, durationMs.
+     * The directory is created automatically if it doesn't exist.
+     * When absent, no audit file is written.
+     */
+    auditLog?: string;
+}
+/**
+ * Minimal engine factory with no domain-specific assumptions.
+ *
+ * Callers provide:
+ * - Pre-instantiated LLM providers
+ * - The agents they want to register
+ * - The tools they want available
+ *
+ * Use this as the foundation for any agent type: coding, autonomous, support, etc.
+ * For a fully configured coding agent, use createCodingEngine() from @backendkit-labs/agent-coding.
+ */
+export declare function createBaseEngine(opts: BaseEngineOptions): AgentEngine;
+//# sourceMappingURL=createBaseEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createBaseEngine.d.ts","sourceRoot":"","sources":["../../src/engine/createBaseEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK5C,OAAO,KAAK,EACR,YAAY,EACZ,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,EACR,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIrE,MAAM,WAAW,iBAAiB;IAC9B;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAEvC,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;IAExB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IAExB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IAEjB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAEpC,kEAAkE;IAClE,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC,uEAAuE;IACvE,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAEzB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,iDAAiD;IACjD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC;;;;;;;;;;;;;;OAcG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,EAAE,oBAAoB,CAAC;IAEtC;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAE/B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,WAAW,CAuErE"}

package/dist/engine/createBaseEngine.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBaseEngine = createBaseEngine;
+const AgentEngine_1 = require("./AgentEngine");
+const AgentRegistry_1 = require("./AgentRegistry");
+const ToolRegistry_1 = require("./ToolRegistry");
+const ProviderRegistry_1 = require("./ProviderRegistry");
+const StdoutTransport_1 = require("../transport/StdoutTransport");
+const MCPClientManager_1 = require("../mcp/MCPClientManager");
+const ObservabilityManager_1 = require("../observability/ObservabilityManager");
+const discoverAgents_1 = require("../agent-discovery/discoverAgents");
+// ── Factory ───────────────────────────────────────────────────────────────────
+/**
+ * Minimal engine factory with no domain-specific assumptions.
+ *
+ * Callers provide:
+ * - Pre-instantiated LLM providers
+ * - The agents they want to register
+ * - The tools they want available
+ *
+ * Use this as the foundation for any agent type: coding, autonomous, support, etc.
+ * For a fully configured coding agent, use createCodingEngine() from @backendkit-labs/agent-coding.
+ */
+function createBaseEngine(opts) {
+    const agents = new AgentRegistry_1.AgentRegistry();
+    for (const agent of opts.agents ?? [])
+        agents.upsert(agent);
+    const tools = new ToolRegistry_1.ToolRegistry();
+    for (const tool of opts.tools ?? [])
+        tools.register(tool);
+    if (opts.memorySystem) {
+        for (const tool of opts.memorySystem.getTools())
+            tools.register(tool);
+    }
+    const providers = new ProviderRegistry_1.ProviderRegistry();
+    for (const [id, provider] of Object.entries(opts.providers)) {
+        providers.register(id, provider);
+    }
+    if (!providers.has(opts.defaultProvider)) {
+        throw new Error(`defaultProvider "${opts.defaultProvider}" is not in providers. ` +
+            `Available: ${Object.keys(opts.providers).join(', ')}`);
+    }
+    const defaultAgentId = opts.defaultAgent
+        ?? opts.agents?.[0]?.id
+        ?? 'general';
+    // Wrap transport with observability if configured
+    const obsManager = opts.observability ? new ObservabilityManager_1.ObservabilityManager(opts.observability) : undefined;
+    const baseTransport = opts.transport ?? new StdoutTransport_1.StdoutTransport();
+    const transport = obsManager ? obsManager.wrapTransport(baseTransport) : baseTransport;
+    return new AgentEngine_1.AgentEngine({
+        model: { provider: opts.defaultProvider, id: opts.defaultProvider },
+        agents,
+        tools,
+        providers,
+        defaultProvider: opts.defaultProvider,
+        transport,
+        defaultAgentId,
+        workingDir: opts.workingDir,
+        maxIterations: opts.maxIterations ?? 100,
+        maxParallelAgents: opts.maxParallelAgents ?? 6,
+        ...(opts.maxContextMessages ? { maxContextMessages: opts.maxContextMessages } : {}),
+        ...(opts.subAgentContextMessages ? { subAgentContextMessages: opts.subAgentContextMessages } : {}),
+        ...(opts.historyPath ? { historyPath: opts.historyPath } : {}),
+        projectContext: opts.projectContext,
+        skills: opts.skills,
+        detectedStack: opts.detectedStack,
+        loadSkills: opts.loadSkills,
+        ...(opts.sessionMemory ? { sessionMemory: opts.sessionMemory } : {}),
+        ...(opts.store ? { store: opts.store } : {}),
+        ...(opts.sessionId ? { sessionId: opts.sessionId } : {}),
+        ...(opts.orchestrator ? { orchestrator: opts.orchestrator } : {}),
+        ...(opts.qaService ? { qaService: opts.qaService } : {}),
+        ...(opts.noQA !== undefined ? { noQA: opts.noQA } : {}),
+        ...(opts.onQAReview ? { onQAReview: opts.onQAReview } : {}),
+        ...(opts.mcpServers?.length
+            ? { mcpManager: new MCPClientManager_1.MCPClientManager(opts.mcpServers) }
+            : {}),
+        ...(obsManager ? { observabilityManager: obsManager } : {}),
+        ...(opts.memorySystem ? { memorySystem: opts.memorySystem } : {}),
+        ...(opts.auditLog ? { auditLog: opts.auditLog } : {}),
+        ...(opts.agentDiscovery
+            ? {
+                loadAgents: () => (0, discoverAgents_1.discoverAgents)({
+                    ...opts.agentDiscovery,
+                    workingDir: opts.agentDiscovery.workingDir ?? opts.workingDir,
+                }),
+            }
+            : {}),
+    });
+}
+//# sourceMappingURL=createBaseEngine.js.map

package/dist/engine/createBaseEngine.js.map

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

package/dist/engine/qa-orchestrator.d.ts

@@ -0,0 +1,56 @@
+import type { AgentProfile, LLMMessage } from '../types';
+import type { Orchestrator } from '../orchestration/orchestrator';
+import type { OrchestrationResult } from '../orchestration/types';
+import type { QAService } from '../qa/qa-service';
+export interface QaContext {
+    clean: string;
+    orchestrationResult: OrchestrationResult;
+    orchestrator: Orchestrator;
+    qaService: QAService;
+    allAgents: AgentProfile[];
+    messages: LLMMessage[];
+    effectiveAgentId: string;
+    /** Agent ID to restore after QA finishes. Defaults to 'general' when omitted. */
+    defaultAgentId?: string;
+    /** Agent ID for the QA reviewer. Defaults to 'qa-engineer' when omitted. */
+    qaAgentId?: string;
+    noQA?: boolean;
+    onQAReview?: (review: string) => void;
+    setEffectiveAgent: (agentId: string) => void;
+}
+/**
+ * Avanza unicamente los gates que la tarea REQUIERE (segun sus flags
+ * requiresArchitectureReview / requiresSecurityReview / requiresQaApproval).
+ * Solo actua si la respuesta tiene codigo sustancial (>= 8 lineas).
+ *
+ * Un gate no requerido no se transiciona ni se registra: hacerlo contaminaba el
+ * audit trail con GO de gates que nunca aplicaban (H-003).
+ *
+ * Distincion clave por tipo de gate:
+ * - architecture / security: no tienen reviewer dedicado en este flujo, asi que
+ *   un gate requerido se auto-pasa con GO silencioso.
+ * - qa: SIEMPRE lo decide un reviewer real (qa-engineer dedicado o review inline).
+ *   Aqui solo posicionamos la tarea en qa_review; el veredicto lo registra ese
+ *   reviewer. Si el reviewer no existe, la tarea queda en qa_review SIN un GO
+ *   falso "sin revisiones pendientes", e isCommitAllowed la mantiene bloqueada.
+ */
+export declare function advanceRequiredGates(ctx: QaContext): Promise<void>;
+/**
+ * Activa el agente qa-engineer cuando el estado de la tarea es qa_review
+ * y el agente actual no es qa-engineer. Retorna el perfil del QA si activo,
+ * null si no es necesario.
+ */
+export declare function activateQaEngineerIfNeeded(ctx: QaContext): AgentProfile | null;
+/**
+ * Procesa la respuesta del agente qa-engineer: registra el gate en AuditReporter,
+ * transiciona el FSM a approved o rework_required, completa el sprint si aprueba
+ * y resetea el agente efectivo al agente por defecto.
+ */
+export declare function processQaEngineerResponse(ctx: QaContext): Promise<void>;
+/**
+ * Procesa QA review inline (sin activar qa-engineer como agente dedicado).
+ * Usa QAService.reviewResponse() para obtener la revision y registra el gate.
+ * Fallback para cuando qa-engineer no esta disponible o noQA es false.
+ */
+export declare function processInlineQaReview(ctx: QaContext): Promise<void>;
+//# sourceMappingURL=qa-orchestrator.d.ts.map

package/dist/engine/qa-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-orchestrator.d.ts","sourceRoot":"","sources":["../../src/engine/qa-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA0BlD,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCxE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,SAAS,GAAG,YAAY,GAAG,IAAI,CAsB9E;AAuDD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAW7E;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzE"}

package/dist/engine/qa-orchestrator.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.advanceRequiredGates = advanceRequiredGates;
+exports.activateQaEngineerIfNeeded = activateQaEngineerIfNeeded;
+exports.processQaEngineerResponse = processQaEngineerResponse;
+exports.processInlineQaReview = processInlineQaReview;
+function normalizeFindings(raw) {
+    return raw.map((f, i) => ({
+        ...f,
+        id: f.id ?? `finding-${i}`,
+        evidencia: f.evidencia ?? '',
+        recomendacion: f.recomendacion ?? '',
+    }));
+}
+const MIN_CODE_LINES = 8;
+const INFORMATIONAL_PATTERNS = [
+    /\bexplain\b/i, /\bexplica(me)?\b/i, /\bdescribe\b/i, /\bqué hace\b/i,
+    /\bcómo funciona\b/i, /\bwhat (is|does|are)\b/i, /\bhow does\b/i,
+    /\bwhat('s| is) this\b/i,
+];
+function isInformationalRequest(rawPrompt) {
+    if (!rawPrompt)
+        return false;
+    return INFORMATIONAL_PATTERNS.some(p => p.test(rawPrompt));
+}
+/**
+ * Avanza unicamente los gates que la tarea REQUIERE (segun sus flags
+ * requiresArchitectureReview / requiresSecurityReview / requiresQaApproval).
+ * Solo actua si la respuesta tiene codigo sustancial (>= 8 lineas).
+ *
+ * Un gate no requerido no se transiciona ni se registra: hacerlo contaminaba el
+ * audit trail con GO de gates que nunca aplicaban (H-003).
+ *
+ * Distincion clave por tipo de gate:
+ * - architecture / security: no tienen reviewer dedicado en este flujo, asi que
+ *   un gate requerido se auto-pasa con GO silencioso.
+ * - qa: SIEMPRE lo decide un reviewer real (qa-engineer dedicado o review inline).
+ *   Aqui solo posicionamos la tarea en qa_review; el veredicto lo registra ese
+ *   reviewer. Si el reviewer no existe, la tarea queda en qa_review SIN un GO
+ *   falso "sin revisiones pendientes", e isCommitAllowed la mantiene bloqueada.
+ */
+async function advanceRequiredGates(ctx) {
+    const { orchestrationResult, orchestrator, qaService, clean } = ctx;
+    if (qaService.countCodeLines(clean) < MIN_CODE_LINES)
+        return;
+    if (isInformationalRequest(orchestrationResult.task.rawPrompt))
+        return;
+    const { task } = orchestrationResult;
+    // Gates auto-pasables: requeridos pero sin reviewer dedicado → GO silencioso.
+    const autoPassGates = [
+        { status: 'design_review', gateName: 'architecture', agentId: 'architecture', required: task.requiresArchitectureReview },
+        { status: 'security_review', gateName: 'security', agentId: 'security', required: task.requiresSecurityReview },
+    ];
+    const reporter = orchestrator.getAuditReporter();
+    for (const gate of autoPassGates) {
+        if (!gate.required)
+            continue;
+        const result = orchestrator.transitionTask(orchestrationResult.task, gate.status);
+        if (result.allowed && result.task) {
+            orchestrationResult.task = result.task;
+            reporter.recordGate(gate.gateName, gate.agentId, 'GO', [], orchestrationResult.task, `Gate automatico: ${gate.gateName} (sin revisiones pendientes)`, true).catch(() => undefined);
+        }
+    }
+    // QA: solo posicionar en qa_review. El GO/NO-GO lo emite el reviewer real
+    // (processQaEngineerResponse o processInlineQaReview), nunca este auto-avance.
+    if (task.requiresQaApproval) {
+        const toQa = orchestrator.transitionTask(orchestrationResult.task, 'qa_review');
+        if (toQa.allowed && toQa.task)
+            orchestrationResult.task = toQa.task;
+    }
+}
+/**
+ * Activa el agente qa-engineer cuando el estado de la tarea es qa_review
+ * y el agente actual no es qa-engineer. Retorna el perfil del QA si activo,
+ * null si no es necesario.
+ */
+function activateQaEngineerIfNeeded(ctx) {
+    const { orchestrationResult, allAgents, noQA, clean, qaService, effectiveAgentId } = ctx;
+    const qaAgentId = ctx.qaAgentId ?? 'qa-engineer';
+    if (orchestrationResult.task.status !== 'qa_review' ||
+        effectiveAgentId === qaAgentId ||
+        noQA ||
+        qaService.countCodeLines(clean) < MIN_CODE_LINES ||
+        isInformationalRequest(orchestrationResult.task.rawPrompt))
+        return null;
+    const qaProfile = allAgents.find(a => a.id === qaAgentId);
+    if (!qaProfile)
+        return null;
+    ctx.messages.push({
+        role: 'user',
+        content: `Revisa el siguiente codigo generado y determina si es apto para commit. ` +
+            `Tu revision es la ultima palabra y sera visible para el usuario.\n\n${clean}`,
+    });
+    ctx.setEffectiveAgent(qaAgentId);
+    return qaProfile;
+}
+/** Shared FSM transition + sprint completion logic for both QA paths. */
+async function applyQaDecision(ctx, approved, findings, gateNote, prependQaReview = false) {
+    const { orchestrationResult, orchestrator } = ctx;
+    const qaAgentId = ctx.qaAgentId ?? 'qa-engineer';
+    const reporter = orchestrator.getAuditReporter();
+    reporter.recordGate('qa', qaAgentId, approved ? 'GO' : 'NO-GO condicional', findings, orchestrationResult.task, gateNote, true).catch(() => undefined);
+    if (approved) {
+        // Solo empujar por qa_review hacia approved cuando la tarea REQUIERE QA.
+        // Una tarea sin gates requeridos puede commitear directamente (isCommitAllowed),
+        // asi que no debemos fabricar un estado 'approved' a traves de un qa_review
+        // que la tarea nunca necesito (H-004). La review inline igual queda registrada.
+        if (prependQaReview &&
+            orchestrationResult.task.requiresQaApproval &&
+            orchestrationResult.task.status !== 'qa_review') {
+            const toQa = orchestrator.transitionTask(orchestrationResult.task, 'qa_review');
+            if (toQa.allowed && toQa.task)
+                orchestrationResult.task = toQa.task;
+        }
+        const toApproved = orchestrator.transitionTask(orchestrationResult.task, 'approved');
+        if (toApproved.allowed && toApproved.task) {
+            orchestrationResult.task = toApproved.task;
+            reporter.completeSprint({
+                name: orchestrationResult.task.rawPrompt?.slice(0, 48) ?? 'sprint',
+                version: '1.0.0',
+                purpose: orchestrationResult.task.rawPrompt ?? 'Implementacion automatica',
+                newFiles: [],
+                modifiedFiles: [],
+                testCount: 0,
+                testTime: '0s',
+            }).catch(() => undefined);
+        }
+    }
+    else {
+        const rework = orchestrator.transitionTask(orchestrationResult.task, 'rework_required');
+        if (rework.allowed && rework.task)
+            orchestrationResult.task = rework.task;
+    }
+}
+/**
+ * Procesa la respuesta del agente qa-engineer: registra el gate en AuditReporter,
+ * transiciona el FSM a approved o rework_required, completa el sprint si aprueba
+ * y resetea el agente efectivo al agente por defecto.
+ */
+async function processQaEngineerResponse(ctx) {
+    const { qaService, clean } = ctx;
+    ctx.onQAReview?.(clean);
+    const findings = normalizeFindings(qaService.extractFindings(clean));
+    const approved = qaService.evaluateReview(clean);
+    await applyQaDecision(ctx, approved, findings, 'QA review del agente qa-engineer (auto-activado)');
+    ctx.setEffectiveAgent(ctx.defaultAgentId ?? 'general');
+}
+/**
+ * Procesa QA review inline (sin activar qa-engineer como agente dedicado).
+ * Usa QAService.reviewResponse() para obtener la revision y registra el gate.
+ * Fallback para cuando qa-engineer no esta disponible o noQA es false.
+ */
+async function processInlineQaReview(ctx) {
+    const { qaService } = ctx;
+    const review = await qaService.reviewResponse(ctx.clean);
+    if (!review)
+        return;
+    ctx.onQAReview?.(review);
+    const findings = normalizeFindings(qaService.extractFindings(review));
+    const approved = qaService.evaluateReview(review);
+    await applyQaDecision(ctx, approved, findings, 'QA review inline post-respuesta', true);
+}
+//# sourceMappingURL=qa-orchestrator.js.map

package/dist/engine/qa-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-orchestrator.js","sourceRoot":"","sources":["../../src/engine/qa-orchestrator.ts"],"names":[],"mappings":";;AA+DA,oDAkCC;AAOD,gEAsBC;AA4DD,8DAWC;AAOD,sDAYC;AAhND,SAAS,iBAAiB,CAAC,GAAwB;IAC/C,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,GAAG,CAAC;QACJ,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,WAAW,CAAC,EAAE;QAC1B,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE;QAC5B,aAAa,EAAE,CAAC,CAAC,aAAa,IAAI,EAAE;KACvC,CAAC,CAAC,CAAC;AACR,CAAC;AAED,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB,MAAM,sBAAsB,GAAG;IAC3B,cAAc,EAAE,mBAAmB,EAAE,eAAe,EAAE,eAAe;IACrE,oBAAoB,EAAE,yBAAyB,EAAE,eAAe;IAChE,wBAAwB;CAC3B,CAAC;AAEF,SAAS,sBAAsB,CAAC,SAAkB;IAC9C,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;AAC/D,CAAC;AAmBD;;;;;;;;;;;;;;;GAeG;AACI,KAAK,UAAU,oBAAoB,CAAC,GAAc;IACrD,MAAM,EAAE,mBAAmB,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;IACpE,IAAI,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,cAAc;QAAE,OAAO;IAC7D,IAAI,sBAAsB,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO;IAEvE,MAAM,EAAE,IAAI,EAAE,GAAG,mBAAmB,CAAC;IAErC,8EAA8E;IAC9E,MAAM,aAAa,GAAwF;QACvG,EAAE,MAAM,EAAE,eAAe,EAAI,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,CAAC,0BAA0B,EAAE;QAC3H,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAM,OAAO,EAAE,UAAU,EAAM,QAAQ,EAAE,IAAI,CAAC,sBAAsB,EAAE;KAC1H,CAAC;IAEF,MAAM,QAAQ,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC;IACjD,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,SAAS;QAC7B,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAClF,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChC,mBAAmB,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACvC,QAAQ,CAAC,UAAU,CACf,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EACrC,mBAAmB,CAAC,IAAI,EACxB,oBAAoB,IAAI,CAAC,QAAQ,8BAA8B,EAC/D,IAAI,CACP,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;IACL,CAAC;IAED,0EAA0E;IAC1E,+EAA+E;IAC/E,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,YAAY,CAAC,cAAc,CAAC,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAChF,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI;YAAE,mBAAmB,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxE,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAgB,0BAA0B,CAAC,GAAc;IACrD,MAAM,EAAE,mBAAmB,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC;IACzF,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,aAAa,CAAC;IAEjD,IACI,mBAAmB,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW;QAC/C,gBAAgB,KAAK,SAAS;QAC9B,IAAI;QACJ,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,cAAc;QAChD,sBAAsB,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC;QAC5D,OAAO,IAAI,CAAC;IAEd,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IAC1D,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QACd,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,0EAA0E;YAC1E,uEAAuE,KAAK,EAAE;KAC1F,CAAC,CAAC;IACH,GAAG,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACjC,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,yEAAyE;AACzE,KAAK,UAAU,eAAe,CAC1B,GAAc,EACd,QAAiB,EACjB,QAAwB,EACxB,QAAgB,EAChB,eAAe,GAAG,KAAK;IAEvB,MAAM,EAAE,mBAAmB,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC;IAClD,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,aAAa,CAAC;IACjD,MAAM,QAAQ,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAEjD,QAAQ,CAAC,UAAU,CACf,IAAI,EAAE,SAAS,EACf,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,EACrC,QAAQ,EACR,mBAAmB,CAAC,IAAI,EACxB,QAAQ,EACR,IAAI,CACP,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAEzB,IAAI,QAAQ,EAAE,CAAC;QACX,yEAAyE;QACzE,iFAAiF;QACjF,4EAA4E;QAC5E,gFAAgF;QAChF,IACI,eAAe;YACf,mBAAmB,CAAC,IAAI,CAAC,kBAAkB;YAC3C,mBAAmB,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,EACjD,CAAC;YACC,MAAM,IAAI,GAAG,YAAY,CAAC,cAAc,CAAC,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAChF,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI;gBAAE,mBAAmB,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACxE,CAAC;QACD,MAAM,UAAU,GAAG,YAAY,CAAC,cAAc,CAAC,mBAAmB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACrF,IAAI,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YACxC,mBAAmB,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;YAC3C,QAAQ,CAAC,cAAc,CAAC;gBACpB,IAAI,EAAW,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,QAAQ;gBAC3E,OAAO,EAAQ,OAAO;gBACtB,OAAO,EAAQ,mBAAmB,CAAC,IAAI,CAAC,SAAS,IAAI,2BAA2B;gBAChF,QAAQ,EAAO,EAAE;gBACjB,aAAa,EAAE,EAAE;gBACjB,SAAS,EAAM,CAAC;gBAChB,QAAQ,EAAO,IAAI;aACtB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QACxF,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI;YAAE,mBAAmB,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAC9E,CAAC;AACL,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,yBAAyB,CAAC,GAAc;IAC1D,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;IAEjC,GAAG,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC;IAExB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAEjD,MAAM,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,kDAAkD,CAAC,CAAC;IAEnG,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,cAAc,IAAI,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,qBAAqB,CAAC,GAAc;IACtD,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC;IAE1B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,GAAG,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC;IAEzB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAElD,MAAM,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,iCAAiC,EAAE,IAAI,CAAC,CAAC;AAC5F,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,83 @@
+export { AgentEngine } from './engine/AgentEngine';
+export type { AgentEngineOptions } from './engine/AgentEngine';
+export { AgentRegistry } from './engine/AgentRegistry';
+export { ToolRegistry } from './engine/ToolRegistry';
+export { ProviderRegistry } from './engine/ProviderRegistry';
+export { createBaseEngine } from './engine/createBaseEngine';
+export type { BaseEngineOptions } from './engine/createBaseEngine';
+export { IterationManager, DEFAULT_MAX_ITERATIONS, DEFAULT_BATCH_SIZE, GLOBAL_LIMIT } from './engine/IterationManager';
+export type { IterationMode, IterationStats, IterationManagerOptions } from './engine/IterationManager';
+export { DelegationBus } from './delegation/DelegationBus';
+export type { DelegationRequest, DelegationResult } from './delegation/DelegationBus';
+export { SessionMemory } from './memory/SessionMemory';
+export type { Transport, Unsubscribe } from './transport/Transport';
+export { StdoutTransport } from './transport/StdoutTransport';
+export { CallbackTransport } from './transport/CallbackTransport';
+export { defineTool, z } from './tools/defineTool';
+export type { TypedToolOptions } from './tools/defineTool';
+export { SkillLoader } from './skills/loader';
+export { SkillManager, createSkillManager } from './skills/manager';
+export type { InstallOptions, InstalledPack } from './skills/manager';
+export { SkillRegistry } from './skills/registry';
+export { SkillActivator } from './skills/activator';
+export { parseMdSkill, skillToMd } from './skills/parse-md-skill';
+export { GitHubProvider, LocalProvider, SkillsShProvider, ObsidianProvider } from './skills/providers';
+export type { SkillSourceProvider, FetchOptions } from './skills/providers';
+export type { LoadedSkills } from './skills/loader';
+export { SlashCommandRegistry } from './commands/SlashCommandRegistry';
+export type { SlashCommand, SlashCommandHandler, CommandContext, CommandAgentInfo, CommandSkillInfo } from './commands/SlashCommandRegistry';
+export { registerBuiltinCommands } from './commands/builtin';
+export { createCheckpoint, listCheckpoints, readCheckpoint, getLatestCheckpoints, extractSessionFromCheckpoint, compactSession, compactSessionContent, } from './checkpoint';
+export type { CheckpointSummary } from './checkpoint';
+export { loadWorkspaces, saveWorkspaces, createWorkspace, addProject, importProject, removeProject, deleteWorkspace, setActiveProject, buildWorkspaceContext, deriveProjectName, migrateFromLegacy, } from './workspace';
+export type { WorkspaceProject, WorkspaceEntry, WorkspacesConfig } from './workspace';
+export { runGlobalSeed } from './bootstrap/GlobalSeed';
+export type { SeedResult } from './bootstrap/GlobalSeed';
+export { loadFrameworkConfig, DEFAULT_CONFIG } from './bootstrap/config';
+export type { FrameworkConfig, ProviderConfig, FrameworkFeatures } from './bootstrap/config';
+export { cwdToProjectKey, getFrameworkDir, getProjectDir } from './shared/utils/project-key';
+export { atomicWrite, atomicWriteSync } from './shared/utils/atomic-write';
+export { ResilientLLMClient } from './shared/llm/resilient-client';
+export type { ResilientLLMClientOptions } from './shared/llm/resilient-client';
+export { Orchestrator } from './orchestration/orchestrator';
+export { adaptProviderToLLMClient } from './orchestration/llm-client-adapter';
+export type { LLMChatClient } from './orchestration/intent-detector';
+export type { OrchestratorConfig, OrchestrationResult, AgentPipelinePhase, PolicyRule, CapabilityMatrix, } from './orchestration/types';
+export { MCPClientManager } from './mcp/MCPClientManager';
+export type { MCPServerConfig } from './mcp/types';
+export { workflow, agent, WorkflowBuilder } from './workflow/WorkflowBuilder';
+export type { StepOptions } from './workflow/WorkflowBuilder';
+export { WorkflowRunner } from './workflow/WorkflowRunner';
+export type { WorkflowDef, WorkflowResult, WorkflowRunOptions } from './workflow/types';
+export { createAutonomousAgent } from './triggers/createAutonomousAgent';
+export type { AutonomousAgentOptions, AutonomousAgent } from './triggers/createAutonomousAgent';
+export { EventBus } from './triggers/EventBus';
+export type { EventPayload } from './triggers/EventBus';
+export { TriggerManager } from './triggers/TriggerManager';
+export type { TriggerConfig, ScheduleTriggerConfig, WebhookTriggerConfig, EventTriggerConfig } from './triggers/types';
+export { ObservabilityManager } from './observability/ObservabilityManager';
+export { CostTracker } from './observability/CostTracker';
+export { MetricsCollector } from './observability/MetricsCollector';
+export { Tracer } from './observability/Tracer';
+export type { ObservabilityConfig, MetricsSnapshot, Span, SpanExporter } from './observability/types';
+export { MODEL_PRICING } from './observability/types';
+export { MemorySystem, createMemorySystem } from './agent-memory/MemorySystem';
+export { EpisodicMemory } from './agent-memory/EpisodicMemory';
+export { SemanticMemory } from './agent-memory/SemanticMemory';
+export { ProceduralMemory } from './agent-memory/ProceduralMemory';
+export { buildMemoryTools } from './agent-memory/tools';
+export { InMemoryStore } from './agent-memory/stores/InMemoryStore';
+export { JsonFileStore } from './agent-memory/stores/JsonFileStore';
+export type { Episode, Knowledge, Pattern, MemorySystemConfig, MemoryStoreBackend } from './agent-memory/types';
+export { discoverAgents } from './agent-discovery/discoverAgents';
+export { RemoteAgentRegistry } from './agent-discovery/RemoteAgentRegistry';
+export { loadAgentsFromDir, globalAgentsDir, projectAgentsDir } from './agent-discovery/AgentPackageLoader';
+export type { AgentPackageFile, AgentDiscoveryConfig, RemoteRegistryIndex } from './agent-discovery/types';
+export { ReflectionEngine } from './reflection/reflection-engine';
+export type { ReflectionStats } from './reflection/reflection-engine';
+export { DomainRegistry, BUILTIN_DOMAINS } from './reflection/domain-registry';
+export type { BuiltinDomain, CustomDomainDefinition, FailureTypeDefinition } from './reflection/domain-registry';
+export { QAService } from './qa/qa-service';
+export type { QAServiceOptions, QAReviewResult } from './qa/qa-service';
+export type { AgentProfile, ToolDefinition, ExecutionContext, SessionMemoryData, ProjectStoreData, SessionUpdates, ModelConfig, LLMMessage, LLMToolCall, LLMStreamCallbacks, LLMProvider, AgentEvent, EngineOptions, JSONSchema, ToolApprovalDecision, Skill, } from './types';
+//# 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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"}