@aight-cool/aight-utils 0.1.11 → 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.11",
+  "version": "0.1.12",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aight-cool/aight-utils",
-  "version": "0.1.11",
+  "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,8 +3,6 @@
  */
 
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
 
 const AIGHT_MD = `# Aight Integration
 
@@ -29,6 +27,13 @@ When the user asks "What can you do?" — here's what to highlight:
 
 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)
 
 - User asks to **set a reminder**: create a trigger with \`scheduledFor\` (ISO 8601)
@@ -151,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())) {