@shadowob/connector 1.1.3-dev.281 → 1.1.4

package/README.md

@@ -98,6 +98,11 @@ export SHADOW_SLASH_COMMANDS_JSON='[]'
 
 ## cc-connect
 
+The connector uses the ShadowOB-capable fork
+`buggyblues/cc-connect@63b5d59`. It does not install the official npm
+`cc-connect` package, because the npm package currently points to the upstream
+`chenhg5/cc-connect` release line.
+
 ```bash
 npx @shadowob/connector@latest connect \
   --target cc-connect \
@@ -105,9 +110,18 @@ npx @shadowob/connector@latest connect \
   --token buddy-token \
   --work-dir . \
   --project-name shadow-buddy \
-  --agent-type codex
+  --agent-type codex \
+  --install \
+  --start
 ```
 
+With `--install`, the CLI first tries the fork's GitHub release asset matching
+the local OS/CPU and verifies its pinned SHA-256. If the fork release asset is
+missing or does not match, it pulls the pinned source archive, builds a `no_web`
+Go binary, caches it under
+`~/.shadowob/connector/cc-connect/63b5d59/bin/`, and starts that binary when
+`--start` is present.
+
 Equivalent TOML:
 
 ```toml
@@ -115,8 +129,12 @@ language = "zh"
 
 [[projects]]
 name = "shadow-buddy"
+
+[projects.agent]
+type = "codex"
+
+[projects.agent.options]
 work_dir = "."
-agent_type = "codex"
 
 [[projects.platforms]]
 type = "shadowob"
@@ -160,6 +178,6 @@ The tests cover plan generation, config merging for OpenClaw/Hermes/cc-connect,
 
 ## Capability Coverage
 
-- OpenClaw: channel messages, DMs, threads, mentions, attachments/images, interactive components, slash commands, online status, typing/activity, reactions, edits/deletes.
-- Hermes Agent: channel messages, DMs, threads, attachments/images, interactive components, slash commands, online status, typing/activity, cron delivery.
-- cc-connect: channel messages, DMs, attachments/images, interactive components, slash commands, typing, streaming previews, forms.
+- OpenClaw: channel messages, DMs, threads, mentions, attachments/images, interactive components, slash commands, online status, typing/activity, reactions, edits/deletes, status checks, usage/cost telemetry, multi-Agent Buddy binding, Shadow CLI login/notifications, official skills, cron tasks.
+- Hermes Agent: channel messages, DMs, threads, attachments/images, interactive components, slash commands, online status, typing/activity, cron delivery, status checks, usage/cost telemetry, Shadow CLI login/notifications, official skills.
+- cc-connect: channel messages, DMs, attachments/images, interactive components, slash commands, typing, streaming previews, forms, status checks, usage/cost telemetry, multi-Agent Buddy binding, Shadow CLI login/notifications.

package/dist/cli.js

@@ -1,11 +1,280 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { spawnSync } from "child_process";
-import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { spawnSync as spawnSync2 } from "child_process";
+import { cpSync, existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, writeFileSync as writeFileSync2 } from "fs";
+import { homedir as homedir2 } from "os";
+import { dirname as dirname2, resolve as resolve2 } from "path";
+import { fileURLToPath } from "url";
+
+// src/cc-connect-installer.ts
+import { execFileSync, spawnSync } from "child_process";
+import { createHash } from "crypto";
+import {
+  chmodSync,
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  renameSync,
+  rmSync,
+  writeFileSync
+} from "fs";
+import { get as httpGet } from "http";
+import { get as httpsGet } from "https";
 import { homedir } from "os";
 import { dirname, resolve } from "path";
-import { fileURLToPath } from "url";
+
+// src/cc-connect-fork.ts
+var CC_CONNECT_FORK_REPO = "buggyblues/cc-connect";
+var CC_CONNECT_FORK_REF = "63b5d59127b3004bc7002f2d51892b1f2a91ea83";
+var CC_CONNECT_FORK_SHORT_REF = CC_CONNECT_FORK_REF.slice(0, 7);
+var CC_CONNECT_FORK_PACKAGE_VERSION = "1.3.3-beta.5";
+var CC_CONNECT_FORK_DOCS_URL = `https://github.com/${CC_CONNECT_FORK_REPO}/blob/main/docs/shadowob.md`;
+
+// src/cc-connect-installer.ts
+var NAME = "cc-connect";
+var RELEASE_ARCHIVE_SHA256 = {
+  "cc-connect-v1.3.3-beta.5-darwin-amd64.tar.gz": "71677cd565f6ea79e186ffc1b842e4548faa3baeb2e3dd2ced25ab2e95c416a3",
+  "cc-connect-v1.3.3-beta.5-darwin-arm64.tar.gz": "c1fc5a3d4cfe6db97a5d864ea844dbfd86345b89cea3d89871330568e6eb43cf",
+  "cc-connect-v1.3.3-beta.5-linux-amd64.tar.gz": "812484d19733044c8c5d67d997a921e351e2ae4e9a200ce5ae258ab338400bc1",
+  "cc-connect-v1.3.3-beta.5-linux-arm64.tar.gz": "290110a60e905f5e25f6133f52c1b3988ab6aeff1b1199318398cfef06f81e9a",
+  "cc-connect-v1.3.3-beta.5-windows-amd64.zip": "a90f8a669a48412fc5896613173b5e9b3dc5fdebdee731b6f6b9d4625a200952",
+  "cc-connect-v1.3.3-beta.5-windows-arm64.zip": "3c5ff24769d95c42b95a717949dc6369169c029e1110ab4bdd76d12e0043d283"
+};
+var PLATFORM_MAP = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows"
+};
+var ARCH_MAP = {
+  x64: "amd64",
+  arm64: "arm64"
+};
+function log(options, message) {
+  options.log?.(message);
+}
+function quoteArg(value) {
+  return /^[A-Za-z0-9_./:@=-]+$/.test(value) ? value : JSON.stringify(value);
+}
+function expandHome(value) {
+  return value.startsWith("~/") ? resolve(homedir(), value.slice(2)) : resolve(value);
+}
+function installRoot() {
+  const override = process.env.SHADOW_CC_CONNECT_HOME?.trim();
+  return override ? expandHome(override) : resolve(homedir(), ".shadowob/connector/cc-connect");
+}
+function binaryName() {
+  return process.platform === "win32" ? `${NAME}.exe` : NAME;
+}
+function cachedBinaryPath() {
+  return resolve(installRoot(), CC_CONNECT_FORK_SHORT_REF, "bin", binaryName());
+}
+function runCommand(command, args, options) {
+  const rendered = [command, ...args].map(quoteArg).join(" ");
+  if (options.dryRun) {
+    console.log(`[dry-run] ${rendered}`);
+    return;
+  }
+  const result = spawnSync(command, args, {
+    cwd: options.cwd,
+    env: options.env,
+    stdio: "inherit"
+  });
+  if (result.status !== 0) {
+    throw new Error(`Command failed with exit code ${result.status ?? "unknown"}: ${rendered}`);
+  }
+}
+function platformInfo() {
+  const platform = PLATFORM_MAP[process.platform];
+  const arch = ARCH_MAP[process.arch];
+  if (!platform || !arch) {
+    throw new Error(
+      `Unsupported cc-connect platform: ${process.platform}/${process.arch}. Supported: linux/darwin/windows x64/arm64`
+    );
+  }
+  return { platform, arch, ext: platform === "windows" ? ".zip" : ".tar.gz" };
+}
+function fetchBuffer(url, redirects = 5) {
+  return new Promise((resolvePromise, reject) => {
+    if (redirects <= 0) {
+      reject(new Error(`Too many redirects for ${url}`));
+      return;
+    }
+    const client = url.startsWith("https:") ? httpsGet : httpGet;
+    const request = client(url, { headers: { "User-Agent": "shadowob-connector" } }, (response) => {
+      const location = response.headers.location;
+      if (response.statusCode && response.statusCode >= 300 && response.statusCode < 400 && location) {
+        response.resume();
+        const next = new URL(location, url).toString();
+        resolvePromise(fetchBuffer(next, redirects - 1));
+        return;
+      }
+      if (response.statusCode !== 200) {
+        response.resume();
+        reject(new Error(`HTTP ${response.statusCode ?? "unknown"} for ${url}`));
+        return;
+      }
+      const chunks = [];
+      response.on("data", (chunk) => chunks.push(chunk));
+      response.on("end", () => resolvePromise(Buffer.concat(chunks)));
+      response.on("error", reject);
+    });
+    request.on("error", reject);
+  });
+}
+function findExtractedBinary(dir) {
+  const expected = binaryName();
+  const entries = readdirSync(dir);
+  if (entries.includes(expected)) return resolve(dir, expected);
+  return entries.filter((entry) => entry.startsWith(NAME)).map((entry) => resolve(dir, entry)).find(
+    (entry) => process.platform === "win32" ? entry.endsWith(".exe") : !entry.endsWith(".gz")
+  );
+}
+function extractReleaseArchive(archivePath, binDir, ext) {
+  if (ext === ".tar.gz") {
+    runCommand("tar", ["xzf", archivePath, "-C", binDir], { dryRun: false });
+  } else {
+    const unzip = spawnSync("unzip", ["-o", archivePath, "-d", binDir], { stdio: "inherit" });
+    if (unzip.status !== 0) {
+      runCommand("powershell", ["-Command", `Expand-Archive -Force '${archivePath}' '${binDir}'`], {
+        dryRun: false
+      });
+    }
+  }
+  const extracted = findExtractedBinary(binDir);
+  const target = resolve(binDir, binaryName());
+  if (!extracted) throw new Error("cc-connect release archive did not contain a binary");
+  if (extracted !== target) renameSync(extracted, target);
+}
+function verifyReleaseChecksum(filename, data) {
+  const expected = RELEASE_ARCHIVE_SHA256[filename];
+  if (!expected) throw new Error(`No pinned SHA-256 for ${filename}`);
+  const actual = createHash("sha256").update(data).digest("hex");
+  if (actual !== expected) {
+    throw new Error(`SHA-256 mismatch for ${filename}: expected ${expected}, got ${actual}`);
+  }
+}
+async function installFromRelease(binaryPath, options) {
+  const { platform, arch, ext } = platformInfo();
+  const version = `v${CC_CONNECT_FORK_PACKAGE_VERSION}`;
+  const filename = `${NAME}-${version}-${platform}-${arch}${ext}`;
+  const url = `https://github.com/${CC_CONNECT_FORK_REPO}/releases/download/${version}/${filename}`;
+  const binDir = dirname(binaryPath);
+  const archivePath = resolve(binDir, `_release${ext}`);
+  log(options, `[cc-connect] Trying fork release asset ${url}`);
+  try {
+    const data = await fetchBuffer(url);
+    verifyReleaseChecksum(filename, data);
+    mkdirSync(binDir, { recursive: true });
+    writeFileSync(archivePath, data);
+    extractReleaseArchive(archivePath, binDir, ext);
+    rmSync(archivePath, { force: true });
+    if (process.platform !== "win32") chmodSync(binaryPath, 493);
+    return true;
+  } catch (error) {
+    rmSync(archivePath, { force: true });
+    log(
+      options,
+      `[cc-connect] Fork release asset unavailable (${error instanceof Error ? error.message : String(error)}); building from source`
+    );
+    return false;
+  }
+}
+async function ensureSourceArchive(options) {
+  const sourceDir = resolve(installRoot(), CC_CONNECT_FORK_SHORT_REF, "source");
+  if (existsSync(resolve(sourceDir, "go.mod"))) return sourceDir;
+  if (existsSync(sourceDir)) rmSync(sourceDir, { recursive: true, force: true });
+  const parent = dirname(sourceDir);
+  const extractDir = resolve(parent, `_source-${process.pid}-${Date.now()}`);
+  const archivePath = resolve(parent, `${CC_CONNECT_FORK_SHORT_REF}.tar.gz`);
+  const sourceUrl = `https://github.com/${CC_CONNECT_FORK_REPO}/archive/${CC_CONNECT_FORK_REF}.tar.gz`;
+  log(options, `[cc-connect] Pulling fork source ${sourceUrl}`);
+  mkdirSync(parent, { recursive: true });
+  const data = await fetchBuffer(sourceUrl);
+  writeFileSync(archivePath, data);
+  mkdirSync(extractDir, { recursive: true });
+  try {
+    runCommand("tar", ["xzf", archivePath, "-C", extractDir], { dryRun: false });
+    const extracted = readdirSync(extractDir, { withFileTypes: true }).find(
+      (entry) => entry.isDirectory()
+    );
+    if (!extracted) throw new Error("cc-connect source archive did not contain a directory");
+    mkdirSync(dirname(sourceDir), { recursive: true });
+    renameSync(resolve(extractDir, extracted.name), sourceDir);
+  } finally {
+    rmSync(archivePath, { force: true });
+    rmSync(extractDir, { recursive: true, force: true });
+  }
+  return sourceDir;
+}
+async function buildFromSource(binaryPath, options) {
+  const sourceDir = await ensureSourceArchive(options);
+  const buildTime = (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z");
+  const ldflags = [
+    "-s",
+    "-w",
+    "-X",
+    "main.version=dev",
+    "-X",
+    `main.commit=${CC_CONNECT_FORK_SHORT_REF}`,
+    "-X",
+    `main.buildTime=${buildTime}`
+  ].join(" ");
+  mkdirSync(dirname(binaryPath), { recursive: true });
+  runCommand(
+    "go",
+    ["build", "-tags", "no_web", "-ldflags", ldflags, "-o", binaryPath, "./cmd/cc-connect"],
+    {
+      cwd: sourceDir,
+      dryRun: false,
+      env: goBuildEnv()
+    }
+  );
+  if (process.platform !== "win32") chmodSync(binaryPath, 493);
+}
+function goBuildEnv() {
+  return {
+    ...process.env,
+    CGO_ENABLED: "0",
+    GOPROXY: process.env.SHADOW_CC_CONNECT_GOPROXY?.trim() || "https://proxy.golang.org,direct",
+    GOSUMDB: process.env.SHADOW_CC_CONNECT_GOSUMDB?.trim() || process.env.GOSUMDB || "sum.golang.org"
+  };
+}
+function binaryLooksUsable(path) {
+  if (!existsSync(path)) return false;
+  try {
+    const out = execFileSync(path, ["--version"], { encoding: "utf8", timeout: 5e3 });
+    return out.includes(CC_CONNECT_FORK_SHORT_REF) || out.includes(CC_CONNECT_FORK_PACKAGE_VERSION);
+  } catch {
+    return false;
+  }
+}
+async function ensureCcConnectFork(options) {
+  const override = process.env.SHADOW_CC_CONNECT_BIN?.trim();
+  if (override) {
+    const binaryPath2 = expandHome(override);
+    if (!existsSync(binaryPath2))
+      throw new Error(`SHADOW_CC_CONNECT_BIN does not exist: ${binaryPath2}`);
+    return { binaryPath: binaryPath2, source: "env" };
+  }
+  const binaryPath = cachedBinaryPath();
+  if (binaryLooksUsable(binaryPath)) {
+    return { binaryPath, source: "cache" };
+  }
+  if (options.dryRun) {
+    console.log(
+      `[dry-run] install ${CC_CONNECT_FORK_REPO}@${CC_CONNECT_FORK_SHORT_REF} -> ${binaryPath}`
+    );
+    return { binaryPath, source: "source" };
+  }
+  mkdirSync(dirname(binaryPath), { recursive: true });
+  const fromRelease = await installFromRelease(binaryPath, options);
+  if (!fromRelease) await buildFromSource(binaryPath, options);
+  if (!binaryLooksUsable(binaryPath)) {
+    throw new Error(`Installed cc-connect binary did not pass version verification: ${binaryPath}`);
+  }
+  return { binaryPath, source: fromRelease ? "release" : "source" };
+}
 
 // src/config-writers.ts
 import { parse as parseDotenv } from "dotenv";
@@ -150,17 +419,30 @@ function tomlArray(value) {
   }
   return tables;
 }
+function ccConnectProjectWorkDir(project) {
+  const agent = asTomlTable(project.agent);
+  const options = asTomlTable(agent.options);
+  return typeof options.work_dir === "string" ? options.work_dir : typeof project.work_dir === "string" ? project.work_dir : void 0;
+}
 function mergeCcConnectConfigContent(existing, values) {
   const root = parseTomlRoot(existing, "cc-connect");
   const projects = tomlArray(root.projects);
-  let project = projects.find((item) => item.name === values.projectName) ?? projects.find((item) => item.work_dir === values.workDir);
+  let project = projects.find((item) => item.name === values.projectName) ?? projects.find((item) => ccConnectProjectWorkDir(item) === values.workDir);
   if (!project) {
     project = {};
     projects.push(project);
   }
   project.name = values.projectName;
-  project.work_dir = values.workDir;
-  project.agent_type = values.agentType;
+  delete project.work_dir;
+  delete project.agent_type;
+  const agent = asTomlTable(project.agent);
+  const agentOptions = asTomlTable(agent.options);
+  agent.type = values.agentType;
+  agent.options = {
+    ...agentOptions,
+    work_dir: values.workDir
+  };
+  project.agent = agent;
   const platforms = tomlArray(project.platforms);
   let shadowPlatform = platforms.find((item) => item.type === "shadowob");
   if (!shadowPlatform) {
@@ -270,7 +552,14 @@ function buildOpenClawPlan(input) {
       "typing",
       "activityStatus",
       "reactions",
-      "editDelete"
+      "editDelete",
+      "statusChecks",
+      "usageCosts",
+      "multiAgentBinding",
+      "shadowCliLogin",
+      "notifications",
+      "officialSkills",
+      "cronTasks"
     ]
   };
 }
@@ -356,7 +645,12 @@ function buildHermesPlan(input) {
       "onlineStatus",
       "typing",
       "activityStatus",
-      "cronDelivery"
+      "cronDelivery",
+      "statusChecks",
+      "usageCosts",
+      "shadowCliLogin",
+      "notifications",
+      "officialSkills"
     ]
   };
 }
@@ -371,8 +665,12 @@ function buildCcConnectPlan(input) {
     "",
     "[[projects]]",
     `name = "${projectName}"`,
+    "",
+    "[projects.agent]",
+    `type = "${agentType}"`,
+    "",
+    "[projects.agent.options]",
     `work_dir = "${workDir}"`,
-    `agent_type = "${agentType}"`,
     "",
     "[[projects.platforms]]",
     'type = "shadowob"',
@@ -385,15 +683,6 @@ function buildCcConnectPlan(input) {
     "share_session_in_channel = false",
     'progress_style = "compact"'
   ].join("\n");
-  const commands = [
-    { label: "Install cc-connect", command: "npm install -g cc-connect" },
-    { label: "Create config directory", command: "mkdir -p ~/.cc-connect" },
-    {
-      label: "Edit config",
-      command: "$EDITOR ~/.cc-connect/config.toml"
-    },
-    { label: "Start cc-connect", command: "cc-connect" }
-  ];
   const connectCommand = [
     "npx @shadowob/connector@latest connect",
     "--target cc-connect",
@@ -403,12 +692,26 @@ function buildCcConnectPlan(input) {
     `--project-name ${shellQuote(projectName)}`,
     `--agent-type ${shellQuote(agentType)}`
   ].join(" ");
+  const installCommand = `${connectCommand} --install`;
+  const startCommand = `${connectCommand} --install --start`;
+  const commands = [
+    {
+      label: "Install ShadowOB cc-connect fork",
+      command: installCommand
+    },
+    { label: "Create config directory", command: "mkdir -p ~/.cc-connect" },
+    {
+      label: "Edit config",
+      command: "$EDITOR ~/.cc-connect/config.toml"
+    },
+    { label: "Start ShadowOB cc-connect fork", command: startCommand }
+  ];
   return {
     target: "cc-connect",
     title: "cc-connect",
-    summary: "Use cc-connect ShadowOB Socket.IO platform support with this Buddy token.",
-    connectCommand,
-    quickCommand: commands.map((item) => item.command).join(" && "),
+    summary: `Use ${CC_CONNECT_FORK_REPO}@${CC_CONNECT_FORK_SHORT_REF} with ShadowOB Socket.IO platform support for this Buddy token.`,
+    connectCommand: startCommand,
+    quickCommand: startCommand,
     commands,
     configBlocks: [{ label: "~/.cc-connect/config.toml", language: "toml", content: tomlConfig }],
     aiPrompt: [
@@ -419,9 +722,9 @@ function buildCcConnectPlan(input) {
       `Project work_dir: ${workDir}`,
       `Agent type: ${agentType}`,
       "",
-      "Install cc-connect, add the TOML platform block, and start cc-connect."
+      `Install ${CC_CONNECT_FORK_REPO}@${CC_CONNECT_FORK_SHORT_REF}, add the TOML platform block, and start cc-connect.`
     ].join("\n"),
-    docsUrl: "https://github.com/buggyblues/cc-connect/blob/main/docs/shadowob.md",
+    docsUrl: CC_CONNECT_FORK_DOCS_URL,
     capabilities: [
       "channelMessages",
       "dms",
@@ -431,7 +734,12 @@ function buildCcConnectPlan(input) {
       "slashCommands",
       "typing",
       "streamingPreviews",
-      "forms"
+      "forms",
+      "statusChecks",
+      "usageCosts",
+      "multiAgentBinding",
+      "shadowCliLogin",
+      "notifications"
     ]
   };
 }
@@ -469,7 +777,7 @@ function usage() {
     "  --agent-type <type>     cc-connect agent type, default codex",
     "  --json                  Print the full plan as JSON",
     "  --force                 Overwrite target config files when needed",
-    "  --install               Install cc-connect when target is cc-connect",
+    "  --install               Install the ShadowOB cc-connect fork when target is cc-connect",
     "  --no-install            Skip Hermes dependency install and plugin enablement",
     "  --start                 Start Hermes gateway or cc-connect after setup",
     "  --dry-run               Show what would be applied without changing files"
@@ -527,28 +835,39 @@ function runShell(command, dryRun) {
     console.log(`[dry-run] ${command}`);
     return;
   }
-  const result = spawnSync(command, { shell: true, stdio: "inherit" });
+  const result = spawnSync2(command, { shell: true, stdio: "inherit" });
   if (result.status !== 0) {
     throw new Error(`Command failed with exit code ${result.status ?? "unknown"}: ${command}`);
   }
 }
+function runBinary(binaryPath, args, dryRun) {
+  const rendered = [binaryPath, ...args].map((arg) => /^[A-Za-z0-9_./:@=-]+$/.test(arg) ? arg : JSON.stringify(arg)).join(" ");
+  if (dryRun) {
+    console.log(`[dry-run] ${rendered}`);
+    return;
+  }
+  const result = spawnSync2(binaryPath, args, { stdio: "inherit" });
+  if (result.status !== 0) {
+    throw new Error(`Command failed with exit code ${result.status ?? "unknown"}: ${rendered}`);
+  }
+}
 function writeFile(path, content, dryRun) {
   if (dryRun) {
     console.log(`[dry-run] write ${path}`);
     return;
   }
-  mkdirSync(dirname(path), { recursive: true });
-  writeFileSync(path, content.endsWith("\n") ? content : `${content}
+  mkdirSync2(dirname2(path), { recursive: true });
+  writeFileSync2(path, content.endsWith("\n") ? content : `${content}
 `);
 }
 function packageRoot() {
-  return resolve(dirname(fileURLToPath(import.meta.url)), "..");
+  return resolve2(dirname2(fileURLToPath(import.meta.url)), "..");
 }
-function expandHome(value) {
-  return value.startsWith("~/") ? resolve(homedir(), value.slice(2)) : resolve(value);
+function expandHome2(value) {
+  return value.startsWith("~/") ? resolve2(homedir2(), value.slice(2)) : resolve2(value);
 }
 function readExisting(path) {
-  return existsSync(path) ? readFileSync(path, "utf8") : "";
+  return existsSync2(path) ? readFileSync(path, "utf8") : "";
 }
 function normalizeServerUrl2(value) {
   const trimmed = value.trim() || "https://shadowob.com";
@@ -556,16 +875,16 @@ function normalizeServerUrl2(value) {
 }
 function hermesPluginSource() {
   const candidates = [
-    resolve(packageRoot(), "hermes-shadowob-plugin"),
-    resolve(process.cwd(), "packages/connector/hermes-shadowob-plugin")
+    resolve2(packageRoot(), "hermes-shadowob-plugin"),
+    resolve2(process.cwd(), "packages/connector/hermes-shadowob-plugin")
   ];
-  const found = candidates.find((candidate) => existsSync(candidate));
+  const found = candidates.find((candidate) => existsSync2(candidate));
   if (!found) throw new Error("Cannot find bundled hermes-shadowob-plugin directory");
   return found;
 }
 function applyOpenClaw(options) {
   const plan = createConnectorPlan(options);
-  const configPath = expandHome(
+  const configPath = expandHome2(
     options.openclawConfig ?? process.env.OPENCLAW_CONFIG ?? "~/.shadowob/openclaw.json"
   );
   console.log("Applying: Install plugin");
@@ -584,16 +903,16 @@ function applyOpenClaw(options) {
 }
 function applyHermes(options) {
   const plan = createConnectorPlan(options);
-  const hermesDir = expandHome(options.hermesHome ?? process.env.HERMES_HOME ?? "~/.hermes");
-  const pluginTarget = resolve(hermesDir, "plugins/shadowob");
-  const envPath = resolve(hermesDir, ".env");
-  const configPath = resolve(hermesDir, "config.yaml");
+  const hermesDir = expandHome2(options.hermesHome ?? process.env.HERMES_HOME ?? "~/.hermes");
+  const pluginTarget = resolve2(hermesDir, "plugins/shadowob");
+  const envPath = resolve2(hermesDir, ".env");
+  const configPath = resolve2(hermesDir, "config.yaml");
   const envBlock = plan.configBlocks.find((block) => block.label === "~/.hermes/.env");
   if (!envBlock) throw new Error("Hermes plan is missing config blocks");
   if (options.dryRun) {
     console.log(`[dry-run] copy ${hermesPluginSource()} -> ${pluginTarget}`);
   } else {
-    mkdirSync(resolve(hermesDir, "plugins"), { recursive: true });
+    mkdirSync2(resolve2(hermesDir, "plugins"), { recursive: true });
     cpSync(hermesPluginSource(), pluginTarget, { recursive: true, force: true });
   }
   const nextEnv = options.force ? envBlock.content : mergeEnvContent(readExisting(envPath), {
@@ -608,7 +927,7 @@ function applyHermes(options) {
   writeFile(configPath, nextConfig, options.dryRun);
   if (options.install) {
     runShell(
-      `python -m pip install -r "${resolve(pluginTarget, "requirements.txt")}"`,
+      `python -m pip install -r "${resolve2(pluginTarget, "requirements.txt")}"`,
       options.dryRun
     );
     runShell("hermes plugins enable shadowob", options.dryRun);
@@ -617,11 +936,11 @@ function applyHermes(options) {
     runShell("hermes gateway", options.dryRun);
   }
 }
-function applyCcConnect(options) {
+async function applyCcConnect(options) {
   const plan = createConnectorPlan(options);
   const configBlock = plan.configBlocks.find((block) => block.label === "~/.cc-connect/config.toml");
   if (!configBlock) throw new Error("cc-connect plan is missing config block");
-  const configPath = resolve(homedir(), ".cc-connect/config.toml");
+  const configPath = resolve2(homedir2(), ".cc-connect/config.toml");
   const nextConfig = options.force ? configBlock.content : mergeCcConnectConfigContent(readExisting(configPath), {
     token: options.token,
     serverUrl: normalizeServerUrl2(options.serverUrl),
@@ -630,14 +949,20 @@ function applyCcConnect(options) {
     agentType: options.agentType?.trim() || "codex"
   });
   writeFile(configPath, nextConfig, options.dryRun);
-  if (options.install) {
-    runShell("npm install -g cc-connect", options.dryRun);
+  let binaryPath;
+  if (options.install || options.start) {
+    const installed = await ensureCcConnectFork({
+      dryRun: options.dryRun,
+      log: (message) => console.log(message)
+    });
+    binaryPath = installed.binaryPath;
+    console.log(`cc-connect binary: ${binaryPath}`);
   }
   if (options.start) {
-    runShell("cc-connect", options.dryRun);
+    runBinary(binaryPath ?? "cc-connect", [], options.dryRun);
   }
 }
-function connect(options) {
+async function connect(options) {
   if (options.target === "openclaw") {
     applyOpenClaw(options);
     return;
@@ -646,18 +971,19 @@ function connect(options) {
     applyHermes(options);
     return;
   }
-  applyCcConnect(options);
+  await applyCcConnect(options);
 }
-try {
+async function main() {
   const options = parseArgs(process.argv.slice(2));
   if (options.command === "connect") {
-    connect(options);
+    await connect(options);
   } else {
     printPlan(options);
   }
-} catch (error) {
+}
+main().catch((error) => {
   console.error(error instanceof Error ? error.message : String(error));
   console.error("");
   console.error(usage());
   process.exit(1);
-}
+});

package/dist/index.cjs

@@ -24,6 +24,14 @@ __export(index_exports, {
   createConnectorPlans: () => createConnectorPlans
 });
 module.exports = __toCommonJS(index_exports);
+
+// src/cc-connect-fork.ts
+var CC_CONNECT_FORK_REPO = "buggyblues/cc-connect";
+var CC_CONNECT_FORK_REF = "63b5d59127b3004bc7002f2d51892b1f2a91ea83";
+var CC_CONNECT_FORK_SHORT_REF = CC_CONNECT_FORK_REF.slice(0, 7);
+var CC_CONNECT_FORK_DOCS_URL = `https://github.com/${CC_CONNECT_FORK_REPO}/blob/main/docs/shadowob.md`;
+
+// src/index.ts
 var DEFAULT_SERVER_URL = "https://shadowob.com";
 var DEFAULT_WORK_DIR = ".";
 var DEFAULT_PROJECT_NAME = "shadow-buddy";
@@ -110,7 +118,14 @@ function buildOpenClawPlan(input) {
       "typing",
       "activityStatus",
       "reactions",
-      "editDelete"
+      "editDelete",
+      "statusChecks",
+      "usageCosts",
+      "multiAgentBinding",
+      "shadowCliLogin",
+      "notifications",
+      "officialSkills",
+      "cronTasks"
     ]
   };
 }
@@ -196,7 +211,12 @@ function buildHermesPlan(input) {
       "onlineStatus",
       "typing",
       "activityStatus",
-      "cronDelivery"
+      "cronDelivery",
+      "statusChecks",
+      "usageCosts",
+      "shadowCliLogin",
+      "notifications",
+      "officialSkills"
     ]
   };
 }
@@ -211,8 +231,12 @@ function buildCcConnectPlan(input) {
     "",
     "[[projects]]",
     `name = "${projectName}"`,
+    "",
+    "[projects.agent]",
+    `type = "${agentType}"`,
+    "",
+    "[projects.agent.options]",
     `work_dir = "${workDir}"`,
-    `agent_type = "${agentType}"`,
     "",
     "[[projects.platforms]]",
     'type = "shadowob"',
@@ -225,15 +249,6 @@ function buildCcConnectPlan(input) {
     "share_session_in_channel = false",
     'progress_style = "compact"'
   ].join("\n");
-  const commands = [
-    { label: "Install cc-connect", command: "npm install -g cc-connect" },
-    { label: "Create config directory", command: "mkdir -p ~/.cc-connect" },
-    {
-      label: "Edit config",
-      command: "$EDITOR ~/.cc-connect/config.toml"
-    },
-    { label: "Start cc-connect", command: "cc-connect" }
-  ];
   const connectCommand = [
     "npx @shadowob/connector@latest connect",
     "--target cc-connect",
@@ -243,12 +258,26 @@ function buildCcConnectPlan(input) {
     `--project-name ${shellQuote(projectName)}`,
     `--agent-type ${shellQuote(agentType)}`
   ].join(" ");
+  const installCommand = `${connectCommand} --install`;
+  const startCommand = `${connectCommand} --install --start`;
+  const commands = [
+    {
+      label: "Install ShadowOB cc-connect fork",
+      command: installCommand
+    },
+    { label: "Create config directory", command: "mkdir -p ~/.cc-connect" },
+    {
+      label: "Edit config",
+      command: "$EDITOR ~/.cc-connect/config.toml"
+    },
+    { label: "Start ShadowOB cc-connect fork", command: startCommand }
+  ];
   return {
     target: "cc-connect",
     title: "cc-connect",
-    summary: "Use cc-connect ShadowOB Socket.IO platform support with this Buddy token.",
-    connectCommand,
-    quickCommand: commands.map((item) => item.command).join(" && "),
+    summary: `Use ${CC_CONNECT_FORK_REPO}@${CC_CONNECT_FORK_SHORT_REF} with ShadowOB Socket.IO platform support for this Buddy token.`,
+    connectCommand: startCommand,
+    quickCommand: startCommand,
     commands,
     configBlocks: [{ label: "~/.cc-connect/config.toml", language: "toml", content: tomlConfig }],
     aiPrompt: [
@@ -259,9 +288,9 @@ function buildCcConnectPlan(input) {
       `Project work_dir: ${workDir}`,
       `Agent type: ${agentType}`,
       "",
-      "Install cc-connect, add the TOML platform block, and start cc-connect."
+      `Install ${CC_CONNECT_FORK_REPO}@${CC_CONNECT_FORK_SHORT_REF}, add the TOML platform block, and start cc-connect.`
     ].join("\n"),
-    docsUrl: "https://github.com/buggyblues/cc-connect/blob/main/docs/shadowob.md",
+    docsUrl: CC_CONNECT_FORK_DOCS_URL,
     capabilities: [
       "channelMessages",
       "dms",
@@ -271,7 +300,12 @@ function buildCcConnectPlan(input) {
       "slashCommands",
       "typing",
       "streamingPreviews",
-      "forms"
+      "forms",
+      "statusChecks",
+      "usageCosts",
+      "multiAgentBinding",
+      "shadowCliLogin",
+      "notifications"
     ]
   };
 }

package/dist/index.js

@@ -1,3 +1,9 @@
+// src/cc-connect-fork.ts
+var CC_CONNECT_FORK_REPO = "buggyblues/cc-connect";
+var CC_CONNECT_FORK_REF = "63b5d59127b3004bc7002f2d51892b1f2a91ea83";
+var CC_CONNECT_FORK_SHORT_REF = CC_CONNECT_FORK_REF.slice(0, 7);
+var CC_CONNECT_FORK_DOCS_URL = `https://github.com/${CC_CONNECT_FORK_REPO}/blob/main/docs/shadowob.md`;
+
 // src/index.ts
 var DEFAULT_SERVER_URL = "https://shadowob.com";
 var DEFAULT_WORK_DIR = ".";
@@ -85,7 +91,14 @@ function buildOpenClawPlan(input) {
       "typing",
       "activityStatus",
       "reactions",
-      "editDelete"
+      "editDelete",
+      "statusChecks",
+      "usageCosts",
+      "multiAgentBinding",
+      "shadowCliLogin",
+      "notifications",
+      "officialSkills",
+      "cronTasks"
     ]
   };
 }
@@ -171,7 +184,12 @@ function buildHermesPlan(input) {
       "onlineStatus",
       "typing",
       "activityStatus",
-      "cronDelivery"
+      "cronDelivery",
+      "statusChecks",
+      "usageCosts",
+      "shadowCliLogin",
+      "notifications",
+      "officialSkills"
     ]
   };
 }
@@ -186,8 +204,12 @@ function buildCcConnectPlan(input) {
     "",
     "[[projects]]",
     `name = "${projectName}"`,
+    "",
+    "[projects.agent]",
+    `type = "${agentType}"`,
+    "",
+    "[projects.agent.options]",
     `work_dir = "${workDir}"`,
-    `agent_type = "${agentType}"`,
     "",
     "[[projects.platforms]]",
     'type = "shadowob"',
@@ -200,15 +222,6 @@ function buildCcConnectPlan(input) {
     "share_session_in_channel = false",
     'progress_style = "compact"'
   ].join("\n");
-  const commands = [
-    { label: "Install cc-connect", command: "npm install -g cc-connect" },
-    { label: "Create config directory", command: "mkdir -p ~/.cc-connect" },
-    {
-      label: "Edit config",
-      command: "$EDITOR ~/.cc-connect/config.toml"
-    },
-    { label: "Start cc-connect", command: "cc-connect" }
-  ];
   const connectCommand = [
     "npx @shadowob/connector@latest connect",
     "--target cc-connect",
@@ -218,12 +231,26 @@ function buildCcConnectPlan(input) {
     `--project-name ${shellQuote(projectName)}`,
     `--agent-type ${shellQuote(agentType)}`
   ].join(" ");
+  const installCommand = `${connectCommand} --install`;
+  const startCommand = `${connectCommand} --install --start`;
+  const commands = [
+    {
+      label: "Install ShadowOB cc-connect fork",
+      command: installCommand
+    },
+    { label: "Create config directory", command: "mkdir -p ~/.cc-connect" },
+    {
+      label: "Edit config",
+      command: "$EDITOR ~/.cc-connect/config.toml"
+    },
+    { label: "Start ShadowOB cc-connect fork", command: startCommand }
+  ];
   return {
     target: "cc-connect",
     title: "cc-connect",
-    summary: "Use cc-connect ShadowOB Socket.IO platform support with this Buddy token.",
-    connectCommand,
-    quickCommand: commands.map((item) => item.command).join(" && "),
+    summary: `Use ${CC_CONNECT_FORK_REPO}@${CC_CONNECT_FORK_SHORT_REF} with ShadowOB Socket.IO platform support for this Buddy token.`,
+    connectCommand: startCommand,
+    quickCommand: startCommand,
     commands,
     configBlocks: [{ label: "~/.cc-connect/config.toml", language: "toml", content: tomlConfig }],
     aiPrompt: [
@@ -234,9 +261,9 @@ function buildCcConnectPlan(input) {
       `Project work_dir: ${workDir}`,
       `Agent type: ${agentType}`,
       "",
-      "Install cc-connect, add the TOML platform block, and start cc-connect."
+      `Install ${CC_CONNECT_FORK_REPO}@${CC_CONNECT_FORK_SHORT_REF}, add the TOML platform block, and start cc-connect.`
     ].join("\n"),
-    docsUrl: "https://github.com/buggyblues/cc-connect/blob/main/docs/shadowob.md",
+    docsUrl: CC_CONNECT_FORK_DOCS_URL,
     capabilities: [
       "channelMessages",
       "dms",
@@ -246,7 +273,12 @@ function buildCcConnectPlan(input) {
       "slashCommands",
       "typing",
       "streamingPreviews",
-      "forms"
+      "forms",
+      "statusChecks",
+      "usageCosts",
+      "multiAgentBinding",
+      "shadowCliLogin",
+      "notifications"
     ]
   };
 }

package/hermes-shadowob-plugin/shadow_sdk.py

@@ -241,6 +241,21 @@ class ShadowAsyncClient:
     async def get_channel(self, channel_id: str) -> JsonDict:
         return await self.request("GET", f"/api/channels/{quote(str(channel_id), safe='')}")
 
+    async def get_channel_bootstrap(
+        self,
+        channel_id: str,
+        *,
+        messages_limit: int | None = None,
+    ) -> JsonDict:
+        params: JsonDict = {}
+        if messages_limit is not None:
+            params["messagesLimit"] = int(messages_limit)
+        return await self.request(
+            "GET",
+            f"/api/channels/{quote(str(channel_id), safe='')}/bootstrap",
+            params=params or None,
+        )
+
     async def get_messages(
         self,
         channel_id: str,
@@ -263,11 +278,20 @@ class ShadowAsyncClient:
     async def get_message(self, message_id: str) -> JsonDict:
         return await self.request("GET", f"/api/messages/{quote(str(message_id), safe='')}")
 
-    async def resolve_attachment_media_url(self, attachment_id: str, *, disposition: str = "inline") -> JsonDict:
+    async def resolve_attachment_media_url(
+        self,
+        attachment_id: str,
+        *,
+        disposition: str = "inline",
+        variant: str | None = None,
+    ) -> JsonDict:
+        params: JsonDict = {"disposition": disposition}
+        if variant:
+            params["variant"] = variant
         return await self.request(
             "GET",
             f"/api/attachments/{quote(str(attachment_id), safe='')}/media-url",
-            params={"disposition": disposition},
+            params=params,
         )
 
     async def send_message(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shadowob/connector",
-  "version": "1.1.3-dev.281",
+  "version": "1.1.4",
   "description": "Shadow connector helpers for OpenClaw, Hermes Agent, and cc-connect",
   "type": "module",
   "main": "./dist/index.js",