@tea-agent/loop-agent 0.1.0

package/docs/templates/agent-dag.schema.json

@@ -0,0 +1,316 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://loop-agent.local/schemas/agent-dag.schema.json",
+  "title": "Agent DAG Spec",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "title", "tasks"],
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "version": {
+      "enum": [1, 2],
+      "default": 1
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "objective": {
+      "type": "string"
+    },
+    "successCriteria": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "globalConstraints": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "verifyStrategy": { "$ref": "#/$defs/verifyStrategy" },
+    "defaults": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "executor": { "$ref": "#/$defs/executor" },
+        "model": { "type": "string" },
+        "piBackend": {
+          "enum": ["sdk-first", "cli-only"],
+          "description": "Accepted metadata only. Runtime Pi backend selection is controlled by CODE_AGENT_PI_BACKEND."
+        },
+        "contextProfile": { "type": "string" },
+        "skills": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "writePolicy": { "$ref": "#/$defs/writePolicy" }
+      }
+    },
+    "skillsByRole": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": "string", "minLength": 1 }
+      }
+    },
+    "executorModels": {
+      "type": "object",
+      "description": "Executor-owned model routing template keyed by executor then complexity. Do not use legacy top-level models or defaults.model.",
+      "additionalProperties": false,
+      "properties": {
+        "cursor": { "$ref": "#/$defs/complexityModelMap" },
+        "pi": { "$ref": "#/$defs/complexityModelMap" }
+      }
+    },
+    "tasks": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/task" }
+    }
+  },
+  "not": {
+    "required": ["models"]
+  },
+  "$defs": {
+    "complexity": {
+      "enum": ["LOW", "MED", "HIGH"]
+    },
+    "executor": {
+      "enum": ["cursor", "pi", "shell", "static"]
+    },
+    "toolProfile": {
+      "enum": ["read-only", "write"]
+    },
+    "role": {
+      "enum": ["planner", "scout", "implementer", "reviewer", "supervisor", "verifier", "closeout"]
+    },
+    "writePolicy": {
+      "enum": ["read-only", "docs-only", "exclusive", "none"]
+    },
+    "complexityModelMap": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "LOW": { "type": "string", "minLength": 1 },
+        "MED": { "type": "string", "minLength": 1 },
+        "HIGH": { "type": "string", "minLength": 1 }
+      }
+    },
+    "verifyQuota": {
+      "enum": ["1", "3", "full"]
+    },
+    "verifyStrategy": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "intermediateQuota": { "$ref": "#/$defs/verifyQuota" },
+        "finalQuota": {
+          "const": "full",
+          "default": "full",
+          "description": "Final completion verification cannot be quota-reduced."
+        },
+        "focusedCommandSource": {
+          "const": "adapter",
+          "default": "adapter"
+        }
+      }
+    },
+    "shellVerifyEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["phase", "quota", "commandSource", "commandCount"],
+      "properties": {
+        "phase": { "enum": ["intermediate", "final"] },
+        "quota": { "$ref": "#/$defs/verifyQuota" },
+        "commandSource": { "enum": ["adapter", "inline"] },
+        "commandCount": { "type": "integer", "minimum": 0 },
+        "commandLabels": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": []
+        },
+        "finalFullRequired": { "type": "boolean" }
+      }
+    },
+    "repairArtifactGate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["fromNodeId"],
+      "properties": {
+        "fromNodeId": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        }
+      }
+    },
+    "shellConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "commands": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "default": []
+        },
+        "preset": {
+          "enum": ["loop-agent-standard-verify"]
+        },
+        "verdictGate": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["fromNodeId", "accept"],
+          "properties": {
+            "fromNodeId": {
+              "type": "string",
+              "pattern": "^[a-z][a-z0-9-]*$",
+              "description": "Upstream node id whose canonical JSON output in the runner-injected current run directory ($HARNESS_DAG_RUN_DIR/<fromNodeId>.json) supplies the verdict line."
+            },
+            "accept": {
+              "type": "array",
+              "minItems": 1,
+              "items": { "type": "string", "minLength": 1 },
+              "description": "Exact assistantText/stdout verdict lines that pass the gate."
+            },
+            "label": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Optional human-readable gate label for error messages."
+            },
+            "lineMode": {
+              "type": "string",
+              "enum": ["first-non-empty", "first-verdict-line"],
+              "default": "first-non-empty",
+              "description": "Selects how verdict gates parse assistant output: first non-empty line (legacy) or first normalized line starting with 'VERDICT:' (common whole-line Markdown emphasis is normalized before exact accept matching)."
+            }
+          }
+        },
+        "verifyEvidence": { "$ref": "#/$defs/shellVerifyEvidence" },
+        "repairArtifactGate": { "$ref": "#/$defs/repairArtifactGate" },
+        "envAllowlist": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Z_][A-Z0-9_]*$"
+          }
+        },
+        "timeoutMs": { "type": "number" },
+        "cwd": { "type": "string", "minLength": 1 }
+      },
+      "anyOf": [
+        { "required": ["commands"], "properties": { "commands": { "minItems": 1 } } },
+        { "required": ["preset"] },
+        { "required": ["verdictGate"] }
+      ]
+    },
+    "staticConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["resultMarkdown"],
+      "properties": {
+        "resultMarkdown": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["success", "error"] }
+      }
+    },
+    "promptSource": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "path", "sha256"],
+      "properties": {
+        "type": { "const": "markdown" },
+        "path": { "type": "string", "minLength": 1 },
+        "sha256": { "type": "string", "minLength": 1 }
+      }
+    },
+    "task": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "depends_on", "complexity"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "depends_on": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+          "default": []
+        },
+        "complexity": { "$ref": "#/$defs/complexity" },
+        "subtask_prompt": {
+          "type": "string",
+          "minLength": 1
+        },
+        "subtask_prompt_markdown": {
+          "type": "string",
+          "minLength": 1
+        },
+        "subtask_prompt_source": { "$ref": "#/$defs/promptSource" },
+        "executor": {
+          "$ref": "#/$defs/executor",
+          "default": "pi"
+        },
+        "role": { "$ref": "#/$defs/role" },
+        "skills": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "toolProfile": { "$ref": "#/$defs/toolProfile" },
+        "writePolicy": { "$ref": "#/$defs/writePolicy" },
+        "writeSet": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "piStep": {
+          "type": "string",
+          "minLength": 1
+        },
+        "shell": {
+          "$ref": "#/$defs/shellConfig"
+        },
+        "static": {
+          "$ref": "#/$defs/staticConfig"
+        },
+        "outputContract": {
+          "type": "string",
+          "minLength": 1
+        },
+        "allowedPaths": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "default": []
+        },
+        "forbiddenPaths": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "default": []
+        },
+        "decisionGate": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["enabled"],
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "schemaVersion": { "const": 1 },
+            "mode": {
+              "enum": ["record-only", "pause-on-human"],
+              "default": "record-only"
+            }
+          }
+        }
+      },
+      "oneOf": [
+        {
+          "description": "Inline prompt only; subtask_prompt_markdown must be absent.",
+          "required": ["subtask_prompt"],
+          "not": { "required": ["subtask_prompt_markdown"] }
+        },
+        {
+          "description": "Markdown-backed prompt only; subtask_prompt must be absent until file loader resolves it.",
+          "required": ["subtask_prompt_markdown"],
+          "not": { "required": ["subtask_prompt"] }
+        }
+      ]
+    }
+  }
+}