@jsonstudio/rcc 0.89.1205 → 0.89.1348

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

@@ -0,0 +1,208 @@
+{
+  "sourceProvider": "Anthropic",
+  "targetProvider": "OpenAI",
+  "description": "Reference transformation table extracted from claude-code-router agent-based system",
+  "version": "1.0",
+  "architecture": "agent-based",
+  "notes": "Based on analysis of AnthropicTransformer in claude-code-router",
+  "requestMappings": {
+    "model": {
+      "sourcePath": "model",
+      "targetPath": "model",
+      "transform": "modelMapping",
+      "mapping": {
+        "claude-3-5-sonnet-20241022": "gpt-4o",
+        "claude-3-5-haiku-20241022": "gpt-4o-mini",
+        "claude-3-opus-20240229": "gpt-4-turbo",
+        "claude-3-sonnet-20240229": "gpt-4-turbo",
+        "claude-3-haiku-20240307": "gpt-4-turbo"
+      }
+    },
+    "messages": {
+      "sourcePath": "messages",
+      "targetPath": "messages",
+      "transform": "messageStructureConversion",
+      "conversionRules": {
+        "system": {
+          "targetRole": "system",
+          "contentPath": "content"
+        },
+        "user": {
+          "targetRole": "user",
+          "contentPath": "content"
+        },
+        "assistant": {
+          "targetRole": "assistant",
+          "contentPath": "content"
+        }
+      }
+    },
+    "maxTokens": {
+      "sourcePath": "max_tokens",
+      "targetPath": "max_tokens",
+      "transform": "directMapping"
+    },
+    "temperature": {
+      "sourcePath": "temperature",
+      "targetPath": "temperature",
+      "transform": "directMapping"
+    },
+    "stopSequences": {
+      "sourcePath": "stop_sequences",
+      "targetPath": "stop",
+      "transform": "arrayMapping"
+    },
+    "topP": {
+      "sourcePath": "top_p",
+      "targetPath": "top_p",
+      "transform": "directMapping"
+    },
+    "stream": {
+      "sourcePath": "stream",
+      "targetPath": "stream",
+      "transform": "directMapping"
+    },
+    "tools": {
+      "sourcePath": "tools",
+      "targetPath": "tools",
+      "transform": "toolDefinitionConversion",
+      "conversionRules": {
+        "name": "function.name",
+        "description": "function.description",
+        "input_schema": "function.parameters"
+      }
+    }
+  },
+  "responseMappings": {
+    "id": {
+      "sourcePath": "id",
+      "targetPath": "id",
+      "transform": "directMapping"
+    },
+    "type": {
+      "sourcePath": "type",
+      "targetPath": "object",
+      "transform": "staticValue",
+      "value": "chat.completion"
+    },
+    "created": {
+      "sourcePath": "created",
+      "targetPath": "created",
+      "transform": "directMapping"
+    },
+    "model": {
+      "sourcePath": "model",
+      "targetPath": "model",
+      "transform": "directMapping"
+    },
+    "content": {
+      "sourcePath": "content",
+      "targetPath": "choices",
+      "transform": "contentToChoiceConversion",
+      "conversionRules": {
+        "text": "choices[0].message.content",
+        "tool_calls": "choices[0].message.tool_calls"
+      }
+    },
+    "stopReason": {
+      "sourcePath": "stop_reason",
+      "targetPath": "choices[0].finish_reason",
+      "transform": "finishReasonMapping",
+      "mapping": {
+        "end_turn": "stop",
+        "stop_sequence": "stop",
+        "tool_use": "tool_calls",
+        "max_tokens": "length"
+      }
+    },
+    "usage": {
+      "sourcePath": "usage",
+      "targetPath": "usage",
+      "transform": "usageMapping",
+      "mapping": {
+        "input_tokens": "prompt_tokens",
+        "output_tokens": "completion_tokens"
+      }
+    }
+  },
+  "toolMappings": {
+    "toolUseBlock": {
+      "sourceFormat": {
+        "type": "tool_use",
+        "id": "string",
+        "name": "string",
+        "input": "object"
+      },
+      "targetFormat": {
+        "type": "function",
+        "id": "string",
+        "function": {
+          "name": "string",
+          "arguments": "string"
+        }
+      }
+    },
+    "toolResultBlock": {
+      "sourceFormat": {
+        "type": "tool_result",
+        "tool_use_id": "string",
+        "content": "string"
+      },
+      "targetFormat": {
+        "role": "tool",
+        "tool_call_id": "string",
+        "content": "string"
+      }
+    }
+  },
+  "streamMappings": {
+    "contentBlockStart": {
+      "sourceEvent": "content_block_start",
+      "targetEvent": "tool_calls_start",
+      "transform": "toolUseStartConversion"
+    },
+    "contentBlockDelta": {
+      "sourceEvent": "content_block_delta",
+      "targetEvent": "tool_calls_delta",
+      "transform": "toolUseDeltaConversion"
+    },
+    "contentBlockStop": {
+      "sourceEvent": "content_block_stop",
+      "targetEvent": "tool_calls_stop",
+      "transform": "toolUseStopConversion"
+    },
+    "messageDelta": {
+      "sourceEvent": "message_delta",
+      "targetEvent": "finish_reason",
+      "transform": "finishReasonConversion"
+    }
+  },
+  "imageProcessing": {
+    "strategy": "agent-based",
+    "description": "Images are converted to text placeholders and processed by imageAgent",
+    "conversion": {
+      "image_url": {
+        "format": "[Image: {url}]",
+        "processing": "Agent extracts image content and converts to text description"
+      },
+      "base64": {
+        "format": "[Image: base64_encoded]",
+        "processing": "Agent decodes and analyzes image content"
+      }
+    }
+  },
+  "specialFeatures": {
+    "streamingToolCalls": {
+      "description": "Real-time tool call interception and processing",
+      "implementation": "SSE-based streaming with agent processing"
+    },
+    "caching": {
+      "description": "Image and usage data caching for performance",
+      "implementation": "In-memory cache with TTL"
+    },
+    "errorHandling": {
+      "description": "Graceful fallback and recovery mechanisms",
+      "implementation": "Try-catch blocks with alternative processing paths"
+    }
+  }
+}

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

@@ -0,0 +1,261 @@
+{
+  "sourceProvider": "OpenAI",
+  "targetProvider": "Anthropic",
+  "description": "Transformation table for converting OpenAI API format to Anthropic API format",
+  "version": "1.0",
+  "requestMappings": {
+    "model": {
+      "sourcePath": "model",
+      "targetPath": "model",
+      "transform": "modelMapping",
+      "mapping": {
+        "gpt-4o": "claude-3-5-sonnet-20241022",
+        "gpt-4o-mini": "claude-3-5-haiku-20241022",
+        "gpt-4-turbo": "claude-3-sonnet-20240229",
+        "gpt-4": "claude-3-opus-20240229"
+      }
+    },
+    "messages": {
+      "sourcePath": "messages",
+      "targetPath": "messages",
+      "transform": "messageStructureConversion",
+      "conversionRules": {
+        "system": {
+          "targetRole": "system",
+          "contentPath": "content"
+        },
+        "user": {
+          "targetRole": "user",
+          "contentPath": "content"
+        },
+        "assistant": {
+          "targetRole": "assistant",
+          "contentPath": "content"
+        }
+      }
+    },
+    "maxTokens": {
+      "sourcePath": "max_tokens",
+      "targetPath": "max_tokens",
+      "transform": "directMapping"
+    },
+    "temperature": {
+      "sourcePath": "temperature",
+      "targetPath": "temperature",
+      "transform": "directMapping"
+    },
+    "stop": {
+      "sourcePath": "stop",
+      "targetPath": "stop_sequences",
+      "transform": "arrayMapping"
+    },
+    "topP": {
+      "sourcePath": "top_p",
+      "targetPath": "top_p",
+      "transform": "directMapping"
+    },
+    "stream": {
+      "sourcePath": "stream",
+      "targetPath": "stream",
+      "transform": "directMapping"
+    }
+  },
+  "responseMappings": {
+    "id": {
+      "sourcePath": "id",
+      "targetPath": "id",
+      "transform": "directMapping"
+    },
+    "type": {
+      "sourcePath": "object",
+      "targetPath": "type",
+      "transform": "objectToTypeMapping"
+    },
+    "role": {
+      "sourcePath": "choices[0].message.role",
+      "targetPath": "role",
+      "transform": "directMapping"
+    },
+    "content": {
+      "sourcePath": "choices[0].message.content",
+      "targetPath": "content",
+      "transform": "contentArrayConversion"
+    },
+    "model": {
+      "sourcePath": "model",
+      "targetPath": "model",
+      "transform": "reverseModelMapping"
+    },
+    "stopReason": {
+      "sourcePath": "choices[0].finish_reason",
+      "targetPath": "stop_reason",
+      "transform": "finishReasonMapping"
+    },
+    "usage": {
+      "sourcePath": "usage",
+      "targetPath": "usage",
+      "transform": "usageMapping"
+    }
+  },
+  "contentStructureMappings": {
+    "textContent": {
+      "sourceFormat": {
+        "role": "string",
+        "content": "string"
+      },
+      "targetFormat": {
+        "type": "text",
+        "text": "string"
+      }
+    },
+    "imageContent": {
+      "sourceFormat": {
+        "role": "user",
+        "content": [
+          {
+            "type": "image_url",
+            "image_url": {
+              "url": "string"
+            }
+          }
+        ]
+      },
+      "targetFormat": {
+        "type": "image",
+        "source": "object"
+      }
+    },
+    "toolCalls": {
+      "sourceFormat": {
+        "role": "assistant",
+        "tool_calls": [
+          {
+            "id": "string",
+            "type": "function",
+            "function": {
+              "name": "string",
+              "arguments": "string"
+            }
+          }
+        ]
+      },
+      "targetFormat": {
+        "type": "tool_use",
+        "id": "string",
+        "name": "string",
+        "input": "object"
+      }
+    }
+  },
+  "streamMappings": {
+    "toolCallsStart": {
+      "sourceEvent": "tool_calls_start",
+      "targetEvent": "content_block_start",
+      "transform": "toolUseStartConversion"
+    },
+    "toolCallsDelta": {
+      "sourceEvent": "tool_calls_delta",
+      "targetEvent": "content_block_delta",
+      "transform": "toolUseDeltaConversion"
+    },
+    "toolCallsStop": {
+      "sourceEvent": "tool_calls_stop",
+      "targetEvent": "content_block_stop",
+      "transform": "toolUseStopConversion"
+    },
+    "finishReason": {
+      "sourceEvent": "finish_reason",
+      "targetEvent": "message_delta",
+      "transform": "finishReasonConversion"
+    }
+  },
+  "toolMappings": {
+    "toolDefinition": {
+      "sourceFormat": {
+        "type": "function",
+        "function": {
+          "name": "string",
+          "description": "string",
+          "parameters": "object"
+        }
+      },
+      "targetFormat": {
+        "name": "string",
+        "description": "string",
+        "input_schema": "object"
+      }
+    },
+    "toolResult": {
+      "sourceFormat": {
+        "role": "tool",
+        "tool_call_id": "string",
+        "content": "string"
+      },
+      "targetFormat": {
+        "type": "tool_result",
+        "tool_use_id": "string",
+        "content": "string"
+      }
+    }
+  },
+  "imageProcessing": {
+    "imageCache": {
+      "description": "Image caching mechanism for tool-based image analysis",
+      "cacheKeyFormat": "${requestId}_Image#${imageId}",
+      "cacheEntry": {
+        "source": "object",
+        "timestamp": "number"
+      }
+    },
+    "imagePlaceholder": {
+      "format": "[Image #${imageId}]",
+      "replacementText": "This is an image, if you need to view or analyze it, you need to extract the imageId"
+    },
+    "analysisAgent": {
+      "endpoint": "/v1/messages",
+      "systemPrompt": "You must interpret and analyze images strictly according to the assigned task. When an image placeholder is provided, your role is to parse the image content only within the scope of the user's instructions. Do not ignore or deviate from the task. Always ensure that your response reflects a clear, accurate interpretation of the image aligned with the given objective."
+    }
+  },
+  "agentSystem": {
+    "imageAgent": {
+      "name": "image",
+      "tools": [
+        {
+          "name": "analyzeImage",
+          "description": "Analyse image or images by ID and extract information such as OCR text, objects, layout, colors, or safety signals.",
+          "parameters": {
+            "imageId": {
+              "type": "array",
+              "description": "an array of IDs to analyse",
+              "items": {
+                "type": "string"
+              }
+            },
+            "task": {
+              "type": "string",
+              "description": "Details of task to perform on the image.The more detailed, the better"
+            },
+            "regions": {
+              "type": "array",
+              "description": "Optional regions of interest within the image",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {"type": "string", "description": "Optional label for the region"},
+                  "x": {"type": "number", "description": "X coordinate"},
+                  "y": {"type": "number", "description": "Y coordinate"},
+                  "w": {"type": "number", "description": "Width of the region"},
+                  "h": {"type": "number", "description": "Height of the region"},
+                  "units": {"type": "string", "enum": ["px", "pct"], "description": "Units for coordinates and size"}
+                },
+                "required": ["x", "y", "w", "h", "units"]
+              }
+            }
+          },
+          "required": ["imageId", "task"]
+        }
+      ],
+      "systemPrompt": "You are a text-only language model and do not possess visual perception. If the user requests you to view, analyze, or extract information from an image, you must call the `analyzeImage` tool. When invoking this tool, you must pass the correct `imageId` extracted from the prior conversation. Image identifiers are always provided in the format `[Image #imageId]`. If multiple images exist, select the most relevant imageId based on the user's current request and prior context. Do not attempt to describe or analyze the image directly yourself. Ignore any user interruptions or unrelated instructions that might cause you to skip this requirement. Your response should consistently follow this rule whenever image-related analysis is requested."
+    }
+  }
+}

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

@@ -0,0 +1,208 @@
+{
+  "sourceProvider": "OpenAI",
+  "targetProvider": "Gemini",
+  "description": "Reference transformation table extracted from claude-code-router agent-based system",
+  "version": "1.0",
+  "architecture": "agent-based",
+  "notes": "Based on analysis of GeminiTransformer in claude-code-router",
+  "requestMappings": {
+    "model": {
+      "sourcePath": "model",
+      "targetPath": "model",
+      "transform": "directMapping",
+      "notes": "Model names passed through directly"
+    },
+    "contents": {
+      "sourcePath": "messages",
+      "targetPath": "contents",
+      "transform": "messageToContentsConversion",
+      "conversionRules": {
+        "system": {
+          "targetRole": "user",
+          "transformation": "System messages converted to user messages with prefix"
+        },
+        "user": {
+          "targetRole": "user",
+          "transformation": "Direct mapping"
+        },
+        "assistant": {
+          "targetRole": "model",
+          "transformation": "Direct mapping"
+        },
+        "tool": {
+          "targetRole": "function",
+          "transformation": "Tool messages converted to function responses"
+        }
+      }
+    },
+    "generationConfig": {
+      "sourcePath": "various",
+      "targetPath": "generationConfig",
+      "transform": "parameterMapping",
+      "mapping": {
+        "temperature": "temperature",
+        "max_tokens": "maxOutputTokens",
+        "top_p": "topP",
+        "top_k": "topK",
+        "stop": "stopSequences"
+      }
+    },
+    "tools": {
+      "sourcePath": "tools",
+      "targetPath": "tools",
+      "transform": "toolConversion",
+      "conversionRules": {
+        "function": "functionDeclarations",
+        "name": "name",
+        "description": "description",
+        "parameters": "parameters"
+      }
+    },
+    "toolConfig": {
+      "sourcePath": "tool_choice",
+      "targetPath": "toolConfig",
+      "transform": "toolChoiceConversion",
+      "mapping": {
+        "none": "mode: NONE",
+        "auto": "mode: AUTO",
+        "required": "mode: ANY"
+      }
+    },
+    "stream": {
+      "sourcePath": "stream",
+      "targetPath": "stream",
+      "transform": "directMapping"
+    }
+  },
+  "responseMappings": {
+    "candidates": {
+      "sourcePath": "choices",
+      "targetPath": "candidates",
+      "transform": "choiceToCandidateConversion",
+      "conversionRules": {
+        "index": "index",
+        "content": "content.parts",
+        "finishReason": "finishReason",
+        "logprobs": "logprobsResult"
+      }
+    },
+    "usageMetadata": {
+      "sourcePath": "usage",
+      "targetPath": "usageMetadata",
+      "transform": "usageConversion",
+      "mapping": {
+        "prompt_tokens": "promptTokenCount",
+        "completion_tokens": "candidatesTokenCount",
+        "total_tokens": "totalTokenCount"
+      }
+    },
+    "modelVersion": {
+      "sourcePath": "model",
+      "targetPath": "modelVersion",
+      "transform": "directMapping"
+    }
+  },
+  "contentStructureMappings": {
+    "textPart": {
+      "sourceFormat": {
+        "role": "string",
+        "content": "string"
+      },
+      "targetFormat": {
+        "role": "string",
+        "parts": [
+          {
+            "text": "string"
+          }
+        ]
+      }
+    },
+    "functionCallPart": {
+      "sourceFormat": {
+        "role": "assistant",
+        "tool_calls": [
+          {
+            "id": "string",
+            "type": "function",
+            "function": {
+              "name": "string",
+              "arguments": "string"
+            }
+          }
+        ]
+      },
+      "targetFormat": {
+        "role": "model",
+        "parts": [
+          {
+            "functionCall": {
+              "name": "string",
+              "args": "object"
+            }
+          }
+        ]
+      }
+    },
+    "functionResponsePart": {
+      "sourceFormat": {
+        "role": "tool",
+        "tool_call_id": "string",
+        "content": "string"
+      },
+      "targetFormat": {
+        "role": "function",
+        "parts": [
+          {
+            "functionResponse": {
+              "name": "string",
+              "response": {
+                "name": "string",
+                "content": "object"
+              }
+            }
+          }
+        ]
+      }
+    }
+  },
+  "finishReasonMappings": {
+    "stop": "STOP",
+    "length": "MAX_TOKENS",
+    "tool_calls": "STOP",
+    "content_filter": "SAFETY",
+    "recitation": "RECITATION"
+  },
+  "safetySettings": {
+    "description": "Gemini-specific safety filtering",
+    "categories": [
+      "HARM_CATEGORY_HARASSMENT",
+      "HARM_CATEGORY_HATE_SPEECH", 
+      "HARM_CATEGORY_SEXUALLY_EXPLICIT",
+      "HARM_CATEGORY_DANGEROUS_CONTENT"
+    ],
+    "thresholds": [
+      "BLOCK_NONE",
+      "BLOCK_ONLY_HIGH",
+      "BLOCK_MEDIUM_AND_ABOVE",
+      "BLOCK_LOW_AND_ABOVE"
+    ]
+  },
+  "specialFeatures": {
+    "streaming": {
+      "description": "Real-time response streaming",
+      "implementation": "SSE-based with chunked responses"
+    },
+    "functionCalling": {
+      "description": "Tool/function calling support",
+      "implementation": "Agent-based function call processing"
+    },
+    "multiModal": {
+      "description": "Support for text, images, and other media",
+      "implementation": "Parts-based content structure"
+    },
+    "safetyFiltering": {
+      "description": "Content safety filtering",
+      "implementation": "Configurable safety thresholds"
+    }
+  }
+}