@aight-cool/aight-utils 0.1.20 → 0.1.22

package/dist/src/bootstrap.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Agent Bootstrap — injects AIGHT.md via before_prompt_build hook
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+export declare function registerBootstrap(api: OpenClawPluginApi): void;
+export declare function getBootstrapContent(): string;

package/dist/src/bootstrap.js

@@ -0,0 +1,265 @@
+/**
+ * Agent Bootstrap — injects AIGHT.md via before_prompt_build hook
+ */
+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)
+
+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)
+
+- User asks to **set a reminder**: create a trigger with \`scheduledFor\` (ISO 8601)
+- User asks to **create a task**: create an item with labels
+- User mentions a **deadline or event**: create a trigger with appropriate type
+- User wants to **track a PR/issue**: create an item with a URL
+- User says **"done"** or **"cancel"**: update status to "done" or "cancelled"
+
+## Item Types (Aight App)
+
+| Type | Use For | Examples |
+|------|---------|---------|
+| \`trigger\` | Time-based, fire-once | Reminders, events, deadlines |
+| \`item\` | Stateful, lifecycle | Tasks, PRs, issues, projects |
+| \`process\` | Background work | Subagent runs, builds, deploys |
+
+## Rules (Aight App)
+
+- Always generate a unique \`id\` (use a short slug like \`remind-groceries-1708012800\`)
+- Parse natural language dates to ISO 8601 before calling the tool
+- Set \`labels\` for categorization (e.g. \`["work", "urgent"]\`)
+- Default status is \`"active"\` — don't set it unless changing state
+- For reminders: set \`type: "trigger"\` and include \`scheduledFor\`
+- For tasks: set \`type: "item"\`
+
+## Public Figure Agent Creation (Aight App)
+
+When you receive a message starting with "[PUBLIC_FIGURE_AGENT]", **immediately spawn a
+sub-agent** to handle the creation. This ensures a fresh session with no stale context.
+
+**Do NOT try to create the agent yourself inline.** Always delegate via \`sessions_spawn\`.
+
+\`\`\`
+sessions_spawn({
+  task: <the full instructions below, with the person's name filled in>,
+  model: "sonnet",
+  label: "create-agent-<kebab-name>"
+})
+\`\`\`
+
+The sub-agent task message should contain ALL of the following instructions:
+
+---
+
+Create a new OpenClaw agent based on the public figure: "<Person's Name>"
+
+### Step 1: Research
+1. Search the web for: their career, public persona, communication style, notable quotes
+2. Search X/Twitter if relevant for their voice/tone
+3. Identify: communication style, core expertise, personality traits, catchphrases, how they respond to questions
+
+### Step 2: Create the Agent
+Use these tools in order:
+
+1. **Read the OpenClaw config** to check the agent doesn't already exist:
+   \`\`\`
+   exec: grep "<agent-id>" ~/.openclaw/openclaw.json
+   \`\`\`
+
+2. **Create workspace and agent directories:**
+   \`\`\`
+   exec: mkdir -p ~/.openclaw/workspace-<agent-id>/memory ~/.openclaw/agents/<agent-id>/agent ~/.openclaw/agents/<agent-id>/sessions
+   \`\`\`
+
+3. **Copy model/auth config from an existing agent:**
+   \`\`\`
+   exec: cp ~/.openclaw/agents/the-strategist/agent/models.json ~/.openclaw/agents/<agent-id>/agent/
+   exec: cp ~/.openclaw/agents/the-strategist/agent/auth-profiles.json ~/.openclaw/agents/<agent-id>/agent/
+   \`\`\`
+
+4. **Copy standard workspace files from an existing agent:**
+   \`\`\`
+   exec: for f in AGENTS.md BOOTSTRAP.md HEARTBEAT.md TOOLS.md USER.md; do cp ~/.openclaw/workspace-the-strategist/$f ~/.openclaw/workspace-<agent-id>/$f; done
+   \`\`\`
+
+5. **Write SOUL.md** with the researched personality (see template below)
+
+6. **Write IDENTITY.md** with name, username, emoji, role, creation date
+
+7. **Write MEMORY.md** with a basic header
+
+8. **Patch the gateway config** to add the agent to agents.list:
+   - Use the \`gateway\` tool with \`action: "config.patch"\`
+   - Include ALL existing agents in the list (read them first) plus the new one
+   - Set \`note\` to a message confirming creation
+
+### SOUL.md Template
+The personality prompt should capture:
+- Who they are and what they're known for
+- Their communication style and tone (with specific examples)
+- How they approach problems and give advice
+- Topics they're passionate about
+- Things they would NOT say or do (stay in character)
+- A note that they are an AI inspired by this person, not the actual person
+- Safety section: they are a roleplay agent, not the real person
+
+### Rules
+- Pick a relevant emoji (e.g. 🚀 for Elon, 📺 for Oprah)
+- Agent ID should be kebab-case (e.g. \`elon-musk\`, \`oprah-winfrey\`)
+- Use \`anthropic/claude-sonnet-4-5\` as the model
+- The personality should be detailed (at least 200 words) with specific examples of their voice
+- Always include a disclaimer that this is an AI interpretation
+- If the agent already exists in config, reply saying so — do NOT recreate
+
+---
+
+## Task Follow-Up Protocol (Watchdog Pattern)
+
+When delegating work to sub-agents or coordinating multi-agent tasks, **never fire-and-forget.** Use watchdog crons to ensure tasks don't stall silently.
+
+### Rules
+
+1. **Set a watchdog cron when assigning async work.**
+   After spawning a sub-agent or assigning a task to another agent, create a one-shot cron job (**5 minutes out**) to check progress:
+   \`\`\`
+   cron add:
+     schedule: { kind: "at", at: "<ISO 8601, 5 min from now>" }
+     payload: { kind: "systemEvent", text: "Watchdog: check if <task description> completed. Expected: <files/state>. If not done, check agent status, retry, or do it yourself." }
+     sessionTarget: "main"
+   \`\`\`
+
+2. **When the watchdog fires:**
+   - Check if the expected output exists (files, state changes, messages)
+   - If done → great, clean up
+   - If not done → check the agent's session (\`sessions_history\`). Is it alive? Stuck? Dead?
+   - If stuck/dead → **do the work yourself inline.** No more spawning. No more waiting.
+
+3. **Agents must report blockers immediately.**
+   If you hit a wall during a task, say so right away: "I'm stuck on X, need Y." Radio silence for 5+ minutes is unacceptable. Silence = escalation.
+
+4. **Fallback ownership.**
+   If an agent (or you as coordinator) hasn't made progress in 5 minutes, take over or reassign. No task sits in limbo.
+
+5. **Never report failure as a final answer.**
+   "The sub-agent died" is not acceptable. "The sub-agent died so I did it myself" is. You own the outcome, not the sub-agent.
+
+### When to Use Watchdogs
+- Sub-agent spawns (\`sessions_spawn\`)
+- Multi-step group chat tasks (e.g., "build and test this PR")
+- Any async work where you're waiting on another agent
+- Background processes (builds, deploys, long-running scripts)
+
+### When NOT Needed
+- Simple inline tasks you do yourself
+- Quick questions to another agent in a group chat
+- One-shot tool calls that return immediately
+
+## 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.
+
+## 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.
+Example: "Claiming this — looking at the inline code rendering in CodeRenderer.m now."
+
+### 2. Report Completion
+When done, post in the group:
+- **Commit hash** (or what you changed)
+- **What changed** (1-2 sentences)
+- **What's needed next** (e.g. "needs native rebuild", "ready for QA", "blocked on X")
+
+Don't wait to be asked. Don't go silent after finishing.
+
+### 3. Report Blockers Fast (<2 min)
+If you're stuck, say so immediately. Don't spend 10 minutes silently struggling.
+Example: "Blocker: CocoaPods fails with Ruby 4.0 encoding error. Need to downgrade Ruby or find workaround."
+
+### 4. No Limbo
+If you've been working on something for 5+ minutes with no progress, escalate or hand it off. Tasks do not sit in limbo.
+
+### 5. Silence = Escalation
+If an agent goes silent for 5+ minutes during an active task, any other agent (or the coordinator) should take over. Don't wait for permission.
+
+**This protocol exists because agents repeatedly picked up tasks, worked silently, and never reported back — forcing Bruno to chase every time. That stops now.**
+
+## Shortcuts (Aight App)
+
+See the Shortcuts Protocol at the top of this document.
+
+`;
+export function registerBootstrap(api) {
+    try {
+        // Register both event names so we work on old (before_agent_start only) and
+        // new (before_prompt_build) openclaw. Identical return shape lets the new
+        // SDK's `??` merge dedupe the injection.
+        const handler = () => ({ systemPrompt: AIGHT_MD });
+        api.on("before_prompt_build", handler);
+        api.on("before_agent_start", handler);
+    }
+    catch (err) {
+        api.logger.error(`[aight-utils] Failed to register bootstrap hook: ${err}`);
+    }
+}
+export function getBootstrapContent() {
+    return AIGHT_MD;
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/src/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoPhB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,GAAsB;IACtD,IAAI,CAAC;QACH,4EAA4E;QAC5E,0EAA0E;QAC1E,yCAAyC;QACzC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnD,GAAG,CAAC,EAAE,CAAC,qBAA4B,EAAE,OAAO,CAAC,CAAC;QAC9C,GAAG,CAAC,EAAE,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,oDAAoD,GAAG,EAAE,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/config.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Config RPC module — aight.config.get, aight.config.patch, aight.status
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+export interface AightConfig {
+    push?: {
+        mode?: "private" | "rich";
+        relayUrl?: string;
+        relaySecret?: string;
+    };
+    today?: {
+        enabled?: boolean;
+    };
+}
+/** Returns a sanitized copy of the config with secrets redacted */
+export declare function getClientSafeConfig(config: AightConfig): Record<string, unknown>;
+export declare function getPluginConfig(api: OpenClawPluginApi): AightConfig;
+export declare function registerConfig(api: OpenClawPluginApi): void;

package/dist/src/config.js

@@ -0,0 +1,100 @@
+/**
+ * Config RPC module — aight.config.get, aight.config.patch, aight.status
+ */
+import { DEFAULT_PUSH_MODE } from "./defaults.js";
+/** 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 */
+const SECRET_KEYS = ["relaySecret"];
+/** Returns a sanitized copy of the config with secrets redacted */
+export function getClientSafeConfig(config) {
+    const safe = JSON.parse(JSON.stringify(config));
+    if (safe.push) {
+        for (const key of SECRET_KEYS) {
+            if (key in safe.push) {
+                safe.push[key] = safe.push[key] ? "[REDACTED]" : undefined;
+            }
+        }
+    }
+    return safe;
+}
+export function getPluginConfig(api) {
+    const raw = api.pluginConfig;
+    return raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
+}
+export function registerConfig(api) {
+    api.registerGatewayMethod("aight.config.get", ({ respond }) => {
+        respond(true, getClientSafeConfig(getPluginConfig(api)));
+    });
+    api.registerGatewayMethod("aight.config.patch", async ({ params, respond }) => {
+        if (!params || typeof params !== "object") {
+            respond(false, { error: "params must be an object" });
+            return;
+        }
+        try {
+            // Reject any keys not in the plugin allowlist — never touch root gateway config
+            const incoming = params;
+            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?.plugins?.entries?.["aight-utils"] ?? {};
+            const currentPluginConfig = pluginEntry.config ?? {};
+            // Deep merge allowed plugin-level keys into plugin config
+            const merged = { ...currentPluginConfig };
+            for (const [key, value] of Object.entries(incoming)) {
+                if (value &&
+                    typeof value === "object" &&
+                    !Array.isArray(value) &&
+                    merged[key] &&
+                    typeof merged[key] === "object") {
+                    merged[key] = { ...merged[key], ...value };
+                }
+                else {
+                    merged[key] = value;
+                }
+            }
+            // 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 = {
+                ...currentConfig,
+                plugins: {
+                    ...(currentConfig?.plugins ?? {}),
+                    entries: {
+                        ...(currentConfig?.plugins?.entries ?? {}),
+                        "aight-utils": {
+                            ...pluginEntry,
+                            config: merged,
+                        },
+                    },
+                },
+            };
+            await api.runtime.config.writeConfigFile(updatedConfig);
+            respond(true, { ok: true, config: getClientSafeConfig(merged) });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            api.logger.error(`[aight-utils] config.patch failed: ${msg}`);
+            respond(false, { error: msg });
+        }
+    });
+    api.registerGatewayMethod("aight.status", ({ respond }) => {
+        const cfg = getPluginConfig(api);
+        respond(true, {
+            ok: true,
+            version: "0.1.0",
+            push: {
+                mode: cfg.push?.mode ?? DEFAULT_PUSH_MODE,
+                relayUrl: cfg.push?.relayUrl ?? "https://push.aight.app",
+            },
+            today: {
+                enabled: cfg.today?.enabled ?? true,
+            },
+        });
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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"}

package/dist/src/defaults.d.ts

@@ -0,0 +1,4 @@
+/** Default push relay URL */
+export declare const DEFAULT_RELAY_URL = "https://push.aight.cool";
+/** Default push notification mode */
+export declare const DEFAULT_PUSH_MODE: "private" | "rich";

package/dist/src/defaults.js

@@ -0,0 +1,5 @@
+/** Default push relay URL */
+export const DEFAULT_RELAY_URL = "https://push.aight.cool";
+/** Default push notification mode */
+export const DEFAULT_PUSH_MODE = "rich";
+//# sourceMappingURL=defaults.js.map

package/dist/src/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/defaults.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,MAAM,CAAC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAE3D,qCAAqC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAuB,MAAM,CAAC"}

package/dist/src/groups.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Group name store — simple mapping of groupId → display name.
+ * The app registers group names via RPC so push notifications
+ * can show friendly titles instead of raw IDs.
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+export declare function loadGroupName(api: OpenClawPluginApi, groupId: string): string | undefined;
+export declare function registerGroupName(api: OpenClawPluginApi, groupId: string, name: string): void;
+export declare function removeGroupName(api: OpenClawPluginApi, groupId: string): void;
+export declare function registerGroupRpc(api: OpenClawPluginApi): void;

package/dist/src/groups.js

@@ -0,0 +1,59 @@
+/**
+ * Group name store — simple mapping of groupId → display name.
+ * The app registers group names via RPC so push notifications
+ * can show friendly titles instead of raw IDs.
+ */
+import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+const FILENAME = "group-names.json";
+function filePath(api) {
+    const dir = api.dataDir ?? join(homedir(), ".openclaw", "plugin-data", "aight-utils");
+    mkdirSync(dir, { recursive: true });
+    return join(dir, FILENAME);
+}
+function loadAll(api) {
+    try {
+        return JSON.parse(readFileSync(filePath(api), "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+function saveAll(api, data) {
+    writeFileSync(filePath(api), JSON.stringify(data), "utf-8");
+}
+export function loadGroupName(api, groupId) {
+    return loadAll(api)[groupId];
+}
+export function registerGroupName(api, groupId, name) {
+    const data = loadAll(api);
+    data[groupId] = name;
+    saveAll(api, data);
+}
+export function removeGroupName(api, groupId) {
+    const data = loadAll(api);
+    delete data[groupId];
+    saveAll(api, data);
+}
+export function registerGroupRpc(api) {
+    api.registerGatewayMethod("aight.groups.setName", ({ params, respond }) => {
+        const { groupId, name } = (params ?? {});
+        if (!groupId || !name) {
+            respond(false, { error: "groupId and name are required" });
+            return;
+        }
+        registerGroupName(api, groupId, name);
+        respond(true, { ok: true });
+    });
+    api.registerGatewayMethod("aight.groups.removeName", ({ params, respond }) => {
+        const { groupId } = (params ?? {});
+        if (!groupId) {
+            respond(false, { error: "groupId is required" });
+            return;
+        }
+        removeGroupName(api, groupId);
+        respond(true, { ok: true });
+    });
+}
+//# sourceMappingURL=groups.js.map

package/dist/src/groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.js","sourceRoot":"","sources":["../../src/groups.ts"],"names":[],"mappings":"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"}

package/dist/src/health.d.ts

@@ -0,0 +1,8 @@
+/**
+ * System health RPC — aight.health
+ *
+ * Returns memory, CPU, disk stats without needing an LLM call.
+ * Uses Node built-ins only (no child_process).
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+export declare function registerHealth(api: OpenClawPluginApi): void;

package/dist/src/health.js

@@ -0,0 +1,58 @@
+/**
+ * System health RPC — aight.health
+ *
+ * Returns memory, CPU, disk stats without needing an LLM call.
+ * Uses Node built-ins only (no child_process).
+ */
+import * as os from "node:os";
+import * as fs from "node:fs";
+function getStats() {
+    let memory = null;
+    let cpu = null;
+    let disk = null;
+    try {
+        // Memory — os.totalmem / os.freemem (cross-platform)
+        const totalBytes = os.totalmem();
+        const freeBytes = os.freemem();
+        const usedBytes = totalBytes - freeBytes;
+        const totalGB = totalBytes / 1073741824;
+        const usedGB = usedBytes / 1073741824;
+        memory = {
+            usedGB: Math.round(usedGB * 10) / 10,
+            totalGB: Math.round(totalGB * 10) / 10,
+            percent: Math.round((usedGB / totalGB) * 100),
+        };
+        // CPU — load average relative to core count (cross-platform)
+        const load1m = os.loadavg()[0];
+        const cores = os.cpus().length;
+        cpu = { percent: Math.round(Math.min((load1m / cores) * 100, 100)) };
+        // Disk — fs.statfsSync (Node 18.15+)
+        const stat = fs.statfsSync("/");
+        const totalDiskBytes = stat.blocks * stat.bsize;
+        const freeDiskBytes = stat.bfree * stat.bsize;
+        const usedDiskBytes = totalDiskBytes - freeDiskBytes;
+        disk = {
+            totalGB: Math.round(totalDiskBytes / 1073741824),
+            usedGB: Math.round(usedDiskBytes / 1073741824),
+            percent: Math.round((usedDiskBytes / totalDiskBytes) * 100),
+        };
+    }
+    catch {
+        // Best effort — return whatever we got
+    }
+    return { memory, cpu, disk };
+}
+export function registerHealth(api) {
+    api.registerGatewayMethod("aight.health", async ({ respond }) => {
+        try {
+            const stats = getStats();
+            respond(true, stats);
+        }
+        catch (err) {
+            respond(false, {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+}
+//# sourceMappingURL=health.js.map

package/dist/src/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/health.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAS9B,SAAS,QAAQ;IACf,IAAI,MAAM,GAA0B,IAAI,CAAC;IACzC,IAAI,GAAG,GAAuB,IAAI,CAAC;IACnC,IAAI,IAAI,GAAwB,IAAI,CAAC;IAErC,IAAI,CAAC;QACH,qDAAqD;QACrD,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;QACxC,MAAM,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;QACtC,MAAM,GAAG;YACP,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE;YACpC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,EAAE;YACtC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC;SAC9C,CAAC;QAEF,6DAA6D;QAC7D,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC;QAC/B,GAAG,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QAErE,qCAAqC;QACrC,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QAChD,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC9C,MAAM,aAAa,GAAG,cAAc,GAAG,aAAa,CAAC;QACrD,IAAI,GAAG;YACL,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,UAAU,CAAC;YAChD,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,UAAU,CAAC;YAC9C,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,aAAa,GAAG,cAAc,CAAC,GAAG,GAAG,CAAC;SAC5D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAsB;IACnD,GAAG,CAAC,qBAAqB,CAAC,cAAc,EAAE,KAAK,EAAE,EAAE,OAAO,EAAgC,EAAE,EAAE;QAC5F,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,EAAE;gBACb,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/items.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Items Store — aight.items.list, aight.items.upsert, aight.items.delete + aight_item tool
+ */
+import { type Static } from "@sinclair/typebox";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+export declare const ItemType: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"trigger">, import("@sinclair/typebox").TLiteral<"item">, import("@sinclair/typebox").TLiteral<"process">]>;
+export declare const ItemStatus: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"fired">, import("@sinclair/typebox").TLiteral<"cancelled">, import("@sinclair/typebox").TLiteral<"deleted">]>;
+export declare const ItemSchema: import("@sinclair/typebox").TObject<{
+    id: import("@sinclair/typebox").TString;
+    type: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"trigger">, import("@sinclair/typebox").TLiteral<"item">, import("@sinclair/typebox").TLiteral<"process">]>;
+    title: import("@sinclair/typebox").TString;
+    status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"fired">, import("@sinclair/typebox").TLiteral<"cancelled">, import("@sinclair/typebox").TLiteral<"deleted">]>>;
+    labels: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    scheduledFor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    url: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    createdAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    updatedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type Item = Static<typeof ItemSchema>;
+export declare function loadItems(): Item[];
+export declare function saveItems(items: Item[]): void;
+export declare function upsertItem(item: Item): Item;
+export declare function deleteItem(id: string): boolean;
+export interface ListFilters {
+    type?: string;
+    labels?: string[];
+    status?: string;
+    from?: string;
+    to?: string;
+}
+export declare function listItems(filters?: ListFilters): Item[];
+export declare const AightItemToolParams: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"create">, import("@sinclair/typebox").TLiteral<"update">, import("@sinclair/typebox").TLiteral<"delete">]>;
+    item: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        id: import("@sinclair/typebox").TString;
+        type: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"trigger">, import("@sinclair/typebox").TLiteral<"item">, import("@sinclair/typebox").TLiteral<"process">]>;
+        title: import("@sinclair/typebox").TString;
+        status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"fired">, import("@sinclair/typebox").TLiteral<"cancelled">, import("@sinclair/typebox").TLiteral<"deleted">]>>;
+        labels: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        scheduledFor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        url: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+        createdAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        updatedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>;
+    id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare function registerItems(api: OpenClawPluginApi): void;