@aight-cool/aight-utils 0.1.13 → 0.1.15

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.13",
+  "version": "0.1.15",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -13,10 +13,7 @@
         "properties": {
           "mode": {
             "type": "string",
-            "enum": [
-              "private",
-              "rich"
-            ],
+            "enum": ["private", "rich"],
             "default": "rich"
           },
           "relayUrl": {
@@ -34,19 +31,13 @@
                 },
                 "platform": {
                   "type": "string",
-                  "enum": [
-                    "ios",
-                    "android"
-                  ]
+                  "enum": ["ios", "android"]
                 },
                 "registeredAt": {
                   "type": "string"
                 }
               },
-              "required": [
-                "token",
-                "platform"
-              ]
+              "required": ["token", "platform"]
             }
           },
           "relaySecret": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aight-cool/aight-utils",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "OpenClaw gateway plugin for Aight App: push notifications, Today items, config RPC, and agent bootstrap",
   "type": "module",
   "files": [

package/src/bootstrap.ts

@@ -6,6 +6,16 @@ import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 
 const AIGHT_MD = `# Aight Integration
 
+## ⚠️ Shortcuts Protocol (CRITICAL — follow exactly)
+
+When you receive a message starting with "shortcut:", you MUST reply with ONLY a JSON object — no explanation, no markdown fences, no other text:
+{"short_name": "Example Name", "emoji": "🎯"}
+Rules:
+- short_name: 2-4 words, Title Case, describing what the shortcut does
+- emoji: a single relevant emoji
+- Do NOT answer the question in the shortcut text. Just label it.
+- Reply with NOTHING else — just the raw JSON object
+
 Aight is the iOS app the user is chatting through. It connects to the OpenClaw gateway running on their machine, giving them a native mobile interface for their AI agent.
 
 ## What You Can Do (via Aight)
@@ -181,9 +191,34 @@ When delegating work to sub-agents or coordinating multi-agent tasks, **never fi
 - Quick questions to another agent in a group chat
 - One-shot tool calls that return immediately
 
-## BUGS Group Chat — Task Protocol
+## Group Chat Message Format
+
+When you receive a message prefixed with \`[Group Chat: "Name" — Members: ...]\`, you are in a group chat. The format is:
+
+\`\`\`
+[Group Chat: "Name" — Members: emoji Name (@username), ...]
+[Recent messages]
+emoji SenderName: message text
+emoji SenderName: [your message at HH:MM]
+emoji SenderName: message text
+...
+
+[Your turn]
+The user's actual message
+\`\`\`
+
+**Your own messages are stubbed.** To save tokens, the app replaces the body of your own messages in the recent messages block with \`[your message at HH:MM]\`. You already have the full text in your session history, so no information is lost. Other agents' and the user's messages are shown in full.
+
+Rules:
+- To address another agent, **@mention them** in your reply text. The app routes automatically.
+- Do **NOT** use \`sessions_send\` — just @mention in your message.
+- Recent messages provide conversational context — the gateway session has full history.
+- \`[Your turn]\` marks the boundary between context and the new message you should respond to.
+- If you need to recall what you said at a specific time, check your own session history — it has the full text.
 
-When a task is posted in the BUGS group chat, follow these rules **without exception:**
+## Group Chat — Task Protocol
+
+When a task is posted in any group chat, follow these rules **without exception:**
 
 ### 1. Claim Immediately
 When you start working on something, say so in the group chat. No silent pickups.
@@ -211,15 +246,7 @@ If an agent goes silent for 5+ minutes during an active task, any other agent (o
 
 ## Shortcuts (Aight App)
 
-When you receive a message starting with "shortcut:", extract a short name and emoji for it.
-Reply with ONLY a JSON object — no markdown, no explanation:
-\`\`\`
-{"short_name": "Example Name", "emoji": "🎯"}
-\`\`\`
-Rules:
-- short_name: 2-4 words, Title Case, describing what the shortcut does
-- emoji: a single relevant emoji
-- Reply with NOTHING else — just the JSON object
+See the Shortcuts Protocol at the top of this document.
 
 `;
 

package/src/config.ts

@@ -16,7 +16,7 @@ export interface AightConfig {
   };
 }
 
-/** Keys that belong in the plugin config section (everything else routes to root gateway config) */
+/** 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 */
@@ -53,25 +53,23 @@ export function registerConfig(api: OpenClawPluginApi) {
         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 ?? {};
 
-        // Separate plugin-level keys from gateway root-level keys
-        const pluginPatch: Record<string, unknown> = {};
-        const rootPatch: Record<string, unknown> = {};
-        for (const [key, value] of Object.entries(params as Record<string, unknown>)) {
-          if (PLUGIN_CONFIG_KEYS.has(key)) {
-            pluginPatch[key] = value;
-          } else {
-            rootPatch[key] = value;
-          }
-        }
-
-        // Deep merge plugin-level keys into plugin config
+        // Deep merge allowed plugin-level keys into plugin config
         const merged = { ...currentPluginConfig };
-        for (const [key, value] of Object.entries(pluginPatch)) {
+        for (const [key, value] of Object.entries(incoming)) {
           if (
             value &&
             typeof value === "object" &&
@@ -85,8 +83,9 @@ export function registerConfig(api: OpenClawPluginApi) {
           }
         }
 
-        // Build updated config: plugin config + root-level overrides
-        let updatedConfig: Record<string, unknown> = {
+        // 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 ?? {}),
@@ -100,21 +99,6 @@ export function registerConfig(api: OpenClawPluginApi) {
           },
         };
 
-        // Deep merge root-level keys into the gateway config
-        for (const [key, value] of Object.entries(rootPatch)) {
-          if (
-            value &&
-            typeof value === "object" &&
-            !Array.isArray(value) &&
-            updatedConfig[key] &&
-            typeof updatedConfig[key] === "object"
-          ) {
-            updatedConfig[key] = { ...(updatedConfig[key] as Record<string, unknown>), ...value };
-          } else {
-            updatedConfig[key] = value;
-          }
-        }
-
         await api.runtime.config.writeConfigFile(updatedConfig as any);
         respond(true, { ok: true, config: getClientSafeConfig(merged as AightConfig) });
       } catch (err) {

package/src/items.ts

@@ -150,13 +150,37 @@ export const AightItemToolParams = Type.Object({
 
 // ── 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) });
+      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 });
     },
   );