agentfootprint 7.11.0 → 7.13.0

package/dist/lib/mcp/mcpServe.js

@@ -0,0 +1,401 @@
+"use strict";
+/**
+ * mcpServe — expose your agentfootprint tools AS an MCP server.
+ *
+ *   const handle = await mcpServe([lookupTool, refundTool], {
+ *     name: 'support-desk',
+ *     version: '1.0.0',
+ *   });
+ *
+ *   // …later
+ *   await handle.close();
+ *
+ * `mcpClient` pulls someone else's tools in. This pushes yours out, so
+ * the tool you already wrote, tested and governed can be called by any
+ * MCP client — a desktop host, another team's agent, an IDE — without
+ * being rewritten against a second tool interface.
+ *
+ * Pattern: Adapter (GoF), pointed the other way. `mcpClient` translates
+ *          MCP → `Tool`; this translates `Tool` → MCP. Same SDK, same
+ *          lazy-require discipline, mirrored lifecycle (`close()`).
+ *
+ * ── The one promise worth stating plainly ────────────────────────────
+ * A served tool is THE SAME OBJECT you passed in. `mcpServe` holds your
+ * `Tool` by reference and calls `tool.execute(args, ctx)` — it never
+ * copies the schema and re-implements the body, never unwraps a
+ * decorator, never reaches past a wrapper to an inner tool. So whatever
+ * governance you composed around that tool — a permission check inside
+ * `execute`, a redaction step, an audit hook — is still the thing that
+ * runs when a remote client calls it. Serving is not a second door into
+ * your tool; it is the same door with a longer corridor.
+ *
+ * Two demands the library CANNOT keep over MCP are refused at
+ * construction rather than silently dropped:
+ *   - `checkIn` (human consent before the tool runs) needs a pause
+ *     channel that a request/response protocol does not have.
+ *   - `needs` (declare-and-push credentials) needs a provider; without
+ *     one the tool would run with `ctx.credential` undefined.
+ *
+ * ── Schemas ──────────────────────────────────────────────────────────
+ * Tools already carry JSON Schema in `schema.inputSchema`, and MCP's
+ * `tools/list` wants JSON Schema, so the mapping is the identity
+ * function. That is also why this builds on the SDK's low-level
+ * `Server` rather than its `McpServer` convenience wrapper — the latter
+ * takes zod schemas, which would mean converting a JSON Schema you
+ * already have into zod (a new dependency) to convert it straight back.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CALL_TOOL_SENTINEL = exports.LIST_TOOLS_SENTINEL = exports.mcpServe = void 0;
+const types_js_1 = require("../../identity/types.js");
+const lazyRequire_js_1 = require("../lazyRequire.js");
+const DEFAULT_SERVER_NAME = 'agentfootprint';
+const DEFAULT_SERVER_VERSION = '0.0.0';
+const DEFAULT_HTTP_PATH = '/mcp';
+/**
+ * Serve `tools` over MCP. Resolves once the transport is connected (for
+ * `http`, once the socket is listening), so holding the handle means the
+ * server is live.
+ *
+ * @throws at construction when `tools` is empty, when two tools share a
+ *   name, when a tool declares `checkIn`, or when a tool declares `needs`
+ *   without `opts.credentials` — see the module header. Also throws when
+ *   `@modelcontextprotocol/sdk` is not installed.
+ */
+async function mcpServe(tools, opts = {}) {
+    const name = opts.name ?? DEFAULT_SERVER_NAME;
+    const version = opts.version ?? DEFAULT_SERVER_VERSION;
+    const byName = validateServableTools(tools, name, opts.credentials);
+    const credentials = opts.credentials ?? (0, types_js_1.unconfiguredCredentialProvider)();
+    const listing = tools.map((t) => ({
+        name: t.schema.name,
+        ...(t.schema.description !== undefined && { description: t.schema.description }),
+        inputSchema: t.schema.inputSchema ?? { type: 'object', properties: {} },
+    }));
+    // Order matters: the server is resolved FIRST so that a missing SDK is
+    // reported by the message that tells you how to install it, rather than
+    // by the narrower one about a single submodule.
+    const rootServer = opts._server ?? (await resolveServer(name, version));
+    const { listSchema, callSchema } = await resolveRequestSchemas(opts._server !== undefined);
+    let callCounter = 0;
+    const handleCall = async (request, extra) => {
+        // Everything below this line is inside one try/catch on purpose. A
+        // client we do not control chose this request; a bad choice is a tool
+        // error reported back over the protocol, never an exception that
+        // escapes the SDK's dispatch loop and takes the server down with it.
+        try {
+            const toolName = request?.params?.name;
+            const tool = typeof toolName === 'string' ? byName.get(toolName) : undefined;
+            if (!tool) {
+                return toolError(`Unknown tool '${String(toolName)}'. Served tools: ${listing
+                    .map((t) => t.name)
+                    .join(', ')}.`);
+            }
+            const ctx = await buildExecutionContext(tool, `mcp-${name}-${++callCounter}`, {
+                credentials,
+                hasCredentials: opts.credentials !== undefined,
+                ...(extra?.signal && { signal: extra.signal }),
+            });
+            if ('blocked' in ctx)
+                return toolError(ctx.blocked);
+            // Args are forwarded EXACTLY as the client sent them. Validating
+            // them here would mean a second, weaker copy of the tool's own
+            // contract — and a tool that already rejects bad input is the one
+            // place that rejection belongs.
+            const result = await tool.execute(request?.params?.arguments, ctx.context);
+            return { content: [{ type: 'text', text: stringifyResult(result) }] };
+        }
+        catch (error) {
+            return toolError(error instanceof Error ? error.message : String(error));
+        }
+    };
+    /**
+     * Put our two handlers on one SDK server. Factored out of the body
+     * because the streamable-HTTP path cannot reuse a single server: the
+     * SDK's stateless transport refuses a second request ("Stateless
+     * transport cannot be reused across requests"), so that path builds a
+     * fresh server + transport per request and needs to install the same
+     * two handlers on each one. `listing` and `byName` are captured, so
+     * every server instance serves the same tools — the same objects.
+     */
+    const install = (server) => {
+        server.setRequestHandler(listSchema, () => ({ tools: listing }));
+        server.setRequestHandler(callSchema, handleCall);
+        return server;
+    };
+    const sdk = install(rootServer);
+    const connection = await connectTransport(sdk, opts.transport ?? { transport: 'stdio' }, opts, async () => install(await resolveServer(name, version)));
+    let closed = false;
+    return {
+        name,
+        toolNames: listing.map((t) => t.name),
+        async close() {
+            if (closed)
+                return;
+            closed = true;
+            await connection.close();
+            await sdk.close();
+        },
+    };
+}
+exports.mcpServe = mcpServe;
+// ─── Construction-time refusals ────────────────────────────────────
+/**
+ * Build the dispatch map and refuse, by name, every tool this transport
+ * cannot honour. All of these are author mistakes, and all of them are
+ * invisible at run time if we let them through — a duplicate name means
+ * one tool silently shadows another; a dropped `checkIn` means a
+ * consent gate that quietly stopped gating.
+ */
+function validateServableTools(tools, serverName, credentials) {
+    if (tools.length === 0) {
+        throw new Error(`mcpServe('${serverName}'): no tools to serve. Pass at least one Tool — a server ` +
+            `advertising an empty tool list is indistinguishable from a broken one.`);
+    }
+    const byName = new Map();
+    for (const tool of tools) {
+        const name = tool.schema.name;
+        if (byName.has(name)) {
+            throw new Error(`mcpServe('${serverName}'): duplicate tool name '${name}'. MCP clients dispatch by ` +
+                `name, so one of the two could never be reached.`);
+        }
+        if (tool.checkIn !== undefined) {
+            throw new Error(`mcpServe('${serverName}'): tool '${name}' declares checkIn, which asks a human to ` +
+                `approve the call before it runs. MCP is request/response — there is no pause to ` +
+                `carry that ask — so serving it would drop the consent gate silently. Serve a ` +
+                `variant without checkIn, or keep this tool inside an agent that can pause.`);
+        }
+        if (tool.needs !== undefined && credentials === undefined) {
+            throw new Error(`mcpServe('${serverName}'): tool '${name}' declares needs.credential ` +
+                `'${tool.needs.credential}' but no credential provider was passed. Pass ` +
+                `mcpServe(tools, { credentials }) so the credential is resolved before execute, ` +
+                `the same way the Agent resolves it.`);
+        }
+        byName.set(name, tool);
+    }
+    return byName;
+}
+// ─── Per-call execution context ────────────────────────────────────
+/**
+ * Assemble the `ToolExecutionContext` for one served call, resolving a
+ * declared credential first. Returns `{ blocked }` instead of throwing
+ * when the credential is unavailable, so the client is told WHY in a
+ * tool-error result rather than seeing a generic failure.
+ */
+async function buildExecutionContext(tool, toolCallId, wiring) {
+    const { credentials, hasCredentials, signal } = wiring;
+    let credential;
+    const need = tool.needs;
+    if (need) {
+        const resolved = await credentials.getCredential({
+            service: need.credential,
+            ...(need.scopes && { scopes: need.scopes }),
+            ...(need.mode && { mode: need.mode }),
+        });
+        // Fail-closed, mirroring the Agent's tool-call stage: a tool that
+        // asked for a credential never runs without one.
+        if (resolved.status !== 'issued') {
+            return {
+                blocked: `authorization required for '${need.credential}': ${resolved.authorizationUrl}`,
+            };
+        }
+        credential = resolved.credential;
+    }
+    return {
+        context: {
+            toolCallId,
+            // There is no ReAct loop out here — a served call is a single
+            // request, so the iteration a tool might branch on is zero.
+            iteration: 0,
+            credentials,
+            hasCredentials,
+            ...(signal && { signal }),
+            ...(credential && { credential }),
+        },
+    };
+}
+// ─── Result mapping ────────────────────────────────────────────────
+/** MCP carries text blocks; a Tool returns anything JSON-serializable. */
+function stringifyResult(result) {
+    if (typeof result === 'string')
+        return result;
+    if (result === undefined)
+        return '';
+    try {
+        return JSON.stringify(result) ?? String(result);
+    }
+    catch {
+        // Circular or otherwise unserializable — say so rather than throwing
+        // from the happy path.
+        return String(result);
+    }
+}
+/** A tool-level error: reported IN the result, per the MCP spec, not thrown. */
+function toolError(message) {
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
+// ─── SDK construction (lazy require) ───────────────────────────────
+async function resolveServer(name, version) {
+    let mod;
+    try {
+        mod = (0, lazyRequire_js_1.lazyRequire)('@modelcontextprotocol/sdk/server/index.js');
+    }
+    catch {
+        throw new Error('mcpServe requires @modelcontextprotocol/sdk.\n' +
+            '  Install:  npm install @modelcontextprotocol/sdk\n' +
+            '  Or pass `_server` for test injection.');
+    }
+    return new mod.Server({ name, version }, { capabilities: { tools: {} } });
+}
+/**
+ * The request schemas the SDK dispatches on. With an injected `_server`
+ * there is no SDK to read them from, so tests get stable sentinel
+ * objects — the injected server decides what to do with them.
+ */
+async function resolveRequestSchemas(injected) {
+    if (injected) {
+        return { listSchema: exports.LIST_TOOLS_SENTINEL, callSchema: exports.CALL_TOOL_SENTINEL };
+    }
+    let types;
+    try {
+        types = (0, lazyRequire_js_1.lazyRequire)('@modelcontextprotocol/sdk/types.js');
+    }
+    catch {
+        throw new Error('mcpServe requires @modelcontextprotocol/sdk/types.js — check that ' +
+            '@modelcontextprotocol/sdk is installed at the latest version.');
+    }
+    return { listSchema: types.ListToolsRequestSchema, callSchema: types.CallToolRequestSchema };
+}
+/**
+ * Sentinels handed to an injected `_server` in place of the SDK's zod
+ * schemas. Exported so a test can tell the two handlers apart.
+ * @internal
+ */
+exports.LIST_TOOLS_SENTINEL = Object.freeze({ method: 'tools/list' });
+/** @internal @see LIST_TOOLS_SENTINEL */
+exports.CALL_TOOL_SENTINEL = Object.freeze({ method: 'tools/call' });
+/**
+ * For stdio and for an injected test server there is nothing extra to
+ * unwind: the SDK's own `server.close()` closes the transport it is
+ * connected to. Only the HTTP path owns a socket of its own.
+ */
+const NOTHING_TO_UNWIND = { close: () => Promise.resolve() };
+async function connectTransport(sdk, transport, opts, newServer) {
+    // An injected server is a test double: there is no real transport to
+    // build, and building one would spawn a listener or seize stdio.
+    if (opts._server) {
+        await sdk.connect(undefined);
+        return NOTHING_TO_UNWIND;
+    }
+    if (transport.transport === 'stdio') {
+        let stdioMod;
+        try {
+            stdioMod = (0, lazyRequire_js_1.lazyRequire)('@modelcontextprotocol/sdk/server/stdio.js');
+        }
+        catch {
+            throw new Error('mcpServe(stdio) requires @modelcontextprotocol/sdk/server/stdio.js — ' +
+                'check that @modelcontextprotocol/sdk is installed at the latest version.');
+        }
+        await sdk.connect(new stdioMod.StdioServerTransport());
+        return NOTHING_TO_UNWIND;
+    }
+    // HTTP deliberately does not use `sdk`: it mints a server per request
+    // (see connectHttp). The root server stays unconnected, which makes the
+    // handle's `sdk.close()` a harmless no-op on this path.
+    return connectHttp(transport, newServer);
+}
+/**
+ * Streamable HTTP. The SDK's transport handles the protocol but does not
+ * own a socket — it expects to be driven from a request handler — so the
+ * listener is ours, built on node:http (built in; no new dependency).
+ *
+ * Stateless (`sessionIdGenerator: undefined`): no session table to keep,
+ * nothing to expire, and several replicas can serve the same tools.
+ *
+ * Statelessness is not just a config flag here — it decides the shape of
+ * this function. The SDK's stateless transport is single-use by design
+ * (reusing one would let two clients collide on JSON-RPC message ids), so
+ * it throws on its second request. Each request therefore gets its own
+ * transport, and — because one SDK server can only be attached to one
+ * transport — its own server. Both are thrown away when the response
+ * closes. The tools they serve are the same objects either way.
+ */
+async function connectHttp(transport, newServer) {
+    let httpMod;
+    try {
+        httpMod = (0, lazyRequire_js_1.lazyRequire)('@modelcontextprotocol/sdk/server/streamableHttp.js');
+    }
+    catch {
+        throw new Error('mcpServe(http) requires @modelcontextprotocol/sdk/server/streamableHttp.js — ' +
+            'check that @modelcontextprotocol/sdk is installed at the latest version.');
+    }
+    const { createServer } = await Promise.resolve().then(() => __importStar(require('node:http')));
+    const serveOne = async (req, res) => {
+        const server = await newServer();
+        const mcpTransport = new httpMod.StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+        });
+        // The pair lives exactly as long as the response does.
+        res.on('close', () => {
+            void mcpTransport.close();
+            void server.close();
+        });
+        await server.connect(mcpTransport);
+        await mcpTransport.handleRequest(req, res);
+    };
+    const path = transport.path ?? DEFAULT_HTTP_PATH;
+    const listener = createServer((req, res) => {
+        // Route on the path only; the transport itself decides which HTTP
+        // methods it accepts on the MCP endpoint.
+        const url = req.url ?? '';
+        if (url.split('?')[0] !== path) {
+            res.statusCode = 404;
+            res.end();
+            return;
+        }
+        // One failed request must not take the listener down. The client is
+        // told (500 is a protocol-level error it surfaces); the next request
+        // is served normally.
+        void serveOne(req, res).catch(() => {
+            if (!res.headersSent) {
+                res.statusCode = 500;
+                res.end();
+            }
+        });
+    });
+    await new Promise((resolve, reject) => {
+        listener.once('error', reject);
+        if (transport.host !== undefined)
+            listener.listen(transport.port, transport.host, resolve);
+        else
+            listener.listen(transport.port, resolve);
+    });
+    return {
+        close: () => new Promise((resolve, reject) => {
+            listener.close((err) => (err ? reject(err) : resolve()));
+        }),
+    };
+}
+//# sourceMappingURL=mcpServe.js.map

package/dist/lib/mcp/mcpServe.js.map

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

package/dist/lib/mcp/types.js

@@ -1,12 +1,15 @@
 "use strict";
 /**
- * MCP — Model Context Protocol client integration.
+ * MCP — Model Context Protocol, in both directions.
  *
  * MCP (https://modelcontextprotocol.io) is an open standard for
- * connecting LLMs to external tools and data sources. agentfootprint's
- * MCP adapter is **client-only** — it consumes MCP servers and exposes
- * their tools as agentfootprint `Tool[]` so consumers can plug them
- * straight into `agent.tool(...)`.
+ * connecting LLMs to external tools and data sources. This module
+ * bridges it both ways:
+ *
+ *   - `mcpClient(opts)`  — consume an MCP server; its tools become
+ *     agentfootprint `Tool[]` you can hand to `agent.tools(...)`.
+ *   - `mcpServe(tools, opts)` — the other direction: expose your own
+ *     `Tool[]` AS an MCP server, so any MCP client can call them.
  *
  * Pattern: Adapter (GoF) — translates MCP wire format ↔ agentfootprint
  *          `Tool` interface. The MCP SDK does the protocol work; we
@@ -15,11 +18,8 @@
  *          inline alternative for non-MCP tools).
  * Emits:   N/A directly — wrapped tools emit the standard
  *          `agentfootprint.stream.tool_start` / `tool_end` events
- *          when the agent calls them.
- *
- * Server-side support (exposing an agent or LLMCall as an MCP tool)
- * is a separate concern not yet shipped. This module covers the
- * 80% case: pulling an existing MCP server's tools INTO an agent.
+ *          when the agent calls them. `mcpServe` runs OUTSIDE any
+ *          agent run, so it emits nothing at all.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=types.js.map

package/dist/tool-providers/index.js

@@ -14,6 +14,12 @@
  *    - `mcpClient(opts)` — connect to an MCP server (real)
  *    - `mockMcpClient({ tools })` — in-memory MCP source for dev / tests
  *
+ * 3. Tool sink — the other direction
+ *    - `mcpServe(tools, opts)` — expose your own `Tool[]` AS an MCP
+ *      server, so any MCP client can call them. The served tool is the
+ *      SAME object you pass in, so whatever governance you composed
+ *      around it still runs.
+ *
  * Compose freely. The dispatch layer is decorator-shaped (mirroring
  * `withRetry` / `withFallback` over LLMProvider). Tool sources produce
  * `Tool[]` that flow into a `staticTools(arr)` provider, which can
@@ -35,7 +41,7 @@
  *   const provider = gatedTools(staticTools(slackTools), (name) => allowed(name));
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mockMcpClient = exports.mcpClient = exports.skillScopedTools = exports.gatedTools = exports.staticTools = void 0;
+exports.mockMcpClient = exports.mcpServe = exports.mcpClient = exports.skillScopedTools = exports.gatedTools = exports.staticTools = void 0;
 var staticTools_js_1 = require("./staticTools.js");
 Object.defineProperty(exports, "staticTools", { enumerable: true, get: function () { return staticTools_js_1.staticTools; } });
 var gatedTools_js_1 = require("./gatedTools.js");
@@ -47,5 +53,6 @@ Object.defineProperty(exports, "skillScopedTools", { enumerable: true, get: func
 // top-level barrel does not re-export it.
 var index_js_1 = require("../lib/mcp/index.js");
 Object.defineProperty(exports, "mcpClient", { enumerable: true, get: function () { return index_js_1.mcpClient; } });
+Object.defineProperty(exports, "mcpServe", { enumerable: true, get: function () { return index_js_1.mcpServe; } });
 Object.defineProperty(exports, "mockMcpClient", { enumerable: true, get: function () { return index_js_1.mockMcpClient; } });
 //# sourceMappingURL=index.js.map

package/dist/tool-providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tool-providers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;;AAEH,mDAA+C;AAAtC,6GAAA,WAAW,OAAA;AACpB,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AACnB,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA;AAGzB,uEAAuE;AACvE,wEAAwE;AACxE,0CAA0C;AAC1C,gDAA+D;AAAtD,qGAAA,SAAS,OAAA;AAAE,yGAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tool-providers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;;;AAEH,mDAA+C;AAAtC,6GAAA,WAAW,OAAA;AACpB,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AACnB,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA;AAGzB,uEAAuE;AACvE,wEAAwE;AACxE,0CAA0C;AAC1C,gDAAyE;AAAhE,qGAAA,SAAS,OAAA;AAAE,oGAAA,QAAQ,OAAA;AAAE,yGAAA,aAAa,OAAA"}

package/dist/types/core/Agent.d.ts

@@ -27,11 +27,11 @@ import { type OutputSchemaParser } from './outputSchema.js';
 import { RunnerBase } from './RunnerBase.js';
 import type { ToolRegistryEntry } from './tools.js';
 import type { ToolProvider } from '../tool-providers/types.js';
-import type { AgentInput, AgentOptions, AgentOutput, ObserverDeliveryOptions } from './agent/types.js';
+import type { AgentInput, AgentOptions, AgentOutput, ObserverDeliveryOptions, RunConfig, RunConfigContext, RunConfigFn, WriteProvenanceMode } from './agent/types.js';
 import { AgentBuilder } from './agent/AgentBuilder.js';
 import type { ThinkingHandler } from '../thinking/types.js';
 export { AgentBuilder };
-export type { AgentInput, AgentOptions, AgentOutput, ObserverDeliveryOptions };
+export type { AgentInput, AgentOptions, AgentOutput, ObserverDeliveryOptions, RunConfig, RunConfigContext, RunConfigFn, WriteProvenanceMode, };
 /**
  * `RunOptions` (footprintjs) + agentfootprint-domain correlation fields.
  *
@@ -110,6 +110,10 @@ export declare class Agent extends RunnerBase<AgentInput, AgentOutput> {
      *  present — defaults to `standard` evidence + the lexical scorer, so a tool
      *  that declares `checkIn` works even without a `.checkIn()` builder call. */
     private readonly checkInConfig;
+    /** Per-run config resolver from `.configure()`. Undefined for every agent
+     *  that never called it — and the chart is then built exactly as before,
+     *  with no scope writes and no scope reads added. */
+    private readonly runConfigFn?;
     /** Snapshot read-tracking policy (#18/#14) — forwarded to the internal
      *  executor. Agent default is `'summary'` (cheap markers), NOT
      *  footprintjs's `'full'`. See AgentOptions.readTracking. */
@@ -120,6 +124,10 @@ export declare class Agent extends RunnerBase<AgentInput, AgentOutput> {
      *  retained memory), NOT footprintjs's `'full'`. See
      *  AgentOptions.commitValues. */
     private readonly commitValues;
+    /** Per-write read provenance (#P1) — forwarded to the internal executor.
+     *  Default `'off'` (footprintjs's own): recordings stay byte-identical
+     *  unless a consumer opts in. See AgentOptions.writeProvenance. */
+    private readonly writeProvenance;
     private readonly credentialProvider?;
     /** Evidence bridge (#5) — present iff a CAUSAL memory is mounted. */
     private readonly causalEvidence?;
@@ -216,7 +224,7 @@ export declare class Agent extends RunnerBase<AgentInput, AgentOutput> {
         readonly appName: string;
         readonly commentaryTemplates: Readonly<Record<string, string>>;
         readonly thinkingTemplates: Readonly<Record<string, string>>;
-    }, injections?: readonly Injection[], memories?: readonly MemoryDefinition[], outputSchemaParser?: OutputSchemaParser<unknown>, toolProvider?: ToolProvider, systemPromptCachePolicy?: CachePolicy, cachingDisabled?: boolean, cacheStrategy?: CacheStrategy, outputFallbackCfg?: ResolvedOutputFallback<unknown>, reliabilityConfig?: ReliabilityConfig, thinkingHandlerValue?: ThinkingHandler | null, thinkingBudgetValue?: number, skillGraphNextSkill?: (ctx: InjectionContext) => string | undefined, skillGraphReachable?: (currentSkillId?: string) => readonly string[], skillGraphScoreEntries?: (ctx: InjectionContext, signal?: AbortSignal) => Promise<EntryScoring>, checkInOptions?: CheckInBuilderOptions);
+    }, injections?: readonly Injection[], memories?: readonly MemoryDefinition[], outputSchemaParser?: OutputSchemaParser<unknown>, toolProvider?: ToolProvider, systemPromptCachePolicy?: CachePolicy, cachingDisabled?: boolean, cacheStrategy?: CacheStrategy, outputFallbackCfg?: ResolvedOutputFallback<unknown>, reliabilityConfig?: ReliabilityConfig, thinkingHandlerValue?: ThinkingHandler | null, thinkingBudgetValue?: number, skillGraphNextSkill?: (ctx: InjectionContext) => string | undefined, skillGraphReachable?: (currentSkillId?: string) => readonly string[], skillGraphScoreEntries?: (ctx: InjectionContext, signal?: AbortSignal) => Promise<EntryScoring>, checkInOptions?: CheckInBuilderOptions, runConfigFn?: RunConfigFn);
     static create(opts: AgentOptions): AgentBuilder;
     /**
      * Cache policy for the base system prompt. Read by the CacheDecision

package/dist/types/core/Agent.d.ts.map

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

package/dist/types/core/agent/AgentBuilder.d.ts

@@ -19,7 +19,7 @@ import type { CheckInBuilderOptions } from '../checkin.js';
 import type { ToolProvider } from '../../tool-providers/types.js';
 import { type SelfExplainOptions } from '../../lib/trace-toolpack/selfExplain.js';
 import { Agent } from '../Agent.js';
-import type { AgentOptions } from './types.js';
+import type { AgentOptions, RunConfigFn } from './types.js';
 /**
  * Fluent builder. `tool()` accepts any Tool<TArgs, TResult> and registers
  * it by its schema.name. Duplicate names throw at build time.
@@ -121,6 +121,9 @@ export declare class AgentBuilder {
     private thinkingBudgetValue?;
     private selfExplainConfig?;
     private checkInConfig?;
+    /** Per-run config resolver set via `.configure()`. Undefined = the agent
+     *  runs on its build-time model + system prompt, unchanged. */
+    private runConfigFn?;
     constructor(opts: AgentOptions);
     /**
      * Set the base system prompt.
@@ -183,6 +186,50 @@ export declare class AgentBuilder {
      *     .build();
      */
     toolProvider(provider: ToolProvider): this;
+    /**
+     * Decide this run's model and/or system prompt when the run starts.
+     *
+     * An agent is built once and run many times, but not every run wants the
+     * same model or the same instructions: a long message may deserve the
+     * bigger model, a tenant may have its own house rules, a canary may want
+     * last week's prompt. Rebuilding the whole agent per request works and is
+     * wasteful; reaching in and mutating one is worse, because the trace then
+     * describes an agent that no longer exists.
+     *
+     * The resolver runs ONCE per `run()`, at the start of the run, and what it
+     * returns is **committed to the trace** — `resolvedModel` and
+     * `resolvedInstructions` land in the run's commit log before the first LLM
+     * call, and the LLM call reads them from there. So the recording says which
+     * model actually answered instead of which model the agent was built with.
+     *
+     * Return `{}` (or nothing) to keep the defaults; `ctx.defaults` carries
+     * them, so a resolver can decide relative to what was built rather than
+     * restating it. Omit `.configure()` entirely and every run behaves — and
+     * records — exactly as it did before.
+     *
+     * This is the RUN axis only. Tools are the iteration axis and already have
+     * an owner: `.toolProvider()`, consulted every iteration.
+     *
+     * Throws if called more than once (same rule as `.toolProvider()` — a
+     * silently-overridden resolver is a config that lies).
+     *
+     * @example  Bigger model for a bigger question
+     *   const agent = Agent.create({ provider, model: 'small-model' })
+     *     .system('You answer support questions.')
+     *     .configure(({ message, defaults }) =>
+     *       message.length > 500 ? { model: 'big-model' } : {},
+     *     )
+     *     .build();
+     *
+     * @example  Per-tenant house rules
+     *   const agent = Agent.create({ provider, model })
+     *     .system('You answer support questions.')
+     *     .configure(({ identity, defaults }) => ({
+     *       instructions: `${defaults.instructions}\n\n${rulesFor(identity?.tenant)}`,
+     *     }))
+     *     .build();
+     */
+    configure(fn: RunConfigFn): this;
     /**
      * Override the ReAct iteration cap set via `Agent.create({
      * maxIterations })`. Convenience for builder-style code that prefers