knowmind 0.3.7 → 0.3.8

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/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Knowmind CLI — Änderungen
2
2
 
3
+ ## 0.3.8 (2026-10-08)
4
+
5
+ - Die mitgelieferte Werkzeugliste trägt den Stand des Servers vom 8. Oktober:
6
+ die Werkzeugnamen nach dem Muster Verb und Gegenstand
7
+ (`knowmind_recall_memories`, `knowmind_get_schema` …) und die Kennzeichnung,
8
+ welche Werkzeuge nur lesen und welche Daten ersetzen oder entfernen.
9
+ - Die README nennt die neuen Werkzeugnamen.
10
+
3
11
  ## 0.3.7 (2026-09-07)
4
12
 
5
13
  - Veröffentlichung über GitHub Actions: Das Paket wird ohne dauerhaften Token
package/README.de.md CHANGED
@@ -73,7 +73,7 @@ knowmind init --dry-run # zeigt nur, was geschähe (schreibt nich
73
73
  **Was eingerichtet wird:**
74
74
 
75
75
  - **Claude Code** — projektlokale Hooks in `.claude/`:
76
- - *UserPromptSubmit* → ruft vor jeder inhaltlichen Frage `knowmind_recall` auf und reicht die
76
+ - *UserPromptSubmit* → ruft vor jeder inhaltlichen Frage `knowmind_recall_memories` auf und reicht die
77
77
  Top-Treffer als Kontext nach (Memory-First, automatisch).
78
78
  - *Stop* → erinnert die KI daran, mit `knowmind_store_memory` zu sichern, wenn die Runde
79
79
  Sicherungswürdiges enthielt (Deploy/Commit, neue Regel, Entscheidung) und noch nichts
@@ -154,22 +154,46 @@ Der MCP-Modus ist seit 0.1.18 ein reiner Proxy auf die Plattform: Tool-Namen,
154
154
  Schemas und Safety-Annotations kommen direkt vom Server und sind damit immer
155
155
  identisch mit dem Remote-Connector (`https://knowmind.de/api/mcp/v1`).
156
156
 
157
- - `knowmind_recall` — Hybride Suche im Wissensspeicher des Mandanten
157
+ - `knowmind_recall_memories` — Hybride Suche im Wissensspeicher des Mandanten
158
158
  - `knowmind_recall_at_time` — Recall mit Zeitfilter (bi-temporal)
159
159
  - `knowmind_store_memory` — Neue Erinnerung anlegen (Titel + Inhalt)
160
160
  - `knowmind_upload_document` — Längeren Text als Dokument ingestieren (Upsert-per-Titel: gleicher Titel ersetzt die alte Version)
161
161
  - `knowmind_update_fact` — Fakt bi-temporal aktualisieren (Historie bleibt)
162
- - `knowmind_link` — Typisierte Beziehung anlegen (Inverse wird automatisch gesetzt)
163
- - `knowmind_unlink` — Beziehung wieder entfernen (samt Inverse)
162
+ - `knowmind_link_entities` — Typisierte Beziehung anlegen (Inverse wird automatisch gesetzt)
163
+ - `knowmind_unlink_entities` — Beziehung wieder entfernen (samt Inverse)
164
164
  - `knowmind_list_relations` — Beziehungen einer Erinnerung auflisten
165
165
  - `knowmind_list_recent` — Zuletzt angelegte Dokumente/Memories des Mandanten auflisten, sortiert nach Anlagedatum absteigend
166
- - `knowmind_stats` — Statistik über gespeicherte Erinnerungen und Beziehungen
167
- - `knowmind_health` — Verfügbarkeits-Status der Plattform
166
+ - `knowmind_get_stats` — Statistik über gespeicherte Erinnerungen und Beziehungen
167
+ - `knowmind_get_health` — Verfügbarkeits-Status der Plattform
168
+ - `knowmind_upsert_entity` — Knoten für eine Sache anlegen (Person, Firma, Anwendung, Rechner, Technik) oder den vorhandenen zurückgeben
169
+ - `knowmind_get_schema` — Welche Entitätsklassen und Beziehungstypen dieser Arbeitsbereich kennt
168
170
 
169
171
  Inverse-Beziehungen (z. B. `IS_EMPLOYEE_OF` zu `HAS_EMPLOYEE`) werden
170
172
  serverseitig automatisch mit angelegt. Hinweis: `knowmind upload` als
171
173
  CLI-Befehl läuft über die REST-Schnittstelle (`/api/documents`), nicht über MCP.
172
174
 
175
+
176
+ ### Die bisherigen Werkzeugnamen
177
+
178
+ Sieben Werkzeuge haben am 12. September 2026 neue Namen bekommen, damit jeder
179
+ Name dem Muster `knowmind_<verb>_<objekt>` folgt und sagt, ob er liest oder
180
+ schreibt. Die bisherigen Namen antworten bis zum 31. März 2027 unverändert
181
+ weiter und stehen weiter in der Discovery, als veraltet gekennzeichnet:
182
+
183
+ | bisher | ab jetzt |
184
+ | --- | --- |
185
+ | `knowmind_recall` | `knowmind_recall_memories` |
186
+ | `knowmind_health` | `knowmind_get_health` |
187
+ | `knowmind_stats` | `knowmind_get_stats` |
188
+ | `knowmind_schema` | `knowmind_get_schema` |
189
+ | `knowmind_entity` | `knowmind_upsert_entity` |
190
+ | `knowmind_link` | `knowmind_link_entities` |
191
+ | `knowmind_unlink` | `knowmind_unlink_entities` |
192
+
193
+ Aus `knowmind_entity` wurde `upsert` und nicht `get`: Das Werkzeug legt den
194
+ Knoten an oder gibt den vorhandenen zurück. Sonst ändert sich nichts —
195
+ dieselben Parameter, dasselbe Verhalten.
196
+
173
197
  ## Daten in Deutschland
174
198
 
175
199
  knowmind wird in Deutschland betrieben: Ihre Inhalte (Memories, Account- und Metadaten) werden
package/README.md CHANGED
@@ -93,7 +93,7 @@ never sees another tenant's data.
93
93
 
94
94
  ### Reading
95
95
 
96
- **`knowmind_recall`** — Search your memory and get the passages that answer a
96
+ **`knowmind_recall_memories`** — Search your memory and get the passages that answer a
97
97
  question, ranked. Combines keyword search, vector similarity and the knowledge
98
98
  graph, then reranks with a cross-encoder.
99
99
  `query` (string, required) · `k` (integer, default 5, max 20) · `hops` (integer,
@@ -110,7 +110,7 @@ then are returned even if they are no longer true.
110
110
  practice) · `k` (integer, default 5)
111
111
  *Usage:* "What was our pricing in March?" — answers from the state of that day,
112
112
  not today's.
113
- *Difference from `knowmind_recall`:* use `recall` for what is true now, and
113
+ *Difference from `knowmind_recall_memories`:* use `recall` for what is true now, and
114
114
  `recall_at_time` for what was true then. Asking `recall` about the past returns
115
115
  today's facts.
116
116
 
@@ -124,15 +124,15 @@ directions.
124
124
  *Usage:* "What does this contract connect to?" before changing or superseding it.
125
125
  *Errors:* unknown id returns an error, not an empty list.
126
126
 
127
- **`knowmind_schema`** — The entity classes and relation types this workspace
127
+ **`knowmind_get_schema`** — The entity classes and relation types this workspace
128
128
  accepts. No parameters.
129
- *Usage:* call it before `knowmind_entity` or `knowmind_link` to use a type the
129
+ *Usage:* call it before `knowmind_upsert_entity` or `knowmind_link_entities` to use a type the
130
130
  server will accept, rather than inventing one.
131
131
 
132
- **`knowmind_stats`** — Size of the corpus: documents, chunks, entities, edges.
132
+ **`knowmind_get_stats`** — Size of the corpus: documents, chunks, entities, edges.
133
133
  No parameters.
134
134
 
135
- **`knowmind_health`** — Whether the service and its stores are reachable. No
135
+ **`knowmind_get_health`** — Whether the service and its stores are reachable. No
136
136
  parameters.
137
137
  *Usage:* a status line, or a check before a long ingest.
138
138
 
@@ -148,7 +148,7 @@ unit; it is not split.
148
148
  an access key. Store a pointer instead, not the secret.
149
149
 
150
150
  **`knowmind_upload_document`** — Store a longer text as a document. It is split
151
- into passages, embedded, and becomes searchable through `knowmind_recall`.
151
+ into passages, embedded, and becomes searchable through `knowmind_recall_memories`.
152
152
  `content` (string, required) · `title` (string) · `source` (string) ·
153
153
  `relations` (array)
154
154
  *Usage:* meeting minutes, a specification, a handbook chapter.
@@ -164,33 +164,55 @@ keeps its validity window and stays auditable; nothing is deleted.
164
164
  supersede, so "what did we believe in July" stays answerable.
165
165
  *Errors:* unknown `target_id` is rejected.
166
166
 
167
- **`knowmind_entity`** — Create or update a typed entity (a person, a company, a
167
+ **`knowmind_upsert_entity`** — Create or update a typed entity (a person, a company, a
168
168
  product) with aliases.
169
169
  `name` (string, required) · `entity_class` (string, required — see
170
- `knowmind_schema`) · `description` (string) · `aliases` (array of strings)
170
+ `knowmind_get_schema`) · `description` (string) · `aliases` (array of strings)
171
171
  *Usage:* give "ACME Ltd." its aliases so a question about "ACME" finds it.
172
172
  *Errors:* a class outside the schema is rejected.
173
173
 
174
- **`knowmind_link`** — Create a typed edge between two entries, with a confidence
174
+ **`knowmind_link_entities`** — Create a typed edge between two entries, with a confidence
175
175
  value.
176
176
  `from_id` (string, required) · `to_id` (string, required) · `rel_type` (string,
177
- required — see `knowmind_schema`) · `confidence` (number 0–1)
177
+ required — see `knowmind_get_schema`) · `confidence` (number 0–1)
178
178
  *Usage:* connect a contract to the client it belongs to. The inverse edge is
179
179
  created for you.
180
180
 
181
- **`knowmind_unlink`** — Remove a typed edge.
181
+ **`knowmind_unlink_entities`** — Remove a typed edge.
182
182
  `from_id`, `to_id`, `rel_type` (all required)
183
183
  *Usage:* an edge created in error. The entries themselves stay.
184
184
 
185
185
  ### On deleting
186
186
 
187
187
  There is no delete tool, and that is deliberate. Facts are superseded
188
- (`knowmind_update_fact`), edges are removed (`knowmind_unlink`), and the history
188
+ (`knowmind_update_fact`), edges are removed (`knowmind_unlink_entities`), and the history
189
189
  stays auditable. Deleting an entire workspace including its data is a
190
190
  self-service action in the web interface at
191
191
  [knowmind.de](https://knowmind.de) — it is not something an agent should be able
192
192
  to do by calling a tool.
193
193
 
194
+
195
+ ### Older tool names
196
+
197
+ Seven tools were renamed on 12 September 2026 so that every name follows
198
+ `knowmind_<verb>_<object>` and says whether it reads or writes. The previous
199
+ names keep answering unchanged until 31 March 2027 and still appear in
200
+ discovery, marked as deprecated:
201
+
202
+ | until now | from now on |
203
+ | --- | --- |
204
+ | `knowmind_recall` | `knowmind_recall_memories` |
205
+ | `knowmind_health` | `knowmind_get_health` |
206
+ | `knowmind_stats` | `knowmind_get_stats` |
207
+ | `knowmind_schema` | `knowmind_get_schema` |
208
+ | `knowmind_entity` | `knowmind_upsert_entity` |
209
+ | `knowmind_link` | `knowmind_link_entities` |
210
+ | `knowmind_unlink` | `knowmind_unlink_entities` |
211
+
212
+ `knowmind_entity` became `upsert`, not `get`: it creates the node or returns
213
+ the existing one. Nothing else about the tools changed — same parameters,
214
+ same behaviour.
215
+
194
216
  ### Discovery
195
217
 
196
218
  `GET https://knowmind.de/api/mcp/v1` returns name, version, protocol version and
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "knowmind",
3
- "version": "0.3.7",
3
+ "version": "0.3.8",
4
4
  "mcpName": "io.github.Schubeler-Consulting/knowmind",
5
5
  "description": "Knowmind — das Agentengehirn aus Deutschland: CLI + MCP-Server (Langzeitgedächtnis & Wissensgraph für Ihre KI, Server in Deutschland).",
6
6
  "type": "module",
@@ -0,0 +1,92 @@
1
+ #!/usr/bin/env node
2
+ // Steht diese Fassung schon im MCP-Verzeichnis?
3
+ //
4
+ // WARUM ES DIESES SKRIPT GIBT
5
+ // Der Ablauf „Publish to MCP Registry" läuft an zwei Auslösern: von Hand
6
+ // (`workflow_dispatch`) und beim Setzen eines Versionsmerkmals (`push: tags`).
7
+ // Am 07.09.2026 lief beides zehn Minuten auseinander für dieselbe Fassung
8
+ // 0.3.7. Der erste Lauf veröffentlichte sie, der zweite bekam vom Verzeichnis
9
+ //
10
+ // 400 Bad Request: invalid version: cannot publish duplicate version
11
+ //
12
+ // und färbte den Ablauf rot. Elf Tage lang stand dort ein rotes Kreuz für
13
+ // einen Vorgang, der gelungen war — und ein Ablauf, der dauerhaft rot steht,
14
+ // verbirgt den nächsten echten Fehler.
15
+ //
16
+ // Die Ablehnung des Verzeichnisses ist richtig: Eine veröffentlichte Fassung
17
+ // darf sich nicht ändern. Falsch war, dass unser Ablauf den zweiten Versuch
18
+ // überhaupt unternimmt.
19
+ //
20
+ // WAS ES TUT
21
+ // Es liest die Fassung aus `server.json`, fragt das Verzeichnis und sagt,
22
+ // ob sie dort schon steht.
23
+ //
24
+ // node scripts/registry-fassung-vorhanden.mjs
25
+ // Rückgabe 0 -> Fassung steht schon im Verzeichnis, Veröffentlichung übergehen
26
+ // Rückgabe 1 -> Fassung fehlt, veröffentlichen
27
+ // Rückgabe 2 -> Abbruch (Datei unlesbar, Verzeichnis antwortet nicht)
28
+ //
29
+ // **Rückgabe 2 heißt veröffentlichen, nicht überspringen.** Wer bei einer
30
+ // unbeantworteten Abfrage übergeht, verpasst eine Veröffentlichung und merkt
31
+ // es nie; wer veröffentlicht, riskiert höchstens genau den Doppelversuch, den
32
+ // der Ablauf danach ohnehin abfängt. Der Ablauf behandelt 2 deshalb wie 1.
33
+ //
34
+ // node scripts/registry-fassung-vorhanden.mjs --fassung 9.9.9
35
+ // prüft eine andere Fassung als die in server.json (für den Prüfstand)
36
+ import { readFileSync } from "node:fs";
37
+
38
+ const VERZEICHNIS = "https://registry.modelcontextprotocol.io/v0/servers";
39
+ const NAME = "io.github.Schubeler-Consulting/knowmind";
40
+
41
+ const argv = process.argv.slice(2);
42
+ const i = argv.indexOf("--fassung");
43
+ let fassung = i >= 0 ? argv[i + 1] : null;
44
+
45
+ if (!fassung) {
46
+ try {
47
+ fassung = JSON.parse(readFileSync("server.json", "utf8")).version;
48
+ } catch (e) {
49
+ console.error(`ABBRUCH: server.json nicht lesbar (${e.message})`);
50
+ process.exit(2);
51
+ }
52
+ }
53
+
54
+ if (!fassung) {
55
+ console.error("ABBRUCH: server.json nennt keine Fassung.");
56
+ process.exit(2);
57
+ }
58
+
59
+ let antwort;
60
+ try {
61
+ const r = await fetch(`${VERZEICHNIS}?search=knowmind`, {
62
+ signal: AbortSignal.timeout(20_000),
63
+ });
64
+ if (!r.ok) {
65
+ console.error(`ABBRUCH: Verzeichnis antwortet mit ${r.status}.`);
66
+ process.exit(2);
67
+ }
68
+ antwort = await r.json();
69
+ } catch (e) {
70
+ console.error(`ABBRUCH: Verzeichnis nicht erreichbar (${e.message})`);
71
+ process.exit(2);
72
+ }
73
+
74
+ // Die Suche liefert auch fremde Server, deren Beschreibung das Wort enthält.
75
+ // Deshalb wird auf den vollständigen Namen gefiltert, nicht auf den Treffer.
76
+ const unsere = (antwort.servers ?? [])
77
+ .map((e) => e.server ?? {})
78
+ .filter((s) => s.name === NAME);
79
+
80
+ if (unsere.length === 0) {
81
+ console.log(`Kein Eintrag für ${NAME} im Verzeichnis. Veröffentlichen.`);
82
+ process.exit(1);
83
+ }
84
+
85
+ const vorhanden = unsere.some((s) => s.version === fassung);
86
+ if (vorhanden) {
87
+ console.log(`Fassung ${fassung} steht schon im Verzeichnis (${unsere.length} Fassungen gesamt). Übergehen.`);
88
+ process.exit(0);
89
+ }
90
+
91
+ console.log(`Fassung ${fassung} fehlt im Verzeichnis (${unsere.length} andere Fassungen). Veröffentlichen.`);
92
+ process.exit(1);
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "_hinweis": "Rückfall für tools/list, wenn die Discovery nicht erreichbar ist. Erzeugt aus https://knowmind.de/api/mcp/v1. Abgleich: npm run tools:abgleich",
3
- "stand": "2026-09-07",
3
+ "stand": "2026-10-08",
4
4
  "quelle": "https://knowmind.de/api/mcp/v1",
5
5
  "protocolVersion": "2025-06-18",
6
6
  "tools": [
7
7
  {
8
- "name": "knowmind_recall",
8
+ "name": "knowmind_recall_memories",
9
9
  "annotations": {
10
10
  "title": "Recall - retrieve knowledge",
11
11
  "readOnlyHint": true,
@@ -42,7 +42,7 @@
42
42
  }
43
43
  },
44
44
  {
45
- "name": "knowmind_health",
45
+ "name": "knowmind_get_health",
46
46
  "annotations": {
47
47
  "title": "Service health",
48
48
  "readOnlyHint": true,
@@ -57,7 +57,7 @@
57
57
  }
58
58
  },
59
59
  {
60
- "name": "knowmind_stats",
60
+ "name": "knowmind_get_stats",
61
61
  "annotations": {
62
62
  "title": "Corpus statistics",
63
63
  "readOnlyHint": true,
@@ -103,7 +103,7 @@
103
103
  "idempotentHint": false,
104
104
  "openWorldHint": false
105
105
  },
106
- "description": "Store durable insights the moment they arise - decisions, preferences, facts, results, appointments. Persists one memory entry in the tenant corpus (Postgres + vector index + graph node), afterwards findable via knowmind_recall and knowmind_list_recent. Append-only: the same title replaces nothing (use knowmind_update_fact to supersede); sha-identical content is detected as idempotent (unchanged). Returns the new memory id. Use for a single short fact; for long or multi-fact text use knowmind_upload_document. GIVE THE EDGES ALONG: whatever the text says about people, organisations, projects, hosts or technologies belongs into `relations` in THIS call - name the counterpart, the server creates its node and the edge, no second call needed. A memory without edges is a note; with edges it becomes a graph that answers questions nobody wrote down. Use knowmind_link separately only to connect two entries that already exist. Requires write scope.",
106
+ "description": "Store durable insights the moment they arise - decisions, preferences, facts, results, appointments. Persists one memory entry in the tenant corpus (Postgres + vector index + graph node), afterwards findable via knowmind_recall and knowmind_list_recent. Append-only: the same title replaces nothing (use knowmind_update_fact to supersede); sha-identical content is detected as idempotent (unchanged). Returns the new memory id. Use for a single short fact; for long or multi-fact text use knowmind_upload_document. GIVE THE EDGES ALONG: whatever the text says about people, organisations, projects, hosts or technologies belongs into `relations` in THIS call - name the counterpart, the server creates its node and the edge, no second call needed. A memory without edges is a note; with edges it becomes a graph that answers questions nobody wrote down. Use knowmind_link separately only to connect two entries that already exist. ENTRIES ARE NEVER HARD-DELETED, they are superseded: correct a fact with knowmind_update_fact, remove an edge with knowmind_unlink_entities. Both keep the history auditable, which is the point of this store - what was true when, and when that changed. Requires write scope.",
107
107
  "inputSchema": {
108
108
  "type": "object",
109
109
  "properties": {
@@ -143,7 +143,7 @@
143
143
  },
144
144
  "relations": {
145
145
  "type": "array",
146
- "description": "Edges from this entry to the things it talks about - set them HERE, in the same call. Name the counterpart in plain words; the server finds or creates its node and draws the edge, so you need neither knowmind_recall nor knowmind_entity nor knowmind_link for it. Example: storing 'Anna Meier leitet die IT bei der Muster GmbH' carries [{predicate: 'WORKS_FOR', object: 'Muster GmbH', object_class: 'Organization'}]. An entry without edges is a note; with edges it answers questions nobody wrote down. Allowed predicate values: ABOUT (Contract|Document|FileResource → Topic), CLIENT_OF (Agent|Organization|Person|SoftwareAgent → Organization), CONTACT_PERSON_FOR (Person → Organization), COVERED_BY (Topic → Contract|Document|FileResource), DELIVERED_AS (Application → Product), DELIVERED_BY (Product → Application), DEPENDS_ON (Application → Application), DEPLOYED_TO (Application → Container), DEVELOPED_BY (Application → Agent|Organization|Person|SoftwareAgent), DEVELOPS (Agent|Organization|Person|SoftwareAgent → Application), ENABLES (Application → Application), FOR_CLIENT (Project → Agent|Organization|Person|SoftwareAgent), HAS_CHILD (Person → Person), HAS_CLIENT (Organization → Agent|Organization|Person|SoftwareAgent), HAS_CONTACT_PERSON (Organization → Person), HAS_EMPLOYEE (Organization → Person), HAS_OPERATED_APPLICATION (Agent|Organization|Person|SoftwareAgent → Application), HAS_PARENT (Person → Person), HAS_PROJECT (Agent|Organization|Person|SoftwareAgent → Project), HAS_ROLE (Person → Role), HAS_SIBLING (Person → Person), HAS_SKILL (Agent|Organization|Person|SoftwareAgent → Skill), HOSTED_ON (Container → Host), HOSTS (Host → Container), HOSTS_APPLICATION (Container → Application), INFRASTRUCTURE_PROVIDED_BY (Host → Organization), INTEGRATES_WITH (Application → Application), IS_LED_BY (Organization → Person), KNOWS (Person → Person), LEADS (Person → Organization), OPERATED_FOR (Application → Agent|Organization|Person|SoftwareAgent), PAID_BY (Agent|Organization|Person|SoftwareAgent → Agent|Organization|Person|SoftwareAgent), PARTNER_OF (Organization → Organization), PAYS (Agent|Organization|Person|SoftwareAgent → Agent|Organization|Person|SoftwareAgent), PRODUCED_BY (Contract|Document|FileResource → Project), PRODUCES (Project → Contract|Document|FileResource), PROVIDES_INFRASTRUCTURE (Organization → Host), ROLE_OF (Role → Person), SERVED_UNDER (Application → Domain), SERVES (Domain → Application), SKILL_OF (Skill → Agent|Organization|Person|SoftwareAgent), SPOUSE_OF (Person → Person), SUPPLIED_BY (Agent|Organization|Person|SoftwareAgent → Organization), SUPPLIES (Organization → Agent|Organization|Person|SoftwareAgent), SUPPLIES_TECHNOLOGY (Organization → Technology), SUPPORTED_BY (Contract|Document|FileResource → Contract|Document|FileResource), SUPPORTS (Contract|Document|FileResource → Contract|Document|FileResource), TECHNOLOGY_SUPPLIED_BY (Technology → Organization), TECHNOLOGY_USED_BY (Technology → Application), USES_TECHNOLOGY (Application → Technology), WORKED_ON_BY (Project → Agent|Organization|Person|SoftwareAgent), WORKS_FOR (Person → Organization), WORKS_ON (Agent|Organization|Person|SoftwareAgent → Project)",
146
+ "description": "Edges from this entry to the things it talks about - set them HERE, in the same call. Name the counterpart in plain words; the server finds or creates its node and draws the edge, so you need neither knowmind_recall nor knowmind_entity nor knowmind_link for it. Example: storing 'Anna Meier leitet die IT bei der Muster GmbH' carries [{predicate: 'WORKS_FOR', object: 'Muster GmbH', object_class: 'Organization'}]. An entry without edges is a note; with edges it answers questions nobody wrote down. Allowed predicate values: ABOUT (Contract|Document|FileResource → Topic), ASSIGNED_TO (ActionRecord|Task → Agent|Organization|Person|SoftwareAgent), CLIENT_OF (Agent|Organization|Person|SoftwareAgent → Organization), CONTACT_PERSON_FOR (Person → Organization), COVERED_BY (Topic → Contract|Document|FileResource), DELIVERED_AS (Application → Product), DELIVERED_BY (Product → Application), DEPENDS_ON (Application → Application), DEPLOYED_TO (Application → Container), DEVELOPED_BY (Application → Agent|Organization|Person|SoftwareAgent), DEVELOPS (Agent|Organization|Person|SoftwareAgent → Application), ENABLES (Application → Application), FOR_CLIENT (Project → Agent|Organization|Person|SoftwareAgent), HAS_ASSIGNED_TASK (Agent|Organization|Person|SoftwareAgent → ActionRecord|Task), HAS_CHILD (Person → Person), HAS_CLIENT (Organization → Agent|Organization|Person|SoftwareAgent), HAS_CONTACT_PERSON (Organization → Person), HAS_EMPLOYEE (Organization → Person), HAS_OPERATED_APPLICATION (Agent|Organization|Person|SoftwareAgent → Application), HAS_PARENT (Person → Person), HAS_PREDECESSOR (ActionRecord|Project|Task → ActionRecord|Project|Task), HAS_PROJECT (Agent|Organization|Person|SoftwareAgent → Project), HAS_ROLE (Person → Role), HAS_SIBLING (Person → Person), HAS_SKILL (Agent|Organization|Person|SoftwareAgent → Skill), HAS_SUCCESSOR (ActionRecord|Project|Task → ActionRecord|Project|Task), HOSTED_ON (Container → Host), HOSTS (Host → Container), HOSTS_APPLICATION (Container → Application), INFRASTRUCTURE_PROVIDED_BY (Host → Organization), INTEGRATES_WITH (Application → Application), IS_LED_BY (Organization → Person), KNOWS (Person → Person), LEADS (Person → Organization), OPERATED_FOR (Application → Agent|Organization|Person|SoftwareAgent), PAID_BY (Agent|Organization|Person|SoftwareAgent → Agent|Organization|Person|SoftwareAgent), PARTNER_OF (Organization → Organization), PAYS (Agent|Organization|Person|SoftwareAgent → Agent|Organization|Person|SoftwareAgent), PRODUCED_BY (Contract|Document|FileResource → Project), PRODUCES (Project → Contract|Document|FileResource), PROVIDES_INFRASTRUCTURE (Organization → Host), ROLE_OF (Role → Person), SERVED_UNDER (Application → Domain), SERVES (Domain → Application), SKILL_OF (Skill → Agent|Organization|Person|SoftwareAgent), SPOUSE_OF (Person → Person), SUPPLIED_BY (Agent|Organization|Person|SoftwareAgent → Organization), SUPPLIES (Organization → Agent|Organization|Person|SoftwareAgent), SUPPLIES_TECHNOLOGY (Organization → Technology), SUPPORTED_BY (Contract|Document|FileResource → Contract|Document|FileResource), SUPPORTS (Contract|Document|FileResource → Contract|Document|FileResource), TECHNOLOGY_SUPPLIED_BY (Technology → Organization), TECHNOLOGY_USED_BY (Technology → Application), USES_TECHNOLOGY (Application → Technology), WORKED_ON_BY (Project → Agent|Organization|Person|SoftwareAgent), WORKS_FOR (Person → Organization), WORKS_ON (Agent|Organization|Person|SoftwareAgent → Project)",
147
147
  "items": {
148
148
  "type": "object",
149
149
  "properties": {
@@ -185,7 +185,7 @@
185
185
  "annotations": {
186
186
  "title": "Upload document",
187
187
  "readOnlyHint": false,
188
- "destructiveHint": false,
188
+ "destructiveHint": true,
189
189
  "idempotentHint": false,
190
190
  "openWorldHint": false
191
191
  },
@@ -207,7 +207,7 @@
207
207
  },
208
208
  "relations": {
209
209
  "type": "array",
210
- "description": "Edges from this document to the things it talks about - set them HERE, in the same call. Name the counterpart in plain words; the server finds or creates its node and draws the edge. Allowed predicate values: ABOUT (Contract|Document|FileResource → Topic), CLIENT_OF (Agent|Organization|Person|SoftwareAgent → Organization), CONTACT_PERSON_FOR (Person → Organization), COVERED_BY (Topic → Contract|Document|FileResource), DELIVERED_AS (Application → Product), DELIVERED_BY (Product → Application), DEPENDS_ON (Application → Application), DEPLOYED_TO (Application → Container), DEVELOPED_BY (Application → Agent|Organization|Person|SoftwareAgent), DEVELOPS (Agent|Organization|Person|SoftwareAgent → Application), ENABLES (Application → Application), FOR_CLIENT (Project → Agent|Organization|Person|SoftwareAgent), HAS_CHILD (Person → Person), HAS_CLIENT (Organization → Agent|Organization|Person|SoftwareAgent), HAS_CONTACT_PERSON (Organization → Person), HAS_EMPLOYEE (Organization → Person), HAS_OPERATED_APPLICATION (Agent|Organization|Person|SoftwareAgent → Application), HAS_PARENT (Person → Person), HAS_PROJECT (Agent|Organization|Person|SoftwareAgent → Project), HAS_ROLE (Person → Role), HAS_SIBLING (Person → Person), HAS_SKILL (Agent|Organization|Person|SoftwareAgent → Skill), HOSTED_ON (Container → Host), HOSTS (Host → Container), HOSTS_APPLICATION (Container → Application), INFRASTRUCTURE_PROVIDED_BY (Host → Organization), INTEGRATES_WITH (Application → Application), IS_LED_BY (Organization → Person), KNOWS (Person → Person), LEADS (Person → Organization), OPERATED_FOR (Application → Agent|Organization|Person|SoftwareAgent), PAID_BY (Agent|Organization|Person|SoftwareAgent → Agent|Organization|Person|SoftwareAgent), PARTNER_OF (Organization → Organization), PAYS (Agent|Organization|Person|SoftwareAgent → Agent|Organization|Person|SoftwareAgent), PRODUCED_BY (Contract|Document|FileResource → Project), PRODUCES (Project → Contract|Document|FileResource), PROVIDES_INFRASTRUCTURE (Organization → Host), ROLE_OF (Role → Person), SERVED_UNDER (Application → Domain), SERVES (Domain → Application), SKILL_OF (Skill → Agent|Organization|Person|SoftwareAgent), SPOUSE_OF (Person → Person), SUPPLIED_BY (Agent|Organization|Person|SoftwareAgent → Organization), SUPPLIES (Organization → Agent|Organization|Person|SoftwareAgent), SUPPLIES_TECHNOLOGY (Organization → Technology), SUPPORTED_BY (Contract|Document|FileResource → Contract|Document|FileResource), SUPPORTS (Contract|Document|FileResource → Contract|Document|FileResource), TECHNOLOGY_SUPPLIED_BY (Technology → Organization), TECHNOLOGY_USED_BY (Technology → Application), USES_TECHNOLOGY (Application → Technology), WORKED_ON_BY (Project → Agent|Organization|Person|SoftwareAgent), WORKS_FOR (Person → Organization), WORKS_ON (Agent|Organization|Person|SoftwareAgent → Project)",
210
+ "description": "Edges from this document to the things it talks about - set them HERE, in the same call. Name the counterpart in plain words; the server finds or creates its node and draws the edge. Allowed predicate values: ABOUT (Contract|Document|FileResource → Topic), ASSIGNED_TO (ActionRecord|Task → Agent|Organization|Person|SoftwareAgent), CLIENT_OF (Agent|Organization|Person|SoftwareAgent → Organization), CONTACT_PERSON_FOR (Person → Organization), COVERED_BY (Topic → Contract|Document|FileResource), DELIVERED_AS (Application → Product), DELIVERED_BY (Product → Application), DEPENDS_ON (Application → Application), DEPLOYED_TO (Application → Container), DEVELOPED_BY (Application → Agent|Organization|Person|SoftwareAgent), DEVELOPS (Agent|Organization|Person|SoftwareAgent → Application), ENABLES (Application → Application), FOR_CLIENT (Project → Agent|Organization|Person|SoftwareAgent), HAS_ASSIGNED_TASK (Agent|Organization|Person|SoftwareAgent → ActionRecord|Task), HAS_CHILD (Person → Person), HAS_CLIENT (Organization → Agent|Organization|Person|SoftwareAgent), HAS_CONTACT_PERSON (Organization → Person), HAS_EMPLOYEE (Organization → Person), HAS_OPERATED_APPLICATION (Agent|Organization|Person|SoftwareAgent → Application), HAS_PARENT (Person → Person), HAS_PREDECESSOR (ActionRecord|Project|Task → ActionRecord|Project|Task), HAS_PROJECT (Agent|Organization|Person|SoftwareAgent → Project), HAS_ROLE (Person → Role), HAS_SIBLING (Person → Person), HAS_SKILL (Agent|Organization|Person|SoftwareAgent → Skill), HAS_SUCCESSOR (ActionRecord|Project|Task → ActionRecord|Project|Task), HOSTED_ON (Container → Host), HOSTS (Host → Container), HOSTS_APPLICATION (Container → Application), INFRASTRUCTURE_PROVIDED_BY (Host → Organization), INTEGRATES_WITH (Application → Application), IS_LED_BY (Organization → Person), KNOWS (Person → Person), LEADS (Person → Organization), OPERATED_FOR (Application → Agent|Organization|Person|SoftwareAgent), PAID_BY (Agent|Organization|Person|SoftwareAgent → Agent|Organization|Person|SoftwareAgent), PARTNER_OF (Organization → Organization), PAYS (Agent|Organization|Person|SoftwareAgent → Agent|Organization|Person|SoftwareAgent), PRODUCED_BY (Contract|Document|FileResource → Project), PRODUCES (Project → Contract|Document|FileResource), PROVIDES_INFRASTRUCTURE (Organization → Host), ROLE_OF (Role → Person), SERVED_UNDER (Application → Domain), SERVES (Domain → Application), SKILL_OF (Skill → Agent|Organization|Person|SoftwareAgent), SPOUSE_OF (Person → Person), SUPPLIED_BY (Agent|Organization|Person|SoftwareAgent → Organization), SUPPLIES (Organization → Agent|Organization|Person|SoftwareAgent), SUPPLIES_TECHNOLOGY (Organization → Technology), SUPPORTED_BY (Contract|Document|FileResource → Contract|Document|FileResource), SUPPORTS (Contract|Document|FileResource → Contract|Document|FileResource), TECHNOLOGY_SUPPLIED_BY (Technology → Organization), TECHNOLOGY_USED_BY (Technology → Application), USES_TECHNOLOGY (Application → Technology), WORKED_ON_BY (Project → Agent|Organization|Person|SoftwareAgent), WORKS_FOR (Person → Organization), WORKS_ON (Agent|Organization|Person|SoftwareAgent → Project)",
211
211
  "items": {
212
212
  "type": "object",
213
213
  "properties": {
@@ -316,7 +316,7 @@
316
316
  }
317
317
  },
318
318
  {
319
- "name": "knowmind_entity",
319
+ "name": "knowmind_upsert_entity",
320
320
  "annotations": {
321
321
  "title": "Create entity",
322
322
  "readOnlyHint": false,
@@ -355,7 +355,7 @@
355
355
  }
356
356
  },
357
357
  {
358
- "name": "knowmind_link",
358
+ "name": "knowmind_link_entities",
359
359
  "annotations": {
360
360
  "title": "Link relation",
361
361
  "readOnlyHint": false,
@@ -363,7 +363,7 @@
363
363
  "idempotentHint": true,
364
364
  "openWorldHint": false
365
365
  },
366
- "description": "Create a typed relation between two memory nodes (a knowledge-graph edge). THIS IS HOW THE GRAPH IS BUILT: after storing memories, connect them - a corpus without edges answers only what a single note already says. Subject and object classes must match the predicate; the inverse edge is materialized automatically, and derived edges (RUNS_ON, WORKS_FOR_CLIENT, HOST_SERVES_CLIENT, DEPENDS_ON_SUPPLIER) are computed by the server - never set them by hand. Get both node IDs via knowmind_recall first, and call knowmind_schema for the full catalogue with explanations. Allowed rel_type values: ABOUT (Contract|Document|FileResource → Topic), CLIENT_OF (Agent|Organization|Person|SoftwareAgent → Organization), CONTACT_PERSON_FOR (Person → Organization), COVERED_BY (Topic → Contract|Document|FileResource), DELIVERED_AS (Application → Product), DELIVERED_BY (Product → Application), DEPENDS_ON (Application → Application), DEPLOYED_TO (Application → Container), DEVELOPED_BY (Application → Agent|Organization|Person|SoftwareAgent), DEVELOPS (Agent|Organization|Person|SoftwareAgent → Application), ENABLES (Application → Application), FOR_CLIENT (Project → Agent|Organization|Person|SoftwareAgent), HAS_CHILD (Person → Person), HAS_CLIENT (Organization → Agent|Organization|Person|SoftwareAgent), HAS_CONTACT_PERSON (Organization → Person), HAS_EMPLOYEE (Organization → Person), HAS_OPERATED_APPLICATION (Agent|Organization|Person|SoftwareAgent → Application), HAS_PARENT (Person → Person), HAS_PROJECT (Agent|Organization|Person|SoftwareAgent → Project), HAS_ROLE (Person → Role), HAS_SIBLING (Person → Person), HAS_SKILL (Agent|Organization|Person|SoftwareAgent → Skill), HOSTED_ON (Container → Host), HOSTS (Host → Container), HOSTS_APPLICATION (Container → Application), INFRASTRUCTURE_PROVIDED_BY (Host → Organization), INTEGRATES_WITH (Application → Application), IS_LED_BY (Organization → Person), KNOWS (Person → Person), LEADS (Person → Organization), OPERATED_FOR (Application → Agent|Organization|Person|SoftwareAgent), PAID_BY (Agent|Organization|Person|SoftwareAgent → Agent|Organization|Person|SoftwareAgent), PARTNER_OF (Organization → Organization), PAYS (Agent|Organization|Person|SoftwareAgent → Agent|Organization|Person|SoftwareAgent), PRODUCED_BY (Contract|Document|FileResource → Project), PRODUCES (Project → Contract|Document|FileResource), PROVIDES_INFRASTRUCTURE (Organization → Host), ROLE_OF (Role → Person), SERVED_UNDER (Application → Domain), SERVES (Domain → Application), SKILL_OF (Skill → Agent|Organization|Person|SoftwareAgent), SPOUSE_OF (Person → Person), SUPPLIED_BY (Agent|Organization|Person|SoftwareAgent → Organization), SUPPLIES (Organization → Agent|Organization|Person|SoftwareAgent), SUPPLIES_TECHNOLOGY (Organization → Technology), SUPPORTED_BY (Contract|Document|FileResource → Contract|Document|FileResource), SUPPORTS (Contract|Document|FileResource → Contract|Document|FileResource), TECHNOLOGY_SUPPLIED_BY (Technology → Organization), TECHNOLOGY_USED_BY (Technology → Application), USES_TECHNOLOGY (Application → Technology), WORKED_ON_BY (Project → Agent|Organization|Person|SoftwareAgent), WORKS_FOR (Person → Organization), WORKS_ON (Agent|Organization|Person|SoftwareAgent → Project). Requires write scope.",
366
+ "description": "Create a typed relation between two memory nodes (a knowledge-graph edge). THIS IS HOW THE GRAPH IS BUILT: after storing memories, connect them - a corpus without edges answers only what a single note already says. Subject and object classes must match the predicate; the inverse edge is materialized automatically, and derived edges (RUNS_ON, WORKS_FOR_CLIENT, HOST_SERVES_CLIENT, DEPENDS_ON_SUPPLIER) are computed by the server - never set them by hand. Get both node IDs via knowmind_recall first, and call knowmind_schema for the full catalogue with explanations. Allowed rel_type values: ABOUT (Contract|Document|FileResource → Topic), ASSIGNED_TO (ActionRecord|Task → Agent|Organization|Person|SoftwareAgent), CLIENT_OF (Agent|Organization|Person|SoftwareAgent → Organization), CONTACT_PERSON_FOR (Person → Organization), COVERED_BY (Topic → Contract|Document|FileResource), DELIVERED_AS (Application → Product), DELIVERED_BY (Product → Application), DEPENDS_ON (Application → Application), DEPLOYED_TO (Application → Container), DEVELOPED_BY (Application → Agent|Organization|Person|SoftwareAgent), DEVELOPS (Agent|Organization|Person|SoftwareAgent → Application), ENABLES (Application → Application), FOR_CLIENT (Project → Agent|Organization|Person|SoftwareAgent), HAS_ASSIGNED_TASK (Agent|Organization|Person|SoftwareAgent → ActionRecord|Task), HAS_CHILD (Person → Person), HAS_CLIENT (Organization → Agent|Organization|Person|SoftwareAgent), HAS_CONTACT_PERSON (Organization → Person), HAS_EMPLOYEE (Organization → Person), HAS_OPERATED_APPLICATION (Agent|Organization|Person|SoftwareAgent → Application), HAS_PARENT (Person → Person), HAS_PREDECESSOR (ActionRecord|Project|Task → ActionRecord|Project|Task), HAS_PROJECT (Agent|Organization|Person|SoftwareAgent → Project), HAS_ROLE (Person → Role), HAS_SIBLING (Person → Person), HAS_SKILL (Agent|Organization|Person|SoftwareAgent → Skill), HAS_SUCCESSOR (ActionRecord|Project|Task → ActionRecord|Project|Task), HOSTED_ON (Container → Host), HOSTS (Host → Container), HOSTS_APPLICATION (Container → Application), INFRASTRUCTURE_PROVIDED_BY (Host → Organization), INTEGRATES_WITH (Application → Application), IS_LED_BY (Organization → Person), KNOWS (Person → Person), LEADS (Person → Organization), OPERATED_FOR (Application → Agent|Organization|Person|SoftwareAgent), PAID_BY (Agent|Organization|Person|SoftwareAgent → Agent|Organization|Person|SoftwareAgent), PARTNER_OF (Organization → Organization), PAYS (Agent|Organization|Person|SoftwareAgent → Agent|Organization|Person|SoftwareAgent), PRODUCED_BY (Contract|Document|FileResource → Project), PRODUCES (Project → Contract|Document|FileResource), PROVIDES_INFRASTRUCTURE (Organization → Host), ROLE_OF (Role → Person), SERVED_UNDER (Application → Domain), SERVES (Domain → Application), SKILL_OF (Skill → Agent|Organization|Person|SoftwareAgent), SPOUSE_OF (Person → Person), SUPPLIED_BY (Agent|Organization|Person|SoftwareAgent → Organization), SUPPLIES (Organization → Agent|Organization|Person|SoftwareAgent), SUPPLIES_TECHNOLOGY (Organization → Technology), SUPPORTED_BY (Contract|Document|FileResource → Contract|Document|FileResource), SUPPORTS (Contract|Document|FileResource → Contract|Document|FileResource), TECHNOLOGY_SUPPLIED_BY (Technology → Organization), TECHNOLOGY_USED_BY (Technology → Application), USES_TECHNOLOGY (Application → Technology), WORKED_ON_BY (Project → Agent|Organization|Person|SoftwareAgent), WORKS_FOR (Person → Organization), WORKS_ON (Agent|Organization|Person|SoftwareAgent → Project). Requires write scope.",
367
367
  "inputSchema": {
368
368
  "type": "object",
369
369
  "properties": {
@@ -392,7 +392,7 @@
392
392
  }
393
393
  },
394
394
  {
395
- "name": "knowmind_schema",
395
+ "name": "knowmind_get_schema",
396
396
  "annotations": {
397
397
  "title": "Graph schema",
398
398
  "readOnlyHint": true,
@@ -407,7 +407,7 @@
407
407
  }
408
408
  },
409
409
  {
410
- "name": "knowmind_unlink",
410
+ "name": "knowmind_unlink_entities",
411
411
  "annotations": {
412
412
  "title": "Remove relation",
413
413
  "readOnlyHint": false,
@@ -461,6 +461,197 @@
461
461
  "memory_id"
462
462
  ]
463
463
  }
464
+ },
465
+ {
466
+ "name": "knowmind_recall",
467
+ "annotations": {
468
+ "title": "Recall - retrieve knowledge (deprecated)",
469
+ "readOnlyHint": true,
470
+ "destructiveHint": false,
471
+ "idempotentHint": true,
472
+ "openWorldHint": false
473
+ },
474
+ "description": "DEPRECATED, removed on 2027-03-31: use knowmind_recall_memories. This name keeps answering unchanged until then. Retrieve relevant knowledge before answering anything that benefits from prior context - decisions, preferences, project state, people, deadlines, past conversations. Hybrid recall (BM25 + pgvector + graph hops) over the tenant corpus; returns the top-k memory chunks, each with a relevance score and source reference. Suitable whenever earlier context would improve the answer; use knowmind_recall_at_time when you need what was valid at a past point in time. Read scope suffices.",
475
+ "inputSchema": {
476
+ "type": "object",
477
+ "properties": {
478
+ "query": {
479
+ "type": "string",
480
+ "description": "Natural-language question; full sentences retrieve better than keywords."
481
+ },
482
+ "k": {
483
+ "type": "integer",
484
+ "minimum": 1,
485
+ "maximum": 25,
486
+ "default": 5,
487
+ "description": "Number of chunks to return (1-25, default 5)."
488
+ },
489
+ "hops": {
490
+ "type": "integer",
491
+ "minimum": 0,
492
+ "maximum": 3,
493
+ "default": 2,
494
+ "description": "Graph expansion depth over typed relations (0-3, default 2); 0 = text/vector only, no graph."
495
+ }
496
+ },
497
+ "required": [
498
+ "query"
499
+ ]
500
+ }
501
+ },
502
+ {
503
+ "name": "knowmind_health",
504
+ "annotations": {
505
+ "title": "Service health (deprecated)",
506
+ "readOnlyHint": true,
507
+ "destructiveHint": false,
508
+ "idempotentHint": true,
509
+ "openWorldHint": false
510
+ },
511
+ "description": "DEPRECATED, removed on 2027-03-31: use knowmind_get_health. This name keeps answering unchanged until then. Return the health of the knowmind backend (Postgres, memory service, graph). Use before a batch of writes or when calls fail, to tell an outage apart from an empty result. Returns a status object per component. Read scope suffices; takes no parameters.",
512
+ "inputSchema": {
513
+ "type": "object",
514
+ "properties": {}
515
+ }
516
+ },
517
+ {
518
+ "name": "knowmind_stats",
519
+ "annotations": {
520
+ "title": "Corpus statistics (deprecated)",
521
+ "readOnlyHint": true,
522
+ "destructiveHint": false,
523
+ "idempotentHint": true,
524
+ "openWorldHint": false
525
+ },
526
+ "description": "DEPRECATED, removed on 2027-03-31: use knowmind_get_stats. This name keeps answering unchanged until then. Return current counts for the tenant corpus: memories, graph edges and vector chunks. Use to gauge how much has been stored; for the actual entries use knowmind_list_recent or knowmind_recall. Read scope suffices; takes no parameters.",
527
+ "inputSchema": {
528
+ "type": "object",
529
+ "properties": {}
530
+ }
531
+ },
532
+ {
533
+ "name": "knowmind_entity",
534
+ "annotations": {
535
+ "title": "Create entity (deprecated)",
536
+ "readOnlyHint": false,
537
+ "destructiveHint": false,
538
+ "idempotentHint": true,
539
+ "openWorldHint": false
540
+ },
541
+ "description": "DEPRECATED, removed on 2027-03-31: use knowmind_upsert_entity. This name keeps answering unchanged until then. Create the node for a thing the corpus talks about - a person, an organisation, an application, a host, a technology - or return the existing one. THE GRAPH NEEDS THESE: memories are texts, and two texts mentioning the same server stay unconnected until that server exists as its own node. Create an entity when a name recurs across memories or when you are about to link something that has no node yet, then connect it with knowmind_link. Same name, same class and same tenant always return the same id, so calling twice creates no duplicate. Give the entity its plain proper name (\"PostgreSQL\", not \"the database we use\"), and pick the class from the catalogue in knowmind_schema. Requires write scope.",
542
+ "inputSchema": {
543
+ "type": "object",
544
+ "properties": {
545
+ "name": {
546
+ "type": "string",
547
+ "description": "Proper name of the thing, as it would be written in a document. No role, no status, no description."
548
+ },
549
+ "entity_class": {
550
+ "type": "string",
551
+ "description": "Class from the catalogue (knowmind_schema -> entityClasses), e.g. Person, Organization, Application, Host, Technology."
552
+ },
553
+ "description": {
554
+ "type": "string",
555
+ "description": "One sentence saying what this is. Optional, helps later retrieval."
556
+ },
557
+ "aliases": {
558
+ "type": "array",
559
+ "items": {
560
+ "type": "string"
561
+ },
562
+ "description": "Other spellings the same thing appears under. Optional."
563
+ }
564
+ },
565
+ "required": [
566
+ "name",
567
+ "entity_class"
568
+ ]
569
+ }
570
+ },
571
+ {
572
+ "name": "knowmind_link",
573
+ "annotations": {
574
+ "title": "Link relation (deprecated)",
575
+ "readOnlyHint": false,
576
+ "destructiveHint": false,
577
+ "idempotentHint": true,
578
+ "openWorldHint": false
579
+ },
580
+ "description": "DEPRECATED, removed on 2027-03-31: use knowmind_link_entities. This name keeps answering unchanged until then. Create a typed relation between two memory nodes (a knowledge-graph edge). THIS IS HOW THE GRAPH IS BUILT: after storing memories, connect them - a corpus without edges answers only what a single note already says. Subject and object classes must match the predicate; the inverse edge is materialized automatically, and derived edges (RUNS_ON, WORKS_FOR_CLIENT, HOST_SERVES_CLIENT, DEPENDS_ON_SUPPLIER) are computed by the server - never set them by hand. Get both node IDs via knowmind_recall first, and call knowmind_schema for the full catalogue with explanations. Allowed rel_type values: ABOUT (Contract|Document|FileResource → Topic), ASSIGNED_TO (ActionRecord|Task → Agent|Organization|Person|SoftwareAgent), CLIENT_OF (Agent|Organization|Person|SoftwareAgent → Organization), CONTACT_PERSON_FOR (Person → Organization), COVERED_BY (Topic → Contract|Document|FileResource), DELIVERED_AS (Application → Product), DELIVERED_BY (Product → Application), DEPENDS_ON (Application → Application), DEPLOYED_TO (Application → Container), DEVELOPED_BY (Application → Agent|Organization|Person|SoftwareAgent), DEVELOPS (Agent|Organization|Person|SoftwareAgent → Application), ENABLES (Application → Application), FOR_CLIENT (Project → Agent|Organization|Person|SoftwareAgent), HAS_ASSIGNED_TASK (Agent|Organization|Person|SoftwareAgent → ActionRecord|Task), HAS_CHILD (Person → Person), HAS_CLIENT (Organization → Agent|Organization|Person|SoftwareAgent), HAS_CONTACT_PERSON (Organization → Person), HAS_EMPLOYEE (Organization → Person), HAS_OPERATED_APPLICATION (Agent|Organization|Person|SoftwareAgent → Application), HAS_PARENT (Person → Person), HAS_PREDECESSOR (ActionRecord|Project|Task → ActionRecord|Project|Task), HAS_PROJECT (Agent|Organization|Person|SoftwareAgent → Project), HAS_ROLE (Person → Role), HAS_SIBLING (Person → Person), HAS_SKILL (Agent|Organization|Person|SoftwareAgent → Skill), HAS_SUCCESSOR (ActionRecord|Project|Task → ActionRecord|Project|Task), HOSTED_ON (Container → Host), HOSTS (Host → Container), HOSTS_APPLICATION (Container → Application), INFRASTRUCTURE_PROVIDED_BY (Host → Organization), INTEGRATES_WITH (Application → Application), IS_LED_BY (Organization → Person), KNOWS (Person → Person), LEADS (Person → Organization), OPERATED_FOR (Application → Agent|Organization|Person|SoftwareAgent), PAID_BY (Agent|Organization|Person|SoftwareAgent → Agent|Organization|Person|SoftwareAgent), PARTNER_OF (Organization → Organization), PAYS (Agent|Organization|Person|SoftwareAgent → Agent|Organization|Person|SoftwareAgent), PRODUCED_BY (Contract|Document|FileResource → Project), PRODUCES (Project → Contract|Document|FileResource), PROVIDES_INFRASTRUCTURE (Organization → Host), ROLE_OF (Role → Person), SERVED_UNDER (Application → Domain), SERVES (Domain → Application), SKILL_OF (Skill → Agent|Organization|Person|SoftwareAgent), SPOUSE_OF (Person → Person), SUPPLIED_BY (Agent|Organization|Person|SoftwareAgent → Organization), SUPPLIES (Organization → Agent|Organization|Person|SoftwareAgent), SUPPLIES_TECHNOLOGY (Organization → Technology), SUPPORTED_BY (Contract|Document|FileResource → Contract|Document|FileResource), SUPPORTS (Contract|Document|FileResource → Contract|Document|FileResource), TECHNOLOGY_SUPPLIED_BY (Technology → Organization), TECHNOLOGY_USED_BY (Technology → Application), USES_TECHNOLOGY (Application → Technology), WORKED_ON_BY (Project → Agent|Organization|Person|SoftwareAgent), WORKS_FOR (Person → Organization), WORKS_ON (Agent|Organization|Person|SoftwareAgent → Project). Requires write scope.",
581
+ "inputSchema": {
582
+ "type": "object",
583
+ "properties": {
584
+ "from_id": {
585
+ "type": "string",
586
+ "description": "Memory ID of the source node (get it via knowmind_recall)."
587
+ },
588
+ "to_id": {
589
+ "type": "string",
590
+ "description": "Memory ID of the target node."
591
+ },
592
+ "rel_type": {
593
+ "type": "string",
594
+ "description": "Edge type in UPPER_SNAKE_CASE from the allowed list. Must fit the subject and object classes."
595
+ },
596
+ "confidence": {
597
+ "type": "number",
598
+ "description": "Edge confidence in [0..1]; 1.0 for a fact stated verbatim, 0.7 for a clear paraphrase. Below that, do not create the edge."
599
+ }
600
+ },
601
+ "required": [
602
+ "from_id",
603
+ "to_id",
604
+ "rel_type"
605
+ ]
606
+ }
607
+ },
608
+ {
609
+ "name": "knowmind_schema",
610
+ "annotations": {
611
+ "title": "Graph schema (deprecated)",
612
+ "readOnlyHint": true,
613
+ "destructiveHint": false,
614
+ "idempotentHint": true,
615
+ "openWorldHint": false
616
+ },
617
+ "description": "DEPRECATED, removed on 2027-03-31: use knowmind_get_schema. This name keeps answering unchanged until then. Return the relation catalogue of this tenant's knowledge graph: every allowed edge type with its subject and object classes and an explanation of when to use it. Call this before building edges with knowmind_link, so you pick the right predicate instead of the nearest-sounding one. Read scope suffices.",
618
+ "inputSchema": {
619
+ "type": "object",
620
+ "properties": {}
621
+ }
622
+ },
623
+ {
624
+ "name": "knowmind_unlink",
625
+ "annotations": {
626
+ "title": "Remove relation (deprecated)",
627
+ "readOnlyHint": false,
628
+ "destructiveHint": true,
629
+ "idempotentHint": true,
630
+ "openWorldHint": false
631
+ },
632
+ "description": "DEPRECATED, removed on 2027-03-31: use knowmind_unlink_entities. This name keeps answering unchanged until then. Delete a typed relation between two memory nodes; the inverse edge is removed with it. Idempotent - deleting a non-existent edge is a no-op. Use to correct a wrong link created via knowmind_link. Requires write scope.",
633
+ "inputSchema": {
634
+ "type": "object",
635
+ "properties": {
636
+ "from_id": {
637
+ "type": "string",
638
+ "description": "Memory ID of the source node."
639
+ },
640
+ "to_id": {
641
+ "type": "string",
642
+ "description": "Memory ID of the target node."
643
+ },
644
+ "rel_type": {
645
+ "type": "string",
646
+ "description": "Edge type to remove (UPPER_SNAKE_CASE, exactly as created)."
647
+ }
648
+ },
649
+ "required": [
650
+ "from_id",
651
+ "to_id",
652
+ "rel_type"
653
+ ]
654
+ }
464
655
  }
465
656
  ]
466
657
  }