@aight-cool/aight-utils 0.1.0 → 0.1.4

package/openclaw.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "aight-utils",
-  "name": "Aight Utilities",
-  "description": "Push notifications, Today items, config RPC, and agent bootstrap for the Aight app",
-  "version": "0.1.0",
+  "name": "Aight App Utils",
+  "description": "Aight App: Push notifications, Today items, config RPC, and agent bootstrap",
+  "version": "0.1.2",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aight-cool/aight-utils",
-  "version": "0.1.0",
-  "description": "OpenClaw gateway plugin — push notifications, Today items, config RPC, and agent bootstrap for the Aight app",
+  "version": "0.1.4",
+  "description": "OpenClaw gateway plugin for Aight App: push notifications, Today items, config RPC, and agent bootstrap",
   "type": "module",
   "files": [
     "index.ts",

package/src/bootstrap.ts

@@ -35,6 +35,87 @@ You have the \`aight_item\` tool for managing structured items in the Aight Toda
 - 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
+
+---
+
 ## Shortcuts (Aight App)
 
 When you receive a message starting with "shortcut:", extract a short name and emoji for it.

package/src/version.ts

@@ -10,7 +10,6 @@ import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 
 let cachedVersion: string | null = null;
-let cachedLatest: { version: string; checkedAt: number } | null = null;
 const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
 
 function getCurrentVersion(): string {
@@ -25,22 +24,47 @@ function getCurrentVersion(): string {
   return cachedVersion!;
 }
 
-async function getLatestVersion(): Promise<string> {
-  if (cachedLatest && Date.now() - cachedLatest.checkedAt < CACHE_TTL_MS) {
-    return cachedLatest.version;
+let cachedGatewayVersion: string | null = null;
+
+function getGatewayVersion(): string {
+  if (cachedGatewayVersion) return cachedGatewayVersion;
+  try {
+    const { execSync } = require("node:child_process");
+    const out = execSync("openclaw --version", { timeout: 5000 }).toString().trim();
+    cachedGatewayVersion = out || "unknown";
+  } catch {
+    // Try to find openclaw's package.json via require.resolve
+    try {
+      const resolved = require.resolve("openclaw");
+      const pkgPath = join(dirname(resolved), "package.json");
+      const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+      cachedGatewayVersion = pkg.version ?? "unknown";
+    } catch {
+      cachedGatewayVersion = "unknown";
+    }
+  }
+  return cachedGatewayVersion!;
+}
+
+const npmCache = new Map<string, { version: string; checkedAt: number }>();
+
+async function getLatestNpmVersion(pkg: string): Promise<string> {
+  const cached = npmCache.get(pkg);
+  if (cached && Date.now() - cached.checkedAt < CACHE_TTL_MS) {
+    return cached.version;
   }
   try {
-    const res = await fetch("https://registry.npmjs.org/@aight-cool/aight-utils/latest", {
+    const res = await fetch(`https://registry.npmjs.org/${encodeURIComponent(pkg)}/latest`, {
       headers: { accept: "application/json" },
       signal: AbortSignal.timeout(5000),
     });
     if (!res.ok) return "unknown";
     const data = (await res.json()) as { version?: string };
     const version = data.version ?? "unknown";
-    cachedLatest = { version, checkedAt: Date.now() };
+    npmCache.set(pkg, { version, checkedAt: Date.now() });
     return version;
   } catch {
-    return cachedLatest?.version ?? "unknown";
+    return cached?.version ?? "unknown";
   }
 }
 
@@ -48,11 +72,17 @@ export function registerVersion(api: OpenClawPluginApi) {
   api.registerGatewayMethod("aight.version", async ({ respond }: GatewayRequestHandlerOptions) => {
     try {
       const current = getCurrentVersion();
-      const latest = await getLatestVersion();
+      const latest = await getLatestNpmVersion("@aight-cool/aight-utils");
+      const gateway = getGatewayVersion();
+      const gatewayLatest = await getLatestNpmVersion("openclaw");
       respond(true, {
         current,
         latest,
         updateAvailable: latest !== "unknown" && current !== latest,
+        gatewayVersion: gateway,
+        gatewayLatest,
+        gatewayUpdateAvailable:
+          gatewayLatest !== "unknown" && gateway !== "unknown" && gateway !== gatewayLatest,
       });
     } catch (err) {
       respond(false, {