@mcpmesh/sdk 0.8.0-beta.1

package/dist/__tests__/template.test.js

@@ -0,0 +1,176 @@
+/**
+ * Unit tests for template.ts
+ *
+ * Tests Handlebars template rendering and utilities.
+ */
+import { describe, it, expect, beforeEach } from "vitest";
+import { isFileTemplate, extractFilePath, renderTemplate, clearTemplateCache, registerHelper, registerPartial, } from "../template.js";
+describe("isFileTemplate", () => {
+    it("should return true for file:// templates", () => {
+        expect(isFileTemplate("file://path/to/template.hbs")).toBe(true);
+        expect(isFileTemplate("file://template.txt")).toBe(true);
+        expect(isFileTemplate("file://./relative/path.hbs")).toBe(true);
+    });
+    it("should return false for inline templates", () => {
+        expect(isFileTemplate("Hello {{name}}!")).toBe(false);
+        expect(isFileTemplate("Just plain text")).toBe(false);
+        expect(isFileTemplate("")).toBe(false);
+    });
+    it("should return false for file-like but not file:// templates", () => {
+        expect(isFileTemplate("filepath://test")).toBe(false);
+        expect(isFileTemplate("File://test")).toBe(false); // case sensitive
+        expect(isFileTemplate(" file://test")).toBe(false); // leading space
+    });
+});
+describe("extractFilePath", () => {
+    it("should extract path from file:// template", () => {
+        expect(extractFilePath("file://path/to/template.hbs")).toBe("path/to/template.hbs");
+        expect(extractFilePath("file://template.txt")).toBe("template.txt");
+        expect(extractFilePath("file:///absolute/path.hbs")).toBe("/absolute/path.hbs");
+    });
+    it("should throw for non-file templates", () => {
+        expect(() => extractFilePath("Hello {{name}}")).toThrow("Not a file template");
+        expect(() => extractFilePath("")).toThrow("Not a file template");
+    });
+});
+describe("renderTemplate", () => {
+    beforeEach(() => {
+        clearTemplateCache();
+    });
+    describe("inline templates", () => {
+        it("should render simple variable substitution", async () => {
+            const result = await renderTemplate("Hello {{name}}!", { name: "World" });
+            expect(result).toBe("Hello World!");
+        });
+        it("should render multiple variables", async () => {
+            const result = await renderTemplate("{{greeting}}, {{name}}! You have {{count}} messages.", { greeting: "Hi", name: "User", count: 5 });
+            expect(result).toBe("Hi, User! You have 5 messages.");
+        });
+        it("should handle missing variables as empty", async () => {
+            const result = await renderTemplate("Hello {{name}}!", {});
+            expect(result).toBe("Hello !");
+        });
+        it("should render nested object properties", async () => {
+            const result = await renderTemplate("Name: {{user.name}}, Age: {{user.age}}", {
+                user: { name: "John", age: 30 },
+            });
+            expect(result).toBe("Name: John, Age: 30");
+        });
+        it("should render arrays with #each", async () => {
+            const result = await renderTemplate("Items: {{#each items}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}", { items: ["a", "b", "c"] });
+            expect(result).toBe("Items: a, b, c");
+        });
+        it("should handle conditionals", async () => {
+            const template = "{{#if active}}Active{{else}}Inactive{{/if}}";
+            const activeResult = await renderTemplate(template, { active: true });
+            expect(activeResult).toBe("Active");
+            const inactiveResult = await renderTemplate(template, { active: false });
+            expect(inactiveResult).toBe("Inactive");
+        });
+        it("should render empty string for empty template", async () => {
+            const result = await renderTemplate("", {});
+            expect(result).toBe("");
+        });
+        it("should preserve literal text", async () => {
+            const result = await renderTemplate("No variables here.", {});
+            expect(result).toBe("No variables here.");
+        });
+    });
+    describe("built-in helpers", () => {
+        it("should use json helper", async () => {
+            // Use triple braces to avoid HTML escaping
+            const result = await renderTemplate("Data: {{{json data}}}", {
+                data: { key: "value" },
+            });
+            expect(result).toContain('"key": "value"');
+        });
+        it("should use join helper", async () => {
+            const result = await renderTemplate("Items: {{join items ', '}}", {
+                items: ["a", "b", "c"],
+            });
+            expect(result).toBe("Items: a, b, c");
+        });
+        it("should handle join with non-array", async () => {
+            const result = await renderTemplate("Items: {{join notArray ', '}}", {
+                notArray: "string",
+            });
+            expect(result).toBe("Items: ");
+        });
+        it("should use eq helper", async () => {
+            const template = "{{#if (eq status 'active')}}Yes{{else}}No{{/if}}";
+            const activeResult = await renderTemplate(template, { status: "active" });
+            expect(activeResult).toBe("Yes");
+            const otherResult = await renderTemplate(template, { status: "inactive" });
+            expect(otherResult).toBe("No");
+        });
+        it("should use ne helper", async () => {
+            const template = "{{#if (ne value 0)}}Non-zero{{else}}Zero{{/if}}";
+            const nonZero = await renderTemplate(template, { value: 5 });
+            expect(nonZero).toBe("Non-zero");
+            const zero = await renderTemplate(template, { value: 0 });
+            expect(zero).toBe("Zero");
+        });
+        it("should use default helper", async () => {
+            const template = "Name: {{default name 'Anonymous'}}";
+            const withName = await renderTemplate(template, { name: "John" });
+            expect(withName).toBe("Name: John");
+            const withoutName = await renderTemplate(template, {});
+            expect(withoutName).toBe("Name: Anonymous");
+        });
+    });
+    describe("template caching", () => {
+        it("should cache compiled templates", async () => {
+            const template = "Hello {{name}}!";
+            // First render - compiles template
+            const result1 = await renderTemplate(template, { name: "First" });
+            expect(result1).toBe("Hello First!");
+            // Second render - uses cache
+            const result2 = await renderTemplate(template, { name: "Second" });
+            expect(result2).toBe("Hello Second!");
+        });
+        it("should clear cache", async () => {
+            const template = "Hello {{name}}!";
+            await renderTemplate(template, { name: "Test" });
+            clearTemplateCache();
+            // Should work after cache clear
+            const result = await renderTemplate(template, { name: "After Clear" });
+            expect(result).toBe("Hello After Clear!");
+        });
+    });
+});
+describe("registerHelper", () => {
+    beforeEach(() => {
+        clearTemplateCache();
+    });
+    it("should register and use custom helper", async () => {
+        registerHelper("uppercase", (str) => str.toUpperCase());
+        const result = await renderTemplate("Name: {{uppercase name}}", { name: "john" });
+        expect(result).toBe("Name: JOHN");
+    });
+    it("should register helper with multiple arguments", async () => {
+        registerHelper("repeat", (str, times) => {
+            return str.repeat(typeof times === "number" ? times : 1);
+        });
+        const result = await renderTemplate("{{repeat text 3}}", { text: "Hi" });
+        expect(result).toBe("HiHiHi");
+    });
+});
+describe("registerPartial", () => {
+    beforeEach(() => {
+        clearTemplateCache();
+    });
+    it("should register and use partial template", async () => {
+        registerPartial("header", "<h1>{{title}}</h1>");
+        const result = await renderTemplate("{{> header title='Welcome'}}", {});
+        expect(result).toBe("<h1>Welcome</h1>");
+    });
+    it("should use partial with context", async () => {
+        registerPartial("userCard", "User: {{name}} ({{role}})");
+        const result = await renderTemplate("{{> userCard}}", {
+            name: "John",
+            role: "Admin",
+        });
+        expect(result).toBe("User: John (Admin)");
+    });
+});
+//# sourceMappingURL=template.test.js.map

package/dist/__tests__/template.test.js.map

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

package/dist/__tests__/tracing.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for tracing.ts
+ *
+ * Tests distributed tracing utilities for MCP Mesh TypeScript SDK.
+ */
+export {};
+//# sourceMappingURL=tracing.test.d.ts.map

package/dist/__tests__/tracing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tracing.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/__tests__/tracing.test.js

@@ -0,0 +1,264 @@
+/**
+ * Unit tests for tracing.ts
+ *
+ * Tests distributed tracing utilities for MCP Mesh TypeScript SDK.
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { generateTraceId, generateSpanId, parseTraceContext, createTraceHeaders, publishTraceSpan, } from "../tracing.js";
+// Mock the @mcpmesh/core module
+vi.mock("@mcpmesh/core", () => ({
+    isTracingEnabled: vi.fn(() => false),
+    initTracePublisher: vi.fn(async () => true),
+    publishSpan: vi.fn(async () => true),
+    isTracePublisherAvailable: vi.fn(async () => true),
+}));
+describe("generateTraceId", () => {
+    it("should generate a 32-character hex string (UUID without dashes)", () => {
+        const traceId = generateTraceId();
+        expect(traceId).toHaveLength(32);
+        expect(traceId).toMatch(/^[0-9a-f]{32}$/);
+    });
+    it("should not contain dashes", () => {
+        const traceId = generateTraceId();
+        expect(traceId).not.toContain("-");
+    });
+    it("should generate unique trace IDs", () => {
+        const traceId1 = generateTraceId();
+        const traceId2 = generateTraceId();
+        const traceId3 = generateTraceId();
+        expect(traceId1).not.toBe(traceId2);
+        expect(traceId2).not.toBe(traceId3);
+        expect(traceId1).not.toBe(traceId3);
+    });
+    it("should generate 1000 unique trace IDs without collision", () => {
+        const traceIds = new Set();
+        for (let i = 0; i < 1000; i++) {
+            traceIds.add(generateTraceId());
+        }
+        expect(traceIds.size).toBe(1000);
+    });
+});
+describe("generateSpanId", () => {
+    it("should generate a 16-character hex string (OTel compliant)", () => {
+        const spanId = generateSpanId();
+        // 16 hex characters (64-bit span ID per OpenTelemetry spec)
+        expect(spanId).toHaveLength(16);
+        expect(spanId).toMatch(/^[0-9a-f]{16}$/);
+    });
+    it("should not contain dashes", () => {
+        const spanId = generateSpanId();
+        expect(spanId).not.toContain("-");
+    });
+    it("should generate unique span IDs", () => {
+        const spanId1 = generateSpanId();
+        const spanId2 = generateSpanId();
+        expect(spanId1).not.toBe(spanId2);
+    });
+});
+describe("parseTraceContext", () => {
+    it("should parse trace context from lowercase headers", () => {
+        const headers = {
+            "x-trace-id": "abc123def456",
+            "x-parent-span-id": "span-789",
+        };
+        const context = parseTraceContext(headers);
+        expect(context).not.toBeNull();
+        expect(context?.traceId).toBe("abc123def456");
+        expect(context?.parentSpanId).toBe("span-789");
+    });
+    it("should parse trace context from mixed-case headers", () => {
+        const headers = {
+            "X-Trace-Id": "trace-mixed-case",
+            "X-Parent-Span-Id": "parent-mixed-case",
+        };
+        const context = parseTraceContext(headers);
+        expect(context).not.toBeNull();
+        expect(context?.traceId).toBe("trace-mixed-case");
+        expect(context?.parentSpanId).toBe("parent-mixed-case");
+    });
+    it("should parse trace context from Python SDK headers", () => {
+        const headers = {
+            "X-Trace-ID": "python-trace-id",
+            "X-Parent-Span": "python-parent-span",
+        };
+        const context = parseTraceContext(headers);
+        expect(context).not.toBeNull();
+        expect(context?.traceId).toBe("python-trace-id");
+        expect(context?.parentSpanId).toBe("python-parent-span");
+    });
+    it("should return null when trace ID is missing", () => {
+        const headers = {
+            "x-parent-span-id": "orphan-span",
+        };
+        const context = parseTraceContext(headers);
+        expect(context).toBeNull();
+    });
+    it("should handle missing parent span ID", () => {
+        const headers = {
+            "x-trace-id": "root-trace",
+        };
+        const context = parseTraceContext(headers);
+        expect(context).not.toBeNull();
+        expect(context?.traceId).toBe("root-trace");
+        expect(context?.parentSpanId).toBeNull();
+    });
+    it("should handle empty headers", () => {
+        const context = parseTraceContext({});
+        expect(context).toBeNull();
+    });
+    it("should handle undefined header values", () => {
+        const headers = {
+            "x-trace-id": undefined,
+        };
+        const context = parseTraceContext(headers);
+        expect(context).toBeNull();
+    });
+});
+describe("createTraceHeaders", () => {
+    it("should create headers with trace ID and span ID (Python SDK convention)", () => {
+        const headers = createTraceHeaders("my-trace-id", "my-span-id");
+        expect(headers["X-Trace-ID"]).toBe("my-trace-id");
+        expect(headers["X-Parent-Span"]).toBe("my-span-id");
+    });
+    it("should create headers that can be parsed back", () => {
+        const originalTraceId = generateTraceId();
+        const originalSpanId = generateSpanId();
+        const headers = createTraceHeaders(originalTraceId, originalSpanId);
+        const parsed = parseTraceContext(headers);
+        expect(parsed).not.toBeNull();
+        expect(parsed?.traceId).toBe(originalTraceId);
+        expect(parsed?.parentSpanId).toBe(originalSpanId);
+    });
+});
+describe("TraceContext interface", () => {
+    it("should have correct structure", () => {
+        const context = {
+            traceId: "test-trace-id",
+            parentSpanId: "test-parent-span",
+        };
+        expect(context.traceId).toBe("test-trace-id");
+        expect(context.parentSpanId).toBe("test-parent-span");
+    });
+    it("should allow null parentSpanId for root spans", () => {
+        const context = {
+            traceId: "root-trace",
+            parentSpanId: null,
+        };
+        expect(context.traceId).toBe("root-trace");
+        expect(context.parentSpanId).toBeNull();
+    });
+});
+describe("AgentMetadata interface", () => {
+    it("should have all required fields", () => {
+        const metadata = {
+            agentId: "test-agent-123",
+            agentName: "test-agent",
+            agentNamespace: "default",
+            agentHostname: "localhost",
+            agentIp: "127.0.0.1",
+            agentPort: 8080,
+            agentEndpoint: "http://127.0.0.1:8080",
+        };
+        expect(metadata.agentId).toBe("test-agent-123");
+        expect(metadata.agentName).toBe("test-agent");
+        expect(metadata.agentNamespace).toBe("default");
+        expect(metadata.agentHostname).toBe("localhost");
+        expect(metadata.agentIp).toBe("127.0.0.1");
+        expect(metadata.agentPort).toBe(8080);
+        expect(metadata.agentEndpoint).toBe("http://127.0.0.1:8080");
+    });
+});
+describe("SpanData interface", () => {
+    it("should have all required fields for a successful span", () => {
+        const span = {
+            traceId: "trace-123",
+            spanId: "span-456",
+            parentSpan: "parent-789",
+            functionName: "test_function",
+            startTime: 1704067200.0,
+            endTime: 1704067200.5,
+            durationMs: 500,
+            success: true,
+            error: null,
+            resultType: "string",
+            argsCount: 2,
+            kwargsCount: 3,
+            dependencies: ["dep1", "dep2"],
+            injectedDependencies: 2,
+            meshPositions: [0, 1],
+        };
+        expect(span.success).toBe(true);
+        expect(span.error).toBeNull();
+        expect(span.durationMs).toBe(500);
+    });
+    it("should have correct structure for a failed span", () => {
+        const span = {
+            traceId: "trace-error",
+            spanId: "span-error",
+            parentSpan: null,
+            functionName: "failing_function",
+            startTime: 1704067200.0,
+            endTime: 1704067200.1,
+            durationMs: 100,
+            success: false,
+            error: "Connection timeout",
+            resultType: "error",
+            argsCount: 0,
+            kwargsCount: 0,
+            dependencies: [],
+            injectedDependencies: 0,
+            meshPositions: [],
+        };
+        expect(span.success).toBe(false);
+        expect(span.error).toBe("Connection timeout");
+        expect(span.parentSpan).toBeNull();
+    });
+});
+describe("initTracing", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        // Reset module state by reimporting
+        vi.resetModules();
+    });
+    it("should check if tracing is enabled via Rust core", async () => {
+        const { isTracingEnabled } = await import("@mcpmesh/core");
+        const metadata = {
+            agentId: "test-agent",
+            agentName: "test",
+            agentNamespace: "default",
+            agentHostname: "localhost",
+            agentIp: "127.0.0.1",
+            agentPort: 8080,
+            agentEndpoint: "http://127.0.0.1:8080",
+        };
+        // Re-import to get fresh module state
+        const { initTracing: freshInit } = await import("../tracing.js");
+        await freshInit(metadata);
+        expect(isTracingEnabled).toHaveBeenCalled();
+    });
+});
+describe("publishTraceSpan", () => {
+    it("should return false when tracing is disabled", async () => {
+        const span = {
+            traceId: "trace-123",
+            spanId: "span-456",
+            parentSpan: null,
+            functionName: "test",
+            startTime: Date.now() / 1000,
+            endTime: Date.now() / 1000,
+            durationMs: 0,
+            success: true,
+            error: null,
+            resultType: "string",
+            argsCount: 0,
+            kwargsCount: 0,
+            dependencies: [],
+            injectedDependencies: 0,
+            meshPositions: [],
+        };
+        // Tracing is disabled by default in our mock
+        const result = await publishTraceSpan(span);
+        expect(result).toBe(false);
+    });
+});
+//# sourceMappingURL=tracing.test.js.map

package/dist/__tests__/tracing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.test.js","sourceRoot":"","sources":["../../src/__tests__/tracing.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GAIjB,MAAM,eAAe,CAAC;AAEvB,gCAAgC;AAChC,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9B,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC;IACpC,kBAAkB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC;IAC3C,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC;IACpC,yBAAyB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC;CACnD,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;QAElC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;QAElC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;QAEnC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAEhC,4DAA4D;QAC5D,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;QAEjC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,OAAO,GAAG;YACd,YAAY,EAAE,cAAc;YAC5B,kBAAkB,EAAE,UAAU;SAC/B,CAAC;QAEF,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAE3C,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,OAAO,GAAG;YACd,YAAY,EAAE,kBAAkB;YAChC,kBAAkB,EAAE,mBAAmB;SACxC,CAAC;QAEF,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAE3C,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,OAAO,GAAG;YACd,YAAY,EAAE,iBAAiB;YAC/B,eAAe,EAAE,oBAAoB;SACtC,CAAC;QAEF,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAE3C,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,OAAO,GAAG;YACd,kBAAkB,EAAE,aAAa;SAClC,CAAC;QAEF,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAE3C,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,OAAO,GAAG;YACd,YAAY,EAAE,YAAY;SAC3B,CAAC;QAEF,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAE3C,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,OAAO,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAEtC,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,OAAO,GAAuC;YAClD,YAAY,EAAE,SAAS;SACxB,CAAC;QAEF,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAE3C,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,OAAO,GAAG,kBAAkB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;QAEhE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,eAAe,GAAG,eAAe,EAAE,CAAC;QAC1C,MAAM,cAAc,GAAG,cAAc,EAAE,CAAC;QAExC,MAAM,OAAO,GAAG,kBAAkB,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,OAAO,GAAiB;YAC5B,OAAO,EAAE,eAAe;YACxB,YAAY,EAAE,kBAAkB;SACjC,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,OAAO,GAAiB;YAC5B,OAAO,EAAE,YAAY;YACrB,YAAY,EAAE,IAAI;SACnB,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,QAAQ,GAAkB;YAC9B,OAAO,EAAE,gBAAgB;YACzB,SAAS,EAAE,YAAY;YACvB,cAAc,EAAE,SAAS;YACzB,aAAa,EAAE,WAAW;YAC1B,OAAO,EAAE,WAAW;YACpB,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,uBAAuB;SACvC,CAAC;QAEF,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAChD,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,IAAI,GAAa;YACrB,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,YAAY;YACxB,YAAY,EAAE,eAAe;YAC7B,SAAS,EAAE,YAAY;YACvB,OAAO,EAAE,YAAY;YACrB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,QAAQ;YACpB,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;YAC9B,oBAAoB,EAAE,CAAC;YACvB,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;SACtB,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,IAAI,GAAa;YACrB,OAAO,EAAE,aAAa;YACtB,MAAM,EAAE,YAAY;YACpB,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,kBAAkB;YAChC,SAAS,EAAE,YAAY;YACvB,OAAO,EAAE,YAAY;YACrB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,oBAAoB;YAC3B,UAAU,EAAE,OAAO;YACnB,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,EAAE;YAChB,oBAAoB,EAAE,CAAC;YACvB,aAAa,EAAE,EAAE;SAClB,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,oCAAoC;QACpC,EAAE,CAAC,YAAY,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAE3D,MAAM,QAAQ,GAAkB;YAC9B,OAAO,EAAE,YAAY;YACrB,SAAS,EAAE,MAAM;YACjB,cAAc,EAAE,SAAS;YACzB,aAAa,EAAE,WAAW;YAC1B,OAAO,EAAE,WAAW;YACpB,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,uBAAuB;SACvC,CAAC;QAEF,sCAAsC;QACtC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACjE,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE1B,MAAM,CAAC,gBAAgB,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,IAAI,GAAa;YACrB,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,MAAM;YACpB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI;YAC5B,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI;YAC1B,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,QAAQ;YACpB,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,EAAE;YAChB,oBAAoB,EAAE,CAAC;YACvB,aAAa,EAAE,EAAE;SAClB,CAAC;QAEF,6CAA6C;QAC7C,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAE5C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/agent.d.ts

@@ -0,0 +1,165 @@
+/**
+ * MeshAgent implementation for MCP Mesh.
+ *
+ * Provides the core agent functionality including:
+ * - Registration with mesh registry via Rust core
+ * - Heartbeat management
+ * - Tool/capability discovery
+ * - Dependency injection for tool functions
+ * - Graceful shutdown
+ */
+import type { FastMCP } from "fastmcp";
+import type { z } from "zod";
+import { type JsAgentHandle } from "@mcpmesh/core";
+import type { AgentConfig, ResolvedAgentConfig, MeshToolDef, McpMeshAgent, LlmProviderConfig } from "./types.js";
+/**
+ * MeshAgent wraps a FastMCP server with MCP Mesh capabilities.
+ *
+ * It provides:
+ * - Automatic registration with the mesh registry
+ * - Heartbeat management via Rust core
+ * - Tool/capability discovery
+ * - Dependency injection for tool functions
+ */
+export declare class MeshAgent {
+    private server;
+    private config;
+    private agentId;
+    private tools;
+    /**
+     * Maps LLM provider tool names to their vendor (e.g., "process_chat" -> "anthropic").
+     * TODO: Use for provider metrics, health checks, or exposing via getLlmProviderVendor() getter.
+     * Currently populated by addLlmProvider() for future introspection needs.
+     */
+    private llmProviderVendors;
+    private handle;
+    private started;
+    private tracingEnabled;
+    /**
+     * Resolved dependencies: composite key -> proxy
+     * Key format: "${toolName}:dep_${depIndex}" (e.g., "myTool:dep_0")
+     * Updated when dependency_available/unavailable events arrive.
+     *
+     * This allows multiple tools to depend on the same capability with
+     * different tags/settings without overwriting each other.
+     */
+    private resolvedDeps;
+    constructor(server: FastMCP, config: AgentConfig);
+    /**
+     * Add a tool to the agent.
+     *
+     * This registers the tool with both fastmcp (for MCP protocol) and
+     * the mesh (for capability discovery). If the tool has dependencies,
+     * they will be injected positionally at runtime.
+     */
+    addTool<T extends z.ZodType>(def: MeshToolDef<T>): this;
+    /**
+     * Add an LLM provider to the agent.
+     *
+     * This creates a zero-code LLM provider that other agents can use
+     * via mesh delegation.
+     *
+     * @param config - LLM provider configuration
+     * @returns This agent for chaining
+     *
+     * @example
+     * ```typescript
+     * agent.addLlmProvider({
+     *   model: "anthropic/claude-sonnet-4-5",
+     *   capability: "llm",
+     *   tags: ["llm", "claude", "anthropic", "provider"],
+     * });
+     * ```
+     */
+    addLlmProvider(config: LlmProviderConfig): this;
+    /**
+     * Convert Zod schema to JSON Schema.
+     */
+    private convertZodToJsonSchema;
+    /**
+     * Internal: Start the agent (called by auto-start mechanism).
+     */
+    _autoStart(): Promise<void>;
+    /**
+     * Register LLM tools from LlmToolRegistry.
+     * This adds tool metadata for LLM tools created via mesh.llm().
+     */
+    private registerLlmTools;
+    /**
+     * Install signal handlers for graceful shutdown.
+     * Ensures agent unregisters from registry on SIGINT/SIGTERM.
+     */
+    private installSignalHandlers;
+    /**
+     * Start the Rust core heartbeat loop.
+     */
+    private startHeartbeat;
+    /**
+     * Run the event loop to handle mesh events.
+     */
+    private runEventLoop;
+    /**
+     * Handle dependency_available event.
+     * Creates proxy at the exact position specified by the event.
+     *
+     * The Rust core now sends events with requestingFunction and depIndex,
+     * so we can directly create the proxy at the correct position without
+     * needing to match by capability.
+     */
+    private handleDependencyAvailable;
+    /**
+     * Handle dependency_unavailable event.
+     * Removes proxy at the exact position specified by the event.
+     */
+    private handleDependencyUnavailable;
+    /**
+     * Get a resolved dependency proxy by capability name.
+     * Returns the first matching proxy if multiple tools depend on the same capability.
+     *
+     * For more precise lookup, use getDependencyByKey with composite key "toolName:dep_index".
+     */
+    getDependency(capability: string): McpMeshAgent | null;
+    /**
+     * Get a resolved dependency proxy by composite key.
+     *
+     * @param toolName - The tool name
+     * @param depIndex - The dependency index within that tool
+     * @returns The proxy or null if not available
+     */
+    getDependencyByKey(toolName: string, depIndex: number): McpMeshAgent | null;
+    /**
+     * Get all resolved dependencies.
+     */
+    getAllDependencies(): Map<string, McpMeshAgent>;
+    /**
+     * Get the agent handle for advanced operations.
+     */
+    getHandle(): JsAgentHandle | null;
+    /**
+     * Get the resolved configuration.
+     */
+    getConfig(): ResolvedAgentConfig;
+    /**
+     * Get the agent ID.
+     */
+    getAgentId(): string;
+    /**
+     * Shutdown the agent gracefully.
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Create a MeshAgent wrapping a FastMCP server.
+ *
+ * This is the main entry point for creating MCP Mesh agents.
+ *
+ * @example
+ * ```typescript
+ * const agent = mesh(server, {
+ *   name: "calculator",
+ *   port: 9002,
+ * });
+ * ```
+ */
+export declare function mesh(server: FastMCP, config: AgentConfig): MeshAgent;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAGL,KAAK,aAAa,EAInB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,WAAW,EAEX,YAAY,EAEZ,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAuCpB;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAoC;IACjD;;;;OAIG;IACH,OAAO,CAAC,kBAAkB,CAAkC;IAC5D,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;IAE/B;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY,CAAwC;gBAEhD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW;IAchD;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAyHvD;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAkC/C;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAI9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0CjC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;YACW,cAAc;IAyF5B;;OAEG;YACW,YAAY;IA6G1B;;;;;;;OAOG;IACH,OAAO,CAAC,yBAAyB;IA6CjC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAiCnC;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAYtD;;;;;;OAMG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAI3E;;OAEG;IACH,kBAAkB,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAI/C;;OAEG;IACH,SAAS,IAAI,aAAa,GAAG,IAAI;IAIjC;;OAEG;IACH,SAAS,IAAI,mBAAmB;IAIhC;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAMhC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,CAEpE"}