@ailib-official/ai-protocol 0.8.4

package/dist/v2/providers/moonshot.json

@@ -0,0 +1,284 @@
+{
+  "$schema": "https://raw.githubusercontent.com/ailib-official/ai-protocol/main/schemas/v2/provider.json",
+  "id": "moonshot",
+  "protocol_version": "2.0",
+  "name": "Moonshot AI",
+  "version": "2.5.0",
+  "status": "stable",
+  "category": "ai_provider",
+  "official_url": "https://platform.moonshot.ai/docs/",
+  "support_contact": "https://platform.moonshot.ai/",
+  "endpoint": {
+    "base_url": "https://api.moonshot.cn/v1",
+    "chat": "/chat/completions",
+    "auth": {
+      "type": "bearer",
+      "header": "Authorization",
+      "prefix": "Bearer",
+      "token_env": "MOONSHOT_API_KEY"
+    }
+  },
+  "error_classification": {
+    "by_http_status": {
+      "400": "invalid_request",
+      "401": "authentication",
+      "403": "permission_denied",
+      "404": "not_found",
+      "429": "rate_limited",
+      "500": "server_error",
+      "503": "overloaded"
+    },
+    "by_error_code": {
+      "context_length_exceeded": "request_too_large",
+      "model_not_found": "not_found",
+      "rate_limit_exceeded": "rate_limited",
+      "insufficient_quota": "quota_exhausted"
+    }
+  },
+  "capabilities": {
+    "required": [
+      "text",
+      "streaming",
+      "tools"
+    ],
+    "optional": [
+      "vision",
+      "video",
+      "parallel_tools",
+      "agentic",
+      "reasoning",
+      "structured_output"
+    ],
+    "feature_flags": {
+      "structured_output": true,
+      "parallel_tool_calls": true,
+      "streaming_usage": true,
+      "system_messages": true
+    }
+  },
+  "capability_profile": {
+    "phase": "ios_v1",
+    "inputs": {
+      "modalities": [
+        "text",
+        "image",
+        "video"
+      ]
+    },
+    "outcomes": {
+      "types": [
+        "text_completion",
+        "structured_json",
+        "tool_call_sequence"
+      ]
+    },
+    "systems": {
+      "requires": [
+        "mcp",
+        "search"
+      ]
+    }
+  },
+  "parameters": {
+    "temperature": {
+      "type": "float",
+      "range": [
+        0,
+        2
+      ],
+      "default": 1
+    },
+    "max_tokens": {
+      "type": "integer",
+      "min": 1,
+      "max": 33000
+    },
+    "top_p": {
+      "type": "float",
+      "range": [
+        0,
+        1
+      ]
+    },
+    "stream": {
+      "type": "boolean"
+    }
+  },
+  "parameter_mappings": {
+    "temperature": "temperature",
+    "max_tokens": "max_tokens",
+    "stream": "stream",
+    "top_p": "top_p",
+    "tools": "tools",
+    "tool_choice": "tool_choice"
+  },
+  "streaming": {
+    "decoder": {
+      "format": "sse",
+      "strategy": "openai_chat",
+      "done_signal": "[DONE]",
+      "prefix": "data: "
+    },
+    "content_path": "$.choices[0].delta.content",
+    "tool_call_path": "$.choices[0].delta.tool_calls",
+    "usage_path": "$.usage",
+    "event_map": [
+      {
+        "match": "exists($.choices[*].delta.content)",
+        "emit": "PartialContentDelta",
+        "fields": {
+          "content": "$.choices[*].delta.content"
+        }
+      },
+      {
+        "match": "exists($.choices[*].delta.tool_calls)",
+        "emit": "PartialToolCall",
+        "fields": {
+          "tool_calls": "$.choices[*].delta.tool_calls"
+        }
+      },
+      {
+        "match": "exists($.usage)",
+        "emit": "Metadata",
+        "fields": {
+          "usage": "$.usage"
+        }
+      },
+      {
+        "match": "$.choices[*].finish_reason != null",
+        "emit": "StreamEnd",
+        "fields": {
+          "finish_reason": "$.choices[*].finish_reason"
+        }
+      }
+    ],
+    "stop_condition": "$.choices[0].finish_reason != null"
+  },
+  "multimodal": {
+    "input": {
+      "vision": {
+        "supported": true,
+        "formats": [
+          "jpeg",
+          "png",
+          "webp",
+          "gif"
+        ],
+        "encoding_methods": [
+          "base64_inline",
+          "url"
+        ]
+      },
+      "audio": {
+        "supported": false
+      },
+      "video": {
+        "supported": true,
+        "formats": [
+          "mp4",
+          "avi",
+          "mov"
+        ]
+      }
+    },
+    "output": {
+      "text": true,
+      "audio": {
+        "supported": false
+      },
+      "image": {
+        "supported": false
+      }
+    }
+  },
+  "api_families": [
+    "chat_completions"
+  ],
+  "default_api_family": "chat_completions",
+  "endpoints": {
+    "chat": {
+      "path": "/chat/completions",
+      "method": "POST",
+      "adapter": "openai"
+    }
+  },
+  "services": {
+    "list_models": {
+      "path": "/models",
+      "method": "GET"
+    }
+  },
+  "retry_policy": {
+    "strategy": "exponential_backoff",
+    "max_retries": 3,
+    "min_delay_ms": 1000,
+    "max_delay_ms": 30000,
+    "jitter": "full",
+    "retry_on_http_status": [
+      429,
+      500,
+      502,
+      503
+    ]
+  },
+  "termination": {
+    "source_field": "finish_reason",
+    "mapping": {
+      "stop": "end_turn",
+      "length": "max_tokens",
+      "tool_calls": "tool_use"
+    }
+  },
+  "metadata": {
+    "api_compatibility": "openai",
+    "open_source": {
+      "license": "Modified MIT",
+      "hugging_face": "https://huggingface.co/moonshotai/Kimi-K2.5"
+    },
+    "agent_swarm": {
+      "supported": true,
+      "status": "beta",
+      "max_agents": 100,
+      "max_tool_calls": 1500,
+      "coordination": "PARL (Parallel Agent RL)"
+    },
+    "models": {
+      "kimi-k2-5": {
+        "context_window": 256000,
+        "max_output_tokens": 33000,
+        "architecture": {
+          "type": "moe",
+          "total": "1T",
+          "active": "32B",
+          "experts": 384
+        },
+        "pricing": {
+          "input_per_1m": 0.6,
+          "output_per_1m": 3
+        }
+      },
+      "kimi-k2-thinking": {
+        "context_window": 256000,
+        "max_output_tokens": 33000,
+        "pricing": {
+          "input_per_1m": 0.6,
+          "output_per_1m": 2.5
+        }
+      }
+    },
+    "regional": {
+      "primary": "china",
+      "international_partners": [
+        "fireworks_ai",
+        "together_ai",
+        "openrouter",
+        "nvidia_nim"
+      ]
+    },
+    "sdk": {
+      "note": "OpenAI-compatible — use openai SDK with base_url override",
+      "python": "openai",
+      "typescript": "openai"
+    }
+  }
+}

package/dist/v2/providers/openai.json

@@ -0,0 +1,419 @@
+{
+  "$schema": "https://raw.githubusercontent.com/ailib-official/ai-protocol/main/schemas/v2/provider.json",
+  "id": "openai",
+  "protocol_version": "2.0",
+  "name": "OpenAI",
+  "version": "5.3.0",
+  "status": "stable",
+  "category": "ai_provider",
+  "official_url": "https://platform.openai.com/docs",
+  "support_contact": "https://help.openai.com",
+  "endpoint": {
+    "base_url": "https://api.openai.com/v1",
+    "chat": "/chat/completions",
+    "embeddings": "/embeddings",
+    "stt": "/audio/transcriptions",
+    "tts": "/audio/speech",
+    "auth": {
+      "type": "bearer",
+      "header": "Authorization",
+      "prefix": "Bearer",
+      "token_env": "OPENAI_API_KEY"
+    }
+  },
+  "error_classification": {
+    "by_http_status": {
+      "400": "invalid_request",
+      "401": "authentication",
+      "403": "permission_denied",
+      "404": "not_found",
+      "413": "request_too_large",
+      "429": "rate_limited",
+      "500": "server_error",
+      "503": "overloaded"
+    },
+    "by_error_code": {
+      "invalid_api_key": "authentication",
+      "model_not_found": "not_found",
+      "context_length_exceeded": "request_too_large",
+      "rate_limit_exceeded": "rate_limited",
+      "insufficient_quota": "quota_exhausted",
+      "server_error": "server_error"
+    }
+  },
+  "capabilities": {
+    "required": [
+      "text",
+      "streaming",
+      "tools"
+    ],
+    "optional": [
+      "vision",
+      "audio",
+      "parallel_tools",
+      "agentic",
+      "reasoning",
+      "embeddings",
+      "structured_output",
+      "batch",
+      "image_generation",
+      "computer_use",
+      "mcp_client",
+      "stt",
+      "tts"
+    ],
+    "feature_flags": {
+      "structured_output": true,
+      "parallel_tool_calls": true,
+      "extended_thinking": true,
+      "streaming_usage": true,
+      "system_messages": true,
+      "image_generation": true
+    }
+  },
+  "capability_profile": {
+    "phase": "ios_v1",
+    "inputs": {
+      "modalities": [
+        "text",
+        "image",
+        "audio"
+      ]
+    },
+    "outcomes": {
+      "types": [
+        "text_completion",
+        "structured_json",
+        "tool_call_sequence"
+      ]
+    },
+    "systems": {
+      "requires": [
+        "mcp",
+        "search"
+      ]
+    }
+  },
+  "parameters": {
+    "temperature": {
+      "type": "float",
+      "range": [
+        0,
+        2
+      ],
+      "default": 1
+    },
+    "max_tokens": {
+      "type": "integer",
+      "min": 1,
+      "max": 128000
+    },
+    "top_p": {
+      "type": "float",
+      "range": [
+        0,
+        1
+      ]
+    },
+    "frequency_penalty": {
+      "type": "float",
+      "range": [
+        -2,
+        2
+      ]
+    },
+    "presence_penalty": {
+      "type": "float",
+      "range": [
+        -2,
+        2
+      ]
+    },
+    "stream": {
+      "type": "boolean"
+    },
+    "n": {
+      "type": "integer",
+      "min": 1
+    },
+    "response_format": {
+      "type": "object"
+    }
+  },
+  "streaming": {
+    "decoder": {
+      "format": "sse",
+      "strategy": "openai_chat",
+      "done_signal": "[DONE]",
+      "prefix": "data: "
+    },
+    "event_map": [
+      {
+        "match": "$.choices[0].delta.content",
+        "emit": "PartialContentDelta",
+        "extract": {
+          "content": "$.choices[0].delta.content"
+        }
+      },
+      {
+        "match": "$.choices[0].delta.tool_calls",
+        "emit": "PartialToolCall",
+        "extract": {
+          "tool_calls": "$.choices[0].delta.tool_calls"
+        }
+      },
+      {
+        "match": "$.choices[0].finish_reason",
+        "emit": "StreamEnd",
+        "extract": {
+          "finish_reason": "$.choices[0].finish_reason"
+        }
+      },
+      {
+        "match": "$.usage",
+        "emit": "UsageReport",
+        "extract": {
+          "usage": "$.usage"
+        }
+      }
+    ],
+    "candidate": {
+      "candidate_id_path": "$.choices[*].index",
+      "fan_out": true
+    },
+    "accumulator": {
+      "stateful_tool_parsing": true,
+      "key_path": "$.choices[0].delta.tool_calls[0].function.arguments",
+      "flush_on": "$.choices[0].finish_reason == 'tool_calls'"
+    }
+  },
+  "multimodal": {
+    "input": {
+      "vision": {
+        "supported": true,
+        "formats": [
+          "jpeg",
+          "png",
+          "gif",
+          "webp"
+        ],
+        "encoding_methods": [
+          "base64_inline",
+          "url"
+        ],
+        "document_understanding": true
+      },
+      "audio": {
+        "supported": true,
+        "formats": [
+          "mp3",
+          "wav",
+          "flac",
+          "m4a",
+          "ogg",
+          "aac"
+        ],
+        "real_time_streaming": true,
+        "speech_recognition": true
+      },
+      "video": {
+        "supported": false
+      }
+    },
+    "output": {
+      "text": true,
+      "audio": {
+        "supported": true,
+        "formats": [
+          "mp3"
+        ],
+        "real_time_tts": true,
+        "natural_voice": true,
+        "voice_selection": true
+      },
+      "image": {
+        "supported": true,
+        "formats": [
+          "png"
+        ]
+      }
+    }
+  },
+  "computer_use": {
+    "supported": true,
+    "status": "preview",
+    "implementation": "screen_based",
+    "actions": {
+      "screenshot": {
+        "supported": true,
+        "formats": [
+          "png"
+        ]
+      },
+      "mouse": {
+        "supported": true,
+        "operations": [
+          "click",
+          "double_click",
+          "drag",
+          "scroll"
+        ]
+      },
+      "keyboard": {
+        "supported": true,
+        "operations": [
+          "type",
+          "key_press",
+          "shortcut"
+        ]
+      },
+      "browser": {
+        "supported": true,
+        "operations": [
+          "navigate",
+          "fill_form",
+          "click_element"
+        ]
+      }
+    },
+    "safety": {
+      "confirmation_required": true,
+      "sandbox_mode": "recommended",
+      "action_logging": true,
+      "domain_allowlist": false,
+      "sensitive_data_protection": true
+    },
+    "environment": {
+      "browser": true,
+      "desktop": true
+    },
+    "provider_mapping": {
+      "tool_type": "computer_use_preview",
+      "model_requirement": "computer-use-preview",
+      "api_endpoint": "/v1/responses"
+    }
+  },
+  "mcp": {
+    "client": {
+      "supported": true,
+      "protocol_version": "2025-11-25",
+      "transports": [
+        "streamable_http",
+        "sse"
+      ],
+      "auth_methods": [
+        "bearer",
+        "oauth2"
+      ],
+      "capabilities": {
+        "tools": true,
+        "resources": false,
+        "prompts": false,
+        "sampling": false
+      },
+      "tool_filtering": {
+        "allowed_tools": true,
+        "denied_tools": false
+      },
+      "approval_modes": [
+        "never",
+        "always"
+      ],
+      "provider_mapping": {
+        "tool_type": "mcp",
+        "api_endpoint": "/v1/responses",
+        "config_method": "tool_parameter"
+      }
+    }
+  },
+  "api_families": [
+    "chat_completions",
+    "completions",
+    "embeddings",
+    "assistants",
+    "realtime"
+  ],
+  "default_api_family": "chat_completions",
+  "endpoints": {
+    "chat": {
+      "path": "/chat/completions",
+      "method": "POST",
+      "adapter": "openai"
+    },
+    "embeddings": {
+      "path": "/embeddings",
+      "method": "POST",
+      "adapter": "openai"
+    }
+  },
+  "services": {
+    "list_models": {
+      "path": "/models",
+      "method": "GET",
+      "response_binding": "data"
+    }
+  },
+  "rate_limit_headers": {
+    "requests_limit": "x-ratelimit-limit-requests",
+    "requests_remaining": "x-ratelimit-remaining-requests",
+    "tokens_limit": "x-ratelimit-limit-tokens",
+    "tokens_remaining": "x-ratelimit-remaining-tokens",
+    "retry_after": "retry-after"
+  },
+  "retry_policy": {
+    "strategy": "exponential_backoff",
+    "max_retries": 3,
+    "min_delay_ms": 1000,
+    "max_delay_ms": 60000,
+    "jitter": "full",
+    "retry_on_http_status": [
+      429,
+      500,
+      502,
+      503
+    ]
+  },
+  "termination": {
+    "source_field": "finish_reason",
+    "mapping": {
+      "stop": "end_turn",
+      "length": "max_tokens",
+      "content_filter": "refusal",
+      "tool_calls": "tool_use",
+      "function_call": "tool_use"
+    }
+  },
+  "metadata": {
+    "models": {
+      "gpt-5.2": {
+        "context_window": 400000,
+        "max_output_tokens": 16384,
+        "release_date": "2025-12-10",
+        "pricing": {
+          "input_per_1m": 1.75,
+          "output_per_1m": 14
+        }
+      },
+      "gpt-5.3-codex": {
+        "context_window": 400000,
+        "max_output_tokens": 16384,
+        "release_date": "2026-02-05",
+        "pricing": {
+          "input_per_1m": 1.25,
+          "output_per_1m": 10
+        }
+      },
+      "gpt-5.3-codex-spark": {
+        "context_window": 128000,
+        "max_output_tokens": 16384,
+        "release_date": "2026-02-12",
+        "status": "research_preview"
+      }
+    },
+    "sdk": {
+      "python": "openai",
+      "typescript": "openai",
+      "go": "github.com/openai/openai-go"
+    }
+  }
+}