@polderlabs/bizar 6.2.4 → 6.3.0

package/packages/sdk/src/types.ts

@@ -1,176 +0,0 @@
-/**
- * Type definitions matching .bizar/research/OPENAPI_SPEC.yaml.
- *
- * Hand-written in v0.7.0-alpha.1. In v0.7.1 these will be auto-generated
- * via @hey-api/openapi-ts. Keep this file in sync with OPENAPI_SPEC.yaml
- * until codegen is wired.
- */
-
-// ─── Session ────────────────────────────────────────────────────────────
-
-export type SessionStatus =
-  | "pending"
-  | "running"
-  | "done"
-  | "failed"
-  | "killed"
-  | "timed_out";
-
-export type Session = {
-  id: string;
-  clineSessionId?: string;
-  agent: string;
-  status: SessionStatus;
-  parentId?: string;
-  model?: string;
-  error?: string;
-  toolCallCount: number;
-  resultPreview?: string;
-  worktree: string;
-  createdAt: number;
-  updatedAt: number;
-};
-
-export type SessionCreate = {
-  agent: string;
-  prompt: string;
-  model?: string;
-  parentId?: string;
-  timeoutMs?: number;
-};
-
-export type SessionListQuery = {
-  status?: SessionStatus;
-  agent?: string;
-  limit?: number;
-};
-
-// ─── Project ────────────────────────────────────────────────────────────
-
-export type Project = {
-  id: string;
-  name: string;
-  path: string;
-  bankId?: string;
-};
-
-// ─── Plan ───────────────────────────────────────────────────────────────
-
-export type PlanStatus = "draft" | "approved" | "rejected" | "in-progress" | "done";
-
-export type Plan = {
-  slug: string;
-  title: string;
-  status: PlanStatus;
-  createdAt?: number;
-  updatedAt?: number;
-};
-
-// ─── Part (discriminated by `type`) ─────────────────────────────────────
-
-export type TextPart = {
-  type: "text";
-  text: string;
-};
-
-export type ToolCallPart = {
-  type: "tool_call";
-  toolName: string;
-  args: Record<string, unknown>;
-};
-
-export type ToolResultPart = {
-  type: "tool_result";
-  toolName: string;
-  result: Record<string, unknown>;
-  isError?: boolean;
-};
-
-export type ReasoningPart = {
-  type: "reasoning";
-  text: string;
-};
-
-export type Part = TextPart | ToolCallPart | ToolResultPart | ReasoningPart;
-
-// ─── Event (discriminated by `type`) ────────────────────────────────────
-
-export type DashboardConnectedEvent = {
-  type: "dashboard.connected";
-  properties: Record<string, never>;
-};
-
-export type SessionCreatedEvent = {
-  type: "session.created";
-  properties: {
-    sessionId: string;
-    agent: string;
-  };
-};
-
-export type SessionUpdatedEvent = {
-  type: "session.updated";
-  properties: {
-    sessionId: string;
-    status: SessionStatus;
-  };
-};
-
-export type SessionIdleEvent = {
-  type: "session.idle";
-  properties: {
-    sessionId: string;
-  };
-};
-
-export type SessionErrorEvent = {
-  type: "session.error";
-  properties: {
-    sessionId: string;
-    error: string;
-  };
-};
-
-export type MessagePartUpdatedEvent = {
-  type: "message.part.updated";
-  properties: {
-    sessionId: string;
-    messageId: string;
-    part: Part;
-  };
-};
-
-export type ToolExecutedEvent = {
-  type: "tool.executed";
-  properties: {
-    sessionId: string;
-    toolName: string;
-    durationMs?: number;
-  };
-};
-
-export type PlanUpdatedEvent = {
-  type: "plan.updated";
-  properties: {
-    slug: string;
-    status: PlanStatus;
-  };
-};
-
-export type DashboardEvent =
-  | DashboardConnectedEvent
-  | SessionCreatedEvent
-  | SessionUpdatedEvent
-  | SessionIdleEvent
-  | SessionErrorEvent
-  | MessagePartUpdatedEvent
-  | ToolExecutedEvent
-  | PlanUpdatedEvent;
-
-// ─── Health ─────────────────────────────────────────────────────────────
-
-export type Health = {
-  status: "ok" | "degraded";
-  uptime: number;
-  version: string;
-};

package/packages/sdk/tests/client.test.ts

@@ -1,217 +0,0 @@
-/**
- * Tests for the createBizarClient factory and its resource methods.
- */
-
-import { describe, it, expect, beforeEach } from "vitest";
-import { createBizarClient } from "../src/client.js";
-import { isBizarError, type BizarError } from "../src/errors.js";
-import type { Session } from "../src/types.js";
-import { makeFetchMock, type FetchMock } from "./fixtures/fetch-mock.js";
-
-describe("createBizarClient", () => {
-  let m: FetchMock;
-
-  beforeEach(() => {
-    m = makeFetchMock();
-  });
-
-  it("attaches HTTP basic auth header with username 'cline'", async () => {
-    m.respondWith("GET", "/sessions", { status: 200, body: "[]" });
-
-    const client = createBizarClient({
-      baseUrl: "http://127.0.0.1:4098",
-      password: "secret123",
-      fetch: m.fetch,
-    });
-
-    const result = await client.sessions.list();
-    expect(isBizarError(result)).toBe(false);
-    expect(m.lastRequest).not.toBeNull();
-    expect(m.lastRequest!.headers["Authorization"]).toBe(
-      `Basic ${Buffer.from("cline:secret123").toString("base64")}`,
-    );
-  });
-
-  it("GET /sessions returns an array of sessions on 200", async () => {
-    const sessions: Session[] = [
-      {
-        id: "bgr_1",
-        agent: "mimir",
-        status: "running",
-        toolCallCount: 0,
-        worktree: "/tmp",
-        createdAt: 1,
-        updatedAt: 2,
-      },
-    ];
-    m.respondWith("GET", "/sessions", { status: 200, body: JSON.stringify(sessions) });
-
-    const client = createBizarClient({
-      baseUrl: "http://127.0.0.1:4098",
-      password: "x",
-      fetch: m.fetch,
-    });
-
-    const result = await client.sessions.list();
-    expect(isBizarError(result)).toBe(false);
-    expect(result).toEqual(sessions);
-    expect(m.lastRequest!.method).toBe("GET");
-  });
-
-  it("POST /sessions sends JSON body and returns 201 session", async () => {
-    const created: Session = {
-      id: "bgr_2",
-      agent: "thor",
-      status: "pending",
-      toolCallCount: 0,
-      worktree: "/tmp",
-      createdAt: 1,
-      updatedAt: 1,
-    };
-    m.respondWith("POST", "/sessions", { status: 201, body: JSON.stringify(created) });
-
-    const client = createBizarClient({
-      baseUrl: "http://127.0.0.1:4098",
-      password: "x",
-      fetch: m.fetch,
-    });
-
-    const result = await client.sessions.create({
-      agent: "thor",
-      prompt: "hello",
-    });
-
-    expect(isBizarError(result)).toBe(false);
-    expect(result).toEqual(created);
-    expect(m.lastRequest!.method).toBe("POST");
-    expect(m.lastRequest!.headers["Content-Type"]).toBe("application/json");
-    const body = JSON.parse(m.lastRequest!.body!);
-    expect(body.agent).toBe("thor");
-    expect(body.prompt).toBe("hello");
-  });
-
-  it("DELETE /sessions/:id returns null on 204", async () => {
-    m.respondWith("DELETE", "/sessions/bgr_2", { status: 204, body: "" });
-
-    const client = createBizarClient({
-      baseUrl: "http://127.0.0.1:4098",
-      password: "x",
-      fetch: m.fetch,
-    });
-
-    const result = await client.sessions.abort({ sessionId: "bgr_2" });
-    expect(isBizarError(result)).toBe(false);
-    expect(result).toBeNull();
-  });
-
-  it("returns a DashboardError on 4xx (not thrown by default)", async () => {
-    m.respondWith("GET", "/sessions/missing", {
-      status: 404,
-      body: JSON.stringify({ name: "DashboardError", data: { statusCode: 404, message: "Session not found" } }),
-    });
-
-    const client = createBizarClient({
-      baseUrl: "http://127.0.0.1:4098",
-      password: "x",
-      fetch: m.fetch,
-    });
-
-    const result = await client.sessions.get({ sessionId: "missing" });
-    expect(isBizarError(result)).toBe(true);
-    if (isBizarError(result)) {
-      expect(result.name).toBe("DashboardError");
-      if (result.name === "DashboardError") {
-        expect(result.data.statusCode).toBe(404);
-        expect(result.data.message).toBe("Session not found");
-      }
-    }
-  });
-
-  it("returns an APIError on 5xx with isRetryable=true", async () => {
-    m.respondWith("GET", "/sessions", { status: 503, body: "service unavailable" });
-
-    const client = createBizarClient({
-      baseUrl: "http://127.0.0.1:4098",
-      password: "x",
-      fetch: m.fetch,
-    });
-
-    const result = await client.sessions.list();
-    expect(isBizarError(result)).toBe(true);
-    if (isBizarError(result)) {
-      expect(result.name).toBe("APIError");
-      if (result.name === "APIError") {
-        expect(result.data.statusCode).toBe(503);
-        expect(result.data.isRetryable).toBe(true);
-      }
-    }
-  });
-
-  it("returns a ConnectionError when fetch throws", async () => {
-    m.respondWithError("GET", "/health", new TypeError("fetch failed"));
-
-    const client = createBizarClient({
-      baseUrl: "http://127.0.0.1:4098",
-      password: "x",
-      fetch: m.fetch,
-    });
-
-    const result = await client.health.check();
-    expect(isBizarError(result)).toBe(true);
-    if (isBizarError(result)) {
-      expect(result.name).toBe("ConnectionError");
-      if (result.name === "ConnectionError") {
-        expect(result.data.message).toContain("fetch failed");
-      }
-    }
-  });
-
-  it("throws when throwOnError=true", async () => {
-    m.respondWithError("GET", "/sessions", new TypeError("connection refused"));
-
-    const client = createBizarClient({
-      baseUrl: "http://127.0.0.1:4098",
-      password: "x",
-      fetch: m.fetch,
-      throwOnError: true,
-    });
-
-    await expect(client.sessions.list()).rejects.toMatchObject({
-      name: "ConnectionError",
-    });
-  });
-
-  it("sends query parameters for sessions.list", async () => {
-    m.respondWith("GET", "/sessions", { status: 200, body: "[]" });
-
-    const client = createBizarClient({
-      baseUrl: "http://127.0.0.1:4098",
-      password: "x",
-      fetch: m.fetch,
-    });
-
-    await client.sessions.list({ status: "running", limit: 25 });
-    expect(m.lastRequest!.url).toContain("status=running");
-    expect(m.lastRequest!.url).toContain("limit=25");
-  });
-
-  it("publishes a DashboardEvent via POST /event", async () => {
-    m.respondWith("POST", "/event", { status: 204, body: "" });
-
-    const client = createBizarClient({
-      baseUrl: "http://127.0.0.1:4098",
-      password: "x",
-      fetch: m.fetch,
-    });
-
-    const result = await client.events.publish({
-      type: "session.created",
-      properties: { sessionId: "ses_1", agent: "mimir" },
-    });
-    expect(isBizarError(result)).toBe(false);
-
-    const body = JSON.parse(m.lastRequest!.body!);
-    expect(body.type).toBe("session.created");
-    expect(body.properties.sessionId).toBe("ses_1");
-  });
-});

package/packages/sdk/tests/errors.test.ts

@@ -1,108 +0,0 @@
-/**
- * Tests for the discriminated error model.
- */
-
-import { describe, it, expect } from "vitest";
-import {
-  isBizarError,
-  connectionErrorFrom,
-  dashboardErrorFrom,
-  apiErrorFrom,
-} from "../src/errors.js";
-
-describe("isBizarError", () => {
-  it("returns true for PluginError", () => {
-    expect(
-      isBizarError({
-        name: "PluginError",
-        data: { code: "X", message: "y" },
-      }),
-    ).toBe(true);
-  });
-
-  it("returns true for DashboardError", () => {
-    expect(
-      isBizarError({
-        name: "DashboardError",
-        data: { statusCode: 401, message: "unauth" },
-      }),
-    ).toBe(true);
-  });
-
-  it("returns true for ConnectionError", () => {
-    expect(
-      isBizarError({
-        name: "ConnectionError",
-        data: { message: "fetch failed" },
-      }),
-    ).toBe(true);
-  });
-
-  it("returns true for APIError", () => {
-    expect(
-      isBizarError({
-        name: "APIError",
-        data: { statusCode: 500, isRetryable: true, message: "boom" },
-      }),
-    ).toBe(true);
-  });
-
-  it("returns false for unknown shapes", () => {
-    expect(isBizarError(null)).toBe(false);
-    expect(isBizarError(undefined)).toBe(false);
-    expect(isBizarError("string")).toBe(false);
-    expect(isBizarError({})).toBe(false);
-    expect(isBizarError({ name: "OtherError" })).toBe(false);
-  });
-});
-
-describe("connectionErrorFrom", () => {
-  it("wraps Error instances", () => {
-    const err = connectionErrorFrom(new TypeError("ECONNREFUSED"));
-    expect(err.name).toBe("ConnectionError");
-    expect(err.data.message).toBe("ECONNREFUSED");
-    expect(err.data.cause).toBeInstanceOf(TypeError);
-  });
-
-  it("wraps non-Error values", () => {
-    const err = connectionErrorFrom("weird");
-    expect(err.name).toBe("ConnectionError");
-    expect(err.data.message).toBe("weird");
-  });
-});
-
-describe("dashboardErrorFrom", () => {
-  it("extracts message from JSON body", () => {
-    const err = dashboardErrorFrom(
-      401,
-      JSON.stringify({ data: { message: "auth failed" } }),
-    );
-    expect(err.name).toBe("DashboardError");
-    expect(err.data.statusCode).toBe(401);
-    expect(err.data.message).toBe("auth failed");
-  });
-
-  it("falls back to status-only message when body is not JSON", () => {
-    const err = dashboardErrorFrom(500, "<html>error</html>");
-    expect(err.data.statusCode).toBe(500);
-    expect(err.data.message).toBe("HTTP 500");
-  });
-});
-
-describe("apiErrorFrom", () => {
-  it("marks 5xx as retryable", () => {
-    const err = apiErrorFrom(502, "bad gateway");
-    expect(err.name).toBe("APIError");
-    expect(err.data.isRetryable).toBe(true);
-  });
-
-  it("marks 429 as retryable", () => {
-    const err = apiErrorFrom(429, "rate limit");
-    expect(err.data.isRetryable).toBe(true);
-  });
-
-  it("marks 4xx other than 429 as non-retryable", () => {
-    const err = apiErrorFrom(400, "bad request");
-    expect(err.data.isRetryable).toBe(false);
-  });
-});

package/packages/sdk/tests/events.test.ts

@@ -1,139 +0,0 @@
-/**
- * Tests for the SSE event subscriber.
- */
-
-import { describe, it, expect, beforeEach } from "vitest";
-import { subscribeEvents, parseSseStream } from "../src/events.js";
-import type { DashboardEvent } from "../src/types.js";
-import { sseStream, sseRawStream } from "./fixtures/sse-mock.js";
-import { makeFetchMock, type FetchMock } from "./fixtures/fetch-mock.js";
-
-describe("parseSseStream", () => {
-  it("parses a single event", async () => {
-    const stream = sseStream([
-      { type: "dashboard.connected", properties: {} },
-    ]);
-
-    const controller = new AbortController();
-    const iter = parseSseStream<DashboardEvent>(stream, controller);
-    const events: DashboardEvent[] = [];
-    for await (const e of iter) events.push(e);
-
-    expect(events).toHaveLength(1);
-    expect(events[0].type).toBe("dashboard.connected");
-  });
-
-  it("parses multiple events in order", async () => {
-    const stream = sseStream([
-      { type: "dashboard.connected", properties: {} },
-      {
-        type: "session.created",
-        properties: { sessionId: "ses_1", agent: "mimir" },
-      },
-      {
-        type: "session.updated",
-        properties: { sessionId: "ses_1", status: "running" },
-      },
-    ]);
-
-    const controller = new AbortController();
-    const iter = parseSseStream<DashboardEvent>(stream, controller);
-    const events: DashboardEvent[] = [];
-    for await (const e of iter) events.push(e);
-
-    expect(events).toHaveLength(3);
-    expect(events.map((e) => e.type)).toEqual([
-      "dashboard.connected",
-      "session.created",
-      "session.updated",
-    ]);
-  });
-
-  it("skips malformed data lines instead of throwing", async () => {
-    const stream = sseRawStream([
-      "event: dashboard.connected\ndata: {not valid json}\n\n",
-      "event: session.created\ndata: {\"type\":\"session.created\",\"properties\":{\"sessionId\":\"ses_1\",\"agent\":\"thor\"}}\n\n",
-    ]);
-
-    const controller = new AbortController();
-    const iter = parseSseStream<DashboardEvent>(stream, controller);
-    const events: DashboardEvent[] = [];
-    for await (const e of iter) events.push(e);
-
-    expect(events).toHaveLength(1);
-    expect(events[0].type).toBe("session.created");
-  });
-
-  it("ignores comment lines starting with ':'", async () => {
-    const stream = sseRawStream([
-      ": this is a comment\n",
-      "event: dashboard.connected\n",
-      "data: {\"type\":\"dashboard.connected\",\"properties\":{}}\n\n",
-    ]);
-
-    const controller = new AbortController();
-    const iter = parseSseStream<DashboardEvent>(stream, controller);
-    const events: DashboardEvent[] = [];
-    for await (const e of iter) events.push(e);
-
-    expect(events).toHaveLength(1);
-  });
-});
-
-describe("subscribeEvents", () => {
-  let m: FetchMock;
-
-  beforeEach(() => {
-    m = makeFetchMock();
-  });
-
-  it("returns subscription that yields parsed events", async () => {
-    const events: DashboardEvent[] = [
-      { type: "dashboard.connected", properties: {} },
-      {
-        type: "session.created",
-        properties: { sessionId: "ses_1", agent: "mimir" },
-      },
-    ];
-
-    m.respondWithStream("GET", "/event", sseStream(events));
-
-    const sub = await subscribeEvents(
-      "http://127.0.0.1:4098",
-      "Basic xyz",
-      {},
-      m.fetch,
-    );
-
-    const received: DashboardEvent[] = [];
-    for await (const e of sub.stream) received.push(e);
-
-    expect(received).toHaveLength(2);
-    expect(received[0].type).toBe("dashboard.connected");
-    expect(received[1].type).toBe("session.created");
-
-    expect(m.lastRequest!.headers["Accept"]).toBe("text/event-stream");
-    expect(m.lastRequest!.headers["Authorization"]).toBe("Basic xyz");
-  });
-
-  it("aborts the fetch when subscription.close() is called", async () => {
-    // Long-lived stream that blocks
-    const blockedStream = new ReadableStream<Uint8Array>({
-      start() {
-        /* never closes */
-      },
-    });
-
-    m.respondWithStream("GET", "/event", blockedStream);
-
-    const sub = await subscribeEvents(
-      "http://127.0.0.1:4098",
-      "Basic xyz",
-      {},
-      m.fetch,
-    );
-
-    sub.close();
-    // No assertion needed beyond "did not hang"
-  });
-});