@backendkit-labs/agent-core 0.38.0 → 0.39.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/engine/AgentEngine.d.ts +1 -22
- package/dist/engine/AgentEngine.d.ts.map +1 -1
- package/dist/engine/AgentEngine.js +17 -109
- package/dist/engine/AgentEngine.js.map +1 -1
- package/dist/engine/ApprovalGate.d.ts +4 -3
- package/dist/engine/ApprovalGate.d.ts.map +1 -1
- package/dist/engine/ApprovalGate.js +9 -13
- package/dist/engine/ApprovalGate.js.map +1 -1
- package/dist/engine/MCPRegistrar.js +1 -1
- package/dist/engine/MCPRegistrar.js.map +1 -1
- package/dist/engine/coding-pipeline-hooks.d.ts +28 -0
- package/dist/engine/coding-pipeline-hooks.d.ts.map +1 -0
- package/dist/engine/coding-pipeline-hooks.js +91 -0
- package/dist/engine/coding-pipeline-hooks.js.map +1 -0
- package/dist/engine/createBaseEngine.d.ts +4 -25
- package/dist/engine/createBaseEngine.d.ts.map +1 -1
- package/dist/engine/createBaseEngine.js +1 -6
- package/dist/engine/createBaseEngine.js.map +1 -1
- package/dist/engine/qa-orchestrator.d.ts +11 -12
- package/dist/engine/qa-orchestrator.d.ts.map +1 -1
- package/dist/engine/qa-orchestrator.js +13 -16
- package/dist/engine/qa-orchestrator.js.map +1 -1
- package/dist/governance/hooks.d.ts +2 -0
- package/dist/governance/hooks.d.ts.map +1 -1
- package/dist/governance/hooks.js.map +1 -1
- package/dist/governance/policy.d.ts +5 -0
- package/dist/governance/policy.d.ts.map +1 -1
- package/dist/governance/policy.js +15 -1
- package/dist/governance/policy.js.map +1 -1
- package/dist/index.d.ts +8 -13
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +28 -17
- package/dist/index.js.map +1 -1
- package/dist/reflection/index.d.ts +0 -7
- package/dist/reflection/index.d.ts.map +1 -1
- package/dist/reflection/index.js +1 -16
- package/dist/reflection/index.js.map +1 -1
- package/dist/sandbox/types.d.ts +2 -2
- package/dist/sandbox/types.d.ts.map +1 -1
- package/dist/shared/llm/chat-client.d.ts +16 -0
- package/dist/shared/llm/chat-client.d.ts.map +1 -0
- package/dist/shared/llm/chat-client.js +27 -0
- package/dist/shared/llm/chat-client.js.map +1 -0
- package/dist/shared/llm/resilient-client.d.ts +1 -1
- package/dist/shared/llm/resilient-client.d.ts.map +1 -1
- package/dist/tools/defineTool.d.ts +2 -0
- package/dist/tools/defineTool.d.ts.map +1 -1
- package/dist/tools/defineTool.js +1 -0
- package/dist/tools/defineTool.js.map +1 -1
- package/dist/tools/services.d.ts +7 -0
- package/dist/tools/services.d.ts.map +1 -0
- package/dist/tools/services.js +11 -0
- package/dist/tools/services.js.map +1 -0
- package/dist/types/index.d.ts +14 -38
- package/dist/types/index.d.ts.map +1 -1
- package/package.json +89 -93
|
@@ -11,8 +11,6 @@ import type { MemorySystem } from '../agent-memory/MemorySystem';
|
|
|
11
11
|
import type { CommandContext } from '../commands/SlashCommandRegistry';
|
|
12
12
|
import type { WorkflowDef, WorkflowResult, WorkflowRunOptions } from '../workflow/types';
|
|
13
13
|
import type { WorkflowBuilder } from '../workflow/WorkflowBuilder';
|
|
14
|
-
import type { Orchestrator } from '../orchestration/orchestrator';
|
|
15
|
-
import type { QAService } from '../qa/qa-service';
|
|
16
14
|
import { type IterationMode, type IterationStats } from './IterationManager';
|
|
17
15
|
export interface AgentEngineOptions extends EngineOptions {
|
|
18
16
|
agents: AgentRegistry;
|
|
@@ -32,23 +30,10 @@ export interface AgentEngineOptions extends EngineOptions {
|
|
|
32
30
|
* Set true to keep that behavior while the profiles are fixed.
|
|
33
31
|
*/
|
|
34
32
|
allowUnlistedTools?: boolean;
|
|
35
|
-
/** Orchestrator para clasificacion de tareas, risk scoring y FSM */
|
|
36
|
-
orchestrator?: Orchestrator;
|
|
37
|
-
/**
|
|
38
|
-
* What run() does when the orchestrator throws. 'closed' (default) rethrows: the gates it would have
|
|
39
|
-
* applied cannot be silently skipped. 'open' warns on the transport and runs without orchestration.
|
|
40
|
-
*/
|
|
41
|
-
orchestratorFailureMode?: 'closed' | 'open';
|
|
42
|
-
/** QA service para revisar respuestas y registrar gates */
|
|
43
|
-
qaService?: QAService;
|
|
44
|
-
/** Si true, deshabilita las revisiones de QA automaticas */
|
|
45
|
-
noQA?: boolean;
|
|
46
|
-
/** Callback invocado cuando el QA genera una revision */
|
|
47
|
-
onQAReview?: (review: string) => void;
|
|
48
33
|
/** MCP client manager — connects to external MCP servers and registers their tools */
|
|
49
34
|
mcpManager?: MCPClientManager;
|
|
50
35
|
/**
|
|
51
|
-
* Called before executing write/execute tools (
|
|
36
|
+
* Called before executing write/execute tools (tools that declare `readOnly: false`) when
|
|
52
37
|
* iteration mode is 'manual'. Return 'approve' to run, 'approve_all' to run and disable
|
|
53
38
|
* further prompts this session, 'reject' to skip the tool call.
|
|
54
39
|
*/
|
|
@@ -300,12 +285,6 @@ export declare class AgentEngine {
|
|
|
300
285
|
private getCurrentProfile;
|
|
301
286
|
private buildAgentRoster;
|
|
302
287
|
private buildSystemPrompt;
|
|
303
|
-
/**
|
|
304
|
-
* Converts an OrchestrationResult into a system-prompt section that tells the
|
|
305
|
-
* default agent which specialists to use, in what order, and what gates apply.
|
|
306
|
-
* This closes the gap between the deterministic policy layer and the LLM layer.
|
|
307
|
-
*/
|
|
308
|
-
private buildOrchestrationBrief;
|
|
309
288
|
private resolvesDelegateTo;
|
|
310
289
|
private getToolsForAgent;
|
|
311
290
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"AgentEngine.d.ts","sourceRoot":"","sources":["../../src/engine/AgentEngine.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"AgentEngine.d.ts","sourceRoot":"","sources":["../../src/engine/AgentEngine.ts"],"names":[],"mappings":"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"}
|
|
@@ -13,7 +13,6 @@ const node_crypto_1 = require("node:crypto");
|
|
|
13
13
|
const audit_1 = require("../governance/audit");
|
|
14
14
|
const policy_1 = require("../governance/policy");
|
|
15
15
|
const approval_1 = require("../governance/approval");
|
|
16
|
-
const package_install_1 = require("./package-install");
|
|
17
16
|
const hooks_1 = require("../governance/hooks");
|
|
18
17
|
const canonical_json_1 = require("../shared/utils/canonical-json");
|
|
19
18
|
const DelegationBus_1 = require("../delegation/DelegationBus");
|
|
@@ -21,7 +20,6 @@ const SessionMemory_1 = require("../memory/SessionMemory");
|
|
|
21
20
|
const activator_1 = require("../skills/activator");
|
|
22
21
|
const WorkflowRunner_1 = require("../workflow/WorkflowRunner");
|
|
23
22
|
const IterationManager_1 = require("./IterationManager");
|
|
24
|
-
const qa_orchestrator_1 = require("./qa-orchestrator");
|
|
25
23
|
const MAX_INPUT_BYTES = 100_000; // Fix #17: 100 KB hard cap on user input
|
|
26
24
|
const ASK_AGENT_TOOL = {
|
|
27
25
|
name: 'ask_agent',
|
|
@@ -131,10 +129,10 @@ class AgentEngine {
|
|
|
131
129
|
if (this.governed) {
|
|
132
130
|
const someoneToAsk = !!(opts.approver || opts.approvals || opts.onToolApproval);
|
|
133
131
|
const configured = opts.policy ? (Array.isArray(opts.policy) ? opts.policy : [opts.policy]) : [];
|
|
134
|
-
//
|
|
132
|
+
// What a tool declares with `alwaysAsk` always asks a person, whatever the configured policy says.
|
|
135
133
|
this.policies = [
|
|
136
134
|
...(configured.length > 0 ? configured : someoneToAsk ? [policy_1.defaultToolPolicy] : []),
|
|
137
|
-
|
|
135
|
+
policy_1.declaredAskPolicy,
|
|
138
136
|
];
|
|
139
137
|
if (opts.approver) {
|
|
140
138
|
this.approver = opts.approver;
|
|
@@ -401,20 +399,6 @@ class AgentEngine {
|
|
|
401
399
|
const profile = this.getCurrentProfile();
|
|
402
400
|
if (!profile)
|
|
403
401
|
throw new Error(`Default agent "${this.currentAgentId}" not registered`);
|
|
404
|
-
// Orquestar la tarea para obtener clasificacion, risk scoring y gates requeridos
|
|
405
|
-
let orchestrationResult;
|
|
406
|
-
if (this.opts.orchestrator) {
|
|
407
|
-
try {
|
|
408
|
-
orchestrationResult = await this.opts.orchestrator.orchestrate(input);
|
|
409
|
-
}
|
|
410
|
-
catch (err) {
|
|
411
|
-
const reason = err instanceof Error ? err.message : String(err);
|
|
412
|
-
if ((this.opts.orchestratorFailureMode ?? 'closed') === 'closed') {
|
|
413
|
-
throw new Error(`Orchestrator failed; refusing to run without its gates: ${reason}`);
|
|
414
|
-
}
|
|
415
|
-
this.opts.transport.emit({ type: 'system', level: 'warn', text: `[Orchestrator] failed (${reason}); running without classification or gates` });
|
|
416
|
-
}
|
|
417
|
-
}
|
|
418
402
|
// Hooks of this turn share one context (SPEC-0014 F3). A throwing hook fails the turn.
|
|
419
403
|
this.runController = new AbortController();
|
|
420
404
|
this.lastAnswer = '';
|
|
@@ -423,12 +407,13 @@ class AgentEngine {
|
|
|
423
407
|
input,
|
|
424
408
|
state: new Map(),
|
|
425
409
|
signal: this.runController.signal,
|
|
410
|
+
hasAgent: (id) => this.opts.agents.has(id),
|
|
426
411
|
emit: (event) => this.opts.transport.emit(event),
|
|
427
412
|
};
|
|
428
413
|
try {
|
|
429
414
|
await (0, hooks_1.runHooks)(this.hooks, 'beforeRun', h => h.beforeRun(this.runCtx));
|
|
430
415
|
this.history.push({ role: 'user', content: input });
|
|
431
|
-
await this.runLoop(profile
|
|
416
|
+
await this.runLoop(profile);
|
|
432
417
|
this.saveHistory();
|
|
433
418
|
const finished = this.runCtx;
|
|
434
419
|
await (0, hooks_1.runHooks)(this.hooks, 'afterRun', h => h.afterRun(finished, { text: this.lastAnswer }));
|
|
@@ -469,7 +454,7 @@ class AgentEngine {
|
|
|
469
454
|
toolHookContext(principal) {
|
|
470
455
|
return this.runCtx
|
|
471
456
|
? { ...this.runCtx, principal }
|
|
472
|
-
: { principal, input: '', state: new Map(), signal: new AbortController().signal, emit: (e) => this.opts.transport.emit(e) };
|
|
457
|
+
: { principal, input: '', state: new Map(), signal: new AbortController().signal, hasAgent: (id) => this.opts.agents.has(id), emit: (e) => this.opts.transport.emit(e) };
|
|
473
458
|
}
|
|
474
459
|
async runWorkflow(defOrBuilder, opts = {}) {
|
|
475
460
|
if (this.pendingContextLoad)
|
|
@@ -761,65 +746,24 @@ class AgentEngine {
|
|
|
761
746
|
}
|
|
762
747
|
return parts.join('\n');
|
|
763
748
|
}
|
|
764
|
-
buildSystemPrompt(profile,
|
|
749
|
+
buildSystemPrompt(profile, hookSections = []) {
|
|
765
750
|
const isOrchestrator = profile.id === this.opts.defaultAgentId;
|
|
766
751
|
const parts = [profile.systemPrompt];
|
|
767
752
|
if (isOrchestrator)
|
|
768
753
|
parts.push(this.buildAgentRoster(profile.id));
|
|
769
754
|
if (this.opts.workingDir) {
|
|
770
755
|
parts.push(`## Working Directory\n` +
|
|
771
|
-
`\`${this.opts.workingDir}
|
|
772
|
-
`ALWAYS use RELATIVE paths with tools (e.g. \`src/index.ts\`, \`package.json\`). ` +
|
|
773
|
-
`NEVER invent absolute paths like \`/workspace/...\` or \`/home/...\`.`);
|
|
756
|
+
`\`${this.opts.workingDir}\``);
|
|
774
757
|
}
|
|
775
758
|
if (this.opts.projectContext)
|
|
776
759
|
parts.push(this.opts.projectContext);
|
|
777
|
-
// Per-agent session notes (tool quirks, learnings routed by LearningRouter)
|
|
778
|
-
const agentNotes = this.opts.store?.getAgentNotes?.(profile.id);
|
|
779
|
-
if (agentNotes)
|
|
780
|
-
parts.push(`## Agent Session Notes\n${agentNotes}`);
|
|
781
760
|
if (this.memoryContextBlock)
|
|
782
761
|
parts.push(this.memoryContextBlock);
|
|
783
762
|
if (this.activeSkillAddition)
|
|
784
763
|
parts.push(this.activeSkillAddition);
|
|
785
|
-
if (isOrchestrator && orchestrationResult) {
|
|
786
|
-
parts.push(this.buildOrchestrationBrief(orchestrationResult));
|
|
787
|
-
}
|
|
788
764
|
parts.push(...hookSections);
|
|
789
765
|
return parts.join('\n\n');
|
|
790
766
|
}
|
|
791
|
-
/**
|
|
792
|
-
* Converts an OrchestrationResult into a system-prompt section that tells the
|
|
793
|
-
* default agent which specialists to use, in what order, and what gates apply.
|
|
794
|
-
* This closes the gap between the deterministic policy layer and the LLM layer.
|
|
795
|
-
*/
|
|
796
|
-
buildOrchestrationBrief(result) {
|
|
797
|
-
const { task, selectedAgents, agentPipeline, requiredGates } = result;
|
|
798
|
-
const lines = ['## Orchestrator Analysis — Current Task'];
|
|
799
|
-
const domains = task.domains.length > 0 ? task.domains.join(', ') : 'general';
|
|
800
|
-
lines.push(`**Intent:** ${task.actionType} | **Risk:** ${task.riskLevel} | **Domains:** ${domains}`);
|
|
801
|
-
// Only surface non-trivial agent selections (skip sole-fallback case)
|
|
802
|
-
const nonFallback = selectedAgents.filter(a => !(a.agentId === 'general' && a.score <= 50));
|
|
803
|
-
if (nonFallback.length > 0) {
|
|
804
|
-
lines.push('\n**Recommended agents for this task (highest priority first):**');
|
|
805
|
-
for (const a of nonFallback) {
|
|
806
|
-
lines.push(`- ${a.agentId} — ${a.reason}`);
|
|
807
|
-
}
|
|
808
|
-
lines.push('\nWhen delegating via ask_agent, prioritize the agents listed above. ' +
|
|
809
|
-
'Do not delegate to unlisted agents unless the task explicitly requires it.');
|
|
810
|
-
}
|
|
811
|
-
if (agentPipeline && agentPipeline.length > 0) {
|
|
812
|
-
lines.push('\n**Suggested execution pipeline (respect this order):**');
|
|
813
|
-
agentPipeline.forEach((phase, i) => {
|
|
814
|
-
lines.push(`${i + 1}. [${phase.phase}] ${phase.agentId} — ${phase.purpose}`);
|
|
815
|
-
});
|
|
816
|
-
}
|
|
817
|
-
if (requiredGates.length > 0) {
|
|
818
|
-
lines.push(`\n**Required gates before commit:** ${requiredGates.join(', ')}`);
|
|
819
|
-
lines.push('Ensure each gate is satisfied before considering the task complete.');
|
|
820
|
-
}
|
|
821
|
-
return lines.join('\n');
|
|
822
|
-
}
|
|
823
767
|
resolvesDelegateTo(profile) {
|
|
824
768
|
if (!profile.delegatesTo || profile.delegatesTo.length === 0)
|
|
825
769
|
return [];
|
|
@@ -860,7 +804,7 @@ class AgentEngine {
|
|
|
860
804
|
parts.push(`## Orchestrator Analysis\n${trimmed}`);
|
|
861
805
|
return parts.join('\n\n');
|
|
862
806
|
}
|
|
863
|
-
async runLoop(profile
|
|
807
|
+
async runLoop(profile) {
|
|
864
808
|
let currentProfile = profile;
|
|
865
809
|
this.iterationManager.reset();
|
|
866
810
|
const iterManager = this.iterationManager;
|
|
@@ -882,7 +826,7 @@ class AgentEngine {
|
|
|
882
826
|
await this.prepareContext();
|
|
883
827
|
const systemMsg = {
|
|
884
828
|
role: 'system',
|
|
885
|
-
content: this.buildSystemPrompt(currentProfile,
|
|
829
|
+
content: this.buildSystemPrompt(currentProfile, await this.hookPromptSections(currentProfile)),
|
|
886
830
|
};
|
|
887
831
|
const tools = this.getToolsForAgent(currentProfile);
|
|
888
832
|
const safeHistory = this.history.sanitized();
|
|
@@ -1070,41 +1014,6 @@ class AgentEngine {
|
|
|
1070
1014
|
toolResults.push({ role: 'tool', tool_call_id: call.id, content: results[i] });
|
|
1071
1015
|
});
|
|
1072
1016
|
}
|
|
1073
|
-
// ── QA orchestration: runs when response is final (no tool calls) ─
|
|
1074
|
-
if (toolResults.length === 0 && this.opts.orchestrator && this.opts.qaService && orchestrationResult) {
|
|
1075
|
-
const qaAgentId = this.opts.agents.has('qa-engineer') ? 'qa-engineer' : undefined;
|
|
1076
|
-
const qaCtx = {
|
|
1077
|
-
clean: streamBuffer,
|
|
1078
|
-
orchestrationResult,
|
|
1079
|
-
orchestrator: this.opts.orchestrator,
|
|
1080
|
-
qaService: this.opts.qaService,
|
|
1081
|
-
allAgents: this.opts.agents.getAll(),
|
|
1082
|
-
messages: this.history.getAll(),
|
|
1083
|
-
effectiveAgentId: currentProfile.id,
|
|
1084
|
-
defaultAgentId: this.opts.defaultAgentId,
|
|
1085
|
-
qaAgentId,
|
|
1086
|
-
noQA: this.opts.noQA,
|
|
1087
|
-
onQAReview: this.opts.onQAReview,
|
|
1088
|
-
setEffectiveAgent: (agentId) => {
|
|
1089
|
-
const p = this.opts.agents.get(agentId);
|
|
1090
|
-
if (p)
|
|
1091
|
-
currentProfile = p;
|
|
1092
|
-
},
|
|
1093
|
-
};
|
|
1094
|
-
await (0, qa_orchestrator_1.advanceRequiredGates)(qaCtx);
|
|
1095
|
-
const qaProfile = (0, qa_orchestrator_1.activateQaEngineerIfNeeded)(qaCtx);
|
|
1096
|
-
if (qaProfile) {
|
|
1097
|
-
currentProfile = qaProfile;
|
|
1098
|
-
continue; // re-enter loop as qa-engineer
|
|
1099
|
-
}
|
|
1100
|
-
if (qaAgentId && currentProfile.id === qaAgentId) {
|
|
1101
|
-
await (0, qa_orchestrator_1.processQaEngineerResponse)(qaCtx);
|
|
1102
|
-
currentProfile = profile; // reset to original agent
|
|
1103
|
-
}
|
|
1104
|
-
else {
|
|
1105
|
-
await (0, qa_orchestrator_1.processInlineQaReview)(qaCtx);
|
|
1106
|
-
}
|
|
1107
|
-
}
|
|
1108
1017
|
if (toolResults.length === 0) {
|
|
1109
1018
|
// The model answered without tools: afterTurn hooks may force another pass (SPEC-0014 F3).
|
|
1110
1019
|
this.lastAnswer = streamBuffer;
|
|
@@ -1155,7 +1064,7 @@ class AgentEngine {
|
|
|
1155
1064
|
historySlice = (0, HistoryManager_1.sanitizeMessages)(historySlice);
|
|
1156
1065
|
}
|
|
1157
1066
|
const messages = [
|
|
1158
|
-
{ role: 'system', content: this.buildSystemPrompt(profile,
|
|
1067
|
+
{ role: 'system', content: this.buildSystemPrompt(profile, await this.hookPromptSections(profile)) },
|
|
1159
1068
|
...historySlice,
|
|
1160
1069
|
{ role: 'user', content: context ? `${question}\n\nContext:\n${context}` : question },
|
|
1161
1070
|
];
|
|
@@ -1494,7 +1403,7 @@ class AgentEngine {
|
|
|
1494
1403
|
const sandboxAsk = this.opts.sandbox?.approvalFor
|
|
1495
1404
|
? this.opts.sandbox.approvalFor({ agentId, sessionId: this.opts.sessionId ?? 'default' }, call.name)
|
|
1496
1405
|
: undefined;
|
|
1497
|
-
const gate = await this.serialize(() => this.approvalGate.check(call, agentId, sandboxAsk));
|
|
1406
|
+
const gate = await this.serialize(() => this.approvalGate.check(call, agentId, sandboxAsk, this.opts.tools.get(call.name)));
|
|
1498
1407
|
if (gate === 'rejected') {
|
|
1499
1408
|
return { run: false, decision: 'deny', reason: 'rejected by the approver', message: `Tool call "${call.name}" was rejected by the user.` };
|
|
1500
1409
|
}
|
|
@@ -1728,21 +1637,20 @@ class AgentEngine {
|
|
|
1728
1637
|
const id = agentId ?? this.currentAgentId;
|
|
1729
1638
|
const principal = this.principalFor(id, chain);
|
|
1730
1639
|
const profile = this.opts.agents.get(id);
|
|
1731
|
-
const
|
|
1732
|
-
const
|
|
1733
|
-
|
|
1734
|
-
|
|
1735
|
-
|
|
1640
|
+
const additionalRoots = this.opts.additionalRoots ?? [];
|
|
1641
|
+
const serviceSource = this.opts.services;
|
|
1642
|
+
const serviceMap = serviceSource
|
|
1643
|
+
? new Map(Object.entries(typeof serviceSource === 'function' ? serviceSource(profile) : serviceSource))
|
|
1644
|
+
: undefined;
|
|
1736
1645
|
return {
|
|
1737
1646
|
agentId: id,
|
|
1738
1647
|
sessionId: this.opts.sessionId ?? 'default',
|
|
1739
1648
|
principal,
|
|
1740
1649
|
workingDir: this.opts.workingDir,
|
|
1741
1650
|
memory: this.memory,
|
|
1742
|
-
|
|
1651
|
+
...(serviceMap ? { services: serviceMap } : {}),
|
|
1743
1652
|
advancedMemory: this.opts.memorySystem,
|
|
1744
1653
|
...(additionalRoots.length ? { additionalRoots } : {}),
|
|
1745
|
-
...(profile?.blockedCommands?.length ? { blockedCommands: profile.blockedCommands } : {}),
|
|
1746
1654
|
askAgent: async (agentId, question, context) => {
|
|
1747
1655
|
const result = await this.bus.runSingle({ agentId, question, context, fromAgentId: id, depth: depth + 1, chain: principal.chain });
|
|
1748
1656
|
return result.content;
|