@vietor/easy-agent 0.4.2 → 0.4.3

package/README.md

@@ -27,15 +27,25 @@ Create `~/.easy-agent.json` in your home directory:
 ```json
 {
   "llm": {
-    "baseUrl": "https://api.openai.com/v1",
+    "baseUrl": "https://api.deepseek.com/v1",
     "apiKey": "your-api-key",
-    "model": "gpt-4o"
+    "model": "deepseek-v4-flash"
   }
 }
 ```
 
 `llm.baseUrl`, `llm.apiKey`, and `llm.model` are all required. Point `baseUrl` at any OpenAI-compatible endpoint (OpenAI, Azure OpenAI, local servers, etc.) and set `model` to a model that endpoint serves.
 
+### Proxy
+
+The agent automatically routes HTTP requests through a proxy when the standard environment variables are set:
+
+- `HTTPS_PROXY` / `https_proxy` — proxy URL for HTTPS (preferred)
+- `HTTP_PROXY` / `http_proxy` — proxy URL for HTTP (fallback)
+- `NO_PROXY` / `no_proxy` — comma-separated hosts/domains to bypass the proxy
+
+No extra configuration is needed — just set the env vars before launching `easy-agent`.
+
 ### MCP servers (optional)
 
 Add an `mcpServers` map to expose external tools through the Model Context Protocol. Each entry is either a local process (stdio) or a remote endpoint (Streamable HTTP):
@@ -128,7 +138,7 @@ Type a prompt and press Enter. The agent streams its reply and calls tools as ne
 ## Build from source
 
 ```bash
-git clone <repo-url>
+git clone https://github.com/vietor/easy-agent.git
 cd easy-agent
 pnpm install
 pnpm build                 # build core → CLI

package/dist/cmds/builtin.js

@@ -3,7 +3,7 @@ export const exitCommand = {
     name: "exit",
     description: "Exit the conversation",
     async execute(ctx) {
-        ctx.session.local.set("exitRequested", true);
+        ctx.session.localStore.set("exitRequested", true);
     },
 };
 export const exportCommand = {

package/dist/main.js

@@ -1,7 +1,7 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { loadConfig } from "./config.js";
-import { tryLoadSkills, tryReadFileText, startSession, } from "@vietor/easy-agent-core";
+import { tryLoadSkills, tryReadFileText, createSession, } from "@vietor/easy-agent-core";
 import { builtinCommands } from "./cmds/builtin.js";
 import { startApp } from "./tui/App.js";
 const SYSTEM_PROMPT_BASE = [
@@ -27,7 +27,7 @@ export async function main() {
     const systemPrompt = [SYSTEM_PROMPT_BASE, globalPrompt, projectPrompt]
         .filter(Boolean)
         .join("\n\n=================\n\n");
-    const session = await startSession({
+    const session = await createSession({
         systemPrompt,
         llmConfig: config.llm,
         mcpServers: config.mcpServers,

package/dist/tui/App.js

@@ -12,20 +12,20 @@ import { compactDisplay } from "../util/format.js";
 const STREAM_FRAME_MS = 120;
 export function App({ session }) {
     const { exit } = useApp();
-    const version = useSyncExternalStore(session.subscribe, session.getSnapshot);
+    const view = useSyncExternalStore(session.subscribe, session.getSnapshot);
     const [runState, setRunState] = useState({ running: false, elapsed: 0, promptTokens: 0, completionTokens: 0 });
     const [streamingText, setStreamingText] = useState("");
     const streamingRef = useRef("");
     const renderTimerRef = useRef(undefined);
     const allCmds = useMemo(() => session.commandSchemas, [session]);
-    const pendingQuestion = useMemo(() => session.logEntries.find((e) => e.kind === "question" && e.answer === null), [session, version]);
+    const pendingQuestion = session.getPendingQuestion();
     useEffect(() => {
-        session.setCallbacks({
-            onStreaming: (text) => {
+        session.setRunHandler({
+            onStream: (text) => {
                 streamingRef.current = text;
                 scheduleStreamingRender();
             },
-            onRunStateChange: setRunState,
+            onState: setRunState,
         });
     }, []);
     const scheduleStreamingRender = () => {
@@ -54,12 +54,14 @@ export function App({ session }) {
     });
     async function handleCommand(name, args) {
         await session.executeCommand(name, args);
-        if (session.local.get("exitRequested"))
+        if (session.localStore.get("exitRequested"))
             exit();
     }
     async function handlePrompt(text) {
-        if (session.isCommand(text)) {
-            await handleCommand(text, "");
+        const [first, ...rest] = text.split(/\s+/);
+        if (first.startsWith("/") || session.isCommand(first)) {
+            const name = first.startsWith("/") ? first.slice(1) : first;
+            await handleCommand(name, rest.join(" "));
         }
         else {
             await session.startPrompt(text);
@@ -77,7 +79,7 @@ export function App({ session }) {
             runningView = (_jsx(Box, { marginTop: 1, paddingLeft: 1, children: _jsx(Spinner, { label: "thinking", elapsed: runState.elapsed, promptTokens: runState.promptTokens, completionTokens: runState.completionTokens }) }));
         }
     }
-    return (_jsxs(Box, { flexDirection: "column", minWidth: 80, children: [_jsx(AppHeader, {}), _jsx(LogList, { session: session }), session.todos.length > 0 ? _jsx(TodoView, { todos: session.todos }) : null, runningView, !runState.running ? (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Text, { dimColor: true, children: ["[CTX ", compactDisplay(session.contextTokens), "] \u00B7 ESC to stop \u00B7 type / for commands"] }), _jsx(PromptOrCommandInput, { commands: allCmds, onCommand: handleCommand, onPrompt: handlePrompt })] })) : null] }));
+    return (_jsxs(Box, { flexDirection: "column", minWidth: 80, children: [_jsx(AppHeader, {}), _jsx(LogList, { session: session }), view.todos.length > 0 ? _jsx(TodoView, { todos: view.todos }) : null, runningView, !runState.running ? (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Text, { dimColor: true, children: ["[CTX ", compactDisplay(session.contextTokens), "] \u00B7 ESC to stop \u00B7 type / for commands"] }), _jsx(PromptOrCommandInput, { commands: allCmds, onCommand: handleCommand, onPrompt: handlePrompt })] })) : null] }));
 }
 export function startApp(session) {
     process.stdout.write("");

package/dist/tui/LogList.js

@@ -3,7 +3,7 @@ import { memo, useSyncExternalStore } from "react";
 import { Box } from "ink";
 import { LogView } from "./LogView.js";
 export const LogList = memo(function LogList({ session }) {
-    useSyncExternalStore(session.subscribe, session.getSnapshot);
-    const entries = session.logEntries;
+    const view = useSyncExternalStore(session.subscribe, session.getSnapshot);
+    const entries = view.logEntries;
     return (_jsx(Box, { flexDirection: "column", paddingLeft: 1, paddingRight: 1, children: entries.map((entry, i) => (_jsx(LogView, { entry: entry }, i))) }));
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vietor/easy-agent",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "type": "module",
   "main": "dist/cli.js",
   "bin": {
@@ -22,7 +22,7 @@
     "react": "^19.2.7",
     "string-width": "^8.2.1",
     "zod": "^4.4.3",
-    "@vietor/easy-agent-core": "0.4.2"
+    "@vietor/easy-agent-core": "0.4.3"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",