@ghostmind-dev/agent 0.1.0

package/dist/skills.js

@@ -0,0 +1,168 @@
+/**
+ * Skills — guides the agent loads only when a task calls for one.
+ *
+ * Loaded the Agent Skills way (agentskills.io): the model sees each picked skill's name and when to
+ * use it; `use_skill` brings in the full instructions and lists the reference files;
+ * `read_skill_file` brings in one of those. Nothing is loaded that the task does not call for.
+ *
+ * Which skills a run needs is a DECISION, not a generation, so Jev makes it (`pickSkills`): one
+ * choice question over every skill's description, answered in well under a second. TypeSafe
+ * measured the case — an agent reading a truncated index loaded the wrong skill 16.8% of the time
+ * against 7.3% when a System One model ranked them first — and it keeps the index out of the
+ * prompt however many skills exist. Without a `decide`, every skill is offered.
+ *
+ * Reading skills and guides is preparation, not work: the loop spends no tool call on them and gives
+ * the step back (see `guideTools` in the loop), because in production four guide reads once used up
+ * a whole budget and the answer then dropped what the person asked for.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+const FILE_CAP = 24_000;
+const cap = (s) => (s.length > FILE_CAP ? `${s.slice(0, FILE_CAP)}\n…(truncated, ${s.length} characters)` : s);
+const stripFrontmatter = (s) => s.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/, '');
+/** name and description from a SKILL.md's frontmatter (simple `key: value` lines, quotes optional). */
+export function readFrontmatter(text) {
+    const m = /^---\r?\n([\s\S]*?)\r?\n---/.exec(text);
+    const out = {};
+    if (!m?.[1])
+        return out;
+    for (const line of m[1].split(/\r?\n/)) {
+        const kv = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line);
+        if (kv?.[1])
+            out[kv[1]] = (kv[2] ?? '').trim().replace(/^(['"])([\s\S]*)\1$/, '$2');
+    }
+    return out;
+}
+/** Skills embedded in code (generated at build time, fetched from a database…). */
+export function inlineSkills(skills) {
+    const find = (name) => skills.find(s => s.name === name);
+    return {
+        list: async () => skills.map(s => ({ name: s.name, description: s.description })),
+        open: async (name) => {
+            const s = find(name);
+            return s ? { instructions: stripFrontmatter(s.files['SKILL.md'] ?? ''), files: Object.keys(s.files).filter(f => f !== 'SKILL.md') } : null;
+        },
+        readFile: async (name, path) => find(name)?.files[path.replace(/^\.?\//, '')] ?? null,
+    };
+}
+function walk(dir, root, out = []) {
+    for (const entry of readdirSync(dir)) {
+        if (entry.startsWith('.'))
+            continue;
+        const full = join(dir, entry);
+        if (statSync(full).isDirectory())
+            walk(full, root, out);
+        else
+            out.push(relative(root, full).split(sep).join('/'));
+    }
+    return out;
+}
+/** Skills on disk: every `<dir>/<name>/SKILL.md` (Claude Code, Codex and Gemini CLI all use this layout). */
+export function dirSkills(...dirs) {
+    const load = () => {
+        const found = new Map();
+        for (const dir of dirs) {
+            if (!existsSync(dir))
+                continue;
+            for (const entry of readdirSync(dir)) {
+                const root = join(dir, entry);
+                const file = join(root, 'SKILL.md');
+                if (!existsSync(file))
+                    continue;
+                const fm = readFrontmatter(readFileSync(file, 'utf8'));
+                const name = fm.name || entry;
+                // The first directory that defines a name wins, so a project can override one it inherited.
+                if (!found.has(name) && fm.description)
+                    found.set(name, { meta: { name, description: fm.description }, root });
+            }
+        }
+        return found;
+    };
+    return {
+        list: async () => [...load().values()].map(s => s.meta),
+        open: async (name) => {
+            const s = load().get(name);
+            if (!s)
+                return null;
+            return { instructions: stripFrontmatter(readFileSync(join(s.root, 'SKILL.md'), 'utf8')), files: walk(s.root, s.root).filter(f => f !== 'SKILL.md') };
+        },
+        readFile: async (name, path) => {
+            const s = load().get(name);
+            const clean = path.replace(/^\.?\//, '');
+            if (!s || clean.split('/').includes('..'))
+                return null;
+            const full = join(s.root, clean);
+            return existsSync(full) && statSync(full).isFile() ? readFileSync(full, 'utf8') : null;
+        },
+    };
+}
+export const NO_SKILL = 'none';
+/**
+ * Which skills this task needs — usually none. Jev reads the message (and the last few before it)
+ * against every description; a clear pick, or the two likeliest when it is torn — never "none"
+ * dressed up as a skill. Without `decide`, every skill is returned. A failed decision picks none.
+ */
+export async function pickSkills(model, skills, message, options = {}) {
+    if (!skills.length)
+        return { names: [], cost: 0 };
+    if (!model.decide)
+        return { names: skills.map(s => s.name), cost: 0 };
+    const paths = {
+        [NO_SKILL]: options.none ?? 'No guide is needed: the message can be handled with the tools alone. Almost every message is this.',
+    };
+    for (const s of skills.slice(0, 254))
+        paths[s.name] = s.description.slice(0, 600);
+    try {
+        const { answers, cost } = await model.decide({ message, earlier: (options.earlier ?? []).slice(-3) }, { skill: { type: 'choice', instructions: 'Which guide does handling `message` need, if any?', criteria: paths } }, options.signal);
+        const a = answers.skill;
+        if (a.type !== 'choice')
+            return { names: [], cost };
+        const ranked = Object.entries(a.probabilities).sort((x, y) => y[1] - x[1]);
+        const names = (a.confidence >= 0.5 ? ranked.slice(0, 1) : ranked.slice(0, 2)).filter(([name, p]) => name !== NO_SKILL && p >= 0.2 && name in paths).map(([name]) => name);
+        return { names, cost };
+    }
+    catch {
+        return { names: [], cost: 0 };
+    }
+}
+/** The tool names skillsToolset defines — the loop's default guide tools. */
+export const SKILL_TOOLS = ['use_skill', 'read_skill_file'];
+/** Tools to load the given skills (and only those). Null when there are none. */
+export function skillsToolset(source, names, options = {}) {
+    if (!names.length)
+        return null;
+    return {
+        name: 'skills',
+        description: `Guides: ${names.join(', ')}. Load one when the task calls for it.`,
+        tools: [
+            {
+                name: 'use_skill',
+                description: `Load a skill's full instructions and the list of its reference files. Skills: ${names.join(', ')}.`,
+                parameters: { type: 'object', properties: { name: { type: 'string', enum: names } }, required: ['name'] },
+                run: async (a) => {
+                    const name = String(a.name ?? '');
+                    const skill = names.includes(name) ? await source.open(name) : null;
+                    if (!skill)
+                        throw new Error(`No skill "${name}". Skills: ${names.join(', ')}`);
+                    return { skill: name, ...(options.preface ? { note: options.preface } : {}), instructions: cap(skill.instructions), reference_files: skill.files };
+                },
+            },
+            {
+                name: 'read_skill_file',
+                description: 'Read one reference file of a skill, as listed by use_skill.',
+                parameters: { type: 'object', properties: { name: { type: 'string', enum: names }, path: { type: 'string' } }, required: ['name', 'path'] },
+                run: async (a) => {
+                    const name = String(a.name ?? '');
+                    const path = String(a.path ?? '');
+                    const content = names.includes(name) ? await source.readFile(name, path) : null;
+                    if (content === null) {
+                        const skill = names.includes(name) ? await source.open(name) : null;
+                        throw new Error(`No file "${path}" in skill "${name}". Files: ${skill ? skill.files.join(', ') : 'unknown skill'}`);
+                    }
+                    return cap(content);
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

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

package/dist/testing.d.ts

@@ -0,0 +1,36 @@
+/**
+ * A scripted ModelProvider — the engine's own tests, and any app's, run offline on it.
+ *
+ * The worker replies from a script, in order; Jev answers through a function (or picks the first
+ * option of every choice, which is "task" for the opening decision and "none" for skills). Every
+ * request is recorded, so a test can assert what the model was shown. It spends nothing unless the
+ * script says a step cost something — which is how a budget cap is tested without a key.
+ */
+import type { Answer, ChatReply, ChatRequest, ModelCard, ModelProvider, Question } from './model.ts';
+export type ScriptStep = string | {
+    text?: string | null;
+    calls?: {
+        name: string;
+        args?: Record<string, unknown> | string;
+    }[];
+    cost?: number;
+} | ((request: ChatRequest) => ChatReply | Promise<ChatReply>);
+export type ScriptedDecide = (state: unknown, questions: Record<string, Question>) => Record<string, Answer> | Promise<Record<string, Answer>>;
+export interface ScriptedModel extends ModelProvider {
+    /** Every chat request, in order (messages copied as they were at the time). */
+    requests: ChatRequest[];
+    /** Every decide call, in order. */
+    decisions: {
+        state: unknown;
+        questions: Record<string, Question>;
+    }[];
+}
+/** Jev's default stub: the first option of every choice, 0.5 for yes/no, the first level of a score. */
+export declare const firstOption: ScriptedDecide;
+export declare function scriptedModel(script: ScriptStep[], options?: {
+    decide?: ScriptedDecide | false;
+    decideCost?: number;
+    model?: string; /** What `card()` says of the worker (how the guide sizes it up). */
+    card?: Partial<ModelCard>;
+}): ScriptedModel;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAY,MAAM,YAAY,CAAC;AAE/G,MAAM,MAAM,UAAU,GAClB,MAAM,GACN;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5G,CAAC,CAAC,OAAO,EAAE,WAAW,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAE/D,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/I,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,+EAA+E;IAC/E,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,mCAAmC;IACnC,SAAS,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;KAAE,EAAE,CAAC;CACtE;AAED,wGAAwG;AACxG,eAAO,MAAM,WAAW,EAAE,cAWvB,CAAC;AAIJ,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,cAAc,GAAG,KAAK,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,oEAAoE;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;CAAO,GAAG,aAAa,CA2CzP"}

package/dist/testing.js

@@ -0,0 +1,60 @@
+/** Jev's default stub: the first option of every choice, 0.5 for yes/no, the first level of a score. */
+export const firstOption = (_state, questions) => Object.fromEntries(Object.entries(questions).map(([id, q]) => {
+    if (q.type === 'noul')
+        return [id, { type: 'noul', noul: 0.5 }];
+    if (q.type === 'choice') {
+        const keys = Object.keys(q.criteria);
+        const first = keys[0] ?? '';
+        return [id, { type: 'choice', choice: first, confidence: 1, probabilities: Object.fromEntries(keys.map(k => [k, k === first ? 1 : 0])) }];
+    }
+    return [id, { type: 'score', score: 0, confidence: 1, probabilities: { '0': 1 }, legend: { '0': String(q.criteria[0] ?? '') } }];
+}));
+let seq = 0;
+export function scriptedModel(script, options = {}) {
+    const queue = [...script];
+    const requests = [];
+    const decisions = [];
+    const provider = {
+        defaultModel: options.model ?? 'stub/worker',
+        requests,
+        decisions,
+        async chat(request) {
+            request.signal?.throwIfAborted();
+            requests.push({ ...request, messages: structuredClone(request.messages) });
+            const step = queue.shift();
+            if (step === undefined)
+                throw new Error(`The script ran out after ${requests.length - 1} replies.`);
+            if (typeof step === 'function')
+                return step(request);
+            const s = typeof step === 'string' ? { text: step } : step;
+            const calls = (s.calls ?? []).map(c => ({
+                id: `call_${++seq}`,
+                type: 'function',
+                function: { name: c.name, arguments: typeof c.args === 'string' ? c.args : JSON.stringify(c.args ?? {}) },
+            }));
+            const text = s.text ?? null;
+            if (text && request.onDelta)
+                request.onDelta(text);
+            return {
+                message: { role: 'assistant', content: text, ...(calls.length ? { tool_calls: calls } : {}) },
+                finishReason: calls.length ? 'tool_calls' : 'stop',
+                model: request.model ?? provider.defaultModel ?? 'stub/worker',
+                cost: s.cost ?? 0,
+            };
+        },
+    };
+    if (options.card) {
+        const card = options.card;
+        provider.card = async (model) => ({ id: model, name: model, prompt: 0, completion: 0, context: 128_000, tools: true, vision: false, ...card });
+    }
+    if (options.decide !== false) {
+        const answer = options.decide ?? firstOption;
+        provider.decide = async (state, questions, signal) => {
+            signal?.throwIfAborted();
+            decisions.push({ state: structuredClone(state), questions: structuredClone(questions) });
+            return { answers: (await answer(state, questions)), cost: options.decideCost ?? 0 };
+        };
+    }
+    return provider;
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Tools — what an app hands the engine, and the helpers every app ended up writing.
+ *
+ * A tool is a spec the model reads plus a `run`. A tool that CHANGES something says so with
+ * `write.describe`: the loop then never runs it on the model's say-so, it asks the app's `approve`
+ * first with that one-line account of the change. That split lives on the tool, not in the loop,
+ * because only the tool knows whether THIS call writes (an action tool may read or write depending
+ * on its arguments).
+ *
+ * `foldTools` exists because a few general tools beat many narrow ones (Pi's lesson, confirmed in
+ * Potion's evaluation): a router that offered only some tools per step was the main cause of
+ * "I have no tool for that". Folding keeps every action visible in ONE tool's description while
+ * each still runs, and asks approval, exactly as before.
+ *
+ * Arguments are read forgivingly (`forgivingArgs`, `readCall`): models send JSON as a string, put
+ * arguments beside `action` instead of inside `args`, or (GLM) pack them into the action name. Each
+ * of those used to cost a failed step; each is a harmless encoding slip, so it is read as meant.
+ */
+import type { ToolSpec } from './model.ts';
+export interface ToolContext {
+    signal: AbortSignal;
+    /** Add USD this tool spent (a model it consulted, a sub-agent) to the run's total and budget. */
+    spend(usd: number): void;
+    /** The model's id for this call. */
+    callId: string;
+}
+export interface AgentTool extends ToolSpec {
+    /** Whatever it returns is handed to the model as text (objects as JSON). A throw is reported to the model, not to the caller. */
+    run(args: Record<string, unknown>, ctx: ToolContext): Promise<unknown>;
+    /** A change: its approval sentence (may need a lookup). Null = this particular call only reads. */
+    write?: {
+        describe(args: Record<string, unknown>): string | null | Promise<string | null>;
+    };
+}
+/** A group of tools: one MCP server, one area of an app, one page's buttons. */
+export interface Toolset {
+    /** A short stable key: "notes", "github-mcp". */
+    name: string;
+    /** What it is for. */
+    description: string;
+    tools: AgentTool[];
+}
+export interface ApprovalRequest {
+    id: string;
+    tool: string;
+    summary: string;
+    args: Record<string, unknown>;
+}
+/**
+ * JSON with keys sorted at every level: the same call written in another key order is the same
+ * call. Not JSON.stringify(v, keys): an array replacer is an allowlist applied at EVERY depth, so
+ * it emptied nested arguments — every call looked like a repeat of the first, and the repeat guard
+ * locked the model out after one miss.
+ */
+export declare function stableJson(v: unknown): string;
+/** Parse arguments a model sent as JSON strings; leave everything else as it is. */
+export declare function forgivingArgs(args: unknown): Record<string, unknown>;
+/** The action and its arguments of a folded call, however the model sent them. */
+export declare function readCall(a: Record<string, unknown>): {
+    name: string;
+    args: Record<string, unknown>;
+};
+export interface FoldOptions {
+    /** The folded tool's name, e.g. the app's name. */
+    name: string;
+    /** The first line of its description: what it reaches. */
+    description: string;
+    /** Appended after the action reference: query grammars, argument shapes a model guesses wrong. */
+    appendix?: string;
+}
+/**
+ * Fold toolsets into ONE tool called as { action, args }. Its description is a compact reference of
+ * every action. Reads run directly; an action with `write` still asks approval (the folded tool's
+ * `write.describe` delegates, and says null for a read).
+ */
+export declare function foldTools(toolsets: Toolset[], options: FoldOptions): AgentTool;
+/**
+ * The shape of an MCP connection this engine can use. Structural on purpose: ensemble's
+ * `connect()` session satisfies it as-is, and any other client can with a three-line adapter.
+ * The engine speaks no MCP wire protocol itself — connecting (stdio, HTTP, OAuth) is the app's job.
+ */
+export interface McpLike {
+    name: string;
+    listTools(options?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        name: string;
+        description?: string;
+        inputSchema?: Record<string, unknown>;
+    }[]>;
+    call(tool: string, args: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        text: string;
+        data?: unknown;
+        isError: boolean;
+    }>;
+}
+export interface McpToolsetOptions {
+    /** Default: the session's name. */
+    name?: string;
+    description?: string;
+    /** Only these tools (by name). */
+    only?: string[];
+    /**
+     * Which calls CHANGE something, and the sentence the person approves. MCP servers do not say
+     * reliably (annotations are hints), so the app decides. Default: every call is a read.
+     */
+    writes?: (tool: string, args: Record<string, unknown>) => string | null | Promise<string | null>;
+    signal?: AbortSignal;
+}
+/** One MCP server's tools as a Toolset. */
+export declare function mcpToolset(session: McpLike, options?: McpToolsetOptions): Promise<Toolset>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

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

package/dist/tools.js

@@ -0,0 +1,136 @@
+/**
+ * JSON with keys sorted at every level: the same call written in another key order is the same
+ * call. Not JSON.stringify(v, keys): an array replacer is an allowlist applied at EVERY depth, so
+ * it emptied nested arguments — every call looked like a repeat of the first, and the repeat guard
+ * locked the model out after one miss.
+ */
+export function stableJson(v) {
+    if (Array.isArray(v))
+        return `[${v.map(stableJson).join(',')}]`;
+    if (v && typeof v === 'object') {
+        const o = v;
+        return `{${Object.keys(o)
+            .sort()
+            .filter(k => o[k] !== undefined)
+            .map(k => `${JSON.stringify(k)}:${stableJson(o[k])}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(v) ?? 'null';
+}
+function safeParse(s) {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Parse arguments a model sent as JSON strings; leave everything else as it is. */
+export function forgivingArgs(args) {
+    const raw = typeof args === 'string' ? safeParse(args) : args;
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(raw)) {
+        if (typeof v === 'string' && /^\s*[[{]/.test(v)) {
+            const parsed = safeParse(v);
+            out[k] = parsed !== undefined && typeof parsed === 'object' ? parsed : v;
+        }
+        else
+            out[k] = v;
+    }
+    return out;
+}
+/** The action and its arguments of a folded call, however the model sent them. */
+export function readCall(a) {
+    let name = String(a.action ?? '').trim();
+    const packed = {};
+    if (name.includes('<arg_key>')) {
+        for (const m of name.matchAll(/<arg_key>([\s\S]*?)<\/arg_key>\s*<arg_value>([\s\S]*?)(?:<\/arg_value>|$)/g)) {
+            const value = (m[2] ?? '').trim();
+            const parsed = /^[[{"]|^-?\d|^(true|false|null)$/.test(value) ? safeParse(value) : undefined;
+            packed[(m[1] ?? '').trim()] = parsed !== undefined ? parsed : value;
+        }
+        name = name.slice(0, name.indexOf('<')).trim();
+    }
+    const { action: _action, args: nested, ...beside } = a;
+    const fromPacked = packed.args && typeof packed.args === 'object' ? packed.args : {};
+    const { args: _packedArgs, ...packedRest } = packed;
+    return { name, args: forgivingArgs({ ...beside, ...fromPacked, ...packedRest, ...forgivingArgs(nested) }) };
+}
+/** A compact argument signature from a JSON Schema: { query, limit? }. */
+function signature(tool) {
+    const p = tool.parameters;
+    if (!p?.properties || !Object.keys(p.properties).length)
+        return '{}';
+    const req = new Set(p.required ?? []);
+    return `{ ${Object.keys(p.properties)
+        .map(k => (req.has(k) ? k : `${k}?`))
+        .join(', ')} }`;
+}
+/** The first sentence of a description. */
+function gist(tool) {
+    const d = tool.description.trim();
+    const first = d.split(/(?<=\.)\s/)[0] ?? d;
+    return first.length > 140 ? `${first.slice(0, 140)}…` : first;
+}
+/**
+ * Fold toolsets into ONE tool called as { action, args }. Its description is a compact reference of
+ * every action. Reads run directly; an action with `write` still asks approval (the folded tool's
+ * `write.describe` delegates, and says null for a read).
+ */
+export function foldTools(toolsets, options) {
+    const byName = new Map(toolsets.flatMap(s => s.tools).map(t => [t.name, t]));
+    const names = [...byName.keys()];
+    const reference = toolsets
+        .map(s => `${s.name.replace(/_/g, ' ')}:\n${s.tools.map(t => `  ${t.name} ${signature(t)}${t.write ? ' [asks approval]' : ''} — ${gist(t)}`).join('\n')}`)
+        .join('\n');
+    return {
+        name: options.name,
+        description: [`${options.description} Call as { action, args }. Actions marked [asks approval] run only once the person approves.`, reference, options.appendix]
+            .filter(Boolean)
+            .join('\n'),
+        parameters: {
+            type: 'object',
+            properties: {
+                action: { type: 'string', enum: names },
+                args: { type: 'object', description: "The action's arguments, as listed", additionalProperties: true },
+            },
+            required: ['action'],
+        },
+        write: {
+            describe: a => {
+                const call = readCall(a);
+                const t = byName.get(call.name);
+                return t?.write ? t.write.describe(call.args) : null;
+            },
+        },
+        run: async (a, ctx) => {
+            const call = readCall(a);
+            const t = byName.get(call.name);
+            if (!t)
+                throw new Error(`There is no action "${call.name}". Actions: ${names.join(', ')}`);
+            return t.run(call.args, ctx);
+        },
+    };
+}
+/** One MCP server's tools as a Toolset. */
+export async function mcpToolset(session, options = {}) {
+    const listed = await session.listTools({ signal: options.signal });
+    const tools = listed
+        .filter(t => !options.only || options.only.includes(t.name))
+        .map(t => ({
+        name: t.name,
+        description: t.description ?? t.name,
+        parameters: t.inputSchema ?? { type: 'object', properties: {} },
+        ...(options.writes ? { write: { describe: (args) => options.writes(t.name, args) } } : {}),
+        run: async (args, ctx) => {
+            const out = await session.call(t.name, args, { signal: ctx.signal });
+            if (out.isError)
+                throw new Error(out.text || `${t.name} failed`);
+            return out.data ?? out.text;
+        },
+    }));
+    return { name: options.name ?? session.name, description: options.description ?? `Tools of the ${session.name} MCP server.`, tools };
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@ghostmind-dev/agent",
+  "version": "0.1.0",
+  "description": "The agent engine every app builds its own agent from: the tool loop and its guards, a model seam (OpenRouter + Jev), budgets with a USD cap, go/pause/stop hooks, and an append-only event log. A library, not a service.",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "agent",
+    "tool-loop",
+    "llm",
+    "openrouter",
+    "jev",
+    "typesafe",
+    "mcp",
+    "agent-skills",
+    "hooks",
+    "budget"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "node test/run.mts",
+    "pretest": "npm run build",
+    "example": "node examples/two-tools.mts",
+    "bench": "node bench/guidance.mts",
+    "prepublishOnly": "npm run typecheck && npm test"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}