@agentproto/corpus-cli 0.1.0-alpha.1 → 0.1.0-alpha.2

package/dist/specs/resources/aip-30/draft/DRIVER.schema.json

@@ -0,0 +1,237 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentproto.sh/docs/aip-30/DRIVER.schema.json",
+  "title": "DRIVER.md frontmatter — agentdriver/v1",
+  "description": "JSON Schema for the YAML frontmatter of an AIP-30 DRIVER.md manifest. Subtype-specific fields (CLI's bin/sandbox/output, HTTP's endpoint/body, etc.) are validated by the subtype AIP's schema.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["name", "id", "description", "version", "kind", "implements"],
+  "properties": {
+    "name":        { "type": "string", "minLength": 1, "maxLength": 80 },
+    "id":          { "type": "string", "pattern": "^[a-z0-9][a-z0-9.\\-]{1,79}$" },
+    "description": { "type": "string", "minLength": 1, "maxLength": 2000 },
+    "version":     { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][\\w.\\-]+)?$" },
+    "kind":        { "type": "string", "enum": ["cli", "http", "mcp", "sdk", "builtin"] },
+    "implements": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/implementsEntry" }
+    },
+    "install": {
+      "type": "array",
+      "items": { "type": "object" },
+      "description": "Inherited from AIP-29 § Install methods. Methods registry validated by subtype schema."
+    },
+    "version_check": { "$ref": "#/$defs/versionCheck" },
+    "auth":          { "$ref": "#/$defs/auth" },
+    "runner": {
+      "oneOf": [
+        { "type": "string", "description": "Workspace-relative path to a RUNNER.md (AIP-17)." },
+        { "type": "object" }
+      ]
+    },
+    "network": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "egress":  { "type": "array", "items": { "type": "string" } },
+        "ingress": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "region": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": ["global"]
+    },
+    "policy_tags": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z0-9][a-z0-9\\-]{0,63}$" },
+      "uniqueItems": true
+    },
+    "cost_override":      { "$ref": "#/$defs/costOverride" },
+    "timeout_override_ms": { "type": "integer", "minimum": 100 },
+    "retry_override":     { "$ref": "#/$defs/retryPolicy" },
+    "health_check":       { "$ref": "#/$defs/healthCheck" },
+    "requires": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "os":             { "type": "array", "items": { "type": "string", "enum": ["darwin", "linux", "windows"] } },
+        "arch":           { "type": "array", "items": { "type": "string", "enum": ["x64", "arm64", "x86", "arm"] } },
+        "min_disk_mb":    { "type": "integer", "minimum": 0 },
+        "min_memory_mb":  { "type": "integer", "minimum": 0 }
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": ["goal"],
+        "properties": {
+          "goal": { "type": "string" },
+          "note": { "type": "string" },
+          "cmd":  { "type": "string", "description": "CLI subtype only" }
+        }
+      }
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z0-9][a-z0-9\\-]{0,63}$" },
+      "uniqueItems": true
+    },
+    "metadata": { "type": "object" }
+  },
+  "$defs": {
+    "implementsEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["tool", "version"],
+      "properties": {
+        "tool":    { "type": "string", "description": "Workspace-relative path or registry id of a TOOL.md." },
+        "version": { "type": "string", "description": "Contract semver range (npm-style)." },
+        "schema_narrowing": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "drop_inputs":  { "type": "array", "items": { "type": "string" } },
+            "drop_outputs": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "mapping": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/mappingValue" }
+        },
+        "cost_override":      { "$ref": "#/$defs/costOverride" },
+        "timeout_override_ms": { "type": "integer", "minimum": 100 },
+        "retry_override":     { "$ref": "#/$defs/retryPolicy" },
+        "metadata":           { "type": "object" }
+      }
+    },
+    "mappingValue": {
+      "oneOf": [
+        { "type": "string", "description": "Identity / rename: tool input → provider input key." },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["from"],
+          "properties": {
+            "from":      { "type": "string" },
+            "transform": { "type": "string", "description": "Named transformer exported by the provider's entry." }
+          }
+        }
+      ]
+    },
+    "versionCheck": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["cmd", "parse", "range"],
+      "properties": {
+        "cmd":        { "type": "string" },
+        "parse":      { "type": "string" },
+        "range":      { "type": "string" },
+        "timeout_ms": { "type": "integer", "minimum": 100, "default": 5000 }
+      }
+    },
+    "auth": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "ref":   { "type": "string" },
+        "state": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "paths": { "type": "array", "items": { "type": "string" } },
+            "env":   { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "login": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "cmd":                   { "type": "string" },
+            "url":                   { "type": "string", "format": "uri" },
+            "interactive":           { "type": "boolean" },
+            "requires_callback_url": { "type": "boolean" },
+            "completes_when": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "cmd":            { "type": "string" },
+                "exit_code":      { "type": "integer" },
+                "http": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["method", "url"],
+                  "properties": {
+                    "method":        { "type": "string", "enum": ["GET", "POST", "HEAD"] },
+                    "url":           { "type": "string", "format": "uri" },
+                    "expect_status": { "type": "integer", "minimum": 100, "maximum": 599 }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "refresh": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "cmd":   { "type": "string" },
+            "url":   { "type": "string", "format": "uri" },
+            "every": { "type": "string", "pattern": "^P(?:T)?\\S+$" }
+          }
+        },
+        "expiry": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "detect": { "type": "string", "description": "exit_code:N | http_status:N | exception:Name | header:NAME:VALUE" }
+          }
+        }
+      }
+    },
+    "costOverride": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "cost_class":          { "type": "string", "enum": ["trivial", "metered", "expensive"] },
+        "cost_units_per_call": { "type": "number", "minimum": 0, "description": "Millicents per call." },
+        "currency":            { "type": "string", "pattern": "^[A-Z]{3}$" }
+      }
+    },
+    "retryPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["max_attempts"],
+      "properties": {
+        "max_attempts": { "type": "integer", "minimum": 1, "maximum": 10 },
+        "backoff":      { "type": "string", "enum": ["fixed", "exponential"] },
+        "initial_ms":   { "type": "integer", "minimum": 0 }
+      }
+    },
+    "healthCheck": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["method"],
+      "properties": {
+        "method":      { "type": "string", "enum": ["ping", "exec", "http", "noop"] },
+        "cmd":         { "type": "string", "description": "Used when method=exec" },
+        "http": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["method", "url"],
+          "properties": {
+            "method":        { "type": "string", "enum": ["GET", "POST", "HEAD"] },
+            "url":           { "type": "string", "format": "uri" },
+            "expect_status": { "type": "integer", "minimum": 100, "maximum": 599 }
+          }
+        },
+        "expect_exit": { "type": "integer" },
+        "every":       { "type": "string", "pattern": "^P(?:T)?\\S+$" },
+        "timeout_ms":  { "type": "integer", "minimum": 100, "default": 5000 }
+      }
+    }
+  }
+}

package/dist/specs/resources/aip-31/draft/HTTP.schema.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentproto.sh/docs/aip-31/HTTP.schema.json",
+  "title": "HTTP.md frontmatter — agenthttp/v1 (HTTP provider specialisation)",
+  "description": "Validates the HTTP-specific frontmatter fields of an AIP-31 DRIVER.md (kind: http). Universal PROVIDER fields validate via AIP-30's schema.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["kind", "base_url"],
+  "properties": {
+    "kind":     { "const": "http" },
+    "base_url": { "type": "string", "format": "uri" },
+    "default_headers": {
+      "type": "object",
+      "additionalProperties": { "type": "string" }
+    },
+    "default_method": {
+      "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"],
+      "default": "POST"
+    },
+    "streaming": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["transport"],
+      "properties": {
+        "transport":   { "enum": ["sse", "ndjson", "chunked"] },
+        "event_field": { "type": "string" },
+        "terminator":  { "type": "string" }
+      }
+    },
+    "rate_limit": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "requests_per_minute": { "type": "integer", "minimum": 1 },
+        "burst":               { "type": "integer", "minimum": 1 }
+      }
+    },
+    "implements": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["tool", "version"],
+        "additionalProperties": true,
+        "properties": {
+          "metadata": {
+            "type": "object",
+            "properties": {
+              "http": { "$ref": "#/$defs/perToolHttp" }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "perToolHttp": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["endpoint"],
+      "properties": {
+        "endpoint":   { "type": "string", "description": "Path relative to base_url, e.g. /v1/images/generations" },
+        "method":     { "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"] },
+        "headers":    { "type": "object", "additionalProperties": { "type": "string" } },
+        "body_template":   { "type": "object" },
+        "query_template":  { "type": "object", "additionalProperties": { "type": "string" } },
+        "response_extract": { "type": "string", "description": "JSONPath-lite expression. Default: $" },
+        "streaming": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "transport":   { "enum": ["sse", "ndjson", "chunked"] },
+            "event_field": { "type": "string" },
+            "terminator":  { "type": "string" }
+          }
+        },
+        "idempotency_key_header": { "type": "string" }
+      }
+    }
+  }
+}

package/dist/specs/resources/aip-32/draft/MCP.schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentproto.sh/docs/aip-32/MCP.schema.json",
+  "title": "MCP.md frontmatter — agentmcp/v1",
+  "description": "Validates the MCP-specific frontmatter of an AIP-32 DRIVER.md (kind: mcp). Universal PROVIDER fields validate via AIP-30's schema.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["kind", "server", "transport"],
+  "properties": {
+    "kind":      { "const": "mcp" },
+    "server":    { "$ref": "#/$defs/server" },
+    "transport": { "enum": ["stdio", "sse", "http"] },
+    "protocol_version": { "type": "string" },
+    "prompts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "integrate_as"],
+        "additionalProperties": false,
+        "properties": {
+          "name":         { "type": "string" },
+          "description":  { "type": "string" },
+          "integrate_as": { "enum": ["skill_block", "raw"] },
+          "skill_ref":    { "type": "string" }
+        }
+      }
+    },
+    "resources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["uri_template", "integrate_as"],
+        "additionalProperties": false,
+        "properties": {
+          "uri_template": { "type": "string" },
+          "description":  { "type": "string" },
+          "integrate_as": { "enum": ["ref_kind", "raw"] },
+          "ref_kind_id":  { "type": "string", "pattern": "^[a-z][a-z0-9_]*$" }
+        }
+      }
+    },
+    "connection_options": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "timeout_ms":  { "type": "integer", "minimum": 100 },
+        "max_retries": { "type": "integer", "minimum": 0, "maximum": 10 },
+        "keepalive":   { "type": "boolean" }
+      }
+    },
+    "implements": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["tool", "version"],
+        "additionalProperties": true,
+        "properties": {
+          "metadata": {
+            "type": "object",
+            "properties": {
+              "mcp": { "$ref": "#/$defs/perToolMcp" }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "server": {
+      "oneOf": [
+        { "type": "object", "required": ["kind", "path"],    "properties": { "kind": { "const": "binary" }, "path": { "type": "string" }, "args": { "type": "array", "items": { "type": "string" } }, "env": { "type": "object", "additionalProperties": { "type": "string" } } } },
+        { "type": "object", "required": ["kind", "package"], "properties": { "kind": { "const": "npm" },    "package": { "type": "string" }, "args": { "type": "array", "items": { "type": "string" } }, "env": { "type": "object", "additionalProperties": { "type": "string" } } } },
+        { "type": "object", "required": ["kind", "image"],   "properties": { "kind": { "const": "docker" }, "image": { "type": "string" }, "args": { "type": "array", "items": { "type": "string" } }, "env": { "type": "object", "additionalProperties": { "type": "string" } } } },
+        { "type": "object", "required": ["kind", "url"],     "properties": { "kind": { "const": "remote" }, "url": { "type": "string", "format": "uri" } } }
+      ]
+    },
+    "perToolMcp": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["tool_name"],
+      "properties": {
+        "tool_name":         { "type": "string" },
+        "argument_mapping":  { "type": "object", "additionalProperties": { "type": "string" } },
+        "result_extract":    { "type": "string" }
+      }
+    }
+  }
+}

package/dist/specs/resources/aip-33/draft/SDK.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentproto.sh/docs/aip-33/SDK.schema.json",
+  "title": "SDK.md frontmatter — agentsdk/v1",
+  "description": "Validates the SDK-specific frontmatter of an AIP-33 DRIVER.md (kind: sdk). Universal PROVIDER fields validate via AIP-30's schema.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["kind", "package", "package_manager"],
+  "properties": {
+    "kind":             { "const": "sdk" },
+    "package":          { "type": "string", "minLength": 1 },
+    "package_manager":  { "enum": ["npm", "pnpm", "yarn", "pip", "poetry", "cargo", "go", "local"] },
+    "package_version":  { "type": "string" },
+    "entrypoint":       { "type": "string" },
+    "import_style":     { "enum": ["esm", "cjs", "python", "rust-crate", "go-module"], "default": "esm" },
+    "streaming": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode"],
+      "properties": {
+        "mode": { "enum": ["async-iterator", "callback"] }
+      }
+    },
+    "implements": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["tool", "version"],
+        "additionalProperties": true,
+        "properties": {
+          "metadata": {
+            "type": "object",
+            "properties": {
+              "sdk": { "$ref": "#/$defs/perToolSdk" }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "perToolSdk": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["function_ref"],
+      "properties": {
+        "function_ref":   { "type": "string", "description": "Dotted ref - 'default', 'createImage', 'images.create', 'Client.images.create'" },
+        "args_template":  { "type": "object" },
+        "result_extract": { "type": "string" },
+        "streaming": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "mode": { "enum": ["async-iterator", "callback"] }
+          }
+        }
+      }
+    }
+  }
+}