cuonztech-agent-harness 0.5.2 → 0.7.0

package/examples/testsystem/server.mjs

@@ -0,0 +1,127 @@
+// TESTSYSTEM — Mietbuchungs-Attrappe für den Agent-Harness-Kaltstart-Test.
+// Keine echten Daten, keine Abhängigkeiten. Speichert Buchungen in bookings.json
+// neben dieser Datei (oder in der Datei aus TESTSYSTEM_DATA), damit jeder
+// Schreibvorgang nachprüfbar bleibt.
+// Start: node server.mjs   (MCP über stdio, JSON-RPC, Zeile für Zeile)
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { createInterface } from "node:readline";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const DATA = process.env.TESTSYSTEM_DATA ?? join(dirname(fileURLToPath(import.meta.url)), "bookings.json");
+const PROTOCOL = "2024-11-05";
+
+function load() {
+  return existsSync(DATA) ? JSON.parse(readFileSync(DATA, "utf8")) : [];
+}
+function save(list) {
+  writeFileSync(DATA, JSON.stringify(list, null, 2) + "\n");
+}
+
+const TOOLS = [
+  {
+    name: "create_booking",
+    description: "Legt eine neue Mietbuchung an (schreibt in das Testsystem).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        customer: { type: "string", description: "Name des Kunden" },
+        date: { type: "string", description: "Datum, z. B. 2026-11-03" },
+        amount_chf: { type: "number", description: "Betrag in CHF" },
+        idempotency_key: { type: "string", description: "Optional: gleicher Key = gleiche Buchung, kein Doppel" },
+      },
+      required: ["customer", "date", "amount_chf"],
+    },
+    annotations: { readOnlyHint: false },
+  },
+  {
+    name: "list_bookings",
+    description: "Listet alle Buchungen eines Kunden (nur lesend).",
+    inputSchema: {
+      type: "object",
+      properties: { customer: { type: "string" } },
+      required: ["customer"],
+    },
+    annotations: { readOnlyHint: true },
+  },
+  {
+    name: "get_booking",
+    description: "Liefert eine Buchung anhand ihrer ID (nur lesend).",
+    inputSchema: {
+      type: "object",
+      properties: { booking_id: { type: "string" } },
+      required: ["booking_id"],
+    },
+    annotations: { readOnlyHint: true },
+  },
+];
+
+function callTool(name, args) {
+  const list = load();
+  if (name === "create_booking") {
+    if (args.idempotency_key) {
+      const known = list.find((b) => b.idempotency_key === args.idempotency_key);
+      if (known) return { booking: known, duplicate_prevented: true };
+    }
+    const booking = {
+      idempotency_key: args.idempotency_key ?? null,
+      booking_id: `B-${String(list.length + 1).padStart(4, "0")}`,
+      customer: args.customer,
+      date: args.date,
+      amount_chf: args.amount_chf,
+      created_at: new Date().toISOString(),
+    };
+    list.push(booking);
+    save(list);
+    return { booking };
+  }
+  if (name === "list_bookings") {
+    return { bookings: list.filter((b) => b.customer === args.customer) };
+  }
+  if (name === "get_booking") {
+    const booking = list.find((b) => b.booking_id === args.booking_id);
+    return booking ? { booking } : { error: `booking ${args.booking_id} not found` };
+  }
+  throw new Error(`unknown tool ${name}`);
+}
+
+function reply(id, result) {
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id, result }) + "\n");
+}
+function replyError(id, code, message) {
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id, error: { code, message } }) + "\n");
+}
+
+createInterface({ input: process.stdin }).on("line", (line) => {
+  if (!line.trim()) return;
+  let msg;
+  try {
+    msg = JSON.parse(line);
+  } catch {
+    return replyError(null, -32700, "parse error");
+  }
+  if (msg.id === undefined) return; // Notifications brauchen keine Antwort.
+  switch (msg.method) {
+    case "initialize":
+      return reply(msg.id, {
+        protocolVersion: PROTOCOL,
+        capabilities: { tools: {} },
+        serverInfo: { name: "testsystem-mietbuchung", version: "0.1.0" },
+      });
+    case "tools/list":
+      return reply(msg.id, { tools: TOOLS });
+    case "tools/call": {
+      try {
+        const data = callTool(msg.params.name, msg.params.arguments ?? {});
+        return reply(msg.id, { content: [{ type: "text", text: JSON.stringify(data) }] });
+      } catch (err) {
+        return reply(msg.id, {
+          content: [{ type: "text", text: String(err.message) }],
+          isError: true,
+        });
+      }
+    }
+    default:
+      return replyError(msg.id, -32601, `method not found: ${msg.method}`);
+  }
+});

package/launchers/Start-Agent-Harness.cmd

@@ -0,0 +1,23 @@
+@echo off
+rem Doppelklick-Start der Oberflaeche (Windows). Prueft Node und oeffnet den Browser.
+setlocal
+where node >nul 2>nul
+if errorlevel 1 (
+  echo Node.js ist nicht installiert.
+  echo Bitte Version 20 oder neuer von https://nodejs.org installieren und diese Datei danach erneut starten.
+  pause
+  exit /b 1
+)
+node -e "process.exit(Number(process.versions.node.split('.')[0])>=20?0:1)"
+if errorlevel 1 (
+  echo Die installierte Node.js-Version ist zu alt. Noetig ist Version 20 oder neuer.
+  echo Bitte von https://nodejs.org aktualisieren und diese Datei danach erneut starten.
+  pause
+  exit /b 1
+)
+if exist "%~dp0..\dist\index.js" (
+  node "%~dp0..\dist\index.js" ui %*
+) else (
+  npx -y cuonztech-agent-harness ui %*
+)
+if errorlevel 1 pause

package/launchers/start-agent-harness.sh

@@ -0,0 +1,18 @@
+#!/bin/sh
+# Start der Oberflaeche (macOS und Linux). Prueft Node und oeffnet den Browser.
+if ! command -v node >/dev/null 2>&1; then
+  echo "Node.js ist nicht installiert."
+  echo "Bitte Version 20 oder neuer von https://nodejs.org installieren und das Skript danach erneut starten."
+  exit 1
+fi
+if ! node -e "process.exit(Number(process.versions.node.split('.')[0])>=20?0:1)"; then
+  echo "Die installierte Node.js-Version ist zu alt. Noetig ist Version 20 oder neuer."
+  echo "Hinweis: 'apt install nodejs' liefert unter Ubuntu 24.04 nur Node 18. Bitte von https://nodejs.org installieren."
+  exit 1
+fi
+here="$(cd "$(dirname "$0")" && pwd)"
+if [ -f "$here/../dist/index.js" ]; then
+  exec node "$here/../dist/index.js" ui "$@"
+else
+  exec npx -y cuonztech-agent-harness ui "$@"
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cuonztech-agent-harness",
-  "version": "0.5.2",
+  "version": "0.7.0",
   "mcpName": "io.github.cuonztech/agent-harness",
   "description": "Chaos-Proxy für MCP-Server: injiziert F1-F5-Fehlerszenarien (Ghost-Write nach Timeout, 429, defektes JSON, Duplicate Dispatch, 500) vor einem echten Upstream-MCP-Server und prüft, ob ein Agent Schreibvorgänge doppelt ausführt. Mit Resilience Score und System-Prompt-Patches für beobachtetes Fehlverhalten.",
   "type": "module",
@@ -45,6 +45,8 @@
   },
   "files": [
     "dist/**/*.js",
+    "launchers",
+    "examples/testsystem/server.mjs",
     "README.md",
     "LICENSE",
     "server.json"

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/cuonztech/agent-harness",
     "source": "github"
   },
-  "version": "0.5.2",
+  "version": "0.7.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "cuonztech-agent-harness",
-      "version": "0.5.2",
+      "version": "0.7.0",
       "transport": {
         "type": "stdio"
       }