@agentique.io/schemas 0.1.0

package/output-contract.schema.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agentique.io/output-contract.schema.json",
+  "title": "Agentique Public Output Contract",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["inputSchema", "outputSchema", "maxOutputBytes", "timeoutMs", "errorBehavior", "redaction"],
+  "properties": {
+    "inputSchema": {
+      "$ref": "#/$defs/jsonSchemaObject"
+    },
+    "outputSchema": {
+      "$ref": "#/$defs/jsonSchemaObject"
+    },
+    "structuredContent": {
+      "type": "boolean"
+    },
+    "unstructuredFallback": {
+      "type": "string",
+      "enum": ["none", "summary", "public-text"]
+    },
+    "maxOutputBytes": {
+      "type": "integer",
+      "minimum": 256,
+      "maximum": 262144
+    },
+    "timeoutMs": {
+      "type": "integer",
+      "minimum": 100,
+      "maximum": 300000
+    },
+    "limitHints": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "maxItems": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1000
+        },
+        "maxRequests": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100
+        }
+      }
+    },
+    "errorBehavior": {
+      "type": "string",
+      "enum": ["typed-error", "empty-result", "partial-result"]
+    },
+    "redaction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["secrets", "privateFields"],
+      "properties": {
+        "secrets": {
+          "type": "boolean",
+          "const": true
+        },
+        "privateFields": {
+          "type": "boolean",
+          "const": true
+        },
+        "notes": {
+          "type": "string",
+          "minLength": 12,
+          "maxLength": 240
+        }
+      }
+    }
+  },
+  "$defs": {
+    "jsonSchemaObject": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["object", "array", "string", "number", "integer", "boolean"]
+        }
+      }
+    }
+  }
+}

package/package-manifest.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agentique.io/package-manifest.schema.json",
+  "title": "Agentique Public Package Manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["formatVersion", "files", "hashes"],
+  "properties": {
+    "formatVersion": {
+      "type": "string",
+      "const": "1.0"
+    },
+    "files": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 200,
+      "items": {
+        "type": "string",
+        "pattern": "^(?!/)(?![A-Za-z]:)(?!.*(?:^|/)\\.env(?:/|$))(?!.*(?:^|/)\\.git(?:/|$))(?!.*(?:^|/)\\.cache(?:/|$))(?!.*(?:^|/)node_modules(?:/|$))(?!.*(?:^|/)private(?:/|$))(?!.*\\.\\.)(?!.*[\\\\]).{1,160}$"
+      }
+    },
+    "hashes": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string",
+        "pattern": "^sha256:[a-f0-9]{64}$"
+      },
+      "propertyNames": {
+        "pattern": "^(?!/)(?![A-Za-z]:)(?!.*(?:^|/)\\.env(?:/|$))(?!.*(?:^|/)\\.git(?:/|$))(?!.*(?:^|/)\\.cache(?:/|$))(?!.*(?:^|/)node_modules(?:/|$))(?!.*(?:^|/)private(?:/|$))(?!.*\\.\\.)(?!.*[\\\\]).{1,160}$"
+      },
+      "minProperties": 1,
+      "maxProperties": 200
+    }
+  }
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@agentique.io/schemas",
+  "version": "0.1.0",
+  "description": "Public JSON Schema contracts for Agentique resource preparation.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rookiestar28/Agentique.git",
+    "directory": "schemas"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "files": [
+    "*.schema.json",
+    "fixtures"
+  ]
+}

package/permission-risk.schema.json

@@ -0,0 +1,108 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agentique.io/permission-risk.schema.json",
+  "title": "Agentique Public Permission And Risk Declaration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["readOnly", "destructive", "openWorld", "approvalRequired", "dataSensitivity"],
+  "properties": {
+    "readOnly": {
+      "type": "boolean"
+    },
+    "destructive": {
+      "type": "boolean"
+    },
+    "idempotent": {
+      "type": "boolean"
+    },
+    "openWorld": {
+      "type": "boolean"
+    },
+    "externalNetwork": {
+      "type": "boolean"
+    },
+    "credentialed": {
+      "type": "boolean"
+    },
+    "approvalRequired": {
+      "type": "boolean"
+    },
+    "dataSensitivity": {
+      "type": "string",
+      "enum": ["public", "user-provided", "sensitive", "unknown"]
+    },
+    "capabilities": {
+      "type": "array",
+      "maxItems": 12,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "enum": [
+          "read-public-content",
+          "read-user-provided-content",
+          "external-network",
+          "credential-use",
+          "upload",
+          "download",
+          "filesystem-read",
+          "filesystem-write",
+          "state-mutation",
+          "human-approval"
+        ]
+      }
+    },
+    "reviewNotes": {
+      "type": "string",
+      "minLength": 12,
+      "maxLength": 400
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "destructive": {
+            "const": true
+          }
+        },
+        "required": ["destructive"]
+      },
+      "then": {
+        "properties": {
+          "approvalRequired": {
+            "const": true
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "anyOf": [
+          {
+            "properties": {
+              "credentialed": {
+                "const": true
+              }
+            },
+            "required": ["credentialed"]
+          },
+          {
+            "properties": {
+              "dataSensitivity": {
+                "enum": ["sensitive", "unknown"]
+              }
+            },
+            "required": ["dataSensitivity"]
+          }
+        ]
+      },
+      "then": {
+        "properties": {
+          "approvalRequired": {
+            "const": true
+          }
+        }
+      }
+    }
+  ]
+}

package/public-readback.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agentique.io/public-readback.schema.json",
+  "title": "Agentique Public Readback Projection",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["resourceId", "state", "updatedAt", "platformUrl"],
+  "properties": {
+    "resourceId": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]{1,80}$"
+    },
+    "state": {
+      "type": "string",
+      "enum": ["draft", "review_required", "published", "blocked", "unavailable", "stale"]
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "platformUrl": {
+      "type": "string",
+      "format": "uri",
+      "pattern": "^https://agentique\\.io/"
+    },
+    "message": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 240
+    },
+    "internalId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 120
+    },
+    "storageUsage": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": {
+            "anyOf": [
+              { "type": "number" },
+              { "type": "integer" },
+              { "type": "string" },
+              { "type": "boolean" },
+              { "type": "null" }
+            ]
+          }
+        },
+        {
+          "type": "number",
+          "minimum": 0
+        }
+      ]
+    },
+    "deploymentDate": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "tokenCount": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "objectType": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 80
+    },
+    "storageMode": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 80
+    }
+  }
+}

package/resource-manifest.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agentique.io/resource-manifest.schema.json",
+  "title": "Agentique Public Resource Manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["formatVersion", "name", "summary", "source", "distribution", "package"],
+  "properties": {
+    "formatVersion": {
+      "type": "string",
+      "const": "1.0"
+    },
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]{1,63}$"
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 12,
+      "maxLength": 240
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "url"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["git", "website", "package"]
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "pattern": "^https://"
+        }
+      }
+    },
+    "distribution": {
+      "$ref": "https://schemas.agentique.io/distribution-mode.schema.json"
+    },
+    "package": {
+      "$ref": "https://schemas.agentique.io/package-manifest.schema.json"
+    },
+    "skill": {
+      "$ref": "https://schemas.agentique.io/skill-metadata.schema.json"
+    },
+    "workflow": {
+      "$ref": "https://schemas.agentique.io/workflow-metadata.schema.json"
+    },
+    "surfacing": {
+      "$ref": "https://schemas.agentique.io/surfacing-metadata.schema.json"
+    },
+    "permissionRisk": {
+      "$ref": "https://schemas.agentique.io/permission-risk.schema.json"
+    }
+  }
+}

package/skill-metadata.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agentique.io/skill-metadata.schema.json",
+  "title": "Agentique Public Skill Metadata",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["name", "summary", "inputs", "outputs"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]{1,63}$"
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 12,
+      "maxLength": 240
+    },
+    "inputs": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 20,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 80
+      }
+    },
+    "outputs": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 20,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 80
+      }
+    },
+    "outputContract": {
+      "$ref": "https://schemas.agentique.io/output-contract.schema.json"
+    }
+  }
+}

package/surfacing-metadata.schema.json

@@ -0,0 +1,109 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agentique.io/surfacing-metadata.schema.json",
+  "title": "Agentique Public Surfacing Metadata",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["taskIntents", "audience", "priority", "contextBudget"],
+  "properties": {
+    "taskIntents": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 8,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 3,
+        "maxLength": 48,
+        "pattern": "^[a-z0-9][a-z0-9-]*$"
+      }
+    },
+    "audience": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 6,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "enum": ["agent", "human", "developer", "reviewer", "integrator"]
+      }
+    },
+    "priority": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1,
+      "multipleOf": 0.01
+    },
+    "recency": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["lastReviewedAt"],
+      "properties": {
+        "lastReviewedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "reviewCadenceDays": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 365
+        }
+      }
+    },
+    "compatibility": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "runtimeFamilies": {
+          "type": "array",
+          "maxItems": 8,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 2,
+            "maxLength": 40,
+            "pattern": "^[a-z0-9][a-z0-9.+-]*$"
+          }
+        },
+        "protocols": {
+          "type": "array",
+          "maxItems": 8,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 2,
+            "maxLength": 40,
+            "pattern": "^[a-z0-9][a-z0-9.+-]*$"
+          }
+        }
+      }
+    },
+    "contextBudget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["maxTokens", "maxBytes"],
+      "properties": {
+        "maxTokens": {
+          "type": "integer",
+          "minimum": 128,
+          "maximum": 32000
+        },
+        "maxBytes": {
+          "type": "integer",
+          "minimum": 1024,
+          "maximum": 262144
+        },
+        "preferredSummaryBytes": {
+          "type": "integer",
+          "minimum": 256,
+          "maximum": 32768
+        }
+      }
+    },
+    "notes": {
+      "type": "string",
+      "minLength": 12,
+      "maxLength": 400
+    }
+  }
+}

package/tool-listing.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agentique.io/tool-listing.schema.json",
+  "title": "Agentique Public Tool Listing",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["name", "summary", "capabilities", "permissionRisk", "outputContract", "documentationUrl"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]{1,63}$"
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 12,
+      "maxLength": 240
+    },
+    "capabilities": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 20,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 2,
+        "maxLength": 48,
+        "pattern": "^[a-z0-9][a-z0-9-]*$"
+      }
+    },
+    "permissionRisk": {
+      "$ref": "https://schemas.agentique.io/permission-risk.schema.json"
+    },
+    "outputContract": {
+      "$ref": "https://schemas.agentique.io/output-contract.schema.json"
+    },
+    "supportUrl": {
+      "type": "string",
+      "format": "uri",
+      "pattern": "^https://"
+    },
+    "documentationUrl": {
+      "type": "string",
+      "format": "uri",
+      "pattern": "^https://"
+    }
+  }
+}

package/workflow-metadata.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agentique.io/workflow-metadata.schema.json",
+  "title": "Agentique Public Workflow Metadata",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["name", "summary", "steps"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]{1,63}$"
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 12,
+      "maxLength": 240
+    },
+    "steps": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 40,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "description"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9][a-z0-9-]{1,63}$"
+          },
+          "description": {
+            "type": "string",
+            "minLength": 8,
+            "maxLength": 240
+          }
+        }
+      }
+    },
+    "outputContract": {
+      "$ref": "https://schemas.agentique.io/output-contract.schema.json"
+    }
+  }
+}