minicode-ai 0.11.0 → 0.13.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.
Files changed (221) hide show
  1. package/CHANGELOG.md +98 -0
  2. package/LICENSE +21 -21
  3. package/README.md +4 -4
  4. package/cli/args.ts +46 -0
  5. package/cli/commands/acp.ts +163 -10
  6. package/cli/commands/config.ts +33 -18
  7. package/cli/commands/daemon.ts +515 -0
  8. package/cli/commands/exec.ts +145 -53
  9. package/cli/commands/openwork.ts +986 -0
  10. package/cli/commands/sessions.ts +4 -1
  11. package/cli/commands/stats.ts +34 -4
  12. package/cli/commands.ts +217 -2
  13. package/cli/index.ts +146 -14
  14. package/cli/recovery-warning.ts +115 -0
  15. package/cli/router.ts +32 -1
  16. package/cli/setup.ts +2332 -171
  17. package/cli/tui.ts +113 -7
  18. package/docs/OUTPUT_ARCHITECTURE_AUDIT.md +489 -0
  19. package/docs/OUTPUT_EVENT_MODEL.md +289 -0
  20. package/docs/OUTPUT_IMPLEMENTATION_PLAN.md +391 -0
  21. package/docs/OUTPUT_PROTOCOL_SPEC.md +285 -0
  22. package/docs/OUTPUT_RENDERING_SPEC.md +248 -0
  23. package/docs/OUTPUT_UX_RULES.md +449 -0
  24. package/docs/PLAN_UIUX_V6.md +2 -2
  25. package/docs/README.md +4 -3
  26. package/docs/TERMINAL_CONTRACT.md +278 -66
  27. package/docs/architecture.md +89 -7
  28. package/docs/changelog.md +1 -1
  29. package/docs/choosing-mode.md +2 -2
  30. package/docs/cli.md +9 -5
  31. package/docs/concepts.md +1 -1
  32. package/docs/contributing.md +9 -2
  33. package/docs/environment.md +6 -2
  34. package/docs/exec.md +46 -5
  35. package/docs/memory-sessions.md +2 -0
  36. package/docs/policy-sandbox.md +1 -1
  37. package/docs/pricing-budget.md +1 -1
  38. package/docs/quickstart.md +2 -2
  39. package/docs/repl.md +6 -2
  40. package/docs/security-model.md +1 -1
  41. package/docs/security.md +1 -1
  42. package/docs/skills.md +2 -2
  43. package/docs/terminal.md +9 -5
  44. package/docs/tools.md +1 -1
  45. package/package.json +35 -5
  46. package/src/app/session.ts +261 -15
  47. package/src/app/tool-layer.ts +94 -7
  48. package/src/daemon/approvals.ts +361 -0
  49. package/src/daemon/capability.ts +145 -0
  50. package/src/daemon/children.ts +142 -0
  51. package/src/daemon/client.ts +267 -0
  52. package/src/daemon/control.ts +350 -0
  53. package/src/daemon/discovery.ts +234 -0
  54. package/src/daemon/feed.ts +155 -0
  55. package/src/daemon/framing.ts +94 -0
  56. package/src/daemon/host.ts +316 -0
  57. package/src/daemon/protocol.ts +217 -0
  58. package/src/daemon/resource.ts +170 -0
  59. package/src/daemon/sanitize.ts +57 -0
  60. package/src/daemon/server.ts +627 -0
  61. package/src/daemon/store.ts +317 -0
  62. package/src/daemon/subscription.ts +270 -0
  63. package/src/daemon/telemetry.ts +81 -0
  64. package/src/hooks/run.ts +12 -1
  65. package/src/lib/atomic-write.ts +29 -3
  66. package/src/lib/db-path.ts +26 -0
  67. package/src/lib/keystore.ts +544 -42
  68. package/src/lib/net.ts +43 -1
  69. package/src/lib/safe-open.ts +116 -1
  70. package/src/lib/session-id.ts +15 -0
  71. package/src/lsp/client.ts +123 -5
  72. package/src/mcp/client.ts +139 -17
  73. package/src/mcp/server.ts +177 -50
  74. package/src/mcp/transport.ts +16 -19
  75. package/src/memory/vector.ts +770 -55
  76. package/src/policy/allowlist.ts +14 -2
  77. package/src/policy/bash-guard.ts +105 -10
  78. package/src/policy/compaction.ts +82 -5
  79. package/src/policy/consequence-engine.ts +220 -0
  80. package/src/policy/context.ts +132 -0
  81. package/src/policy/executor.ts +187 -121
  82. package/src/policy/no-progress.ts +559 -0
  83. package/src/policy/permission.ts +4 -8
  84. package/src/policy/pricing.ts +17 -3
  85. package/src/policy/scrub.ts +69 -2
  86. package/src/policy/tool-contract.ts +515 -0
  87. package/src/policy/usage.ts +310 -24
  88. package/src/policy/verifier.ts +6 -3
  89. package/src/policy/work-mode.ts +182 -0
  90. package/src/presentation/adapter.ts +533 -26
  91. package/src/presentation/events.ts +151 -0
  92. package/src/presentation/model.ts +180 -27
  93. package/src/presentation/projection.ts +858 -0
  94. package/src/presentation/reducer.ts +645 -310
  95. package/src/presentation/store.ts +12 -7
  96. package/src/providers/anthropic.ts +18 -10
  97. package/src/providers/responses.ts +17 -7
  98. package/src/runtime/capability.ts +409 -0
  99. package/src/runtime/child-execution.ts +274 -0
  100. package/src/runtime/composition.ts +958 -0
  101. package/src/runtime/dispatch.ts +591 -0
  102. package/src/runtime/execution-backend.ts +632 -0
  103. package/src/runtime/execution-events.ts +272 -0
  104. package/src/runtime/execution-id.ts +230 -0
  105. package/src/runtime/execution-journal.ts +926 -0
  106. package/src/runtime/execution-kernel.ts +456 -0
  107. package/src/runtime/execution-registry.ts +379 -0
  108. package/src/runtime/process-supervision.ts +276 -0
  109. package/src/runtime/production-execution.ts +551 -0
  110. package/src/runtime/production-runtime.ts +217 -0
  111. package/src/runtime/recovery-safety.ts +70 -0
  112. package/src/runtime/recovery.ts +477 -0
  113. package/src/runtime/runtime-capabilities.ts +179 -0
  114. package/src/runtime/runtime-diagnostics.ts +141 -0
  115. package/src/runtime/runtime-host.ts +365 -0
  116. package/src/runtime/runtime-status-facts.ts +222 -0
  117. package/src/runtime/runtime-status-provider.ts +74 -0
  118. package/src/runtime/runtime-status.ts +459 -0
  119. package/src/runtime/runtime-task-admission.ts +101 -0
  120. package/src/runtime/supervisor.ts +444 -0
  121. package/src/session/authority.ts +168 -0
  122. package/src/session/checkpoint.ts +88 -1
  123. package/src/session/context-adapter.ts +251 -0
  124. package/src/session/context-assembly.ts +242 -0
  125. package/src/session/context-identity.ts +389 -0
  126. package/src/session/context-projection.ts +248 -0
  127. package/src/session/context-selector.ts +500 -0
  128. package/src/session/cross-session-adoption.ts +249 -0
  129. package/src/session/full-history-fold.ts +171 -0
  130. package/src/session/identity.ts +192 -0
  131. package/src/session/journal.ts +805 -102
  132. package/src/session/open-work-intent.ts +732 -0
  133. package/src/session/open-work.ts +767 -0
  134. package/src/session/pending-tools.ts +94 -0
  135. package/src/session/persistence.ts +3569 -127
  136. package/src/session/runtime-header.ts +208 -0
  137. package/src/session/shadow-git.ts +13 -5
  138. package/src/session/verification.ts +1623 -0
  139. package/src/task/assignment.ts +136 -0
  140. package/src/task/autonomous-adapter.ts +168 -0
  141. package/src/task/autonomous-context.ts +630 -0
  142. package/src/task/autonomous-policy.ts +490 -0
  143. package/src/task/continuity.ts +179 -0
  144. package/src/task/execution-cancellation.ts +165 -0
  145. package/src/task/graph-validate.ts +379 -0
  146. package/src/task/graph.ts +305 -0
  147. package/src/task/identity.ts +230 -0
  148. package/src/task/model.ts +417 -0
  149. package/src/task/production-scheduler.ts +293 -0
  150. package/src/task/readiness.ts +229 -0
  151. package/src/task/scheduler-observability.ts +387 -0
  152. package/src/task/scheduler.ts +1197 -0
  153. package/src/task/scheduling-policy.ts +165 -0
  154. package/src/task/session-authority.ts +148 -0
  155. package/src/task/session-ownership.ts +211 -0
  156. package/src/task/store.ts +2887 -0
  157. package/src/task/sync.ts +343 -0
  158. package/src/task/trigger.ts +260 -0
  159. package/src/tools/bash.ts +377 -211
  160. package/src/tools/code_run.ts +1 -1
  161. package/src/tools/delete_file.ts +1 -1
  162. package/src/tools/edit.ts +33 -6
  163. package/src/tools/evidence.ts +30 -0
  164. package/src/tools/git.ts +4 -4
  165. package/src/tools/glob.ts +12 -3
  166. package/src/tools/grep.ts +1 -1
  167. package/src/tools/lsp.ts +4 -4
  168. package/src/tools/mcp_call.ts +11 -4
  169. package/src/tools/memory.ts +153 -18
  170. package/src/tools/move_file.ts +1 -1
  171. package/src/tools/patch.ts +1 -1
  172. package/src/tools/read_file.ts +1 -1
  173. package/src/tools/read_image.ts +1 -1
  174. package/src/tools/submit_result.ts +1 -1
  175. package/src/tools/task.ts +437 -41
  176. package/src/tools/todo.ts +662 -35
  177. package/src/tools/web_fetch.ts +4 -2
  178. package/src/tools/web_search.ts +9 -3
  179. package/src/tools/write_file.ts +1 -1
  180. package/src/ui/assistant/simple.ts +123 -50
  181. package/src/ui/assistant/turn-status.ts +17 -3
  182. package/src/ui/contract.ts +184 -0
  183. package/src/ui/footer.ts +54 -18
  184. package/src/ui/i18n/en.ts +62 -6
  185. package/src/ui/i18n/id.ts +62 -6
  186. package/src/ui/input/prompt-engine.ts +120 -25
  187. package/src/ui/render/errors.ts +39 -1
  188. package/src/ui/render/markdown-table.ts +455 -0
  189. package/src/ui/render/markdown.ts +22 -1
  190. package/src/ui/render/table-grid.ts +184 -0
  191. package/src/ui/render/table.ts +15 -76
  192. package/src/ui/runtime/screen.ts +7 -2
  193. package/src/ui/runtime/statusline.ts +25 -6
  194. package/src/ui/tui/app.ts +598 -133
  195. package/src/ui/tui/transcript.ts +531 -89
  196. package/vendor/minicore/VENDOR.md +1 -1
  197. package/vendor/minicore/src/core/budget.ts +25 -25
  198. package/vendor/minicore/src/core/compact.ts +75 -75
  199. package/vendor/minicore/src/core/errors.ts +59 -59
  200. package/vendor/minicore/src/core/events.ts +73 -73
  201. package/vendor/minicore/src/core/executor.ts +139 -139
  202. package/vendor/minicore/src/core/history.ts +31 -31
  203. package/vendor/minicore/src/core/index.ts +41 -41
  204. package/vendor/minicore/src/core/loop.ts +355 -355
  205. package/vendor/minicore/src/core/permission.ts +22 -22
  206. package/vendor/minicore/src/core/provider.ts +39 -39
  207. package/vendor/minicore/src/core/recovery.ts +35 -35
  208. package/vendor/minicore/src/core/session.ts +327 -327
  209. package/vendor/minicore/src/core/snapshot.ts +146 -146
  210. package/vendor/minicore/src/core/tokens.ts +107 -107
  211. package/vendor/minicore/src/core/tool.ts +115 -115
  212. package/vendor/minicore/src/core/types.ts +50 -50
  213. package/vendor/minicore/src/providers/openai-compat.ts +417 -417
  214. package/AGENTS.md +0 -45
  215. package/PLAN.md +0 -491
  216. package/docs/ARCHITECTURE.html +0 -1248
  217. package/docs/CONTROL-PLANE-MAP.md +0 -139
  218. package/docs/HARNESS.md +0 -150
  219. package/docs/SUMMARY.md +0 -52
  220. package/docs/UI_RENDER_PIPELINE.md +0 -165
  221. package/docs/USAGE.md +0 -11
@@ -1,139 +1,139 @@
1
- // Tool executor boundary. The kernel ships a sequential strategy; a parallel
2
- // strategy can be added later by implementing the same interface, without
3
- // changing the kernel. Each call runs the same deterministic pipeline:
4
- // resolve → permission → validate → execute → normalize/truncate.
5
-
6
- import { validateArgs } from "./tool.ts";
7
- import type { ToolRegistry } from "./tool.ts";
8
- import type { PermissionHandler } from "./permission.ts";
9
- import type { EventBus } from "./events.ts";
10
- import type { SessionState } from "./session.ts";
11
- import type { Execution } from "./session.ts";
12
- import type { ToolCall, ToolResult } from "./types.ts";
13
- import { DEFAULT_CHARS_PER_TOKEN } from "./tokens.ts";
14
- import { abortError } from "./errors.ts";
15
- import { snapshotExecution, snapshotState, snapshotToolCall } from "./snapshot.ts";
16
-
17
- export interface ExecutorDeps {
18
- readonly registry: ToolRegistry;
19
- readonly permissions: PermissionHandler;
20
- readonly events: EventBus;
21
- readonly signal: AbortSignal;
22
- readonly state: Readonly<SessionState>;
23
- readonly maxResultTokens: number;
24
- readonly cwd?: string;
25
- readonly permissionMode?: string;
26
- }
27
-
28
- export interface ToolExecutor {
29
- execute(calls: readonly ToolCall[], deps: ExecutorDeps): Promise<readonly ToolResult[]>;
30
- }
31
-
32
- const errorResult = (call: ToolCall, message: string): ToolResult => ({
33
- role: "tool",
34
- toolCallId: call.id,
35
- name: call.name,
36
- content: message,
37
- isError: true,
38
- });
39
-
40
- export async function runCall(call: ToolCall, deps: ExecutorDeps): Promise<ToolResult> {
41
- throwIfAborted(deps.signal);
42
- const safeCall = snapshotToolCall(call);
43
- const tool = deps.registry.get(safeCall.name);
44
- if (!tool) return errorResult(safeCall, `unknown tool: ${safeCall.name}`);
45
-
46
- // The permission handler is user/policy code and may throw. Treat a crash
47
- // exactly like a tool error: a deterministic error result (observation),
48
- // never a raw rejection that escapes run() without an error taxonomy.
49
- let decision: Awaited<ReturnType<PermissionHandler["check"]>>;
50
- const permissionDeps: ExecutorDeps = { ...deps, state: snapshotState(deps.state) };
51
- try {
52
- decision = await deps.permissions.check(snapshotToolCall(safeCall), permissionDeps);
53
- } catch (error) {
54
- throwIfAborted(deps.signal);
55
- return errorResult(safeCall, `permission error: ${error instanceof Error ? error.message : String(error)}`);
56
- }
57
- throwIfAborted(deps.signal);
58
- if (decision === "deny") {
59
- // Optional handler diagnostic, surfaced so the model observes an
60
- // actionable reason ("permission denied: <reason>"). Diagnostic-only:
61
- // describeDenial must never fail the denial itself — hence the guard.
62
- let suffix = "";
63
- try {
64
- const r = await deps.permissions.describeDenial?.(snapshotToolCall(safeCall));
65
- if (typeof r === "string" && r.trim()) suffix = `: ${r.trim().slice(0, 160)}`;
66
- } catch {
67
- /* reason is diagnostic-only; the denial stands */
68
- }
69
- return errorResult(safeCall, `permission denied${suffix}`);
70
- }
71
-
72
- const parsed = validateArgs(tool.parameters, safeCall.args);
73
- if (!parsed.ok) return errorResult(safeCall, `invalid arguments: ${parsed.message}`);
74
- throwIfAborted(deps.signal);
75
-
76
- const ctx = {
77
- signal: deps.signal,
78
- state: snapshotState(deps.state),
79
- emit: deps.events.emit,
80
- cwd: deps.cwd,
81
- permissionMode: deps.permissionMode,
82
- };
83
- // Started and completed events carry separate result objects so listeners
84
- // that retain the execution reference never observe later mutation.
85
- const started: Execution = { call: safeCall, result: { role: "tool", toolCallId: safeCall.id, name: safeCall.name, content: "" } };
86
- deps.events.emit({ type: "execution:started", execution: snapshotExecution(started) });
87
- let result: ToolResult;
88
- try {
89
- const content = await tool.execute(parsed.value, ctx);
90
- throwIfAborted(deps.signal);
91
- result = { role: "tool", toolCallId: safeCall.id, name: safeCall.name, content: serializeContent(content, deps.maxResultTokens) };
92
- } catch (error) {
93
- throwIfAborted(deps.signal);
94
- result = {
95
- role: "tool",
96
- toolCallId: safeCall.id,
97
- name: safeCall.name,
98
- content: error instanceof Error ? error.message : String(error),
99
- isError: true,
100
- };
101
- }
102
- deps.events.emit({ type: "execution:completed", execution: snapshotExecution({ call: safeCall, result }) });
103
- return result;
104
- }
105
-
106
- export function sequentialExecutor(): ToolExecutor {
107
- return {
108
- async execute(calls, deps) {
109
- const results: ToolResult[] = [];
110
- for (const call of calls) {
111
- throwIfAborted(deps.signal);
112
- results.push(await runCall(call, deps));
113
- }
114
- return results;
115
- },
116
- };
117
- }
118
-
119
- function throwIfAborted(signal: AbortSignal): void {
120
- if (signal.aborted) throw abortError(signal);
121
- }
122
-
123
- function serializeContent(value: unknown, maxTokens: number): unknown {
124
- if (value instanceof Uint8Array) return value;
125
- let text: string;
126
- if (typeof value === "string") text = value;
127
- else {
128
- try {
129
- text = JSON.stringify(value, null, 2) ?? String(value);
130
- } catch {
131
- text = String(value);
132
- }
133
- }
134
- const maxChars = maxTokens * DEFAULT_CHARS_PER_TOKEN;
135
- if (text.length <= maxChars) return text;
136
- const headLen = Math.max(0, Math.floor(maxChars * 0.7));
137
- const tailLen = Math.max(0, maxChars - headLen - 12);
138
- return `${text.slice(0, headLen)}\n…[truncated]…\n${text.slice(-tailLen)}`;
139
- }
1
+ // Tool executor boundary. The kernel ships a sequential strategy; a parallel
2
+ // strategy can be added later by implementing the same interface, without
3
+ // changing the kernel. Each call runs the same deterministic pipeline:
4
+ // resolve → permission → validate → execute → normalize/truncate.
5
+
6
+ import { validateArgs } from "./tool.ts";
7
+ import type { ToolRegistry } from "./tool.ts";
8
+ import type { PermissionHandler } from "./permission.ts";
9
+ import type { EventBus } from "./events.ts";
10
+ import type { SessionState } from "./session.ts";
11
+ import type { Execution } from "./session.ts";
12
+ import type { ToolCall, ToolResult } from "./types.ts";
13
+ import { DEFAULT_CHARS_PER_TOKEN } from "./tokens.ts";
14
+ import { abortError } from "./errors.ts";
15
+ import { snapshotExecution, snapshotState, snapshotToolCall } from "./snapshot.ts";
16
+
17
+ export interface ExecutorDeps {
18
+ readonly registry: ToolRegistry;
19
+ readonly permissions: PermissionHandler;
20
+ readonly events: EventBus;
21
+ readonly signal: AbortSignal;
22
+ readonly state: Readonly<SessionState>;
23
+ readonly maxResultTokens: number;
24
+ readonly cwd?: string;
25
+ readonly permissionMode?: string;
26
+ }
27
+
28
+ export interface ToolExecutor {
29
+ execute(calls: readonly ToolCall[], deps: ExecutorDeps): Promise<readonly ToolResult[]>;
30
+ }
31
+
32
+ const errorResult = (call: ToolCall, message: string): ToolResult => ({
33
+ role: "tool",
34
+ toolCallId: call.id,
35
+ name: call.name,
36
+ content: message,
37
+ isError: true,
38
+ });
39
+
40
+ export async function runCall(call: ToolCall, deps: ExecutorDeps): Promise<ToolResult> {
41
+ throwIfAborted(deps.signal);
42
+ const safeCall = snapshotToolCall(call);
43
+ const tool = deps.registry.get(safeCall.name);
44
+ if (!tool) return errorResult(safeCall, `unknown tool: ${safeCall.name}`);
45
+
46
+ // The permission handler is user/policy code and may throw. Treat a crash
47
+ // exactly like a tool error: a deterministic error result (observation),
48
+ // never a raw rejection that escapes run() without an error taxonomy.
49
+ let decision: Awaited<ReturnType<PermissionHandler["check"]>>;
50
+ const permissionDeps: ExecutorDeps = { ...deps, state: snapshotState(deps.state) };
51
+ try {
52
+ decision = await deps.permissions.check(snapshotToolCall(safeCall), permissionDeps);
53
+ } catch (error) {
54
+ throwIfAborted(deps.signal);
55
+ return errorResult(safeCall, `permission error: ${error instanceof Error ? error.message : String(error)}`);
56
+ }
57
+ throwIfAborted(deps.signal);
58
+ if (decision === "deny") {
59
+ // Optional handler diagnostic, surfaced so the model observes an
60
+ // actionable reason ("permission denied: <reason>"). Diagnostic-only:
61
+ // describeDenial must never fail the denial itself — hence the guard.
62
+ let suffix = "";
63
+ try {
64
+ const r = await deps.permissions.describeDenial?.(snapshotToolCall(safeCall));
65
+ if (typeof r === "string" && r.trim()) suffix = `: ${r.trim().slice(0, 160)}`;
66
+ } catch {
67
+ /* reason is diagnostic-only; the denial stands */
68
+ }
69
+ return errorResult(safeCall, `permission denied${suffix}`);
70
+ }
71
+
72
+ const parsed = validateArgs(tool.parameters, safeCall.args);
73
+ if (!parsed.ok) return errorResult(safeCall, `invalid arguments: ${parsed.message}`);
74
+ throwIfAborted(deps.signal);
75
+
76
+ const ctx = {
77
+ signal: deps.signal,
78
+ state: snapshotState(deps.state),
79
+ emit: deps.events.emit,
80
+ cwd: deps.cwd,
81
+ permissionMode: deps.permissionMode,
82
+ };
83
+ // Started and completed events carry separate result objects so listeners
84
+ // that retain the execution reference never observe later mutation.
85
+ const started: Execution = { call: safeCall, result: { role: "tool", toolCallId: safeCall.id, name: safeCall.name, content: "" } };
86
+ deps.events.emit({ type: "execution:started", execution: snapshotExecution(started) });
87
+ let result: ToolResult;
88
+ try {
89
+ const content = await tool.execute(parsed.value, ctx);
90
+ throwIfAborted(deps.signal);
91
+ result = { role: "tool", toolCallId: safeCall.id, name: safeCall.name, content: serializeContent(content, deps.maxResultTokens) };
92
+ } catch (error) {
93
+ throwIfAborted(deps.signal);
94
+ result = {
95
+ role: "tool",
96
+ toolCallId: safeCall.id,
97
+ name: safeCall.name,
98
+ content: error instanceof Error ? error.message : String(error),
99
+ isError: true,
100
+ };
101
+ }
102
+ deps.events.emit({ type: "execution:completed", execution: snapshotExecution({ call: safeCall, result }) });
103
+ return result;
104
+ }
105
+
106
+ export function sequentialExecutor(): ToolExecutor {
107
+ return {
108
+ async execute(calls, deps) {
109
+ const results: ToolResult[] = [];
110
+ for (const call of calls) {
111
+ throwIfAborted(deps.signal);
112
+ results.push(await runCall(call, deps));
113
+ }
114
+ return results;
115
+ },
116
+ };
117
+ }
118
+
119
+ function throwIfAborted(signal: AbortSignal): void {
120
+ if (signal.aborted) throw abortError(signal);
121
+ }
122
+
123
+ function serializeContent(value: unknown, maxTokens: number): unknown {
124
+ if (value instanceof Uint8Array) return value;
125
+ let text: string;
126
+ if (typeof value === "string") text = value;
127
+ else {
128
+ try {
129
+ text = JSON.stringify(value, null, 2) ?? String(value);
130
+ } catch {
131
+ text = String(value);
132
+ }
133
+ }
134
+ const maxChars = maxTokens * DEFAULT_CHARS_PER_TOKEN;
135
+ if (text.length <= maxChars) return text;
136
+ const headLen = Math.max(0, Math.floor(maxChars * 0.7));
137
+ const tailLen = Math.max(0, maxChars - headLen - 12);
138
+ return `${text.slice(0, headLen)}\n…[truncated]…\n${text.slice(-tailLen)}`;
139
+ }
@@ -1,32 +1,32 @@
1
- // Context storage: an append-only, transformable message buffer.
2
- // Storage only — token policy and compaction are separate modules.
3
-
4
- import type { Message } from "./types.ts";
5
-
6
- /**
7
- * The kernel's context buffer. Append-only in normal operation; `replace` is
8
- * the single seam for compaction. `messages` exposes the live buffer typed as
9
- * read-only — mutating it via a cast would corrupt the kernel's history, so
10
- * treat it as immutable.
11
- */
12
- export class ContextStore {
13
- #messages: Message[] = [];
14
-
15
- /** Live view of the buffer. Read-only by type; never cast and mutate. */
16
- get messages(): readonly Message[] {
17
- return this.#messages;
18
- }
19
-
20
- append(message: Message): void {
21
- this.#messages.push(message);
22
- }
23
-
24
- appendAll(messages: readonly Message[]): void {
25
- this.#messages.push(...messages);
26
- }
27
-
28
- /** Replace `deleteCount` messages starting at `start` with `replacement`. */
29
- replace(start: number, deleteCount: number, replacement: readonly Message[]): void {
30
- this.#messages.splice(start, deleteCount, ...replacement);
31
- }
1
+ // Context storage: an append-only, transformable message buffer.
2
+ // Storage only — token policy and compaction are separate modules.
3
+
4
+ import type { Message } from "./types.ts";
5
+
6
+ /**
7
+ * The kernel's context buffer. Append-only in normal operation; `replace` is
8
+ * the single seam for compaction. `messages` exposes the live buffer typed as
9
+ * read-only — mutating it via a cast would corrupt the kernel's history, so
10
+ * treat it as immutable.
11
+ */
12
+ export class ContextStore {
13
+ #messages: Message[] = [];
14
+
15
+ /** Live view of the buffer. Read-only by type; never cast and mutate. */
16
+ get messages(): readonly Message[] {
17
+ return this.#messages;
18
+ }
19
+
20
+ append(message: Message): void {
21
+ this.#messages.push(message);
22
+ }
23
+
24
+ appendAll(messages: readonly Message[]): void {
25
+ this.#messages.push(...messages);
26
+ }
27
+
28
+ /** Replace `deleteCount` messages starting at `start` with `replacement`. */
29
+ replace(start: number, deleteCount: number, replacement: readonly Message[]): void {
30
+ this.#messages.splice(start, deleteCount, ...replacement);
31
+ }
32
32
  }
@@ -1,42 +1,42 @@
1
- // MiniCore — public surface. Everything the kernel exposes intentionally.
2
- // Providers, tools, memory, UI, and storage live outside this file.
3
-
4
- export type { Message, UserMessage, AssistantMessage, ToolResult, ToolCall, Content, ContentPart } from "./types.ts";
5
- export { AgentError, ProviderError, abortError } from "./errors.ts";
6
- export type { AgentErrorKind, ProviderErrorCategory, RecoveryAction } from "./errors.ts";
7
- export type { ModelProvider, StreamRequest, ProviderEvent, FinishReason } from "./provider.ts";
8
- export type { Tool, ToolSchema, JSONSchema, ToolContext, ToolRegistry, ArgsResult } from "./tool.ts";
9
- export { validateArgs, createToolRegistry } from "./tool.ts";
10
- export type { ToolExecutor, ExecutorDeps } from "./executor.ts";
11
- export { runCall, sequentialExecutor } from "./executor.ts";
12
- export type { PermissionHandler, Decision } from "./permission.ts";
13
- export type { TokenEstimator } from "./tokens.ts";
14
- export {
15
- defaultTokenEstimator,
16
- estimateImageTokens,
17
- estimateMessage,
18
- estimateMessages,
19
- estimateTools,
20
- estimateSystem,
21
- estimateSessionContext,
22
- contentToText,
23
- DEFAULT_CHARS_PER_TOKEN,
24
- } from "./tokens.ts";
25
- export type { BudgetPolicy, BudgetState, PressureLevel } from "./budget.ts";
26
- export { defaultBudgetPolicy } from "./budget.ts";
27
- export type { CompactionStrategy } from "./compact.ts";
28
- export { mechanicalCompaction } from "./compact.ts";
29
- export type { RecoveryPolicy } from "./recovery.ts";
30
- export { defaultRecoveryPolicy, maxProviderRetries } from "./recovery.ts";
31
- export type { AgentEvent, AgentEventType, EventBus, EventBusOptions } from "./events.ts";
32
- export { createEventBus } from "./events.ts";
33
- export { ContextStore } from "./history.ts";
34
- export type { Session, SessionConfig, SessionState, TurnResult, Step, Execution } from "./session.ts";
35
- export {
36
- createSession,
37
- DEFAULT_MAX_STEPS,
38
- DEFAULT_CONTEXT_WINDOW_TOKENS,
39
- DEFAULT_TOOL_RESULT_MAX_TOKENS,
40
- DEFAULT_KEEP_RECENT_TURNS,
41
- DEFAULT_TIMEOUT_MS,
1
+ // MiniCore — public surface. Everything the kernel exposes intentionally.
2
+ // Providers, tools, memory, UI, and storage live outside this file.
3
+
4
+ export type { Message, UserMessage, AssistantMessage, ToolResult, ToolCall, Content, ContentPart } from "./types.ts";
5
+ export { AgentError, ProviderError, abortError } from "./errors.ts";
6
+ export type { AgentErrorKind, ProviderErrorCategory, RecoveryAction } from "./errors.ts";
7
+ export type { ModelProvider, StreamRequest, ProviderEvent, FinishReason } from "./provider.ts";
8
+ export type { Tool, ToolSchema, JSONSchema, ToolContext, ToolRegistry, ArgsResult } from "./tool.ts";
9
+ export { validateArgs, createToolRegistry } from "./tool.ts";
10
+ export type { ToolExecutor, ExecutorDeps } from "./executor.ts";
11
+ export { runCall, sequentialExecutor } from "./executor.ts";
12
+ export type { PermissionHandler, Decision } from "./permission.ts";
13
+ export type { TokenEstimator } from "./tokens.ts";
14
+ export {
15
+ defaultTokenEstimator,
16
+ estimateImageTokens,
17
+ estimateMessage,
18
+ estimateMessages,
19
+ estimateTools,
20
+ estimateSystem,
21
+ estimateSessionContext,
22
+ contentToText,
23
+ DEFAULT_CHARS_PER_TOKEN,
24
+ } from "./tokens.ts";
25
+ export type { BudgetPolicy, BudgetState, PressureLevel } from "./budget.ts";
26
+ export { defaultBudgetPolicy } from "./budget.ts";
27
+ export type { CompactionStrategy } from "./compact.ts";
28
+ export { mechanicalCompaction } from "./compact.ts";
29
+ export type { RecoveryPolicy } from "./recovery.ts";
30
+ export { defaultRecoveryPolicy, maxProviderRetries } from "./recovery.ts";
31
+ export type { AgentEvent, AgentEventType, EventBus, EventBusOptions } from "./events.ts";
32
+ export { createEventBus } from "./events.ts";
33
+ export { ContextStore } from "./history.ts";
34
+ export type { Session, SessionConfig, SessionState, TurnResult, Step, Execution } from "./session.ts";
35
+ export {
36
+ createSession,
37
+ DEFAULT_MAX_STEPS,
38
+ DEFAULT_CONTEXT_WINDOW_TOKENS,
39
+ DEFAULT_TOOL_RESULT_MAX_TOKENS,
40
+ DEFAULT_KEEP_RECENT_TURNS,
41
+ DEFAULT_TIMEOUT_MS,
42
42
  } from "./session.ts";