alepha 0.22.0 → 0.24.0

package/dist/mcp/index.d.ts

@@ -1,5 +1,4 @@
 import { Alepha, AlephaError, Async, KIND, Primitive, Static, TObject, TSchema } from "alepha";
-
 //#region ../../src/mcp/errors/McpError.d.ts
 /**
  * MCP-specific error codes (application-specific codes in the -32000 to -32099 range).
@@ -478,11 +477,11 @@ declare class ResourcePrimitive extends Primitive<ResourcePrimitiveOptions> {
  *   add = $tool({
  *     description: "Add two numbers together",
  *     schema: {
- *       params: t.object({
- *         a: t.number(),
- *         b: t.number(),
+ *       params: z.object({
+ *         a: z.number(),
+ *         b: z.number(),
  *       }),
- *       result: t.number(),
+ *       result: z.number(),
  *     },
  *     handler: async ({ params }) => {
  *       return params.a + params.b;
@@ -492,10 +491,10 @@ declare class ResourcePrimitive extends Primitive<ResourcePrimitiveOptions> {
  *   greet = $tool({
  *     description: "Generate a greeting message",
  *     schema: {
- *       params: t.object({
- *         name: t.text(),
+ *       params: z.object({
+ *         name: z.text(),
  *       }),
- *       result: t.text(),
+ *       result: z.text(),
  *     },
  *     handler: async ({ params }) => {
  *       return `Hello, ${params.name}!`;
@@ -615,7 +614,7 @@ declare class ToolPrimitive<T extends ToolPrimitiveSchema> extends Primitive<Too
     root?: boolean;
   }): McpJsonSchema;
   /**
-   * Convert a single property schema to JSON Schema format.
+   * Convert a single property schema to JSON Schema format (zod-native).
    */
   protected propertyToJsonSchema(schema: TSchema): Record<string, unknown>;
 }
@@ -712,6 +711,15 @@ declare class McpServerProvider {
     tools: McpToolDescriptor[];
   };
   protected handleToolsCall(params: Record<string, unknown>, context?: McpContext): Promise<McpToolCallResult>;
+  /**
+   * Recognize a tool handler's return value as a pre-built MCP tool result —
+   * i.e. it already carries a `content` array of content blocks (text, image,
+   * audio, resource, resource_link). Returns the normalized
+   * {@link McpToolCallResult} when matched, or `undefined` to fall back to the
+   * default JSON/text encoding. Only ever consulted for tools that did NOT
+   * declare an output schema (see {@link handleToolCall}).
+   */
+  protected asRawToolContent(result: unknown): McpToolCallResult | undefined;
   protected handleResourcesList(): {
     resources: McpResourceDescriptor[];
   };
@@ -735,9 +743,9 @@ declare class McpServerProvider {
  * class Prompts {
  *   greeting = $prompt({
  *     description: "Generate a personalized greeting",
- *     args: t.object({
- *       name: t.text({ description: "Name of the person to greet" }),
- *       style: t.optional(t.enum(["formal", "casual"])),
+ *     args: z.object({
+ *       name: z.text({ description: "Name of the person to greet" }),
+ *       style: z.enum(["formal", "casual"]).optional(),
  *     }),
  *     handler: async ({ args }) => [
  *       {
@@ -751,9 +759,9 @@ declare class McpServerProvider {
  *
  *   codeReview = $prompt({
  *     description: "Request a code review",
- *     args: t.object({
- *       code: t.text({ description: "The code to review" }),
- *       language: t.text({ description: "Programming language" }),
+ *     args: z.object({
+ *       code: z.text({ description: "The code to review" }),
+ *       language: z.text({ description: "Programming language" }),
  *     }),
  *     handler: async ({ args }) => [
  *       {
@@ -843,80 +851,18 @@ declare class PromptPrimitive<T extends TObject> extends Primitive<PromptPrimiti
 }
 //#endregion
 //#region ../../src/mcp/transports/StreamableHttpMcpTransport.d.ts
-declare const mcpStreamableHttpOptions: import("alepha").Atom<import("typebox").TObject<{
-  /**
-   * Path for the MCP endpoint. Single endpoint for both requests and
-   * (optional) server-streamed responses, per spec 2025-03-26+.
-   */
-  path: import("typebox").TString;
-  /**
-   * Allow-list of `Origin` header values accepted on incoming requests.
-   * Empty array (default) means "allow any". When set, browser-originated
-   * requests with a non-matching `Origin` are rejected with 403 Forbidden,
-   * blocking DNS-rebinding attacks against localhost MCP servers.
-   *
-   * Server-to-server callers (no `Origin` header) are always allowed.
-   *
-   * Spec 2025-11-25, PR #1439.
-   */
-  allowedOrigins: import("typebox").TArray<import("typebox").TString>;
-  /**
-   * When true, an unauthenticated POST to the MCP endpoint is rejected
-   * with `401 Unauthorized` and an RFC 9728 `WWW-Authenticate` challenge
-   * instead of being dispatched. MCP clients (Claude, etc.) rely on that
-   * challenge to discover the OAuth authorization server.
-   *
-   * The transport stays OAuth-agnostic: it only knows "auth is required".
-   * `$realm({ features: { oauth: true } })` flips this on automatically.
-   *
-   * @default false
-   */
-  requireAuth: import("typebox").TBoolean;
-  /**
-   * Path of the RFC 9728 protected-resource metadata document, advertised
-   * (as an absolute URL, resolved against the request origin) in the
-   * `WWW-Authenticate` challenge emitted when {@link requireAuth} rejects
-   * a request.
-   */
-  resourceMetadataPath: import("typebox").TString;
-}>, "alepha.mcp.streamableHttp.options">;
-declare const mcpSseOptions: import("alepha").Atom<import("typebox").TObject<{
-  /**
-   * Path for the MCP endpoint. Single endpoint for both requests and
-   * (optional) server-streamed responses, per spec 2025-03-26+.
-   */
-  path: import("typebox").TString;
-  /**
-   * Allow-list of `Origin` header values accepted on incoming requests.
-   * Empty array (default) means "allow any". When set, browser-originated
-   * requests with a non-matching `Origin` are rejected with 403 Forbidden,
-   * blocking DNS-rebinding attacks against localhost MCP servers.
-   *
-   * Server-to-server callers (no `Origin` header) are always allowed.
-   *
-   * Spec 2025-11-25, PR #1439.
-   */
-  allowedOrigins: import("typebox").TArray<import("typebox").TString>;
-  /**
-   * When true, an unauthenticated POST to the MCP endpoint is rejected
-   * with `401 Unauthorized` and an RFC 9728 `WWW-Authenticate` challenge
-   * instead of being dispatched. MCP clients (Claude, etc.) rely on that
-   * challenge to discover the OAuth authorization server.
-   *
-   * The transport stays OAuth-agnostic: it only knows "auth is required".
-   * `$realm({ features: { oauth: true } })` flips this on automatically.
-   *
-   * @default false
-   */
-  requireAuth: import("typebox").TBoolean;
-  /**
-   * Path of the RFC 9728 protected-resource metadata document, advertised
-   * (as an absolute URL, resolved against the request origin) in the
-   * `WWW-Authenticate` challenge emitted when {@link requireAuth} rejects
-   * a request.
-   */
-  resourceMetadataPath: import("typebox").TString;
-}>, "alepha.mcp.streamableHttp.options">;
+declare const mcpStreamableHttpOptions: import("alepha").Atom<import("zod").ZodObject<{
+  path: import("zod").ZodString;
+  allowedOrigins: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+  requireAuth: import("zod").ZodDefault<import("zod").ZodBoolean>;
+  resourceMetadataPath: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, "alepha.mcp.streamableHttp.options">;
+declare const mcpSseOptions: import("alepha").Atom<import("zod").ZodObject<{
+  path: import("zod").ZodString;
+  allowedOrigins: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+  requireAuth: import("zod").ZodDefault<import("zod").ZodBoolean>;
+  resourceMetadataPath: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, "alepha.mcp.streamableHttp.options">;
 /**
  * Streamable HTTP transport for MCP communication.
  *
@@ -979,7 +925,7 @@ declare class StreamableHttpMcpTransport {
    * concrete need exists).
    */
   message: import("alepha/server").RoutePrimitive<{
-    body: import("typebox").TRecord<string, import("typebox").TAny>;
+    body: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>;
   }>;
 }
 /**

package/dist/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/mcp/errors/McpError.ts","../../src/mcp/interfaces/McpTypes.ts","../../src/mcp/helpers/jsonrpc.ts","../../src/mcp/primitives/$resource.ts","../../src/mcp/primitives/$tool.ts","../../src/mcp/providers/McpServerProvider.ts","../../src/mcp/primitives/$prompt.ts","../../src/mcp/transports/StreamableHttpMcpTransport.ts","../../src/mcp/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/mcp/errors/McpError.ts","../../src/mcp/interfaces/McpTypes.ts","../../src/mcp/helpers/jsonrpc.ts","../../src/mcp/primitives/$resource.ts","../../src/mcp/primitives/$tool.ts","../../src/mcp/providers/McpServerProvider.ts","../../src/mcp/primitives/$prompt.ts","../../src/mcp/transports/StreamableHttpMcpTransport.ts","../../src/mcp/index.ts"],"mappings":"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"}

package/dist/mcp/index.js

@@ -1,4 +1,4 @@
-import { $atom, $inject, $module, $state, Alepha, AlephaError, KIND, Primitive, TypeBoxError, createPrimitive, t } from "alepha";
+import { $atom, $inject, $module, $state, Alepha, AlephaError, KIND, Primitive, TypeBoxError, createPrimitive, z } from "alepha";
 import { $logger } from "alepha/logger";
 import { $route } from "alepha/server";
 //#region ../../src/mcp/helpers/jsonrpc.ts
@@ -354,6 +354,10 @@ var McpServerProvider = class {
 		if (!tool) throw new McpToolNotFoundError(name);
 		try {
 			const result = await tool.execute(args, context);
+			if (!tool.hasOutputSchema()) {
+				const raw = this.asRawToolContent(result);
+				if (raw) return raw;
+			}
 			const callResult = { content: [{
 				type: "text",
 				text: typeof result === "string" ? result : JSON.stringify(result ?? null)
@@ -385,6 +389,25 @@ var McpServerProvider = class {
 			};
 		}
 	}
+	/**
+	* Recognize a tool handler's return value as a pre-built MCP tool result —
+	* i.e. it already carries a `content` array of content blocks (text, image,
+	* audio, resource, resource_link). Returns the normalized
+	* {@link McpToolCallResult} when matched, or `undefined` to fall back to the
+	* default JSON/text encoding. Only ever consulted for tools that did NOT
+	* declare an output schema (see {@link handleToolCall}).
+	*/
+	asRawToolContent(result) {
+		if (!result || typeof result !== "object") return;
+		const candidate = result;
+		if (!Array.isArray(candidate.content) || candidate.content.length === 0) return;
+		if (!candidate.content.every((block) => !!block && typeof block === "object" && typeof block.type === "string")) return;
+		return {
+			content: candidate.content,
+			isError: typeof candidate.isError === "boolean" ? candidate.isError : void 0,
+			_meta: candidate._meta && typeof candidate._meta === "object" ? candidate._meta : void 0
+		};
+	}
 	handleResourcesList() {
 		return { resources: Array.from(this.resources.values()).map((r) => r.toDescriptor()) };
 	}
@@ -436,9 +459,9 @@ var McpServerProvider = class {
 * class Prompts {
 *   greeting = $prompt({
 *     description: "Generate a personalized greeting",
-*     args: t.object({
-*       name: t.text({ description: "Name of the person to greet" }),
-*       style: t.optional(t.enum(["formal", "casual"])),
+*     args: z.object({
+*       name: z.text({ description: "Name of the person to greet" }),
+*       style: z.enum(["formal", "casual"]).optional(),
 *     }),
 *     handler: async ({ args }) => [
 *       {
@@ -452,9 +475,9 @@ var McpServerProvider = class {
 *
 *   codeReview = $prompt({
 *     description: "Request a code review",
-*     args: t.object({
-*       code: t.text({ description: "The code to review" }),
-*       language: t.text({ description: "Programming language" }),
+*     args: z.object({
+*       code: z.text({ description: "The code to review" }),
+*       language: z.text({ description: "Programming language" }),
 *     }),
 *     handler: async ({ args }) => [
 *       {
@@ -520,11 +543,11 @@ var PromptPrimitive = class extends Primitive {
 	schemaToArguments(schema) {
 		const args = [];
 		for (const [name, propSchema] of Object.entries(schema.properties)) {
-			const prop = propSchema;
+			const prop = z.schema.unwrap(propSchema);
 			args.push({
 				name,
 				description: prop.description,
-				required: !t.schema.isOptional(propSchema)
+				required: !z.schema.isOptional(propSchema)
 			});
 		}
 		return args;
@@ -645,11 +668,11 @@ $resource[KIND] = ResourcePrimitive;
 *   add = $tool({
 *     description: "Add two numbers together",
 *     schema: {
-*       params: t.object({
-*         a: t.number(),
-*         b: t.number(),
+*       params: z.object({
+*         a: z.number(),
+*         b: z.number(),
 *       }),
-*       result: t.number(),
+*       result: z.number(),
 *     },
 *     handler: async ({ params }) => {
 *       return params.a + params.b;
@@ -659,10 +682,10 @@ $resource[KIND] = ResourcePrimitive;
 *   greet = $tool({
 *     description: "Generate a greeting message",
 *     schema: {
-*       params: t.object({
-*         name: t.text(),
+*       params: z.object({
+*         name: z.text(),
 *       }),
-*       result: t.text(),
+*       result: z.text(),
 *     },
 *     handler: async ({ params }) => {
 *       return `Hello, ${params.name}!`;
@@ -756,59 +779,31 @@ var ToolPrimitive = class extends Primitive {
 	* this is just the dialect declaration.
 	*/
 	schemaToJsonSchema(schema, options) {
-		const properties = {};
-		const required = [];
-		for (const [key, propSchema] of Object.entries(schema.properties)) {
-			properties[key] = this.propertyToJsonSchema(propSchema);
-			if (!t.schema.isOptional(propSchema)) required.push(key);
+		let json;
+		try {
+			json = z.toJSONSchema(schema);
+		} catch {
+			json = {
+				type: "object",
+				properties: {},
+				required: []
+			};
 		}
-		const result = {
-			type: "object",
-			properties,
-			required
-		};
-		if (options?.root !== false) result.$schema = "https://json-schema.org/draft/2020-12/schema";
-		return result;
+		if (options?.root === false) json.$schema = void 0;
+		else json.$schema = "https://json-schema.org/draft/2020-12/schema";
+		return json;
 	}
 	/**
-	* Convert a single property schema to JSON Schema format.
+	* Convert a single property schema to JSON Schema format (zod-native).
 	*/
 	propertyToJsonSchema(schema) {
-		const result = {};
-		if ("description" in schema) result.description = schema.description;
-		if (t.schema.isString(schema)) {
-			result.type = "string";
-			if ("minLength" in schema) result.minLength = schema.minLength;
-			if ("maxLength" in schema) result.maxLength = schema.maxLength;
-			if ("pattern" in schema) result.pattern = schema.pattern;
-			if ("enum" in schema) result.enum = schema.enum;
-		} else if (t.schema.isNumber(schema)) {
-			result.type = "number";
-			if ("minimum" in schema) result.minimum = schema.minimum;
-			if ("maximum" in schema) result.maximum = schema.maximum;
-		} else if (t.schema.isInteger(schema)) {
-			result.type = "integer";
-			if ("minimum" in schema) result.minimum = schema.minimum;
-			if ("maximum" in schema) result.maximum = schema.maximum;
-		} else if (t.schema.isBoolean(schema)) result.type = "boolean";
-		else if (t.schema.isArray(schema)) {
-			result.type = "array";
-			if ("items" in schema) result.items = this.propertyToJsonSchema(schema.items);
-		} else if (t.schema.isObject(schema)) Object.assign(result, this.schemaToJsonSchema(schema, { root: false }));
-		else if (t.schema.isUnsafe(schema) || t.schema.isOptional(schema)) {
-			const schemaAny = schema;
-			if (schemaAny.type === "string") {
-				result.type = "string";
-				if ("enum" in schema) result.enum = schema.enum;
-				if ("pattern" in schema) result.pattern = schema.pattern;
-			} else if (schemaAny.type === "number") result.type = "number";
-			else if (schemaAny.type === "integer") result.type = "integer";
-			else if (schemaAny.type === "boolean") result.type = "boolean";
-			else if (schemaAny.type === "array") result.type = "array";
-			else if (schemaAny.type === "object") result.type = "object";
-			else result.type = "string";
-		} else result.type = "string";
-		return result;
+		try {
+			const json = z.toJSONSchema(schema);
+			json.$schema = void 0;
+			return json;
+		} catch {
+			return { type: "string" };
+		}
 	}
 };
 $tool[KIND] = ToolPrimitive;
@@ -817,12 +812,12 @@ $tool[KIND] = ToolPrimitive;
 const mcpStreamableHttpOptions = $atom({
 	name: "alepha.mcp.streamableHttp.options",
 	description: "Configuration options for the MCP Streamable HTTP transport.",
-	schema: t.object({
+	schema: z.object({
 		/**
 		* Path for the MCP endpoint. Single endpoint for both requests and
 		* (optional) server-streamed responses, per spec 2025-03-26+.
 		*/
-		path: t.text({ default: "/mcp" }),
+		path: z.text({ default: "/mcp" }),
 		/**
 		* Allow-list of `Origin` header values accepted on incoming requests.
 		* Empty array (default) means "allow any". When set, browser-originated
@@ -833,7 +828,7 @@ const mcpStreamableHttpOptions = $atom({
 		*
 		* Spec 2025-11-25, PR #1439.
 		*/
-		allowedOrigins: t.array(t.text(), { default: [] }),
+		allowedOrigins: z.array(z.text()).default([]),
 		/**
 		* When true, an unauthenticated POST to the MCP endpoint is rejected
 		* with `401 Unauthorized` and an RFC 9728 `WWW-Authenticate` challenge
@@ -845,14 +840,14 @@ const mcpStreamableHttpOptions = $atom({
 		*
 		* @default false
 		*/
-		requireAuth: t.boolean({ default: false }),
+		requireAuth: z.boolean().default(false),
 		/**
 		* Path of the RFC 9728 protected-resource metadata document, advertised
 		* (as an absolute URL, resolved against the request origin) in the
 		* `WWW-Authenticate` challenge emitted when {@link requireAuth} rejects
 		* a request.
 		*/
-		resourceMetadataPath: t.text({ default: "/.well-known/oauth-protected-resource" })
+		resourceMetadataPath: z.text({ default: "/.well-known/oauth-protected-resource" })
 	}),
 	default: {
 		path: "/mcp",
@@ -930,7 +925,7 @@ var StreamableHttpMcpTransport = class {
 	message = $route({
 		method: "POST",
 		path: this.options.path,
-		schema: { body: t.json() },
+		schema: { body: z.json() },
 		handler: async (request) => {
 			try {
 				const originRaw = request.headers.origin;