@dirgha/code 1.7.6 → 1.7.7

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.
Files changed (66) hide show
  1. package/CHANGELOG.md +52 -5
  2. package/CREDITS.md +46 -0
  3. package/LICENSE +101 -21
  4. package/README.md +15 -9
  5. package/dist_v2/cli/config.d.ts +1 -0
  6. package/dist_v2/cli/config.js.map +1 -1
  7. package/dist_v2/cli/main.js +8 -18
  8. package/dist_v2/cli/main.js.map +1 -1
  9. package/dist_v2/cli/slash.js +0 -6
  10. package/dist_v2/cli/slash.js.map +1 -1
  11. package/dist_v2/cli/subcommands/index.js +2 -0
  12. package/dist_v2/cli/subcommands/index.js.map +1 -1
  13. package/dist_v2/cli/subcommands/web.d.ts +13 -0
  14. package/dist_v2/cli/subcommands/web.js +61 -0
  15. package/dist_v2/cli/subcommands/web.js.map +1 -0
  16. package/dist_v2/intelligence/models-dev-sync.d.ts +39 -0
  17. package/dist_v2/intelligence/models-dev-sync.js +103 -0
  18. package/dist_v2/intelligence/models-dev-sync.js.map +1 -0
  19. package/dist_v2/kernel/agent-loop.d.ts +8 -38
  20. package/dist_v2/kernel/agent-loop.js +18 -57
  21. package/dist_v2/kernel/agent-loop.js.map +1 -1
  22. package/dist_v2/kernel/index.d.ts +0 -1
  23. package/dist_v2/kernel/index.js +0 -1
  24. package/dist_v2/kernel/index.js.map +1 -1
  25. package/dist_v2/kernel/message.d.ts +1 -17
  26. package/dist_v2/kernel/message.js +0 -26
  27. package/dist_v2/kernel/message.js.map +1 -1
  28. package/dist_v2/kernel/types.d.ts +0 -29
  29. package/dist_v2/skills/install-npm.d.ts +16 -0
  30. package/dist_v2/skills/install-npm.js +97 -0
  31. package/dist_v2/skills/install-npm.js.map +1 -0
  32. package/dist_v2/tools/browser.js +6 -3
  33. package/dist_v2/tools/browser.js.map +1 -1
  34. package/dist_v2/tools/index.d.ts +1 -3
  35. package/dist_v2/tools/index.js +1 -5
  36. package/dist_v2/tools/index.js.map +1 -1
  37. package/dist_v2/tui/ink/App.d.ts +3 -0
  38. package/dist_v2/tui/ink/App.js +85 -124
  39. package/dist_v2/tui/ink/App.js.map +1 -1
  40. package/dist_v2/tui/ink/components/SlashComplete.d.ts +1 -7
  41. package/dist_v2/tui/ink/components/SlashComplete.js +2 -9
  42. package/dist_v2/tui/ink/components/SlashComplete.js.map +1 -1
  43. package/dist_v2/tui/ink/index.js +4 -0
  44. package/dist_v2/tui/ink/index.js.map +1 -1
  45. package/dist_v2/web/cost.d.ts +35 -0
  46. package/dist_v2/web/cost.js +211 -0
  47. package/dist_v2/web/cost.js.map +1 -0
  48. package/dist_v2/web/ledger.d.ts +25 -0
  49. package/dist_v2/web/ledger.js +156 -0
  50. package/dist_v2/web/ledger.js.map +1 -0
  51. package/dist_v2/web/server.d.ts +30 -0
  52. package/dist_v2/web/server.js +199 -0
  53. package/dist_v2/web/server.js.map +1 -0
  54. package/package.json +32 -52
  55. package/dist_v2/kernel/queues.d.ts +0 -82
  56. package/dist_v2/kernel/queues.js +0 -105
  57. package/dist_v2/kernel/queues.js.map +0 -1
  58. package/dist_v2/providers/faux.d.ts +0 -99
  59. package/dist_v2/providers/faux.js +0 -153
  60. package/dist_v2/providers/faux.js.map +0 -1
  61. package/dist_v2/tools/webfetch.d.ts +0 -11
  62. package/dist_v2/tools/webfetch.js +0 -130
  63. package/dist_v2/tools/webfetch.js.map +0 -1
  64. package/dist_v2/tools/websearch.d.ts +0 -14
  65. package/dist_v2/tools/websearch.js +0 -137
  66. package/dist_v2/tools/websearch.js.map +0 -1
@@ -0,0 +1,61 @@
1
+ /**
2
+ * `dirgha web` — boot the read-only localhost dashboard for audit /
3
+ * cost / ledger. Three pages, no auth, never binds 0.0.0.0.
4
+ *
5
+ * Usage:
6
+ * dirgha web Open at http://127.0.0.1:7878
7
+ * dirgha web --port=9000 Custom port
8
+ * dirgha web --json Print URL as JSON, then keep serving
9
+ *
10
+ * Stops on Ctrl+C (closes the http server cleanly before exit).
11
+ */
12
+ import { stdout, stderr } from 'node:process';
13
+ import { startWebServer } from '../../web/server.js';
14
+ import { style, defaultTheme } from '../../tui/theme.js';
15
+ // scope: S19d
16
+ function parsePort(argv) {
17
+ for (const a of argv) {
18
+ if (a.startsWith('--port=')) {
19
+ const n = Number(a.slice('--port='.length));
20
+ if (Number.isFinite(n) && n >= 0 && n < 65536)
21
+ return n;
22
+ }
23
+ }
24
+ return undefined;
25
+ }
26
+ export const webSubcommand = {
27
+ name: 'web',
28
+ description: 'Read-only localhost dashboard (audit / cost / ledger)',
29
+ async run(argv) {
30
+ const json = argv.includes('--json');
31
+ const port = parsePort(argv);
32
+ let srv;
33
+ try {
34
+ srv = await startWebServer(port !== undefined ? { port } : {});
35
+ }
36
+ catch (err) {
37
+ stderr.write(`failed to start dashboard: ${err instanceof Error ? err.message : String(err)}\n`);
38
+ return 1;
39
+ }
40
+ if (json) {
41
+ stdout.write(JSON.stringify({ url: srv.url, pages: ['/', '/cost', '/ledger'] }) + '\n');
42
+ }
43
+ else {
44
+ stdout.write(`${style(defaultTheme.success, '✓')} Dirgha Web Dashboard at ${style(defaultTheme.accent, srv.url)}\n`);
45
+ stdout.write(` Pages: ${srv.url}/ · ${srv.url}/cost · ${srv.url}/ledger\n`);
46
+ stdout.write(` Press Ctrl+C to stop.\n`);
47
+ }
48
+ return new Promise(resolve => {
49
+ const stop = async () => {
50
+ try {
51
+ await srv.close();
52
+ }
53
+ catch { /* swallow shutdown errors */ }
54
+ resolve(0);
55
+ };
56
+ process.once('SIGINT', stop);
57
+ process.once('SIGTERM', stop);
58
+ });
59
+ },
60
+ };
61
+ //# sourceMappingURL=web.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"web.js","sourceRoot":"","sources":["../../../src_v2/cli/subcommands/web.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGzD,cAAc;AAEd,SAAS,SAAS,CAAC,IAAc;IAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;YAC5C,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK;gBAAE,OAAO,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAe;IACvC,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,uDAAuD;IACpE,KAAK,CAAC,GAAG,CAAC,IAAI;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAE7B,IAAI,GAAG,CAAC;QACR,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,cAAc,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,8BAA8B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjG,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1F,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,4BAA4B,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrH,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,aAAa,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;YACjF,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,IAAI,OAAO,CAAS,OAAO,CAAC,EAAE;YACnC,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;gBACrC,IAAI,CAAC;oBACH,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;gBACpB,CAAC;gBAAC,MAAM,CAAC,CAAC,6BAA6B,CAAC,CAAC;gBACzC,OAAO,CAAC,CAAC,CAAC,CAAC;YACb,CAAC,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}
@@ -0,0 +1,39 @@
1
+ export interface ModelsDevModel {
2
+ id: string;
3
+ name: string;
4
+ contextWindow: number;
5
+ maxOutput: number;
6
+ cost: {
7
+ inputPerM: number;
8
+ outputPerM: number;
9
+ cacheReadPerM?: number;
10
+ cacheWritePerM?: number;
11
+ };
12
+ capabilities: {
13
+ tools: boolean;
14
+ reasoning: boolean;
15
+ attachments: boolean;
16
+ };
17
+ modalities: {
18
+ input: string[];
19
+ output: string[];
20
+ };
21
+ }
22
+ export interface ModelsDevProvider {
23
+ id: string;
24
+ name: string;
25
+ apiBase: string | null;
26
+ envKeys: string[];
27
+ docUrl?: string;
28
+ models: ModelsDevModel[];
29
+ }
30
+ export interface ModelsDevCatalog {
31
+ fetchedAt: string;
32
+ providerCount: number;
33
+ modelCount: number;
34
+ providers: Record<string, ModelsDevProvider>;
35
+ }
36
+ export declare function fetchModelsDev(timeoutMs?: number): Promise<ModelsDevCatalog>;
37
+ export declare function readCache(): Promise<ModelsDevCatalog | null>;
38
+ export declare function writeCache(c: ModelsDevCatalog): Promise<void>;
39
+ export declare function getCatalogue(ttlMs?: number): Promise<ModelsDevCatalog>;
@@ -0,0 +1,103 @@
1
+ /**
2
+ * Fetches and caches the models.dev catalog of AI model providers and their models.
3
+ */
4
+ import { homedir } from 'node:os';
5
+ import { join, dirname } from 'node:path';
6
+ import { readFile, writeFile, mkdir } from 'node:fs/promises';
7
+ // scope: S20
8
+ const cachePath = join(homedir(), '.dirgha', 'models-dev-cache.json');
9
+ export async function fetchModelsDev(timeoutMs) {
10
+ const controller = new AbortController();
11
+ let timer;
12
+ if (timeoutMs !== undefined) {
13
+ timer = setTimeout(() => controller.abort(), timeoutMs);
14
+ }
15
+ try {
16
+ const response = await fetch('https://models.dev/api.json', { signal: controller.signal });
17
+ if (!response.ok)
18
+ throw new Error(`HTTP ${response.status}`);
19
+ const raw = await response.json();
20
+ const providers = {};
21
+ let modelCount = 0;
22
+ for (const [provId, provRaw] of Object.entries(raw)) {
23
+ const p = provRaw;
24
+ const modelsArr = [];
25
+ const modelsObj = (p.models && typeof p.models === 'object' && !Array.isArray(p.models)) ? p.models : {};
26
+ for (const [modelId, modelRaw] of Object.entries(modelsObj)) {
27
+ const m = modelRaw;
28
+ const costRaw = m.cost || {};
29
+ const limitRaw = m.limit || {};
30
+ const modalitiesRaw = m.modalities || {};
31
+ const model = {
32
+ id: modelId,
33
+ name: m.name || modelId,
34
+ contextWindow: limitRaw.context ?? 0,
35
+ maxOutput: limitRaw.output ?? 0,
36
+ cost: {
37
+ inputPerM: costRaw.input ?? 0,
38
+ outputPerM: costRaw.output ?? 0,
39
+ ...(costRaw.cache_read !== undefined ? { cacheReadPerM: costRaw.cache_read } : {}),
40
+ ...(costRaw.cache_write !== undefined ? { cacheWritePerM: costRaw.cache_write } : {}),
41
+ },
42
+ capabilities: {
43
+ tools: m.tool_call ?? false,
44
+ reasoning: m.reasoning ?? false,
45
+ attachments: m.attachment ?? false,
46
+ },
47
+ modalities: {
48
+ input: modalitiesRaw.input || [],
49
+ output: modalitiesRaw.output || [],
50
+ },
51
+ };
52
+ modelsArr.push(model);
53
+ }
54
+ const provider = {
55
+ id: provId,
56
+ name: p.name || provId,
57
+ apiBase: p.api ?? null,
58
+ envKeys: Array.isArray(p.env) ? p.env : [],
59
+ docUrl: p.doc || undefined,
60
+ models: modelsArr,
61
+ };
62
+ providers[provId] = provider;
63
+ modelCount += modelsArr.length;
64
+ }
65
+ const catalog = {
66
+ fetchedAt: new Date().toISOString(),
67
+ providerCount: Object.keys(providers).length,
68
+ modelCount,
69
+ providers,
70
+ };
71
+ return catalog;
72
+ }
73
+ finally {
74
+ if (timer)
75
+ clearTimeout(timer);
76
+ }
77
+ }
78
+ export async function readCache() {
79
+ try {
80
+ const data = await readFile(cachePath, 'utf8');
81
+ return JSON.parse(data);
82
+ }
83
+ catch {
84
+ return null;
85
+ }
86
+ }
87
+ export async function writeCache(c) {
88
+ const dir = dirname(cachePath);
89
+ await mkdir(dir, { recursive: true });
90
+ await writeFile(cachePath, JSON.stringify(c), { mode: 0o600 });
91
+ }
92
+ export async function getCatalogue(ttlMs = 86400000) {
93
+ const cached = await readCache();
94
+ if (cached) {
95
+ const age = Date.now() - new Date(cached.fetchedAt).getTime();
96
+ if (age < ttlMs)
97
+ return cached;
98
+ }
99
+ const fresh = await fetchModelsDev();
100
+ await writeCache(fresh);
101
+ return fresh;
102
+ }
103
+ //# sourceMappingURL=models-dev-sync.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"models-dev-sync.js","sourceRoot":"","sources":["../../src_v2/intelligence/models-dev-sync.ts"],"names":[],"mappings":"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"}
@@ -10,38 +10,13 @@
10
10
  * before any retry decision; there is no string matching.
11
11
  * 4. Context transform (compaction, skill injection) is invoked once per
12
12
  * turn before the provider call, never mid-stream.
13
- * 5. Steering and follow-up queues allow mid-flight control (see queues.ts).
14
13
  */
15
- import type { Message, AgentMessage, AgentResult, ToolDefinition, Provider, ToolExecutor, ApprovalBus, ErrorClassifier, AgentHooks } from './types.js';
14
+ import type { Message, AgentResult, ToolDefinition, Provider, ToolExecutor, ApprovalBus, ErrorClassifier, AgentHooks } from './types.js';
16
15
  import type { EventStream } from './event-stream.js';
17
- /**
18
- * Controller interface for mid-flight agent steering and follow-up.
19
- *
20
- * Exposed via `cfg.controller` so callers can inject messages without
21
- * changing the return type of `runAgentLoop` (which remains
22
- * `Promise<AgentResult>` for backwards compatibility).
23
- *
24
- * Usage:
25
- * const controller = { steer: (msg) => {}, followUp: (msg) => {} };
26
- * const result = await runAgentLoop({ ...cfg, controller });
27
- * // Later, from another context:
28
- * controller.steer({ role: 'user', content: 'Stop and do this instead' });
29
- */
30
- export interface AgentController {
31
- /** Queue a steering message (drain mode: all). Replaces current turn. */
32
- steer: (msg: AgentMessage) => void;
33
- /** Queue a follow-up message (drain mode: one-at-a-time). Runs after current turn. */
34
- followUp: (msg: AgentMessage) => void;
35
- }
36
16
  export interface AgentLoopConfig {
37
17
  sessionId: string;
38
18
  model: string;
39
- /**
40
- * Initial transcript. Plain `Message[]` is accepted (a `Message` is a
41
- * structural `AgentMessage` since `ui` and `hidden` are optional), so
42
- * existing callers keep working unchanged.
43
- */
44
- messages: AgentMessage[];
19
+ messages: Message[];
45
20
  tools: ToolDefinition[];
46
21
  maxTurns: number;
47
22
  provider: Provider;
@@ -50,21 +25,16 @@ export interface AgentLoopConfig {
50
25
  approvalBus?: ApprovalBus;
51
26
  errorClassifier?: ErrorClassifier;
52
27
  hooks?: AgentHooks;
53
- /**
54
- * Per-turn context transform. Receives the full transcript (post-projection
55
- * to `Message[]`) and returns the messages to actually send to the model.
56
- * Kept on `Message[]` so existing transforms (compaction, etc.) need no
57
- * changes.
58
- */
59
28
  contextTransform?: (messages: Message[]) => Promise<Message[]>;
60
29
  toolConcurrency?: 'serial' | 'parallel';
61
30
  signal?: AbortSignal;
62
31
  /**
63
- * Optional controller for mid-flight steering and follow-up.
64
- * When provided, the caller can inject messages via `steer()` and `followUp()`.
65
- * The controller object is populated with function references during loop
66
- * initialisation (mutated in-place so the caller sees them).
32
+ * When true, every approval-required tool call is auto-granted
33
+ * without going through the ApprovalBus. Set by `dirgha --yolo` or
34
+ * by the YOLO mode preamble. The ApprovalBus is otherwise the
35
+ * canonical gate for risky operations (writes outside cwd, shell,
36
+ * git mutations, etc.).
67
37
  */
68
- controller?: AgentController;
38
+ autoApprove?: boolean;
69
39
  }
70
40
  export declare function runAgentLoop(cfg: AgentLoopConfig): Promise<AgentResult>;
@@ -10,48 +10,34 @@
10
10
  * before any retry decision; there is no string matching.
11
11
  * 4. Context transform (compaction, skill injection) is invoked once per
12
12
  * turn before the provider call, never mid-stream.
13
- * 5. Steering and follow-up queues allow mid-flight control (see queues.ts).
14
13
  */
15
- import { assembleTurn, extractToolUses, appendToolResults, convertToLlm } from './message.js';
16
- import { SteeringQueue, FollowUpQueue } from './queues.js';
14
+ import { assembleTurn, extractToolUses, appendToolResults } from './message.js';
17
15
  export async function runAgentLoop(cfg) {
18
16
  const events = cfg.events;
19
17
  const history = [...cfg.messages];
20
18
  const totals = { inputTokens: 0, outputTokens: 0, cachedTokens: 0, costUsd: 0 };
21
19
  let stopReason = 'end_turn';
22
20
  let turnCount = 0;
23
- // Initialise steering and follow-up queues.
24
- const steeringQueue = new SteeringQueue();
25
- const followUpQueue = new FollowUpQueue();
26
- // Populate the controller object in-place so the caller can use it.
27
- if (cfg.controller) {
28
- cfg.controller.steer = (msg) => steeringQueue.enqueue(msg);
29
- cfg.controller.followUp = (msg) => followUpQueue.enqueue(msg);
30
- }
31
21
  events.emit({ type: 'agent_start', sessionId: cfg.sessionId, model: cfg.model });
32
22
  try {
33
- for (let turnIndex = 0; turnIndex < cfg.maxTurns;) {
23
+ for (let turnIndex = 0; turnIndex < cfg.maxTurns; turnIndex++) {
34
24
  if (cfg.signal?.aborted) {
35
25
  stopReason = 'aborted';
36
26
  break;
37
27
  }
38
28
  if (cfg.hooks?.beforeTurn) {
39
- // Project to Message[] so hooks observe exactly what the LLM does
40
- // (no ui/hidden leakage via covariant assignability).
41
- const decision = await cfg.hooks.beforeTurn(turnIndex, convertToLlm(history));
29
+ const decision = await cfg.hooks.beforeTurn(turnIndex, history);
42
30
  if (decision === 'abort') {
43
31
  stopReason = 'aborted';
44
32
  break;
45
33
  }
46
34
  }
35
+ turnCount = turnIndex + 1;
47
36
  const turnId = `t${turnIndex}-${Date.now().toString(36)}`;
48
37
  events.emit({ type: 'turn_start', turnId, turnIndex });
49
- // Projection boundary: strip UI-only metadata + drop hidden messages
50
- // before either the optional contextTransform or the provider call.
51
- const llmMessages = convertToLlm(history);
52
38
  const messagesForCall = cfg.contextTransform
53
- ? await cfg.contextTransform(llmMessages)
54
- : llmMessages;
39
+ ? await cfg.contextTransform(history)
40
+ : history;
55
41
  const streamEvents = [];
56
42
  try {
57
43
  for await (const ev of cfg.provider.stream({
@@ -65,6 +51,16 @@ export async function runAgentLoop(cfg) {
65
51
  }
66
52
  }
67
53
  catch (err) {
54
+ // An AbortError mid-stream is a clean cancellation, not a
55
+ // failure. Distinguish so callers (and `dirgha audit`) see
56
+ // `stopReason: 'aborted'` instead of misleading 'error'.
57
+ const isAbort = ((err instanceof Error && (err.name === 'AbortError' || /aborted|abort/i.test(err.message)))
58
+ || cfg.signal?.aborted === true);
59
+ if (isAbort) {
60
+ stopReason = 'aborted';
61
+ events.emit({ type: 'turn_end', turnId, stopReason });
62
+ break;
63
+ }
68
64
  const classified = cfg.errorClassifier?.classify(err, cfg.provider.id, cfg.model);
69
65
  events.emit({
70
66
  type: 'error',
@@ -81,43 +77,12 @@ export async function runAgentLoop(cfg) {
81
77
  totals.outputTokens += assembled.outputTokens;
82
78
  totals.cachedTokens += assembled.cachedTokens;
83
79
  history.push(assembled.message);
84
- // After provider stream completes, drain steering queue.
85
- // If non-empty, push steered messages to history and continue looping
86
- // (don't break on end_turn — the steered message becomes the next prompt).
87
- const steeredMessages = steeringQueue.drain();
88
- if (steeredMessages && steeredMessages.length > 0) {
89
- // Remove the assistant message we just added (the steered message replaces it).
90
- history.pop();
91
- // Push the steered messages instead.
92
- history.push(...steeredMessages);
93
- // Re-run the loop without incrementing turnIndex
94
- // (the steered message is the new prompt for the same turn).
95
- events.emit({ type: 'turn_end', turnId, stopReason: 'tool_use' });
96
- await cfg.hooks?.afterTurn?.(turnIndex, totals);
97
- continue;
98
- }
99
- // No steering — check if we're done or need tool execution.
100
80
  const toolUses = extractToolUses(assembled.message);
101
81
  if (toolUses.length === 0) {
102
- // Check for follow-up messages before breaking.
103
- // If a follow-up exists, it becomes the next turn.
104
- const followUpMessages = followUpQueue.drain();
105
- if (followUpMessages) {
106
- history.push(...followUpMessages);
107
- turnCount = turnIndex + 1;
108
- events.emit({ type: 'turn_end', turnId, stopReason: 'tool_use' });
109
- await cfg.hooks?.afterTurn?.(turnIndex, totals);
110
- turnIndex++;
111
- continue;
112
- }
113
- // No follow-up, we're done.
114
- turnCount = turnIndex + 1;
115
82
  events.emit({ type: 'turn_end', turnId, stopReason: 'end_turn' });
116
83
  await cfg.hooks?.afterTurn?.(turnIndex, totals);
117
84
  break;
118
85
  }
119
- // Execute tool calls and continue to next turn.
120
- turnCount = turnIndex + 1;
121
86
  const toolResults = await executeToolCalls(toolUses, cfg, events);
122
87
  const appended = appendToolResults(history, toolResults.map(r => ({
123
88
  toolUseId: r.call.id,
@@ -128,16 +93,12 @@ export async function runAgentLoop(cfg) {
128
93
  history.push(...appended);
129
94
  events.emit({ type: 'turn_end', turnId, stopReason: 'tool_use' });
130
95
  await cfg.hooks?.afterTurn?.(turnIndex, totals);
131
- // Only increment turnIndex if we're not being steered.
132
- turnIndex++;
133
96
  }
134
97
  }
135
98
  finally {
136
99
  events.emit({ type: 'agent_end', sessionId: cfg.sessionId, stopReason, usage: totals });
137
100
  }
138
- // Project to Message[] on return — AgentResult.messages is typed Message[],
139
- // so honor that contract here. Sprint B/C can widen later if needed.
140
- return { messages: convertToLlm(history), usage: totals, stopReason, turnCount, sessionId: cfg.sessionId };
101
+ return { messages: history, usage: totals, stopReason, turnCount, sessionId: cfg.sessionId };
141
102
  }
142
103
  async function executeToolCalls(toolUses, cfg, events) {
143
104
  const run = async (call) => {
@@ -152,7 +113,7 @@ async function executeToolCalls(toolUses, cfg, events) {
152
113
  input = decision.replaceInput;
153
114
  }
154
115
  }
155
- if (cfg.approvalBus?.requiresApproval(call.name, input)) {
116
+ if (cfg.approvalBus?.requiresApproval(call.name, input) && !cfg.autoApprove) {
156
117
  const decision = await cfg.approvalBus.request({
157
118
  id: call.id,
158
119
  tool: call.name,
@@ -1 +1 @@
1
- {"version":3,"file":"agent-loop.js","sourceRoot":"","sources":["../../src_v2/kernel/agent-loop.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"agent-loop.js","sourceRoot":"","sources":["../../src_v2/kernel/agent-loop.ts"],"names":[],"mappings":"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"}
@@ -2,4 +2,3 @@ export * from './types.js';
2
2
  export * from './event-stream.js';
3
3
  export * from './message.js';
4
4
  export * from './agent-loop.js';
5
- export * from './queues.js';
@@ -2,5 +2,4 @@ export * from './types.js';
2
2
  export * from './event-stream.js';
3
3
  export * from './message.js';
4
4
  export * from './agent-loop.js';
5
- export * from './queues.js';
6
5
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src_v2/kernel/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src_v2/kernel/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}
@@ -1,23 +1,7 @@
1
1
  /**
2
2
  * Message manipulation helpers. Pure functions over Message[].
3
3
  */
4
- import type { AgentMessage, Message, ContentPart, ToolUsePart, AgentEvent } from './types.js';
5
- /**
6
- * Projection boundary: convert kernel-internal `AgentMessage[]` (which may
7
- * carry UI-only metadata) into the clean `Message[]` shape that providers
8
- * actually send to the LLM.
9
- *
10
- * Behaviour:
11
- * - Filters out any entry with `hidden === true`.
12
- * - Strips the `ui` field from the remaining entries.
13
- * - Preserves order.
14
- * - Pure: does not mutate the input array or its elements.
15
- *
16
- * This is the ONLY seam the agent loop should use when handing messages
17
- * off to a `Provider.stream` call. Keeping it a single function makes the
18
- * UI/LLM boundary auditable.
19
- */
20
- export declare function convertToLlm(messages: AgentMessage[]): Message[];
4
+ import type { Message, ContentPart, ToolUsePart, AgentEvent } from './types.js';
21
5
  export declare function normaliseContent(msg: Message): ContentPart[];
22
6
  export declare function extractText(msg: Message): string;
23
7
  export declare function extractToolUses(msg: Message): ToolUsePart[];
@@ -1,32 +1,6 @@
1
1
  /**
2
2
  * Message manipulation helpers. Pure functions over Message[].
3
3
  */
4
- /**
5
- * Projection boundary: convert kernel-internal `AgentMessage[]` (which may
6
- * carry UI-only metadata) into the clean `Message[]` shape that providers
7
- * actually send to the LLM.
8
- *
9
- * Behaviour:
10
- * - Filters out any entry with `hidden === true`.
11
- * - Strips the `ui` field from the remaining entries.
12
- * - Preserves order.
13
- * - Pure: does not mutate the input array or its elements.
14
- *
15
- * This is the ONLY seam the agent loop should use when handing messages
16
- * off to a `Provider.stream` call. Keeping it a single function makes the
17
- * UI/LLM boundary auditable.
18
- */
19
- export function convertToLlm(messages) {
20
- const out = [];
21
- for (const m of messages) {
22
- if (m.hidden === true)
23
- continue;
24
- // Destructure to strip ui/hidden without mutating the original.
25
- const { ui: _ui, hidden: _hidden, ...rest } = m;
26
- out.push(rest);
27
- }
28
- return out;
29
- }
30
4
  export function normaliseContent(msg) {
31
5
  if (typeof msg.content === 'string') {
32
6
  return msg.content.length > 0 ? [{ type: 'text', text: msg.content }] : [];
@@ -1 +1 @@
1
- {"version":3,"file":"message.js","sourceRoot":"","sources":["../../src_v2/kernel/message.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"message.js","sourceRoot":"","sources":["../../src_v2/kernel/message.ts"],"names":[],"mappings":"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"}
@@ -33,35 +33,6 @@ export interface Message {
33
33
  content: string | ContentPart[];
34
34
  name?: string;
35
35
  }
36
- /**
37
- * UI-only metadata that may be attached to a message in agent state but
38
- * MUST NOT be sent to the LLM. Use `convertToLlm` (see `./message.ts`) at
39
- * the provider boundary to strip these fields.
40
- *
41
- * `kind` is the high-level provenance / role of the entry:
42
- * - 'notification' : transient UI banner (rate-limit, model-switch, etc.)
43
- * - 'skill-injection' : marker for a skill-prompt injection event
44
- * - 'fleet-supervisor': supervisor commentary in fleet/multi-agent runs
45
- * - 'internal' : free-form internal annotation
46
- *
47
- * `data` is opaque to the kernel; consumers (TUI, daemon, fleet) may shape
48
- * it as they wish.
49
- */
50
- export interface AgentMessageUi {
51
- kind: 'notification' | 'skill-injection' | 'fleet-supervisor' | 'internal';
52
- data?: unknown;
53
- }
54
- /**
55
- * `AgentMessage` is the in-kernel transcript entry. It is a `Message` plus
56
- * optional UI-only metadata. The agent loop stores `AgentMessage[]`; only
57
- * the projected `Message[]` (via `convertToLlm`) is sent to providers.
58
- *
59
- * `hidden: true` excludes the message from the LLM context entirely.
60
- */
61
- export interface AgentMessage extends Message {
62
- ui?: AgentMessageUi;
63
- hidden?: boolean;
64
- }
65
36
  export type StopReason = 'end_turn' | 'tool_use' | 'max_tokens' | 'stop_sequence' | 'error' | 'aborted';
66
37
  export interface UsageTotal {
67
38
  inputTokens: number;
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Skill marketplace via npm: Allows installing skill packs from npm.
3
+ * This module provides `installNpmSkill` to fetch and install a skill from an npm package.
4
+ */
5
+ export interface InstallNpmResult {
6
+ name: string;
7
+ version: string;
8
+ installedAt: string;
9
+ bytes: number;
10
+ }
11
+ /**
12
+ * Install a skill from an npm package.
13
+ * @param spec - "npm:@scope/pack", "npm:@scope/pack@version", or "npm:plain-pkg"
14
+ * @param nameOverride - optional folder name (default: derived from package.json's "name" stripped of @scope/)
15
+ */
16
+ export declare function installNpmSkill(spec: string, nameOverride?: string): Promise<InstallNpmResult>;