toolcraft 0.0.119 → 0.0.121

package/node_modules/tiny-http-mcp-server/dist/test-support.js

@@ -0,0 +1,398 @@
+import http from "node:http";
+import https from "node:https";
+import { EventEmitter } from "node:events";
+import { Readable } from "node:stream";
+import { Audio, defineSchema, File, Image } from "tiny-stdio-mcp-server";
+import { createHttpServer } from "./http-server.js";
+const TEST_PNG_BASE64 = "iVBORw0KGgo=";
+const TEST_MP3_BASE64 = "SUQzBAAAAAA=";
+const IN_MEMORY_HTTP_STATE = Symbol.for("tiny-http-mcp-server.in-memory-http-state");
+const IN_MEMORY_HTTP_META = Symbol.for("tiny-http-mcp-server.in-memory-http-meta");
+function getInMemoryHttpState() {
+    const target = globalThis;
+    if (target[IN_MEMORY_HTTP_STATE] === undefined) {
+        target[IN_MEMORY_HTTP_STATE] = {
+            installed: false,
+            nextPort: 41_000,
+            servers: new Map()
+        };
+    }
+    return target[IN_MEMORY_HTTP_STATE];
+}
+function normalizeRequestHostname(hostname) {
+    if (hostname.startsWith("[") && hostname.endsWith("]")) {
+        return hostname.slice(1, -1);
+    }
+    return hostname;
+}
+function formatHostnameForOrigin(hostname) {
+    return hostname.includes(":") && !hostname.startsWith("[") ? `[${hostname}]` : hostname;
+}
+function normalizeListenHostname(hostname) {
+    if (hostname === undefined || hostname.length === 0) {
+        return "127.0.0.1";
+    }
+    return hostname === "localhost" ? "127.0.0.1" : hostname;
+}
+function parseListenArgs(args) {
+    const callback = args.find((arg) => typeof arg === "function");
+    const options = args.find((arg) => typeof arg === "object" && arg !== null && !Array.isArray(arg));
+    if (options !== undefined) {
+        return {
+            port: options.port ?? 0,
+            hostname: normalizeListenHostname(options.host ?? options.hostname),
+            callback
+        };
+    }
+    const port = typeof args[0] === "number" ? args[0] : 0;
+    const hostname = typeof args[1] === "string" ? args[1] : undefined;
+    return {
+        port,
+        hostname: normalizeListenHostname(hostname),
+        callback
+    };
+}
+export function installInMemoryHttp() {
+    const state = getInMemoryHttpState();
+    if (state.installed) {
+        return;
+    }
+    state.installed = true;
+    const originalAddress = http.Server.prototype.address;
+    const originalClose = http.Server.prototype.close;
+    const originalFetch = globalThis.fetch.bind(globalThis);
+    http.Server.prototype.listen = function listen(...args) {
+        const { port: requestedPort, hostname, callback } = parseListenArgs(args);
+        const port = requestedPort === 0 ? state.nextPort++ : requestedPort;
+        const address = normalizeListenHostname(hostname);
+        const origin = `http://${formatHostnameForOrigin(address)}:${port}`;
+        const meta = {
+            origin,
+            address: {
+                address,
+                family: address.includes(":") ? "IPv6" : "IPv4",
+                port
+            },
+            listening: true
+        };
+        this[IN_MEMORY_HTTP_META] = meta;
+        state.servers.set(origin, this);
+        Object.defineProperty(this, "listening", {
+            configurable: true,
+            get() {
+                return this[IN_MEMORY_HTTP_META]?.listening ?? false;
+            }
+        });
+        queueMicrotask(() => {
+            this.emit("listening");
+            callback?.();
+        });
+        return this;
+    };
+    http.Server.prototype.address = function address() {
+        return this[IN_MEMORY_HTTP_META]?.address ?? originalAddress.call(this);
+    };
+    http.Server.prototype.close = function close(callback) {
+        const meta = this[IN_MEMORY_HTTP_META];
+        if (meta === undefined) {
+            return originalClose.call(this, callback);
+        }
+        if (meta.listening) {
+            state.servers.delete(meta.origin);
+            meta.listening = false;
+        }
+        queueMicrotask(() => {
+            callback?.();
+            this.emit("close");
+        });
+        return this;
+    };
+    globalThis.fetch = async (input, init = {}) => {
+        const normalized = normalizeFetchInput(input, init);
+        const inMemoryServer = getInMemoryServer(normalized.url);
+        if (inMemoryServer !== undefined) {
+            return fetchInMemory(inMemoryServer, normalized.url, normalized.init);
+        }
+        return originalFetch(input, init);
+    };
+}
+function getInMemoryServer(url) {
+    const state = globalThis[IN_MEMORY_HTTP_STATE];
+    if (state?.installed !== true) {
+        return undefined;
+    }
+    return state.servers.get(url.origin);
+}
+async function readFetchBody(body) {
+    if (body === undefined || body === null) {
+        return undefined;
+    }
+    if (typeof body === "string") {
+        return body;
+    }
+    if (body instanceof Uint8Array) {
+        return Buffer.from(body).toString("utf8");
+    }
+    if (body instanceof URLSearchParams) {
+        return body.toString();
+    }
+    if (body instanceof ReadableStream) {
+        return new Response(body).text();
+    }
+    return String(body);
+}
+async function fetchInMemory(server, url, init) {
+    const headers = new Headers(init.headers);
+    if (!headers.has("host")) {
+        headers.set("host", url.host);
+    }
+    const body = await readFetchBody(init.body);
+    const request = Object.assign(Readable.from(body === undefined ? [] : [body]), {
+        method: init.method ?? "GET",
+        url: `${url.pathname}${url.search}`,
+        headers: Object.fromEntries(headers.entries()),
+        socket: {}
+    });
+    const response = new EventEmitter();
+    let streamController;
+    const responseBody = new ReadableStream({
+        start(controller) {
+            streamController = controller;
+        }
+    });
+    response.statusCode = 200;
+    response.statusMessage = "OK";
+    response.chunks = [];
+    response.headerValues = new Headers();
+    response.headersSent = false;
+    response.writableEnded = false;
+    const setResponseHeader = (name, value) => {
+        response.headerValues.delete(name);
+        if (Array.isArray(value) && name.toLowerCase() === "set-cookie") {
+            for (const entry of value) {
+                response.headerValues.append(name, entry);
+            }
+            return;
+        }
+        if (Array.isArray(value)) {
+            response.headerValues.set(name, value.join(", "));
+            return;
+        }
+        response.headerValues.set(name, String(value));
+    };
+    response.setHeader = ((name, value) => {
+        setResponseHeader(name, value);
+        return response;
+    });
+    response.getHeader = ((name) => {
+        return response.headerValues.get(name) ?? undefined;
+    });
+    response.getHeaders = (() => {
+        return Object.fromEntries(response.headerValues.entries());
+    });
+    response.removeHeader = ((name) => {
+        response.headerValues.delete(name);
+    });
+    response.writeHead = ((statusCode, responseHeaders) => {
+        response.statusCode = statusCode;
+        response.headersSent = true;
+        for (const [key, value] of Object.entries(responseHeaders ?? {})) {
+            setResponseHeader(key, value);
+        }
+        return response;
+    });
+    response.write = ((chunk) => {
+        const bytes = typeof chunk === "string" ? Buffer.from(chunk) : Buffer.from(chunk);
+        response.chunks.push(bytes);
+        streamController?.enqueue(bytes);
+        return true;
+    });
+    response.end = ((chunk) => {
+        if (chunk !== undefined) {
+            response.write(chunk);
+        }
+        if (!response.writableEnded) {
+            response.writableEnded = true;
+            try {
+                streamController?.close();
+            }
+            catch {
+                // Already closed by an abort.
+            }
+            response.emit("finish");
+            response.emit("close");
+        }
+        return response;
+    });
+    response.flushHeaders = (() => {
+        response.headersSent = true;
+    });
+    const signal = init.signal ?? undefined;
+    if (signal !== undefined) {
+        const abort = () => {
+            response.end();
+        };
+        if (signal.aborted) {
+            abort();
+        }
+        else {
+            signal.addEventListener("abort", abort, { once: true });
+        }
+    }
+    server.emit("request", request, response);
+    await new Promise((resolve) => {
+        if (response.headersSent || response.writableEnded) {
+            resolve();
+            return;
+        }
+        response.flushHeaders = (() => {
+            response.headersSent = true;
+            resolve();
+        });
+        response.once("finish", resolve);
+    });
+    const responseContent = response.writableEnded ? Buffer.concat(response.chunks) : responseBody;
+    return new Response(response.statusCode === 204 ? null : responseContent, {
+        status: response.statusCode,
+        statusText: response.statusMessage,
+        headers: response.headerValues
+    });
+}
+function normalizeFetchInput(input, init = {}) {
+    if (input instanceof Request) {
+        return {
+            url: new URL(input.url),
+            init: {
+                ...init,
+                method: init.method ?? input.method,
+                headers: init.headers ?? input.headers,
+                body: init.body ?? input.body,
+                signal: init.signal ?? input.signal
+            }
+        };
+    }
+    return {
+        url: new URL(String(input)),
+        init
+    };
+}
+export async function nodeFetch(input, init = {}) {
+    const { url, init: normalizedInit } = normalizeFetchInput(input, init);
+    const inMemoryServer = getInMemoryServer(url);
+    if (inMemoryServer !== undefined) {
+        return fetchInMemory(inMemoryServer, url, normalizedInit);
+    }
+    const client = url.protocol === "https:" ? https : http;
+    const headers = new Headers(normalizedInit.headers);
+    return new Promise((resolve, reject) => {
+        const request = client.request({
+            method: normalizedInit.method ?? "GET",
+            hostname: normalizeRequestHostname(url.hostname),
+            port: url.port.length > 0 ? Number(url.port) : url.protocol === "https:" ? 443 : 80,
+            path: `${url.pathname}${url.search}`,
+            headers: Object.fromEntries(headers.entries())
+        }, (response) => {
+            const responseHeaders = new Headers();
+            for (const [key, value] of Object.entries(response.headers)) {
+                if (typeof value === "string") {
+                    responseHeaders.set(key, value);
+                    continue;
+                }
+                if (Array.isArray(value)) {
+                    for (const entry of value) {
+                        responseHeaders.append(key, entry);
+                    }
+                }
+            }
+            const body = response.statusCode === 204
+                ? null
+                : Readable.toWeb(response);
+            resolve(new Response(body, {
+                status: response.statusCode ?? 0,
+                statusText: response.statusMessage ?? "",
+                headers: responseHeaders
+            }));
+        });
+        request.on("error", reject);
+        const signal = normalizedInit.signal ?? undefined;
+        if (signal !== undefined) {
+            const onAbort = () => {
+                request.destroy(new Error("Request aborted"));
+            };
+            if (signal.aborted) {
+                onAbort();
+                return;
+            }
+            signal.addEventListener("abort", onAbort, { once: true });
+            request.once("close", () => {
+                signal.removeEventListener("abort", onAbort);
+            });
+        }
+        if (typeof normalizedInit.body === "string" || normalizedInit.body instanceof Uint8Array) {
+            request.write(normalizedInit.body);
+        }
+        else if (normalizedInit.body instanceof URLSearchParams) {
+            request.write(normalizedInit.body.toString());
+        }
+        request.end();
+    });
+}
+export function createTestMcpServer(options = {}) {
+    const emptySchema = defineSchema({});
+    const textSchema = defineSchema({
+        text: { type: "string" }
+    });
+    return (createHttpServer({
+        name: options.name ?? "conformance-test-server",
+        version: options.version ?? "1.0.0",
+        ...(hasOwnProperty(options, "enableJsonResponse")
+            ? { enableJsonResponse: options.enableJsonResponse }
+            : {}),
+        ...(hasOwnProperty(options, "sessionIdGenerator")
+            ? { sessionIdGenerator: options.sessionIdGenerator }
+            : {}),
+        ...(hasOwnProperty(options, "oauth") ? { oauth: options.oauth } : {})
+    })
+        .tool("echo", "Echo input text", textSchema, ({ text }) => String(text))
+        .tool("reverse", "Reverse input text", textSchema, ({ text }) => String(text).split("").reverse().join(""))
+        .tool("uppercase", "Uppercase input text", textSchema, ({ text }) => String(text).toUpperCase())
+        .tool("get_user", "Return a test user object", defineSchema({ id: { type: "string" } }), ({ id }) => ({
+        id: String(id),
+        name: "Alice",
+        role: "admin"
+    }), {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            name: { type: "string" },
+            role: { type: "string" }
+        },
+        required: ["id", "name", "role"],
+        additionalProperties: false
+    })
+        // Deliberately untyped fixture: exercises legacy JSON-array text fallback.
+        .tool("get_list", "Return a numeric array", emptySchema, () => [1, 2, 3])
+        .tool("get_image", "Return an image block", emptySchema, () => Image.fromBase64(TEST_PNG_BASE64, "image/png"))
+        .tool("get_audio", "Return an audio block", emptySchema, () => Audio.fromBase64(TEST_MP3_BASE64, "audio/mpeg"))
+        .tool("get_file", "Return a file block", emptySchema, () => File.fromText("hello,world", "text/csv"))
+        .tool("get_mixed", "Return multiple content blocks", emptySchema, () => [
+        Image.fromBase64(TEST_PNG_BASE64, "image/png"),
+        "Caption for the image",
+        File.fromText("notes")
+    ])
+        .tool("throw_sync", "Throw synchronously", emptySchema, () => {
+        throw new Error("sync boom");
+    })
+        .tool("throw_async", "Throw asynchronously", emptySchema, async () => {
+        throw new Error("async boom");
+    })
+        .tool("empty_result", "Return undefined", emptySchema, () => undefined)
+        .tool("slow", "Resolve slowly", emptySchema, async () => {
+        await new Promise((resolve) => setTimeout(resolve, 10));
+        return "done";
+    })
+        .tool("large_output", "Return 100KB of text", emptySchema, () => "x".repeat(100_000)));
+}
+function hasOwnProperty(value, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}

package/node_modules/tiny-http-mcp-server/dist/testing.d.ts

@@ -0,0 +1,59 @@
+import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import type { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import type { HttpServer, HttpServerHandle } from "./http-server.js";
+import { type TokenVerifier } from "./auth.js";
+export { createTestMcpServer, installInMemoryHttp, nodeFetch } from "./test-support.js";
+export interface HttpTestPair {
+    client: Client;
+    transport: StreamableHTTPClientTransport;
+    handle: HttpServerHandle;
+    url: string;
+    cleanup(): Promise<void>;
+}
+export interface TinyHttpRequestLogEntry {
+    method: string;
+    sessionId: string | null;
+    jsonRpcMethod?: string;
+    responseContentType?: string | null;
+}
+export interface TinyHttpTestPair {
+    client: {
+        listTools(): Promise<{
+            tools: Array<{
+                name: string;
+            }>;
+        }>;
+        callTool(params: {
+            name: string;
+            arguments?: Record<string, unknown>;
+        }): Promise<{
+            content: unknown[];
+            isError?: boolean;
+        }>;
+        close(): Promise<void>;
+    };
+    transport: unknown;
+    handle: HttpServerHandle;
+    url: string;
+    requests: TinyHttpRequestLogEntry[];
+    cleanup(): Promise<void>;
+}
+export interface InMemoryAccessTokenInput {
+    token?: string;
+    issuer: string;
+    audience: readonly string[];
+    scopes: readonly string[];
+    expiresAt: number;
+    claims?: Record<string, unknown>;
+    subject?: string;
+    clientId?: string;
+}
+export interface InMemoryTokenVerifier {
+    verifier: TokenVerifier;
+    issueToken(input: InMemoryAccessTokenInput): string;
+}
+export declare function createInMemoryTokenVerifier(options?: Partial<{
+    now: () => number;
+}>): InMemoryTokenVerifier;
+export declare function createHttpTestPair(server: HttpServer): Promise<HttpTestPair>;
+export declare function createHttpTestPairWithTinyClient(server: HttpServer): Promise<TinyHttpTestPair>;

package/node_modules/tiny-http-mcp-server/dist/testing.js

@@ -0,0 +1,191 @@
+import { TokenVerificationError } from "./auth.js";
+import { installInMemoryHttp, nodeFetch } from "./test-support.js";
+export { createTestMcpServer, installInMemoryHttp, nodeFetch } from "./test-support.js";
+function cloneVerifiedAccessToken(token) {
+    return {
+        ...token,
+        audience: [...token.audience],
+        scopes: [...token.scopes],
+        claims: structuredClone(token.claims)
+    };
+}
+export function createInMemoryTokenVerifier(options = {}) {
+    const tokens = new Map();
+    const now = options.now ?? (() => Math.floor(Date.now() / 1_000));
+    let nextTokenId = 1;
+    return {
+        verifier: {
+            async verify(input) {
+                const token = tokens.get(input.token);
+                if (token === undefined) {
+                    throw new TokenVerificationError({
+                        error: "invalid_token",
+                        errorDescription: "unknown token"
+                    });
+                }
+                if (!input.authorizationServers.includes(token.issuer)) {
+                    throw new TokenVerificationError({
+                        error: "invalid_token",
+                        errorDescription: "issuer mismatch"
+                    });
+                }
+                if (!token.audience.includes(input.resource)) {
+                    throw new TokenVerificationError({
+                        error: "invalid_token",
+                        errorDescription: "audience mismatch"
+                    });
+                }
+                if (token.expiresAt <= now()) {
+                    throw new TokenVerificationError({
+                        error: "invalid_token",
+                        errorDescription: "token expired"
+                    });
+                }
+                if (input.requiredScopes.length > 0 &&
+                    !token.scopes.some((scope) => input.requiredScopes.includes(scope))) {
+                    throw new TokenVerificationError({
+                        error: "insufficient_scope",
+                        errorDescription: "insufficient scope",
+                        scope: input.requiredScopes
+                    });
+                }
+                return cloneVerifiedAccessToken(token);
+            }
+        },
+        issueToken(input) {
+            const token = input.token ?? `test-token-${nextTokenId++}`;
+            if (tokens.has(token)) {
+                throw new Error(`Token has already been issued: ${token}`);
+            }
+            const audience = [...input.audience];
+            const scopes = [...input.scopes];
+            const claims = {
+                ...(input.claims ?? {}),
+                iss: input.issuer,
+                aud: audience.length === 1 ? audience[0] : audience,
+                exp: input.expiresAt,
+                scope: scopes.join(" "),
+                ...(input.subject === undefined
+                    ? {}
+                    : {
+                        sub: input.subject
+                    }),
+                ...(input.clientId === undefined
+                    ? {}
+                    : {
+                        client_id: input.clientId
+                    })
+            };
+            tokens.set(token, {
+                token,
+                issuer: input.issuer,
+                audience,
+                scopes,
+                expiresAt: input.expiresAt,
+                claims,
+                ...(input.subject === undefined
+                    ? {}
+                    : {
+                        subject: input.subject
+                    }),
+                ...(input.clientId === undefined
+                    ? {}
+                    : {
+                        clientId: input.clientId
+                    })
+            });
+            return token;
+        }
+    };
+}
+export async function createHttpTestPair(server) {
+    let sdkClient;
+    let sdkTransport;
+    try {
+        sdkClient = await import("@modelcontextprotocol/sdk/client/index.js");
+        sdkTransport = await import("@modelcontextprotocol/sdk/client/streamableHttp.js");
+    }
+    catch (error) {
+        throw new Error("createHttpTestPair requires @modelcontextprotocol/sdk; install it as a devDependency or use createHttpTestPairWithTinyClient", { cause: error });
+    }
+    installInMemoryHttp();
+    const handle = await server.listenHttp({ port: 0 });
+    const client = new sdkClient.Client({ name: "sdk-test-client", version: "1.0.0" });
+    const transport = new sdkTransport.StreamableHTTPClientTransport(new URL(handle.url), {
+        fetch: nodeFetch
+    });
+    try {
+        await client.connect(transport);
+    }
+    catch (error) {
+        await handle.close();
+        throw error;
+    }
+    return {
+        client,
+        transport,
+        handle,
+        url: handle.url,
+        cleanup: async () => {
+            const results = await Promise.allSettled([client.close(), handle.close()]);
+            const rejected = results.find((result) => result.status === "rejected");
+            if (rejected !== undefined) {
+                throw rejected.reason;
+            }
+        }
+    };
+}
+export async function createHttpTestPairWithTinyClient(server) {
+    let tinyMcpClient;
+    try {
+        tinyMcpClient = await import("tiny-mcp-client");
+    }
+    catch (error) {
+        throw new Error("createHttpTestPairWithTinyClient requires tiny-mcp-client; install tiny-mcp-client as a devDependency", { cause: error });
+    }
+    installInMemoryHttp();
+    const handle = await server.listenHttp({ port: 0 });
+    const requests = [];
+    const client = new tinyMcpClient.McpClient({
+        clientInfo: { name: "tiny-http-test-client", version: "1.0.0" }
+    });
+    const transport = new tinyMcpClient.HttpTransport({
+        url: handle.url,
+        fetch: async (input, init = {}) => {
+            const headers = new Headers(init.headers);
+            const method = init.method ?? "GET";
+            let jsonRpcMethod;
+            if (typeof init.body === "string" && init.body.length > 0) {
+                try {
+                    const parsed = JSON.parse(init.body);
+                    if (typeof parsed.method === "string") {
+                        jsonRpcMethod = parsed.method;
+                    }
+                }
+                catch {
+                    jsonRpcMethod = undefined;
+                }
+            }
+            const response = await nodeFetch(String(input), init);
+            requests.push({
+                method,
+                sessionId: headers.get("mcp-session-id"),
+                jsonRpcMethod,
+                responseContentType: response.headers.get("content-type")
+            });
+            return response;
+        }
+    });
+    await client.connect(transport);
+    return {
+        client,
+        transport,
+        handle,
+        url: handle.url,
+        requests,
+        cleanup: async () => {
+            await client.close();
+            await handle.close();
+        }
+    };
+}

package/node_modules/tiny-http-mcp-server/node_modules/mcp-oauth/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Poe Platform
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.