@autonomaai/api-schemas 1.0.0

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@autonomaai/api-schemas",
+  "version": "1.0.0",
+  "description": "Unified API schemas and OpenAPI specifications for autonoma services",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "lint": "echo 'lint skipped'",
+    "test": "echo 'tests skipped'"
+  },
+  "keywords": [
+    "openapi",
+    "api-schema",
+    "typescript",
+    "trading",
+    "mcp",
+    "standardization"
+  ],
+  "author": "autonoma Team",
+  "license": "MIT",
+  "dependencies": {
+    "ajv": "^8.12.0",
+    "ajv-formats": "^2.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.2.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=4.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "src/**/*", 
+    "openapi.yaml",
+    "docs/**/*",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/autonoma/autonoma"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+} 

package/src/global.d.ts

@@ -0,0 +1,12 @@
+// Global type declarations for Node.js environment
+declare namespace NodeJS {
+  interface ProcessEnv {
+    [key: string]: string | undefined;
+  }
+
+  interface Process {
+    env: ProcessEnv;
+  }
+}
+
+declare const process: NodeJS.Process;

package/src/index.ts

@@ -0,0 +1,159 @@
+/**
+ * autonoma API Schemas
+ * 
+ * Unified API schemas and validation utilities for all autonoma services.
+ * 
+ * This package normalizes API contracts across:
+ * - Hummingbot MCP Server  
+ * - Backend API
+ * - Market Maker Agent
+ * - Data Collector
+ * - RAG Service
+ */
+
+// Export validation utilities
+export * from './validators';
+
+// Export schema migration helpers
+export {
+  migrateLegacyExecuteSignal,
+  convertToLegacyFormat,
+  createValidationMiddleware,
+  generatePythonValidator
+} from './validators';
+
+// Export validation result types
+export type {
+  ValidationResult,
+  ValidationError
+} from './validators';
+
+// Export validation functions
+export {
+  validateSuccessResponse,
+  validateErrorResponse,
+  validateCreateControllerRequest,
+  validateController,
+  validateTradingSignal,
+  validateExecuteSignalRequest
+} from './validators';
+
+// Version and metadata
+export const API_SCHEMA_VERSION = '1.0.0';
+export const SUPPORTED_FORMATS = ['openapi-3.0.3', 'json-schema-draft-07'];
+
+// Schema format constants
+export const SCHEMAS = {
+  OPENAPI_SPEC: 'openapi.yaml',
+  JSON_SCHEMAS: 'schemas/',
+  GENERATED_TYPES: 'generated-types.ts'
+} as const;
+
+// Endpoint normalization mappings
+export const ENDPOINT_MIGRATIONS = {
+  LEGACY_EXECUTE_SIGNAL: '/trading/execute-signal',
+  LEGACY_CONTROLLER_SIGNAL: '/trading/{controller_id}/signal',
+  UNIFIED_EXECUTE_SIGNAL: '/trading/signals/execute'
+} as const;
+
+// Common error codes
+export const ERROR_CODES = {
+  VALIDATION_FAILED: 'VALIDATION_FAILED',
+  CONTROLLER_NOT_FOUND: 'CONTROLLER_NOT_FOUND',
+  INVALID_SIGNAL: 'INVALID_SIGNAL',
+  EXCHANGE_ERROR: 'EXCHANGE_ERROR',
+  UNAUTHORIZED: 'UNAUTHORIZED',
+  RATE_LIMITED: 'RATE_LIMITED',
+  INTERNAL_ERROR: 'INTERNAL_ERROR'
+} as const;
+
+// Standard HTTP status codes
+export const HTTP_STATUS = {
+  OK: 200,
+  CREATED: 201,
+  BAD_REQUEST: 400,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  NOT_FOUND: 404,
+  CONFLICT: 409,
+  RATE_LIMITED: 429,
+  INTERNAL_ERROR: 500,
+  SERVICE_UNAVAILABLE: 503
+} as const;
+
+/**
+ * Create a standardized success response
+ */
+export function createSuccessResponse<T = any>(
+  message: string,
+  data?: T,
+  additionalFields?: Record<string, any>
+) {
+  return {
+    success: true,
+    message,
+    timestamp: new Date().toISOString(),
+    ...(data !== undefined && { data }),
+    ...additionalFields
+  };
+}
+
+/**
+ * Create a standardized error response
+ */
+export function createErrorResponse(
+  error: string,
+  detail?: string,
+  errorCode?: string,
+  additionalFields?: Record<string, any>
+) {
+  return {
+    success: false,
+    error,
+    ...(detail && { detail }),
+    ...(errorCode && { error_code: errorCode }),
+    timestamp: new Date().toISOString(),
+    ...additionalFields
+  };
+}
+
+/**
+ * Check if a response follows the standardized format
+ */
+export function isStandardizedResponse(response: any): boolean {
+  return (
+    typeof response === 'object' &&
+    response !== null &&
+    typeof response.success === 'boolean' &&
+    typeof response.timestamp === 'string'
+  );
+}
+
+/**
+ * Normalize a legacy response to the standardized format
+ */
+export function normalizeLegacyResponse(response: any): any {
+  // Already standardized
+  if (isStandardizedResponse(response)) {
+    return response;
+  }
+
+  // Handle common legacy patterns
+  if (response.status === 'success' || response.success === true) {
+    return createSuccessResponse(
+      response.message || 'Operation completed successfully',
+      response.data || response.result || response
+    );
+  }
+
+  if (response.status === 'error' || response.error) {
+    return createErrorResponse(
+      response.error || response.message || 'Operation failed',
+      response.detail || response.description,
+      response.error_code || response.code
+    );
+  }
+
+  // Default: treat as successful data response
+  return createSuccessResponse('Operation completed successfully', response);
+}