robodev 0.34.0 → 0.36.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "robodev",
-  "version": "0.34.0",
+  "version": "0.36.0",
   "description": "CLI for Robodev Starbase — create, auth, link, deploy, and run a project locally with robodev dev",
   "type": "module",
   "license": "MIT",
@@ -22,14 +22,16 @@
   },
   "dependencies": {
     "@fastify/cors": "^11.3.0",
+    "@fastify/websocket": "^11.2.0",
     "embedded-postgres": "17.10.0-beta.17",
     "fastify": "^5.12.1",
     "tsx": "^4.20.5",
-    "@robodev-ai/runtime": "0.3.0",
+    "@robodev-ai/runtime": "0.4.1",
     "@robodev-ai/sdk": "0.11.0"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
+    "@types/ws": "^8.18.1",
     "typescript": "^5.9.2"
   },
   "scripts": {

package/src/dev-clients.ts

@@ -1,18 +1,20 @@
+import {
+  createLocalStorageClient,
+  createProjectSocketsClient,
+  type StorageQueryable,
+} from "@robodev-ai/runtime";
 import type { RouteClients } from "@robodev-ai/runtime";
 import type { EmailClient, JobEnqueueInput, LlmClient } from "@robodev-ai/sdk";
 import type { DevInspectStore } from "./dev-inspect.js";
 
 /**
  * The `ctx.*` clients `robodev dev` can offer offline. `email` prints to the terminal;
- * `jobs` enqueues onto the local engine; everything else that needs Starbase
- * infrastructure fails with a message that says so rather than silently doing nothing.
+ * `jobs`, `storage`, and `sockets` run locally. llm / agent / push throw hosted-style
+ * not-configured codes rather than silently doing nothing.
  */
 
-function unavailable(feature: string): never {
-  throw Object.assign(
-    new Error(`ctx.${feature} needs hosted Starbase. Run robodev deploy to use it.`),
-    { statusCode: 501 },
-  );
+function notConfigured(code: string): never {
+  throw Object.assign(new Error(code), { statusCode: 400, code });
 }
 
 function errorMessage(error: unknown): string {
@@ -37,8 +39,8 @@ export function consoleEmailClient(
 
 function offlineLlmClient(): LlmClient {
   return {
-    complete: () => unavailable("llm"),
-    stream: () => unavailable("llm"),
+    complete: () => notConfigured("llm_not_configured"),
+    stream: () => notConfigured("llm_not_configured"),
   };
 }
 
@@ -47,29 +49,35 @@ export function devRouteClients(input: {
   log: (line: string) => void;
   enqueue: (job: JobEnqueueInput) => Promise<{ id: string }>;
   inspect: DevInspectStore;
+  query: StorageQueryable["query"];
+  objectsDir: string;
+  publicBaseUrl: string;
+  projectId: string;
+  jwtSecret: string;
 }): RouteClients {
   return {
     email: consoleEmailClient(input.log, input.inspect),
     llm: offlineLlmClient(),
     agent: {
-      createSession: () => unavailable("agent"),
-      start: () => unavailable("agent"),
-      events: () => unavailable("agent"),
-      subscribe: () => unavailable("agent"),
-      destroy: () => unavailable("agent"),
+      createSession: () => notConfigured("llm_not_configured"),
+      start: () => notConfigured("llm_not_configured"),
+      events: () => notConfigured("llm_not_configured"),
+      subscribe: () => notConfigured("llm_not_configured"),
+      destroy: () => notConfigured("llm_not_configured"),
     },
-    storage: {
-      upload: () => unavailable("storage"),
-      get: () => unavailable("storage"),
-      getUrl: () => unavailable("storage"),
-      delete: () => unavailable("storage"),
-      list: () => unavailable("storage"),
-    },
-    push: { send: () => unavailable("push") },
+    storage: createLocalStorageClient({
+      query: input.query,
+      objectsDir: input.objectsDir,
+      publicBaseUrl: input.publicBaseUrl,
+      projectId: input.projectId,
+      jwtSecret: input.jwtSecret,
+    }),
+    push: { send: () => notConfigured("push_not_configured") },
     jobs: {
       enqueue: async (job) => {
         try {
           const result = await input.enqueue(job);
+          // Enqueue is not a run; the dashboard Jobs page reads `job_run` from onJobFinished.
           input.inspect.record({
             kind: "job",
             name: job.name,
@@ -88,10 +96,7 @@ export function devRouteClients(input: {
         }
       },
     },
-    sockets: {
-      send: () => unavailable("sockets"),
-      broadcast: () => unavailable("sockets"),
-    },
+    sockets: createProjectSocketsClient(input.projectId),
     env: input.env,
   };
 }

package/src/dev-inspect.test.ts

@@ -1,9 +1,13 @@
 import assert from "node:assert/strict";
 import { test } from "node:test";
 import {
+  buildDashboardState,
+  callMatchesRoute,
   createDevInspect,
   inspectHtml,
+  isHistogramExcludedPath,
   isInspectPath,
+  shouldCountRequestHistogram,
   type DevInspectAuthCodeEvent,
   type DevInspectEmailEvent,
   type DevInspectJobEvent,
@@ -11,9 +15,18 @@ import {
   type DevInspectRequestEvent,
 } from "./dev-inspect.js";
 
-test("isInspectPath excludes only inspect self-routes", () => {
+const fileRuntime = {
+  routes: [{ method: "get", path: "/api/planets" }],
+};
+
+test("isInspectPath covers dashboard pages and JSON only", () => {
   assert.equal(isInspectPath("/_robodev"), true);
+  assert.equal(isInspectPath("/_robodev/apis"), true);
+  assert.equal(isInspectPath("/_robodev/jobs"), true);
+  assert.equal(isInspectPath("/_robodev/emails"), true);
+  assert.equal(isInspectPath("/_robodev/auth"), true);
   assert.equal(isInspectPath("/_robodev/logs"), true);
+  assert.equal(isInspectPath("/_robodev/state.json"), true);
   assert.equal(isInspectPath("/_robodev/logs.json"), true);
   assert.equal(isInspectPath("/_robodev/docs"), false);
   assert.equal(isInspectPath("/_robodev/ready"), false);
@@ -22,6 +35,23 @@ test("isInspectPath excludes only inspect self-routes", () => {
   assert.equal(isInspectPath("/api/planets"), false);
 });
 
+test("shouldCountRequestHistogram counts Auth and matched file routes only", () => {
+  assert.equal(shouldCountRequestHistogram("/api/user/me", fileRuntime, "GET"), true);
+  assert.equal(shouldCountRequestHistogram("/api/user/auth/google", fileRuntime, "GET"), true);
+  assert.equal(shouldCountRequestHistogram("/api/planets", fileRuntime, "GET"), true);
+  assert.equal(shouldCountRequestHistogram("/api/planets", fileRuntime, "POST"), false);
+  assert.equal(shouldCountRequestHistogram("/api/unknown", fileRuntime, "GET"), false);
+  assert.equal(shouldCountRequestHistogram("/_robodev", fileRuntime, "GET"), false);
+  assert.equal(shouldCountRequestHistogram("/_robodev/apis", fileRuntime, "GET"), false);
+  assert.equal(shouldCountRequestHistogram("/_robodev/docs", fileRuntime, "GET"), false);
+  assert.equal(shouldCountRequestHistogram("/_robodev/scalar", fileRuntime, "GET"), false);
+  assert.equal(shouldCountRequestHistogram("/_robodev/ready", fileRuntime, "GET"), false);
+  assert.equal(shouldCountRequestHistogram("/openapi.json", fileRuntime, "GET"), false);
+  assert.equal(shouldCountRequestHistogram("/docs", fileRuntime, "GET"), false);
+  assert.equal(shouldCountRequestHistogram("/swagger", fileRuntime, "GET"), false);
+  assert.equal(isHistogramExcludedPath("/scalar"), true);
+});
+
 test("ring buffer drops oldest events past max", () => {
   const inspect = createDevInspect({ max: 3 });
   inspect.record({ kind: "log", message: "a" });
@@ -37,6 +67,32 @@ test("ring buffer drops oldest events past max", () => {
   );
 });
 
+test("request histogram survives 500-event ring rotation", () => {
+  const inspect = createDevInspect({ max: 2 });
+  inspect.incrementRequestHistogram(200);
+  inspect.incrementRequestHistogram(200);
+  inspect.incrementRequestHistogram(404);
+  inspect.incrementRequestHistogram(500);
+  inspect.record({ kind: "request", method: "GET", path: "/api/a", status: 200, durationMs: 1 });
+  inspect.record({ kind: "request", method: "GET", path: "/api/b", status: 200, durationMs: 1 });
+  inspect.record({ kind: "request", method: "GET", path: "/api/c", status: 200, durationMs: 1 });
+  assert.equal(inspect.list().length, 2);
+
+  const last = inspect.requestHistogram().at(-1);
+  assert.equal(last?.c2xx, 2);
+  assert.equal(last?.c4xx, 1);
+  assert.equal(last?.c5xx, 1);
+});
+
+test("3xx does not increment request histogram buckets", () => {
+  const inspect = createDevInspect();
+  inspect.incrementRequestHistogram(302);
+  const last = inspect.requestHistogram().at(-1);
+  assert.equal(last?.c2xx, 0);
+  assert.equal(last?.c4xx, 0);
+  assert.equal(last?.c5xx, 0);
+});
+
 test("list is newest last and does not leak the internal buffer", () => {
   const inspect = createDevInspect({ max: 500 });
   inspect.record({ kind: "log", message: "first" });
@@ -112,12 +168,85 @@ test("record assigns id, at, and the expected fields for each kind", () => {
   assert.equal(inspect.list().length, 5);
 });
 
-test("inspect HTML has four lists and polls logs.json", () => {
+test("callMatchesRoute uses matchPathParams and requires method", () => {
+  const route = { method: "GET", path: "/api/planets/:id" };
+  assert.equal(callMatchesRoute({ method: "GET", path: "/api/planets/123" }, route), true);
+  assert.equal(callMatchesRoute({ method: "GET", path: "/api/planets" }, route), false);
+  assert.equal(callMatchesRoute({ method: "POST", path: "/api/planets/123" }, route), false);
+});
+
+test("dashboard snapshot lists reserved Auth, filters emails, and ignores enqueue jobs", async () => {
+  const inspect = createDevInspect();
+  inspect.record({
+    kind: "request",
+    method: "GET",
+    path: "/api/planets",
+    status: 200,
+    durationMs: 4,
+  });
+  inspect.record({
+    kind: "request",
+    method: "GET",
+    path: "/_robodev/docs",
+    status: 200,
+    durationMs: 1,
+  });
+  inspect.record({ kind: "email", to: "a@b.test", subject: "Hello", text: "Body" });
+  inspect.record({ kind: "auth_code", type: "magic", to: "a@b.test", code: "999111" });
+  inspect.record({ kind: "job", name: "hourly", payload: { n: 1 }, error: "" });
+  inspect.record({
+    kind: "job_run",
+    name: "hourly",
+    status: "failed",
+    payload: { n: 1 },
+    error: "boom",
+  });
+  inspect.incrementJobHistogram("failed");
+
+  const state = await buildDashboardState({
+    inspect,
+    runtime: {
+      routes: [{ method: "get", path: "/api/planets", file: "api/planets.ts" }],
+      jobs: [{ name: "hourly", file: "jobs/hourly.ts", def: { cron: "0 * * * *" } }],
+    },
+  });
+
+  assert.equal(state.overview.apiCount, 1 + 12);
+  assert.equal(state.overview.jobCount, 1);
+  assert.equal(state.overview.google, "broker");
+  assert.ok(state.routes.some((route) => route.path === "/api/user/auth/google/callback"));
+  assert.equal(state.calls.length, 1);
+  assert.equal(state.calls[0]?.path, "/api/planets");
+  assert.equal(state.emails.length, 1);
+  assert.equal(state.emails[0]?.subject, "Hello");
+  assert.equal(state.jobRuns.length, 1);
+  assert.equal(state.jobRuns[0]?.status, "failed");
+  assert.equal(state.overview.jobHistogram.at(-1)?.failed, 1);
+  assert.deepEqual(state.auth.users, []);
+});
+
+test("incomplete Google credentials are not labeled override", async () => {
+  const state = await buildDashboardState({
+    inspect: createDevInspect(),
+    runtime: { routes: [], jobs: [] },
+    googleClientId: "only-id",
+  });
+  assert.equal(state.overview.google, "incomplete");
+  assert.equal(state.auth.google, "incomplete");
+});
+
+test("inspect HTML has nav labels and polls state.json", () => {
   const html = inspectHtml();
-  assert.match(html, /<h2>Requests<\/h2>/);
-  assert.match(html, /<h2>Emails<\/h2>/);
-  assert.match(html, /<h2>Jobs<\/h2>/);
-  assert.match(html, /<h2>Logs<\/h2>/);
-  assert.match(html, /\/_robodev\/logs\.json/);
+  assert.match(html, />Overview</);
+  assert.match(html, />APIs</);
+  assert.match(html, />Jobs</);
+  assert.match(html, />Emails</);
+  assert.match(html, />Auth</);
+  assert.doesNotMatch(html, /<h2>Requests<\/h2>/);
+  assert.doesNotMatch(html, /<h2>Emails<\/h2>/);
+  assert.doesNotMatch(html, /<h2>Jobs<\/h2>/);
+  assert.doesNotMatch(html, /<h2>Logs<\/h2>/);
+  assert.match(html, /\/_robodev\/state\.json/);
+  assert.doesNotMatch(html, /fetch\("\/_robodev\/logs\.json"\)/);
   assert.match(html, /setInterval\(poll, 1000\)/);
 });