@stagewhisper/stagewhisper 0.49.0 → 0.52.0

package/plugin-main.ts

@@ -1,342 +0,0 @@
-import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
-import { stagewhisperPlugin } from "./src/channel.js";
-import { setRuntime } from "./src/runtime.js";
-import { createRelayService } from "./src/service.js";
-
-async function ensureResponsesEndpoint(api: Parameters<Parameters<typeof definePluginEntry>[0]["register"]>[0]): Promise<void> {
-  try {
-    const cfg = await api.runtime.config.loadConfig();
-    const gw = ((cfg as Record<string, unknown>)["gateway"] ?? {}) as Record<string, unknown>;
-    const http = (gw["http"] ?? {}) as Record<string, unknown>;
-    const endpoints = (http["endpoints"] ?? {}) as Record<string, unknown>;
-    const responses = (endpoints["responses"] ?? {}) as Record<string, unknown>;
-
-    if (responses["enabled"] === true) return;
-
-    const auth = (gw["auth"] ?? {}) as Record<string, unknown>;
-    if (auth["mode"] === "none" && !auth["token"] && !auth["password"]) return;
-
-    responses["enabled"] = true;
-    endpoints["responses"] = responses;
-    http["endpoints"] = endpoints;
-    gw["http"] = http;
-    (cfg as Record<string, unknown>)["gateway"] = gw;
-
-    await api.runtime.config.writeConfigFile(cfg);
-    api.logger.info(
-      "Enabled gateway.http.endpoints.responses for StageWhisper reasoning. Restart the gateway for it to take effect.",
-    );
-  } catch {
-    // best-effort — reasoning-check will surface the real error
-  }
-}
-
-export default definePluginEntry({
-  id: "stagewhisper",
-  name: "StageWhisper",
-  description: "Turn live call moments into assistant tasks via StageWhisper",
-  register(api) {
-    api.registerChannel({ plugin: stagewhisperPlugin });
-
-    api.registerCli(
-      ({ program }) => {
-        const sw = program
-          .command("stagewhisper")
-          .description("StageWhisper integration");
-
-        sw.command("pair")
-          .description(
-            "Pair with StageWhisper using a pairing code from the desktop app",
-          )
-          .requiredOption("--code <code>", "Pairing code from Settings → Assistant")
-          .option(
-            "--api-url <url>",
-            "StageWhisper backend URL",
-            "https://api.stagewhisper.io",
-          )
-          .option("--label <label>", "Label for this OpenClaw host", "OpenClaw")
-          .option("--no-enable-responses", "Skip enabling the gateway OpenResponses HTTP API")
-          .action(
-            async (opts: {
-              code: string;
-              apiUrl: string;
-              label?: string;
-              enableResponses: boolean;
-            }) => {
-              const { StageWhisperClient } = await import("./src/client.js");
-              const client = new StageWhisperClient(opts.apiUrl, "", "");
-              try {
-                const result = await client.completePairing(
-                  opts.code,
-                  opts.label ?? "OpenClaw",
-                );
-
-                const cfg = await api.runtime.config.loadConfig();
-                const plugins = (cfg as Record<string, unknown>)["plugins"] as Record<string, unknown> ?? {};
-                const entries = plugins["entries"] as Record<string, Record<string, unknown>> ?? {};
-                const swEntry = entries["stagewhisper"] ?? {};
-                const swConfig = (swEntry["config"] as Record<string, unknown>) ?? {};
-
-                swConfig["apiBaseUrl"] = opts.apiUrl;
-                swConfig["integrationId"] = result.integration_id;
-                swConfig["relayToken"] = result.relay_token;
-                swConfig["label"] = result.label;
-                swEntry["config"] = swConfig;
-                entries["stagewhisper"] = swEntry;
-                plugins["entries"] = entries;
-                (cfg as Record<string, unknown>)["plugins"] = plugins;
-
-                const channels = ((cfg as Record<string, unknown>)["channels"] ?? {}) as Record<string, Record<string, unknown>>;
-                channels["stagewhisper"] = {
-                  apiBaseUrl: opts.apiUrl,
-                  integrationId: result.integration_id,
-                  relayToken: result.relay_token,
-                  label: result.label,
-                };
-                (cfg as Record<string, unknown>)["channels"] = channels;
-
-                if (opts.enableResponses) {
-                  const gw = ((cfg as Record<string, unknown>)["gateway"] ?? {}) as Record<string, unknown>;
-                  const gwAuth = (gw["auth"] as Record<string, unknown>) ?? {};
-                  const authMode = gwAuth["mode"] as string | undefined;
-                  const hasToken = typeof gwAuth["token"] === "string" && (gwAuth["token"] as string).length > 0;
-
-                  if (authMode === "none" && !hasToken) {
-                    console.warn("  ⚠ gateway.auth.mode is 'none' with no token — skipping HTTP API enablement.");
-                    console.warn("    Set a gateway auth token first for reasoning to work.\n");
-                  } else {
-                    const http = (gw["http"] ?? {}) as Record<string, unknown>;
-                    const endpoints = (http["endpoints"] ?? {}) as Record<string, unknown>;
-                    const responses = (endpoints["responses"] ?? {}) as Record<string, unknown>;
-                    responses["enabled"] = true;
-                    endpoints["responses"] = responses;
-                    http["endpoints"] = endpoints;
-                    gw["http"] = http;
-                    (cfg as Record<string, unknown>)["gateway"] = gw;
-                  }
-                }
-
-                await api.runtime.config.writeConfigFile(cfg);
-
-                console.log(
-                  `\n✓ Paired with StageWhisper (${result.label})`,
-                );
-                console.log("  Config saved. Restart the gateway to activate:\n");
-                console.log("  openclaw gateway restart\n");
-              } catch (err) {
-                console.error(`\n✗ Pairing failed: ${err}\n`);
-                process.exit(1);
-              }
-            },
-          );
-
-        sw.command("unpair")
-          .description(
-            "Remove StageWhisper pairing (run before `openclaw plugins uninstall`)",
-          )
-          .option("--keep-responses", "Keep the OpenResponses HTTP API enabled after unpair")
-          .action(async (opts: { keepResponses?: boolean }) => {
-            try {
-              const cfg = await api.runtime.config.loadConfig();
-              const plugins = (cfg as Record<string, unknown>)["plugins"] as Record<string, unknown> ?? {};
-              const entries = plugins["entries"] as Record<string, Record<string, unknown>> ?? {};
-              const swEntry = entries["stagewhisper"];
-              if (swEntry) {
-                delete swEntry["config"];
-              }
-
-              const channels = (cfg as Record<string, unknown>)["channels"] as Record<string, unknown> | undefined;
-              if (channels?.["stagewhisper"]) {
-                delete channels["stagewhisper"];
-                if (Object.keys(channels).length === 0) {
-                  delete (cfg as Record<string, unknown>)["channels"];
-                }
-              }
-
-              if (!opts.keepResponses) {
-                const gw = (cfg as Record<string, unknown>)["gateway"] as Record<string, unknown> | undefined;
-                const http = gw?.["http"] as Record<string, unknown> | undefined;
-                const endpoints = http?.["endpoints"] as Record<string, unknown> | undefined;
-                const responses = endpoints?.["responses"] as Record<string, unknown> | undefined;
-                if (responses?.["enabled"] === true) {
-                  delete responses["enabled"];
-                  if (Object.keys(responses).length === 0 && endpoints) delete endpoints["responses"];
-                  if (endpoints && Object.keys(endpoints).length === 0 && http) delete http["endpoints"];
-                  if (http && Object.keys(http).length === 0 && gw) delete gw["http"];
-                  console.log("  ℹ Disabled gateway.http.endpoints.responses. Use --keep-responses to preserve it.");
-                }
-              }
-
-              await api.runtime.config.writeConfigFile(cfg);
-              console.log("\n✓ StageWhisper unpaired.");
-              console.log("  Config cleaned. You can now safely uninstall:\n");
-              console.log("  openclaw plugins uninstall stagewhisper\n");
-            } catch (err) {
-              console.error(`\n✗ Unpair failed: ${err}\n`);
-              process.exit(1);
-            }
-          });
-
-        sw.command("reasoning-check")
-          .description("Test reasoning capability against the local OpenResponses endpoint")
-          .option("--model <model>", "Model to use (omit to use your configured default)", "openclaw/default")
-          .action(async (opts: { model: string }) => {
-            const { callOpenResponses, isResponsesEndpointEnabled } = await import("./src/openresponses.js");
-            const modelLabel = opts.model === "openclaw/default" ? "default (configured)" : opts.model;
-
-            const cfg = api.config as Record<string, unknown>;
-            const gw = (cfg?.gateway as Record<string, unknown>) ?? {};
-            const auth = (gw?.auth as Record<string, unknown>) ?? {};
-            const port = Number(gw?.port) || 18789;
-            const hasToken = typeof auth?.token === "string" && auth.token.length > 0;
-            const responsesEnabled = isResponsesEndpointEnabled(api);
-
-            console.log("Preflight checks:");
-            console.log(`  Gateway port:       ${port}`);
-            console.log(`  Auth token:         ${hasToken ? "✓ present" : "✗ MISSING"}`);
-            console.log(`  responses.enabled:  ${responsesEnabled ? "✓ true" : "✗ false"}`);
-
-            if (!responsesEnabled) {
-              console.warn("\n⚠ responses.enabled is false in the running config.");
-              console.warn("  The plugin auto-enables it on startup — restart the gateway if you haven't:");
-              console.warn("  openclaw gateway restart\n");
-            }
-
-            if (!hasToken) {
-              console.warn("\n⚠ No gateway auth token found — request may be rejected.\n");
-            }
-
-            console.log(`\nTesting reasoning with model: ${modelLabel}`);
-            console.log("Sending test request to local /v1/responses ...");
-
-            const testSchema = {
-              type: "object",
-              properties: {
-                signals: {
-                  type: "array",
-                  items: {
-                    type: "object",
-                    properties: {
-                      severity: { type: "string", enum: ["green", "orange", "red"] },
-                      message: { type: "string" },
-                    },
-                    required: ["severity", "message"],
-                    additionalProperties: false,
-                  },
-                },
-                no_signal_reason: { type: "string" },
-              },
-              required: ["signals", "no_signal_reason"],
-              additionalProperties: false,
-            };
-
-            const start = Date.now();
-            try {
-              const result = await callOpenResponses(api, {
-                model: opts.model,
-                input: JSON.stringify({
-                  transcript: "Candidate: I think we should use Redis for caching.",
-                  playbook_guidance: "Evaluate technical decisions",
-                }),
-                instructions: [
-                  'You are a structured reasoning engine for the "reasoning_test" task.',
-                  "You MUST respond with a JSON object conforming to this schema.",
-                  "Output ONLY valid JSON. No markdown fences, no explanation, no extra text.",
-                  "",
-                  "JSON Schema:",
-                  JSON.stringify(testSchema, null, 2),
-                ].join("\n"),
-                max_output_tokens: 1024,
-              });
-
-              const elapsed = Date.now() - start;
-              console.log(`✓ Response received in ${elapsed}ms`);
-              console.log(`  Run ID: ${result.id}`);
-              if (result.usage) {
-                console.log(
-                  `  Tokens: ${result.usage.input_tokens} in / ${result.usage.output_tokens} out`,
-                );
-              }
-
-              const output = result.output;
-              const msgItem = Array.isArray(output)
-                ? (output.find((o) => o.type === "message") as Record<string, unknown> | undefined)
-                : null;
-              const textContent = msgItem
-                ? ((msgItem.content as Array<Record<string, unknown>>)?.find(
-                    (c) => c.type === "output_text",
-                  )?.text as string | undefined)
-                : null;
-              if (textContent) {
-                const cleaned = textContent.replace(/^```(?:json)?\s*\n?/i, "").replace(/\n?```\s*$/, "").trim();
-                try {
-                  const parsed = JSON.parse(cleaned);
-                  console.log("  Schema-valid JSON: ✓");
-                  console.log(`  Output: ${JSON.stringify(parsed, null, 2)}`);
-                } catch {
-                  console.log("  Schema-valid JSON: ✗ (parse error)");
-                  console.log(`  Raw text: ${textContent.slice(0, 500)}`);
-                }
-              }
-            } catch (err) {
-              const elapsed = Date.now() - start;
-              console.error(`✗ Reasoning check failed after ${elapsed}ms`);
-              console.error(
-                `  Error: ${err instanceof Error ? err.message : String(err)}`,
-              );
-              process.exitCode = 1;
-            }
-          });
-
-        sw.command("status")
-          .description("Show StageWhisper relay connection status")
-          .action(async () => {
-            const cfg = api.pluginConfig as Record<string, string> | undefined;
-            const configured = !!(
-              cfg?.["integrationId"] && cfg?.["relayToken"]
-            );
-
-            if (!configured) {
-              console.log("\nStageWhisper: not paired\n");
-              console.log(
-                "  Run: openclaw stagewhisper pair --code <CODE> [--api-url <URL>]\n",
-              );
-              console.log(
-                "  Get the pairing code from StageWhisper desktop: Settings → Assistant → Generate Pairing Code\n",
-              );
-              return;
-            }
-
-            const apiBaseUrl = cfg?.["apiBaseUrl"] ?? "(unset)";
-            console.log(`\nStageWhisper:`);
-            console.log(`  Backend: ${apiBaseUrl}`);
-            console.log(`  Integration: ${cfg?.["integrationId"]}`);
-            console.log(`  Label: ${cfg?.["label"] ?? "(unset)"}`);
-
-            if (cfg?.["apiBaseUrl"] && cfg?.["integrationId"] && cfg?.["relayToken"]) {
-              try {
-                const { StageWhisperClient } = await import("./src/client.js");
-                const client = new StageWhisperClient(
-                  cfg["apiBaseUrl"],
-                  cfg["integrationId"],
-                  cfg["relayToken"],
-                );
-                await client.heartbeat();
-                console.log("  Connection: ✓ reachable\n");
-              } catch (err) {
-                console.log(`  Connection: ✗ ${err}\n`);
-              }
-            }
-          });
-      },
-      { commands: ["stagewhisper"] },
-    );
-
-    if (api.registrationMode !== "full") return;
-
-    ensureResponsesEndpoint(api);
-    setRuntime(api.runtime);
-    const service = createRelayService(api);
-    api.registerService(service);
-  },
-});

package/src/channel.test.ts

@@ -1,201 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from "vitest";
-import { StageWhisperClient } from "./client.js";
-
-describe("StageWhisperClient", () => {
-  beforeEach(() => {
-    vi.restoreAllMocks();
-  });
-
-  describe("completePairing", () => {
-    it("sends pairing code and returns credentials", async () => {
-      const mockResponse = {
-        integration_id: "int-123",
-        relay_token: "tok-abc",
-        label: "StageWhisper (openclaw)",
-      };
-
-      vi.stubGlobal(
-        "fetch",
-        vi.fn().mockResolvedValue({
-          ok: true,
-          json: () => Promise.resolve(mockResponse),
-        }),
-      );
-
-      const client = new StageWhisperClient("https://sw.test", "", "");
-      const result = await client.completePairing("ABC123", "MyHost");
-
-      expect(fetch).toHaveBeenCalledWith(
-        "https://sw.test/api/v1/openclaw/pair/complete",
-        expect.objectContaining({
-          method: "POST",
-          body: JSON.stringify({
-            pairing_code: "ABC123",
-            host_label: "MyHost",
-          }),
-        }),
-      );
-
-      expect(result.integration_id).toBe("int-123");
-      expect(result.relay_token).toBe("tok-abc");
-    });
-
-    it("throws on failure", async () => {
-      vi.stubGlobal(
-        "fetch",
-        vi.fn().mockResolvedValue({
-          ok: false,
-          status: 400,
-          text: () => Promise.resolve("Invalid code"),
-        }),
-      );
-
-      const client = new StageWhisperClient("https://sw.test", "", "");
-      await expect(client.completePairing("BAD", "Host")).rejects.toThrow(
-        "Pairing failed (400)",
-      );
-    });
-  });
-
-  describe("postReply", () => {
-    it("sends reply content to the correct endpoint", async () => {
-      vi.stubGlobal(
-        "fetch",
-        vi.fn().mockResolvedValue({
-          ok: true,
-          json: () => Promise.resolve({ ok: true }),
-        }),
-      );
-
-      const client = new StageWhisperClient(
-        "https://sw.test",
-        "int-1",
-        "tok-1",
-      );
-      await client.postReply("task-42", "Here is the answer", "msg-99");
-
-      expect(fetch).toHaveBeenCalledWith(
-        "https://sw.test/api/v1/openclaw/tasks/task-42/reply",
-        expect.objectContaining({
-          method: "POST",
-          headers: expect.objectContaining({
-            Authorization: "Bearer tok-1",
-          }),
-          body: JSON.stringify({
-            content: "Here is the answer",
-            remote_message_id: "msg-99",
-          }),
-        }),
-      );
-    });
-  });
-
-  describe("updateTaskStatus", () => {
-    it("sends status update", async () => {
-      vi.stubGlobal(
-        "fetch",
-        vi.fn().mockResolvedValue({
-          ok: true,
-          json: () => Promise.resolve({ ok: true }),
-        }),
-      );
-
-      const client = new StageWhisperClient(
-        "https://sw.test",
-        "int-1",
-        "tok-1",
-      );
-      await client.updateTaskStatus("task-42", "running", "remote-77");
-
-      expect(fetch).toHaveBeenCalledWith(
-        "https://sw.test/api/v1/openclaw/tasks/task-42/status",
-        expect.objectContaining({
-          method: "POST",
-          body: JSON.stringify({
-            status: "running",
-            remote_task_id: "remote-77",
-          }),
-        }),
-      );
-    });
-  });
-
-  describe("heartbeat", () => {
-    it("sends heartbeat and returns response", async () => {
-      vi.stubGlobal(
-        "fetch",
-        vi.fn().mockResolvedValue({
-          ok: true,
-          json: () => Promise.resolve({ ok: true }),
-        }),
-      );
-
-      const client = new StageWhisperClient(
-        "https://sw.test",
-        "int-1",
-        "tok-1",
-      );
-      const result = await client.heartbeat();
-
-      expect(result.ok).toBe(true);
-      expect(fetch).toHaveBeenCalledWith(
-        "https://sw.test/api/v1/openclaw/integrations/int-1/heartbeat",
-        expect.objectContaining({
-          method: "POST",
-          headers: expect.objectContaining({
-            Authorization: "Bearer tok-1",
-          }),
-        }),
-      );
-    });
-  });
-
-  describe("streamUrl", () => {
-    it("builds correct stream URL", () => {
-      const client = new StageWhisperClient(
-        "https://sw.test/",
-        "int-1",
-        "tok-1",
-      );
-      expect(client.streamUrl()).toBe(
-        "https://sw.test/api/v1/openclaw/integrations/int-1/stream",
-      );
-    });
-  });
-});
-
-describe("config resolution", () => {
-  it("resolveAccount extracts config from channels.stagewhisper", async () => {
-    const { stagewhisperPlugin } = await import("./channel.js");
-
-    const cfg = {
-      channels: {
-        stagewhisper: {
-          apiBaseUrl: "https://sw.test",
-          integrationId: "int-1",
-          relayToken: "tok-1",
-          label: "My SW",
-        },
-      },
-    } as unknown as import("openclaw/plugin-sdk/core").OpenClawConfig;
-
-    const base = stagewhisperPlugin.base;
-    if (base?.setup?.resolveAccount) {
-      const account = base.setup.resolveAccount(cfg);
-      expect(account.apiBaseUrl).toBe("https://sw.test");
-      expect(account.integrationId).toBe("int-1");
-      expect(account.relayToken).toBe("tok-1");
-      expect(account.label).toBe("My SW");
-    }
-  });
-
-  it("resolveAccount throws when config is missing", async () => {
-    const { stagewhisperPlugin } = await import("./channel.js");
-
-    const cfg = { channels: {} } as unknown as import("openclaw/plugin-sdk/core").OpenClawConfig;
-    const base = stagewhisperPlugin.base;
-    if (base?.setup?.resolveAccount) {
-      expect(() => base.setup.resolveAccount(cfg)).toThrow("apiBaseUrl is required");
-    }
-  });
-});