@frontmcp/sdk 0.3.1 → 0.4.0

package/src/common/metadata/resource.metadata.d.ts

@@ -56,15 +56,15 @@ export declare const frontMcpResourceMetadataSchema: z.ZodObject<{
         src: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
         sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        src: z.ZodString;
-        mimeType: z.ZodOptional<z.ZodString>;
-        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        src: z.ZodString;
-        mimeType: z.ZodOptional<z.ZodString>;
-        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }, {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }>, "many">>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     name: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
@@ -75,15 +75,15 @@ export declare const frontMcpResourceMetadataSchema: z.ZodObject<{
         src: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
         sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        src: z.ZodString;
-        mimeType: z.ZodOptional<z.ZodString>;
-        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        src: z.ZodString;
-        mimeType: z.ZodOptional<z.ZodString>;
-        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }, {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }>, "many">>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     name: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
@@ -94,15 +94,15 @@ export declare const frontMcpResourceMetadataSchema: z.ZodObject<{
         src: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
         sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        src: z.ZodString;
-        mimeType: z.ZodOptional<z.ZodString>;
-        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        src: z.ZodString;
-        mimeType: z.ZodOptional<z.ZodString>;
-        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }, {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }>, "many">>;
 }, z.ZodTypeAny, "passthrough">>;
 /**
  * A template description for resources available on the server.
@@ -148,15 +148,15 @@ export declare const frontMcpResourceTemplateMetadataSchema: z.ZodObject<{
         src: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
         sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        src: z.ZodString;
-        mimeType: z.ZodOptional<z.ZodString>;
-        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        src: z.ZodString;
-        mimeType: z.ZodOptional<z.ZodString>;
-        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }, {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }>, "many">>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     name: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
@@ -167,15 +167,15 @@ export declare const frontMcpResourceTemplateMetadataSchema: z.ZodObject<{
         src: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
         sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        src: z.ZodString;
-        mimeType: z.ZodOptional<z.ZodString>;
-        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        src: z.ZodString;
-        mimeType: z.ZodOptional<z.ZodString>;
-        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }, {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }>, "many">>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     name: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
@@ -186,14 +186,14 @@ export declare const frontMcpResourceTemplateMetadataSchema: z.ZodObject<{
         src: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
         sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        src: z.ZodString;
-        mimeType: z.ZodOptional<z.ZodString>;
-        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        src: z.ZodString;
-        mimeType: z.ZodOptional<z.ZodString>;
-        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }, {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }>, "many">>;
 }, z.ZodTypeAny, "passthrough">>;
 export { ResourceMetadata, ResourceMetadata as FrontMcpResourceMetadata, ResourceTemplateMetadata, ResourceTemplateMetadata as FrontMcpResourceTemplateMetadata, };

package/src/common/metadata/tool.metadata.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z, ZodObject } from 'zod';
 import type { JSONSchema7 } from 'json-schema';
 declare global {
     /**
@@ -47,10 +47,192 @@ export interface ToolAnnotations {
      */
     openWorldHint?: boolean;
 }
+/**
+ * Tool response type text: include if outputSchema is zod primitive types
+ */
+type PrimitiveOutputType = 'string' | 'number' | 'date' | 'boolean' | z.ZodString | z.ZodNumber | z.ZodBoolean | z.ZodBigInt | z.ZodDate;
+/**
+ * Tool response type image, will use the ImageContentSchema from MCP types
+ */
+type ImageOutputType = 'image';
+export declare const ImageOutputSchema: z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    data: z.ZodEffects<z.ZodString, string, string>;
+    mimeType: z.ZodString;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "image";
+    data: string;
+    mimeType: string;
+    _meta?: Record<string, unknown> | undefined;
+}, {
+    type: "image";
+    data: string;
+    mimeType: string;
+    _meta?: Record<string, unknown> | undefined;
+}>;
+export type ImageOutput = z.output<typeof ImageOutputSchema>;
+/**
+ * Tool response type audio, will use the AudioContentSchema from MCP types
+ */
+type AudioOutputType = 'audio';
+export declare const AudioOutputSchema: z.ZodObject<{
+    type: z.ZodLiteral<"audio">;
+    data: z.ZodEffects<z.ZodString, string, string>;
+    mimeType: z.ZodString;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "audio";
+    data: string;
+    mimeType: string;
+    _meta?: Record<string, unknown> | undefined;
+}, {
+    type: "audio";
+    data: string;
+    mimeType: string;
+    _meta?: Record<string, unknown> | undefined;
+}>;
+export type AudioOutput = z.output<typeof AudioOutputSchema>;
+/**
+ * Tool response type resource, will use the EmbeddedResourceSchema from MCP types
+ */
+type ResourceOutputType = 'resource';
+export declare const ResourceOutputSchema: z.ZodObject<{
+    type: z.ZodLiteral<"resource">;
+    resource: z.ZodUnion<[z.ZodObject<z.objectUtil.extendShape<{
+        uri: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, {
+        text: z.ZodString;
+    }>, "strip", z.ZodTypeAny, {
+        uri: string;
+        text: string;
+        _meta?: Record<string, unknown> | undefined;
+        mimeType?: string | undefined;
+    }, {
+        uri: string;
+        text: string;
+        _meta?: Record<string, unknown> | undefined;
+        mimeType?: string | undefined;
+    }>, z.ZodObject<z.objectUtil.extendShape<{
+        uri: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, {
+        blob: z.ZodEffects<z.ZodString, string, string>;
+    }>, "strip", z.ZodTypeAny, {
+        uri: string;
+        blob: string;
+        _meta?: Record<string, unknown> | undefined;
+        mimeType?: string | undefined;
+    }, {
+        uri: string;
+        blob: string;
+        _meta?: Record<string, unknown> | undefined;
+        mimeType?: string | undefined;
+    }>]>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "resource";
+    resource: {
+        uri: string;
+        text: string;
+        _meta?: Record<string, unknown> | undefined;
+        mimeType?: string | undefined;
+    } | {
+        uri: string;
+        blob: string;
+        _meta?: Record<string, unknown> | undefined;
+        mimeType?: string | undefined;
+    };
+    _meta?: Record<string, unknown> | undefined;
+}, {
+    type: "resource";
+    resource: {
+        uri: string;
+        text: string;
+        _meta?: Record<string, unknown> | undefined;
+        mimeType?: string | undefined;
+    } | {
+        uri: string;
+        blob: string;
+        _meta?: Record<string, unknown> | undefined;
+        mimeType?: string | undefined;
+    };
+    _meta?: Record<string, unknown> | undefined;
+}>;
+export type ResourceOutput = z.output<typeof ResourceOutputSchema>;
+/**
+ * Tool response type resource_link, will use the ResourceLinkSchema from MCP types
+ */
+type ResourceLinkOutputType = 'resource_link';
+export declare const ResourceLinkOutputSchema: z.ZodObject<{
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+} & {
+    uri: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    _meta: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
+} & {
+    icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        src: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }, {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }>, "many">>;
+} & {
+    type: z.ZodLiteral<"resource_link">;
+}, "strip", z.ZodTypeAny, {
+    type: "resource_link";
+    name: string;
+    uri: string;
+    _meta?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+    mimeType?: string | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+    description?: string | undefined;
+}, {
+    type: "resource_link";
+    name: string;
+    uri: string;
+    _meta?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+    mimeType?: string | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+    description?: string | undefined;
+}>;
+export type ResourceLinkOutput = z.output<typeof ResourceLinkOutputSchema>;
+/**
+ * Tool response type json, ZodRawShape for fast usage
+ */
+type StructuredOutputType = z.ZodRawShape | z.ZodObject<any> | z.ZodArray<any> | z.ZodUnion<[ZodObject<any>, ...ZodObject<any>[]]> | z.ZodDiscriminatedUnion<any, any>;
+export type ToolSingleOutputType = PrimitiveOutputType | ImageOutputType | AudioOutputType | ResourceOutputType | ResourceLinkOutputType | StructuredOutputType;
+/**
+ * Default default tool schema is {}
+ */
+export type ToolOutputType = ToolSingleOutputType | ToolSingleOutputType[] | undefined;
+export type ToolInputType = z.ZodRawShape;
 /**
  * Declarative metadata describing what an McpTool contributes.
  */
-export interface ToolMetadata<In = z.ZodRawShape, Out = z.ZodRawShape> extends ExtendFrontMcpToolMetadata {
+export interface ToolMetadata<InSchema = ToolInputType, OutSchema extends ToolOutputType = ToolOutputType> extends ExtendFrontMcpToolMetadata {
     /**
      * Optional unique identifier for the tool.
      * If omitted, a consumer may derive an ID from the class or file name.
@@ -68,7 +250,7 @@ export interface ToolMetadata<In = z.ZodRawShape, Out = z.ZodRawShape> extends E
      * Zod schema describing the expected input payload for the tool.
      * Used for validation and for generating automatic docs/UX.
      */
-    inputSchema: In;
+    inputSchema: InSchema;
     /**
      * Zod schema describing the expected input payload for the tool.
      * Used for validation and for generating automatic docs/UX.
@@ -77,7 +259,7 @@ export interface ToolMetadata<In = z.ZodRawShape, Out = z.ZodRawShape> extends E
     /**
      * Zod schema describing the structure of the tool's successful output.
      */
-    outputSchema?: Out;
+    outputSchema?: OutSchema;
     /**
      * Optional list of tags/labels that categorize the tool for discovery and filtering.
      */
@@ -97,7 +279,7 @@ export declare const frontMcpToolMetadataSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     inputSchema: z.ZodType<Object, z.ZodTypeDef, Object>;
     rawInputSchema: z.ZodOptional<z.ZodAny>;
-    outputSchema: z.ZodOptional<z.ZodType<Object, z.ZodTypeDef, Object>>;
+    outputSchema: z.ZodOptional<z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodEnum<["string", "number", "date", "boolean"]>, z.ZodEnum<["image", "audio", "resource", "resource_link"]>]>, z.ZodType<z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodTypeDef, z.ZodType<unknown, z.ZodTypeDef, unknown>>, z.ZodRecord<z.ZodString, z.ZodType<z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodTypeDef, z.ZodType<unknown, z.ZodTypeDef, unknown>>>]>, z.ZodArray<z.ZodUnion<[z.ZodUnion<[z.ZodEnum<["string", "number", "date", "boolean"]>, z.ZodEnum<["image", "audio", "resource", "resource_link"]>]>, z.ZodType<z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodTypeDef, z.ZodType<unknown, z.ZodTypeDef, unknown>>, z.ZodRecord<z.ZodString, z.ZodType<z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodTypeDef, z.ZodType<unknown, z.ZodTypeDef, unknown>>>]>, "many">]>>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     annotations: z.ZodOptional<z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
@@ -125,7 +307,7 @@ export declare const frontMcpToolMetadataSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     inputSchema: z.ZodType<Object, z.ZodTypeDef, Object>;
     rawInputSchema: z.ZodOptional<z.ZodAny>;
-    outputSchema: z.ZodOptional<z.ZodType<Object, z.ZodTypeDef, Object>>;
+    outputSchema: z.ZodOptional<z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodEnum<["string", "number", "date", "boolean"]>, z.ZodEnum<["image", "audio", "resource", "resource_link"]>]>, z.ZodType<z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodTypeDef, z.ZodType<unknown, z.ZodTypeDef, unknown>>, z.ZodRecord<z.ZodString, z.ZodType<z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodTypeDef, z.ZodType<unknown, z.ZodTypeDef, unknown>>>]>, z.ZodArray<z.ZodUnion<[z.ZodUnion<[z.ZodEnum<["string", "number", "date", "boolean"]>, z.ZodEnum<["image", "audio", "resource", "resource_link"]>]>, z.ZodType<z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodTypeDef, z.ZodType<unknown, z.ZodTypeDef, unknown>>, z.ZodRecord<z.ZodString, z.ZodType<z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodTypeDef, z.ZodType<unknown, z.ZodTypeDef, unknown>>>]>, "many">]>>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     annotations: z.ZodOptional<z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
@@ -153,7 +335,7 @@ export declare const frontMcpToolMetadataSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     inputSchema: z.ZodType<Object, z.ZodTypeDef, Object>;
     rawInputSchema: z.ZodOptional<z.ZodAny>;
-    outputSchema: z.ZodOptional<z.ZodType<Object, z.ZodTypeDef, Object>>;
+    outputSchema: z.ZodOptional<z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodEnum<["string", "number", "date", "boolean"]>, z.ZodEnum<["image", "audio", "resource", "resource_link"]>]>, z.ZodType<z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodTypeDef, z.ZodType<unknown, z.ZodTypeDef, unknown>>, z.ZodRecord<z.ZodString, z.ZodType<z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodTypeDef, z.ZodType<unknown, z.ZodTypeDef, unknown>>>]>, z.ZodArray<z.ZodUnion<[z.ZodUnion<[z.ZodEnum<["string", "number", "date", "boolean"]>, z.ZodEnum<["image", "audio", "resource", "resource_link"]>]>, z.ZodType<z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodTypeDef, z.ZodType<unknown, z.ZodTypeDef, unknown>>, z.ZodRecord<z.ZodString, z.ZodType<z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodTypeDef, z.ZodType<unknown, z.ZodTypeDef, unknown>>>]>, "many">]>>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     annotations: z.ZodOptional<z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
@@ -176,3 +358,4 @@ export declare const frontMcpToolMetadataSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">>>;
     hideFromDiscovery: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.ZodTypeAny, "passthrough">>;
+export {};

package/src/common/metadata/tool.metadata.js

@@ -1,23 +1,58 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.frontMcpToolMetadataSchema = void 0;
+exports.frontMcpToolMetadataSchema = exports.ResourceLinkOutputSchema = exports.ResourceOutputSchema = exports.AudioOutputSchema = exports.ImageOutputSchema = void 0;
 const zod_1 = require("zod");
-const mcpToolAnnotationsSchema = zod_1.z.object({
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const mcpToolAnnotationsSchema = zod_1.z
+    .object({
     title: zod_1.z.string().optional(),
     readOnlyHint: zod_1.z.boolean().optional(),
     destructiveHint: zod_1.z.boolean().optional(),
     idempotentHint: zod_1.z.boolean().optional(),
     openWorldHint: zod_1.z.boolean().optional(),
-}).passthrough();
-exports.frontMcpToolMetadataSchema = zod_1.z.object({
+})
+    .passthrough();
+exports.ImageOutputSchema = types_js_1.ImageContentSchema;
+exports.AudioOutputSchema = types_js_1.AudioContentSchema;
+exports.ResourceOutputSchema = types_js_1.EmbeddedResourceSchema;
+exports.ResourceLinkOutputSchema = types_js_1.ResourceLinkSchema;
+/**
+ * Runtime schema for ToolSingleOutputType:
+ *  - literals ('string', 'image', ...)
+ *  - any Zod schema (ZodObject, ZodArray, etc.)
+ *  - raw shapes (Record<string, ZodTypeAny>)
+ */
+const primitiveOutputLiteralSchema = zod_1.z.enum(['string', 'number', 'date', 'boolean']);
+const specialOutputLiteralSchema = zod_1.z.enum(['image', 'audio', 'resource', 'resource_link']);
+const outputLiteralSchema = zod_1.z.union([
+    primitiveOutputLiteralSchema,
+    specialOutputLiteralSchema,
+]);
+// Any Zod schema instance (object, array, union, etc.)
+const zodSchemaInstanceSchema = zod_1.z.instanceof(zod_1.z.ZodType);
+// Raw shape: { field: z.string(), ... }
+const zodRawShapeSchema = zod_1.z.record(zodSchemaInstanceSchema);
+const toolSingleOutputSchema = zod_1.z.union([
+    outputLiteralSchema,
+    zodSchemaInstanceSchema,
+    zodRawShapeSchema,
+]);
+// ToolOutputType = ToolSingleOutputType | ToolSingleOutputType[]
+const toolOutputSchema = zod_1.z.union([
+    toolSingleOutputSchema,
+    zod_1.z.array(toolSingleOutputSchema),
+]);
+exports.frontMcpToolMetadataSchema = zod_1.z
+    .object({
     id: zod_1.z.string().optional(),
     name: zod_1.z.string().min(1),
     description: zod_1.z.string().optional(),
     inputSchema: zod_1.z.instanceof(Object),
     rawInputSchema: zod_1.z.any().optional(),
-    outputSchema: zod_1.z.instanceof(Object).optional(),
+    outputSchema: toolOutputSchema.optional(),
     tags: zod_1.z.array(zod_1.z.string().min(1)).optional(),
     annotations: mcpToolAnnotationsSchema.optional(),
     hideFromDiscovery: zod_1.z.boolean().optional().default(false),
-}).passthrough();
+})
+    .passthrough();
 //# sourceMappingURL=tool.metadata.js.map

package/src/common/metadata/tool.metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.metadata.js","sourceRoot":"","sources":["../../../../src/common/metadata/tool.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AAyDtB,MAAM,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,YAAY,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,eAAe,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACvC,cAAc,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACtC,aAAa,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACC,CAAC,CAAC,WAAW,EAAE,CAAC;AAwD3C,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC;IACjC,cAAc,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;IAC7C,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IAChD,iBAAiB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACO,CAAC,CAAC,WAAW,EAAE,CAAC","sourcesContent":["import {z} from 'zod';\nimport {RawZodShape} from '../types';\nimport type {JSONSchema7} from 'json-schema';\n\ndeclare global {\n  /**\n   * Declarative metadata extends to the an McpTool decorator.\n   */\n  interface ExtendFrontMcpToolMetadata {\n\n  }\n}\n\n\nexport interface ToolAnnotations {\n  [x: string]: unknown;\n\n  /**\n   * A human-readable title for the tool.\n   */\n  title?: string;\n  /**\n   * If true, the tool does not modify its environment.\n   *\n   * Default: false\n   */\n  readOnlyHint?: boolean;\n  /**\n   * If true, the tool may perform destructive updates to its environment.\n   * If false, the tool performs only additive updates.\n   *\n   * (This property is meaningful only when `readOnlyHint == false`)\n   *\n   * Default: true\n   */\n  destructiveHint?: boolean;\n  /**\n   * If true, calling the tool repeatedly with the same arguments\n   * will have no additional effect on the its environment.\n   *\n   * (This property is meaningful only when `readOnlyHint == false`)\n   *\n   * Default: false\n   */\n  idempotentHint?: boolean;\n  /**\n   * If true, this tool may interact with an \"open world\" of external\n   * entities. If false, the tool's domain of interaction is closed.\n   * For example, the world of a web search tool is open, whereas that\n   * of a memory tool is not.\n   *\n   * Default: true\n   */\n  openWorldHint?: boolean;\n}\n\n\nconst mcpToolAnnotationsSchema = z.object({\n  title: z.string().optional(),\n  readOnlyHint: z.boolean().optional(),\n  destructiveHint: z.boolean().optional(),\n  idempotentHint: z.boolean().optional(),\n  openWorldHint: z.boolean().optional(),\n} satisfies RawZodShape<ToolAnnotations>).passthrough();\n\n\n/**\n * Declarative metadata describing what an McpTool contributes.\n */\nexport interface ToolMetadata<In = z.ZodRawShape, Out = z.ZodRawShape> extends ExtendFrontMcpToolMetadata {\n  /**\n   * Optional unique identifier for the tool.\n   * If omitted, a consumer may derive an ID from the class or file name.\n   */\n  id?: string;\n\n  /**\n   * Human‑readable name of the tool, used in UIs, logs, and discovery.\n   */\n  name: string;\n\n  /**\n   * Short summary describing what the tool does and when to use it.\n   */\n  description?: string;\n\n  /**\n   * Zod schema describing the expected input payload for the tool.\n   * Used for validation and for generating automatic docs/UX.\n   */\n  inputSchema: In;\n  /**\n   * Zod schema describing the expected input payload for the tool.\n   * Used for validation and for generating automatic docs/UX.\n   */\n  rawInputSchema?: JSONSchema7;\n\n  /**\n   * Zod schema describing the structure of the tool's successful output.\n   */\n  outputSchema?: Out;\n\n  /**\n   * Optional list of tags/labels that categorize the tool for discovery and filtering.\n   */\n  tags?: string[];\n\n  annotations?: ToolAnnotations;\n\n  /**\n   * If true, the tool will not be shown in the tool/list action results.\n   * this method can still be called directly with tool/call even if hidden.\n   * use case: tools that are intended to be private or internal. (usually for testing / private apis)\n   * Default: false\n   */\n  hideFromDiscovery?: boolean;\n}\n\n\nexport const frontMcpToolMetadataSchema = z.object({\n  id: z.string().optional(),\n  name: z.string().min(1),\n  description: z.string().optional(),\n  inputSchema: z.instanceof(Object),\n  rawInputSchema: z.any().optional(),\n  outputSchema: z.instanceof(Object).optional(),\n  tags: z.array(z.string().min(1)).optional(),\n  annotations: mcpToolAnnotationsSchema.optional(),\n  hideFromDiscovery: z.boolean().optional().default(false),\n} satisfies RawZodShape<ToolMetadata, ExtendFrontMcpToolMetadata>).passthrough();\n"]}
+{"version":3,"file":"tool.metadata.js","sourceRoot":"","sources":["../../../../src/common/metadata/tool.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAmC;AAGnC,iEAK4C;AAmD5C,MAAM,wBAAwB,GAAG,OAAC;KAC/B,MAAM,CAAC;IACN,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,YAAY,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,eAAe,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACvC,cAAc,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACtC,aAAa,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACC,CAAC;KACxC,WAAW,EAAE,CAAC;AAmBJ,QAAA,iBAAiB,GAAG,6BAAkB,CAAC;AAOvC,QAAA,iBAAiB,GAAG,6BAAkB,CAAC;AAOvC,QAAA,oBAAoB,GAAG,iCAAsB,CAAC;AAO9C,QAAA,wBAAwB,GAAG,6BAAkB,CAAC;AAkF3D;;;;;GAKG;AAEH,MAAM,4BAA4B,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AACrF,MAAM,0BAA0B,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC;AAE3F,MAAM,mBAAmB,GAAG,OAAC,CAAC,KAAK,CAAC;IAClC,4BAA4B;IAC5B,0BAA0B;CAC3B,CAAC,CAAC;AAEH,uDAAuD;AACvD,MAAM,uBAAuB,GAAG,OAAC,CAAC,UAAU,CAAC,OAAC,CAAC,OAAO,CAAC,CAAC;AAExD,wCAAwC;AACxC,MAAM,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAE5D,MAAM,sBAAsB,GAAG,OAAC,CAAC,KAAK,CAAC;IACrC,mBAAmB;IACnB,uBAAuB;IACvB,iBAAiB;CAClB,CAAC,CAAC;AAEH,iEAAiE;AACjE,MAAM,gBAAgB,GAAG,OAAC,CAAC,KAAK,CAAC;IAC/B,sBAAsB;IACtB,OAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;CAChC,CAAC,CAAC;AACU,QAAA,0BAA0B,GAAG,OAAC;KACxC,MAAM,CAAC;IACN,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC;IACjC,cAAc,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACzC,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IAChD,iBAAiB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACO,CAAC;KACjE,WAAW,EAAE,CAAC","sourcesContent":["import { z, ZodObject } from 'zod';\nimport { RawZodShape } from '../types';\nimport type { JSONSchema7 } from 'json-schema';\nimport {\n  ImageContentSchema,\n  AudioContentSchema,\n  ResourceLinkSchema,\n  EmbeddedResourceSchema,\n} from '@modelcontextprotocol/sdk/types.js';\n\ndeclare global {\n  /**\n   * Declarative metadata extends to the an McpTool decorator.\n   */\n  interface ExtendFrontMcpToolMetadata {}\n}\n\nexport interface ToolAnnotations {\n  [x: string]: unknown;\n\n  /**\n   * A human-readable title for the tool.\n   */\n  title?: string;\n  /**\n   * If true, the tool does not modify its environment.\n   *\n   * Default: false\n   */\n  readOnlyHint?: boolean;\n  /**\n   * If true, the tool may perform destructive updates to its environment.\n   * If false, the tool performs only additive updates.\n   *\n   * (This property is meaningful only when `readOnlyHint == false`)\n   *\n   * Default: true\n   */\n  destructiveHint?: boolean;\n  /**\n   * If true, calling the tool repeatedly with the same arguments\n   * will have no additional effect on the its environment.\n   *\n   * (This property is meaningful only when `readOnlyHint == false`)\n   *\n   * Default: false\n   */\n  idempotentHint?: boolean;\n  /**\n   * If true, this tool may interact with an \"open world\" of external\n   * entities. If false, the tool's domain of interaction is closed.\n   * For example, the world of a web search tool is open, whereas that\n   * of a memory tool is not.\n   *\n   * Default: true\n   */\n  openWorldHint?: boolean;\n}\n\nconst mcpToolAnnotationsSchema = z\n  .object({\n    title: z.string().optional(),\n    readOnlyHint: z.boolean().optional(),\n    destructiveHint: z.boolean().optional(),\n    idempotentHint: z.boolean().optional(),\n    openWorldHint: z.boolean().optional(),\n  } satisfies RawZodShape<ToolAnnotations>)\n  .passthrough();\n\n/**\n * Tool response type text: include if outputSchema is zod primitive types\n */\ntype PrimitiveOutputType =\n  | 'string'\n  | 'number'\n  | 'date'\n  | 'boolean'\n  | z.ZodString\n  | z.ZodNumber\n  | z.ZodBoolean\n  | z.ZodBigInt\n  | z.ZodDate;\n/**\n * Tool response type image, will use the ImageContentSchema from MCP types\n */\ntype ImageOutputType = 'image';\nexport const ImageOutputSchema = ImageContentSchema;\nexport type ImageOutput = z.output<typeof ImageOutputSchema>;\n\n/**\n * Tool response type audio, will use the AudioContentSchema from MCP types\n */\ntype AudioOutputType = 'audio';\nexport const AudioOutputSchema = AudioContentSchema;\nexport type AudioOutput = z.output<typeof AudioOutputSchema>;\n\n/**\n * Tool response type resource, will use the EmbeddedResourceSchema from MCP types\n */\ntype ResourceOutputType = 'resource';\nexport const ResourceOutputSchema = EmbeddedResourceSchema;\nexport type ResourceOutput = z.output<typeof ResourceOutputSchema>;\n\n/**\n * Tool response type resource_link, will use the ResourceLinkSchema from MCP types\n */\ntype ResourceLinkOutputType = 'resource_link';\nexport const ResourceLinkOutputSchema = ResourceLinkSchema;\nexport type ResourceLinkOutput = z.output<typeof ResourceLinkOutputSchema>;\n\n/**\n * Tool response type json, ZodRawShape for fast usage\n */\ntype StructuredOutputType =\n  | z.ZodRawShape\n  | z.ZodObject<any>\n  | z.ZodArray<any>\n  | z.ZodUnion<[ZodObject<any>, ...ZodObject<any>[]]>\n  | z.ZodDiscriminatedUnion<any, any>;\n\nexport type ToolSingleOutputType =\n  | PrimitiveOutputType\n  | ImageOutputType\n  | AudioOutputType\n  | ResourceOutputType\n  | ResourceLinkOutputType\n  | StructuredOutputType;\n\n/**\n * Default default tool schema is {}\n */\nexport type ToolOutputType = ToolSingleOutputType | ToolSingleOutputType[] | undefined;\nexport type ToolInputType = z.ZodRawShape;\n\n/**\n * Declarative metadata describing what an McpTool contributes.\n */\nexport interface ToolMetadata<InSchema = ToolInputType, OutSchema extends ToolOutputType = ToolOutputType>\n  extends ExtendFrontMcpToolMetadata {\n  /**\n   * Optional unique identifier for the tool.\n   * If omitted, a consumer may derive an ID from the class or file name.\n   */\n  id?: string;\n\n  /**\n   * Human‑readable name of the tool, used in UIs, logs, and discovery.\n   */\n  name: string;\n\n  /**\n   * Short summary describing what the tool does and when to use it.\n   */\n  description?: string;\n\n  /**\n   * Zod schema describing the expected input payload for the tool.\n   * Used for validation and for generating automatic docs/UX.\n   */\n  inputSchema: InSchema;\n  /**\n   * Zod schema describing the expected input payload for the tool.\n   * Used for validation and for generating automatic docs/UX.\n   */\n  rawInputSchema?: JSONSchema7;\n\n  /**\n   * Zod schema describing the structure of the tool's successful output.\n   */\n  outputSchema?: OutSchema;\n\n  /**\n   * Optional list of tags/labels that categorize the tool for discovery and filtering.\n   */\n  tags?: string[];\n\n  annotations?: ToolAnnotations;\n\n  /**\n   * If true, the tool will not be shown in the tool/list action results.\n   * this method can still be called directly with tool/call even if hidden.\n   * use case: tools that are intended to be private or internal. (usually for testing / private apis)\n   * Default: false\n   */\n  hideFromDiscovery?: boolean;\n}\n\n\n\n/**\n * Runtime schema for ToolSingleOutputType:\n *  - literals ('string', 'image', ...)\n *  - any Zod schema (ZodObject, ZodArray, etc.)\n *  - raw shapes (Record<string, ZodTypeAny>)\n */\n\nconst primitiveOutputLiteralSchema = z.enum(['string', 'number', 'date', 'boolean']);\nconst specialOutputLiteralSchema = z.enum(['image', 'audio', 'resource', 'resource_link']);\n\nconst outputLiteralSchema = z.union([\n  primitiveOutputLiteralSchema,\n  specialOutputLiteralSchema,\n]);\n\n// Any Zod schema instance (object, array, union, etc.)\nconst zodSchemaInstanceSchema = z.instanceof(z.ZodType);\n\n// Raw shape: { field: z.string(), ... }\nconst zodRawShapeSchema = z.record(zodSchemaInstanceSchema);\n\nconst toolSingleOutputSchema = z.union([\n  outputLiteralSchema,\n  zodSchemaInstanceSchema,\n  zodRawShapeSchema,\n]);\n\n// ToolOutputType = ToolSingleOutputType | ToolSingleOutputType[]\nconst toolOutputSchema = z.union([\n  toolSingleOutputSchema,\n  z.array(toolSingleOutputSchema),\n]);\nexport const frontMcpToolMetadataSchema = z\n  .object({\n    id: z.string().optional(),\n    name: z.string().min(1),\n    description: z.string().optional(),\n    inputSchema: z.instanceof(Object),\n    rawInputSchema: z.any().optional(),\n    outputSchema: toolOutputSchema.optional(),\n    tags: z.array(z.string().min(1)).optional(),\n    annotations: mcpToolAnnotationsSchema.optional(),\n    hideFromDiscovery: z.boolean().optional().default(false),\n  } satisfies RawZodShape<ToolMetadata, ExtendFrontMcpToolMetadata>)\n  .passthrough();\n"]}