@agent-workspace/mcp-server 0.2.1 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -28,28 +28,65 @@ It will auto-discover the AWP workspace from the current directory (or use `AWP_
28
28
 
29
29
  ## Tools
30
30
 
31
+ ### Core Identity & Context
32
+
31
33
  | Tool | Description |
32
34
  |------|-------------|
33
35
  | `awp_read_identity` | Read agent identity (name, capabilities, DID) |
34
36
  | `awp_read_soul` | Read behavioral constraints (values, boundaries, governance) |
35
37
  | `awp_read_user` | Read human profile |
36
- | `awp_read_memory` | Read memory (daily or long-term) |
37
- | `awp_write_memory` | Log structured memory entries |
38
+ | `awp_read_agents` | Read operations config (AGENTS.md) |
39
+ | `awp_read_tools` | Read tools config (TOOLS.md) |
40
+ | `awp_read_heartbeat` | Read heartbeat config (HEARTBEAT.md) |
41
+
42
+ ### Memory Operations
43
+
44
+ | Tool | Description |
45
+ |------|-------------|
46
+ | `awp_read_memory` | Read memory (daily, longterm, or recent logs) |
47
+ | `awp_write_memory` | Log structured memory entries to daily log |
48
+
49
+ ### Knowledge Artifacts (SMP)
50
+
51
+ | Tool | Description |
52
+ |------|-------------|
38
53
  | `awp_artifact_read` | Read a knowledge artifact by slug |
39
- | `awp_artifact_write` | Create or update a knowledge artifact |
54
+ | `awp_artifact_write` | Create or update a knowledge artifact with versioning |
40
55
  | `awp_artifact_list` | List all artifacts (optional tag filter) |
41
56
  | `awp_artifact_search` | Search artifacts by content, title, or tags |
42
- | `awp_workspace_status` | Workspace summary (files present, memory count, artifact count) |
57
+
58
+ ### Reputation (RDP)
59
+
60
+ | Tool | Description |
61
+ |------|-------------|
62
+ | `awp_reputation_query` | Query reputation profiles with time-based decay applied |
63
+ | `awp_reputation_signal` | Log reputation signals (uses EWMA with decay) |
64
+
65
+ ### Delegation Contracts (RDP)
66
+
67
+ | Tool | Description |
68
+ |------|-------------|
69
+ | `awp_contract_create` | Create delegation contracts between agents |
70
+ | `awp_contract_evaluate` | Evaluate contracts and generate reputation signals |
71
+ | `awp_contract_list` | List all contracts with optional status filter |
72
+
73
+ ### Workspace Management
74
+
75
+ | Tool | Description |
76
+ |------|-------------|
77
+ | `awp_workspace_status` | Workspace health check (files present, stats) |
43
78
 
44
79
  ## How It Works
45
80
 
46
- The MCP server reads and writes AWP workspace files directly — no database, no daemon. Your agent's identity, memory, and knowledge artifacts are just Markdown files with YAML frontmatter, stored in a directory and compatible with Git.
81
+ The MCP server reads and writes AWP workspace files directly — no database, no daemon. Your agent's identity, memory, knowledge artifacts, and reputation profiles are just Markdown files with YAML frontmatter, stored in a directory and compatible with Git.
47
82
 
48
83
  When an AI agent connects via MCP, it can:
49
84
  - **Read** its identity, soul, and user context at the start of each session
50
85
  - **Write** memory entries as it works
51
86
  - **Create and update** knowledge artifacts with full provenance tracking
52
87
  - **Search** its accumulated knowledge
88
+ - **Query and update** reputation profiles for itself and other agents
89
+ - **Create and evaluate** delegation contracts for multi-agent coordination
53
90
 
54
91
  ## Part of AWP
55
92
 
package/dist/index.d.ts CHANGED
@@ -1,3 +1,19 @@
1
1
  #!/usr/bin/env node
2
- export {};
2
+ /**
3
+ * Validate that a path is within the workspace root (prevents directory traversal).
4
+ * Returns the normalized absolute path if valid, or throws an error.
5
+ * @internal Available for future use in tool handlers
6
+ */
7
+ export declare function _validatePath(root: string, targetPath: string): string;
8
+ /**
9
+ * Validate and sanitize a slug.
10
+ * Slugs must be lowercase alphanumeric with hyphens, not starting with hyphen.
11
+ * @internal Available for future use in tool handlers
12
+ */
13
+ export declare function _validateSlug(slug: string): string;
14
+ /**
15
+ * Read a file with size limit check.
16
+ * @internal Available for future use in tool handlers
17
+ */
18
+ export declare function _safeReadFile(path: string): Promise<string>;
3
19
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAkCA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAUtE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYlD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMjE"}