@ariso-ai/ari-hooks 0.1.1 → 0.1.4

package/README.md

@@ -2,7 +2,9 @@
 
 Shares your Claude Code activity with [Ari](https://ariso.ai): after every
 Claude Code turn, the hooks send your request and the final outcome (not the
-intermediate steps) to Ari.
+intermediate steps) to Ari. When a session starts, Ari suggests the top
+things Claude can take care of for you right now — pick one and Claude runs
+it.
 
 ## Install
 
@@ -22,7 +24,9 @@ That single command:
 
 1. Opens your browser to log in to Ari and mint an API token (stored in
    `~/.ari-hooks/config.json`, `0600`). Only needed once per machine.
-2. Adds two hooks to `./.claude/settings.json`:
+2. Adds three hooks to `./.claude/settings.json`:
+   - `SessionStart` — fetches Ari's top suggested tasks and shows them when
+     Claude Code boots; reply with a task number or name to run one
    - `UserPromptSubmit` — records what you asked for
    - `Stop` — reads the final assistant message from the transcript and sends
      the request/outcome pair to the Ari API

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ariso-ai/ari-hooks",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "description": "Set up Claude Code hooks that share your requests and their outcomes with Ari",
   "type": "module",
   "bin": {

package/src/hooks.js

@@ -3,6 +3,7 @@ import {
   mkdirSync,
   readFileSync,
   writeFileSync,
+  writeSync,
   rmSync,
   appendFileSync,
 } from 'node:fs';
@@ -128,6 +129,89 @@ async function onStop(input) {
   rmSync(sessionPath(input.session_id), { force: true });
 }
 
+const MAX_TASKS = 3;
+const MAX_TASK_NAME_LENGTH = 200;
+
+const oneLine = (text) =>
+  text.replace(/\s+/g, ' ').trim().slice(0, MAX_TASK_NAME_LENGTH);
+
+/**
+ * SessionStart: ask Ari for the top tasks Claude can take care of right now
+ * and surface them at boot — a visible list for the user (systemMessage)
+ * plus the full prompts for Claude (additionalContext) so it can run
+ * whichever one the user picks.
+ */
+async function onSessionStart(input) {
+  // Compaction restarts the session mid-conversation; the tasks were
+  // already offered, so don't show (or inject) them again.
+  if (input.source === 'compact') return;
+
+  const config = loadConfig();
+  if (!config.token) return;
+
+  const response = await fetch(new URL('/agent-tasks', getApiUrl(config)), {
+    headers: { Authorization: `Bearer ${config.token}` },
+    signal: AbortSignal.timeout(SEND_TIMEOUT_MS),
+  });
+  if (!response.ok) {
+    throw new Error(`GET /agent-tasks failed: ${response.status}`);
+  }
+
+  const body = await response.json();
+  // The API wraps the list ({ tasks: [...] }); accept a bare array too.
+  const list = Array.isArray(body) ? body : Array.isArray(body?.tasks) ? body.tasks : [];
+  const tasks = list
+    .filter(
+      (t) =>
+        t &&
+        typeof t.taskName === 'string' &&
+        t.taskName.trim() &&
+        typeof t.prompt === 'string' &&
+        t.prompt.trim()
+    )
+    .slice(0, MAX_TASKS);
+  if (tasks.length === 0) return;
+
+  // Claude Code renders systemMessage with ANSI intact; the leading \n
+  // pushes our block below the fixed "SessionStart:<source> says:" prefix.
+  const BOLD = '\x1b[1m';
+  const CYAN = '\x1b[36m';
+  const GREY = '\x1b[37m';
+  const RESET = '\x1b[0m';
+  const visibleList = tasks
+    .map((t, i) => `  ${BOLD}${i + 1}.${RESET} ${oneLine(t.taskName)}`)
+    .join('\n');
+  const systemMessage =
+    `\n${BOLD}${CYAN}✻ Ari — things Claude can take care of for you right now${RESET}\n` +
+    `${visibleList}\n` +
+    `${GREY}Reply "run task 1" (or the task name) to start one.${RESET}`;
+
+  const additionalContext =
+    `The user has Ari connected via ari-hooks. At session start the user was ` +
+    `shown this list of suggested tasks:\n\n` +
+    tasks
+      .map(
+        (t, i) =>
+          `Task ${i + 1}: ${oneLine(t.taskName)}\nPrompt: ${clamp(t.prompt)}`
+      )
+      .join('\n\n') +
+    `\n\nIf the user asks to run one of these tasks (by number or name), ` +
+    `carry out that task's prompt as if the user had typed it. Do not start ` +
+    `any of these tasks unless the user asks.`;
+
+  // writeSync: process.exit(0) in runHook would race an async stdout write.
+  writeSync(
+    1,
+    JSON.stringify({
+      systemMessage,
+      hookSpecificOutput: {
+        hookEventName: 'SessionStart',
+        additionalContext,
+      },
+    }) + '\n'
+  );
+}
+
 /**
  * Entry point for `ari-hooks hook <event>`. Hooks must never break the
  * user's Claude Code session: all failures are swallowed (logged to
@@ -141,6 +225,8 @@ export async function runHook(event) {
       await onUserPromptSubmit(input);
     } else if (event === 'stop') {
       await onStop(input);
+    } else if (event === 'session-start') {
+      await onSessionStart(input);
     }
   } catch (err) {
     logError(err);

package/src/init.js

@@ -2,6 +2,7 @@ import { join } from 'node:path';
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 
 const HOOK_EVENTS = {
+  SessionStart: 'ari-hooks hook session-start',
   UserPromptSubmit: 'ari-hooks hook user-prompt-submit',
   Stop: 'ari-hooks hook stop',
 };
@@ -50,6 +51,7 @@ export function init(cwd = process.cwd()) {
   writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
   console.log(`✓ Ari hooks added to ${settingsPath}`);
   console.log(
-    'Claude Code sessions in this folder will now share each request and its outcome with Ari.'
+    'Claude Code sessions in this folder will now share each request and its outcome with Ari,'
   );
+  console.log('and show suggested Ari tasks when a session starts.');
 }

package/src/login.js

@@ -12,7 +12,7 @@ import {
 const LOGIN_TIMEOUT_MS = 5 * 60 * 1000;
 
 const SUCCESS_HTML = `<!doctype html>
-<html><head><title>Ari Hooks</title></head>
+<html><head><meta charset="utf-8"><title>Ari Hooks</title></head>
 <body style="font-family: sans-serif; text-align: center; padding-top: 4rem;">
 <h2>✓ Logged in</h2>
 <p>The Ari Hooks CLI received your token. You can close this window.</p>
@@ -36,7 +36,7 @@ function openBrowser(url) {
 
 /**
  * Browser login: start a one-shot loopback HTTP server, send the user to
- * the web app's /cli-auth page with our callback URL, and wait for the
+ * the web app's /cli-auth page with our callback port, and wait for the
  * page to redirect back with a freshly minted API token.
  */
 export async function login() {
@@ -45,7 +45,7 @@ export async function login() {
 
   const token = await new Promise((resolve, reject) => {
     const server = createServer((req, res) => {
-      const url = new URL(req.url, 'http://127.0.0.1');
+      const url = new URL(req.url, 'http://localhost');
       if (url.pathname !== '/callback') {
         res.writeHead(404).end();
         return;
@@ -59,20 +59,20 @@ export async function login() {
         res.writeHead(400).end('Missing token.');
         return;
       }
-      res.writeHead(200, { 'Content-Type': 'text/html' }).end(SUCCESS_HTML);
+      res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' }).end(SUCCESS_HTML);
       // Let the response flush before tearing the server down.
       setTimeout(() => server.close(), 100);
       resolve(received);
     });
 
     server.on('error', reject);
+    // Bind to 127.0.0.1 explicitly — the web app reconstructs the callback
+    // as http://127.0.0.1:<port>/callback from callback_port.
     server.listen(0, '127.0.0.1', () => {
       const { port } = server.address();
       const authUrl = new URL('/cli-auth', getWebUrl(config));
-      authUrl.searchParams.set(
-        'callback',
-        `http://127.0.0.1:${port}/callback`
-      );
+      // Pass only the port; the full callback URL trips the WAF.
+      authUrl.searchParams.set('callback_port', String(port));
       authUrl.searchParams.set('state', state);
 
       console.log('Opening your browser to log in to Ari...');