@defai.digital/contracts 13.0.3

package/dist/mcp/v1/runtime/response.js

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+// ============================================================================
+// MCP Error Codes
+// ============================================================================
+export const MCPErrorCodeSchema = z.enum([
+    // Validation errors
+    'INVALID_INPUT',
+    'MISSING_REQUIRED_FIELD',
+    'INVALID_FORMAT',
+    'ARRAY_TOO_LARGE',
+    'STRING_TOO_LONG',
+    'REQUEST_TOO_LARGE',
+    // Resource errors
+    'NOT_FOUND',
+    'ALREADY_EXISTS',
+    'CONFLICT',
+    // Operation errors
+    'OPERATION_FAILED',
+    'TOOL_TIMEOUT',
+    'RATE_LIMITED',
+    'MEMORY_PRESSURE',
+    // System errors
+    'INTERNAL_ERROR',
+    'NOT_IMPLEMENTED',
+    'SERVICE_UNAVAILABLE',
+]);
+// ============================================================================
+// Error Retryability Mapping
+// ============================================================================
+export const RETRYABLE_ERRORS = new Set([
+    'TOOL_TIMEOUT',
+    'RATE_LIMITED',
+    'MEMORY_PRESSURE',
+    'SERVICE_UNAVAILABLE',
+]);
+export function isRetryableError(code) {
+    return RETRYABLE_ERRORS.has(code);
+}
+// ============================================================================
+// Structured Error
+// ============================================================================
+export const MCPStructuredErrorSchema = z.object({
+    /** Error code for programmatic handling */
+    code: MCPErrorCodeSchema,
+    /** Human-readable message */
+    message: z.string().min(1).max(1000),
+    /** Additional context */
+    context: z.record(z.unknown()).optional(),
+    /** Whether the operation can be retried */
+    retryable: z.boolean().default(false),
+    /** Suggested retry delay in ms (if retryable) */
+    retryAfterMs: z.number().int().positive().optional(),
+});
+// ============================================================================
+// Response Metadata
+// ============================================================================
+export const MCPResponseMetadataSchema = z.object({
+    /** Operation duration in milliseconds */
+    durationMs: z.number().int().nonnegative(),
+    /** Whether result was served from cache */
+    cached: z.boolean().default(false),
+    /** Whether result was truncated due to size limits */
+    truncated: z.boolean().default(false),
+    /** Original size before truncation (if truncated) */
+    originalSizeBytes: z.number().int().positive().optional(),
+    /** Request ID for tracing */
+    requestId: z.string().uuid().optional(),
+});
+// ============================================================================
+// Standard Response Envelope
+// ============================================================================
+export const MCPSuccessResponseSchema = (dataSchema) => z.object({
+    success: z.literal(true),
+    data: dataSchema,
+    metadata: MCPResponseMetadataSchema.optional(),
+});
+export const MCPErrorResponseSchema = z.object({
+    success: z.literal(false),
+    error: MCPStructuredErrorSchema,
+    metadata: MCPResponseMetadataSchema.optional(),
+});
+// Generic response envelope factory
+export function createResponseEnvelopeSchema(dataSchema) {
+    return z.discriminatedUnion('success', [
+        MCPSuccessResponseSchema(dataSchema),
+        MCPErrorResponseSchema,
+    ]);
+}
+// ============================================================================
+// List Response (for paginated results)
+// ============================================================================
+export const MCPPaginationSchema = z.object({
+    /** Total count of all items */
+    total: z.number().int().nonnegative(),
+    /** Number of items requested */
+    limit: z.number().int().positive(),
+    /** Offset from start */
+    offset: z.number().int().nonnegative(),
+    /** Whether more items exist */
+    hasMore: z.boolean(),
+});
+export function createListResponseSchema(itemSchema) {
+    return z.object({
+        items: z.array(itemSchema),
+        pagination: MCPPaginationSchema,
+    });
+}
+// ============================================================================
+// Response Size Limits
+// ============================================================================
+export const MCPResponseLimitsSchema = z.object({
+    /** Maximum response size in bytes */
+    maxResponseBytes: z.number().int().positive().default(1_048_576), // 1MB
+    /** Maximum items in list responses */
+    maxListItems: z.number().int().positive().default(100),
+    /** Maximum string field length */
+    maxStringLength: z.number().int().positive().default(10_000),
+    /** Truncation indicator suffix */
+    truncationSuffix: z.string().default('... [truncated]'),
+});
+// ============================================================================
+// Default Response Limits
+// ============================================================================
+export const DEFAULT_RESPONSE_LIMITS = {
+    maxResponseBytes: 1_048_576, // 1MB
+    maxListItems: 100,
+    maxStringLength: 10_000,
+    truncationSuffix: '... [truncated]',
+};
+//# sourceMappingURL=response.js.map

package/dist/mcp/v1/runtime/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../../src/mcp/v1/runtime/response.ts"],"names":[],"mappings":"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"}

package/dist/mcp/v1/runtime/timeout.d.ts

@@ -0,0 +1,116 @@
+import { z } from 'zod';
+export declare const ToolCategorySchema: z.ZodEnum<["query", "mutation", "scan", "execution"]>;
+export type ToolCategory = z.infer<typeof ToolCategorySchema>;
+export declare const MCPTimeoutConfigSchema: z.ZodObject<{
+    /** Default timeout for all operations (ms) */
+    defaultTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    /** Timeout per tool category */
+    toolTimeouts: z.ZodDefault<z.ZodObject<{
+        /** Quick read operations */
+        query: z.ZodDefault<z.ZodNumber>;
+        /** Write operations */
+        mutation: z.ZodDefault<z.ZodNumber>;
+        /** Scan/analysis operations */
+        scan: z.ZodDefault<z.ZodNumber>;
+        /** Execution operations (agent/workflow) */
+        execution: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        query: number;
+        mutation: number;
+        scan: number;
+        execution: number;
+    }, {
+        query?: number | undefined;
+        mutation?: number | undefined;
+        scan?: number | undefined;
+        execution?: number | undefined;
+    }>>;
+    /** Per-tool overrides */
+    toolOverrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    defaultTimeoutMs: number;
+    toolTimeouts: {
+        query: number;
+        mutation: number;
+        scan: number;
+        execution: number;
+    };
+    toolOverrides: Record<string, number>;
+}, {
+    defaultTimeoutMs?: number | undefined;
+    toolTimeouts?: {
+        query?: number | undefined;
+        mutation?: number | undefined;
+        scan?: number | undefined;
+        execution?: number | undefined;
+    } | undefined;
+    toolOverrides?: Record<string, number> | undefined;
+}>;
+export type MCPTimeoutConfig = z.infer<typeof MCPTimeoutConfigSchema>;
+export declare const TimeoutResultSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+    status: z.ZodLiteral<"completed">;
+    result: z.ZodUnknown;
+    durationMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    status: "completed";
+    durationMs: number;
+    result?: unknown;
+}, {
+    status: "completed";
+    durationMs: number;
+    result?: unknown;
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"timeout">;
+    timeoutMs: z.ZodNumber;
+    partialResult: z.ZodOptional<z.ZodUnknown>;
+    durationMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    status: "timeout";
+    durationMs: number;
+    timeoutMs: number;
+    partialResult?: unknown;
+}, {
+    status: "timeout";
+    durationMs: number;
+    timeoutMs: number;
+    partialResult?: unknown;
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"error">;
+    error: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        stack: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        stack?: string | undefined;
+    }, {
+        code: string;
+        message: string;
+        stack?: string | undefined;
+    }>;
+    durationMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    status: "error";
+    durationMs: number;
+    error: {
+        code: string;
+        message: string;
+        stack?: string | undefined;
+    };
+}, {
+    status: "error";
+    durationMs: number;
+    error: {
+        code: string;
+        message: string;
+        stack?: string | undefined;
+    };
+}>]>;
+export type TimeoutResult = z.infer<typeof TimeoutResultSchema>;
+export declare const TOOL_CATEGORIES: Record<string, ToolCategory>;
+/**
+ * Get timeout for a specific tool
+ */
+export declare function getToolTimeout(toolName: string, config: MCPTimeoutConfig): number;
+//# sourceMappingURL=timeout.d.ts.map

package/dist/mcp/v1/runtime/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../../../src/mcp/v1/runtime/timeout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,kBAAkB,uDAK7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D,eAAO,MAAM,sBAAsB;IACjC,8CAA8C;;IAE9C,gCAAgC;;QAG5B,4BAA4B;;QAE5B,uBAAuB;;QAEvB,+BAA+B;;QAE/B,4CAA4C;;;;;;;;;;;;;IAIhD,yBAAyB;;;;;;;;;;;;;;;;;;;;EAEzB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqB9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAyCxD,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,GACvB,MAAM,CAcR"}

package/dist/mcp/v1/runtime/timeout.js

@@ -0,0 +1,116 @@
+import { z } from 'zod';
+// ============================================================================
+// Tool Categories
+// ============================================================================
+export const ToolCategorySchema = z.enum([
+    'query', // memory_retrieve, agent_get, session_status
+    'mutation', // memory_store, agent_register, session_create
+    'scan', // bugfix_scan, refactor_scan
+    'execution', // agent_run, workflow_run
+]);
+// ============================================================================
+// Timeout Configuration
+// ============================================================================
+export const MCPTimeoutConfigSchema = z.object({
+    /** Default timeout for all operations (ms) */
+    defaultTimeoutMs: z.number().int().positive().default(30_000),
+    /** Timeout per tool category */
+    toolTimeouts: z
+        .object({
+        /** Quick read operations */
+        query: z.number().int().positive().default(10_000), // 10 seconds
+        /** Write operations */
+        mutation: z.number().int().positive().default(30_000), // 30 seconds
+        /** Scan/analysis operations */
+        scan: z.number().int().positive().default(120_000), // 2 minutes
+        /** Execution operations (agent/workflow) */
+        execution: z.number().int().positive().default(1_200_000), // 20 minutes
+    })
+        .default({}),
+    /** Per-tool overrides */
+    toolOverrides: z.record(z.string(), z.number().int().positive()).default({}),
+});
+// ============================================================================
+// Timeout Result
+// ============================================================================
+export const TimeoutResultSchema = z.discriminatedUnion('status', [
+    z.object({
+        status: z.literal('completed'),
+        result: z.unknown(),
+        durationMs: z.number().int().nonnegative(),
+    }),
+    z.object({
+        status: z.literal('timeout'),
+        timeoutMs: z.number().int().positive(),
+        partialResult: z.unknown().optional(),
+        durationMs: z.number().int().nonnegative(),
+    }),
+    z.object({
+        status: z.literal('error'),
+        error: z.object({
+            code: z.string(),
+            message: z.string(),
+            stack: z.string().optional(),
+        }),
+        durationMs: z.number().int().nonnegative(),
+    }),
+]);
+// ============================================================================
+// Tool Category Mapping
+// ============================================================================
+export const TOOL_CATEGORIES = {
+    // Query tools
+    memory_retrieve: 'query',
+    memory_search: 'query',
+    memory_list: 'query',
+    agent_get: 'query',
+    agent_list: 'query',
+    session_status: 'query',
+    session_list: 'query',
+    trace_get: 'query',
+    trace_list: 'query',
+    config_get: 'query',
+    config_show: 'query',
+    ability_list: 'query',
+    guard_list: 'query',
+    review_list: 'query',
+    workflow_list: 'query',
+    workflow_describe: 'query',
+    // Mutation tools
+    memory_store: 'mutation',
+    memory_delete: 'mutation',
+    agent_register: 'mutation',
+    agent_remove: 'mutation',
+    session_create: 'mutation',
+    session_join: 'mutation',
+    session_leave: 'mutation',
+    session_complete: 'mutation',
+    session_fail: 'mutation',
+    config_set: 'mutation',
+    guard_apply: 'mutation',
+    // Scan tools
+    review_analyze: 'scan',
+    trace_analyze: 'scan',
+    guard_check: 'scan',
+    // Execution tools
+    agent_run: 'execution',
+    workflow_run: 'execution',
+    ability_inject: 'execution',
+};
+/**
+ * Get timeout for a specific tool
+ */
+export function getToolTimeout(toolName, config) {
+    // Check for tool-specific override first
+    if (config.toolOverrides[toolName] !== undefined) {
+        return config.toolOverrides[toolName];
+    }
+    // Get category and return category timeout
+    const category = TOOL_CATEGORIES[toolName];
+    if (category && config.toolTimeouts[category] !== undefined) {
+        return config.toolTimeouts[category];
+    }
+    // Fall back to default
+    return config.defaultTimeoutMs;
+}
+//# sourceMappingURL=timeout.js.map

package/dist/mcp/v1/runtime/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../../../src/mcp/v1/runtime/timeout.ts"],"names":[],"mappings":"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"}

package/dist/mcp/v1/schema.d.ts

@@ -0,0 +1,171 @@
+import { z } from 'zod';
+/**
+ * Standardized error code definition
+ */
+export declare const ErrorCodeSchema: z.ZodObject<{
+    code: z.ZodString;
+    description: z.ZodString;
+    retryable: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    description: string;
+    retryable: boolean;
+}, {
+    code: string;
+    description: string;
+    retryable?: boolean | undefined;
+}>;
+export type ErrorCode = z.infer<typeof ErrorCodeSchema>;
+/**
+ * Tool execution error
+ */
+export declare const ToolErrorSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    details?: Record<string, unknown> | undefined;
+}, {
+    code: string;
+    message: string;
+    details?: Record<string, unknown> | undefined;
+}>;
+export type ToolError = z.infer<typeof ToolErrorSchema>;
+/**
+ * Tool execution result
+ */
+export declare const ToolResultSchema: z.ZodDiscriminatedUnion<"success", [z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodUnknown;
+}, "strict", z.ZodTypeAny, {
+    success: true;
+    data?: unknown;
+}, {
+    success: true;
+    data?: unknown;
+}>, z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    error: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    };
+    success: false;
+}, {
+    error: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    };
+    success: false;
+}>]>;
+export type ToolResult = z.infer<typeof ToolResultSchema>;
+/**
+ * MCP Tool definition
+ */
+export declare const McpToolSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    errorCodes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        description: z.ZodString;
+        retryable: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        description: string;
+        retryable: boolean;
+    }, {
+        code: string;
+        description: string;
+        retryable?: boolean | undefined;
+    }>, "many">>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    inputSchema: Record<string, unknown>;
+    description: string;
+    outputSchema?: Record<string, unknown> | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    errorCodes?: {
+        code: string;
+        description: string;
+        retryable: boolean;
+    }[] | undefined;
+}, {
+    name: string;
+    inputSchema: Record<string, unknown>;
+    description: string;
+    outputSchema?: Record<string, unknown> | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    errorCodes?: {
+        code: string;
+        description: string;
+        retryable?: boolean | undefined;
+    }[] | undefined;
+}>;
+export type McpTool = z.infer<typeof McpToolSchema>;
+/**
+ * Tool invocation request
+ */
+export declare const ToolInvocationSchema: z.ZodObject<{
+    toolName: z.ZodString;
+    input: z.ZodUnknown;
+    requestId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    toolName: string;
+    input?: unknown;
+    requestId?: string | undefined;
+}, {
+    toolName: string;
+    input?: unknown;
+    requestId?: string | undefined;
+}>;
+export type ToolInvocation = z.infer<typeof ToolInvocationSchema>;
+/**
+ * Validates an MCP tool definition
+ */
+export declare function validateMcpTool(data: unknown): McpTool;
+/**
+ * Safely validates an MCP tool definition
+ */
+export declare function safeValidateMcpTool(data: unknown): z.SafeParseReturnType<unknown, McpTool>;
+/**
+ * Creates a success result
+ */
+export declare function createSuccessResult(data: unknown): ToolResult;
+/**
+ * Creates an error result
+ */
+export declare function createErrorResult(code: string, message: string, details?: Record<string, unknown>): ToolResult;
+/**
+ * Standard error codes that all tools should use
+ */
+export declare const StandardErrorCodes: {
+    readonly INVALID_INPUT: "INVALID_INPUT";
+    readonly RESOURCE_NOT_FOUND: "RESOURCE_NOT_FOUND";
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
+    readonly RATE_LIMITED: "RATE_LIMITED";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly NOT_IMPLEMENTED: "NOT_IMPLEMENTED";
+};
+export type StandardErrorCode = (typeof StandardErrorCodes)[keyof typeof StandardErrorCodes];
+//# sourceMappingURL=schema.d.ts.map

package/dist/mcp/v1/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/mcp/v1/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAa3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWxB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,GACZ,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAEzC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAE7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,UAAU,CAKZ;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;CAQrB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAC3B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/mcp/v1/schema.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+/**
+ * Standardized error code definition
+ */
+export const ErrorCodeSchema = z.object({
+    code: z.string().regex(/^[A-Z][A-Z0-9_]*$/),
+    description: z.string().max(256),
+    retryable: z.boolean().default(false),
+});
+/**
+ * Tool execution error
+ */
+export const ToolErrorSchema = z.object({
+    code: z.string().regex(/^[A-Z][A-Z0-9_]*$/),
+    message: z.string().max(512),
+    details: z.record(z.unknown()).optional(),
+});
+/**
+ * Tool execution result
+ */
+export const ToolResultSchema = z.discriminatedUnion('success', [
+    z
+        .object({
+        success: z.literal(true),
+        data: z.unknown(),
+    })
+        .strict(),
+    z
+        .object({
+        success: z.literal(false),
+        error: ToolErrorSchema,
+    })
+        .strict(),
+]);
+/**
+ * MCP Tool definition
+ */
+export const McpToolSchema = z.object({
+    name: z
+        .string()
+        .min(1)
+        .max(64)
+        .regex(/^[a-z][a-z0-9_]*$/),
+    description: z.string().min(1).max(1024),
+    inputSchema: z.record(z.unknown()),
+    outputSchema: z.record(z.unknown()).optional(),
+    errorCodes: z.array(ErrorCodeSchema).optional(),
+    metadata: z.record(z.unknown()).optional(),
+});
+/**
+ * Tool invocation request
+ */
+export const ToolInvocationSchema = z.object({
+    toolName: z.string().min(1),
+    input: z.unknown(),
+    requestId: z.string().uuid().optional(),
+});
+/**
+ * Validates an MCP tool definition
+ */
+export function validateMcpTool(data) {
+    return McpToolSchema.parse(data);
+}
+/**
+ * Safely validates an MCP tool definition
+ */
+export function safeValidateMcpTool(data) {
+    return McpToolSchema.safeParse(data);
+}
+/**
+ * Creates a success result
+ */
+export function createSuccessResult(data) {
+    return { success: true, data };
+}
+/**
+ * Creates an error result
+ */
+export function createErrorResult(code, message, details) {
+    return {
+        success: false,
+        error: { code, message, details },
+    };
+}
+/**
+ * Standard error codes that all tools should use
+ */
+export const StandardErrorCodes = {
+    INVALID_INPUT: 'INVALID_INPUT',
+    RESOURCE_NOT_FOUND: 'RESOURCE_NOT_FOUND',
+    PERMISSION_DENIED: 'PERMISSION_DENIED',
+    RATE_LIMITED: 'RATE_LIMITED',
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+    TIMEOUT: 'TIMEOUT',
+    NOT_IMPLEMENTED: 'NOT_IMPLEMENTED',
+};
+//# sourceMappingURL=schema.js.map

package/dist/mcp/v1/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/mcp/v1/schema.ts"],"names":[],"mappings":"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"}