agents-inc 0.149.2 → 0.151.0

package/src/schemas/project-config.schema.json

@@ -0,0 +1,189 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "schemas/project-config.schema.json",
+  "title": "Project Configuration",
+  "description": "Schema for .claude-src/config.yaml consumer project files (name, agents, stack, skills).",
+  "type": "object",
+  "properties": {
+    "version": {
+      "type": "string",
+      "const": "1"
+    },
+    "name": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "agents": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "skills": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^(ai|web|api|cli|mobile|infra|meta|shared|security)-.+-.+$"
+      }
+    },
+    "author": {
+      "type": "string"
+    },
+    "installMode": {
+      "type": "string",
+      "enum": ["eject", "plugin"]
+    },
+    "domains": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["ai", "api", "cli", "infra", "meta", "mobile", "shared", "web"]
+      }
+    },
+    "selectedAgents": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "stack": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "object",
+        "propertyNames": {
+          "type": "string",
+          "enum": [
+            "ai-infrastructure",
+            "ai-observability",
+            "ai-orchestration",
+            "ai-patterns",
+            "ai-provider",
+            "api-analytics",
+            "api-api",
+            "api-auth",
+            "api-baas",
+            "api-cms",
+            "api-commerce",
+            "api-database",
+            "api-email",
+            "api-flags",
+            "api-framework",
+            "api-observability",
+            "api-performance",
+            "api-search",
+            "api-vector-db",
+            "cli-framework",
+            "infra-ci-cd",
+            "infra-config",
+            "infra-platform",
+            "meta-methodology",
+            "meta-reviewing",
+            "mobile-framework",
+            "shared-monorepo",
+            "shared-security",
+            "shared-tooling",
+            "web-accessibility",
+            "web-animation",
+            "web-client-state",
+            "web-data-fetching",
+            "web-error-handling",
+            "web-file-upload",
+            "web-files",
+            "web-forms",
+            "web-framework",
+            "web-i18n",
+            "web-meta-framework",
+            "web-mocking",
+            "web-performance",
+            "web-pwa",
+            "web-realtime",
+            "web-routing",
+            "web-server-state",
+            "web-styling",
+            "web-testing",
+            "web-tooling",
+            "web-ui-components",
+            "web-utilities"
+          ]
+        },
+        "additionalProperties": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "pattern": "^(ai|web|api|cli|mobile|infra|meta|shared|security)-.+-.+$"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "preloaded": {
+                      "type": "boolean"
+                    },
+                    "local": {
+                      "type": "boolean"
+                    },
+                    "path": {
+                      "type": "string"
+                    }
+                  },
+                  "required": ["id"],
+                  "additionalProperties": false
+                }
+              ]
+            },
+            {
+              "type": "array",
+              "items": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "pattern": "^(ai|web|api|cli|mobile|infra|meta|shared|security)-.+-.+$"
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string"
+                      },
+                      "preloaded": {
+                        "type": "boolean"
+                      },
+                      "local": {
+                        "type": "boolean"
+                      },
+                      "path": {
+                        "type": "string"
+                      }
+                    },
+                    "required": ["id"],
+                    "additionalProperties": false
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    },
+    "source": {
+      "type": "string"
+    },
+    "marketplace": {
+      "type": "string"
+    },
+    "agentsSource": {
+      "type": "string"
+    }
+  },
+  "required": ["name", "agents", "skills", "installMode", "stack", "source"],
+  "additionalProperties": false
+}

package/src/schemas/project-source-config.schema.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "schemas/project-source-config.schema.json",
+  "title": "Project Source Configuration",
+  "description": "Schema for .claude-src/config.yaml marketplace source configuration files.",
+  "type": "object",
+  "properties": {
+    "source": {
+      "type": "string"
+    },
+    "author": {
+      "type": "string"
+    },
+    "marketplace": {
+      "type": "string"
+    },
+    "agentsSource": {
+      "type": "string"
+    },
+    "sources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "ref": {
+            "type": "string"
+          }
+        },
+        "required": ["name", "url"],
+        "additionalProperties": false
+      }
+    },
+    "boundSkills": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "sourceUrl": {
+            "type": "string"
+          },
+          "sourceName": {
+            "type": "string"
+          },
+          "boundTo": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          }
+        },
+        "required": ["id", "sourceUrl", "sourceName", "boundTo"],
+        "additionalProperties": false
+      }
+    },
+    "branding": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "tagline": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "skillsDir": {
+      "type": "string"
+    },
+    "agentsDir": {
+      "type": "string"
+    },
+    "stacksFile": {
+      "type": "string"
+    },
+    "categoriesFile": {
+      "type": "string"
+    },
+    "rulesFile": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/src/schemas/skill-frontmatter.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "schemas/skill-frontmatter.schema.json",
+  "title": "Skill Frontmatter",
+  "description": "Schema for SKILL.md file frontmatter fields.",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1
+    },
+    "disable-model-invocation": {
+      "type": "boolean"
+    },
+    "user-invocable": {
+      "type": "boolean"
+    },
+    "allowed-tools": {
+      "type": "string"
+    },
+    "model": {
+      "type": "string",
+      "enum": ["sonnet", "opus", "haiku", "fable", "inherit"]
+    },
+    "context": {
+      "type": "string",
+      "enum": ["fork"]
+    },
+    "agent": {
+      "type": "string"
+    },
+    "argument-hint": {
+      "type": "string"
+    }
+  },
+  "required": ["name", "description"],
+  "additionalProperties": false
+}

package/src/schemas/stack.schema.json

@@ -0,0 +1,191 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "schemas/stack.schema.json",
+  "title": "Stack Config",
+  "description": "Schema for individual stack config.yaml files.",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "version": {
+      "type": "string"
+    },
+    "author": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string"
+    },
+    "created": {
+      "type": "string"
+    },
+    "updated": {
+      "type": "string"
+    },
+    "framework": {
+      "type": "string"
+    },
+    "skills": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "preloaded": {
+            "type": "boolean"
+          }
+        },
+        "required": ["id"],
+        "additionalProperties": false
+      }
+    },
+    "agents": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
+      }
+    },
+    "agentSkills": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "object",
+        "propertyNames": {
+          "type": "string"
+        },
+        "additionalProperties": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "preloaded": {
+                "type": "boolean"
+              }
+            },
+            "required": ["id"],
+            "additionalProperties": false
+          }
+        }
+      }
+    },
+    "philosophy": {
+      "type": "string"
+    },
+    "principles": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
+      }
+    },
+    "overrides": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "alternatives": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "locked": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "metrics": {
+      "type": "object",
+      "properties": {
+        "upvotes": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "downloads": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "additionalProperties": false
+    },
+    "hooks": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "matcher": {
+              "type": "string"
+            },
+            "hooks": {
+              "minItems": 1,
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": ["command", "script", "prompt"]
+                  },
+                  "command": {
+                    "type": "string"
+                  },
+                  "script": {
+                    "type": "string"
+                  },
+                  "prompt": {
+                    "type": "string"
+                  }
+                },
+                "required": ["type"],
+                "additionalProperties": false
+              }
+            }
+          },
+          "required": ["hooks"],
+          "additionalProperties": false
+        }
+      }
+    }
+  },
+  "required": ["name", "version", "author", "skills", "agents"],
+  "additionalProperties": false
+}

package/src/schemas/stacks.schema.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "schemas/stacks.schema.json",
+  "title": "Stacks Configuration",
+  "description": "Schema for config/stacks.ts defining agent groupings.",
+  "type": "object",
+  "properties": {
+    "stacks": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": {
+            "type": "string"
+          },
+          "agents": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "anyOf": [
+                  {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string"
+                          },
+                          "preloaded": {
+                            "type": "boolean"
+                          },
+                          "local": {
+                            "type": "boolean"
+                          },
+                          "path": {
+                            "type": "string"
+                          }
+                        },
+                        "required": ["id"],
+                        "additionalProperties": false
+                      }
+                    ]
+                  },
+                  {
+                    "type": "array",
+                    "items": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "id": {
+                              "type": "string"
+                            },
+                            "preloaded": {
+                              "type": "boolean"
+                            },
+                            "local": {
+                              "type": "boolean"
+                            },
+                            "path": {
+                              "type": "string"
+                            }
+                          },
+                          "required": ["id"],
+                          "additionalProperties": false
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          },
+          "philosophy": {
+            "type": "string"
+          }
+        },
+        "required": ["id", "name", "description", "agents"],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": ["stacks"],
+  "additionalProperties": false
+}

package/bin/run.js

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-// The CLI's entrypoint starts oclif at import time, so delegating is a bare import.
-import "@agents-inc/cli";