@tianmucreations/jeeves 0.3.0 → 0.3.2

package/LICENSE

@@ -1,21 +1,41 @@
-MIT License
+Jeeves Licence
+Copyright (c) 2026 Tianmu Creations. All rights reserved.
 
-Copyright (c) 2026 tianmucreations
+This licence applies to Jeeves version 0.3.1 and every later version. Versions
+0.3.0 and earlier were released under the MIT licence, which still applies to
+those versions.
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+1. YOU MAY
+   - Install Jeeves and use it free of charge, for personal use and for work,
+     on as many of your own computers as you like.
+   - Read the source code on GitHub.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+2. YOU MAY NOT, without written permission from Tianmu Creations
+   - copy Jeeves, or any part of its source code, except as needed to install
+     and run it;
+   - change, adapt, translate, or build other software from Jeeves or its
+     source code;
+   - merge Jeeves, or any part of it, into other software;
+   - publish, share, distribute, host, or make Jeeves available to others,
+     changed or unchanged, except by pointing them to the official copies on
+     npm (npmjs.com/package/@tianmucreations/jeeves) and GitHub;
+   - sublicense, rent, lease, lend, or sell Jeeves or access to it; or
+   - remove or change this licence or any copyright notice.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+3. OTHER PEOPLE'S WORK
+   Jeeves uses add-ons made by others, which are installed alongside it and keep
+   their own licences. Its built-in list of AI models and prices comes from
+   models.dev (MIT licence).
+
+4. NO WARRANTY
+   Jeeves is provided "as is", without any warranty of any kind. Jeeves asks
+   before changing your computer and keeps backups for /undo, but you are
+   responsible for what you approve and for the costs of the AI services you
+   connect it to. To the fullest extent the law allows, Tianmu Creations is not
+   liable for any loss or damage arising from using Jeeves.
+
+5. ENDING
+   This licence ends automatically if you break it. When it ends you must stop
+   using Jeeves and delete your copies.
+
+Questions or permission requests: https://tianmucreations.com

package/README.md

@@ -32,7 +32,9 @@ Needs [Node.js](https://nodejs.org) 22.12 or newer, and a key from an AI service
 
 **He doesn't guess.** Facts about the outside world are looked up on the web, read from the most official page, and given with their source. Before building something new, he checks what already exists and shows you a short research note: use an existing tool, adapt one (licence permitting), or build new — and why. If the same problem happens twice, he researches the cause instead of patching blindly.
 
-**Safe to say yes to.** Anything that changes your computer asks first. Before any change in your project folder he quietly takes a backup, so `/undo` puts the folder back — changed and deleted files return, new ones disappear. Changes outside the folder come with a warning, because they can't be undone.
+**Safe to say yes to.** Anything that changes your computer asks first — or answer **a** once to always allow changes inside that project folder (`/ask` turns asking back on). Before any change in your project folder he quietly takes a backup, so `/undo` puts the folder back — changed and deleted files return, new ones disappear. Changes outside the folder always ask, with a warning, because they can't be undone.
+
+**Type while he works.** Your message box grows as you type, and anything you send while Jeeves is busy waits its turn and goes as soon as he finishes. Your own messages sit on a soft grey band, so they're easy to find when you scroll back.
 
 **Honest about costs.** A daily spending limit (you choose it; $3 to start) stops and asks before going over, and a long job checks in every 50 cents. Nothing is spent without you seeing it — and it can cost nothing at all: OpenRouter's free models, or models running on your own computer with Ollama.
 
@@ -70,6 +72,7 @@ Auto is offered only where a pairing has been measured doing everyday and diffic
 | `/model` | Choose a service and a model (or Auto), and set your daily limit |
 | `/keys` | Add, replace or remove keys |
 | `/undo` | Put the project folder back to before your last request |
+| `/ask` | Ask before every change in this project folder again (after choosing "always allow") |
 | `/clear` | Start a fresh conversation |
 | `/address` | Change how Jeeves addresses you |
 | `/verbose` | Show the technical details as well |
@@ -90,4 +93,4 @@ Arrow keys and the trackpad scroll the conversation; `Page Up` / `Page Down` jum
 
 ## Licence
 
-MIT — made by [Tianmu Creations](https://tianmucreations.com). More about Jeeves at [tianmucreations.com/jeeves](https://tianmucreations.com/jeeves/).
+Free to use, for personal use and for work. All rights reserved — see [LICENSE](LICENSE): you may not copy, change, share or sell Jeeves. Versions up to 0.3.0 were released under the MIT licence. Made by [Tianmu Creations](https://tianmucreations.com). More about Jeeves at [tianmucreations.com/jeeves](https://tianmucreations.com/jeeves/).

package/dist/agent/errors.js

@@ -37,7 +37,7 @@ export function plainError(error, providerId) {
     const service = serviceName(providerId);
     const make = (message, kind) => ({ message, kind, detail: raw });
     if (/^no .*\bkey\b/.test(text)) {
-        return make("There's no key yet - type /keys to add one.", 'auth');
+        return make('Jeeves isn\'t connected to an AI service yet - type /keys to connect one. It takes about a minute.', 'auth');
     }
     if (status === 401 ||
         status === 403 ||

package/dist/agent/loop.js

@@ -11,12 +11,14 @@ import { isToolCapable } from '../models/filter.js';
 import { autoCatalogue } from './auto.js';
 import { isAuto, workingModelId, workerModel, expertModel, topModel, AUTO_NOTE, shouldTakeOver, createAskExpertTool, newAutoTurnState, topModelPriceRatio, topModelQuestion, REVIEW_FINISHED_JOBS } from './auto.js';
 import { jobNeedsReview, reviewJob, fixRequest, startReproducing, stopReproducing, UNCHECKED_NOTICE } from './review.js';
-import { requestApproval } from './permissions.js';
+import { requestApproval, hasPendingApproval, answerApproval } from './permissions.js';
+import { killAllRunningCommands } from '../tools/runBash.js';
 import { clearOldToolResults } from './housekeeping.js';
 import { startJob, endJob, reportStepCost, withinLimits } from './spending.js';
 import { getAddress } from '../platform/config.js';
 import { startTurnCheckpoints, undoLastChange } from '../checkpoints/index.js';
 import { noteSkipRequest } from './research-gate.js';
+import { untrustProject } from './trust.js';
 // Added to the rulebook when the chosen model cannot use tools, so a task request
 // gets a plain answer instead of a pretend attempt.
 export const CHAT_ONLY_NOTE = `
@@ -25,6 +27,24 @@ Chat-Only Model
 
 The model currently selected can only chat. For now you have no tools: you cannot read files, write files, list folders, or run commands, whatever the sections above say. If you are asked to do something that needs them, say plainly that the model in use can only chat, and suggest typing /model to choose one that can do tasks. Never pretend to have done it.`;
 const DISCONNECTING = new Set(['auth', 'network', 'payment']);
+// The job now running, so the person can stop it (Claude Code's Esc: the request is
+// cancelled and running commands are closed).
+let currentStop = null;
+// Stops the job now running: the model request, any command it started, any
+// question waiting for an answer, and messages waiting their turn. Returns false
+// when nothing was running.
+export function stopTurn() {
+    if (!currentStop || currentStop.signal.aborted)
+        return false;
+    currentStop.abort();
+    killAllRunningCommands();
+    while (hasPendingApproval())
+        answerApproval(false);
+    while (session.takeQueued() !== undefined) {
+        // Messages sent while busy are dropped too - "stop" means stop.
+    }
+    return true;
+}
 export async function runTurn(input) {
     if (input.startsWith('/') && input.length > 1 && !input.startsWith('/ ')) {
         if (input === '/help') {
@@ -36,12 +56,20 @@ export async function runTurn(input) {
         else if (input === '/keys') {
             session.openKeys();
         }
+        else if (input === '/folder') {
+            session.openFolderPicker();
+        }
         else if (input === '/verbose') {
             session.addNotice(toggleVerbose());
         }
         else if (input === '/address') {
             openAddressPrompt();
         }
+        else if (input === '/ask') {
+            session.addNotice(untrustProject()
+                ? "I'll ask before every change in this project folder again."
+                : 'I already ask before every change in this project folder.');
+        }
         else if (input === '/undo') {
             if (session.status === 'working') {
                 session.addNotice('Undo works between tasks - wait for this one to finish, then type /undo.');
@@ -62,6 +90,7 @@ export async function runTurn(input) {
         }
         else if (input === '/clear') {
             clearConversation();
+            session.addNotice('Started a fresh conversation - the earlier one is cleared.');
         }
         else if (input === '/exit') {
             session.requestExit();
@@ -96,6 +125,7 @@ export async function runTurn(input) {
     const autoState = newAutoTurnState();
     session.setActiveModel(auto ? workerModel() : null);
     const stop = new AbortController();
+    currentStop = stop;
     let countedSteps = 0;
     session.beginTurn();
     session.setStatus('working');
@@ -149,15 +179,18 @@ export async function runTurn(input) {
                 return { modelId: stepModel, messages: tidied.freedTokens > 0 ? tidied.messages : undefined };
             },
             onToken: (token) => {
+                session.setThinking(false);
                 if (assistantId === null)
                     assistantId = session.startAssistant();
                 session.appendToken(assistantId, token);
             },
             onReasoning: (delta) => {
+                session.setThinking(true);
                 if (session.verbose)
                     session.appendReasoning(delta);
             },
             onToolCall: () => {
+                session.setThinking(false);
                 // Hide pre-tool chatter so only the final answer stays visible (spec 2.3). The
                 // entry is removed, not just emptied, so the final answer appears below the
                 // actions it reports on rather than above them.
@@ -213,10 +246,16 @@ export async function runTurn(input) {
             reportStepCost(cost);
         session.setPlanResetAt(null);
         session.setActiveModel(auto ? workerModel() : null);
+        session.setThinking(false);
+        if (currentStop === stop)
+            currentStop = null;
         endJob();
         session.setStatus('idle');
     }
     catch (error) {
+        session.setThinking(false);
+        if (currentStop === stop)
+            currentStop = null;
         endJob();
         session.setActiveModel(auto ? workerModel() : null);
         if (stop.signal.aborted) {

package/dist/agent/permissions.js

@@ -1,4 +1,6 @@
 import { session } from '../state/session.js';
+import { trustProject } from './trust.js';
+import { getAddress } from '../platform/config.js';
 // Pure-output commands that never require permission (the rule: harmless
 // output must never prompt). A command is auto-approved only when every stage of
 // it - across pipes, && and || - is one of the commands below, and the only
@@ -172,18 +174,32 @@ const queue = [];
 export function hasPendingApproval() {
     return queue.length > 0;
 }
-export function requestApproval() {
+export function requestApproval(options = {}) {
     return new Promise((resolve) => {
-        queue.push({ resolve });
+        queue.push({ resolve, trustable: options.trustable === true });
         if (queue.length === 1) {
             session.setActiveApproval();
         }
     });
 }
-export function answerApproval(approved) {
+// Whether the question now on screen may be answered with "always allow".
+export function currentApprovalTrustable() {
+    return queue[0]?.trustable === true;
+}
+// always: "always allow in this project" - approves this change, every other change
+// inside the project already waiting, and all future ones in this folder.
+export function answerApproval(approved, always = false) {
     const current = queue.shift();
     if (!current)
         return;
+    if (always && approved && current.trustable) {
+        trustProject();
+        session.addNotice(`From now on I won't ask before changing things in this project folder, ${getAddress() ?? 'Sir'} - every change is still backed up, so /undo puts it back. I'll still ask about anything outside it. Type /ask to have me ask every time again.`);
+        for (let i = queue.length - 1; i >= 0; i--) {
+            if (queue[i].trustable)
+                queue.splice(i, 1)[0].resolve(true);
+        }
+    }
     current.resolve(approved);
     if (queue.length > 0) {
         session.setActiveApproval();

package/dist/agent/systemPrompt.js

@@ -1,11 +1,12 @@
 import { getAddress } from '../platform/config.js';
+import { partOfDay } from '../platform/address.js';
 // The system prompt is the personality and the rulebook, copied verbatim from the
 // product specification. {{ADDRESS}} is replaced with the user's saved form of
 // address (config key "address", asked once on first launch, changeable via
 // /address); "Sir" is the fallback if none is saved yet.
 export const SYSTEM_PROMPT_TEMPLATE = `Identity
 
-You are Jeeves, a gentleman's personal assistant built by Tianmu Creations. You speak with quiet formality, dry wit, and impeccable discretion, in the tradition of P.G. Wodehouse. You are competent, unflappable, and never flustered. You do not use modern slang. You do not use emoji. Your replies are concise and warm, never servile. When you complete a task, you say so plainly and stop. You address the user as {{ADDRESS}}.
+You are Jeeves, a gentleman's personal assistant built by Tianmu Creations. You speak with quiet formality, dry wit, and impeccable discretion, in the tradition of P.G. Wodehouse. Your wit never costs clarity: say the plain fact first. You are competent, unflappable, and never flustered. You do not use modern slang. You do not use emoji. Your replies are concise and warm, never servile. When you complete a task, you say so plainly and stop. You address the user as {{ADDRESS}}.
 
 The person using you may have no technical background at all: they describe what they want in ordinary words, and you do the work by reading files, writing files, listing folders, and running shell commands.
 
@@ -65,6 +66,7 @@ You have seven tools: readFile, listDir, writeFile, runBash, webSearch, readWebP
 Researching the Web
 
 For facts about the outside world — versions, prices, dates, rules, current events, how a product works — research before stating them:
+Today's date is {{TODAY}}. What you learned in training stops well before it, so "this year", "the current season" and "the latest" mean the year of today's date: search for that year by name, and never present an earlier year's results as current.
 1. webSearch to find where to look. Its snippets are not checked facts.
 2. readWebPage on the most official source: the maker's own website, documentation, release list, or registry, in preference to news or blogs.
 3. State the fact only once readWebPage has returned the exact quote, and name the source in a few words.
@@ -85,8 +87,10 @@ Never use placeholders or guess missing parameters in tool calls.
 Complete tasks fully. Do not stop mid-task or leave work incomplete.
 Tone and Style
 
-Your output appears in a command-line interface. Keep responses short.
-Answer concisely — fewer than four lines of text (not counting tool use), unless the user asks for detail.
+Write for a person who has not seen your working. {{ADDRESS}} cannot see your thinking or most of what your tools returned — only your words. They do not know names, labels or shorthand you made up along the way (such as "Corner A", "the finalists", "the capacity corner"), so never use them: say what the thing actually is.
+Use complete, plain sentences that can be read once and understood. Never put a metaphor or figure of speech in place of a fact.
+In a longer job, a progress update says in a sentence or two what you found, what it means for {{ADDRESS}}, and what you are doing next.
+Be brief, but clarity comes first: if {{ADDRESS}} would have to read it twice or ask what you meant, it was too short. A simple question gets a short, direct answer.
 Lead with the answer, not the reasoning. Skip filler, preamble, and unnecessary transitions.
 Never say "Let me...", "I'll now...", or "First, I will..." before acting. Just act, then report the result in a sentence or two.
 Do not summarise your own actions. Do not explain your code unless asked.
@@ -97,14 +101,24 @@ Writing files and running non-read-only commands may ask the user for permission
 If the user declines a permission, do not ask again for the same action. Acknowledge it briefly and continue with whatever can still be done.
 Environment
 
+Today's date is {{TODAY}}, and it is {{PART_OF_DAY}} (this computer's own date and clock). Greet by that - never guess the time of day.
 The computer is macOS. The working directory is the user's chosen project folder; relative paths refer to it.
 Shell commands run in the user's default shell. Prefer cross-platform-safe commands.
 If a task would be destructive or hard to undo, say so plainly before doing it.
 Professional Objectivity
 
 Prioritise technical accuracy over validating the user's beliefs. If the user's approach has a problem, say so plainly and offer the better path.`;
-export function buildSystemPrompt(address) {
-    return SYSTEM_PROMPT_TEMPLATE.replaceAll('{{ADDRESS}}', address);
+// Today's date on this computer, as Claude Code gives it (constants/common.ts
+// getLocalISODate): the local calendar date, so it is right wherever the person is.
+// Without it, a question about "the season" was answered with last year's (19 Sept).
+export function localISODate(now = new Date()) {
+    return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')}`;
+}
+// The part of the day as well (owner's request, 19 Sept): the model otherwise
+// guessed "Good evening". It changes three times a day, so the prompt stays
+// cacheable in between.
+export function buildSystemPrompt(address, today = localISODate(), dayPart = partOfDay()) {
+    return SYSTEM_PROMPT_TEMPLATE.replaceAll('{{ADDRESS}}', address).replaceAll('{{TODAY}}', today).replaceAll('{{PART_OF_DAY}}', dayPart);
 }
 // The address the user saved on first launch; "Sir" until one is saved.
 export function getSystemPrompt() {

package/dist/agent/trust.js

@@ -0,0 +1,29 @@
+import { realpathSync } from 'node:fs';
+import { getTrustedProjects, setTrustedProjects } from '../platform/config.js';
+// "Always allow in this project" (after Claude Code's "Yes, allow all edits in this
+// folder during this session" - here remembered per project folder, as asked for).
+// It covers changes inside the project folder only: anything outside it, or a
+// command that may reach outside it, still asks. Every change is still backed up
+// first, so /undo can put it back.
+function canonical(folder) {
+    try {
+        return realpathSync(folder);
+    }
+    catch {
+        return folder;
+    }
+}
+export function isProjectTrusted(folder = process.cwd()) {
+    return getTrustedProjects().includes(canonical(folder));
+}
+export function trustProject(folder = process.cwd()) {
+    const key = canonical(folder);
+    if (!getTrustedProjects().includes(key))
+        setTrustedProjects([...getTrustedProjects(), key]);
+}
+export function untrustProject(folder = process.cwd()) {
+    const key = canonical(folder);
+    const before = getTrustedProjects();
+    setTrustedProjects(before.filter((entry) => entry !== key));
+    return before.includes(key);
+}

package/dist/app.js

@@ -1,9 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect } from 'react';
-import { Box, Text, useStdout } from 'ink';
+import { Box, Text, useInput, useStdout } from 'ink';
 import { Header } from './components/Header.js';
 import { Transcript } from './components/Transcript.js';
-import { Input } from './components/Input.js';
+import { Input, inputRowsFor } from './components/Input.js';
 import { Footer } from './components/Footer.js';
 import { session, useSession } from './state/session.js';
 import { initKeys, hasCredentials, refreshCredit, serviceKey } from './providers/index.js';
@@ -16,6 +16,8 @@ import { KeysManager } from './components/KeysManager.js';
 import { HelpView } from './components/HelpView.js';
 import { ProjectPicker } from './components/ProjectPicker.js';
 import { AddressPrompt } from './components/AddressPrompt.js';
+import { ENABLE_MOUSE_TRACKING, DISABLE_MOUSE_TRACKING } from './ink/mouse.js';
+import { pressCtrlCToQuit } from './ink/quit.js';
 // The main window: a rounded box border around the top section only, with the
 // info bar on its own row below the box. Top to bottom: plain top border, header
 // row inside the box (Jeeves left, dot right), transcript (flexGrow), internal
@@ -29,7 +31,12 @@ export function App() {
     const rows = Math.max(stdout.rows ?? 24, 8);
     const columns = Math.max(stdout.columns ?? 80, 40);
     const inner = columns - 2;
-    const midHeight = Math.max(1, rows - 6);
+    // The input box grows with the message (up to MAX_INPUT_ROWS); the transcript gives
+    // up the rows. A hint or question in the input row is always one row.
+    const inputRows = s.approvalPending || s.transcriptScrollUp > 0 ? 1 : inputRowsFor(s.inputText, inner - 2);
+    const midHeight = Math.max(1, rows - 5 - inputRows);
+    const inputSideLeft = Array.from({ length: inputRows }, () => '│ ').join('\n');
+    const inputSideRight = Array.from({ length: inputRows }, () => ' │').join('\n');
     const side = '│\n'.repeat(midHeight - 1) + '│';
     const separator = '─'.repeat(inner);
     useEffect(() => {
@@ -61,6 +68,26 @@ export function App() {
             }
         });
     }, []);
+    // The mouse is Jeeves's only on the conversation screen (wheel scrolling, drag to
+    // copy). On every other screen - keys, models, help, folders, the first question -
+    // it goes back to the terminal, so its own selecting and Cmd+C copy work: a web
+    // address such as where to get a key can be copied (owner, 19 Sept: "I still
+    // can't copy things").
+    const onConversation = !(s.wizardActive || s.keysOpen || s.pickerOpen || s.helpOpen || s.addressOpen || s.launchStage !== 'ready');
+    // On the setup screens Ctrl+C is only for quitting - still twice, never at once.
+    // (The conversation screen's typing box handles its own.)
+    useInput((input, key) => {
+        if (key.ctrl && input === 'c' && !onConversation)
+            pressCtrlCToQuit();
+    });
+    useEffect(() => {
+        try {
+            process.stdout.write(onConversation ? ENABLE_MOUSE_TRACKING : DISABLE_MOUSE_TRACKING);
+        }
+        catch {
+            // A closed stream must never crash the app.
+        }
+    }, [onConversation]);
     if (s.wizardActive) {
         return _jsx(KeysManager, { mode: "wizard", rows: rows, columns: columns });
     }
@@ -79,5 +106,5 @@ export function App() {
     if (s.launchStage === 'project') {
         return _jsx(ProjectPicker, { rows: rows, columns: columns });
     }
-    return (_jsxs(Box, { flexDirection: "column", height: rows, width: columns, children: [_jsxs(Text, { dimColor: true, children: ["\u256D", separator, "\u256E"] }), _jsxs(Box, { height: 1, children: [_jsx(Text, { dimColor: true, children: "\u2502" }), _jsx(Box, { width: inner, paddingLeft: 1, paddingRight: 1, flexDirection: "column", children: _jsx(Header, {}) }), _jsx(Text, { dimColor: true, children: "\u2502" })] }), _jsxs(Box, { height: midHeight, children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { dimColor: true, children: side }) }), _jsx(Box, { width: inner, paddingLeft: 1, paddingRight: 1, children: _jsx(Transcript, { width: inner - 2 }) }), _jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { dimColor: true, children: side }) })] }), _jsxs(Text, { dimColor: true, children: ["\u251C", separator, "\u2524"] }), _jsxs(Box, { height: 1, children: [_jsx(Text, { dimColor: true, children: "\u2502 " }), _jsx(Box, { width: inner - 2, children: _jsx(Input, { scrollPage: midHeight, width: inner - 2 }) }), _jsx(Text, { dimColor: true, children: " \u2502" })] }), _jsxs(Text, { dimColor: true, children: ["\u2570", separator, "\u256F"] }), _jsx(Box, { height: 1, flexDirection: "column", children: _jsx(Footer, {}) })] }));
+    return (_jsxs(Box, { flexDirection: "column", height: rows, width: columns, children: [_jsxs(Text, { dimColor: true, children: ["\u256D", separator, "\u256E"] }), _jsxs(Box, { height: 1, children: [_jsx(Text, { dimColor: true, children: "\u2502" }), _jsx(Box, { width: inner, paddingLeft: 1, paddingRight: 1, flexDirection: "column", children: _jsx(Header, {}) }), _jsx(Text, { dimColor: true, children: "\u2502" })] }), _jsxs(Box, { height: midHeight, children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { dimColor: true, children: side }) }), _jsx(Box, { width: inner, paddingLeft: 1, paddingRight: 1, children: _jsx(Transcript, { width: inner - 2 }) }), _jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { dimColor: true, children: side }) })] }), _jsxs(Text, { dimColor: true, children: ["\u251C", separator, "\u2524"] }), _jsxs(Box, { height: inputRows, children: [_jsx(Text, { dimColor: true, children: inputSideLeft }), _jsx(Box, { width: inner - 2, children: _jsx(Input, { scrollPage: midHeight, width: inner - 2 }) }), _jsx(Text, { dimColor: true, children: inputSideRight })] }), _jsxs(Text, { dimColor: true, children: ["\u2570", separator, "\u256F"] }), _jsx(Box, { height: 1, flexDirection: "column", children: _jsx(Footer, {}) })] }));
 }

package/dist/checkpoints/index.js

@@ -90,11 +90,41 @@ export function isOutsideProject(target, folder = process.cwd()) {
 export function commandMayReachOutside(command, folder = process.cwd()) {
     if (/(^|[\s;|&])sudo\b|\bbrew\s|\s(-g|--global)\b|\bapt(-get)?\s|\bchoco\s|\bwinget\s/.test(command))
         return true;
-    if (/(^|[\s'"=])~(\/|\s|$)|(^|[\s'"=/])\.\.(\/|\\|\s|$)|\$HOME|%USERPROFILE%/.test(command))
+    if (/\$HOME|%USERPROFILE%/.test(command))
         return true;
-    for (const match of command.matchAll(/(?:^|[\s'"=])((?:\/|[A-Za-z]:\\)[^\s'"]*)/g)) {
-        const candidate = match[1];
-        if (/^\/dev\/null$/.test(candidate))
+    // A quoted path is one path however many spaces it holds - a project folder
+    // called "Income Streams Research" was read only up to "Income", so every command
+    // naming the folder in full counted as outside it and could never be "always
+    // allowed" (19 Sept). Quoted text is judged whole: a path is checked as a path,
+    // anything else (bash -c "...") as a command of its own. A backslash-escaped
+    // space (Income\ Streams) joins a word the same way.
+    const quoted = [];
+    const rest = command
+        .replace(/"([^"]*)"|'([^']*)'/g, (_match, double, single) => {
+        quoted.push(double ?? single ?? '');
+        return ' ';
+    })
+        .replace(/\\ /g, '\u0000');
+    for (const text of quoted) {
+        if (/^~(\/|$)/.test(text))
+            return true;
+        if (/^(\/|[A-Za-z]:\\|\.\.(\/|\\|$))/.test(text)) {
+            if (text !== '/dev/null' && isOutsideProject(text, folder))
+                return true;
+            // A path that goes on into more command (bash -c "/x/run.sh && rm /y") is also
+            // read word by word - a false question is safe, a false "allowed" is not.
+            if (/[;&|<>]|\s[-/~.]/.test(text) && commandMayReachOutside(text, folder))
+                return true;
+        }
+        else if (text.trim() && commandMayReachOutside(text, folder)) {
+            return true;
+        }
+    }
+    if (/(^|[\s=])~(\/|\s|$)|(^|[\s=/])\.\.(\/|\\|\s|$)/.test(rest))
+        return true;
+    for (const match of rest.matchAll(/(?:^|[\s=])((?:\/|[A-Za-z]:\\)\S*)/g)) {
+        const candidate = match[1].replace(/\u0000/g, ' ');
+        if (candidate === '/dev/null')
             continue;
         if (isOutsideProject(candidate, folder))
             return true;

package/dist/commands/clear.js

@@ -1,6 +1,7 @@
 import { session } from '../state/session.js';
 import { resetStickySession } from '../providers/openrouter.js';
 import { resetResearchGate } from '../agent/research-gate.js';
+import { resetBorrowedSearch } from '../tools/web/research.js';
 // Starts fresh: wipes the screen and the conversation the model remembers.
 export function clearConversation() {
     session.clearTranscript();
@@ -8,4 +9,5 @@ export function clearConversation() {
     session.setLastReasoning('');
     resetStickySession();
     resetResearchGate();
+    resetBorrowedSearch();
 }

package/dist/commands/help.js

@@ -1,20 +1,23 @@
+import { WORD_JUMP_KEYS } from '../platform/wording.js';
 export const COMMANDS = [
     { command: '/help', description: 'show this list' },
-    { command: '/model', description: 'pick a different AI model' },
-    { command: '/keys', description: 'add or remove keys' },
+    { command: '/model', description: 'choose the AI service and model' },
+    { command: '/keys', description: 'connect an AI service, or remove one' },
+    { command: '/folder', description: 'work in a different folder, or just chat' },
+    { command: '/undo', description: "put the folder back to how it was before Jeeves's last change" },
+    { command: '/ask', description: 'ask before every change again (after "always allow")' },
+    { command: '/clear', description: 'start a fresh conversation' },
     { command: '/address', description: 'change how Jeeves addresses you' },
-    { command: '/verbose', description: "show the model's thinking and technical details" },
-    { command: '/undo', description: 'put the project folder back to how it was before the last change' },
-    { command: '/clear', description: 'start a fresh conversation and clear the screen' },
+    { command: '/verbose', description: 'show technical details as well (for curious people)' },
     { command: '/exit', description: 'quit' },
 ];
 export const KEY_BINDINGS = [
-    { command: 'up down', description: 'move in lists' },
-    { command: 'Enter', description: 'select' },
-    { command: 'Esc', description: 'go back' },
-    { command: 'Ctrl+R', description: "show the model's last thinking" },
-    { command: 'y / n', description: 'allow or deny a permission request' },
-    { command: 'arrows', description: 'scroll the conversation up and down; Page Up / Page Down jump a whole screen; End returns to the newest' },
-    { command: 'wheel', description: 'the trackpad or mouse wheel scrolls the conversation too' },
-    { command: 'copying', description: 'hold Fn and drag to select text (Option in iTerm2, Shift elsewhere)' },
+    { command: 'Enter', description: 'send your message, or choose in a list' },
+    { command: 'Esc', description: 'stop what Jeeves is doing, or go back' },
+    { command: 'Ctrl+C', description: 'clear what you are typing or stop Jeeves; press it twice to quit' },
+    { command: 'y / a / n', description: 'answer a question: yes, always allow in this folder, or no' },
+    { command: '↑ ↓', description: 'move in a list, or scroll the conversation; Page Up / Page Down jump a whole screen; End returns to the newest' },
+    { command: '← →', description: `move the cursor in what you are typing; ${WORD_JUMP_KEYS} jump a word; Ctrl+A / Ctrl+E go to the start / end; or click where you want it` },
+    { command: 'copying', description: 'drag over any text - it is copied when you let go' },
+    { command: 'Ctrl+R', description: 'show the notes Jeeves made while thinking about the last answer' },
 ];

package/dist/commands/keys.js

@@ -1,3 +1,4 @@
+import { KEY_STORE } from '../platform/wording.js';
 // Plain-English key helpers; the interactive screens live in KeysManager.
 export function keyLooksValid(key, provider) {
     const trimmed = key.trim();
@@ -8,7 +9,7 @@ export function keyLooksValid(key, provider) {
 }
 export function describeKeySource(source) {
     if (source === 'keychain')
-        return 'key stored in your Mac keychain';
+        return `key stored in ${KEY_STORE}`;
     if (source === 'env')
         return 'key in a local file - add it with /keys to store it safely';
     return 'no key';

package/dist/components/AddressPrompt.js

@@ -4,19 +4,33 @@ import { Box, Text, useInput } from 'ink';
 import { session } from '../state/session.js';
 import { getAddress, setAddress } from '../platform/config.js';
 import { isMouseSequence } from '../ink/mouse.js';
+import { cleanAddress, timeOfDayGreeting, ADDRESS_MAX } from '../platform/address.js';
+import { splitTypedBurst } from './input-layout.js';
 // The first-launch question, in Jeeves' own voice, asked once before the project
 // picker whenever no address is saved; /address reopens the same screen later.
 export function AddressPrompt({ rows }) {
     const [value, setValue] = useState('');
+    const [note, setNote] = useState('');
     const firstRun = session.launchStage === 'address';
     useInput((input, key) => {
         if (isMouseSequence(input))
             return;
-        if (key.return) {
-            const address = value.trim() || getAddress() || 'Sir';
-            setAddress(address.slice(0, 30));
+        // Typing and Enter can arrive together (as in the main typing box, 18 Sept):
+        // the text before the line break is typed text, the break is Enter.
+        const burst = key.return ? { typed: '', enter: true } : splitTypedBurst(input);
+        if (burst.enter) {
+            const typedValue = (value + burst.typed).slice(0, ADDRESS_MAX);
+            // Nothing typed keeps the current address; on the first run there is none to
+            // keep, so Jeeves asks rather than guessing "Sir".
+            const address = cleanAddress(typedValue) ?? getAddress();
+            if (!address) {
+                setValue(typedValue);
+                setNote("Type Sir, Ma'am, your name, or whatever you'd like to be called.");
+                return;
+            }
+            setAddress(address);
             session.addressDone();
-            session.addNotice(`Very good - I shall address you as ${address.slice(0, 30)}.`);
+            session.addNotice(`Very good - I shall address you as ${address}.`);
             return;
         }
         if (key.backspace || key.delete) {
@@ -25,7 +39,8 @@ export function AddressPrompt({ rows }) {
         }
         if (!input || key.ctrl || key.meta)
             return;
-        setValue((v) => (v.length >= 30 ? v : v + input));
+        setNote('');
+        setValue((v) => (v.length >= ADDRESS_MAX ? v : v + input));
     });
-    return (_jsxs(Box, { flexDirection: "column", height: rows, children: [_jsx(Text, { dimColor: true, children: "Good evening. Before we begin \u2014 how shall I address you? Sir, Madam, or something else?" }), _jsx(Box, { flexGrow: 1, justifyContent: "center", flexDirection: "column", minHeight: 1, children: _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "Address: " }), _jsx(Text, { children: value }), _jsx(Text, { inverse: true, children: " " })] }) }), firstRun ? _jsx(Text, { dimColor: true, children: "type your title \u00B7 Enter save" }) : _jsx(Text, { dimColor: true, children: "type a new title \u00B7 Enter save \u00B7 unchanged keeps the current one" })] }));
+    return (_jsxs(Box, { flexDirection: "column", height: rows, children: [_jsxs(Text, { dimColor: true, children: [timeOfDayGreeting(), ". Before we begin \u2014 how shall I address you? Sir, Ma'am, or something else?"] }), _jsx(Box, { flexGrow: 1, justifyContent: "center", flexDirection: "column", minHeight: 1, children: _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "Call me: " }), _jsx(Text, { children: value }), _jsx(Text, { inverse: true, children: " " })] }) }), note ? _jsx(Text, { color: "yellow", children: note }) : null, firstRun ? _jsx(Text, { dimColor: true, children: "type Sir, Ma'am or a name \u00B7 Enter save" }) : _jsx(Text, { dimColor: true, children: "type a new title \u00B7 Enter save \u00B7 unchanged keeps the current one" })] }));
 }

package/dist/components/Footer.js

@@ -5,6 +5,7 @@ import { useSession } from '../state/session.js';
 import { allowanceToday } from '../agent/spending.js';
 import { isAuto, workerModel } from '../agent/auto.js';
 import { isDirectService, CUSTOM_SERVICE_ID } from '../providers/direct-services.js';
+import { hasCredentials } from '../providers/index.js';
 export function shortModelName(model) {
     const short = model.split('/').pop();
     return short && short.length > 0 ? short : model;
@@ -14,6 +15,8 @@ const money = (value) => `$${value.toFixed(2)}`;
 // and on the right what today has cost and what is left - or, for a flat-rate
 // plan, whether it has allowance. Warnings appear only when they matter.
 export function footerSegments(info) {
+    if (info.connected === false)
+        return [{ text: `not connected - ${info.connectHint ?? 'type /keys to connect'}`, color: 'yellow' }];
     const busy = info.busyNote ?? (info.tidying ? 'tidying up…' : null);
     const direct = isDirectService(info.providerId);
     if (busy && info.providerId !== 'openrouter' && !direct)
@@ -72,11 +75,13 @@ export function Footer() {
         providerId: s.providerId,
         allowance: allowanceToday(),
         tidying: s.tidying,
-        busyNote: s.busyNote,
+        busyNote: s.busyNote ?? (s.thinkingSince !== null ? 'thinking…' : null),
         todaySpend: s.todaySpend,
         creditRemaining: s.creditRemaining,
         creditIsAccount: s.creditIsAccount,
         planResetAt: s.planResetAt,
+        // Whether a service is set up at all - not the brief "disconnected" of an internet drop.
+        connected: hasCredentials(),
     });
     const rightWidth = segments.reduce((sum, segment) => sum + segment.text.length, 0) + 3 * (segments.length - 1);
     // In Auto mode the bar names the model actually working: "auto · deepseek-v4-flash-0731".