@voybio/ace-swarm 0.1.0

package/assets/agent-state/MODULES/schemas/HANDOFF.agent-state.schema.json

@@ -0,0 +1,124 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "ace://schemas/agent-state-handoff/1.0.0",
+  "title": "ACE Agent-State Handoff",
+  "type": "object",
+  "required": [
+    "meta",
+    "transition",
+    "payload",
+    "integrity"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "meta": {
+      "type": "object",
+      "required": [
+        "timestamp",
+        "iteration",
+        "session_id",
+        "log_commit"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "timestamp": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "iteration": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "session_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "log_commit": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        }
+      }
+    },
+    "transition": {
+      "type": "object",
+      "required": [
+        "from",
+        "to",
+        "status",
+        "reason"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "from": {
+          "type": "string",
+          "pattern": "^(capability|agent)-[a-z0-9-]+$"
+        },
+        "to": {
+          "type": "string",
+          "pattern": "^(capability|agent)-[a-z0-9-]+$"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "READY",
+            "READY_FOR_REVIEW",
+            "BLOCKED",
+            "DONE"
+          ]
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "payload": {
+      "type": "object",
+      "required": [
+        "primary_artifact",
+        "interface_contract",
+        "evidence_pointer",
+        "known_issues"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "primary_artifact": {
+          "type": "string",
+          "minLength": 1
+        },
+        "interface_contract": {
+          "type": "string",
+          "minLength": 1
+        },
+        "evidence_pointer": {
+          "type": "string",
+          "minLength": 1
+        },
+        "known_issues": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "integrity": {
+      "type": "object",
+      "required": [
+        "checksum",
+        "file_count"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "checksum": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        "file_count": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    }
+  }
+}

package/assets/agent-state/MODULES/schemas/HANDOFF.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "ace://schemas/handoff/1-0-0",
+  "title": "HANDOFF",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["meta", "transition", "payload", "integrity"],
+  "properties": {
+    "meta": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["timestamp", "iteration", "session_id", "log_commit"],
+      "properties": {
+        "timestamp": {"type": "string", "format": "date-time"},
+        "iteration": {"type": "integer", "minimum": 1},
+        "session_id": {"type": "string", "minLength": 8},
+        "log_commit": {"type": "string", "minLength": 4}
+      }
+    },
+    "transition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["from", "to", "status", "reason"],
+      "properties": {
+        "from": {"type": "string", "pattern": "^(capability|agent)-[a-z0-9-]+$"},
+        "to": {"type": "string", "pattern": "^(capability|agent)-[a-z0-9-]+$"},
+        "status": {"type": "string", "enum": ["READY", "READY_FOR_REVIEW", "BLOCKED", "DONE"]},
+        "reason": {"type": "string", "minLength": 1}
+      }
+    },
+    "payload": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["primary_artifact", "interface_contract", "evidence_pointer", "known_issues"],
+      "properties": {
+        "primary_artifact": {"type": "string", "minLength": 1},
+        "interface_contract": {"type": "string", "minLength": 1},
+        "evidence_pointer": {"type": "string", "minLength": 1},
+        "known_issues": {
+          "type": "array",
+          "items": {"type": "string"}
+        }
+      }
+    },
+    "integrity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["checksum", "file_count"],
+      "properties": {
+        "checksum": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
+        "file_count": {"type": "integer", "minimum": 0}
+      }
+    }
+  }
+}

package/assets/agent-state/MODULES/schemas/RUNTIME_EXECUTOR_SESSION_REGISTRY.schema.json

@@ -0,0 +1,290 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "ace://schemas/runtime-executor-session-registry/1.0.0",
+  "title": "ACE Runtime Executor Session Registry",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "updated_at",
+    "sessions"
+  ],
+  "properties": {
+    "version": {
+      "type": "integer",
+      "const": 1
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "sessions": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/session"
+      }
+    }
+  },
+  "$defs": {
+    "tool_call": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "tool_name",
+        "ok",
+        "summary",
+        "request_path",
+        "response_path",
+        "started_at",
+        "ended_at"
+      ],
+      "properties": {
+        "tool_name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "ok": {
+          "type": "boolean"
+        },
+        "summary": {
+          "type": "string",
+          "minLength": 1
+        },
+        "request_path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "response_path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "started_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "ended_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "output": {},
+        "error": {},
+        "validation_errors": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "turn": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "turn_number",
+        "task",
+        "started_at",
+        "ended_at",
+        "status",
+        "response_status",
+        "summary",
+        "prompt_path",
+        "request_path",
+        "response_path",
+        "exit_code",
+        "stdout",
+        "stderr",
+        "tool_calls"
+      ],
+      "properties": {
+        "turn_number": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "task": {
+          "type": "string",
+          "minLength": 1
+        },
+        "started_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "ended_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "completed",
+            "failed",
+            "blocked",
+            "stopped"
+          ]
+        },
+        "response_status": {
+          "type": "string",
+          "enum": [
+            "continue",
+            "done",
+            "blocked",
+            "failed"
+          ]
+        },
+        "summary": {
+          "type": "string",
+          "minLength": 1
+        },
+        "prompt_path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "request_path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "response_path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "exit_code": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "stdout": {
+          "type": "string"
+        },
+        "stderr": {
+          "type": "string"
+        },
+        "tool_calls": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/tool_call"
+          }
+        }
+      }
+    },
+    "session": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_id",
+        "status",
+        "task",
+        "current_task",
+        "runtime_profile_path",
+        "workspace_session_id",
+        "workspace_path",
+        "command",
+        "max_turns",
+        "turn_timeout_ms",
+        "turn_count",
+        "created_at",
+        "updated_at",
+        "workspace_cleanup_status",
+        "turns"
+      ],
+      "properties": {
+        "session_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "starting",
+            "running",
+            "completed",
+            "failed",
+            "blocked",
+            "stopped"
+          ]
+        },
+        "task": {
+          "type": "string",
+          "minLength": 1
+        },
+        "current_task": {
+          "type": "string",
+          "minLength": 1
+        },
+        "runtime_profile_path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "workspace_session_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "workspace_path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "objective_id": {
+          "type": "string"
+        },
+        "tracker_item_id": {
+          "type": "string"
+        },
+        "command": {
+          "type": "string",
+          "minLength": 1
+        },
+        "max_turns": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "turn_timeout_ms": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "turn_count": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "updated_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "started_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "ended_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "result_summary": {
+          "type": "string"
+        },
+        "last_error": {
+          "type": "string"
+        },
+        "cleanup_error": {
+          "type": "string"
+        },
+        "workspace_cleanup_status": {
+          "type": "string",
+          "enum": [
+            "pending",
+            "removed",
+            "archived",
+            "failed"
+          ]
+        },
+        "turns": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/turn"
+          }
+        }
+      }
+    }
+  }
+}

package/assets/agent-state/MODULES/schemas/RUNTIME_TOOL_SPEC_REGISTRY.schema.json

@@ -0,0 +1,144 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "ace://schemas/runtime-tool-spec-registry/1.0.0",
+  "title": "ACE Runtime Tool Spec Registry",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "updated_at",
+    "tools"
+  ],
+  "properties": {
+    "version": {
+      "type": "integer",
+      "const": 1
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "tools": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/tool_spec"
+      }
+    }
+  },
+  "$defs": {
+    "scalar_enum_item": {
+      "type": [
+        "string",
+        "number",
+        "boolean",
+        "null"
+      ]
+    },
+    "schema_node": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "object",
+            "array",
+            "string",
+            "number",
+            "integer",
+            "boolean",
+            "null"
+          ]
+        },
+        "description": {
+          "type": "string"
+        },
+        "enum": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/scalar_enum_item"
+          }
+        },
+        "properties": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/$defs/schema_node"
+          }
+        },
+        "required": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": {
+          "type": "boolean"
+        },
+        "items": {
+          "$ref": "#/$defs/schema_node"
+        }
+      }
+    },
+    "executor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "command"
+      ],
+      "properties": {
+        "command": {
+          "type": "string",
+          "minLength": 1
+        },
+        "cwd": {
+          "type": "string"
+        },
+        "timeout_ms": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "env": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "tool_spec": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "description",
+        "input_schema",
+        "executor"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "input_schema": {
+          "$ref": "#/$defs/schema_node"
+        },
+        "success_schema": {
+          "$ref": "#/$defs/schema_node"
+        },
+        "failure_schema": {
+          "$ref": "#/$defs/schema_node"
+        },
+        "executor": {
+          "$ref": "#/$defs/executor"
+        }
+      }
+    }
+  }
+}

package/assets/agent-state/MODULES/schemas/STATUS_EVENT.schema.json

@@ -0,0 +1,84 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "ace://schemas/status-event/1.0.0",
+  "title": "ACE Status Event",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "event_id",
+    "trace_id",
+    "timestamp",
+    "source_module",
+    "event_type",
+    "status",
+    "payload"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": {
+      "const": "1.0.0"
+    },
+    "event_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "trace_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "source_module": {
+      "type": "string",
+      "pattern": "^(capability|agent)-[a-z0-9-]+$"
+    },
+    "event_type": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "started",
+        "in_progress",
+        "pass",
+        "fail",
+        "blocked",
+        "done"
+      ]
+    },
+    "objective_id": {
+      "type": "string"
+    },
+    "decision_id": {
+      "type": "string"
+    },
+    "payload": {
+      "type": "object",
+      "required": [
+        "summary"
+      ],
+      "properties": {
+        "summary": {
+          "type": "string",
+          "minLength": 1
+        },
+        "gate_id": {
+          "type": "string"
+        },
+        "evidence_ref": {
+          "type": "string"
+        },
+        "artifact_delta": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    }
+  }
+}