@stagewhisper/stagewhisper 0.45.0 → 0.47.0

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "stagewhisper",
   "name": "StageWhisper",
   "description": "Turn live call moments into assistant tasks via StageWhisper",
-  "version": "0.45.0",
+  "version": "0.47.0",
   "channels": [
     "stagewhisper"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stagewhisper/stagewhisper",
-  "version": "0.45.0",
+  "version": "0.47.0",
   "type": "module",
   "description": "OpenClaw channel plugin that connects StageWhisper live calls to your AI assistant",
   "license": "MIT",

package/plugin-main.ts

@@ -3,6 +3,34 @@ 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",
@@ -10,6 +38,8 @@ export default definePluginEntry({
   register(api) {
     api.registerChannel({ plugin: stagewhisperPlugin });
 
+    ensureResponsesEndpoint(api);
+
     api.registerCli(
       ({ program }) => {
         const sw = program
@@ -27,11 +57,13 @@ export default definePluginEntry({
             "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, "", "");
@@ -65,13 +97,33 @@ export default definePluginEntry({
                 };
                 (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 automatically.\n");
-                console.log("  Restart the gateway to activate the relay:\n");
+                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`);
@@ -84,7 +136,8 @@ export default definePluginEntry({
           .description(
             "Remove StageWhisper pairing (run before `openclaw plugins uninstall`)",
           )
-          .action(async () => {
+          .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> ?? {};
@@ -102,6 +155,20 @@ export default definePluginEntry({
                 }
               }
 
+              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");
@@ -116,7 +183,7 @@ export default definePluginEntry({
           .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 } = await import("./src/openresponses.js");
+            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>;
@@ -124,10 +191,47 @@ export default definePluginEntry({
             const auth = (gw?.auth as Record<string, unknown>) ?? {};
             const port = Number(gw?.port) || 18789;
             const hasToken = typeof auth?.token === "string" && auth.token.length > 0;
-            console.log(`Gateway: 127.0.0.1:${port}, auth token: ${hasToken ? "present" : "MISSING"}`);
-            console.log(`Testing reasoning with model: ${modelLabel}`);
+            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, {
@@ -136,34 +240,14 @@ export default definePluginEntry({
                   transcript: "Candidate: I think we should use Redis for caching.",
                   playbook_guidance: "Evaluate technical decisions",
                 }),
-                text: {
-                  format: {
-                    type: "json_schema" as const,
-                    name: "reasoning_test",
-                    schema: {
-                      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,
-                    },
-                    strict: true,
-                  },
-                },
-                temperature: 0.2,
+                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,
               });
 
@@ -177,17 +261,18 @@ export default definePluginEntry({
               }
 
               const output = result.output;
-              const text = Array.isArray(output)
+              const msgItem = Array.isArray(output)
                 ? (output.find((o) => o.type === "message") as Record<string, unknown> | undefined)
                 : null;
-              const textContent = text
-                ? ((text.content as Array<Record<string, unknown>>)?.find(
+              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(textContent);
+                  const parsed = JSON.parse(cleaned);
                   console.log("  Schema-valid JSON: ✓");
                   console.log(`  Output: ${JSON.stringify(parsed, null, 2)}`);
                 } catch {

package/src/openresponses.ts

@@ -16,6 +16,15 @@ function resolveGatewayConfig(api: OpenClawPluginApi): GatewayConfig {
   return { url, apiKey: token };
 }
 
+export function isResponsesEndpointEnabled(api: OpenClawPluginApi): boolean {
+  const cfg = api.config as Record<string, unknown>;
+  const gw = (cfg?.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>) ?? {};
+  return responses?.enabled === true;
+}
+
 export async function callOpenResponses(
   api: OpenClawPluginApi,
   requestBody: OpenResponsesCreateResponseRequestBody,
@@ -44,6 +53,13 @@ export async function callOpenResponses(
 
   if (!response.ok) {
     const body = await response.text().catch(() => "");
+    if (response.status === 404) {
+      throw new OpenResponsesError(
+        "POST /v1/responses returned 404 — the OpenResponses HTTP API is most likely disabled. " +
+        'Enable it in OpenClaw config: gateway.http.endpoints.responses.enabled = true, then restart the gateway.',
+        response.status,
+      );
+    }
     throw new OpenResponsesError(`POST /v1/responses returned ${response.status}: ${body}`, response.status);
   }
   return (await response.json()) as OpenResponsesResponseResource;

package/src/reasoning.ts

@@ -19,7 +19,6 @@ export async function probeOpenResponses(
     model: "openclaw/default",
     input: "Reply with exactly: OK",
     max_output_tokens: 16,
-    temperature: 0,
   };
 
   const controller = new AbortController();
@@ -81,6 +80,23 @@ function extractTextOutput(result: OpenResponsesResponseResource): string | null
   return null;
 }
 
+function buildSchemaInstruction(schema: Record<string, unknown>, purpose: string, systemInstruction?: string): string {
+  const parts: string[] = [];
+  if (systemInstruction) {
+    parts.push(systemInstruction);
+    parts.push("");
+  }
+  parts.push(
+    `You are a structured reasoning engine for the "${purpose}" 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(schema, null, 2),
+  );
+  return parts.join("\n");
+}
+
 export async function executeReasoningJob(
   api: OpenClawPluginApi,
   job: ReasoningJobEnvelope,
@@ -109,17 +125,12 @@ export async function executeReasoningJob(
   const requestBody: OpenResponsesCreateResponseRequestBody = {
     model,
     input: JSON.stringify(job.payload),
-    instructions: (job.payload.system_instruction as string) ?? undefined,
-    text: {
-      format: {
-        type: "json_schema",
-        name: `reasoning_${job.purpose}`,
-        schema: job.response_schema,
-        strict: true,
-      },
-    },
+    instructions: buildSchemaInstruction(
+      job.response_schema,
+      job.purpose,
+      (job.payload.system_instruction as string) ?? undefined,
+    ),
     max_output_tokens: 4096,
-    temperature: 0.2,
   };
 
   const controller = new AbortController();
@@ -131,8 +142,9 @@ export async function executeReasoningJob(
 
     let parsed: Record<string, unknown> | null = null;
     if (textOutput) {
+      const cleaned = textOutput.replace(/^```(?:json)?\s*\n?/i, "").replace(/\n?```\s*$/, "").trim();
       try {
-        parsed = JSON.parse(textOutput) as Record<string, unknown>;
+        parsed = JSON.parse(cleaned) as Record<string, unknown>;
       } catch {
         return {
           job_id: job.job_id,

package/src/service.ts

@@ -7,6 +7,7 @@ import type { StageWhisperAccount } from "./channel.js";
 import { resolveAccount } from "./channel.js";
 import { createHealthTracker } from "./health.js";
 import { executeReasoningJob, probeOpenResponses, type ReasoningJobEnvelope } from "./reasoning.js";
+import { isResponsesEndpointEnabled } from "./openresponses.js";
 
 const HEARTBEAT_INTERVAL_MS = 30_000;
 const RECONNECT_BASE_MS = 1_000;
@@ -497,6 +498,13 @@ export function createRelayService(api: OpenClawPluginApi) {
 
       state.running = true;
 
+      if (!isResponsesEndpointEnabled(api)) {
+        api.logger.warn(
+          "gateway.http.endpoints.responses.enabled is not true — reasoning jobs will fail with 404. " +
+          "Enable it in config and restart the gateway, or re-pair with: openclaw stagewhisper pair --code <CODE> --enable-responses",
+        );
+      }
+
       api.logger.info("Probing /v1/responses to verify local AI connectivity...");
       const probe = await probeOpenResponses(api);
       if (probe.ok) {