@corenel/harness 0.20.0 → 0.22.0

package/dist/tools/toolSearch.js

@@ -1,5 +1,5 @@
 import { parseMcpWireName } from '@corenel/protocol';
-import { resolveNamespace } from './namespaces.js';
+import { isListedTool, resolveNamespace } from './namespaces.js';
 export const TOOL_SEARCH_NAME = 'tool_search';
 /** Most tools one conversation keeps loaded. Least recently used goes first.
  *  Large enough for a real multi-service task, small enough that the loaded set
@@ -7,16 +7,38 @@ export const TOOL_SEARCH_NAME = 'tool_search';
 export const LOADED_TOOLS_CAP = 24;
 const DEFAULT_LIMIT = 8;
 const MAX_LIMIT = 20;
-/** Deferred = reached by search. Every MCP tool, and nothing else: builtins are
- *  the agent's own competence and are used on most turns. One rule rather than a
- *  size threshold, so there is one behaviour to reason about. */
-export function isDeferredTool(tool) {
+/** A tool from a connected MCP server. Use this, not isDeferredTool, where the
+ *  question is about MCP itself (the daemon's credential, outside content). */
+export function isMcpTool(tool) {
     return resolveNamespace(tool) === 'mcp';
 }
-/** The server a deferred tool belongs to, from its wire name. */
+/** Deferred = reached by search. Every MCP tool and every Listed built-in; the
+ *  rest of the builtins are the agent's own competence and are used on most
+ *  turns. Two table-driven rules rather than a size threshold, so there is one
+ *  behaviour to reason about. */
+export function isDeferredTool(tool) {
+    return isMcpTool(tool) || isListedTool(tool);
+}
+/** The server a deferred tool belongs to, from its wire name. A Listed built-in
+ *  has no server: it is grouped as 'built-in'. */
 export function serverOf(tool) {
+    if (isListedTool(tool))
+        return BUILT_IN_GROUP;
     return parseMcpWireName(tool.name)?.server ?? 'mcp';
 }
+/** The group name `serverOf` gives a Listed built-in, and the `server` value that
+ *  searches only them. Not an MCP server. */
+export const BUILT_IN_GROUP = 'built-in';
+/** A run's tools split by tier, as every host hands them to the loop: Loaded
+ *  tools (sent as functions on every request) in `tools`, MCP tools and Listed
+ *  built-ins (reached by `tool_search`) in `deferredTools`. Order is kept. */
+export function splitByTier(all) {
+    const tools = [];
+    const deferredTools = [];
+    for (const t of all)
+        (isDeferredTool(t) ? deferredTools : tools).push(t);
+    return { tools, deferredTools };
+}
 function words(s) {
     return s.toLowerCase().split(/[^a-z0-9]+/).filter((w) => w.length > 1);
 }
@@ -36,12 +58,14 @@ export function rankTools(query, tools, opts = {}) {
     const limit = Math.min(MAX_LIMIT, Math.max(1, Math.floor(opts.limit ?? DEFAULT_LIMIT)));
     const pool = opts.server ? tools.filter((t) => serverOf(t) === opts.server) : tools;
     const q = words(query);
+    const exact = query.trim().toLowerCase();
     const scored = pool.map((tool, i) => {
         const parsed = parseMcpWireName(tool.name);
         const nameWords = words(parsed?.tool ?? tool.name);
         const serverWords = words(parsed?.server ?? '');
         const descWords = words(tool.description ?? '');
-        let score = 0;
+        // A query that is exactly a tool's name is the model asking for that tool.
+        let score = exact && tool.name.toLowerCase() === exact ? 1000 : 0;
         for (const w of q) {
             if (nameWords.includes(w))
                 score += 3;
@@ -62,9 +86,12 @@ export function rankTools(query, tools, opts = {}) {
         .slice(0, limit)
         .map((s) => s.tool);
 }
-/** One line per server the run can reach by search. Goes in the system prompt,
- *  so the model knows a capability exists before deciding it does not. */
+/** One line per MCP server the run can reach by search (pass MCP tools only).
+ *  Goes in the system prompt, so the model knows a capability exists before
+ *  deciding it does not. */
 export function serverIndex(deferred) {
+    if (!deferred.length)
+        return '';
     const counts = new Map();
     for (const t of deferred)
         counts.set(serverOf(t), (counts.get(serverOf(t)) ?? 0) + 1);
@@ -74,6 +101,20 @@ export function serverIndex(deferred) {
         ...lines,
     ].join('\n');
 }
+/** What a search that found nothing says. Listed built-ins are grouped as
+ *  'built-in' for search, but they are not a connected server, so they are
+ *  named apart from the MCP servers. */
+function noMatchNote(deferred) {
+    const groups = [...new Set(deferred.map(serverOf))];
+    const servers = groups.filter((g) => g !== BUILT_IN_GROUP);
+    const parts = ['No tools matched.'];
+    if (servers.length)
+        parts.push(`Connected servers: ${servers.join(', ')}.`);
+    if (groups.includes(BUILT_IN_GROUP))
+        parts.push(`To search only the listed built-in tools, pass server "${BUILT_IN_GROUP}".`);
+    parts.push(servers.length ? 'Try other words or name a server.' : 'Try other words.');
+    return parts.join(' ');
+}
 export function createToolLoader(opts) {
     const cap = opts.cap ?? LOADED_TOOLS_CAP;
     const byName = new Map(opts.deferred.map((t) => [t.name, t]));
@@ -98,7 +139,7 @@ export function createToolLoader(opts) {
     const searchTool = {
         name: TOOL_SEARCH_NAME,
         namespace: 'agent',
-        description: 'Find tools on connected services (MCP servers) by what you want to do. Returns matching tools with their input schemas and makes them callable from your next step. Search before concluding a service cannot do something.',
+        description: 'Find listed tools and tools on connected services by what you want to do (or by exact tool name). Returns matching tools with their input schemas and makes them callable from your next step. Search before concluding a tool or service cannot do something.',
         parameters: {
             type: 'object',
             properties: {
@@ -109,6 +150,10 @@ export function createToolLoader(opts) {
             required: ['query'],
         },
         mutates: false,
+        // A read that loads nothing it could not already call by name, so it never
+        // stops for a person under a policy's defaultPermission: ask. A policy that
+        // names tool_search, and the ceiling, still decide.
+        permission: 'allow',
         // The schemas ARE the answer; offloading them behind a pointer would hide
         // exactly what the model searched for.
         noOffload: true,
@@ -120,12 +165,9 @@ export function createToolLoader(opts) {
             const limit = typeof args.limit === 'number' ? args.limit : undefined;
             const found = rankTools(query, opts.deferred, { server, limit });
             add(found.map((t) => t.name));
-            const servers = [...new Set(opts.deferred.map(serverOf))];
             return JSON.stringify({
                 tools: found.map((t) => ({ name: t.name, server: serverOf(t), description: t.description, inputSchema: t.parameters })),
-                note: found.length
-                    ? 'These tools are now loaded; call them directly.'
-                    : `No tools matched. Connected servers: ${servers.join(', ') || '(none)'}. Try other words or name a server.`,
+                note: found.length ? 'These tools are now loaded; call them directly.' : noMatchNote(opts.deferred),
             });
         },
     };
@@ -138,6 +180,12 @@ export function createToolLoader(opts) {
                 return;
             order = [...order.filter((n) => n !== name), name];
         },
+        load: (name) => {
+            const tool = byName.get(name);
+            if (tool)
+                add([name]);
+            return tool;
+        },
     };
 }
 //# sourceMappingURL=toolSearch.js.map

package/dist/tools/toolSearch.js.map

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

package/dist/tools/workflowTool.d.ts

@@ -0,0 +1,34 @@
+import type { AgentTool, WorkflowCallInputs } from '@corenel/protocol';
+export declare const RUN_WORKFLOW_NAME = "run_workflow";
+/** The most of a run's final output the tool returns; the rest is cut with a note. */
+export declare const RUN_WORKFLOW_OUTPUT_MAX_BYTES: number;
+/** One declared parameter of a workflow, as an agent sees it. */
+export interface CallableParameter {
+    name: string;
+    label?: string;
+    description?: string;
+    /** The declared type: string, number, integer, boolean, date, datetime, array or object. */
+    type: string;
+    required: boolean;
+    default?: unknown;
+    enum?: string[];
+}
+/** One workflow the agent may run: its installed name, its description and its parameters. */
+export interface CallableWorkflow {
+    name: string;
+    description: string;
+    parameters: CallableParameter[];
+}
+/** The tool description (O5): one block per workflow from its metadata.description and its parameters. */
+export declare function runWorkflowDescription(workflows: readonly CallableWorkflow[]): string;
+/** R18. Defaults are NOT filled here (the run fills them); only given values are checked. */
+export declare function checkWorkflowInputs(w: CallableWorkflow, inputs: unknown): {
+    ok: true;
+    value: WorkflowCallInputs;
+} | {
+    ok: false;
+    error: string;
+};
+/** `run` returns the text the model reads (output, busy refusal, failure). */
+export declare function createRunWorkflowTool(workflows: readonly CallableWorkflow[], run: (name: string, inputs: WorkflowCallInputs, signal: AbortSignal) => Promise<string>): AgentTool;
+//# sourceMappingURL=workflowTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflowTool.d.ts","sourceRoot":"","sources":["../../tools/workflowTool.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvE,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,sFAAsF;AACtF,eAAO,MAAM,6BAA6B,QAAY,CAAC;AAEvD,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,8FAA8F;AAC9F,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAsBD,0GAA0G;AAC1G,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,CAWrF;AAkBD,6FAA6F;AAC7F,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GACnC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA0BxE;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,gBAAgB,EAAE,EACtC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,GACtF,SAAS,CA2BX"}

package/dist/tools/workflowTool.js

@@ -0,0 +1,122 @@
+export const RUN_WORKFLOW_NAME = 'run_workflow';
+/** The most of a run's final output the tool returns; the rest is cut with a note. */
+export const RUN_WORKFLOW_OUTPUT_MAX_BYTES = 64 * 1024;
+const LEAD = "Run one workflow this fleet deployed to this sidecar and wait for its final output. Its spend counts against the workflow's own limits. "
+    + 'A workflow that is already running cannot be started again until it finishes.';
+/** Text from a package, laid out on one line so it cannot break the list it sits in. */
+const oneLine = (s) => s.replace(/\s+/g, ' ').trim();
+function parameterLine(p) {
+    const label = p.label !== undefined && oneLine(p.label) !== '' && oneLine(p.label) !== p.name ? ` (${oneLine(p.label)})` : '';
+    let line = `  - ${p.name}${label}: ${p.type}, ${p.required ? 'required' : 'optional'}`;
+    if (p.default !== undefined) {
+        let shown;
+        try {
+            shown = JSON.stringify(p.default);
+        }
+        catch {
+            shown = undefined;
+        }
+        if (shown !== undefined)
+            line += `, default ${shown}`;
+    }
+    if (p.enum && p.enum.length)
+        line += `, one of ${p.enum.join(', ')}`;
+    const description = p.description !== undefined ? oneLine(p.description) : '';
+    if (description)
+        line += `. ${description}`;
+    return line;
+}
+/** The tool description (O5): one block per workflow from its metadata.description and its parameters. */
+export function runWorkflowDescription(workflows) {
+    const lines = [LEAD, '', 'Workflows:'];
+    for (const w of workflows) {
+        const description = oneLine(w.description);
+        lines.push(description ? `- ${w.name}: ${description}` : `- ${w.name}`);
+        if (w.parameters.length) {
+            lines.push('  Inputs:');
+            for (const p of w.parameters)
+                lines.push(parameterLine(p));
+        }
+    }
+    return lines.join('\n');
+}
+const isRecord = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+const hasOwn = (o, k) => Object.prototype.hasOwnProperty.call(o, k);
+/** What a value of `type` must be, in the words the refusal uses; null for a list or an object. */
+function expected(type) {
+    switch (type) {
+        case 'number': return { words: 'a number', ok: (v) => typeof v === 'number' && Number.isFinite(v) };
+        case 'integer': return { words: 'a whole number', ok: (v) => typeof v === 'number' && Number.isInteger(v) };
+        case 'boolean': return { words: 'true or false', ok: (v) => typeof v === 'boolean' };
+        case 'array':
+        case 'object': return null;
+        // string, date, datetime, and any type a newer workflow declares: text.
+        default: return { words: 'a string', ok: (v) => typeof v === 'string' };
+    }
+}
+/** R18. Defaults are NOT filled here (the run fills them); only given values are checked. */
+export function checkWorkflowInputs(w, inputs) {
+    if (inputs === undefined || inputs === null)
+        inputs = {};
+    if (!isRecord(inputs))
+        return { ok: false, error: `The inputs of ${w.name} must be an object of values by input name.` };
+    const byName = new Map(w.parameters.map((p) => [p.name, p]));
+    for (const name of Object.keys(inputs)) {
+        if (!byName.has(name))
+            return { ok: false, error: `${w.name} has no input named "${name}".` };
+    }
+    const value = {};
+    for (const p of w.parameters) {
+        if (!hasOwn(inputs, p.name) || inputs[p.name] === undefined)
+            continue;
+        const given = inputs[p.name];
+        const kind = expected(p.type);
+        if (kind === null)
+            return { ok: false, error: `The input "${p.name}" of ${w.name} is a list or an object, which an agent cannot give.` };
+        if (!kind.ok(given))
+            return { ok: false, error: `The input "${p.name}" of ${w.name} must be ${kind.words}.` };
+        const scalar = given;
+        if (p.enum && p.enum.length && !p.enum.includes(String(scalar))) {
+            return { ok: false, error: `The input "${p.name}" of ${w.name} must be one of: ${p.enum.join(', ')}.` };
+        }
+        Object.defineProperty(value, p.name, { value: scalar, enumerable: true, writable: true, configurable: true });
+    }
+    for (const p of w.parameters) {
+        if (p.required && !hasOwn(value, p.name) && p.default === undefined) {
+            return { ok: false, error: `${w.name} needs the input "${p.name}".` };
+        }
+    }
+    return { ok: true, value };
+}
+/** `run` returns the text the model reads (output, busy refusal, failure). */
+export function createRunWorkflowTool(workflows, run) {
+    const byName = new Map(workflows.map((w) => [w.name, w]));
+    const names = workflows.map((w) => w.name);
+    return {
+        name: RUN_WORKFLOW_NAME,
+        means: 'run a workflow the fleet deployed to this sidecar',
+        // A workflow calls models and can fetch and write its results: never assumed harmless. No roomSafe: a room
+        // turn is for deciding, and drops this tool.
+        mutates: true,
+        description: runWorkflowDescription(workflows),
+        parameters: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', enum: names, description: 'The workflow to run, from the Workflows list.' },
+                inputs: { type: 'object', description: 'Its inputs by name: text, numbers or true/false. Leave out an optional input to use its default.' },
+            },
+            required: ['name'],
+        },
+        async run(args, ctx) {
+            const name = typeof args.name === 'string' ? args.name : '';
+            const w = byName.get(name);
+            if (!w)
+                return `No workflow named "${name}". Available: ${names.join(', ')}.`;
+            const checked = checkWorkflowInputs(w, args.inputs);
+            if (!checked.ok)
+                return checked.error;
+            return run(w.name, checked.value, ctx.signal);
+        },
+    };
+}
+//# sourceMappingURL=workflowTool.js.map

package/dist/tools/workflowTool.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corenel/harness",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "license": "Elastic-2.0",
   "type": "module",
   "description": "Corenel — host-agnostic agent harness (kernel). The app resolves it via the `corenel` path alias (bypasses these exports entirely); vitest aliases it to source too. Everything else — node consumers like @corenel/cli, @corenel/term, @corenel/sidecar — resolves it through this workspace package via the exports map below, which points at dist/ unconditionally (not just at publish) so in-repo and published resolution are identical: a bundle that treats @corenel/harness as external (see packages/term/build.mjs) must see the SAME module instance node sees when it later resolves this package at runtime, and plain node cannot execute the raw .ts sources at all. Run `pnpm build` here (or let a dependent's prebuild do it) before relying on this package outside the app/vitest. NOTE: @xyflow/react and dagre are NOT dependencies here at all — this package has no .tsx files and imports neither. `react` IS a real (small) runtime dependency: `todos.ts` uses `useSyncExternalStore`. It is declared below as an OPTIONAL peer, not a hard dependency, so node-only consumers (cli/term/sidecar) aren't forced to install react; node consumers hoist it today only because something else in the tree happens to pull it in. Do not add @xyflow/react or dagre as dependencies/peers without testing a packed install end to end — an earlier attempt at that (before this package had any .tsx files) failed npm's peer resolution with ERESOLVE.",
@@ -33,7 +33,7 @@
   "dependencies": {
     "openai": "^4.77.0",
     "yaml": "^2.8.3",
-    "@corenel/protocol": "0.18.0"
+    "@corenel/protocol": "0.20.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"
@@ -44,9 +44,12 @@
     }
   },
   "devDependencies": {
+    "@types/node": "^24.13.1",
     "@prompd/core": "0.7.0",
+    "@types/react": "^18.3.5",
     "@types/ws": "^8.5.13",
-    "jszip": "^3.10.1"
+    "jszip": "^3.10.1",
+    "typescript": "^5.9.3"
   },
   "publishConfig": {
     "access": "public"