@arkheia/mcp-server 1.2.0 → 1.2.2

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.
@@ -0,0 +1,33 @@
1
+ # Fabrication Detection — Arkheia
2
+
3
+ When Arkheia MCP tools are available in this session, follow this protocol.
4
+
5
+ ## Detection
6
+
7
+ Call `arkheia_verify` on EVERY model response before surfacing it to the user. Do not skip responses that appear obviously correct.
8
+
9
+ ## Risk Escalation
10
+
11
+ - **HIGH risk**: Warn the user that the response may be fabricated. Include the `detection_id`. Still show the response — never hide or suppress it. Ask the user if they want to verify with a different model.
12
+ - **MEDIUM risk**: Show the response with a brief confidence note.
13
+ - **LOW risk**: Show normally.
14
+ - **UNKNOWN risk**: Flag for human review. Include the `detection_id`.
15
+
16
+ ## Cross-Model Verification
17
+
18
+ When HIGH or UNKNOWN risk is detected, offer to verify using: `run_grok`, `run_gemini`, `run_ollama`, `run_together`.
19
+
20
+ ## Audit Trail
21
+
22
+ Use `arkheia_audit_log` when the user asks about detection history or for compliance evidence.
23
+
24
+ ## Persistent Knowledge Graph
25
+
26
+ Use `memory_store` to persist facts, `memory_retrieve` to recall them, `memory_relate` to track relationships between entities.
27
+
28
+ ## Key Rules
29
+
30
+ 1. Never hide a response from the user regardless of risk level
31
+ 2. Always include the `detection_id` when reporting HIGH or UNKNOWN risk
32
+ 3. Call `arkheia_verify` proactively — do not wait for the user to ask
33
+ 4. Audit logging happens automatically through `arkheia_verify`
package/README.md CHANGED
@@ -1,89 +1,177 @@
1
- # Arkheia MCP Server — Fabrication Detection for AI Agents
2
-
3
- Know when your AI is making things up.
4
-
5
- Arkheia screens model responses for fabrication using behavioural fingerprinting. Works with Claude, GPT, Gemini, Grok, Llama, Mistral, and 30+ other models. One tool call. Real-time risk scoring.
6
-
7
- Free tier: 1,500 detections/month. No credit card.
8
-
9
- ## Quick Start
10
-
11
- ```bash
12
- npx @arkheia/mcp-server
13
- ```
14
-
15
- Get a free API key:
16
-
17
- ```bash
18
- curl -X POST https://arkheia-proxy-production.up.railway.app/v1/provision \
19
- -H "Content-Type: application/json" \
20
- -d '{"email": "you@example.com"}'
21
- ```
22
-
23
- Add to your agent config (Claude Code, Claude Desktop, Cursor, or any MCP-compatible tool):
24
-
25
- ```json
26
- {
27
- "mcpServers": {
28
- "arkheia": {
29
- "command": "python",
30
- "args": ["-m", "mcp_server.server"],
31
- "cwd": "~/.arkheia/mcp",
32
- "env": {
33
- "PYTHONPATH": "~/.arkheia/mcp",
34
- "ARKHEIA_API_KEY": "ak_live_your_key_here"
35
- }
36
- }
37
- }
38
- }
39
- ```
40
-
41
- Restart your agent. Then ask it:
42
-
43
- > "Use arkheia_verify to check this response: The Kafka 4.1 ConsumerLease API introduces a lease-based partition ownership model."
44
-
45
- It should flag this as **HIGH** risk — because the Kafka 4.1 ConsumerLease API doesn't exist.
46
-
47
- ## What You Get
48
-
49
- | Tool | Description |
50
- |------|-------------|
51
- | `arkheia_verify` | Score any model response for fabrication risk (LOW/MEDIUM/HIGH) |
52
- | `arkheia_audit_log` | Review your detection history |
53
- | `run_grok` | Call Grok + screen for fabrication |
54
- | `run_gemini` | Call Gemini + screen for fabrication |
55
- | `run_ollama` | Call local Ollama model + screen |
56
- | `run_together` | Call Together AI (Kimi, DeepSeek) + screen |
57
-
58
- ## 35+ Model Profiles
59
-
60
- GPT-4o, GPT-5.4, Claude Opus/Sonnet/Haiku, Gemini 2.5/3.0, Grok 4, Llama, Mixtral, CodeLlama, Falcon, Phi4, Kimi K2.5, and more. If your model isn't listed, [let us know](mailto:dmurfet@arkheia.ai).
61
-
62
- ## Pricing
63
-
64
- | Plan | Price | Detections |
65
- |------|-------|------------|
66
- | Free | $0 | 1,500/month |
67
- | Single Contributor | $99/month | Unlimited |
68
- | Professional | $499/month | Unlimited |
69
- | Team | $1,999/month | Unlimited |
70
-
71
- ## Full Documentation
72
-
73
- See the [GitHub repo](https://github.com/arkheiaai/arkheia-mcp) for:
74
- - Complete setup guide for all agents
75
- - CLAUDE.md template for automatic detection across projects
76
- - Multi-agent quorum pattern
77
- - Test prompts and examples
78
-
79
- ## Feedback
80
-
81
- - **GitHub Issues:** https://github.com/arkheiaai/arkheia-mcp/issues
82
- - **Email:** dmurfet@arkheia.ai
83
-
84
- Every message is read by the founder.
85
-
86
- ## Links
87
-
88
- - Website: https://arkheia.ai
89
- - GitHub: https://github.com/arkheiaai/arkheia-mcp
1
+ # Arkheia MCP Server — Fabrication Detection for AI Agents
2
+
3
+ Know when your AI is making things up.
4
+
5
+ Arkheia screens model responses for fabrication using behavioural fingerprinting. Works with Claude, GPT, Gemini, Grok, Llama, Mistral, and 30+ other models. One tool call. Real-time risk scoring.
6
+
7
+ Free tier: 1,500 detections/month. No credit card.
8
+
9
+ ## Prerequisites
10
+
11
+ ```
12
+ Requires:
13
+ - Node 18+
14
+ - Python 3.10–3.13 with working pyexpat
15
+
16
+ macOS note: Homebrew's current `brew install python` installs 3.14,
17
+ which has a broken pyexpat link. Use `brew install python@3.12` until
18
+ Homebrew ships a fix. Verify with:
19
+ python3.12 -c "import pyexpat, ensurepip"
20
+ ```
21
+
22
+ ## Install
23
+
24
+ ```bash
25
+ npm install -g @arkheia/mcp-server
26
+ ```
27
+
28
+ Get a free API key at [arkheia.ai/mcp/account](https://arkheia.ai/mcp/account), or via the CLI:
29
+
30
+ ```bash
31
+ curl -X POST https://arkheia-proxy-production.up.railway.app/v1/provision \
32
+ -H "Content-Type: application/json" \
33
+ -d '{"email": "you@example.com"}'
34
+ ```
35
+
36
+ Set your key:
37
+
38
+ ```bash
39
+ export ARKHEIA_API_KEY="ak_live_..."
40
+ ```
41
+
42
+ ## Register with your CLI
43
+
44
+ Each AI CLI has a slightly different `mcp add` command. Use the one that matches your tool. All assume you've installed globally with `npm install -g`.
45
+
46
+ ### Claude Code
47
+
48
+ ```bash
49
+ claude mcp add arkheia -s user \
50
+ -e ARKHEIA_API_KEY="$ARKHEIA_API_KEY" \
51
+ -- mcp-server
52
+ ```
53
+
54
+ Config lands in: `~/.claude.json` under `mcpServers.arkheia`
55
+
56
+ ### Codex
57
+
58
+ ```bash
59
+ codex mcp add arkheia \
60
+ --env ARKHEIA_API_KEY="$ARKHEIA_API_KEY" \
61
+ -- mcp-server
62
+ ```
63
+
64
+ Config lands in: `~/.codex/config.toml` under `[mcp_servers.arkheia.env]`
65
+
66
+ Note: `codex login --api-key` is deprecated. Use `printenv OPENAI_API_KEY | codex login --with-api-key` instead.
67
+
68
+ ### Gemini
69
+
70
+ ```bash
71
+ gemini mcp add -s user \
72
+ -e ARKHEIA_API_KEY="$ARKHEIA_API_KEY" \
73
+ arkheia mcp-server
74
+ ```
75
+
76
+ Config lands in: `~/.gemini/settings.json` under `mcpServers.arkheia`
77
+
78
+ **Gotcha:** `gemini mcp list` only shows project-scope servers. If you registered with `-s user`, verify by reading `~/.gemini/settings.json` directly.
79
+
80
+ **Gotcha:** Don't use `npx -y @arkheia/mcp-server` with Gemini — the `-y` flag gets eaten by Gemini's yargs parser as `--yolo`. Use the globally-installed `mcp-server` binary directly.
81
+
82
+ ### Grok
83
+
84
+ ```bash
85
+ grok mcp add arkheia \
86
+ -t stdio \
87
+ -c mcp-server \
88
+ -e ARKHEIA_API_KEY="$ARKHEIA_API_KEY"
89
+ ```
90
+
91
+ Config lands in: `~/.grok/settings.json` under `mcpServers.arkheia` (note: env is nested under `transport`, unlike other CLIs)
92
+
93
+ ## Verify it works
94
+
95
+ ```bash
96
+ # Claude Code — live connection test
97
+ claude mcp list
98
+
99
+ # Codex — shows 'enabled' (not a live check)
100
+ codex mcp list
101
+
102
+ # Grok — best: spawns the server and lists all 9 tools
103
+ grok mcp test arkheia
104
+
105
+ # Gemini — no built-in test; start a session and try the tool
106
+ ```
107
+
108
+ **Important:** MCP registrations are not hot-reloaded. Restart your CLI session after running `mcp add`.
109
+
110
+ ## What You Get
111
+
112
+ | Tool | Description |
113
+ |------|-------------|
114
+ | `arkheia_verify` | Score any model response for fabrication risk (LOW/MEDIUM/HIGH) |
115
+ | `arkheia_audit_log` | Review your detection history |
116
+ | `run_grok` | Call Grok + screen for fabrication |
117
+ | `run_gemini` | Call Gemini + screen for fabrication |
118
+ | `run_ollama` | Call local Ollama model + screen |
119
+ | `run_together` | Call Together AI (Kimi, DeepSeek) + screen |
120
+ | `memory_store` | Persistent knowledge graph — upsert entity |
121
+ | `memory_retrieve` | Knowledge graph lookup |
122
+ | `memory_relate` | Create relationship between entities |
123
+
124
+ ## 35+ Model Profiles
125
+
126
+ GPT-4o, GPT-5.4, Claude Opus/Sonnet/Haiku, Gemini 2.5/3.0, Grok 4, Llama, Mixtral, CodeLlama, Falcon, Phi4, Kimi K2.5, and more. If your model isn't listed, [let us know](mailto:dmurfet@arkheia.ai).
127
+
128
+ ## Pricing
129
+
130
+ | Plan | Price | Detections |
131
+ |------|-------|------------|
132
+ | Free | $0 | 1,500/month |
133
+ | Single Contributor | $99/month | Unlimited |
134
+ | Professional | $499/month | Unlimited |
135
+ | Team | $1,999/month | Unlimited |
136
+
137
+ Manage your account at [arkheia.ai/mcp/account](https://arkheia.ai/mcp/account).
138
+
139
+ ## Where API keys are stored
140
+
141
+ | CLI | Config file | Key location |
142
+ |-----|-------------|-------------|
143
+ | Claude Code | `~/.claude.json` | `mcpServers.arkheia.env.ARKHEIA_API_KEY` |
144
+ | Codex | `~/.codex/config.toml` | `[mcp_servers.arkheia.env]` section |
145
+ | Gemini | `~/.gemini/settings.json` | `mcpServers.arkheia.env.ARKHEIA_API_KEY` |
146
+ | Grok | `~/.grok/settings.json` | `mcpServers.arkheia.transport.env.ARKHEIA_API_KEY` |
147
+
148
+ ## Troubleshooting
149
+
150
+ **"Python 3.10+ is required but not found"** — Install Python 3.12: `brew install python@3.12` (macOS) or download from [python.org](https://python.org).
151
+
152
+ **"No module named pip"** — Your Python installation has broken pip (common with Python 3.14 on macOS). Delete `~/.arkheia/venv` and switch to Python 3.12: `brew install python@3.12`.
153
+
154
+ **Server registered but tools not showing** — Restart your CLI session. MCP registrations are not hot-reloaded.
155
+
156
+ **API key rejected** — Check for trailing whitespace or `\r` characters. If your env file was created on Windows, run `dos2unix` on it. The server will warn about this on startup.
157
+
158
+ ## Full Documentation
159
+
160
+ See the [GitHub repo](https://github.com/arkheiaai/arkheia-mcp) for:
161
+ - Complete setup guide for all agents
162
+ - CLAUDE.md template for automatic detection across projects
163
+ - Multi-agent quorum pattern
164
+ - Test prompts and examples
165
+
166
+ ## Feedback
167
+
168
+ - **GitHub Issues:** https://github.com/arkheiaai/arkheia-mcp/issues
169
+ - **Email:** dmurfet@arkheia.ai
170
+
171
+ Every message is read by the founder.
172
+
173
+ ## Links
174
+
175
+ - Website: https://arkheia.ai
176
+ - MCP Account: https://arkheia.ai/mcp/account
177
+ - GitHub: https://github.com/arkheiaai/arkheia-mcp
package/dist/index.js ADDED
@@ -0,0 +1,263 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
4
+ if (k2 === undefined) k2 = k;
5
+ var desc = Object.getOwnPropertyDescriptor(m, k);
6
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
7
+ desc = { enumerable: true, get: function() { return m[k]; } };
8
+ }
9
+ Object.defineProperty(o, k2, desc);
10
+ }) : (function(o, m, k, k2) {
11
+ if (k2 === undefined) k2 = k;
12
+ o[k2] = m[k];
13
+ }));
14
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
15
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
16
+ }) : function(o, v) {
17
+ o["default"] = v;
18
+ });
19
+ var __importStar = (this && this.__importStar) || (function () {
20
+ var ownKeys = function(o) {
21
+ ownKeys = Object.getOwnPropertyNames || function (o) {
22
+ var ar = [];
23
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
24
+ return ar;
25
+ };
26
+ return ownKeys(o);
27
+ };
28
+ return function (mod) {
29
+ if (mod && mod.__esModule) return mod;
30
+ var result = {};
31
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
32
+ __setModuleDefault(result, mod);
33
+ return result;
34
+ };
35
+ })();
36
+ Object.defineProperty(exports, "__esModule", { value: true });
37
+ const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
38
+ const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
39
+ const zod_1 = require("zod");
40
+ const path = __importStar(require("path"));
41
+ const os = __importStar(require("os"));
42
+ const fs = __importStar(require("fs"));
43
+ const proxy_client_js_1 = require("./proxy-client.js");
44
+ const tool_registry_js_1 = require("./tool-registry.js");
45
+ const providers_js_1 = require("./providers.js");
46
+ const memory_js_1 = require("./memory.js");
47
+ // ---------------------------------------------------------------------------
48
+ // Config Loading
49
+ // ---------------------------------------------------------------------------
50
+ function loadConfig() {
51
+ const configPath = path.join(os.homedir(), '.arkheia', 'config.json');
52
+ if (!fs.existsSync(configPath))
53
+ return;
54
+ try {
55
+ const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
56
+ if (config.api_key && !process.env.ARKHEIA_API_KEY) {
57
+ process.env.ARKHEIA_API_KEY = config.api_key;
58
+ process.stderr.write(`[arkheia] API key loaded from ${configPath}\n`);
59
+ }
60
+ if (config.proxy_url && !process.env.ARKHEIA_HOSTED_URL) {
61
+ process.env.ARKHEIA_HOSTED_URL = config.proxy_url;
62
+ process.stderr.write(`[arkheia] Hosted URL: ${config.proxy_url}\n`);
63
+ }
64
+ }
65
+ catch (e) {
66
+ process.stderr.write(`[arkheia] Warning: Could not read ${configPath}\n`);
67
+ }
68
+ }
69
+ function checkCRLF() {
70
+ for (const k of ['ARKHEIA_API_KEY', 'ARKHEIA_PROXY_URL', 'ARKHEIA_HOSTED_URL']) {
71
+ const v = process.env[k];
72
+ if (v && /[\r\n]/.test(v)) {
73
+ process.stderr.write(`[arkheia] WARNING: ${k} contains whitespace/newline characters. Run 'dos2unix' on your env file.\n`);
74
+ process.env[k] = v.trim();
75
+ }
76
+ }
77
+ }
78
+ // ---------------------------------------------------------------------------
79
+ // Helpers
80
+ // ---------------------------------------------------------------------------
81
+ function wrapResult(result) {
82
+ return { content: [{ type: "text", text: JSON.stringify(result) }] };
83
+ }
84
+ function handleError(toolName, e) {
85
+ if (e instanceof tool_registry_js_1.PolicyViolation) {
86
+ return wrapResult({ error: e.reason, risk_level: "UNKNOWN" });
87
+ }
88
+ process.stderr.write(`[arkheia] ${toolName} error: ${e.message}\n`);
89
+ return wrapResult({ error: e.message, risk_level: "UNKNOWN" });
90
+ }
91
+ // ---------------------------------------------------------------------------
92
+ // Main
93
+ // ---------------------------------------------------------------------------
94
+ const CURRENT_VERSION = "1.2.2";
95
+ async function checkForUpdate() {
96
+ // Check once per day — skip if checked recently
97
+ const markerPath = path.join(os.homedir(), '.arkheia', '.update-check');
98
+ try {
99
+ if (fs.existsSync(markerPath)) {
100
+ const age = Date.now() - fs.statSync(markerPath).mtimeMs;
101
+ if (age < 24 * 60 * 60 * 1000)
102
+ return; // checked within 24h
103
+ }
104
+ }
105
+ catch { }
106
+ try {
107
+ const resp = await fetch('https://registry.npmjs.org/@arkheia/mcp-server/latest', {
108
+ signal: AbortSignal.timeout(5000),
109
+ });
110
+ if (resp.ok) {
111
+ const data = await resp.json();
112
+ if (data.version && data.version !== CURRENT_VERSION) {
113
+ process.stderr.write(`[arkheia] Update available: ${CURRENT_VERSION} → ${data.version}\n` +
114
+ `[arkheia] Run: npm update -g @arkheia/mcp-server\n`);
115
+ }
116
+ }
117
+ // Touch marker regardless of result
118
+ const dir = path.dirname(markerPath);
119
+ if (!fs.existsSync(dir))
120
+ fs.mkdirSync(dir, { recursive: true });
121
+ fs.writeFileSync(markerPath, new Date().toISOString());
122
+ }
123
+ catch {
124
+ // Network failure — silently skip, don't block startup
125
+ }
126
+ }
127
+ async function main() {
128
+ // --setup flag: install protocol + register MCP with all detected CLIs, then exit
129
+ if (process.argv.includes('--setup')) {
130
+ const { execSync } = await import('child_process');
131
+ const setupScript = path.join(__dirname, '..', 'scripts', 'setup-claude.js');
132
+ execSync(`node "${setupScript}"`, { stdio: 'inherit', env: process.env });
133
+ process.exit(0);
134
+ }
135
+ loadConfig();
136
+ checkCRLF();
137
+ // Opt-in only: the check writes ~/.arkheia/.update-check, and a default run must change nothing in the user's
138
+ // home (B-288, Codex R1). Set ARKHEIA_UPDATE_CHECK=1 to enable it.
139
+ if (process.env.ARKHEIA_UPDATE_CHECK === "1")
140
+ checkForUpdate(); // fire-and-forget, never blocks startup
141
+ const ARKHEIA_PROXY_URL = process.env.ARKHEIA_PROXY_URL || "http://localhost:8098";
142
+ const ARKHEIA_HOSTED_URL = process.env.ARKHEIA_HOSTED_URL || "https://arkheia-proxy-production.up.railway.app";
143
+ const ARKHEIA_API_KEY = process.env.ARKHEIA_API_KEY;
144
+ if (!ARKHEIA_API_KEY) {
145
+ process.stderr.write("[arkheia] Warning: ARKHEIA_API_KEY not set.\n" +
146
+ "Get a free API key at https://arkheia.ai/mcp\n" +
147
+ "Then set: export ARKHEIA_API_KEY=ak_live_...\n\n");
148
+ }
149
+ const proxy = new proxy_client_js_1.ProxyClient(ARKHEIA_PROXY_URL, 10.0, ARKHEIA_HOSTED_URL, ARKHEIA_API_KEY);
150
+ const server = new mcp_js_1.McpServer({ name: "arkheia-trust", version: "1.2.2" });
151
+ // ── Detection & audit ──────────────────────────────────────────
152
+ server.tool("arkheia_verify", "Verify whether an AI response shows signs of fabrication. Call this on EVERY model response before acting on it. Risk guidance: HIGH = warn the user this response may be fabricated and include the detection_id, but still show them the response with the warning. MEDIUM = show with a brief confidence note. LOW = show normally. Never hide or suppress a response — always surface it to the user with the appropriate risk context.", { prompt: zod_1.z.string(), response: zod_1.z.string(), model: zod_1.z.string() }, async ({ prompt, response, model }) => {
153
+ try {
154
+ (0, tool_registry_js_1.check)("arkheia_verify");
155
+ const result = await proxy.verify(prompt, response, model);
156
+ return wrapResult(result);
157
+ }
158
+ catch (e) {
159
+ return handleError("arkheia_verify", e);
160
+ }
161
+ });
162
+ server.tool("arkheia_audit_log", "Retrieve structured audit evidence for compliance review.", { session_id: zod_1.z.string().optional(), limit: zod_1.z.number().int().min(1).max(500).default(50) }, async ({ session_id, limit }) => {
163
+ try {
164
+ (0, tool_registry_js_1.check)("arkheia_audit_log");
165
+ const result = await proxy.get_audit_log(session_id, Math.min(limit, 500));
166
+ return wrapResult(result);
167
+ }
168
+ catch (e) {
169
+ return handleError("arkheia_audit_log", e);
170
+ }
171
+ });
172
+ // ── Provider wrappers ──────────────────────────────────────────
173
+ server.tool("run_grok", "Call xAI Grok and screen the response through Arkheia for fabrication.", { prompt: zod_1.z.string(), model: zod_1.z.string().default("grok-4-fast-non-reasoning") }, async ({ prompt, model }) => {
174
+ try {
175
+ (0, tool_registry_js_1.check)("run_grok");
176
+ const pr = await (0, providers_js_1.call_grok)(prompt, model);
177
+ if (pr.error)
178
+ return wrapResult({ ...pr, arkheia: { risk_level: "UNKNOWN", error: pr.error } });
179
+ const risk = await proxy.verify(prompt, pr.response, model);
180
+ return wrapResult({ ...pr, arkheia: risk });
181
+ }
182
+ catch (e) {
183
+ return handleError("run_grok", e);
184
+ }
185
+ });
186
+ server.tool("run_gemini", "Call Google Gemini and screen the response through Arkheia for fabrication.", { prompt: zod_1.z.string(), model: zod_1.z.string().default("gemini-2.5-flash") }, async ({ prompt, model }) => {
187
+ try {
188
+ (0, tool_registry_js_1.check)("run_gemini");
189
+ const pr = await (0, providers_js_1.call_gemini)(prompt, model);
190
+ if (pr.error)
191
+ return wrapResult({ ...pr, arkheia: { risk_level: "UNKNOWN", error: pr.error } });
192
+ const risk = await proxy.verify(prompt, pr.response, model);
193
+ return wrapResult({ ...pr, arkheia: risk });
194
+ }
195
+ catch (e) {
196
+ return handleError("run_gemini", e);
197
+ }
198
+ });
199
+ server.tool("run_ollama", "Call a local Ollama model and screen the response through Arkheia. No network egress.", { prompt: zod_1.z.string(), model: zod_1.z.string().default("phi4:14b") }, async ({ prompt, model }) => {
200
+ try {
201
+ (0, tool_registry_js_1.check)("run_ollama");
202
+ const pr = await (0, providers_js_1.call_ollama)(prompt, model);
203
+ if (pr.error)
204
+ return wrapResult({ ...pr, arkheia: { risk_level: "UNKNOWN", error: pr.error } });
205
+ const risk = await proxy.verify(prompt, pr.response, model);
206
+ return wrapResult({ ...pr, arkheia: risk });
207
+ }
208
+ catch (e) {
209
+ return handleError("run_ollama", e);
210
+ }
211
+ });
212
+ server.tool("run_together", "Call Together AI (Kimi K2.5, DeepSeek, etc.) and screen the response through Arkheia.", { prompt: zod_1.z.string(), model: zod_1.z.string().default("moonshotai/Kimi-K2.5") }, async ({ prompt, model }) => {
213
+ try {
214
+ (0, tool_registry_js_1.check)("run_together");
215
+ const pr = await (0, providers_js_1.call_together)(prompt, model);
216
+ if (pr.error)
217
+ return wrapResult({ ...pr, arkheia: { risk_level: "UNKNOWN", error: pr.error } });
218
+ const risk = await proxy.verify(prompt, pr.response, model);
219
+ return wrapResult({ ...pr, arkheia: risk });
220
+ }
221
+ catch (e) {
222
+ return handleError("run_together", e);
223
+ }
224
+ });
225
+ // ── Memory / Knowledge Graph ───────────────────────────────────
226
+ server.tool("memory_store", "Store an entity and its observations in the persistent knowledge graph. Entities are upserted by name+type.", { name: zod_1.z.string(), entity_type: zod_1.z.string(), observations: zod_1.z.array(zod_1.z.string()) }, async ({ name, entity_type, observations }) => {
227
+ try {
228
+ (0, tool_registry_js_1.check)("memory_store");
229
+ const result = await (0, memory_js_1.store_entity)(name, entity_type, observations);
230
+ return wrapResult(result);
231
+ }
232
+ catch (e) {
233
+ return handleError("memory_store", e);
234
+ }
235
+ });
236
+ server.tool("memory_retrieve", "Search entities in the persistent knowledge graph by name (case-insensitive).", { query: zod_1.z.string(), entity_type: zod_1.z.string().optional(), limit: zod_1.z.number().int().min(1).max(50).default(10) }, async ({ query, entity_type, limit }) => {
237
+ try {
238
+ (0, tool_registry_js_1.check)("memory_retrieve");
239
+ const result = await (0, memory_js_1.retrieve_entities)(query, entity_type, Math.min(limit, 50));
240
+ return wrapResult(result);
241
+ }
242
+ catch (e) {
243
+ return handleError("memory_retrieve", e);
244
+ }
245
+ });
246
+ server.tool("memory_relate", "Store a named relationship between two entities in the knowledge graph.", { from_entity: zod_1.z.string(), relation_type: zod_1.z.string(), to_entity: zod_1.z.string() }, async ({ from_entity, relation_type, to_entity }) => {
247
+ try {
248
+ (0, tool_registry_js_1.check)("memory_relate");
249
+ const result = await (0, memory_js_1.store_relation)(from_entity, relation_type, to_entity);
250
+ return wrapResult(result);
251
+ }
252
+ catch (e) {
253
+ return handleError("memory_relate", e);
254
+ }
255
+ });
256
+ // ── Start ──────────────────────────────────────────────────────
257
+ const transport = new stdio_js_1.StdioServerTransport();
258
+ await server.connect(transport);
259
+ }
260
+ main().catch((err) => {
261
+ process.stderr.write(`[arkheia] Fatal error: ${err}\n`);
262
+ process.exit(1);
263
+ });