agentfootprint 7.12.0 → 7.13.0

package/dist/esm/lib/mcp/types.d.ts

@@ -1,11 +1,14 @@
 /**
- * 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
@@ -14,11 +17,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.
  */
 import type { Tool } from '../../core/tools.js';
 /**
@@ -32,7 +32,13 @@ export interface McpStdioTransport {
     readonly command: string;
     /** CLI args passed to the executable. */
     readonly args?: readonly string[];
-    /** Optional env vars set on the subprocess. */
+    /**
+     * Environment for the subprocess. Passed to the SDK as-is, and the SDK
+     * treats it as the WHOLE environment: set this and the child no longer
+     * inherits the safe default set (`PATH`, `HOME`, …). Omit it unless you
+     * mean to replace the environment; to merely add a variable, include the
+     * ones the child still needs.
+     */
     readonly env?: Readonly<Record<string, string>>;
     /** Working directory for the subprocess. */
     readonly cwd?: string;
@@ -107,22 +113,29 @@ export interface McpClient {
  *      a lazy peer-dep)
  *
  * The real SDK exports a richer surface; we narrow to what's needed.
+ *
+ * Argument POSITION matters here and is easy to get wrong: the SDK keeps
+ * per-request options (`signal`, `timeout`) in a SEPARATE trailing
+ * argument, never inside the JSON-RPC params. A `signal` smuggled into
+ * the params object is serialized onto the wire as `{}` and silently
+ * fails to cancel anything, so these signatures mirror the SDK's own
+ * shape rather than a flattened convenience version of it.
  */
 export interface McpSdkClient {
-    connect(transport: unknown): Promise<void>;
-    listTools(): Promise<{
+    connect(transport: unknown, options?: McpRequestOptions): Promise<void>;
+    listTools(params?: undefined, options?: McpRequestOptions): Promise<{
         readonly tools: ReadonlyArray<{
             readonly name: string;
             readonly description?: string;
             readonly inputSchema: Readonly<Record<string, unknown>>;
         }>;
     }>;
-    callTool(args: {
+    callTool(params: {
         readonly name: string;
         readonly arguments?: Readonly<Record<string, unknown>>;
-        /** Forwarded from `McpClientOptions.signal` so consumers can cancel hung tool calls. */
-        readonly signal?: AbortSignal;
-    }): Promise<{
+    }, 
+    /** The SDK's result schema. We always want its default, so we pass `undefined`. */
+    resultSchema?: undefined, options?: McpRequestOptions): Promise<{
         readonly content: ReadonlyArray<{
             readonly type: string;
             readonly text?: string;
@@ -131,3 +144,103 @@ export interface McpSdkClient {
     }>;
     close(): Promise<void>;
 }
+/**
+ * The SDK's trailing per-request options argument, narrowed to the one
+ * field we forward from {@link McpClientOptions.signal}.
+ */
+export interface McpRequestOptions {
+    readonly signal?: AbortSignal;
+}
+/**
+ * `stdio` transport — the server speaks MCP over its own stdin/stdout.
+ * This is how a desktop MCP host launches a server: it spawns your
+ * process and talks down the pipe. The default.
+ *
+ * One consequence worth stating out loud: stdout belongs to the
+ * protocol. Anything else your process prints there corrupts the
+ * stream, so log to stderr.
+ */
+export interface McpStdioServeTransport {
+    readonly transport: 'stdio';
+}
+/**
+ * `http` transport — the server listens on a port and speaks MCP over
+ * Streamable HTTP. Stateless (no session ids): every request is
+ * self-contained, which is what makes it safe to run several replicas
+ * behind a load balancer.
+ */
+export interface McpHttpServeTransport {
+    readonly transport: 'http';
+    /** TCP port to listen on. */
+    readonly port: number;
+    /** Interface to bind. Defaults to Node's own default (all interfaces). */
+    readonly host?: string;
+    /** URL path the MCP endpoint answers on. Default `'/mcp'`. */
+    readonly path?: string;
+}
+export type McpServeTransport = McpStdioServeTransport | McpHttpServeTransport;
+export interface McpServeOptions {
+    /**
+     * Server name reported to clients on connect. Surfaces in the
+     * client's server list. Default `'agentfootprint'`.
+     */
+    readonly name?: string;
+    /** Server version reported to clients. Default `'0.0.0'`. */
+    readonly version?: string;
+    /** Transport configuration. Default `{ transport: 'stdio' }`. */
+    readonly transport?: McpServeTransport;
+    /**
+     * Credential provider for served tools that declare `needs`. The
+     * credential is resolved BEFORE `execute` and injected as
+     * `ctx.credential`, exactly as the Agent's tool-call stage does it.
+     *
+     * Serving a `needs`-declaring tool without this is refused at
+     * construction: the tool would run with `ctx.credential` undefined
+     * and fail somewhere further in, or worse, not fail at all.
+     */
+    readonly credentials?: import('../../identity/types.js').CredentialProvider;
+    /**
+     * @internal Pre-built SDK server for tests. Skips SDK import +
+     * transport construction. Mirrors `McpClientOptions._client`.
+     */
+    readonly _server?: McpSdkServer;
+}
+/**
+ * What `mcpServe(...)` returns. The server is already listening by the
+ * time you hold this; `close()` is the only thing left to do.
+ */
+export interface McpServeHandle {
+    /** Server name from options (or the default). */
+    readonly name: string;
+    /** Names of the tools being served, in the order clients will list them. */
+    readonly toolNames: readonly string[];
+    /**
+     * Stop serving: closes the transport (and, for `http`, the listening
+     * socket) and then the MCP server. Idempotent — calling it twice is
+     * not an error, so a shutdown hook and an explicit close can coexist.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Minimal structural type for the parts of the MCP SDK's low-level
+ * `Server` we touch. Defined locally for the same two reasons as
+ * {@link McpSdkClient}: test injection via `McpServeOptions._server`,
+ * and no hard import on the lazy peer-dep.
+ */
+export interface McpSdkServer {
+    setRequestHandler(schema: unknown, handler: (request: McpCallToolRequest, extra: {
+        readonly signal?: AbortSignal;
+    }) => unknown): void;
+    connect(transport: unknown): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * The shape `tools/call` requests arrive in. `tools/list` requests carry
+ * no params we read, so one request type covers both handlers.
+ */
+export interface McpCallToolRequest {
+    readonly params?: {
+        readonly name?: string;
+        readonly arguments?: unknown;
+    };
+}

package/dist/esm/lib/mcp/types.js

@@ -1,11 +1,14 @@
 /**
- * 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
@@ -14,11 +17,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.
  */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/esm/tool-providers/index.d.ts

@@ -13,6 +13,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
@@ -37,5 +43,5 @@ export { staticTools } from './staticTools.js';
 export { gatedTools } from './gatedTools.js';
 export { skillScopedTools } from './skillScopedTools.js';
 export type { ToolProvider, ToolDispatchContext, ToolGatePredicate } from './types.js';
-export { mcpClient, mockMcpClient } from '../lib/mcp/index.js';
-export type { McpClient, McpClientOptions, McpSdkClient, McpTransport, McpStdioTransport, McpHttpTransport, MockMcpClientOptions, MockMcpTool, } from '../lib/mcp/index.js';
+export { mcpClient, mcpServe, mockMcpClient } from '../lib/mcp/index.js';
+export type { McpClient, McpClientOptions, McpSdkClient, McpTransport, McpStdioTransport, McpHttpTransport, MockMcpClientOptions, MockMcpTool, McpServeOptions, McpServeHandle, McpServeTransport, McpStdioServeTransport, McpHttpServeTransport, McpSdkServer, } from '../lib/mcp/index.js';

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

@@ -13,6 +13,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
@@ -39,5 +45,5 @@ export { skillScopedTools } from './skillScopedTools.js';
 // Re-export tool sources from the MCP module so consumers find them in
 // one place. This subpath is the ONLY place `mcpClient` is public — the
 // top-level barrel does not re-export it.
-export { mcpClient, mockMcpClient } from '../lib/mcp/index.js';
+export { mcpClient, mcpServe, mockMcpClient } from '../lib/mcp/index.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tool-providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,uEAAuE;AACvE,wEAAwE;AACxE,0CAA0C;AAC1C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tool-providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,uEAAuE;AACvE,wEAAwE;AACxE,0CAA0C;AAC1C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lib/injection-engine/index.js

@@ -7,7 +7,7 @@
  * factories. See `README.md` in this folder for the full concept.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.skillToolNames = exports.checkSkillContracts = exports.checkSkillContract = exports.rankEntries = exports.embeddingScorer = exports.keywordScorer = exports.SKILL_GRAPH_METADATA_KEY = exports.decideSkill = exports.skillGraph = exports.defineInjection = exports.defineFact = exports.defineSteering = exports.buildReadSkillTool = exports.buildListSkillsTool = exports.SkillRegistry = exports.resolveSurfaceMode = exports.defineSkill = exports.defineRelevanceHint = exports.defineInstruction = exports.buildInjectionEngineSubflow = exports.evaluateInjections = exports.projectActiveInjection = void 0;
+exports.skillToolNames = exports.checkSkillContracts = exports.checkSkillContract = exports.rankEntries = exports.embeddingScorer = exports.keywordScorer = exports.SKILL_GRAPH_METADATA_KEY = exports.decideSkill = exports.skillGraph = exports.defineInjection = exports.defineFact = exports.defineSteering = exports.buildReadSkillTool = exports.buildListSkillsTool = exports.skillsFromDir = exports.SkillRegistry = exports.resolveSurfaceMode = exports.defineSkill = exports.defineRelevanceHint = exports.defineInstruction = exports.buildInjectionEngineSubflow = exports.evaluateInjections = exports.projectActiveInjection = void 0;
 // POJO projection — used by slot subflows + advanced consumers
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "projectActiveInjection", { enumerable: true, get: function () { return types_js_1.projectActiveInjection; } });
@@ -26,6 +26,11 @@ Object.defineProperty(exports, "defineSkill", { enumerable: true, get: function
 Object.defineProperty(exports, "resolveSurfaceMode", { enumerable: true, get: function () { return defineSkill_js_1.resolveSurfaceMode; } });
 var SkillRegistry_js_1 = require("./SkillRegistry.js");
 Object.defineProperty(exports, "SkillRegistry", { enumerable: true, get: function () { return SkillRegistry_js_1.SkillRegistry; } });
+// File-authored skills — a loader over `defineSkill`, not a second mechanism.
+// Node-only (reads the filesystem); node:fs is imported lazily inside the call
+// so this barrel stays safe to import from a browser bundle.
+var skillsFromDir_js_1 = require("./skillsFromDir.js");
+Object.defineProperty(exports, "skillsFromDir", { enumerable: true, get: function () { return skillsFromDir_js_1.skillsFromDir; } });
 // Skill-tool builders — used by SkillRegistry.toTools() and the Agent's
 // auto-attach path. Exported so consumers building custom tool wiring
 // (e.g., gatedTools chains) can compose the same `list_skills` /

package/dist/lib/injection-engine/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/injection-engine/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAYH,+DAA+D;AAC/D,uCAAoD;AAA3C,kHAAA,sBAAsB,OAAA;AAE/B,SAAS;AACT,+CAAoD;AAA3C,kHAAA,kBAAkB,OAAA;AAC3B,mFAG0C;AAFxC,6IAAA,2BAA2B,OAAA;AAI7B,gFAAgF;AAChF,yEAAoG;AAA3F,yHAAA,iBAAiB,OAAA;AAC1B,6EAAoG;AAA3F,6HAAA,mBAAmB,OAAA;AAE5B,6DAOoC;AANlC,6GAAA,WAAW,OAAA;AACX,oHAAA,kBAAkB,OAAA;AAOpB,uDAA8E;AAArE,iHAAA,aAAa,OAAA;AAEtB,wEAAwE;AACxE,sEAAsE;AACtE,iEAAiE;AACjE,+BAA+B;AAC/B,iDAA8F;AAArF,oHAAA,mBAAmB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAEhD,mEAA2F;AAAlF,mHAAA,cAAc,OAAA;AAEvB,2DAA+E;AAAtE,2GAAA,UAAU,OAAA;AAEnB,6EAA6E;AAC7E,0EAA0E;AAC1E,qDAAqD;AACrD,qEAIwC;AAHtC,qHAAA,eAAe,OAAA;AAKjB,4EAA4E;AAC5E,8EAA8E;AAC9E,iDAuByB;AAtBvB,2GAAA,UAAU,OAAA;AACV,4GAAA,WAAW,OAAA;AACX,yHAAA,wBAAwB,OAAA;AAqB1B,mDAO0B;AANxB,+GAAA,aAAa,OAAA;AACb,iHAAA,eAAe,OAAA;AACf,6GAAA,WAAW,OAAA;AAKb,uDAA6F;AAApF,sHAAA,kBAAkB,OAAA;AAAE,uHAAA,mBAAmB,OAAA;AAAE,kHAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/injection-engine/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAYH,+DAA+D;AAC/D,uCAAoD;AAA3C,kHAAA,sBAAsB,OAAA;AAE/B,SAAS;AACT,+CAAoD;AAA3C,kHAAA,kBAAkB,OAAA;AAC3B,mFAG0C;AAFxC,6IAAA,2BAA2B,OAAA;AAI7B,gFAAgF;AAChF,yEAAoG;AAA3F,yHAAA,iBAAiB,OAAA;AAC1B,6EAAoG;AAA3F,6HAAA,mBAAmB,OAAA;AAE5B,6DAOoC;AANlC,6GAAA,WAAW,OAAA;AACX,oHAAA,kBAAkB,OAAA;AAOpB,uDAA8E;AAArE,iHAAA,aAAa,OAAA;AAEtB,8EAA8E;AAC9E,+EAA+E;AAC/E,6DAA6D;AAC7D,uDAA8E;AAArE,iHAAA,aAAa,OAAA;AAEtB,wEAAwE;AACxE,sEAAsE;AACtE,iEAAiE;AACjE,+BAA+B;AAC/B,iDAA8F;AAArF,oHAAA,mBAAmB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAEhD,mEAA2F;AAAlF,mHAAA,cAAc,OAAA;AAEvB,2DAA+E;AAAtE,2GAAA,UAAU,OAAA;AAEnB,6EAA6E;AAC7E,0EAA0E;AAC1E,qDAAqD;AACrD,qEAIwC;AAHtC,qHAAA,eAAe,OAAA;AAKjB,4EAA4E;AAC5E,8EAA8E;AAC9E,iDAuByB;AAtBvB,2GAAA,UAAU,OAAA;AACV,4GAAA,WAAW,OAAA;AACX,yHAAA,wBAAwB,OAAA;AAqB1B,mDAO0B;AANxB,+GAAA,aAAa,OAAA;AACb,iHAAA,eAAe,OAAA;AACf,6GAAA,WAAW,OAAA;AAKb,uDAA6F;AAApF,sHAAA,kBAAkB,OAAA;AAAE,uHAAA,mBAAmB,OAAA;AAAE,kHAAA,cAAc,OAAA"}

package/dist/lib/injection-engine/skillsFromDir.js

@@ -0,0 +1,270 @@
+"use strict";
+/**
+ * skillsFromDir — load Skills that were AUTHORED AS FILES.
+ *
+ * The just-in-time half of skills already ships: `defineSkill` produces an
+ * Injection whose `description` is all the model sees until it calls
+ * `read_skill(<id>)`, at which point the body enters the context. What did not
+ * ship was the other half — a way to keep those bodies where prose belongs, in
+ * files, next to the code they describe, reviewable in a diff.
+ *
+ * This is that loader, and nothing more. It reads a directory of `SKILL.md`
+ * files and hands each one to `defineSkill`. The progressive disclosure, the
+ * activation tool, the slot routing — all unchanged, all upstream of here.
+ *
+ *   skills/
+ *     billing/SKILL.md
+ *     refunds/SKILL.md
+ *
+ *   ---
+ *   name: billing
+ *   description: Use for refunds, charges and billing questions.
+ *   ---
+ *   When handling billing: confirm identity first, then …
+ *
+ *   const skills = await skillsFromDir('./skills');
+ *   const agent = Agent.create({ provider, model }).skills({ list: () => skills }).build();
+ *
+ * The frontmatter is the disclosure stub (`name` + `description` — what the
+ * model reads when deciding), and everything after the closing fence is the
+ * body (what it reads after deciding). That is the same file convention Claude
+ * Code made familiar, so a skill folder is portable between the two.
+ *
+ * ── Why authorship is decided here, at load time ─────────────────────────────
+ * A Skill body is *instructions to a model*. Where it came from is therefore a
+ * security property, not a convenience: content fetched at run time from
+ * somewhere else is content someone else can change after you reviewed it.
+ * This loader accepts a local directory and nothing else — a URL is refused BY
+ * NAME rather than fetched — because "these files are mine" is a claim you can
+ * only make about a path on your own disk at build time. Each file is read
+ * ONCE, here; a later edit does not reach a run already in flight.
+ *
+ * Node-only. `node:fs/promises` and `node:path` are imported lazily inside the
+ * call, the same gating `lib/tool-lint/cli.ts` uses: this module is reachable
+ * from the `agentfootprint/injection-engine` barrel, and a TOP-LEVEL node:fs
+ * import detonates a browser bundle at module-eval even when nothing calls it.
+ */
+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.skillsFromDir = void 0;
+const defineSkill_js_1 = require("./factories/defineSkill.js");
+/** The file name every skill folder is expected to use. */
+const SKILL_FILE = 'SKILL.md';
+/**
+ * Skill ids ride into `read_skill`'s `enum` and into the skill-graph's node
+ * ids. The house tool-name charset keeps them quotable in a prompt, comparable
+ * as plain strings, and safe as an object key.
+ */
+const SKILL_NAME_RE = /^[a-zA-Z0-9_-]{1,64}$/;
+/** Anything of the form `scheme://…` — http, https, s3, git+ssh, file, … */
+const URL_LIKE_RE = /^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//;
+/**
+ * Load every `SKILL.md` under `dir` as a Skill Injection.
+ *
+ * Two layouts are accepted, and they can be mixed:
+ *   - `dir/<anything>/SKILL.md` — one folder per skill (the portable layout,
+ *     and the one to prefer: the folder can hold the skill's other assets).
+ *   - `dir/SKILL.md` — the directory IS one skill.
+ *
+ * The returned array is sorted by skill name, so a chart built from it is
+ * stable regardless of the order the filesystem happened to hand back.
+ *
+ * @param dir - A local filesystem path. A URL (or any `scheme://` string, or a
+ *   UNC network path) is refused by name — see the module header for why.
+ * @param opts - Applied uniformly to every loaded skill.
+ *
+ * @throws when `dir` is not a local path, does not exist, is not a directory,
+ *   or contains no `SKILL.md` at all; when a file's frontmatter is malformed
+ *   (the message names the file); or when two files claim the same skill name
+ *   (the message names both).
+ */
+async function skillsFromDir(dir, opts = {}) {
+    assertLocalDirectoryArgument(dir);
+    // Lazy node imports (browser-compat) — see module header.
+    const { readdir, readFile, stat } = await Promise.resolve().then(() => __importStar(require('node:fs/promises')));
+    const { join } = await Promise.resolve().then(() => __importStar(require('node:path')));
+    let isDirectory = false;
+    try {
+        isDirectory = (await stat(dir)).isDirectory();
+    }
+    catch {
+        throw new Error(`skillsFromDir: '${dir}' does not exist. Pass the directory that holds your ` +
+            `${SKILL_FILE} folders.`);
+    }
+    if (!isDirectory) {
+        throw new Error(`skillsFromDir: '${dir}' is a file, not a directory. Pass the directory that holds ` +
+            `your ${SKILL_FILE} folders.`);
+    }
+    const entries = await readdir(dir, { withFileTypes: true });
+    const files = [];
+    // `dir/SKILL.md` — the whole directory is one skill.
+    if (entries.some((e) => e.isFile() && e.name === SKILL_FILE)) {
+        files.push(join(dir, SKILL_FILE));
+    }
+    // `dir/<folder>/SKILL.md` — the portable layout.
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const candidate = join(dir, entry.name, SKILL_FILE);
+        try {
+            if ((await stat(candidate)).isFile())
+                files.push(candidate);
+        }
+        catch {
+            // A subdirectory without a SKILL.md is not an error — a skill folder can
+            // sit next to assets, fixtures, or anything else the author keeps here.
+        }
+    }
+    if (files.length === 0) {
+        throw new Error(`skillsFromDir: no ${SKILL_FILE} found under '${dir}'. Expected '${dir}/<skill>/${SKILL_FILE}' ` +
+            `or '${dir}/${SKILL_FILE}'.`);
+    }
+    const parsed = [];
+    for (const file of files.sort()) {
+        parsed.push(parseSkillFile(await readFile(file, 'utf8'), file));
+    }
+    // Collisions are refused naming BOTH files: with only the id in the message
+    // you would know a duplicate exists and still have to go find the pair.
+    const byName = new Map();
+    for (const skill of parsed) {
+        const clash = byName.get(skill.name);
+        if (clash) {
+            throw new Error(`skillsFromDir: two files claim the skill name '${skill.name}' — '${clash.file}' and ` +
+                `'${skill.file}'. Skill ids must be unique (read_skill dispatches by id); rename one.`);
+        }
+        byName.set(skill.name, skill);
+    }
+    return parsed
+        .slice()
+        .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))
+        .map((skill) => (0, defineSkill_js_1.defineSkill)({
+        id: skill.name,
+        description: skill.description,
+        body: skill.body,
+        ...(opts.viaToolName !== undefined && { viaToolName: opts.viaToolName }),
+        ...(opts.surfaceMode !== undefined && { surfaceMode: opts.surfaceMode }),
+    }));
+}
+exports.skillsFromDir = skillsFromDir;
+// ─── Authorship guard ──────────────────────────────────────────────
+/**
+ * Refuse anything that is not a local path, BY NAME. The message quotes what
+ * was passed, because the whole point is that the reader can see the thing
+ * that was rejected.
+ */
+function assertLocalDirectoryArgument(dir) {
+    if (typeof dir !== 'string' || dir.trim().length === 0) {
+        throw new Error(`skillsFromDir: expected a local directory path, got ${JSON.stringify(dir)}.`);
+    }
+    const scheme = URL_LIKE_RE.exec(dir);
+    if (scheme) {
+        throw new Error(`skillsFromDir: '${dir}' is a ${scheme[0].slice(0, -3)} URL, not a local directory. ` +
+            `Skill bodies are instructions to a model, so this loader only reads files you own ` +
+            `at build time — fetch remote content yourself, review it, and pass defineSkill(...) ` +
+            `the result.`);
+    }
+    if (dir.startsWith('\\\\')) {
+        throw new Error(`skillsFromDir: '${dir}' is a network (UNC) path, not a local directory. ` +
+            `Skill bodies are instructions to a model, so this loader only reads files you own ` +
+            `at build time.`);
+    }
+}
+// ─── Frontmatter ───────────────────────────────────────────────────
+/**
+ * Parse one `SKILL.md`. Every refusal names the file — a loader that says
+ * "malformed frontmatter" over a directory of forty files has told you nothing.
+ *
+ * The grammar is deliberately small: an opening `---` line, `key: value` lines
+ * (`#` comments and blank lines skipped, single/double quotes stripped), a
+ * closing `---` line, then the body. Keys other than `name` and `description`
+ * are IGNORED rather than rejected, so a file carrying extra frontmatter for
+ * another tool still loads here.
+ */
+function parseSkillFile(raw, file) {
+    // Strip a UTF-8 BOM — an editor artifact, not the author's intent.
+    const text = raw.charCodeAt(0) === 0xfeff ? raw.slice(1) : raw;
+    const lines = text.split(/\r?\n/);
+    if (lines[0]?.trim() !== '---') {
+        throw new Error(`skillsFromDir: '${file}' does not start with a '---' frontmatter block. ` +
+            `Expected:\n---\nname: my-skill\ndescription: When to use it.\n---\n<the body>`);
+    }
+    const closingIndex = lines.findIndex((line, i) => i > 0 && line.trim() === '---');
+    if (closingIndex === -1) {
+        throw new Error(`skillsFromDir: '${file}' opens a '---' frontmatter block that is never closed. ` +
+            `Add a '---' line after the last frontmatter key.`);
+    }
+    const fields = new Map();
+    for (let i = 1; i < closingIndex; i++) {
+        const line = lines[i] ?? '';
+        if (line.trim().length === 0 || line.trimStart().startsWith('#'))
+            continue;
+        const separator = line.indexOf(':');
+        if (separator === -1) {
+            throw new Error(`skillsFromDir: '${file}' frontmatter line ${i + 1} is not 'key: value' — got ` +
+                `${JSON.stringify(line)}.`);
+        }
+        const key = line.slice(0, separator).trim();
+        if (key.length === 0) {
+            throw new Error(`skillsFromDir: '${file}' frontmatter line ${i + 1} has an empty key — got ` +
+                `${JSON.stringify(line)}.`);
+        }
+        fields.set(key, unquote(line.slice(separator + 1).trim()));
+    }
+    const name = fields.get('name') ?? '';
+    const description = fields.get('description') ?? '';
+    const body = lines
+        .slice(closingIndex + 1)
+        .join('\n')
+        .trim();
+    if (name.length === 0) {
+        throw new Error(`skillsFromDir: '${file}' frontmatter is missing 'name'. It becomes the skill id the ` +
+            `model passes to read_skill.`);
+    }
+    if (!SKILL_NAME_RE.test(name)) {
+        throw new Error(`skillsFromDir: '${file}' frontmatter name '${name}' must match ` +
+            `/^[a-zA-Z0-9_-]{1,64}$/ — it is the id the model passes to read_skill.`);
+    }
+    if (description.length === 0) {
+        throw new Error(`skillsFromDir: '${file}' frontmatter is missing 'description'. It is the ONLY thing ` +
+            `the model reads when deciding whether to open this skill.`);
+    }
+    if (body.length === 0) {
+        throw new Error(`skillsFromDir: '${file}' has no body after the closing '---'. The body is what the ` +
+            `model reads once it activates the skill.`);
+    }
+    return { name, description, body, file };
+}
+/** Strip one layer of matching single or double quotes from a YAML-ish scalar. */
+function unquote(value) {
+    if (value.length >= 2) {
+        const first = value[0];
+        const last = value[value.length - 1];
+        if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+            return value.slice(1, -1);
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=skillsFromDir.js.map

package/dist/lib/injection-engine/skillsFromDir.js.map

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

package/dist/lib/mcp/index.js

@@ -1,14 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mockMcpClient = exports.mcpClient = void 0;
+exports.mockMcpClient = exports.mcpServe = exports.mcpClient = void 0;
 /**
- * MCP — Model Context Protocol client integration. Connect to an MCP
- * server, register its tools on your Agent. Server-side support is
- * separate (consumer exposes their agent as an MCP tool — different
- * use case, not yet shipped).
+ * MCP — Model Context Protocol, both directions. `mcpClient` connects to
+ * someone else's MCP server and registers its tools on your Agent;
+ * `mcpServe` exposes your own tools AS an MCP server so any MCP client
+ * can call them.
  */
 var mcpClient_js_1 = require("./mcpClient.js");
 Object.defineProperty(exports, "mcpClient", { enumerable: true, get: function () { return mcpClient_js_1.mcpClient; } });
+var mcpServe_js_1 = require("./mcpServe.js");
+Object.defineProperty(exports, "mcpServe", { enumerable: true, get: function () { return mcpServe_js_1.mcpServe; } });
 var mockMcpClient_js_1 = require("./mockMcpClient.js");
 Object.defineProperty(exports, "mockMcpClient", { enumerable: true, get: function () { return mockMcpClient_js_1.mockMcpClient; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/mcp/index.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,+CAA2C;AAAlC,yGAAA,SAAS,OAAA;AAClB,uDAAgG;AAAvF,iHAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/mcp/index.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,+CAA2C;AAAlC,yGAAA,SAAS,OAAA;AAClB,6CAAyC;AAAhC,uGAAA,QAAQ,OAAA;AACjB,uDAAgG;AAAvF,iHAAA,aAAa,OAAA"}