@agent-workspace/core 0.2.1 → 0.5.0

package/dist/types/workspace.d.ts

@@ -1,65 +1,106 @@
 /**
- * AWP Workspace manifest (.awp/workspace.json)
+ * AWP Workspace manifest stored at .awp/workspace.json
+ * Contains workspace-level metadata and agent configuration.
  */
 export interface WorkspaceManifest {
+    /** AWP specification version (e.g., "0.4.0") */
     awp: string;
+    /** Unique workspace identifier (URN format) */
     id: string;
+    /** Human-readable workspace name */
     name: string;
+    /** ISO 8601 timestamp when workspace was created */
     created: string;
+    /** Agent configuration */
     agent: {
+        /** Agent's decentralized identifier (did:key format) */
         did?: string;
+        /** Path to identity file (default: "IDENTITY.md") */
         identityFile: string;
     };
+    /** List of agent capabilities (e.g., ["coding", "research"]) */
     capabilities?: string[];
+    /** Protocol support flags */
     protocols?: {
+        /** Agent-to-Agent protocol support */
         a2a?: boolean;
+        /** Model Context Protocol support */
         mcp?: boolean;
     };
 }
 /**
- * Common frontmatter fields shared by all workspace files
+ * Common YAML frontmatter fields shared by all AWP workspace files.
+ * Every workspace file (*.md) includes these base fields.
  */
 export interface BaseFrontmatter {
+    /** AWP specification version */
     awp: string;
+    /** File type identifier (e.g., "identity", "soul", "memory-daily") */
     type: string;
+    /** ISO 8601 timestamp of last modification */
     lastModified?: string;
+    /** DID or identifier of last modifier */
     modifiedBy?: string;
 }
 /**
- * IDENTITY.md frontmatter
+ * IDENTITY.md frontmatter - defines the agent's public identity.
+ * Contains factual information about what the agent is and can do.
  */
 export interface IdentityFrontmatter extends BaseFrontmatter {
     type: "identity";
+    /** Decentralized identifier (did:key format) */
     did?: string;
+    /** Agent's display name */
     name: string;
+    /** What kind of entity this is (e.g., "digital assistant", "coding agent") */
     creature?: string;
+    /** Representative emoji */
     emoji?: string;
+    /** URL to avatar image */
     avatar?: string;
+    /** List of capabilities this agent has */
     capabilities?: string[];
+    /** ISO 8601 timestamp when identity was created */
     created: string;
 }
 /**
- * SOUL.md frontmatter
+ * SOUL.md frontmatter - defines the agent's personality, values, and behavioral constraints.
+ * This is who the agent IS, not just what it can do.
  */
 export interface SoulFrontmatter extends BaseFrontmatter {
     type: "soul";
+    /** Brief personality description */
     vibe?: string;
+    /** Core values that guide behavior */
     values?: SoulValue[];
+    /** Behavioral boundaries and constraints */
     boundaries?: SoulBoundary[];
+    /** Governance rules for human oversight */
     governance?: SoulGovernance;
 }
+/** A core value that guides agent behavior */
 export interface SoulValue {
+    /** Unique identifier for this value */
     id: string;
+    /** Priority ranking (1 = highest) */
     priority?: number;
+    /** Description of what this value means in practice */
     description: string;
 }
+/** A behavioral boundary or constraint */
 export interface SoulBoundary {
+    /** Unique identifier for this boundary */
     id: string;
+    /** The rule or constraint */
     rule: string;
+    /** Severity level: "hard" = never violate, "soft" = prefer to follow */
     severity: "hard" | "soft";
 }
+/** Governance rules defining what requires human approval */
 export interface SoulGovernance {
+    /** Actions that always require human approval */
     humanApprovalRequired?: string[];
+    /** Actions the agent can take autonomously */
     autonomouslyAllowed?: string[];
 }
 /**
@@ -90,17 +131,25 @@ export interface OperationsFrontmatter extends BaseFrontmatter {
     };
 }
 /**
- * Daily memory log frontmatter
+ * Daily memory log frontmatter (memory/YYYY-MM-DD.md).
+ * Contains structured entries from a single day.
  */
 export interface MemoryDailyFrontmatter extends BaseFrontmatter {
     type: "memory-daily";
+    /** Date in YYYY-MM-DD format */
     date: string;
+    /** Structured memory entries for this day */
     entries?: MemoryEntry[];
 }
+/** A single memory entry in a daily log */
 export interface MemoryEntry {
+    /** Time of entry in HH:MM format */
     time?: string;
+    /** The memory content */
     content: string;
+    /** Tags for categorization and search */
     tags?: string[];
+    /** Whether this entry should be preserved during compaction */
     pinned?: boolean;
 }
 /**
@@ -132,16 +181,28 @@ export interface HeartbeatTask {
     enabled?: boolean;
 }
 import type { ArtifactFrontmatter } from "./artifact.js";
+import type { ReputationProfileFrontmatter } from "./reputation.js";
+import type { DelegationContractFrontmatter } from "./contract.js";
+import type { ProjectFrontmatter, TaskFrontmatter } from "./project.js";
 /**
  * Union of all frontmatter types
  */
-export type AnyFrontmatter = IdentityFrontmatter | SoulFrontmatter | UserFrontmatter | OperationsFrontmatter | ToolsFrontmatter | HeartbeatFrontmatter | MemoryDailyFrontmatter | MemoryLongtermFrontmatter | ArtifactFrontmatter;
+export type AnyFrontmatter = IdentityFrontmatter | SoulFrontmatter | UserFrontmatter | OperationsFrontmatter | ToolsFrontmatter | HeartbeatFrontmatter | MemoryDailyFrontmatter | MemoryLongtermFrontmatter | ArtifactFrontmatter | ReputationProfileFrontmatter | DelegationContractFrontmatter | ProjectFrontmatter | TaskFrontmatter;
 /**
- * A parsed workspace file — frontmatter + markdown body
+ * A parsed AWP workspace file containing YAML frontmatter and markdown body.
+ * Generic type T allows type-safe access to specific frontmatter types.
+ *
+ * @template T - The frontmatter type (extends BaseFrontmatter)
+ * @example
+ * const identity = await parseWorkspaceFile<IdentityFrontmatter>("IDENTITY.md");
+ * console.log(identity.frontmatter.name); // Type-safe access
  */
 export interface WorkspaceFile<T extends BaseFrontmatter = BaseFrontmatter> {
+    /** Parsed YAML frontmatter */
     frontmatter: T;
+    /** Markdown body content (without frontmatter) */
     body: string;
+    /** Absolute path to the file */
     filePath: string;
 }
 //# sourceMappingURL=workspace.d.ts.map

package/dist/types/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/types/workspace.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/types/workspace.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-workspace/core",
-  "version": "0.2.1",
+  "version": "0.5.0",
   "description": "Core types, constants, and schemas for the Agent Workspace Protocol",
   "license": "Apache-2.0",
   "type": "module",
@@ -39,8 +39,13 @@
     "node": ">=18"
   },
   "scripts": {
+    "copy-schemas": "cp -r ../../spec/schemas/* ./schemas/",
+    "prebuild": "npm run copy-schemas",
     "build": "tsc",
     "dev": "tsc --watch",
+    "lint": "eslint src/",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build"
   },

package/schemas/delegation-contract.schema.json

@@ -0,0 +1,139 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/delegation-contract.schema.json",
+  "title": "AWP Delegation Contract",
+  "description": "Schema for AWP delegation contract frontmatter (RDP v1.0)",
+  "type": "object",
+  "required": ["awp", "rdp", "type", "id", "status", "delegator", "delegate", "delegateSlug", "created", "task", "evaluation"],
+  "properties": {
+    "awp": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "AWP specification version"
+    },
+    "rdp": {
+      "type": "string",
+      "description": "RDP specification version"
+    },
+    "type": {
+      "type": "string",
+      "const": "delegation-contract"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^contract:[a-z0-9][a-z0-9-]*$",
+      "description": "Unique identifier (contract:<slug>)"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "active", "completed", "evaluated"],
+      "description": "Contract lifecycle state"
+    },
+    "delegator": {
+      "type": "string",
+      "description": "DID of the agent delegating work"
+    },
+    "delegate": {
+      "type": "string",
+      "description": "DID of the agent receiving work"
+    },
+    "delegateSlug": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$",
+      "description": "Slug of delegate's reputation profile"
+    },
+    "created": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Contract creation timestamp"
+    },
+    "deadline": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Optional deadline"
+    },
+    "task": {
+      "type": "object",
+      "required": ["description"],
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "What needs to be done"
+        },
+        "outputFormat": {
+          "type": "string",
+          "description": "Expected output type (e.g., 'knowledge-artifact')"
+        },
+        "outputSlug": {
+          "type": "string",
+          "description": "Expected output artifact slug"
+        }
+      },
+      "additionalProperties": true
+    },
+    "scope": {
+      "type": "object",
+      "properties": {
+        "include": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "What's in scope"
+        },
+        "exclude": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "What's out of scope"
+        }
+      },
+      "additionalProperties": true
+    },
+    "constraints": {
+      "type": "object",
+      "properties": {
+        "requireCitations": {
+          "type": "boolean",
+          "description": "Must cite sources"
+        },
+        "confidenceThreshold": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Minimum confidence for claims"
+        }
+      },
+      "additionalProperties": true
+    },
+    "evaluation": {
+      "type": "object",
+      "required": ["criteria"],
+      "properties": {
+        "criteria": {
+          "type": "object",
+          "description": "Map of criterion name to weight (should sum to 1.0)",
+          "additionalProperties": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          }
+        },
+        "result": {
+          "oneOf": [
+            { "type": "null" },
+            {
+              "type": "object",
+              "description": "Map of criterion name to score (0.0-1.0)",
+              "additionalProperties": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1
+              }
+            }
+          ],
+          "description": "Evaluation results, null until evaluated"
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/experiment.schema.json

@@ -0,0 +1,223 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/experiment.schema.json",
+  "title": "AWP Experiment",
+  "description": "Schema for experiment manifest - comparing societies under different manifestos (EXP v1.0)",
+  "type": "object",
+  "required": ["exp", "type", "id", "name", "status", "created", "societies", "simulation"],
+  "properties": {
+    "exp": {
+      "type": "string",
+      "description": "EXP specification version"
+    },
+    "type": {
+      "type": "string",
+      "const": "experiment"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^experiment:[a-z0-9][a-z0-9-]*$",
+      "description": "Unique identifier (experiment:<slug>)"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable experiment name"
+    },
+    "hypothesis": {
+      "type": "string",
+      "description": "The hypothesis being tested"
+    },
+    "created": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Creation timestamp"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "running", "paused", "completed", "analyzed"],
+      "description": "Experiment lifecycle state"
+    },
+    "societies": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/societyRef" },
+      "minItems": 1,
+      "description": "Societies being compared"
+    },
+    "simulation": {
+      "$ref": "#/$defs/simulationConfig",
+      "description": "Simulation parameters"
+    },
+    "measurement": {
+      "$ref": "#/$defs/measurementConfig",
+      "description": "What and how to measure"
+    },
+    "comparison": {
+      "$ref": "#/$defs/comparisonConfig",
+      "description": "How to compare societies"
+    },
+    "results": {
+      "$ref": "#/$defs/experimentResults",
+      "description": "Experiment results (populated after completion)"
+    }
+  },
+  "additionalProperties": true,
+  "$defs": {
+    "societyRef": {
+      "type": "object",
+      "required": ["id", "manifesto"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^society:[a-z0-9][a-z0-9-]*$"
+        },
+        "manifesto": {
+          "type": "string",
+          "pattern": "^manifesto:[a-z0-9][a-z0-9-]*$"
+        },
+        "label": {
+          "type": "string",
+          "description": "Short label for charts/comparisons"
+        }
+      }
+    },
+    "simulationConfig": {
+      "type": "object",
+      "required": ["cycles"],
+      "properties": {
+        "cycles": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Number of cycles to run"
+        },
+        "cycleLength": {
+          "type": "string",
+          "description": "Simulated time per cycle (e.g., '1 day')"
+        },
+        "tasksPerCycle": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Tasks generated per cycle"
+        },
+        "contractsPerCycle": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Contracts created per cycle"
+        },
+        "randomSeed": {
+          "type": "integer",
+          "description": "Random seed for reproducibility"
+        },
+        "parallelExecution": {
+          "type": "boolean",
+          "description": "Run societies in parallel"
+        }
+      }
+    },
+    "measurementConfig": {
+      "type": "object",
+      "properties": {
+        "interval": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Measure every N cycles"
+        },
+        "metrics": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Metrics to collect"
+        },
+        "snapshots": {
+          "type": "boolean",
+          "description": "Whether to store full state snapshots"
+        }
+      }
+    },
+    "comparisonConfig": {
+      "type": "object",
+      "properties": {
+        "primary": {
+          "type": "string",
+          "description": "Primary metric for comparison"
+        },
+        "statistical": {
+          "type": "string",
+          "enum": ["t-test", "anova", "mann-whitney", "kruskal-wallis"],
+          "description": "Statistical test to use"
+        },
+        "significance": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Significance level (alpha)"
+        }
+      }
+    },
+    "experimentResults": {
+      "type": "object",
+      "properties": {
+        "completedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "totalCycles": {
+          "type": "integer"
+        },
+        "societyResults": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/societyResult" }
+        },
+        "comparison": {
+          "$ref": "#/$defs/comparisonResult"
+        },
+        "conclusion": {
+          "type": "string",
+          "description": "Human-readable conclusion"
+        },
+        "hypothesisSupported": {
+          "type": "boolean",
+          "description": "Whether the hypothesis was supported"
+        }
+      }
+    },
+    "societyResult": {
+      "type": "object",
+      "properties": {
+        "finalFitness": { "type": "number" },
+        "avgFitness": { "type": "number" },
+        "finalPurityMean": { "type": "number" },
+        "roleTemplatesEmerged": { "type": "integer" },
+        "humanInterventions": { "type": "integer" },
+        "antiPatternViolations": { "type": "integer" },
+        "populationHistory": {
+          "type": "array",
+          "items": { "type": "integer" }
+        },
+        "fitnessHistory": {
+          "type": "array",
+          "items": { "type": "number" }
+        }
+      }
+    },
+    "comparisonResult": {
+      "type": "object",
+      "properties": {
+        "metric": { "type": "string" },
+        "means": {
+          "type": "object",
+          "additionalProperties": { "type": "number" }
+        },
+        "stddevs": {
+          "type": "object",
+          "additionalProperties": { "type": "number" }
+        },
+        "testStatistic": { "type": "number" },
+        "pValue": { "type": "number" },
+        "significantDifference": { "type": "boolean" },
+        "winner": {
+          "type": "string",
+          "description": "Society ID with best performance on primary metric"
+        }
+      }
+    }
+  }
+}