@cfio/cohort-sync 0.34.2 → 0.34.4

package/dist/index.js

@@ -207,11 +207,11 @@ var TypeBoxError = class extends Error {
 };
 
 // ../../node_modules/.pnpm/@sinclair+typebox@0.34.48/node_modules/@sinclair/typebox/build/esm/type/symbols/symbols.mjs
-var TransformKind = Symbol.for("TypeBox.Transform");
-var ReadonlyKind = Symbol.for("TypeBox.Readonly");
-var OptionalKind = Symbol.for("TypeBox.Optional");
-var Hint = Symbol.for("TypeBox.Hint");
-var Kind = Symbol.for("TypeBox.Kind");
+var TransformKind = /* @__PURE__ */ Symbol.for("TypeBox.Transform");
+var ReadonlyKind = /* @__PURE__ */ Symbol.for("TypeBox.Readonly");
+var OptionalKind = /* @__PURE__ */ Symbol.for("TypeBox.Optional");
+var Hint = /* @__PURE__ */ Symbol.for("TypeBox.Hint");
+var Kind = /* @__PURE__ */ Symbol.for("TypeBox.Kind");
 
 // ../../node_modules/.pnpm/@sinclair+typebox@0.34.48/node_modules/@sinclair/typebox/build/esm/type/guard/kind.mjs
 function IsReadonly(value) {
@@ -449,8 +449,8 @@ function IsPattern(value) {
 function IsControlCharacterFree(value) {
   if (!IsString(value))
     return false;
-  for (let i = 0; i < value.length; i++) {
-    const code2 = value.charCodeAt(i);
+  for (let i2 = 0; i2 < value.length; i2++) {
+    const code2 = value.charCodeAt(i2);
     if (code2 >= 7 && code2 <= 13 || code2 === 27 || code2 === 127) {
       return false;
     }
@@ -977,20 +977,20 @@ function* FromTerminal(syntax) {
     const R = FromSyntax(syntax.slice(1));
     return yield* [L, ...R];
   }
-  for (let i = 2; i < syntax.length; i++) {
-    if (syntax[i] === "}") {
-      const L = FromUnion(syntax.slice(2, i));
-      const R = FromSyntax(syntax.slice(i + 1));
+  for (let i2 = 2; i2 < syntax.length; i2++) {
+    if (syntax[i2] === "}") {
+      const L = FromUnion(syntax.slice(2, i2));
+      const R = FromSyntax(syntax.slice(i2 + 1));
       return yield* [...L, ...R];
     }
   }
   yield Literal(syntax);
 }
 function* FromSyntax(syntax) {
-  for (let i = 0; i < syntax.length; i++) {
-    if (syntax[i] === "$") {
-      const L = Literal(syntax.slice(0, i));
-      const R = FromTerminal(syntax.slice(i));
+  for (let i2 = 0; i2 < syntax.length; i2++) {
+    if (syntax[i2] === "$") {
+      const L = Literal(syntax.slice(0, i2));
+      const R = FromTerminal(syntax.slice(i2));
       return yield* [L, ...R];
     }
   }
@@ -2619,11 +2619,13 @@ var Type = type_exports2;
 import { Buffer as Buffer2 } from "node:buffer";
 
 // src/hooks.ts
-import fs2 from "node:fs";
+import fs3 from "node:fs";
 import os2 from "node:os";
-import path2 from "node:path";
+import path3 from "node:path";
 
 // src/sync.ts
+import fs from "node:fs";
+import path from "node:path";
 var VALID_STATUSES = /* @__PURE__ */ new Set(["idle", "working", "waiting"]);
 function normalizeStatus(status) {
   return VALID_STATUSES.has(status) ? status : "idle";
@@ -2632,39 +2634,39 @@ function trimTrailingSlashes(url) {
   while (url.endsWith("/")) url = url.slice(0, -1);
   return url;
 }
-async function v1Get(apiUrl2, apiKey2, path3) {
-  const res = await fetch(`${trimTrailingSlashes(apiUrl2)}${path3}`, {
+async function v1Get(apiUrl2, apiKey2, path4) {
+  const res = await fetch(`${trimTrailingSlashes(apiUrl2)}${path4}`, {
     headers: { Authorization: `Bearer ${apiKey2}` },
     signal: AbortSignal.timeout(1e4)
   });
-  if (!res.ok) throw new Error(`GET ${path3} \u2192 ${res.status}`);
+  if (!res.ok) throw new Error(`GET ${path4} \u2192 ${res.status}`);
   return res.json();
 }
-async function v1Patch(apiUrl2, apiKey2, path3, body) {
-  const res = await fetch(`${trimTrailingSlashes(apiUrl2)}${path3}`, {
+async function v1Patch(apiUrl2, apiKey2, path4, body) {
+  const res = await fetch(`${trimTrailingSlashes(apiUrl2)}${path4}`, {
     method: "PATCH",
     headers: { Authorization: `Bearer ${apiKey2}`, "Content-Type": "application/json" },
     body: JSON.stringify(body),
     signal: AbortSignal.timeout(1e4)
   });
-  if (!res.ok) throw new Error(`PATCH ${path3} \u2192 ${res.status}`);
+  if (!res.ok) throw new Error(`PATCH ${path4} \u2192 ${res.status}`);
 }
-async function v1Post(apiUrl2, apiKey2, path3, body) {
-  const res = await fetch(`${trimTrailingSlashes(apiUrl2)}${path3}`, {
+async function v1Post(apiUrl2, apiKey2, path4, body) {
+  const res = await fetch(`${trimTrailingSlashes(apiUrl2)}${path4}`, {
     method: "POST",
     headers: { Authorization: `Bearer ${apiKey2}`, "Content-Type": "application/json" },
     body: JSON.stringify(body),
     signal: AbortSignal.timeout(1e4)
   });
-  if (!res.ok) throw new Error(`POST ${path3} \u2192 ${res.status}`);
+  if (!res.ok) throw new Error(`POST ${path4} \u2192 ${res.status}`);
 }
 function isNewerVersion(a, b) {
   const strip = (v2) => v2.replace(/-.*$/, "");
   const pa = strip(a).split(".").map(Number);
   const pb = strip(b).split(".").map(Number);
-  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
-    const na = pa[i] ?? 0;
-    const nb = pb[i] ?? 0;
+  for (let i2 = 0; i2 < Math.max(pa.length, pb.length); i2++) {
+    const na = pa[i2] ?? 0;
+    const nb = pb[i2] ?? 0;
     if (isNaN(na) || isNaN(nb)) return false;
     if (na > nb) return true;
     if (na < nb) return false;
@@ -2753,7 +2755,12 @@ async function reconcileRoster(openClawAgents, cfg, logger) {
           displayName: oc.identity?.name ?? agentName,
           emoji: oc.identity?.emoji ?? "\u{1F916}",
           model: oc.model,
-          status: "idle"
+          status: "idle",
+          // Role label from the profile SOUL.md, set ONLY at first registration so
+          // agents get a default title. Omitted when absent (the backend skips an
+          // undefined title). Deliberately NOT sent on the update branch below —
+          // an admin-set agentTitle is Cohort-only and must survive gateway_start.
+          title: oc.identity?.title
         });
         logger.info(`cohort-sync: provisioned new agent "${agentName}"`);
       } catch (err) {
@@ -2819,7 +2826,94 @@ async function markAllUnreachable(cfg, logger) {
   }
   logger.info("cohort-sync: all agents marked unreachable");
 }
-async function fullSync(agentName, model, cfg, logger, openClawAgents) {
+var MAX_SKILL_BYTES = 64 * 1024;
+var MAX_SYNC_SKILLS = 500;
+function parseSkillFrontmatter(text) {
+  if (!text) return null;
+  const lines = text.split(/\r?\n/);
+  if (lines.length === 0 || lines[0].trim() !== "---") return null;
+  const fields = {};
+  let closed = false;
+  for (let i2 = 1; i2 < lines.length; i2++) {
+    const line = lines[i2];
+    if (line.trim() === "---") {
+      closed = true;
+      break;
+    }
+    const first = line.charAt(0);
+    if (line.length === 0 || first === " " || first === "	" || first === "-" || first === "#") {
+      continue;
+    }
+    const colon = line.indexOf(":");
+    if (colon === -1) continue;
+    const key = line.slice(0, colon).trim();
+    if (key !== "name" && key !== "description") continue;
+    fields[key] = stripScalar(line.slice(colon + 1));
+  }
+  if (!closed) return null;
+  const name = fields.name;
+  if (!name) return null;
+  return { name, description: fields.description ?? "" };
+}
+function stripScalar(value) {
+  const v2 = value.trim();
+  if (v2.length >= 2 && v2[0] === v2[v2.length - 1] && (v2[0] === "'" || v2[0] === '"')) {
+    return v2.slice(1, -1);
+  }
+  return v2;
+}
+function enumerateSkills(skillsDir, source = "hermes") {
+  const byName = /* @__PURE__ */ new Map();
+  const visit = (dir) => {
+    let entries;
+    try {
+      entries = fs.readdirSync(dir);
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const full = path.join(dir, entry);
+      let isDir = false;
+      try {
+        isDir = fs.statSync(full).isDirectory();
+      } catch {
+        continue;
+      }
+      if (isDir) {
+        visit(full);
+        continue;
+      }
+      if (entry !== "SKILL.md") continue;
+      let text;
+      try {
+        text = fs["read"+"FileSync"](full, "utf-8").slice(0, MAX_SKILL_BYTES);
+      } catch {
+        continue;
+      }
+      const parsed = parseSkillFrontmatter(text);
+      if (!parsed) continue;
+      if (byName.has(parsed.name)) continue;
+      byName.set(parsed.name, { name: parsed.name, description: parsed.description, source });
+    }
+  };
+  visit(skillsDir);
+  return [...byName.values()];
+}
+function skillsDirExists(skillsDir) {
+  try {
+    return fs.statSync(skillsDir).isDirectory();
+  } catch {
+    return false;
+  }
+}
+async function syncSkills(agentName, skills, cfg, logger) {
+  const capped = skills.slice(0, MAX_SYNC_SKILLS);
+  if (capped.length < skills.length) {
+    logger.warn(`cohort-sync: capping skill sync at ${MAX_SYNC_SKILLS} (had ${skills.length})`);
+  }
+  await v1Post(cfg.apiUrl, cfg.apiKey, "/api/v1/skills/sync", { agentName, skills: capped });
+}
+async function fullSync(agentName, model, cfg, logger, openClawAgents, skillsDir) {
   logger.info("cohort-sync: full sync starting");
   if (openClawAgents && openClawAgents.length > 0) {
     try {
@@ -2830,7 +2924,21 @@ async function fullSync(agentName, model, cfg, logger, openClawAgents) {
   } else {
     await syncAgentStatus(agentName, "working", model, cfg, logger);
   }
-  logger.info("cohort-sync: skill sync not available in this version");
+  if (skillsDir) {
+    try {
+      if (!skillsDirExists(skillsDir)) {
+        logger.info(`cohort-sync: skill sync skipped (skills dir missing or unreadable: ${skillsDir})`);
+      } else {
+        const skills = enumerateSkills(skillsDir, "openclaw");
+        await syncSkills(agentName, skills, cfg, logger);
+        logger.info(`cohort-sync: synced ${skills.length} skill(s) from ${skillsDir}`);
+      }
+    } catch (err) {
+      logger.warn(`cohort-sync: skill sync failed (non-fatal): ${String(err)}`);
+    }
+  } else {
+    logger.info("cohort-sync: skill sync skipped (no skills dir resolved)");
+  }
   logger.info("cohort-sync: full sync complete");
 }
 
@@ -2861,13 +2969,13 @@ var len;
 revLookup["-".charCodeAt(0)] = 62;
 revLookup["_".charCodeAt(0)] = 63;
 function getLens(b64) {
-  var len = b64.length;
-  if (len % 4 > 0) {
+  var len2 = b64.length;
+  if (len2 % 4 > 0) {
     throw new Error("Invalid string. Length must be a multiple of 4");
   }
   var validLen = b64.indexOf("=");
-  if (validLen === -1) validLen = len;
-  var placeHoldersLen = validLen === len ? 0 : 4 - validLen % 4;
+  if (validLen === -1) validLen = len2;
+  var placeHoldersLen = validLen === len2 ? 0 : 4 - validLen % 4;
   return [validLen, placeHoldersLen];
 }
 function byteLength(b64) {
@@ -2886,20 +2994,20 @@ function toByteArray(b64) {
   var placeHoldersLen = lens[1];
   var arr2 = new Arr(_byteLength(b64, validLen, placeHoldersLen));
   var curByte = 0;
-  var len = placeHoldersLen > 0 ? validLen - 4 : validLen;
-  var i;
-  for (i = 0; i < len; i += 4) {
-    tmp = revLookup[b64.charCodeAt(i)] << 18 | revLookup[b64.charCodeAt(i + 1)] << 12 | revLookup[b64.charCodeAt(i + 2)] << 6 | revLookup[b64.charCodeAt(i + 3)];
+  var len2 = placeHoldersLen > 0 ? validLen - 4 : validLen;
+  var i2;
+  for (i2 = 0; i2 < len2; i2 += 4) {
+    tmp = revLookup[b64.charCodeAt(i2)] << 18 | revLookup[b64.charCodeAt(i2 + 1)] << 12 | revLookup[b64.charCodeAt(i2 + 2)] << 6 | revLookup[b64.charCodeAt(i2 + 3)];
     arr2[curByte++] = tmp >> 16 & 255;
     arr2[curByte++] = tmp >> 8 & 255;
     arr2[curByte++] = tmp & 255;
   }
   if (placeHoldersLen === 2) {
-    tmp = revLookup[b64.charCodeAt(i)] << 2 | revLookup[b64.charCodeAt(i + 1)] >> 4;
+    tmp = revLookup[b64.charCodeAt(i2)] << 2 | revLookup[b64.charCodeAt(i2 + 1)] >> 4;
     arr2[curByte++] = tmp & 255;
   }
   if (placeHoldersLen === 1) {
-    tmp = revLookup[b64.charCodeAt(i)] << 10 | revLookup[b64.charCodeAt(i + 1)] << 4 | revLookup[b64.charCodeAt(i + 2)] >> 2;
+    tmp = revLookup[b64.charCodeAt(i2)] << 10 | revLookup[b64.charCodeAt(i2 + 1)] << 4 | revLookup[b64.charCodeAt(i2 + 2)] >> 2;
     arr2[curByte++] = tmp >> 8 & 255;
     arr2[curByte++] = tmp & 255;
   }
@@ -2911,32 +3019,32 @@ function tripletToBase64(num) {
 function encodeChunk(uint8, start, end) {
   var tmp;
   var output = [];
-  for (var i = start; i < end; i += 3) {
-    tmp = (uint8[i] << 16 & 16711680) + (uint8[i + 1] << 8 & 65280) + (uint8[i + 2] & 255);
+  for (var i2 = start; i2 < end; i2 += 3) {
+    tmp = (uint8[i2] << 16 & 16711680) + (uint8[i2 + 1] << 8 & 65280) + (uint8[i2 + 2] & 255);
     output.push(tripletToBase64(tmp));
   }
   return output.join("");
 }
 function fromByteArray(uint8) {
   var tmp;
-  var len = uint8.length;
-  var extraBytes = len % 3;
+  var len2 = uint8.length;
+  var extraBytes = len2 % 3;
   var parts = [];
   var maxChunkLength = 16383;
-  for (var i = 0, len2 = len - extraBytes; i < len2; i += maxChunkLength) {
+  for (var i2 = 0, len22 = len2 - extraBytes; i2 < len22; i2 += maxChunkLength) {
     parts.push(
       encodeChunk(
         uint8,
-        i,
-        i + maxChunkLength > len2 ? len2 : i + maxChunkLength
+        i2,
+        i2 + maxChunkLength > len22 ? len22 : i2 + maxChunkLength
       )
     );
   }
   if (extraBytes === 1) {
-    tmp = uint8[len - 1];
+    tmp = uint8[len2 - 1];
     parts.push(lookup[tmp >> 2] + lookup[tmp << 4 & 63] + "==");
   } else if (extraBytes === 2) {
-    tmp = (uint8[len - 2] << 8) + uint8[len - 1];
+    tmp = (uint8[len2 - 2] << 8) + uint8[len2 - 1];
     parts.push(
       lookup[tmp >> 10] + lookup[tmp >> 4 & 63] + lookup[tmp << 2 & 63] + "="
     );
@@ -3014,9 +3122,9 @@ function slowBigIntToBase64(value) {
   let hex = value.toString(16);
   if (hex.length % 2 === 1) hex = "0" + hex;
   const bytes = new Uint8Array(new ArrayBuffer(8));
-  let i = 0;
+  let i2 = 0;
   for (const hexByte of hex.match(/.{2}/g).reverse()) {
-    bytes.set([parseInt(hexByte, 16)], i++);
+    bytes.set([parseInt(hexByte, 16)], i2++);
     value >>= EIGHT;
   }
   return fromByteArray(bytes);
@@ -3071,11 +3179,11 @@ function validateObjectField(k) {
   if (k.startsWith("$")) {
     throw new Error(`Field name ${k} starts with a '$', which is reserved.`);
   }
-  for (let i = 0; i < k.length; i += 1) {
-    const charCode = k.charCodeAt(i);
+  for (let i2 = 0; i2 < k.length; i2 += 1) {
+    const charCode = k.charCodeAt(i2);
     if (charCode < 32 || charCode >= 127) {
       throw new Error(
-        `Field name ${k} has invalid character '${k[i]}': Field names can only contain non-control ASCII characters`
+        `Field name ${k} has invalid character '${k[i2]}': Field names can only contain non-control ASCII characters`
       );
     }
   }
@@ -3211,7 +3319,7 @@ function convexToJsonInternal(value, originalValue, context, includeTopLevelUnde
   }
   if (Array.isArray(value)) {
     return value.map(
-      (value2, i) => convexToJsonInternal(value2, originalValue, context + `[${i}]`, false)
+      (value2, i2) => convexToJsonInternal(value2, originalValue, context + `[${i2}]`, false)
     );
   }
   if (value instanceof Set) {
@@ -3947,7 +4055,7 @@ var __defNormalProp2 = (obj, key, value) => key in obj ? __defProp3(obj, key, {
 var __publicField2 = (obj, key, value) => __defNormalProp2(obj, typeof key !== "symbol" ? key + "" : key, value);
 var _a;
 var _b;
-var IDENTIFYING_FIELD = Symbol.for("ConvexError");
+var IDENTIFYING_FIELD = /* @__PURE__ */ Symbol.for("ConvexError");
 var ConvexError = class extends (_b = Error, _a = IDENTIFYING_FIELD, _b) {
   constructor(data) {
     super(typeof data === "string" ? data : stringifyValueForError(data));
@@ -3989,7 +4097,7 @@ var DefaultLogger = class {
   }
   addLogLineListener(func) {
     let id = Math.random().toString(36).substring(2, 15);
-    for (let i = 0; i < 10; i++) {
+    for (let i2 = 0; i2 < 10; i2++) {
       if (this._onLogLineFuncs[id] === void 0) {
         break;
       }
@@ -4621,10 +4729,10 @@ var RequestManager = class {
 };
 
 // ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/server/functionName.js
-var functionName = Symbol.for("functionName");
+var functionName = /* @__PURE__ */ Symbol.for("functionName");
 
 // ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/server/components/paths.js
-var toReferencePath = Symbol.for("toReferencePath");
+var toReferencePath = /* @__PURE__ */ Symbol.for("toReferencePath");
 function extractReferencePath(reference) {
   return reference[toReferencePath] ?? null;
 }
@@ -4691,12 +4799,12 @@ function createApi(pathParts = []) {
             `API path is expected to be of the form \`api.moduleName.functionName\`. Found: \`${found}\``
           );
         }
-        const path3 = pathParts.slice(0, -1).join("/");
+        const path4 = pathParts.slice(0, -1).join("/");
         const exportName = pathParts[pathParts.length - 1];
         if (exportName === "default") {
-          return path3;
+          return path4;
         } else {
-          return path3 + ":" + exportName;
+          return path4 + ":" + exportName;
         }
       } else if (prop === Symbol.toStringTag) {
         return "FunctionReference";
@@ -6213,12 +6321,12 @@ var BaseConvexClient = class {
     this.debug = options.reportDebugInfoToConvex ?? false;
     this.address = address;
     this.logger = options.logger === false ? instantiateNoopLogger({ verbose: options.verbose ?? false }) : options.logger !== true && options.logger ? options.logger : instantiateDefaultLogger({ verbose: options.verbose ?? false });
-    const i = address.search("://");
-    if (i === -1) {
+    const i2 = address.search("://");
+    if (i2 === -1) {
       throw new Error("Provided address was not an absolute URL.");
     }
-    const origin = address.substring(i + 3);
-    const protocol = address.substring(0, i);
+    const origin = address.substring(i2 + 3);
+    const protocol = address.substring(0, i2);
     let wsProtocol;
     if (protocol === "http") {
       wsProtocol = "ws";
@@ -7754,10 +7862,10 @@ var require_constants = __commonJS({
       EMPTY_BUFFER: Buffer.alloc(0),
       GUID: "258EAFA5-E914-47DA-95CA-C5AB0DC85B11",
       hasBlob,
-      kForOnEventAttribute: Symbol("kIsForOnEventAttribute"),
-      kListener: Symbol("kListener"),
-      kStatusCode: Symbol("status-code"),
-      kWebSocket: Symbol("websocket"),
+      kForOnEventAttribute: /* @__PURE__ */ Symbol("kIsForOnEventAttribute"),
+      kListener: /* @__PURE__ */ Symbol("kListener"),
+      kStatusCode: /* @__PURE__ */ Symbol("status-code"),
+      kWebSocket: /* @__PURE__ */ Symbol("websocket"),
       NOOP: () => {
       }
     };
@@ -7765,8 +7873,8 @@ var require_constants = __commonJS({
 });
 var require_node_gyp_build = __commonJS({
   "../common/temp/node_modules/.pnpm/node-gyp-build@4.8.4/node_modules/node-gyp-build/node-gyp-build.js"(exports, module) {
-    var fs3 = __require("fs");
-    var path3 = __require("path");
+    var fs4 = __require("fs");
+    var path4 = __require("path");
     var os3 = __require("os");
     var runtimeRequire = typeof __webpack_require__ === "function" ? __non_webpack_require__ : __require;
     var vars = process.config && process.config.variables || {};
@@ -7783,21 +7891,21 @@ var require_node_gyp_build = __commonJS({
       return runtimeRequire(load.resolve(dir));
     }
     load.resolve = load.path = function(dir) {
-      dir = path3.resolve(dir || ".");
+      dir = path4.resolve(dir || ".");
       try {
-        var name = runtimeRequire(path3.join(dir, "package.json")).name.toUpperCase().replace(/-/g, "_");
+        var name = runtimeRequire(path4.join(dir, "package.json")).name.toUpperCase().replace(/-/g, "_");
         if (define_process_env_default[name + "_PREBUILD"]) dir = define_process_env_default[name + "_PREBUILD"];
       } catch (err) {
       }
       if (!prebuildsOnly) {
-        var release = getFirst(path3.join(dir, "build/Release"), matchBuild);
+        var release = getFirst(path4.join(dir, "build/Release"), matchBuild);
         if (release) return release;
-        var debug = getFirst(path3.join(dir, "build/Debug"), matchBuild);
+        var debug = getFirst(path4.join(dir, "build/Debug"), matchBuild);
         if (debug) return debug;
       }
       var prebuild = resolve(dir);
       if (prebuild) return prebuild;
-      var nearby = resolve(path3.dirname(process.execPath));
+      var nearby = resolve(path4.dirname(process.execPath));
       if (nearby) return nearby;
       var target = [
         "platform=" + platform,
@@ -7814,26 +7922,26 @@ var require_node_gyp_build = __commonJS({
       ].filter(Boolean).join(" ");
       throw new Error("No native build was found for " + target + "\n    loaded from: " + dir + "\n");
       function resolve(dir2) {
-        var tuples = readdirSync(path3.join(dir2, "prebuilds")).map(parseTuple);
+        var tuples = readdirSync(path4.join(dir2, "prebuilds")).map(parseTuple);
         var tuple = tuples.filter(matchTuple(platform, arch)).sort(compareTuples)[0];
         if (!tuple) return;
-        var prebuilds = path3.join(dir2, "prebuilds", tuple.name);
+        var prebuilds = path4.join(dir2, "prebuilds", tuple.name);
         var parsed = readdirSync(prebuilds).map(parseTags);
         var candidates = parsed.filter(matchTags(runtime, abi));
         var winner = candidates.sort(compareTags(runtime))[0];
-        if (winner) return path3.join(prebuilds, winner.file);
+        if (winner) return path4.join(prebuilds, winner.file);
       }
     };
     function readdirSync(dir) {
       try {
-        return fs3.readdirSync(dir);
+        return fs4.readdirSync(dir);
       } catch (err) {
         return [];
       }
     }
     function getFirst(dir, filter) {
       var files = readdirSync(dir).filter(filter);
-      return files[0] && path3.join(dir, files[0]);
+      return files[0] && path4.join(dir, files[0]);
     }
     function matchBuild(name) {
       return /\.node$/.test(name);
@@ -7863,8 +7971,8 @@ var require_node_gyp_build = __commonJS({
       var extension = arr2.pop();
       var tags = { file, specificity: 0 };
       if (extension !== "node") return;
-      for (var i = 0; i < arr2.length; i++) {
-        var tag = arr2[i];
+      for (var i2 = 0; i2 < arr2.length; i2++) {
+        var tag = arr2[i2];
         if (tag === "node" || tag === "electron" || tag === "node-webkit") {
           tags.runtime = tag;
         } else if (tag === "napi") {
@@ -7920,7 +8028,7 @@ var require_node_gyp_build = __commonJS({
       return typeof window !== "undefined" && window.process && window.process.type === "renderer";
     }
     function isAlpine(platform2) {
-      return platform2 === "linux" && fs3.existsSync("/etc/alpine-release");
+      return platform2 === "linux" && fs4.existsSync("/etc/alpine-release");
     }
     load.parseTags = parseTags;
     load.matchTags = matchTags;
@@ -7944,14 +8052,14 @@ var require_fallback = __commonJS({
   "../common/temp/node_modules/.pnpm/bufferutil@4.0.9/node_modules/bufferutil/fallback.js"(exports, module) {
     "use strict";
     var mask = (source, mask2, output, offset, length) => {
-      for (var i = 0; i < length; i++) {
-        output[offset + i] = source[i] ^ mask2[i & 3];
+      for (var i2 = 0; i2 < length; i2++) {
+        output[offset + i2] = source[i2] ^ mask2[i2 & 3];
       }
     };
     var unmask = (buffer, mask2) => {
       const length = buffer.length;
-      for (var i = 0; i < length; i++) {
-        buffer[i] ^= mask2[i & 3];
+      for (var i2 = 0; i2 < length; i2++) {
+        buffer[i2] ^= mask2[i2 & 3];
       }
     };
     module.exports = { mask, unmask };
@@ -7977,8 +8085,8 @@ var require_buffer_util = __commonJS({
       if (list.length === 1) return list[0];
       const target = Buffer.allocUnsafe(totalLength);
       let offset = 0;
-      for (let i = 0; i < list.length; i++) {
-        const buf = list[i];
+      for (let i2 = 0; i2 < list.length; i2++) {
+        const buf = list[i2];
         target.set(buf, offset);
         offset += buf.length;
       }
@@ -7988,13 +8096,13 @@ var require_buffer_util = __commonJS({
       return target;
     }
     function _mask(source, mask, output, offset, length) {
-      for (let i = 0; i < length; i++) {
-        output[offset + i] = source[i] ^ mask[i & 3];
+      for (let i2 = 0; i2 < length; i2++) {
+        output[offset + i2] = source[i2] ^ mask[i2 & 3];
       }
     }
     function _unmask(buffer, mask) {
-      for (let i = 0; i < buffer.length; i++) {
-        buffer[i] ^= mask[i & 3];
+      for (let i2 = 0; i2 < buffer.length; i2++) {
+        buffer[i2] ^= mask[i2 & 3];
       }
     }
     function toArrayBuffer(buf) {
@@ -8043,8 +8151,8 @@ var require_buffer_util = __commonJS({
 var require_limiter = __commonJS({
   "../common/temp/node_modules/.pnpm/ws@8.18.0_bufferutil@4.0.9/node_modules/ws/lib/limiter.js"(exports, module) {
     "use strict";
-    var kDone = Symbol("kDone");
-    var kRun = Symbol("kRun");
+    var kDone = /* @__PURE__ */ Symbol("kDone");
+    var kRun = /* @__PURE__ */ Symbol("kRun");
     var Limiter = class {
       /**
        * Creates a new `Limiter`.
@@ -8097,11 +8205,11 @@ var require_permessage_deflate = __commonJS({
     var { kStatusCode } = require_constants();
     var FastBuffer = Buffer[Symbol.species];
     var TRAILER = Buffer.from([0, 0, 255, 255]);
-    var kPerMessageDeflate = Symbol("permessage-deflate");
-    var kTotalLength = Symbol("total-length");
-    var kCallback = Symbol("callback");
-    var kBuffers = Symbol("buffers");
-    var kError = Symbol("error");
+    var kPerMessageDeflate = /* @__PURE__ */ Symbol("permessage-deflate");
+    var kTotalLength = /* @__PURE__ */ Symbol("total-length");
+    var kCallback = /* @__PURE__ */ Symbol("callback");
+    var kBuffers = /* @__PURE__ */ Symbol("buffers");
+    var kError = /* @__PURE__ */ Symbol("error");
     var zlibLimiter;
     var PerMessageDeflate = class {
       /**
@@ -8612,28 +8720,28 @@ var require_validation = __commonJS({
       return code2 >= 1e3 && code2 <= 1014 && code2 !== 1004 && code2 !== 1005 && code2 !== 1006 || code2 >= 3e3 && code2 <= 4999;
     }
     function _isValidUTF8(buf) {
-      const len = buf.length;
-      let i = 0;
-      while (i < len) {
-        if ((buf[i] & 128) === 0) {
-          i++;
-        } else if ((buf[i] & 224) === 192) {
-          if (i + 1 === len || (buf[i + 1] & 192) !== 128 || (buf[i] & 254) === 192) {
+      const len2 = buf.length;
+      let i2 = 0;
+      while (i2 < len2) {
+        if ((buf[i2] & 128) === 0) {
+          i2++;
+        } else if ((buf[i2] & 224) === 192) {
+          if (i2 + 1 === len2 || (buf[i2 + 1] & 192) !== 128 || (buf[i2] & 254) === 192) {
             return false;
           }
-          i += 2;
-        } else if ((buf[i] & 240) === 224) {
-          if (i + 2 >= len || (buf[i + 1] & 192) !== 128 || (buf[i + 2] & 192) !== 128 || buf[i] === 224 && (buf[i + 1] & 224) === 128 || // Overlong
-          buf[i] === 237 && (buf[i + 1] & 224) === 160) {
+          i2 += 2;
+        } else if ((buf[i2] & 240) === 224) {
+          if (i2 + 2 >= len2 || (buf[i2 + 1] & 192) !== 128 || (buf[i2 + 2] & 192) !== 128 || buf[i2] === 224 && (buf[i2 + 1] & 224) === 128 || // Overlong
+          buf[i2] === 237 && (buf[i2 + 1] & 224) === 160) {
             return false;
           }
-          i += 3;
-        } else if ((buf[i] & 248) === 240) {
-          if (i + 3 >= len || (buf[i + 1] & 192) !== 128 || (buf[i + 2] & 192) !== 128 || (buf[i + 3] & 192) !== 128 || buf[i] === 240 && (buf[i + 1] & 240) === 128 || // Overlong
-          buf[i] === 244 && buf[i + 1] > 143 || buf[i] > 244) {
+          i2 += 3;
+        } else if ((buf[i2] & 248) === 240) {
+          if (i2 + 3 >= len2 || (buf[i2 + 1] & 192) !== 128 || (buf[i2 + 2] & 192) !== 128 || (buf[i2 + 3] & 192) !== 128 || buf[i2] === 240 && (buf[i2 + 1] & 240) === 128 || // Overlong
+          buf[i2] === 244 && buf[i2 + 1] > 143 || buf[i2] > 244) {
             return false;
           }
-          i += 4;
+          i2 += 4;
         } else {
           return false;
         }
@@ -9263,7 +9371,7 @@ var require_sender = __commonJS({
     var { EMPTY_BUFFER, kWebSocket, NOOP } = require_constants();
     var { isBlob, isValidStatusCode } = require_validation();
     var { mask: applyMask, toBuffer } = require_buffer_util();
-    var kByteLength = Symbol("kByteLength");
+    var kByteLength = /* @__PURE__ */ Symbol("kByteLength");
     var maskBuffer = Buffer.alloc(4);
     var RANDOM_POOL_SIZE = 8 * 1024;
     var randomPool;
@@ -9728,8 +9836,8 @@ var require_sender = __commonJS({
     module.exports = Sender2;
     function callCallbacks(sender, err, cb) {
       if (typeof cb === "function") cb(err);
-      for (let i = 0; i < sender._queue.length; i++) {
-        const params = sender._queue[i];
+      for (let i2 = 0; i2 < sender._queue.length; i2++) {
+        const params = sender._queue[i2];
         const callback = params[params.length - 1];
         if (typeof callback === "function") callback(err);
       }
@@ -9744,14 +9852,14 @@ var require_event_target = __commonJS({
   "../common/temp/node_modules/.pnpm/ws@8.18.0_bufferutil@4.0.9/node_modules/ws/lib/event-target.js"(exports, module) {
     "use strict";
     var { kForOnEventAttribute, kListener } = require_constants();
-    var kCode = Symbol("kCode");
-    var kData = Symbol("kData");
-    var kError = Symbol("kError");
-    var kMessage = Symbol("kMessage");
-    var kReason = Symbol("kReason");
-    var kTarget = Symbol("kTarget");
-    var kType = Symbol("kType");
-    var kWasClean = Symbol("kWasClean");
+    var kCode = /* @__PURE__ */ Symbol("kCode");
+    var kData = /* @__PURE__ */ Symbol("kData");
+    var kError = /* @__PURE__ */ Symbol("kError");
+    var kMessage = /* @__PURE__ */ Symbol("kMessage");
+    var kReason = /* @__PURE__ */ Symbol("kReason");
+    var kTarget = /* @__PURE__ */ Symbol("kTarget");
+    var kType = /* @__PURE__ */ Symbol("kType");
+    var kWasClean = /* @__PURE__ */ Symbol("kWasClean");
     var Event = class {
       /**
        * Create a new `Event`.
@@ -9986,19 +10094,19 @@ var require_extension = __commonJS({
       let start = -1;
       let code2 = -1;
       let end = -1;
-      let i = 0;
-      for (; i < header.length; i++) {
-        code2 = header.charCodeAt(i);
+      let i2 = 0;
+      for (; i2 < header.length; i2++) {
+        code2 = header.charCodeAt(i2);
         if (extensionName === void 0) {
           if (end === -1 && tokenChars[code2] === 1) {
-            if (start === -1) start = i;
-          } else if (i !== 0 && (code2 === 32 || code2 === 9)) {
-            if (end === -1 && start !== -1) end = i;
+            if (start === -1) start = i2;
+          } else if (i2 !== 0 && (code2 === 32 || code2 === 9)) {
+            if (end === -1 && start !== -1) end = i2;
           } else if (code2 === 59 || code2 === 44) {
             if (start === -1) {
-              throw new SyntaxError(`Unexpected character at index ${i}`);
+              throw new SyntaxError(`Unexpected character at index ${i2}`);
             }
-            if (end === -1) end = i;
+            if (end === -1) end = i2;
             const name = header.slice(start, end);
             if (code2 === 44) {
               push(offers, name, params);
@@ -10008,18 +10116,18 @@ var require_extension = __commonJS({
             }
             start = end = -1;
           } else {
-            throw new SyntaxError(`Unexpected character at index ${i}`);
+            throw new SyntaxError(`Unexpected character at index ${i2}`);
           }
         } else if (paramName === void 0) {
           if (end === -1 && tokenChars[code2] === 1) {
-            if (start === -1) start = i;
+            if (start === -1) start = i2;
           } else if (code2 === 32 || code2 === 9) {
-            if (end === -1 && start !== -1) end = i;
+            if (end === -1 && start !== -1) end = i2;
           } else if (code2 === 59 || code2 === 44) {
             if (start === -1) {
-              throw new SyntaxError(`Unexpected character at index ${i}`);
+              throw new SyntaxError(`Unexpected character at index ${i2}`);
             }
-            if (end === -1) end = i;
+            if (end === -1) end = i2;
             push(params, header.slice(start, end), true);
             if (code2 === 44) {
               push(offers, extensionName, params);
@@ -10028,41 +10136,41 @@ var require_extension = __commonJS({
             }
             start = end = -1;
           } else if (code2 === 61 && start !== -1 && end === -1) {
-            paramName = header.slice(start, i);
+            paramName = header.slice(start, i2);
             start = end = -1;
           } else {
-            throw new SyntaxError(`Unexpected character at index ${i}`);
+            throw new SyntaxError(`Unexpected character at index ${i2}`);
           }
         } else {
           if (isEscaping) {
             if (tokenChars[code2] !== 1) {
-              throw new SyntaxError(`Unexpected character at index ${i}`);
+              throw new SyntaxError(`Unexpected character at index ${i2}`);
             }
-            if (start === -1) start = i;
+            if (start === -1) start = i2;
             else if (!mustUnescape) mustUnescape = true;
             isEscaping = false;
           } else if (inQuotes) {
             if (tokenChars[code2] === 1) {
-              if (start === -1) start = i;
+              if (start === -1) start = i2;
             } else if (code2 === 34 && start !== -1) {
               inQuotes = false;
-              end = i;
+              end = i2;
             } else if (code2 === 92) {
               isEscaping = true;
             } else {
-              throw new SyntaxError(`Unexpected character at index ${i}`);
+              throw new SyntaxError(`Unexpected character at index ${i2}`);
             }
-          } else if (code2 === 34 && header.charCodeAt(i - 1) === 61) {
+          } else if (code2 === 34 && header.charCodeAt(i2 - 1) === 61) {
             inQuotes = true;
           } else if (end === -1 && tokenChars[code2] === 1) {
-            if (start === -1) start = i;
+            if (start === -1) start = i2;
           } else if (start !== -1 && (code2 === 32 || code2 === 9)) {
-            if (end === -1) end = i;
+            if (end === -1) end = i2;
           } else if (code2 === 59 || code2 === 44) {
             if (start === -1) {
-              throw new SyntaxError(`Unexpected character at index ${i}`);
+              throw new SyntaxError(`Unexpected character at index ${i2}`);
             }
-            if (end === -1) end = i;
+            if (end === -1) end = i2;
             let value = header.slice(start, end);
             if (mustUnescape) {
               value = value.replace(/\\/g, "");
@@ -10077,14 +10185,14 @@ var require_extension = __commonJS({
             paramName = void 0;
             start = end = -1;
           } else {
-            throw new SyntaxError(`Unexpected character at index ${i}`);
+            throw new SyntaxError(`Unexpected character at index ${i2}`);
           }
         }
       }
       if (start === -1 || inQuotes || code2 === 32 || code2 === 9) {
         throw new SyntaxError("Unexpected end of input");
       }
-      if (end === -1) end = i;
+      if (end === -1) end = i2;
       const token2 = header.slice(start, end);
       if (extensionName === void 0) {
         push(offers, token2, params);
@@ -10149,7 +10257,7 @@ var require_websocket = __commonJS({
     var { format, parse } = require_extension();
     var { toBuffer } = require_buffer_util();
     var closeTimeout = 30 * 1e3;
-    var kAborted = Symbol("kAborted");
+    var kAborted = /* @__PURE__ */ Symbol("kAborted");
     var protocolVersions = [8, 13];
     var readyStates = ["CONNECTING", "OPEN", "CLOSING", "CLOSED"];
     var subprotocolRegex = /^[!#$%&'*+\-.0-9A-Z^_`|a-z~]+$/;
@@ -11007,18 +11115,18 @@ var require_subprotocol = __commonJS({
       const protocols = /* @__PURE__ */ new Set();
       let start = -1;
       let end = -1;
-      let i = 0;
-      for (i; i < header.length; i++) {
-        const code2 = header.charCodeAt(i);
+      let i2 = 0;
+      for (i2; i2 < header.length; i2++) {
+        const code2 = header.charCodeAt(i2);
         if (end === -1 && tokenChars[code2] === 1) {
-          if (start === -1) start = i;
-        } else if (i !== 0 && (code2 === 32 || code2 === 9)) {
-          if (end === -1 && start !== -1) end = i;
+          if (start === -1) start = i2;
+        } else if (i2 !== 0 && (code2 === 32 || code2 === 9)) {
+          if (end === -1 && start !== -1) end = i2;
         } else if (code2 === 44) {
           if (start === -1) {
-            throw new SyntaxError(`Unexpected character at index ${i}`);
+            throw new SyntaxError(`Unexpected character at index ${i2}`);
           }
-          if (end === -1) end = i;
+          if (end === -1) end = i2;
           const protocol2 = header.slice(start, end);
           if (protocols.has(protocol2)) {
             throw new SyntaxError(`The "${protocol2}" subprotocol is duplicated`);
@@ -11026,13 +11134,13 @@ var require_subprotocol = __commonJS({
           protocols.add(protocol2);
           start = end = -1;
         } else {
-          throw new SyntaxError(`Unexpected character at index ${i}`);
+          throw new SyntaxError(`Unexpected character at index ${i2}`);
         }
       }
       if (start === -1 || end !== -1) {
         throw new SyntaxError("Unexpected end of input");
       }
-      const protocol = header.slice(start, i);
+      const protocol = header.slice(start, i2);
       if (protocols.has(protocol)) {
         throw new SyntaxError(`The "${protocol}" subprotocol is duplicated`);
       }
@@ -11994,6 +12102,7 @@ var upsertTelemetryFromPlugin = makeFunctionReference("telemetryPlugin:upsertTel
 var upsertSessionsFromPlugin = makeFunctionReference("telemetryPlugin:upsertSessionsFromPlugin");
 var pushActivityFromPluginRef = makeFunctionReference("activityFeed:pushActivityFromPlugin");
 var upsertCronSnapshotFromPluginRef = makeFunctionReference("telemetryPlugin:upsertCronSnapshotFromPlugin");
+var recordGatewayPresenceRef = makeFunctionReference("gatewayPresence:recordGatewayPresence");
 var recordCronRunFromPluginRef = makeFunctionReference("cronRunHistory:recordFromPlugin");
 var getUndeliveredForPlugin = makeFunctionReference("notifications:getUndeliveredForPlugin");
 var markDeliveredByPlugin = makeFunctionReference("notifications:markDeliveredByPlugin");
@@ -12015,7 +12124,7 @@ async function pushTelemetry(apiKey2, data) {
   const c = getClient();
   if (!c) return;
   try {
-    await c.mutation(upsertTelemetryFromPlugin, { apiKeyHash: hashApiKey(apiKey2), ...data });
+    await c.mutation(upsertTelemetryFromPlugin, { apiKeyHash: hashApiKey(apiKey2), runtime: "openclaw", ...data });
   } catch (err) {
     if (isUnauthorizedError(err)) {
       tripAuthCircuit();
@@ -12068,6 +12177,22 @@ async function pushCronSnapshot(apiKey2, jobs) {
     return false;
   }
 }
+async function pushPresence(apiKey2, runtime) {
+  if (authCircuitOpen) return false;
+  const c = getClient();
+  if (!c) return false;
+  try {
+    await c.mutation(recordGatewayPresenceRef, { apiKeyHash: hashApiKey(apiKey2), runtime });
+    return true;
+  } catch (err) {
+    if (isUnauthorizedError(err)) {
+      tripAuthCircuit();
+      return false;
+    }
+    getLogger().error(`cohort-sync: pushPresence failed: ${err}`);
+    return false;
+  }
+}
 async function recordCronRun(apiKey2, run) {
   if (authCircuitOpen) return false;
   const c = getClient();
@@ -12686,7 +12811,7 @@ async function startNotificationSubscription(port, cfg, hooksToken, logger, gwCl
         processing = true;
         try {
           for (const n of notifications) {
-            const failCount = deliveryFailures.get(n._id) ?? 0;
+            const failCount = deliveryFailures.get(n.id) ?? 0;
             if (failCount >= MAX_DELIVERY_ATTEMPTS) {
               continue;
             }
@@ -12697,34 +12822,34 @@ async function startNotificationSubscription(port, cfg, hooksToken, logger, gwCl
                 logger.info(`cohort-sync: injected notification for ${targetLabel} (${agentName})`);
               } else {
                 throw new Error(
-                  `no transport available for notification ${n._id} (gwClient alive: ${gwClient?.isAlive() ?? "null"}, hooksToken: ${!!hooksToken})`
+                  `no transport available for notification ${n.id} (gwClient alive: ${gwClient?.isAlive() ?? "null"}, hooksToken: ${!!hooksToken})`
                 );
               }
               await c.mutation(markDeliveredByPlugin, {
-                notificationId: n._id,
+                notificationId: n.id,
                 apiKeyHash
               });
-              deliveryFailures.delete(n._id);
+              deliveryFailures.delete(n.id);
             } catch (err) {
               const newFailCount = failCount + 1;
-              deliveryFailures.set(n._id, newFailCount);
+              deliveryFailures.set(n.id, newFailCount);
               if (newFailCount >= MAX_DELIVERY_ATTEMPTS) {
                 const targetLabel = n.type === "room_message" ? `room ${n.roomId ?? n.roomName ?? "unknown"}` : `task #${n.taskNumber}`;
                 logger.error(
-                  `cohort-sync: dead-letter notification ${n._id} for ${targetLabel} (${n.type} from ${n.actorName}) after ${MAX_DELIVERY_ATTEMPTS} failed delivery attempts: ${String(err)}`
+                  `cohort-sync: dead-letter notification ${n.id} for ${targetLabel} (${n.type} from ${n.actorName}) after ${MAX_DELIVERY_ATTEMPTS} failed delivery attempts: ${String(err)}`
                 );
                 try {
                   await c.mutation(markDeliveredByPlugin, {
-                    notificationId: n._id,
+                    notificationId: n.id,
                     apiKeyHash
                   });
-                  deliveryFailures.delete(n._id);
+                  deliveryFailures.delete(n.id);
                 } catch (markErr) {
-                  logger.error(`cohort-sync: failed to dead-letter ${n._id}: ${String(markErr)}`);
+                  logger.error(`cohort-sync: failed to dead-letter ${n.id}: ${String(markErr)}`);
                 }
               } else {
                 logger.warn(
-                  `cohort-sync: failed to inject notification ${n._id} (attempt ${newFailCount}/${MAX_DELIVERY_ATTEMPTS}): ${String(err)}`
+                  `cohort-sync: failed to inject notification ${n.id} (attempt ${newFailCount}/${MAX_DELIVERY_ATTEMPTS}): ${String(err)}`
                 );
               }
             }
@@ -12855,15 +12980,15 @@ import crypto2 from "node:crypto";
 
 // src/device-identity-crypto.ts
 import crypto from "node:crypto";
-import fs from "node:fs";
-import path from "node:path";
+import fs2 from "node:fs";
+import path2 from "node:path";
 import os from "node:os";
-var DATA_DIR = path.join(os.homedir(), ".openclaw", "data", "cohort-sync");
-var IDENTITY_PATH = path.join(DATA_DIR, ".device-identity.json");
-var LEGACY_IDENTITY_PATH = path.join(os.homedir(), ".openclaw", "extensions", "cohort-sync", ".device-identity.json");
+var DATA_DIR = path2.join(os.homedir(), ".openclaw", "data", "cohort-sync");
+var IDENTITY_PATH = path2.join(DATA_DIR, ".device-identity.json");
+var LEGACY_IDENTITY_PATH = path2.join(os.homedir(), ".openclaw", "extensions", "cohort-sync", ".device-identity.json");
 function tryLoadIdentity(filePath) {
   try {
-    const data = JSON.parse(fs["read"+"FileSync"](filePath, "utf-8"));
+    const data = JSON.parse(fs2["read"+"FileSync"](filePath, "utf-8"));
     if (data.deviceId && data.publicKeyPem && data.privateKeyPem) {
       return data;
     }
@@ -12896,8 +13021,8 @@ function loadOrCreateDeviceIdentity() {
 }
 function persistIdentity(identity) {
   try {
-    fs.mkdirSync(DATA_DIR, { recursive: true, mode: 448 });
-    fs.writeFileSync(IDENTITY_PATH, JSON.stringify(identity, null, 2), { mode: 384 });
+    fs2.mkdirSync(DATA_DIR, { recursive: true, mode: 448 });
+    fs2.writeFileSync(IDENTITY_PATH, JSON.stringify(identity, null, 2), { mode: 384 });
   } catch (err) {
     console.debug("cohort-sync: device identity write failed", { error: String(err) });
   }
@@ -14009,6 +14134,28 @@ var AgentStateTracker = class {
 
 // src/types.ts
 var DEFAULT_API_URL = "https://api.cohort.bot";
+function normalizeTriageBrief(raw) {
+  if (raw === null || typeof raw !== "object") {
+    return { error: "brief must be an object with problem, solution (and optional risks)." };
+  }
+  const obj = raw;
+  const requireField = (name) => {
+    const value = obj[name];
+    if (typeof value !== "string" || value.trim().length === 0) {
+      return { error: `brief.${name} is required and must be a non-empty string.` };
+    }
+    return value.trim();
+  };
+  const problem = requireField("problem");
+  if (typeof problem !== "string") return problem;
+  const solution = requireField("solution");
+  if (typeof solution !== "string") return solution;
+  const brief = { problem, solution };
+  if (typeof obj.risks === "string" && obj.risks.trim().length > 0) {
+    brief.risks = obj.risks.trim();
+  }
+  return { brief };
+}
 
 // src/tool-runtime.ts
 var apiKey = null;
@@ -14119,7 +14266,8 @@ function dumpEvent(event) {
 function positiveNumber(value) {
   return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
 }
-var PLUGIN_VERSION = true ? "0.34.2" : "unknown";
+var PLUGIN_VERSION = true ? "0.34.4" : "unknown";
+var PRESENCE_PING_INTERVAL_MS = 12e4;
 function resolveGatewayToken(api) {
   const token2 = api.config?.gateway?.auth?.token;
   return typeof token2 === "string" ? token2 : null;
@@ -14149,8 +14297,8 @@ function registerCronEventHandlers(client2, cfg, resolveAgentName, cronTimestamp
 }
 function parseIdentityFile(workspaceDir) {
   try {
-    const filePath = path2.join(workspaceDir, "IDENTITY.md");
-    const content = fs2["read"+"FileSync"](filePath, "utf-8");
+    const filePath = path3.join(workspaceDir, "IDENTITY.md");
+    const content = fs3["read"+"FileSync"](filePath, "utf-8");
     const identity = {};
     for (const line of content.split(/\r?\n/)) {
       const cleaned = line.trim().replace(/^\s*-\s*/, "");
@@ -14169,14 +14317,41 @@ function parseIdentityFile(workspaceDir) {
     return null;
   }
 }
+function parseRoleFromSoul(content) {
+  const MAX_LEN = 80;
+  for (const line of content.split(/\r?\n/)) {
+    const cleaned = line.trim().replace(/^\s*-\s*/, "");
+    const colonIndex = cleaned.indexOf(":");
+    if (colonIndex === -1) continue;
+    const label = cleaned.slice(0, colonIndex).replace(/[*_]/g, "").trim().toLowerCase();
+    if (label !== "role" && label !== "current role") continue;
+    let value = cleaned.slice(colonIndex + 1).replace(/^[*_]+|[*_]+$/g, "").trim();
+    if (!value) continue;
+    const firstSentence = value.split(/\.\s/)[0].trim();
+    if (firstSentence) value = firstSentence;
+    if (value.length > MAX_LEN) value = value.slice(0, MAX_LEN).trim();
+    return value;
+  }
+  return void 0;
+}
+function parseSoulRole(workspaceDir) {
+  try {
+    const content = fs3["read"+"FileSync"](path3.join(workspaceDir, "SOUL.md"), "utf-8");
+    return parseRoleFromSoul(content);
+  } catch {
+    return void 0;
+  }
+}
 function resolveIdentity(configIdentity, workspaceDir) {
   const fileIdentity = workspaceDir ? parseIdentityFile(workspaceDir) : null;
-  if (!configIdentity && !fileIdentity) return void 0;
+  const soulRole = workspaceDir ? parseSoulRole(workspaceDir) : void 0;
+  if (!configIdentity && !fileIdentity && !soulRole) return void 0;
   return {
     name: configIdentity?.name ?? fileIdentity?.name,
     emoji: configIdentity?.emoji ?? fileIdentity?.emoji,
     theme: configIdentity?.theme ?? fileIdentity?.theme,
-    avatar: configIdentity?.avatar ?? fileIdentity?.avatar
+    avatar: configIdentity?.avatar ?? fileIdentity?.avatar,
+    title: configIdentity?.title ?? soulRole
   };
 }
 function saveSessionsToDisk(tracker, stateFilePath) {
@@ -14193,14 +14368,14 @@ function saveSessionsToDisk(tracker, stateFilePath) {
         data.sessions.push({ agentName: name, key });
       }
     }
-    fs2.writeFileSync(stateFilePath, JSON.stringify(data), { mode: 384 });
+    fs3.writeFileSync(stateFilePath, JSON.stringify(data), { mode: 384 });
   } catch {
   }
 }
 function loadSessionsFromDisk(tracker, stateFilePath, logger) {
   try {
-    if (!fs2.existsSync(stateFilePath)) return;
-    const data = JSON.parse(fs2["read"+"FileSync"](stateFilePath, "utf8"));
+    if (!fs3.existsSync(stateFilePath)) return;
+    const data = JSON.parse(fs3["read"+"FileSync"](stateFilePath, "utf8"));
     if (Date.now() - new Date(data.savedAt).getTime() > 864e5) {
       logger.info("cohort-sync: disk session state too old (>24h), skipping");
       return;
@@ -14296,7 +14471,15 @@ async function handleGatewayStart(event, state) {
       model: state.resolveModel(a.id),
       identity: resolveIdentity(a.identity, a.workspace)
     }));
-    await fullSync(state.resolveAgentName("main"), state.resolveModel("main"), cfg, logger, agentList);
+    const skillsDir = api.config?.skills?.dir ?? path3.join(os2.homedir(), ".openclaw", "skills");
+    await fullSync(
+      state.resolveAgentName("main"),
+      state.resolveModel("main"),
+      cfg,
+      logger,
+      agentList,
+      skillsDir
+    );
   } catch (err) {
     logger.error(`cohort-sync: gateway_start sync failed: ${String(err)}`);
   }
@@ -14421,6 +14604,17 @@ async function handleGatewayStart(event, state) {
     saveSessionsToDisk(tracker, state.stateFilePath);
   }, 15e4);
   logger.info("cohort-sync: keepalive interval started (150s)");
+  void pushPresence(cfg.apiKey, "openclaw").catch(() => {
+  });
+  if (state.presenceInterval) clearInterval(state.presenceInterval);
+  state.presenceInterval = setInterval(() => {
+    void pushPresence(cfg.apiKey, "openclaw").catch(() => {
+    });
+  }, PRESENCE_PING_INTERVAL_MS);
+  if (typeof state.presenceInterval.unref === "function") {
+    state.presenceInterval.unref();
+  }
+  logger.info(`cohort-sync: liveness ping interval started (${PRESENCE_PING_INTERVAL_MS / 1e3}s)`);
 }
 function registerHookHandlers(api, logger, getState) {
   function resolveAgentFromContext(state, ctx) {
@@ -14497,7 +14691,7 @@ function registerHookHandlers(api, logger, getState) {
         const parsed = parseSessionKey(sessionKey);
         const routineId = parsed.kind === "cron" ? parsed.identifier : void 0;
         try {
-          const raw = fs2["read"+"FileSync"](state.cronStorePath, "utf8");
+          const raw = fs3["read"+"FileSync"](state.cronStorePath, "utf8");
           const store = JSON.parse(raw);
           const jobs = store.jobs ?? [];
           const mapped = jobs.map((j) => mapCronJob(j, state.resolveAgentName, state.cronTimestampTracker));
@@ -14881,6 +15075,10 @@ function registerHookHandlers(api, logger, getState) {
       clearInterval(state.keepaliveInterval);
       state.keepaliveInterval = null;
     }
+    if (state.presenceInterval) {
+      clearInterval(state.presenceInterval);
+      state.presenceInterval = null;
+    }
     if (state.updateCheckInterval) {
       clearInterval(state.updateCheckInterval);
       state.updateCheckInterval = null;
@@ -14931,7 +15129,7 @@ function registerHookHandlers(api, logger, getState) {
 }
 function initializeHookState(api, cfg) {
   const { logger, config } = api;
-  const stateFilePath = path2.join(cfg.stateDir, "session-state.json");
+  const stateFilePath = path3.join(cfg.stateDir, "session-state.json");
   const nameMap = cfg.agentNameMap;
   const tracker = new AgentStateTracker();
   const convexUrl = cfg.convexUrl ?? deriveConvexUrl(cfg.apiUrl);
@@ -14965,7 +15163,7 @@ function initializeHookState(api, cfg) {
   function getModelContextLimit2(model) {
     return getModelContextLimit(model);
   }
-  const cronStorePath = api.config?.cron?.store ?? path2.join(os2.homedir(), ".openclaw", "cron", "jobs.json");
+  const cronStorePath = api.config?.cron?.store ?? path3.join(os2.homedir(), ".openclaw", "cron", "jobs.json");
   const activityBatch = new MicroBatch({
     maxSize: 10,
     maxDelayMs: 1e3,
@@ -15041,6 +15239,7 @@ function initializeHookState(api, cfg) {
     persistentGwClient,
     gwClientInitialized,
     keepaliveInterval: null,
+    presenceInterval: null,
     commandUnsubscriber: commandUnsub,
     channelsUnsubscriber: null,
     api,
@@ -15084,6 +15283,65 @@ function registerGatewayMethods(api, getGatewayClient) {
   );
 }
 
+// src/triage-pr-files.ts
+import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { promisify } from "node:util";
+var execFileAsync = promisify(execFile);
+async function collectChangedFiles(args) {
+  const cwd = args.repoDir || process.cwd();
+  const git = async (gitArgs) => {
+    const { stdout } = await execFileAsync("git", gitArgs, {
+      cwd,
+      maxBuffer: 64 * 1024 * 1024
+    });
+    return stdout;
+  };
+  const files = [];
+  const seen = /* @__PURE__ */ new Set();
+  const nameStatus = await git(["diff", "--name-status", "-z", args.baseSha]);
+  const tokens = nameStatus.split("\0");
+  let i2 = 0;
+  while (i2 < tokens.length) {
+    const status = tokens[i2];
+    if (!status) {
+      i2 += 1;
+      continue;
+    }
+    let path4;
+    if (status[0] === "R" || status[0] === "C") {
+      const oldPath = tokens[i2 + 1] ?? "";
+      path4 = tokens[i2 + 2] ?? "";
+      i2 += 3;
+      if (oldPath && !seen.has(oldPath)) {
+        seen.add(oldPath);
+        files.push({ path: oldPath, deleted: true });
+      }
+    } else {
+      path4 = tokens[i2 + 1] ?? "";
+      i2 += 2;
+    }
+    if (!path4 || seen.has(path4)) continue;
+    seen.add(path4);
+    if (status[0] === "D") {
+      files.push({ path: path4, deleted: true });
+    } else {
+      files.push({ path: path4, content: await readRepoFile(cwd, path4) });
+    }
+  }
+  const others = await git(["ls-files", "--others", "--exclude-standard", "-z"]);
+  for (const path4 of others.split("\0")) {
+    if (!path4 || seen.has(path4)) continue;
+    seen.add(path4);
+    files.push({ path: path4, content: await readRepoFile(cwd, path4) });
+  }
+  return files;
+}
+async function readRepoFile(cwd, path4) {
+  return readFile(join(cwd, path4), "utf8");
+}
+
 // src/pocket-guide.ts
 var POCKET_GUIDE = `# Cohort Agent Guide (Pocket Version)
 
@@ -15104,6 +15362,13 @@ var POCKET_GUIDE = `# Cohort Agent Guide (Pocket Version)
 - For code changes, work is not complete when it is implemented locally; push your branch, open a PR, enable auto-merge, watch CI until green or red, confirm the PR merged, verify the production deploy, then comment with the PR link, deploy result, and verification evidence.
 - Use GitHub for deployment: after opening the PR, run gh pr merge --auto --rebase --delete-branch, gh pr checks <PR> --watch, confirm the merge, then run gh run watch <deploy-run-id> for the Deploy Production workflow. Do not stop because Vercel CLI is not authenticated; Cohort deploys through GitHub Actions after merge.
 
+## Working as a Team
+- Two modes: orchestrator and worker. As an orchestrator, break the goal into a task graph (create tasks, assign owners, relate dependencies), then report the graph and leave implementation to the assigned workers. As a worker, take one task, do it, and hand it back cleanly.
+- Relate dependent tasks with blockers so ordering is explicit. A blocked task stays gated until its blocker clears.
+- Before assigning, confirm the assignee is a real agent in the workspace, because a task assigned to a name that resolves to no one strands in its column.
+- The closing comment is the handoff: what you did, the evidence (links, PR, test output, artifact), and what is now unblocked or what the human must decide. Agents cannot set "done", so move to "waiting" and let a human close it.
+- Create a task when work spans multiple agents, needs to survive a restart, wants a human in the loop, or can run in parallel. For something you can finish right now, just do it.
+
 ## Comments
 - Comment before every status transition explaining what happened.
 - Post progress updates every 15-30 minutes on long-running work.
@@ -15306,6 +15571,31 @@ async function safeHttpError(response) {
   }
   return "";
 }
+var PR_MAX_FILES = 50;
+var PR_MAX_FILE_BYTES = 1e6;
+var PR_MAX_TOTAL_BYTES = 5e6;
+var PR_BASE_SHA_RE = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/i;
+function checkPrEnvelope(files) {
+  if (files.length === 0) {
+    return "No changed files to report \u2014 make a change first, then call cohort_triage_pr.";
+  }
+  if (files.length > PR_MAX_FILES) {
+    return `Change too large: ${files.length} files (max ${PR_MAX_FILES}).`;
+  }
+  let total = 0;
+  for (const entry of files) {
+    if ("deleted" in entry) continue;
+    const size = Buffer2.byteLength(entry.content, "utf8");
+    if (size > PR_MAX_FILE_BYTES) {
+      return `File too large: ${entry.path} (max ${PR_MAX_FILE_BYTES} bytes).`;
+    }
+    total += size;
+  }
+  if (total > PR_MAX_TOTAL_BYTES) {
+    return "Change too large (total content size exceeds the limit).";
+  }
+  return null;
+}
 function renderTaskContext(context) {
   if (!context) return "";
   const lines = [];
@@ -15472,7 +15762,7 @@ Do not attempt more comments until tomorrow.`);
         label: "cohort_room_message",
         description: "Post a message in a Cohort Room. Use this to reply when you are participating in a Room chat.",
         parameters: Type.Object({
-          room_id: Type.String({ description: "Room ID supplied by Cohort, e.g. rooms:abc123" }),
+          room_id: Type.String({ description: 'The Room to post in. Prefer the exact room id from your prompt/notification (e.g. xs773mgqe3qd9h41pjwxndd755887b1x). The room name (e.g. "All Hands") is also accepted.' }),
           message: Type.String({ description: "Message text to post in the Room" }),
           turn_id: Type.Optional(Type.String({ description: "Moderation turn id to attribute this reply to (echo from your prompt)" }))
         }),
@@ -15499,7 +15789,7 @@ Do not attempt more comments until tomorrow.`);
         label: "cohort_room_prompt_agent",
         description: "Ask one agent in a Cohort Room to respond. Use this when you are the Room moderator and need controlled turn-taking.",
         parameters: Type.Object({
-          room_id: Type.String({ description: "Room ID supplied by Cohort, e.g. rooms:abc123" }),
+          room_id: Type.String({ description: 'Room ID supplied by Cohort, e.g. xs773mgqe3qd9h41pjwxndd755887b1x (NOT prefixed with "rooms:").' }),
           agent_name: Type.String({ description: "Cohort agent name to prompt, e.g. iris" }),
           prompt: Type.String({ description: "Prompt to send to the target agent" })
         }),
@@ -15527,7 +15817,7 @@ Do not attempt more comments until tomorrow.`);
         label: "cohort_room_prompt_agents",
         description: "Ask multiple agents in a Cohort Room to respond in one controlled moderator action.",
         parameters: Type.Object({
-          room_id: Type.String({ description: "Room ID supplied by Cohort, e.g. rooms:abc123" }),
+          room_id: Type.String({ description: 'Room ID supplied by Cohort, e.g. xs773mgqe3qd9h41pjwxndd755887b1x (NOT prefixed with "rooms:").' }),
           agent_names: Type.Array(Type.String({ description: "Cohort agent name to prompt" })),
           prompt: Type.String({ description: "Prompt to send to the target agents" })
         }),
@@ -15671,7 +15961,7 @@ Wire item: ${result.wireItemId}`, result);
         label: "cohort_room_start_moderation_session",
         description: 'Start a managed moderation session in a Cohort Room. Use round_robin = ask every participant to report in; use moderated_qna = route a question to one selected agent, wait for the answer, ask the asker whether it resolves the question, then complete. For multiple experts in Q&A, start with one best agent and use action: "followup" for additional experts one at a time. Returns the session state block. The returned block includes the session_id \u2014 pass it to cohort_room_advance_moderation_session for every subsequent action.',
         parameters: Type.Object({
-          room_id: Type.String({ description: "Room ID supplied by Cohort, e.g. rooms:abc123" }),
+          room_id: Type.String({ description: 'Room ID supplied by Cohort, e.g. xs773mgqe3qd9h41pjwxndd755887b1x (NOT prefixed with "rooms:").' }),
           mode: Type.Union([
             Type.Literal("round_robin"),
             Type.Literal("moderated_qna")
@@ -16056,6 +16346,127 @@ ${renderGoal(goal)}`, goal);
         }
       };
     });
+    api.registerTool(() => {
+      return {
+        name: "cohort_triage",
+        label: "cohort_triage",
+        description: "Report your triage decision on a Cohort triage item back to Cohort. Pass the Triage item ID from your wake task as triage_item_id, the tier (trivial | judgment | feature | not_actionable), whether it is actionable, and your reasoning. Also pass a short `title` \u2014 a brief (\u226480 char) issue summary in your own words (a task-name headline of what you read), NOT a paste of the feedback; Cohort uses it as the Build-it task title. SHADOW MODE: do NOT write code or open PRs.",
+        parameters: Type.Object({
+          triage_item_id: Type.String({ description: "Triage item ID from your wake task (e.g. triageItems:abc123)." }),
+          tier: Type.Union([
+            Type.Literal("trivial"),
+            Type.Literal("judgment"),
+            Type.Literal("feature"),
+            Type.Literal("not_actionable")
+          ], { description: "Triage tier for this feedback." }),
+          actionable: Type.Boolean({ description: "Whether this feedback is actionable." }),
+          reasoning: Type.String({ description: "Why you reached this decision." }),
+          confidence: Type.Optional(Type.Number({ description: "Optional confidence in the decision, 0 to 1." })),
+          title: Type.Optional(Type.String({ description: "Optional short (\u226480 char) issue summary in your own words \u2014 a task-name headline of the problem, NOT a paste of the feedback. Used as the Build-it task title." }))
+        }),
+        async execute(_toolCallId, params) {
+          const rt = getToolRuntime();
+          if (!rt.isReady) {
+            return textResult("cohort_triage is not ready yet \u2014 the plugin is still starting up.");
+          }
+          try {
+            const response = await fetch(
+              `${rt.apiUrl}/api/v1/plugin/triage/${encodeURIComponent(params.triage_item_id)}/decision`,
+              {
+                method: "POST",
+                headers: {
+                  "Authorization": `Bearer ${rt.apiKey}`,
+                  "Content-Type": "application/json"
+                },
+                body: JSON.stringify({
+                  tier: params.tier,
+                  actionable: params.actionable,
+                  reasoning: params.reasoning,
+                  ...params.confidence !== void 0 ? { confidence: params.confidence } : {},
+                  ...params.title !== void 0 ? { title: params.title } : {}
+                }),
+                signal: AbortSignal.timeout(1e4)
+              }
+            );
+            if (!response.ok) {
+              const message = await safeHttpError(response);
+              return textResult(`Failed to record triage decision for ${params.triage_item_id}: ${response.status}${message}`);
+            }
+            const result = await response.json();
+            const verdict = params.actionable ? "actionable" : "not actionable";
+            return textResult(`Recorded triage decision for ${params.triage_item_id}: ${params.tier} (${verdict}).`, result);
+          } catch (err) {
+            return textResult(`Failed to record triage decision for ${params.triage_item_id}: ${err instanceof Error ? redactSecrets(err.message) : "Unknown error"}`);
+          }
+        }
+      };
+    });
+    api.registerTool(() => {
+      return {
+        name: "cohort_triage_pr",
+        label: "cohort_triage_pr",
+        description: "Report a Build-it fix you produced for a Cohort triage item. Pass the Triage item ID, the base commit SHA you branched from (base_sha), and a structured brief (problem, solution, optional risks). The tool collects your changed files from the current worktree and sends them to Cohort; the Cohort spine opens the PR and it auto-merges once CI is green. Do NOT open a PR or merge yourself \u2014 you hold no merge credential.",
+        parameters: Type.Object({
+          triage_item_id: Type.String({ description: "Triage item ID from your wake task (e.g. triageItems:abc123)." }),
+          base_sha: Type.String({ description: "The 40- or 64-char hex commit SHA you branched from." }),
+          brief: Type.Object({
+            problem: Type.String({ description: "What's wrong (the issue being fixed)." }),
+            solution: Type.String({ description: "How the PR fixes it (rendered under the 'Fix' label)." }),
+            risks: Type.Optional(Type.String({ description: "Optional risks/blast radius of the change." }))
+          }),
+          repo_dir: Type.Optional(Type.String({ description: "Optional worktree path to diff (defaults to the current directory)." }))
+        }),
+        async execute(_toolCallId, params) {
+          const rt = getToolRuntime();
+          if (!rt.isReady) {
+            return textResult("cohort_triage_pr is not ready yet \u2014 the plugin is still starting up.");
+          }
+          if (!PR_BASE_SHA_RE.test(params.base_sha)) {
+            return textResult("Invalid base_sha: must be a 40- or 64-char hex commit SHA.");
+          }
+          const normalized = normalizeTriageBrief(params.brief);
+          if ("error" in normalized) {
+            return textResult(`Invalid brief: ${normalized.error}`);
+          }
+          let files;
+          try {
+            files = await collectChangedFiles({ baseSha: params.base_sha, repoDir: params.repo_dir });
+          } catch (err) {
+            return textResult(`Failed to collect changed files for ${params.triage_item_id}: ${err instanceof Error ? redactSecrets(err.message) : "Unknown error"}`);
+          }
+          const envelopeError = checkPrEnvelope(files);
+          if (envelopeError) {
+            return textResult(envelopeError);
+          }
+          try {
+            const response = await fetch(
+              `${rt.apiUrl}/api/v1/plugin/triage/${encodeURIComponent(params.triage_item_id)}/pr`,
+              {
+                method: "POST",
+                headers: {
+                  "Authorization": `Bearer ${rt.apiKey}`,
+                  "Content-Type": "application/json"
+                },
+                body: JSON.stringify({
+                  brief: normalized.brief,
+                  baseSha: params.base_sha,
+                  files
+                }),
+                signal: AbortSignal.timeout(3e4)
+              }
+            );
+            if (!response.ok) {
+              const message = await safeHttpError(response);
+              return textResult(`Failed to report PR for ${params.triage_item_id}: ${response.status}${message}`);
+            }
+            const result = await response.json();
+            return textResult(`Reported ${files.length} changed file(s) for ${params.triage_item_id}; the spine will open the PR.`, result);
+          } catch (err) {
+            return textResult(`Failed to report PR for ${params.triage_item_id}: ${err instanceof Error ? redactSecrets(err.message) : "Unknown error"}`);
+          }
+        }
+      };
+    });
     api.registerTool(() => {
       return {
         name: "cohort_relate",