@corenel/harness 0.1.0

package/dist/todos.d.ts

@@ -0,0 +1,34 @@
+export type TodoStatus = 'pending' | 'in_progress' | 'completed' | 'blocked';
+export interface TodoActivity {
+    id: string;
+    label: string;
+    detail?: string;
+    isError?: boolean;
+    done?: boolean;
+}
+export interface AgentTodo {
+    id: string;
+    title: string;
+    status: TodoStatus;
+    note?: string;
+    /** Task ids this one waits on. */
+    blockedBy?: string[];
+    /** Parent task id for a one-level subtask. */
+    parentId?: string;
+    /** Tool calls / notes recorded while this task was active. */
+    activity: TodoActivity[];
+}
+export declare function getTodos(): AgentTodo[];
+export declare function clearTodos(): void;
+export type TodoView = 'timeline' | 'board';
+export declare function getTodoView(): TodoView;
+export declare function setTodoView(v: TodoView): void;
+/** Replace the list from a todo_write tool call. Activity accumulated for a task
+ * (matched by id) is preserved across rewrites. */
+export declare function applyTodoWrite(input: unknown): void;
+/** Record a tool call under the active (in_progress) task. */
+export declare function addActivity(activityId: string, label: string): void;
+/** Resolve a recorded tool call (its result arrived). */
+export declare function resolveActivity(activityId: string, isError?: boolean, detail?: string): void;
+export declare function useTodos(): AgentTodo[];
+//# sourceMappingURL=todos.d.ts.map

package/dist/todos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todos.d.ts","sourceRoot":"","sources":["../todos.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,YAAY;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE;AAE/G,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAcD,wBAAgB,QAAQ,IAAI,SAAS,EAAE,CAAkB;AACzD,wBAAgB,UAAU,IAAI,IAAI,CAA8C;AAGhF,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAE5C,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AACD,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAE7C;AAUD;mDACmD;AACnD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAoBnD;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQnE;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ5F;AAED,wBAAgB,QAAQ,IAAI,SAAS,EAAE,CAMtC"}

package/dist/todos.js

@@ -0,0 +1,112 @@
+/* Agent todos: the task list the assistant maintains during a multi-step job,
+ * shown as a vertical timeline (see ui/TodoTimeline). A reactive module store so
+ * the dock panel can render it as a sibling of the assistant.
+ *
+ * Source of truth flow: the worker's `todo_write` tool call surfaces its args via
+ * the `tool-call` event; AgentPanel applies them here. Other tool calls made
+ * while a task is `in_progress` are bucketed under it as "activity", so expanding
+ * a node shows what the agent actually did for that task. */
+import { useSyncExternalStore } from 'react';
+const LS = 'prompd.web.todos.v1';
+function load() {
+    try {
+        const r = localStorage.getItem(LS);
+        const a = r ? JSON.parse(r) : [];
+        return Array.isArray(a) ? a : [];
+    }
+    catch {
+        return [];
+    }
+}
+function persist() {
+    try {
+        localStorage.setItem(LS, JSON.stringify(todos));
+    }
+    catch { /* ignore quota */ }
+}
+let todos = load();
+const subs = new Set();
+const emit = () => { persist(); for (const s of subs)
+    s(); };
+export function getTodos() { return todos; }
+export function clearTodos() { if (todos.length) {
+    todos = [];
+    emit();
+} }
+const VIEW_LS = 'prompd.web.todoView';
+export function getTodoView() {
+    try {
+        const v = localStorage.getItem(VIEW_LS);
+        return v === 'board' ? 'board' : 'timeline';
+    }
+    catch {
+        return 'timeline';
+    }
+}
+export function setTodoView(v) {
+    try {
+        localStorage.setItem(VIEW_LS, v);
+    }
+    catch { /* ignore */ }
+}
+function normalizeStatus(s) {
+    const v = String(s ?? 'pending').toLowerCase();
+    if (v === 'in_progress' || v === 'active' || v === 'doing' || v === 'in-progress')
+        return 'in_progress';
+    if (v === 'completed' || v === 'done' || v === 'complete')
+        return 'completed';
+    if (v === 'blocked' || v === 'waiting')
+        return 'blocked';
+    return 'pending';
+}
+/** Replace the list from a todo_write tool call. Activity accumulated for a task
+ * (matched by id) is preserved across rewrites. */
+export function applyTodoWrite(input) {
+    const raw = (input && typeof input === 'object' && Array.isArray(input.todos))
+        ? input.todos
+        : Array.isArray(input) ? input : [];
+    const prev = new Map(todos.map((t) => [t.id, t]));
+    todos = raw
+        .filter((t) => t && t.title)
+        .map((t, i) => {
+        const id = String(t.id ?? `todo-${i + 1}`);
+        return {
+            id,
+            title: String(t.title),
+            status: normalizeStatus(t.status),
+            note: t.note ? String(t.note) : undefined,
+            blockedBy: Array.isArray(t.blockedBy) ? t.blockedBy.map(String) : undefined,
+            parentId: t.parentId ? String(t.parentId) : undefined,
+            activity: prev.get(id)?.activity ?? [],
+        };
+    });
+    emit();
+}
+/** Record a tool call under the active (in_progress) task. */
+export function addActivity(activityId, label) {
+    let done = false;
+    todos = todos.map((t) => {
+        if (done || t.status !== 'in_progress')
+            return t;
+        done = true;
+        return { ...t, activity: [...t.activity, { id: activityId, label }] };
+    });
+    if (done)
+        emit();
+}
+/** Resolve a recorded tool call (its result arrived). */
+export function resolveActivity(activityId, isError, detail) {
+    let changed = false;
+    todos = todos.map((t) => {
+        if (!t.activity.some((a) => a.id === activityId))
+            return t;
+        changed = true;
+        return { ...t, activity: t.activity.map((a) => (a.id === activityId ? { ...a, isError, detail, done: true } : a)) };
+    });
+    if (changed)
+        emit();
+}
+export function useTodos() {
+    return useSyncExternalStore((cb) => { subs.add(cb); return () => { subs.delete(cb); }; }, getTodos, getTodos);
+}
+//# sourceMappingURL=todos.js.map

package/dist/todos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todos.js","sourceRoot":"","sources":["../todos.ts"],"names":[],"mappings":"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"}

package/dist/tools/builtins.d.ts

@@ -0,0 +1,20 @@
+import type { AgentTool } from '@corenel/protocol';
+export declare const proposeEditTool: AgentTool;
+export declare const saveMemoryTool: AgentTool;
+export declare const recallMemoryTool: AgentTool;
+export declare const kvGetTool: AgentTool;
+export declare const kvSetTool: AgentTool;
+export declare const recallResultTool: AgentTool;
+export declare const askUserTool: AgentTool;
+export declare const spawnAgentTool: AgentTool;
+export declare const spawnAgentsTool: AgentTool;
+export declare const compilePrompdTool: AgentTool;
+/** The kernel's runtime-agnostic built-in tools. Product/host tools (registry
+ * search) are added by the registry — use `allTools()` for the complete set. */
+export declare const defaultTools: AgentTool[];
+/** The full tool set the model is offered: kernel built-ins + everything the
+ * host registered (compile_prompd, search_packages, a bridge's tools, …).
+ * Read this LAZILY at the point of use — never cache it at module top level —
+ * so tools registered after a consumer loaded still appear. */
+export declare function allTools(): AgentTool[];
+//# sourceMappingURL=builtins.d.ts.map

package/dist/tools/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../tools/builtins.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,mBAAmB,CAAC;AAahE,eAAO,MAAM,eAAe,EAAE,SA0C7B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,SAoB5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,SAa9B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,SAWvB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,SAkBvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,SAgB9B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,SAiDzB,CAAC;AAiBF,eAAO,MAAM,cAAc,EAAE,SA6B5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,SA6C7B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,SAgC/B,CAAC;AAEF;gFACgF;AAChF,eAAO,MAAM,YAAY,EAAE,SAAS,EAenC,CAAC;AAEF;;;+DAG+D;AAC/D,wBAAgB,QAAQ,IAAI,SAAS,EAAE,CAEtC"}

package/dist/tools/builtins.js

@@ -0,0 +1,335 @@
+import { extensionTools } from './registry';
+import { fileTools } from './files';
+import { webSearchTool } from './web';
+import { todoWriteTool } from './todo';
+import { searchSessionsTool } from './sessions';
+import { compilePrompt } from '../promptCompiler';
+function str(args, key) {
+    const v = args[key];
+    return typeof v === 'string' ? v : v == null ? '' : String(v);
+}
+export const proposeEditTool = {
+    name: 'propose_edit',
+    description: 'Propose a replacement for the current editor file. The user reviews a diff and applies or rejects it — ' +
+        'this does NOT write the file directly. Provide the COMPLETE new file content (not a patch) plus a short ' +
+        'explanation. Use the editor file shown in the system context as the basis. This call WAITS for the review ' +
+        'and returns the outcome: applied, partially applied (with the rejected changes), or rejected — rely on ' +
+        'that outcome, not on the proposal, for any follow-up work.',
+    parameters: {
+        type: 'object',
+        properties: {
+            explanation: { type: 'string', description: 'One line describing the change.' },
+            new_content: { type: 'string', description: 'The full proposed file content.' },
+        },
+        required: ['explanation', 'new_content'],
+    },
+    async run(args, ctx) {
+        const explanation = str(args, 'explanation') || 'Proposed an edit';
+        // The diff + apply happen on the main thread (the panel renders the proposal
+        // from this tool call). Block until the user decides so later turns can rely
+        // on the outcome. Without a reviewer (sub-agents, DAG nodes, headless runs)
+        // degrade to the old non-blocking acknowledgment.
+        if (!ctx.reviewEdit || !ctx.callId) {
+            return `Proposed an edit: ${explanation}. Awaiting the user's review (apply/reject).`;
+        }
+        const outcome = ctx.signal.aborted ? null : await Promise.race([
+            ctx.reviewEdit(ctx.callId),
+            new Promise((resolve) => ctx.signal.addEventListener('abort', () => resolve(null), { once: true })),
+        ]);
+        if (!outcome)
+            return 'The run ended before the user reviewed this proposal. Do NOT assume the edit was applied.';
+        if (outcome.decision === 'applied') {
+            return 'The user APPLIED this edit. The editor file now matches the proposal.';
+        }
+        if (outcome.decision === 'partial') {
+            return ('The user PARTIALLY applied this edit. The following proposed changes were REJECTED and are NOT in the file:\n' +
+                `${outcome.note || '(rejected changes not captured)'}\n` +
+                'Respect the rejection — do not re-propose those changes unless the user asks.');
+        }
+        return 'The user REJECTED this edit. The file is UNCHANGED. Do not build on this proposal — adjust your approach or ask what to change.';
+    },
+};
+export const saveMemoryTool = {
+    name: 'save_memory',
+    mutates: true,
+    description: 'Persist a durable note to memory for later recall (facts, user preferences, decisions).',
+    parameters: {
+        type: 'object',
+        properties: {
+            text: { type: 'string', description: 'The note to remember.' },
+            tags: { type: 'array', items: { type: 'string' }, description: 'Optional tags.' },
+        },
+        required: ['text'],
+    },
+    // Permission is gated centrally by the loop's policy/permission layer (this
+    // tool is `mutates`), so no confirm call here.
+    async run(args, ctx) {
+        const text = str(args, 'text');
+        const tags = Array.isArray(args.tags) ? args.tags.map(String) : [];
+        const item = await ctx.memory.save(text, tags);
+        return `Saved memory ${item.id}.`;
+    },
+};
+export const recallMemoryTool = {
+    name: 'recall_memory',
+    description: 'Search memory for previously saved notes relevant to a query.',
+    parameters: {
+        type: 'object',
+        properties: { query: { type: 'string', description: 'What to recall.' } },
+        required: ['query'],
+    },
+    async run(args, ctx) {
+        const items = await ctx.memory.recall(str(args, 'query'), 5);
+        if (!items.length)
+            return 'No relevant memories.';
+        return items.map((m) => `- ${m.text}${m.tags.length ? ` [${m.tags.join(', ')}]` : ''}`).join('\n');
+    },
+};
+export const kvGetTool = {
+    name: 'kv_get',
+    description: 'Read a value you previously saved with kv_set, by key, from the local key/value store. ' +
+        'This is a general note store — NOT a filesystem, working directory, or settings: ' +
+        'use list_files/read_file for files.',
+    parameters: { type: 'object', properties: { key: { type: 'string' } }, required: ['key'] },
+    async run(args, ctx) {
+        const v = await ctx.kv.get(str(args, 'key'));
+        return v == null ? '(not set)' : v;
+    },
+};
+export const kvSetTool = {
+    name: 'kv_set',
+    mutates: true,
+    description: 'Save an arbitrary value under a key in the local key/value store, to recall later with kv_get. ' +
+        'This is a general note store — NOT a filesystem or working directory; it does NOT change where files are read/written. ' +
+        'Use write_file/create_file for files.',
+    parameters: {
+        type: 'object',
+        properties: { key: { type: 'string' }, value: { type: 'string' } },
+        required: ['key', 'value'],
+    },
+    // Permission is gated centrally by the loop's policy/permission layer.
+    async run(args, ctx) {
+        const key = str(args, 'key');
+        await ctx.kv.set(key, str(args, 'value'));
+        return `Set ${key}.`;
+    },
+};
+export const recallResultTool = {
+    name: 'recall_result',
+    noOffload: true, // recalling a large result must never re-offload itself
+    description: 'Fetch the full content of a tool result that was offloaded to save context. ' +
+        'You saw an "[offloaded tool result … recall_result({ id })]" reference — pass that id.',
+    parameters: {
+        type: 'object',
+        properties: { id: { type: 'string', description: 'The offloaded result id, e.g. "art-ab12-1".' } },
+        required: ['id'],
+    },
+    async run(args, ctx) {
+        const id = str(args, 'id');
+        const full = ctx.recall ? await ctx.recall.read(id) : null;
+        return full ?? `No offloaded result found with id "${id}".`;
+    },
+};
+export const askUserTool = {
+    name: 'ask_user',
+    noOffload: true,
+    description: 'Ask the user one or more questions when you need a decision you cannot make from context — to choose ' +
+        'between approaches, get a missing requirement, or confirm direction. Prefer this over guessing. Give each ' +
+        'question a short `header` (a chip label), the `question` text, and 2–4 distinct `options` (each with a ' +
+        'label and an optional one-line description of the trade-off). Set `multiSelect: true` when more than one ' +
+        'option may apply. The user can also type a custom answer. Returns the chosen answers per question.',
+    parameters: {
+        type: 'object',
+        properties: {
+            questions: {
+                type: 'array',
+                description: '1–4 questions to ask together.',
+                items: {
+                    type: 'object',
+                    properties: {
+                        header: { type: 'string', description: 'Very short label (≤ ~12 chars) shown as a chip.' },
+                        question: { type: 'string', description: 'The full question.' },
+                        multiSelect: { type: 'boolean', description: 'Allow choosing more than one option.' },
+                        options: {
+                            type: 'array',
+                            description: '2–4 distinct options.',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    label: { type: 'string', description: 'Concise choice text (1–5 words).' },
+                                    description: { type: 'string', description: 'Optional one-line explanation of the trade-off.' },
+                                },
+                                required: ['label'],
+                            },
+                        },
+                    },
+                    required: ['header', 'question', 'options'],
+                },
+            },
+        },
+        required: ['questions'],
+    },
+    async run(args, ctx) {
+        if (!ctx.ask)
+            return 'ask_user is unavailable in this environment.';
+        const questions = Array.isArray(args.questions) ? args.questions : [];
+        if (!questions.length)
+            return 'No questions were provided.';
+        const answers = await ctx.ask(questions);
+        if (!answers)
+            return 'The user dismissed the questions without answering.';
+        const lines = Object.entries(answers).map(([h, vals]) => `${h}: ${vals.length ? vals.join(', ') : '(no answer)'}`);
+        return `The user answered:\n${lines.join('\n')}`;
+    },
+};
+/** Parse one {task, tools?, model?} spec from loosely-typed tool args. */
+function spawnReq(o) {
+    const task = typeof o.task === 'string' ? o.task.trim() : '';
+    if (!task)
+        return null;
+    const tools = Array.isArray(o.tools) ? o.tools.filter((t) => typeof t === 'string') : undefined;
+    const model = typeof o.model === 'string' && o.model ? o.model : undefined;
+    return { task, tools, model };
+}
+/** Compact footer summarizing a sub-agent's cost, appended to its result. */
+function spawnFooter(r) {
+    const tokens = r.usage.promptTokens + r.usage.completionTokens;
+    return `\n\n[sub-agent: ${r.turns} turn(s), ~${tokens} tokens, ${r.stopReason}]`;
+}
+export const spawnAgentTool = {
+    name: 'spawn_agent',
+    noOffload: true, // the sub-agent's summary is the answer; offload happens inside it
+    description: 'Delegate a focused, self-contained subtask to a fresh sub-agent that runs with its OWN context window and ' +
+        'returns only its final summary. Use this to isolate a large exploration (lots of file reads or searches) ' +
+        'from this conversation, or to run a well-scoped research/compile task without bloating your own context. ' +
+        'The sub-agent does NOT see this conversation — put everything it needs in `task`. By default it gets a ' +
+        'read-only tool set (read/search files, compile, web/registry search); pass `tools` to grant specific tools.',
+    parameters: {
+        type: 'object',
+        properties: {
+            task: { type: 'string', description: 'The complete, self-contained instruction for the sub-agent.' },
+            tools: { type: 'array', items: { type: 'string' }, description: 'Optional tool-name allowlist (defaults to a read-only set).' },
+            model: { type: 'string', description: 'Optional model override (defaults to the current model).' },
+        },
+        required: ['task'],
+    },
+    async run(args, ctx) {
+        if (!ctx.spawn)
+            return 'Sub-agents are not available here (depth limit reached or unsupported context).';
+        const req = spawnReq(args);
+        if (!req)
+            return 'Error: a non-empty `task` is required.';
+        try {
+            const r = await ctx.spawn(req);
+            return `${r.text}${spawnFooter(r)}`;
+        }
+        catch (e) {
+            return `Error: ${String(e?.message || e)}`;
+        }
+    },
+};
+export const spawnAgentsTool = {
+    name: 'spawn_agents',
+    noOffload: true,
+    description: 'Run several sub-agents IN PARALLEL, each on its own self-contained task, and get back a numbered digest of ' +
+        'their results. Use this to fan out independent work (e.g. research several topics at once) — far faster than ' +
+        'calling spawn_agent sequentially. Each task is isolated (no shared context); put everything each needs in its ' +
+        '`task`. Same per-task defaults as spawn_agent (read-only tools unless `tools` is given).',
+    parameters: {
+        type: 'object',
+        properties: {
+            tasks: {
+                type: 'array',
+                description: 'The sub-tasks to run concurrently.',
+                items: {
+                    type: 'object',
+                    properties: {
+                        task: { type: 'string', description: 'The complete, self-contained instruction.' },
+                        tools: { type: 'array', items: { type: 'string' }, description: 'Optional tool-name allowlist.' },
+                        model: { type: 'string', description: 'Optional model override.' },
+                    },
+                    required: ['task'],
+                },
+            },
+        },
+        required: ['tasks'],
+    },
+    async run(args, ctx) {
+        if (!ctx.spawn)
+            return 'Sub-agents are not available here (depth limit reached or unsupported context).';
+        const spawn = ctx.spawn;
+        const raw = Array.isArray(args.tasks) ? args.tasks : [];
+        const reqs = raw.map((t) => spawnReq((t && typeof t === 'object' ? t : {}))).filter((r) => r !== null);
+        if (!reqs.length)
+            return 'Error: `tasks` must contain at least one task with a non-empty `task` string.';
+        const results = await Promise.all(reqs.map(async (req, i) => {
+            try {
+                const r = await spawn(req);
+                return `### Sub-agent ${i + 1}\n${r.text}${spawnFooter(r)}`;
+            }
+            catch (e) {
+                return `### Sub-agent ${i + 1}\nError: ${String(e?.message || e)}`;
+            }
+        }));
+        return results.join('\n\n');
+    },
+};
+export const compilePrompdTool = {
+    name: 'compile_prompd',
+    noOffload: true, // the compiled output is what the user asked to see — keep inline
+    description: 'Compile a .prmd/.md prompt (YAML frontmatter + Nunjucks body) and return the rendered output. ' +
+        'The frontmatter REQUIRES id (kebab-case), name, and version (e.g. 1.0.0). ' +
+        'Body variables use {{ name }} and are filled from the `parameters` argument — ' +
+        'you MUST pass `parameters` to substitute them (e.g. {"name":"Prompd"}), or they render empty. ' +
+        'To compile a file already in the workspace (so its inherits:/{% include %} resolve against ' +
+        'sibling files), pass `path` (e.g. "prompts/topic.prmd"); pass `source` to compile inline text, ' +
+        'or both to compile a modified version of a workspace file (source overrides the file at path).',
+    parameters: {
+        type: 'object',
+        properties: {
+            source: { type: 'string', description: 'Full source including frontmatter. Omit to compile the stored file at `path`.' },
+            path: { type: 'string', description: 'A workspace file to compile (relative path). Enables inherits:/{% include %} resolution against sibling files.' },
+            parameters: { type: 'object', description: 'Values for the {{ variables }} in the body, e.g. {"name":"Prompd"}.', additionalProperties: true },
+        },
+        required: ['parameters'],
+    },
+    async run(args, ctx) {
+        const source = str(args, 'source');
+        const path = str(args, 'path');
+        const params = (args.parameters && typeof args.parameters === 'object' ? args.parameters : {});
+        try {
+            const r = await compilePrompt(source, params, { files: ctx.files, path });
+            const errs = r.errors?.length ? `\n\nErrors:\n${r.errors.map((e) => `- ${e.message}`).join('\n')}` : '';
+            return `${r.output}${errs}`;
+        }
+        catch (e) {
+            return `Compile failed: ${e instanceof Error ? e.message : String(e)}`;
+        }
+    },
+};
+/** The kernel's runtime-agnostic built-in tools. Product/host tools (registry
+ * search) are added by the registry — use `allTools()` for the complete set. */
+export const defaultTools = [
+    askUserTool,
+    spawnAgentTool,
+    spawnAgentsTool,
+    proposeEditTool,
+    saveMemoryTool,
+    recallMemoryTool,
+    kvGetTool,
+    kvSetTool,
+    recallResultTool,
+    searchSessionsTool,
+    webSearchTool,
+    todoWriteTool,
+    compilePrompdTool,
+    ...fileTools,
+];
+/** The full tool set the model is offered: kernel built-ins + everything the
+ * host registered (compile_prompd, search_packages, a bridge's tools, …).
+ * Read this LAZILY at the point of use — never cache it at module top level —
+ * so tools registered after a consumer loaded still appear. */
+export function allTools() {
+    return [...defaultTools, ...extensionTools()];
+}
+//# sourceMappingURL=builtins.js.map

package/dist/tools/builtins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.js","sourceRoot":"","sources":["../../tools/builtins.ts"],"names":[],"mappings":"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"}

package/dist/tools/files.d.ts

@@ -0,0 +1,11 @@
+import type { AgentTool } from '@corenel/protocol';
+export declare const listFilesTool: AgentTool;
+export declare const readFileTool: AgentTool;
+export declare const statFileTool: AgentTool;
+export declare const searchFilesTool: AgentTool;
+export declare const writeFileTool: AgentTool;
+export declare const createFileTool: AgentTool;
+export declare const deleteFileTool: AgentTool;
+export declare const renameFileTool: AgentTool;
+export declare const fileTools: AgentTool[];
+//# sourceMappingURL=files.d.ts.map

package/dist/tools/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../tools/files.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,mBAAmB,CAAC;AAqBhE,eAAO,MAAM,aAAa,EAAE,SAe3B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,SAY1B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,SAc1B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,SAa7B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,SAoB3B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,SAkB5B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,SAe5B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,SAmB5B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,SAAS,EAShC,CAAC"}