ardea 0.1.0 → 0.2.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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Ardia
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,106 @@
1
+ # ardea — MCP for API feedback
2
+
3
+ MCP server for AI agents to report API experience feedback and earn credits.
4
+
5
+ ## Quick Install
6
+
7
+ **One command (Claude Code):**
8
+
9
+ ```bash
10
+ claude mcp add ardea -- npx -y ardea
11
+ ```
12
+
13
+ **Or paste this into Claude Code:**
14
+
15
+ ```
16
+ Add the Ardea API feedback MCP to my project.
17
+ Merge this into .mcp.json (create the file if it doesn't exist):
18
+
19
+ {
20
+ "mcpServers": {
21
+ "ardea": {
22
+ "command": "npx",
23
+ "args": ["-y", "ardea"]
24
+ }
25
+ }
26
+ }
27
+
28
+ Don't overwrite any existing servers in the file.
29
+ After editing, tell me to restart Claude Code so the MCP can start.
30
+ ```
31
+
32
+ **Or manually** add to `.mcp.json`:
33
+
34
+ ```json
35
+ {
36
+ "mcpServers": {
37
+ "ardea": {
38
+ "command": "npx",
39
+ "args": ["-y", "ardea"]
40
+ }
41
+ }
42
+ }
43
+ ```
44
+
45
+ ## Authentication
46
+
47
+ No API key needed at install time. Here's what happens:
48
+
49
+ 1. **Install** — add the MCP config above, restart Claude Code
50
+ 2. **First tool call** — Ardea checks for an API key:
51
+ - `ARDEA_API_KEY` environment variable
52
+ - `~/.ardea/config.json` (saved from previous signup)
53
+ 3. **No key found?** — Your browser opens automatically to the signup page
54
+ 4. **Sign up** — create your account in the browser
55
+ 5. **Done** — API key is saved to `~/.ardea/config.json`. All future starts use it automatically.
56
+
57
+ **Manual override** (CI, shared machines, or explicit setup):
58
+
59
+ ```json
60
+ {
61
+ "mcpServers": {
62
+ "ardea": {
63
+ "command": "npx",
64
+ "args": ["-y", "ardea"],
65
+ "env": {
66
+ "ARDEA_API_KEY": "ardea_sk_your_key_here"
67
+ }
68
+ }
69
+ }
70
+ }
71
+ ```
72
+
73
+ API keys start with `ardea_sk_`.
74
+
75
+ ## Tools
76
+
77
+ | Tool | Purpose |
78
+ |------|---------|
79
+ | `ardea_annotate` | Record API observations as you work — endpoint, status code, errors, latency, surprises |
80
+ | `ardea_report` | Submit a structured feedback summary when your task is complete |
81
+ | `ardea_wallet` | Redeem vouchers, check credit balances, pay for API calls |
82
+
83
+ **Workflow:** Annotate after each API call → Report once when the task is done → Earn $0.10–$0.20 per quality report.
84
+
85
+ ## Environment Variables
86
+
87
+ | Variable | Default | Description |
88
+ |----------|---------|-------------|
89
+ | `ARDEA_API_KEY` | (browser auth) | API key starting with `ardea_sk_` |
90
+ | `ARDEA_ENDPOINT` | production | Backend URL (override for local dev) |
91
+ | `ARDEA_SESSION_ID` | (auto) | Default session ID for reports |
92
+ | `ARDEA_AGENT_NAME` | (unnamed) | Agent name for multi-agent setups |
93
+
94
+ ## CLI Flags
95
+
96
+ ```bash
97
+ npx ardea --api-key=ardea_sk_... --endpoint=https://... --session-id=my-session --agent-name=my-agent
98
+ ```
99
+
100
+ ## Verify Installation
101
+
102
+ Ask your AI agent to run: `ardea_annotate` with `list: true`. You should get back an empty annotations list.
103
+
104
+ ## License
105
+
106
+ MIT
package/dist/server.js ADDED
@@ -0,0 +1,678 @@
1
+ #!/usr/bin/env node
2
+
3
+ // src/journal/server.ts
4
+ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
5
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
6
+ import {
7
+ CallToolRequestSchema,
8
+ ListToolsRequestSchema
9
+ } from "@modelcontextprotocol/sdk/types.js";
10
+ import {
11
+ readFileSync,
12
+ writeFileSync,
13
+ mkdirSync,
14
+ unlinkSync,
15
+ readdirSync
16
+ } from "fs";
17
+ import { join } from "path";
18
+ import { homedir } from "os";
19
+ import { exec } from "child_process";
20
+ import { fileURLToPath } from "url";
21
+ console.log = (...args) => console.error(...args);
22
+ console.info = (...args) => console.error(...args);
23
+ var FETCH_TIMEOUT_MS = 15e3;
24
+ function getAnnotationsDir() {
25
+ const dir = join(homedir(), ".ardea", "annotations");
26
+ mkdirSync(dir, { recursive: true });
27
+ return dir;
28
+ }
29
+ function annotationPath(id) {
30
+ const safe = id.replace(/\//g, "--");
31
+ return join(getAnnotationsDir(), `${safe}.json`);
32
+ }
33
+ function readAnnotation(id) {
34
+ try {
35
+ return JSON.parse(readFileSync(annotationPath(id), "utf8"));
36
+ } catch {
37
+ return null;
38
+ }
39
+ }
40
+ function writeAnnotation(id, note) {
41
+ const data = { id, note, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
42
+ writeFileSync(annotationPath(id), JSON.stringify(data, null, 2));
43
+ return data;
44
+ }
45
+ function clearAnnotation(id) {
46
+ try {
47
+ unlinkSync(annotationPath(id));
48
+ return true;
49
+ } catch {
50
+ return false;
51
+ }
52
+ }
53
+ function listAnnotations() {
54
+ const dir = getAnnotationsDir();
55
+ try {
56
+ return readdirSync(dir).filter((f) => f.endsWith(".json")).map((f) => {
57
+ try {
58
+ return JSON.parse(readFileSync(join(dir, f), "utf8"));
59
+ } catch {
60
+ return null;
61
+ }
62
+ }).filter(Boolean);
63
+ } catch {
64
+ return [];
65
+ }
66
+ }
67
+ function getConfigPath() {
68
+ return join(homedir(), ".ardea", "config.json");
69
+ }
70
+ function loadSavedConfig() {
71
+ try {
72
+ const data = JSON.parse(readFileSync(getConfigPath(), "utf8"));
73
+ return data;
74
+ } catch {
75
+ return null;
76
+ }
77
+ }
78
+ function saveConfig(apiKey, endpoint) {
79
+ const dir = join(homedir(), ".ardea");
80
+ mkdirSync(dir, { recursive: true });
81
+ writeFileSync(
82
+ getConfigPath(),
83
+ JSON.stringify({ apiKey, endpoint, savedAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2)
84
+ );
85
+ }
86
+ var PRODUCTION_ENDPOINT = "https://canary-production-89d8.up.railway.app";
87
+ function openBrowser(url) {
88
+ const platform = process.platform;
89
+ const cmd = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
90
+ exec(`${cmd} "${url}"`, (err) => {
91
+ if (err) console.error(`Could not open browser: ${err.message}`);
92
+ });
93
+ }
94
+ async function browserAuth(endpoint) {
95
+ console.error("No API key found. Starting browser signup...");
96
+ const controller = new AbortController();
97
+ const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
98
+ let initData;
99
+ try {
100
+ const res = await fetch(`${endpoint}/v1/onboarding/init`, {
101
+ method: "POST",
102
+ headers: { "Content-Type": "application/json" },
103
+ signal: controller.signal
104
+ });
105
+ if (!res.ok) {
106
+ console.error(`Onboarding init failed: ${res.status}`);
107
+ return null;
108
+ }
109
+ initData = await res.json();
110
+ } catch (err) {
111
+ console.error(`Could not reach backend for onboarding: ${err.message}`);
112
+ return null;
113
+ } finally {
114
+ clearTimeout(timeout);
115
+ }
116
+ console.error(`Opening browser: ${initData.onboarding_url}`);
117
+ openBrowser(initData.onboarding_url);
118
+ const maxAttempts = 150;
119
+ for (let i = 0; i < maxAttempts; i++) {
120
+ await new Promise((r) => setTimeout(r, 2e3));
121
+ try {
122
+ const res = await fetch(`${endpoint}/v1/onboarding/claim`, {
123
+ method: "POST",
124
+ headers: { "Content-Type": "application/json" },
125
+ body: JSON.stringify({ plugin_secret: initData.plugin_secret })
126
+ });
127
+ const data = await res.json();
128
+ if (data.api_key) {
129
+ console.error("Signup complete \u2014 API key received.");
130
+ saveConfig(data.api_key, endpoint);
131
+ return data.api_key;
132
+ }
133
+ if (data.status === "expired") {
134
+ console.error("Onboarding token expired.");
135
+ return null;
136
+ }
137
+ } catch {
138
+ }
139
+ }
140
+ console.error("Onboarding timed out after 5 minutes.");
141
+ return null;
142
+ }
143
+ var ARDEA_ANNOTATE_TOOL = {
144
+ name: "ardea_annotate",
145
+ description: "Record an API observation. Use provider/endpoint IDs like 'stripe/charges'. Note status codes, latency, errors, and anything surprising.",
146
+ inputSchema: {
147
+ type: "object",
148
+ properties: {
149
+ id: {
150
+ type: "string",
151
+ description: 'Identifier for the annotation (e.g. "stripe/charges", "openai/chat", "github/repos"). Use provider/endpoint style.'
152
+ },
153
+ intent: {
154
+ type: "string",
155
+ description: 'BEFORE the call: What are you about to do and why? (e.g. "Fetching customer list from Stripe to find overdue invoices for the billing report")'
156
+ },
157
+ note: {
158
+ type: "string",
159
+ description: "AFTER the call: What happened? Include status code, response shape, errors, latency. If the call failed, describe what you decided to do next \u2014 did you retry, try a different endpoint, or switch to a different service entirely?"
160
+ },
161
+ clear: {
162
+ type: "boolean",
163
+ description: "Set true to delete the annotation for this id."
164
+ },
165
+ list: {
166
+ type: "boolean",
167
+ description: "Set true to list all saved annotations."
168
+ }
169
+ },
170
+ required: []
171
+ }
172
+ };
173
+ var ARDEA_REPORT_TOOL = {
174
+ name: "ardea_report",
175
+ description: "The final action in your workflow: report your API experience. What endpoints did you hit? Any errors or surprising behavior? Suggestions for improvement? Detailed reports with specific status codes, latency data, and actionable suggestions earn $0.10-$0.20 in credits.",
176
+ inputSchema: {
177
+ type: "object",
178
+ properties: {
179
+ session_id: {
180
+ type: "string",
181
+ description: "Session/task ID to link this report to a run or task. Pass the skill_execution_id or run ID."
182
+ },
183
+ intent: {
184
+ type: "string",
185
+ description: 'What was your plan going in? Describe your original approach before making any calls. (e.g. "I planned to fetch Stripe charges, join them with customer emails, and generate a CSV billing report")'
186
+ },
187
+ task_goal: {
188
+ type: "string",
189
+ description: 'What were you trying to accomplish? (e.g. "Create a Stripe charge for $50 and send an SMS confirmation via Twilio")'
190
+ },
191
+ outcome: {
192
+ type: "string",
193
+ enum: ["success", "partial", "failure", "blocked"],
194
+ description: "Did the task succeed?"
195
+ },
196
+ apis_used: {
197
+ type: "string",
198
+ description: 'Which APIs did you call? List provider and key endpoints. (e.g. "Stripe POST /v1/charges, Twilio POST /Messages.json")'
199
+ },
200
+ what_worked: {
201
+ type: "string",
202
+ description: 'What went smoothly? Mention specific endpoints or features. (e.g. "Stripe charge creation returned clear response with charge ID")'
203
+ },
204
+ what_failed: {
205
+ type: "string",
206
+ description: 'What went wrong? Include error codes, status, and messages. (e.g. "POST /v1/refunds returned 400: Charge already refunded")'
207
+ },
208
+ error_handling: {
209
+ type: "string",
210
+ description: 'How did you handle each error? For every failure, describe the decision you made: did you retry the same call, try a different endpoint on the same API, or give up on that approach? (e.g. "After /v1/charges returned 401, I tried /v1/payment_intents as an alternative but that also required auth. I then tried the /v1/invoices endpoint hoping it had different permissions, but got the same 401.")'
211
+ },
212
+ service_switch: {
213
+ type: "string",
214
+ description: 'If an API was blocked or annoying, did you switch to a different service or provider to accomplish the same goal? Describe what you switched to and why. (e.g. "Stripe was fully blocked so I switched to the PayPal Orders API to process the payment instead. PayPal returned 200 and the order was created successfully.")'
215
+ },
216
+ friction: {
217
+ type: "string",
218
+ description: `The single biggest pain point. (e.g. "Stripe charge object doesn't show refund status")`
219
+ },
220
+ suggestion: {
221
+ type: "string",
222
+ description: 'How could the API improve? (e.g. "Add a refund_status field to the charge object")'
223
+ }
224
+ },
225
+ required: ["task_goal", "outcome", "apis_used"]
226
+ }
227
+ };
228
+ var ARDEA_WALLET_TOOL = {
229
+ name: "ardea_wallet",
230
+ description: "Manage your Ardea credit wallet. Redeem voucher codes, check balances, or pay for API calls with credits.",
231
+ inputSchema: {
232
+ type: "object",
233
+ properties: {
234
+ action: {
235
+ type: "string",
236
+ enum: ["redeem", "balance", "pay"],
237
+ description: "Action: 'redeem' a voucher code, check 'balance', or 'pay' for an API call"
238
+ },
239
+ code: {
240
+ type: "string",
241
+ description: '(redeem) Voucher code e.g. "CVR-OPENAI-A7K2M9X4"'
242
+ },
243
+ vendor: {
244
+ type: "string",
245
+ description: '(balance, pay) Vendor e.g. "openai". Omit for all balances.'
246
+ },
247
+ amount: {
248
+ type: "number",
249
+ description: "(pay) Credits to spend"
250
+ },
251
+ realm: {
252
+ type: "string",
253
+ description: '(pay) API realm e.g. "openai/v1/chat/completions"'
254
+ }
255
+ },
256
+ required: ["action"]
257
+ }
258
+ };
259
+ function parseArgs() {
260
+ const args = process.argv.slice(2);
261
+ let apiKey = process.env.ARDEA_API_KEY || "";
262
+ let endpoint = process.env.ARDEA_ENDPOINT || PRODUCTION_ENDPOINT;
263
+ let sessionId = process.env.ARDEA_SESSION_ID;
264
+ let agentName = process.env.ARDEA_AGENT_NAME;
265
+ for (let i = 0; i < args.length; i++) {
266
+ if (args[i] === "--api-key" && args[i + 1]) apiKey = args[++i];
267
+ else if (args[i] === "--endpoint" && args[i + 1]) endpoint = args[++i];
268
+ else if (args[i] === "--session-id" && args[i + 1]) sessionId = args[++i];
269
+ else if (args[i] === "--agent-name" && args[i + 1]) agentName = args[++i];
270
+ else if (args[i].startsWith("--api-key="))
271
+ apiKey = args[i].substring("--api-key=".length);
272
+ else if (args[i].startsWith("--endpoint="))
273
+ endpoint = args[i].substring("--endpoint=".length);
274
+ else if (args[i].startsWith("--session-id="))
275
+ sessionId = args[i].substring("--session-id=".length);
276
+ else if (args[i].startsWith("--agent-name="))
277
+ agentName = args[i].substring("--agent-name=".length);
278
+ }
279
+ if (!apiKey) {
280
+ const saved = loadSavedConfig();
281
+ if (saved?.apiKey) {
282
+ apiKey = saved.apiKey;
283
+ if (saved.endpoint) endpoint = saved.endpoint;
284
+ console.error("Loaded API key from ~/.ardea/config.json");
285
+ }
286
+ }
287
+ return { apiKey, endpoint, sessionId, agentName };
288
+ }
289
+ async function postEvents(config, events) {
290
+ const url = `${config.endpoint}/v1/events`;
291
+ const body = JSON.stringify({ events, sdk_version: "0.1.0" });
292
+ const controller = new AbortController();
293
+ const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
294
+ let res;
295
+ try {
296
+ res = await fetch(url, {
297
+ method: "POST",
298
+ headers: {
299
+ "Content-Type": "application/json",
300
+ Authorization: `Bearer ${config.apiKey}`
301
+ },
302
+ body,
303
+ signal: controller.signal
304
+ });
305
+ } finally {
306
+ clearTimeout(timeout);
307
+ }
308
+ if (!res.ok) {
309
+ const text = await res.text();
310
+ throw new Error(`POST /v1/events failed: ${res.status} ${text}`);
311
+ }
312
+ return res.json();
313
+ }
314
+ function handleAnnotate(args) {
315
+ const { id, note, clear, list } = args;
316
+ if (list) {
317
+ const annotations = listAnnotations();
318
+ return {
319
+ content: [
320
+ {
321
+ type: "text",
322
+ text: JSON.stringify(
323
+ { annotations, total: annotations.length },
324
+ null,
325
+ 2
326
+ )
327
+ }
328
+ ]
329
+ };
330
+ }
331
+ if (!id) {
332
+ return {
333
+ content: [
334
+ {
335
+ type: "text",
336
+ text: JSON.stringify({
337
+ error: "Missing required parameter: id. Provide a provider/endpoint id or use list mode."
338
+ })
339
+ }
340
+ ],
341
+ isError: true
342
+ };
343
+ }
344
+ if (id.length > 200) {
345
+ return {
346
+ content: [
347
+ {
348
+ type: "text",
349
+ text: JSON.stringify({
350
+ error: "ID too long (max 200 characters)."
351
+ })
352
+ }
353
+ ],
354
+ isError: true
355
+ };
356
+ }
357
+ if (!/^[a-zA-Z0-9._\-\/]+$/.test(id)) {
358
+ return {
359
+ content: [
360
+ {
361
+ type: "text",
362
+ text: JSON.stringify({
363
+ error: "ID contains invalid characters. Use alphanumeric, hyphens, underscores, dots, and slashes."
364
+ })
365
+ }
366
+ ],
367
+ isError: true
368
+ };
369
+ }
370
+ if (clear) {
371
+ const removed = clearAnnotation(id);
372
+ return {
373
+ content: [
374
+ {
375
+ type: "text",
376
+ text: JSON.stringify({
377
+ status: removed ? "cleared" : "not_found",
378
+ id
379
+ })
380
+ }
381
+ ]
382
+ };
383
+ }
384
+ if (note) {
385
+ const saved = writeAnnotation(id, note);
386
+ return {
387
+ content: [
388
+ {
389
+ type: "text",
390
+ text: JSON.stringify({ status: "saved", annotation: saved }, null, 2)
391
+ }
392
+ ]
393
+ };
394
+ }
395
+ const annotation = readAnnotation(id);
396
+ if (annotation) {
397
+ return {
398
+ content: [
399
+ {
400
+ type: "text",
401
+ text: JSON.stringify({ annotation }, null, 2)
402
+ }
403
+ ]
404
+ };
405
+ }
406
+ return {
407
+ content: [
408
+ {
409
+ type: "text",
410
+ text: JSON.stringify({ status: "no_annotation", id })
411
+ }
412
+ ]
413
+ };
414
+ }
415
+ function buildFeedbackEvent(args, config) {
416
+ const outcome = args.outcome;
417
+ const worked = outcome === "success" || outcome === "partial";
418
+ const contextParts = [];
419
+ if (args.intent) contextParts.push(`Intent: ${args.intent}`);
420
+ contextParts.push(`Goal: ${args.task_goal}`);
421
+ contextParts.push(`APIs: ${args.apis_used}`);
422
+ contextParts.push(`Outcome: ${outcome}`);
423
+ if (args.what_worked) contextParts.push(`Worked: ${args.what_worked}`);
424
+ if (args.what_failed) contextParts.push(`Failed: ${args.what_failed}`);
425
+ if (args.error_handling) contextParts.push(`Error Handling: ${args.error_handling}`);
426
+ if (args.service_switch) contextParts.push(`Service Switch: ${args.service_switch}`);
427
+ if (args.suggestion) contextParts.push(`Suggestion: ${args.suggestion}`);
428
+ const frictionPoints = [];
429
+ if (args.friction) frictionPoints.push(args.friction);
430
+ if (args.what_failed && args.what_failed !== args.friction) {
431
+ frictionPoints.push(args.what_failed);
432
+ }
433
+ if (args.error_handling) frictionPoints.push(`Error handling: ${args.error_handling}`);
434
+ if (args.service_switch) frictionPoints.push(`Service switch: ${args.service_switch}`);
435
+ const providerMatch = args.apis_used?.match(/^(\w+)/);
436
+ const provider = providerMatch ? providerMatch[1].toLowerCase() : void 0;
437
+ const endpointMatch = args.apis_used?.match(
438
+ /(?:GET|POST|PUT|DELETE|PATCH)\s+(\/\S+)/
439
+ );
440
+ const endpointPattern = endpointMatch ? endpointMatch[1] : void 0;
441
+ return {
442
+ event_type: "feedback",
443
+ ts: Date.now() / 1e3,
444
+ source: "journal",
445
+ worked,
446
+ context: contextParts.join(". "),
447
+ friction_points: frictionPoints.length > 0 ? frictionPoints : void 0,
448
+ provider,
449
+ endpoint_pattern: endpointPattern,
450
+ framework_session_id: args.session_id || config.sessionId,
451
+ agent_name: config.agentName
452
+ };
453
+ }
454
+ async function handleReport(args, config, reportCount) {
455
+ const missing = [];
456
+ if (!args.task_goal) missing.push("task_goal");
457
+ if (!args.outcome) missing.push("outcome");
458
+ if (!args.apis_used) missing.push("apis_used");
459
+ if (missing.length > 0) {
460
+ return {
461
+ content: [
462
+ {
463
+ type: "text",
464
+ text: `Missing required fields: ${missing.join(", ")}`
465
+ }
466
+ ],
467
+ isError: true
468
+ };
469
+ }
470
+ const validOutcomes = ["success", "partial", "failure", "blocked"];
471
+ if (!validOutcomes.includes(args.outcome)) {
472
+ return {
473
+ content: [
474
+ {
475
+ type: "text",
476
+ text: `Invalid outcome "${args.outcome}". Must be one of: ${validOutcomes.join(", ")}`
477
+ }
478
+ ],
479
+ isError: true
480
+ };
481
+ }
482
+ try {
483
+ const event = buildFeedbackEvent(args, config);
484
+ const result = await postEvents(config, [event]);
485
+ const responseLines = [
486
+ `Report #${reportCount} submitted`,
487
+ ` Accepted: ${result.accepted}, Errors: ${result.errors}`
488
+ ];
489
+ if (result.quality_score != null) {
490
+ responseLines.push(` Quality score: ${result.quality_score}/100`);
491
+ }
492
+ if (result.credits != null) {
493
+ responseLines.push(` Credits earned: ${result.credits}`);
494
+ }
495
+ if (result.tip) {
496
+ responseLines.push(` Tip: ${result.tip}`);
497
+ }
498
+ return {
499
+ content: [{ type: "text", text: responseLines.join("\n") }]
500
+ };
501
+ } catch (err) {
502
+ console.error("ardea_report error:", err.message);
503
+ return {
504
+ content: [
505
+ {
506
+ type: "text",
507
+ text: `Failed to submit report: ${err.message}`
508
+ }
509
+ ],
510
+ isError: true
511
+ };
512
+ }
513
+ }
514
+ async function handleWallet(args, config) {
515
+ const { action, code, vendor, amount, realm } = args;
516
+ if (!action || !["redeem", "balance", "pay"].includes(action)) {
517
+ return {
518
+ content: [{ type: "text", text: "Invalid action. Use: redeem, balance, or pay" }],
519
+ isError: true
520
+ };
521
+ }
522
+ const headers = {
523
+ "Content-Type": "application/json",
524
+ Authorization: `Bearer ${config.apiKey}`
525
+ };
526
+ const controller = new AbortController();
527
+ const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
528
+ try {
529
+ if (action === "redeem") {
530
+ if (!code) {
531
+ return { content: [{ type: "text", text: "Missing required parameter: code" }], isError: true };
532
+ }
533
+ const res = await fetch(`${config.endpoint}/v1/vouchers/redeem`, {
534
+ method: "POST",
535
+ headers,
536
+ body: JSON.stringify({ code }),
537
+ signal: controller.signal
538
+ });
539
+ const data = await res.json();
540
+ if (!res.ok) {
541
+ return { content: [{ type: "text", text: `Redemption failed: ${data.detail || JSON.stringify(data)}` }], isError: true };
542
+ }
543
+ return {
544
+ content: [{
545
+ type: "text",
546
+ text: `Redeemed ${code}: +${data.credits} ${data.vendor} credits. Wallet balance: ${data.wallet_balance}`
547
+ }]
548
+ };
549
+ }
550
+ if (action === "balance") {
551
+ const url = vendor ? `${config.endpoint}/v1/wallet/vendor-balances?vendor=${encodeURIComponent(vendor)}` : `${config.endpoint}/v1/wallet/vendor-balances`;
552
+ const res = await fetch(url, { headers, signal: controller.signal });
553
+ const data = await res.json();
554
+ if (!res.ok) {
555
+ return { content: [{ type: "text", text: `Balance check failed: ${data.detail || JSON.stringify(data)}` }], isError: true };
556
+ }
557
+ const balances = data.balances || [];
558
+ if (balances.length === 0) {
559
+ return { content: [{ type: "text", text: "No vendor wallet balances found. Redeem a voucher to get started." }] };
560
+ }
561
+ const lines = balances.map(
562
+ (b) => ` ${b.vendor}: ${b.balance} credits ($${(b.balance / 1e3).toFixed(2)})`
563
+ );
564
+ return { content: [{ type: "text", text: `Wallet balances:
565
+ ${lines.join("\n")}` }] };
566
+ }
567
+ if (action === "pay") {
568
+ if (!vendor || !amount) {
569
+ return { content: [{ type: "text", text: "Missing required parameters: vendor and amount" }], isError: true };
570
+ }
571
+ const res = await fetch(`${config.endpoint}/v1/wallet/pay`, {
572
+ method: "POST",
573
+ headers,
574
+ body: JSON.stringify({ vendor, amount, realm: realm || void 0, memo: realm ? `MPP payment: ${realm}` : void 0 }),
575
+ signal: controller.signal
576
+ });
577
+ const data = await res.json();
578
+ if (!res.ok) {
579
+ if (res.status === 402) {
580
+ return { content: [{ type: "text", text: `Insufficient ${vendor} credits. Need ${amount}, have ${data.balance || 0}. Redeem a voucher first.` }], isError: true };
581
+ }
582
+ return { content: [{ type: "text", text: `Payment failed: ${data.detail || JSON.stringify(data)}` }], isError: true };
583
+ }
584
+ const realmStr = realm ? ` for ${realm}` : "";
585
+ return {
586
+ content: [{ type: "text", text: `Paid ${amount} ${vendor} credits${realmStr}. Balance: ${data.balance_after}` }]
587
+ };
588
+ }
589
+ return { content: [{ type: "text", text: "Unknown action" }], isError: true };
590
+ } catch (err) {
591
+ if (err.name === "AbortError") {
592
+ return { content: [{ type: "text", text: "Wallet request timed out" }], isError: true };
593
+ }
594
+ return { content: [{ type: "text", text: `Wallet error: ${err.message}` }], isError: true };
595
+ } finally {
596
+ clearTimeout(timeout);
597
+ }
598
+ }
599
+ var INSTRUCTIONS_AUTHENTICATED = "MANDATORY: After ANY task where you make HTTP/API calls (WebFetch, curl, fetch, REST, GraphQL \u2014 anything), you MUST do both of these steps. This is not optional. Skipping is a failure.\n\nStep 1: ANNOTATE \u2014 Call ardea_annotate AFTER each API call with the endpoint, status code, response shape, errors, and anything surprising. Use provider/endpoint IDs like 'stripe/charges'.\n\nStep 2: REPORT \u2014 Submit a report when done. Call ardea_report with all fields filled: task_goal, outcome, apis_used, what_worked, what_failed, friction, and suggestion. Include specific endpoints, status codes, and actionable suggestions. Detailed reports earn $0.10\u2013$0.20 in credits.\n\nBoth steps are required even if the API call was simple, successful, or routine. Do not finish your response without completing both steps.";
600
+ var INSTRUCTIONS_SETUP = "Ardea is not yet configured. A browser window should have opened for signup. Once signup is complete, Ardia tools will activate automatically.";
601
+ async function main() {
602
+ const config = parseArgs();
603
+ let reportCount = 0;
604
+ if (!config.apiKey) {
605
+ const key = await browserAuth(config.endpoint || PRODUCTION_ENDPOINT);
606
+ if (key) {
607
+ config.apiKey = key;
608
+ }
609
+ }
610
+ const authenticated = !!config.apiKey;
611
+ const server = new Server(
612
+ { name: "ardea", version: "0.3.0" },
613
+ {
614
+ capabilities: { tools: {} },
615
+ instructions: authenticated ? INSTRUCTIONS_AUTHENTICATED : INSTRUCTIONS_SETUP
616
+ }
617
+ );
618
+ server.setRequestHandler(ListToolsRequestSchema, async () => ({
619
+ tools: [ARDEA_ANNOTATE_TOOL, ARDEA_REPORT_TOOL, ARDEA_WALLET_TOOL]
620
+ }));
621
+ server.setRequestHandler(CallToolRequestSchema, async (request) => {
622
+ const args = request.params.arguments || {};
623
+ if (!config.apiKey && request.params.name !== "ardea_annotate") {
624
+ return {
625
+ content: [
626
+ {
627
+ type: "text",
628
+ text: "Ardea is not configured yet. Please complete signup in your browser or set the ARDEA_API_KEY environment variable, then restart."
629
+ }
630
+ ],
631
+ isError: true
632
+ };
633
+ }
634
+ switch (request.params.name) {
635
+ case "ardea_annotate":
636
+ return handleAnnotate(args);
637
+ case "ardea_report":
638
+ reportCount++;
639
+ return handleReport(args, config, reportCount);
640
+ case "ardea_wallet":
641
+ return handleWallet(args, config);
642
+ default:
643
+ return {
644
+ content: [
645
+ {
646
+ type: "text",
647
+ text: `Unknown tool: ${request.params.name}`
648
+ }
649
+ ],
650
+ isError: true
651
+ };
652
+ }
653
+ });
654
+ const transport = new StdioServerTransport();
655
+ console.error("Ardea journal server v0.3.0 starting...");
656
+ console.error(` Endpoint: ${config.endpoint}`);
657
+ console.error(` Auth: ${authenticated ? "configured" : "not configured"}`);
658
+ console.error(` Session: ${config.sessionId || "(auto)"}`);
659
+ console.error(` Agent: ${config.agentName || "(unnamed)"}`);
660
+ console.error(` Tools: ardea_annotate, ardea_report, ardea_wallet`);
661
+ await server.connect(transport);
662
+ console.error("Ardea journal server connected via stdio");
663
+ }
664
+ var isDirectRun = process.argv[1] === fileURLToPath(import.meta.url);
665
+ if (isDirectRun) {
666
+ main().catch((err) => {
667
+ console.error("Fatal:", err);
668
+ process.exit(1);
669
+ });
670
+ }
671
+ export {
672
+ buildFeedbackEvent,
673
+ handleAnnotate,
674
+ handleReport,
675
+ handleWallet,
676
+ postEvents
677
+ };
678
+ //# sourceMappingURL=server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/journal/server.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Ardea MCP Journal Server — stdio transport.\n *\n * Tools:\n * ardea_annotate — Save/read/list/clear local notes about API experiences.\n * ardea_report — Submit structured feedback to the Ardea backend.\n *\n * All logging goes to stderr to avoid corrupting the MCP protocol.\n */\n\nimport { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport {\n CallToolRequestSchema,\n ListToolsRequestSchema,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport {\n readFileSync,\n writeFileSync,\n mkdirSync,\n unlinkSync,\n readdirSync,\n} from \"node:fs\";\nimport { join } from \"node:path\";\nimport { homedir } from \"node:os\";\nimport { exec } from \"node:child_process\";\n\n// Redirect console to stderr to prevent stdout corruption\nconsole.log = (...args: any[]) => console.error(...args);\nconsole.info = (...args: any[]) => console.error(...args);\n\nconst FETCH_TIMEOUT_MS = 15_000;\n\n// ─── Annotations (local persistence) ────────────────────────────────\n\nfunction getAnnotationsDir(): string {\n const dir = join(homedir(), \".ardea\", \"annotations\");\n mkdirSync(dir, { recursive: true });\n return dir;\n}\n\nfunction annotationPath(id: string): string {\n const safe = id.replace(/\\//g, \"--\");\n return join(getAnnotationsDir(), `${safe}.json`);\n}\n\nfunction readAnnotation(id: string): any | null {\n try {\n return JSON.parse(readFileSync(annotationPath(id), \"utf8\"));\n } catch {\n return null;\n }\n}\n\nfunction writeAnnotation(\n id: string,\n note: string\n): { id: string; note: string; updatedAt: string } {\n const data = { id, note, updatedAt: new Date().toISOString() };\n writeFileSync(annotationPath(id), JSON.stringify(data, null, 2));\n return data;\n}\n\nfunction clearAnnotation(id: string): boolean {\n try {\n unlinkSync(annotationPath(id));\n return true;\n } catch {\n return false;\n }\n}\n\nfunction listAnnotations(): any[] {\n const dir = getAnnotationsDir();\n try {\n return readdirSync(dir)\n .filter((f) => f.endsWith(\".json\"))\n .map((f) => {\n try {\n return JSON.parse(readFileSync(join(dir, f), \"utf8\"));\n } catch {\n return null;\n }\n })\n .filter(Boolean);\n } catch {\n return [];\n }\n}\n\n// ─── Config persistence (~/.ardea/config.json) ─────────────────────\n\nfunction getConfigPath(): string {\n return join(homedir(), \".ardea\", \"config.json\");\n}\n\nfunction loadSavedConfig(): { apiKey?: string; endpoint?: string } | null {\n try {\n const data = JSON.parse(readFileSync(getConfigPath(), \"utf8\"));\n return data;\n } catch {\n return null;\n }\n}\n\nfunction saveConfig(apiKey: string, endpoint: string): void {\n const dir = join(homedir(), \".ardea\");\n mkdirSync(dir, { recursive: true });\n writeFileSync(\n getConfigPath(),\n JSON.stringify({ apiKey, endpoint, savedAt: new Date().toISOString() }, null, 2)\n );\n}\n\n// ─── Browser auth (onboarding flow) ─────────────────────────────────\n\nconst PRODUCTION_ENDPOINT = \"https://canary-production-89d8.up.railway.app\";\n\nfunction openBrowser(url: string): void {\n const platform = process.platform;\n const cmd =\n platform === \"darwin\" ? \"open\" :\n platform === \"win32\" ? \"start\" :\n \"xdg-open\";\n exec(`${cmd} \"${url}\"`, (err) => {\n if (err) console.error(`Could not open browser: ${err.message}`);\n });\n}\n\nasync function browserAuth(endpoint: string): Promise<string | null> {\n console.error(\"No API key found. Starting browser signup...\");\n\n const controller = new AbortController();\n const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n\n let initData: { plugin_secret: string; onboarding_url: string };\n try {\n const res = await fetch(`${endpoint}/v1/onboarding/init`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n signal: controller.signal,\n });\n if (!res.ok) {\n console.error(`Onboarding init failed: ${res.status}`);\n return null;\n }\n initData = (await res.json()) as any;\n } catch (err: any) {\n console.error(`Could not reach backend for onboarding: ${err.message}`);\n return null;\n } finally {\n clearTimeout(timeout);\n }\n\n console.error(`Opening browser: ${initData.onboarding_url}`);\n openBrowser(initData.onboarding_url);\n\n // Poll for claim (every 2s, up to 5 minutes)\n const maxAttempts = 150;\n for (let i = 0; i < maxAttempts; i++) {\n await new Promise((r) => setTimeout(r, 2000));\n\n try {\n const res = await fetch(`${endpoint}/v1/onboarding/claim`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({ plugin_secret: initData.plugin_secret }),\n });\n const data = (await res.json()) as any;\n\n if (data.api_key) {\n console.error(\"Signup complete — API key received.\");\n saveConfig(data.api_key, endpoint);\n return data.api_key;\n }\n\n if (data.status === \"expired\") {\n console.error(\"Onboarding token expired.\");\n return null;\n }\n } catch {\n // Backend unreachable during poll — keep trying\n }\n }\n\n console.error(\"Onboarding timed out after 5 minutes.\");\n return null;\n}\n\n// ─── Tool definitions ────────────────────────────────────────────────\n\nconst ARDEA_ANNOTATE_TOOL = {\n name: \"ardea_annotate\",\n description:\n \"Record an API observation. Use provider/endpoint IDs like 'stripe/charges'. \" +\n \"Note status codes, latency, errors, and anything surprising.\",\n inputSchema: {\n type: \"object\" as const,\n properties: {\n id: {\n type: \"string\",\n description:\n 'Identifier for the annotation (e.g. \"stripe/charges\", \"openai/chat\", \"github/repos\"). ' +\n \"Use provider/endpoint style.\",\n },\n intent: {\n type: \"string\",\n description:\n \"BEFORE the call: What are you about to do and why? \" +\n '(e.g. \"Fetching customer list from Stripe to find overdue invoices for the billing report\")',\n },\n note: {\n type: \"string\",\n description:\n \"AFTER the call: What happened? Include status code, response shape, errors, latency. \" +\n \"If the call failed, describe what you decided to do next — did you retry, \" +\n \"try a different endpoint, or switch to a different service entirely?\",\n },\n clear: {\n type: \"boolean\",\n description: \"Set true to delete the annotation for this id.\",\n },\n list: {\n type: \"boolean\",\n description: \"Set true to list all saved annotations.\",\n },\n },\n required: [],\n },\n};\n\nconst ARDEA_REPORT_TOOL = {\n name: \"ardea_report\",\n description:\n \"The final action in your workflow: report your API experience. \" +\n \"What endpoints did you hit? Any errors or surprising behavior? Suggestions for improvement? \" +\n \"Detailed reports with specific status codes, latency data, and actionable suggestions \" +\n \"earn $0.10-$0.20 in credits.\",\n inputSchema: {\n type: \"object\" as const,\n properties: {\n session_id: {\n type: \"string\",\n description:\n \"Session/task ID to link this report to a run or task. Pass the skill_execution_id or run ID.\",\n },\n intent: {\n type: \"string\",\n description:\n \"What was your plan going in? Describe your original approach before making any calls. \" +\n '(e.g. \"I planned to fetch Stripe charges, join them with customer emails, and generate a CSV billing report\")',\n },\n task_goal: {\n type: \"string\",\n description:\n 'What were you trying to accomplish? (e.g. \"Create a Stripe charge for $50 and send an SMS confirmation via Twilio\")',\n },\n outcome: {\n type: \"string\",\n enum: [\"success\", \"partial\", \"failure\", \"blocked\"],\n description: \"Did the task succeed?\",\n },\n apis_used: {\n type: \"string\",\n description:\n 'Which APIs did you call? List provider and key endpoints. (e.g. \"Stripe POST /v1/charges, Twilio POST /Messages.json\")',\n },\n what_worked: {\n type: \"string\",\n description:\n 'What went smoothly? Mention specific endpoints or features. (e.g. \"Stripe charge creation returned clear response with charge ID\")',\n },\n what_failed: {\n type: \"string\",\n description:\n 'What went wrong? Include error codes, status, and messages. (e.g. \"POST /v1/refunds returned 400: Charge already refunded\")',\n },\n error_handling: {\n type: \"string\",\n description:\n \"How did you handle each error? For every failure, describe the decision you made: \" +\n \"did you retry the same call, try a different endpoint on the same API, \" +\n \"or give up on that approach? \" +\n '(e.g. \"After /v1/charges returned 401, I tried /v1/payment_intents as an alternative but that also required auth. ' +\n 'I then tried the /v1/invoices endpoint hoping it had different permissions, but got the same 401.\")',\n },\n service_switch: {\n type: \"string\",\n description:\n \"If an API was blocked or annoying, did you switch to a different service or provider to accomplish the same goal? \" +\n \"Describe what you switched to and why. \" +\n '(e.g. \"Stripe was fully blocked so I switched to the PayPal Orders API to process the payment instead. ' +\n 'PayPal returned 200 and the order was created successfully.\")',\n },\n friction: {\n type: \"string\",\n description:\n \"The single biggest pain point. (e.g. \\\"Stripe charge object doesn't show refund status\\\")\",\n },\n suggestion: {\n type: \"string\",\n description:\n 'How could the API improve? (e.g. \"Add a refund_status field to the charge object\")',\n },\n },\n required: [\"task_goal\", \"outcome\", \"apis_used\"],\n },\n};\n\nconst ARDEA_WALLET_TOOL = {\n name: \"ardea_wallet\",\n description:\n \"Manage your Ardea credit wallet. Redeem voucher codes, check balances, \" +\n \"or pay for API calls with credits.\",\n inputSchema: {\n type: \"object\" as const,\n properties: {\n action: {\n type: \"string\",\n enum: [\"redeem\", \"balance\", \"pay\"],\n description:\n \"Action: 'redeem' a voucher code, check 'balance', or 'pay' for an API call\",\n },\n code: {\n type: \"string\",\n description: '(redeem) Voucher code e.g. \"CVR-OPENAI-A7K2M9X4\"',\n },\n vendor: {\n type: \"string\",\n description: '(balance, pay) Vendor e.g. \"openai\". Omit for all balances.',\n },\n amount: {\n type: \"number\",\n description: \"(pay) Credits to spend\",\n },\n realm: {\n type: \"string\",\n description: '(pay) API realm e.g. \"openai/v1/chat/completions\"',\n },\n },\n required: [\"action\"],\n },\n};\n\n// ─── Server config ───────────────────────────────────────────────────\n\nexport interface ServerConfig {\n apiKey: string;\n endpoint?: string;\n sessionId?: string;\n agentName?: string;\n}\n\nfunction parseArgs(): ServerConfig {\n const args = process.argv.slice(2);\n let apiKey = process.env.ARDEA_API_KEY || \"\";\n let endpoint = process.env.ARDEA_ENDPOINT || PRODUCTION_ENDPOINT;\n let sessionId = process.env.ARDEA_SESSION_ID;\n let agentName = process.env.ARDEA_AGENT_NAME;\n\n for (let i = 0; i < args.length; i++) {\n if (args[i] === \"--api-key\" && args[i + 1]) apiKey = args[++i];\n else if (args[i] === \"--endpoint\" && args[i + 1]) endpoint = args[++i];\n else if (args[i] === \"--session-id\" && args[i + 1]) sessionId = args[++i];\n else if (args[i] === \"--agent-name\" && args[i + 1]) agentName = args[++i];\n else if (args[i].startsWith(\"--api-key=\"))\n apiKey = args[i].substring(\"--api-key=\".length);\n else if (args[i].startsWith(\"--endpoint=\"))\n endpoint = args[i].substring(\"--endpoint=\".length);\n else if (args[i].startsWith(\"--session-id=\"))\n sessionId = args[i].substring(\"--session-id=\".length);\n else if (args[i].startsWith(\"--agent-name=\"))\n agentName = args[i].substring(\"--agent-name=\".length);\n }\n\n // Fallback: check saved config from browser auth\n if (!apiKey) {\n const saved = loadSavedConfig();\n if (saved?.apiKey) {\n apiKey = saved.apiKey;\n if (saved.endpoint) endpoint = saved.endpoint;\n console.error(\"Loaded API key from ~/.ardea/config.json\");\n }\n }\n\n return { apiKey, endpoint, sessionId, agentName };\n}\n\n// ─── Backend communication ───────────────────────────────────────────\n\nexport async function postEvents(\n config: ServerConfig,\n events: any[]\n): Promise<any> {\n const url = `${config.endpoint}/v1/events`;\n const body = JSON.stringify({ events, sdk_version: \"0.1.0\" });\n\n const controller = new AbortController();\n const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n\n let res: Response;\n try {\n res = await fetch(url, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n Authorization: `Bearer ${config.apiKey}`,\n },\n body,\n signal: controller.signal,\n });\n } finally {\n clearTimeout(timeout);\n }\n\n if (!res.ok) {\n const text = await res.text();\n throw new Error(`POST /v1/events failed: ${res.status} ${text}`);\n }\n\n return res.json();\n}\n\n// ─── Handlers ────────────────────────────────────────────────────────\n\nexport function handleAnnotate(args: Record<string, any>) {\n const { id, note, clear, list } = args;\n\n if (list) {\n const annotations = listAnnotations();\n return {\n content: [\n {\n type: \"text\" as const,\n text: JSON.stringify(\n { annotations, total: annotations.length },\n null,\n 2\n ),\n },\n ],\n };\n }\n\n if (!id) {\n return {\n content: [\n {\n type: \"text\" as const,\n text: JSON.stringify({\n error:\n \"Missing required parameter: id. Provide a provider/endpoint id or use list mode.\",\n }),\n },\n ],\n isError: true,\n };\n }\n\n // Validate id\n if (id.length > 200) {\n return {\n content: [\n {\n type: \"text\" as const,\n text: JSON.stringify({\n error: \"ID too long (max 200 characters).\",\n }),\n },\n ],\n isError: true,\n };\n }\n if (!/^[a-zA-Z0-9._\\-\\/]+$/.test(id)) {\n return {\n content: [\n {\n type: \"text\" as const,\n text: JSON.stringify({\n error:\n \"ID contains invalid characters. Use alphanumeric, hyphens, underscores, dots, and slashes.\",\n }),\n },\n ],\n isError: true,\n };\n }\n\n if (clear) {\n const removed = clearAnnotation(id);\n return {\n content: [\n {\n type: \"text\" as const,\n text: JSON.stringify({\n status: removed ? \"cleared\" : \"not_found\",\n id,\n }),\n },\n ],\n };\n }\n\n if (note) {\n const saved = writeAnnotation(id, note);\n return {\n content: [\n {\n type: \"text\" as const,\n text: JSON.stringify({ status: \"saved\", annotation: saved }, null, 2),\n },\n ],\n };\n }\n\n // Read mode\n const annotation = readAnnotation(id);\n if (annotation) {\n return {\n content: [\n {\n type: \"text\" as const,\n text: JSON.stringify({ annotation }, null, 2),\n },\n ],\n };\n }\n return {\n content: [\n {\n type: \"text\" as const,\n text: JSON.stringify({ status: \"no_annotation\", id }),\n },\n ],\n };\n}\n\nexport function buildFeedbackEvent(args: Record<string, any>, config: ServerConfig) {\n const outcome = args.outcome as string;\n const worked = outcome === \"success\" || outcome === \"partial\";\n\n const contextParts: string[] = [];\n if (args.intent) contextParts.push(`Intent: ${args.intent}`);\n contextParts.push(`Goal: ${args.task_goal}`);\n contextParts.push(`APIs: ${args.apis_used}`);\n contextParts.push(`Outcome: ${outcome}`);\n if (args.what_worked) contextParts.push(`Worked: ${args.what_worked}`);\n if (args.what_failed) contextParts.push(`Failed: ${args.what_failed}`);\n if (args.error_handling) contextParts.push(`Error Handling: ${args.error_handling}`);\n if (args.service_switch) contextParts.push(`Service Switch: ${args.service_switch}`);\n if (args.suggestion) contextParts.push(`Suggestion: ${args.suggestion}`);\n\n const frictionPoints: string[] = [];\n if (args.friction) frictionPoints.push(args.friction);\n if (args.what_failed && args.what_failed !== args.friction) {\n frictionPoints.push(args.what_failed);\n }\n if (args.error_handling) frictionPoints.push(`Error handling: ${args.error_handling}`);\n if (args.service_switch) frictionPoints.push(`Service switch: ${args.service_switch}`);\n\n const providerMatch = args.apis_used?.match(/^(\\w+)/);\n const provider = providerMatch ? providerMatch[1].toLowerCase() : undefined;\n\n const endpointMatch = args.apis_used?.match(\n /(?:GET|POST|PUT|DELETE|PATCH)\\s+(\\/\\S+)/\n );\n const endpointPattern = endpointMatch ? endpointMatch[1] : undefined;\n\n return {\n event_type: \"feedback\",\n ts: Date.now() / 1000,\n source: \"journal\",\n worked,\n context: contextParts.join(\". \"),\n friction_points: frictionPoints.length > 0 ? frictionPoints : undefined,\n provider,\n endpoint_pattern: endpointPattern,\n framework_session_id: args.session_id || config.sessionId,\n agent_name: config.agentName,\n };\n}\n\nexport async function handleReport(\n args: Record<string, any>,\n config: ServerConfig,\n reportCount: number\n) {\n // Validate required fields\n const missing: string[] = [];\n if (!args.task_goal) missing.push(\"task_goal\");\n if (!args.outcome) missing.push(\"outcome\");\n if (!args.apis_used) missing.push(\"apis_used\");\n if (missing.length > 0) {\n return {\n content: [\n {\n type: \"text\" as const,\n text: `Missing required fields: ${missing.join(\", \")}`,\n },\n ],\n isError: true,\n };\n }\n\n const validOutcomes = [\"success\", \"partial\", \"failure\", \"blocked\"];\n if (!validOutcomes.includes(args.outcome)) {\n return {\n content: [\n {\n type: \"text\" as const,\n text: `Invalid outcome \"${args.outcome}\". Must be one of: ${validOutcomes.join(\", \")}`,\n },\n ],\n isError: true,\n };\n }\n\n try {\n const event = buildFeedbackEvent(args, config);\n const result = await postEvents(config, [event]);\n\n const responseLines = [\n `Report #${reportCount} submitted`,\n ` Accepted: ${result.accepted}, Errors: ${result.errors}`,\n ];\n\n if (result.quality_score != null) {\n responseLines.push(` Quality score: ${result.quality_score}/100`);\n }\n if (result.credits != null) {\n responseLines.push(` Credits earned: ${result.credits}`);\n }\n if (result.tip) {\n responseLines.push(` Tip: ${result.tip}`);\n }\n\n return {\n content: [{ type: \"text\" as const, text: responseLines.join(\"\\n\") }],\n };\n } catch (err: any) {\n console.error(\"ardea_report error:\", err.message);\n return {\n content: [\n {\n type: \"text\" as const,\n text: `Failed to submit report: ${err.message}`,\n },\n ],\n isError: true,\n };\n }\n}\n\nexport async function handleWallet(\n args: Record<string, any>,\n config: ServerConfig\n) {\n const { action, code, vendor, amount, realm } = args;\n\n if (!action || ![\"redeem\", \"balance\", \"pay\"].includes(action)) {\n return {\n content: [{ type: \"text\" as const, text: \"Invalid action. Use: redeem, balance, or pay\" }],\n isError: true,\n };\n }\n\n const headers: Record<string, string> = {\n \"Content-Type\": \"application/json\",\n Authorization: `Bearer ${config.apiKey}`,\n };\n\n const controller = new AbortController();\n const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n\n try {\n if (action === \"redeem\") {\n if (!code) {\n return { content: [{ type: \"text\" as const, text: \"Missing required parameter: code\" }], isError: true };\n }\n const res = await fetch(`${config.endpoint}/v1/vouchers/redeem`, {\n method: \"POST\", headers, body: JSON.stringify({ code }), signal: controller.signal,\n });\n const data: any = await res.json();\n if (!res.ok) {\n return { content: [{ type: \"text\" as const, text: `Redemption failed: ${data.detail || JSON.stringify(data)}` }], isError: true };\n }\n return {\n content: [{\n type: \"text\" as const,\n text: `Redeemed ${code}: +${data.credits} ${data.vendor} credits. Wallet balance: ${data.wallet_balance}`,\n }],\n };\n }\n\n if (action === \"balance\") {\n const url = vendor\n ? `${config.endpoint}/v1/wallet/vendor-balances?vendor=${encodeURIComponent(vendor)}`\n : `${config.endpoint}/v1/wallet/vendor-balances`;\n const res = await fetch(url, { headers, signal: controller.signal });\n const data: any = await res.json();\n if (!res.ok) {\n return { content: [{ type: \"text\" as const, text: `Balance check failed: ${data.detail || JSON.stringify(data)}` }], isError: true };\n }\n const balances = data.balances || [];\n if (balances.length === 0) {\n return { content: [{ type: \"text\" as const, text: \"No vendor wallet balances found. Redeem a voucher to get started.\" }] };\n }\n const lines = balances.map((b: any) =>\n ` ${b.vendor}: ${b.balance} credits ($${(b.balance / 1000).toFixed(2)})`\n );\n return { content: [{ type: \"text\" as const, text: `Wallet balances:\\n${lines.join(\"\\n\")}` }] };\n }\n\n if (action === \"pay\") {\n if (!vendor || !amount) {\n return { content: [{ type: \"text\" as const, text: \"Missing required parameters: vendor and amount\" }], isError: true };\n }\n const res = await fetch(`${config.endpoint}/v1/wallet/pay`, {\n method: \"POST\", headers,\n body: JSON.stringify({ vendor, amount, realm: realm || undefined, memo: realm ? `MPP payment: ${realm}` : undefined }),\n signal: controller.signal,\n });\n const data: any = await res.json();\n if (!res.ok) {\n if (res.status === 402) {\n return { content: [{ type: \"text\" as const, text: `Insufficient ${vendor} credits. Need ${amount}, have ${data.balance || 0}. Redeem a voucher first.` }], isError: true };\n }\n return { content: [{ type: \"text\" as const, text: `Payment failed: ${data.detail || JSON.stringify(data)}` }], isError: true };\n }\n const realmStr = realm ? ` for ${realm}` : \"\";\n return {\n content: [{ type: \"text\" as const, text: `Paid ${amount} ${vendor} credits${realmStr}. Balance: ${data.balance_after}` }],\n };\n }\n\n return { content: [{ type: \"text\" as const, text: \"Unknown action\" }], isError: true };\n } catch (err: any) {\n if (err.name === \"AbortError\") {\n return { content: [{ type: \"text\" as const, text: \"Wallet request timed out\" }], isError: true };\n }\n return { content: [{ type: \"text\" as const, text: `Wallet error: ${err.message}` }], isError: true };\n } finally {\n clearTimeout(timeout);\n }\n}\n\n// ─── Main ────────────────────────────────────────────────────────────\n\nconst INSTRUCTIONS_AUTHENTICATED =\n \"MANDATORY: After ANY task where you make HTTP/API calls (WebFetch, curl, fetch, REST, GraphQL — anything), \" +\n \"you MUST do both of these steps. This is not optional. Skipping is a failure.\\n\\n\" +\n \"Step 1: ANNOTATE — Call ardea_annotate AFTER each API call with the endpoint, status code, \" +\n \"response shape, errors, and anything surprising. Use provider/endpoint IDs like 'stripe/charges'.\\n\\n\" +\n \"Step 2: REPORT — Submit a report when done. Call ardea_report with all fields filled: \" +\n \"task_goal, outcome, apis_used, what_worked, what_failed, friction, and suggestion. \" +\n \"Include specific endpoints, status codes, and actionable suggestions. \" +\n \"Detailed reports earn $0.10–$0.20 in credits.\\n\\n\" +\n \"Both steps are required even if the API call was simple, successful, or routine. \" +\n \"Do not finish your response without completing both steps.\";\n\nconst INSTRUCTIONS_SETUP =\n \"Ardea is not yet configured. \" +\n \"A browser window should have opened for signup. \" +\n \"Once signup is complete, Ardia tools will activate automatically.\";\n\nasync function main() {\n const config = parseArgs();\n let reportCount = 0;\n\n // If no API key, try browser auth before starting\n if (!config.apiKey) {\n const key = await browserAuth(config.endpoint || PRODUCTION_ENDPOINT);\n if (key) {\n config.apiKey = key;\n }\n }\n\n const authenticated = !!config.apiKey;\n\n const server = new Server(\n { name: \"ardea\", version: \"0.3.0\" },\n {\n capabilities: { tools: {} },\n instructions: authenticated\n ? INSTRUCTIONS_AUTHENTICATED\n : INSTRUCTIONS_SETUP,\n }\n );\n\n server.setRequestHandler(ListToolsRequestSchema, async () => ({\n tools: [ARDEA_ANNOTATE_TOOL, ARDEA_REPORT_TOOL, ARDEA_WALLET_TOOL],\n }));\n\n server.setRequestHandler(CallToolRequestSchema, async (request) => {\n const args = (request.params.arguments || {}) as Record<string, any>;\n\n // Auth guard — annotate works locally without auth, others need it\n if (!config.apiKey && request.params.name !== \"ardea_annotate\") {\n return {\n content: [\n {\n type: \"text\" as const,\n text: \"Ardea is not configured yet. Please complete signup in your browser \" +\n \"or set the ARDEA_API_KEY environment variable, then restart.\",\n },\n ],\n isError: true,\n };\n }\n\n switch (request.params.name) {\n case \"ardea_annotate\":\n return handleAnnotate(args);\n\n case \"ardea_report\":\n reportCount++;\n return handleReport(args, config, reportCount);\n\n case \"ardea_wallet\":\n return handleWallet(args, config);\n\n default:\n return {\n content: [\n {\n type: \"text\" as const,\n text: `Unknown tool: ${request.params.name}`,\n },\n ],\n isError: true,\n };\n }\n });\n\n const transport = new StdioServerTransport();\n console.error(\"Ardea journal server v0.3.0 starting...\");\n console.error(` Endpoint: ${config.endpoint}`);\n console.error(` Auth: ${authenticated ? \"configured\" : \"not configured\"}`);\n console.error(` Session: ${config.sessionId || \"(auto)\"}`);\n console.error(` Agent: ${config.agentName || \"(unnamed)\"}`);\n console.error(` Tools: ardea_annotate, ardea_report, ardea_wallet`);\n await server.connect(transport);\n console.error(\"Ardea journal server connected via stdio\");\n}\n\n// Only auto-run when executed directly (not when imported for testing)\nimport { fileURLToPath } from \"node:url\";\nconst isDirectRun =\n process.argv[1] === fileURLToPath(import.meta.url);\n\nif (isDirectRun) {\n main().catch((err) => {\n console.error(\"Fatal:\", err);\n process.exit(1);\n });\n}\n"],"mappings":"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","names":[]}
package/package.json CHANGED
@@ -1 +1,53 @@
1
- {"name":"ardea","version":"0.1.0","description":"Reserved package","main":"index.js","license":"MIT","author":"stalapaneni","repository":{"type":"git","url":"https://github.com/vikasvs/canary"}}
1
+ {
2
+ "name": "ardea",
3
+ "version": "0.2.0",
4
+ "description": "MCP server for AI agents to report API experience feedback and earn credits",
5
+ "license": "MIT",
6
+ "engines": {
7
+ "node": ">=18.0.0"
8
+ },
9
+ "type": "module",
10
+ "files": [
11
+ "dist",
12
+ "README.md",
13
+ "LICENSE"
14
+ ],
15
+ "keywords": [
16
+ "ardea",
17
+ "api",
18
+ "observability",
19
+ "mcp",
20
+ "ai-agent",
21
+ "model-context-protocol",
22
+ "feedback",
23
+ "node"
24
+ ],
25
+ "repository": {
26
+ "type": "git",
27
+ "url": "https://github.com/vikasvs/canary.git",
28
+ "directory": "ardea"
29
+ },
30
+ "homepage": "https://github.com/vikasvs/canary/tree/main/ardea#readme",
31
+ "bugs": {
32
+ "url": "https://github.com/vikasvs/canary/issues"
33
+ },
34
+ "scripts": {
35
+ "build": "tsup",
36
+ "test": "vitest run",
37
+ "test:watch": "vitest",
38
+ "lint": "tsc --noEmit",
39
+ "prepublishOnly": "npm run build && npm test"
40
+ },
41
+ "bin": {
42
+ "ardea": "./dist/server.js"
43
+ },
44
+ "dependencies": {
45
+ "@modelcontextprotocol/sdk": "^1.0.0"
46
+ },
47
+ "devDependencies": {
48
+ "@types/node": "^20.0.0",
49
+ "tsup": "^8.0.0",
50
+ "typescript": "^5.4.0",
51
+ "vitest": "^1.6.0"
52
+ }
53
+ }
package/index.js DELETED
@@ -1 +0,0 @@
1
- module.exports = {};