niahere 0.2.10 → 0.2.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "niahere",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "A personal AI assistant daemon — scheduled jobs, chat across Telegram and Slack, persona system, and visual identity.",
   "type": "module",
   "scripts": {

package/skills/modal-cli/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: modal-cli
+description: >
+  Modal CLI for serverless GPU/cloud compute. Use when user mentions modal, deploying to modal,
+  running GPU workloads, or serverless Python functions.
+  Check `which modal` first — if missing, offer: `pip install modal && modal setup`.
+  Covers run/serve/deploy, apps, containers, secrets, volumes, and workspace management.
+---
+
+## Prerequisites
+
+Before any modal command, verify the CLI is available:
+
+```bash
+which modal
+```
+
+**If not found**, ask the user:
+
+> Modal CLI not found. Install it?
+>
+> ```bash
+> pip install modal
+> ```
+
+After install, run auth setup:
+
+```bash
+modal setup
+```
+
+This opens a browser for token auth. If `modal` still isn't on PATH after pip install, use:
+
+```bash
+python -m modal setup
+```
+
+**If found but not authed**, check with:
+
+```bash
+modal token info
+```
+
+If that errors, run `modal setup` to authenticate.
+
+## Core Commands
+
+| Command | Purpose |
+|---------|---------|
+| `modal run <file>` | One-off execution of a script/function |
+| `modal serve <file>` | Local dev with hot-reload |
+| `modal deploy <file>` | Production deployment |
+| `modal app list` | List deployed apps |
+| `modal app logs <name>` | Stream logs for a deployed app |
+| `modal app stop <name>` | Stop a running app |
+| `modal shell` | Interactive shell in Modal environment |
+
+## Workflows
+
+### First-time setup
+```bash
+pip install modal
+modal setup
+modal run hello.py  # validate end-to-end
+```
+
+### Develop and deploy
+```bash
+modal run my_app.py        # test locally
+modal serve my_app.py      # hot-reload dev
+modal deploy my_app.py     # ship it
+```
+
+### Debug containers
+```bash
+modal container list
+modal container logs <id>
+modal container exec <id> -- bash -lc "nvidia-smi"
+```
+
+### Manage resources
+```bash
+modal secret create my-secret KEY=value
+modal volume create my-vol
+modal environment create dev
+modal config set-environment dev
+```
+
+## Auth & Profiles
+
+- `modal token info` — check current auth
+- `modal token new` — create token via browser
+- `modal token set` — set token credentials directly
+- `modal profile list` / `activate` — switch workspaces
+- `modal config show` — print effective config
+
+Environment variables: `MODAL_TOKEN_ID`, `MODAL_TOKEN_SECRET`, `MODAL_ENVIRONMENT`, `MODAL_PROFILE`
+
+## Resource Management
+
+- **Secrets**: `modal secret list/create/delete` (supports `.env` import)
+- **Volumes**: `modal volume create/list/ls/put/get/rm/delete`
+- **Dicts**: `modal dict create/list/items/get/clear/delete`
+- **Queues**: `modal queue create/list/peek/len/clear/delete`
+- **NFS**: `modal nfs list/create/ls/put/get/rm/delete`
+- **Environments**: `modal environment list/create/delete/update`
+
+## Decision Points
+
+- User says "deploy to modal" / "run on GPU" → `modal deploy` or `modal run`
+- User says "check my modal apps" → `modal app list`
+- User says "modal logs" → `modal app logs <name>`
+- User needs interactive debug → `modal shell` or `modal container exec`
+- modal not installed → offer install, don't silently fail
+- modal not authed → run `modal setup`
+
+## References
+
+- Guide: https://modal.com/docs/guide
+- CLI reference: https://modal.com/docs/reference/cli/
+- Status: https://status.modal.com

package/skills/slack/SKILL.md

@@ -43,7 +43,18 @@ URL format: `https://<workspace>.slack.com/archives/<CHANNEL_ID>/p<THREAD_TS_NO_
 - **Channel ID:** the segment after `/archives/`
 - **Thread TS:** the `p` number with a `.` inserted before the last 6 digits
 
+## Beyond these primitives
+
+These commands cover common operations but the Slack API has 200+ methods. If you need something not listed here (e.g. managing bookmarks, setting channel topics, pinning messages, scheduling messages, managing user groups):
+
+1. **Check `slack.py --help`** for available subcommands first.
+2. **Use the Slack API directly** via `curl` with the bot token from `slack_helper.load_slack_config()["token"]`. The pattern is always: `curl -H "Authorization: Bearer $TOKEN" https://slack.com/api/<method>`.
+3. **Consult the [Slack API docs](https://api.slack.com/methods)** to find the right method and required scopes.
+4. **Compose primitives** to build workflows — "summarize channel" is just `history` + LLM reasoning. "Find discussions about X" is `search` + `thread`.
+
+The bot token and auth pattern are consistent across all Slack APIs. Don't limit yourself to what's explicitly in `slack.py` — treat it as a starting point, not a boundary.
+
 ## Design
 
 Each subcommand = one Slack API call. No bundled workflows.
-Features like "summarize channel" or "find discussions" are agent-level compositions of these primitives.
+Features are outcomes achieved by an agent composing these primitives in a loop.

package/src/cli/channels.ts

@@ -91,6 +91,28 @@ export async function slackCommand(): Promise<void> {
         console.log(`  Workspace: ${config.channels.slack.workspace} (${config.channels.slack.workspace_url})`);
         console.log(`  Bot: @${config.channels.slack.bot_name} (${config.channels.slack.bot_user_id})`);
       }
+      // Verify auth is working
+      try {
+        const resp = await fetch("https://slack.com/api/auth.test", {
+          headers: { Authorization: `Bearer ${config.channels.slack.bot_token}` },
+        });
+        const data = (await resp.json()) as Record<string, unknown>;
+        if (data.ok) {
+          console.log(`  Auth: \u2713 valid`);
+          // Backfill workspace info if missing
+          if (!config.channels.slack.workspace) {
+            const enriched = await enrichSlackConfig(config.channels.slack.bot_token);
+            if (Object.keys(enriched).length > 0) {
+              updateRawConfig({ channels: { slack: enriched } });
+              console.log("  (workspace info backfilled)");
+            }
+          }
+        } else {
+          console.log(`  Auth: \u2717 ${data.error}`);
+        }
+      } catch (err) {
+        console.log(`  Auth: \u2717 could not reach Slack API`);
+      }
     } else {
       console.log("Slack: not configured");
     }

package/src/cli/index.ts

@@ -219,7 +219,7 @@ switch (command) {
   }
 
   case "slack": {
-    slackCommand();
+    await slackCommand();
     break;
   }
 

package/src/cli/status.ts

@@ -7,6 +7,7 @@ import { Message, ActiveEngine, Job } from "../db/models";
 import type { ScheduleType, JobStateStatus, RoomStats } from "../types";
 import { withDb } from "../db/connection";
 import { errMsg } from "../utils/errors";
+import { checkForUpdate } from "../utils/update";
 
 type StatusOptions = {
   json: boolean;
@@ -306,4 +307,13 @@ export async function statusCommand(argv: string[] = []): Promise<void> {
   } else {
     console.log("Tip: use --rooms N, --all, or --json for alternate views.");
   }
+
+  // Check for updates (non-blocking, cached 24h)
+  try {
+    const { version } = await import("../../package.json");
+    const update = await checkForUpdate(version);
+    if (update) {
+      console.log(`\n⚠ Update available: ${update.current} → ${update.latest} (run \`npm i -g niahere\` to update)`);
+    }
+  } catch {}
 }

package/src/core/daemon.ts

@@ -162,6 +162,17 @@ export async function runDaemon(): Promise<void> {
   writePid(process.pid);
   log.info({ pid: process.pid }, "daemon started");
 
+  // Check for updates (non-blocking, logged only)
+  try {
+    const { checkForUpdate } = await import("../utils/update");
+    const { version } = await import("../../package.json");
+    const update = await checkForUpdate(version);
+    if (update) {
+      log.warn({ current: update.current, latest: update.latest }, "update available — run `npm i -g niahere` to update");
+    }
+  } catch {}
+
+
   // Startup recovery
   try {
     await runMigrations();

package/src/utils/update.ts

@@ -0,0 +1,68 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { resolve, dirname } from "path";
+import { getNiaHome } from "./paths";
+
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const PACKAGE_NAME = "niahere";
+
+type UpdateCache = {
+  latest: string;
+  checkedAt: number;
+};
+
+function cachePath(): string {
+  return resolve(getNiaHome(), "tmp/update-check.json");
+}
+
+function readCache(): UpdateCache | null {
+  const path = cachePath();
+  if (!existsSync(path)) return null;
+  try {
+    const data = JSON.parse(readFileSync(path, "utf8"));
+    if (data.latest && data.checkedAt && Date.now() - data.checkedAt < CACHE_TTL_MS) {
+      return data;
+    }
+  } catch {}
+  return null;
+}
+
+function writeCache(latest: string): void {
+  const path = cachePath();
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, JSON.stringify({ latest, checkedAt: Date.now() }));
+}
+
+async function fetchLatestVersion(): Promise<string | null> {
+  try {
+    const resp = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
+      signal: AbortSignal.timeout(3000),
+    });
+    if (!resp.ok) return null;
+    const data = await resp.json() as { version?: string };
+    return data.version ?? null;
+  } catch {
+    return null;
+  }
+}
+
+function isNewer(latest: string, current: string): boolean {
+  const [la, lb, lc] = latest.split(".").map(Number);
+  const [ca, cb, cc] = current.split(".").map(Number);
+  if (la !== ca) return la > ca;
+  if (lb !== cb) return lb > cb;
+  return lc > cc;
+}
+
+/** Check if a newer version is available. Returns update info or null. Non-blocking, cached 24h. */
+export async function checkForUpdate(currentVersion: string): Promise<{ current: string; latest: string } | null> {
+  const cached = readCache();
+  if (cached) {
+    return isNewer(cached.latest, currentVersion) ? { current: currentVersion, latest: cached.latest } : null;
+  }
+
+  const latest = await fetchLatestVersion();
+  if (!latest) return null;
+
+  writeCache(latest);
+  return isNewer(latest, currentVersion) ? { current: currentVersion, latest } : null;
+}