@kodama-run/sdk 0.1.0

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@kodama-run/sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "bin": {
+    "kodama": "./src/adapters/cli.ts",
+    "kodama-mcp": "./src/adapters/mcp.ts"
+  },
+  "files": [
+    "src/**/*.ts",
+    "!src/__tests__",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "echo 'No build step for sdk (source-only)'",
+    "test": "bun test",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@kodama-run/shared": "workspace:*",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^13",
+    "ws": "^8",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/ws": "^8",
+    "typescript": "*"
+  }
+}

package/src/adapters/cli.ts

@@ -0,0 +1,172 @@
+#!/usr/bin/env bun
+import { program } from "commander";
+import Anthropic from "@anthropic-ai/sdk";
+import { Kodama } from "../room.ts";
+import * as readline from "readline";
+
+// ---------------------------------------------------------------------------
+// Helper: read a line from stdin
+// ---------------------------------------------------------------------------
+
+function readLine(prompt: string): Promise<string> {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: false,
+    });
+    process.stdout.write(prompt);
+    rl.once("line", (line) => {
+      rl.close();
+      resolve(line);
+    });
+    rl.once("close", () => {
+      resolve("");
+    });
+  });
+}
+
+// ---------------------------------------------------------------------------
+// `kodama create`
+// ---------------------------------------------------------------------------
+
+program
+  .command("create")
+  .description("Create a new Kodama room")
+  .option("-p, --password <password>", "Room password")
+  .option("-r, --rounds <number>", "Max rounds", "10")
+  .option("-t, --timeout <seconds>", "Turn timeout in seconds", "90")
+  .option("--topic <text>", "Room topic / negotiation subject")
+  .option("--relay <url>", "Relay HTTP base URL", "http://localhost:8000")
+  .action(async (options) => {
+    const body: Record<string, unknown> = {
+      maxRounds: parseInt(options.rounds, 10),
+      turnTimeout: parseInt(options.timeout, 10),
+    };
+    if (options.password) {
+      body.password = options.password;
+    }
+    if (options.topic) {
+      body.topic = options.topic;
+    }
+
+    try {
+      const res = await fetch(`${options.relay}/api/rooms`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+      });
+
+      if (!res.ok) {
+        const text = await res.text();
+        console.error(`Error creating room (HTTP ${res.status}): ${text}`);
+        process.exit(1);
+      }
+
+      const data = await res.json() as {
+        code: string;
+        topic?: string;
+        inviteTokens?: string[];
+        status?: string;
+      };
+      const inviteToken = data.inviteTokens?.[0] ?? "???";
+
+      console.log(`Room created: ${data.code}`);
+      if (data.topic) {
+        console.log(`Topic: ${data.topic}`);
+      }
+      console.log("");
+      console.log("Share with your friend:");
+      console.log(`  kodama join ${data.code} --invite ${inviteToken}`);
+      console.log("");
+      console.log(`Spectate: http://localhost:3000/room/${data.code}`);
+      if (options.password) {
+        console.log(`Password: ${options.password}`);
+      }
+    } catch (err) {
+      console.error("Failed to reach relay:", (err as Error).message);
+      process.exit(1);
+    }
+  });
+
+// ---------------------------------------------------------------------------
+// `kodama join <code>`
+// ---------------------------------------------------------------------------
+
+program
+  .command("join <code>")
+  .description("Join a Kodama room as a CLI agent")
+  .requiredOption("--invite <token>", "Invite token for the room")
+  .option("-n, --name <name>", "Agent display name", "CLI Agent")
+  .option("-p, --password <password>", "Room password")
+  .option("--goal <text>", "Goal for autonomous LLM mode")
+  .option("--manual", "Manual stdin mode (for debugging)")
+  .option("--relay <url>", "Relay WebSocket URL", "ws://localhost:8000/ws")
+  .action(async (code: string, options) => {
+    const agent = new Kodama(code, {
+      relayUrl: options.relay,
+      name: options.name,
+      password: options.password,
+      inviteToken: options.invite,
+    });
+
+    agent.on("error", (err: Error) => {
+      console.error(`[error] ${err.message}`);
+    });
+
+    agent.on("turn", async (messages, _ctx) => {
+      if (options.manual) {
+        // Manual stdin mode
+        const last = messages[messages.length - 1];
+        if (last) {
+          console.log(`\n[${last.agent.name}]: ${last.content}`);
+        } else {
+          console.log("\n[Room] You go first.");
+        }
+        return await readLine("You: ");
+      }
+
+      // Autonomous LLM mode
+      const client = new Anthropic();
+      const systemPrompt = options.goal || "You are a helpful conversationalist.";
+      const history = messages.map((m) => ({
+        role: "user" as const,
+        content: `${m.agent.name}: ${m.content}`,
+      }));
+      if (history.length === 0) {
+        history.push({ role: "user", content: "Start the conversation. Introduce yourself." });
+      }
+      const response = await client.messages.create({
+        model: "claude-sonnet-4-6",
+        max_tokens: 500,
+        system: systemPrompt,
+        messages: history,
+      });
+      const text = response.content[0]?.type === "text" ? response.content[0].text : "";
+      console.log(`\n[You]: ${text}`);
+      return text;
+    });
+
+    try {
+      console.log(`Joining room ${code} as "${options.name}" …`);
+      await agent.join();
+      const ownerToken = agent.getOwnerToken();
+      console.log(`Joined!`);
+      console.log(`Owner token: ${ownerToken}`);
+      console.log(`Spectate: http://localhost:3000/room/${code}`);
+      console.log("Waiting for your turn… (Ctrl+C to exit)");
+    } catch (err) {
+      console.error("Failed to join room:", (err as Error).message);
+      process.exit(1);
+    }
+  });
+
+// ---------------------------------------------------------------------------
+// Parse
+// ---------------------------------------------------------------------------
+
+program
+  .name("kodama")
+  .description("Kodama CLI — create and join negotiation rooms")
+  .version("0.1.0")
+  .parse(process.argv);