@irogane/kaji 0.2.0-beta.11

package/contracts/tools/conformance-invalid.json

@@ -0,0 +1,271 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "cases": [
+    {
+      "name": "nested required",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "required": ["profile"],
+        "properties": {
+          "profile": {
+            "type": "object",
+            "required": ["email"],
+            "properties": { "email": { "type": "string" } }
+          }
+        }
+      },
+      "arguments": { "profile": {} },
+      "expectedPath": "/profile",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "nested additional property",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "required": ["profile"],
+        "properties": {
+          "profile": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": { "name": { "type": "string" } }
+          }
+        }
+      },
+      "arguments": { "profile": { "extra": true } },
+      "expectedPath": "/profile",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "top-level additional property",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": { "name": { "type": "string" } }
+      },
+      "arguments": { "name": "kaji", "extra": true },
+      "expectedPath": "/",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "const",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "properties": { "mode": { "const": "strict" } }
+      },
+      "arguments": { "mode": "relaxed" },
+      "expectedPath": "/mode",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "enum",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "properties": { "mode": { "enum": ["safe", "strict"] } }
+      },
+      "arguments": { "mode": "other" },
+      "expectedPath": "/mode",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "number minimum",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "properties": { "count": { "type": "integer", "minimum": 1, "maximum": 5 } }
+      },
+      "arguments": { "count": 0 },
+      "expectedPath": "/count",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "number maximum",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "properties": { "count": { "type": "integer", "minimum": 1, "maximum": 5 } }
+      },
+      "arguments": { "count": 6 },
+      "expectedPath": "/count",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "string minimum length",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "properties": { "slug": { "type": "string", "minLength": 3, "maxLength": 8 } }
+      },
+      "arguments": { "slug": "ab" },
+      "expectedPath": "/slug",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "string maximum length",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "properties": { "slug": { "type": "string", "minLength": 3, "maxLength": 8 } }
+      },
+      "arguments": { "slug": "too-long-slug" },
+      "expectedPath": "/slug",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "string pattern",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "properties": { "slug": { "type": "string", "pattern": "^[a-z]+$" } }
+      },
+      "arguments": { "slug": "NOT-valid" },
+      "expectedPath": "/slug",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "array minimum items",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "properties": { "ids": { "type": "array", "minItems": 1, "maxItems": 2 } }
+      },
+      "arguments": { "ids": [] },
+      "expectedPath": "/ids",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "array maximum items",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "properties": { "ids": { "type": "array", "minItems": 1, "maxItems": 2 } }
+      },
+      "arguments": { "ids": [1, 2, 3] },
+      "expectedPath": "/ids",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "array item",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "properties": { "ids": { "type": "array", "items": { "type": "integer" } } }
+      },
+      "arguments": { "ids": [1, "two"] },
+      "expectedPath": "/ids/1",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "email format",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "properties": { "email": { "type": "string", "format": "email" } }
+      },
+      "arguments": { "email": "not-an-email" },
+      "expectedPath": "/email",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "uri format",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "properties": { "url": { "type": "string", "format": "uri" } }
+      },
+      "arguments": { "url": "not a uri" },
+      "expectedPath": "/url",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "union branches",
+      "kind": "invalid_arguments",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "target": {
+            "oneOf": [
+              { "type": "string", "minLength": 1 },
+              { "type": "integer", "minimum": 1 }
+            ]
+          }
+        }
+      },
+      "arguments": { "target": false },
+      "expectedPath": "/target",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "local reference",
+      "kind": "invalid_arguments",
+      "schema": {
+        "$defs": { "positive": { "type": "integer", "minimum": 1 } },
+        "type": "object",
+        "properties": { "value": { "$ref": "#/$defs/positive" } }
+      },
+      "arguments": { "value": 0 },
+      "expectedPath": "/value",
+      "expectedCode": "INVALID_TOOL_ARGUMENTS",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "invalid type declaration",
+      "kind": "invalid_schema",
+      "schema": { "type": "not-a-json-schema-type" },
+      "arguments": {},
+      "expectedPath": "/type",
+      "expectedCode": "INVALID_TOOL_SCHEMA",
+      "expectedMessage": "Tool schema failed schema validation at /type",
+      "retryable": false,
+      "outcome": "not_started"
+    },
+    {
+      "name": "invalid required declaration",
+      "kind": "invalid_schema",
+      "schema": { "type": "object", "required": "name" },
+      "arguments": {},
+      "expectedPath": "/required",
+      "expectedCode": "INVALID_TOOL_SCHEMA",
+      "expectedMessage": "Tool schema failed schema validation at /required",
+      "retryable": false,
+      "outcome": "not_started"
+    }
+  ]
+}

package/contracts/tools/conformance-valid.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "cases": [
+    {
+      "name": "nested object, format, and bounded array",
+      "schema": {
+        "type": "object",
+        "required": ["profile", "tags"],
+        "additionalProperties": false,
+        "properties": {
+          "profile": {
+            "type": "object",
+            "required": ["email", "role"],
+            "additionalProperties": false,
+            "properties": {
+              "email": { "type": "string", "format": "email" },
+              "role": { "enum": ["admin", "member"] }
+            }
+          },
+          "tags": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 3,
+            "items": { "type": "string", "minLength": 2, "maxLength": 8 }
+          }
+        }
+      },
+      "arguments": {
+        "profile": { "email": "user@example.com", "role": "member" },
+        "tags": ["beta"]
+      }
+    },
+    {
+      "name": "const and number bounds",
+      "schema": {
+        "type": "object",
+        "required": ["mode", "count"],
+        "properties": {
+          "mode": { "const": "strict" },
+          "count": { "type": "integer", "minimum": 1, "maximum": 5 }
+        }
+      },
+      "arguments": { "mode": "strict", "count": 3 }
+    },
+    {
+      "name": "union branch",
+      "schema": {
+        "type": "object",
+        "required": ["target"],
+        "properties": {
+          "target": {
+            "oneOf": [
+              { "type": "string", "minLength": 1 },
+              { "type": "integer", "minimum": 1 }
+            ]
+          }
+        }
+      },
+      "arguments": { "target": 2 }
+    },
+    {
+      "name": "local reference",
+      "schema": {
+        "$defs": {
+          "target": {
+            "type": "object",
+            "required": ["url"],
+            "properties": { "url": { "type": "string", "format": "uri" } }
+          }
+        },
+        "type": "object",
+        "required": ["target"],
+        "properties": { "target": { "$ref": "#/$defs/target" } }
+      },
+      "arguments": { "target": { "url": "https://example.com/resource" } }
+    }
+  ]
+}

package/contracts/tools/tool-schema-v1.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kaji.dev/contracts/tools/tool-schema-v1.schema.json",
+  "title": "Kaji tool specification",
+  "type": "object",
+  "required": ["name", "description", "parameters", "risk"],
+  "additionalProperties": false,
+  "properties": {
+    "name": { "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_.-]*$" },
+    "description": { "type": "string", "minLength": 1 },
+    "parameters": { "type": "object" },
+    "risk": {
+      "enum": ["read", "write", "external_effect", "destructive", "admin"]
+    },
+    "parallel_safe": { "type": "boolean", "default": false },
+    "timeout_ms": { "type": "integer", "minimum": 1 }
+  }
+}