gauss-ai 4.0.0

package/dist/server/index.js

@@ -0,0 +1,166 @@
+// src/server/mcp-server.ts
+var McpServer = class {
+  name;
+  version;
+  tools;
+  constructor(options) {
+    this.name = options.name ?? "gauss-agent";
+    this.version = options.version ?? "1.0.0";
+    this.tools = options.tools;
+  }
+  /** Handle a JSON-RPC request and return a JSON-RPC response */
+  async handleRequest(request) {
+    try {
+      switch (request.method) {
+        case "initialize":
+          return this.handleInitialize(request);
+        case "tools/list":
+          return this.handleToolsList(request);
+        case "tools/call":
+          return this.handleToolsCall(request);
+        case "notifications/initialized":
+          return { jsonrpc: "2.0", id: null };
+        default:
+          return {
+            jsonrpc: "2.0",
+            id: request.id ?? null,
+            error: { code: -32601, message: `Method not found: ${request.method}` }
+          };
+      }
+    } catch (error) {
+      return {
+        jsonrpc: "2.0",
+        id: request.id ?? null,
+        error: { code: -32603, message: error instanceof Error ? error.message : "Internal error" }
+      };
+    }
+  }
+  handleInitialize(request) {
+    return {
+      jsonrpc: "2.0",
+      id: request.id ?? null,
+      result: {
+        protocolVersion: "2025-03-26",
+        capabilities: { tools: { listChanged: false } },
+        serverInfo: { name: this.name, version: this.version }
+      }
+    };
+  }
+  handleToolsList(request) {
+    const toolList = Object.entries(this.tools).map(([name, tool]) => {
+      const t = tool;
+      return {
+        name,
+        description: t.description ?? "",
+        inputSchema: t.parameters?.jsonSchema ?? { type: "object", properties: {} }
+      };
+    });
+    return { jsonrpc: "2.0", id: request.id ?? null, result: { tools: toolList } };
+  }
+  async handleToolsCall(request) {
+    const params = request.params ?? {};
+    const toolName = params.name;
+    const args = params.arguments;
+    if (!toolName) {
+      return {
+        jsonrpc: "2.0",
+        id: request.id ?? null,
+        error: { code: -32602, message: "Missing tool name" }
+      };
+    }
+    const tool = this.tools[toolName];
+    if (!tool?.execute) {
+      return {
+        jsonrpc: "2.0",
+        id: request.id ?? null,
+        error: { code: -32602, message: `Unknown tool: ${toolName}` }
+      };
+    }
+    try {
+      const result = await tool.execute(args ?? {});
+      return {
+        jsonrpc: "2.0",
+        id: request.id ?? null,
+        result: {
+          content: [{ type: "text", text: typeof result === "string" ? result : JSON.stringify(result) }]
+        }
+      };
+    } catch (error) {
+      return {
+        jsonrpc: "2.0",
+        id: request.id ?? null,
+        result: {
+          content: [{ type: "text", text: error instanceof Error ? error.message : "Tool execution failed" }],
+          isError: true
+        }
+      };
+    }
+  }
+};
+
+// src/server/streamable-http-handler.ts
+var InMemorySessionManager = class {
+  sessions = /* @__PURE__ */ new Set();
+  createSession() {
+    const id = crypto.randomUUID();
+    this.sessions.add(id);
+    return id;
+  }
+  isValidSession(id) {
+    return this.sessions.has(id);
+  }
+  deleteSession(id) {
+    this.sessions.delete(id);
+  }
+};
+function createStreamableHttpHandler(options) {
+  const { server } = options;
+  const sessions = options.sessionManager ?? new InMemorySessionManager();
+  return async (request) => {
+    if (request.method === "DELETE") {
+      const sessionId = request.headers.get("mcp-session-id");
+      if (!sessionId || !sessions.isValidSession(sessionId)) {
+        return new Response(null, { status: 404 });
+      }
+      sessions.deleteSession(sessionId);
+      return new Response(null, { status: 200 });
+    }
+    if (request.method === "GET") {
+      return new Response(null, { status: 405 });
+    }
+    if (request.method !== "POST") {
+      return new Response(null, { status: 405 });
+    }
+    let body;
+    try {
+      body = await request.json();
+    } catch {
+      return new Response(
+        JSON.stringify({ jsonrpc: "2.0", id: null, error: { code: -32700, message: "Parse error" } }),
+        { status: 400, headers: { "Content-Type": "application/json" } }
+      );
+    }
+    const isInit = body.method === "initialize";
+    if (!isInit) {
+      const sessionId = request.headers.get("mcp-session-id");
+      if (!sessionId || !sessions.isValidSession(sessionId)) {
+        return new Response(null, { status: 401 });
+      }
+    }
+    if (!("id" in body)) {
+      return new Response(null, { status: 202 });
+    }
+    const result = await server.handleRequest(body);
+    const headers = { "Content-Type": "application/json" };
+    if (isInit && !result.error) {
+      const sessionId = sessions.createSession();
+      headers["Mcp-Session-Id"] = sessionId;
+    }
+    return new Response(JSON.stringify(result), { status: 200, headers });
+  };
+}
+export {
+  McpServer,
+  createStreamableHttpHandler
+};
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/mcp-server.ts","../../src/server/streamable-http-handler.ts"],"sourcesContent":["// =============================================================================\n// McpServer — Expose Agent tools as an MCP Server\n// =============================================================================\n// Enables cross-language consumption (Python, Go, etc.) via Streamable HTTP.\n// =============================================================================\n\nimport type { Tool } from \"../core/llm/index.js\";\n\nexport interface McpServerOptions {\n  name?: string;\n  version?: string;\n  tools: Record<string, Tool<any, any>>;\n}\n\ninterface JsonRpcRequest {\n  jsonrpc: \"2.0\";\n  id?: number | string;\n  method: string;\n  params?: Record<string, unknown>;\n}\n\ninterface JsonRpcResponse {\n  jsonrpc: \"2.0\";\n  id?: number | string | null;\n  result?: unknown;\n  error?: { code: number; message: string; data?: unknown };\n}\n\nexport class McpServer {\n  private readonly name: string;\n  private readonly version: string;\n  private readonly tools: Record<string, Tool<any, any>>;\n\n  constructor(options: McpServerOptions) {\n    this.name = options.name ?? \"gauss-agent\";\n    this.version = options.version ?? \"1.0.0\";\n    this.tools = options.tools;\n  }\n\n  /** Handle a JSON-RPC request and return a JSON-RPC response */\n  async handleRequest(request: JsonRpcRequest): Promise<JsonRpcResponse> {\n    try {\n      switch (request.method) {\n        case \"initialize\":\n          return this.handleInitialize(request);\n        case \"tools/list\":\n          return this.handleToolsList(request);\n        case \"tools/call\":\n          return this.handleToolsCall(request);\n        case \"notifications/initialized\":\n          return { jsonrpc: \"2.0\", id: null };\n        default:\n          return {\n            jsonrpc: \"2.0\",\n            id: request.id ?? null,\n            error: { code: -32601, message: `Method not found: ${request.method}` },\n          };\n      }\n    } catch (error) {\n      return {\n        jsonrpc: \"2.0\",\n        id: request.id ?? null,\n        error: { code: -32603, message: error instanceof Error ? error.message : \"Internal error\" },\n      };\n    }\n  }\n\n  private handleInitialize(request: JsonRpcRequest): JsonRpcResponse {\n    return {\n      jsonrpc: \"2.0\",\n      id: request.id ?? null,\n      result: {\n        protocolVersion: \"2025-03-26\",\n        capabilities: { tools: { listChanged: false } },\n        serverInfo: { name: this.name, version: this.version },\n      },\n    };\n  }\n\n  private handleToolsList(request: JsonRpcRequest): JsonRpcResponse {\n    const toolList = Object.entries(this.tools).map(([name, tool]) => {\n      const t = tool as { description?: string; parameters?: { jsonSchema?: unknown } };\n      return {\n        name,\n        description: t.description ?? \"\",\n        inputSchema: t.parameters?.jsonSchema ?? { type: \"object\", properties: {} },\n      };\n    });\n    return { jsonrpc: \"2.0\", id: request.id ?? null, result: { tools: toolList } };\n  }\n\n  private async handleToolsCall(request: JsonRpcRequest): Promise<JsonRpcResponse> {\n    const params = request.params ?? {};\n    const toolName = params.name as string | undefined;\n    const args = params.arguments as Record<string, unknown> | undefined;\n\n    if (!toolName) {\n      return {\n        jsonrpc: \"2.0\",\n        id: request.id ?? null,\n        error: { code: -32602, message: \"Missing tool name\" },\n      };\n    }\n\n    const tool = this.tools[toolName] as { execute?: (args: unknown) => Promise<unknown> } | undefined;\n    if (!tool?.execute) {\n      return {\n        jsonrpc: \"2.0\",\n        id: request.id ?? null,\n        error: { code: -32602, message: `Unknown tool: ${toolName}` },\n      };\n    }\n\n    try {\n      const result = await tool.execute(args ?? {});\n      return {\n        jsonrpc: \"2.0\",\n        id: request.id ?? null,\n        result: {\n          content: [{ type: \"text\", text: typeof result === \"string\" ? result : JSON.stringify(result) }],\n        },\n      };\n    } catch (error) {\n      return {\n        jsonrpc: \"2.0\",\n        id: request.id ?? null,\n        result: {\n          content: [{ type: \"text\", text: error instanceof Error ? error.message : \"Tool execution failed\" }],\n          isError: true,\n        },\n      };\n    }\n  }\n}\n","// =============================================================================\n// Streamable HTTP Handler — Universal MCP HTTP handler using Web APIs\n// =============================================================================\n// Uses the standard Request/Response Web API, works in all runtimes.\n// =============================================================================\n\nimport { McpServer } from \"./mcp-server.js\";\n\nexport interface StreamableHttpHandlerOptions {\n  server: McpServer;\n  sessionManager?: SessionManager;\n}\n\nexport interface SessionManager {\n  createSession(): string;\n  isValidSession(id: string): boolean;\n  deleteSession(id: string): void;\n}\n\nclass InMemorySessionManager implements SessionManager {\n  private readonly sessions = new Set<string>();\n\n  createSession(): string {\n    const id = crypto.randomUUID();\n    this.sessions.add(id);\n    return id;\n  }\n\n  isValidSession(id: string): boolean {\n    return this.sessions.has(id);\n  }\n\n  deleteSession(id: string): void {\n    this.sessions.delete(id);\n  }\n}\n\nexport function createStreamableHttpHandler(options: StreamableHttpHandlerOptions) {\n  const { server } = options;\n  const sessions = options.sessionManager ?? new InMemorySessionManager();\n\n  return async (request: Request): Promise<Response> => {\n    if (request.method === \"DELETE\") {\n      const sessionId = request.headers.get(\"mcp-session-id\");\n      if (!sessionId || !sessions.isValidSession(sessionId)) {\n        return new Response(null, { status: 404 });\n      }\n      sessions.deleteSession(sessionId);\n      return new Response(null, { status: 200 });\n    }\n\n    if (request.method === \"GET\") {\n      return new Response(null, { status: 405 });\n    }\n\n    if (request.method !== \"POST\") {\n      return new Response(null, { status: 405 });\n    }\n\n    let body: Record<string, unknown>;\n    try {\n      body = await request.json() as Record<string, unknown>;\n    } catch {\n      return new Response(\n        JSON.stringify({ jsonrpc: \"2.0\", id: null, error: { code: -32700, message: \"Parse error\" } }),\n        { status: 400, headers: { \"Content-Type\": \"application/json\" } },\n      );\n    }\n    const isInit = body.method === \"initialize\";\n\n    // Session validation: required for all non-init requests\n    if (!isInit) {\n      const sessionId = request.headers.get(\"mcp-session-id\");\n      if (!sessionId || !sessions.isValidSession(sessionId)) {\n        return new Response(null, { status: 401 });\n      }\n    }\n\n    // Handle notification (no id)\n    if (!(\"id\" in body)) {\n      return new Response(null, { status: 202 });\n    }\n\n    const result = await server.handleRequest(body as any);\n\n    const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n\n    // Assign session ID on initialize\n    if (isInit && !result.error) {\n      const sessionId = sessions.createSession();\n      headers[\"Mcp-Session-Id\"] = sessionId;\n    }\n\n    return new Response(JSON.stringify(result), { status: 200, headers });\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/testing/index.cjs

@@ -0,0 +1,25 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+var _chunkUO4NGXRTcjs = require('../chunk-UO4NGXRT.cjs');
+
+
+
+
+
+
+
+
+
+
+
+exports.assertMaxSteps = _chunkUO4NGXRTcjs.assertMaxSteps; exports.assertMaxTokens = _chunkUO4NGXRTcjs.assertMaxTokens; exports.assertResponseContains = _chunkUO4NGXRTcjs.assertResponseContains; exports.assertResponseMatches = _chunkUO4NGXRTcjs.assertResponseMatches; exports.assertToolCalled = _chunkUO4NGXRTcjs.assertToolCalled; exports.assertToolNotCalled = _chunkUO4NGXRTcjs.assertToolNotCalled; exports.compareSnapshots = _chunkUO4NGXRTcjs.compareSnapshots; exports.createMockProvider = _chunkUO4NGXRTcjs.createMockProvider; exports.createSnapshot = _chunkUO4NGXRTcjs.createSnapshot; exports.runAgentTest = _chunkUO4NGXRTcjs.runAgentTest;
+//# sourceMappingURL=index.cjs.map

package/dist/testing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/giulioleone/Sviluppo/gauss/gauss-flow/dist/testing/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,moBAAC","file":"/Users/giulioleone/Sviluppo/gauss/gauss-flow/dist/testing/index.cjs"}

package/dist/testing/index.d.cts

@@ -0,0 +1,63 @@
+import { L as LanguageModel } from '../types-CVsP7gFI.cjs';
+import { N as Agent } from '../agent-builder-GEMYdb1p.cjs';
+import 'zod';
+import '../token-counter.port-D7BHMCRR.cjs';
+
+interface MockResponse {
+    text: string;
+    toolCalls?: Array<{
+        toolName: string;
+        args: Record<string, unknown>;
+    }>;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+/**
+ * Creates a mock LanguageModelV3 that returns canned responses in order.
+ * Compatible with AI SDK v6's ToolLoopAgent.
+ */
+declare function createMockProvider(responses: MockResponse[]): LanguageModel;
+
+interface AgentTestResult {
+    response: string;
+    toolCalls: Array<{
+        name: string;
+        args: unknown;
+        result: unknown;
+    }>;
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+    duration: number;
+    steps: number;
+}
+declare function runAgentTest(config: {
+    agent: Agent;
+    prompt: string;
+    maxSteps?: number;
+}): Promise<AgentTestResult>;
+
+declare function assertToolCalled(result: AgentTestResult, toolName: string, args?: Record<string, unknown>): void;
+declare function assertToolNotCalled(result: AgentTestResult, toolName: string): void;
+declare function assertResponseContains(result: AgentTestResult, substring: string): void;
+declare function assertResponseMatches(result: AgentTestResult, pattern: RegExp): void;
+declare function assertMaxSteps(result: AgentTestResult, max: number): void;
+declare function assertMaxTokens(result: AgentTestResult, max: number): void;
+
+/**
+ * Creates a deterministic JSON snapshot of an AgentTestResult.
+ * Excludes non-deterministic fields (duration).
+ */
+declare function createSnapshot(result: AgentTestResult): string;
+/**
+ * Compares two snapshot strings line by line.
+ */
+declare function compareSnapshots(current: string, expected: string): {
+    match: boolean;
+    diff?: string;
+};
+
+export { type AgentTestResult, type MockResponse, assertMaxSteps, assertMaxTokens, assertResponseContains, assertResponseMatches, assertToolCalled, assertToolNotCalled, compareSnapshots, createMockProvider, createSnapshot, runAgentTest };

package/dist/testing/index.d.ts

@@ -0,0 +1,63 @@
+import { L as LanguageModel } from '../types-CVsP7gFI.js';
+import { N as Agent } from '../agent-builder-8W3mBR-N.js';
+import 'zod';
+import '../token-counter.port-CRgxZZGe.js';
+
+interface MockResponse {
+    text: string;
+    toolCalls?: Array<{
+        toolName: string;
+        args: Record<string, unknown>;
+    }>;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+/**
+ * Creates a mock LanguageModelV3 that returns canned responses in order.
+ * Compatible with AI SDK v6's ToolLoopAgent.
+ */
+declare function createMockProvider(responses: MockResponse[]): LanguageModel;
+
+interface AgentTestResult {
+    response: string;
+    toolCalls: Array<{
+        name: string;
+        args: unknown;
+        result: unknown;
+    }>;
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+    duration: number;
+    steps: number;
+}
+declare function runAgentTest(config: {
+    agent: Agent;
+    prompt: string;
+    maxSteps?: number;
+}): Promise<AgentTestResult>;
+
+declare function assertToolCalled(result: AgentTestResult, toolName: string, args?: Record<string, unknown>): void;
+declare function assertToolNotCalled(result: AgentTestResult, toolName: string): void;
+declare function assertResponseContains(result: AgentTestResult, substring: string): void;
+declare function assertResponseMatches(result: AgentTestResult, pattern: RegExp): void;
+declare function assertMaxSteps(result: AgentTestResult, max: number): void;
+declare function assertMaxTokens(result: AgentTestResult, max: number): void;
+
+/**
+ * Creates a deterministic JSON snapshot of an AgentTestResult.
+ * Excludes non-deterministic fields (duration).
+ */
+declare function createSnapshot(result: AgentTestResult): string;
+/**
+ * Compares two snapshot strings line by line.
+ */
+declare function compareSnapshots(current: string, expected: string): {
+    match: boolean;
+    diff?: string;
+};
+
+export { type AgentTestResult, type MockResponse, assertMaxSteps, assertMaxTokens, assertResponseContains, assertResponseMatches, assertToolCalled, assertToolNotCalled, compareSnapshots, createMockProvider, createSnapshot, runAgentTest };

package/dist/testing/index.js

@@ -0,0 +1,25 @@
+import {
+  assertMaxSteps,
+  assertMaxTokens,
+  assertResponseContains,
+  assertResponseMatches,
+  assertToolCalled,
+  assertToolNotCalled,
+  compareSnapshots,
+  createMockProvider,
+  createSnapshot,
+  runAgentTest
+} from "../chunk-ZM2OEWM2.js";
+export {
+  assertMaxSteps,
+  assertMaxTokens,
+  assertResponseContains,
+  assertResponseMatches,
+  assertToolCalled,
+  assertToolNotCalled,
+  compareSnapshots,
+  createMockProvider,
+  createSnapshot,
+  runAgentTest
+};
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}