@polderlabs/bizar 6.2.5 → 6.3.0

package/plugins/bizar/src/tools/bg-send-message.ts

@@ -1,223 +0,0 @@
-/**
- * plugins/bizar/src/tools/bg-send-message.ts
- *
- * v5.5.1 — `bizar_send_message` tool. TRUE mid-flight steer.
- *
- * In v5.5.0 this tool returned `unavailable_in_subprocess_mode` because
- * `cline run` is a one-shot CLI. v5.5.1 switched bg agents to
- * long-lived cline serve SDK sessions, so this tool now delegates
- * to `POST /api/background/<id>/steer` on the dashboard. The dashboard
- * calls `sdk.sessions.prompt()` on the live session, which the
- * cline serve child picks up mid-loop as the next user turn.
- *
- * Wire contract (mirrors `bizar-dash/src/server/routes/background.mjs`):
- *   - Request: `POST /api/background/:id/steer` with body `{ message }`.
- *   - Response: `{ ok, mode: 'true_midflight', newInstanceId: null, instanceId, steerCount }`.
- *
- * Errors surface as `{ ok: false, error }` so callers can react.
- *
- * Cline SDK port (Phase 2):
- *   - Uses `createTool` from `@cline/sdk` directly.
- *   - Adds `name: BIZAR_SEND_MESSAGE_TOOL_NAME`.
- *   - `inputSchema` is `z.object(...)` over the same fields as before.
- *   - Returns structured `{ ok, mode, instanceId, steerCount, message }`
- *     instead of `{ output: JSON.stringify(...) }`.
- */
-import { createTool, type AgentTool } from "@cline/sdk";
-import { z } from "zod";
-
-import type { InstanceManager } from "../background.js";
-import type { Logger } from "../logger.js";
-import { readFileSync, existsSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-
-export const BIZAR_SEND_MESSAGE_TOOL_NAME = "bizar_send_message";
-
-export interface BgSendMessageDeps {
-  instanceManager: InstanceManager;
-  logger: Logger;
-  /**
-   * Optional injection point for tests. When provided, the dashboard
-   * HTTP call is short-circuited and the test function is called with
-   * the resolved request shape.
-   */
-  _dashboardPost?: (url: string, init: { headers: Record<string, string>; body: string }) => Promise<{ ok: boolean; status: number; json: () => Promise<unknown> }>;
-}
-
-export type BizarSendMessageInput = z.infer<typeof bizarSendMessageSchema>;
-export type BizarSendMessageOutput =
-  | {
-      ok: true;
-      mode: string;
-      instanceId: string;
-      steerCount: number;
-      message: string;
-    }
-  | { ok: false; error: string; instanceId?: string };
-
-const bizarSendMessageSchema = z.object({
-  instanceId: z
-    .string()
-    .min(1)
-    .describe("Instance id returned by bizar_spawn_background."),
-  message: z
-    .string()
-    .min(1)
-    .describe("The follow-up instruction to send."),
-});
-
-// --- Dashboard URL + token (mirrors bg-spawn.ts) ------------------------
-
-function resolveDashboardUrl(): string {
-  const fromEnv = process.env.BIZAR_DASHBOARD_URL;
-  if (fromEnv && fromEnv.trim()) return fromEnv.trim().replace(/\/+$/, "");
-  const port = process.env.BIZAR_DASHBOARD_PORT;
-  if (port && /^\d+$/.test(port)) return `http://127.0.0.1:${port}`;
-  return "http://127.0.0.1:4098";
-}
-
-const DEFAULT_DASHBOARD_AUTH_PATHS = [
-  join(homedir(), ".config", "bizar", "dashboard-secret"),
-  join(homedir(), ".cache", "bizarharness", "dash-auth.json"),
-  join(homedir(), ".cache", "bizar", "dash-auth.json"),
-];
-
-function readDashboardToken(): string {
-  for (const candidate of DEFAULT_DASHBOARD_AUTH_PATHS) {
-    try {
-      if (!existsSync(candidate)) continue;
-      const text = readFileSync(candidate, "utf-8").trim();
-      if (text && text.length >= 16) return text;
-    } catch {
-      /* ignore */
-    }
-  }
-  for (const candidate of DEFAULT_DASHBOARD_AUTH_PATHS) {
-    try {
-      if (!existsSync(candidate)) continue;
-      const parsed = JSON.parse(readFileSync(candidate, "utf-8")) as { password?: unknown };
-      if (typeof parsed.password === "string" && parsed.password.length >= 16) {
-        return parsed.password;
-      }
-    } catch {
-      /* ignore */
-    }
-  }
-  return "";
-}
-
-async function postJsonToDashboard(
-  url: string,
-  body: unknown,
-  override?: BgSendMessageDeps["_dashboardPost"],
-): Promise<unknown> {
-  if (override) {
-    const res = await override(url, {
-      headers: { "content-type": "application/json" },
-      body: JSON.stringify(body),
-    });
-    if (!res.ok) {
-      const text = await res.json().catch(() => ({}));
-      const err = new Error(
-        `dashboard HTTP ${res.status}: ${JSON.stringify(text).slice(0, 200)}`,
-      );
-      (err as Error & { httpStatus?: number }).httpStatus = res.status;
-      throw err;
-    }
-    return res.json();
-  }
-  const token = readDashboardToken();
-  const headers: Record<string, string> = {
-    "content-type": "application/json",
-    accept: "application/json",
-  };
-  if (token) headers.authorization = `Bearer ${token}`;
-
-  const ac = new AbortController();
-  const timer = setTimeout(() => ac.abort(), 8_000);
-  try {
-    const res = await fetch(url, {
-      method: "POST",
-      headers,
-      body: JSON.stringify(body),
-      signal: ac.signal,
-    });
-    if (!res.ok) {
-      const text = await res.text().catch(() => "");
-      const err = new Error(
-        `dashboard HTTP ${res.status}: ${text.slice(0, 200)}`,
-      );
-      (err as Error & { httpStatus?: number }).httpStatus = res.status;
-      throw err;
-    }
-    return res.json();
-  } finally {
-    clearTimeout(timer);
-  }
-}
-
-export function createBgSendMessageTool(
-  deps: BgSendMessageDeps,
-): AgentTool<BizarSendMessageInput, BizarSendMessageOutput> {
-  return createTool({
-    name: BIZAR_SEND_MESSAGE_TOOL_NAME,
-    description:
-      "Send a follow-up message to a running background agent. " +
-      "v5.5.1: TRUE mid-flight steer via the cline serve SDK. " +
-      "The same instance keeps running; the new message becomes the next user turn " +
-      "of the running cline session. No kill+respawn, no [STEERED <ts>] marker, " +
-      "no loss of agent context.",
-    inputSchema: bizarSendMessageSchema.shape,
-    execute: async (input, _context) => {
-      // 1. Verify the instance exists so we don't silently accept bogus ids.
-      const inst = await deps.instanceManager.get(input.instanceId);
-      if (!inst) {
-        return {
-          ok: false as const,
-          error: "instance_not_found",
-          instanceId: input.instanceId,
-        };
-      }
-
-      // 2. v5.5.1 — delegate to the dashboard. The dashboard owns the
-      //    cline SDK and calls `sdk.sessions.prompt({...})` on the
-      //    live session, which the cline serve child picks up
-      //    mid-loop as the next user turn.
-      const dashboardUrl = `${resolveDashboardUrl()}/api/background/${encodeURIComponent(input.instanceId)}/steer`;
-      try {
-        const data = (await postJsonToDashboard(
-          dashboardUrl,
-          { message: input.message },
-          deps._dashboardPost,
-        )) as { ok: boolean; mode?: string; steerCount?: number; error?: string };
-        if (!data || data.ok !== true) {
-          return {
-            ok: false as const,
-            error: data?.error || "steer_failed",
-            instanceId: input.instanceId,
-          };
-        }
-        deps.logger.info(
-          `bizar: sendMessage(${input.instanceId}) — TRUE mid-flight steer #${data.steerCount ?? "?"} accepted`,
-        );
-        return {
-          ok: true as const,
-          mode: data.mode || "true_midflight",
-          instanceId: input.instanceId,
-          steerCount: data.steerCount ?? 0,
-          message:
-            "Steer delivered to the running cline session. The agent will pick up your message as the next user turn — no kill+respawn was performed, no context was lost.",
-        };
-      } catch (err: unknown) {
-        const msg = err instanceof Error ? err.message : String(err);
-        deps.logger.warn(`bizar: sendMessage(${input.instanceId}) failed: ${msg}`);
-        return {
-          ok: false as const,
-          error: `steer_failed: ${msg}`,
-          instanceId: input.instanceId,
-        };
-      }
-    },
-  });
-}