@skybridge/test 0.0.0 → 2.0.0-alpha.deed804

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alpic
+
+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.

package/README.md

@@ -0,0 +1,96 @@
+# @skybridge/test
+
+Evals for [Skybridge](https://skybridge.tech) MCP apps: they answer whether a
+prompt reaches the right tool with the right arguments, which no unit test can
+check.
+
+Add the `evals` option to the Skybridge Vite plugin so `expect.chat` exists,
+then write scenarios with vitest's own `it` and `expect`. Pass the app itself
+to `start`: it is served in-process, dialing `app.fetchHandler` directly, and
+the tool names and argument shapes come from the app value, so no type
+parameter is needed.
+
+```ts
+import { anthropic } from "@ai-sdk/anthropic";
+import { expect, it } from "vitest";
+import { start } from "@skybridge/test";
+import { app } from "../src/server.js";
+
+it("finds products by category", async () => {
+  const chat = await start({ app, model: anthropic("claude-sonnet-4-5") });
+  await chat.send("I am looking for ski goggles");
+
+  expect.chat(chat).toHaveCalledToolWith("search-products", {
+    category: "goggles",
+  });
+});
+```
+
+There is no child process and no server to boot, so the evals run anywhere
+vitest does. The caveat is that they bypass the Express layer, so nothing
+verifies a bearer token; pass `authInfo` to claim an identity.
+
+## Authenticated evals
+
+```ts
+const chat = await start({
+  app,
+  model: anthropic("claude-sonnet-4-5"),
+  authInfo: {
+    token: "eval-token",
+    clientId: "eval-client",
+    scopes: ["checkout"],
+    extra: { sub: "user_123", email: "ada@example.com" },
+  },
+});
+```
+
+`authInfo` injects a claimed identity: the app's own scheme and scope
+enforcement runs for real, in-band challenges included, and only token
+signature verification is skipped. Omit it to eval the anonymous path, which is
+how you assert that a protected tool challenges instead of running.
+
+## Choosing a model
+
+`start` takes any AI SDK model instance, so the provider and its credentials
+are the project's own. Install the provider package you want alongside `ai`.
+
+```ts
+import { anthropic } from "@ai-sdk/anthropic";
+import { start } from "@skybridge/test";
+
+const chat = await start({ app, model: anthropic("claude-sonnet-4-5") });
+```
+
+A local runtime or a company gateway works the same way, through the AI SDK's
+own `createOpenAICompatible` or `customProvider`.
+
+```ts
+import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
+
+const ollama = createOpenAICompatible({
+  name: "ollama",
+  baseURL: "http://localhost:11434/v1",
+});
+const chat = await start({ app, model: ollama("llama3.1") });
+```
+
+The plugin's `evals` option also carries the defaults every conversation starts
+from, so a project can set them once instead of per scenario.
+
+```ts
+skybridge({ evals: { temperature: 0, maxSteps: 6 } });
+```
+
+## Matchers
+
+Assertions on what the assistant said work the same way, though model prose
+varies between runs, so keep them loose.
+
+```ts
+expect.chat(chat).toHaveSaid("in stock");
+expect.chat(chat).not.toHaveSaid("refund");
+```
+
+See the [documentation](https://docs.skybridge.tech) for setup and the full
+matcher list.

package/dist/chat.d.ts

@@ -0,0 +1,40 @@
+import type { ToolCall } from "@skybridge/vite-plugin/evals";
+import { type LanguageModel } from "ai";
+interface HostConfig {
+    model: LanguageModel;
+    temperature?: number;
+    systemPrompt?: string;
+    maxSteps?: number;
+}
+/**
+ * A `fetch` replacement the transport dials instead of the network. Mirrors the
+ * MCP client's own `fetch` option so an in-process app can serve the session.
+ */
+export type TransportFetch = (url: string | URL, init?: RequestInit) => Promise<Response>;
+/**
+ * One conversation against one MCP session. A scenario asserts on
+ * {@link Chat.toolCalls}, the sequence of calls the model made.
+ */
+export declare class Chat<App = unknown> {
+    /** Type-only anchor so `expect.chat` infers `App` from the conversation. */
+    readonly $app: App;
+    /** Every call the model made, in order, as it crossed the wire. */
+    readonly toolCalls: ToolCall<App>[];
+    /** What the assistant said, one entry per turn, intermediate ones included. */
+    readonly assistantTurns: string[];
+    private readonly messages;
+    private readonly failures;
+    private readonly client;
+    private readonly transport;
+    private readonly host;
+    private tools;
+    private constructor();
+    static open<App>(host: HostConfig, fetchImpl: TransportFetch): Promise<Chat<App>>;
+    /** Takes a turn. Assert on the result with `expect.chat`. */
+    send(prompt: string): Promise<void>;
+    close(): Promise<void>;
+    private failureFor;
+    private toolSet;
+}
+export {};
+//# sourceMappingURL=chat.d.ts.map

package/dist/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAIL,KAAK,aAAa,EAGnB,MAAM,IAAI,CAAC;AAEZ,UAAU,UAAU;IAClB,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB;;;GAGG;AACH,qBAAa,IAAI,CAAC,GAAG,GAAG,OAAO;IAC7B,4EAA4E;IAC5E,SAAiB,IAAI,EAAE,GAAG,CAAC;IAE3B,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAM;IAEzC,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAM;IAEvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,KAAK,CAAc;IAE3B,OAAO;WAUM,IAAI,CAAC,GAAG,EACnB,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAkBrB,6DAA6D;IACvD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,OAAO;CAqChB"}

package/dist/chat.js

@@ -0,0 +1,113 @@
+import { Client, StreamableHTTPClientTransport, } from "@modelcontextprotocol/client";
+import { dynamicTool, generateText, jsonSchema, stepCountIs, } from "ai";
+const DEFAULT_MAX_STEPS = 8;
+const IN_PROCESS_URL = "http://in-process.skybridge.test/mcp";
+/**
+ * One conversation against one MCP session. A scenario asserts on
+ * {@link Chat.toolCalls}, the sequence of calls the model made.
+ */
+export class Chat {
+    /** Every call the model made, in order, as it crossed the wire. */
+    toolCalls = [];
+    /** What the assistant said, one entry per turn, intermediate ones included. */
+    assistantTurns = [];
+    messages = [];
+    failures = new Map();
+    client;
+    transport;
+    host;
+    tools = [];
+    constructor(client, transport, host) {
+        this.client = client;
+        this.transport = transport;
+        this.host = host;
+    }
+    static async open(host, fetchImpl) {
+        const client = new Client({ name: "skybridge-eval", version: "0" });
+        const transport = new StreamableHTTPClientTransport(new URL(IN_PROCESS_URL), { fetch: fetchImpl });
+        await client.connect(transport);
+        const chat = new Chat(client, transport, host);
+        try {
+            const { tools } = await client.listTools();
+            chat.tools = tools;
+        }
+        catch (error) {
+            await transport.close();
+            throw error;
+        }
+        return chat;
+    }
+    /** Takes a turn. Assert on the result with `expect.chat`. */
+    async send(prompt) {
+        this.messages.push({ role: "user", content: prompt });
+        const result = await generateText({
+            model: this.host.model,
+            temperature: this.host.temperature ?? 0,
+            ...(this.host.systemPrompt === undefined
+                ? {}
+                : { system: this.host.systemPrompt }),
+            messages: this.messages,
+            tools: this.toolSet(),
+            stopWhen: stepCountIs(this.host.maxSteps ?? DEFAULT_MAX_STEPS),
+        });
+        for (const step of result.steps) {
+            for (const call of step.toolCalls) {
+                this.toolCalls.push({
+                    name: call.toolName,
+                    arguments: (call.input ?? {}),
+                    ...this.failureFor(call),
+                });
+            }
+        }
+        for (const step of result.steps) {
+            if (step.text !== "") {
+                this.assistantTurns.push(step.text);
+            }
+        }
+        this.messages.push(...result.response.messages);
+    }
+    async close() {
+        await this.transport.close();
+    }
+    failureFor(call) {
+        const reported = this.failures.get(call.toolCallId);
+        if (reported !== undefined) {
+            return { failed: reported };
+        }
+        if (call.invalid === true) {
+            return { failed: "the model's arguments could not be parsed" };
+        }
+        return {};
+    }
+    toolSet() {
+        const entries = this.tools.map((definition) => {
+            const { $schema: _ignored, ...parameters } = definition.inputSchema;
+            return [
+                definition.name,
+                dynamicTool({
+                    description: definition.description ?? "",
+                    inputSchema: jsonSchema(parameters),
+                    execute: async (input, { toolCallId }) => {
+                        let result;
+                        try {
+                            result = await this.client.callTool({
+                                name: definition.name,
+                                arguments: (input ?? {}),
+                            });
+                        }
+                        catch (error) {
+                            this.failures.set(toolCallId, `the call never reached the server: ${error instanceof Error ? error.message : String(error)}`);
+                            throw error;
+                        }
+                        if (result.isError === true) {
+                            this.failures.set(toolCallId, `the tool returned an error: ${JSON.stringify(result.content)}`);
+                        }
+                        return result.content ?? result;
+                    },
+                }),
+            ];
+        });
+        return Object.fromEntries(entries);
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { ChatAssertion, ChatMatchers, } from "@skybridge/vite-plugin/evals";
+export type { Chat } from "./chat.js";
+export type { EvalApp, EvalIdentity } from "./session-registry.js";
+export { start } from "./session-registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,YAAY,GACb,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { start } from "./session-registry.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/session-registry.d.ts

@@ -0,0 +1,59 @@
+import type { LanguageModel } from "ai";
+import { Chat } from "./chat.js";
+/**
+ * The minimum a Skybridge app has to expose to be served in-process: the
+ * `$types` marker the assertions infer tool names from, and the fetch handler
+ * the session is dialed through. Structural on purpose, so this package needs
+ * no runtime dependency on `skybridge`.
+ */
+export interface EvalApp {
+    readonly $types: {
+        readonly tools: object;
+    };
+    readonly fetchHandler: {
+        fetch: (request: Request, options?: {
+            authInfo?: EvalIdentity;
+        }) => Promise<Response>;
+    };
+}
+/**
+ * The identity an in-process session claims, handed to the app as the
+ * request's `authInfo`. Mirrors the SDK's `AuthInfo` structurally; `extra`
+ * carries whatever claims the app's verifier would have produced.
+ */
+export interface EvalIdentity {
+    token: string;
+    clientId: string;
+    scopes: string[];
+    expiresAt?: number;
+    resource?: URL;
+    extra?: Record<string, unknown>;
+}
+interface StartOptions {
+    /** Any AI SDK model instance, built by the project. */
+    model: LanguageModel;
+    systemPrompt?: string;
+    temperature?: number;
+    maxSteps?: number;
+}
+/**
+ * Opens a fresh MCP session and conversation against the app under test. The
+ * app is served in-process, and the session is closed when the current test
+ * finishes, so scenarios never leak sessions and never write teardown, and
+ * tests that run concurrently cannot close each other's sessions.
+ *
+ * The assertions are inferred from the app value itself, so `expect.chat` gets
+ * the project's tool names and argument shapes with no type parameter. The
+ * session talks straight to `app.fetchHandler`, which never closes: the
+ * handler is memoized on the app and shared by every test.
+ *
+ * `authInfo` claims an identity for the session: the app's per-tool scheme and
+ * scope enforcement runs against it for real, only token verification is
+ * skipped. Omit it to exercise the anonymous path, challenges included.
+ */
+export declare function start<App extends EvalApp>(options: StartOptions & {
+    app: App;
+    authInfo?: EvalIdentity;
+}): Promise<Chat<App>>;
+export {};
+//# sourceMappingURL=session-registry.d.ts.map

package/dist/session-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-registry.d.ts","sourceRoot":"","sources":["../src/session-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE;QACrB,KAAK,EAAE,CACL,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,YAAY,CAAA;SAAE,KAClC,OAAO,CAAC,QAAQ,CAAC,CAAC;KACxB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,UAAU,YAAY;IACpB,uDAAuD;IACvD,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,KAAK,CAAC,GAAG,SAAS,OAAO,EAC7C,OAAO,EAAE,YAAY,GAAG;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;CAAE,GAC5D,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAoBpB"}

package/dist/session-registry.js

@@ -0,0 +1,38 @@
+import { inject, onTestFinished } from "vitest";
+import { Chat } from "./chat.js";
+function sharedDefaults() {
+    try {
+        return inject("skybridgeEvals");
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Opens a fresh MCP session and conversation against the app under test. The
+ * app is served in-process, and the session is closed when the current test
+ * finishes, so scenarios never leak sessions and never write teardown, and
+ * tests that run concurrently cannot close each other's sessions.
+ *
+ * The assertions are inferred from the app value itself, so `expect.chat` gets
+ * the project's tool names and argument shapes with no type parameter. The
+ * session talks straight to `app.fetchHandler`, which never closes: the
+ * handler is memoized on the app and shared by every test.
+ *
+ * `authInfo` claims an identity for the session: the app's per-tool scheme and
+ * scope enforcement runs against it for real, only token verification is
+ * skipped. Omit it to exercise the anonymous path, challenges included.
+ */
+export async function start(options) {
+    const config = sharedDefaults();
+    const { app, authInfo } = options;
+    const chat = await Chat.open({
+        model: options.model,
+        temperature: options.temperature ?? config?.temperature,
+        systemPrompt: options.systemPrompt ?? config?.systemPrompt,
+        maxSteps: options.maxSteps ?? config?.maxSteps,
+    }, (url, init) => app.fetchHandler.fetch(new Request(url, init), authInfo === undefined ? undefined : { authInfo }));
+    onTestFinished(() => chat.close());
+    return chat;
+}
+//# sourceMappingURL=session-registry.js.map

package/dist/session-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-registry.js","sourceRoot":"","sources":["../src/session-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAwCjC,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,OAA6D;IAE7D,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAElC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAC1B;QACE,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,MAAM,EAAE,WAAW;QACvD,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,MAAM,EAAE,YAAY;QAC1D,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM,EAAE,QAAQ;KAC/C,EACD,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CACZ,GAAG,CAAC,YAAY,CAAC,KAAK,CACpB,IAAI,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EACtB,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAClD,CACJ,CAAC;IAEF,cAAc,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,7 +1,48 @@
 {
   "name": "@skybridge/test",
-  "version": "0.0.0",
-  "publishConfig": {
-    "access": "public"
+  "version": "2.0.0-alpha.deed804",
+  "description": "Eval runner for Skybridge MCP apps: does a prompt reach the right tool with the right arguments",
+  "license": "ISC",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alpic-ai/skybridge.git"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/client": "^2.0.0",
+    "@skybridge/vite-plugin": "2.0.0-alpha.deed804"
+  },
+  "peerDependencies": {
+    "ai": "^5.0.0",
+    "skybridge": "^2.0.0",
+    "vitest": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.3",
+    "ai": "^5.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10",
+    "zod": "^4.4.3",
+    "skybridge": "2.0.0-alpha.deed804"
+  },
+  "engines": {
+    "node": ">=22.23.1"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "format": "biome check --write --error-on-warnings",
+    "test": "pnpm run test:format && pnpm run test:types && pnpm run test:unit",
+    "test:format": "biome ci",
+    "test:types": "tsc --noEmit -p tsconfig.test.json",
+    "test:unit": "vitest run"
   }
-}
+}