@agentvault/agentvault 0.13.12 → 0.14.0

package/dist/cli.js

@@ -87,7 +87,7 @@ var init_libsodium_sumo = __esm({
       }
     }
     _Module = Module;
-    Module.ready = new Promise(function(resolve3, reject) {
+    Module.ready = new Promise(function(resolve4, reject) {
       var Module2 = _Module;
       Module2.onAbort = reject;
       Module2.print = function(what) {
@@ -99,13 +99,13 @@ var init_libsodium_sumo = __esm({
       Module2.onRuntimeInitialized = function() {
         try {
           Module2._crypto_secretbox_keybytes();
-          resolve3();
+          resolve4();
         } catch (err2) {
           reject(err2);
         }
       };
       Module2.useBackupModule = function() {
-        return new Promise(function(resolve4, reject2) {
+        return new Promise(function(resolve5, reject2) {
           var Module3 = {};
           Module3.onAbort = reject2;
           Module3.getRandomValue = _Module.getRandomValue;
@@ -118,7 +118,7 @@ var init_libsodium_sumo = __esm({
             Object.keys(Module3).forEach(function(k2) {
               _Module[k2] = Module3[k2];
             });
-            resolve4();
+            resolve5();
           };
           var Module3 = typeof Module3 != "undefined" ? Module3 : {};
           var ENVIRONMENT_IS_WEB2 = !!globalThis.window;
@@ -178,13 +178,13 @@ var init_libsodium_sumo = __esm({
               }
               readAsync2 = async (url) => {
                 if (isFileURI2(url)) {
-                  return new Promise((resolve5, reject3) => {
+                  return new Promise((resolve6, reject3) => {
                     var xhr = new XMLHttpRequest();
                     xhr.open("GET", url, true);
                     xhr.responseType = "arraybuffer";
                     xhr.onload = () => {
                       if (xhr.status == 200 || xhr.status == 0 && xhr.response) {
-                        resolve5(xhr.response);
+                        resolve6(xhr.response);
                         return;
                       }
                       reject3(xhr.status);
@@ -40097,9 +40097,9 @@ var init_libsodium_sumo = __esm({
             }
             var info = getWasmImports2();
             if (Module3["instantiateWasm"]) {
-              return new Promise((resolve5, reject3) => {
+              return new Promise((resolve6, reject3) => {
                 Module3["instantiateWasm"](info, (inst, mod) => {
-                  resolve5(receiveInstance(inst, mod));
+                  resolve6(receiveInstance(inst, mod));
                 });
               });
             }
@@ -41002,13 +41002,13 @@ var init_libsodium_sumo = __esm({
           }
           readAsync = async (url) => {
             if (isFileURI(url)) {
-              return new Promise((resolve4, reject2) => {
+              return new Promise((resolve5, reject2) => {
                 var xhr = new XMLHttpRequest();
                 xhr.open("GET", url, true);
                 xhr.responseType = "arraybuffer";
                 xhr.onload = () => {
                   if (xhr.status == 200 || xhr.status == 0 && xhr.response) {
-                    resolve4(xhr.response);
+                    resolve5(xhr.response);
                     return;
                   }
                   reject2(xhr.status);
@@ -41122,9 +41122,9 @@ var init_libsodium_sumo = __esm({
         }
         var info = getWasmImports();
         if (Module2["instantiateWasm"]) {
-          return new Promise((resolve4, reject2) => {
+          return new Promise((resolve5, reject2) => {
             Module2["instantiateWasm"](info, (inst, mod) => {
-              resolve4(receiveInstance(inst, mod));
+              resolve5(receiveInstance(inst, mod));
             });
           });
         }
@@ -45267,17 +45267,30 @@ function generateTraceId() {
 function generateSpanId() {
   return randomHex(8);
 }
+function applySkillName(attributes, skillName) {
+  if (skillName) {
+    attributes["ai.agent.skill.name"] = skillName;
+  }
+}
 function buildLlmSpan(opts) {
   const now = Date.now();
   const attributes = {
+    // Legacy (keep for backward compat)
     "ai.agent.llm.model": opts.model,
     "ai.agent.llm.latency_ms": opts.latencyMs,
     "ai.agent.llm.tokens_input": opts.tokensInput,
-    "ai.agent.llm.tokens_output": opts.tokensOutput
+    "ai.agent.llm.tokens_output": opts.tokensOutput,
+    // OTel gen_ai standard
+    "gen_ai.request.model": opts.model,
+    "gen_ai.usage.input_tokens": opts.tokensInput,
+    "gen_ai.usage.output_tokens": opts.tokensOutput,
+    "gen_ai.operation.name": "chat"
   };
   if (opts.provider !== void 0) {
     attributes["ai.agent.llm.provider"] = opts.provider;
+    attributes["gen_ai.system"] = opts.provider;
   }
+  applySkillName(attributes, opts.skillName);
   const isError = opts.status === "error";
   const status = isError ? { code: 2, ...opts.statusMessage ? { message: opts.statusMessage } : {} } : { code: 0 };
   return {
@@ -45297,8 +45310,11 @@ function buildToolSpan(opts) {
   const attributes = {
     "ai.agent.tool.name": opts.toolName,
     "ai.agent.tool.latency_ms": opts.latencyMs,
-    "ai.agent.tool.success": opts.success
+    "ai.agent.tool.success": opts.success,
+    // OTel gen_ai standard
+    "gen_ai.tool.name": opts.toolName
   };
+  applySkillName(attributes, opts.skillName);
   const status = opts.success ? { code: 0 } : { code: 2, ...opts.errorMessage ? { message: opts.errorMessage } : {} };
   return {
     traceId: opts.traceId ?? generateTraceId(),
@@ -45314,6 +45330,13 @@ function buildToolSpan(opts) {
 }
 function buildErrorSpan(opts) {
   const now = Date.now();
+  const attributes = {
+    "ai.agent.error.type": opts.errorType,
+    "ai.agent.error.message": opts.errorMessage,
+    // OTel standard
+    "error.type": opts.errorType
+  };
+  applySkillName(attributes, opts.skillName);
   return {
     traceId: opts.traceId ?? generateTraceId(),
     spanId: opts.spanId ?? generateSpanId(),
@@ -45322,10 +45345,7 @@ function buildErrorSpan(opts) {
     kind: opts.spanKind ?? "internal",
     startTime: now,
     endTime: now,
-    attributes: {
-      "ai.agent.error.type": opts.errorType,
-      "ai.agent.error.message": opts.errorMessage
-    },
+    attributes,
     status: { code: 2, message: opts.errorMessage }
   };
 }
@@ -45335,8 +45355,13 @@ function buildHttpSpan(opts) {
     "ai.agent.http.method": opts.method,
     "ai.agent.http.url": opts.url,
     "ai.agent.http.status_code": opts.statusCode,
-    "ai.agent.http.latency_ms": opts.latencyMs
+    "ai.agent.http.latency_ms": opts.latencyMs,
+    // OTel HTTP standard
+    "http.request.method": opts.method,
+    "url.full": opts.url,
+    "http.response.status_code": opts.statusCode
   };
+  applySkillName(attributes, opts.skillName);
   const isError = opts.status === "error" || opts.statusCode >= 400;
   const status = isError ? { code: 2, ...opts.statusMessage ? { message: opts.statusMessage } : {} } : { code: 0 };
   return {
@@ -45359,6 +45384,7 @@ function buildActionSpan(opts) {
     "ai.agent.action.latency_ms": opts.latencyMs,
     "ai.agent.action.success": opts.success
   };
+  applySkillName(attributes, opts.skillName);
   const status = opts.success ? { code: 0 } : { code: 2, ...opts.statusMessage ? { message: opts.statusMessage } : {} };
   return {
     traceId: opts.traceId ?? generateTraceId(),
@@ -45378,6 +45404,7 @@ function buildNavSpan(opts) {
     "ai.agent.nav.to_url": opts.toUrl,
     "ai.agent.nav.latency_ms": opts.latencyMs
   };
+  applySkillName(attributes, opts.skillName);
   const isError = opts.status === "error";
   const status = isError ? { code: 2, ...opts.statusMessage ? { message: opts.statusMessage } : {} } : { code: 0 };
   return {
@@ -45392,6 +45419,60 @@ function buildNavSpan(opts) {
     status
   };
 }
+function buildTaskSpan(opts) {
+  const now = Date.now();
+  const attributes = {
+    "ai.agent.task.id": opts.taskId,
+    "ai.agent.task.name": opts.taskName,
+    "ai.agent.task.status": opts.status,
+    "gen_ai.operation.name": "task"
+  };
+  if (opts.taskType !== void 0)
+    attributes["ai.agent.task.type"] = opts.taskType;
+  if (opts.stepsCount !== void 0)
+    attributes["ai.agent.task.steps_count"] = opts.stepsCount;
+  if (opts.tokensUsed !== void 0)
+    attributes["ai.agent.task.tokens_used"] = opts.tokensUsed;
+  applySkillName(attributes, opts.skillName);
+  const isError = opts.status === "failed";
+  const status = isError ? { code: 2, ...opts.statusMessage ? { message: opts.statusMessage } : {} } : { code: 0 };
+  return {
+    traceId: opts.traceId ?? generateTraceId(),
+    spanId: opts.spanId ?? generateSpanId(),
+    parentSpanId: opts.parentSpanId,
+    name: "task.execute",
+    kind: "internal",
+    startTime: now - opts.latencyMs,
+    endTime: now,
+    attributes,
+    status
+  };
+}
+function buildEvalSpan(opts) {
+  const now = Date.now();
+  const attributes = {
+    "gen_ai.evaluation.name": opts.evaluationName,
+    "gen_ai.evaluation.score.value": opts.scoreValue
+  };
+  if (opts.scoreLabel)
+    attributes["gen_ai.evaluation.score.label"] = opts.scoreLabel;
+  if (opts.explanation)
+    attributes["gen_ai.evaluation.explanation"] = opts.explanation;
+  if (opts.targetSpanId)
+    attributes["gen_ai.evaluation.target_span_id"] = opts.targetSpanId;
+  applySkillName(attributes, opts.skillName);
+  return {
+    traceId: opts.traceId ?? generateTraceId(),
+    spanId: opts.spanId ?? generateSpanId(),
+    parentSpanId: opts.parentSpanId,
+    name: "gen_ai.evaluation",
+    kind: "internal",
+    startTime: now,
+    endTime: now,
+    attributes,
+    status: { code: 0 }
+  };
+}
 var init_telemetry = __esm({
   "../crypto/dist/telemetry.js"() {
     "use strict";
@@ -45444,6 +45525,8 @@ var init_telemetry_reporter = __esm({
       _hubId;
       _authHeader;
       _fetch;
+      _agentName;
+      _agentVersion;
       _buffer = [];
       _timer = null;
       constructor(config) {
@@ -45451,6 +45534,8 @@ var init_telemetry_reporter = __esm({
         this._hubId = config.hubId;
         this._authHeader = config.authHeader;
         this._fetch = config.fetchImpl ?? globalThis.fetch;
+        this._agentName = config.agentName ?? "unknown";
+        this._agentVersion = config.agentVersion ?? "0.0.0";
       }
       /** Number of spans waiting to be flushed. */
       get pendingCount() {
@@ -45481,6 +45566,14 @@ var init_telemetry_reporter = __esm({
       reportNavCall(opts) {
         this._buffer.push(buildNavSpan(opts));
       }
+      /** Record an evaluation event. */
+      reportEvaluation(opts) {
+        this._buffer.push(buildEvalSpan(opts));
+      }
+      /** Record a task lifecycle event. */
+      reportTaskCall(opts) {
+        this._buffer.push(buildTaskSpan(opts));
+      }
       /** Record an arbitrary pre-built span. */
       reportCustomSpan(span) {
         this._buffer.push(span);
@@ -45508,6 +45601,12 @@ var init_telemetry_reporter = __esm({
             },
             body: JSON.stringify({
               hub_id: this._hubId,
+              resource: {
+                "gen_ai.agent.name": this._agentName,
+                "gen_ai.agent.id": this._hubId,
+                "gen_ai.agent.version": this._agentVersion,
+                "service.name": "agentvault-agent"
+              },
               spans: spans.map(spanToOtlp)
             })
           });
@@ -45702,6 +45801,156 @@ var init_transport2 = __esm({
   }
 });
 
+// src/openclaw-compat.ts
+var openclaw_compat_exports = {};
+__export(openclaw_compat_exports, {
+  onAgentEvent: () => onAgentEvent,
+  onSessionTranscriptUpdate: () => onSessionTranscriptUpdate,
+  requestHeartbeatNow: () => requestHeartbeatNow
+});
+async function requestHeartbeatNow(opts) {
+  if (_heartbeatFn === null) {
+    try {
+      const mod = await import("openclaw/dist/plugin-sdk/infra/heartbeat-wake.js");
+      _heartbeatFn = mod.requestHeartbeatNow ?? mod.default?.requestHeartbeatNow ?? false;
+    } catch {
+      _heartbeatFn = false;
+    }
+  }
+  if (typeof _heartbeatFn === "function") {
+    try {
+      await _heartbeatFn(opts);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  return false;
+}
+async function onAgentEvent(callback) {
+  if (_agentEventFn === null) {
+    try {
+      const mod = await import("openclaw/dist/plugin-sdk/infra/agent-events.js");
+      _agentEventFn = mod.onAgentEvent ?? mod.default?.onAgentEvent ?? false;
+    } catch {
+      _agentEventFn = false;
+    }
+  }
+  if (typeof _agentEventFn === "function") {
+    try {
+      return _agentEventFn(callback);
+    } catch {
+      return () => {
+      };
+    }
+  }
+  return () => {
+  };
+}
+async function onSessionTranscriptUpdate(callback) {
+  if (_transcriptFn === null) {
+    try {
+      const mod = await import("openclaw/dist/plugin-sdk/sessions/transcript-events.js");
+      _transcriptFn = mod.onSessionTranscriptUpdate ?? mod.default?.onSessionTranscriptUpdate ?? false;
+    } catch {
+      _transcriptFn = false;
+    }
+  }
+  if (typeof _transcriptFn === "function") {
+    try {
+      return _transcriptFn(callback);
+    } catch {
+      return () => {
+      };
+    }
+  }
+  return () => {
+  };
+}
+var _heartbeatFn, _agentEventFn, _transcriptFn;
+var init_openclaw_compat = __esm({
+  "src/openclaw-compat.ts"() {
+    "use strict";
+    _heartbeatFn = null;
+    _agentEventFn = null;
+    _transcriptFn = null;
+  }
+});
+
+// src/http-handlers.ts
+var http_handlers_exports = {};
+__export(http_handlers_exports, {
+  handleActionRequest: () => handleActionRequest,
+  handleSendRequest: () => handleSendRequest,
+  handleStatusRequest: () => handleStatusRequest
+});
+async function handleSendRequest(parsed, channel2) {
+  const text = parsed.text;
+  if (!text || typeof text !== "string") {
+    return { status: 400, body: { ok: false, error: "Missing 'text' field" } };
+  }
+  try {
+    if (parsed.room_id && typeof parsed.room_id === "string") {
+      await channel2.sendToRoom(parsed.room_id, text, {
+        messageType: parsed.message_type,
+        priority: parsed.priority,
+        metadata: parsed.metadata
+      });
+    } else if (parsed.file_path && typeof parsed.file_path === "string") {
+      await channel2.sendWithAttachment(text, parsed.file_path, {
+        topicId: parsed.topicId
+      });
+    } else {
+      await channel2.send(text, {
+        topicId: parsed.topicId,
+        messageType: parsed.message_type,
+        metadata: parsed.metadata
+      });
+    }
+    return { status: 200, body: { ok: true } };
+  } catch (err) {
+    return { status: 500, body: { ok: false, error: String(err) } };
+  }
+}
+async function handleActionRequest(parsed, channel2) {
+  if (!parsed.action || typeof parsed.action !== "string") {
+    return { status: 400, body: { ok: false, error: "Missing 'action' field" } };
+  }
+  try {
+    const confirmation = {
+      action: parsed.action,
+      status: parsed.status ?? "completed",
+      decisionId: parsed.decision_id,
+      detail: parsed.detail,
+      estimated_cost: parsed.estimated_cost
+    };
+    if (parsed.room_id && typeof parsed.room_id === "string") {
+      await channel2.sendActionConfirmationToRoom(parsed.room_id, confirmation);
+    } else {
+      await channel2.sendActionConfirmation(confirmation);
+    }
+    return { status: 200, body: { ok: true } };
+  } catch (err) {
+    return { status: 500, body: { ok: false, error: String(err) } };
+  }
+}
+function handleStatusRequest(channel2) {
+  return {
+    status: 200,
+    body: {
+      ok: true,
+      state: channel2.state,
+      deviceId: channel2.deviceId ?? void 0,
+      sessions: channel2.sessionCount
+    }
+  };
+}
+var init_http_handlers = __esm({
+  "src/http-handlers.ts"() {
+    "use strict";
+  }
+});
+
 // src/channel.ts
 import { EventEmitter } from "node:events";
 import { createServer } from "node:http";
@@ -45924,6 +46173,8 @@ var init_channel = __esm({
         if (this._sessions.size === 0) {
           throw new Error("No active sessions");
         }
+        Promise.resolve().then(() => (init_openclaw_compat(), openclaw_compat_exports)).then(({ requestHeartbeatNow: requestHeartbeatNow2 }) => requestHeartbeatNow2({ reason: "channel-send" })).catch(() => {
+        });
         const targetConvId = options?.conversationId;
         const topicId = options?.topicId ?? this._lastIncomingTopicId ?? this._persisted?.defaultTopicId;
         const messageType = options?.messageType ?? "text";
@@ -46075,7 +46326,7 @@ var init_channel = __esm({
        * Optional timeout rejects with an Error.
        */
       waitForDecision(decisionId, timeoutMs) {
-        return new Promise((resolve3, reject) => {
+        return new Promise((resolve4, reject) => {
           let timer = null;
           const handler = (plaintext, metadata) => {
             if (metadata.messageType !== "decision_response") return;
@@ -46084,7 +46335,7 @@ var init_channel = __esm({
               if (parsed.decision?.decision_id === decisionId) {
                 if (timer) clearTimeout(timer);
                 this.removeListener("message", handler);
-                resolve3({
+                resolve4({
                   decision_id: parsed.decision.decision_id,
                   selected_option_id: parsed.decision.selected_option_id,
                   resolved_at: parsed.decision.resolved_at,
@@ -46189,6 +46440,8 @@ var init_channel = __esm({
         if (!this._persisted?.rooms?.[roomId]) {
           throw new Error(`Room ${roomId} not found`);
         }
+        Promise.resolve().then(() => (init_openclaw_compat(), openclaw_compat_exports)).then(({ requestHeartbeatNow: requestHeartbeatNow2 }) => requestHeartbeatNow2({ reason: "channel-sendToRoom" })).catch(() => {
+        });
         const room = this._persisted.rooms[roomId];
         const messageType = opts?.messageType ?? "text";
         const recipients = [];
@@ -46456,6 +46709,11 @@ var init_channel = __esm({
       // --- Local HTTP server for proactive sends ---
       startHttpServer(port) {
         if (this._httpServer) return;
+        let _handlers = null;
+        const getHandlers = async () => {
+          if (!_handlers) _handlers = await Promise.resolve().then(() => (init_http_handlers(), http_handlers_exports));
+          return _handlers;
+        };
         this._httpServer = createServer(async (req, res) => {
           const remote = req.socket.remoteAddress;
           if (remote !== "127.0.0.1" && remote !== "::1" && remote !== "::ffff:127.0.0.1") {
@@ -46463,6 +46721,7 @@ var init_channel = __esm({
             res.end(JSON.stringify({ ok: false, error: "Forbidden" }));
             return;
           }
+          const handlers = await getHandlers();
           if (req.method === "POST" && req.url === "/send") {
             let body = "";
             req.on("data", (chunk) => {
@@ -46471,29 +46730,9 @@ var init_channel = __esm({
             req.on("end", async () => {
               try {
                 const parsed = JSON.parse(body);
-                const text = parsed.text;
-                if (!text || typeof text !== "string") {
-                  res.writeHead(400, { "Content-Type": "application/json" });
-                  res.end(JSON.stringify({ ok: false, error: "Missing 'text' field" }));
-                  return;
-                }
-                if (parsed.room_id && typeof parsed.room_id === "string") {
-                  await this.sendToRoom(parsed.room_id, text, {
-                    messageType: parsed.message_type,
-                    priority: parsed.priority,
-                    metadata: parsed.metadata
-                  });
-                } else if (parsed.file_path && typeof parsed.file_path === "string") {
-                  await this.sendWithAttachment(text, parsed.file_path, { topicId: parsed.topicId });
-                } else {
-                  await this.send(text, {
-                    topicId: parsed.topicId,
-                    messageType: parsed.message_type,
-                    metadata: parsed.metadata
-                  });
-                }
-                res.writeHead(200, { "Content-Type": "application/json" });
-                res.end(JSON.stringify({ ok: true }));
+                const result = await handlers.handleSendRequest(parsed, this);
+                res.writeHead(result.status, { "Content-Type": "application/json" });
+                res.end(JSON.stringify(result.body));
               } catch (err) {
                 res.writeHead(500, { "Content-Type": "application/json" });
                 res.end(JSON.stringify({ ok: false, error: String(err) }));
@@ -46507,38 +46746,18 @@ var init_channel = __esm({
             req.on("end", async () => {
               try {
                 const parsed = JSON.parse(body);
-                if (!parsed.action || typeof parsed.action !== "string") {
-                  res.writeHead(400, { "Content-Type": "application/json" });
-                  res.end(JSON.stringify({ ok: false, error: "Missing 'action' field" }));
-                  return;
-                }
-                const confirmation = {
-                  action: parsed.action,
-                  status: parsed.status ?? "completed",
-                  decisionId: parsed.decision_id,
-                  detail: parsed.detail,
-                  estimated_cost: parsed.estimated_cost
-                };
-                if (parsed.room_id && typeof parsed.room_id === "string") {
-                  await this.sendActionConfirmationToRoom(parsed.room_id, confirmation);
-                } else {
-                  await this.sendActionConfirmation(confirmation);
-                }
-                res.writeHead(200, { "Content-Type": "application/json" });
-                res.end(JSON.stringify({ ok: true }));
+                const result = await handlers.handleActionRequest(parsed, this);
+                res.writeHead(result.status, { "Content-Type": "application/json" });
+                res.end(JSON.stringify(result.body));
               } catch (err) {
                 res.writeHead(500, { "Content-Type": "application/json" });
                 res.end(JSON.stringify({ ok: false, error: String(err) }));
               }
             });
           } else if (req.method === "GET" && req.url === "/status") {
-            res.writeHead(200, { "Content-Type": "application/json" });
-            res.end(JSON.stringify({
-              ok: true,
-              state: this._state,
-              deviceId: this._deviceId,
-              sessions: this._sessions.size
-            }));
+            const result = handlers.handleStatusRequest(this);
+            res.writeHead(result.status, { "Content-Type": "application/json" });
+            res.end(JSON.stringify(result.body));
           } else {
             res.writeHead(404, { "Content-Type": "application/json" });
             res.end(JSON.stringify({ ok: false, error: "Not found. Use POST /send, POST /action, or GET /status" }));
@@ -47015,7 +47234,9 @@ var init_channel = __esm({
               this._telemetryReporter = new TelemetryReporter({
                 apiBase: this.config.apiUrl,
                 hubId: this._persisted.hubId,
-                authHeader: `Bearer ${this._persisted.deviceJwt}`
+                authHeader: `Bearer ${this._persisted.deviceJwt}`,
+                agentName: this.config.agentName ?? this._persisted.hubAddress,
+                agentVersion: this.config.agentVersion ?? "0.0.0"
               });
               this._telemetryReporter.startAutoFlush(3e4);
             }
@@ -47134,7 +47355,9 @@ var init_channel = __esm({
                   this._telemetryReporter = new TelemetryReporter({
                     apiBase: this.config.apiUrl,
                     hubId: this._persisted.hubId,
-                    authHeader: `Bearer ${this._persisted.deviceJwt}`
+                    authHeader: `Bearer ${this._persisted.deviceJwt}`,
+                    agentName: this.config.agentName ?? this._persisted.hubAddress,
+                    agentVersion: this.config.agentVersion ?? "0.0.0"
                   });
                   this._telemetryReporter.startAutoFlush(3e4);
                 }
@@ -48455,6 +48678,7 @@ var init_openclaw_plugin = __esm({
     "use strict";
     await init_channel();
     init_account_config();
+    init_openclaw_compat();
   }
 });
 
@@ -48467,6 +48691,9 @@ __export(gateway_send_exports, {
 function resolveBaseUrl(options) {
   const host = options?.host ?? "127.0.0.1";
   const port = options?.port ?? (process.env.GATEWAY_SEND_PORT ? Number(process.env.GATEWAY_SEND_PORT) : 18790);
+  if (!options?.port && !options?.host && process.env.OPENCLAW_GATEWAY_URL) {
+    return process.env.OPENCLAW_GATEWAY_URL;
+  }
   return `http://${host}:${port}`;
 }
 function friendlyError(err) {
@@ -48479,9 +48706,12 @@ async function sendToOwner(text, options) {
   if (typeof text !== "string" || text.trim().length === 0) {
     return { ok: false, error: "Message text must be a non-empty string" };
   }
+  requestHeartbeatNow({ reason: "proactive-send" }).catch(() => {
+  });
   try {
     const base = resolveBaseUrl(options);
-    const res = await fetch(`${base}/send`, {
+    const sendPath = process.env.OPENCLAW_GATEWAY_URL ? "/agentvault/send" : "/send";
+    const res = await fetch(`${base}${sendPath}`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ text }),
@@ -48499,7 +48729,8 @@ async function sendToOwner(text, options) {
 async function checkGateway(options) {
   try {
     const base = resolveBaseUrl(options);
-    const res = await fetch(`${base}/status`, { signal: options?.signal });
+    const statusPath = process.env.OPENCLAW_GATEWAY_URL ? "/agentvault/status" : "/status";
+    const res = await fetch(`${base}${statusPath}`, { signal: options?.signal });
     if (!res.ok) {
       return { ok: false, error: `HTTP ${res.status}` };
     }
@@ -48517,6 +48748,28 @@ async function checkGateway(options) {
 var init_gateway_send = __esm({
   "src/gateway-send.ts"() {
     "use strict";
+    init_openclaw_compat();
+  }
+});
+
+// src/fetch-interceptor.ts
+import { AsyncLocalStorage } from "node:async_hooks";
+var traceStore;
+var init_fetch_interceptor = __esm({
+  "src/fetch-interceptor.ts"() {
+    "use strict";
+    traceStore = new AsyncLocalStorage();
+  }
+});
+
+// src/openclaw-entry.ts
+var init_openclaw_entry = __esm({
+  "src/openclaw-entry.ts"() {
+    "use strict";
+    init_account_config();
+    init_fetch_interceptor();
+    init_http_handlers();
+    init_openclaw_compat();
   }
 });
 
@@ -48529,7 +48782,10 @@ var init_index = __esm({
     init_account_config();
     await init_openclaw_plugin();
     init_gateway_send();
-    VERSION = "0.13.9";
+    init_openclaw_compat();
+    init_openclaw_entry();
+    init_http_handlers();
+    VERSION = "0.14.0";
   }
 });
 
@@ -48866,7 +49122,7 @@ async function promptAndRestart(env) {
   }
 }
 function ask(question) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     const rl2 = readline.createInterface({
       input: process.stdin,
       output: process.stdout,
@@ -48874,7 +49130,7 @@ function ask(question) {
     });
     rl2.question(question, (answer) => {
       rl2.close();
-      resolve3(answer);
+      resolve4(answer);
     });
   });
 }
@@ -48887,10 +49143,104 @@ var init_setup = __esm({
   }
 });
 
+// src/skills-publish.ts
+var skills_publish_exports = {};
+__export(skills_publish_exports, {
+  publishSkills: () => publishSkills
+});
+import { readFileSync } from "node:fs";
+import { resolve as resolve2 } from "node:path";
+async function publishSkills(opts) {
+  if (!opts.manifest) {
+    console.error("Error: --manifest is required");
+    process.exit(1);
+  }
+  if (!opts.apiKey) {
+    console.error("Error: --api-key or AGENTVAULT_API_KEY is required");
+    process.exit(1);
+  }
+  const manifestPath = resolve2(opts.manifest);
+  let raw;
+  try {
+    raw = readFileSync(manifestPath, "utf-8");
+  } catch {
+    console.error(`Error: Cannot read manifest file: ${manifestPath}`);
+    process.exit(1);
+  }
+  let manifest;
+  try {
+    manifest = JSON.parse(raw);
+  } catch {
+    console.error("Error: Invalid JSON in manifest file");
+    process.exit(1);
+  }
+  if (!Array.isArray(manifest.skills) || manifest.skills.length === 0) {
+    console.error("Error: Manifest must contain a non-empty 'skills' array");
+    process.exit(1);
+  }
+  for (const skill of manifest.skills) {
+    if (!skill.name || typeof skill.name !== "string") {
+      console.error("Error: Each skill must have a 'name' string");
+      process.exit(1);
+    }
+    if (skill.sla?.max_error_rate !== void 0 && (skill.sla.max_error_rate < 0 || skill.sla.max_error_rate > 1)) {
+      console.error(
+        `Error: Skill "${skill.name}" max_error_rate must be 0.0-1.0`
+      );
+      process.exit(1);
+    }
+    if (skill.sla?.min_uptime_pct !== void 0 && (skill.sla.min_uptime_pct < 0 || skill.sla.min_uptime_pct > 100)) {
+      console.error(
+        `Error: Skill "${skill.name}" min_uptime_pct must be 0-100`
+      );
+      process.exit(1);
+    }
+  }
+  const capabilities = manifest.skills.map((s2) => ({
+    capability_name: s2.name,
+    capability_version: s2.version ?? null,
+    description: s2.description ?? null,
+    sla_definition: s2.sla ? {
+      p95_latency_ms: s2.sla.p95_latency_ms ?? null,
+      max_error_rate: s2.sla.max_error_rate ?? null,
+      min_uptime_pct: s2.sla.min_uptime_pct ?? null,
+      max_avg_tokens: s2.sla.max_avg_tokens ?? null
+    } : null
+  }));
+  const url = `${opts.apiUrl}/api/v1/hub/skills/publish`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${opts.apiKey}`
+    },
+    body: JSON.stringify(capabilities)
+  });
+  if (!res.ok) {
+    const text = await res.text();
+    console.error(`Error: API returned ${res.status}: ${text}`);
+    process.exit(1);
+  }
+  const result = await res.json();
+  console.log(`Published ${result.length} skill(s) successfully.`);
+  for (const cap of result) {
+    const status = cap.verification_status ?? "declared";
+    const sla = cap.sla_definition ? " (SLA defined)" : "";
+    console.log(
+      `  - ${cap.capability_name}${cap.capability_version ? `@${cap.capability_version}` : ""}: ${status}${sla}`
+    );
+  }
+}
+var init_skills_publish = __esm({
+  "src/skills-publish.ts"() {
+    "use strict";
+  }
+});
+
 // src/cli.ts
 await init_channel();
 await init_setup();
-import { resolve as resolve2 } from "node:path";
+import { resolve as resolve3 } from "node:path";
 import { createInterface as createInterface2 } from "node:readline";
 var _notifier = null;
 async function tryNotify(title, message) {
@@ -49005,6 +49355,20 @@ if (subcommand === "status") {
   }
   process.exit(0);
 }
+if (subcommand === "skills") {
+  const subAction = args[1];
+  if (subAction === "publish") {
+    const { publishSkills: publishSkills2 } = await Promise.resolve().then(() => (init_skills_publish(), skills_publish_exports));
+    await publishSkills2({
+      manifest: flags["manifest"],
+      apiKey: flags["api-key"] || process.env.AGENTVAULT_API_KEY,
+      apiUrl
+    });
+    process.exit(0);
+  }
+  console.error(`Usage: agentvault skills publish --manifest=./skill-manifest.json`);
+  process.exit(1);
+}
 if (!token) {
   console.error(`
 AgentVault Secure Channel CLI
@@ -49014,6 +49378,7 @@ Usage:
   npx @agentvault/agentvault pm2-setup              # Configure pm2 (existing install)
   npx @agentvault/agentvault send "message"         # Send a message to the owner
   npx @agentvault/agentvault status                 # Check gateway status
+  npx @agentvault/agentvault skills publish --manifest=FILE  # Publish skills from manifest
   npx @agentvault/agentvault --token=TOKEN          # Standalone interactive CLI
 
 Options:
@@ -49021,6 +49386,7 @@ Options:
   --name=NAME            Agent display name (default: "CLI Agent")
   --data-dir=PATH        Directory for persistent state (default: ./agentvault-data)
   --api-url=URL          API endpoint (default: https://api.agentvault.chat)
+  --api-key=KEY          API key for skills publish (or AGENTVAULT_API_KEY env var)
   --account-id=ID        Multi-agent account identifier (e.g., "work", "research")
   --webhook-url=URL      URL for HTTP webhook notifications on new messages
   --no-notifications     Disable OS desktop notifications
@@ -49031,6 +49397,7 @@ Environment variables:
   AGENTVAULT_AGENT_NAME         Same as --name
   AGENTVAULT_DATA_DIR           Same as --data-dir
   AGENTVAULT_API_URL            Same as --api-url
+  AGENTVAULT_API_KEY            Same as --api-key (for skills publish)
   AGENTVAULT_ACCOUNT_ID         Same as --account-id
   AGENTVAULT_WEBHOOK_URL        Same as --webhook-url
   AGENTVAULT_NO_NOTIFICATIONS   Set to "1" to disable desktop notifications
@@ -49046,6 +49413,9 @@ Examples:
   # Check gateway status:
   npx @agentvault/agentvault status
 
+  # Publish skills from a manifest (CI/CD):
+  npx @agentvault/agentvault skills publish --manifest=./skill-manifest.json --api-key=av_agent_sk_...
+
   # Standalone interactive CLI:
   npx @agentvault/agentvault --token=av_tok_abc123 --name="My Agent"
 `);
@@ -49063,7 +49433,7 @@ var stateMessages = {
 };
 var channel = new SecureChannel({
   inviteToken: token,
-  dataDir: resolve2(dataDir),
+  dataDir: resolve3(dataDir),
   apiUrl,
   agentName: name,
   webhookUrl,