@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 +42 -5
- package/dist/index.d.ts +17 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1306 -38
- package/dist/index.js.map +1 -1
- package/package.json +7 -2
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
|
-
| `
|
|
37
|
-
| `
|
|
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
|
-
|
|
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,
|
|
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
|
-
|
|
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
|
package/dist/index.d.ts.map
CHANGED
|
@@ -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"}
|