awel 0.1.0 → 0.1.2

package/README.md

@@ -1,5 +1,7 @@
 # Awel
 
+English | [中文](./README.zh-CN.md)
+
 AI-powered development overlay for Next.js. Awel runs a proxy in front of your dev server, injects a floating chat button into your app, and lets you talk to an AI agent that can read, write, and edit files in your project — all from an embedded dashboard.
 
 ![Awel dashboard overlay](docs/screenshot.png)
@@ -10,9 +12,17 @@ AI-powered development overlay for Next.js. Awel runs a proxy in front of your d
 # Skip if you're already in a Next.js app
 npx create-next-app@latest my-app && cd my-app
 
+# Set up at least one AI provider (pick one):
+export ANTHROPIC_API_KEY="sk-ant-..."   # Anthropic API
+export OPENAI_API_KEY="sk-..."          # OpenAI
+export GOOGLE_GENERATIVE_AI_API_KEY="..." # Google AI
+# Or install the Claude CLI: https://docs.anthropic.com/en/docs/claude-code
+
 npx awel dev
 ```
 
+Awel needs at least one configured provider to function. See [Supported Models](#supported-models) for the full list.
+
 This starts Awel on port 3001 and proxies your Next.js dev server on port 3000. Open `http://localhost:3001` to see your app with the Awel overlay.
 
 ### Options
@@ -71,6 +81,13 @@ The AI agent has access to:
 ## Features
 
 - **Element inspector** — click the crosshair icon to select an element in your app and attach it as context to your prompt
+
+  ![Element inspector](docs/Screenshot-Inspector.png)
+
+- **Screenshot annotator** — annotate screenshots with shapes, arrows, and text before sending to the agent
+
+  ![Screenshot annotator](docs/Screenshot-annotator.png)
+
 - **Image attachments** — attach screenshots or reference images
 - **Plan approval** — the agent can propose plans for you to review before making changes
 - **Undo** — roll back all file changes from an agent session in one click

package/README.zh-CN.md

@@ -0,0 +1,115 @@
+# Awel
+
+[English](./README.md) | 中文
+
+为 Next.js 打造的 AI 开发助手。Awel 在你的开发服务器前运行一个代理，向页面注入一个悬浮聊天按钮，让你通过内嵌的面板与 AI 智能体对话——它可以读取、编写和编辑项目中的文件。
+
+![Awel 面板](docs/screenshot.png)
+
+## 快速开始
+
+```bash
+# 如果你已经在一个 Next.js 项目中，可以跳过这一步
+npx create-next-app@latest my-app && cd my-app
+
+# 至少配置一个 AI 服务商（任选其一）：
+export ANTHROPIC_API_KEY="sk-ant-..."   # Anthropic API
+export OPENAI_API_KEY="sk-..."          # OpenAI
+export GOOGLE_GENERATIVE_AI_API_KEY="..." # Google AI
+# 或安装 Claude CLI：https://docs.anthropic.com/en/docs/claude-code
+
+npx awel dev
+```
+
+Awel 需要至少一个已配置的服务商才能运行。完整列表见[支持的模型](#支持的模型)。
+
+Awel 会在端口 3001 启动，并代理运行在端口 3000 的 Next.js 开发服务器。打开 `http://localhost:3001` 即可看到带有 Awel 浮层的应用。
+
+### 选项
+
+```
+awel dev [options]
+
+  -p, --port <port>    目标应用端口（默认：3000）
+  -v, --verbose        将 LLM 流式事件输出到 stderr
+```
+
+## 工作原理
+
+Awel 位于浏览器和开发服务器之间：
+
+```
+浏览器 → Awel（代理 :3001）→ 你的应用（开发服务器 :3000）
+```
+
+1. Awel 拦截 HTML 响应，注入一段脚本
+2. 脚本在页面右下角渲染一个悬浮按钮（通过 Shadow DOM 隔离）
+3. 点击按钮会打开一个全屏聊天面板（iframe）
+4. 描述你的需求——AI 智能体会读取代码、进行编辑、执行命令，并实时流式返回结果
+
+HMR / WebSocket 流量会透明代理，在智能体编辑文件期间暂停，以防止热重载干扰。
+
+## 支持的模型
+
+Awel 使用 [Vercel AI SDK](https://sdk.vercel.ai)，支持多个服务商。设置对应的环境变量即可启用：
+
+| 服务商 | 环境变量 | 示例模型 |
+|--------|----------|----------|
+| Claude Code | PATH 中有 Claude CLI | sonnet, opus, haiku |
+| Anthropic API | `ANTHROPIC_API_KEY` | claude-sonnet-4-5, claude-opus-4-5 |
+| OpenAI | `OPENAI_API_KEY` | gpt-5.2-codex, gpt-5.1-codex |
+| Google AI | `GOOGLE_GENERATIVE_AI_API_KEY` | gemini-3-pro-preview, gemini-2.5-pro |
+| 通义千问 | `DASHSCOPE_API_KEY` | qwen-max, qwen-plus-latest |
+| MiniMax | `MINIMAX_API_KEY` | MiniMax-M2 |
+| Vercel Gateway | `AI_GATEWAY_API_KEY` | 通过网关访问多种模型 |
+
+可随时在面板顶部的下拉菜单中切换模型。
+
+## 智能体工具
+
+AI 智能体可使用以下工具：
+
+- **Read** / **Write** / **Edit** / **MultiEdit** — 文件操作
+- **Bash** — 执行 Shell 命令
+- **Glob** / **Grep** / **CodeSearch** — 查找文件和搜索代码
+- **WebSearch** / **WebFetch** — 网络搜索
+- **ProposePlan** — 提出多步骤实施计划，等待你审批后再执行
+- **AskUser** — 在执行过程中向你提问
+- **RestartDevServer** — 配置变更后重启开发服务器
+- **TodoRead** / **TodoWrite** — 跨对话的任务管理
+
+## 功能特性
+
+- **元素检查器** — 点击十字准星图标，在应用中选择一个元素，自动作为上下文附加到提示中
+
+  ![元素检查器](docs/Screenshot-Inspector.png)
+
+- **截图标注** — 用图形、箭头和文字标注截图后发送给智能体
+
+  ![截图标注](docs/Screenshot-annotator.png)
+
+- **图片附件** — 附加截图或参考图片
+- **计划审批** — 智能体可以提出计划，由你审核后再执行变更
+- **撤销** — 一键回滚整个智能体会话的所有文件变更
+- **Diff 审查** — 在接受变更前查看所有文件修改的摘要
+- **深色模式** — 跟随系统偏好
+- **国际化** — 支持英文和中文
+
+## 开发
+
+```bash
+npm run build           # 构建所有模块
+npm run dev             # 监听模式（仅 CLI）
+```
+
+单独构建：
+
+```bash
+npm run build:cli       # TypeScript → dist/cli/
+npm run build:dashboard # Vite → dist/dashboard/
+npm run build:host      # esbuild → dist/host/host.js
+```
+
+## 许可证
+
+MIT

package/dist/cli/agent.js

@@ -164,6 +164,13 @@ export function createAgentRoute(projectCwd, targetPort) {
                     appendUserMessage(userContent);
                     appendResponseMessages(responseMessages);
                 }
+            })
+                .catch((err) => {
+                // Swallow provider-level rejections (e.g. API 400 from tool-use
+                // concurrency in Claude Code). The error has already been surfaced
+                // as an SSE error event inside streamResponse.
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`[awel] streamResponse rejected: ${msg}`);
             })
                 .finally(() => {
                 if (!signal.aborted) {
@@ -262,5 +269,9 @@ export function createAgentRoute(projectCwd, targetPort) {
     agent.get('/api/dev-server/status', (c) => {
         return c.json(getDevServerStatus());
     });
+    // ─── Project Info ───────────────────────────────────────
+    agent.get('/api/project-info', (c) => {
+        return c.json({ projectCwd });
+    });
     return agent;
 }

package/dist/cli/awel-config.d.ts

@@ -0,0 +1,6 @@
+export interface AwelConfig {
+    babelPlugin?: boolean;
+    onboarded?: boolean;
+}
+export declare function readAwelConfig(projectCwd: string): AwelConfig;
+export declare function writeAwelConfig(projectCwd: string, config: AwelConfig): void;

package/dist/cli/awel-config.js

@@ -0,0 +1,20 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+export function readAwelConfig(projectCwd) {
+    const configPath = join(projectCwd, '.awel', 'config.json');
+    if (!existsSync(configPath))
+        return {};
+    try {
+        return JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function writeAwelConfig(projectCwd, config) {
+    const dir = join(projectCwd, '.awel');
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(join(dir, 'config.json'), JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}

package/dist/cli/babel-setup.js

@@ -1,6 +1,7 @@
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { existsSync, readFileSync, writeFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
+import { readAwelConfig, writeAwelConfig } from './awel-config.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const BABEL_CONFIG_FILES = [
     'babel.config.js',
@@ -37,24 +38,6 @@ function findExistingBabelConfig(projectCwd) {
         return 'package.json';
     return null;
 }
-function readAwelConfig(projectCwd) {
-    const configPath = join(projectCwd, '.awel', 'config.json');
-    if (!existsSync(configPath))
-        return {};
-    try {
-        return JSON.parse(readFileSync(configPath, 'utf-8'));
-    }
-    catch {
-        return {};
-    }
-}
-function writeAwelConfig(projectCwd, config) {
-    const dir = join(projectCwd, '.awel');
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-    writeFileSync(join(dir, 'config.json'), JSON.stringify(config, null, 2) + '\n', 'utf-8');
-}
 // ANSI 256-color helpers — darker shades that stay visible on light backgrounds
 const bold = (s) => `\x1b[1m${s}\x1b[22m`;
 const dim = (s) => `\x1b[2m${s}\x1b[22m`;

package/dist/cli/comment-popup.js

@@ -1,15 +1,36 @@
 import { Hono } from 'hono';
-const commentPopupHtml = `<!DOCTYPE html>
-<html lang="en">
+const i18n = {
+    en: { placeholder: 'Describe what you want to change...', cancel: 'Cancel', send: 'Send' },
+    zh: { placeholder: '描述您想进行的更改...', cancel: '取消', send: '发送' },
+};
+function getCommentPopupHtml(lang, theme) {
+    const t = i18n[lang] ?? i18n.en;
+    const isDark = theme !== 'light';
+    return `<!DOCTYPE html>
+<html lang="en" data-theme="${isDark ? 'dark' : 'light'}">
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <style>
+  :root[data-theme="dark"] {
+    --bg: #18181b; --fg: #fafafa;
+    --title: #e4e4e7; --muted: #a1a1aa; --dim: #71717a; --sep: #52525b;
+    --input-bg: #09090b; --input-border: #27272a; --input-focus: #a1a1aa;
+    --btn-bg: #27272a; --btn-fg: #a1a1aa; --btn-hover-bg: #3f3f46; --btn-hover-fg: #fafafa;
+    --primary-bg: #fafafa; --primary-border: #fafafa; --primary-fg: #18181b; --primary-hover: #e4e4e7;
+  }
+  :root[data-theme="light"] {
+    --bg: #ffffff; --fg: #18181b;
+    --title: #27272a; --muted: #71717a; --dim: #a1a1aa; --sep: #d4d4d8;
+    --input-bg: #f4f4f5; --input-border: #d4d4d8; --input-focus: #71717a;
+    --btn-bg: #e4e4e7; --btn-fg: #71717a; --btn-hover-bg: #d4d4d8; --btn-hover-fg: #18181b;
+    --primary-bg: #18181b; --primary-border: #18181b; --primary-fg: #fafafa; --primary-hover: #27272a;
+  }
   * { box-sizing: border-box; margin: 0; padding: 0; }
   body {
     font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-    background: #18181b;
-    color: #fafafa;
+    background: var(--bg);
+    color: var(--fg);
     padding: 0 12px 12px;
     height: 100vh;
     display: flex;
@@ -30,7 +51,7 @@ const commentPopupHtml = `<!DOCTYPE html>
   .header-title {
     font-size: 12px;
     font-weight: 600;
-    color: #e4e4e7;
+    color: var(--title);
   }
   .element-info {
     margin-left: auto;
@@ -38,7 +59,7 @@ const commentPopupHtml = `<!DOCTYPE html>
     align-items: center;
     gap: 4px;
     font-size: 11px;
-    color: #a1a1aa;
+    color: var(--muted);
     overflow: hidden;
   }
   .element-name {
@@ -49,10 +70,10 @@ const commentPopupHtml = `<!DOCTYPE html>
     max-width: 100px;
   }
   .element-sep {
-    color: #52525b;
+    color: var(--sep);
   }
   .element-file {
-    color: #71717a;
+    color: var(--dim);
     font-family: ui-monospace, SFMono-Regular, monospace;
     font-size: 10px;
     white-space: nowrap;
@@ -63,10 +84,10 @@ const commentPopupHtml = `<!DOCTYPE html>
   textarea {
     flex: 1;
     width: 100%;
-    background: #09090b;
-    border: 1px solid #27272a;
+    background: var(--input-bg);
+    border: 1px solid var(--input-border);
     border-radius: 6px;
-    color: #fafafa;
+    color: var(--fg);
     font-family: inherit;
     font-size: 13px;
     padding: 8px 10px;
@@ -75,10 +96,10 @@ const commentPopupHtml = `<!DOCTYPE html>
     transition: border-color 0.15s ease;
   }
   textarea:focus {
-    border-color: #a1a1aa;
+    border-color: var(--input-focus);
   }
   textarea::placeholder {
-    color: #71717a;
+    color: var(--dim);
   }
   .buttons {
     display: flex;
@@ -92,26 +113,26 @@ const commentPopupHtml = `<!DOCTYPE html>
     font-weight: 500;
     padding: 6px 14px;
     border-radius: 6px;
-    border: 1px solid #27272a;
+    border: 1px solid var(--input-border);
     cursor: pointer;
     transition: all 0.15s ease;
   }
   button:active { transform: scale(0.97); }
   .btn-close {
-    background: #27272a;
-    color: #a1a1aa;
+    background: var(--btn-bg);
+    color: var(--btn-fg);
   }
   .btn-close:hover {
-    background: #3f3f46;
-    color: #fafafa;
+    background: var(--btn-hover-bg);
+    color: var(--btn-hover-fg);
   }
   .btn-submit {
-    background: #fafafa;
-    border-color: #fafafa;
-    color: #18181b;
+    background: var(--primary-bg);
+    border-color: var(--primary-border);
+    color: var(--primary-fg);
   }
   .btn-submit:hover {
-    background: #e4e4e7;
+    background: var(--primary-hover);
   }
   .btn-submit:disabled {
     opacity: 0.4;
@@ -135,10 +156,10 @@ const commentPopupHtml = `<!DOCTYPE html>
     </div>
     <div class="element-info" id="elementInfo"></div>
   </div>
-  <textarea id="comment" placeholder="Describe what you want to change..." autofocus></textarea>
+  <textarea id="comment" placeholder="${t.placeholder}" autofocus></textarea>
   <div class="buttons">
-    <button class="btn-close" id="closeBtn">Cancel</button>
-    <button class="btn-submit" id="submitBtn" disabled>Send<kbd id="shortcutHint"></kbd></button>
+    <button class="btn-close" id="closeBtn">${t.cancel}</button>
+    <button class="btn-submit" id="submitBtn" disabled>${t.send}<kbd id="shortcutHint"></kbd></button>
   </div>
   <script>
     const params = new URLSearchParams(window.location.search);
@@ -197,10 +218,13 @@ const commentPopupHtml = `<!DOCTYPE html>
   </script>
 </body>
 </html>`;
+}
 export function createCommentPopupRoute() {
     const app = new Hono();
     app.get('/_awel/comment-popup', (c) => {
-        return c.html(commentPopupHtml);
+        const lang = c.req.query('lang') ?? 'en';
+        const theme = c.req.query('theme') ?? 'dark';
+        return c.html(getCommentPopupHtml(lang, theme));
     });
     return app;
 }

package/dist/cli/index.js

@@ -3,6 +3,7 @@ import { startServer } from './server.js';
 import { AWEL_PORT, USER_APP_PORT } from './config.js';
 import { setVerbose } from './verbose.js';
 import { ensureBabelPlugin } from './babel-setup.js';
+import { ensureProvider } from './onboarding.js';
 import { awel } from './logger.js';
 import { spawnDevServer } from './subprocess.js';
 program
@@ -18,6 +19,7 @@ program
     const targetPort = parseInt(options.port, 10);
     if (options.verbose)
         setVerbose(true);
+    await ensureProvider(process.cwd());
     await ensureBabelPlugin(process.cwd());
     awel.log('🌟 Starting Awel...');
     awel.log(`   Target app port: ${targetPort}`);

package/dist/cli/onboarding.d.ts

@@ -0,0 +1 @@
+export declare function ensureProvider(projectCwd: string): Promise<void>;

package/dist/cli/onboarding.js

@@ -0,0 +1,58 @@
+import { readAwelConfig } from './awel-config.js';
+import { getAvailableProviders, PROVIDER_ENV_KEYS, PROVIDER_LABELS } from './providers/registry.js';
+import { awel } from './logger.js';
+function printSetupInstructions() {
+    awel.log('No LLM providers are configured.');
+    awel.log('Awel needs at least one AI provider to function.');
+    awel.log('');
+    awel.log('Set up a provider by exporting its API key:');
+    awel.log('');
+    // List all providers with their setup commands
+    for (const [provider, envKey] of Object.entries(PROVIDER_ENV_KEYS)) {
+        const label = PROVIDER_LABELS[provider] ?? provider;
+        awel.log(`  ${label}`);
+        awel.log(`  export ${envKey}="..."`);
+        awel.log('');
+    }
+    // Claude Code is special — no env var, needs CLI install
+    const label = PROVIDER_LABELS['claude-code'] ?? 'Claude Code';
+    awel.log(`  ${label}`);
+    awel.log('  Install the Claude CLI: https://docs.anthropic.com/en/docs/claude-code');
+    awel.log('');
+    awel.log('Then run `awel dev` again.');
+}
+export async function ensureProvider(projectCwd) {
+    const config = readAwelConfig(projectCwd);
+    const providers = getAvailableProviders();
+    const available = providers.filter(p => p.available);
+    const isFirstRun = !config.onboarded;
+    if (isFirstRun && available.length > 0) {
+        // First run with providers available — show welcome
+        awel.log('');
+        awel.log('Welcome to Awel!');
+        awel.log('AI-powered development overlay for Next.js');
+        awel.log('');
+        awel.log(`\u2714 ${available.length} provider${available.length === 1 ? '' : 's'} available:`);
+        for (const p of available) {
+            awel.log(`  \u25CF ${p.label}`);
+        }
+        awel.log('');
+        printSetupInstructions();
+        process.exit(1);
+    }
+    if (isFirstRun && available.length === 0) {
+        // First run with NO providers — show welcome + instructions, exit
+        awel.log('');
+        awel.log('Welcome to Awel!');
+        awel.log('AI-powered development overlay for Next.js');
+        awel.log('');
+        printSetupInstructions();
+        process.exit(1);
+    }
+    if (!isFirstRun && available.length === 0) {
+        // Subsequent run with NO providers — instructions only, exit
+        printSetupInstructions();
+        process.exit(1);
+    }
+    // Subsequent run with providers available — silent pass-through
+}

package/dist/cli/providers/registry.d.ts

@@ -1,5 +1,17 @@
 import type { StreamProvider, ModelDefinition } from './types.js';
 export declare const PROVIDER_ENV_KEYS: Record<string, string>;
+export declare const PROVIDER_LABELS: Record<string, string>;
+export interface ProviderAvailability {
+    provider: string;
+    label: string;
+    available: boolean;
+    envVar: string | null;
+}
+/**
+ * Returns deduplicated provider availability info.
+ * Checks each provider once (claude-code via binary check, others via env var).
+ */
+export declare function getAvailableProviders(): ProviderAvailability[];
 export declare function resolveProvider(modelId: string): {
     provider: StreamProvider;
     modelProvider: string;

package/dist/cli/providers/registry.js

@@ -59,6 +59,47 @@ function isClaudeBinaryAvailable() {
     }
     return _claudeBinaryAvailable;
 }
+// ─── Provider Availability ────────────────────────────────────
+export const PROVIDER_LABELS = {
+    'claude-code': 'Claude Code',
+    anthropic: 'Anthropic API',
+    openai: 'OpenAI',
+    'google-ai': 'Google AI',
+    'vercel-gateway': 'Vercel AI Gateway',
+    qwen: 'Qwen',
+    minimax: 'MiniMax',
+};
+/**
+ * Returns deduplicated provider availability info.
+ * Checks each provider once (claude-code via binary check, others via env var).
+ */
+export function getAvailableProviders() {
+    const seen = new Set();
+    const result = [];
+    for (const model of MODEL_CATALOG) {
+        if (seen.has(model.provider))
+            continue;
+        seen.add(model.provider);
+        const label = PROVIDER_LABELS[model.provider] ?? model.provider;
+        if (model.provider === 'claude-code') {
+            result.push({
+                provider: model.provider,
+                label,
+                available: isClaudeBinaryAvailable(),
+                envVar: null,
+            });
+            continue;
+        }
+        const envKey = PROVIDER_ENV_KEYS[model.provider];
+        result.push({
+            provider: model.provider,
+            label,
+            available: envKey ? !!process.env[envKey] : true,
+            envVar: envKey ?? null,
+        });
+    }
+    return result;
+}
 // ─── Provider Resolution ─────────────────────────────────────
 export function resolveProvider(modelId) {
     const model = MODEL_CATALOG.find(m => m.id === modelId);

package/dist/cli/providers/vercel.js

@@ -63,7 +63,10 @@ Inspector Context:
 - CRITICAL: Focus your changes on the specific selected tag, NOT the entire parent component. The rendered HTML attributes help you locate the exact JSX element in the source code.
 - Use the parent component source code only as context to find and modify the specific tag.
 - Prioritize addressing what the user sees: if props are undefined/null, investigate why.
-- Reference the specific line numbers from the context when making edits.`;
+- Reference the specific line numbers from the context when making edits.
+
+Language:
+- IMPORTANT: Always respond in the same language the user writes in. If the user writes in Chinese, respond in Chinese. If the user writes in English, respond in English. Match the user's language throughout the conversation.`;
 /** Detects files Claude Code uses for plan output (.claude/plans/*.md, plan.md) */
 function isPlanFile(filePath) {
     const normalized = filePath.replace(/\\/g, '/');
@@ -96,6 +99,7 @@ function createModel(modelId, providerType, cwd) {
             permissionMode: 'acceptEdits',
             streamingInput: 'always',
             maxTurns: 25,
+            appendSystemPrompt: 'IMPORTANT: Always respond in the same language the user writes in. If the user writes in Chinese, respond in Chinese. If the user writes in English, respond in English. Match the user\'s language throughout the conversation.',
         });
     }
     else if (providerType === 'anthropic') {
@@ -427,10 +431,20 @@ export function createVercelProvider(modelId, providerType) {
                     }
                 }
                 catch (err) {
-                    // Ignore abort errors from user-input pauses or external cancellation
+                    // Ignore abort errors from user-input pauses or external cancellation.
+                    // For other errors (e.g. transient API 400s from tool-use concurrency),
+                    // log and surface them as SSE error events instead of killing the stream.
                     const externallyAborted = config.signal?.aborted;
-                    if (!waitingForUserInput && !externallyAborted)
-                        throw err;
+                    if (!waitingForUserInput && !externallyAborted) {
+                        const errorMsg = err instanceof Error ? err.message : String(err);
+                        logEvent('error', `stream error (non-fatal): ${errorMsg}`);
+                        const errorData = JSON.stringify({
+                            type: 'error',
+                            message: errorMsg
+                        });
+                        addToHistory('error', errorData);
+                        await stream.writeSSE({ event: 'error', data: errorData });
+                    }
                 }
                 // Capture response messages for multi-turn accumulation.
                 // Skip only when externally aborted (new request cancelled this one).