@atrib/annotate 0.2.37 → 0.2.39
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/LICENSE +1 -1
- package/README.md +27 -2
- package/package.json +4 -4
package/LICENSE
CHANGED
|
@@ -201,7 +201,7 @@
|
|
|
201
201
|
See the License for the specific language governing permissions and
|
|
202
202
|
limitations under the License.
|
|
203
203
|
|
|
204
|
-
Copyright 2025-2026
|
|
204
|
+
Copyright 2025-2026 atrib contributors
|
|
205
205
|
|
|
206
206
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
207
207
|
you may not use this file except in compliance with the License.
|
package/README.md
CHANGED
|
@@ -1,9 +1,17 @@
|
|
|
1
1
|
# @atrib/annotate
|
|
2
2
|
|
|
3
|
-
MCP server exposing the `atrib-annotate` tool. Marks a past signed record with importance, a one-line summary, and topics, so future recall can surface what mattered without re-scanning every record flat.
|
|
3
|
+
MCP server exposing the `atrib-annotate` tool for atrib's verifiable action layer. Marks a past signed record with importance, a one-line summary, and topics, so future recall can surface what mattered without re-scanning every record flat.
|
|
4
4
|
|
|
5
5
|
Closes the producer-side recall-fidelity gap: an agent reading back its own past loses enormous nuance compared to the agent that signed it. An annotation lets the agent at signing time say "future-self: this one is critical, and here's why in one line", and the graph carries that judgment forward.
|
|
6
6
|
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
pnpm add @atrib/annotate
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Verify a local build with `pnpm --filter @atrib/annotate test`.
|
|
14
|
+
|
|
7
15
|
## Tool
|
|
8
16
|
|
|
9
17
|
```
|
|
@@ -24,6 +32,8 @@ mcp__atrib-annotate__atrib-annotate({
|
|
|
24
32
|
}
|
|
25
33
|
```
|
|
26
34
|
|
|
35
|
+
The `annotates` target is the `record_hash` of a prior record, for example one returned by a previous `atrib-emit` call or an `@atrib/recall` result.
|
|
36
|
+
|
|
27
37
|
## Writes
|
|
28
38
|
|
|
29
39
|
Signs an `annotation` record per spec [§1.2.4](https://github.com/creatornader/atrib/blob/main/atrib-spec.md#124-event_type-values) (event_type `0x05`, promoted via [D058](https://github.com/creatornader/atrib/blob/main/DECISIONS.md#d058-promote-annotation-to-atrib-normative-event_type-byte-0x05)) and persists it through the same pipeline `@atrib/emit` uses: same key resolution, same chain composition, same JSONL mirror at `ATRIB_MIRROR_FILE`. A verifier cannot distinguish annotation records signed via this tool from annotation records signed via `@atrib/emit`'s polymorphic surface; the wire format is identical.
|
|
@@ -43,6 +53,17 @@ The graph layer derives an ANNOTATES edge from the new record to the `annotates`
|
|
|
43
53
|
|
|
44
54
|
Add to your MCP host config (e.g. `~/.claude.json` `mcpServers`):
|
|
45
55
|
|
|
56
|
+
```json
|
|
57
|
+
{
|
|
58
|
+
"atrib-annotate": {
|
|
59
|
+
"command": "npx",
|
|
60
|
+
"args": ["-y", "@atrib/annotate"]
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
For a monorepo checkout or local development, point at the built binary directly:
|
|
66
|
+
|
|
46
67
|
```json
|
|
47
68
|
{
|
|
48
69
|
"atrib-annotate": {
|
|
@@ -70,8 +91,12 @@ Or run as a one-off subprocess via `pnpm --filter @atrib/annotate start`.
|
|
|
70
91
|
|
|
71
92
|
## Status
|
|
72
93
|
|
|
73
|
-
|
|
94
|
+
Published and maintained. Cognitive primitive #2 per [D079](https://github.com/creatornader/atrib/blob/main/DECISIONS.md#d079-the-six-core-cognitive-primitives--atribs-agent-facing-surface). Builds clean against `@atrib/mcp` and `@atrib/emit`'s public exports introduced in `@atrib/emit@0.8.0`. The companion specialized writer `@atrib/revise` covers the contradiction-handling primitive (revision event_type).
|
|
74
95
|
|
|
75
96
|
## License
|
|
76
97
|
|
|
77
98
|
Apache-2.0.
|
|
99
|
+
|
|
100
|
+
## Part of atrib
|
|
101
|
+
|
|
102
|
+
atrib is an open protocol for verifiable agent actions. Every action becomes a signed, chain-linked record that anyone can verify against a public Merkle log, with no operator to trust. This package is one entrypoint. See the [full package family](https://github.com/creatornader/atrib#packages) and the [protocol spec](https://github.com/creatornader/atrib/blob/main/atrib-spec.md).
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@atrib/annotate",
|
|
3
|
-
"version": "0.2.
|
|
4
|
-
"description": "MCP server for atrib. Lets agents mark a past record's importance and meaning
|
|
3
|
+
"version": "0.2.39",
|
|
4
|
+
"description": "MCP server for atrib's verifiable action layer. Lets agents mark a past record's importance and meaning for later recall.",
|
|
5
5
|
"author": "atrib <hello@atrib.dev>",
|
|
6
6
|
"keywords": [
|
|
7
7
|
"atrib",
|
|
@@ -25,8 +25,8 @@
|
|
|
25
25
|
"dependencies": {
|
|
26
26
|
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
27
27
|
"zod": "^3.25.76",
|
|
28
|
-
"@atrib/emit": "0.
|
|
29
|
-
"@atrib/mcp": "0.
|
|
28
|
+
"@atrib/emit": "0.17.1",
|
|
29
|
+
"@atrib/mcp": "0.19.1"
|
|
30
30
|
},
|
|
31
31
|
"devDependencies": {
|
|
32
32
|
"@types/node": "^25.9.3",
|