@ailib-official/ai-protocol 0.8.4 → 1.0.0

package/dist/v2/providers/zhipu.json

@@ -3,13 +3,13 @@
   "id": "zhipu",
   "protocol_version": "2.0",
   "name": "Zhipu AI",
-  "version": "5.0.0",
+  "version": "5.2.0",
   "status": "stable",
   "category": "ai_provider",
-  "official_url": "https://open.bigmodel.cn/dev/api",
-  "support_contact": "https://open.bigmodel.cn/",
+  "official_url": "https://docs.z.ai",
+  "support_contact": "https://z.ai",
   "endpoint": {
-    "base_url": "https://open.bigmodel.cn/api/paas/v4",
+    "base_url": "https://api.z.ai/api/paas/v4",
     "chat": "/chat/completions",
     "auth": {
       "type": "bearer",
@@ -22,6 +22,7 @@
     "by_http_status": {
       "400": "invalid_request",
       "401": "authentication",
+      "402": "insufficient_quota",
       "403": "permission_denied",
       "404": "not_found",
       "429": "rate_limited",
@@ -35,6 +36,22 @@
       "insufficient_quota": "quota_exhausted"
     }
   },
+  "availability": {
+    "required": false,
+    "regions": [
+      "cn",
+      "global"
+    ],
+    "check": {
+      "method": "GET",
+      "path": "/models",
+      "expected_status": [
+        200,
+        401
+      ],
+      "timeout_ms": 5000
+    }
+  },
   "capabilities": {
     "required": [
       "text",
@@ -42,6 +59,7 @@
       "tools"
     ],
     "optional": [
+      "vision",
       "parallel_tools",
       "agentic",
       "reasoning",
@@ -50,8 +68,19 @@
     "feature_flags": {
       "structured_output": true,
       "parallel_tool_calls": true,
+      "extended_thinking": true,
       "streaming_usage": true,
       "system_messages": true
+    },
+    "tool_calling": {
+      "native": {
+        "supported": true,
+        "reliability": "full",
+        "parallel": true,
+        "streaming": true,
+        "notes": "Well-evaluated on MCP-Atlas 500-task benchmark; reliable native tool calling"
+      },
+      "text_fallback": null
     }
   },
   "capability_profile": {
@@ -71,8 +100,7 @@
     },
     "systems": {
       "requires": [
-        "mcp",
-        "search"
+        "mcp"
       ]
     }
   },
@@ -81,9 +109,9 @@
       "type": "float",
       "range": [
         0,
-        2
+        1
       ],
-      "default": 1
+      "default": 0.7
     },
     "max_tokens": {
       "type": "integer",
@@ -99,16 +127,16 @@
     },
     "stream": {
       "type": "boolean"
+    },
+    "reasoning_effort": {
+      "type": "string",
+      "enum": [
+        "high",
+        "max"
+      ],
+      "default": "max"
     }
   },
-  "parameter_mappings": {
-    "temperature": "temperature",
-    "max_tokens": "max_tokens",
-    "stream": "stream",
-    "top_p": "top_p",
-    "tools": "tools",
-    "tool_choice": "tool_choice"
-  },
   "streaming": {
     "decoder": {
       "format": "sse",
@@ -127,6 +155,13 @@
           "content": "$.choices[*].delta.content"
         }
       },
+      {
+        "match": "exists($.choices[*].delta.reasoning_content)",
+        "emit": "ThinkingDelta",
+        "fields": {
+          "thinking": "$.choices[*].delta.reasoning_content"
+        }
+      },
       {
         "match": "exists($.choices[*].delta.tool_calls)",
         "emit": "PartialToolCall",
@@ -154,13 +189,28 @@
   "multimodal": {
     "input": {
       "vision": {
-        "supported": false
+        "supported": true,
+        "formats": [
+          "jpeg",
+          "png",
+          "webp"
+        ],
+        "encoding_methods": [
+          "base64_inline",
+          "url"
+        ],
+        "document_understanding": true
       },
       "audio": {
         "supported": false
       },
       "video": {
-        "supported": false
+        "supported": true,
+        "formats": [
+          "mp4",
+          "mov",
+          "avi"
+        ]
       }
     },
     "output": {
@@ -215,17 +265,57 @@
     "api_compatibility": "openai",
     "open_source": {
       "license": "MIT",
-      "hugging_face": "https://huggingface.co/zhipuai/glm-5"
+      "hugging_face": "https://huggingface.co/zai-org/GLM-5.2"
     },
     "agentic_engineering": {
       "supported": true,
       "capabilities": [
         "long_horizon_planning",
         "multi_step_workflows",
-        "autonomous_debugging"
+        "autonomous_debugging",
+        "computer_use"
       ]
     },
     "models": {
+      "glm-5.2": {
+        "context_window": 1048576,
+        "max_output_tokens": 128000,
+        "release_date": "2026-05-01",
+        "architecture": {
+          "type": "moe",
+          "total": "744B",
+          "active": "40B"
+        },
+        "thinking": "dual_mode",
+        "reasoning_effort": [
+          "high",
+          "max"
+        ]
+      },
+      "glm-5v-turbo": {
+        "context_window": 200000,
+        "max_output_tokens": 64000,
+        "release_date": "2026-04-01",
+        "architecture": {
+          "type": "moe",
+          "total": "744B",
+          "active": "40B"
+        },
+        "vision": true,
+        "computer_use": true,
+        "mcp_support": true
+      },
+      "glm-5.1": {
+        "context_window": 200000,
+        "max_output_tokens": 128000,
+        "release_date": "2026-03-01",
+        "architecture": {
+          "type": "moe",
+          "total": "744B",
+          "active": "40B"
+        },
+        "status": "deprecated"
+      },
       "glm-5": {
         "context_window": 200000,
         "max_output_tokens": 128000,
@@ -243,9 +333,11 @@
     },
     "regional": {
       "primary": "china",
-      "alternative_base": "https://api.z.ai/v1",
+      "international_base": "https://api.z.ai/api/paas/v4",
+      "legacy_base": "https://open.bigmodel.cn/api/paas/v4",
       "international_partners": [
-        "aimlapi"
+        "aimlapi",
+        "openrouter"
       ]
     },
     "sdk": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ailib-official/ai-protocol",
-  "version": "0.8.4",
+  "version": "1.0.0",
   "description": "Provider-agnostic AI provider + model registry specification",
   "type": "module",
   "main": "dist/index.json",
@@ -17,11 +17,14 @@
     "validate:providers": "node scripts/validate.js --providers",
     "validate:models": "node scripts/validate.js --models",
     "validate:examples": "node scripts/validate.js --examples",
+    "validate:packs": "node scripts/validate.js --packs",
     "validate:schemas": "node scripts/validate.js --schemas",
     "validate:specs": "node scripts/validate.js --specs",
-    "validate:capability-profile": "node scripts/validate-capability-profile-boundary.js",
+    "validate:compliance": "node scripts/validate-compliance-cases.js",
+    "validate:error-codes": "node scripts/validate-error-codes-sync.js",
     "drift:check": "node scripts/drift-detect.js",
     "gate:manifest-consumption": "node scripts/gate-manifest-consumption.js",
+    "gate:manifest-authority": "node scripts/gate-manifest-authority.js",
     "gate:compliance-matrix": "node scripts/gate-compliance-matrix.js",
     "gate:compliance-matrix:required": "node scripts/gate-compliance-matrix.js",
     "gate:compliance-matrix:report-only": "node scripts/gate-compliance-matrix.js --report-only",
@@ -35,7 +38,9 @@
     "release:gate": "node scripts/release-gate.js",
     "fact-check:models": "node scripts/fact-check-models.js",
     "fact-check:models:strict": "node scripts/fact-check-models.js --strict",
-    "fact-check:models:strict-all": "node scripts/fact-check-models.js --strict --require-keys"
+    "fact-check:models:strict-all": "node scripts/fact-check-models.js --strict --require-keys",
+    "migrate:v2alpha-capacity": "node scripts/migrate-v1-capacity-to-v2alpha.js",
+    "verify:v1-v2-capacity": "node scripts/verify-v1-v2-capacity-parity.js"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -55,6 +60,10 @@
     "model"
   ],
   "license": "MIT OR Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ailib-official/ai-protocol.git"
+  },
   "publishConfig": {
     "access": "public"
   }

package/schemas/v1.json

@@ -14,7 +14,7 @@
           ]
         },
         {
-          "pattern": "^(https://raw\\.githubusercontent\\.com/ailib-official/ai-protocol/(main|master|v\\d+\\.\\d+)/schemas/v1\\.json|\\.\\./schemas/v1\\.json)$"
+          "pattern": "^(https://raw\\.githubusercontent\\.com/ailib-official/ai-protocol/(main|master|v\\d+\\.\\d+(\\.\\d+)?)/schemas/v1\\.json|\\.\\./schemas/v1\\.json)$"
         }
       ],
       "description": "Schema reference: GitHub raw URL (preferred) or relative path (for local development)"

package/schemas/v2/availability.json

@@ -13,6 +13,18 @@
     "regions": {
       "$ref": "./regions.json"
     },
+    "approval_ids": {
+      "type": "object",
+      "description": "Optional regulatory filing IDs keyed by region (e.g. cn ICP/algorithm filing numbers for audit trails)",
+      "additionalProperties": {
+        "type": "array",
+        "minItems": 1,
+        "items": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
     "interval_ms": {
       "type": "integer",
       "minimum": 1000,

package/schemas/v2/capabilities.json

@@ -87,6 +87,10 @@
           "additionalProperties": {
             "type": "boolean"
           }
+        },
+        "tool_calling": {
+          "$ref": "./tool-calling.json",
+          "description": "Tool calling capability declaration (VL-TTC-001)"
         }
       },
       "additionalProperties": false

package/schemas/v2/error-codes.yaml

@@ -62,6 +62,11 @@ error_codes:
     fallbackable: false
     description: "Input exceeds the model's context window or the API payload size limit"
     recovery_hint: "Reduce input size or use a model with a larger context window"
+    # QA-protocol-002: capability_guard / undeclared advanced capability (adv-001..004, gen-007)
+    # intentionally maps to E1005 — client-side rejection before request is sent; not payload size.
+    compliance_aliases:
+      - "capability_not_declared"
+      - "unsupported_capability"
 
   # --- Rate/Quota Errors (2xxx) ---
   E2001:

package/schemas/v2/metadata-model-entry.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/ailib-official/ai-protocol/main/schemas/v2/metadata-model-entry.json",
+  "title": "V2 Provider Metadata Model Entry",
+  "description": "Model-level capacity metadata under provider manifest metadata.models. Integer fields use 0 for unknown. Distinct from capabilities string enums.",
+  "type": "object",
+  "properties": {
+    "context_window": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Maximum input context tokens. 0 = unknown."
+    },
+    "max_output_tokens": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Maximum output/completion tokens. 0 = unknown."
+    },
+    "release_date": {
+      "type": "string",
+      "format": "date",
+      "description": "Model release or GA date (ISO 8601 date)"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["active", "deprecated", "research_preview", "public_preview", "preview", "beta"],
+      "description": "Operational status of this model entry"
+    },
+    "pricing": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Optional per-model pricing hints (not a substitute for pricing.json)"
+    },
+    "verification": {
+      "type": "object",
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": ["operational", "verified", "unverified", "deprecated"]
+        },
+        "source": {
+          "type": "string",
+          "enum": [
+            "official_documentation",
+            "api_probe",
+            "compliance_registry",
+            "provider_catalog"
+          ],
+          "description": "Provenance of verification evidence. Application or deployment names (eos, velaclaw, etc.) are forbidden — see docs/MANIFEST_AUTHORITY.md."
+        },
+        "verified_at": { "type": "string", "format": "date" },
+        "notes": { "type": "string" }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/v2/pack.json

@@ -0,0 +1,145 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/ailib-official/ai-protocol/main/schemas/v2/pack.json",
+  "title": "AI-Protocol V2 Prism Pack Manifest",
+  "description": "Prism Pack capability contract: a curated bundle of provider routes for cost/latency/balanced routing. Extends the v2 provider manifest ecosystem; references provider ids and model ids from ai-protocol v2 provider manifests. Contract only — no marketplace or registry implementation.",
+  "type": "object",
+  "required": [
+    "id",
+    "name",
+    "version",
+    "protocol_version",
+    "provider_routes"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Schema reference URL (must point to schemas/v2/pack.json)"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-_]{1,63}$",
+      "description": "Stable pack identifier (lowercase, alphanumeric, hyphens, underscores)"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable pack name"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.]+)?$",
+      "description": "Pack manifest SemVer"
+    },
+    "protocol_version": {
+      "type": "string",
+      "const": "2.0",
+      "description": "AI-Protocol version this pack conforms to"
+    },
+    "description": {
+      "type": "string",
+      "description": "Short summary of pack intent and routing strategy"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "stable", "deprecated"],
+      "default": "draft",
+      "description": "Pack lifecycle status"
+    },
+    "optimize_default": {
+      "type": "string",
+      "enum": ["cost", "latency", "balanced"],
+      "default": "cost",
+      "description": "Default routing optimize mode when the consumer does not specify one (aligns with Prism /v1/route/decide)"
+    },
+    "provider_routes": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Ordered provider/model routes; lower priority value = higher preference within the same optimize mode",
+      "items": {
+        "$ref": "#/$defs/provider_route"
+      }
+    },
+    "signing_info": {
+      "$ref": "#/$defs/signing_info",
+      "description": "Optional publisher signature metadata (future registry use; not required for draft packs)"
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Opaque publisher metadata (tags, docs links, billing hints)",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "provider_route": {
+      "type": "object",
+      "required": ["provider", "model", "priority"],
+      "additionalProperties": false,
+      "properties": {
+        "provider": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-_]{1,63}$",
+          "description": "Provider id — must match an ai-protocol v2 provider manifest id"
+        },
+        "model": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Model id within the provider manifest metadata.models"
+        },
+        "priority": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Route preference rank (0 = primary)"
+        },
+        "cost_weight": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Relative cost weight for balanced optimize mode (0 = ignore cost, 1 = cost-only)"
+        },
+        "capability_tags": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true,
+          "description": "Capability tags for filtering (e.g. chat, reasoning, vision)"
+        },
+        "notes": {
+          "type": "string",
+          "description": "Publisher notes for this route (alias handling, SLA caveats)"
+        }
+      }
+    },
+    "signing_info": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "publisher": {
+          "type": "string",
+          "description": "Publisher identity (org or individual)"
+        },
+        "signed_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO-8601 signature timestamp"
+        },
+        "algorithm": {
+          "type": "string",
+          "enum": ["ed25519", "rsa-pss-sha256"],
+          "description": "Signature algorithm identifier"
+        },
+        "public_key_id": {
+          "type": "string",
+          "description": "Key id for verifying the pack manifest signature"
+        },
+        "signature": {
+          "type": "string",
+          "description": "Base64-encoded detached signature over canonical JSON (registry TBD)"
+        }
+      }
+    }
+  }
+}

package/schemas/v2/provider-contract.json

@@ -101,6 +101,51 @@
                 "id_field": { "type": "string" },
                 "content_field": { "type": "string" }
               }
+            },
+            "document": {
+              "type": "object",
+              "description": "Maps ContentBlock::Document to provider-native document or inline payload",
+              "properties": {
+                "format": {
+                  "type": "string",
+                  "enum": ["anthropic_document", "gemini_inline_data", "openai_file"],
+                  "description": "Wire shape family for document blocks"
+                },
+                "source_wrapper": {
+                  "type": "string",
+                  "enum": ["anthropic_source", "gemini_inline_data", "openai_file"],
+                  "description": "Nested source object style (Anthropic base64/url source)"
+                },
+                "base64_field": {
+                  "type": "string",
+                  "description": "JSON path to base64 payload relative to encoded block (e.g. source.data, inlineData.data)"
+                },
+                "mime_type_field": {
+                  "type": "string",
+                  "description": "JSON path to MIME type (e.g. source.media_type, inlineData.mimeType)"
+                },
+                "type_field": {
+                  "type": "string",
+                  "description": "Top-level discriminator value when provider uses typed content blocks (e.g. document)"
+                },
+                "default_mime_type": {
+                  "type": "string",
+                  "default": "application/pdf",
+                  "description": "Fallback MIME when unified block omits mime_type"
+                },
+                "ref_resolution": {
+                  "type": "string",
+                  "enum": ["error_before_encode", "resolve_at_runtime"],
+                  "default": "error_before_encode",
+                  "description": "Whether document ref must be resolved before encoder runs"
+                },
+                "supported": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Explicit opt-out when api_style lacks native document blocks"
+                }
+              },
+              "additionalProperties": false
             }
           },
           "additionalProperties": false

package/schemas/v2/provider.json

@@ -190,12 +190,25 @@
     },
     "metadata": {
       "type": "object",
-      "additionalProperties": true,
-      "description": "Additional provider-specific metadata"
+      "description": "Additional provider-specific metadata",
+      "properties": {
+        "models": {
+          "type": "object",
+          "description": "Model-level capacity and operational metadata keyed by model id",
+          "additionalProperties": {
+            "$ref": "./metadata-model-entry.json"
+          }
+        }
+      },
+      "additionalProperties": true
     },
     "pricing": {
       "$ref": "./pricing.json",
       "description": "Optional pricing for cost estimation (per 1k tokens)"
+    },
+    "tool_calling": {
+      "$ref": "./tool-calling.json",
+      "description": "Native function calling and text fallback configuration (optional)"
     }
   },
   "additionalProperties": false