@agent-workspace/core 0.1.0

package/dist/constants.d.ts

@@ -0,0 +1,26 @@
+/** Current AWP specification version */
+export declare const AWP_VERSION = "0.1.0";
+/** Required workspace files */
+export declare const REQUIRED_FILES: readonly ["IDENTITY.md", "SOUL.md"];
+/** Optional workspace files */
+export declare const OPTIONAL_FILES: readonly ["AGENTS.md", "USER.md", "TOOLS.md", "HEARTBEAT.md", "BOOTSTRAP.md", "MEMORY.md"];
+/** All known workspace files */
+export declare const ALL_WORKSPACE_FILES: readonly ["IDENTITY.md", "SOUL.md", "AGENTS.md", "USER.md", "TOOLS.md", "HEARTBEAT.md", "BOOTSTRAP.md", "MEMORY.md"];
+/** Workspace manifest path */
+export declare const MANIFEST_PATH = ".awp/workspace.json";
+/** Memory directory */
+export declare const MEMORY_DIR = "memory";
+/** File type to filename mapping */
+export declare const FILE_TYPE_MAP: Record<string, string>;
+/**
+ * Absolute path to the schemas directory bundled with @agent-workspace/core.
+ * Works in monorepo (dev) and when installed from npm.
+ */
+export declare const SCHEMAS_DIR: string;
+/**
+ * Resolve absolute path to a specific schema file.
+ */
+export declare function getSchemaPath(schemaFileName: string): string;
+/** Schema file mapping */
+export declare const SCHEMA_MAP: Record<string, string>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAKA,wCAAwC;AACxC,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,+BAA+B;AAC/B,eAAO,MAAM,cAAc,qCAAsC,CAAC;AAElE,+BAA+B;AAC/B,eAAO,MAAM,cAAc,4FAOjB,CAAC;AAEX,gCAAgC;AAChC,eAAO,MAAM,mBAAmB,sHAGtB,CAAC;AAEX,8BAA8B;AAC9B,eAAO,MAAM,aAAa,wBAAwB,CAAC;AAEnD,uBAAuB;AACvB,eAAO,MAAM,UAAU,WAAW,CAAC;AAEnC,oCAAoC;AACpC,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAShD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAmC,CAAC;AAE5D;;GAEG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,0BAA0B;AAC1B,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS7C,CAAC"}

package/dist/constants.js

@@ -0,0 +1,59 @@
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** Current AWP specification version */
+export const AWP_VERSION = "0.1.0";
+/** Required workspace files */
+export const REQUIRED_FILES = ["IDENTITY.md", "SOUL.md"];
+/** Optional workspace files */
+export const OPTIONAL_FILES = [
+    "AGENTS.md",
+    "USER.md",
+    "TOOLS.md",
+    "HEARTBEAT.md",
+    "BOOTSTRAP.md",
+    "MEMORY.md",
+];
+/** All known workspace files */
+export const ALL_WORKSPACE_FILES = [
+    ...REQUIRED_FILES,
+    ...OPTIONAL_FILES,
+];
+/** Workspace manifest path */
+export const MANIFEST_PATH = ".awp/workspace.json";
+/** Memory directory */
+export const MEMORY_DIR = "memory";
+/** File type to filename mapping */
+export const FILE_TYPE_MAP = {
+    identity: "IDENTITY.md",
+    soul: "SOUL.md",
+    operations: "AGENTS.md",
+    user: "USER.md",
+    tools: "TOOLS.md",
+    heartbeat: "HEARTBEAT.md",
+    bootstrap: "BOOTSTRAP.md",
+    "memory-longterm": "MEMORY.md",
+};
+/**
+ * Absolute path to the schemas directory bundled with @agent-workspace/core.
+ * Works in monorepo (dev) and when installed from npm.
+ */
+export const SCHEMAS_DIR = join(__dirname, "..", "schemas");
+/**
+ * Resolve absolute path to a specific schema file.
+ */
+export function getSchemaPath(schemaFileName) {
+    return join(SCHEMAS_DIR, schemaFileName);
+}
+/** Schema file mapping */
+export const SCHEMA_MAP = {
+    identity: "identity.schema.json",
+    soul: "soul.schema.json",
+    operations: "operations.schema.json",
+    user: "user.schema.json",
+    tools: "tools.schema.json",
+    heartbeat: "heartbeat.schema.json",
+    "memory-daily": "memory-daily.schema.json",
+    "memory-longterm": "memory-longterm.schema.json",
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,wCAAwC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,+BAA+B;AAC/B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,aAAa,EAAE,SAAS,CAAU,CAAC;AAElE,+BAA+B;AAC/B,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,WAAW;IACX,SAAS;IACT,UAAU;IACV,cAAc;IACd,cAAc;IACd,WAAW;CACH,CAAC;AAEX,gCAAgC;AAChC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,cAAc;IACjB,GAAG,cAAc;CACT,CAAC;AAEX,8BAA8B;AAC9B,MAAM,CAAC,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAEnD,uBAAuB;AACvB,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAEnC,oCAAoC;AACpC,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,QAAQ,EAAE,aAAa;IACvB,IAAI,EAAE,SAAS;IACf,UAAU,EAAE,WAAW;IACvB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,SAAS,EAAE,cAAc;IACzB,SAAS,EAAE,cAAc;IACzB,iBAAiB,EAAE,WAAW;CAC/B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,cAAsB;IAClD,OAAO,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AAC3C,CAAC;AAED,0BAA0B;AAC1B,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,QAAQ,EAAE,sBAAsB;IAChC,IAAI,EAAE,kBAAkB;IACxB,UAAU,EAAE,wBAAwB;IACpC,IAAI,EAAE,kBAAkB;IACxB,KAAK,EAAE,mBAAmB;IAC1B,SAAS,EAAE,uBAAuB;IAClC,cAAc,EAAE,0BAA0B;IAC1C,iBAAiB,EAAE,6BAA6B;CACjD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { WorkspaceManifest, BaseFrontmatter, IdentityFrontmatter, SoulFrontmatter, SoulValue, SoulBoundary, SoulGovernance, UserFrontmatter, OperationsFrontmatter, ToolsFrontmatter, HeartbeatFrontmatter, HeartbeatTask, MemoryDailyFrontmatter, MemoryEntry, MemoryLongtermFrontmatter, AnyFrontmatter, WorkspaceFile, } from "./types/workspace.js";
+export type { AgentCard, AgentSkill, DIDDocument, VerificationMethod, } from "./types/identity.js";
+export { AWP_VERSION, REQUIRED_FILES, OPTIONAL_FILES, ALL_WORKSPACE_FILES, MANIFEST_PATH, MEMORY_DIR, FILE_TYPE_MAP, SCHEMA_MAP, SCHEMAS_DIR, getSchemaPath, } from "./constants.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,YAAY,EACZ,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,WAAW,EACX,yBAAyB,EACzB,cAAc,EACd,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACX,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,WAAW,EACX,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { AWP_VERSION, REQUIRED_FILES, OPTIONAL_FILES, ALL_WORKSPACE_FILES, MANIFEST_PATH, MEMORY_DIR, FILE_TYPE_MAP, SCHEMA_MAP, SCHEMAS_DIR, getSchemaPath, } from "./constants.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2BA,OAAO,EACL,WAAW,EACX,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,gBAAgB,CAAC"}

package/dist/types/identity.d.ts

@@ -0,0 +1,38 @@
+/**
+ * A2A-compatible Agent Card generated from AWP identity
+ */
+export interface AgentCard {
+    name: string;
+    description?: string;
+    url?: string;
+    capabilities?: {
+        streaming?: boolean;
+        pushNotifications?: boolean;
+    };
+    skills?: AgentSkill[];
+    authentication?: {
+        schemes: string[];
+    };
+}
+export interface AgentSkill {
+    id: string;
+    name: string;
+    description?: string;
+}
+/**
+ * DID Document (simplified W3C DID Core)
+ */
+export interface DIDDocument {
+    "@context": string[];
+    id: string;
+    verificationMethod?: VerificationMethod[];
+    authentication?: string[];
+    assertionMethod?: string[];
+}
+export interface VerificationMethod {
+    id: string;
+    type: string;
+    controller: string;
+    publicKeyMultibase?: string;
+}
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/types/identity.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE;QACb,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE;QACf,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/types/identity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=identity.js.map

package/dist/types/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/types/identity.ts"],"names":[],"mappings":""}

package/dist/types/workspace.d.ts

@@ -0,0 +1,146 @@
+/**
+ * AWP Workspace manifest (.awp/workspace.json)
+ */
+export interface WorkspaceManifest {
+    awp: string;
+    id: string;
+    name: string;
+    created: string;
+    agent: {
+        did?: string;
+        identityFile: string;
+    };
+    capabilities?: string[];
+    protocols?: {
+        a2a?: boolean;
+        mcp?: boolean;
+    };
+}
+/**
+ * Common frontmatter fields shared by all workspace files
+ */
+export interface BaseFrontmatter {
+    awp: string;
+    type: string;
+    lastModified?: string;
+    modifiedBy?: string;
+}
+/**
+ * IDENTITY.md frontmatter
+ */
+export interface IdentityFrontmatter extends BaseFrontmatter {
+    type: "identity";
+    did?: string;
+    name: string;
+    creature?: string;
+    emoji?: string;
+    avatar?: string;
+    capabilities?: string[];
+    created: string;
+}
+/**
+ * SOUL.md frontmatter
+ */
+export interface SoulFrontmatter extends BaseFrontmatter {
+    type: "soul";
+    vibe?: string;
+    values?: SoulValue[];
+    boundaries?: SoulBoundary[];
+    governance?: SoulGovernance;
+}
+export interface SoulValue {
+    id: string;
+    priority?: number;
+    description: string;
+}
+export interface SoulBoundary {
+    id: string;
+    rule: string;
+    severity: "hard" | "soft";
+}
+export interface SoulGovernance {
+    humanApprovalRequired?: string[];
+    autonomouslyAllowed?: string[];
+}
+/**
+ * USER.md frontmatter
+ */
+export interface UserFrontmatter extends BaseFrontmatter {
+    type: "user";
+    name?: string;
+    callSign?: string;
+    pronouns?: string;
+    timezone?: string;
+}
+/**
+ * AGENTS.md frontmatter
+ */
+export interface OperationsFrontmatter extends BaseFrontmatter {
+    type: "operations";
+    sessionStartup?: string[];
+    heartbeat?: {
+        enabled: boolean;
+        intervalMinutes?: number;
+        checks?: string[];
+    };
+    memoryPolicy?: {
+        dailyLogs?: boolean;
+        longTermCompaction?: boolean;
+        compactionInterval?: "daily" | "weekly" | "monthly";
+    };
+}
+/**
+ * Daily memory log frontmatter
+ */
+export interface MemoryDailyFrontmatter extends BaseFrontmatter {
+    type: "memory-daily";
+    date: string;
+    entries?: MemoryEntry[];
+}
+export interface MemoryEntry {
+    time?: string;
+    content: string;
+    tags?: string[];
+    pinned?: boolean;
+}
+/**
+ * MEMORY.md frontmatter
+ */
+export interface MemoryLongtermFrontmatter extends BaseFrontmatter {
+    type: "memory-longterm";
+    lastCompacted?: string;
+    entryCount?: number;
+    pinnedCount?: number;
+}
+/**
+ * TOOLS.md frontmatter
+ */
+export interface ToolsFrontmatter extends BaseFrontmatter {
+    type: "tools";
+}
+/**
+ * HEARTBEAT.md frontmatter
+ */
+export interface HeartbeatFrontmatter extends BaseFrontmatter {
+    type: "heartbeat";
+    tasks?: HeartbeatTask[];
+}
+export interface HeartbeatTask {
+    id: string;
+    description: string;
+    intervalMinutes?: number;
+    enabled?: boolean;
+}
+/**
+ * Union of all frontmatter types
+ */
+export type AnyFrontmatter = IdentityFrontmatter | SoulFrontmatter | UserFrontmatter | OperationsFrontmatter | ToolsFrontmatter | HeartbeatFrontmatter | MemoryDailyFrontmatter | MemoryLongtermFrontmatter;
+/**
+ * A parsed workspace file — frontmatter + markdown body
+ */
+export interface WorkspaceFile<T extends BaseFrontmatter = BaseFrontmatter> {
+    frontmatter: T;
+    body: string;
+    filePath: string;
+}
+//# sourceMappingURL=workspace.d.ts.map

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

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

package/dist/types/workspace.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workspace.js.map

package/dist/types/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/types/workspace.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@agent-workspace/core",
+  "version": "0.1.0",
+  "description": "Core types, constants, and schemas for the Agent Workspace Protocol",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./schemas/*": "./schemas/*"
+  },
+  "files": [
+    "dist",
+    "schemas"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/marcoloco23/awp.git",
+    "directory": "packages/awp-core"
+  },
+  "homepage": "https://github.com/marcoloco23/awp#readme",
+  "keywords": [
+    "awp",
+    "agent",
+    "workspace",
+    "protocol",
+    "ai",
+    "llm",
+    "mcp",
+    "a2a",
+    "agent-economy",
+    "coordination"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}

package/schemas/heartbeat.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/heartbeat.schema.json",
+  "title": "AWP Heartbeat Frontmatter",
+  "description": "Frontmatter schema for HEARTBEAT.md — periodic tasks the agent should execute",
+  "type": "object",
+  "required": ["awp", "type"],
+  "properties": {
+    "awp": {
+      "type": "string",
+      "description": "AWP specification version",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "type": {
+      "type": "string",
+      "const": "heartbeat"
+    },
+    "tasks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "description"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Task identifier"
+          },
+          "description": {
+            "type": "string",
+            "description": "What the agent should check or do"
+          },
+          "intervalMinutes": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Override interval for this specific task"
+          },
+          "enabled": {
+            "type": "boolean",
+            "default": true,
+            "description": "Whether this task is active"
+          }
+        }
+      },
+      "description": "Periodic tasks to execute"
+    },
+    "lastModified": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "modifiedBy": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/identity.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/identity.schema.json",
+  "title": "AWP Identity Frontmatter",
+  "description": "Frontmatter schema for IDENTITY.md files",
+  "type": "object",
+  "required": ["awp", "type", "name", "created"],
+  "properties": {
+    "awp": {
+      "type": "string",
+      "description": "AWP specification version",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "type": {
+      "type": "string",
+      "const": "identity"
+    },
+    "did": {
+      "type": "string",
+      "description": "W3C Decentralized Identifier",
+      "pattern": "^did:"
+    },
+    "name": {
+      "type": "string",
+      "description": "The agent's chosen name",
+      "minLength": 1
+    },
+    "creature": {
+      "type": "string",
+      "description": "What kind of entity (factual descriptor)"
+    },
+    "emoji": {
+      "type": "string",
+      "description": "Signature emoji"
+    },
+    "avatar": {
+      "type": "string",
+      "description": "Path to avatar image (workspace-relative or URL)"
+    },
+    "capabilities": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "What this agent can do"
+    },
+    "created": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 creation timestamp"
+    },
+    "lastModified": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 last modification timestamp"
+    },
+    "modifiedBy": {
+      "type": "string",
+      "description": "DID of the modifier"
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/memory-daily.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/memory-daily.schema.json",
+  "title": "AWP Daily Memory Frontmatter",
+  "description": "Frontmatter schema for daily memory log files",
+  "type": "object",
+  "required": ["awp", "type", "date"],
+  "properties": {
+    "awp": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "type": {
+      "type": "string",
+      "const": "memory-daily"
+    },
+    "date": {
+      "type": "string",
+      "format": "date",
+      "description": "ISO 8601 date"
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["content"],
+        "properties": {
+          "time": {
+            "type": "string",
+            "pattern": "^\\d{2}:\\d{2}$",
+            "description": "Time of entry (HH:MM)"
+          },
+          "content": {
+            "type": "string",
+            "description": "What happened"
+          },
+          "tags": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Categorization tags"
+          },
+          "pinned": {
+            "type": "boolean",
+            "default": false,
+            "description": "Pinned entries survive compaction and must never be deleted"
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/memory-longterm.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/memory-longterm.schema.json",
+  "title": "AWP Long-term Memory Frontmatter",
+  "description": "Frontmatter schema for MEMORY.md",
+  "type": "object",
+  "required": ["awp", "type"],
+  "properties": {
+    "awp": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "type": {
+      "type": "string",
+      "const": "memory-longterm"
+    },
+    "lastCompacted": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When memory was last compacted"
+    },
+    "entryCount": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of curated entries"
+    },
+    "pinnedCount": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of pinned entries (must be preserved during compaction)"
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/operations.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/operations.schema.json",
+  "title": "AWP Operations Frontmatter",
+  "description": "Frontmatter schema for AGENTS.md",
+  "type": "object",
+  "required": ["awp", "type"],
+  "properties": {
+    "awp": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "type": {
+      "type": "string",
+      "const": "operations"
+    },
+    "sessionStartup": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Steps to perform at session start"
+    },
+    "heartbeat": {
+      "type": "object",
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "intervalMinutes": { "type": "integer", "minimum": 1 },
+        "checks": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "memoryPolicy": {
+      "type": "object",
+      "properties": {
+        "dailyLogs": { "type": "boolean" },
+        "longTermCompaction": { "type": "boolean" },
+        "compactionInterval": {
+          "type": "string",
+          "enum": ["daily", "weekly", "monthly"]
+        }
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/soul.schema.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/soul.schema.json",
+  "title": "AWP Soul Frontmatter",
+  "description": "Frontmatter schema for SOUL.md files",
+  "type": "object",
+  "required": ["awp", "type"],
+  "properties": {
+    "awp": {
+      "type": "string",
+      "description": "AWP specification version",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "type": {
+      "type": "string",
+      "const": "soul"
+    },
+    "vibe": {
+      "type": "string",
+      "description": "Personality description — how the agent comes across"
+    },
+    "values": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "description"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Value identifier"
+          },
+          "priority": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Priority rank (1 = highest)"
+          },
+          "description": {
+            "type": "string",
+            "description": "Human-readable description"
+          }
+        }
+      },
+      "description": "Ordered list of core values"
+    },
+    "boundaries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "rule", "severity"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Boundary identifier"
+          },
+          "rule": {
+            "type": "string",
+            "description": "The boundary rule"
+          },
+          "severity": {
+            "type": "string",
+            "enum": ["hard", "soft"],
+            "description": "hard = never violate, soft = use judgment"
+          }
+        }
+      },
+      "description": "Behavioral boundaries"
+    },
+    "governance": {
+      "type": "object",
+      "properties": {
+        "humanApprovalRequired": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Actions requiring human approval"
+        },
+        "autonomouslyAllowed": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Actions the agent may take freely"
+        }
+      },
+      "description": "Governance rules"
+    },
+    "lastModified": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "modifiedBy": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/tools.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/tools.schema.json",
+  "title": "AWP Tools Frontmatter",
+  "description": "Frontmatter schema for TOOLS.md files — environment-specific configuration",
+  "type": "object",
+  "required": ["awp", "type"],
+  "properties": {
+    "awp": {
+      "type": "string",
+      "description": "AWP specification version",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "type": {
+      "type": "string",
+      "const": "tools"
+    },
+    "lastModified": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "modifiedBy": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/user.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/user.schema.json",
+  "title": "AWP User Profile Frontmatter",
+  "description": "Frontmatter schema for USER.md",
+  "type": "object",
+  "required": ["awp", "type"],
+  "properties": {
+    "awp": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "type": {
+      "type": "string",
+      "const": "user"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human's name"
+    },
+    "callSign": {
+      "type": "string",
+      "description": "What to call them"
+    },
+    "pronouns": {
+      "type": "string",
+      "description": "Preferred pronouns"
+    },
+    "timezone": {
+      "type": "string",
+      "description": "IANA timezone"
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/workspace.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/workspace.schema.json",
+  "title": "AWP Workspace Manifest",
+  "description": "Manifest file for an Agent Workspace Protocol workspace",
+  "type": "object",
+  "required": ["awp", "id", "name", "created", "agent"],
+  "properties": {
+    "awp": {
+      "type": "string",
+      "description": "AWP specification version",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "id": {
+      "type": "string",
+      "description": "Unique workspace identifier (URN format)",
+      "pattern": "^urn:awp:workspace:"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable workspace name",
+      "minLength": 1
+    },
+    "created": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 creation timestamp"
+    },
+    "agent": {
+      "type": "object",
+      "required": ["identityFile"],
+      "properties": {
+        "did": {
+          "type": "string",
+          "description": "W3C DID for this agent",
+          "pattern": "^did:"
+        },
+        "identityFile": {
+          "type": "string",
+          "description": "Path to identity file relative to workspace root",
+          "default": "IDENTITY.md"
+        }
+      }
+    },
+    "capabilities": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Agent capability tags"
+    },
+    "protocols": {
+      "type": "object",
+      "properties": {
+        "a2a": { "type": "boolean" },
+        "mcp": { "type": "boolean" }
+      },
+      "description": "Supported protocol flags"
+    }
+  },
+  "additionalProperties": false
+}