@aight-cool/aight-utils 0.1.17 → 0.1.18

package/src/items.ts

@@ -1,252 +0,0 @@
-/**
- * Items Store — aight.items.list, aight.items.upsert, aight.items.delete + aight_item tool
- */
-
-import { Type, type Static } from "@sinclair/typebox";
-import * as fs from "node:fs";
-import * as path from "node:path";
-import * as os from "node:os";
-import type { OpenClawPluginApi, GatewayRequestHandlerOptions } from "openclaw/plugin-sdk";
-
-// ── Types ──
-
-export const ItemType = Type.Union([
-  Type.Literal("trigger"),
-  Type.Literal("item"),
-  Type.Literal("process"),
-]);
-
-export const ItemStatus = Type.Union([
-  Type.Literal("active"),
-  Type.Literal("done"),
-  Type.Literal("fired"),
-  Type.Literal("cancelled"),
-  Type.Literal("deleted"),
-]);
-
-export const ItemSchema = Type.Object({
-  id: Type.String({ description: "Unique item ID" }),
-  type: ItemType,
-  title: Type.String({ description: "Display title" }),
-  status: Type.Optional(ItemStatus),
-  labels: Type.Optional(Type.Array(Type.String())),
-  scheduledFor: Type.Optional(Type.String({ description: "ISO 8601 datetime for triggers" })),
-  description: Type.Optional(Type.String()),
-  url: Type.Optional(Type.String({ description: "Related URL (PR, issue, etc.)" })),
-  metadata: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
-  createdAt: Type.Optional(Type.String()),
-  updatedAt: Type.Optional(Type.String()),
-});
-
-export type Item = Static<typeof ItemSchema>;
-
-// ── Store ──
-
-const STORE_DIR = path.join(os.homedir(), ".openclaw", "aight");
-const STORE_FILE = path.join(STORE_DIR, "items.json");
-
-export function loadItems(): Item[] {
-  try {
-    if (!fs.existsSync(STORE_FILE)) return [];
-    const raw = fs.readFileSync(STORE_FILE, "utf-8");
-    const parsed = JSON.parse(raw);
-    return Array.isArray(parsed) ? parsed : [];
-  } catch {
-    return [];
-  }
-}
-
-export function saveItems(items: Item[]): void {
-  fs.mkdirSync(STORE_DIR, { recursive: true });
-  fs.writeFileSync(STORE_FILE, JSON.stringify(items, null, 2), { encoding: "utf-8", mode: 0o600 });
-}
-
-const MAX_TITLE_LEN = 500;
-const MAX_DESC_LEN = 5000;
-const MAX_ITEMS = 10000;
-
-export function upsertItem(item: Item): Item {
-  if (item.title && item.title.length > MAX_TITLE_LEN) {
-    throw new Error(`title exceeds max length of ${MAX_TITLE_LEN}`);
-  }
-  if (item.description && item.description.length > MAX_DESC_LEN) {
-    throw new Error(`description exceeds max length of ${MAX_DESC_LEN}`);
-  }
-  const items = loadItems();
-  const now = new Date().toISOString();
-  const idx = items.findIndex((i) => i.id === item.id);
-  if (idx < 0 && items.length >= MAX_ITEMS) {
-    throw new Error(`item store full (max ${MAX_ITEMS})`);
-  }
-  const merged: Item = {
-    ...item,
-    status: item.status ?? "active",
-    updatedAt: now,
-    createdAt: idx >= 0 ? items[idx].createdAt : now,
-  };
-  if (idx >= 0) {
-    items[idx] = merged;
-  } else {
-    items.push(merged);
-  }
-  saveItems(items);
-  return merged;
-}
-
-export function deleteItem(id: string): boolean {
-  const items = loadItems();
-  const idx = items.findIndex((i) => i.id === id);
-  if (idx < 0) return false;
-  items[idx] = { ...items[idx], status: "deleted", updatedAt: new Date().toISOString() };
-  saveItems(items);
-  return true;
-}
-
-export interface ListFilters {
-  type?: string;
-  labels?: string[];
-  status?: string;
-  from?: string;
-  to?: string;
-}
-
-export function listItems(filters: ListFilters = {}): Item[] {
-  let items = loadItems().filter((i) => i.status !== "deleted");
-
-  if (filters.type) {
-    items = items.filter((i) => i.type === filters.type);
-  }
-  if (filters.status) {
-    items = items.filter((i) => i.status === filters.status);
-  }
-  if (filters.labels && filters.labels.length > 0) {
-    items = items.filter((i) => filters.labels!.some((l) => i.labels?.includes(l)));
-  }
-  if (filters.from) {
-    const fromTs = new Date(filters.from).getTime();
-    items = items.filter((i) => {
-      if (!i.scheduledFor) return true;
-      return new Date(i.scheduledFor).getTime() >= fromTs;
-    });
-  }
-  if (filters.to) {
-    const toTs = new Date(filters.to).getTime();
-    items = items.filter((i) => {
-      if (!i.scheduledFor) return true;
-      return new Date(i.scheduledFor).getTime() <= toTs;
-    });
-  }
-
-  return items;
-}
-
-// ── Tool schema ──
-
-export const AightItemToolParams = Type.Object({
-  action: Type.Union([Type.Literal("create"), Type.Literal("update"), Type.Literal("delete")]),
-  item: Type.Optional(ItemSchema),
-  id: Type.Optional(Type.String({ description: "Item ID (for delete)" })),
-});
-
-// ── Registration ──
-
-/** Strip heavy fields for list responses — detail is fetched via aight.items.get */
-function toLightItem(item: Item): Omit<Item, "description" | "metadata" | "url"> {
-  const { description: _d, metadata: _m, url: _u, ...light } = item;
-  return light;
-}
-
-export function registerItems(api: OpenClawPluginApi) {
-  api.registerGatewayMethod(
-    "aight.items.list",
-    ({ params, respond }: GatewayRequestHandlerOptions) => {
-      const filters: ListFilters =
-        params && typeof params === "object" ? (params as ListFilters) : {};
-      respond(true, { items: listItems(filters).map(toLightItem) });
-    },
-  );
-
-  api.registerGatewayMethod(
-    "aight.items.get",
-    ({ params, respond }: GatewayRequestHandlerOptions) => {
-      const id = typeof params?.id === "string" ? params.id : "";
-      if (!id) {
-        respond(false, { error: "id required" });
-        return;
-      }
-      const all = loadItems();
-      const item = all.find((i) => i.id === id);
-      if (!item || item.status === "deleted") {
-        respond(false, { error: "item not found" });
-        return;
-      }
-      respond(true, { item });
-    },
-  );
-
-  api.registerGatewayMethod(
-    "aight.items.upsert",
-    ({ params, respond }: GatewayRequestHandlerOptions) => {
-      if (
-        !params ||
-        typeof params !== "object" ||
-        !("id" in params) ||
-        !("type" in params) ||
-        !("title" in params)
-      ) {
-        respond(false, { error: "item must have id, type, and title" });
-        return;
-      }
-      const item = upsertItem(params as Item);
-      respond(true, { item });
-    },
-  );
-
-  api.registerGatewayMethod(
-    "aight.items.delete",
-    ({ params, respond }: GatewayRequestHandlerOptions) => {
-      const id = typeof params?.id === "string" ? params.id : "";
-      if (!id) {
-        respond(false, { error: "id required" });
-        return;
-      }
-      const ok = deleteItem(id);
-      respond(true, { ok, id });
-    },
-  );
-
-  api.registerTool({
-    name: "aight_item",
-    label: "Aight Item",
-    description:
-      "Create, update, or delete a structured item in the Aight Today view. " +
-      "Use for reminders, tasks, events, deadlines, and process tracking. " +
-      "Parse natural language dates/times before calling (e.g. 'tomorrow at 3pm' → ISO 8601).",
-    parameters: AightItemToolParams,
-    async execute(_toolCallId: string, params: any) {
-      const json = (payload: unknown) => ({
-        content: [{ type: "text" as const, text: JSON.stringify(payload, null, 2) }],
-        details: payload,
-      });
-
-      try {
-        if (params.action === "delete") {
-          const id = params.id ?? params.item?.id;
-          if (!id) throw new Error("id required for delete");
-          const ok = deleteItem(id);
-          return json({ ok, id });
-        }
-
-        if (!params.item) throw new Error("item required for create/update");
-        if (!params.item.id || !params.item.type || !params.item.title) {
-          throw new Error("item must have id, type, and title");
-        }
-
-        const item = upsertItem(params.item);
-        return json({ action: params.action, item });
-      } catch (err) {
-        return json({ error: err instanceof Error ? err.message : String(err) });
-      }
-    },
-  });
-}

package/src/notif-prefs.ts

@@ -1,115 +0,0 @@
-/**
- * Notification Preferences — gateway-side storage for push suppression.
- *
- * The app syncs notification preferences here via RPC. The push hook
- * checks these prefs before sending to the relay — if a category is
- * muted, the push never leaves the user's machine.
- *
- * RPC methods:
- *   aight.notif.setPrefs  — update preferences
- *   aight.notif.getPrefs  — read current preferences
- */
-
-import * as fs from "node:fs";
-import * as path from "node:path";
-import * as os from "node:os";
-import type { OpenClawPluginApi, GatewayRequestHandlerOptions } from "openclaw/plugin-sdk";
-
-// ── Types ──
-
-export interface NotifPrefs {
-  globalMute: boolean;
-  muteUntil: string | null;
-  agentReplies: boolean;
-  groupChat: boolean;
-  cron: boolean;
-}
-
-const DEFAULTS: NotifPrefs = {
-  globalMute: false,
-  muteUntil: null,
-  agentReplies: true,
-  groupChat: true,
-  cron: false,
-};
-
-// ── Storage ──
-
-const PREFS_DIR = path.join(os.homedir(), ".openclaw", "aight");
-const PREFS_FILE = path.join(PREFS_DIR, "notif-prefs.json");
-
-export function loadNotifPrefs(): NotifPrefs {
-  try {
-    if (!fs.existsSync(PREFS_FILE)) return { ...DEFAULTS };
-    const raw = fs.readFileSync(PREFS_FILE, "utf-8");
-    const parsed = JSON.parse(raw);
-    return { ...DEFAULTS, ...parsed };
-  } catch {
-    return { ...DEFAULTS };
-  }
-}
-
-function saveNotifPrefs(prefs: NotifPrefs): void {
-  fs.mkdirSync(PREFS_DIR, { recursive: true, mode: 0o700 });
-  fs.writeFileSync(PREFS_FILE, JSON.stringify(prefs, null, 2), "utf-8");
-}
-
-// ── Classification (matches app-side logic) ──
-
-export function classifySessionKey(sessionKey: string): "agentReplies" | "groupChat" | "cron" {
-  if (sessionKey.includes(":cron:")) return "cron";
-  if (sessionKey.includes(":group-chat:")) return "groupChat";
-  return "agentReplies";
-}
-
-/**
- * Check if a push for this sessionKey should be sent.
- */
-export function shouldSendPush(sessionKey: string): boolean {
-  if (!sessionKey) return true; // fail open
-
-  const prefs = loadNotifPrefs();
-
-  // Global mute
-  if (prefs.globalMute) {
-    if (!prefs.muteUntil) return false; // indefinite
-    const expiry = new Date(prefs.muteUntil).getTime();
-    if (Date.now() < expiry) return false;
-    // Mute expired — clear it
-    prefs.globalMute = false;
-    prefs.muteUntil = null;
-    saveNotifPrefs(prefs);
-  }
-
-  // Category check
-  const category = classifySessionKey(sessionKey);
-  return prefs[category];
-}
-
-// ── RPC Registration ──
-
-export function registerNotifPrefsRPC(api: OpenClawPluginApi) {
-  api.registerGatewayMethod("aight.notif.getPrefs", ({ respond }: GatewayRequestHandlerOptions) => {
-    respond(true, loadNotifPrefs());
-  });
-
-  api.registerGatewayMethod(
-    "aight.notif.setPrefs",
-    ({ params, respond }: GatewayRequestHandlerOptions) => {
-      const update = (params ?? {}) as Partial<NotifPrefs>;
-      const current = loadNotifPrefs();
-
-      if (typeof update.globalMute === "boolean") current.globalMute = update.globalMute;
-      if (typeof update.agentReplies === "boolean") current.agentReplies = update.agentReplies;
-      if (typeof update.groupChat === "boolean") current.groupChat = update.groupChat;
-      if (typeof update.cron === "boolean") current.cron = update.cron;
-      if (update.muteUntil !== undefined) current.muteUntil = update.muteUntil;
-
-      saveNotifPrefs(current);
-      api.logger.info(`[aight-utils] Notification prefs updated: ${JSON.stringify(current)}`);
-      respond(true, current);
-    },
-  );
-
-  api.logger.info("[aight-utils] Notification prefs RPC registered");
-}

package/src/push-hook.ts

@@ -1,162 +0,0 @@
-/**
- * Push notification hook — sends push on agent_end.
- */
-
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import { getPluginConfig } from "./config.js";
-import { sendPush, loadTokens, unregisterToken } from "./push.js";
-import { loadGroupName } from "./groups.js";
-import { shouldSendPush } from "./notif-prefs.js";
-
-export function registerPushHook(api: OpenClawPluginApi) {
-  try {
-    api.on("agent_end", async (event, ctx) => {
-      api.logger.info(
-        `[aight-utils] agent_end fired session=${ctx.sessionKey} agent=${ctx.agentId}`,
-      );
-      const tokens = loadTokens();
-      if (tokens.length === 0) return;
-
-      // Skip hidden/internal sessions — no push notifications for config,
-      // security, voice, sub-agent, or other background sessions.
-      const sk = ctx.sessionKey ?? "";
-      if (
-        sk.endsWith(":aight-config") ||
-        sk.endsWith(":aight-pentest") ||
-        sk.endsWith(":speak") ||
-        sk.endsWith(":structured_content") ||
-        sk.endsWith(":main") ||
-        sk.includes("subagent") ||
-        sk.includes("security-audit") ||
-        sk.includes("_skill-audit-") ||
-        sk.includes("_ensure-skill-defender") ||
-        sk.endsWith("security-fix") ||
-        sk.endsWith("skill-scan")
-      ) {
-        api.logger.info(`[aight-utils] Skipping hidden session push: ${sk}`);
-        return;
-      }
-
-      const msgs = event.messages ?? [];
-      api.logger.info(
-        `[aight-utils] messages count=${msgs.length} roles=${msgs.map((m: any) => m.role).join(",")}`,
-      );
-
-      // Extract last assistant message - try string and array content formats
-      let preview = "";
-      for (let i = msgs.length - 1; i >= 0; i--) {
-        const m = msgs[i] as any;
-        if (m.role === "assistant") {
-          if (typeof m.content === "string" && m.content.trim()) {
-            preview = m.content.slice(0, 200);
-            break;
-          }
-          if (Array.isArray(m.content)) {
-            const textBlock = m.content.find(
-              (b: any) => b.type === "text" && typeof b.text === "string",
-            );
-            if (textBlock) {
-              preview = textBlock.text.slice(0, 200);
-              break;
-            }
-          }
-        }
-      }
-
-      if (!preview) {
-        api.logger.info(`[aight-utils] No preview found, skipping push`);
-        return;
-      }
-
-      // Skip hidden/internal sessions (aight-config, structured_content, etc.)
-      const sessionKey_ = ctx.sessionKey ?? "";
-      const HIDDEN_SESSIONS = ["aight-config", "structured_content"];
-      if (HIDDEN_SESSIONS.some((h) => sessionKey_.includes(h))) {
-        api.logger.info(`[aight-utils] Skipping hidden session: ${sessionKey_}`);
-        return;
-      }
-
-      // Skip internal/meta responses
-      const skip = ["NO_REPLY", "REPLY_SKIP", "ANNOUNCE_SKIP", "HEARTBEAT_OK"];
-      if (skip.includes(preview.trim())) {
-        api.logger.info(`[aight-utils] Skipping meta response: ${preview.trim()}`);
-        return;
-      }
-
-      const freshConfig = getPluginConfig(api);
-
-      // Resolve display name from gateway config agent list
-      const agentId = ctx.agentId ?? "agent";
-      const agents = (api.config as any)?.agents?.list ?? [];
-      const agent = agents.find((a: any) => a.id === agentId);
-      const displayName = agent?.name ?? agent?.identity?.name ?? agentId;
-
-      // Resolve group chat name for push subtitle (WhatsApp-style layout)
-      const pushTitle = displayName;
-      let pushSubtitle: string | undefined;
-      const sessionKey = ctx.sessionKey ?? "";
-      if (sessionKey.includes(":group-chat:")) {
-        const groupId = sessionKey.split(":group-chat:")[1];
-        if (groupId) {
-          const groupName = loadGroupName(api, groupId);
-          if (groupName) {
-            pushSubtitle = groupName;
-          }
-        }
-      }
-
-      const cleanBody = preview.trim().replace(/\n+/g, " ").trim();
-
-      // ── Notification preference gate ──
-      // Check if this category is muted — if so, don't send the push at all.
-      const sk_ = ctx.sessionKey ?? "";
-      if (!shouldSendPush(sk_)) {
-        api.logger.info(`[aight-utils] Push suppressed by notification prefs: ${sk_}`);
-        return;
-      }
-
-      for (const device of tokens) {
-        if (!device.sendKey) continue;
-        try {
-          const pushResult = await sendPush(
-            device.deviceId,
-            {
-              title: pushTitle.trim(),
-              subtitle: pushSubtitle,
-              body: cleanBody,
-              data: { sessionKey: ctx.sessionKey, agentId },
-            },
-            freshConfig,
-          );
-          api.logger.info(
-            `[aight-utils] Push sent: session=${ctx.sessionKey} device=${device.deviceId} ok=${pushResult.ok}${pushResult.error ? ` error=${pushResult.error}` : ""}`,
-          );
-
-          // Auto-prune stale tokens — if the relay rejects the token, remove it
-          if (!pushResult.ok && pushResult.error) {
-            const err = pushResult.error.toLowerCase();
-            if (
-              err.includes("baddevicetoken") ||
-              err.includes("unregistered") ||
-              err.includes("devicetokennotfortopic") ||
-              err.includes("expired")
-            ) {
-              api.logger.info(`[aight-utils] Pruning stale device token: ${device.deviceId}`);
-              unregisterToken(device.deviceId);
-            }
-          }
-        } catch (err) {
-          api.logger.warn(
-            `[aight-utils] Push failed: ${err instanceof Error ? err.message : String(err)}`,
-          );
-        }
-      }
-    });
-
-    api.logger.info("[aight-utils] Push hook registered (agent_end)");
-  } catch (err) {
-    api.logger.error(
-      `[aight-utils] Failed to register push hook: ${err instanceof Error ? err.message : String(err)}`,
-    );
-  }
-}