@corenel/harness 0.1.0

package/dist/tools/files.js

@@ -0,0 +1,161 @@
+function str(args, key) {
+    const v = args[key];
+    return typeof v === 'string' ? v : v == null ? '' : String(v);
+}
+function requireFiles(ctx) {
+    if (!ctx.files)
+        throw new Error('No file workspace is connected.');
+    return ctx.files;
+}
+function flatten(nodes, out = []) {
+    for (const n of nodes) {
+        out.push(`${n.kind === 'directory' ? '[dir] ' : ''}${n.path}${n.kind === 'file' && n.size != null ? ` (${n.size}b)` : ''}`);
+        if (n.children?.length)
+            flatten(n.children, out);
+    }
+    return out;
+}
+export const listFilesTool = {
+    name: 'list_files',
+    description: 'List files and directories in the workspace (the open folder or the virtual workspace). ' +
+        'Optionally pass `dir` to list a subdirectory. Returns paths relative to the workspace root.',
+    parameters: {
+        type: 'object',
+        properties: { dir: { type: 'string', description: 'Subdirectory to list (optional; omit for the root).' } },
+    },
+    async run(args, ctx) {
+        const files = requireFiles(ctx);
+        const nodes = await files.list(str(args, 'dir') || undefined);
+        const lines = flatten(nodes);
+        return lines.length ? lines.join('\n') : '(empty)';
+    },
+};
+export const readFileTool = {
+    name: 'read_file',
+    description: 'Read a file from the workspace and return its UTF-8 text. Pass `path` relative to the workspace root.',
+    parameters: {
+        type: 'object',
+        properties: { path: { type: 'string', description: 'File path, e.g. "prompts/base.prmd".' } },
+        required: ['path'],
+    },
+    async run(args, ctx) {
+        const files = requireFiles(ctx);
+        return files.read(str(args, 'path'));
+    },
+};
+export const statFileTool = {
+    name: 'stat_file',
+    description: 'Check whether a path exists in the workspace and whether it is a file or directory.',
+    parameters: {
+        type: 'object',
+        properties: { path: { type: 'string', description: 'Path to check.' } },
+        required: ['path'],
+    },
+    async run(args, ctx) {
+        const files = requireFiles(ctx);
+        const s = await files.stat(str(args, 'path'));
+        if (!s)
+            return `Not found: ${str(args, 'path')}`;
+        return `${s.kind} — ${s.path}${s.kind === 'file' ? ` (${s.size}b)` : ''}`;
+    },
+};
+export const searchFilesTool = {
+    name: 'search_files',
+    description: 'Find files in the workspace whose path or contents contain a query (case-insensitive).',
+    parameters: {
+        type: 'object',
+        properties: { query: { type: 'string', description: 'Text to search for.' } },
+        required: ['query'],
+    },
+    async run(args, ctx) {
+        const files = requireFiles(ctx);
+        const hits = await files.search(str(args, 'query'));
+        return hits.length ? hits.join('\n') : 'No matches.';
+    },
+};
+export const writeFileTool = {
+    name: 'write_file',
+    mutates: true,
+    description: 'Overwrite (or create) a file in the workspace with the given full content. ' +
+        'Provide the COMPLETE new content, not a patch. Use `path` relative to the workspace root.',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'File path to write.' },
+            content: { type: 'string', description: 'The full file content.' },
+        },
+        required: ['path', 'content'],
+    },
+    async run(args, ctx) {
+        const files = requireFiles(ctx);
+        const path = str(args, 'path');
+        await files.write(path, str(args, 'content'));
+        return `Wrote ${path}.`;
+    },
+};
+export const createFileTool = {
+    name: 'create_file',
+    mutates: true,
+    description: 'Create a new file in the workspace. Fails if it already exists (use write_file to overwrite).',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'New file path.' },
+            content: { type: 'string', description: 'Initial content (optional).' },
+        },
+        required: ['path'],
+    },
+    async run(args, ctx) {
+        const files = requireFiles(ctx);
+        const path = str(args, 'path');
+        await files.create(path, str(args, 'content'));
+        return `Created ${path}.`;
+    },
+};
+export const deleteFileTool = {
+    name: 'delete_file',
+    mutates: true,
+    description: 'Delete a file or directory (recursive) from the workspace.',
+    parameters: {
+        type: 'object',
+        properties: { path: { type: 'string', description: 'Path to delete.' } },
+        required: ['path'],
+    },
+    async run(args, ctx) {
+        const files = requireFiles(ctx);
+        const path = str(args, 'path');
+        await files.remove(path);
+        return `Deleted ${path}.`;
+    },
+};
+export const renameFileTool = {
+    name: 'rename_file',
+    mutates: true,
+    description: 'Move or rename a file (or directory) within the workspace.',
+    parameters: {
+        type: 'object',
+        properties: {
+            from: { type: 'string', description: 'Current path.' },
+            to: { type: 'string', description: 'New path.' },
+        },
+        required: ['from', 'to'],
+    },
+    async run(args, ctx) {
+        const files = requireFiles(ctx);
+        const from = str(args, 'from');
+        const to = str(args, 'to');
+        await files.rename(from, to);
+        return `Renamed ${from} -> ${to}.`;
+    },
+};
+export const fileTools = [
+    listFilesTool,
+    readFileTool,
+    statFileTool,
+    searchFilesTool,
+    writeFileTool,
+    createFileTool,
+    deleteFileTool,
+    renameFileTool,
+];
+//# sourceMappingURL=files.js.map

package/dist/tools/files.js.map

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

package/dist/tools/http.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from '@corenel/protocol';
+export declare const apiRequestTool: AgentTool;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../tools/http.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAYnD,eAAO,MAAM,cAAc,EAAE,SA0D5B,CAAC"}

package/dist/tools/http.js

@@ -0,0 +1,71 @@
+import { outboundUrlError, safeFetch } from './urlGuard';
+function str(args, key) {
+    const v = args[key];
+    return typeof v === 'string' ? v : v == null ? '' : String(v);
+}
+const METHODS = new Set(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD']);
+/** Cap the body we feed back to the model so a large response can't blow context. */
+const MAX_BODY = 16000;
+export const apiRequestTool = {
+    name: 'api_request',
+    mutates: true,
+    description: 'Make an HTTP request to a URL and return the status and response body. Supply `url` (required), ' +
+        'optional `method` (GET by default), `headers` (object), and `body` (a string, or an object that is ' +
+        'JSON-encoded). Use for calling REST APIs and webhooks. NOTE: in the browser this is subject to CORS — ' +
+        'cross-origin endpoints without permissive CORS headers will fail.',
+    parameters: {
+        type: 'object',
+        properties: {
+            url: { type: 'string', description: 'The full request URL (https://…).' },
+            method: { type: 'string', description: 'HTTP method: GET (default), POST, PUT, PATCH, DELETE, HEAD.' },
+            headers: { type: 'object', description: 'Request headers as a flat string map.', additionalProperties: { type: 'string' } },
+            body: { type: 'string', description: 'Request body. A string is sent verbatim; an object is JSON-encoded (with a JSON content-type).' },
+        },
+        required: ['url'],
+    },
+    async run(args, ctx) {
+        const url = str(args, 'url').trim();
+        if (!url)
+            return 'Error: `url` is required.';
+        // SSRF guard: http(s) only, and never an internal/loopback/metadata host. The
+        // same check re-runs on every redirect hop inside safeFetch.
+        const bad = outboundUrlError(url);
+        if (bad)
+            return `Error: ${bad}.`;
+        const method = (str(args, 'method').toUpperCase() || 'GET');
+        if (!METHODS.has(method))
+            return `Error: unsupported method "${method}".`;
+        const headers = {};
+        if (args.headers && typeof args.headers === 'object') {
+            for (const [k, v] of Object.entries(args.headers))
+                headers[k] = v == null ? '' : String(v);
+        }
+        // body: a string is sent as-is; an object is JSON-encoded. GET/HEAD carry none.
+        let body;
+        if (method !== 'GET' && method !== 'HEAD' && args.body != null) {
+            if (typeof args.body === 'string') {
+                body = args.body;
+            }
+            else {
+                body = JSON.stringify(args.body);
+                if (!Object.keys(headers).some((h) => h.toLowerCase() === 'content-type'))
+                    headers['Content-Type'] = 'application/json';
+            }
+        }
+        try {
+            const res = await safeFetch(url, { method, headers, body, signal: ctx.signal });
+            const text = await res.text();
+            const clipped = text.length > MAX_BODY ? `${text.slice(0, MAX_BODY)}\n…[truncated ${text.length - MAX_BODY} chars]` : text;
+            return `HTTP ${res.status} ${res.statusText}\n\n${clipped || '(empty body)'}`;
+        }
+        catch (e) {
+            const msg = String(e?.message || e);
+            // The browser reports a CORS/network failure as an opaque "Failed to fetch" —
+            // name the likely cause so the user isn't left guessing.
+            return /failed to fetch|networkerror/i.test(msg)
+                ? `Request failed: ${msg}. In the browser this is usually CORS or an unreachable host.`
+                : `Request failed: ${msg}`;
+        }
+    },
+};
+//# sourceMappingURL=http.js.map

package/dist/tools/http.js.map

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

package/dist/tools/namespaces.d.ts

@@ -0,0 +1,27 @@
+export type ToolNamespace = 'fs' | 'prompd' | 'web' | 'memory' | 'agent' | 'shell' | 'system' | 'mcp' | 'skill' | 'other';
+/** Display order + labels for the namespaces (capabilities panel grouping). */
+export declare const NAMESPACE_LABELS: {
+    ns: ToolNamespace;
+    label: string;
+}[];
+/** Minimal shape needed to namespace a tool — a subset of AgentTool. */
+export interface NamespacedTool {
+    name: string;
+    /** Explicit override (dynamic tools set this); otherwise resolved by name. */
+    namespace?: string;
+}
+/** Resolve a tool's namespace: explicit field > built-in table > wire prefix > 'other'. */
+export declare function resolveNamespace(tool: NamespacedTool): ToolNamespace;
+/** The policy-facing address `namespace:leaf`. For mcp/skill the redundant wire
+ * prefix is stripped — both the `mcp__server__x` convention and the actual
+ * `mcp_x` wire names loadMcpTools produces (mcp__github__x -> mcp:github__x,
+ * mcp_create_issue -> mcp:create_issue). */
+export declare function toolAddress(tool: NamespacedTool): string;
+/** Candidate strings a policy glob may target for this tool: its address and its
+ * bare wire name (so both `fs:write_file` and legacy `write_file` match). */
+export declare function toolGlobTargets(tool: NamespacedTool): string[];
+/** True if any glob matches the tool by address or bare name. */
+export declare function toolMatchesAnyGlob(tool: NamespacedTool, globs: readonly string[]): boolean;
+/** Namespace-wildcard address (`fs:*`) — the "whole namespace" policy target. */
+export declare function namespaceGlob(ns: ToolNamespace): string;
+//# sourceMappingURL=namespaces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"namespaces.d.ts","sourceRoot":"","sources":["../../tools/namespaces.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,aAAa,GACrB,IAAI,GACJ,QAAQ,GACR,KAAK,GACL,QAAQ,GACR,OAAO,GACP,OAAO,GACP,QAAQ,GACR,KAAK,GACL,OAAO,GACP,OAAO,CAAC;AAEZ,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,EAAE;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAWlE,CAAC;AAcF,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa,CAUpE;AAED;;;4CAG4C;AAC5C,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAQxD;AAED;6EAC6E;AAC7E,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CAE9D;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAI1F;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,CAEvD"}

package/dist/tools/namespaces.js

@@ -0,0 +1,83 @@
+/* Tool namespacing — the single source of truth for which namespace a tool
+ * belongs to, and the policy-addressing scheme built on top of it.
+ *
+ * Wire names (what the model calls) must match /^[a-zA-Z0-9_-]{1,64}$/, so the
+ * namespace is NOT part of the wire name — it is a policy/UI/authoring address:
+ *   wire name   write_file                 (sent to the model)
+ *   address     fs:write_file              (used in policy globs + completions)
+ * Dynamic tools carry a wire prefix instead (mcp__server__tool, skill__name);
+ * their address strips the prefix to read mcp:server__tool / skill:name.
+ *
+ * Policy globs may target a whole namespace (fs:*) or one tool (fs:write_file),
+ * and legacy bare-name globs (write_file) still match for back-compat. */
+import { matchesAnyGlob } from '../guardrail/glob';
+/** Display order + labels for the namespaces (capabilities panel grouping). */
+export const NAMESPACE_LABELS = [
+    { ns: 'fs', label: 'Files' },
+    { ns: 'prompd', label: 'Prompd' },
+    { ns: 'web', label: 'Web' },
+    { ns: 'memory', label: 'Memory' },
+    { ns: 'agent', label: 'Agent' },
+    { ns: 'shell', label: 'Shell' },
+    { ns: 'system', label: 'System' },
+    { ns: 'mcp', label: 'MCP' },
+    { ns: 'skill', label: 'Skills' },
+    { ns: 'other', label: 'Other' },
+];
+/** Canonical namespace for every built-in tool. Dynamic tools (mcp/skill) are
+ * resolved from their wire prefix, not this table. */
+const BUILTIN_NAMESPACES = {
+    list_files: 'fs', read_file: 'fs', stat_file: 'fs', search_files: 'fs',
+    write_file: 'fs', create_file: 'fs', delete_file: 'fs', rename_file: 'fs',
+    compile_prompd: 'prompd', propose_edit: 'prompd', search_packages: 'prompd',
+    web_search: 'web',
+    save_memory: 'memory', recall_memory: 'memory', recall_result: 'memory',
+    kv_get: 'memory', kv_set: 'memory', search_sessions: 'memory',
+    ask_user: 'agent', spawn_agent: 'agent', spawn_agents: 'agent', todo_write: 'agent',
+};
+/** Resolve a tool's namespace: explicit field > built-in table > wire prefix > 'other'. */
+export function resolveNamespace(tool) {
+    if (tool.namespace)
+        return tool.namespace;
+    const known = BUILTIN_NAMESPACES[tool.name];
+    if (known)
+        return known;
+    const i = tool.name.indexOf('__');
+    if (i > 0) {
+        const head = tool.name.slice(0, i);
+        if (head === 'mcp' || head === 'skill')
+            return head;
+    }
+    return 'other';
+}
+/** The policy-facing address `namespace:leaf`. For mcp/skill the redundant wire
+ * prefix is stripped — both the `mcp__server__x` convention and the actual
+ * `mcp_x` wire names loadMcpTools produces (mcp__github__x -> mcp:github__x,
+ * mcp_create_issue -> mcp:create_issue). */
+export function toolAddress(tool) {
+    const ns = resolveNamespace(tool);
+    let leaf = tool.name;
+    if (ns === 'mcp' || ns === 'skill') {
+        const m = new RegExp(`^${ns}__?`).exec(leaf); // `mcp__` or `mcp_`
+        if (m)
+            leaf = leaf.slice(m[0].length);
+    }
+    return `${ns}:${leaf}`;
+}
+/** Candidate strings a policy glob may target for this tool: its address and its
+ * bare wire name (so both `fs:write_file` and legacy `write_file` match). */
+export function toolGlobTargets(tool) {
+    return [toolAddress(tool), tool.name];
+}
+/** True if any glob matches the tool by address or bare name. */
+export function toolMatchesAnyGlob(tool, globs) {
+    if (!globs.length)
+        return false;
+    const targets = toolGlobTargets(tool);
+    return globs.some((g) => matchesAnyGlob(targets[0], [g]) || matchesAnyGlob(targets[1], [g]));
+}
+/** Namespace-wildcard address (`fs:*`) — the "whole namespace" policy target. */
+export function namespaceGlob(ns) {
+    return `${ns}:*`;
+}
+//# sourceMappingURL=namespaces.js.map

package/dist/tools/namespaces.js.map

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,8 @@
+import type { AgentTool } from '@corenel/protocol';
+/** Register (or replace) an extension tool by name. */
+export declare function registerTool(tool: AgentTool): void;
+/** Remove an extension tool (used by tests and dynamic providers). */
+export declare function unregisterTool(name: string): void;
+/** Host-registered extension tools, in registration order. */
+export declare function extensionTools(): AgentTool[];
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../tools/registry.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAInD,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAElD;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,8DAA8D;AAC9D,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAE5C"}

package/dist/tools/registry.js

@@ -0,0 +1,14 @@
+const registry = new Map();
+/** Register (or replace) an extension tool by name. */
+export function registerTool(tool) {
+    registry.set(tool.name, tool);
+}
+/** Remove an extension tool (used by tests and dynamic providers). */
+export function unregisterTool(name) {
+    registry.delete(name);
+}
+/** Host-registered extension tools, in registration order. */
+export function extensionTools() {
+    return [...registry.values()];
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../tools/registry.ts"],"names":[],"mappings":"AAYA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqB,CAAC;AAE9C,uDAAuD;AACvD,MAAM,UAAU,YAAY,CAAC,IAAe;IAC1C,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/dist/tools/sessions.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from '@corenel/protocol';
+export declare const searchSessionsTool: AgentTool;
+//# sourceMappingURL=sessions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../tools/sessions.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AA2EnD,eAAO,MAAM,kBAAkB,EAAE,SA0DhC,CAAC"}

package/dist/tools/sessions.js

@@ -0,0 +1,149 @@
+function str(args, key) {
+    const v = args[key];
+    return typeof v === 'string' ? v : v == null ? '' : String(v);
+}
+function clamp(n, lo, hi) {
+    return Number.isFinite(n) ? Math.min(hi, Math.max(lo, Math.round(n))) : lo;
+}
+/** Text of one (possibly multimodal) message content. */
+function messageText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((p) => (p && typeof p === 'object' && p.type === 'text' && typeof p.text === 'string' ? p.text : ''))
+            .filter(Boolean)
+            .join(' ');
+    }
+    return '';
+}
+/** Flatten a session's stored messages to {role,text}. Sessions persist as
+ * ConversationTurn[] (each turn wraps `messages`); older/other shapes may be a
+ * flat ChatCompletionMessageParam[] — handle both. Only user/assistant text. */
+function extractMessages(raw) {
+    const out = [];
+    const walk = (items) => {
+        if (!Array.isArray(items))
+            return;
+        for (const item of items) {
+            if (!item || typeof item !== 'object')
+                continue;
+            const o = item;
+            if (Array.isArray(o.messages)) {
+                walk(o.messages);
+                continue;
+            } // ConversationTurn
+            const role = typeof o.role === 'string' ? o.role : '';
+            if (role !== 'user' && role !== 'assistant')
+                continue;
+            const text = messageText(o.content).trim();
+            if (text)
+                out.push({ role, text });
+        }
+    };
+    walk(raw);
+    return out;
+}
+function occurrences(haystack, needle) {
+    if (!needle)
+        return 0;
+    return haystack.split(needle).length - 1;
+}
+/** A ~160-char window around the first matching term. */
+function snippet(text, terms) {
+    const lower = text.toLowerCase();
+    let idx = -1;
+    for (const t of terms) {
+        const i = lower.indexOf(t);
+        if (i >= 0 && (idx < 0 || i < idx))
+            idx = i;
+    }
+    if (idx < 0)
+        idx = 0;
+    const start = Math.max(0, idx - 60);
+    const end = Math.min(text.length, idx + 100);
+    let s = text.slice(start, end).replace(/\s+/g, ' ').trim();
+    if (start > 0)
+        s = `…${s}`;
+    if (end < text.length)
+        s = `${s}…`;
+    return s;
+}
+function relTime(ts, now) {
+    const s = Math.max(0, Math.floor((now - ts) / 1000));
+    if (s < 60)
+        return 'just now';
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m} minute${m > 1 ? 's' : ''} ago`;
+    const h = Math.floor(m / 60);
+    if (h < 24)
+        return `${h} hour${h > 1 ? 's' : ''} ago`;
+    const d = Math.floor(h / 24);
+    if (d < 30)
+        return `${d} day${d > 1 ? 's' : ''} ago`;
+    const mo = Math.floor(d / 30);
+    if (mo < 12)
+        return `${mo} month${mo > 1 ? 's' : ''} ago`;
+    const y = Math.floor(mo / 12);
+    return `${y} year${y > 1 ? 's' : ''} ago`;
+}
+export const searchSessionsTool = {
+    name: 'search_sessions',
+    noOffload: true, // results are short snippets the user asked to recall — keep inline
+    description: "Search the user's previous chat sessions (this app's saved conversations, for the signed-in user) by keyword. " +
+        'Use it to recall what was discussed or decided in an earlier chat — when the user says things like "like we ' +
+        'set up before", "what did we decide about X", or "continue from yesterday". Returns the best-matching sessions ' +
+        'with their title, how long ago, and short snippets showing where the words appear, plus a session id. ' +
+        'It does NOT search the workspace files (use search_files) or saved memory notes (use recall_memory).',
+    parameters: {
+        type: 'object',
+        properties: {
+            query: { type: 'string', description: 'Keywords to look for across past session titles and messages.' },
+            limit: { type: 'number', description: 'Max sessions to return (default 5, max 15).' },
+        },
+        required: ['query'],
+    },
+    async run(args, ctx) {
+        if (!ctx.sessions)
+            return 'Session history is unavailable in this environment.';
+        const query = str(args, 'query').trim();
+        if (!query)
+            return 'Provide a non-empty `query`.';
+        const limit = clamp(Number(args.limit) || 5, 1, 15);
+        const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+        const all = await ctx.sessions.list();
+        const now = Date.now();
+        const scored = all
+            .map((s) => {
+            const msgs = extractMessages(s.messages);
+            if (!msgs.length)
+                return null; // skip empty/placeholder chats
+            const title = s.title || 'Untitled';
+            const titleLower = title.toLowerCase();
+            const hay = `${title} ${msgs.map((m) => m.text).join(' ')}`.toLowerCase();
+            let score = 0;
+            for (const t of terms) {
+                if (titleLower.includes(t))
+                    score += 3;
+                score += occurrences(hay, t);
+            }
+            return score > 0 ? { s, title, msgs, score } : null;
+        })
+            .filter((x) => x !== null)
+            .sort((a, b) => b.score - a.score || b.s.updatedAt - a.s.updatedAt)
+            .slice(0, limit);
+        if (!scored.length)
+            return `No previous sessions match "${query}".`;
+        const blocks = scored.map(({ s, title, msgs }, i) => {
+            const surface = s.surface || 'agent';
+            const when = relTime(s.updatedAt || s.createdAt || now, now);
+            const hits = msgs.filter((m) => terms.some((t) => m.text.toLowerCase().includes(t))).slice(0, 2);
+            const shown = hits.length ? hits : msgs.slice(0, 1); // title-only match -> show the opener
+            const lines = shown.map((m) => `   ${m.role}: "${snippet(m.text, terms)}"`);
+            return [`${i + 1}. "${title}"  ·  ${surface}  ·  ${when}`, `   id: ${s.id}`, ...lines].join('\n');
+        });
+        return `Found ${scored.length} previous session${scored.length > 1 ? 's' : ''} matching "${query}":\n\n${blocks.join('\n\n')}`;
+    },
+};
+//# sourceMappingURL=sessions.js.map

package/dist/tools/sessions.js.map

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

package/dist/tools/todo.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from '@corenel/protocol';
+export declare const todoWriteTool: AgentTool;
+//# sourceMappingURL=todo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../../tools/todo.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,eAAO,MAAM,aAAa,EAAE,SAqC3B,CAAC"}

package/dist/tools/todo.js

@@ -0,0 +1,38 @@
+export const todoWriteTool = {
+    name: 'todo_write',
+    noOffload: true, // the task list is what the user wants to see — keep it inline
+    description: 'Maintain a visible task list for a multi-step job. Pass the COMPLETE list each time (a rewrite). ' +
+        'Keep exactly one task "in_progress" while you work it; mark tasks "completed" as you finish; use ' +
+        '"blocked" + blockedBy for tasks waiting on others; nest a subtask one level with parentId. Reuse a ' +
+        'short stable id per task across updates so its progress and activity persist. Call it when you start ' +
+        'a multi-step task and after each meaningful step.',
+    parameters: {
+        type: 'object',
+        properties: {
+            todos: {
+                type: 'array',
+                description: 'The complete task list, in execution order.',
+                items: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'string', description: 'Stable short id, reused across updates (e.g. "auth").' },
+                        title: { type: 'string', description: 'Concise, imperative (e.g. "Wire the routes").' },
+                        status: { type: 'string', enum: ['pending', 'in_progress', 'completed', 'blocked'] },
+                        note: { type: 'string', description: 'Optional one-line detail.' },
+                        blockedBy: { type: 'array', items: { type: 'string' }, description: 'Task ids this one waits on.' },
+                        parentId: { type: 'string', description: 'Parent task id for a subtask (one level deep).' },
+                    },
+                    required: ['id', 'title', 'status'],
+                },
+            },
+        },
+        required: ['todos'],
+    },
+    async run(args) {
+        const todos = Array.isArray(args.todos) ? args.todos : [];
+        const done = todos.filter((t) => String(t?.status) === 'completed').length;
+        const active = todos.find((t) => String(t?.status) === 'in_progress');
+        return `Task list updated (${done}/${todos.length} done${active ? `, now: ${active.title}` : ''}).`;
+    },
+};
+//# sourceMappingURL=todo.js.map