@vfarcic/dot-ai 1.0.3 → 1.1.0

package/dist/interfaces/schemas/sessions.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Sessions Endpoint Schemas
+ *
+ * Schemas for the /api/v1/sessions/:sessionId endpoint.
+ * PRD #354: REST API Route Registry with Auto-Generated OpenAPI and Test Fixtures
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionRetrievalErrorSchema = exports.SessionNotFoundErrorSchema = exports.SessionResponseSchema = exports.SessionResponseDataSchema = exports.SessionDataSchema = exports.SessionMetadataSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("./common");
+/**
+ * Session metadata
+ */
+exports.SessionMetadataSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Session ID'),
+    createdAt: zod_1.z.string().describe('Session creation timestamp'),
+    expiresAt: zod_1.z.string().optional().describe('Session expiration timestamp'),
+});
+/**
+ * Generic session data
+ * Sessions can contain different data based on the tool that created them
+ */
+exports.SessionDataSchema = zod_1.z.object({
+    toolName: zod_1.z.string().optional().describe('Tool that created this session'),
+    intent: zod_1.z.string().optional().describe('User intent for this session'),
+    // Additional fields vary by tool type
+}).passthrough(); // Allow additional properties
+/**
+ * Session response data
+ * GET /api/v1/sessions/:sessionId
+ */
+exports.SessionResponseDataSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Session ID'),
+    data: exports.SessionDataSchema.describe('Session data'),
+    createdAt: zod_1.z.string().optional().describe('Session creation timestamp'),
+    expiresAt: zod_1.z.string().optional().describe('Session expiration timestamp'),
+});
+exports.SessionResponseSchema = (0, common_1.createSuccessResponseSchema)(exports.SessionResponseDataSchema);
+/**
+ * Session endpoint error schemas
+ */
+exports.SessionNotFoundErrorSchema = common_1.NotFoundErrorSchema.extend({
+    error: zod_1.z.object({
+        code: zod_1.z.literal('SESSION_NOT_FOUND'),
+        message: zod_1.z.string(),
+        details: zod_1.z.any().optional(),
+    }),
+});
+exports.SessionRetrievalErrorSchema = common_1.InternalServerErrorSchema.extend({
+    error: zod_1.z.object({
+        code: zod_1.z.literal('SESSION_RETRIEVAL_ERROR'),
+        message: zod_1.z.string(),
+        details: zod_1.z.any().optional(),
+    }),
+});

package/dist/interfaces/schemas/tools.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Tool Discovery and Execution Schemas
+ *
+ * Schemas for the /api/v1/tools and /api/v1/tools/:toolName endpoints.
+ * PRD #354: REST API Route Registry with Auto-Generated OpenAPI and Test Fixtures
+ */
+import { z } from 'zod';
+/**
+ * Tool parameter schema
+ */
+export declare const ToolParameterSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+    description: z.ZodString;
+    required: z.ZodBoolean;
+    default: z.ZodOptional<z.ZodAny>;
+    enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ToolParameter = z.infer<typeof ToolParameterSchema>;
+/**
+ * Tool information schema
+ * Matches ToolInfo from rest-registry.ts
+ */
+export declare const ToolInfoSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    category: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        description: z.ZodString;
+        required: z.ZodBoolean;
+        default: z.ZodOptional<z.ZodAny>;
+        enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+export type ToolInfo = z.infer<typeof ToolInfoSchema>;
+/**
+ * Tool discovery response data
+ */
+export declare const ToolDiscoveryDataSchema: z.ZodObject<{
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        category: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+            default: z.ZodOptional<z.ZodAny>;
+            enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ToolDiscoveryData = z.infer<typeof ToolDiscoveryDataSchema>;
+/**
+ * Tool discovery response schema
+ * GET /api/v1/tools
+ */
+export declare const ToolDiscoveryResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        tools: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            category: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodString;
+                description: z.ZodString;
+                required: z.ZodBoolean;
+                default: z.ZodOptional<z.ZodAny>;
+                enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>>;
+            inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.core.$strip>>;
+        total: z.ZodNumber;
+        categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    error: z.ZodOptional<z.ZodUndefined>;
+    meta: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ToolDiscoveryResponse = z.infer<typeof ToolDiscoveryResponseSchema>;
+/**
+ * Tool execution result data
+ */
+export declare const ToolExecutionDataSchema: z.ZodObject<{
+    result: z.ZodAny;
+    tool: z.ZodString;
+    executionTime: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ToolExecutionData = z.infer<typeof ToolExecutionDataSchema>;
+/**
+ * Tool execution response schema
+ * POST /api/v1/tools/:toolName
+ */
+export declare const ToolExecutionResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        result: z.ZodAny;
+        tool: z.ZodString;
+        executionTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    error: z.ZodOptional<z.ZodUndefined>;
+    meta: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ToolExecutionResponse = z.infer<typeof ToolExecutionResponseSchema>;
+/**
+ * Tool not found error
+ */
+export declare const ToolNotFoundErrorSchema: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    data: z.ZodOptional<z.ZodUndefined>;
+    meta: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+    error: z.ZodObject<{
+        code: z.ZodLiteral<"TOOL_NOT_FOUND">;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Invalid tool request error
+ */
+export declare const InvalidToolRequestErrorSchema: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    data: z.ZodOptional<z.ZodUndefined>;
+    meta: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+    error: z.ZodObject<{
+        code: z.ZodLiteral<"INVALID_REQUEST">;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Tool execution error
+ */
+export declare const ToolExecutionErrorSchema: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    data: z.ZodOptional<z.ZodUndefined>;
+    meta: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+    error: z.ZodObject<{
+        code: z.ZodLiteral<"EXECUTION_ERROR">;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Tool discovery error
+ */
+export declare const ToolDiscoveryErrorSchema: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    data: z.ZodOptional<z.ZodUndefined>;
+    meta: z.ZodOptional<z.ZodObject<{
+        timestamp: z.ZodString;
+        requestId: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+    error: z.ZodObject<{
+        code: z.ZodLiteral<"DISCOVERY_ERROR">;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/interfaces/schemas/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/interfaces/schemas/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;iBAO9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;iBAOzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;iBAKlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAuD,CAAC;AAEhG,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;iBAAuD,CAAC;AAEhG,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;iBAMlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;iBAMxC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;iBAMnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;iBAMnC,CAAC"}

package/dist/interfaces/schemas/tools.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Tool Discovery and Execution Schemas
+ *
+ * Schemas for the /api/v1/tools and /api/v1/tools/:toolName endpoints.
+ * PRD #354: REST API Route Registry with Auto-Generated OpenAPI and Test Fixtures
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolDiscoveryErrorSchema = exports.ToolExecutionErrorSchema = exports.InvalidToolRequestErrorSchema = exports.ToolNotFoundErrorSchema = exports.ToolExecutionResponseSchema = exports.ToolExecutionDataSchema = exports.ToolDiscoveryResponseSchema = exports.ToolDiscoveryDataSchema = exports.ToolInfoSchema = exports.ToolParameterSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("./common");
+/**
+ * Tool parameter schema
+ */
+exports.ToolParameterSchema = zod_1.z.object({
+    name: zod_1.z.string().describe('Parameter name'),
+    type: zod_1.z.string().describe('Parameter type (string, number, boolean, object, array)'),
+    description: zod_1.z.string().describe('Parameter description'),
+    required: zod_1.z.boolean().describe('Whether the parameter is required'),
+    default: zod_1.z.any().optional().describe('Default value if not provided'),
+    enum: zod_1.z.array(zod_1.z.string()).optional().describe('Allowed values for enum parameters'),
+});
+/**
+ * Tool information schema
+ * Matches ToolInfo from rest-registry.ts
+ */
+exports.ToolInfoSchema = zod_1.z.object({
+    name: zod_1.z.string().describe('Tool name/identifier'),
+    description: zod_1.z.string().describe('Tool description'),
+    category: zod_1.z.string().optional().describe('Tool category for grouping'),
+    tags: zod_1.z.array(zod_1.z.string()).optional().describe('Tags for filtering'),
+    parameters: zod_1.z.array(exports.ToolParameterSchema).optional().describe('Tool parameters'),
+    inputSchema: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe('JSON Schema for tool input'),
+});
+/**
+ * Tool discovery response data
+ */
+exports.ToolDiscoveryDataSchema = zod_1.z.object({
+    tools: zod_1.z.array(exports.ToolInfoSchema).describe('List of available tools'),
+    total: zod_1.z.number().describe('Total number of tools'),
+    categories: zod_1.z.array(zod_1.z.string()).optional().describe('Available categories'),
+    tags: zod_1.z.array(zod_1.z.string()).optional().describe('Available tags'),
+});
+/**
+ * Tool discovery response schema
+ * GET /api/v1/tools
+ */
+exports.ToolDiscoveryResponseSchema = (0, common_1.createSuccessResponseSchema)(exports.ToolDiscoveryDataSchema);
+/**
+ * Tool execution result data
+ */
+exports.ToolExecutionDataSchema = zod_1.z.object({
+    result: zod_1.z.any().describe('Tool execution result'),
+    tool: zod_1.z.string().describe('Name of the executed tool'),
+    executionTime: zod_1.z.number().optional().describe('Execution time in milliseconds'),
+});
+/**
+ * Tool execution response schema
+ * POST /api/v1/tools/:toolName
+ */
+exports.ToolExecutionResponseSchema = (0, common_1.createSuccessResponseSchema)(exports.ToolExecutionDataSchema);
+/**
+ * Tool not found error
+ */
+exports.ToolNotFoundErrorSchema = common_1.NotFoundErrorSchema.extend({
+    error: zod_1.z.object({
+        code: zod_1.z.literal('TOOL_NOT_FOUND'),
+        message: zod_1.z.string(),
+        details: zod_1.z.any().optional(),
+    }),
+});
+/**
+ * Invalid tool request error
+ */
+exports.InvalidToolRequestErrorSchema = common_1.BadRequestErrorSchema.extend({
+    error: zod_1.z.object({
+        code: zod_1.z.literal('INVALID_REQUEST'),
+        message: zod_1.z.string(),
+        details: zod_1.z.any().optional(),
+    }),
+});
+/**
+ * Tool execution error
+ */
+exports.ToolExecutionErrorSchema = common_1.InternalServerErrorSchema.extend({
+    error: zod_1.z.object({
+        code: zod_1.z.literal('EXECUTION_ERROR'),
+        message: zod_1.z.string(),
+        details: zod_1.z.any().optional(),
+    }),
+});
+/**
+ * Tool discovery error
+ */
+exports.ToolDiscoveryErrorSchema = common_1.InternalServerErrorSchema.extend({
+    error: zod_1.z.object({
+        code: zod_1.z.literal('DISCOVERY_ERROR'),
+        message: zod_1.z.string(),
+        details: zod_1.z.any().optional(),
+    }),
+});