@jsonstudio/rcc 0.89.1205 → 0.89.1457

package/docs/mapping-tables/anthropic-to-openai.json

@@ -0,0 +1,290 @@
+{
+  "sourceProvider": "Anthropic",
+  "targetProvider": "OpenAI",
+  "description": "LLMSwitch Module - Anthropic to OpenAI protocol transformation table",
+  "version": "1.0",
+  "architecture": "transformer-based",
+  "notes": "Based on existing transformation tables with enhanced tool execution support",
+  "requestMappings": {
+    "model": {
+      "sourcePath": "model",
+      "targetPath": "model",
+      "transform": "directMapping",
+      "description": "Model identifier mapping"
+    },
+    "maxTokens": {
+      "sourcePath": "max_tokens",
+      "targetPath": "max_tokens",
+      "transform": "directMapping",
+      "description": "Maximum tokens to generate"
+    },
+    "temperature": {
+      "sourcePath": "temperature",
+      "targetPath": "temperature",
+      "transform": "directMapping",
+      "description": "Temperature parameter for response randomness"
+    },
+    "messages": {
+      "sourcePath": "messages",
+      "targetPath": "messages",
+      "transform": "messageStructureConversion",
+      "description": "Convert Anthropic message format to OpenAI format",
+      "conversionRules": {
+        "system": {
+          "targetRole": "system",
+          "contentPath": "content"
+        },
+        "user": {
+          "targetRole": "user",
+          "contentPath": "content"
+        },
+        "assistant": {
+          "targetRole": "assistant",
+          "contentPath": "content"
+        }
+      }
+    },
+    "tools": {
+      "sourcePath": "tools",
+      "targetPath": "tools",
+      "transform": "toolDefinitionConversion",
+      "description": "Convert Anthropic tool format to OpenAI format",
+      "conversionRules": {
+        "name": "function.name",
+        "description": "function.description",
+        "input_schema": "function.parameters"
+      }
+    },
+    "toolChoice": {
+      "sourcePath": "tool_choice",
+      "targetPath": "tool_choice",
+      "transform": "toolChoiceConversion",
+      "description": "Tool choice strategy conversion"
+    },
+    "stopSequences": {
+      "sourcePath": "stop_sequences",
+      "targetPath": "stop",
+      "transform": "arrayMapping",
+      "description": "Stop sequences mapping"
+    },
+    "stream": {
+      "sourcePath": "stream",
+      "targetPath": "stream",
+      "transform": "directMapping",
+      "description": "Streaming response setting"
+    }
+  },
+  "responseMappings": {
+    "id": {
+      "sourcePath": "id",
+      "targetPath": "id",
+      "transform": "directMapping",
+      "description": "Response identifier"
+    },
+    "type": {
+      "sourcePath": "type",
+      "targetPath": "object",
+      "transform": "staticValue",
+      "value": "chat.completion",
+      "description": "OpenAI response object type"
+    },
+    "created": {
+      "sourcePath": "created",
+      "targetPath": "created",
+      "transform": "directMapping",
+      "description": "Response creation timestamp"
+    },
+    "model": {
+      "sourcePath": "model",
+      "targetPath": "model",
+      "transform": "directMapping",
+      "description": "Model used for response"
+    },
+    "content": {
+      "sourcePath": "content",
+      "targetPath": "choices",
+      "transform": "contentToChoiceConversion",
+      "description": "Convert Anthropic content to OpenAI choices format"
+    },
+    "stopReason": {
+      "sourcePath": "stop_reason",
+      "targetPath": "choices[0].finish_reason",
+      "transform": "finishReasonMapping",
+      "description": "Map Anthropic stop reason to OpenAI finish reason"
+    },
+    "usage": {
+      "sourcePath": "usage",
+      "targetPath": "usage",
+      "transform": "usageMapping",
+      "description": "Convert usage statistics format"
+    }
+  },
+  "finishReasonMappings": {
+    "anthropicToOpenai": {
+      "end_turn": {
+        "source": "end_turn",
+        "target": "stop",
+        "description": "正常结束，模型完成响应"
+      },
+      "stop_sequence": {
+        "source": "stop_sequence",
+        "target": "stop",
+        "description": "遇到停止序列"
+      },
+      "max_tokens": {
+        "source": "max_tokens",
+        "target": "length",
+        "description": "达到最大token限制"
+      },
+      "tool_use": {
+        "source": "tool_use",
+        "target": "tool_calls",
+        "description": "需要调用工具"
+      }
+    },
+    "openaiToAnthropic": {
+      "stop": {
+        "source": "stop",
+        "target": "end_turn",
+        "description": "正常结束"
+      },
+      "length": {
+        "source": "length",
+        "target": "max_tokens",
+        "description": "达到最大token限制"
+      },
+      "tool_calls": {
+        "source": "tool_calls",
+        "target": "tool_use",
+        "description": "需要调用工具"
+      },
+      "content_filter": {
+        "source": "content_filter",
+        "target": "end_turn",
+        "description": "内容过滤，Anthropic无直接对应"
+      }
+    }
+  },
+  "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"
+      }
+    }
+  },
+  "toolExecutionLifecycle": {
+    "detection": {
+      "anthropic": {
+        "condition": "LLM decides to use tool",
+        "response": {
+          "type": "tool_use",
+          "id": "string",
+          "name": "string",
+          "input": "object"
+        }
+      },
+      "openai": {
+        "condition": "LLM decides to use tool",
+        "response": {
+          "tool_calls": [
+            {
+              "id": "string",
+              "type": "function",
+              "function": {
+                "name": "string",
+                "arguments": "string"
+              }
+            }
+          ]
+        }
+      }
+    },
+    "execution": {
+      "clientAction": "客户端执行工具",
+      "resultFormat": {
+        "anthropic": {
+          "role": "user",
+          "content": [
+            {
+              "type": "tool_result",
+              "tool_use_id": "string",
+              "content": "工具执行结果"
+            }
+          ]
+        },
+        "openai": {
+          "role": "tool",
+          "tool_call_id": "string",
+          "content": "工具执行结果"
+        }
+      }
+    }
+  },
+  "errorHandling": {
+    "toolExecutionError": {
+      "anthropic": {
+        "type": "tool_result",
+        "tool_use_id": "string",
+        "content": "错误信息",
+        "is_error": true
+      },
+      "openai": {
+        "role": "tool",
+        "tool_call_id": "string",
+        "content": "错误信息",
+        "is_error": true
+      }
+    },
+    "toolTimeout": {
+      "anthropic": {
+        "type": "tool_result",
+        "tool_use_id": "string",
+        "content": "工具执行超时",
+        "is_error": true
+      },
+      "openai": {
+        "role": "tool",
+        "tool_call_id": "string",
+        "content": "工具执行超时",
+        "is_error": true
+      }
+    }
+  },
+  "specialFeatures": {
+    "streamingToolCalls": {
+      "description": "Real-time tool call interception and processing",
+      "implementation": "SSE-based streaming with transformer 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/mapping-tables/iflow-to-openai.json

@@ -0,0 +1,215 @@
+{
+  "version": "1.0.0",
+  "description": "iFlow to OpenAI compatibility mapping table based on Claude Code Router architecture",
+  "formats": {
+    "source": "iflow",
+    "target": "openai"
+  },
+  "metadata": {
+    "created": "2024-01-01T00:00:00Z",
+    "updated": "2024-01-01T00:00:00Z",
+    "author": "RCC System",
+    "architecture": "agent-based",
+    "basedOn": "claude-code-router"
+  },
+  "fieldMappings": {
+    "taskId": {
+      "targetField": "id",
+      "transform": "directMapping",
+      "required": true,
+      "description": "Task identifier"
+    },
+    "agentId": {
+      "targetField": "model",
+      "transform": "mapAgentToModel",
+      "required": true,
+      "description": "Map iFlow agent ID to OpenAI model"
+    },
+    "sessionInfo": {
+      "targetField": "metadata.session_info",
+      "transform": "nestedMapping",
+      "description": "Session information"
+    },
+    "messages": {
+      "targetField": "messages",
+      "transform": "reverseMessageFormatConversion",
+      "required": true,
+      "description": "Convert iFlow message format back to OpenAI format"
+    },
+    "tools": {
+      "targetField": "tools",
+      "transform": "reverseToolFormatConversion",
+      "description": "Convert iFlow tool format back to OpenAI format"
+    },
+    "parameters": {
+      "targetField": "metadata.parameters",
+      "transform": "flattenParameters",
+      "description": "Agent parameters"
+    },
+    "agentConfig": {
+      "targetField": "metadata.agent_config",
+      "transform": "directMapping",
+      "description": "Agent configuration"
+    },
+    "maxTokens": {
+      "targetField": "max_tokens",
+      "transform": "directMapping",
+      "description": "Maximum tokens to generate"
+    },
+    "temperature": {
+      "targetField": "temperature",
+      "transform": "directMapping",
+      "description": "Temperature parameter"
+    },
+    "timeout": {
+      "targetField": "metadata.timeout",
+      "transform": "directMapping",
+      "description": "Request timeout"
+    },
+    "priority": {
+      "targetField": "metadata.priority",
+      "transform": "directMapping",
+      "description": "Request priority"
+    },
+    "streaming": {
+      "targetField": "stream",
+      "transform": "directMapping",
+      "description": "Streaming response flag"
+    },
+    "context": {
+      "targetField": "metadata.context",
+      "transform": "directMapping",
+      "description": "Request context"
+    },
+    "userId": {
+      "targetField": "user",
+      "transform": "mapUserId",
+      "description": "User identifier"
+    }
+  },
+  "validationRules": {
+    "required": ["taskId", "agentId", "messages"],
+    "types": {
+      "taskId": "string",
+      "agentId": "string",
+      "messages": "array",
+      "temperature": "number",
+      "max_tokens": "number",
+      "top_p": "number",
+      "frequency_penalty": "number",
+      "presence_penalty": "number",
+      "stream": "boolean",
+      "user": "string",
+      "tools": "array",
+      "tool_choice": "string",
+      "sessionInfo": "object",
+      "parameters": "object",
+      "agentConfig": "object",
+      "timeout": "number",
+      "priority": "string",
+      "context": "object"
+    },
+    "constraints": {
+      "taskId": {
+        "pattern": "^[a-zA-Z0-9-_]+$",
+        "minLength": 1,
+        "maxLength": 100
+      },
+      "agentId": {
+        "pattern": "^[a-zA-Z0-9-_]+$",
+        "minLength": 1,
+        "maxLength": 50,
+        "allowedValues": ["text-agent", "code-agent", "image-agent", "analysis-agent", "reasoning-agent", "chat-agent", "tool-agent", "multimodal-agent", "research-agent"]
+      },
+      "messages": {
+        "minLength": 1,
+        "maxLength": 100
+      },
+      "max_tokens": {
+        "min": 1,
+        "max": 200000
+      },
+      "temperature": {
+        "min": 0.0,
+        "max": 2.0
+      },
+      "top_p": {
+        "min": 0.0,
+        "max": 1.0
+      },
+      "priority": {
+        "allowedValues": ["low", "normal", "high", "urgent"]
+      }
+    }
+  },
+  "transformFunctions": {
+    "mapAgentToModel": {
+      "type": "mapping",
+      "description": "Map iFlow agent IDs to OpenAI models",
+      "mappings": {
+        "text-agent": "gpt-3.5-turbo",
+        "code-agent": "gpt-4",
+        "image-agent": "gpt-4-vision-preview",
+        "analysis-agent": "gpt-4",
+        "reasoning-agent": "gpt-4",
+        "chat-agent": "gpt-3.5-turbo",
+        "tool-agent": "gpt-4",
+        "multimodal-agent": "gpt-4-vision-preview",
+        "research-agent": "gpt-4"
+      },
+      "defaultValue": "gpt-3.5-turbo"
+    },
+    "reverseMessageFormatConversion": {
+      "type": "object_transform",
+      "description": "Convert iFlow message format back to OpenAI format",
+      "roleMapping": {
+        "system": "system",
+        "user": "user", 
+        "assistant": "assistant",
+        "tool": "tool"
+      },
+      "contentProcessing": {
+        "preserveStructure": true,
+        "restoreMultimodal": true,
+        "agentContentHandling": true
+      }
+    },
+    "reverseToolFormatConversion": {
+      "type": "array_transform",
+      "description": "Convert iFlow tool format back to OpenAI format",
+      "elementTransform": {
+        "type": "object_transform",
+        "fields": {
+          "type": "type",
+          "function": "function"
+        },
+        "preserveStructure": true,
+        "agentToolSchema": true
+      }
+    },
+    "nestedMapping": {
+      "type": "object_transform",
+      "description": "Map nested object structures",
+      "preserveStructure": true
+    },
+    "flattenParameters": {
+      "type": "object_transform",
+      "description": "Flatten parameter object to metadata",
+      "flattenTo": "metadata"
+    },
+    "mapUserId": {
+      "type": "transform",
+      "description": "Format user ID for OpenAI",
+      "transformFunction": "formatUserId"
+    },
+    "directMapping": {
+      "type": "direct",
+      "description": "No transformation needed - pass through as-is"
+    },
+    "reverseArrayMapping": {
+      "type": "array_transform",
+      "description": "Convert array format back to OpenAI format",
+      "preserveElements": true
+    }
+  }
+}

package/docs/mapping-tables/openai-passthrough.json

@@ -0,0 +1,190 @@
+{
+  "sourceProvider": "OpenAI",
+  "targetProvider": "OpenAI",
+  "description": "LLMSwitch Module - OpenAI passthrough transformation table",
+  "version": "1.0",
+  "architecture": "passthrough",
+  "notes": "Direct passthrough for OpenAI requests without transformation",
+  "requestMappings": {
+    "model": {
+      "sourcePath": "model",
+      "targetPath": "model",
+      "transform": "directMapping",
+      "description": "Model identifier passthrough"
+    },
+    "messages": {
+      "sourcePath": "messages",
+      "targetPath": "messages",
+      "transform": "directMapping",
+      "description": "Messages array passthrough"
+    },
+    "temperature": {
+      "sourcePath": "temperature",
+      "targetPath": "temperature",
+      "transform": "directMapping",
+      "description": "Temperature parameter passthrough"
+    },
+    "maxTokens": {
+      "sourcePath": "max_tokens",
+      "targetPath": "max_tokens",
+      "transform": "directMapping",
+      "description": "Maximum tokens passthrough"
+    },
+    "tools": {
+      "sourcePath": "tools",
+      "targetPath": "tools",
+      "transform": "directMapping",
+      "description": "Tools array passthrough"
+    },
+    "toolChoice": {
+      "sourcePath": "tool_choice",
+      "targetPath": "tool_choice",
+      "transform": "directMapping",
+      "description": "Tool choice passthrough"
+    },
+    "stop": {
+      "sourcePath": "stop",
+      "targetPath": "stop",
+      "transform": "directMapping",
+      "description": "Stop sequences passthrough"
+    },
+    "stream": {
+      "sourcePath": "stream",
+      "targetPath": "stream",
+      "transform": "directMapping",
+      "description": "Streaming setting passthrough"
+    },
+    "topP": {
+      "sourcePath": "top_p",
+      "targetPath": "top_p",
+      "transform": "directMapping",
+      "description": "Top P parameter passthrough"
+    },
+    "frequencyPenalty": {
+      "sourcePath": "frequency_penalty",
+      "targetPath": "frequency_penalty",
+      "transform": "directMapping",
+      "description": "Frequency penalty passthrough"
+    },
+    "presencePenalty": {
+      "sourcePath": "presence_penalty",
+      "targetPath": "presence_penalty",
+      "transform": "directMapping",
+      "description": "Presence penalty passthrough"
+    },
+    "user": {
+      "sourcePath": "user",
+      "targetPath": "user",
+      "transform": "directMapping",
+      "description": "User identifier passthrough"
+    }
+  },
+  "responseMappings": {
+    "id": {
+      "sourcePath": "id",
+      "targetPath": "id",
+      "transform": "directMapping",
+      "description": "Response identifier passthrough"
+    },
+    "object": {
+      "sourcePath": "object",
+      "targetPath": "object",
+      "transform": "directMapping",
+      "description": "Response object type passthrough"
+    },
+    "created": {
+      "sourcePath": "created",
+      "targetPath": "created",
+      "transform": "directMapping",
+      "description": "Creation timestamp passthrough"
+    },
+    "model": {
+      "sourcePath": "model",
+      "targetPath": "model",
+      "transform": "directMapping",
+      "description": "Model identifier passthrough"
+    },
+    "choices": {
+      "sourcePath": "choices",
+      "targetPath": "choices",
+      "transform": "directMapping",
+      "description": "Response choices passthrough"
+    },
+    "usage": {
+      "sourcePath": "usage",
+      "targetPath": "usage",
+      "transform": "directMapping",
+      "description": "Usage statistics passthrough"
+    }
+  },
+  "finishReasonMappings": {
+    "openaiToOpenai": {
+      "stop": {
+        "source": "stop",
+        "target": "stop",
+        "description": "正常结束"
+      },
+      "length": {
+        "source": "length",
+        "target": "length",
+        "description": "达到最大token限制"
+      },
+      "tool_calls": {
+        "source": "tool_calls",
+        "target": "tool_calls",
+        "description": "需要调用工具"
+      },
+      "content_filter": {
+        "source": "content_filter",
+        "target": "content_filter",
+        "description": "内容过滤"
+      }
+    }
+  },
+  "toolMappings": {
+    "toolCalls": {
+      "sourceFormat": {
+        "id": "string",
+        "type": "function",
+        "function": {
+          "name": "string",
+          "arguments": "string"
+        }
+      },
+      "targetFormat": {
+        "id": "string",
+        "type": "function",
+        "function": {
+          "name": "string",
+          "arguments": "string"
+        }
+      }
+    },
+    "toolResults": {
+      "sourceFormat": {
+        "role": "tool",
+        "tool_call_id": "string",
+        "content": "string"
+      },
+      "targetFormat": {
+        "role": "tool",
+        "tool_call_id": "string",
+        "content": "string"
+      }
+    }
+  },
+  "specialFeatures": {
+    "passthroughMode": {
+      "description": "No transformation applied - direct passthrough",
+      "implementation": "Identity mapping"
+    },
+    "validationOnly": {
+      "description": "Validate OpenAI request format without transformation",
+      "implementation": "Schema validation"
+    },
+    "logging": {
+      "description": "Log all passthrough requests and responses",
+      "implementation": "Comprehensive audit trail"
+    }
+  }
+}