arisa 2.0.1 → 2.0.3

package/README.md

@@ -13,20 +13,14 @@ Arisa can execute actions with operational control over the system where it runs
 ## Commands
 
 Requires [Bun](https://bun.sh).
-For Bun global installs, use your user environment (do not use `sudo`).
-If needed, configure Bun's user-local install directory:
+For Bun global installs, use your user environment.
 
 ```bash
-export BUN_INSTALL="$HOME/.bun"
-export PATH="$BUN_INSTALL/bin:$PATH"
-```
-
-```bash
-bun install -g arisa     # Global install from package registry (recommended)
-npm install -g arisa     # Alternative global install via npm (may require sudo)
+bun add -g arisa     # Global install from package registry (recommended)
 ```
 
 ```bash
+arisa                    # Foreground daemon mode (Ctrl+C to stop)
 arisa start              # Start as service (enables autostart with systemd --user)
 arisa stop               # Stop service
 arisa status             # Service status
@@ -36,13 +30,6 @@ arisa core               # Foreground core-only mode
 arisa dev                # Foreground core watch mode
 ```
 
-```bash
-bun install              # Install dependencies
-bun run daemon           # Start everything (Daemon spawns Core with --watch)
-bun run dev              # Start Core only with hot-reload (for development)
-npm install -g .         # Global install via Node/npm
-bun add -g .             # Global install via Bun
-```
 
 On Linux with `systemd --user`, `arisa start` enables auto-start on reboot. To keep it running even without an active login session:
 
@@ -95,12 +82,12 @@ src/
 │   ├── media.ts            # Voice transcription (Whisper), image analysis (Vision), speech synthesis (ElevenLabs)
 │   ├── scheduler.ts        # Cron + one-time tasks with croner, persists via deepbase
 │   ├── format.ts           # Telegram chunking (4096 char limit)
-│   ├── file-detector.ts    # Detect file paths in responses for auto-sending
+│   ├── file-detector.ts     # Detect file paths in responses for auto-sending
 │   └── context.ts          # Manage -c flag and reset_flag
 │
 └── shared/
     ├── types.ts            # All shared interfaces
-    ├── config.ts           # Env vars, ports, paths
+    ├── config.ts            # Env vars, ports, paths
     ├── logger.ts           # Logger → .arisa/logs/
     └── db.ts               # Unified persistence layer (deepbase)
 ```

package/bin/arisa.js

@@ -27,15 +27,17 @@ const systemdUserDir = join(homeDir, ".config", "systemd", "user");
 const systemdUserUnitPath = join(systemdUserDir, systemdServiceName);
 
 const args = process.argv.slice(2);
-const command = (args[0] || "start").toLowerCase();
-const rest = args.slice(1);
+const inputCommand = (args[0] || "").toLowerCase();
+const command = inputCommand || "daemon";
+const rest = inputCommand ? args.slice(1) : args;
+const isDefaultInvocation = inputCommand === "";
 
 function printHelp() {
   process.stdout.write(
     `Arisa CLI
 
 Usage:
-  arisa                 Start service (default)
+  arisa                 Start daemon in foreground (default)
   arisa start           Start service and enable restart-on-boot
   arisa stop            Stop service
   arisa status          Show service status
@@ -396,6 +398,11 @@ function restartService() {
   return restartDetachedFallback();
 }
 
+function printForegroundNotice() {
+  process.stdout.write("Starting Arisa in foreground. Press Ctrl+C to stop.\n");
+  process.stdout.write("Use `arisa start` to run it as a background service.\n");
+}
+
 if (command === "help" || command === "--help" || command === "-h") {
   printHelp();
   process.exit(0);
@@ -421,6 +428,9 @@ switch (command) {
     break;
   case "daemon":
   case "run": {
+    if (isDefaultInvocation) {
+      printForegroundNotice();
+    }
     const child = runWithBun([daemonEntry, ...rest]);
     process.exit(child.status === null ? 1 : child.status);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arisa",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Arisa - dynamic agent runtime with daemon/core architecture that evolves through user interaction",
   "preferGlobal": true,
   "bin": {

package/src/core/index.ts

@@ -164,8 +164,8 @@ ${messageText}`;
           const deps = checkDeps();
           if (!deps.codex) {
             const hint = deps.os === "macOS"
-              ? "<code>npm install -g @openai/codex</code>"
-              : "<code>npm install -g @openai/codex</code>";
+              ? "<code>bun add -g @openai/codex</code>"
+              : "<code>bun add -g @openai/codex</code>";
             return Response.json({ text: `Codex CLI is not installed.\n${hint}` } as CoreResponse);
           }
           backendState.set(msg.chatId, "codex");
@@ -179,8 +179,8 @@ ${messageText}`;
           const deps = checkDeps();
           if (!deps.claude) {
             const hint = deps.os === "macOS"
-              ? "<code>brew install claude-code</code> o <code>npm install -g @anthropic-ai/claude-code</code>"
-              : "<code>npm install -g @anthropic-ai/claude-code</code>";
+              ? "<code>brew install claude-code</code> or <code>bun add -g @anthropic-ai/claude-code</code>"
+              : "<code>bun add -g @anthropic-ai/claude-code</code>";
             return Response.json({ text: `Claude CLI is not installed.\n${hint}` } as CoreResponse);
           }
           backendState.set(msg.chatId, "claude");

package/src/core/onboarding.ts

@@ -86,9 +86,9 @@ export async function getOnboarding(chatId: string): Promise<{ message: string;
     if (deps.os === "macOS") {
       lines.push("Claude: <code>brew install claude-code</code>");
     } else {
-      lines.push("Claude: <code>npm install -g @anthropic-ai/claude-code</code>");
+      lines.push("Claude: <code>bun add -g @anthropic-ai/claude-code</code>");
     }
-    lines.push("Codex: <code>npm install -g @openai/codex</code>\n");
+    lines.push("Codex: <code>bun add -g @openai/codex</code>\n");
     lines.push("Install one and message me again.");
     return { message: lines.join("\n"), blocking: true };
   }
@@ -100,9 +100,9 @@ export async function getOnboarding(chatId: string): Promise<{ message: string;
   const lines = [`<b>Arisa</b> — using <b>${using}</b>`];
 
   if (!deps.claude) {
-    lines.push("Claude CLI not installed. Add it with <code>npm install -g @anthropic-ai/claude-code</code>");
+    lines.push("Claude CLI not installed. Add it with <code>bun add -g @anthropic-ai/claude-code</code>");
   } else if (!deps.codex) {
-    lines.push("Codex CLI not installed. Add it with <code>npm install -g @openai/codex</code>");
+    lines.push("Codex CLI not installed. Add it with <code>bun add -g @openai/codex</code>");
   } else {
     lines.push("Use /codex or /claude to switch backend.");
   }

package/src/core/processor.ts

@@ -24,10 +24,11 @@ const ACTIVITY_LOG = join(config.logsDir, "activity.log");
 const PROMPT_PREVIEW_MAX = 220;
 export const CLAUDE_RATE_LIMIT_MESSAGE = "Claude is out of credits right now. Please try again in a few minutes.";
 export const CODEX_AUTH_REQUIRED_MESSAGE = [
-  "Codex is not authenticated on this server.",
-  "Check the server terminal and run:",
+  "Codex login is required.",
+  "Check the Arisa daemon logs now and complete the device-auth steps shown there.",
+  "If the login flow is not running, execute:",
   "<code>codex login --device-auth</code>",
-  "Then try again.",
+  "Then send your message again.",
 ].join("\n");
 
 function logActivity(backend: string, model: string | null, durationMs: number, status: string) {

package/src/daemon/codex-login.ts

@@ -23,13 +23,22 @@ const RETRY_COOLDOWN_MS = 30_000;
 
 let loginInProgress = false;
 let lastLoginAttemptAt = 0;
+const pendingChatIds = new Set<string>();
+
+type NotifyFn = (chatId: string, text: string) => Promise<void>;
+let notifyFn: NotifyFn | null = null;
+
+export function setCodexLoginNotify(fn: NotifyFn) {
+  notifyFn = fn;
+}
 
 function needsCodexLogin(text: string): boolean {
   return AUTH_HINT_PATTERNS.some((pattern) => pattern.test(text));
 }
 
-export function maybeStartCodexDeviceAuth(rawCoreText: string): void {
+export function maybeStartCodexDeviceAuth(rawCoreText: string, chatId?: string): void {
   if (!rawCoreText || !needsCodexLogin(rawCoreText)) return;
+  if (chatId) pendingChatIds.add(chatId);
 
   if (loginInProgress) {
     log.info("Codex device auth already in progress; skipping duplicate trigger");
@@ -50,7 +59,8 @@ export function maybeStartCodexDeviceAuth(rawCoreText: string): void {
 }
 
 async function runCodexDeviceAuth(): Promise<void> {
-  log.warn("Codex auth error detected. Running: codex login --device-auth");
+  log.warn("Codex auth required. Starting `codex login --device-auth` now.");
+  log.warn("Complete device auth using the URL/code printed below in this Arisa terminal.");
 
   let proc: ReturnType<typeof Bun.spawn>;
   try {
@@ -68,8 +78,32 @@ async function runCodexDeviceAuth(): Promise<void> {
 
   const exitCode = await proc.exited;
   if (exitCode === 0) {
-    log.info("Codex device auth finished successfully");
+    log.info("Codex device auth finished successfully. You can retry your message.");
+    await notifySuccess();
   } else {
     log.error(`Codex device auth finished with exit code ${exitCode}`);
+    pendingChatIds.clear();
   }
 }
+
+async function notifySuccess(): Promise<void> {
+  if (!notifyFn || pendingChatIds.size === 0) return;
+
+  const text = [
+    "<b>Codex login completed successfully.</b>",
+    "Then try again.",
+  ].join("\n");
+
+  const chats = Array.from(pendingChatIds);
+  pendingChatIds.clear();
+
+  await Promise.all(
+    chats.map(async (chatId) => {
+      try {
+        await notifyFn?.(chatId, text);
+      } catch (error) {
+        log.error(`Failed to send Codex login success notice to ${chatId}: ${error}`);
+      }
+    }),
+  );
+}

package/src/daemon/index.ts

@@ -28,7 +28,7 @@ const { TelegramChannel } = await import("./channels/telegram");
 const { sendToCore } = await import("./bridge");
 const { startCore, stopCore, setLifecycleNotify } = await import("./lifecycle");
 const { setAutoFixNotify } = await import("./autofix");
-const { maybeStartCodexDeviceAuth } = await import("./codex-login");
+const { maybeStartCodexDeviceAuth, setCodexLoginNotify } = await import("./codex-login");
 const { chunkMessage, markdownToTelegramHtml } = await import("../core/format");
 const { saveMessageRecord } = await import("../shared/db");
 
@@ -61,6 +61,9 @@ const sendToAllChats = async (text: string) => {
 
 setLifecycleNotify(sendToAllChats);
 setAutoFixNotify(sendToAllChats);
+setCodexLoginNotify(async (chatId, text) => {
+  await telegram.send(chatId, text);
+});
 
 telegram.onMessage(async (msg) => {
   knownChatIds.add(msg.chatId);
@@ -78,7 +81,7 @@ telegram.onMessage(async (msg) => {
     clearInterval(typingInterval);
 
     const raw = response.text || "";
-    maybeStartCodexDeviceAuth(raw);
+    maybeStartCodexDeviceAuth(raw, msg.chatId);
     const messageParts = raw.split(/\n---CHUNK---\n/g);
     let sentText = false;
 

package/src/daemon/setup.ts

@@ -12,8 +12,10 @@
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
 import { dirname, join } from "path";
 import { dataDir } from "../shared/paths";
+import { secrets } from "../shared/secrets";
 
 const ENV_PATH = join(dataDir, ".env");
+const SETUP_DONE_KEY = "ARISA_SETUP_COMPLETE";
 
 function loadExistingEnv(): Record<string, string> {
   if (!existsSync(ENV_PATH)) return {};
@@ -44,10 +46,13 @@ async function prompt(question: string): Promise<string> {
 
 export async function runSetup(): Promise<boolean> {
   const vars = loadExistingEnv();
+  const telegramSecret = await secrets.telegram();
+  const openaiSecret = await secrets.openai();
   let changed = false;
+  const setupDone = vars[SETUP_DONE_KEY] === "1" || process.env[SETUP_DONE_KEY] === "1";
 
   // Required: TELEGRAM_BOT_TOKEN
-  if (!vars.TELEGRAM_BOT_TOKEN && !process.env.TELEGRAM_BOT_TOKEN) {
+  if (!vars.TELEGRAM_BOT_TOKEN && !process.env.TELEGRAM_BOT_TOKEN && !telegramSecret) {
     console.log("\n🔧 Arisa Setup\n");
     console.log("Telegram Bot Token required. Get one from @BotFather on Telegram.");
     const token = await prompt("TELEGRAM_BOT_TOKEN: ");
@@ -60,7 +65,7 @@ export async function runSetup(): Promise<boolean> {
   }
 
   // Optional: OPENAI_API_KEY
-  if (!vars.OPENAI_API_KEY && !process.env.OPENAI_API_KEY) {
+  if (!vars.OPENAI_API_KEY && !process.env.OPENAI_API_KEY && !openaiSecret && !setupDone) {
     if (!changed) console.log("\n🔧 Arisa Setup\n");
     console.log("\nOpenAI API Key (optional — enables voice transcription + image analysis).");
     const key = await prompt("OPENAI_API_KEY (enter to skip): ");
@@ -70,6 +75,11 @@ export async function runSetup(): Promise<boolean> {
     }
   }
 
+  if (!setupDone) {
+    vars[SETUP_DONE_KEY] = "1";
+    changed = true;
+  }
+
   if (changed) {
     saveEnv(vars);
     console.log(`\nConfig saved to ${ENV_PATH}\n`);