holon-sh 0.0.1-dev.6 → 0.0.1-dev.8

package/dist/runtime.js

@@ -0,0 +1,276 @@
+import { Client, isInputRequiredResult, SdkHttpError, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
+import { AjvJsonSchemaValidator } from "@modelcontextprotocol/client/validators/ajv";
+import { EXTENSION } from "./ext/files.js";
+import { acceptUploadRequests, downloads, isUploadRequest, prepare, settings, upload } from "./ext/files.client.js";
+import { ToolCallError } from "./protocol.js";
+export { ToolCallError } from "./protocol.js";
+// Environment-bound calls reuse the last server/discover result for the same endpoint and token instead of discovering
+// the server on every call. A dependency keeps only its latest result, so a changed endpoint or token replaces it.
+const DISCOVERY = Symbol("discovery");
+const discovered = new Map();
+const LEGACY_VERDICT_MS = 10 * 60 * 1000;
+// Object methods JavaScript calls implicitly; tools with these names stay reachable through callTool.
+const reserved = new Set(["then", "toJSON", "toString", "valueOf", "toLocaleString"]);
+// The MCP client's own Ajv, one engine per schema so contracts that reuse an $id stay apart. Contracts are module
+// constants, so each schema compiles once however often createApps runs.
+const checks = new WeakMap();
+function defaultValidator(schema) {
+    const cached = checks.get(schema);
+    if (cached)
+        return cached;
+    const compiled = new AjvJsonSchemaValidator().getValidator(schema);
+    const check = value => {
+        const { valid, errorMessage } = compiled(value);
+        check.errors = errorMessage;
+        return valid;
+    };
+    checks.set(schema, check);
+    return check;
+}
+function environment(name) {
+    const prefix = `${name.toUpperCase().replaceAll("-", "_")}_MCP_`;
+    const endpoint = process.env[`${prefix}URL`];
+    // Environment-bound dependencies connect for one call at a time, sending <NAME>_MCP_TOKEN as the bearer token when it is set.
+    const token = process.env[`${prefix}TOKEN`];
+    if (endpoint)
+        return { endpoint, scoped: true, [DISCOVERY]: `${endpoint} ${token ?? ""}`, ...(token && { authProvider: { token: async () => token } }) };
+    throw new Error(`Dependency ${name} is unavailable (${prefix}URL). Provide a binding or set the environment variable.`);
+}
+function validate(check, value, label) {
+    if (!check(value))
+        throw new Error(`Invalid ${label}: ${JSON.stringify(check.errors)}`);
+}
+function sleep(milliseconds, signal) {
+    return new Promise(resolve => {
+        const done = () => {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", done);
+            resolve();
+        };
+        const timer = setTimeout(done, milliseconds);
+        signal?.addEventListener("abort", done, { once: true });
+    });
+}
+function untilAborted(promise, signal) {
+    if (!signal)
+        return promise;
+    return new Promise((resolve, reject) => {
+        const aborted = () => reject(signal.reason);
+        signal.addEventListener("abort", aborted, { once: true });
+        promise.then(resolve, reject).finally(() => signal.removeEventListener("abort", aborted));
+    });
+}
+// The MCP client ends a request after 60 s unless given a timeout. A request without one waits as long as a timer can
+// (2^31 - 1 ms, about 24.8 days). A request with one asks for progress, and progress restarts its timeout.
+function patient(options) {
+    return options?.timeout === undefined
+        ? { ...options, timeout: 2 ** 31 - 1 }
+        : { onprogress: () => { }, resetTimeoutOnProgress: true, ...options };
+}
+/** Construct only the explicitly bound dependencies. Unknown names throw; an empty binding map selects none. Used by generated createApps factories. */
+export function bindApps(identity, contracts, bindings, options) {
+    const selected = Object.fromEntries(Object.keys(bindings).map((name) => {
+        if (!Object.hasOwn(contracts, name) && !Object.hasOwn(identity.requires ?? {}, name))
+            throw new Error("Unknown app binding: " + name);
+        return [name, contracts[name] ?? null];
+    }));
+    return createApps(identity, selected, bindings, options);
+}
+/** Construct runtime clients from identity and contracts. Connections open lazily. Explicit and resolved endpoint bindings reuse one session unless scoped is true; <NAME>_MCP_URL bindings use one session per call. Close persistent clients on shutdown. Most callers use the generated clients. */
+export function createApps(identity, contracts, bindings, options) {
+    const { validator = defaultValidator, resolve = environment, session: hosted } = options ?? {};
+    const apps = Object.create(null);
+    // Without explicit bindings, every declared dependency gets a client; those without a contract are untyped.
+    const members = { ...(bindings ? {} : Object.fromEntries(Object.keys(identity.requires ?? {}).map(name => [name, null]))), ...contracts };
+    for (const [name, contract] of Object.entries(members)) {
+        const binding = bindings?.[name];
+        // Without explicit bindings, the resolve hook supplies the binding on every call.
+        const current = () => binding ?? (bindings ? undefined : resolve(name));
+        let connection;
+        const connect = (resolved, prior) => {
+            // Every client can be asked: a call answers with elicit, or the question reaches its caller. Servers must not assume a client answers: https://modelcontextprotocol.io/specification/2026-07-28/basic/patterns/mrtr#server-requirements-basic-workflow
+            // On 2026-07-28 the client sends these capabilities in every request's _meta: https://github.com/modelcontextprotocol/typescript-sdk/blob/fcef852f6cdafea07f36cf6fae69b37c8adf85be/packages/client/src/client/client.ts#L700-L711
+            const client = new Client({ name: identity.name, version: identity.version }, { capabilities: { elicitation: { form: {}, url: {} }, extensions: { [EXTENSION]: { upload: {}, download: {} } } }, versionNegotiation: { mode: "auto" } });
+            const endpoint = new URL(resolved.endpoint);
+            const transport = acceptUploadRequests(new StreamableHTTPClientTransport(endpoint, { authProvider: resolved.authProvider, fetch: async (input, init) => {
+                    if (String(input) === endpoint.href)
+                        current.authorization = new Headers(init?.headers).get("authorization") ?? undefined;
+                    const response = await (resolved.fetch ?? fetch)(input, init);
+                    current.answered ||= response.ok;
+                    return response;
+                }, requestInit: { credentials: "include", redirect: "error", headers: resolved.installationUID ? { "X-Holon-Installation-UID": resolved.installationUID } : {} } }));
+            transport.onclose = () => { if (connection === current)
+                connection = undefined; };
+            const ready = client.connect(transport, { prior }).catch(async (error) => {
+                await transport.close();
+                throw error;
+            });
+            const current = { client, resolved, ready, answered: false, close: async () => {
+                    await transport.terminateSession().catch(() => { });
+                    await transport.close();
+                    await ready.catch(() => { });
+                } };
+            return current;
+        };
+        // The session hook serves bindings the runtime does not connect to itself.
+        const host = binding ? hosted?.(name, binding) : undefined;
+        const session = async (options, run) => {
+            options?.signal?.throwIfAborted();
+            if (host)
+                return run(host);
+            const resolved = current();
+            if (!resolved?.endpoint)
+                throw new Error(`Dependency ${name} is unavailable. Provide a binding.`);
+            // Bindings marked scoped connect for one call at a time.
+            const scoped = resolved.scoped === true;
+            const key = resolved[DISCOVERY];
+            const cached = discovered.get(name);
+            const prior = key !== undefined && cached?.key === key && Date.now() < cached.expires ? cached.prior : undefined;
+            const active = scoped ? connect(resolved, prior) : (connection ??= connect(resolved));
+            try {
+                await untilAborted(active.ready, options?.signal);
+                if (key !== undefined && !prior) {
+                    const discover = active.client.getDiscoverResult();
+                    discovered.set(name, { key, prior: discover ? { kind: "modern", discover } : { kind: "legacy" }, expires: discover ? Infinity : Date.now() + LEGACY_VERDICT_MS });
+                }
+                return await run(active.client, active);
+            }
+            catch (error) {
+                // A server that no longer speaks the discovered protocol rejects the first request without running it.
+                if (!prior || active.answered || !(SdkHttpError.isInstance(error) && error.status === 400))
+                    throw error;
+                discovered.delete(name);
+                return session(options, run);
+            }
+            finally {
+                if (scoped)
+                    await active.close();
+            }
+        };
+        const tools = Object.create(null);
+        const definitions = new Map((contract?.tools ?? []).map(definition => [definition.name, { definition }]));
+        const callTool = async (request, { elicit, ...options } = {}) => {
+            const tool = definitions.get(request.name);
+            if (!tool && contract)
+                throw new Error(`Unknown tool ${name}.${request.name}.`);
+            // A contract's tool is the tool as its server listed it.
+            const sent = { ...patient(options), allowInputRequired: true, ...(tool && { toolDefinition: { ...tool.definition, outputSchema: undefined } }) };
+            const label = `${name}.${request.name}`;
+            const result = await session(options, async (client, connection) => {
+                const { arguments: args, files } = await prepare(request.arguments, {
+                    label, connection,
+                    schema: async () => tool?.definition.inputSchema ?? (await client.listTools(undefined, patient(options))).tools.find(({ name }) => name === request.name)?.inputSchema,
+                });
+                // The SDK's request type leaves out the continuation fields the protocol carries.
+                let next = files.size ? { ...request, arguments: args } : request;
+                let uploaded = false;
+                for (let round = 0;;) {
+                    let result;
+                    try {
+                        result = await client.callTool(next, sent);
+                    }
+                    catch (error) {
+                        if (connection && isUploadRequest(error)) {
+                            if (uploaded)
+                                throw new Error(`${label}: the server asked for a second upload; the tool did not run.`);
+                            const requestState = await upload(error.data, files, connection, options.signal, label);
+                            uploaded = true;
+                            const { inputResponses, ...retry } = next;
+                            next = { ...retry, requestState };
+                            continue;
+                        }
+                        if (uploaded)
+                            throw new Error(`${label}: the outcome is unknown; the tool may have run (${error?.message ?? error}).`, { cause: error });
+                        throw error;
+                    }
+                    // A server may keep asking, so answering stops after ten rounds, the MCP clients' own limit, and the last question reaches the caller.
+                    if (!elicit || !isInputRequiredResult(result) || round++ === 10)
+                        return connection ? downloads(result, connection, settings(connection) !== undefined) : result;
+                    const inputResponses = {};
+                    for (const [key, question] of Object.entries(result.inputRequests ?? {})) {
+                        // Every client declares elicitation alone, so it answers nothing else and such a question reaches the caller.
+                        if (question.method !== "elicitation/create")
+                            return result;
+                        inputResponses[key] = await elicit(question.params);
+                    }
+                    next = { ...next, inputResponses, requestState: result.requestState };
+                }
+            });
+            if (isInputRequiredResult(result))
+                return result;
+            // The server validates arguments; the client checks the output against the contract it was compiled against.
+            if (!result.isError && tool?.definition.outputSchema) {
+                validate(tool.output ??= validator(tool.definition.outputSchema), result.structuredContent, `structured output from ${name}.${request.name}`);
+            }
+            // isError tells ToolResult's success variant from its error variant.
+            return { ...result, resultType: "complete" };
+        };
+        const listTools = (options) => session(options, client => client.listTools(undefined, patient(options)));
+        for (const tool of contract?.tools ?? [])
+            if (!reserved.has(tool.name)) {
+                tools[tool.name] = async (input, options) => {
+                    const result = await callTool({ name: tool.name, arguments: input }, options);
+                    if (result.resultType === "input_required" || result.isError)
+                        throw new ToolCallError(name, tool.name, result);
+                    return tool.outputSchema ? result.structuredContent : result;
+                };
+            }
+        const resources = Object.create(null);
+        for (const resource of contract?.resources ?? []) {
+            let valid;
+            const parse = (result) => {
+                // Contracted resources are JSON in their first text content.
+                const [content] = result.contents;
+                if (!content || !("text" in content))
+                    throw new Error(`Invalid contents from ${name} ${resource.uri}: no text content`);
+                const value = JSON.parse(content.text);
+                valid ??= validator(resource.outputSchema);
+                validate(valid, value, `contents from ${name} ${resource.uri}`);
+                return value;
+            };
+            const read = async (options) => parse(await session(options, client => client.readResource({ uri: resource.uri }, patient(options))));
+            const watch = async (onChange, { signal } = {}) => {
+                const resolved = current();
+                if (!resolved?.endpoint)
+                    throw new Error(`Watching ${name} ${resource.uri} requires an endpoint binding.`);
+                // An abort ends the wait between attempts early instead of failing it.
+                for (let established = false; !signal?.aborted; await sleep(1000, signal)) {
+                    const current = connect(resolved);
+                    let failure;
+                    try {
+                        await untilAborted(current.ready, signal);
+                        const { client } = current;
+                        if (!client.getServerCapabilities()?.resources?.subscribe)
+                            throw new Error(`${name} does not advertise resource subscriptions.`);
+                        let reads = Promise.resolve();
+                        const refresh = () => (reads = reads.then(async () => onChange(parse(await client.readResource({ uri: resource.uri }, patient({ signal, cacheMode: "bypass" })))))
+                            .catch(error => { failure ??= error; return current.close(); }));
+                        client.setNotificationHandler("notifications/resources/updated", ({ params }) => { if (params.uri === resource.uri)
+                            void refresh(); });
+                        const subscription = await client.listen({ resourceSubscriptions: [resource.uri] }, { signal });
+                        if (!subscription.honoredFilter.resourceSubscriptions?.includes(resource.uri))
+                            throw new Error(`${name} did not accept a subscription to ${resource.uri}.`);
+                        established = true;
+                        await refresh();
+                        await subscription.closed;
+                    }
+                    catch (error) {
+                        failure ??= error;
+                    }
+                    finally {
+                        await current.close();
+                    }
+                    if (signal?.aborted)
+                        return;
+                    if (failure && !established)
+                        throw failure;
+                }
+            };
+            resources[resource.uri] = Object.freeze({ read, watch });
+        }
+        // Generated clients narrow callTool to their contract's tools and outputs, which validation upholds.
+        apps[name] = Object.freeze({ callTool: callTool, listTools, resources: Object.freeze(resources), close: async () => { await connection?.close(); }, tools: Object.freeze(tools) });
+    }
+    return Object.freeze(apps);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "holon-sh",
-  "version": "0.0.1-dev.6",
-  "description": "Typed MCP clients and app view resources for Node.js.",
+  "version": "0.0.1-dev.8",
+  "description": "Typed MCP clients and the caller of an MCP request, for Node.js.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/holon-sh/sdk-ts.git",
@@ -16,45 +16,59 @@
     "access": "public"
   },
   "holon": {
-    "slot": "generated",
-    "contractVersion": 1
+    "contractVersion": 2
   },
   "exports": {
-    ".": {
-      "types": "./generated/index.d.ts",
-      "import": "./generated/index.js"
-    },
     "./runtime": {
-      "types": "./runtime.d.ts",
-      "import": "./runtime.mjs"
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js"
     },
-    "./view": {
-      "types": "./view.d.ts",
-      "import": "./view.js"
+    "./context": {
+      "types": "./dist/context.d.ts",
+      "import": "./dist/context.js"
     },
     "./protocol": {
-      "types": "./protocol.d.ts",
-      "import": "./runtime.mjs"
+      "types": "./dist/protocol.d.ts",
+      "import": "./dist/protocol.js"
+    },
+    "./ext/files": {
+      "types": "./dist/ext/files.d.ts",
+      "import": "./dist/ext/files.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "runtime": [
+        "./dist/runtime.d.ts"
+      ],
+      "context": [
+        "./dist/context.d.ts"
+      ],
+      "protocol": [
+        "./dist/protocol.d.ts"
+      ],
+      "ext/files": [
+        "./dist/ext/files.d.ts"
+      ]
+    }
+  },
+  "imports": {
+    "#platform": {
+      "node": "./dist/ext/platform.node.js",
+      "default": "./dist/ext/platform.browser.js"
     }
   },
   "files": [
-    "runtime.mjs",
-    "runtime.d.ts",
-    "validate.mjs",
-    "protocol.d.ts",
-    "view.js",
-    "view.d.ts",
-    "generated/",
-    "README.md"
+    "dist",
+    "src"
   ],
   "scripts": {
-    "build": "node scripts/build.mjs",
-    "prepack": "npm run build",
-    "docs:build": "node scripts/build-reference.mjs"
+    "build": "node scripts/build.ts && tsc",
+    "prepack": "npm run build"
   },
   "dependencies": {
     "@modelcontextprotocol/client": "^2.3.1",
-    "ajv": "^8.20.0",
-    "ajv-formats": "^3.0.1"
+    "ipaddr.js": "^2.5.0",
+    "undici": "^7.16.0"
   }
 }

package/src/context.ts

@@ -0,0 +1,29 @@
+/** Standard OpenID Connect address claims. */
+export interface AddressClaims {
+  formatted?: string; street_address?: string; locality?: string; region?: string; postal_code?: string; country?: string;
+  [claim: string]: unknown;
+}
+/** Standard OpenID Connect claims. Holon drops one whose value has the wrong type; other claims pass through as JSON. */
+export interface IdentityClaims {
+  name?: string; given_name?: string; family_name?: string; middle_name?: string; nickname?: string;
+  preferred_username?: string; profile?: string; picture?: string; website?: string; email?: string;
+  email_verified?: boolean; gender?: string; birthdate?: string; zoneinfo?: string; locale?: string;
+  phone_number?: string; phone_number_verified?: boolean; address?: AddressClaims; updated_at?: number;
+  [claim: string]: unknown;
+}
+/** The user a request acts for, as Holon admitted it. */
+export interface Principal { issuer: string; subject: string; clientId: string; scopes: string[]; claims: IdentityClaims; actor?: Record<string, unknown> }
+/** The caller of the current MCP request. principal is null for anonymous requests. */
+export interface RequestContext { principal: Principal | null }
+
+// Holon admits the caller before the request reaches the server and hands it over as MCP's authInfo, with claims and
+// act in these shapes.
+interface Admitted { iss?: unknown; sub?: unknown; claims?: IdentityClaims; act?: Record<string, unknown> }
+
+/** Read the caller from the context an MCP server receives: a tool callback's ctx.http, or the McpRequestContext of a createMcpHandler factory. */
+export function getContext(context: { authInfo?: { clientId: string; scopes: string[]; extra?: Record<string, unknown> } } = {}): RequestContext {
+  const { authInfo } = context;
+  const { iss, sub, claims, act } = (authInfo?.extra ?? {}) as Admitted;
+  if (!authInfo || typeof iss !== "string" || typeof sub !== "string") return { principal: null };
+  return { principal: { issuer: iss, subject: sub, clientId: authInfo.clientId, scopes: authInfo.scopes, claims: claims ?? {}, ...(act && { actor: act }) } };
+}