@aight-cool/aight-utils 0.1.15 → 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/push-hook.ts

@@ -1,136 +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 } from "./push.js";
-import { loadGroupName } from "./groups.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();
-
-      for (const device of tokens) {
-        if (!device.sendKey) continue;
-        try {
-          await sendPush(
-            device.deviceId,
-            {
-              title: pushTitle.trim(),
-              subtitle: pushSubtitle,
-              body: cleanBody,
-              data: { sessionKey: ctx.sessionKey, agentId },
-            },
-            freshConfig,
-          );
-        } 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)}`,
-    );
-  }
-}

package/src/push.ts

@@ -1,242 +0,0 @@
-/**
- * Push Notifications — aight.push.register, aight.push.unregister, sendPush()
- *
- * Auth model: the relay has a master secret. During device registration, the
- * plugin calls relay /register with the device push token. The relay returns
- * a sendKey = HMAC(masterSecret, pushToken). The plugin stores the sendKey
- * alongside the device token. When sending a push, the plugin includes the
- * sendKey. The relay recomputes the HMAC and verifies — zero state, no shared secrets.
- */
-
-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";
-import type { AightConfig } from "./config.js";
-import { DEFAULT_RELAY_URL, DEFAULT_PUSH_MODE } from "./defaults.js";
-
-// ── Device Token Store ──
-
-export interface DeviceToken {
-  deviceId: string;
-  pushToken: string;
-  platform: "ios" | "android";
-  sandbox?: boolean;
-  sendKey?: string;
-  registeredAt: string;
-}
-
-const TOKEN_DIR = path.join(os.homedir(), ".openclaw", "aight");
-const TOKEN_FILE = path.join(TOKEN_DIR, "devices.json");
-
-export function loadTokens(): DeviceToken[] {
-  try {
-    if (!fs.existsSync(TOKEN_FILE)) return [];
-    const raw = fs.readFileSync(TOKEN_FILE, "utf-8");
-    const parsed = JSON.parse(raw);
-    return Array.isArray(parsed) ? parsed : [];
-  } catch {
-    return [];
-  }
-}
-
-export function saveTokens(tokens: DeviceToken[]): void {
-  fs.mkdirSync(TOKEN_DIR, { recursive: true, mode: 0o700 });
-  fs.writeFileSync(TOKEN_FILE, JSON.stringify(tokens, null, 2), { encoding: "utf-8", mode: 0o600 });
-}
-
-export function registerToken(token: DeviceToken): void {
-  const tokens = loadTokens();
-  const idx = tokens.findIndex((t) => t.deviceId === token.deviceId);
-  if (idx >= 0) {
-    tokens[idx] = token;
-  } else {
-    tokens.push(token);
-  }
-  saveTokens(tokens);
-}
-
-export function unregisterToken(deviceId: string): boolean {
-  const tokens = loadTokens();
-  const filtered = tokens.filter((t) => t.deviceId !== deviceId);
-  if (filtered.length === tokens.length) return false;
-  saveTokens(filtered);
-  return true;
-}
-
-// ── Relay Registration (get sendKey) ──
-
-async function obtainSendKey(relayUrl: string, pushToken: string): Promise<string> {
-  const res = await fetch(`${relayUrl}/register`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ token: pushToken }),
-  });
-
-  if (!res.ok) {
-    const text = await res.text();
-    throw new Error(`Relay /register returned ${res.status}: ${text}`);
-  }
-
-  const data = (await res.json()) as { ok: boolean; sendKey: string };
-  if (!data.sendKey) throw new Error("Relay did not return a sendKey");
-  return data.sendKey;
-}
-
-// ── Push Sending ──
-
-export interface PushPayload {
-  title?: string;
-  subtitle?: string;
-  body?: string;
-  data?: Record<string, unknown>;
-  silent?: boolean;
-}
-
-export async function sendPush(
-  deviceId: string,
-  payload: PushPayload,
-  config: AightConfig,
-): Promise<{ ok: boolean; error?: string }> {
-  const tokens = loadTokens();
-  const device = tokens.find((t) => t.deviceId === deviceId);
-  if (!device) {
-    return { ok: false, error: `No device token for ${deviceId}` };
-  }
-  if (!device.sendKey) {
-    return { ok: false, error: `No sendKey for device ${deviceId} — re-register to obtain one` };
-  }
-
-  const relayUrl = config.push?.relayUrl ?? DEFAULT_RELAY_URL;
-  const mode = config.push?.mode ?? DEFAULT_PUSH_MODE;
-
-  const pushBody: Record<string, unknown> = {
-    token: device.pushToken,
-    sendKey: device.sendKey,
-    platform: device.platform,
-    sandbox: device.sandbox ?? false,
-  };
-
-  if (mode === "rich" && !payload.silent) {
-    pushBody.title = payload.title;
-    if (payload.subtitle) pushBody.subtitle = payload.subtitle;
-    pushBody.body = payload.body;
-  }
-
-  if (payload.data) {
-    pushBody.data = payload.data;
-  }
-
-  try {
-    const res = await fetch(`${relayUrl}/send`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(pushBody),
-    });
-
-    if (!res.ok) {
-      const text = await res.text();
-      return { ok: false, error: `Relay returned ${res.status}: ${text}` };
-    }
-
-    return { ok: true };
-  } catch (err) {
-    return { ok: false, error: err instanceof Error ? err.message : String(err) };
-  }
-}
-
-// ── Registration ──
-
-export function registerPush(api: OpenClawPluginApi, _config: AightConfig) {
-  api.registerGatewayMethod(
-    "aight.push.register",
-    ({ params, respond }: GatewayRequestHandlerOptions) => {
-      if (
-        !params ||
-        typeof params !== "object" ||
-        typeof params.deviceId !== "string" ||
-        typeof params.pushToken !== "string" ||
-        (params.platform !== "ios" && params.platform !== "android")
-      ) {
-        respond(false, { error: "deviceId, pushToken, and platform (ios|android) required" });
-        return;
-      }
-
-      const deviceId = params.deviceId as string;
-      const pushToken = params.pushToken as string;
-      const platform = params.platform as "ios" | "android";
-      const sandbox = !!params.sandbox;
-
-      // Register immediately (respond fast)
-      registerToken({
-        deviceId,
-        pushToken,
-        platform,
-        sandbox,
-        registeredAt: new Date().toISOString(),
-      });
-
-      respond(true, { ok: true, deviceId });
-      api.logger.info(`[aight-utils] Push token registered for device ${deviceId}`);
-
-      // Obtain sendKey from relay in background
-      const relayUrl = _config.push?.relayUrl ?? DEFAULT_RELAY_URL;
-      obtainSendKey(relayUrl, pushToken)
-        .then((sendKey) => {
-          // Update the token with the sendKey
-          registerToken({
-            deviceId,
-            pushToken,
-            platform,
-            sandbox,
-            sendKey,
-            registeredAt: new Date().toISOString(),
-          });
-          api.logger.info(`[aight-utils] sendKey obtained for device ${deviceId}`);
-        })
-        .catch((err) => {
-          const msg = err instanceof Error ? err.message : String(err);
-          api.logger.warn(`[aight-utils] Failed to obtain sendKey: ${msg}`);
-        });
-    },
-  );
-
-  api.registerGatewayMethod(
-    "aight.push.unregister",
-    ({ params, respond }: GatewayRequestHandlerOptions) => {
-      const deviceId = typeof params?.deviceId === "string" ? params.deviceId : "";
-      if (!deviceId) {
-        respond(false, { error: "deviceId required" });
-        return;
-      }
-
-      const ok = unregisterToken(deviceId);
-      respond(true, { ok, deviceId });
-    },
-  );
-
-  api.registerGatewayMethod(
-    "aight.push.test",
-    async ({ params, respond }: GatewayRequestHandlerOptions) => {
-      const deviceId = typeof params?.deviceId === "string" ? params.deviceId : "";
-      const tokens = loadTokens();
-      const device = deviceId ? tokens.find((t) => t.deviceId === deviceId) : tokens[0];
-      if (!device) {
-        respond(false, { error: "No registered device" });
-        return;
-      }
-
-      // Test always sends a visible push regardless of privacy mode
-      const result = await sendPush(
-        device.deviceId,
-        {
-          title: "Aight 🤙",
-          body: "Push notifications are working!",
-        },
-        { ..._config, push: { ..._config.push, mode: "rich" } },
-      );
-
-      respond(true, result);
-    },
-  );
-}