arisa 2.0.1 → 2.0.2

package/README.md

@@ -23,10 +23,10 @@ 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)
 ```
 
 ```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 +36,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 +88,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.2",
   "description": "Arisa - dynamic agent runtime with daemon/core architecture that evolves through user interaction",
   "preferGlobal": true,
   "bin": {

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;