@jsonstudio/rcc 0.89.1205 → 0.89.1348

package/docs/transformation-tables/claude-code-router-openai-to-textgenwebui.json

@@ -0,0 +1,295 @@
+{
+  "sourceProvider": "OpenAI",
+  "targetProvider": "Text Generation WebUI",
+  "description": "Transformation table for converting OpenAI API format to Text Generation WebUI compatible format",
+  "version": "1.0",
+  "endpointMappings": {
+    "chatCompletions": {
+      "sourceEndpoint": "/v1/chat/completions",
+      "targetEndpoint": "/v1/chat/completions",
+      "method": "POST"
+    },
+    "completions": {
+      "sourceEndpoint": "/v1/completions",
+      "targetEndpoint": "/v1/completions",
+      "method": "POST"
+    },
+    "models": {
+      "sourceEndpoint": "/v1/models",
+      "targetEndpoint": "/v1/models",
+      "method": "GET"
+    },
+    "embeddings": {
+      "sourceEndpoint": "/v1/embeddings",
+      "targetEndpoint": "/v1/embeddings",
+      "method": "POST"
+    }
+  },
+  "requestMappings": {
+    "model": {
+      "sourcePath": "model",
+      "targetPath": "model",
+      "transform": "directMapping",
+      "description": "Text Generation WebUI uses the same model parameter format"
+    },
+    "messages": {
+      "sourcePath": "messages",
+      "targetPath": "messages",
+      "transform": "directMapping",
+      "description": "Text Generation WebUI uses the same message structure"
+    },
+    "maxTokens": {
+      "sourcePath": "max_tokens",
+      "targetPath": "max_tokens",
+      "transform": "directMapping"
+    },
+    "temperature": {
+      "sourcePath": "temperature",
+      "targetPath": "temperature",
+      "transform": "directMapping"
+    },
+    "topP": {
+      "sourcePath": "top_p",
+      "targetPath": "top_p",
+      "transform": "directMapping"
+    },
+    "frequencyPenalty": {
+      "sourcePath": "frequency_penalty",
+      "targetPath": "frequency_penalty",
+      "transform": "directMapping"
+    },
+    "presencePenalty": {
+      "sourcePath": "presence_penalty",
+      "targetPath": "presence_penalty",
+      "transform": "directMapping"
+    },
+    "stop": {
+      "sourcePath": "stop",
+      "targetPath": "stop",
+      "transform": "directMapping"
+    },
+    "stream": {
+      "sourcePath": "stream",
+      "targetPath": "stream",
+      "transform": "directMapping"
+    },
+    "tools": {
+      "sourcePath": "tools",
+      "targetPath": "tools",
+      "transform": "directMapping",
+      "description": "Text Generation WebUI supports OpenAI-compatible tool calling"
+    },
+    "toolChoice": {
+      "sourcePath": "tool_choice",
+      "targetPath": "tool_choice",
+      "transform": "directMapping"
+    }
+  },
+  "responseMappings": {
+    "id": {
+      "sourcePath": "id",
+      "targetPath": "id",
+      "transform": "directMapping"
+    },
+    "object": {
+      "sourcePath": "object",
+      "targetPath": "object",
+      "transform": "directMapping"
+    },
+    "created": {
+      "sourcePath": "created",
+      "targetPath": "created",
+      "transform": "directMapping"
+    },
+    "model": {
+      "sourcePath": "model",
+      "targetPath": "model",
+      "transform": "directMapping"
+    },
+    "choices": {
+      "sourcePath": "choices",
+      "targetPath": "choices",
+      "transform": "directMapping"
+    },
+    "usage": {
+      "sourcePath": "usage",
+      "targetPath": "usage",
+      "transform": "directMapping"
+    }
+  },
+  "completionMappings": {
+    "prompt": {
+      "sourcePath": "prompt",
+      "targetPath": "prompt",
+      "transform": "directMapping"
+    },
+    "suffix": {
+      "sourcePath": "suffix",
+      "targetPath": "suffix",
+      "transform": "directMapping"
+    },
+    "bestOf": {
+      "sourcePath": "best_of",
+      "targetPath": "best_of",
+      "transform": "directMapping"
+    },
+    "echo": {
+      "sourcePath": "echo",
+      "targetPath": "echo",
+      "transform": "directMapping"
+    },
+    "logProbs": {
+      "sourcePath": "logprobs",
+      "targetPath": "logprobs",
+      "transform": "directMapping"
+    },
+    "logitBias": {
+      "sourcePath": "logit_bias",
+      "targetPath": "logit_bias",
+      "transform": "directMapping"
+    }
+  },
+  "embeddingMappings": {
+    "input": {
+      "sourcePath": "input",
+      "targetPath": "input",
+      "transform": "directMapping"
+    },
+    "model": {
+      "sourcePath": "model",
+      "targetPath": "model",
+      "transform": "directMapping"
+    },
+    "encodingFormat": {
+      "sourcePath": "encoding_format",
+      "targetPath": "encoding_format",
+      "transform": "directMapping"
+    },
+    "dimensions": {
+      "sourcePath": "dimensions",
+      "targetPath": "dimensions",
+      "transform": "directMapping"
+    }
+  },
+  "generationParameters": {
+    "doSample": {
+      "sourcePath": "do_sample",
+      "targetPath": "do_sample",
+      "transform": "directMapping"
+    },
+    "earlyStopping": {
+      "sourcePath": "early_stopping",
+      "targetPath": "early_stopping",
+      "transform": "directMapping"
+    },
+    "numBeams": {
+      "sourcePath": "num_beams",
+      "targetPath": "num_beams",
+      "transform": "directMapping"
+    },
+    "noRepeatNgramSize": {
+      "sourcePath": "no_repeat_ngram_size",
+      "targetPath": "no_repeat_ngram_size",
+      "transform": "directMapping"
+    },
+    "minLength": {
+      "sourcePath": "min_length",
+      "targetPath": "min_length",
+      "transform": "directMapping"
+    },
+    "repetitionPenalty": {
+      "sourcePath": "repetition_penalty",
+      "targetPath": "repetition_penalty",
+      "transform": "directMapping"
+    },
+    "lengthPenalty": {
+      "sourcePath": "length_penalty",
+      "targetPath": "length_penalty",
+      "transform": "directMapping"
+    },
+    "badWordsIds": {
+      "sourcePath": "bad_words_ids",
+      "targetPath": "bad_words_ids",
+      "transform": "directMapping"
+    },
+    "bosTokenId": {
+      "sourcePath": "bos_token_id",
+      "targetPath": "bos_token_id",
+      "transform": "directMapping"
+    },
+    "eosTokenId": {
+      "sourcePath": "eos_token_id",
+      "targetPath": "eos_token_id",
+      "transform": "directMapping"
+    },
+    "padTokenId": {
+      "sourcePath": "pad_token_id",
+      "targetPath": "pad_token_id",
+      "transform": "directMapping"
+    },
+    "decoderStartTokenId": {
+      "sourcePath": "decoder_start_token_id",
+      "targetPath": "decoder_start_token_id",
+      "transform": "directMapping"
+    }
+  },
+  "streamMappings": {
+    "chunkFormat": {
+      "sourceFormat": "data: {JSON}",
+      "targetFormat": "data: {JSON}",
+      "transform": "directMapping"
+    },
+    "eventTypes": {
+      "message_start": "message_start",
+      "message_delta": "message_delta",
+      "message_stop": "message_stop"
+    }
+  },
+  "authentication": {
+    "apiKey": {
+      "sourceHeader": "Authorization: Bearer {token}",
+      "targetHeader": "Authorization: Bearer {token}",
+      "transform": "directMapping"
+    }
+  },
+  "headers": {
+    "contentType": {
+      "sourceHeader": "Content-Type: application/json",
+      "targetHeader": "Content-Type: application/json",
+      "transform": "directMapping"
+    }
+  },
+  "errorMappings": {
+    "errorResponse": {
+      "sourceFormat": {
+        "error": {
+          "message": "string",
+          "type": "string",
+          "code": "string"
+        }
+      },
+      "targetFormat": {
+        "error": {
+          "message": "string",
+          "type": "string",
+          "code": "string"
+        }
+      },
+      "transform": "directMapping"
+    }
+  },
+  "specialFeatures": {
+    "multipleModels": {
+      "description": "Text Generation WebUI supports multiple model backends",
+      "handling": "Model selection handled through UI, API uses OpenAI format"
+    },
+    "extensions": {
+      "description": "Text Generation WebUI supports various extensions",
+      "handling": "Extensions provide additional features not in standard API"
+    },
+    "webInterface": {
+      "description": "Text Generation WebUI provides comprehensive web interface",
+      "handling": "Not relevant for API conversion"
+    }
+  }
+}

package/docs/transformation-tables/claude-code-router-provider-conversions.json

@@ -0,0 +1,193 @@
+{
+  "description": "Provider conversion reference table extracted from claude-code-router",
+  "version": "1.0",
+  "architecture": "agent-based",
+  "notes": "Shows how OpenAI-compatible requests are transformed to various provider formats",
+  "baseFormat": "OpenAI",
+  "providers": {
+    "openai": {
+      "name": "OpenAI",
+      "compatibility": "native",
+      "endpointMapping": {
+        "chat": "https://api.openai.com/v1/chat/completions",
+        "embeddings": "https://api.openai.com/v1/embeddings",
+        "models": "https://api.openai.com/v1/models"
+      },
+      "modelMapping": {
+        "direct": true,
+        "notes": "No model mapping needed - native OpenAI format"
+      },
+      "parameterMapping": {
+        "temperature": "temperature",
+        "max_tokens": "max_tokens",
+        "top_p": "top_p",
+        "frequency_penalty": "frequency_penalty",
+        "presence_penalty": "presence_penalty",
+        "stop": "stop",
+        "stream": "stream",
+        "tools": "tools",
+        "tool_choice": "tool_choice"
+      }
+    },
+    "anthropic": {
+      "name": "Anthropic Claude",
+      "compatibility": "transformed",
+      "endpointMapping": {
+        "chat": "https://api.anthropic.com/v1/messages",
+        "messages": "https://api.anthropic.com/v1/messages"
+      },
+      "modelMapping": {
+        "gpt-4o": "claude-3-5-sonnet-20241022",
+        "gpt-4o-mini": "claude-3-5-haiku-20241022",
+        "gpt-4-turbo": "claude-3-opus-20240229",
+        "gpt-4": "claude-3-sonnet-20240229",
+        "gpt-3.5-turbo": "claude-3-haiku-20240307"
+      },
+      "parameterMapping": {
+        "max_tokens": "max_tokens",
+        "temperature": "temperature",
+        "top_p": "top_p",
+        "stop": "stop_sequences",
+        "stream": "stream",
+        "tools": "tools",
+        "tool_choice": "tool_choice"
+      },
+      "differences": {
+        "messageStructure": "Uses content blocks instead of simple message array",
+        "toolFormat": "Uses tool_use/tool_result blocks instead of function calls",
+        "streaming": "Different event structure for streaming responses",
+        "usage": "Different usage reporting format"
+      }
+    },
+    "gemini": {
+      "name": "Google Gemini",
+      "compatibility": "transformed",
+      "endpointMapping": {
+        "chat": "https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent",
+        "stream": "https://generativelanguage.googleapis.com/v1beta/models/{model}:streamGenerateContent"
+      },
+      "modelMapping": {
+        "gpt-4o": "gemini-1.5-pro",
+        "gpt-4o-mini": "gemini-1.5-flash",
+        "gpt-4-turbo": "gemini-1.0-pro",
+        "gpt-4": "gemini-1.0-pro",
+        "gpt-3.5-turbo": "gemini-1.0-pro-latest"
+      },
+      "parameterMapping": {
+        "temperature": "generationConfig.temperature",
+        "max_tokens": "generationConfig.maxOutputTokens",
+        "top_p": "generationConfig.topP",
+        "top_k": "generationConfig.topK",
+        "stop": "generationConfig.stopSequences",
+        "stream": "stream",
+        "tools": "tools",
+        "tool_choice": "toolConfig"
+      },
+      "differences": {
+        "messageStructure": "Uses contents with parts array",
+        "roles": "Different role names (user/model/function)",
+        "toolFormat": "Uses functionCall/functionResponse parts",
+        "safety": "Built-in safety filtering with configurable thresholds",
+        "usage": "Usage metadata structure different"
+      }
+    },
+    "deepseek": {
+      "name": "DeepSeek",
+      "compatibility": "openai-compatible",
+      "endpointMapping": {
+        "chat": "https://api.deepseek.com/v1/chat/completions",
+        "models": "https://api.deepseek.com/v1/models"
+      },
+      "modelMapping": {
+        "gpt-4o": "deepseek-chat",
+        "gpt-4o-mini": "deepseek-chat",
+        "gpt-4-turbo": "deepseek-chat",
+        "gpt-4": "deepseek-chat",
+        "gpt-3.5-turbo": "deepseek-coder"
+      },
+      "parameterMapping": {
+        "temperature": "temperature",
+        "max_tokens": "max_tokens",
+        "top_p": "top_p",
+        "frequency_penalty": "frequency_penalty",
+        "presence_penalty": "presence_penalty",
+        "stop": "stop",
+        "stream": "stream",
+        "tools": "tools",
+        "tool_choice": "tool_choice"
+      },
+      "differences": {
+        "modelAvailability": "Limited model selection",
+        "features": "Some advanced features may not be supported",
+        "pricing": "Different pricing structure"
+      }
+    },
+    "openrouter": {
+      "name": "OpenRouter",
+      "compatibility": "openai-compatible",
+      "endpointMapping": {
+        "chat": "https://openrouter.ai/api/v1/chat/completions",
+        "models": "https://openrouter.ai/api/v1/models"
+      },
+      "modelMapping": {
+        "gpt-4o": "openai/gpt-4o",
+        "gpt-4o-mini": "openai/gpt-4o-mini",
+        "gpt-4-turbo": "openai/gpt-4-turbo",
+        "gpt-4": "openai/gpt-4",
+        "gpt-3.5-turbo": "openai/gpt-3.5-turbo"
+      },
+      "parameterMapping": {
+        "temperature": "temperature",
+        "max_tokens": "max_tokens",
+        "top_p": "top_p",
+        "frequency_penalty": "frequency_penalty",
+        "presence_penalty": "presence_penalty",
+        "stop": "stop",
+        "stream": "stream",
+        "tools": "tools",
+        "tool_choice": "tool_choice"
+      },
+      "differences": {
+        "routing": "Routes to multiple providers based on availability",
+        "models": "Access to multiple provider models through single API",
+        "pricing": "Unified pricing across providers",
+        "features": "Provider-specific feature support varies"
+      }
+    }
+  },
+  "commonTransformations": {
+    "authentication": {
+      "openai": "Bearer token in Authorization header",
+      "anthropic": "x-api-key header + anthropic-version",
+      "gemini": "API key as query parameter",
+      "deepseek": "Bearer token in Authorization header",
+      "openrouter": "Bearer token in Authorization header"
+    },
+    "errorHandling": {
+      "format": "Standardized error response format",
+      "codes": "HTTP status codes with provider-specific details",
+      "retry": "Exponential backoff for rate limits"
+    },
+    "streaming": {
+      "format": "Server-Sent Events (SSE)",
+      "chunking": "Different chunk structures per provider",
+      "encoding": "UTF-8 text encoding"
+    }
+  },
+  "usagePatterns": {
+    "tokenCounting": {
+      "openai": "Detailed token breakdown",
+      "anthropic": "Input/output token counts",
+      "gemini": "Prompt/candidate/total token counts",
+      "deepseek": "Similar to OpenAI format",
+      "openrouter": "Varies by underlying provider"
+    },
+    "rateLimiting": {
+      "openai": "Requests per minute + tokens per minute",
+      "anthropic": "Requests per minute + tokens per minute",
+      "gemini": "Requests per minute + tokens per minute",
+      "deepseek": "Requests per minute + tokens per minute",
+      "openrouter": "Varies by underlying provider"
+    }
+  }
+}