chrome-openclaw-sider 1.0.2 → 1.0.26

package/README.md

@@ -14,6 +14,8 @@ npx -y @sider-ai/chrome-openclaw-sider-cli install
 ```
 ================================
 
+This convenience command downloads and executes the installer CLI from npm at runtime. If you prefer a more reviewable path, use the manual `openclaw plugins install/update` commands below instead.
+
 You can also paste this command into the OpenClaw chat box and ask OpenClaw to install it for you. This will install or update the plugin and automatically start terminal pairing.
 
 ## 【【【 Manual installation 】】】
@@ -62,4 +64,12 @@ After entering the pairing code, restart the gateway in Terminal:
 ```bash
 openclaw gateway restart
 ```
-================================
+================================
+
+## Data Handling / Security / Privacy
+
+- The plugin sends Sider conversation content, assistant replies, streaming events, tool-call status, and uploaded attachments to Sider/selfclaw endpoints so Sider can render and route the chat.
+- Pairing or setup exchanges persist the resulting long-lived `token` into your local OpenClaw config at `~/.openclaw/openclaw.json`.
+- When you send a local attachment, the plugin may read files from OpenClaw media roots in order to upload them to Sider. When Sider sends attachments inbound, the plugin may download and save them into OpenClaw-managed media storage.
+- Install and pair this plugin only if you trust the Sider service and are comfortable with the relevant chat content and attachments being transmitted to it.
+- Runtime environment variables: `SIDER_BASE_URL` overrides the default API base URL, and `SIDER_SETUP_TOKEN` provides a setup-token fallback for the default account.

package/README.zh_CN.md

@@ -16,6 +16,8 @@ OpenClaw 官方 Sider 渠道插件，用于在 Sider 中连接 OpenClaw。
 npx -y @sider-ai/chrome-openclaw-sider-cli install
 ```
 
+这个便捷命令会在运行时从 npm 下载并执行安装 CLI。若你希望安装过程更可审查，可改用下面的 `openclaw plugins install/update` 手动命令。
+
 它会自动安装或更新插件，并立即进入终端配对流程。
 
 ## 手动安装
@@ -92,13 +94,13 @@ openclaw channels login --channel chrome-openclaw-sider
 openclaw gateway restart
 ```
 
-## 运行时选项
+## Data handling / Security / Privacy
 
-- `SIDER_BASE_URL`：覆盖默认 API base（`https://selfclaw.apps.wisebox.ai`）
-- `SIDER_SETUP_TOKEN`：默认账号的 setup token 环境变量 fallback
-- `SIDER_SETUP_TOKEN_<ACCOUNT_ID>`：命名账号的 setup token 环境变量 fallback
-- `channels.chrome-openclaw-sider.relayId`：可选自定义 relay ID，默认是 `openclaw-<accountId>`
-- `channels.chrome-openclaw-sider.subscribeSessionIds`：可选的入站 session 过滤列表
+- 插件会把 Sider 会话消息、助手回复、流式事件、工具调用状态以及用户发送的附件传到 Sider/selfclaw 接口，用于聊天展示与路由。
+- 配对或 setup token 换取成功后，长期 `token` 会写回本地 OpenClaw 配置文件 `~/.openclaw/openclaw.json`。
+- 当你发送本地附件时，插件可能会读取 OpenClaw media roots 下的文件并上传到 Sider。收到 Sider 发来的附件时，插件也可能会把文件下载到 OpenClaw 管理的媒体存储中。
+- 只有在你信任 Sider 服务，并接受相关聊天内容和附件会被传输到该服务时，才建议安装和配对这个插件。
+- 运行时环境变量：`SIDER_BASE_URL` 可覆盖默认 API base（`https://sider.ai/api/claw/self`），`SIDER_SETUP_TOKEN` 可作为默认账号的 setup token fallback。
 
 ## 说明
 

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import * as openclaw_plugin_sdk_plugin_entry from 'openclaw/plugin-sdk/plugin-entry';
+import { OpenClawPluginApi } from 'openclaw/plugin-sdk/plugin-entry';
+
+declare const plugin: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: openclaw_plugin_sdk_plugin_entry.OpenClawPluginConfigSchema;
+    register(api: OpenClawPluginApi): void;
+};
+
+export { plugin as default };

package/{index.ts → dist/index.js}

@@ -1,23 +1,21 @@
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
 import { emptyPluginConfigSchema } from "openclaw/plugin-sdk/plugin-entry";
 import { listSiderAccountIds, readSiderAccountConfig } from "./src/account.js";
 import { createSiderAuthSetupService, setSiderAuthRuntime } from "./src/auth.js";
 import {
   emitSiderToolHookEvent,
+  recordSiderAgentEnd,
   recordSiderLlmOutputUsage,
   recordSiderPersistedAgentMessage,
   siderPlugin,
-  setSiderRuntime,
+  setSiderRuntime
 } from "./src/channel.js";
 import { SIDER_PLUGIN_DESCRIPTION, SIDER_PLUGIN_ID, SIDER_PLUGIN_NAME } from "./src/config.js";
-import { registerSiderRemoteBrowserSupport } from "./src/remote-browser-support.js";
-
 const plugin = {
   id: SIDER_PLUGIN_ID,
   name: SIDER_PLUGIN_NAME,
   description: SIDER_PLUGIN_DESCRIPTION,
   configSchema: emptyPluginConfigSchema(),
-  register(api: OpenClawPluginApi) {
+  register(api) {
     setSiderRuntime(api.runtime);
     setSiderAuthRuntime(api.runtime);
     api.registerChannel({ plugin: siderPlugin });
@@ -28,13 +26,12 @@ const plugin = {
           const account = readSiderAccountConfig(cfg, accountId);
           return {
             enabled: account.enabled,
-            setupToken: account.setupToken?.trim() || undefined,
-            token: account.token?.trim() || undefined,
+            setupToken: account.setupToken?.trim() || void 0,
+            token: account.token?.trim() || void 0
           };
-        },
-      }),
+        }
+      })
     );
-    registerSiderRemoteBrowserSupport(api);
     api.on("before_tool_call", async (event, ctx) => {
       await emitSiderToolHookEvent({
         sessionKey: ctx.sessionKey,
@@ -42,7 +39,7 @@ const plugin = {
         toolName: event.toolName ?? ctx.toolName,
         toolCallId: event.toolCallId ?? ctx.toolCallId,
         runId: event.runId ?? ctx.runId,
-        params: event.params,
+        params: event.params
       });
     });
     api.on("after_tool_call", async (event, ctx) => {
@@ -55,13 +52,13 @@ const plugin = {
         params: event.params,
         result: event.result,
         error: event.error,
-        durationMs: event.durationMs,
+        durationMs: event.durationMs
       });
     });
     api.on("before_message_write", (event, ctx) => {
       recordSiderPersistedAgentMessage({
         sessionKey: ctx.sessionKey,
-        message: event.message,
+        message: event.message
       });
     });
     api.on("llm_output", (event, ctx) => {
@@ -71,10 +68,20 @@ const plugin = {
         provider: event.provider,
         model: event.model,
         usage: event.usage,
-        lastAssistant: event.lastAssistant,
+        lastAssistant: event.lastAssistant
       });
     });
-  },
+    api.on("agent_end", (event, ctx) => {
+      recordSiderAgentEnd({
+        runId: ctx.runId,
+        success: event.success,
+        error: event.error,
+        messages: event.messages
+      });
+    });
+  }
+};
+var index_default = plugin;
+export {
+  index_default as default
 };
-
-export default plugin;

package/dist/setup-entry.d.ts

@@ -0,0 +1,18 @@
+import * as openclaw_plugin_sdk_core from 'openclaw/plugin-sdk/core';
+import { ResolvedSiderAccount } from './src/account.js';
+export { siderPlugin } from './src/channel.js';
+import 'openclaw/plugin-sdk/setup';
+import './src/auth.js';
+import 'openclaw/plugin-sdk';
+import 'openclaw/plugin-sdk/plugin-entry';
+import './src/auto-title.js';
+import './src/channel-runtime.js';
+import 'ws';
+import './src/channel-types.js';
+import './src/channel-hooks.js';
+
+declare const _default: {
+    plugin: openclaw_plugin_sdk_core.ChannelPlugin<ResolvedSiderAccount>;
+};
+
+export { _default as default };

package/dist/setup-entry.js

@@ -0,0 +1,8 @@
+import { defineSetupPluginEntry } from "openclaw/plugin-sdk/core";
+import { siderPlugin } from "./src/channel.js";
+import { siderPlugin as siderPlugin2 } from "./src/channel.js";
+var setup_entry_default = defineSetupPluginEntry(siderPlugin);
+export {
+  setup_entry_default as default,
+  siderPlugin2 as siderPlugin
+};

package/dist/src/account.d.ts

@@ -0,0 +1,54 @@
+import { OpenClawConfig, ChannelSetupWizard } from 'openclaw/plugin-sdk/setup';
+import { SiderSetupConfigSnapshot } from './auth.js';
+import { SiderAutoTitleConfig } from './auto-title.js';
+import 'openclaw/plugin-sdk';
+import 'openclaw/plugin-sdk/plugin-entry';
+
+type SiderAccountConfig = {
+    enabled?: boolean;
+    name?: string;
+    setupToken?: string;
+    token?: string;
+    autoTitle?: SiderAutoTitleConfig;
+    defaultTo?: string;
+    connectTimeoutMs?: number;
+    sendTimeoutMs?: number;
+    reconnectDelayMs?: number;
+};
+type ResolvedSiderAccount = {
+    accountId: string;
+    name: string;
+    enabled: boolean;
+    gatewayUrl: string;
+    relayId: string;
+    token?: string;
+    defaultTo?: string;
+    connectTimeoutMs: number;
+    sendTimeoutMs: number;
+    reconnectDelayMs: number;
+    configured: boolean;
+    config: SiderAccountConfig;
+};
+declare function readSiderAccountConfig(cfg: OpenClawConfig, accountId?: string | null): SiderSetupConfigSnapshot & SiderAccountConfig;
+declare function resolveSiderAccount(cfg: OpenClawConfig, accountId?: string | null): ResolvedSiderAccount;
+declare function listSiderAccountIds(cfg: OpenClawConfig): string[];
+declare const siderSetupWizard: ChannelSetupWizard;
+declare function describeSiderAccountConfigurationError(account: ResolvedSiderAccount): string;
+declare function isSiderAccountBootstrappable(account: ResolvedSiderAccount): boolean;
+declare function resolveManagedSiderAccount(params: {
+    cfg: OpenClawConfig;
+    accountId?: string | null;
+}): Promise<ResolvedSiderAccount>;
+declare function normalizeSiderMessagingTarget(raw: string): string | undefined;
+declare function looksLikeSiderTargetId(raw: string, normalized?: string): boolean;
+declare function resolveOutboundSessionId(params: {
+    account: ResolvedSiderAccount;
+    to?: string;
+}): string;
+declare function extractSiderToolSend(args: Record<string, unknown>): {
+    to: string;
+    accountId?: string;
+    threadId?: string;
+} | null;
+
+export { type ResolvedSiderAccount, type SiderAccountConfig, describeSiderAccountConfigurationError, extractSiderToolSend, isSiderAccountBootstrappable, listSiderAccountIds, looksLikeSiderTargetId, normalizeSiderMessagingTarget, readSiderAccountConfig, resolveManagedSiderAccount, resolveOutboundSessionId, resolveSiderAccount, siderSetupWizard };

package/{src/account.ts → dist/src/account.js}

@@ -1,16 +1,13 @@
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import {
   createStandardChannelSetupStatus,
-  setSetupChannelEnabled,
-  type ChannelSetupWizard,
-  type OpenClawConfig,
+  setSetupChannelEnabled
 } from "openclaw/plugin-sdk/setup";
 import {
   ensureSiderAccountSetup,
   isSiderAccountSetupPending,
   resolveSiderBaseUrl,
-  resolveSiderSetupToken,
-  type SiderSetupConfigSnapshot,
+  resolveSiderSetupToken
 } from "./auth.js";
 import { SIDER_CHANNEL_ID, SIDER_CHANNEL_LABEL } from "./config.js";
 import {
@@ -20,52 +17,14 @@ import {
   getSiderSetupChannelId,
   requestSiderPairing,
   SiderPairingExpiredError,
-  waitForSiderPairing,
+  waitForSiderPairing
 } from "./setup-core.js";
-
-const DEFAULT_CONNECT_TIMEOUT_MS = 8_000;
-const DEFAULT_SEND_TIMEOUT_MS = 12_000;
-const DEFAULT_RECONNECT_DELAY_MS = 2_000;
-
-export type SiderAccountConfig = {
-  enabled?: boolean;
-  name?: string;
-  setupToken?: string;
-  sessionId?: string;
-  subscribeSessionIds?: string[];
-  relayId?: string;
-  token?: string;
-  defaultTo?: string;
-  connectTimeoutMs?: number;
-  sendTimeoutMs?: number;
-  reconnectDelayMs?: number;
-};
-
-type SiderChannelConfig = SiderAccountConfig & {
-  accounts?: Record<string, SiderAccountConfig>;
-};
-
-export type ResolvedSiderAccount = {
-  accountId: string;
-  name: string;
-  enabled: boolean;
-  gatewayUrl: string;
-  sessionId?: string;
-  subscribeSessionIds?: string[];
-  relayId: string;
-  token?: string;
-  defaultTo?: string;
-  connectTimeoutMs: number;
-  sendTimeoutMs: number;
-  reconnectDelayMs: number;
-  configured: boolean;
-  config: SiderAccountConfig;
-};
-
-const siderEphemeralRelayIds = new Map<string, string>();
+const DEFAULT_CONNECT_TIMEOUT_MS = 8e3;
+const DEFAULT_SEND_TIMEOUT_MS = 12e3;
+const DEFAULT_RECONNECT_DELAY_MS = 2e3;
+const siderEphemeralRelayIds = /* @__PURE__ */ new Map();
 const setupChannel = getSiderSetupChannelId();
-
-function resolveEphemeralRelayId(accountId: string): string {
+function resolveEphemeralRelayId(accountId) {
   const existing = siderEphemeralRelayIds.get(accountId);
   if (existing) {
     return existing;
@@ -74,81 +33,52 @@ function resolveEphemeralRelayId(accountId: string): string {
   siderEphemeralRelayIds.set(accountId, created);
   return created;
 }
-
-function normalizeTimeout(raw: unknown, fallback: number): number {
+function normalizeTimeout(raw, fallback) {
   if (typeof raw !== "number" || !Number.isFinite(raw) || raw <= 0) {
     return fallback;
   }
   return Math.floor(raw);
 }
-
-function normalizeSessionIdList(raw: unknown): string[] | undefined {
-  if (Array.isArray(raw)) {
-    const values = Array.from(
-      new Set(raw.filter((item): item is string => typeof item === "string").map((item) => item.trim()).filter(Boolean)),
-    );
-    return values.length > 0 ? values : undefined;
-  }
-  if (typeof raw === "string" && raw.trim()) {
-    return [raw.trim()];
-  }
-  return undefined;
+function getSiderConfig(cfg) {
+  return cfg.channels?.[SIDER_CHANNEL_ID] ?? {};
 }
-
-function getSiderConfig(cfg: OpenClawConfig): SiderChannelConfig {
-  return (cfg.channels?.[SIDER_CHANNEL_ID] ?? {}) as SiderChannelConfig;
+function hasConfiguredAccountFields(accountCfg) {
+  if (!accountCfg) {
+    return false;
+  }
+  return accountCfg.enabled !== void 0 || Boolean(accountCfg.name?.trim()) || Boolean(accountCfg.setupToken?.trim()) || Boolean(accountCfg.token?.trim()) || accountCfg.autoTitle !== void 0 || Boolean(accountCfg.defaultTo?.trim()) || accountCfg.connectTimeoutMs !== void 0 || accountCfg.sendTimeoutMs !== void 0 || accountCfg.reconnectDelayMs !== void 0;
 }
-
-export function readSiderAccountConfig(
-  cfg: OpenClawConfig,
-  accountId?: string | null,
-): SiderSetupConfigSnapshot & SiderAccountConfig {
+function readSiderAccountConfig(cfg, accountId) {
   const id = normalizeAccountId(accountId) ?? DEFAULT_ACCOUNT_ID;
   const channelCfg = getSiderConfig(cfg);
-  return id === DEFAULT_ACCOUNT_ID ? channelCfg : (channelCfg.accounts?.[id] ?? {});
+  return id === DEFAULT_ACCOUNT_ID ? channelCfg : channelCfg.accounts?.[id] ?? {};
 }
-
-export function resolveSiderAccount(
-  cfg: OpenClawConfig,
-  accountId?: string | null,
-): ResolvedSiderAccount {
+function resolveSiderAccount(cfg, accountId) {
   const id = normalizeAccountId(accountId) ?? DEFAULT_ACCOUNT_ID;
   const accountCfg = readSiderAccountConfig(cfg, id);
   const gatewayUrl = resolveSiderBaseUrl();
-  const sessionId = accountCfg.sessionId?.trim() || undefined;
-  const subscribeSessionIds = normalizeSessionIdList(accountCfg.subscribeSessionIds);
-  const relayId = accountCfg.relayId?.trim() || resolveEphemeralRelayId(id);
-  const token = accountCfg.token?.trim() || undefined;
-  const defaultTo = accountCfg.defaultTo?.trim() || (sessionId ? `session:${sessionId}` : undefined);
-
+  const relayId = resolveEphemeralRelayId(id);
+  const token = accountCfg.token?.trim() || void 0;
+  const defaultTo = accountCfg.defaultTo?.trim() || void 0;
   return {
     accountId: id,
     name: accountCfg.name?.trim() || id,
     enabled: accountCfg.enabled !== false,
     gatewayUrl,
-    sessionId,
-    subscribeSessionIds,
     relayId,
     token,
     defaultTo,
     connectTimeoutMs: normalizeTimeout(accountCfg.connectTimeoutMs, DEFAULT_CONNECT_TIMEOUT_MS),
     sendTimeoutMs: normalizeTimeout(accountCfg.sendTimeoutMs, DEFAULT_SEND_TIMEOUT_MS),
     reconnectDelayMs: normalizeTimeout(accountCfg.reconnectDelayMs, DEFAULT_RECONNECT_DELAY_MS),
-    configured: Boolean(token && relayId),
-    config: accountCfg,
+    configured: Boolean(token),
+    config: accountCfg
   };
 }
-
-export function listSiderAccountIds(cfg: OpenClawConfig): string[] {
+function listSiderAccountIds(cfg) {
   const channelCfg = getSiderConfig(cfg);
-  const ids = new Set<string>();
-  if (
-    channelCfg.enabled !== undefined ||
-    channelCfg.setupToken ||
-    channelCfg.token ||
-    channelCfg.sessionId ||
-    channelCfg.relayId
-  ) {
+  const ids = /* @__PURE__ */ new Set();
+  if (hasConfiguredAccountFields(channelCfg)) {
     ids.add(DEFAULT_ACCOUNT_ID);
   }
   for (const id of Object.keys(channelCfg.accounts ?? {})) {
@@ -156,8 +86,7 @@ export function listSiderAccountIds(cfg: OpenClawConfig): string[] {
   }
   return ids.size > 0 ? Array.from(ids) : [DEFAULT_ACCOUNT_ID];
 }
-
-function isSiderConfiguredForSetup(cfg: OpenClawConfig): boolean {
+function isSiderConfiguredForSetup(cfg) {
   return listSiderAccountIds(cfg).some((accountId) => {
     const account = resolveSiderAccount(cfg, accountId);
     if (account.configured) {
@@ -166,8 +95,7 @@ function isSiderConfiguredForSetup(cfg: OpenClawConfig): boolean {
     return Boolean(resolveSiderSetupToken(accountId, readSiderAccountConfig(cfg, accountId)));
   });
 }
-
-export const siderSetupWizard: ChannelSetupWizard = {
+const siderSetupWizard = {
   channel: setupChannel,
   status: createStandardChannelSetupStatus({
     channelLabel: SIDER_CHANNEL_LABEL,
@@ -178,23 +106,22 @@ export const siderSetupWizard: ChannelSetupWizard = {
     configuredScore: 1,
     unconfiguredScore: 0,
     includeStatusLine: true,
-    resolveConfigured: ({ cfg }) => isSiderConfiguredForSetup(cfg),
+    resolveConfigured: ({ cfg }) => isSiderConfiguredForSetup(cfg)
   }),
   credentials: [],
   finalize: async ({ cfg, accountId, prompter }) => {
-    for (;;) {
+    for (; ; ) {
       const pairing = await requestSiderPairing();
       await prompter.note(
         formatSiderPairingInstructions({ pairingCode: pairing.pairingCode }),
-        "Sider pairing",
+        "Sider pairing"
       );
-
       const progress = prompter.progress("Waiting for connection...");
       const reportPendingUpdate = createSiderPairingPendingUpdateReporter({
         pairingCode: pairing.pairingCode,
         report: (message) => {
           progress.update(message);
-        },
+        }
       });
       try {
         const paired = await waitForSiderPairing({
@@ -202,29 +129,28 @@ export const siderSetupWizard: ChannelSetupWizard = {
           onPending: reportPendingUpdate,
           onRetryableError: (message) => {
             progress.update(message);
-          },
+          }
         });
         progress.stop("Connected.");
-
         await prompter.note(
           "Connected! You can now chat with me in the browser Side Panel.",
-          "Sider connected",
+          "Sider connected"
         );
         return {
           cfg: applySiderSetupAccountConfig({
             cfg,
             accountId,
             input: {
-              token: paired.token,
-            },
-          }),
+              token: paired.token
+            }
+          })
         };
       } catch (error) {
         if (error instanceof SiderPairingExpiredError) {
           progress.stop("Pairing code expired.");
           await prompter.note(
             "Pairing code expired.\nGenerating a new code...",
-            "Sider pairing",
+            "Sider pairing"
           );
           continue;
         }
@@ -233,37 +159,22 @@ export const siderSetupWizard: ChannelSetupWizard = {
       }
     }
   },
-  disable: (cfg) => setSetupChannelEnabled(cfg, setupChannel, false),
+  disable: (cfg) => setSetupChannelEnabled(cfg, setupChannel, false)
 };
-
-export function describeSiderAccountConfigurationError(account: ResolvedSiderAccount): string {
+function describeSiderAccountConfigurationError(account) {
   if (isSiderAccountSetupPending(account.accountId)) {
-    return (
-      `sider account "${account.accountId}" is waiting for setup token exchange; ` +
-      `selfclaw registration is still in progress`
-    );
+    return `sider account "${account.accountId}" is waiting for setup token exchange; selfclaw registration is still in progress`;
   }
-  const missing: string[] = [];
+  const missing = [];
   if (!account.token?.trim()) {
     missing.push("token");
   }
-  if (!account.relayId?.trim()) {
-    missing.push("relayId");
-  }
-  return (
-    `sider account "${account.accountId}" is not configured: missing ${missing.join("/") || "token/relayId"}; ` +
-    `run \`openclaw channels login --channel ${SIDER_CHANNEL_ID}\` or configure a token`
-  );
+  return `sider account "${account.accountId}" is not configured: missing ${missing.join("/") || "token"}; run \`openclaw channels login --channel ${SIDER_CHANNEL_ID}\` or configure a token`;
 }
-
-export function isSiderAccountBootstrappable(account: ResolvedSiderAccount): boolean {
+function isSiderAccountBootstrappable(account) {
   return Boolean(resolveSiderSetupToken(account.accountId, account.config));
 }
-
-export async function resolveManagedSiderAccount(params: {
-  cfg: OpenClawConfig;
-  accountId?: string | null;
-}): Promise<ResolvedSiderAccount> {
+async function resolveManagedSiderAccount(params) {
   const initial = resolveSiderAccount(params.cfg, params.accountId);
   if (!initial.enabled) {
     return initial;
@@ -275,12 +186,11 @@ export async function resolveManagedSiderAccount(params: {
   const nextCfg = await ensureSiderAccountSetup({
     cfg: params.cfg,
     accountId: initial.accountId,
-    getAccountSetupConfig: readSiderAccountConfig,
+    getAccountSetupConfig: readSiderAccountConfig
   });
   return resolveSiderAccount(nextCfg, initial.accountId);
 }
-
-function parseSessionTarget(raw: string): string {
+function parseSessionTarget(raw) {
   const trimmed = raw.trim();
   if (!trimmed) {
     throw new Error("Missing sider session target");
@@ -294,17 +204,15 @@ function parseSessionTarget(raw: string): string {
   }
   return trimmed;
 }
-
-export function normalizeSiderMessagingTarget(raw: string): string | undefined {
+function normalizeSiderMessagingTarget(raw) {
   const trimmed = raw.trim();
   if (!trimmed) {
-    return undefined;
+    return void 0;
   }
   const withoutProviderPrefix = trimmed.replace(/^sider:/i, "").trim();
-  return withoutProviderPrefix || undefined;
+  return withoutProviderPrefix || void 0;
 }
-
-export function looksLikeSiderTargetId(raw: string, normalized?: string): boolean {
+function looksLikeSiderTargetId(raw, normalized) {
   const candidate = (normalized ?? raw ?? "").trim();
   if (!candidate) {
     return false;
@@ -315,25 +223,16 @@ export function looksLikeSiderTargetId(raw: string, normalized?: string): boolea
   }
   return !/\s/.test(candidate);
 }
-
-export function resolveOutboundSessionId(params: {
-  account: ResolvedSiderAccount;
-  to?: string;
-}): string {
+function resolveOutboundSessionId(params) {
   const target = params.to?.trim() || params.account.defaultTo?.trim() || "";
   if (!target) {
     throw new Error(
-      `sider account "${params.account.accountId}" missing target; set 'to' or channels.${SIDER_CHANNEL_ID}.defaultTo`,
+      `sider account "${params.account.accountId}" missing target; set 'to' or channels.${SIDER_CHANNEL_ID}.defaultTo`
     );
   }
   return parseSessionTarget(target);
 }
-
-export function extractSiderToolSend(args: Record<string, unknown>): {
-  to: string;
-  accountId?: string;
-  threadId?: string;
-} | null {
+function extractSiderToolSend(args) {
   const action = typeof args.action === "string" ? args.action.trim() : "";
   if (action !== "sendAttachment" && action !== "send") {
     return null;
@@ -342,9 +241,20 @@ export function extractSiderToolSend(args: Record<string, unknown>): {
   if (!to) {
     return null;
   }
-  const accountId =
-    typeof args.accountId === "string" && args.accountId.trim() ? args.accountId.trim() : undefined;
-  const threadId =
-    typeof args.threadId === "string" && args.threadId.trim() ? args.threadId.trim() : undefined;
+  const accountId = typeof args.accountId === "string" && args.accountId.trim() ? args.accountId.trim() : void 0;
+  const threadId = typeof args.threadId === "string" && args.threadId.trim() ? args.threadId.trim() : void 0;
   return { to, accountId, threadId };
 }
+export {
+  describeSiderAccountConfigurationError,
+  extractSiderToolSend,
+  isSiderAccountBootstrappable,
+  listSiderAccountIds,
+  looksLikeSiderTargetId,
+  normalizeSiderMessagingTarget,
+  readSiderAccountConfig,
+  resolveManagedSiderAccount,
+  resolveOutboundSessionId,
+  resolveSiderAccount,
+  siderSetupWizard
+};

package/dist/src/auth.d.ts

@@ -0,0 +1,30 @@
+import { OpenClawConfig, PluginRuntime } from 'openclaw/plugin-sdk';
+import { OpenClawPluginService } from 'openclaw/plugin-sdk/plugin-entry';
+
+declare const SIDER_AUTH_EXCHANGE_API_PATH = "/v1/claws/register";
+type SiderSetupConfigSnapshot = {
+    enabled?: boolean;
+    setupToken?: string;
+    token?: string;
+};
+type SiderAuthSetupServiceParams = {
+    listAccountIds: (cfg: OpenClawConfig) => string[];
+    getAccountSetupConfig: (cfg: OpenClawConfig, accountId: string) => SiderSetupConfigSnapshot;
+};
+declare function resolveSiderBaseUrl(): string;
+declare function resolveSiderApiUrl(pathname: string): string;
+declare function formatAuthorizationHeader(token: string): string;
+declare function appendTokenQuery(url: string, token?: string): string;
+declare function cloneOpenClawConfig(cfg: OpenClawConfig): OpenClawConfig;
+declare function resolveWritableSiderAccountConfig(cfg: OpenClawConfig, accountId: string): Record<string, unknown>;
+declare function setSiderAuthRuntime(runtime: PluginRuntime): void;
+declare function resolveSiderSetupToken(accountId: string, snapshot?: SiderSetupConfigSnapshot): string | undefined;
+declare function isSiderAccountSetupPending(accountId: string): boolean;
+declare function ensureSiderAccountSetup(params: {
+    cfg: OpenClawConfig;
+    accountId: string;
+    getAccountSetupConfig: (cfg: OpenClawConfig, accountId: string) => SiderSetupConfigSnapshot;
+}): Promise<OpenClawConfig>;
+declare function createSiderAuthSetupService(params: SiderAuthSetupServiceParams): OpenClawPluginService;
+
+export { SIDER_AUTH_EXCHANGE_API_PATH, type SiderSetupConfigSnapshot, appendTokenQuery, cloneOpenClawConfig, createSiderAuthSetupService, ensureSiderAccountSetup, formatAuthorizationHeader, isSiderAccountSetupPending, resolveSiderApiUrl, resolveSiderBaseUrl, resolveSiderSetupToken, resolveWritableSiderAccountConfig, setSiderAuthRuntime };