meridian-sdk 1.0.1 → 1.2.0

package/test/agents.test.ts

@@ -0,0 +1,104 @@
+/**
+ * Unit tests for agents.ts — no server required.
+ */
+
+import { describe, it, expect } from "bun:test";
+import { getMeridianTools, executeMeridianTool } from "../src/agents.js";
+import type { ToolUseBlock } from "../src/agents.js";
+
+const CONFIG = { baseUrl: "http://localhost:3000", token: "tok", namespace: "test-ns" };
+
+describe("getMeridianTools", () => {
+  it("generates 4 tools per CRDT ID", () => {
+    const tools = getMeridianTools(CONFIG, ["counter"]);
+    expect(tools).toHaveLength(4);
+  });
+
+  it("generates correct tool names", () => {
+    const tools = getMeridianTools(CONFIG, ["my-counter"]);
+    const names = tools.map((t) => t.name);
+    expect(names).toContain("meridian_read_my_counter");
+    expect(names).toContain("meridian_increment_my_counter");
+    expect(names).toContain("meridian_set_my_counter");
+    expect(names).toContain("meridian_add_my_counter");
+  });
+
+  it("handles multiple CRDT IDs", () => {
+    const tools = getMeridianTools(CONFIG, ["counter", "tasks", "notes"]);
+    expect(tools).toHaveLength(12);
+  });
+
+  it("returns empty array for empty crdtIds", () => {
+    const tools = getMeridianTools(CONFIG, []);
+    expect(tools).toHaveLength(0);
+  });
+
+  it("sanitizes special characters in CRDT IDs", () => {
+    const tools = getMeridianTools(CONFIG, ["my:crdt/id"]);
+    const names = tools.map((t) => t.name);
+    // colons and slashes should be replaced with underscores
+    expect(names.every((n) => /^meridian_[a-z_]+$/.test(n))).toBe(true);
+  });
+
+  it("read tool has no required fields", () => {
+    const tools = getMeridianTools(CONFIG, ["counter"]);
+    const readTool = tools.find((t) => t.name === "meridian_read_counter");
+    expect(readTool).toBeDefined();
+    expect(readTool!.input_schema.required).toBeUndefined();
+  });
+
+  it("increment tool requires amount and client_id", () => {
+    const tools = getMeridianTools(CONFIG, ["counter"]);
+    const incrTool = tools.find((t) => t.name === "meridian_increment_counter");
+    expect(incrTool!.input_schema.required).toContain("amount");
+    expect(incrTool!.input_schema.required).toContain("client_id");
+  });
+
+  it("set tool requires value and client_id", () => {
+    const tools = getMeridianTools(CONFIG, ["notes"]);
+    const setTool = tools.find((t) => t.name === "meridian_set_notes");
+    expect(setTool!.input_schema.required).toContain("value");
+    expect(setTool!.input_schema.required).toContain("client_id");
+  });
+
+  it("add tool requires element and client_id", () => {
+    const tools = getMeridianTools(CONFIG, ["tags"]);
+    const addTool = tools.find((t) => t.name === "meridian_add_tags");
+    expect(addTool!.input_schema.required).toContain("element");
+    expect(addTool!.input_schema.required).toContain("client_id");
+  });
+
+  it("all tools have descriptions mentioning the CRDT id", () => {
+    const tools = getMeridianTools(CONFIG, ["visits"]);
+    for (const tool of tools) {
+      expect(tool.description).toContain("visits");
+    }
+  });
+
+  it("read tool description mentions the namespace", () => {
+    const tools = getMeridianTools(CONFIG, ["visits"]);
+    const readTool = tools.find((t) => t.name === "meridian_read_visits");
+    expect(readTool!.description).toContain("test-ns");
+  });
+
+  it("all tools have input_schema type object", () => {
+    const tools = getMeridianTools(CONFIG, ["x"]);
+    for (const tool of tools) {
+      expect(tool.input_schema.type).toBe("object");
+    }
+  });
+});
+
+describe("executeMeridianTool", () => {
+  it("returns error JSON for unknown tool name", async () => {
+    const toolUse: ToolUseBlock = {
+      type: "tool_use",
+      id: "tu_1",
+      name: "meridian_unknown_op",
+      input: {},
+    };
+    const result = await executeMeridianTool(CONFIG, toolUse);
+    const parsed = JSON.parse(result);
+    expect(parsed.error).toBeDefined();
+  });
+});

package/test/crdt.test.ts

@@ -13,10 +13,6 @@ import { PresenceHandle } from "../src/crdt/presence.js";
 import { CRDTMapHandle } from "../src/crdt/crdtmap.js";
 import type { WsTransport } from "../src/transport/websocket.js";
 
-// ---------------------------------------------------------------------------
-// Stub transport — captures sends, never actually connects
-// ---------------------------------------------------------------------------
-
 function stubTransport(): WsTransport & { sent: unknown[] } {
   const sent: unknown[] = [];
   return {
@@ -32,10 +28,6 @@ function stubTransport(): WsTransport & { sent: unknown[] } {
 
 const BASE_OPTS = { ns: "test", clientId: 1 };
 
-// ---------------------------------------------------------------------------
-// GCounter
-// ---------------------------------------------------------------------------
-
 describe("GCounterHandle", () => {
   it("starts at 0", () => {
     const t = stubTransport();
@@ -96,10 +88,6 @@ describe("GCounterHandle", () => {
   });
 });
 
-// ---------------------------------------------------------------------------
-// PNCounter
-// ---------------------------------------------------------------------------
-
 describe("PNCounterHandle", () => {
   it("starts at 0", () => {
     const t = stubTransport();
@@ -130,10 +118,6 @@ describe("PNCounterHandle", () => {
   });
 });
 
-// ---------------------------------------------------------------------------
-// ORSet
-// ---------------------------------------------------------------------------
-
 describe("ORSetHandle", () => {
   it("empty by default", () => {
     const t = stubTransport();
@@ -179,10 +163,6 @@ describe("ORSetHandle", () => {
   });
 });
 
-// ---------------------------------------------------------------------------
-// LWW Register
-// ---------------------------------------------------------------------------
-
 describe("LwwRegisterHandle", () => {
   it("starts null", () => {
     const t = stubTransport();
@@ -228,10 +208,6 @@ describe("LwwRegisterHandle", () => {
   });
 });
 
-// ---------------------------------------------------------------------------
-// Presence
-// ---------------------------------------------------------------------------
-
 describe("PresenceHandle", () => {
   it("empty by default", () => {
     const t = stubTransport();
@@ -292,10 +268,6 @@ describe("PresenceHandle", () => {
   });
 });
 
-// ---------------------------------------------------------------------------
-// TTL — ttl_ms forwarded in Op message
-// ---------------------------------------------------------------------------
-
 describe("ttl_ms forwarding", () => {
   it("GCounter.increment includes ttl_ms when provided", () => {
     const t = stubTransport();

package/test/integration.test.ts

@@ -17,12 +17,9 @@ import { MeridianClient } from "../src/client.js";
 import { HttpClient } from "../src/transport/http.js";
 import { uuidToBytes } from "../src/codec.js";
 
-// ---------------------------------------------------------------------------
 // Config — matches the dev signing key [0x42; 32]
 // The token below is for namespace="integration", client_id=1, TTL=24h
 // Regenerate with: cargo run --bin gen_token -- integration 1
-// ---------------------------------------------------------------------------
-
 const SERVER_URL = "http://127.0.0.1:3737";
 const NAMESPACE = "integration";
 
@@ -53,10 +50,6 @@ async function isServerUp(): Promise<boolean> {
   }
 }
 
-// ---------------------------------------------------------------------------
-// Test suite
-// ---------------------------------------------------------------------------
-
 describe("Meridian integration", () => {
   let http: HttpClient;
 

package/test/offline-queue.test.ts

@@ -8,10 +8,6 @@ import { describe, it, expect, beforeEach, afterEach } from "bun:test";
 import { WsTransport } from "../src/transport/websocket.js";
 import { OFFLINE_QUEUE_MAX } from "../src/constants.js";
 
-// ---------------------------------------------------------------------------
-// Fake WebSocket
-// ---------------------------------------------------------------------------
-
 type WsEventName = "open" | "message" | "close" | "error";
 
 class FakeWebSocket {
@@ -69,10 +65,6 @@ function makeTransport(onStateChange?: (s: string) => void): WsTransport {
   });
 }
 
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-
 describe("WsTransport offline queue", () => {
   it("buffers ops sent while DISCONNECTED", () => {
     const t = makeTransport();

package/test/sync.test.ts

@@ -9,10 +9,6 @@ import { encode, decode, encodeClientMsg, decodeServerMsg } from "../src/codec.j
 import { parseToken, checkTokenExpiry } from "../src/auth/token.js";
 import { CodecError, TokenParseError, TokenExpiredError } from "../src/errors.js";
 
-// ---------------------------------------------------------------------------
-// VectorClockTracker
-// ---------------------------------------------------------------------------
-
 describe("VectorClockTracker", () => {
   function freshStorage() {
     const store = new Map<string, Record<string, number>>();
@@ -66,10 +62,6 @@ describe("VectorClockTracker", () => {
   });
 });
 
-// ---------------------------------------------------------------------------
-// Codec
-// ---------------------------------------------------------------------------
-
 describe("codec", () => {
   it("encode/decode roundtrip for plain objects", () => {
     const obj = { foo: "bar", n: 42 };
@@ -117,10 +109,6 @@ describe("codec", () => {
   });
 });
 
-// ---------------------------------------------------------------------------
-// Token parsing
-// ---------------------------------------------------------------------------
-
 describe("parseToken", () => {
   function makeToken(claims: object): string {
     const payload = encode(claims);