@useorgx/openclaw-plugin 0.4.3 → 0.4.4

package/dist/contracts/client.js

@@ -201,16 +201,36 @@ export class OrgXClient {
     // Spawn Guard (Quality Gate + Model Routing)
     // ===========================================================================
     async checkSpawnGuard(domain, taskId) {
-        return this.post("/api/client/spawn", {
+        const response = await this.post("/api/client/spawn", {
             domain,
             taskId,
         });
+        // Newer servers wrap responses in { ok, data } while older clients expect the
+        // SpawnGuardResult fields at top-level.
+        if (response &&
+            typeof response === "object" &&
+            "data" in response &&
+            response.data) {
+            return response.data;
+        }
+        return response;
     }
     // ===========================================================================
     // Quality Scores
     // ===========================================================================
     async recordQuality(score) {
-        return this.post("/api/client/quality", score);
+        const response = await this.post("/api/client/quality", score);
+        // Backwards-compatible: accept either { success: true } or { ok: true, data: ... }.
+        if (response &&
+            typeof response === "object" &&
+            "success" in response &&
+            typeof response.success === "boolean") {
+            return response;
+        }
+        if (response && typeof response === "object" && "ok" in response) {
+            return { success: Boolean(response.ok) };
+        }
+        return { success: true };
     }
     // ===========================================================================
     // Entity CRUD

package/dist/index.js

@@ -22,6 +22,7 @@ import { clearPersistedSnapshot, readPersistedSnapshot, writePersistedSnapshot,
 import { appendToOutbox, readOutbox, readOutboxSummary, replaceOutbox, } from "./outbox.js";
 import { extractProgressOutboxMessage } from "./reporting/outbox-replay.js";
 import { ensureGatewayWatchdog } from "./gateway-watchdog.js";
+import { posthogCapture } from "./telemetry/posthog.js";
 export { OrgXClient } from "./api.js";
 const DEFAULT_BASE_URL = "https://www.useorgx.com";
 const DEFAULT_DOCS_URL = "https://orgx.mintlify.site/guides/openclaw-plugin-setup";
@@ -325,6 +326,19 @@ export default function register(api) {
         api.log?.info?.("[orgx] Plugin disabled");
         return;
     }
+    void posthogCapture({
+        event: "openclaw_plugin_loaded",
+        distinctId: config.installationId,
+        properties: {
+            plugin_version: config.pluginVersion,
+            dashboard_enabled: config.dashboardEnabled,
+            has_api_key: Boolean(config.apiKey),
+            api_key_source: config.apiKeySource,
+            base_url: config.baseUrl,
+        },
+    }).catch(() => {
+        // best effort
+    });
     if (!config.apiKey) {
         api.log?.warn?.("[orgx] No API key. Set plugins.entries.orgx.config.apiKey, ORGX_API_KEY env, or ~/Code/orgx/orgx/.env.local");
     }
@@ -391,6 +405,140 @@ export default function register(api) {
             return err.message;
         return typeof err === "string" ? err : "Unexpected error";
     }
+    const registerTool = api.registerTool.bind(api);
+    api.registerTool = (tool, options) => {
+        const toolName = tool.name;
+        const optional = Boolean(options?.optional);
+        registerTool({
+            ...tool,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            execute: async (callId, params) => {
+                const startedAt = Date.now();
+                void posthogCapture({
+                    event: "openclaw_tool_called",
+                    distinctId: config.installationId,
+                    properties: {
+                        tool_name: toolName,
+                        tool_optional: optional,
+                        call_id: callId,
+                        plugin_version: config.pluginVersion,
+                    },
+                }).catch(() => {
+                    // best effort
+                });
+                try {
+                    const result = await tool.execute(callId, params);
+                    const durationMs = Date.now() - startedAt;
+                    void posthogCapture({
+                        event: "openclaw_tool_succeeded",
+                        distinctId: config.installationId,
+                        properties: {
+                            tool_name: toolName,
+                            tool_optional: optional,
+                            call_id: callId,
+                            duration_ms: durationMs,
+                            plugin_version: config.pluginVersion,
+                        },
+                    }).catch(() => {
+                        // best effort
+                    });
+                    return result;
+                }
+                catch (err) {
+                    const durationMs = Date.now() - startedAt;
+                    void posthogCapture({
+                        event: "openclaw_tool_failed",
+                        distinctId: config.installationId,
+                        properties: {
+                            tool_name: toolName,
+                            tool_optional: optional,
+                            call_id: callId,
+                            duration_ms: durationMs,
+                            plugin_version: config.pluginVersion,
+                            error: toErrorMessage(err),
+                        },
+                    }).catch(() => {
+                        // best effort
+                    });
+                    throw err;
+                }
+            },
+        }, options);
+    };
+    const registerService = api.registerService.bind(api);
+    api.registerService = (service) => {
+        registerService({
+            ...service,
+            start: async () => {
+                const startedAt = Date.now();
+                try {
+                    await service.start();
+                    const durationMs = Date.now() - startedAt;
+                    void posthogCapture({
+                        event: "openclaw_service_started",
+                        distinctId: config.installationId,
+                        properties: {
+                            service_id: service.id,
+                            duration_ms: durationMs,
+                            plugin_version: config.pluginVersion,
+                        },
+                    }).catch(() => {
+                        // best effort
+                    });
+                }
+                catch (err) {
+                    const durationMs = Date.now() - startedAt;
+                    void posthogCapture({
+                        event: "openclaw_service_start_failed",
+                        distinctId: config.installationId,
+                        properties: {
+                            service_id: service.id,
+                            duration_ms: durationMs,
+                            plugin_version: config.pluginVersion,
+                            error: toErrorMessage(err),
+                        },
+                    }).catch(() => {
+                        // best effort
+                    });
+                    throw err;
+                }
+            },
+            stop: async () => {
+                const startedAt = Date.now();
+                try {
+                    await service.stop();
+                    const durationMs = Date.now() - startedAt;
+                    void posthogCapture({
+                        event: "openclaw_service_stopped",
+                        distinctId: config.installationId,
+                        properties: {
+                            service_id: service.id,
+                            duration_ms: durationMs,
+                            plugin_version: config.pluginVersion,
+                        },
+                    }).catch(() => {
+                        // best effort
+                    });
+                }
+                catch (err) {
+                    const durationMs = Date.now() - startedAt;
+                    void posthogCapture({
+                        event: "openclaw_service_stop_failed",
+                        distinctId: config.installationId,
+                        properties: {
+                            service_id: service.id,
+                            duration_ms: durationMs,
+                            plugin_version: config.pluginVersion,
+                            error: toErrorMessage(err),
+                        },
+                    }).catch(() => {
+                        // best effort
+                    });
+                    throw err;
+                }
+            },
+        });
+    };
     function clearPairingState() {
         activePairing = null;
         updateOnboardingState({

package/dist/telemetry/posthog.d.ts

@@ -0,0 +1,8 @@
+export declare function isOrgxTelemetryDisabled(): boolean;
+export declare function resolvePosthogApiKey(): string | null;
+export declare function resolvePosthogHost(): string;
+export declare function posthogCapture(input: {
+    event: string;
+    distinctId: string;
+    properties?: Record<string, unknown>;
+}): Promise<void>;

package/dist/telemetry/posthog.js

@@ -0,0 +1,81 @@
+const POSTHOG_DEFAULT_API_KEY = "phc_s4KPgkYEFZgvkMYw4zXG41H5FN6haVwbEWPYHfNjxOc";
+const POSTHOG_DEFAULT_HOST = "https://us.i.posthog.com";
+function isTruthyEnv(value) {
+    if (!value)
+        return false;
+    switch (value.trim().toLowerCase()) {
+        case "1":
+        case "true":
+        case "yes":
+        case "y":
+        case "on":
+            return true;
+        default:
+            return false;
+    }
+}
+export function isOrgxTelemetryDisabled() {
+    return (isTruthyEnv(process.env.ORGX_TELEMETRY_DISABLED) ||
+        isTruthyEnv(process.env.OPENCLAW_TELEMETRY_DISABLED) ||
+        isTruthyEnv(process.env.POSTHOG_DISABLED));
+}
+export function resolvePosthogApiKey() {
+    const fromEnv = process.env.ORGX_POSTHOG_API_KEY ??
+        process.env.POSTHOG_API_KEY ??
+        process.env.ORGX_POSTHOG_KEY ??
+        process.env.POSTHOG_KEY ??
+        "";
+    const trimmed = fromEnv.trim();
+    if (trimmed)
+        return trimmed;
+    return POSTHOG_DEFAULT_API_KEY;
+}
+export function resolvePosthogHost() {
+    const fromEnv = process.env.ORGX_POSTHOG_HOST ??
+        process.env.POSTHOG_HOST ??
+        process.env.ORGX_POSTHOG_API_HOST ??
+        process.env.POSTHOG_API_HOST ??
+        "";
+    const trimmed = fromEnv.trim();
+    return trimmed || POSTHOG_DEFAULT_HOST;
+}
+function toPosthogBatchUrl(host) {
+    try {
+        return new URL("/batch/", host).toString();
+    }
+    catch {
+        return `${POSTHOG_DEFAULT_HOST}/batch/`;
+    }
+}
+export async function posthogCapture(input) {
+    if (isOrgxTelemetryDisabled())
+        return;
+    const apiKey = resolvePosthogApiKey();
+    if (!apiKey)
+        return;
+    const url = toPosthogBatchUrl(resolvePosthogHost());
+    const now = new Date().toISOString();
+    const body = {
+        api_key: apiKey,
+        batch: [
+            {
+                type: "capture",
+                event: input.event,
+                distinct_id: input.distinctId,
+                properties: {
+                    $lib: "orgx-openclaw-plugin",
+                    ...(input.properties ?? {}),
+                },
+                timestamp: now,
+            },
+        ],
+        sent_at: now,
+    };
+    await fetch(url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    }).then(() => undefined);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useorgx/openclaw-plugin",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "OrgX plugin for OpenClaw — agent orchestration, quality gates, model routing, and live dashboard",
   "type": "module",
   "main": "./dist/index.js",

package/dashboard/dist/assets/Cpr7n8fE.js

@@ -1 +0,0 @@
-var z={exports:{}},K={};var Y;function le(){return Y||(Y=1,(function(e){function n(t,i){var a=t.length;t.push(i);e:for(;0<a;){var l=a-1>>>1,f=t[l];if(0<o(f,i))t[l]=i,t[a]=f,a=l;else break e}}function r(t){return t.length===0?null:t[0]}function s(t){if(t.length===0)return null;var i=t[0],a=t.pop();if(a!==i){t[0]=a;e:for(var l=0,f=t.length,S=f>>>1;l<S;){var E=2*(l+1)-1,R=t[E],w=E+1,G=t[w];if(0>o(R,a))w<f&&0>o(G,R)?(t[l]=G,t[w]=a,l=w):(t[l]=R,t[E]=a,l=E);else if(w<f&&0>o(G,a))t[l]=G,t[w]=a,l=w;else break e}}return i}function o(t,i){var a=t.sortIndex-i.sortIndex;return a!==0?a:t.id-i.id}if(typeof performance=="object"&&typeof performance.now=="function"){var d=performance;e.unstable_now=function(){return d.now()}}else{var T=Date,h=T.now();e.unstable_now=function(){return T.now()-h}}var u=[],m=[],g=1,p=null,c=3,y=!1,b=!1,P=!1,j=typeof setTimeout=="function"?setTimeout:null,x=typeof clearTimeout=="function"?clearTimeout:null,H=typeof setImmediate<"u"?setImmediate:null;typeof navigator<"u"&&navigator.scheduling!==void 0&&navigator.scheduling.isInputPending!==void 0&&navigator.scheduling.isInputPending.bind(navigator.scheduling);function B(t){for(var i=r(m);i!==null;){if(i.callback===null)s(m);else if(i.startTime<=t)s(m),i.sortIndex=i.expirationTime,n(u,i);else break;i=r(m)}}function D(t){if(P=!1,B(t),!b)if(r(u)!==null)b=!0,q(M);else{var i=r(m);i!==null&&F(D,i.startTime-t)}}function M(t,i){b=!1,P&&(P=!1,x(A),A=-1),y=!0;var a=c;try{for(B(i),p=r(u);p!==null&&(!(p.expirationTime>i)||t&&!Q());){var l=p.callback;if(typeof l=="function"){p.callback=null,c=p.priorityLevel;var f=l(p.expirationTime<=i);i=e.unstable_now(),typeof f=="function"?p.callback=f:p===r(u)&&s(u),B(i)}else s(u);p=r(u)}if(p!==null)var S=!0;else{var E=r(m);E!==null&&F(D,E.startTime-i),S=!1}return S}finally{p=null,c=a,y=!1}}var I=!1,C=null,A=-1,V=5,J=-1;function Q(){return!(e.unstable_now()-J<V)}function N(){if(C!==null){var t=e.unstable_now();J=t;var i=!0;try{i=C(!0,t)}finally{i?_():(I=!1,C=null)}}else I=!1}var _;if(typeof H=="function")_=function(){H(N)};else if(typeof MessageChannel<"u"){var X=new MessageChannel,ue=X.port2;X.port1.onmessage=N,_=function(){ue.postMessage(null)}}else _=function(){j(N,0)};function q(t){C=t,I||(I=!0,_())}function F(t,i){A=j(function(){t(e.unstable_now())},i)}e.unstable_IdlePriority=5,e.unstable_ImmediatePriority=1,e.unstable_LowPriority=4,e.unstable_NormalPriority=3,e.unstable_Profiling=null,e.unstable_UserBlockingPriority=2,e.unstable_cancelCallback=function(t){t.callback=null},e.unstable_continueExecution=function(){b||y||(b=!0,q(M))},e.unstable_forceFrameRate=function(t){0>t||125<t||(V=0<t?Math.floor(1e3/t):5)},e.unstable_getCurrentPriorityLevel=function(){return c},e.unstable_getFirstCallbackNode=function(){return r(u)},e.unstable_next=function(t){switch(c){case 1:case 2:case 3:var i=3;break;default:i=c}var a=c;c=i;try{return t()}finally{c=a}},e.unstable_pauseExecution=function(){},e.unstable_requestPaint=function(){},e.unstable_runWithPriority=function(t,i){switch(t){case 1:case 2:case 3:case 4:case 5:break;default:t=3}var a=c;c=t;try{return i()}finally{c=a}},e.unstable_scheduleCallback=function(t,i,a){var l=e.unstable_now();switch(typeof a=="object"&&a!==null?(a=a.delay,a=typeof a=="number"&&0<a?l+a:l):a=l,t){case 1:var f=-1;break;case 2:f=250;break;case 5:f=1073741823;break;case 4:f=1e4;break;default:f=5e3}return f=a+f,t={id:g++,callback:i,priorityLevel:t,startTime:a,expirationTime:f,sortIndex:-1},a>l?(t.sortIndex=a,n(m,t),r(u)===null&&t===r(m)&&(P?(x(A),A=-1):P=!0,F(D,a-l))):(t.sortIndex=f,n(u,t),b||y||(b=!0,q(M))),t},e.unstable_shouldYield=Q,e.unstable_wrapCallback=function(t){var i=c;return function(){var a=c;c=i;try{return t.apply(this,arguments)}finally{c=a}}}})(K)),K}var Z;function Ae(){return Z||(Z=1,z.exports=le()),z.exports}const ce=e=>e;let _e=ce;function re(e){let n;return()=>(n===void 0&&(n=e()),n)}const fe=(e,n,r)=>{const s=n-e;return s===0?1:(r-e)/s},ke=e=>e*1e3,Le=e=>e/1e3,de=re(()=>window.ScrollTimeline!==void 0);class pe{constructor(n){this.stop=()=>this.runAll("stop"),this.animations=n.filter(Boolean)}get finished(){return Promise.all(this.animations.map(n=>"finished"in n?n.finished:n))}getAll(n){return this.animations[0][n]}setAll(n,r){for(let s=0;s<this.animations.length;s++)this.animations[s][n]=r}attachTimeline(n,r){const s=this.animations.map(o=>{if(de()&&o.attachTimeline)return o.attachTimeline(n);if(typeof r=="function")return r(o)});return()=>{s.forEach((o,d)=>{o&&o(),this.animations[d].stop()})}}get time(){return this.getAll("time")}set time(n){this.setAll("time",n)}get speed(){return this.getAll("speed")}set speed(n){this.setAll("speed",n)}get startTime(){return this.getAll("startTime")}get duration(){let n=0;for(let r=0;r<this.animations.length;r++)n=Math.max(n,this.animations[r].duration);return n}runAll(n){this.animations.forEach(r=>r[n]())}flatten(){this.runAll("flatten")}play(){this.runAll("play")}pause(){this.runAll("pause")}cancel(){this.runAll("cancel")}complete(){this.runAll("complete")}}class Ie extends pe{then(n,r){return Promise.all(this.animations).then(n).catch(r)}}function Ce(e,n){return e?e[n]||e.default||e:void 0}const $=2e4;function Se(e){let n=0;const r=50;let s=e.next(n);for(;!s.done&&n<$;)n+=r,s=e.next(n);return n>=$?1/0:n}function Ge(e){return typeof e=="function"}function Be(e,n){e.timeline=n,e.onfinish=null}const ie=e=>Array.isArray(e)&&typeof e[0]=="number",he={linearEasing:void 0};function me(e,n){const r=re(e);return()=>{var s;return(s=he[n])!==null&&s!==void 0?s:r()}}const U=me(()=>{try{document.createElement("div").animate({opacity:0},{easing:"linear(0, 1)"})}catch{return!1}return!0},"linearEasing"),ye=(e,n,r=10)=>{let s="";const o=Math.max(Math.round(n/r),2);for(let d=0;d<o;d++)s+=e(fe(0,o-1,d))+", ";return`linear(${s.substring(0,s.length-2)})`};function ve(e){return!!(typeof e=="function"&&U()||!e||typeof e=="string"&&(e in W||U())||ie(e)||Array.isArray(e)&&e.every(ve))}const k=([e,n,r,s])=>`cubic-bezier(${e}, ${n}, ${r}, ${s})`,W={linear:"linear",ease:"ease",easeIn:"ease-in",easeOut:"ease-out",easeInOut:"ease-in-out",circIn:k([0,.65,.55,1]),circOut:k([.55,0,1,.45]),backIn:k([.31,.01,.66,-.59]),backOut:k([.33,1.53,.69,.99])};function be(e,n){if(e)return typeof e=="function"&&U()?ye(e,n):ie(e)?k(e):Array.isArray(e)?e.map(r=>be(r,n)||W.easeOut):W[e]}const v={x:!1,y:!1};function se(){return v.x||v.y}function ge(e,n,r){var s;if(e instanceof Element)return[e];if(typeof e=="string"){let o=document;const d=(s=void 0)!==null&&s!==void 0?s:o.querySelectorAll(e);return d?Array.from(d):[]}return Array.from(e)}function ae(e,n){const r=ge(e),s=new AbortController,o={passive:!0,...n,signal:s.signal};return[r,o,()=>s.abort()]}function ee(e){return n=>{n.pointerType==="touch"||se()||e(n)}}function De(e,n,r={}){const[s,o,d]=ae(e,r),T=ee(h=>{const{target:u}=h,m=n(h);if(typeof m!="function"||!u)return;const g=ee(p=>{m(p),u.removeEventListener("pointerleave",g)});u.addEventListener("pointerleave",g,o)});return s.forEach(h=>{h.addEventListener("pointerenter",T,o)}),d}const oe=(e,n)=>n?e===n?!0:oe(e,n.parentElement):!1,Ee=e=>e.pointerType==="mouse"?typeof e.button!="number"||e.button<=0:e.isPrimary!==!1,we=new Set(["BUTTON","INPUT","SELECT","TEXTAREA","A"]);function Te(e){return we.has(e.tagName)||e.tabIndex!==-1}const L=new WeakSet;function ne(e){return n=>{n.key==="Enter"&&e(n)}}function O(e,n){e.dispatchEvent(new PointerEvent("pointer"+n,{isPrimary:!0,bubbles:!0}))}const Pe=(e,n)=>{const r=e.currentTarget;if(!r)return;const s=ne(()=>{if(L.has(r))return;O(r,"down");const o=ne(()=>{O(r,"up")}),d=()=>O(r,"cancel");r.addEventListener("keyup",o,n),r.addEventListener("blur",d,n)});r.addEventListener("keydown",s,n),r.addEventListener("blur",()=>r.removeEventListener("keydown",s),n)};function te(e){return Ee(e)&&!se()}function Me(e,n,r={}){const[s,o,d]=ae(e,r),T=h=>{const u=h.currentTarget;if(!te(h)||L.has(u))return;L.add(u);const m=n(h),g=(y,b)=>{window.removeEventListener("pointerup",p),window.removeEventListener("pointercancel",c),!(!te(y)||!L.has(u))&&(L.delete(u),typeof m=="function"&&m(y,{success:b}))},p=y=>{g(y,r.useGlobalTarget||oe(u,y.target))},c=y=>{g(y,!1)};window.addEventListener("pointerup",p,o),window.addEventListener("pointercancel",c,o)};return s.forEach(h=>{!Te(h)&&h.getAttribute("tabindex")===null&&(h.tabIndex=0),(r.useGlobalTarget?window:h).addEventListener("pointerdown",T,o),h.addEventListener("focus",m=>Pe(m,o),o)}),d}function Ne(e){return e==="x"||e==="y"?v[e]?null:(v[e]=!0,()=>{v[e]=!1}):v.x||v.y?null:(v.x=v.y=!0,()=>{v.x=v.y=!1})}export{Ie as G,$ as a,ie as b,Se as c,_e as d,be as e,re as f,ye as g,U as h,Ge as i,Be as j,ve as k,Ce as l,Le as m,ce as n,Ee as o,fe as p,Ne as q,Ae as r,ke as s,De as t,Me as u};