@dexto/server 1.6.19 → 1.6.21

package/dist/hono/routes/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/hono/routes/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,KAAK,UAAU,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAsDrE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAkFrD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/hono/routes/tools.ts"],"names":[],"mappings":"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"}

package/dist/hono/routes/tools.js

@@ -1,15 +1,10 @@
 import { OpenAPIHono, createRoute, z } from "@hono/zod-openapi";
-const JsonSchemaProperty = z.object({
-  type: z.enum(["string", "number", "integer", "boolean", "object", "array"]).optional().describe("Property type"),
-  description: z.string().optional().describe("Property description"),
-  enum: z.array(z.union([z.string(), z.number(), z.boolean()])).optional().describe("Enum values"),
-  default: z.any().optional().describe("Default value")
-}).passthrough().describe("JSON Schema property definition");
-const ToolInputSchema = z.object({
-  type: z.literal("object").optional().describe('Schema type, always "object" when present'),
-  properties: z.record(JsonSchemaProperty).optional().describe("Property definitions"),
-  required: z.array(z.string()).optional().describe("Required property names")
-}).passthrough().describe("JSON Schema for tool input parameters");
+import {
+  InternalErrorResponse,
+  JsonObjectSchema,
+  JsonValueSchema,
+  ToolInputSchema
+} from "../schemas/responses.js";
 const ToolInfoSchema = z.object({
   id: z.string().describe("Tool identifier"),
   name: z.string().describe("Tool name"),
@@ -17,7 +12,7 @@ const ToolInfoSchema = z.object({
   source: z.enum(["local", "mcp"]).describe("Source of the tool (local or mcp)"),
   serverName: z.string().optional().describe("MCP server name (if source is mcp)"),
   inputSchema: ToolInputSchema.optional().describe("JSON Schema for tool input parameters"),
-  _meta: z.record(z.unknown()).optional().describe("Optional tool metadata (e.g., MCP Apps UI resource info)")
+  _meta: z.record(z.string(), JsonValueSchema).optional().describe("Optional tool metadata (e.g., MCP Apps UI resource info)")
 }).strict().describe("Tool information");
 const AllToolsResponseSchema = z.object({
   tools: z.array(ToolInfoSchema).describe("Array of all available tools"),
@@ -25,21 +20,22 @@ const AllToolsResponseSchema = z.object({
   localCount: z.number().describe("Number of local tools"),
   mcpCount: z.number().describe("Number of MCP tools")
 }).strict().describe("All available tools from all sources");
+const allToolsRoute = createRoute({
+  method: "get",
+  path: "/tools",
+  summary: "List All Tools",
+  description: "Retrieves all available tools from all sources (local and MCP)",
+  tags: ["tools"],
+  responses: {
+    200: {
+      description: "All tools",
+      content: { "application/json": { schema: AllToolsResponseSchema } }
+    },
+    500: InternalErrorResponse
+  }
+});
 function createToolsRouter(getAgent) {
   const app = new OpenAPIHono();
-  const allToolsRoute = createRoute({
-    method: "get",
-    path: "/tools",
-    summary: "List All Tools",
-    description: "Retrieves all available tools from all sources (local and MCP)",
-    tags: ["tools"],
-    responses: {
-      200: {
-        description: "All tools",
-        content: { "application/json": { schema: AllToolsResponseSchema } }
-      }
-    }
-  });
   return app.openapi(allToolsRoute, async (ctx) => {
     const agent = await getAgent(ctx);
     const allTools = await agent.getAllTools();
@@ -65,14 +61,15 @@ function createToolsRouter(getAgent) {
         source = "local";
         localCount++;
       }
+      const metadataResult = JsonObjectSchema.safeParse(toolInfo._meta);
       toolList.push({
         id: toolName,
         name: toolName,
         description: toolInfo.description || "No description available",
         source,
         serverName,
-        inputSchema: toolInfo.parameters,
-        _meta: toolInfo._meta
+        inputSchema: toolInfo.parameters === void 0 ? void 0 : ToolInputSchema.parse(toolInfo.parameters),
+        _meta: metadataResult.success ? metadataResult.data : void 0
       });
     }
     toolList.sort((a, b) => {
@@ -82,12 +79,15 @@ function createToolsRouter(getAgent) {
       }
       return a.name.localeCompare(b.name);
     });
-    return ctx.json({
-      tools: toolList,
-      totalCount: toolList.length,
-      localCount,
-      mcpCount
-    });
+    return ctx.json(
+      {
+        tools: toolList,
+        totalCount: toolList.length,
+        localCount,
+        mcpCount
+      },
+      200
+    );
   });
 }
 export {

package/dist/hono/routes/webhooks.cjs

@@ -22,11 +22,13 @@ __export(webhooks_exports, {
 });
 module.exports = __toCommonJS(webhooks_exports);
 var import_zod_openapi = require("@hono/zod-openapi");
+var import_core = require("@dexto/core");
+var import_responses = require("../schemas/responses.js");
 const WebhookResponseSchema = import_zod_openapi.z.object({
   id: import_zod_openapi.z.string().describe("Unique webhook identifier"),
   url: import_zod_openapi.z.string().url().describe("Webhook URL"),
   description: import_zod_openapi.z.string().optional().describe("Webhook description"),
-  createdAt: import_zod_openapi.z.union([import_zod_openapi.z.date(), import_zod_openapi.z.number()]).describe("Creation timestamp (Date or Unix ms)")
+  createdAt: import_zod_openapi.z.string().datetime().describe("Creation timestamp (ISO 8601)")
 }).strict().describe("Webhook response object");
 const WebhookTestResultSchema = import_zod_openapi.z.object({
   success: import_zod_openapi.z.boolean().describe("Whether the webhook test succeeded"),
@@ -39,113 +41,129 @@ const WebhookBodySchema = import_zod_openapi.z.object({
   secret: import_zod_openapi.z.string().optional().describe("A secret key for HMAC signature verification"),
   description: import_zod_openapi.z.string().optional().describe("A description of the webhook for reference")
 }).describe("Request body for registering a webhook");
-function createWebhooksRouter(getAgent, webhookSubscriber) {
-  const app = new import_zod_openapi.OpenAPIHono();
-  const registerRoute = (0, import_zod_openapi.createRoute)({
-    method: "post",
-    path: "/webhooks",
-    summary: "Register Webhook",
-    description: "Registers a new webhook endpoint to receive agent events",
-    tags: ["webhooks"],
-    request: { body: { content: { "application/json": { schema: WebhookBodySchema } } } },
-    responses: {
-      201: {
-        description: "Webhook registered",
-        content: {
-          "application/json": {
-            schema: import_zod_openapi.z.object({
-              webhook: WebhookResponseSchema.describe(
-                "Registered webhook details"
-              )
-            }).strict()
-          }
+const registerRoute = (0, import_zod_openapi.createRoute)({
+  method: "post",
+  path: "/webhooks",
+  summary: "Register Webhook",
+  description: "Registers a new webhook endpoint to receive agent events",
+  tags: ["webhooks"],
+  request: { body: { content: { "application/json": { schema: WebhookBodySchema } } } },
+  responses: {
+    201: {
+      description: "Webhook registered",
+      content: {
+        "application/json": {
+          schema: import_zod_openapi.z.object({
+            webhook: WebhookResponseSchema.describe("Registered webhook details")
+          }).strict()
         }
       }
-    }
-  });
-  const listRoute = (0, import_zod_openapi.createRoute)({
-    method: "get",
-    path: "/webhooks",
-    summary: "List Webhooks",
-    description: "Retrieves a list of all registered webhooks",
-    tags: ["webhooks"],
-    responses: {
-      200: {
-        description: "List webhooks",
-        content: {
-          "application/json": {
-            schema: import_zod_openapi.z.object({
-              webhooks: import_zod_openapi.z.array(WebhookResponseSchema).describe("Array of registered webhooks")
-            }).strict()
-          }
+    },
+    400: import_responses.BadRequestErrorResponse,
+    500: import_responses.InternalErrorResponse
+  }
+});
+const listRoute = (0, import_zod_openapi.createRoute)({
+  method: "get",
+  path: "/webhooks",
+  summary: "List Webhooks",
+  description: "Retrieves a list of all registered webhooks",
+  tags: ["webhooks"],
+  responses: {
+    200: {
+      description: "List webhooks",
+      content: {
+        "application/json": {
+          schema: import_zod_openapi.z.object({
+            webhooks: import_zod_openapi.z.array(WebhookResponseSchema).describe("Array of registered webhooks")
+          }).strict()
         }
       }
-    }
-  });
-  const getRoute = (0, import_zod_openapi.createRoute)({
-    method: "get",
-    path: "/webhooks/{webhookId}",
-    summary: "Get Webhook Details",
-    description: "Fetches details for a specific webhook",
-    tags: ["webhooks"],
-    request: { params: import_zod_openapi.z.object({ webhookId: import_zod_openapi.z.string().describe("The webhook identifier") }) },
-    responses: {
-      200: {
-        description: "Webhook",
-        content: {
-          "application/json": {
-            schema: import_zod_openapi.z.object({
-              webhook: WebhookResponseSchema.describe("Webhook details")
-            }).strict()
-          }
+    },
+    500: import_responses.InternalErrorResponse
+  }
+});
+const getRoute = (0, import_zod_openapi.createRoute)({
+  method: "get",
+  path: "/webhooks/{webhookId}",
+  summary: "Get Webhook Details",
+  description: "Fetches details for a specific webhook",
+  tags: ["webhooks"],
+  request: { params: import_zod_openapi.z.object({ webhookId: import_zod_openapi.z.string().describe("The webhook identifier") }) },
+  responses: {
+    200: {
+      description: "Webhook",
+      content: {
+        "application/json": {
+          schema: import_zod_openapi.z.object({
+            webhook: WebhookResponseSchema.describe("Webhook details")
+          }).strict()
         }
-      },
-      404: { description: "Not found" }
+      }
+    },
+    404: {
+      description: "Not found",
+      content: { "application/json": { schema: import_responses.ApiErrorResponseSchema } }
     }
-  });
-  const deleteRoute = (0, import_zod_openapi.createRoute)({
-    method: "delete",
-    path: "/webhooks/{webhookId}",
-    summary: "Delete Webhook",
-    description: "Permanently removes a webhook endpoint. This action cannot be undone",
-    tags: ["webhooks"],
-    request: { params: import_zod_openapi.z.object({ webhookId: import_zod_openapi.z.string().describe("The webhook identifier") }) },
-    responses: {
-      200: {
-        description: "Removed",
-        content: {
-          "application/json": {
-            schema: import_zod_openapi.z.object({
-              status: import_zod_openapi.z.literal("removed").describe("Operation status indicating successful removal"),
-              webhookId: import_zod_openapi.z.string().describe("ID of the removed webhook")
-            }).strict()
-          }
+  }
+});
+const deleteRoute = (0, import_zod_openapi.createRoute)({
+  method: "delete",
+  path: "/webhooks/{webhookId}",
+  summary: "Delete Webhook",
+  description: "Permanently removes a webhook endpoint. This action cannot be undone",
+  tags: ["webhooks"],
+  request: { params: import_zod_openapi.z.object({ webhookId: import_zod_openapi.z.string().describe("The webhook identifier") }) },
+  responses: {
+    200: {
+      description: "Removed",
+      content: {
+        "application/json": {
+          schema: import_zod_openapi.z.object({
+            status: import_zod_openapi.z.literal("removed").describe("Operation status indicating successful removal"),
+            webhookId: import_zod_openapi.z.string().describe("ID of the removed webhook")
+          }).strict()
         }
-      },
-      404: { description: "Not found" }
+      }
+    },
+    404: {
+      description: "Not found",
+      content: { "application/json": { schema: import_responses.ApiErrorResponseSchema } }
     }
-  });
-  const testRoute = (0, import_zod_openapi.createRoute)({
-    method: "post",
-    path: "/webhooks/{webhookId}/test",
-    summary: "Test Webhook",
-    description: "Sends a sample event to test webhook connectivity and configuration",
-    tags: ["webhooks"],
-    request: { params: import_zod_openapi.z.object({ webhookId: import_zod_openapi.z.string().describe("The webhook identifier") }) },
-    responses: {
-      200: {
-        description: "Test result",
-        content: {
-          "application/json": {
-            schema: import_zod_openapi.z.object({
-              test: import_zod_openapi.z.literal("completed").describe("Test status indicating completion"),
-              result: WebhookTestResultSchema.describe("Test execution results")
-            }).strict()
-          }
+  }
+});
+const testRoute = (0, import_zod_openapi.createRoute)({
+  method: "post",
+  path: "/webhooks/{webhookId}/test",
+  summary: "Test Webhook",
+  description: "Sends a sample event to test webhook connectivity and configuration",
+  tags: ["webhooks"],
+  request: { params: import_zod_openapi.z.object({ webhookId: import_zod_openapi.z.string().describe("The webhook identifier") }) },
+  responses: {
+    200: {
+      description: "Test result",
+      content: {
+        "application/json": {
+          schema: import_zod_openapi.z.object({
+            test: import_zod_openapi.z.literal("completed").describe("Test status indicating completion"),
+            result: WebhookTestResultSchema.describe("Test execution results")
+          }).strict()
         }
-      },
-      404: { description: "Not found" }
+      }
+    },
+    404: {
+      description: "Not found",
+      content: { "application/json": { schema: import_responses.ApiErrorResponseSchema } }
     }
+  }
+});
+function createWebhooksRouter(getAgent, webhookSubscriber) {
+  const app = new import_zod_openapi.OpenAPIHono();
+  const serializeWebhook = (webhook) => ({
+    id: webhook.id,
+    url: webhook.url,
+    description: webhook.description,
+    createdAt: webhook.createdAt.toISOString()
   });
   return app.openapi(registerRoute, async (ctx) => {
     const agent = await getAgent(ctx);
@@ -162,64 +180,73 @@ function createWebhooksRouter(getAgent, webhookSubscriber) {
     agent.logger.info(`Webhook registered: ${webhookId} -> ${url}`);
     return ctx.json(
       {
-        webhook: {
-          id: webhook.id,
-          url: webhook.url,
-          description: webhook.description,
-          createdAt: webhook.createdAt
-        }
+        webhook: serializeWebhook(webhook)
       },
       201
     );
   }).openapi(listRoute, async (ctx) => {
-    const webhooks = webhookSubscriber.getWebhooks().map((webhook) => ({
-      id: webhook.id,
-      url: webhook.url,
-      description: webhook.description,
-      createdAt: webhook.createdAt
-    }));
-    return ctx.json({ webhooks });
+    const webhooks = webhookSubscriber.getWebhooks().map(serializeWebhook);
+    return ctx.json({ webhooks }, 200);
   }).openapi(getRoute, (ctx) => {
     const { webhookId } = ctx.req.valid("param");
     const webhook = webhookSubscriber.getWebhook(webhookId);
     if (!webhook) {
-      return ctx.json({ error: "Webhook not found" }, 404);
+      throw new import_core.DextoRuntimeError(
+        "webhook_not_found",
+        "webhook",
+        import_core.ErrorType.NOT_FOUND,
+        "Webhook not found",
+        { webhookId }
+      );
     }
-    return ctx.json({
-      webhook: {
-        id: webhook.id,
-        url: webhook.url,
-        description: webhook.description,
-        createdAt: webhook.createdAt
-      }
-    });
+    return ctx.json(
+      {
+        webhook: serializeWebhook(webhook)
+      },
+      200
+    );
   }).openapi(deleteRoute, async (ctx) => {
     const agent = await getAgent(ctx);
     const { webhookId } = ctx.req.valid("param");
     const removed = webhookSubscriber.removeWebhook(webhookId);
     if (!removed) {
-      return ctx.json({ error: "Webhook not found" }, 404);
+      throw new import_core.DextoRuntimeError(
+        "webhook_not_found",
+        "webhook",
+        import_core.ErrorType.NOT_FOUND,
+        "Webhook not found",
+        { webhookId }
+      );
     }
     agent.logger.info(`Webhook removed: ${webhookId}`);
-    return ctx.json({ status: "removed", webhookId });
+    return ctx.json({ status: "removed", webhookId }, 200);
   }).openapi(testRoute, async (ctx) => {
     const agent = await getAgent(ctx);
     const { webhookId } = ctx.req.valid("param");
     const webhook = webhookSubscriber.getWebhook(webhookId);
     if (!webhook) {
-      return ctx.json({ error: "Webhook not found" }, 404);
+      throw new import_core.DextoRuntimeError(
+        "webhook_not_found",
+        "webhook",
+        import_core.ErrorType.NOT_FOUND,
+        "Webhook not found",
+        { webhookId }
+      );
     }
     agent.logger.info(`Testing webhook: ${webhookId}`);
     const result = await webhookSubscriber.testWebhook(webhookId);
-    return ctx.json({
-      test: "completed",
-      result: {
-        success: result.success,
-        statusCode: result.statusCode,
-        responseTime: result.responseTime,
-        error: result.error
-      }
-    });
+    return ctx.json(
+      {
+        test: "completed",
+        result: {
+          success: result.success,
+          statusCode: result.statusCode,
+          responseTime: result.responseTime,
+          error: result.error
+        }
+      },
+      200
+    );
   });
 }
 // Annotate the CommonJS export names for ESM import in node: