@agentique.io/schemas 0.1.0

package/fixtures/schema-fixtures.json

@@ -0,0 +1,588 @@
+{
+  "context-bundle.schema.json": {
+    "valid": {
+      "bundleId": "example-context-bundle",
+      "summary": "A small public context bundle with selected public content.",
+      "budget": {
+        "maxItems": 3,
+        "maxTokens": 4000,
+        "maxBytes": 65536
+      },
+      "items": [
+        {
+          "resourceId": "example-resource",
+          "title": "Example Resource",
+          "summary": "A selected public resource summary for local review.",
+          "resourceUrl": "https://agentique.io/resources/example-resource",
+          "selectedContent": [
+            {
+              "kind": "summary",
+              "text": "Public summary text selected for a bounded context bundle.",
+              "maxBytes": 2048
+            }
+          ],
+          "permissionRisk": {
+            "readOnly": true,
+            "destructive": false,
+            "openWorld": false,
+            "approvalRequired": false,
+            "dataSensitivity": "public"
+          },
+          "deeperFetch": {
+            "resourceUrl": "https://agentique.io/resources/example-resource",
+            "readbackUrl": "https://agentique.io/api/public/v1/resources/example-resource/readback"
+          }
+        }
+      ],
+      "deeperFetch": {
+        "resourceUrl": "https://agentique.io/resources",
+        "readbackUrl": "https://agentique.io/api/public/v1/resources"
+      }
+    },
+    "invalid": {
+      "missing-required": {
+        "bundleId": "example-context-bundle",
+        "summary": "A small public context bundle with selected public content.",
+        "budget": {
+          "maxItems": 3,
+          "maxTokens": 4000,
+          "maxBytes": 65536
+        },
+        "items": []
+      },
+      "extra-property": {
+        "bundleId": "example-context-bundle",
+        "summary": "A small public context bundle with selected public content.",
+        "budget": {
+          "maxItems": 3,
+          "maxTokens": 4000,
+          "maxBytes": 65536
+        },
+        "items": [
+          {
+            "resourceId": "example-resource",
+            "title": "Example Resource",
+            "summary": "A selected public resource summary for local review.",
+            "resourceUrl": "https://agentique.io/resources/example-resource",
+            "selectedContent": [
+              {
+                "kind": "summary",
+                "text": "Public summary text selected for a bounded context bundle.",
+                "maxBytes": 2048
+              }
+            ],
+            "deeperFetch": {
+              "resourceUrl": "https://agentique.io/resources/example-resource",
+              "readbackUrl": "https://agentique.io/api/public/v1/resources/example-resource/readback"
+            },
+            "privateManifest": true
+          }
+        ],
+        "deeperFetch": {
+          "resourceUrl": "https://agentique.io/resources",
+          "readbackUrl": "https://agentique.io/api/public/v1/resources"
+        }
+      },
+      "boundary": {
+        "bundleId": "x",
+        "summary": "too short",
+        "budget": {
+          "maxItems": 999,
+          "maxTokens": 64,
+          "maxBytes": 128
+        },
+        "items": [
+          {
+            "resourceId": "example-resource",
+            "title": "Example Resource",
+            "summary": "A selected public resource summary for local review.",
+            "resourceUrl": "http://agentique.io/resources/example-resource",
+            "selectedContent": [],
+            "deeperFetch": {
+              "resourceUrl": "https://agentique.io/resources/example-resource"
+            }
+          }
+        ],
+        "deeperFetch": {
+          "resourceUrl": "https://agentique.io/resources"
+        }
+      }
+    }
+  },
+  "distribution-mode.schema.json": {
+    "valid": {
+      "mode": "package_download",
+      "notes": "Prepared for platform upload review."
+    },
+    "invalid": {
+      "missing-required": {},
+      "extra-property": {
+        "mode": "package_download",
+        "unexpected": true
+      },
+      "boundary": {
+        "mode": "direct_execution"
+      }
+    }
+  },
+  "output-contract.schema.json": {
+    "valid": {
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string"
+          }
+        }
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "summary": {
+            "type": "string"
+          }
+        }
+      },
+      "structuredContent": true,
+      "unstructuredFallback": "summary",
+      "maxOutputBytes": 65536,
+      "timeoutMs": 30000,
+      "limitHints": {
+        "maxItems": 20,
+        "maxRequests": 5
+      },
+      "errorBehavior": "typed-error",
+      "redaction": {
+        "secrets": true,
+        "privateFields": true,
+        "notes": "Redact secrets and private projection fields."
+      }
+    },
+    "invalid": {
+      "missing-required": {
+        "inputSchema": {
+          "type": "object"
+        }
+      },
+      "extra-property": {
+        "inputSchema": {
+          "type": "object"
+        },
+        "outputSchema": {
+          "type": "object"
+        },
+        "maxOutputBytes": 65536,
+        "timeoutMs": 30000,
+        "errorBehavior": "typed-error",
+        "redaction": {
+          "secrets": true,
+          "privateFields": true
+        },
+        "certifiedSafe": true
+      },
+      "boundary": {
+        "inputSchema": {
+          "type": "object"
+        },
+        "outputSchema": {
+          "type": "object"
+        },
+        "unstructuredFallback": "anything",
+        "maxOutputBytes": 999999999,
+        "timeoutMs": 999999999,
+        "errorBehavior": "guaranteed-success",
+        "redaction": {
+          "secrets": false,
+          "privateFields": true
+        }
+      }
+    }
+  },
+  "package-manifest.schema.json": {
+    "valid": {
+      "formatVersion": "1.0",
+      "files": ["README.md"],
+      "hashes": {
+        "README.md": "sha256:0000000000000000000000000000000000000000000000000000000000000000"
+      }
+    },
+    "invalid": {
+      "missing-required": {
+        "formatVersion": "1.0"
+      },
+      "extra-property": {
+        "formatVersion": "1.0",
+        "files": ["README.md"],
+        "hashes": {
+          "README.md": "sha256:0000000000000000000000000000000000000000000000000000000000000000"
+        },
+        "unexpected": true
+      },
+      "boundary": {
+        "formatVersion": "1.0",
+        "files": ["node_modules/pkg/index.js"],
+        "hashes": {
+          "node_modules/pkg/index.js": "sha256:0000000000000000000000000000000000000000000000000000000000000000"
+        }
+      }
+    }
+  },
+  "permission-risk.schema.json": {
+    "valid": {
+      "readOnly": true,
+      "destructive": false,
+      "idempotent": true,
+      "openWorld": false,
+      "externalNetwork": false,
+      "credentialed": false,
+      "approvalRequired": false,
+      "dataSensitivity": "public",
+      "capabilities": ["read-public-content"],
+      "reviewNotes": "Reads public package content without credential access."
+    },
+    "invalid": {
+      "missing-required": {
+        "readOnly": true
+      },
+      "extra-property": {
+        "readOnly": true,
+        "destructive": false,
+        "openWorld": false,
+        "approvalRequired": false,
+        "dataSensitivity": "public",
+        "safe": true
+      },
+      "boundary": {
+        "readOnly": true,
+        "destructive": true,
+        "openWorld": true,
+        "credentialed": true,
+        "approvalRequired": false,
+        "dataSensitivity": "sensitive",
+        "capabilities": ["credential-use"]
+      }
+    }
+  },
+  "public-readback.schema.json": {
+    "valid": {
+      "resourceId": "example-resource",
+      "state": "published",
+      "updatedAt": "2026-05-31T00:00:00.000Z",
+      "platformUrl": "https://agentique.io/resources/example-resource",
+      "tokenCount": 12
+    },
+    "invalid": {
+      "missing-required": {
+        "resourceId": "example-resource"
+      },
+      "extra-property": {
+        "resourceId": "example-resource",
+        "state": "published",
+        "updatedAt": "2026-05-31T00:00:00.000Z",
+        "platformUrl": "https://agentique.io/resources/example-resource",
+        "unexpected": true
+      },
+      "boundary": {
+        "resourceId": "Example Resource",
+        "state": "published",
+        "updatedAt": "2026-05-31T00:00:00.000Z",
+        "platformUrl": "https://agentique.io/resources/example-resource"
+      }
+    }
+  },
+  "resource-manifest.schema.json": {
+    "valid": {
+      "formatVersion": "1.0",
+      "name": "example-resource",
+      "summary": "A public fixture resource manifest.",
+      "source": {
+        "type": "git",
+        "url": "https://github.com/agentique/example-resource"
+      },
+      "distribution": {
+        "mode": "package_download"
+      },
+      "package": {
+        "formatVersion": "1.0",
+        "files": ["README.md"],
+        "hashes": {
+          "README.md": "sha256:0000000000000000000000000000000000000000000000000000000000000000"
+        }
+      },
+      "surfacing": {
+        "taskIntents": ["source-review", "public-summary"],
+        "audience": ["agent", "developer"],
+        "priority": 0.6,
+        "recency": {
+          "lastReviewedAt": "2026-06-01T00:00:00.000Z",
+          "reviewCadenceDays": 90
+        },
+        "compatibility": {
+          "runtimeFamilies": ["node", "browser"],
+          "protocols": ["https"]
+        },
+        "contextBudget": {
+          "maxTokens": 4000,
+          "maxBytes": 65536,
+          "preferredSummaryBytes": 4096
+        },
+        "notes": "Public creator-provided hints for resource selection."
+      },
+      "permissionRisk": {
+        "readOnly": true,
+        "destructive": false,
+        "idempotent": true,
+        "openWorld": false,
+        "externalNetwork": false,
+        "credentialed": false,
+        "approvalRequired": false,
+        "dataSensitivity": "public",
+        "capabilities": ["read-public-content"],
+        "reviewNotes": "Reads public package content without credential access."
+      }
+    },
+    "invalid": {
+      "missing-required": {
+        "formatVersion": "1.0"
+      },
+      "extra-property": {
+        "formatVersion": "1.0",
+        "name": "example-resource",
+        "summary": "A public fixture resource manifest.",
+        "source": {
+          "type": "git",
+          "url": "https://github.com/agentique/example-resource"
+        },
+        "distribution": {
+          "mode": "package_download"
+        },
+        "package": {
+          "formatVersion": "1.0",
+          "files": ["README.md"],
+          "hashes": {
+            "README.md": "sha256:0000000000000000000000000000000000000000000000000000000000000000"
+          }
+        },
+        "unexpected": true
+      },
+      "boundary": {
+        "formatVersion": "1.0",
+        "name": "x",
+        "summary": "too short",
+        "source": {
+          "type": "git",
+          "url": "http://example.com"
+        },
+        "distribution": {
+          "mode": "package_download"
+        },
+        "package": {
+          "formatVersion": "1.0",
+          "files": ["README.md"],
+          "hashes": {
+            "README.md": "sha256:0000000000000000000000000000000000000000000000000000000000000000"
+          }
+        }
+      }
+    }
+  },
+  "skill-metadata.schema.json": {
+    "valid": {
+      "name": "source-summarizer",
+      "summary": "Summarizes public sources with attribution.",
+      "inputs": ["topic"],
+      "outputs": ["summary"]
+    },
+    "invalid": {
+      "missing-required": {
+        "name": "source-summarizer"
+      },
+      "extra-property": {
+        "name": "source-summarizer",
+        "summary": "Summarizes public sources with attribution.",
+        "inputs": ["topic"],
+        "outputs": ["summary"],
+        "unexpected": true
+      },
+      "boundary": {
+        "name": "x",
+        "summary": "too short",
+        "inputs": [],
+        "outputs": []
+      }
+    }
+  },
+  "surfacing-metadata.schema.json": {
+    "valid": {
+      "taskIntents": ["source-review", "public-summary"],
+      "audience": ["agent", "developer"],
+      "priority": 0.5,
+      "recency": {
+        "lastReviewedAt": "2026-06-01T00:00:00.000Z"
+      },
+      "contextBudget": {
+        "maxTokens": 4000,
+        "maxBytes": 65536
+      }
+    },
+    "invalid": {
+      "missing-required": {
+        "taskIntents": ["source-review"]
+      },
+      "extra-property": {
+        "taskIntents": ["source-review"],
+        "audience": ["agent"],
+        "priority": 0.5,
+        "contextBudget": {
+          "maxTokens": 4000,
+          "maxBytes": 65536
+        },
+        "approved": true
+      },
+      "boundary": {
+        "taskIntents": [],
+        "audience": ["unknown"],
+        "priority": 2,
+        "contextBudget": {
+          "maxTokens": 64,
+          "maxBytes": 128
+        }
+      }
+    }
+  },
+  "tool-listing.schema.json": {
+    "valid": {
+      "name": "example-public-tool",
+      "summary": "Describes a public lookup tool listing for review.",
+      "capabilities": ["lookup", "summarize"],
+      "permissionRisk": {
+        "readOnly": true,
+        "destructive": false,
+        "idempotent": true,
+        "openWorld": true,
+        "externalNetwork": true,
+        "credentialed": false,
+        "approvalRequired": false,
+        "dataSensitivity": "public",
+        "capabilities": ["read-public-content", "external-network"],
+        "reviewNotes": "Reads public web content without credentials."
+      },
+      "outputContract": {
+        "inputSchema": {
+          "type": "object"
+        },
+        "outputSchema": {
+          "type": "object"
+        },
+        "structuredContent": true,
+        "unstructuredFallback": "summary",
+        "maxOutputBytes": 65536,
+        "timeoutMs": 30000,
+        "errorBehavior": "typed-error",
+        "redaction": {
+          "secrets": true,
+          "privateFields": true
+        }
+      },
+      "supportUrl": "https://example.com/support",
+      "documentationUrl": "https://example.com/docs"
+    },
+    "invalid": {
+      "missing-required": {
+        "name": "example-public-tool",
+        "summary": "Describes a public lookup tool listing for review.",
+        "capabilities": ["lookup"]
+      },
+      "extra-property": {
+        "name": "example-public-tool",
+        "summary": "Describes a public lookup tool listing for review.",
+        "capabilities": ["lookup"],
+        "permissionRisk": {
+          "readOnly": true,
+          "destructive": false,
+          "openWorld": false,
+          "approvalRequired": false,
+          "dataSensitivity": "public"
+        },
+        "outputContract": {
+          "inputSchema": {
+            "type": "object"
+          },
+          "outputSchema": {
+            "type": "object"
+          },
+          "maxOutputBytes": 65536,
+          "timeoutMs": 30000,
+          "errorBehavior": "typed-error",
+          "redaction": {
+            "secrets": true,
+            "privateFields": true
+          }
+        },
+        "documentationUrl": "https://example.com/docs",
+        "approved": true
+      },
+      "boundary": {
+        "name": "x",
+        "summary": "too short",
+        "capabilities": [],
+        "permissionRisk": {
+          "readOnly": false,
+          "destructive": true,
+          "openWorld": true,
+          "approvalRequired": false,
+          "dataSensitivity": "sensitive"
+        },
+        "outputContract": {
+          "inputSchema": {
+            "type": "object"
+          },
+          "outputSchema": {
+            "type": "object"
+          },
+          "maxOutputBytes": 1,
+          "timeoutMs": 1,
+          "errorBehavior": "approved",
+          "redaction": {
+            "secrets": false,
+            "privateFields": false
+          }
+        },
+        "documentationUrl": "http://example.com/docs"
+      }
+    }
+  },
+  "workflow-metadata.schema.json": {
+    "valid": {
+      "name": "evidence-review",
+      "summary": "Reviews public evidence and unresolved questions.",
+      "steps": [
+        {
+          "id": "collect-sources",
+          "description": "Collect public source links."
+        }
+      ]
+    },
+    "invalid": {
+      "missing-required": {
+        "name": "evidence-review"
+      },
+      "extra-property": {
+        "name": "evidence-review",
+        "summary": "Reviews public evidence and unresolved questions.",
+        "steps": [
+          {
+            "id": "collect-sources",
+            "description": "Collect public source links."
+          }
+        ],
+        "unexpected": true
+      },
+      "boundary": {
+        "name": "x",
+        "summary": "too short",
+        "steps": []
+      }
+    }
+  }
+}

package/fixtures/valid/resource-package.json

@@ -0,0 +1,42 @@
+{
+  "formatVersion": "1.0",
+  "name": "research-helper",
+  "summary": "A public example package for preparing an Agentique resource.",
+  "source": {
+    "type": "git",
+    "url": "https://github.com/example/research-helper"
+  },
+  "distribution": {
+    "mode": "package_download",
+    "notes": "Package is prepared for platform review before publication."
+  },
+  "package": {
+    "formatVersion": "1.0",
+    "files": ["README.md", "manifest.json", "skills/research-helper.md"],
+    "hashes": {
+      "README.md": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "manifest.json": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "skills/research-helper.md": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+    }
+  },
+  "skill": {
+    "name": "research-helper",
+    "summary": "Helps organize public research notes into a reusable workflow.",
+    "inputs": ["topic", "source list"],
+    "outputs": ["summary", "source table"]
+  },
+  "workflow": {
+    "name": "research-review",
+    "summary": "Reviews public sources and creates a structured summary.",
+    "steps": [
+      {
+        "id": "collect-sources",
+        "description": "Collect public source links supplied by the user."
+      },
+      {
+        "id": "summarize",
+        "description": "Summarize public information with source attribution."
+      }
+    ]
+  }
+}