paperclip/packages/adapters/openclaw/src/server/execute.ts

import type { AdapterExecutionContext, AdapterExecutionResult } from "@paperclipai/adapter-utils";
import { asString } from "@paperclipai/adapter-utils/server-utils";
import { isHookEndpoint } from "./execute-common.js";
import { executeSse } from "./execute-sse.js";
import { executeWebhook } from "./execute-webhook.js";

function normalizeTransport(value: unknown): "sse" | "webhook" | null {
  const normalized = asString(value, "sse").trim().toLowerCase();
  if (!normalized || normalized === "sse") return "sse";
  if (normalized === "webhook") return "webhook";
  return null;
}

export async function execute(ctx: AdapterExecutionContext): Promise<AdapterExecutionResult> {
  const url = asString(ctx.config.url, "").trim();
  if (!url) {
    return {
      exitCode: 1,
      signal: null,
      timedOut: false,
      errorMessage: "OpenClaw adapter missing url",
      errorCode: "openclaw_url_missing",
    };
  }

  const transportInput = ctx.config.streamTransport ?? ctx.config.transport;
  const transport = normalizeTransport(transportInput);
  if (!transport) {
    return {
      exitCode: 1,
      signal: null,
      timedOut: false,
      errorMessage: `OpenClaw adapter does not support transport: ${String(transportInput)}`,
      errorCode: "openclaw_stream_transport_unsupported",
    };
  }

  if (transport === "sse" && isHookEndpoint(url)) {
    return {
      exitCode: 1,
      signal: null,
      timedOut: false,
      errorMessage: "OpenClaw /hooks/* endpoints are not stream-capable. Use webhook transport for hooks.",
      errorCode: "openclaw_sse_incompatible_endpoint",
    };
  }

  if (transport === "webhook") {
    return executeWebhook(ctx, url);
  }

  return executeSse(ctx, url);
}