ardea 0.1.0 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ardia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# ardea — MCP for API feedback
+
+MCP server for AI agents to report API experience feedback and earn credits.
+
+## Quick Install
+
+**One command (Claude Code):**
+
+```bash
+claude mcp add ardea -- npx -y ardea
+```
+
+**Or paste this into Claude Code:**
+
+```
+Add the Ardea API feedback MCP to my project.
+Merge this into .mcp.json (create the file if it doesn't exist):
+
+{
+  "mcpServers": {
+    "ardea": {
+      "command": "npx",
+      "args": ["-y", "ardea"]
+    }
+  }
+}
+
+Don't overwrite any existing servers in the file.
+After editing, tell me to restart Claude Code so the MCP can start.
+```
+
+**Or manually** add to `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "ardea": {
+      "command": "npx",
+      "args": ["-y", "ardea"]
+    }
+  }
+}
+```
+
+## Authentication
+
+No API key needed at install time. Here's what happens:
+
+1. **Install** — add the MCP config above, restart Claude Code
+2. **First tool call** — Ardea checks for an API key:
+   - `ARDEA_API_KEY` environment variable
+   - `~/.ardea/config.json` (saved from previous signup)
+3. **No key found?** — Your browser opens automatically to the signup page
+4. **Sign up** — create your account in the browser
+5. **Done** — API key is saved to `~/.ardea/config.json`. All future starts use it automatically.
+
+**Manual override** (CI, shared machines, or explicit setup):
+
+```json
+{
+  "mcpServers": {
+    "ardea": {
+      "command": "npx",
+      "args": ["-y", "ardea"],
+      "env": {
+        "ARDEA_API_KEY": "ardea_sk_your_key_here"
+      }
+    }
+  }
+}
+```
+
+API keys start with `ardea_sk_`.
+
+## Tools
+
+| Tool | Purpose |
+|------|---------|
+| `ardea_annotate` | Record API observations as you work — endpoint, status code, errors, latency, surprises |
+| `ardea_report` | Submit a structured feedback summary when your task is complete |
+| `ardea_wallet` | Redeem vouchers, check credit balances, pay for API calls |
+
+**Workflow:** Annotate after each API call → Report once when the task is done → Earn $0.10–$0.20 per quality report.
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `ARDEA_API_KEY` | (browser auth) | API key starting with `ardea_sk_` |
+| `ARDEA_ENDPOINT` | production | Backend URL (override for local dev) |
+| `ARDEA_SESSION_ID` | (auto) | Default session ID for reports |
+| `ARDEA_AGENT_NAME` | (unnamed) | Agent name for multi-agent setups |
+
+## CLI Flags
+
+```bash
+npx ardea --api-key=ardea_sk_... --endpoint=https://... --session-id=my-session --agent-name=my-agent
+```
+
+## Verify Installation
+
+Ask your AI agent to run: `ardea_annotate` with `list: true`. You should get back an empty annotations list.
+
+## License
+
+MIT

package/dist/server.js

@@ -0,0 +1,687 @@
+#!/usr/bin/env node
+
+// src/journal/server.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+import {
+  readFileSync,
+  writeFileSync,
+  mkdirSync,
+  unlinkSync,
+  readdirSync
+} from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { exec } from "child_process";
+import { fileURLToPath } from "url";
+import { realpathSync } from "fs";
+console.log = (...args) => console.error(...args);
+console.info = (...args) => console.error(...args);
+var FETCH_TIMEOUT_MS = 15e3;
+function getAnnotationsDir() {
+  const dir = join(homedir(), ".ardea", "annotations");
+  mkdirSync(dir, { recursive: true });
+  return dir;
+}
+function annotationPath(id) {
+  const safe = id.replace(/\//g, "--");
+  return join(getAnnotationsDir(), `${safe}.json`);
+}
+function readAnnotation(id) {
+  try {
+    return JSON.parse(readFileSync(annotationPath(id), "utf8"));
+  } catch {
+    return null;
+  }
+}
+function writeAnnotation(id, note) {
+  const data = { id, note, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
+  writeFileSync(annotationPath(id), JSON.stringify(data, null, 2));
+  return data;
+}
+function clearAnnotation(id) {
+  try {
+    unlinkSync(annotationPath(id));
+    return true;
+  } catch {
+    return false;
+  }
+}
+function listAnnotations() {
+  const dir = getAnnotationsDir();
+  try {
+    return readdirSync(dir).filter((f) => f.endsWith(".json")).map((f) => {
+      try {
+        return JSON.parse(readFileSync(join(dir, f), "utf8"));
+      } catch {
+        return null;
+      }
+    }).filter(Boolean);
+  } catch {
+    return [];
+  }
+}
+function getConfigPath() {
+  return join(homedir(), ".ardea", "config.json");
+}
+function loadSavedConfig() {
+  try {
+    const data = JSON.parse(readFileSync(getConfigPath(), "utf8"));
+    return data;
+  } catch {
+    return null;
+  }
+}
+function saveConfig(apiKey, endpoint) {
+  const dir = join(homedir(), ".ardea");
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(
+    getConfigPath(),
+    JSON.stringify({ apiKey, endpoint, savedAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2)
+  );
+}
+var PRODUCTION_ENDPOINT = "https://canary-production-89d8.up.railway.app";
+function openBrowser(url) {
+  const platform = process.platform;
+  const cmd = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+  exec(`${cmd} "${url}"`, (err) => {
+    if (err) console.error(`Could not open browser: ${err.message}`);
+  });
+}
+async function browserAuth(endpoint) {
+  console.error("No API key found. Starting browser signup...");
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  let initData;
+  try {
+    const res = await fetch(`${endpoint}/v1/onboarding/init`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      signal: controller.signal
+    });
+    if (!res.ok) {
+      console.error(`Onboarding init failed: ${res.status}`);
+      return null;
+    }
+    initData = await res.json();
+  } catch (err) {
+    console.error(`Could not reach backend for onboarding: ${err.message}`);
+    return null;
+  } finally {
+    clearTimeout(timeout);
+  }
+  console.error(`Opening browser: ${initData.onboarding_url}`);
+  openBrowser(initData.onboarding_url);
+  const maxAttempts = 150;
+  for (let i = 0; i < maxAttempts; i++) {
+    await new Promise((r) => setTimeout(r, 2e3));
+    try {
+      const res = await fetch(`${endpoint}/v1/onboarding/claim`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ plugin_secret: initData.plugin_secret })
+      });
+      const data = await res.json();
+      if (data.api_key) {
+        console.error("Signup complete \u2014 API key received.");
+        saveConfig(data.api_key, endpoint);
+        return data.api_key;
+      }
+      if (data.status === "expired") {
+        console.error("Onboarding token expired.");
+        return null;
+      }
+    } catch {
+    }
+  }
+  console.error("Onboarding timed out after 5 minutes.");
+  return null;
+}
+var ARDEA_ANNOTATE_TOOL = {
+  name: "ardea_annotate",
+  description: "Record an API observation. Use provider/endpoint IDs like 'stripe/charges'. Note status codes, latency, errors, and anything surprising.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      id: {
+        type: "string",
+        description: 'Identifier for the annotation (e.g. "stripe/charges", "openai/chat", "github/repos"). Use provider/endpoint style.'
+      },
+      intent: {
+        type: "string",
+        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")'
+      },
+      note: {
+        type: "string",
+        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?"
+      },
+      clear: {
+        type: "boolean",
+        description: "Set true to delete the annotation for this id."
+      },
+      list: {
+        type: "boolean",
+        description: "Set true to list all saved annotations."
+      }
+    },
+    required: []
+  }
+};
+var ARDEA_REPORT_TOOL = {
+  name: "ardea_report",
+  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.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      session_id: {
+        type: "string",
+        description: "Session/task ID to link this report to a run or task. Pass the skill_execution_id or run ID."
+      },
+      intent: {
+        type: "string",
+        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")'
+      },
+      task_goal: {
+        type: "string",
+        description: 'What were you trying to accomplish? (e.g. "Create a Stripe charge for $50 and send an SMS confirmation via Twilio")'
+      },
+      outcome: {
+        type: "string",
+        enum: ["success", "partial", "failure", "blocked"],
+        description: "Did the task succeed?"
+      },
+      apis_used: {
+        type: "string",
+        description: 'Which APIs did you call? List provider and key endpoints. (e.g. "Stripe POST /v1/charges, Twilio POST /Messages.json")'
+      },
+      what_worked: {
+        type: "string",
+        description: 'What went smoothly? Mention specific endpoints or features. (e.g. "Stripe charge creation returned clear response with charge ID")'
+      },
+      what_failed: {
+        type: "string",
+        description: 'What went wrong? Include error codes, status, and messages. (e.g. "POST /v1/refunds returned 400: Charge already refunded")'
+      },
+      error_handling: {
+        type: "string",
+        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.")'
+      },
+      service_switch: {
+        type: "string",
+        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.")'
+      },
+      friction: {
+        type: "string",
+        description: `The single biggest pain point. (e.g. "Stripe charge object doesn't show refund status")`
+      },
+      suggestion: {
+        type: "string",
+        description: 'How could the API improve? (e.g. "Add a refund_status field to the charge object")'
+      }
+    },
+    required: ["task_goal", "outcome", "apis_used"]
+  }
+};
+var ARDEA_WALLET_TOOL = {
+  name: "ardea_wallet",
+  description: "Manage your Ardea credit wallet. Redeem voucher codes, check balances, or pay for API calls with credits.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      action: {
+        type: "string",
+        enum: ["redeem", "balance", "pay"],
+        description: "Action: 'redeem' a voucher code, check 'balance', or 'pay' for an API call"
+      },
+      code: {
+        type: "string",
+        description: '(redeem) Voucher code e.g. "CVR-OPENAI-A7K2M9X4"'
+      },
+      vendor: {
+        type: "string",
+        description: '(balance, pay) Vendor e.g. "openai". Omit for all balances.'
+      },
+      amount: {
+        type: "number",
+        description: "(pay) Credits to spend"
+      },
+      realm: {
+        type: "string",
+        description: '(pay) API realm e.g. "openai/v1/chat/completions"'
+      }
+    },
+    required: ["action"]
+  }
+};
+function parseArgs() {
+  const args = process.argv.slice(2);
+  let apiKey = process.env.ARDEA_API_KEY || "";
+  let endpoint = process.env.ARDEA_ENDPOINT || PRODUCTION_ENDPOINT;
+  let sessionId = process.env.ARDEA_SESSION_ID;
+  let agentName = process.env.ARDEA_AGENT_NAME;
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--api-key" && args[i + 1]) apiKey = args[++i];
+    else if (args[i] === "--endpoint" && args[i + 1]) endpoint = args[++i];
+    else if (args[i] === "--session-id" && args[i + 1]) sessionId = args[++i];
+    else if (args[i] === "--agent-name" && args[i + 1]) agentName = args[++i];
+    else if (args[i].startsWith("--api-key="))
+      apiKey = args[i].substring("--api-key=".length);
+    else if (args[i].startsWith("--endpoint="))
+      endpoint = args[i].substring("--endpoint=".length);
+    else if (args[i].startsWith("--session-id="))
+      sessionId = args[i].substring("--session-id=".length);
+    else if (args[i].startsWith("--agent-name="))
+      agentName = args[i].substring("--agent-name=".length);
+  }
+  if (!apiKey) {
+    const saved = loadSavedConfig();
+    if (saved?.apiKey) {
+      apiKey = saved.apiKey;
+      if (saved.endpoint) endpoint = saved.endpoint;
+      console.error("Loaded API key from ~/.ardea/config.json");
+    }
+  }
+  return { apiKey, endpoint, sessionId, agentName };
+}
+async function postEvents(config, events) {
+  const url = `${config.endpoint}/v1/events`;
+  const body = JSON.stringify({ events, sdk_version: "0.1.0" });
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  let res;
+  try {
+    res = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${config.apiKey}`
+      },
+      body,
+      signal: controller.signal
+    });
+  } finally {
+    clearTimeout(timeout);
+  }
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`POST /v1/events failed: ${res.status} ${text}`);
+  }
+  return res.json();
+}
+function handleAnnotate(args) {
+  const { id, note, clear, list } = args;
+  if (list) {
+    const annotations = listAnnotations();
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(
+            { annotations, total: annotations.length },
+            null,
+            2
+          )
+        }
+      ]
+    };
+  }
+  if (!id) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            error: "Missing required parameter: id. Provide a provider/endpoint id or use list mode."
+          })
+        }
+      ],
+      isError: true
+    };
+  }
+  if (id.length > 200) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            error: "ID too long (max 200 characters)."
+          })
+        }
+      ],
+      isError: true
+    };
+  }
+  if (!/^[a-zA-Z0-9._\-\/]+$/.test(id)) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            error: "ID contains invalid characters. Use alphanumeric, hyphens, underscores, dots, and slashes."
+          })
+        }
+      ],
+      isError: true
+    };
+  }
+  if (clear) {
+    const removed = clearAnnotation(id);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            status: removed ? "cleared" : "not_found",
+            id
+          })
+        }
+      ]
+    };
+  }
+  if (note) {
+    const saved = writeAnnotation(id, note);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({ status: "saved", annotation: saved }, null, 2)
+        }
+      ]
+    };
+  }
+  const annotation = readAnnotation(id);
+  if (annotation) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({ annotation }, null, 2)
+        }
+      ]
+    };
+  }
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify({ status: "no_annotation", id })
+      }
+    ]
+  };
+}
+function buildFeedbackEvent(args, config) {
+  const outcome = args.outcome;
+  const worked = outcome === "success" || outcome === "partial";
+  const contextParts = [];
+  if (args.intent) contextParts.push(`Intent: ${args.intent}`);
+  contextParts.push(`Goal: ${args.task_goal}`);
+  contextParts.push(`APIs: ${args.apis_used}`);
+  contextParts.push(`Outcome: ${outcome}`);
+  if (args.what_worked) contextParts.push(`Worked: ${args.what_worked}`);
+  if (args.what_failed) contextParts.push(`Failed: ${args.what_failed}`);
+  if (args.error_handling) contextParts.push(`Error Handling: ${args.error_handling}`);
+  if (args.service_switch) contextParts.push(`Service Switch: ${args.service_switch}`);
+  if (args.suggestion) contextParts.push(`Suggestion: ${args.suggestion}`);
+  const frictionPoints = [];
+  if (args.friction) frictionPoints.push(args.friction);
+  if (args.what_failed && args.what_failed !== args.friction) {
+    frictionPoints.push(args.what_failed);
+  }
+  if (args.error_handling) frictionPoints.push(`Error handling: ${args.error_handling}`);
+  if (args.service_switch) frictionPoints.push(`Service switch: ${args.service_switch}`);
+  const providerMatch = args.apis_used?.match(/^(\w+)/);
+  const provider = providerMatch ? providerMatch[1].toLowerCase() : void 0;
+  const endpointMatch = args.apis_used?.match(
+    /(?:GET|POST|PUT|DELETE|PATCH)\s+(\/\S+)/
+  );
+  const endpointPattern = endpointMatch ? endpointMatch[1] : void 0;
+  return {
+    event_type: "feedback",
+    ts: Date.now() / 1e3,
+    source: "journal",
+    worked,
+    context: contextParts.join(". "),
+    friction_points: frictionPoints.length > 0 ? frictionPoints : void 0,
+    provider,
+    endpoint_pattern: endpointPattern,
+    framework_session_id: args.session_id || config.sessionId,
+    agent_name: config.agentName
+  };
+}
+async function handleReport(args, config, reportCount) {
+  const missing = [];
+  if (!args.task_goal) missing.push("task_goal");
+  if (!args.outcome) missing.push("outcome");
+  if (!args.apis_used) missing.push("apis_used");
+  if (missing.length > 0) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Missing required fields: ${missing.join(", ")}`
+        }
+      ],
+      isError: true
+    };
+  }
+  const validOutcomes = ["success", "partial", "failure", "blocked"];
+  if (!validOutcomes.includes(args.outcome)) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Invalid outcome "${args.outcome}". Must be one of: ${validOutcomes.join(", ")}`
+        }
+      ],
+      isError: true
+    };
+  }
+  try {
+    const event = buildFeedbackEvent(args, config);
+    const result = await postEvents(config, [event]);
+    const responseLines = [
+      `Report #${reportCount} submitted`,
+      `  Accepted: ${result.accepted}, Errors: ${result.errors}`
+    ];
+    if (result.quality_score != null) {
+      responseLines.push(`  Quality score: ${result.quality_score}/100`);
+    }
+    if (result.credits != null) {
+      responseLines.push(`  Credits earned: ${result.credits}`);
+    }
+    if (result.tip) {
+      responseLines.push(`  Tip: ${result.tip}`);
+    }
+    return {
+      content: [{ type: "text", text: responseLines.join("\n") }]
+    };
+  } catch (err) {
+    console.error("ardea_report error:", err.message);
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Failed to submit report: ${err.message}`
+        }
+      ],
+      isError: true
+    };
+  }
+}
+async function handleWallet(args, config) {
+  const { action, code, vendor, amount, realm } = args;
+  if (!action || !["redeem", "balance", "pay"].includes(action)) {
+    return {
+      content: [{ type: "text", text: "Invalid action. Use: redeem, balance, or pay" }],
+      isError: true
+    };
+  }
+  const headers = {
+    "Content-Type": "application/json",
+    Authorization: `Bearer ${config.apiKey}`
+  };
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  try {
+    if (action === "redeem") {
+      if (!code) {
+        return { content: [{ type: "text", text: "Missing required parameter: code" }], isError: true };
+      }
+      const res = await fetch(`${config.endpoint}/v1/vouchers/redeem`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ code }),
+        signal: controller.signal
+      });
+      const data = await res.json();
+      if (!res.ok) {
+        return { content: [{ type: "text", text: `Redemption failed: ${data.detail || JSON.stringify(data)}` }], isError: true };
+      }
+      return {
+        content: [{
+          type: "text",
+          text: `Redeemed ${code}: +${data.credits} ${data.vendor} credits. Wallet balance: ${data.wallet_balance}`
+        }]
+      };
+    }
+    if (action === "balance") {
+      const url = vendor ? `${config.endpoint}/v1/wallet/vendor-balances?vendor=${encodeURIComponent(vendor)}` : `${config.endpoint}/v1/wallet/vendor-balances`;
+      const res = await fetch(url, { headers, signal: controller.signal });
+      const data = await res.json();
+      if (!res.ok) {
+        return { content: [{ type: "text", text: `Balance check failed: ${data.detail || JSON.stringify(data)}` }], isError: true };
+      }
+      const balances = data.balances || [];
+      if (balances.length === 0) {
+        return { content: [{ type: "text", text: "No vendor wallet balances found. Redeem a voucher to get started." }] };
+      }
+      const lines = balances.map(
+        (b) => `  ${b.vendor}: ${b.balance} credits ($${(b.balance / 1e3).toFixed(2)})`
+      );
+      return { content: [{ type: "text", text: `Wallet balances:
+${lines.join("\n")}` }] };
+    }
+    if (action === "pay") {
+      if (!vendor || !amount) {
+        return { content: [{ type: "text", text: "Missing required parameters: vendor and amount" }], isError: true };
+      }
+      const res = await fetch(`${config.endpoint}/v1/wallet/pay`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ vendor, amount, realm: realm || void 0, memo: realm ? `MPP payment: ${realm}` : void 0 }),
+        signal: controller.signal
+      });
+      const data = await res.json();
+      if (!res.ok) {
+        if (res.status === 402) {
+          return { content: [{ type: "text", text: `Insufficient ${vendor} credits. Need ${amount}, have ${data.balance || 0}. Redeem a voucher first.` }], isError: true };
+        }
+        return { content: [{ type: "text", text: `Payment failed: ${data.detail || JSON.stringify(data)}` }], isError: true };
+      }
+      const realmStr = realm ? ` for ${realm}` : "";
+      return {
+        content: [{ type: "text", text: `Paid ${amount} ${vendor} credits${realmStr}. Balance: ${data.balance_after}` }]
+      };
+    }
+    return { content: [{ type: "text", text: "Unknown action" }], isError: true };
+  } catch (err) {
+    if (err.name === "AbortError") {
+      return { content: [{ type: "text", text: "Wallet request timed out" }], isError: true };
+    }
+    return { content: [{ type: "text", text: `Wallet error: ${err.message}` }], isError: true };
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+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.";
+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.";
+async function main() {
+  const config = parseArgs();
+  let reportCount = 0;
+  if (!config.apiKey) {
+    const key = await browserAuth(config.endpoint || PRODUCTION_ENDPOINT);
+    if (key) {
+      config.apiKey = key;
+    }
+  }
+  const authenticated = !!config.apiKey;
+  const server = new Server(
+    { name: "ardea", version: "0.3.0" },
+    {
+      capabilities: { tools: {} },
+      instructions: authenticated ? INSTRUCTIONS_AUTHENTICATED : INSTRUCTIONS_SETUP
+    }
+  );
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [ARDEA_ANNOTATE_TOOL, ARDEA_REPORT_TOOL, ARDEA_WALLET_TOOL]
+  }));
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const args = request.params.arguments || {};
+    if (!config.apiKey && request.params.name !== "ardea_annotate") {
+      return {
+        content: [
+          {
+            type: "text",
+            text: "Ardea is not configured yet. Please complete signup in your browser or set the ARDEA_API_KEY environment variable, then restart."
+          }
+        ],
+        isError: true
+      };
+    }
+    switch (request.params.name) {
+      case "ardea_annotate":
+        return handleAnnotate(args);
+      case "ardea_report":
+        reportCount++;
+        return handleReport(args, config, reportCount);
+      case "ardea_wallet":
+        return handleWallet(args, config);
+      default:
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Unknown tool: ${request.params.name}`
+            }
+          ],
+          isError: true
+        };
+    }
+  });
+  const transport = new StdioServerTransport();
+  console.error("Ardea journal server v0.3.0 starting...");
+  console.error(`  Endpoint: ${config.endpoint}`);
+  console.error(`  Auth:     ${authenticated ? "configured" : "not configured"}`);
+  console.error(`  Session:  ${config.sessionId || "(auto)"}`);
+  console.error(`  Agent:    ${config.agentName || "(unnamed)"}`);
+  console.error(`  Tools:    ardea_annotate, ardea_report, ardea_wallet`);
+  await server.connect(transport);
+  console.error("Ardea journal server connected via stdio");
+}
+function checkDirectRun() {
+  try {
+    const scriptPath = realpathSync(process.argv[1]);
+    const modulePath = realpathSync(fileURLToPath(import.meta.url));
+    return scriptPath === modulePath;
+  } catch {
+    return process.argv[1]?.endsWith("server.js") ?? false;
+  }
+}
+if (checkDirectRun()) {
+  main().catch((err) => {
+    console.error("Fatal:", err);
+    process.exit(1);
+  });
+}
+export {
+  buildFeedbackEvent,
+  handleAnnotate,
+  handleReport,
+  handleWallet,
+  postEvents
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +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\";\nimport { realpathSync } from \"node:fs\";\n\nfunction checkDirectRun(): boolean {\n  try {\n    const scriptPath = realpathSync(process.argv[1]);\n    const modulePath = realpathSync(fileURLToPath(import.meta.url));\n    return scriptPath === modulePath;\n  } catch {\n    // Fallback: check if argv[1] ends with our filename\n    return process.argv[1]?.endsWith(\"server.js\") ?? false;\n  }\n}\n\nif (checkDirectRun()) {\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

@@ -1 +1,53 @@
-{"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"}}
+{
+  "name": "ardea",
+  "version": "0.2.1",
+  "description": "MCP server for AI agents to report API experience feedback and earn credits",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "ardea",
+    "api",
+    "observability",
+    "mcp",
+    "ai-agent",
+    "model-context-protocol",
+    "feedback",
+    "node"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vikasvs/canary.git",
+    "directory": "ardea"
+  },
+  "homepage": "https://github.com/vikasvs/canary/tree/main/ardea#readme",
+  "bugs": {
+    "url": "https://github.com/vikasvs/canary/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "bin": {
+    "ardea": "./dist/server.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  }
+}

package/index.js

@@ -1 +0,0 @@
-module.exports = {};