@agent-workspace/core 0.2.1 → 0.5.0

package/schemas/manifesto.schema.json

@@ -0,0 +1,214 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/manifesto.schema.json",
+  "title": "AWP Manifesto Configuration",
+  "description": "Machine-readable configuration for manifesto principles (EXP v1.0)",
+  "type": "object",
+  "required": ["exp", "type", "id", "name", "version", "values", "fitness", "constraints"],
+  "properties": {
+    "exp": {
+      "type": "string",
+      "description": "EXP specification version"
+    },
+    "type": {
+      "type": "string",
+      "const": "manifesto"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^manifesto:[a-z0-9][a-z0-9-]*$",
+      "description": "Unique identifier (manifesto:<slug>)"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable manifesto name"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Manifesto version (semver)"
+    },
+    "values": {
+      "type": "object",
+      "description": "Core value weights (must sum to 1.0)",
+      "additionalProperties": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1
+      }
+    },
+    "fitness": {
+      "$ref": "#/$defs/fitnessConfig",
+      "description": "Society-level fitness function weights"
+    },
+    "purity": {
+      "$ref": "#/$defs/purityConfig",
+      "description": "Agent purity score computation weights"
+    },
+    "constraints": {
+      "$ref": "#/$defs/constraintsConfig",
+      "description": "Resource constraints for societies"
+    },
+    "governance": {
+      "$ref": "#/$defs/governanceConfig",
+      "description": "Governance rules"
+    },
+    "lifecycle": {
+      "$ref": "#/$defs/lifecycleConfig",
+      "description": "Agent birth and death rules"
+    },
+    "evolution": {
+      "$ref": "#/$defs/evolutionConfig",
+      "description": "What the manifesto evolves"
+    },
+    "antiPatterns": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/antiPattern" },
+      "description": "Anti-patterns to detect and penalize"
+    },
+    "successCriteria": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/successCriterion" },
+      "description": "Criteria for manifesto success"
+    }
+  },
+  "additionalProperties": true,
+  "$defs": {
+    "fitnessConfig": {
+      "type": "object",
+      "properties": {
+        "goal-completion-rate": { "type": "number", "minimum": 0, "maximum": 1 },
+        "error-recovery-speed": { "type": "number", "minimum": 0, "maximum": 1 },
+        "coordination-efficiency": { "type": "number", "minimum": 0, "maximum": 1 },
+        "trust-stability": { "type": "number", "minimum": 0, "maximum": 1 },
+        "human-intervention-frequency": { "type": "number", "minimum": 0, "maximum": 1 }
+      },
+      "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 }
+    },
+    "purityConfig": {
+      "type": "object",
+      "properties": {
+        "epistemic-hygiene": { "type": "number", "minimum": 0, "maximum": 1 },
+        "reliability": { "type": "number", "minimum": 0, "maximum": 1 },
+        "coordination": { "type": "number", "minimum": 0, "maximum": 1 }
+      },
+      "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 }
+    },
+    "constraintsConfig": {
+      "type": "object",
+      "properties": {
+        "maxAgents": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum agents in the society"
+        },
+        "maxConcurrentTasks": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum concurrent tasks"
+        },
+        "maxContractsPerAgent": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum contracts per agent"
+        },
+        "taskBudgetPerCycle": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Tasks generated per cycle"
+        },
+        "trustBudget": {
+          "type": "number",
+          "minimum": 0,
+          "description": "Total trust budget for the society"
+        }
+      },
+      "additionalProperties": true
+    },
+    "governanceConfig": {
+      "type": "object",
+      "properties": {
+        "humanApprovalRequired": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Actions requiring human approval"
+        },
+        "escalationThreshold": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Confidence threshold for escalation"
+        },
+        "vetoPower": {
+          "type": "boolean",
+          "description": "Whether humans have veto power"
+        }
+      },
+      "additionalProperties": true
+    },
+    "lifecycleConfig": {
+      "type": "object",
+      "properties": {
+        "birthRequires": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Requirements for agent instantiation"
+        },
+        "deathTriggers": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["condition", "action"],
+            "properties": {
+              "condition": { "type": "string" },
+              "action": {
+                "type": "string",
+                "enum": ["suspend-delegation", "rate-limit", "archive", "merge-candidate"]
+              }
+            }
+          },
+          "description": "Conditions that trigger agent lifecycle events"
+        }
+      },
+      "additionalProperties": true
+    },
+    "evolutionConfig": {
+      "type": "object",
+      "properties": {
+        "target": {
+          "type": "string",
+          "enum": ["institutions", "agents", "both"],
+          "description": "What the manifesto optimizes"
+        },
+        "extractRoleTemplates": {
+          "type": "boolean",
+          "description": "Whether to extract role templates from successful patterns"
+        },
+        "formalizeSuccessfulPatterns": {
+          "type": "boolean",
+          "description": "Whether to formalize successful coordination patterns"
+        }
+      },
+      "additionalProperties": true
+    },
+    "antiPattern": {
+      "type": "object",
+      "required": ["id", "detector", "penalty"],
+      "properties": {
+        "id": { "type": "string" },
+        "detector": { "type": "string", "description": "Detection rule expression" },
+        "penalty": { "type": "number", "minimum": 0, "maximum": 1 }
+      }
+    },
+    "successCriterion": {
+      "type": "object",
+      "required": ["id", "metric"],
+      "properties": {
+        "id": { "type": "string" },
+        "metric": { "type": "string" },
+        "threshold": { "type": "number" },
+        "direction": { "type": "string", "enum": ["increasing", "decreasing", "stable"] }
+      }
+    }
+  }
+}

package/schemas/project.schema.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/project.schema.json",
+  "title": "AWP Project",
+  "description": "Schema for AWP project frontmatter (CDP v1.0)",
+  "type": "object",
+  "required": ["awp", "cdp", "type", "id", "title", "status", "owner", "created", "members", "taskCount", "completedCount"],
+  "properties": {
+    "awp": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "AWP specification version"
+    },
+    "cdp": {
+      "type": "string",
+      "description": "CDP specification version"
+    },
+    "type": {
+      "type": "string",
+      "const": "project"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^project:[a-z0-9][a-z0-9-]*$",
+      "description": "Unique identifier (project:<slug>)"
+    },
+    "title": {
+      "type": "string",
+      "description": "Human-readable project title"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "active", "paused", "completed", "archived"],
+      "description": "Project lifecycle state"
+    },
+    "owner": {
+      "type": "string",
+      "description": "DID of the project owner"
+    },
+    "created": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Project creation timestamp"
+    },
+    "deadline": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Optional deadline"
+    },
+    "members": {
+      "type": "array",
+      "description": "Project members with roles and optional reputation gates",
+      "items": {
+        "$ref": "#/$defs/projectMember"
+      },
+      "minItems": 1
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Classification tags"
+    },
+    "taskCount": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Total number of tasks"
+    },
+    "completedCount": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of completed tasks"
+    }
+  },
+  "additionalProperties": true,
+  "$defs": {
+    "projectMember": {
+      "type": "object",
+      "required": ["did", "role", "slug"],
+      "properties": {
+        "did": {
+          "type": "string",
+          "description": "W3C DID of the member agent"
+        },
+        "role": {
+          "type": "string",
+          "description": "Role name (e.g., 'lead', 'researcher', 'writer')"
+        },
+        "slug": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*$",
+          "description": "Reputation profile slug"
+        },
+        "minReputation": {
+          "type": "object",
+          "description": "Map of dimension/domain to minimum score threshold",
+          "additionalProperties": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          }
+        }
+      },
+      "additionalProperties": true
+    }
+  }
+}

package/schemas/reputation-profile.schema.json

@@ -0,0 +1,132 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/reputation-profile.schema.json",
+  "title": "AWP Reputation Profile",
+  "description": "Schema for AWP reputation profile frontmatter (RDP v1.0)",
+  "type": "object",
+  "required": ["awp", "rdp", "type", "id", "agentDid", "agentName", "lastUpdated", "signals"],
+  "properties": {
+    "awp": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "AWP specification version"
+    },
+    "rdp": {
+      "type": "string",
+      "description": "RDP specification version"
+    },
+    "type": {
+      "type": "string",
+      "const": "reputation-profile"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^reputation:[a-z0-9][a-z0-9-]*$",
+      "description": "Unique identifier (reputation:<slug>)"
+    },
+    "agentDid": {
+      "type": "string",
+      "description": "W3C DID of the tracked agent"
+    },
+    "agentName": {
+      "type": "string",
+      "description": "Human-readable agent name"
+    },
+    "lastUpdated": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Timestamp of last signal"
+    },
+    "dimensions": {
+      "type": "object",
+      "description": "Map of dimension name to score object",
+      "additionalProperties": {
+        "$ref": "#/$defs/dimensionScore"
+      }
+    },
+    "domainCompetence": {
+      "type": "object",
+      "description": "Map of domain name to score object",
+      "additionalProperties": {
+        "$ref": "#/$defs/dimensionScore"
+      }
+    },
+    "signals": {
+      "type": "array",
+      "description": "Append-only log of reputation signals",
+      "items": {
+        "$ref": "#/$defs/reputationSignal"
+      }
+    }
+  },
+  "additionalProperties": true,
+  "$defs": {
+    "dimensionScore": {
+      "type": "object",
+      "required": ["score", "confidence", "sampleSize", "lastSignal"],
+      "properties": {
+        "score": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Raw score (before decay)"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Data confidence level"
+        },
+        "sampleSize": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of signals received"
+        },
+        "lastSignal": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Timestamp of most recent signal"
+        }
+      },
+      "additionalProperties": true
+    },
+    "reputationSignal": {
+      "type": "object",
+      "required": ["source", "dimension", "score", "timestamp"],
+      "properties": {
+        "source": {
+          "type": "string",
+          "description": "DID of the observer"
+        },
+        "dimension": {
+          "type": "string",
+          "description": "Which dimension (e.g., 'reliability', 'domain-competence')"
+        },
+        "domain": {
+          "type": "string",
+          "description": "Domain name (required when dimension is 'domain-competence')"
+        },
+        "score": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Observed performance score"
+        },
+        "timestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When the observation was made"
+        },
+        "evidence": {
+          "type": "string",
+          "description": "Reference to supporting evidence (e.g., 'contract:q3-research')"
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable note"
+        }
+      },
+      "additionalProperties": true
+    }
+  }
+}

package/schemas/society.schema.json

@@ -0,0 +1,190 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/society.schema.json",
+  "title": "AWP Society Container",
+  "description": "Schema for society manifest - an isolated agent population under a manifesto (EXP v1.0)",
+  "type": "object",
+  "required": ["exp", "type", "id", "name", "manifesto", "status", "created", "cycle", "population", "resources"],
+  "properties": {
+    "exp": {
+      "type": "string",
+      "description": "EXP specification version"
+    },
+    "type": {
+      "type": "string",
+      "const": "society"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^society:[a-z0-9][a-z0-9-]*$",
+      "description": "Unique identifier (society:<slug>)"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable society name"
+    },
+    "manifesto": {
+      "type": "string",
+      "pattern": "^manifesto:[a-z0-9][a-z0-9-]*$",
+      "description": "ID of the governing manifesto"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["initializing", "running", "paused", "completed", "archived"],
+      "description": "Society lifecycle state"
+    },
+    "created": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Creation timestamp"
+    },
+    "cycle": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Current simulation cycle"
+    },
+    "population": {
+      "$ref": "#/$defs/populationStats",
+      "description": "Agent population statistics"
+    },
+    "resources": {
+      "$ref": "#/$defs/resourceStats",
+      "description": "Resource allocation"
+    },
+    "fitness": {
+      "$ref": "#/$defs/fitnessStats",
+      "description": "Society fitness metrics"
+    },
+    "alerts": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/alert" },
+      "description": "Active alerts (anti-patterns, escalations)"
+    },
+    "roleTemplates": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "IDs of role templates emerged from this society"
+    },
+    "linkedExperiment": {
+      "type": "string",
+      "pattern": "^experiment:[a-z0-9][a-z0-9-]*$",
+      "description": "ID of experiment this society belongs to (if any)"
+    }
+  },
+  "additionalProperties": true,
+  "$defs": {
+    "populationStats": {
+      "type": "object",
+      "required": ["current", "max"],
+      "properties": {
+        "current": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Current agent count"
+        },
+        "max": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum allowed agents"
+        },
+        "births": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total agents instantiated"
+        },
+        "deaths": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total agents that died (all types)"
+        },
+        "archived": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Agents archived"
+        },
+        "merged": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Agents merged into others"
+        },
+        "suspended": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Currently suspended agents"
+        }
+      }
+    },
+    "resourceStats": {
+      "type": "object",
+      "properties": {
+        "trustBudget": {
+          "type": "object",
+          "properties": {
+            "total": { "type": "number" },
+            "allocated": { "type": "number" },
+            "available": { "type": "number" }
+          }
+        },
+        "taskSlots": {
+          "type": "object",
+          "properties": {
+            "total": { "type": "integer" },
+            "active": { "type": "integer" },
+            "available": { "type": "integer" }
+          }
+        },
+        "contractSlots": {
+          "type": "object",
+          "properties": {
+            "total": { "type": "integer" },
+            "active": { "type": "integer" },
+            "available": { "type": "integer" }
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "fitnessStats": {
+      "type": "object",
+      "properties": {
+        "current": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Current fitness score"
+        },
+        "history": {
+          "type": "array",
+          "items": { "type": "number" },
+          "description": "Fitness score history (per measurement interval)"
+        },
+        "components": {
+          "type": "object",
+          "additionalProperties": { "type": "number" },
+          "description": "Current values of individual fitness components"
+        }
+      }
+    },
+    "alert": {
+      "type": "object",
+      "required": ["type", "severity"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["anti-pattern", "escalation", "resource-exhaustion", "fitness-decline"]
+        },
+        "pattern": { "type": "string" },
+        "agent": { "type": "string" },
+        "message": { "type": "string" },
+        "severity": {
+          "type": "string",
+          "enum": ["info", "warning", "critical"]
+        },
+        "timestamp": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    }
+  }
+}