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,116 +1,116 @@
1
- // Tool abstraction: declarative schemas + deterministic argument validation.
2
-
3
- import type { AgentEvent } from "./events.ts";
4
- import type { SessionState } from "./session.ts";
5
-
6
- export interface JSONSchema {
7
- readonly type?: "object" | "string" | "number" | "integer" | "boolean" | "array" | "null";
8
- readonly description?: string;
9
- readonly properties?: Readonly<Record<string, JSONSchema>>;
10
- readonly required?: readonly string[];
11
- readonly items?: JSONSchema;
12
- readonly enum?: readonly unknown[];
13
- readonly additionalProperties?: boolean;
14
- }
15
-
16
- export interface ToolSchema {
17
- readonly name: string;
18
- readonly description: string;
19
- readonly parameters: JSONSchema;
20
- }
21
-
22
- export interface ToolContext {
23
- readonly signal: AbortSignal;
24
- readonly state: Readonly<SessionState>;
25
- readonly cwd?: string;
26
- /**
27
- * Session permission mode at dispatch time (e.g. "auto" | "plan").
28
- * Optional for backward compatibility; tools that adapt to read-only
29
- * sessions read this instead of guessing from prompt text. Resolved per
30
- * turn from SessionConfig (plain string or live getter).
31
- */
32
- readonly permissionMode?: string;
33
- emit(event: AgentEvent): void;
34
- }
35
-
36
- export interface Tool<P = unknown> extends ToolSchema {
37
- execute(input: P, ctx: ToolContext): Promise<unknown>;
38
- }
39
-
40
- export type ArgsResult<A = unknown> = { ok: true; value: A } | { ok: false; message: string };
41
-
42
- const error = (message: string): { ok: false; message: string } => ({ ok: false, message });
43
-
44
- // Assignment via `out[key] = value` would treat "__proto__" as a setter and
45
- // swap the result object's prototype (prototype pollution). defineProperty
46
- // always creates an own property instead.
47
- function setOwn(out: Record<string, unknown>, key: string, value: unknown): void {
48
- Object.defineProperty(out, key, { value, enumerable: true, writable: true, configurable: true });
49
- }
50
-
51
- /** Deterministically validate `args` against a JSON schema (kernel built-in). */
52
- export function validateArgs<A = unknown>(schema: JSONSchema, args: unknown): ArgsResult<A> {
53
- if (schema.properties || schema.type === "object") {
54
- if (typeof args !== "object" || args === null || Array.isArray(args)) return error("expected an object");
55
- const record = args as Record<string, unknown>;
56
- const out: Record<string, unknown> = {};
57
- for (const key of schema.required ?? []) {
58
- if (!(key in record)) return error(`missing required property: ${key}`);
59
- }
60
- for (const [key, value] of Object.entries(record)) {
61
- const sub = schema.properties?.[key];
62
- if (sub) {
63
- const result = validateArgs(sub, value);
64
- if (!result.ok) return error(`${key}: ${result.message}`);
65
- setOwn(out, key, result.value);
66
- } else if (schema.additionalProperties === false) {
67
- return error(`unknown property: ${key}`);
68
- } else {
69
- setOwn(out, key, value);
70
- }
71
- }
72
- return { ok: true, value: out as A };
73
- }
74
- if (schema.enum) {
75
- if (!schema.enum.some((v) => Object.is(v, args))) return error("value not allowed");
76
- return { ok: true, value: args as A };
77
- }
78
- switch (schema.type) {
79
- case "string":
80
- return typeof args === "string" ? { ok: true, value: args as A } : error("expected string");
81
- case "number":
82
- return typeof args === "number" && Number.isFinite(args) ? { ok: true, value: args as A } : error("expected number");
83
- case "integer":
84
- return typeof args === "number" && Number.isInteger(args) ? { ok: true, value: args as A } : error("expected integer");
85
- case "boolean":
86
- return typeof args === "boolean" ? { ok: true, value: args as A } : error("expected boolean");
87
- case "null":
88
- return args === null ? { ok: true, value: args as A } : error("expected null");
89
- case "array": {
90
- if (!Array.isArray(args)) return error("expected an array");
91
- if (!schema.items) return { ok: true, value: args as A };
92
- const out: unknown[] = [];
93
- for (const item of args) {
94
- const result = validateArgs(schema.items, item);
95
- if (!result.ok) return error(result.message);
96
- out.push(result.value);
97
- }
98
- return { ok: true, value: out as A };
99
- }
100
- default:
101
- return { ok: true, value: args as A };
102
- }
103
- }
104
-
105
- export interface ToolRegistry {
106
- get(name: string): Tool | undefined;
107
- list(): readonly Tool[];
108
- }
109
-
110
- export function createToolRegistry(tools: readonly Tool[]): ToolRegistry {
111
- const map = new Map<string, Tool>(tools.map((tool) => [tool.name, tool]));
112
- return {
113
- get: (name) => map.get(name),
114
- list: () => tools,
115
- };
1
+ // Tool abstraction: declarative schemas + deterministic argument validation.
2
+
3
+ import type { AgentEvent } from "./events.ts";
4
+ import type { SessionState } from "./session.ts";
5
+
6
+ export interface JSONSchema {
7
+ readonly type?: "object" | "string" | "number" | "integer" | "boolean" | "array" | "null";
8
+ readonly description?: string;
9
+ readonly properties?: Readonly<Record<string, JSONSchema>>;
10
+ readonly required?: readonly string[];
11
+ readonly items?: JSONSchema;
12
+ readonly enum?: readonly unknown[];
13
+ readonly additionalProperties?: boolean;
14
+ }
15
+
16
+ export interface ToolSchema {
17
+ readonly name: string;
18
+ readonly description: string;
19
+ readonly parameters: JSONSchema;
20
+ }
21
+
22
+ export interface ToolContext {
23
+ readonly signal: AbortSignal;
24
+ readonly state: Readonly<SessionState>;
25
+ readonly cwd?: string;
26
+ /**
27
+ * Session permission mode at dispatch time (e.g. "auto" | "plan").
28
+ * Optional for backward compatibility; tools that adapt to read-only
29
+ * sessions read this instead of guessing from prompt text. Resolved per
30
+ * turn from SessionConfig (plain string or live getter).
31
+ */
32
+ readonly permissionMode?: string;
33
+ emit(event: AgentEvent): void;
34
+ }
35
+
36
+ export interface Tool<P = unknown> extends ToolSchema {
37
+ execute(input: P, ctx: ToolContext): Promise<unknown>;
38
+ }
39
+
40
+ export type ArgsResult<A = unknown> = { ok: true; value: A } | { ok: false; message: string };
41
+
42
+ const error = (message: string): { ok: false; message: string } => ({ ok: false, message });
43
+
44
+ // Assignment via `out[key] = value` would treat "__proto__" as a setter and
45
+ // swap the result object's prototype (prototype pollution). defineProperty
46
+ // always creates an own property instead.
47
+ function setOwn(out: Record<string, unknown>, key: string, value: unknown): void {
48
+ Object.defineProperty(out, key, { value, enumerable: true, writable: true, configurable: true });
49
+ }
50
+
51
+ /** Deterministically validate `args` against a JSON schema (kernel built-in). */
52
+ export function validateArgs<A = unknown>(schema: JSONSchema, args: unknown): ArgsResult<A> {
53
+ if (schema.properties || schema.type === "object") {
54
+ if (typeof args !== "object" || args === null || Array.isArray(args)) return error("expected an object");
55
+ const record = args as Record<string, unknown>;
56
+ const out: Record<string, unknown> = {};
57
+ for (const key of schema.required ?? []) {
58
+ if (!(key in record)) return error(`missing required property: ${key}`);
59
+ }
60
+ for (const [key, value] of Object.entries(record)) {
61
+ const sub = schema.properties?.[key];
62
+ if (sub) {
63
+ const result = validateArgs(sub, value);
64
+ if (!result.ok) return error(`${key}: ${result.message}`);
65
+ setOwn(out, key, result.value);
66
+ } else if (schema.additionalProperties === false) {
67
+ return error(`unknown property: ${key}`);
68
+ } else {
69
+ setOwn(out, key, value);
70
+ }
71
+ }
72
+ return { ok: true, value: out as A };
73
+ }
74
+ if (schema.enum) {
75
+ if (!schema.enum.some((v) => Object.is(v, args))) return error("value not allowed");
76
+ return { ok: true, value: args as A };
77
+ }
78
+ switch (schema.type) {
79
+ case "string":
80
+ return typeof args === "string" ? { ok: true, value: args as A } : error("expected string");
81
+ case "number":
82
+ return typeof args === "number" && Number.isFinite(args) ? { ok: true, value: args as A } : error("expected number");
83
+ case "integer":
84
+ return typeof args === "number" && Number.isInteger(args) ? { ok: true, value: args as A } : error("expected integer");
85
+ case "boolean":
86
+ return typeof args === "boolean" ? { ok: true, value: args as A } : error("expected boolean");
87
+ case "null":
88
+ return args === null ? { ok: true, value: args as A } : error("expected null");
89
+ case "array": {
90
+ if (!Array.isArray(args)) return error("expected an array");
91
+ if (!schema.items) return { ok: true, value: args as A };
92
+ const out: unknown[] = [];
93
+ for (const item of args) {
94
+ const result = validateArgs(schema.items, item);
95
+ if (!result.ok) return error(result.message);
96
+ out.push(result.value);
97
+ }
98
+ return { ok: true, value: out as A };
99
+ }
100
+ default:
101
+ return { ok: true, value: args as A };
102
+ }
103
+ }
104
+
105
+ export interface ToolRegistry {
106
+ get(name: string): Tool | undefined;
107
+ list(): readonly Tool[];
108
+ }
109
+
110
+ export function createToolRegistry(tools: readonly Tool[]): ToolRegistry {
111
+ const map = new Map<string, Tool>(tools.map((tool) => [tool.name, tool]));
112
+ return {
113
+ get: (name) => map.get(name),
114
+ list: () => tools,
115
+ };
116
116
  }
@@ -1,50 +1,50 @@
1
- // Universal message & call records. No imports; the kernel's leaf type layer.
2
- // These are the records that flow between the runtime, its context store, and
3
- // provider adapters — never wire-specific shapes.
4
-
5
- /** A single content part: plain text or inline image bytes. */
6
- export type ContentPart =
7
- | { type: "text"; text: string }
8
- | { type: "image"; data: Uint8Array; mime: string };
9
-
10
- /** Message content: a plain string or an ordered list of parts. */
11
- export type Content = string | readonly ContentPart[];
12
-
13
- /** A model-requested tool invocation, dispatched by the executor. */
14
- export interface ToolCall {
15
- readonly id: string;
16
- readonly name: string;
17
- readonly args: unknown;
18
- }
19
-
20
- /**
21
- * The observation produced by executing a tool call. `isError: true` marks a
22
- * failed execution (unknown tool, denied permission, invalid args, or a thrown
23
- * tool error); the loop treats it as a normal observation, never a kernel
24
- * failure.
25
- */
26
- export interface ToolResult {
27
- readonly role: "tool";
28
- readonly toolCallId: string;
29
- readonly name: string;
30
- readonly content: unknown;
31
- readonly isError?: boolean;
32
- }
33
-
34
- /** A user turn. The first message of every run is appended by the kernel. */
35
- export interface UserMessage {
36
- readonly role: "user";
37
- readonly content: Content;
38
- }
39
-
40
- /** A model turn: text output, optionally carrying tool calls to dispatch. */
41
- export interface AssistantMessage {
42
- readonly role: "assistant";
43
- readonly content: Content;
44
- readonly toolCalls?: readonly ToolCall[];
45
- /** DeepSeek-style thinking content (reasoning), di-preservasi untuk multi-turn. */
46
- readonly reasoning?: string;
47
- }
48
-
49
- /** Everything the context store can hold, discriminated by `role`. */
50
- export type Message = UserMessage | AssistantMessage | ToolResult;
1
+ // Universal message & call records. No imports; the kernel's leaf type layer.
2
+ // These are the records that flow between the runtime, its context store, and
3
+ // provider adapters — never wire-specific shapes.
4
+
5
+ /** A single content part: plain text or inline image bytes. */
6
+ export type ContentPart =
7
+ | { type: "text"; text: string }
8
+ | { type: "image"; data: Uint8Array; mime: string };
9
+
10
+ /** Message content: a plain string or an ordered list of parts. */
11
+ export type Content = string | readonly ContentPart[];
12
+
13
+ /** A model-requested tool invocation, dispatched by the executor. */
14
+ export interface ToolCall {
15
+ readonly id: string;
16
+ readonly name: string;
17
+ readonly args: unknown;
18
+ }
19
+
20
+ /**
21
+ * The observation produced by executing a tool call. `isError: true` marks a
22
+ * failed execution (unknown tool, denied permission, invalid args, or a thrown
23
+ * tool error); the loop treats it as a normal observation, never a kernel
24
+ * failure.
25
+ */
26
+ export interface ToolResult {
27
+ readonly role: "tool";
28
+ readonly toolCallId: string;
29
+ readonly name: string;
30
+ readonly content: unknown;
31
+ readonly isError?: boolean;
32
+ }
33
+
34
+ /** A user turn. The first message of every run is appended by the kernel. */
35
+ export interface UserMessage {
36
+ readonly role: "user";
37
+ readonly content: Content;
38
+ }
39
+
40
+ /** A model turn: text output, optionally carrying tool calls to dispatch. */
41
+ export interface AssistantMessage {
42
+ readonly role: "assistant";
43
+ readonly content: Content;
44
+ readonly toolCalls?: readonly ToolCall[];
45
+ /** DeepSeek-style thinking content (reasoning), di-preservasi untuk multi-turn. */
46
+ readonly reasoning?: string;
47
+ }
48
+
49
+ /** Everything the context store can hold, discriminated by `role`. */
50
+ export type Message = UserMessage | AssistantMessage | ToolResult;