@aight-cool/aight-utils 0.1.10 → 0.1.12

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.10",
+  "version": "0.1.12",
   "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.10",
+  "version": "0.1.12",
   "description": "OpenClaw gateway plugin for Aight App: push notifications, Today items, config RPC, and agent bootstrap",
   "type": "module",
   "files": [

package/src/bootstrap.ts

@@ -3,12 +3,36 @@
  */
 
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
 
 const AIGHT_MD = `# Aight Integration
 
-You have the \`aight_item\` tool for managing structured items in the Aight Today view.
+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)
+
+When the user asks "What can you do?" — here's what to highlight:
+
+- **Chat naturally** — Ask anything, get help with tasks, brainstorm ideas
+- **Set reminders & track tasks** — "Remind me to call the dentist tomorrow at 2pm" → creates a reminder in the Today view
+- **Voice mode** — Tap the mic to talk instead of type; you respond with voice too
+- **Manage calendar & email** — Check schedule, draft emails, summarize inbox
+- **Search the web** — Real-time web search, fetch pages, summarize articles
+- **Run shortcuts** — Quick-access saved prompts for things you do often
+- **Browse the Skills marketplace** — 700+ skills to extend capabilities (weather, GitHub, music, finance, etc.)
+- **Create custom agents** — Spin up specialized AI personas for different tasks
+- **Today view** — A personal dashboard with reminders, tasks, deadlines, and background processes
+- **Sub-agents** — Delegate complex tasks to background workers that report back when done
+- **Group chats** — Multi-agent conversations where your agents collaborate
+- **Security built-in** — All data stays on your machine; nothing phones home
+
+Keep the response conversational and concise — don't dump the whole list. Pick 4-5 highlights that feel most relevant, and mention there's more to explore in Skills and Settings.
+
+## Audio / Voice (Aight App)
+
+The Aight app handles all speech-to-text and text-to-speech on the client side.
+- **Inbound:** The app converts the user's voice to text before sending it to the gateway. You always receive text.
+- **Outbound:** Always respond with plain text only. If the user has voice mode enabled, the app will convert your text response to speech automatically.
+- **Never use the TTS tool or send audio files** when the channel is an Aight app client. The app cannot stream audio from the gateway and it will cause playback issues.
 
 ## When to Use \`aight_item\` (Aight App)
 
@@ -132,15 +156,16 @@ Rules:
 
 export function registerBootstrap(api: OpenClawPluginApi) {
   try {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const sdk = require("openclaw/plugin-sdk");
-    if (sdk?.registerPluginHooksFromDir) {
-      const pluginDir = path.dirname(fileURLToPath(import.meta.url));
-      const hooksDir = path.join(pluginDir, "..", "hooks");
-      sdk.registerPluginHooksFromDir(api, hooksDir);
-    }
-  } catch {
-    api.logger.info("[aight-utils] Could not register hooks dir, using inline approach");
+    api.logger.info("[aight-utils] Attempting to register bootstrap hook...");
+    api.logger.info(`[aight-utils] api.on type: ${typeof api.on}`);
+    api.on("before_agent_start", (_event: unknown, ctx: { sessionKey?: string }) => {
+      // Inject AIGHT.md context into every agent session
+      api.logger.info(`[aight-utils] Bootstrap: injecting AIGHT.md into session ${ctx?.sessionKey}`);
+      return { systemPrompt: AIGHT_MD };
+    });
+    api.logger.info("[aight-utils] Bootstrap hook registered (before_agent_start)");
+  } catch (err) {
+    api.logger.error(`[aight-utils] Failed to register bootstrap hook: ${err}`);
   }
 }
 

package/src/push-hook.ts

@@ -16,6 +16,26 @@ export function registerPushHook(api: OpenClawPluginApi) {
       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(",")}`,
@@ -47,6 +67,14 @@ export function registerPushHook(api: OpenClawPluginApi) {
         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())) {