Function register

openclaw-plugin/src/index.js:198–433

(api)

  version: VERSION,

  register(api) {
    const isDisabled =
      process.env.UNCOMMON_ROUTE_DISABLED === "true" ||
      process.env.UNCOMMON_ROUTE_DISABLED === "1";
    if (isDisabled) {
      api.logger.info("UncommonRoute disabled via UNCOMMON_ROUTE_DISABLED");
      return;
    }

    const cfg = api.pluginConfig || {};
    const port = cfg.port || Number(process.env.UNCOMMON_ROUTE_PORT) || DEFAULT_PORT;
    const upstream = cfg.upstream || process.env.UNCOMMON_ROUTE_UPSTREAM || DEFAULT_UPSTREAM;
    const baseUrl = `http://127.0.0.1:${port}/v1`;

    if (!upstream) {
      api.logger.warn("UncommonRoute: No upstream configured. Set UNCOMMON_ROUTE_UPSTREAM or configure 'upstream' in plugin config.");
      api.logger.warn("  Example: UNCOMMON_ROUTE_UPSTREAM=https://api.commonstack.ai/v1 UNCOMMON_ROUTE_API_KEY=csk-...");
    }

    // 1. Register provider immediately (sync, models available right away)
    api.registerProvider({
      id: "uncommon-route",
      label: "UncommonRoute",
      docsPath: "https://github.com/CommonstackAI/UncommonRoute",
      aliases: ["ur", "uncommon"],
      envVars: [],
      get models() { return buildModels(baseUrl); },
      auth: [],
    });

    if (!api.config.models) api.config.models = { providers: {} };
    if (!api.config.models.providers) api.config.models.providers = {};
    api.config.models.providers["uncommon-route"] = buildModels(baseUrl);

    api.logger.info(`UncommonRoute provider registered (${MODELS.length} models)`);

    // 2. Register commands
    api.registerCommand({
      name: "route",
      description: "Show which model UncommonRoute would pick for a prompt",
      acceptsArgs: true,
      requireAuth: false,
      handler: async (ctx) => {
        const prompt = (ctx.args || ctx.commandBody || "").trim();
        if (!prompt) return { text: "Usage: /route <prompt>" };
        try {
          const resp = await fetch(`http://127.0.0.1:${port}/v1/chat/completions`, {
            method: "POST",
            headers: { "content-type": "application/json" },
            body: JSON.stringify({ model: "uncommon-route/auto", messages: [{ role: "user", content: `/debug ${prompt}` }] }),
            signal: AbortSignal.timeout(5000),
          });
          lastRequestId = resp.headers.get("x-uncommon-route-request-id");
          lastTier = resp.headers.get("x-uncommon-route-tier");
          const data = await resp.json();
          let text = data?.choices?.[0]?.message?.content || "No response";
          if (lastRequestId) {
            text += `\n\n_Rate this: \`/feedback ok\` · \`/feedback weak\` · \`/feedback strong\`_`;