@ailib-official/ai-protocol 0.8.4

package/dist/v2/providers/qwen.json

@@ -0,0 +1,274 @@
+{
+  "$schema": "https://raw.githubusercontent.com/ailib-official/ai-protocol/main/schemas/v2/provider.json",
+  "id": "qwen",
+  "protocol_version": "2.0",
+  "name": "Qwen (DashScope)",
+  "version": "3.0.0",
+  "status": "stable",
+  "category": "ai_provider",
+  "official_url": "https://help.aliyun.com/zh/model-studio",
+  "support_contact": "https://help.aliyun.com",
+  "endpoint": {
+    "base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1",
+    "chat": "/chat/completions",
+    "auth": {
+      "type": "bearer",
+      "header": "Authorization",
+      "prefix": "Bearer",
+      "token_env": "QWEN_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"
+    }
+  },
+  "capabilities": {
+    "required": [
+      "text",
+      "streaming",
+      "tools"
+    ],
+    "optional": [
+      "vision",
+      "audio",
+      "video",
+      "parallel_tools",
+      "reasoning",
+      "structured_output",
+      "image_generation",
+      "stt",
+      "tts"
+    ],
+    "feature_flags": {
+      "structured_output": true,
+      "parallel_tool_calls": 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": 32000
+    },
+    "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",
+          "gif",
+          "webp"
+        ],
+        "encoding_methods": [
+          "base64_inline",
+          "url"
+        ],
+        "document_understanding": true
+      },
+      "audio": {
+        "supported": true,
+        "formats": [
+          "mp3",
+          "wav",
+          "flac",
+          "ogg",
+          "aac"
+        ],
+        "speech_recognition": true,
+        "real_time_streaming": true
+      },
+      "video": {
+        "supported": true,
+        "formats": [
+          "mp4",
+          "mov",
+          "avi",
+          "webm"
+        ],
+        "frame_extraction": "automatic",
+        "audio_track": true,
+        "temporal_reasoning": true
+      }
+    },
+    "output": {
+      "text": true,
+      "audio": {
+        "supported": true,
+        "formats": [
+          "wav",
+          "mp3",
+          "opus"
+        ],
+        "real_time_tts": true,
+        "natural_voice": true,
+        "voice_selection": true
+      },
+      "image": {
+        "supported": true,
+        "formats": [
+          "png",
+          "jpeg",
+          "webp"
+        ]
+      },
+      "video": {
+        "supported": false
+      }
+    }
+  },
+  "api_families": [
+    "chat_completions",
+    "completions"
+  ],
+  "default_api_family": "chat_completions",
+  "endpoints": {
+    "chat": {
+      "path": "/chat/completions",
+      "method": "POST",
+      "adapter": "openai"
+    }
+  },
+  "services": {
+    "list_models": {
+      "path": "/models",
+      "method": "GET",
+      "response_binding": "data"
+    }
+  },
+  "retry_policy": {
+    "strategy": "exponential_backoff",
+    "max_retries": 2,
+    "min_delay_ms": 1000,
+    "max_delay_ms": 8000,
+    "jitter": "full",
+    "retry_on_http_status": [
+      408,
+      409,
+      429,
+      500,
+      503
+    ]
+  },
+  "termination": {
+    "source_field": "finish_reason",
+    "mapping": {
+      "stop": "end_turn",
+      "length": "max_tokens",
+      "tool_calls": "tool_use",
+      "content_filter": "refusal"
+    }
+  },
+  "metadata": {
+    "api_compatibility": "openai",
+    "regional": {
+      "primary": "china"
+    },
+    "sdk": {
+      "python": "openai",
+      "typescript": "openai"
+    }
+  }
+}

package/dist/v2/providers/zhipu.json

@@ -0,0 +1,257 @@
+{
+  "$schema": "https://raw.githubusercontent.com/ailib-official/ai-protocol/main/schemas/v2/provider.json",
+  "id": "zhipu",
+  "protocol_version": "2.0",
+  "name": "Zhipu AI",
+  "version": "5.0.0",
+  "status": "stable",
+  "category": "ai_provider",
+  "official_url": "https://open.bigmodel.cn/dev/api",
+  "support_contact": "https://open.bigmodel.cn/",
+  "endpoint": {
+    "base_url": "https://open.bigmodel.cn/api/paas/v4",
+    "chat": "/chat/completions",
+    "auth": {
+      "type": "bearer",
+      "header": "Authorization",
+      "prefix": "Bearer",
+      "token_env": "ZHIPU_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": [
+      "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"
+      ]
+    },
+    "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
+      ]
+    },
+    "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": false
+      },
+      "audio": {
+        "supported": false
+      },
+      "video": {
+        "supported": false
+      }
+    },
+    "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": "MIT",
+      "hugging_face": "https://huggingface.co/zhipuai/glm-5"
+    },
+    "agentic_engineering": {
+      "supported": true,
+      "capabilities": [
+        "long_horizon_planning",
+        "multi_step_workflows",
+        "autonomous_debugging"
+      ]
+    },
+    "models": {
+      "glm-5": {
+        "context_window": 200000,
+        "max_output_tokens": 128000,
+        "release_date": "2026-02-11",
+        "architecture": {
+          "type": "moe",
+          "total": "744B",
+          "active": "40B"
+        },
+        "pricing": {
+          "input_per_1m": 1,
+          "output_per_1m": 3.2
+        }
+      }
+    },
+    "regional": {
+      "primary": "china",
+      "alternative_base": "https://api.z.ai/v1",
+      "international_partners": [
+        "aimlapi"
+      ]
+    },
+    "sdk": {
+      "note": "OpenAI-compatible — use openai SDK with base_url override",
+      "python": "openai",
+      "typescript": "openai"
+    }
+  }
+}

package/dist/v2-alpha/providers/anthropic.json

@@ -0,0 +1,182 @@
+{
+  "$schema": "https://raw.githubusercontent.com/ailib-official/ai-protocol/main/schemas/v2/provider.json",
+  "id": "anthropic",
+  "protocol_version": "2.0",
+  "name": "Anthropic",
+  "version": "v1",
+  "status": "stable",
+  "category": "ai_provider",
+  "official_url": "https://docs.anthropic.com",
+  "support_contact": "https://support.anthropic.com",
+  "endpoint": {
+    "base_url": "https://api.anthropic.com/v1",
+    "chat": "/messages",
+    "auth": {
+      "type": "custom_header",
+      "header": "x-api-key",
+      "token_env": "ANTHROPIC_API_KEY",
+      "extra_headers": [
+        {
+          "name": "anthropic-version",
+          "value": "2023-06-01"
+        }
+      ]
+    }
+  },
+  "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",
+      "529": "overloaded"
+    },
+    "by_error_code": {
+      "invalid_request_error": "invalid_request",
+      "authentication_error": "authentication",
+      "permission_error": "permission_denied",
+      "not_found_error": "not_found",
+      "request_too_large": "request_too_large",
+      "rate_limit_error": "rate_limited",
+      "api_error": "server_error",
+      "overloaded_error": "overloaded"
+    }
+  },
+  "capabilities": {
+    "required": [
+      "text",
+      "streaming"
+    ],
+    "optional": [
+      "vision",
+      "tools",
+      "parallel_tools",
+      "agentic",
+      "reasoning",
+      "batch"
+    ],
+    "feature_flags": {
+      "structured_output": false,
+      "parallel_tool_calls": true,
+      "extended_thinking": true,
+      "streaming_usage": true,
+      "system_messages": true
+    }
+  },
+  "parameters": {
+    "temperature": {
+      "type": "float",
+      "range": [
+        0,
+        2
+      ],
+      "default": 1
+    },
+    "max_tokens": {
+      "type": "integer",
+      "min": 1,
+      "max": 8192,
+      "required": true
+    },
+    "top_p": {
+      "type": "float",
+      "range": [
+        0,
+        1
+      ]
+    },
+    "top_k": {
+      "type": "integer",
+      "min": 0
+    },
+    "stream": {
+      "type": "boolean"
+    }
+  },
+  "streaming": {
+    "decoder": {
+      "format": "anthropic_sse",
+      "strategy": "anthropic_event_stream"
+    },
+    "event_map": [
+      {
+        "match": "$.type == 'content_block_delta' && $.delta.type == 'text_delta'",
+        "emit": "PartialContentDelta",
+        "extract": {
+          "content": "$.delta.text"
+        }
+      },
+      {
+        "match": "$.type == 'content_block_delta' && $.delta.type == 'input_json_delta'",
+        "emit": "PartialToolCall",
+        "extract": {
+          "partial_json": "$.delta.partial_json"
+        }
+      },
+      {
+        "match": "$.type == 'content_block_delta' && $.delta.type == 'thinking_delta'",
+        "emit": "ThinkingDelta",
+        "extract": {
+          "thinking": "$.delta.thinking"
+        }
+      },
+      {
+        "match": "$.type == 'message_delta'",
+        "emit": "StreamEnd",
+        "extract": {
+          "finish_reason": "$.delta.stop_reason",
+          "usage": "$.usage"
+        }
+      }
+    ],
+    "accumulator": {
+      "stateful_tool_parsing": true,
+      "key_path": "$.delta.partial_json",
+      "flush_on": "$.type == 'content_block_stop'"
+    }
+  },
+  "api_families": [
+    "messages"
+  ],
+  "default_api_family": "messages",
+  "endpoints": {
+    "chat": {
+      "path": "/messages",
+      "method": "POST",
+      "adapter": "anthropic"
+    }
+  },
+  "rate_limit_headers": {
+    "retry_after": "retry-after",
+    "requests_limit": "anthropic-ratelimit-requests-limit",
+    "requests_remaining": "anthropic-ratelimit-requests-remaining",
+    "tokens_limit": "anthropic-ratelimit-tokens-limit",
+    "tokens_remaining": "anthropic-ratelimit-tokens-remaining"
+  },
+  "retry_policy": {
+    "strategy": "exponential_backoff",
+    "max_retries": 2,
+    "min_delay_ms": 1000,
+    "max_delay_ms": 60000,
+    "jitter": "full",
+    "retry_on_http_status": [
+      408,
+      409,
+      429,
+      500,
+      529
+    ]
+  },
+  "termination": {
+    "source_field": "stop_reason",
+    "mapping": {
+      "end_turn": "end_turn",
+      "max_tokens": "max_tokens",
+      "stop_sequence": "stop_sequence",
+      "tool_use": "tool_use"
+    }
+  }
+}