@mcpmesh/sdk 1.3.4 → 2.0.0-beta.1

package/dist/__tests__/a2a/agent-a2a-config.spec.js

@@ -0,0 +1,262 @@
+/**
+ * Tests for `addTool({ a2aConfig: ... })` integration in agent.ts
+ * (issue #917).
+ *
+ * Targets the registration-time validation, A2AClient cache, and
+ * heartbeat-build auto-tag injection. Doesn't bind to a real registry
+ * — `_autoStart` is stubbed out, and we reach into the agent's
+ * private fields to assert the cache state.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { z } from "zod";
+import { MeshAgent } from "../../agent.js";
+import { A2AClient } from "../../a2a/a2a-client.js";
+import { A2ABearer } from "../../a2a/a2a-bearer.js";
+function makeFastMCPStub() {
+    return {
+        addTool: vi.fn(),
+        start: vi.fn(),
+        getApp: vi.fn(),
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    };
+}
+let autoStartSpy = null;
+beforeEach(() => {
+    autoStartSpy = vi
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        .spyOn(MeshAgent.prototype, "_autoStart")
+        .mockImplementation(async () => {
+        /* no-op */
+    });
+});
+afterEach(() => {
+    if (autoStartSpy) {
+        autoStartSpy.mockRestore();
+        autoStartSpy = null;
+    }
+});
+function newAgent(name = "date-consumer") {
+    return new MeshAgent(makeFastMCPStub(), { name, httpPort: 0 });
+}
+describe("addTool({ a2aConfig }) — registration-time validation", () => {
+    it("rejects empty url", () => {
+        const agent = newAgent();
+        expect(() => agent.addTool({
+            name: "bad",
+            capability: "x",
+            parameters: z.object({}),
+            a2aConfig: { url: "" },
+            execute: async () => "ok",
+        })).toThrow(/url must be a non-empty string/);
+    });
+    it("rejects non-positive timeoutMs", () => {
+        const agent = newAgent();
+        expect(() => agent.addTool({
+            name: "bad",
+            capability: "x",
+            parameters: z.object({}),
+            a2aConfig: { url: "http://x", timeoutMs: 0 },
+            execute: async () => "ok",
+        })).toThrow(/timeoutMs.*must be a finite positive number/);
+    });
+    it("rejects Infinity timeoutMs", () => {
+        const agent = newAgent();
+        expect(() => agent.addTool({
+            name: "bad",
+            capability: "x",
+            parameters: z.object({}),
+            a2aConfig: { url: "http://x", timeoutMs: Number.POSITIVE_INFINITY },
+            execute: async () => "ok",
+        })).toThrow(/timeoutMs.*must be a finite positive number/);
+    });
+    it("rejects NaN timeoutMs", () => {
+        const agent = newAgent();
+        expect(() => agent.addTool({
+            name: "bad",
+            capability: "x",
+            parameters: z.object({}),
+            a2aConfig: { url: "http://x", timeoutMs: Number.NaN },
+            execute: async () => "ok",
+        })).toThrow(/timeoutMs.*must be a finite positive number/);
+    });
+    it("rejects negative timeoutMs", () => {
+        const agent = newAgent();
+        expect(() => agent.addTool({
+            name: "bad",
+            capability: "x",
+            parameters: z.object({}),
+            a2aConfig: { url: "http://x", timeoutMs: -100 },
+            execute: async () => "ok",
+        })).toThrow(/timeoutMs.*must be a finite positive number/);
+    });
+    it("rejects non-positive pollIntervalMs", () => {
+        const agent = newAgent();
+        expect(() => agent.addTool({
+            name: "bad",
+            capability: "x",
+            parameters: z.object({}),
+            a2aConfig: { url: "http://x", pollIntervalMs: 0 },
+            execute: async () => "ok",
+        })).toThrow(/pollIntervalMs.*must be a finite positive number/);
+    });
+    it("rejects pollIntervalMaxMs < pollIntervalMs", () => {
+        const agent = newAgent();
+        expect(() => agent.addTool({
+            name: "bad",
+            capability: "x",
+            parameters: z.object({}),
+            a2aConfig: {
+                url: "http://x",
+                pollIntervalMs: 500,
+                pollIntervalMaxMs: 100,
+            },
+            execute: async () => "ok",
+        })).toThrow(/pollIntervalMaxMs.*must be >= pollIntervalMs/);
+    });
+    it("accepts a valid a2aConfig and registers the tool", () => {
+        const agent = newAgent();
+        expect(() => agent.addTool({
+            name: "current-date",
+            capability: "current-date",
+            tags: ["a2a-bridge"],
+            parameters: z.object({}),
+            a2aConfig: {
+                url: "http://localhost:9090/agents/date",
+                skillId: "get-date",
+            },
+            execute: async (_args, _a2a) => "ok",
+        })).not.toThrow();
+    });
+});
+describe("A2AClient cache", () => {
+    it("returns the same A2AClient for two tools sharing the same config tuple", () => {
+        const agent = newAgent();
+        agent.addTool({
+            name: "tool-a",
+            capability: "current-date",
+            parameters: z.object({}),
+            a2aConfig: { url: "http://localhost:9090/agents/date", skillId: "get-date" },
+            execute: async () => "ok",
+        });
+        agent.addTool({
+            name: "tool-b",
+            capability: "alt-date",
+            parameters: z.object({}),
+            a2aConfig: { url: "http://localhost:9090/agents/date", skillId: "get-date" },
+            execute: async () => "ok",
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const cache = agent._a2aClients;
+        expect(cache.size).toBe(1);
+        const onlyEntry = [...cache.values()][0];
+        expect(onlyEntry).toBeInstanceOf(A2AClient);
+    });
+    it("returns separate clients for different urls", () => {
+        const agent = newAgent();
+        agent.addTool({
+            name: "tool-a",
+            capability: "x",
+            parameters: z.object({}),
+            a2aConfig: { url: "http://a/agents/x", skillId: "x" },
+            execute: async () => "ok",
+        });
+        agent.addTool({
+            name: "tool-b",
+            capability: "x",
+            parameters: z.object({}),
+            a2aConfig: { url: "http://b/agents/x", skillId: "x" },
+            execute: async () => "ok",
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const cache = agent._a2aClients;
+        expect(cache.size).toBe(2);
+    });
+    it("cache_distinguishesA2AClientsByDistinctBearerInstances", () => {
+        // Regression for the BLOCKER: two A2ABearer instances holding
+        // distinct literal tokens MUST NOT collide in the A2AClient cache.
+        // Pre-fix the cache key used `Object.prototype.hasOwnProperty.call`
+        // against `tokenEnv` — which always returned true because A2ABearer
+        // assigns both fields unconditionally — so both bearers hashed to
+        // `env:` and tool-B's outbound HTTP would carry tool-A's secret.
+        const agent = newAgent();
+        const bearerA = new A2ABearer({ token: "secret-A" });
+        const bearerB = new A2ABearer({ token: "secret-B" });
+        agent.addTool({
+            name: "tool-a",
+            capability: "x",
+            parameters: z.object({}),
+            a2aConfig: { url: "http://x/agents/x", skillId: "x", auth: bearerA },
+            execute: async () => "ok",
+        });
+        agent.addTool({
+            name: "tool-b",
+            capability: "x",
+            parameters: z.object({}),
+            a2aConfig: { url: "http://x/agents/x", skillId: "x", auth: bearerB },
+            execute: async () => "ok",
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const cache = agent._a2aClients;
+        expect(cache.size).toBe(2);
+    });
+    it("reuses one A2AClient when the SAME A2ABearer instance is shared", () => {
+        // Counterpart to the above — sharing one bearer reference across
+        // multiple tools SHOULD hit the cache (the desired connection-pool
+        // sharing behaviour). Identity-based keying preserves this.
+        const agent = newAgent();
+        const sharedBearer = new A2ABearer({ tokenEnv: "MY_TOKEN" });
+        agent.addTool({
+            name: "tool-a",
+            capability: "x",
+            parameters: z.object({}),
+            a2aConfig: { url: "http://x/agents/x", skillId: "x", auth: sharedBearer },
+            execute: async () => "ok",
+        });
+        agent.addTool({
+            name: "tool-b",
+            capability: "x",
+            parameters: z.object({}),
+            a2aConfig: { url: "http://x/agents/x", skillId: "x", auth: sharedBearer },
+            execute: async () => "ok",
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const cache = agent._a2aClients;
+        expect(cache.size).toBe(1);
+    });
+});
+describe("auto-tag injection at heartbeat-build time", () => {
+    it("appends the agent name to the tool's tags when a2aConfig is set", async () => {
+        const agent = newAgent("my-consumer");
+        agent.addTool({
+            name: "current-date",
+            capability: "current-date",
+            tags: ["a2a-bridge"],
+            parameters: z.object({}),
+            a2aConfig: { url: "http://x/agents/y", skillId: "y" },
+            execute: async () => "ok",
+        });
+        // Reach into private state to inspect what heartbeat-build will ship.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const tools = agent.tools;
+        const meta = tools.get("current-date");
+        expect(meta?.a2aConsumer).toBe(true);
+        expect(meta?.a2aAgentName).toBe("my-consumer");
+        // The original tags array stored in meta is unchanged (defensive copy
+        // happens inside the heartbeat path); the on-the-wire tags receive
+        // the auto-tag.
+        expect(meta?.tags).toEqual(["a2a-bridge"]);
+    });
+    it("does NOT mark a2aConsumer when a2aConfig is absent", () => {
+        const agent = newAgent();
+        agent.addTool({
+            name: "plain",
+            capability: "plain",
+            parameters: z.object({}),
+            execute: async () => "ok",
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const tools = agent.tools;
+        expect(tools.get("plain")?.a2aConsumer).toBeFalsy();
+    });
+});
+//# sourceMappingURL=agent-a2a-config.spec.js.map

package/dist/__tests__/a2a/agent-a2a-config.spec.js.map

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

package/dist/__tests__/a2a/producer/auth-filter.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auth-filter.spec.d.ts.map

package/dist/__tests__/a2a/producer/auth-filter.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-filter.spec.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/a2a/producer/auth-filter.spec.ts"],"names":[],"mappings":""}

package/dist/__tests__/a2a/producer/auth-filter.spec.js

@@ -0,0 +1,127 @@
+/**
+ * Unit tests for `auth-filter.ts` (spec §6.2 + §6.3).
+ *
+ * Coverage:
+ * - `Bearer <token>` header → `next()`
+ * - Empty / whitespace-only token after `Bearer ` → 401 + `-32001`
+ * - Missing `Authorization` header → 401 + `-32001`
+ * - Wrong scheme (`Basic ...`) → 401 + `-32001`
+ * - Phase 1 invariant: presence-only — token VALUE is NOT validated
+ *   (Appendix B item 4).
+ *
+ * Mirrors Java's `MeshA2AAuthFilterTest`.
+ *
+ * Note: the "mount with no auth + card endpoint always public" assertions
+ * are covered in `mount.spec.ts` (it's a wiring concern, not the
+ * filter's own behaviour).
+ */
+import { describe, it, expect, vi } from "vitest";
+import { buildBearerAuthMiddleware, JSONRPC_AUTH_ERROR, } from "../../../a2a/producer/auth-filter.js";
+function makeReq(headers) {
+    return { headers };
+}
+function makeRes(captured) {
+    return {
+        status(code) {
+            captured.status = code;
+            return this;
+        },
+        type(t) {
+            captured.contentType = t;
+            return this;
+        },
+        send(body) {
+            captured.body = body;
+            return this;
+        },
+    };
+}
+describe("buildBearerAuthMiddleware (spec §6.2)", () => {
+    /** Spec §6.2: valid `Bearer <token>` passes through to next(). */
+    it("calls next() on valid Bearer token", () => {
+        const mw = buildBearerAuthMiddleware();
+        const captured = {};
+        const req = makeReq({ authorization: "Bearer abc123" });
+        const res = makeRes(captured);
+        const next = vi.fn();
+        mw(req, res, next);
+        expect(next).toHaveBeenCalledTimes(1);
+        expect(captured.status).toBeUndefined();
+        expect(captured.body).toBeUndefined();
+    });
+    /** Spec §6.2 — Appendix B item 4: presence only; never validate value. */
+    it("does not validate the token value (Phase 1 presence-only)", () => {
+        const mw = buildBearerAuthMiddleware();
+        const captured = {};
+        const req = makeReq({ authorization: "Bearer not-a-real-jwt-just-presence" });
+        const res = makeRes(captured);
+        const next = vi.fn();
+        mw(req, res, next);
+        expect(next).toHaveBeenCalledTimes(1);
+    });
+    /** Spec §6.3: empty bearer token → 401 + -32001 JSON-RPC envelope. */
+    it("returns 401 + -32001 on empty Bearer token", () => {
+        const mw = buildBearerAuthMiddleware();
+        const captured = {};
+        const req = makeReq({ authorization: "Bearer " });
+        const res = makeRes(captured);
+        const next = vi.fn();
+        mw(req, res, next);
+        expect(next).not.toHaveBeenCalled();
+        expect(captured.status).toBe(401);
+        expect(captured.contentType).toBe("application/json");
+        const body = JSON.parse(captured.body ?? "{}");
+        expect(body.jsonrpc).toBe("2.0");
+        expect(body.error.code).toBe(JSONRPC_AUTH_ERROR);
+        expect(body.error.code).toBe(-32001);
+        expect(body.id).toBeNull();
+    });
+    /** Whitespace-only token after `Bearer ` → 401. */
+    it("returns 401 on whitespace-only token", () => {
+        const mw = buildBearerAuthMiddleware();
+        const captured = {};
+        const req = makeReq({ authorization: "Bearer    " });
+        const res = makeRes(captured);
+        const next = vi.fn();
+        mw(req, res, next);
+        expect(next).not.toHaveBeenCalled();
+        expect(captured.status).toBe(401);
+    });
+    /** Spec §6.3: missing Authorization header → 401. */
+    it("returns 401 + -32001 when Authorization header missing", () => {
+        const mw = buildBearerAuthMiddleware();
+        const captured = {};
+        const req = makeReq({});
+        const res = makeRes(captured);
+        const next = vi.fn();
+        mw(req, res, next);
+        expect(next).not.toHaveBeenCalled();
+        expect(captured.status).toBe(401);
+        const body = JSON.parse(captured.body ?? "{}");
+        expect(body.error.code).toBe(-32001);
+    });
+    /** Spec §6.3: wrong scheme (Basic) → 401. */
+    it("returns 401 on non-Bearer scheme (Basic)", () => {
+        const mw = buildBearerAuthMiddleware();
+        const captured = {};
+        const req = makeReq({ authorization: "Basic dXNlcjpwYXNz" });
+        const res = makeRes(captured);
+        const next = vi.fn();
+        mw(req, res, next);
+        expect(next).not.toHaveBeenCalled();
+        expect(captured.status).toBe(401);
+        const body = JSON.parse(captured.body ?? "{}");
+        expect(body.error.code).toBe(-32001);
+    });
+    /** Case-insensitive scheme match: "bearer xyz" (lowercase) is accepted. */
+    it("accepts case-insensitive 'bearer ' scheme prefix", () => {
+        const mw = buildBearerAuthMiddleware();
+        const captured = {};
+        const req = makeReq({ authorization: "bearer abc" });
+        const res = makeRes(captured);
+        const next = vi.fn();
+        mw(req, res, next);
+        expect(next).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=auth-filter.spec.js.map

package/dist/__tests__/a2a/producer/auth-filter.spec.js.map

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

package/dist/__tests__/a2a/producer/card-builder.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=card-builder.spec.d.ts.map

package/dist/__tests__/a2a/producer/card-builder.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-builder.spec.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/a2a/producer/card-builder.spec.ts"],"names":[],"mappings":""}

package/dist/__tests__/a2a/producer/card-builder.spec.js

@@ -0,0 +1,113 @@
+/**
+ * Unit tests for `card-builder.ts` (spec §3 + Appendix B item 1).
+ *
+ * Coverage:
+ * - Single skill per card (Appendix B item 1).
+ * - `capabilities.streaming === true` (spec §3.2).
+ * - Auth schemes: `["bearer"]` vs `[]` (spec §6.1).
+ * - Skill metadata populated from surface (id/name/description/tags).
+ * - Empty `url` omitted (Appendix A nuance — never emit blank URLs).
+ * - Public URL passthrough.
+ * - Defaults applied for missing optional fields.
+ *
+ * Mirrors Java's `MeshA2ACardBuilderTest`.
+ */
+import { describe, it, expect } from "vitest";
+import { buildAgentCard, DEFAULT_INPUT_MODES, DEFAULT_OUTPUT_MODES, } from "../../../a2a/producer/card-builder.js";
+function makeSurface(overrides = {}) {
+    return {
+        path: "/agents/date",
+        skillId: "get-date",
+        skillName: "Get Date",
+        description: "Get the current UTC date",
+        tags: ["system", "date"],
+        dependencies: [],
+        auth: "",
+        routeId: "route_0_A2A:/agents/date",
+        ...overrides,
+    };
+}
+describe("buildAgentCard (spec §3)", () => {
+    /** Spec §3.2 + Appendix B item 1: one skill per card. */
+    it("emits exactly one skill per card (Appendix B item 1)", () => {
+        const card = buildAgentCard(makeSurface(), {
+            agentName: "date-agent",
+            publicUrl: "https://example.com/agents/date",
+        });
+        expect(Array.isArray(card.skills)).toBe(true);
+        expect(card.skills.length).toBe(1);
+    });
+    /** Spec §3.2: capabilities.streaming MUST be true (real boolean). */
+    it("capabilities.streaming === true (spec §3.2)", () => {
+        const card = buildAgentCard(makeSurface(), { agentName: "x" });
+        const caps = card.capabilities;
+        expect(caps.streaming).toBe(true);
+        // Defensive: not the string "true" or anything truthy-but-non-boolean.
+        expect(typeof caps.streaming).toBe("boolean");
+    });
+    /** Spec §6.1: authentication.schemes === ["bearer"] when auth=bearer. */
+    it("authentication.schemes === ['bearer'] when surface.auth==='bearer'", () => {
+        const card = buildAgentCard(makeSurface({ auth: "bearer" }), {
+            agentName: "x",
+        });
+        const auth = card.authentication;
+        expect(auth.schemes).toEqual(["bearer"]);
+    });
+    /** Spec §6.1: authentication.schemes === [] (NOT "none") when no auth. */
+    it("authentication.schemes === [] when surface.auth is empty", () => {
+        const card = buildAgentCard(makeSurface({ auth: "" }), {
+            agentName: "x",
+        });
+        const auth = card.authentication;
+        expect(auth.schemes).toEqual([]);
+    });
+    /** Spec §3.2: skill metadata populated from surface. */
+    it("populates skill id / name / description / tags from surface", () => {
+        const card = buildAgentCard(makeSurface({
+            skillId: "weather",
+            skillName: "Weather Forecast",
+            description: "Get forecast for a city",
+            tags: ["weather", "forecast", "external"],
+        }), { agentName: "weather-agent" });
+        const skill = card.skills[0];
+        expect(skill.id).toBe("weather");
+        expect(skill.name).toBe("Weather Forecast");
+        expect(skill.description).toBe("Get forecast for a city");
+        expect(skill.tags).toEqual(["weather", "forecast", "external"]);
+        expect(skill.inputModes).toEqual([...DEFAULT_INPUT_MODES]);
+        expect(skill.outputModes).toEqual([...DEFAULT_OUTPUT_MODES]);
+    });
+    /** Spec conformance §3.2 + Appendix A: blank url MUST be omitted, not "". */
+    it("omits url field when publicUrl is undefined / empty", () => {
+        const cardNoUrl = buildAgentCard(makeSurface(), { agentName: "x" });
+        expect(Object.prototype.hasOwnProperty.call(cardNoUrl, "url")).toBe(false);
+        const cardEmpty = buildAgentCard(makeSurface(), {
+            agentName: "x",
+            publicUrl: "",
+        });
+        expect(Object.prototype.hasOwnProperty.call(cardEmpty, "url")).toBe(false);
+    });
+    /** Spec §3.2: publicUrl passes through to card.url. */
+    it("emits the supplied publicUrl as card.url", () => {
+        const card = buildAgentCard(makeSurface(), {
+            agentName: "x",
+            publicUrl: "https://prod.example.com/agents/date",
+        });
+        expect(card.url).toBe("https://prod.example.com/agents/date");
+    });
+    /** Defaults: agentName "" → "agent", agentVersion undefined → "1.0.0". */
+    it("applies defaults for missing optional context fields", () => {
+        const card = buildAgentCard(makeSurface(), { agentName: "" });
+        expect(card.name).toBe("agent");
+        expect(card.version).toBe("1.0.0");
+        // description defaults to name when not supplied
+        expect(card.description).toBe("agent");
+    });
+    /** Skill description falls back to skillName when description is empty. */
+    it("falls back skill.description to skillName when empty", () => {
+        const card = buildAgentCard(makeSurface({ description: "", skillName: "My Skill" }), { agentName: "x" });
+        const skill = card.skills[0];
+        expect(skill.description).toBe("My Skill");
+    });
+});
+//# sourceMappingURL=card-builder.spec.js.map

package/dist/__tests__/a2a/producer/card-builder.spec.js.map

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

package/dist/__tests__/a2a/producer/dispatcher.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dispatcher.spec.d.ts.map

package/dist/__tests__/a2a/producer/dispatcher.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.spec.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/a2a/producer/dispatcher.spec.ts"],"names":[],"mappings":""}