{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://kortix.com/schema/kortix.v2.schema.json", "title": "Kortix manifest (kortix_version 2)", "description": "kortix.yaml, schema version 2 — YAML-only. `agents` is a name→block MAP, GOVERNANCE ONLY (connectors/secrets/skills/kortix_cli/workspace/enabled); every agent must be declared, and OpenCode behavior (description/model/mode/temperature/permission/the prompt itself) lives entirely in that agent’s own native `.kortix/opencode/agents/.md` frontmatter + body — authoring any of those fields here is a hard error. `[[channels]]` is removed outright. See docs/specs/2026-07-05-agent-first-config-unification.md §2.1/§2.2/§2.5.", "type": "object", "required": [ "kortix_version", "default_agent", "agents" ], "properties": { "kortix_version": { "const": 2 }, "default_agent": { "type": "string", "minLength": 1 }, "runtime": { "type": "string", "enum": [ "opencode" ] }, "agents": { "type": "object", "minProperties": 1, "propertyNames": { "pattern": "^[a-z0-9][a-z0-9_-]{0,127}$" }, "additionalProperties": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "connectors": { "description": "An allowlist of names, or the \"all\" / \"none\" sentinel.", "oneOf": [ { "type": "array", "items": { "type": "string", "minLength": 1 } }, { "type": "string", "enum": [ "all", "none" ] } ] }, "secrets": { "description": "An allowlist of names, or the \"all\" / \"none\" sentinel.", "oneOf": [ { "type": "array", "items": { "type": "string", "minLength": 1 } }, { "type": "string", "enum": [ "all", "none" ] } ] }, "skills": { "description": "An allowlist of names, or the \"all\" / \"none\" sentinel.", "oneOf": [ { "type": "array", "items": { "type": "string", "minLength": 1 } }, { "type": "string", "enum": [ "all", "none" ] } ] }, "kortix_cli": { "description": "An allowlist of names, or the \"all\" / \"none\" sentinel.", "oneOf": [ { "type": "array", "items": { "type": "string", "enum": [ "project.read", "project.write", "project.deploy", "project.delete", "project.cr.open", "project.cr.merge", "project.session.read", "project.session.start", "project.session.stop", "project.members.read", "project.members.manage", "project.trigger.read", "project.trigger.create", "project.trigger.update", "project.trigger.delete", "project.trigger.fire", "project.gateway.logs.read", "project.gateway.spend.read", "project.gateway.budget.set", "project.gateway.keys.manage", "project.agent.read", "project.agent.write", "project.skill.read", "project.skill.write", "project.command.read", "project.command.write", "project.file.read", "project.file.write", "project.customize.read", "project.customize.write", "project.gitops.read", "project.gitops.push", "project.gitops.merge", "project.secret.read", "project.secret.write", "project.connector.read", "project.connector.write", "project.review.read", "project.review.submit", "project.review.act", "*" ] } }, { "type": "string", "enum": [ "all", "none" ] } ] }, "workspace": { "type": "string", "enum": [ "runtime", "read", "branch" ] } }, "additionalProperties": false } }, "project": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" } }, "additionalProperties": true }, "env": { "type": "object", "properties": { "required": { "type": "array", "items": { "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" } }, "optional": { "type": "array", "items": { "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" } } }, "additionalProperties": true }, "opencode": { "type": "object", "properties": { "config_dir": { "type": "string", "minLength": 1, "not": { "pattern": "^/|(^|/)\\.\\.($|/)" } } }, "additionalProperties": true }, "sandbox": { "type": "object", "properties": { "image": false, "dockerfile": false, "slug": false, "cpu": false, "memory": false, "disk": false, "entrypoint": false, "context": false, "context_dir": false, "gpu": false, "templates": { "type": "array", "items": { "type": "object", "required": [ "slug" ], "properties": { "slug": { "allOf": [ { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{0,127}$" }, { "not": { "const": "default" } } ] }, "name": { "type": "string" }, "entrypoint": { "type": "string" }, "image": { "type": "string", "minLength": 1 }, "dockerfile": { "type": "string", "minLength": 1, "not": { "pattern": "^/|(^|/)\\.\\.($|/)" } }, "cpu": { "type": "integer", "minimum": 1 }, "memory": { "type": "integer", "minimum": 1 }, "disk": { "type": "integer", "minimum": 1 } }, "oneOf": [ { "required": [ "image" ], "not": { "required": [ "dockerfile" ] } }, { "required": [ "dockerfile" ], "not": { "required": [ "image" ] } } ] } }, "default": { "type": "string", "minLength": 1 } }, "additionalProperties": true }, "sandboxes": false, "triggers": { "type": "array", "items": { "type": "object", "required": [ "slug", "type" ], "properties": { "slug": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{0,127}$" }, "type": { "type": "string", "enum": [ "cron", "webhook" ] }, "name": { "type": "string" }, "agent": { "type": "string", "minLength": 1 }, "agent_name": { "type": "string", "minLength": 1 }, "enabled": { "oneOf": [ { "type": "boolean" }, { "type": "number" }, { "type": "string", "pattern": "^(?:[tT][rR][uU][eE]|[fF][aA][lL][sS][eE]|1|0|[yY][eE][sS]|[nN][oO]|[oO][nN]|[oO][fF][fF])$" } ] }, "session_mode": { "type": "string", "enum": [ "fresh", "reuse" ] }, "sessionMode": { "type": "string", "enum": [ "fresh", "reuse" ] }, "prompt": { "type": "string", "minLength": 1 }, "prompt_template": { "type": "string", "minLength": 1 }, "cron": { "type": "string", "minLength": 1 }, "schedule": { "type": "string", "minLength": 1 }, "run_at": { "type": "string", "minLength": 1 }, "runAt": { "type": "string", "minLength": 1 }, "timezone": { "type": "string" }, "secret_env": { "type": "string", "pattern": "^[A-Z_][A-Z0-9_]*$" }, "secretEnv": { "type": "string", "pattern": "^[A-Z_][A-Z0-9_]*$" } }, "additionalProperties": true, "allOf": [ { "anyOf": [ { "required": [ "prompt" ] }, { "required": [ "prompt_template" ] } ] }, { "if": { "properties": { "type": { "const": "cron" } } }, "then": { "anyOf": [ { "required": [ "cron" ] }, { "required": [ "schedule" ] }, { "required": [ "run_at" ] }, { "required": [ "runAt" ] } ] } }, { "if": { "properties": { "type": { "const": "webhook" } } }, "then": { "anyOf": [ { "required": [ "secret_env" ] }, { "required": [ "secretEnv" ] } ] } } ] } }, "connectors": { "type": "array", "items": { "type": "object", "required": [ "slug", "provider" ], "properties": { "slug": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{0,127}$" }, "provider": { "type": "string", "enum": [ "pipedream", "mcp", "openapi", "graphql", "http", "channel" ] }, "app": { "type": "string" }, "url": { "type": "string" }, "endpoint": { "type": "string" }, "base_url": { "type": "string" }, "baseUrl": { "type": "string" }, "transport": { "type": "string", "enum": [ "http", "sse" ] }, "spec": { "type": "string" }, "platform": { "type": "string", "enum": [ "slack", "email", "meet" ] }, "credential": { "const": "shared" }, "agent_scope": false, "auth": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string", "enum": [ "bearer", "basic", "custom", "oauth1", "none" ] }, "secret": false }, "additionalProperties": true }, "policies": { "type": "array", "items": { "type": "object", "required": [ "match", "action" ], "properties": { "match": { "type": "string", "minLength": 1 }, "action": { "type": "string", "enum": [ "always_run", "require_approval", "block" ] } } } } }, "additionalProperties": true, "allOf": [ { "if": { "properties": { "slug": { "const": "kortix_slack" } } }, "then": { "properties": { "provider": { "const": "channel" } } } }, { "if": { "properties": { "slug": { "const": "kortix_email" } } }, "then": { "properties": { "provider": { "const": "channel" } } } }, { "if": { "properties": { "slug": { "const": "kortix_meet" } } }, "then": { "properties": { "provider": { "const": "channel" } } } }, { "if": { "properties": { "slug": { "const": "computer" } } }, "then": { "properties": { "provider": { "const": "computer" } } } }, { "if": { "properties": { "provider": { "const": "pipedream" } } }, "then": { "required": [ "app" ] } }, { "if": { "properties": { "provider": { "const": "mcp" } } }, "then": { "required": [ "url" ] } }, { "if": { "properties": { "provider": { "const": "graphql" } } }, "then": { "required": [ "endpoint" ] } }, { "if": { "properties": { "provider": { "const": "http" } } }, "then": { "anyOf": [ { "required": [ "base_url" ] }, { "required": [ "baseUrl" ] } ] } }, { "if": { "properties": { "provider": { "const": "channel" } } }, "then": { "required": [ "platform" ] } }, { "if": { "properties": { "provider": { "const": "channel" } }, "required": [ "auth" ] }, "then": { "properties": { "auth": { "properties": { "type": { "const": "none" } } } } } } ] } }, "apps": { "type": "array", "items": { "type": "object", "required": [ "slug" ], "properties": { "slug": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{0,127}$" }, "name": { "type": "string" }, "framework": { "type": "string" }, "enabled": { "oneOf": [ { "type": "boolean" }, { "type": "number" }, { "type": "string", "pattern": "^(?:[tT][rR][uU][eE]|[fF][aA][lL][sS][eE]|1|0|[yY][eE][sS]|[nN][oO]|[oO][nN]|[oO][fF][fF])$" } ] }, "domains": { "type": "array", "items": { "type": "string" } }, "source": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string", "enum": [ "git", "tar" ] }, "repo": { "type": "string" }, "branch": { "type": "string" }, "root_path": { "type": "string" }, "url": { "type": "string" } }, "additionalProperties": true }, "build": { "type": "object" }, "env": { "type": "object" } }, "additionalProperties": true } }, "channels": false }, "additionalProperties": true, "$defs": { "agentMdFrontmatter": { "type": "object", "description": "OpenCode behavior for one agent — lives in .kortix/opencode/agents/.md frontmatter, never in the manifest. Provided here as an authoring aid; not itself part of kortix.yaml.", "properties": { "description": { "type": "string" }, "model": { "type": "string" }, "mode": { "type": "string", "enum": [ "primary", "subagent", "all" ] }, "variant": { "type": "string" }, "temperature": { "type": "number" }, "top_p": { "type": "number" }, "steps": { "type": "integer", "minimum": 1 }, "color": { "oneOf": [ { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, { "type": "string", "enum": [ "primary", "secondary", "accent", "success", "warning", "error", "info" ] } ] }, "hidden": { "type": "boolean" }, "disable": { "type": "boolean" }, "options": { "type": "object" }, "permission": { "oneOf": [ { "type": "string", "enum": [ "ask", "allow", "deny" ] }, { "type": "object", "properties": { "todowrite": { "type": "string", "enum": [ "ask", "allow", "deny" ] }, "question": { "type": "string", "enum": [ "ask", "allow", "deny" ] }, "webfetch": { "type": "string", "enum": [ "ask", "allow", "deny" ] }, "websearch": { "type": "string", "enum": [ "ask", "allow", "deny" ] }, "doom_loop": { "type": "string", "enum": [ "ask", "allow", "deny" ] } }, "additionalProperties": { "oneOf": [ { "type": "string", "enum": [ "ask", "allow", "deny" ] }, { "type": "object", "additionalProperties": { "type": "string", "enum": [ "ask", "allow", "deny" ] } } ] } } ] } }, "additionalProperties": true } } }