@aiwg/cli 2026.10.1 → 2026.10.4

package/schemas/models/provider-model-capabilities.v1.schema.json

@@ -0,0 +1,1072 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiwg.io/schemas/models/provider-model-capabilities.v1.schema.json",
+  "title": "AIWG provider model capability registry",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "verifiedAt",
+    "providers"
+  ],
+  "properties": {
+    "version": {
+      "const": "1.0.0"
+    },
+    "verifiedAt": {
+      "type": "string",
+      "format": "date"
+    },
+    "providers": {
+      "type": "object",
+      "minProperties": 11,
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "agent",
+          "skill",
+          "globalChild",
+          "identifierSyntax",
+          "inheritance",
+          "invalidPinFallback",
+          "configTarget",
+          "artifactFormat",
+          "verification",
+          "sourceUrl",
+          "verifiedAt"
+        ],
+        "properties": {
+          "sessionEnvAllowlist": {
+            "description": "Exact provider auth/config names for legacy full agent sessions, in addition to the launcher's base environment. Independent of worker invocation allowlists.",
+            "type": "array",
+            "items": { "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" },
+            "uniqueItems": true
+          },
+          "agent": {
+            "$ref": "#/$defs/control"
+          },
+          "skill": {
+            "$ref": "#/$defs/control"
+          },
+          "globalChild": {
+            "$ref": "#/$defs/control"
+          },
+          "identifierSyntax": {
+            "type": "string",
+            "minLength": 1
+          },
+          "effortValues": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "uniqueItems": true
+          },
+          "inheritance": {
+            "type": "string",
+            "minLength": 1
+          },
+          "invalidPinFallback": {
+            "type": "string",
+            "minLength": 1
+          },
+          "configTarget": {
+            "type": "string",
+            "minLength": 1
+          },
+          "artifactFormat": {
+            "type": "string",
+            "minLength": 1
+          },
+          "verification": {
+            "type": "string",
+            "minLength": 1
+          },
+          "sourceUrl": {
+            "type": "string",
+            "format": "uri"
+          },
+          "verifiedAt": {
+            "type": "string",
+            "format": "date"
+          },
+          "workerAdapter": {
+            "$ref": "#/$defs/workerAdapter"
+          },
+          "workerHealthAdapter": {
+            "description": "Descriptive health evidence only; does not register an executable worker adapter.",
+            "$ref": "#/$defs/workerAdapter"
+          },
+          "workerHealthCoverage": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "scope": {
+                "const": "out"
+              },
+              "coverage": {
+                "const": "unobserved"
+              },
+              "handshake": {
+                "const": "unobserved"
+              },
+              "evidenceGrades": {
+                "type": "array",
+                "maxItems": 3,
+                "uniqueItems": true,
+                "items": {
+                  "enum": [
+                    "H",
+                    "R",
+                    "D"
+                  ]
+                }
+              },
+              "qualificationOwner": {
+                "type": "string",
+                "pattern": "^B-OG-[0-9]{2}$"
+              },
+              "provenance": {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 16,
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 4096
+                }
+              },
+              "reason": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 4096
+              }
+            },
+            "required": [
+              "scope",
+              "coverage",
+              "handshake",
+              "evidenceGrades",
+              "qualificationOwner",
+              "provenance",
+              "reason"
+            ]
+          }
+        }
+      }
+    },
+    "workerAdapters": {
+      "type": "object",
+      "maxProperties": 128,
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9-]{0,62}$"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/workerAdapter"
+      }
+    },
+    "workerHealthAdapters": {
+      "description": "Descriptive health evidence only; entries do not register executable worker adapters.",
+      "type": "object",
+      "maxProperties": 128,
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9-]{0,62}$"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/workerAdapter"
+      }
+    },
+    "$schema": {
+      "enum": [
+        "../../../schemas/models/provider-model-capabilities.v1.schema.json",
+        "https://aiwg.io/schemas/models/provider-model-capabilities.v1.schema.json"
+      ]
+    }
+  },
+  "$defs": {
+    "control": {
+      "enum": [
+        "native",
+        "compiled",
+        "inherited",
+        "global-only",
+        "informational",
+        "unsupported"
+      ]
+    },
+    "process": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "kind": {
+          "const": "process"
+        },
+        "executable": {
+          "type": "string",
+          "minLength": 1
+        },
+        "argv": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1
+        },
+        "stdin": {
+          "enum": [
+            "closed",
+            "brief-json",
+            "brief-text",
+            "adapter-frame"
+          ]
+        },
+        "cwd": {
+          "const": "${workspace}"
+        },
+        "envAllowlist": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 0,
+          "uniqueItems": true
+        },
+        "versionArgv": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1
+        },
+        "versionPattern": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "maxOutputBytes": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 10485760
+        }
+      },
+      "required": [
+        "kind",
+        "executable",
+        "argv",
+        "stdin",
+        "cwd",
+        "envAllowlist",
+        "versionArgv"
+      ]
+    },
+    "http": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "kind": {
+          "const": "http"
+        },
+        "protocol": {
+          "enum": [
+            "ollama",
+            "llama-cpp",
+            "openai-compatible"
+          ]
+        },
+        "healthPath": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^/"
+        },
+        "modelsPath": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^/"
+        },
+        "generatePath": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^/"
+        },
+        "timeoutSeconds": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 900
+        },
+        "maxOutputBytes": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 10485760
+        }
+      },
+      "required": [
+        "kind",
+        "protocol",
+        "healthPath",
+        "modelsPath",
+        "generatePath"
+      ]
+    },
+    "catalogAdapter": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "kind": {
+          "enum": [
+            "command",
+            "file",
+            "http",
+            "module"
+          ]
+        },
+        "locator": {
+          "type": "string",
+          "minLength": 1
+        },
+        "argv": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 0
+        },
+        "parser": {
+          "type": "string",
+          "minLength": 1
+        },
+        "timeoutSeconds": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 10
+        },
+        "maxBytes": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 5242880
+        }
+      },
+      "required": [
+        "kind",
+        "locator",
+        "parser"
+      ]
+    },
+    "invocationProfile": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "transport": {
+          "enum": [
+            "shell",
+            "mcp"
+          ]
+        },
+        "supportedVersions": {
+          "type": "string",
+          "minLength": 1
+        },
+        "controls": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "support": {
+                "enum": [
+                  "native",
+                  "external",
+                  "not-applicable",
+                  "unqualified"
+                ]
+              },
+              "mapping": {
+                "type": "string",
+                "maxLength": 2048
+              },
+              "evidence": {
+                "type": "string",
+                "maxLength": 2048
+              }
+            },
+            "required": [
+              "support",
+              "mapping",
+              "evidence"
+            ]
+          },
+          "required": [
+            "model",
+            "effort",
+            "sandbox",
+            "approval",
+            "workdir",
+            "finalOutput",
+            "stdin",
+            "structuredOutput",
+            "stepCap",
+            "trust",
+            "children",
+            "fallback"
+          ],
+          "properties": {
+            "model": {
+              "$ref": "#/$defs/invocationProfile/properties/controls/additionalProperties"
+            },
+            "effort": {
+              "$ref": "#/$defs/invocationProfile/properties/controls/additionalProperties"
+            },
+            "sandbox": {
+              "$ref": "#/$defs/invocationProfile/properties/controls/additionalProperties"
+            },
+            "approval": {
+              "$ref": "#/$defs/invocationProfile/properties/controls/additionalProperties"
+            },
+            "workdir": {
+              "$ref": "#/$defs/invocationProfile/properties/controls/additionalProperties"
+            },
+            "finalOutput": {
+              "$ref": "#/$defs/invocationProfile/properties/controls/additionalProperties"
+            },
+            "stdin": {
+              "$ref": "#/$defs/invocationProfile/properties/controls/additionalProperties"
+            },
+            "structuredOutput": {
+              "$ref": "#/$defs/invocationProfile/properties/controls/additionalProperties"
+            },
+            "stepCap": {
+              "$ref": "#/$defs/invocationProfile/properties/controls/additionalProperties"
+            },
+            "trust": {
+              "$ref": "#/$defs/invocationProfile/properties/controls/additionalProperties"
+            },
+            "children": {
+              "$ref": "#/$defs/invocationProfile/properties/controls/additionalProperties"
+            },
+            "fallback": {
+              "$ref": "#/$defs/invocationProfile/properties/controls/additionalProperties"
+            }
+          }
+        },
+        "envAllowlist": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true
+        },
+        "pitfalls": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "maxLength": 2048
+          }
+        },
+        "mcp": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "serverRef": {
+              "type": "string"
+            },
+            "tool": {
+              "type": "string"
+            },
+            "inputSchemaDigest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            },
+            "outputSchemaDigest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            },
+            "sessionIsolation": {
+              "enum": [
+                "per-call",
+                "per-instance",
+                "serialized"
+              ]
+            },
+            "cancel": {
+              "enum": [
+                "confirmed",
+                "uncertain"
+              ]
+            }
+          },
+          "required": [
+            "serverRef",
+            "tool",
+            "inputSchemaDigest",
+            "outputSchemaDigest",
+            "sessionIsolation",
+            "cancel"
+          ]
+        },
+        "installationQualification": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "scopeDigest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            },
+            "fixtureDigest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            },
+            "verifiedAt": {
+              "type": "string",
+              "format": "date-time"
+            },
+            "evidenceRef": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "required": [
+            "scopeDigest",
+            "fixtureDigest",
+            "verifiedAt",
+            "evidenceRef"
+          ]
+        },
+        "health": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "version": {
+              "const": 1
+            },
+            "handshake": {
+              "enum": [
+                "semantic",
+                "process-only",
+                "unobserved"
+              ]
+            },
+            "outputFraming": {
+              "enum": [
+                "jsonl",
+                "plain",
+                "final-json",
+                "http-stream",
+                "mcp-progress",
+                "opaque"
+              ]
+            },
+            "signalParser": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 4096
+            },
+            "sessionLogLocator": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "maxLength": 4096
+            },
+            "progressEvidence": {
+              "type": "array",
+              "maxItems": 16,
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 4096
+              }
+            },
+            "stopEvidence": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 4096
+            },
+            "fixtureRef": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 4096
+            },
+            "qualifiedAt": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "format": "date-time"
+            },
+            "statusOperation": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "maxLength": 256
+            },
+            "cancelOperation": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "maxLength": 256
+            },
+            "coverage": {
+              "enum": [
+                "full",
+                "degraded",
+                "unobserved"
+              ]
+            },
+            "qualificationTarget": {
+              "enum": [
+                "semantic",
+                "process-only",
+                "unobserved"
+              ]
+            },
+            "evidenceGrades": {
+              "type": "array",
+              "maxItems": 3,
+              "uniqueItems": true,
+              "items": {
+                "enum": [
+                  "H",
+                  "R",
+                  "D"
+                ]
+              }
+            },
+            "provenance": {
+              "type": "array",
+              "maxItems": 16,
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "kind": {
+                    "enum": [
+                      "help",
+                      "repository",
+                      "documentation",
+                      "synthetic"
+                    ]
+                  },
+                  "ref": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 4096
+                  },
+                  "observedAt": {
+                    "type": "string",
+                    "format": "date-time"
+                  },
+                  "cliVersion": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "minLength": 1,
+                    "maxLength": 256
+                  }
+                },
+                "required": [
+                  "kind",
+                  "ref",
+                  "observedAt",
+                  "cliVersion"
+                ]
+              }
+            },
+            "qualificationOwner": {
+              "type": "string",
+              "pattern": "^B-OG-[0-9]{2}$"
+            },
+            "qualification": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "status": {
+                  "enum": [
+                    "unqualified",
+                    "synthetic",
+                    "live-qualified"
+                  ]
+                },
+                "scopeDigest": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "pattern": "^sha256:[a-f0-9]{64}$"
+                },
+                "cliVersion": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "minLength": 1,
+                  "maxLength": 256
+                },
+                "accountScope": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "minLength": 1,
+                  "maxLength": 256
+                },
+                "profileRef": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "minLength": 1,
+                  "maxLength": 256
+                },
+                "modelKey": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "minLength": 1,
+                  "maxLength": 4096
+                },
+                "effort": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "minLength": 1,
+                  "maxLength": 256
+                },
+                "authorizedLive": {
+                  "type": "boolean"
+                }
+              },
+              "required": [
+                "status",
+                "scopeDigest",
+                "cliVersion",
+                "accountScope",
+                "profileRef",
+                "modelKey",
+                "effort",
+                "authorizedLive"
+              ],
+              "allOf": [
+                {
+                  "if": {
+                    "properties": {
+                      "status": {
+                        "enum": [
+                          "synthetic",
+                          "live-qualified"
+                        ]
+                      }
+                    }
+                  },
+                  "then": {
+                    "properties": {
+                      "scopeDigest": {
+                        "type": "string"
+                      },
+                      "cliVersion": {
+                        "type": "string"
+                      },
+                      "accountScope": {
+                        "type": "string"
+                      },
+                      "profileRef": {
+                        "type": "string"
+                      },
+                      "modelKey": {
+                        "type": "string"
+                      }
+                    }
+                  }
+                },
+                {
+                  "if": {
+                    "properties": {
+                      "status": {
+                        "const": "live-qualified"
+                      }
+                    }
+                  },
+                  "then": {
+                    "properties": {
+                      "authorizedLive": {
+                        "const": true
+                      }
+                    }
+                  }
+                }
+              ]
+            }
+          },
+          "required": [
+            "version",
+            "handshake",
+            "outputFraming",
+            "signalParser",
+            "sessionLogLocator",
+            "progressEvidence",
+            "stopEvidence",
+            "fixtureRef",
+            "qualifiedAt",
+            "statusOperation",
+            "cancelOperation"
+          ],
+          "allOf": [
+            {
+              "if": {
+                "required": [
+                  "qualification"
+                ],
+                "properties": {
+                  "qualification": {
+                    "properties": {
+                      "status": {
+                        "enum": [
+                          "synthetic",
+                          "live-qualified"
+                        ]
+                      }
+                    },
+                    "type": "object"
+                  }
+                }
+              },
+              "then": {
+                "properties": {
+                  "qualifiedAt": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          ]
+        }
+      },
+      "required": [
+        "transport",
+        "supportedVersions",
+        "controls",
+        "envAllowlist",
+        "pitfalls"
+      ],
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "transport": {
+                "const": "mcp"
+              }
+            }
+          },
+          "then": {
+            "properties": {
+              "mcp": {}
+            },
+            "required": [
+              "mcp"
+            ]
+          }
+        }
+      ]
+    },
+    "workerAdapter": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "version": {
+          "const": 1
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "provider": {
+          "type": "string",
+          "minLength": 1
+        },
+        "adapterVersion": {
+          "type": "string",
+          "minLength": 1
+        },
+        "supportedVersions": {
+          "type": "string",
+          "minLength": 1
+        },
+        "runtimeDriver": {
+          "type": "string",
+          "minLength": 1
+        },
+        "catalogAdapter": {
+          "$ref": "#/$defs/catalogAdapter"
+        },
+        "invocation": {
+          "oneOf": [
+            {
+              "$ref": "#/$defs/process"
+            },
+            {
+              "$ref": "#/$defs/http"
+            }
+          ]
+        },
+        "capabilities": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "output": {
+              "enum": [
+                "native-schema",
+                "validated-file",
+                "text"
+              ]
+            },
+            "modelPin": {
+              "enum": [
+                "observed",
+                "requested",
+                "unsupported"
+              ]
+            },
+            "effort": {
+              "enum": [
+                "explicit",
+                "not-applicable",
+                "unsupported"
+              ]
+            },
+            "cancel": {
+              "enum": [
+                "process-group",
+                "session",
+                "none"
+              ]
+            },
+            "resume": {
+              "type": "boolean"
+            },
+            "sandboxModes": {
+              "type": "array",
+              "items": {
+                "enum": [
+                  "read-only",
+                  "workspace-write",
+                  "external"
+                ]
+              },
+              "minItems": 1,
+              "uniqueItems": true
+            },
+            "nestedAgentsControllable": {
+              "type": "boolean"
+            },
+            "nativeFallbackControllable": {
+              "type": "boolean"
+            },
+            "hardBudget": {
+              "type": "array",
+              "items": {
+                "enum": [
+                  "tokens",
+                  "cost",
+                  "wall-time"
+                ]
+              },
+              "minItems": 0,
+              "uniqueItems": true
+            }
+          },
+          "required": [
+            "output",
+            "modelPin",
+            "effort",
+            "cancel",
+            "resume",
+            "sandboxModes",
+            "nestedAgentsControllable",
+            "nativeFallbackControllable",
+            "hardBudget"
+          ]
+        },
+        "qualification": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "status": {
+              "enum": [
+                "unqualified",
+                "qualified"
+              ]
+            },
+            "fixtureDigest": {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            },
+            "verifiedAt": {
+              "type": "string",
+              "minLength": 1,
+              "format": "date-time"
+            },
+            "evidenceRef": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "required": [
+            "status"
+          ],
+          "allOf": [
+            {
+              "if": {
+                "properties": {
+                  "status": {
+                    "const": "qualified"
+                  }
+                }
+              },
+              "then": {
+                "properties": {
+                  "fixtureDigest": {},
+                  "verifiedAt": {},
+                  "evidenceRef": {}
+                },
+                "required": [
+                  "fixtureDigest",
+                  "verifiedAt",
+                  "evidenceRef"
+                ]
+              }
+            }
+          ]
+        },
+        "invocationProfiles": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "$ref": "#/$defs/invocationProfile"
+          }
+        }
+      },
+      "required": [
+        "version",
+        "id",
+        "provider",
+        "adapterVersion",
+        "supportedVersions",
+        "runtimeDriver",
+        "catalogAdapter",
+        "invocation",
+        "capabilities",
+        "qualification"
+      ]
+    }
+  }
+}