dvalincode 0.12.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/LICENSE +22 -0
- package/README.md +649 -0
- package/README.zh-CN.md +623 -0
- package/THIRD_PARTY_NOTICES.md +432 -0
- package/dist/agent/compact.d.ts +4 -0
- package/dist/agent/compact.js +40 -0
- package/dist/agent/compact.js.map +1 -0
- package/dist/agent/loop.d.ts +44 -0
- package/dist/agent/loop.js +262 -0
- package/dist/agent/loop.js.map +1 -0
- package/dist/agent/modes.d.ts +13 -0
- package/dist/agent/modes.js +44 -0
- package/dist/agent/modes.js.map +1 -0
- package/dist/agent/runner.d.ts +37 -0
- package/dist/agent/runner.js +171 -0
- package/dist/agent/runner.js.map +1 -0
- package/dist/agent/session.d.ts +73 -0
- package/dist/agent/session.js +282 -0
- package/dist/agent/session.js.map +1 -0
- package/dist/agent/types.d.ts +86 -0
- package/dist/agent/types.js +26 -0
- package/dist/agent/types.js.map +1 -0
- package/dist/audit/diffStat.d.ts +8 -0
- package/dist/audit/diffStat.js +17 -0
- package/dist/audit/diffStat.js.map +1 -0
- package/dist/audit/hash.d.ts +10 -0
- package/dist/audit/hash.js +33 -0
- package/dist/audit/hash.js.map +1 -0
- package/dist/audit/log.d.ts +147 -0
- package/dist/audit/log.js +163 -0
- package/dist/audit/log.js.map +1 -0
- package/dist/audit/minimize.d.ts +10 -0
- package/dist/audit/minimize.js +61 -0
- package/dist/audit/minimize.js.map +1 -0
- package/dist/audit/report.d.ts +8 -0
- package/dist/audit/report.js +113 -0
- package/dist/audit/report.js.map +1 -0
- package/dist/audit/taps.d.ts +8 -0
- package/dist/audit/taps.js +67 -0
- package/dist/audit/taps.js.map +1 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.js +56 -0
- package/dist/cli.js.map +1 -0
- package/dist/commands/ask.d.ts +3 -0
- package/dist/commands/ask.js +14 -0
- package/dist/commands/ask.js.map +1 -0
- package/dist/commands/chat.d.ts +3 -0
- package/dist/commands/chat.js +148 -0
- package/dist/commands/chat.js.map +1 -0
- package/dist/commands/data.d.ts +2 -0
- package/dist/commands/data.js +65 -0
- package/dist/commands/data.js.map +1 -0
- package/dist/commands/evidence.d.ts +2 -0
- package/dist/commands/evidence.js +50 -0
- package/dist/commands/evidence.js.map +1 -0
- package/dist/commands/init.d.ts +2 -0
- package/dist/commands/init.js +18 -0
- package/dist/commands/init.js.map +1 -0
- package/dist/commands/memory.d.ts +2 -0
- package/dist/commands/memory.js +74 -0
- package/dist/commands/memory.js.map +1 -0
- package/dist/commands/policy.d.ts +2 -0
- package/dist/commands/policy.js +95 -0
- package/dist/commands/policy.js.map +1 -0
- package/dist/commands/provider.d.ts +2 -0
- package/dist/commands/provider.js +130 -0
- package/dist/commands/provider.js.map +1 -0
- package/dist/commands/report.d.ts +2 -0
- package/dist/commands/report.js +47 -0
- package/dist/commands/report.js.map +1 -0
- package/dist/commands/runTool.d.ts +3 -0
- package/dist/commands/runTool.js +41 -0
- package/dist/commands/runTool.js.map +1 -0
- package/dist/commands/scan.d.ts +2 -0
- package/dist/commands/scan.js +15 -0
- package/dist/commands/scan.js.map +1 -0
- package/dist/commands/serve.d.ts +2 -0
- package/dist/commands/serve.js +18 -0
- package/dist/commands/serve.js.map +1 -0
- package/dist/commands/tools.d.ts +3 -0
- package/dist/commands/tools.js +11 -0
- package/dist/commands/tools.js.map +1 -0
- package/dist/commands/trust.d.ts +2 -0
- package/dist/commands/trust.js +16 -0
- package/dist/commands/trust.js.map +1 -0
- package/dist/commands/tui.d.ts +2 -0
- package/dist/commands/tui.js +13 -0
- package/dist/commands/tui.js.map +1 -0
- package/dist/core/context.d.ts +28 -0
- package/dist/core/context.js +29 -0
- package/dist/core/context.js.map +1 -0
- package/dist/core/diffPreview.d.ts +6 -0
- package/dist/core/diffPreview.js +37 -0
- package/dist/core/diffPreview.js.map +1 -0
- package/dist/core/ignorefile.d.ts +1 -0
- package/dist/core/ignorefile.js +14 -0
- package/dist/core/ignorefile.js.map +1 -0
- package/dist/core/permissions.d.ts +3 -0
- package/dist/core/permissions.js +9 -0
- package/dist/core/permissions.js.map +1 -0
- package/dist/core/policy.d.ts +182 -0
- package/dist/core/policy.js +358 -0
- package/dist/core/policy.js.map +1 -0
- package/dist/core/projectScanner.d.ts +12 -0
- package/dist/core/projectScanner.js +85 -0
- package/dist/core/projectScanner.js.map +1 -0
- package/dist/core/subprocessSandbox.d.ts +42 -0
- package/dist/core/subprocessSandbox.js +132 -0
- package/dist/core/subprocessSandbox.js.map +1 -0
- package/dist/core/trust.d.ts +50 -0
- package/dist/core/trust.js +191 -0
- package/dist/core/trust.js.map +1 -0
- package/dist/core/workspace.d.ts +9 -0
- package/dist/core/workspace.js +55 -0
- package/dist/core/workspace.js.map +1 -0
- package/dist/data/archive.d.ts +39 -0
- package/dist/data/archive.js +127 -0
- package/dist/data/archive.js.map +1 -0
- package/dist/evidence/compliance.d.ts +22 -0
- package/dist/evidence/compliance.js +57 -0
- package/dist/evidence/compliance.js.map +1 -0
- package/dist/evidence/pack.d.ts +56 -0
- package/dist/evidence/pack.js +123 -0
- package/dist/evidence/pack.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +8 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp/client.d.ts +45 -0
- package/dist/mcp/client.js +111 -0
- package/dist/mcp/client.js.map +1 -0
- package/dist/mcp/config.d.ts +10 -0
- package/dist/mcp/config.js +18 -0
- package/dist/mcp/config.js.map +1 -0
- package/dist/mcp/governedFetch.d.ts +16 -0
- package/dist/mcp/governedFetch.js +44 -0
- package/dist/mcp/governedFetch.js.map +1 -0
- package/dist/mcp/register.d.ts +26 -0
- package/dist/mcp/register.js +77 -0
- package/dist/mcp/register.js.map +1 -0
- package/dist/memory/importers.d.ts +17 -0
- package/dist/memory/importers.js +186 -0
- package/dist/memory/importers.js.map +1 -0
- package/dist/memory/store.d.ts +71 -0
- package/dist/memory/store.js +251 -0
- package/dist/memory/store.js.map +1 -0
- package/dist/providers/egress.d.ts +2 -0
- package/dist/providers/egress.js +172 -0
- package/dist/providers/egress.js.map +1 -0
- package/dist/providers/localPlanner.d.ts +3 -0
- package/dist/providers/localPlanner.js +21 -0
- package/dist/providers/localPlanner.js.map +1 -0
- package/dist/providers/manager.d.ts +30 -0
- package/dist/providers/manager.js +48 -0
- package/dist/providers/manager.js.map +1 -0
- package/dist/providers/openaiCompatible.d.ts +5 -0
- package/dist/providers/openaiCompatible.js +176 -0
- package/dist/providers/openaiCompatible.js.map +1 -0
- package/dist/providers/pool.d.ts +14 -0
- package/dist/providers/pool.js +59 -0
- package/dist/providers/pool.js.map +1 -0
- package/dist/providers/secrets.d.ts +8 -0
- package/dist/providers/secrets.js +17 -0
- package/dist/providers/secrets.js.map +1 -0
- package/dist/providers/trustedBaseUrls.d.ts +1 -0
- package/dist/providers/trustedBaseUrls.js +49 -0
- package/dist/providers/trustedBaseUrls.js.map +1 -0
- package/dist/providers/types.d.ts +59 -0
- package/dist/providers/types.js +2 -0
- package/dist/providers/types.js.map +1 -0
- package/dist/remediation/cases.d.ts +37 -0
- package/dist/remediation/cases.js +90 -0
- package/dist/remediation/cases.js.map +1 -0
- package/dist/remediation/localScan.d.ts +2 -0
- package/dist/remediation/localScan.js +212 -0
- package/dist/remediation/localScan.js.map +1 -0
- package/dist/remediation/sarif.d.ts +26 -0
- package/dist/remediation/sarif.js +150 -0
- package/dist/remediation/sarif.js.map +1 -0
- package/dist/remediation/worktree.d.ts +11 -0
- package/dist/remediation/worktree.js +90 -0
- package/dist/remediation/worktree.js.map +1 -0
- package/dist/server/configStore.d.ts +59 -0
- package/dist/server/configStore.js +73 -0
- package/dist/server/configStore.js.map +1 -0
- package/dist/server/index.d.ts +17 -0
- package/dist/server/index.js +120 -0
- package/dist/server/index.js.map +1 -0
- package/dist/server/playbookHandler.d.ts +3 -0
- package/dist/server/playbookHandler.js +44 -0
- package/dist/server/playbookHandler.js.map +1 -0
- package/dist/server/routes/config.d.ts +1 -0
- package/dist/server/routes/config.js +184 -0
- package/dist/server/routes/config.js.map +1 -0
- package/dist/server/routes/data.d.ts +1 -0
- package/dist/server/routes/data.js +29 -0
- package/dist/server/routes/data.js.map +1 -0
- package/dist/server/routes/files.d.ts +1 -0
- package/dist/server/routes/files.js +20 -0
- package/dist/server/routes/files.js.map +1 -0
- package/dist/server/routes/git.d.ts +1 -0
- package/dist/server/routes/git.js +29 -0
- package/dist/server/routes/git.js.map +1 -0
- package/dist/server/routes/projects.d.ts +3 -0
- package/dist/server/routes/projects.js +178 -0
- package/dist/server/routes/projects.js.map +1 -0
- package/dist/server/routes/remediation.d.ts +1 -0
- package/dist/server/routes/remediation.js +99 -0
- package/dist/server/routes/remediation.js.map +1 -0
- package/dist/server/routes/sessions.d.ts +1 -0
- package/dist/server/routes/sessions.js +46 -0
- package/dist/server/routes/sessions.js.map +1 -0
- package/dist/server/routes/skills.d.ts +1 -0
- package/dist/server/routes/skills.js +48 -0
- package/dist/server/routes/skills.js.map +1 -0
- package/dist/server/routes/tools.d.ts +1 -0
- package/dist/server/routes/tools.js +12 -0
- package/dist/server/routes/tools.js.map +1 -0
- package/dist/server/security.d.ts +7 -0
- package/dist/server/security.js +128 -0
- package/dist/server/security.js.map +1 -0
- package/dist/server/wsHandler.d.ts +2 -0
- package/dist/server/wsHandler.js +212 -0
- package/dist/server/wsHandler.js.map +1 -0
- package/dist/sessions/journal.d.ts +65 -0
- package/dist/sessions/journal.js +98 -0
- package/dist/sessions/journal.js.map +1 -0
- package/dist/sessions/markdown.d.ts +8 -0
- package/dist/sessions/markdown.js +69 -0
- package/dist/sessions/markdown.js.map +1 -0
- package/dist/sessions/store.d.ts +26 -0
- package/dist/sessions/store.js +136 -0
- package/dist/sessions/store.js.map +1 -0
- package/dist/skills/store.d.ts +24 -0
- package/dist/skills/store.js +215 -0
- package/dist/skills/store.js.map +1 -0
- package/dist/tools/deleteFile.d.ts +8 -0
- package/dist/tools/deleteFile.js +37 -0
- package/dist/tools/deleteFile.js.map +1 -0
- package/dist/tools/editFile.d.ts +10 -0
- package/dist/tools/editFile.js +66 -0
- package/dist/tools/editFile.js.map +1 -0
- package/dist/tools/gitDiff.d.ts +10 -0
- package/dist/tools/gitDiff.js +59 -0
- package/dist/tools/gitDiff.js.map +1 -0
- package/dist/tools/gitStatus.d.ts +5 -0
- package/dist/tools/gitStatus.js +45 -0
- package/dist/tools/gitStatus.js.map +1 -0
- package/dist/tools/listFiles.d.ts +9 -0
- package/dist/tools/listFiles.js +36 -0
- package/dist/tools/listFiles.js.map +1 -0
- package/dist/tools/listRemediationCases.d.ts +8 -0
- package/dist/tools/listRemediationCases.js +23 -0
- package/dist/tools/listRemediationCases.js.map +1 -0
- package/dist/tools/listSkills.d.ts +6 -0
- package/dist/tools/listSkills.js +21 -0
- package/dist/tools/listSkills.js.map +1 -0
- package/dist/tools/memoryDelete.d.ts +8 -0
- package/dist/tools/memoryDelete.js +24 -0
- package/dist/tools/memoryDelete.js.map +1 -0
- package/dist/tools/memoryImport.d.ts +18 -0
- package/dist/tools/memoryImport.js +64 -0
- package/dist/tools/memoryImport.js.map +1 -0
- package/dist/tools/memorySearch.d.ts +13 -0
- package/dist/tools/memorySearch.js +40 -0
- package/dist/tools/memorySearch.js.map +1 -0
- package/dist/tools/memoryUpdate.d.ts +19 -0
- package/dist/tools/memoryUpdate.js +38 -0
- package/dist/tools/memoryUpdate.js.map +1 -0
- package/dist/tools/memoryWrite.d.ts +22 -0
- package/dist/tools/memoryWrite.js +36 -0
- package/dist/tools/memoryWrite.js.map +1 -0
- package/dist/tools/prepareRemediationWorktree.d.ts +8 -0
- package/dist/tools/prepareRemediationWorktree.js +48 -0
- package/dist/tools/prepareRemediationWorktree.js.map +1 -0
- package/dist/tools/projectScripts.d.ts +11 -0
- package/dist/tools/projectScripts.js +64 -0
- package/dist/tools/projectScripts.js.map +1 -0
- package/dist/tools/readFile.d.ts +10 -0
- package/dist/tools/readFile.js +57 -0
- package/dist/tools/readFile.js.map +1 -0
- package/dist/tools/readSkill.d.ts +8 -0
- package/dist/tools/readSkill.js +25 -0
- package/dist/tools/readSkill.js.map +1 -0
- package/dist/tools/registry.d.ts +15 -0
- package/dist/tools/registry.js +121 -0
- package/dist/tools/registry.js.map +1 -0
- package/dist/tools/runCheck.d.ts +17 -0
- package/dist/tools/runCheck.js +125 -0
- package/dist/tools/runCheck.js.map +1 -0
- package/dist/tools/runSecurityScan.d.ts +8 -0
- package/dist/tools/runSecurityScan.js +36 -0
- package/dist/tools/runSecurityScan.js.map +1 -0
- package/dist/tools/searchText.d.ts +11 -0
- package/dist/tools/searchText.js +67 -0
- package/dist/tools/searchText.js.map +1 -0
- package/dist/tools/shell.d.ts +16 -0
- package/dist/tools/shell.js +114 -0
- package/dist/tools/shell.js.map +1 -0
- package/dist/tools/types.d.ts +57 -0
- package/dist/tools/types.js +2 -0
- package/dist/tools/types.js.map +1 -0
- package/dist/tools/writeFile.d.ts +9 -0
- package/dist/tools/writeFile.js +89 -0
- package/dist/tools/writeFile.js.map +1 -0
- package/dist/tui/app.d.ts +8 -0
- package/dist/tui/app.js +178 -0
- package/dist/tui/app.js.map +1 -0
- package/dist/tui/presets.d.ts +13 -0
- package/dist/tui/presets.js +11 -0
- package/dist/tui/presets.js.map +1 -0
- package/dist/tui/render.d.ts +14 -0
- package/dist/tui/render.js +83 -0
- package/dist/tui/render.js.map +1 -0
- package/dist/ui/output.d.ts +4 -0
- package/dist/ui/output.js +21 -0
- package/dist/ui/output.js.map +1 -0
- package/package.json +77 -0
|
@@ -0,0 +1,262 @@
|
|
|
1
|
+
import { TurnState, DEFAULT_TURN_CONFIG } from './types.js';
|
|
2
|
+
import { AgentRunner } from './runner.js';
|
|
3
|
+
import { estimateTokens } from './compact.js';
|
|
4
|
+
import { AuditSink, newRunId, resolveGitHead } from '../audit/log.js';
|
|
5
|
+
import { minimizedDescriptor } from '../audit/minimize.js';
|
|
6
|
+
import { policyHash } from '../core/policy.js';
|
|
7
|
+
export class AgentLoop {
|
|
8
|
+
provider;
|
|
9
|
+
registry;
|
|
10
|
+
context;
|
|
11
|
+
systemPrompt;
|
|
12
|
+
config;
|
|
13
|
+
slashCommands;
|
|
14
|
+
sharedUndoStack = [];
|
|
15
|
+
auditOptions;
|
|
16
|
+
constructor(options) {
|
|
17
|
+
this.provider = options.provider;
|
|
18
|
+
this.registry = options.registry;
|
|
19
|
+
this.context = options.context;
|
|
20
|
+
this.systemPrompt = options.systemPrompt;
|
|
21
|
+
this.config = { ...DEFAULT_TURN_CONFIG, ...options.config };
|
|
22
|
+
this.auditOptions = options.audit ?? {};
|
|
23
|
+
this.slashCommands = new Map();
|
|
24
|
+
const cmds = options.slashCommands ?? [];
|
|
25
|
+
for (const cmd of cmds) {
|
|
26
|
+
this.slashCommands.set(cmd.name, cmd);
|
|
27
|
+
}
|
|
28
|
+
// Register built-in commands
|
|
29
|
+
this.slashCommands.set('compact', {
|
|
30
|
+
name: 'compact',
|
|
31
|
+
description: 'Compress conversation context using LLM summarization',
|
|
32
|
+
handler: async (_args, messages) => this.handleCompact(messages),
|
|
33
|
+
});
|
|
34
|
+
this.slashCommands.set('undo', {
|
|
35
|
+
name: 'undo',
|
|
36
|
+
description: 'Undo the last N tool calls (default: 1)',
|
|
37
|
+
handler: async (args, messages) => {
|
|
38
|
+
const count = parseInt(args.trim(), 10);
|
|
39
|
+
const n = Number.isFinite(count) && count > 0 ? count : 1;
|
|
40
|
+
const runner = new AgentRunner({
|
|
41
|
+
provider: this.provider,
|
|
42
|
+
registry: this.registry,
|
|
43
|
+
context: this.context,
|
|
44
|
+
config: this.config,
|
|
45
|
+
systemPrompt: this.systemPrompt,
|
|
46
|
+
sharedUndoStack: this.sharedUndoStack,
|
|
47
|
+
});
|
|
48
|
+
const undoOutput = await runner.undoLast(n);
|
|
49
|
+
return { messages, output: undoOutput };
|
|
50
|
+
},
|
|
51
|
+
});
|
|
52
|
+
this.slashCommands.set('help', {
|
|
53
|
+
name: 'help',
|
|
54
|
+
description: 'List available slash commands',
|
|
55
|
+
handler: (_args, messages) => ({
|
|
56
|
+
messages,
|
|
57
|
+
output: [
|
|
58
|
+
'**Available slash commands:**',
|
|
59
|
+
'',
|
|
60
|
+
'| Command | Description |',
|
|
61
|
+
'|---------|-------------|',
|
|
62
|
+
'| `/clear` | Clear conversation (client-side) |',
|
|
63
|
+
'| `/compact` | Compress context to save tokens |',
|
|
64
|
+
'| `/undo [N]` | Undo the last N tool calls (default: 1) |',
|
|
65
|
+
'| `/git` | Show git branch, commits, changed files |',
|
|
66
|
+
'| `/plan` | Plan the task before executing |',
|
|
67
|
+
'| `/help` | Show this help |',
|
|
68
|
+
].join('\n'),
|
|
69
|
+
}),
|
|
70
|
+
});
|
|
71
|
+
this.slashCommands.set('git', {
|
|
72
|
+
name: 'git',
|
|
73
|
+
description: 'Show git status',
|
|
74
|
+
handler: (_args, messages) => ({
|
|
75
|
+
messages: [...messages, { role: 'user', content: 'Run git_status to show the current git branch, recent commits, and changed files.' }],
|
|
76
|
+
}),
|
|
77
|
+
});
|
|
78
|
+
this.slashCommands.set('plan', {
|
|
79
|
+
name: 'plan',
|
|
80
|
+
description: 'Plan before executing',
|
|
81
|
+
handler: (args, messages) => ({
|
|
82
|
+
messages: [...messages, {
|
|
83
|
+
role: 'user',
|
|
84
|
+
content: `Create a detailed step-by-step plan for the following task. List each step clearly with a numbered list. Do NOT execute any steps yet — only plan.\n\nTask: ${args || '(describe the task)'}`,
|
|
85
|
+
}],
|
|
86
|
+
}),
|
|
87
|
+
});
|
|
88
|
+
}
|
|
89
|
+
/** Process a user message through the full state machine */
|
|
90
|
+
async processMessage(userMessage, history, onEvent, signal) {
|
|
91
|
+
let messages = [...history];
|
|
92
|
+
let state = TurnState.RESTORE;
|
|
93
|
+
// Pre-allocated output
|
|
94
|
+
let output = '';
|
|
95
|
+
let iterationsUsed = 0;
|
|
96
|
+
let usage;
|
|
97
|
+
let runId;
|
|
98
|
+
let auditHead;
|
|
99
|
+
while (state !== TurnState.DONE) {
|
|
100
|
+
switch (state) {
|
|
101
|
+
case TurnState.RESTORE: {
|
|
102
|
+
// Auto-compact: if the running history already exceeds the configured
|
|
103
|
+
// fraction of the context window, summarize it before building the
|
|
104
|
+
// next turn. Wires up `contextTokenLimit` / `compactThreshold`, which
|
|
105
|
+
// were defined but previously never consulted by the state machine.
|
|
106
|
+
const triggerTokens = this.config.contextTokenLimit * this.config.compactThreshold;
|
|
107
|
+
if (estimateTokens(messages) > triggerTokens) {
|
|
108
|
+
state = TurnState.COMPACT;
|
|
109
|
+
}
|
|
110
|
+
else {
|
|
111
|
+
state = TurnState.BUILD;
|
|
112
|
+
}
|
|
113
|
+
break;
|
|
114
|
+
}
|
|
115
|
+
case TurnState.COMPACT: {
|
|
116
|
+
const compacted = await this.handleCompact(messages);
|
|
117
|
+
messages = compacted.messages;
|
|
118
|
+
state = TurnState.BUILD;
|
|
119
|
+
break;
|
|
120
|
+
}
|
|
121
|
+
case TurnState.COMMAND: {
|
|
122
|
+
// Check if user message starts with /
|
|
123
|
+
if (userMessage.startsWith('/')) {
|
|
124
|
+
const spaceIdx = userMessage.indexOf(' ');
|
|
125
|
+
const cmdName = spaceIdx === -1 ? userMessage.slice(1) : userMessage.slice(1, spaceIdx);
|
|
126
|
+
const args = spaceIdx === -1 ? '' : userMessage.slice(spaceIdx + 1);
|
|
127
|
+
const cmd = this.slashCommands.get(cmdName);
|
|
128
|
+
if (cmd) {
|
|
129
|
+
const result = await Promise.resolve(cmd.handler(args, messages));
|
|
130
|
+
messages = result.messages;
|
|
131
|
+
if (result.output)
|
|
132
|
+
output = result.output;
|
|
133
|
+
state = TurnState.DONE;
|
|
134
|
+
break;
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
state = TurnState.RUN;
|
|
138
|
+
break;
|
|
139
|
+
}
|
|
140
|
+
case TurnState.BUILD: {
|
|
141
|
+
state = TurnState.COMMAND;
|
|
142
|
+
break;
|
|
143
|
+
}
|
|
144
|
+
case TurnState.RUN: {
|
|
145
|
+
// Open a per-run audit sink (one file per user turn) unless disabled.
|
|
146
|
+
let sink;
|
|
147
|
+
let runContext = this.context;
|
|
148
|
+
if (this.auditOptions.enabled !== false) {
|
|
149
|
+
runId = newRunId();
|
|
150
|
+
sink = new AuditSink(runId, this.auditOptions.dir);
|
|
151
|
+
sink.append({
|
|
152
|
+
type: 'run_start',
|
|
153
|
+
task: minimizedDescriptor(userMessage),
|
|
154
|
+
mode: this.context.approvalMode,
|
|
155
|
+
provider: this.provider.name,
|
|
156
|
+
model: this.auditOptions.model ?? 'unknown',
|
|
157
|
+
cwd: this.context.cwd,
|
|
158
|
+
gitHead: await resolveGitHead(this.context.cwd),
|
|
159
|
+
sessionId: this.auditOptions.sessionId,
|
|
160
|
+
policyHash: this.auditOptions.policy?.hash ?? policyHash(this.context.policy),
|
|
161
|
+
policySources: this.auditOptions.policy?.sources,
|
|
162
|
+
});
|
|
163
|
+
runContext = { ...this.context, audit: sink };
|
|
164
|
+
}
|
|
165
|
+
const runner = new AgentRunner({
|
|
166
|
+
provider: this.provider,
|
|
167
|
+
registry: this.registry,
|
|
168
|
+
context: runContext,
|
|
169
|
+
config: this.config,
|
|
170
|
+
systemPrompt: this.systemPrompt,
|
|
171
|
+
sharedUndoStack: this.sharedUndoStack,
|
|
172
|
+
});
|
|
173
|
+
try {
|
|
174
|
+
const result = await runner.runTurn(userMessage, messages, onEvent, signal);
|
|
175
|
+
messages = result.messages;
|
|
176
|
+
output = result.finalResponse;
|
|
177
|
+
iterationsUsed = result.iterationsUsed;
|
|
178
|
+
usage = result.usage;
|
|
179
|
+
this.finishRun(sink, 'done', iterationsUsed, usage);
|
|
180
|
+
auditHead = sink?.head();
|
|
181
|
+
}
|
|
182
|
+
catch (err) {
|
|
183
|
+
const status = err instanceof Error && err.message === 'interrupted' ? 'interrupted' : 'error';
|
|
184
|
+
this.finishRun(sink, status, iterationsUsed, usage);
|
|
185
|
+
throw err;
|
|
186
|
+
}
|
|
187
|
+
state = TurnState.SAVE;
|
|
188
|
+
break;
|
|
189
|
+
}
|
|
190
|
+
case TurnState.SAVE: {
|
|
191
|
+
state = TurnState.RESPOND;
|
|
192
|
+
break;
|
|
193
|
+
}
|
|
194
|
+
case TurnState.RESPOND: {
|
|
195
|
+
state = TurnState.DONE;
|
|
196
|
+
break;
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
return { messages, output, iterationsUsed, usage, runId, auditHead };
|
|
201
|
+
}
|
|
202
|
+
/** Emit the terminal run_end event, folding in any best-effort write warnings. */
|
|
203
|
+
finishRun(sink, status, iterations, usage) {
|
|
204
|
+
if (!sink)
|
|
205
|
+
return;
|
|
206
|
+
const warnings = sink.getWarnings();
|
|
207
|
+
sink.append({
|
|
208
|
+
type: 'run_end',
|
|
209
|
+
status,
|
|
210
|
+
iterations,
|
|
211
|
+
inputTokens: usage?.inputTokens,
|
|
212
|
+
outputTokens: usage?.outputTokens,
|
|
213
|
+
warnings: warnings.length > 0 ? warnings : undefined,
|
|
214
|
+
});
|
|
215
|
+
}
|
|
216
|
+
async handleCompact(messages) {
|
|
217
|
+
if (messages.length <= 10) {
|
|
218
|
+
return { messages, output: 'Context is already small enough.' };
|
|
219
|
+
}
|
|
220
|
+
const conversationText = messages
|
|
221
|
+
.filter(m => m.role !== 'system')
|
|
222
|
+
.map(m => `[${m.role}]: ${m.content}`)
|
|
223
|
+
.join('\n\n');
|
|
224
|
+
try {
|
|
225
|
+
const summaryResponse = await this.provider.chat({
|
|
226
|
+
system: 'You are a session summarizer for an AI coding assistant. Be concise.',
|
|
227
|
+
messages: [
|
|
228
|
+
{
|
|
229
|
+
role: 'user',
|
|
230
|
+
content: `Summarize this conversation into a structured summary with these sections:\n1. Goal\n2. Completed\n3. Decisions\n4. CurrentState\n5. Pending\n\nConversation:\n${conversationText}`,
|
|
231
|
+
},
|
|
232
|
+
],
|
|
233
|
+
runtime: {
|
|
234
|
+
policy: this.context.policy,
|
|
235
|
+
audit: this.context.audit,
|
|
236
|
+
model: this.auditOptions.model,
|
|
237
|
+
},
|
|
238
|
+
});
|
|
239
|
+
const systemMsg = messages.find(m => m.role === 'system');
|
|
240
|
+
const summaryMsg = {
|
|
241
|
+
role: 'assistant',
|
|
242
|
+
content: `[Conversation summary]\n${summaryResponse.content}`,
|
|
243
|
+
};
|
|
244
|
+
const kept = systemMsg ? [systemMsg, summaryMsg] : [summaryMsg];
|
|
245
|
+
return {
|
|
246
|
+
messages: kept,
|
|
247
|
+
output: `Compacted: reduced from ${messages.length} to ${kept.length} messages using LLM summarization.`,
|
|
248
|
+
};
|
|
249
|
+
}
|
|
250
|
+
catch {
|
|
251
|
+
// Fallback: keep last 20 messages
|
|
252
|
+
const systemMsg = messages.find(m => m.role === 'system');
|
|
253
|
+
const recentMessages = messages.filter(m => m.role !== 'system').slice(-20);
|
|
254
|
+
const kept = systemMsg ? [systemMsg, ...recentMessages] : recentMessages;
|
|
255
|
+
return {
|
|
256
|
+
messages: kept,
|
|
257
|
+
output: `Compacted (fallback): reduced from ${messages.length} to ${kept.length} messages.`,
|
|
258
|
+
};
|
|
259
|
+
}
|
|
260
|
+
}
|
|
261
|
+
}
|
|
262
|
+
//# sourceMappingURL=loop.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../src/agent/loop.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { ApprovalMode } from '../core/context.js';
|
|
2
|
+
/** Top-level agent mode (mirrors the GUI's Chat / Cowork / Code switch). */
|
|
3
|
+
export type AgentMode = 'chat' | 'cowork' | 'code';
|
|
4
|
+
/** Fine-grained permission within Code mode. */
|
|
5
|
+
export type CodePermissionMode = 'ask' | 'plan' | 'auto' | 'bypass';
|
|
6
|
+
/** Tools allowed per mode; `null` means all registered tools. */
|
|
7
|
+
export declare const MODE_TOOLS: Record<AgentMode, string[] | null>;
|
|
8
|
+
export declare const MODE_APPROVAL: Record<AgentMode, ApprovalMode>;
|
|
9
|
+
export declare const CODE_PERMISSION_APPROVAL: Record<CodePermissionMode, ApprovalMode>;
|
|
10
|
+
export declare const MODE_PROMPT: Record<AgentMode, string>;
|
|
11
|
+
export declare const CODE_PERMISSION_PROMPT: Record<CodePermissionMode, string>;
|
|
12
|
+
/** Resolve the effective approval mode for a (mode, codePermissionMode) pair. */
|
|
13
|
+
export declare function resolveApprovalMode(mode: AgentMode, codePermissionMode: CodePermissionMode): ApprovalMode;
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/** Tools allowed per mode; `null` means all registered tools. */
|
|
2
|
+
export const MODE_TOOLS = {
|
|
3
|
+
chat: [
|
|
4
|
+
'read_file',
|
|
5
|
+
'list_files',
|
|
6
|
+
'search_text',
|
|
7
|
+
'git_status',
|
|
8
|
+
'git_diff',
|
|
9
|
+
'project_scripts',
|
|
10
|
+
'memory_search',
|
|
11
|
+
'list_skills',
|
|
12
|
+
'read_skill',
|
|
13
|
+
'list_remediation_cases',
|
|
14
|
+
],
|
|
15
|
+
cowork: null,
|
|
16
|
+
code: null,
|
|
17
|
+
};
|
|
18
|
+
export const MODE_APPROVAL = {
|
|
19
|
+
chat: 'readonly',
|
|
20
|
+
cowork: 'auto-edit',
|
|
21
|
+
code: 'full-auto',
|
|
22
|
+
};
|
|
23
|
+
export const CODE_PERMISSION_APPROVAL = {
|
|
24
|
+
ask: 'auto-edit',
|
|
25
|
+
plan: 'readonly',
|
|
26
|
+
auto: 'full-auto',
|
|
27
|
+
bypass: 'bypass',
|
|
28
|
+
};
|
|
29
|
+
export const MODE_PROMPT = {
|
|
30
|
+
chat: 'You are in Chat mode. Answer questions, explain code, and discuss ideas. Do NOT write, edit, delete files or run shell commands — read-only tools only.',
|
|
31
|
+
cowork: 'You are in Cowork mode. Work collaboratively. Briefly explain your plan before making changes. Prefer focused, surgical edits. File writes and shell commands require user approval.',
|
|
32
|
+
code: 'You are in Code mode. Work autonomously to complete the task efficiently. Use all available tools as needed. For git fetch/pull/push/clone or package downloads that need outbound network access, use shell with networkAccess="unrestricted" so the user can approve running outside the local subprocess network sandbox when required.',
|
|
33
|
+
};
|
|
34
|
+
export const CODE_PERMISSION_PROMPT = {
|
|
35
|
+
ask: 'Code permission mode: Ask Permissions. Request approval before edits, deletes, or shell commands.',
|
|
36
|
+
plan: 'Code permission mode: Plan Mode. Create a clear plan only. Do not write files, delete files, or run shell commands.',
|
|
37
|
+
auto: 'Code permission mode: Auto Mode. Complete the task autonomously with normal tool access.',
|
|
38
|
+
bypass: 'Code permission mode: Bypass Permissions. Complete the task without approval prompts. When policy permits, shell commands may run with unrestricted subprocess network access instead of the local network sandbox.',
|
|
39
|
+
};
|
|
40
|
+
/** Resolve the effective approval mode for a (mode, codePermissionMode) pair. */
|
|
41
|
+
export function resolveApprovalMode(mode, codePermissionMode) {
|
|
42
|
+
return mode === 'code' ? CODE_PERMISSION_APPROVAL[codePermissionMode] : MODE_APPROVAL[mode];
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=modes.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"modes.js","sourceRoot":"","sources":["../../src/agent/modes.ts"],"names":[],"mappings":"AAQA,iEAAiE;AACjE,MAAM,CAAC,MAAM,UAAU,GAAuC;IAC5D,IAAI,EAAI;QACN,WAAW;QACX,YAAY;QACZ,aAAa;QACb,YAAY;QACZ,UAAU;QACV,iBAAiB;QACjB,eAAe;QACf,aAAa;QACb,YAAY;QACZ,wBAAwB;KACzB;IACD,MAAM,EAAE,IAAI;IACZ,IAAI,EAAI,IAAI;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAoC;IAC5D,IAAI,EAAI,UAAU;IAClB,MAAM,EAAE,WAAW;IACnB,IAAI,EAAI,WAAW;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAA6C;IAChF,GAAG,EAAK,WAAW;IACnB,IAAI,EAAI,UAAU;IAClB,IAAI,EAAI,WAAW;IACnB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,IAAI,EACF,yJAAyJ;IAC3J,MAAM,EACJ,sLAAsL;IACxL,IAAI,EACF,4UAA4U;CAC/U,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAuC;IACxE,GAAG,EAAK,mGAAmG;IAC3G,IAAI,EAAI,qHAAqH;IAC7H,IAAI,EAAI,0FAA0F;IAClG,MAAM,EAAE,qNAAqN;CAC9N,CAAC;AAEF,iFAAiF;AACjF,MAAM,UAAU,mBAAmB,CAAC,IAAe,EAAE,kBAAsC;IACzF,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;AAC9F,CAAC"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import type { ChatMessage, ProviderAdapter } from '../providers/types.js';
|
|
2
|
+
import type { ToolRegistry } from '../tools/registry.js';
|
|
3
|
+
import type { DvalinContext } from '../core/context.js';
|
|
4
|
+
import type { TurnConfig, UndoEntry, AgentEventHandler } from './types.js';
|
|
5
|
+
export type RunnerOptions = {
|
|
6
|
+
provider: ProviderAdapter;
|
|
7
|
+
registry: ToolRegistry;
|
|
8
|
+
context: DvalinContext;
|
|
9
|
+
config: TurnConfig;
|
|
10
|
+
systemPrompt: string;
|
|
11
|
+
sharedUndoStack?: UndoEntry[];
|
|
12
|
+
};
|
|
13
|
+
export declare class AgentRunner {
|
|
14
|
+
private provider;
|
|
15
|
+
private registry;
|
|
16
|
+
private context;
|
|
17
|
+
private config;
|
|
18
|
+
private systemPrompt;
|
|
19
|
+
private iterationCount;
|
|
20
|
+
/** Stack of executed tool calls for undo support */
|
|
21
|
+
private undoStack;
|
|
22
|
+
constructor(options: RunnerOptions);
|
|
23
|
+
/** Undo the last N tool calls. Returns a description of what was undone. */
|
|
24
|
+
undoLast(count?: number): Promise<string>;
|
|
25
|
+
/** Run a single turn: user message → LLM → (tool calls → LLM) → final response */
|
|
26
|
+
runTurn(userMessage: string, history: ChatMessage[], onEvent?: AgentEventHandler, signal?: AbortSignal): Promise<{
|
|
27
|
+
messages: ChatMessage[];
|
|
28
|
+
finalResponse: string;
|
|
29
|
+
iterationsUsed: number;
|
|
30
|
+
usage?: {
|
|
31
|
+
inputTokens: number;
|
|
32
|
+
outputTokens: number;
|
|
33
|
+
};
|
|
34
|
+
}>;
|
|
35
|
+
private buildToolDefs;
|
|
36
|
+
private parseToolCalls;
|
|
37
|
+
}
|
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
export class AgentRunner {
|
|
2
|
+
provider;
|
|
3
|
+
registry;
|
|
4
|
+
context;
|
|
5
|
+
config;
|
|
6
|
+
systemPrompt;
|
|
7
|
+
iterationCount = 0;
|
|
8
|
+
/** Stack of executed tool calls for undo support */
|
|
9
|
+
undoStack;
|
|
10
|
+
constructor(options) {
|
|
11
|
+
this.provider = options.provider;
|
|
12
|
+
this.registry = options.registry;
|
|
13
|
+
this.context = options.context;
|
|
14
|
+
this.config = options.config;
|
|
15
|
+
this.systemPrompt = options.systemPrompt;
|
|
16
|
+
this.undoStack = options.sharedUndoStack ?? [];
|
|
17
|
+
}
|
|
18
|
+
/** Undo the last N tool calls. Returns a description of what was undone. */
|
|
19
|
+
async undoLast(count = 1) {
|
|
20
|
+
if (this.undoStack.length === 0) {
|
|
21
|
+
return 'Nothing to undo.';
|
|
22
|
+
}
|
|
23
|
+
const entries = this.undoStack.splice(-count);
|
|
24
|
+
const descriptions = [];
|
|
25
|
+
for (const entry of entries) {
|
|
26
|
+
const tool = this.registry.get(entry.toolName);
|
|
27
|
+
if (!tool || !tool.isUndoable) {
|
|
28
|
+
descriptions.push(`Cannot undo ${entry.toolName}: undo not supported.`);
|
|
29
|
+
continue;
|
|
30
|
+
}
|
|
31
|
+
const reverseOp = tool.reverse?.(entry.input, entry.result);
|
|
32
|
+
if (!reverseOp) {
|
|
33
|
+
descriptions.push(`Cannot undo ${entry.toolName}: reverse operation not available (file may have existed before).`);
|
|
34
|
+
continue;
|
|
35
|
+
}
|
|
36
|
+
try {
|
|
37
|
+
const reverseTool = this.registry.get(reverseOp.toolName);
|
|
38
|
+
if (!reverseTool) {
|
|
39
|
+
descriptions.push(`Cannot undo ${entry.toolName}: reverse tool "${reverseOp.toolName}" not found.`);
|
|
40
|
+
continue;
|
|
41
|
+
}
|
|
42
|
+
await reverseTool.run(reverseOp.input, this.context);
|
|
43
|
+
descriptions.push(`✅ ${reverseOp.description}`);
|
|
44
|
+
}
|
|
45
|
+
catch (err) {
|
|
46
|
+
descriptions.push(`❌ Undo failed for ${entry.toolName}: ${err instanceof Error ? err.message : String(err)}`);
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
return descriptions.join('\n');
|
|
50
|
+
}
|
|
51
|
+
/** Run a single turn: user message → LLM → (tool calls → LLM) → final response */
|
|
52
|
+
async runTurn(userMessage, history, onEvent, signal) {
|
|
53
|
+
const messages = [...history, { role: 'user', content: userMessage }];
|
|
54
|
+
this.iterationCount = 0;
|
|
55
|
+
let totalUsage;
|
|
56
|
+
while (this.iterationCount < this.config.maxIterations) {
|
|
57
|
+
if (signal?.aborted)
|
|
58
|
+
throw new Error('interrupted');
|
|
59
|
+
this.iterationCount++;
|
|
60
|
+
// Build tool definitions from registry
|
|
61
|
+
const toolDefs = this.buildToolDefs();
|
|
62
|
+
// Call LLM (streaming if onEvent is provided)
|
|
63
|
+
const response = await this.provider.chat({
|
|
64
|
+
system: this.systemPrompt,
|
|
65
|
+
messages,
|
|
66
|
+
tools: toolDefs.length > 0 ? toolDefs : undefined,
|
|
67
|
+
signal,
|
|
68
|
+
onDelta: onEvent ? (delta) => onEvent({ type: 'token_delta', content: delta }) : undefined,
|
|
69
|
+
runtime: {
|
|
70
|
+
policy: this.context.policy,
|
|
71
|
+
audit: this.context.audit,
|
|
72
|
+
},
|
|
73
|
+
});
|
|
74
|
+
// Accumulate token usage across all iterations
|
|
75
|
+
if (response.usage) {
|
|
76
|
+
if (!totalUsage)
|
|
77
|
+
totalUsage = { inputTokens: 0, outputTokens: 0 };
|
|
78
|
+
totalUsage.inputTokens += response.usage.inputTokens;
|
|
79
|
+
totalUsage.outputTokens += response.usage.outputTokens;
|
|
80
|
+
}
|
|
81
|
+
// Add assistant message — include tool_calls if present (required by OpenAI-compatible APIs)
|
|
82
|
+
const assistantMsg = {
|
|
83
|
+
role: 'assistant',
|
|
84
|
+
content: response.content,
|
|
85
|
+
tool_calls: response.toolCalls && response.toolCalls.length > 0 ? response.toolCalls : undefined,
|
|
86
|
+
};
|
|
87
|
+
messages.push(assistantMsg);
|
|
88
|
+
// Check for tool calls — prefer native API response, fallback to @tool() text parsing
|
|
89
|
+
let toolCalls = [];
|
|
90
|
+
if (response.toolCalls && response.toolCalls.length > 0) {
|
|
91
|
+
toolCalls = response.toolCalls;
|
|
92
|
+
}
|
|
93
|
+
else {
|
|
94
|
+
toolCalls = this.parseToolCalls(response.content);
|
|
95
|
+
}
|
|
96
|
+
if (toolCalls.length === 0) {
|
|
97
|
+
// No tool calls — this is the final response
|
|
98
|
+
return { messages, finalResponse: response.content, iterationsUsed: this.iterationCount, usage: totalUsage };
|
|
99
|
+
}
|
|
100
|
+
// Cap tool calls per turn
|
|
101
|
+
const callsToExecute = toolCalls.slice(0, this.config.maxToolCallsPerTurn);
|
|
102
|
+
// Execute tool calls
|
|
103
|
+
for (const tc of callsToExecute) {
|
|
104
|
+
try {
|
|
105
|
+
const parsedInput = JSON.parse(tc.arguments);
|
|
106
|
+
onEvent?.({ type: 'tool_call', name: tc.name, id: tc.id, input: parsedInput });
|
|
107
|
+
const result = await this.registry.run(tc.name, parsedInput, this.context);
|
|
108
|
+
// Record undo entry for this tool call
|
|
109
|
+
this.undoStack.push({
|
|
110
|
+
toolName: tc.name,
|
|
111
|
+
input: parsedInput,
|
|
112
|
+
result: {
|
|
113
|
+
title: result.title,
|
|
114
|
+
output: result.output,
|
|
115
|
+
metadata: result.metadata,
|
|
116
|
+
},
|
|
117
|
+
reverseInput: null,
|
|
118
|
+
timestamp: new Date().toISOString(),
|
|
119
|
+
});
|
|
120
|
+
onEvent?.({ type: 'tool_result', name: tc.name, id: tc.id, output: result.output, metadata: result.metadata });
|
|
121
|
+
messages.push({
|
|
122
|
+
role: 'tool',
|
|
123
|
+
content: `[Tool ${tc.name} result]:\n${result.output}`,
|
|
124
|
+
tool_call_id: tc.id,
|
|
125
|
+
name: tc.name,
|
|
126
|
+
});
|
|
127
|
+
}
|
|
128
|
+
catch (err) {
|
|
129
|
+
const error = err instanceof Error ? err.message : String(err);
|
|
130
|
+
onEvent?.({ type: 'tool_error', name: tc.name, id: tc.id, error });
|
|
131
|
+
messages.push({
|
|
132
|
+
role: 'tool',
|
|
133
|
+
content: `[Tool ${tc.name} error]: ${error}`,
|
|
134
|
+
tool_call_id: tc.id,
|
|
135
|
+
name: tc.name,
|
|
136
|
+
});
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
// Max iterations reached
|
|
141
|
+
const lastMsg = messages.filter(m => m.role === 'assistant').pop();
|
|
142
|
+
return {
|
|
143
|
+
messages,
|
|
144
|
+
finalResponse: lastMsg?.content ?? 'Max iterations reached without final response.',
|
|
145
|
+
iterationsUsed: this.iterationCount,
|
|
146
|
+
usage: totalUsage,
|
|
147
|
+
};
|
|
148
|
+
}
|
|
149
|
+
buildToolDefs() {
|
|
150
|
+
return this.registry.list().map(tool => ({
|
|
151
|
+
name: tool.name,
|
|
152
|
+
description: tool.description,
|
|
153
|
+
parameters: tool.parametersSchema ?? tool.inputSchema.toJSONSchema?.() ?? {},
|
|
154
|
+
}));
|
|
155
|
+
}
|
|
156
|
+
parseToolCalls(content) {
|
|
157
|
+
const calls = [];
|
|
158
|
+
// Pattern: @tool(name, {...arguments})
|
|
159
|
+
const regex = /@tool\s*\(\s*["']([^"']+)["']\s*,\s*({[^}]+})\s*\)/g;
|
|
160
|
+
let match;
|
|
161
|
+
while ((match = regex.exec(content)) !== null) {
|
|
162
|
+
calls.push({
|
|
163
|
+
id: `tc_${calls.length}`,
|
|
164
|
+
name: match[1],
|
|
165
|
+
arguments: match[2],
|
|
166
|
+
});
|
|
167
|
+
}
|
|
168
|
+
return calls;
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
//# sourceMappingURL=runner.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/agent/runner.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import type { AgentEventHandler, LoopResult } from './types.js';
|
|
2
|
+
import { type AgentMode, type CodePermissionMode } from './modes.js';
|
|
3
|
+
import type { ProviderAdapter } from '../providers/types.js';
|
|
4
|
+
import { type McpConnectionSummary } from '../mcp/register.js';
|
|
5
|
+
export type ResolvedProvider = {
|
|
6
|
+
provider: ProviderAdapter;
|
|
7
|
+
providerId: string;
|
|
8
|
+
model: string;
|
|
9
|
+
};
|
|
10
|
+
/**
|
|
11
|
+
* Resolve the active provider from saved config: a provider pool takes priority
|
|
12
|
+
* when enabled, otherwise the single `llm` config (optionally overridden by name).
|
|
13
|
+
*/
|
|
14
|
+
export declare function resolveProvider(override?: string): Promise<ResolvedProvider>;
|
|
15
|
+
export type RunTurnInput = {
|
|
16
|
+
/** The user's message (may contain @file references). */
|
|
17
|
+
content: string;
|
|
18
|
+
/** Resume an existing session; omit to start a new one. */
|
|
19
|
+
sessionId?: string;
|
|
20
|
+
/** Workspace root — caller is responsible for validating it is allowed. */
|
|
21
|
+
cwd: string;
|
|
22
|
+
mode: AgentMode;
|
|
23
|
+
/** Only meaningful in Code mode (default: `auto`). */
|
|
24
|
+
codePermissionMode?: CodePermissionMode;
|
|
25
|
+
/** Override the configured provider by name. */
|
|
26
|
+
providerOverride?: string;
|
|
27
|
+
/**
|
|
28
|
+
* Stable id for this logical message. Reusing an id whose turn already
|
|
29
|
+
* completed replays the prior result instead of re-running the model
|
|
30
|
+
* (idempotency). Omit to always run a fresh turn.
|
|
31
|
+
*/
|
|
32
|
+
messageId?: string;
|
|
33
|
+
signal?: AbortSignal;
|
|
34
|
+
};
|
|
35
|
+
/** A turn that crashed before completing, surfaced on the next resume with its input intact. */
|
|
36
|
+
export type RecoveredTurn = {
|
|
37
|
+
messageId: string;
|
|
38
|
+
content: string;
|
|
39
|
+
};
|
|
40
|
+
export type RunTurnHooks = {
|
|
41
|
+
/** Fired once the session id is known (before the LLM runs). */
|
|
42
|
+
onSessionId?: (sessionId: string) => void;
|
|
43
|
+
/** Fired once the provider is resolved (before the LLM runs). */
|
|
44
|
+
onProviderSelected?: (providerId: string, model: string) => void;
|
|
45
|
+
/** Streams token deltas and tool events as the turn runs. */
|
|
46
|
+
onEvent?: AgentEventHandler;
|
|
47
|
+
/** Approval gate for writes/commands in Cowork / Code-Ask mode. */
|
|
48
|
+
requestApproval?: (id: string, toolName: string, input: unknown) => Promise<boolean>;
|
|
49
|
+
};
|
|
50
|
+
export type RunTurnResult = {
|
|
51
|
+
sessionId: string;
|
|
52
|
+
result: LoopResult;
|
|
53
|
+
/** Rendered Run Report Markdown, when an audit run was produced. */
|
|
54
|
+
reportMarkdown?: string;
|
|
55
|
+
providerId: string;
|
|
56
|
+
model: string;
|
|
57
|
+
/** True when the turn was served from the journal (idempotent replay) without re-running. */
|
|
58
|
+
replayed?: boolean;
|
|
59
|
+
/** Turns that had crashed mid-execution and were closed out on this resume. */
|
|
60
|
+
recovered?: RecoveredTurn[];
|
|
61
|
+
/** Governed MCP servers connected (or denied/blocked/errored) for this turn. */
|
|
62
|
+
mcp?: McpConnectionSummary[];
|
|
63
|
+
};
|
|
64
|
+
/**
|
|
65
|
+
* Run one agent turn end-to-end, independent of transport. Both the WebSocket
|
|
66
|
+
* handler (web GUI) and the terminal UI drive this same function, passing
|
|
67
|
+
* transport-specific hooks for streaming and approval. Handles session
|
|
68
|
+
* load/save, provider resolution, prompt assembly (mode + git + AGENTS.md +
|
|
69
|
+
* @mentions), tool gating, and Run Report rendering.
|
|
70
|
+
*/
|
|
71
|
+
export declare function runAgentTurn(input: RunTurnInput, hooks?: RunTurnHooks): Promise<RunTurnResult>;
|
|
72
|
+
/** Expand @filepath references in the user's message by injecting file contents. */
|
|
73
|
+
export declare function expandAtMentions(content: string, cwd: string): Promise<string>;
|