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

package/dist/specs/resources/aip-26/draft/CODE.schema.json

@@ -0,0 +1,172 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentproto.sh/schemas/aip-26/CODE.schema.json",
+  "title": "CODE blocks (AIP-26)",
+  "description": "Composable JSON Schema definitions for the `code` and `run` blocks reused across manifest formats. Other AIPs reference these by $ref into their own schemas.",
+  "type": "object",
+  "$defs": {
+    "code": {
+      "description": "Bundle composition. String shorthand desugars to `{ sources: [{ ref: <string> }] }`. Object form lists explicit sources merged via overlay (last wins on path collision).",
+      "oneOf": [
+        {
+          "description": "String shorthand — workspace-relative path to a code-workspace.",
+          "type": "string",
+          "pattern": "^[^/].*"
+        },
+        {
+          "description": "Object form — explicit sources list.",
+          "type": "object",
+          "required": ["sources"],
+          "additionalProperties": false,
+          "properties": {
+            "sources": {
+              "type": "array",
+              "minItems": 1,
+              "items": { "$ref": "#/$defs/source" }
+            }
+          }
+        }
+      ]
+    },
+    "source": {
+      "description": "One source contributing files to the bundle. Discriminator is the single populated key: inline | local | github | ref.",
+      "type": "object",
+      "oneOf": [
+        {
+          "required": ["inline"],
+          "properties": { "inline": { "$ref": "#/$defs/sourceInline" } }
+        },
+        {
+          "required": ["local"],
+          "properties": { "local": { "$ref": "#/$defs/sourceLocal" } }
+        },
+        {
+          "required": ["github"],
+          "properties": { "github": { "$ref": "#/$defs/sourceGithub" } }
+        },
+        {
+          "required": ["ref"],
+          "properties": { "ref": { "$ref": "#/$defs/sourceRef" } }
+        }
+      ]
+    },
+    "sourceInline": {
+      "description": "Embedded content. `path` is bundle-internal target; `content` is UTF-8 file body.",
+      "type": "object",
+      "required": ["path", "content"],
+      "additionalProperties": false,
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "content": { "type": "string" }
+      }
+    },
+    "sourceLocal": {
+      "description": "Workspace file/directory. String shorthand desugars to `{ path: <string> }`.",
+      "oneOf": [
+        { "type": "string", "minLength": 1 },
+        {
+          "type": "object",
+          "required": ["path"],
+          "additionalProperties": false,
+          "properties": {
+            "path": { "type": "string", "minLength": 1 },
+            "as": { "type": "string", "minLength": 1 },
+            "glob": { "type": "string" }
+          }
+        }
+      ]
+    },
+    "sourceGithub": {
+      "description": "Remote git source pulled at materialization time. Cached by `(repo, ref, path)`. SHA refs cached forever; tags cached 24h; branches refetched per scan.",
+      "type": "object",
+      "required": ["repo", "ref"],
+      "additionalProperties": false,
+      "properties": {
+        "repo": {
+          "type": "string",
+          "pattern": "^[^/]+/[^/]+$",
+          "description": "<owner>/<name>"
+        },
+        "ref": {
+          "type": "string",
+          "minLength": 1,
+          "description": "SHA (40 hex), tag (vN.N.N), or branch."
+        },
+        "path": {
+          "type": "string",
+          "description": "Sub-folder within the repo. Default = repo root."
+        },
+        "as": {
+          "type": "string",
+          "description": "Bundle-internal target. Default = same as path."
+        }
+      }
+    },
+    "sourceRef": {
+      "description": "Reference to another code-workspace. Recursively resolved; cycles forbidden. String shorthand desugars to `{ path: <string> }`.",
+      "oneOf": [
+        { "type": "string", "minLength": 1 },
+        {
+          "type": "object",
+          "required": ["path"],
+          "additionalProperties": false,
+          "properties": {
+            "path": { "type": "string", "minLength": 1 }
+          }
+        }
+      ]
+    },
+    "run": {
+      "description": "What the runner invokes. String path = file (runner inferred from extension). String with shell metacharacters = bash -c. Array = exec ARGV. Object = explicit form.",
+      "oneOf": [
+        {
+          "description": "String form — single file path or shell command.",
+          "type": "string",
+          "minLength": 1
+        },
+        {
+          "description": "Array form — exec ARGV passed to execve(2).",
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string" }
+        },
+        {
+          "description": "Explicit object form — disambiguates path/exec/shell.",
+          "type": "object",
+          "oneOf": [
+            {
+              "required": ["file"],
+              "properties": { "file": { "type": "string", "minLength": 1 } }
+            },
+            {
+              "required": ["exec"],
+              "properties": {
+                "exec": {
+                  "type": "array",
+                  "items": { "type": "string" },
+                  "minItems": 1
+                }
+              }
+            },
+            {
+              "required": ["shell"],
+              "properties": { "shell": { "type": "string", "minLength": 1 } }
+            }
+          ]
+        }
+      ]
+    },
+    "codeWorkspaceManifest": {
+      "description": "kind: code-workspace — first-class shared bundle referenced by tools/workflows.",
+      "type": "object",
+      "required": ["kind", "name", "code"],
+      "properties": {
+        "kind": { "const": "code-workspace" },
+        "name": { "type": "string", "minLength": 1 },
+        "description": { "type": "string" },
+        "code": { "$ref": "#/$defs/code" },
+        "run": { "$ref": "#/$defs/run" }
+      }
+    }
+  }
+}

package/dist/specs/resources/aip-28/draft/INTENT.schema.json

@@ -0,0 +1,215 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentproto.sh/docs/aip-28/INTENT.schema.json",
+  "title": "INTENT.md frontmatter — agentintent/v1",
+  "description": "JSON Schema for the YAML frontmatter of an AIP-28 INTENT.md manifest.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["name", "id", "label", "description", "version", "intent", "surfaces", "implements"],
+  "properties": {
+    "name":        { "$ref": "#/$defs/i18nString",  "description": "Internal display name." },
+    "id":          { "type": "string", "pattern": "^[a-z0-9][a-z0-9.\\-]{1,79}$" },
+    "label":       { "$ref": "#/$defs/i18nString",  "description": "User-facing button/menu label." },
+    "description": { "$ref": "#/$defs/i18nString",  "description": "User-facing copy (≤500 chars per locale)." },
+    "version":     { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][\\w.\\-]+)?$" },
+    "intent": {
+      "description": "Natural-language seeds an LLM matches against.",
+      "oneOf": [
+        { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+        { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" }, "minItems": 1 } }
+      ]
+    },
+    "surfaces": {
+      "type": "array",
+      "items":  { "type": "string", "enum": ["chat", "menu", "voice", "shortcut", "api"] },
+      "uniqueItems": true,
+      "minItems": 0
+    },
+    "inputs": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/inputField" }
+    },
+    "outputs": { "$ref": "#/$defs/outputs" },
+    "entry": {
+      "type": "string",
+      "description": "Workspace-relative path to a routing implementation."
+    },
+    "implements": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/implementsEntry" }
+    },
+    "cost_class": { "type": "string", "enum": ["trivial", "metered", "expensive"] },
+    "quota_key":  { "type": "string", "pattern": "^[a-z0-9][a-z0-9.\\-]{1,127}$" },
+    "requires": { "$ref": "#/$defs/capabilities" },
+    "auth": {
+      "type": "string",
+      "description": "Workspace-relative path to a SECRETS.md (AIP-19)."
+    },
+    "experiments": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/experimentArm" }
+    },
+    "scope": {
+      "description": "Publication tier. Aligns with Model Access Rules v2 scope chain. Default `app`. `platform` is reserved for host-runtime defaults and MUST NOT appear in authored manifests.",
+      "type": "string",
+      "enum": ["app", "tier", "user", "guild", "workspace", "operator"]
+    },
+    "disable": {
+      "description": "Intent id of a less-specific-tier intent that this manifest hides. Used when a higher-tier scope wants to remove a lower-tier intent without re-implementing it.",
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9.\\-]{1,79}$"
+    },
+    "preview": { "type": "string" },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z0-9][a-z0-9\\-]{0,63}$" },
+      "uniqueItems": true
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["user"],
+        "properties": {
+          "user": { "$ref": "#/$defs/i18nString" },
+          "note": { "$ref": "#/$defs/i18nString" }
+        }
+      }
+    },
+    "metadata": { "type": "object" }
+  },
+  "$defs": {
+    "i18nString": {
+      "description": "Either a plain string (treated as locale `en`) or a per-locale map keyed by BCP-47.",
+      "oneOf": [
+        { "type": "string" },
+        { "type": "object", "additionalProperties": { "type": "string" }, "propertyNames": { "pattern": "^[a-z]{2}(?:-[A-Z]{2})?$" } }
+      ]
+    },
+    "inputField": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "label", "type"],
+      "properties": {
+        "name":        { "type": "string", "pattern": "^[a-zA-Z_][a-zA-Z0-9_]*$" },
+        "label":       { "$ref": "#/$defs/i18nString" },
+        "type":        { "type": "string", "enum": ["text", "textarea", "number", "toggle", "choice", "multi-choice", "file", "image", "date", "markdown", "code", "ref"] },
+        "placeholder": { "$ref": "#/$defs/i18nString" },
+        "hint":        { "$ref": "#/$defs/i18nString" },
+        "required":    { "type": "boolean" },
+        "default":     {},
+        "min":         { "type": "number" },
+        "max":         { "type": "number" },
+        "min_length":  { "type": "integer", "minimum": 0 },
+        "max_length":  { "type": "integer", "minimum": 0 },
+        "pattern":     { "type": "string" },
+        "values": {
+          "description": "For choice / multi-choice. Either a list of strings or a list of {value,label} objects.",
+          "oneOf": [
+            { "type": "array", "items": { "type": "string" } },
+            {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["value", "label"],
+                "properties": {
+                  "value": {},
+                  "label": { "$ref": "#/$defs/i18nString" }
+                }
+              }
+            }
+          ]
+        },
+        "accept":   { "type": "array", "items": { "type": "string" } },
+        "language": { "type": "string" },
+        "depends_on": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/predicateValue" }
+        }
+      }
+    },
+    "outputs": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type"],
+      "properties": {
+        "type":     { "type": "string", "enum": ["text", "image", "markdown", "file", "custom"] },
+        "template": { "type": "string" }
+      }
+    },
+    "implementsEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "tool":     { "type": "string" },
+        "workflow": { "type": "string" },
+        "entry":    { "type": "string" },
+        "default":  { "type": "boolean" },
+        "when":     { "type": "object", "additionalProperties": { "$ref": "#/$defs/predicateValue" } },
+        "mapping":  { "type": "object", "additionalProperties": { "$ref": "#/$defs/mappingValue" } }
+      },
+      "oneOf": [
+        { "required": ["tool"] },
+        { "required": ["workflow"] },
+        { "required": ["entry"] }
+      ]
+    },
+    "predicateValue": {
+      "description": "Value shape for `when` and `depends_on`. Literal value, or comparison object.",
+      "oneOf": [
+        {},
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "not":       {},
+            "in":        { "type": "array" },
+            "not_in":    { "type": "array" },
+            "not_empty": { "type": "boolean" },
+            "gt":        { "type": "number" },
+            "lt":        { "type": "number" },
+            "gte":       { "type": "number" },
+            "lte":       { "type": "number" }
+          }
+        }
+      ]
+    },
+    "mappingValue": {
+      "oneOf": [
+        { "type": "string", "description": "Identity / rename: intent input → tool input key." },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["from"],
+          "properties": {
+            "from":      { "type": "string" },
+            "transform": { "type": "string", "description": "Named transformer exported by the entry." }
+          }
+        }
+      ]
+    },
+    "capabilities": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "network": { "type": "array", "items": { "type": "string" } },
+        "secrets": { "type": "array", "items": { "type": "string" } },
+        "tools":   { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "experimentArm": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "weight", "implements"],
+      "properties": {
+        "id":         { "type": "string", "pattern": "^[a-z0-9][a-z0-9.\\-]{1,63}$" },
+        "weight":     { "type": "number", "minimum": 0, "maximum": 1 },
+        "when":       { "type": "object", "additionalProperties": { "$ref": "#/$defs/predicateValue" } },
+        "implements": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/implementsEntry" } }
+      }
+    }
+  }
+}