@animalabs/agent-framework 0.28.0 → 0.30.0

package/dist/src/host-presentation.js

@@ -0,0 +1,565 @@
+/**
+ * The host's own toolsets (MCPL RFC-014 §8.5 host-made toolsets, §8.1 surface
+ * presentation): how tools outside an agent's tool list are presented, for
+ * the framework's built-in tools and for MCPL servers alike. It's host
+ * presentation, not an MCPL wire change: it works for every server, with or
+ * without RFC-014.
+ *
+ * - **The built-in toolset** (`settings`): the host tools an agent reaches
+ *   for rarely (its settings, wake rules, observers, MCPL administration,
+ *   status reads, modules' utilities, and every tool the agent hid from its
+ *   own list). None of them is in the tool list; `toolsets--open` shows them,
+ *   `toolsets--act` calls them while it's open.
+ * - **MCPL server tabs**: each server is presented to each agent one of three
+ *   ways. `full`: its tools in the tool list, as before. `tab` (a hidden
+ *   tab): connected, its events still arrive, but none of its tools is in the
+ *   tool list; `toolsets--open {server}` shows them and lets `toolsets--act`
+ *   call them, `toolsets--close {server}` hides them again. `closed-tab`:
+ *   disconnected until `toolsets--open {server}` reconnects it.
+ *
+ * The tool list (the request's header) changes only when a server switches
+ * between full and a tab, or a tool is hidden or shown: opening, acting in and
+ * closing a toolset never change it, so the prompt cache stays.
+ *
+ * State lives in one JSON file per store (`config/toolsets.json`): per agent,
+ * which host toolsets are open and each server's presentation where it
+ * differs from the configured default; per server (host-wide, since a
+ * connection is the host's), whether it is disconnected as a closed tab.
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { checkArgs, firstSentence, renderToolDefinition, signature } from './mcpl/tool-signature.js';
+import { META_TOOL_NAMES } from './mcpl/toolset-host.js';
+/** The built-in toolset's name, as agents address it (`toolsets--open {toolset: "settings"}`). */
+export const BUILTIN_TOOLSET = 'settings';
+export const SERVER_PRESENTATIONS = ['full', 'tab', 'closed-tab'];
+const emptyDoc = () => ({ version: 1, agents: {}, closed: {} });
+const isObj = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+function parseDoc(raw) {
+    const parsed = JSON.parse(raw);
+    if (!isObj(parsed) || parsed.version !== 1)
+        throw new Error('not a version 1 toolsets state');
+    const doc = emptyDoc();
+    if (isObj(parsed.agents)) {
+        for (const [name, value] of Object.entries(parsed.agents)) {
+            if (!isObj(value))
+                continue;
+            const open = Array.isArray(value.open) ? value.open.filter((x) => typeof x === 'string') : [];
+            const servers = {};
+            if (isObj(value.servers)) {
+                for (const [id, mode] of Object.entries(value.servers))
+                    if (mode === 'full' || mode === 'tab')
+                        servers[id] = mode;
+            }
+            doc.agents[name] = { open, servers };
+        }
+    }
+    if (isObj(parsed.closed)) {
+        for (const [id, closed] of Object.entries(parsed.closed))
+            if (typeof closed === 'boolean')
+                doc.closed[id] = closed;
+    }
+    return doc;
+}
+const tabKey = (serverId) => `server:${serverId}`;
+export class HostPresentation {
+    deps;
+    statePath;
+    doc;
+    constructor(deps, statePath) {
+        this.deps = deps;
+        this.statePath = statePath;
+        this.doc = emptyDoc();
+        if (statePath && existsSync(statePath)) {
+            try {
+                this.doc = parseDoc(readFileSync(statePath, 'utf8'));
+            }
+            catch (error) {
+                // Kept, not written over: moved aside, so what an agent chose can be
+                // read back by whoever runs the host.
+                const aside = `${statePath}.unreadable-${new Date().toISOString().replace(/[:.]/g, '-')}`;
+                let moved = false;
+                try {
+                    renameSync(statePath, aside);
+                    moved = true;
+                }
+                catch { /* left where it is */ }
+                deps.log(`[toolsets] ${statePath} can't be read (${error instanceof Error ? error.message : String(error)}); `
+                    + (moved ? `moved aside to ${aside}; ` : 'left as it is, and not written to; ')
+                    + 'starting from the configured presentation');
+                if (!moved)
+                    this.unwritable = true;
+            }
+        }
+    }
+    /** An unreadable state file that couldn't be moved aside is never written over. */
+    unwritable = false;
+    /** Reconnects of closed tabs under way, so two opens make one connect. */
+    reconnecting = new Map();
+    /** Each server's opens and closes, one at a time: a disconnect's guard holds until it's done. */
+    serverOps = new Map();
+    serially(serverId, op) {
+        const before = this.serverOps.get(serverId) ?? Promise.resolve();
+        const run = before.then(op, op);
+        const settled = run.catch(() => undefined);
+        this.serverOps.set(serverId, settled);
+        void settled.then(() => { if (this.serverOps.get(serverId) === settled)
+            this.serverOps.delete(serverId); });
+        return run;
+    }
+    save() {
+        if (!this.statePath || this.unwritable)
+            return;
+        // An agent with nothing open and nothing chosen has no state to keep.
+        for (const [name, a] of Object.entries(this.doc.agents)) {
+            if (a.open.length === 0 && Object.keys(a.servers).length === 0)
+                delete this.doc.agents[name];
+        }
+        try {
+            mkdirSync(dirname(this.statePath), { recursive: true });
+            const tmp = `${this.statePath}.tmp`;
+            writeFileSync(tmp, JSON.stringify(this.doc, null, 2) + '\n');
+            renameSync(tmp, this.statePath);
+        }
+        catch (error) {
+            this.deps.log(`[toolsets] couldn't save ${this.statePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    agent(name) {
+        return (this.doc.agents[name] ??= { open: [], servers: {} });
+    }
+    // ── what's known ──
+    /** Whether the host presents anything outside this agent's tool list. */
+    active(agentName) {
+        return this.deps.canUseMeta(agentName);
+    }
+    server(id) {
+        return this.deps.servers().find((s) => s.id === id);
+    }
+    /** Whether a server is kept disconnected as a closed tab (host-wide). */
+    isClosedTab(serverId) {
+        const set = this.doc.closed[serverId];
+        if (set !== undefined)
+            return set;
+        // A configured closed tab is closed until it's connected (by an open, or
+        // a runtime connect that didn't ask).
+        const server = this.server(serverId);
+        return server?.configured === 'closed-tab' && !server.connected;
+    }
+    /** The agent whose presentation `agentName` is shown (HostPresentationDeps.ownerOf). */
+    ownerOf(agentName) {
+        return this.deps.ownerOf?.(agentName) ?? agentName;
+    }
+    /** How a server is presented to an agent now. */
+    presentation(agentName, serverId) {
+        if (this.isClosedTab(serverId))
+            return 'closed-tab';
+        const chosen = this.doc.agents[this.ownerOf(agentName)]?.servers[serverId];
+        if (chosen)
+            return chosen;
+        const configured = this.server(serverId)?.configured ?? 'full';
+        return configured === 'closed-tab' ? 'tab' : configured;
+    }
+    /** Servers to leave unconnected at startup: closed tabs, by state or by configured default. */
+    startClosed(configs) {
+        const out = new Set();
+        for (const c of configs) {
+            const set = this.doc.closed[c.id];
+            if (set === true || (set === undefined && c.presentation === 'closed-tab'))
+                out.add(c.id);
+        }
+        return out;
+    }
+    isOpen(agentName, key) {
+        return this.doc.agents[this.ownerOf(agentName)]?.open.includes(key) ?? false;
+    }
+    setOpen(agentName, key, open) {
+        const a = this.agent(agentName);
+        const has = a.open.includes(key);
+        if (open && !has)
+            a.open.push(key);
+        if (!open && has)
+            a.open = a.open.filter((k) => k !== key);
+        this.save();
+    }
+    // ── the tool list ──
+    /** The tool list an agent is shown: what it may call, less the built-in toolset and its tabs. */
+    header(agentName, tools, active = this.active(agentName)) {
+        // Without the meta-tools nothing is presented out of the tool list, but a
+        // utility still isn't in it: it was never a tool-list tool.
+        if (!active)
+            return tools.filter((t) => isMetaTool(t.name) || !this.deps.isUtility(t.name));
+        return tools.filter((t) => !this.outOfHeader(agentName, t.name));
+    }
+    outOfHeader(agentName, name) {
+        if (isMetaTool(name))
+            return false;
+        // A utility is never a tool-list tool, presented here or not.
+        if (this.deps.isUtility(name))
+            return true;
+        const server = this.deps.serverOf(name);
+        if (server)
+            return this.presentation(agentName, server) !== 'full';
+        return this.deps.placedInBuiltin(name);
+    }
+    /** The built-in toolset's tools for an agent: its placed tools, and the host tools it hid. */
+    builtinTools(agentName) {
+        const hidden = this.deps.hidden(agentName);
+        return this.deps.available(agentName).filter((t) => !isMetaTool(t.name) && this.deps.serverOf(t.name) === null && (this.deps.placedInBuiltin(t.name) || hidden.has(t.name)));
+    }
+    /** A server's tab's tools for an agent: all of them in a tab, its hidden ones while it's full. */
+    tabTools(agentName, serverId) {
+        const full = this.presentation(agentName, serverId) === 'full';
+        const hidden = this.deps.hidden(agentName);
+        return this.deps.available(agentName).filter((t) => this.deps.serverOf(t.name) === serverId && (!full || hidden.has(t.name)));
+    }
+    // ── what an agent is told ──
+    announce(label, tools, closeHint) {
+        const lines = [`${label} open: call these with ${META_TOOL_NAMES.act} {tool, args}; they aren't in your tool list.`];
+        if (!tools.length)
+            lines.push('  (none right now)');
+        for (const t of tools) {
+            const sentence = firstSentence(t.description);
+            lines.push(`  ${signature(t)}${sentence ? ` — ${sentence}` : ''}`);
+        }
+        lines.push(`${closeHint} closes it.`);
+        return lines.join('\n');
+    }
+    builtinLabel = `[${BUILTIN_TOOLSET}]`;
+    tabLabel = (serverId) => `[tab ${serverId}]`;
+    /** The catalog lines `toolsets--look` begins with. */
+    catalog(agentName) {
+        const builtin = this.builtinTools(agentName);
+        const lines = [
+            `${this.builtinLabel} the host's settings and controls (${builtin.length} tool${builtin.length === 1 ? '' : 's'}): ` +
+                (this.isOpen(agentName, BUILTIN_TOOLSET)
+                    ? `open — ${META_TOOL_NAMES.look} {toolset:"${BUILTIN_TOOLSET}"} lists them`
+                    : `closed — ${META_TOOL_NAMES.open} {toolset:"${BUILTIN_TOOLSET}"} opens it`),
+        ];
+        for (const s of this.deps.servers()) {
+            const mode = this.presentation(agentName, s.id);
+            const tabTools = this.tabTools(agentName, s.id);
+            if (mode === 'full') {
+                if (tabTools.length)
+                    lines.push(`${this.tabLabel(s.id)} in your tool list; ${tabTools.length} hidden tool${tabTools.length === 1 ? '' : 's'} in its tab (${this.isOpen(agentName, tabKey(s.id)) ? 'open' : `closed — ${META_TOOL_NAMES.open} {server:"${s.id}"} opens it`})`);
+                else
+                    lines.push(`${this.tabLabel(s.id)} in your tool list — ${META_TOOL_NAMES.close} {server:"${s.id}"} moves it to a tab`);
+            }
+            else if (mode === 'tab') {
+                lines.push(`${this.tabLabel(s.id)} a tab, connected (${tabTools.length} tool${tabTools.length === 1 ? '' : 's'}): ` +
+                    (this.isOpen(agentName, tabKey(s.id)) ? 'open' : `hidden — ${META_TOOL_NAMES.open} {server:"${s.id}"} opens it`) +
+                    `; ${META_TOOL_NAMES.open} {server:"${s.id}", full:true} puts it back in your tool list`);
+            }
+            else {
+                lines.push(`${this.tabLabel(s.id)} a closed tab, disconnected: ${META_TOOL_NAMES.open} {server:"${s.id}"} connects and opens it`);
+            }
+        }
+        return lines;
+    }
+    /** `toolsets--look {toolset:"settings"}` or `{server}`: one host toolset's tools. */
+    lookToolset(agentName, which) {
+        if ('builtin' in which) {
+            const tools = this.builtinTools(agentName);
+            const open = this.isOpen(agentName, BUILTIN_TOOLSET);
+            return [
+                `${this.builtinLabel} ${open ? 'open' : 'closed'}${open ? '' : ` — ${META_TOOL_NAMES.open} {toolset:"${BUILTIN_TOOLSET}"} opens it`}`,
+                ...tools.map((t) => `  ${signature(t)}${firstSentence(t.description) ? ` — ${firstSentence(t.description)}` : ''}`),
+            ].join('\n');
+        }
+        const { serverId } = which;
+        const mode = this.presentation(agentName, serverId);
+        if (mode === 'closed-tab')
+            return `${this.tabLabel(serverId)} a closed tab, disconnected: ${META_TOOL_NAMES.open} {server:"${serverId}"} connects and opens it.`;
+        const tools = this.tabTools(agentName, serverId);
+        const open = this.isOpen(agentName, tabKey(serverId));
+        const head = mode === 'full'
+            ? `${this.tabLabel(serverId)} in your tool list${tools.length ? `; its hidden tools (${open ? 'open' : 'closed'}):` : '.'}`
+            : `${this.tabLabel(serverId)} a tab, connected, ${open ? 'open' : `hidden — ${META_TOOL_NAMES.open} {server:"${serverId}"} opens it`}:`;
+        return [head, ...tools.map((t) => `  ${signature(t)}${firstSentence(t.description) ? ` — ${firstSentence(t.description)}` : ''}`)].join('\n');
+    }
+    /** `toolsets--look {tool}` for a host toolset's tool, or null when no host toolset has it. */
+    lookTool(agentName, tool, serverId) {
+        const def = this.listedTool(agentName, tool, serverId);
+        if (!def)
+            return null;
+        return `${renderToolDefinition(def)}\n${this.homeOf(agentName, def.name)}`;
+    }
+    /**
+     * A host toolset's tool as the agent has it listed, by its name, or with
+     * its server named by the name the server gave it (as act and look take it).
+     */
+    listedTool(agentName, tool, server) {
+        const inTabs = this.deps.servers().filter((s) => !server || s.id === server).flatMap((s) => this.tabTools(agentName, s.id));
+        return (!server ? this.builtinTools(agentName).find((t) => t.name === tool) : undefined)
+            ?? inTabs.find((t) => t.name === tool)
+            ?? (server ? inTabs.find((t) => t.name.endsWith(`--${tool}`) && this.deps.serverOf(t.name) === server) : undefined);
+    }
+    homeOf(agentName, name) {
+        const server = this.deps.serverOf(name);
+        if (server)
+            return `in ${this.tabLabel(server)} (${this.isOpen(agentName, tabKey(server)) ? 'open' : 'closed'})`;
+        return `in ${this.builtinLabel} (${this.isOpen(agentName, BUILTIN_TOOLSET) ? 'open' : 'closed'})`;
+    }
+    // ── open and close ──
+    /** `toolsets--open {toolset:"settings"}`. */
+    openBuiltin(agentName) {
+        this.setOpen(agentName, BUILTIN_TOOLSET, true);
+        return this.announce(this.builtinLabel, this.builtinTools(agentName), `${META_TOOL_NAMES.close} {toolset:"${BUILTIN_TOOLSET}"}`);
+    }
+    /** `toolsets--close {toolset:"settings"}`. */
+    closeBuiltin(agentName) {
+        const was = this.isOpen(agentName, BUILTIN_TOOLSET);
+        this.setOpen(agentName, BUILTIN_TOOLSET, false);
+        return was ? `${this.builtinLabel} closed.` : `${this.builtinLabel} wasn't open.`;
+    }
+    /** Whether a server id names a server the host presents (connected, or a closed tab). */
+    knows(serverId) {
+        return this.server(serverId) !== undefined;
+    }
+    /** Connect a closed tab again: one connect, whoever else asks meanwhile. */
+    async reconnect(serverId) {
+        let pending = this.reconnecting.get(serverId);
+        if (!pending) {
+            pending = (async () => {
+                await this.deps.reconnect(serverId);
+                this.doc.closed[serverId] = false;
+            })().finally(() => this.reconnecting.delete(serverId));
+            this.reconnecting.set(serverId, pending);
+        }
+        await pending;
+    }
+    /**
+     * `toolsets--open {server}`: a closed tab is connected again; a tab's tools
+     * are shown and callable through act; with `full`, the server goes back
+     * into the tool list (one change of the tool list).
+     */
+    openServer(agentName, serverId, opts = {}) {
+        return this.serially(serverId, () => this.runOpenServer(agentName, serverId, opts));
+    }
+    async runOpenServer(agentName, serverId, opts) {
+        const said = [];
+        if (this.isClosedTab(serverId) || this.reconnecting.has(serverId)) {
+            await this.reconnect(serverId);
+            said.push(`${serverId} connected.`);
+        }
+        const a = this.agent(agentName);
+        try {
+            if (opts.full) {
+                const was = this.presentation(agentName, serverId);
+                a.servers[serverId] = 'full';
+                a.open = a.open.filter((k) => k !== tabKey(serverId));
+                said.push(was === 'full'
+                    ? `${serverId} is in your tool list already.`
+                    : `${serverId}'s tools are back in your tool list from your next request (your tool list changed, so that request writes its prompt cache again).`);
+                return said.join('\n');
+            }
+            if (this.presentation(agentName, serverId) === 'full' && !this.tabTools(agentName, serverId).length) {
+                said.push(`${serverId}'s tools are in your tool list: call them by name. ${META_TOOL_NAMES.close} {server:"${serverId}"} moves it to a tab.`);
+                return said.join('\n');
+            }
+            if (!a.open.includes(tabKey(serverId)))
+                a.open.push(tabKey(serverId));
+            said.push(this.announce(this.tabLabel(serverId), this.tabTools(agentName, serverId), `${META_TOOL_NAMES.close} {server:"${serverId}"}`));
+            return said.join('\n');
+        }
+        finally {
+            this.save();
+        }
+    }
+    /**
+     * The other resident agents a server's disconnect would take it from. One
+     * the host presents things to out of its tool list uses the server while
+     * it's in that list or its tab is open; one that can't use the meta-tools
+     * has every server in its list and couldn't open a closed tab again, so it
+     * always does. A connection is the host's, so one agent's closed tab is
+     * every agent's.
+     */
+    otherUsers(agentName, serverId) {
+        return this.deps.residents().filter((other) => other !== agentName
+            && (!this.active(other) || this.presentation(other, serverId) === 'full' || this.isOpen(other, tabKey(serverId))));
+    }
+    /**
+     * `toolsets--close {server}`: a server in the tool list moves to a tab (one
+     * change of the tool list); an open tab is hidden; with `disconnect`, the
+     * server is disconnected as a closed tab until it's opened again, unless
+     * another resident agent still uses it. The disconnect comes first: one
+     * that fails changes nothing.
+     */
+    closeServer(agentName, serverId, opts = {}) {
+        return this.serially(serverId, () => this.runCloseServer(agentName, serverId, opts));
+    }
+    async runCloseServer(agentName, serverId, opts) {
+        const was = this.presentation(agentName, serverId);
+        const wasOpen = this.isOpen(agentName, tabKey(serverId));
+        let disconnected = false;
+        if (opts.disconnect && !this.isClosedTab(serverId)) {
+            const users = this.otherUsers(agentName, serverId);
+            if (users.length) {
+                return `${serverId} wasn't disconnected: ${users.join(', ')} still ${users.length === 1 ? 'uses' : 'use'} it, ` +
+                    `and a connection is the host's, every agent's. Nothing was changed. ` +
+                    `${META_TOOL_NAMES.close} {server:"${serverId}"} without disconnect moves it out of your own tool list.`;
+            }
+            await this.deps.disconnect(serverId);
+            this.doc.closed[serverId] = true;
+            disconnected = true;
+        }
+        const said = [];
+        const a = this.agent(agentName);
+        try {
+            if (was === 'full') {
+                a.servers[serverId] = 'tab';
+                said.push(`${serverId}'s tools leave your tool list from your next request (your tool list changed, so that request writes its prompt cache again); its tab: ${META_TOOL_NAMES.open} {server:"${serverId}"}.`);
+            }
+            else if (wasOpen) {
+                said.push(disconnected ? `${this.tabLabel(serverId)} hidden.` : `${this.tabLabel(serverId)} hidden; it stays connected.`);
+            }
+            a.open = a.open.filter((k) => k !== tabKey(serverId));
+            if (disconnected)
+                said.push(`${serverId} disconnected: none of its events reach you until ${META_TOOL_NAMES.open} {server:"${serverId}"} connects it again.`);
+            else if (opts.disconnect)
+                said.push(`${serverId} is disconnected already.`);
+        }
+        finally {
+            this.save();
+        }
+        if (!said.length)
+            said.push(`${this.tabLabel(serverId)} is hidden already.`);
+        return said.join('\n');
+    }
+    /** A server connected by other means (an operator's connect, a deploy): no longer a closed tab. */
+    noteConnected(serverId, wasClosedTab = false) {
+        // Closed by an agent, or by its configured default (the caller says,
+        // from the configuration it kept): connected against it now, which is
+        // kept across restarts. A server that wasn't a closed tab writes
+        // nothing, so a configured closed-tab default still applies at startup.
+        if (wasClosedTab || this.doc.closed[serverId] === true) {
+            this.doc.closed[serverId] = false;
+            this.save();
+        }
+    }
+    /** A server's saved closed state: true closed, false connected against a closed-tab default, undefined neither. */
+    closedState(serverId) {
+        return this.doc.closed[serverId];
+    }
+    /** A connect refused before anything changed: its closed tab is put back as it was. */
+    restoreClosed(serverId, was) {
+        if (was === undefined)
+            delete this.doc.closed[serverId];
+        else
+            this.doc.closed[serverId] = was;
+        this.save();
+    }
+    /** A server removed for good (an operator's disconnect): nothing of its tab is kept. */
+    noteRemoved(serverId) {
+        let changed = false;
+        if (serverId in this.doc.closed) {
+            delete this.doc.closed[serverId];
+            changed = true;
+        }
+        for (const a of Object.values(this.doc.agents)) {
+            if (serverId in a.servers) {
+                delete a.servers[serverId];
+                changed = true;
+            }
+            const open = a.open.filter((k) => k !== tabKey(serverId));
+            if (open.length !== a.open.length) {
+                a.open = open;
+                changed = true;
+            }
+        }
+        if (changed)
+            this.save();
+    }
+    // ── act ──
+    /**
+     * `toolsets--act` for a host toolset's tool: the call it makes, under the
+     * tool's own name; a refusal when its toolset isn't open or its arguments
+     * don't fit its definition; null when no host toolset has the tool (an
+     * RFC-014 dynamic tool's call goes on to the server's toolsets). A
+     * server's tool may be named in full, or bare with `server`.
+     */
+    resolveAct(agentName, input) {
+        if (!this.active(agentName))
+            return null;
+        const args = isObj(input) ? input : {};
+        const tool = typeof args.tool === 'string' ? args.tool.trim() : '';
+        if (!tool)
+            return null;
+        const server = typeof args.server === 'string' && args.server.trim() ? args.server.trim() : undefined;
+        const listed = this.listedTool(agentName, tool, server);
+        // A host toolset's tool the agent may not call isn't listed to it; its
+        // call still goes on, by name, for dispatch to refuse as it would a
+        // direct call, rather than reading as no such tool.
+        const def = listed
+            ?? (!server && this.deps.serverOf(tool) === null && this.deps.placedInBuiltin(tool) ? { name: tool } : undefined);
+        if (!def) {
+            if (server && this.isClosedTab(server))
+                return { kind: 'refused', error: `${server} is a closed tab, disconnected: ${META_TOOL_NAMES.open} {server:"${server}"} connects it. Nothing was sent.` };
+            return null;
+        }
+        if (args.args !== undefined && !isObj(args.args))
+            return { kind: 'refused', error: 'args must be an object of the tool\'s arguments; nothing was sent' };
+        const home = this.deps.serverOf(def.name);
+        const key = home ? tabKey(home) : BUILTIN_TOOLSET;
+        if (!this.isOpen(agentName, key)) {
+            const opener = home ? `${META_TOOL_NAMES.open} {server:"${home}"}` : `${META_TOOL_NAMES.open} {toolset:"${BUILTIN_TOOLSET}"}`;
+            return { kind: 'refused', error: `${def.name} is in ${home ? this.tabLabel(home) : this.builtinLabel}, which isn't open: ${opener} opens it. Nothing was sent.` };
+        }
+        const callArgs = (args.args ?? {});
+        // As a server's dynamic tool is checked before it's sent (RFC §6.1): the
+        // arguments against the definition the agent was shown.
+        if (def.inputSchema !== undefined) {
+            const problem = checkArgs(def.inputSchema, callArgs);
+            if (problem) {
+                // A key the definition doesn't have is named too, since it's often
+                // the cause of a missing one (a misspelling).
+                const props = isObj(def.inputSchema) && isObj(def.inputSchema.properties)
+                    ? Object.keys(def.inputSchema.properties) : null;
+                const unknown = props ? Object.keys(callArgs).filter((k) => !props.includes(k)) : [];
+                const extra = unknown.length
+                    ? `; ${unknown.map((k) => JSON.stringify(k)).join(', ')} ${unknown.length === 1 ? "isn't one of its parameters" : "aren't among its parameters"}`
+                    : '';
+                return { kind: 'refused', error: `Invalid arguments for ${def.name}: ${problem}${extra}. Nothing was sent; ${META_TOOL_NAMES.look} {tool:"${def.name}"} shows its definition.` };
+            }
+        }
+        return { kind: 'call', name: def.name, args: callArgs };
+    }
+    // ── reminders (RFC-014 §8.3) ──
+    /**
+     * The open host toolsets of an agent: each one's marker (its announcement's
+     * first words, which a reminder repeats) and its reminder, worked out only
+     * when one is due. `dueWhenAbsent`: such a toolset is due whenever a
+     * request doesn't carry its marker, even one never seen since the host
+     * started (open across a restart).
+     */
+    openMarkers(agentName) {
+        if (!this.active(agentName))
+            return [];
+        const out = [];
+        for (const key of this.doc.agents[this.ownerOf(agentName)]?.open ?? []) {
+            if (key === BUILTIN_TOOLSET) {
+                out.push({
+                    marker: `${this.builtinLabel} open`,
+                    dueWhenAbsent: true,
+                    reminder: () => `${this.builtinLabel} open: ${this.builtinTools(agentName).map((t) => t.name).join(', ') || '(none)'} — through ${META_TOOL_NAMES.act}; ${META_TOOL_NAMES.close} {toolset:"${BUILTIN_TOOLSET}"} closes it.`,
+                });
+            }
+            else if (key.startsWith('server:')) {
+                const id = key.slice('server:'.length);
+                if (!this.knows(id) || this.isClosedTab(id))
+                    continue;
+                out.push({
+                    marker: `${this.tabLabel(id)} open`,
+                    dueWhenAbsent: true,
+                    reminder: () => `${this.tabLabel(id)} open: ${this.tabTools(agentName, id).map((t) => t.name).join(', ') || '(none)'} — through ${META_TOOL_NAMES.act}; ${META_TOOL_NAMES.close} {server:"${id}"} hides it.`,
+                });
+            }
+        }
+        return out;
+    }
+}
+/** The meta-tools themselves never leave the tool list: they're how anything else is reached. */
+export function isMetaTool(name) {
+    return name === META_TOOL_NAMES.open || name === META_TOOL_NAMES.act || name === META_TOOL_NAMES.look || name === META_TOOL_NAMES.close;
+}
+//# sourceMappingURL=host-presentation.js.map

package/dist/src/host-presentation.js.map

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

package/dist/src/index.d.ts

@@ -1,6 +1,6 @@
 export * from './types/index.js';
-export { AgentFramework, BudgetPreflightError, DefaultErrorPolicy, ProviderWaitNotSleptError, QuiesceBlockedError, ResumeBlockedError } from './framework.js';
-export type { RuntimeSettingsPreview, HostModeStatus } from './framework.js';
+export { AgentFramework, AgentStoppedError, BudgetPreflightError, DefaultErrorPolicy, ProviderWaitNotSleptError, QuiesceBlockedError, ResumeBlockedError } from './framework.js';
+export type { RuntimeSettingsPreview, HostModeStatus, DeriveAgentOptions } from './framework.js';
 export { Agent } from './agent.js';
 export { storedInjectionMarkOf, type StoredInjectionMark } from './stored-injections.js';
 export type { StartStreamResult } from './agent.js';
@@ -11,6 +11,7 @@ export { formatZonedDateTime, formatZonedTime, isValidTimeZone, resolveTimeZone
 export { CLOCK_ROW_KIND, resolveClockConfig } from './clock-rows.js';
 export type { ClockConfig, ClockStamp, ResolvedClockConfig } from './clock-rows.js';
 export { REFUSAL_REACTIONS, REFUSAL_REACTION_FALLBACK, REFUSAL_REACTION_BASELINE } from './refusal-reactions.js';
+export * from './dendrite/index.js';
 export * from './modules/index.js';
 export { ApiServer } from './api/server.js';
 export { McpServer } from './api/mcp-server-core.js';
@@ -18,12 +19,12 @@ export type { ApiServerConfig, ApiMessage, ApiRequest, ApiResponse, ApiEvent, Ap
 export { UsageTracker } from './usage/index.js';
 export { buildCodeExecutionToolDefinition, CODE_EXECUTION_TOOL_NAME } from './code-execution/index.js';
 export type { SessionUsage, AgentUsage, SessionUsageSnapshot, UsageUpdatedEvent } from './usage/index.js';
-export { EventGate, wakeLineText, type WakeProvenance, type WritePlacement } from './gate/index.js';
+export { EventGate, MCPL_GATE_EVENT_TYPES, wakeLineText, type EventTypesFrom, type WakeProvenance, type WritePlacement } from './gate/index.js';
 export type { GateConfig, GateOptions, GatePolicy, GatePolicyMatch, GateBehavior, WakeLine } from './gate/index.js';
 export { ReplyJudge, DEFAULT_JUDGE_MODEL, DEFAULT_JUDGE_MAX_INPUT_TOKENS, MIN_JUDGE_INPUT_TOKENS } from './gate/index.js';
 export type { JudgeConfig, JudgeEventSummary, JudgeFn, JudgeRequest, JudgeVerdict, ReplyJudgeOptions, ReplyJudgeDeps, UpcomingWake } from './gate/index.js';
 export { Heartbeat, DEFAULT_HEARTBEAT, HEARTBEAT_TOOL_PREFIX } from './heartbeat/heartbeat.js';
-export type { HeartbeatOptions, HeartbeatSettings, HeartbeatWake, HeartbeatDeliveryMode, Reminder } from './heartbeat/heartbeat.js';
+export type { HeartbeatOptions, HeartbeatSettings, HeartbeatWake, HeartbeatDeliveryMode, HeartbeatScheduledWake, Reminder } from './heartbeat/heartbeat.js';
 export { ChannelRegistry } from './mcpl/index.js';
 export type { ChannelRef, PublishRefusalReason } from './mcpl/index.js';
 export { INBOUND_SOURCE_KEY, readInboundSource, conversationKey, sourceBodyDigest } from './mcpl/index.js';
@@ -53,5 +54,7 @@ export type { OperatorLogEntry, OperatorLogInput, OperatorRequester, SurgeryMark
 export { createOfflineRecoveryBranch } from './recovery/offline-branch.js';
 export type { OfflineRecoveryBranchOptions, OfflineRecoveryBranchResult, } from './recovery/offline-branch.js';
 export * from "./tool-presentation.js";
+export { presentAuthor, authorLine, authorNamed, ANONYMOUS_PARTICIPANT } from './author-presentation.js';
+export { defaultReaderFraming, type SubconsciousConfig, type PersistentReaderConfig, type ForkReaderConfig, type ReaderFramingContext, } from './tune-out/tools.js';
 export { SILENT_HEARTBEAT_SEPARATOR, silentHeartbeatOf, type RequestOnlyPrompt, type SilentHeartbeatStamp, type SilentHeartbeatTick, } from './silent-heartbeat.js';
 //# sourceMappingURL=index.d.ts.map