otterly 0.3.0 → 0.3.1

package/dist/cli.js

@@ -12,9 +12,14 @@ const { values, positionals } = parseArgs({
         "max-queue": { type: "string", default: "50" },
         "rate-limit": { type: "string", default: "60" },
         help: { type: "boolean", short: "h", default: false },
+        version: { type: "boolean", short: "v", default: false },
     },
 });
 const command = positionals[0] || "serve";
+if (values.version) {
+    console.log("0.3.1");
+    process.exit(0);
+}
 if (values.help || command === "help") {
     console.log(`
   otterly — local inference server for Claude Code
@@ -29,6 +34,7 @@ if (values.help || command === "help") {
     --max-concurrent <number>   Max concurrent requests (default: 5)
     --max-queue <number>        Max queued requests (default: 50)
     --rate-limit <number>       Requests per minute per client (default: 60)
+    -v, --version               Print version
     -h, --help                  Show this help
 
   Environment:
@@ -39,6 +45,7 @@ if (values.help || command === "help") {
     POST /api/run               Native one-shot execution
     POST /api/stream            Native NDJSON streaming
     GET  /api/status            Health check + queue/circuit stats
+    GET  /playground            Interactive API playground
     WS   /ws                    Multi-turn WebSocket sessions
 `);
     process.exit(0);

package/dist/server/index.js

@@ -12,6 +12,7 @@ import { checkAuth, RateLimiter, sendAuthError, sendRateLimitError } from "./mid
 import { generateRequestId, logRequest, logResponse, logError } from "./logger.js";
 import { CircuitBreaker } from "./circuit-breaker.js";
 import { openApiSpec } from "./swagger.js";
+import { getPlaygroundHtml } from "./playground.js";
 /**
  * Parse JSON body from an incoming request. Returns parsed object or null on failure.
  */
@@ -104,6 +105,18 @@ export async function startApiServer(opts = {}) {
             jsonResponse(res, 200, openApiSpec);
             return;
         }
+        // GET /playground — interactive API playground
+        if (req.method === "GET" && path === "/playground") {
+            const html = getPlaygroundHtml(port);
+            res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+            res.end(html);
+            return;
+        }
+        // GET / — server info
+        if (req.method === "GET" && path === "/") {
+            jsonResponse(res, 200, { name: "otterly", version: "0.3.1", playground: "/playground" });
+            return;
+        }
         // ── POST routes: auth → rate limit → circuit breaker → queue ──
         if (req.method !== "POST") {
             jsonResponse(res, 404, { error: "Not found" });
@@ -243,6 +256,7 @@ export async function startApiServer(opts = {}) {
             console.log(`  Streaming     : http://localhost:${port}/api/stream`);
             console.log(`  WebSocket     : ws://localhost:${port}/ws`);
             console.log(`  Health        : http://localhost:${port}/api/status`);
+            console.log(`  Playground    : http://localhost:${port}/playground`);
             console.log(`  Working dir   : ${workingDir}`);
             if (apiKey) {
                 console.log(`  Auth          : API key required (OTTERLY_API_KEY)`);

package/dist/server/playground.d.ts

@@ -0,0 +1 @@
+export declare function getPlaygroundHtml(port: number): string;