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.
- package/CHANGELOG.md +98 -0
- package/LICENSE +21 -21
- package/README.md +4 -4
- package/cli/args.ts +46 -0
- package/cli/commands/acp.ts +163 -10
- package/cli/commands/config.ts +33 -18
- package/cli/commands/daemon.ts +515 -0
- package/cli/commands/exec.ts +145 -53
- package/cli/commands/openwork.ts +986 -0
- package/cli/commands/sessions.ts +4 -1
- package/cli/commands/stats.ts +34 -4
- package/cli/commands.ts +217 -2
- package/cli/index.ts +146 -14
- package/cli/recovery-warning.ts +115 -0
- package/cli/router.ts +32 -1
- package/cli/setup.ts +2332 -171
- package/cli/tui.ts +113 -7
- package/docs/OUTPUT_ARCHITECTURE_AUDIT.md +489 -0
- package/docs/OUTPUT_EVENT_MODEL.md +289 -0
- package/docs/OUTPUT_IMPLEMENTATION_PLAN.md +391 -0
- package/docs/OUTPUT_PROTOCOL_SPEC.md +285 -0
- package/docs/OUTPUT_RENDERING_SPEC.md +248 -0
- package/docs/OUTPUT_UX_RULES.md +449 -0
- package/docs/PLAN_UIUX_V6.md +2 -2
- package/docs/README.md +4 -3
- package/docs/TERMINAL_CONTRACT.md +278 -66
- package/docs/architecture.md +89 -7
- package/docs/changelog.md +1 -1
- package/docs/choosing-mode.md +2 -2
- package/docs/cli.md +9 -5
- package/docs/concepts.md +1 -1
- package/docs/contributing.md +9 -2
- package/docs/environment.md +6 -2
- package/docs/exec.md +46 -5
- package/docs/memory-sessions.md +2 -0
- package/docs/policy-sandbox.md +1 -1
- package/docs/pricing-budget.md +1 -1
- package/docs/quickstart.md +2 -2
- package/docs/repl.md +6 -2
- package/docs/security-model.md +1 -1
- package/docs/security.md +1 -1
- package/docs/skills.md +2 -2
- package/docs/terminal.md +9 -5
- package/docs/tools.md +1 -1
- package/package.json +35 -5
- package/src/app/session.ts +261 -15
- package/src/app/tool-layer.ts +94 -7
- package/src/daemon/approvals.ts +361 -0
- package/src/daemon/capability.ts +145 -0
- package/src/daemon/children.ts +142 -0
- package/src/daemon/client.ts +267 -0
- package/src/daemon/control.ts +350 -0
- package/src/daemon/discovery.ts +234 -0
- package/src/daemon/feed.ts +155 -0
- package/src/daemon/framing.ts +94 -0
- package/src/daemon/host.ts +316 -0
- package/src/daemon/protocol.ts +217 -0
- package/src/daemon/resource.ts +170 -0
- package/src/daemon/sanitize.ts +57 -0
- package/src/daemon/server.ts +627 -0
- package/src/daemon/store.ts +317 -0
- package/src/daemon/subscription.ts +270 -0
- package/src/daemon/telemetry.ts +81 -0
- package/src/hooks/run.ts +12 -1
- package/src/lib/atomic-write.ts +29 -3
- package/src/lib/db-path.ts +26 -0
- package/src/lib/keystore.ts +544 -42
- package/src/lib/net.ts +43 -1
- package/src/lib/safe-open.ts +116 -1
- package/src/lib/session-id.ts +15 -0
- package/src/lsp/client.ts +123 -5
- package/src/mcp/client.ts +139 -17
- package/src/mcp/server.ts +177 -50
- package/src/mcp/transport.ts +16 -19
- package/src/memory/vector.ts +770 -55
- package/src/policy/allowlist.ts +14 -2
- package/src/policy/bash-guard.ts +105 -10
- package/src/policy/compaction.ts +82 -5
- package/src/policy/consequence-engine.ts +220 -0
- package/src/policy/context.ts +132 -0
- package/src/policy/executor.ts +187 -121
- package/src/policy/no-progress.ts +559 -0
- package/src/policy/permission.ts +4 -8
- package/src/policy/pricing.ts +17 -3
- package/src/policy/scrub.ts +69 -2
- package/src/policy/tool-contract.ts +515 -0
- package/src/policy/usage.ts +310 -24
- package/src/policy/verifier.ts +6 -3
- package/src/policy/work-mode.ts +182 -0
- package/src/presentation/adapter.ts +533 -26
- package/src/presentation/events.ts +151 -0
- package/src/presentation/model.ts +180 -27
- package/src/presentation/projection.ts +858 -0
- package/src/presentation/reducer.ts +645 -310
- package/src/presentation/store.ts +12 -7
- package/src/providers/anthropic.ts +18 -10
- package/src/providers/responses.ts +17 -7
- package/src/runtime/capability.ts +409 -0
- package/src/runtime/child-execution.ts +274 -0
- package/src/runtime/composition.ts +958 -0
- package/src/runtime/dispatch.ts +591 -0
- package/src/runtime/execution-backend.ts +632 -0
- package/src/runtime/execution-events.ts +272 -0
- package/src/runtime/execution-id.ts +230 -0
- package/src/runtime/execution-journal.ts +926 -0
- package/src/runtime/execution-kernel.ts +456 -0
- package/src/runtime/execution-registry.ts +379 -0
- package/src/runtime/process-supervision.ts +276 -0
- package/src/runtime/production-execution.ts +551 -0
- package/src/runtime/production-runtime.ts +217 -0
- package/src/runtime/recovery-safety.ts +70 -0
- package/src/runtime/recovery.ts +477 -0
- package/src/runtime/runtime-capabilities.ts +179 -0
- package/src/runtime/runtime-diagnostics.ts +141 -0
- package/src/runtime/runtime-host.ts +365 -0
- package/src/runtime/runtime-status-facts.ts +222 -0
- package/src/runtime/runtime-status-provider.ts +74 -0
- package/src/runtime/runtime-status.ts +459 -0
- package/src/runtime/runtime-task-admission.ts +101 -0
- package/src/runtime/supervisor.ts +444 -0
- package/src/session/authority.ts +168 -0
- package/src/session/checkpoint.ts +88 -1
- package/src/session/context-adapter.ts +251 -0
- package/src/session/context-assembly.ts +242 -0
- package/src/session/context-identity.ts +389 -0
- package/src/session/context-projection.ts +248 -0
- package/src/session/context-selector.ts +500 -0
- package/src/session/cross-session-adoption.ts +249 -0
- package/src/session/full-history-fold.ts +171 -0
- package/src/session/identity.ts +192 -0
- package/src/session/journal.ts +805 -102
- package/src/session/open-work-intent.ts +732 -0
- package/src/session/open-work.ts +767 -0
- package/src/session/pending-tools.ts +94 -0
- package/src/session/persistence.ts +3569 -127
- package/src/session/runtime-header.ts +208 -0
- package/src/session/shadow-git.ts +13 -5
- package/src/session/verification.ts +1623 -0
- package/src/task/assignment.ts +136 -0
- package/src/task/autonomous-adapter.ts +168 -0
- package/src/task/autonomous-context.ts +630 -0
- package/src/task/autonomous-policy.ts +490 -0
- package/src/task/continuity.ts +179 -0
- package/src/task/execution-cancellation.ts +165 -0
- package/src/task/graph-validate.ts +379 -0
- package/src/task/graph.ts +305 -0
- package/src/task/identity.ts +230 -0
- package/src/task/model.ts +417 -0
- package/src/task/production-scheduler.ts +293 -0
- package/src/task/readiness.ts +229 -0
- package/src/task/scheduler-observability.ts +387 -0
- package/src/task/scheduler.ts +1197 -0
- package/src/task/scheduling-policy.ts +165 -0
- package/src/task/session-authority.ts +148 -0
- package/src/task/session-ownership.ts +211 -0
- package/src/task/store.ts +2887 -0
- package/src/task/sync.ts +343 -0
- package/src/task/trigger.ts +260 -0
- package/src/tools/bash.ts +377 -211
- package/src/tools/code_run.ts +1 -1
- package/src/tools/delete_file.ts +1 -1
- package/src/tools/edit.ts +33 -6
- package/src/tools/evidence.ts +30 -0
- package/src/tools/git.ts +4 -4
- package/src/tools/glob.ts +12 -3
- package/src/tools/grep.ts +1 -1
- package/src/tools/lsp.ts +4 -4
- package/src/tools/mcp_call.ts +11 -4
- package/src/tools/memory.ts +153 -18
- package/src/tools/move_file.ts +1 -1
- package/src/tools/patch.ts +1 -1
- package/src/tools/read_file.ts +1 -1
- package/src/tools/read_image.ts +1 -1
- package/src/tools/submit_result.ts +1 -1
- package/src/tools/task.ts +437 -41
- package/src/tools/todo.ts +662 -35
- package/src/tools/web_fetch.ts +4 -2
- package/src/tools/web_search.ts +9 -3
- package/src/tools/write_file.ts +1 -1
- package/src/ui/assistant/simple.ts +123 -50
- package/src/ui/assistant/turn-status.ts +17 -3
- package/src/ui/contract.ts +184 -0
- package/src/ui/footer.ts +54 -18
- package/src/ui/i18n/en.ts +62 -6
- package/src/ui/i18n/id.ts +62 -6
- package/src/ui/input/prompt-engine.ts +120 -25
- package/src/ui/render/errors.ts +39 -1
- package/src/ui/render/markdown-table.ts +455 -0
- package/src/ui/render/markdown.ts +22 -1
- package/src/ui/render/table-grid.ts +184 -0
- package/src/ui/render/table.ts +15 -76
- package/src/ui/runtime/screen.ts +7 -2
- package/src/ui/runtime/statusline.ts +25 -6
- package/src/ui/tui/app.ts +598 -133
- package/src/ui/tui/transcript.ts +531 -89
- package/vendor/minicore/VENDOR.md +1 -1
- package/vendor/minicore/src/core/budget.ts +25 -25
- package/vendor/minicore/src/core/compact.ts +75 -75
- package/vendor/minicore/src/core/errors.ts +59 -59
- package/vendor/minicore/src/core/events.ts +73 -73
- package/vendor/minicore/src/core/executor.ts +139 -139
- package/vendor/minicore/src/core/history.ts +31 -31
- package/vendor/minicore/src/core/index.ts +41 -41
- package/vendor/minicore/src/core/loop.ts +355 -355
- package/vendor/minicore/src/core/permission.ts +22 -22
- package/vendor/minicore/src/core/provider.ts +39 -39
- package/vendor/minicore/src/core/recovery.ts +35 -35
- package/vendor/minicore/src/core/session.ts +327 -327
- package/vendor/minicore/src/core/snapshot.ts +146 -146
- package/vendor/minicore/src/core/tokens.ts +107 -107
- package/vendor/minicore/src/core/tool.ts +115 -115
- package/vendor/minicore/src/core/types.ts +50 -50
- package/vendor/minicore/src/providers/openai-compat.ts +417 -417
- package/AGENTS.md +0 -45
- package/PLAN.md +0 -491
- package/docs/ARCHITECTURE.html +0 -1248
- package/docs/CONTROL-PLANE-MAP.md +0 -139
- package/docs/HARNESS.md +0 -150
- package/docs/SUMMARY.md +0 -52
- package/docs/UI_RENDER_PIPELINE.md +0 -165
- 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;
|