@aight-cool/aight-utils 0.1.17 → 0.1.19

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "aight-utils",
   "name": "Aight App Utils",
   "description": "Aight App: Push notifications, Today items, config RPC, and agent bootstrap",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@aight-cool/aight-utils",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "OpenClaw gateway plugin for Aight App: push notifications, Today items, config RPC, and agent bootstrap",
   "type": "module",
   "files": [
-    "index.ts",
-    "src/",
-    "hooks/",
+    "dist/",
+    "hooks/**/HOOK.md",
     "openclaw.plugin.json",
     "README.md",
     "LICENSE"
@@ -29,6 +28,8 @@
     "lint": "eslint . --ext .ts",
     "format": "prettier --check .",
     "format:fix": "prettier --write .",
+    "build": "tsup",
+    "prepublishOnly": "npm run build",
     "ci": "npm run typecheck && npm run lint && npm run format && npm test"
   },
   "dependencies": {
@@ -45,13 +46,14 @@
     "eslint": "^9.39.2",
     "openclaw": "*",
     "prettier": "^3.8.1",
+    "tsup": "^8.5.1",
     "typescript": "^5.7.0",
     "typescript-eslint": "^8.55.0",
     "vitest": "^3.0.0"
   },
   "openclaw": {
     "extensions": [
-      "./index.ts"
+      "./dist/index.js"
     ]
   }
 }

package/hooks/aight-bootstrap/handler.ts

@@ -1,34 +0,0 @@
-/**
- * Aight bootstrap hook — injects AIGHT.md into agent bootstrap context
- */
-
-import { getBootstrapContent } from "../../src/bootstrap.js";
-
-interface HookEvent {
-  type: string;
-  action: string;
-  sessionKey: string;
-  timestamp: Date;
-  messages: string[];
-  context: {
-    bootstrapFiles?: Array<{ basename: string; content: string }>;
-    [key: string]: unknown;
-  };
-}
-
-const handler = async (event: HookEvent) => {
-  if (event.type !== "agent" || event.action !== "bootstrap") {
-    return;
-  }
-
-  if (!event.context.bootstrapFiles) {
-    event.context.bootstrapFiles = [];
-  }
-
-  event.context.bootstrapFiles.push({
-    basename: "AIGHT.md",
-    content: getBootstrapContent(),
-  });
-};
-
-export default handler;

package/index.ts

@@ -1,78 +0,0 @@
-/**
- * @aight/utils — OpenClaw gateway plugin
- *
- * Push notifications, Today items, config RPC, and agent bootstrap for the Aight app.
- */
-
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import { registerConfig, getPluginConfig } from "./src/config.js";
-import { registerItems } from "./src/items.js";
-import { registerPush } from "./src/push.js";
-import { registerReminders } from "./src/reminders.js";
-import { registerBootstrap } from "./src/bootstrap.js";
-import { registerPushHook } from "./src/push-hook.js";
-import { registerHealth } from "./src/health.js";
-import { registerVersion } from "./src/version.js";
-import { registerGroupRpc } from "./src/groups.js";
-import { registerNotifPrefsRPC } from "./src/notif-prefs.js";
-
-const aightPlugin = {
-  id: "aight-utils",
-  name: "Aight Utilities",
-  description: "Push notifications, Today items, config RPC, and agent bootstrap for the Aight app",
-
-  configSchema: {
-    parse(value: unknown) {
-      const raw =
-        value && typeof value === "object" && !Array.isArray(value)
-          ? (value as Record<string, unknown>)
-          : {};
-      return {
-        push: {
-          mode: (raw.push as any)?.mode ?? "private",
-          relayUrl: (raw.push as any)?.relayUrl ?? "https://push.aight.app",
-          relaySecret: (raw.push as any)?.relaySecret,
-        },
-        today: {
-          enabled: (raw.today as any)?.enabled ?? true,
-        },
-      };
-    },
-    uiHints: {
-      "push.mode": {
-        label: "Notification Mode",
-        help: "Private = silent wake. Rich = preview text in notification.",
-      },
-      "push.relayUrl": {
-        label: "Push Relay URL",
-        placeholder: "https://push.aight.app",
-      },
-      "push.relaySecret": {
-        label: "Relay Shared Secret",
-        sensitive: true,
-      },
-      "today.enabled": {
-        label: "Today View",
-      },
-    },
-  },
-
-  register(api: OpenClawPluginApi) {
-    const cfg = getPluginConfig(api);
-
-    registerConfig(api);
-    registerItems(api);
-    registerPush(api, cfg);
-    registerReminders(api, cfg);
-    registerBootstrap(api);
-    registerPushHook(api);
-    registerHealth(api);
-    registerVersion(api);
-    registerGroupRpc(api);
-    registerNotifPrefsRPC(api);
-
-    api.logger.info("[aight-utils] Plugin loaded");
-  },
-};
-
-export default aightPlugin;

package/src/config.ts

@@ -1,126 +0,0 @@
-/**
- * Config RPC module — aight.config.get, aight.config.patch, aight.status
- */
-
-import type { OpenClawPluginApi, GatewayRequestHandlerOptions } from "openclaw/plugin-sdk";
-import { DEFAULT_PUSH_MODE } from "./defaults.js";
-
-export interface AightConfig {
-  push?: {
-    mode?: "private" | "rich";
-    relayUrl?: string;
-    relaySecret?: string;
-  };
-  today?: {
-    enabled?: boolean;
-  };
-}
-
-/** Strict allowlist of keys this plugin owns — anything else is rejected */
-const PLUGIN_CONFIG_KEYS = new Set(["push", "today"]);
-
-/** Secret keys that must never be returned to clients via RPC */
-const SECRET_KEYS: string[] = ["relaySecret"];
-
-/** Returns a sanitized copy of the config with secrets redacted */
-export function getClientSafeConfig(config: AightConfig): Record<string, unknown> {
-  const safe = JSON.parse(JSON.stringify(config));
-  if (safe.push) {
-    for (const key of SECRET_KEYS) {
-      if (key in safe.push) {
-        safe.push[key] = safe.push[key] ? "[REDACTED]" : undefined;
-      }
-    }
-  }
-  return safe;
-}
-
-export function getPluginConfig(api: OpenClawPluginApi): AightConfig {
-  const raw = api.pluginConfig;
-  return raw && typeof raw === "object" && !Array.isArray(raw) ? (raw as AightConfig) : {};
-}
-
-export function registerConfig(api: OpenClawPluginApi) {
-  api.registerGatewayMethod("aight.config.get", ({ respond }: GatewayRequestHandlerOptions) => {
-    respond(true, getClientSafeConfig(getPluginConfig(api)));
-  });
-
-  api.registerGatewayMethod(
-    "aight.config.patch",
-    async ({ params, respond }: GatewayRequestHandlerOptions) => {
-      if (!params || typeof params !== "object") {
-        respond(false, { error: "params must be an object" });
-        return;
-      }
-      try {
-        // Reject any keys not in the plugin allowlist — never touch root gateway config
-        const incoming = params as Record<string, unknown>;
-        for (const key of Object.keys(incoming)) {
-          if (!PLUGIN_CONFIG_KEYS.has(key)) {
-            respond(false, { error: `Key "${key}" is not allowed in config.patch` });
-            return;
-          }
-        }
-
-        // Load current config
-        const currentConfig = await api.runtime.config.loadConfig();
-        const pluginEntry = (currentConfig as any)?.plugins?.entries?.["aight-utils"] ?? {};
-        const currentPluginConfig = pluginEntry.config ?? {};
-
-        // Deep merge allowed plugin-level keys into plugin config
-        const merged = { ...currentPluginConfig };
-        for (const [key, value] of Object.entries(incoming)) {
-          if (
-            value &&
-            typeof value === "object" &&
-            !Array.isArray(value) &&
-            merged[key] &&
-            typeof merged[key] === "object"
-          ) {
-            merged[key] = { ...merged[key], ...value };
-          } else {
-            merged[key] = value;
-          }
-        }
-
-        // Build updated config — only the plugin's own config section is modified;
-        // root gateway config is preserved as-is and never overwritten by client input.
-        const updatedConfig: Record<string, unknown> = {
-          ...(currentConfig as Record<string, unknown>),
-          plugins: {
-            ...((currentConfig as any)?.plugins ?? {}),
-            entries: {
-              ...((currentConfig as any)?.plugins?.entries ?? {}),
-              "aight-utils": {
-                ...pluginEntry,
-                config: merged,
-              },
-            },
-          },
-        };
-
-        await api.runtime.config.writeConfigFile(updatedConfig as any);
-        respond(true, { ok: true, config: getClientSafeConfig(merged as AightConfig) });
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        api.logger.error(`[aight-utils] config.patch failed: ${msg}`);
-        respond(false, { error: msg });
-      }
-    },
-  );
-
-  api.registerGatewayMethod("aight.status", ({ respond }: GatewayRequestHandlerOptions) => {
-    const cfg = getPluginConfig(api);
-    respond(true, {
-      ok: true,
-      version: "0.1.0",
-      push: {
-        mode: cfg.push?.mode ?? DEFAULT_PUSH_MODE,
-        relayUrl: cfg.push?.relayUrl ?? "https://push.aight.app",
-      },
-      today: {
-        enabled: cfg.today?.enabled ?? true,
-      },
-    });
-  });
-}

package/src/defaults.ts

@@ -1,5 +0,0 @@
-/** Default push relay URL */
-export const DEFAULT_RELAY_URL = "https://push.aight.cool";
-
-/** Default push notification mode */
-export const DEFAULT_PUSH_MODE: "private" | "rich" = "rich";

package/src/groups.ts

@@ -1,71 +0,0 @@
-/**
- * Group name store — simple mapping of groupId → display name.
- * The app registers group names via RPC so push notifications
- * can show friendly titles instead of raw IDs.
- */
-
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import { readFileSync, writeFileSync, mkdirSync } from "fs";
-import { join } from "path";
-
-const FILENAME = "group-names.json";
-
-function filePath(api: OpenClawPluginApi): string {
-  const dir =
-    (api as any).dataDir ??
-    join(process.env.HOME ?? "/tmp", ".openclaw", "plugin-data", "aight-utils");
-  mkdirSync(dir, { recursive: true });
-  return join(dir, FILENAME);
-}
-
-function loadAll(api: OpenClawPluginApi): Record<string, string> {
-  try {
-    return JSON.parse(readFileSync(filePath(api), "utf-8"));
-  } catch {
-    return {};
-  }
-}
-
-function saveAll(api: OpenClawPluginApi, data: Record<string, string>): void {
-  writeFileSync(filePath(api), JSON.stringify(data), "utf-8");
-}
-
-export function loadGroupName(api: OpenClawPluginApi, groupId: string): string | undefined {
-  return loadAll(api)[groupId];
-}
-
-export function registerGroupName(api: OpenClawPluginApi, groupId: string, name: string): void {
-  const data = loadAll(api);
-  data[groupId] = name;
-  saveAll(api, data);
-}
-
-export function removeGroupName(api: OpenClawPluginApi, groupId: string): void {
-  const data = loadAll(api);
-  delete data[groupId];
-  saveAll(api, data);
-}
-
-export function registerGroupRpc(api: OpenClawPluginApi): void {
-  api.registerGatewayMethod("aight.groups.setName", ({ params, respond }: any) => {
-    const { groupId, name } = (params ?? {}) as { groupId?: string; name?: string };
-    if (!groupId || !name) {
-      respond(false, { error: "groupId and name are required" });
-      return;
-    }
-    registerGroupName(api, groupId, name);
-    respond(true, { ok: true });
-  });
-
-  api.registerGatewayMethod("aight.groups.removeName", ({ params, respond }: any) => {
-    const { groupId } = (params ?? {}) as { groupId?: string };
-    if (!groupId) {
-      respond(false, { error: "groupId is required" });
-      return;
-    }
-    removeGroupName(api, groupId);
-    respond(true, { ok: true });
-  });
-
-  api.logger.info("[aight-utils] Group name RPC registered");
-}

package/src/health.ts

@@ -1,95 +0,0 @@
-/**
- * System health RPC — aight.health
- *
- * Returns memory, CPU, disk stats without needing an LLM call.
- */
-
-import { execSync } from "child_process";
-import { platform } from "os";
-import type { OpenClawPluginApi, GatewayRequestHandlerOptions } from "openclaw/plugin-sdk";
-
-interface HealthStats {
-  memory: { usedGB: number; totalGB: number; percent: number } | null;
-  cpu: { percent: number } | null;
-  disk: { usedGB: number; totalGB: number; percent: number } | null;
-}
-
-function getStats(): HealthStats {
-  const os = platform();
-  let memory: HealthStats["memory"] = null;
-  let cpu: HealthStats["cpu"] = null;
-  let disk: HealthStats["disk"] = null;
-
-  try {
-    if (os === "darwin") {
-      // Memory
-      const totalBytes = parseInt(
-        execSync("/usr/sbin/sysctl -n hw.memsize", { encoding: "utf8", timeout: 5000 }).trim(),
-      );
-      const top = execSync("top -l 1 -n 0", { encoding: "utf8", timeout: 5000 });
-      const memMatch = top.match(/PhysMem:\s*(\d+)([GM])\s*used/);
-      const usedGB = memMatch ? parseInt(memMatch[1]) * (memMatch[2] === "G" ? 1 : 1 / 1024) : 0;
-      const totalGB = totalBytes / 1073741824;
-      memory = {
-        usedGB: Math.round(usedGB * 10) / 10,
-        totalGB: Math.round(totalGB * 10) / 10,
-        percent: Math.round((usedGB / totalGB) * 100),
-      };
-
-      // CPU
-      const idleMatch = top.match(/([\d.]+)% idle/);
-      cpu = {
-        percent: idleMatch ? Math.round(100 - parseFloat(idleMatch[1])) : 0,
-      };
-    } else {
-      // Linux memory
-      const meminfo = execSync("cat /proc/meminfo", { encoding: "utf8", timeout: 5000 });
-      const totalKB = parseInt(meminfo.match(/MemTotal:\s*(\d+)/)?.[1] ?? "0");
-      const availKB = parseInt(meminfo.match(/MemAvailable:\s*(\d+)/)?.[1] ?? "0");
-      const totalGB = (totalKB * 1024) / 1073741824;
-      const usedGB = ((totalKB - availKB) * 1024) / 1073741824;
-      memory = {
-        usedGB: Math.round(usedGB * 10) / 10,
-        totalGB: Math.round(totalGB * 10) / 10,
-        percent: Math.round((usedGB / totalGB) * 100),
-      };
-
-      // Linux CPU
-      const loadavg = execSync("cat /proc/loadavg", { encoding: "utf8", timeout: 5000 });
-      const load1m = parseFloat(loadavg.split(" ")[0]);
-      const cores = parseInt(execSync("nproc", { encoding: "utf8", timeout: 5000 }).trim());
-      cpu = { percent: Math.round(Math.min((load1m / cores) * 100, 100)) };
-    }
-
-    // Disk (cross-platform via df)
-    const df = execSync("df -k /", { encoding: "utf8", timeout: 5000 });
-    const dfLine = df.split("\n")[1];
-    const dfParts = dfLine?.split(/\s+/);
-    if (dfParts && dfParts.length >= 4) {
-      const totalKB = parseInt(dfParts[1]);
-      const usedKB = parseInt(dfParts[2]);
-      disk = {
-        totalGB: Math.round(totalKB / 1048576),
-        usedGB: Math.round(usedKB / 1048576),
-        percent: Math.round((usedKB / totalKB) * 100),
-      };
-    }
-  } catch {
-    // Best effort — return whatever we got
-  }
-
-  return { memory, cpu, disk };
-}
-
-export function registerHealth(api: OpenClawPluginApi) {
-  api.registerGatewayMethod("aight.health", async ({ respond }: GatewayRequestHandlerOptions) => {
-    try {
-      const stats = getStats();
-      respond(true, stats);
-    } catch (err) {
-      respond(false, {
-        error: err instanceof Error ? err.message : String(err),
-      });
-    }
-  });
-}