@celljs/ta-web 0.0.0-stage → 4.6.1

package/README.md

@@ -1,3 +1,84 @@
-# Temporary Holding Version
+# Cell - Ta Web
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`ta serve` 自带的 Web 客户端：一个 Cell 前端组件（[@celljs/react](../../ui-packages/react/README.md)），状态全部来自 [@celljs/ta-client](../ta-client/README.md)，因此和桌面端、移动端共用同一套会话状态机。
+
+```bash
+ta serve --web     # 启动并在浏览器里打开，已带上 token
+```
+
+## 安装为应用（PWA）
+
+Web 客户端可以装成桌面或手机上的应用：Chrome / Edge 地址栏的安装图标或账号菜单里的"安装为应用"，iOS Safari 的"添加到主屏幕"。装好后在单独的窗口里打开，图标是 Cell 的小恐龙。
+
+- 文件在 `src/browser/public/`（`manifest.webmanifest`、`sw.js`、`icons/`），构建时放在站点根路径；清单与 Service Worker 只在安全上下文生效：本机（127.0.0.1、localhost）或 HTTPS，用 `--host` 经普通 HTTP 从别的机器访问时只是网页。
+- 应用记住的是地址（含端口）和 token，所以 ta serve 默认沿用上次的端口和 token（见 [@celljs/ta](../../apps/ta/README.md)）。
+- Service Worker 不缓存 `/api` 下的任何东西：页面走网络，失败时用上次的页面；`/assets/` 下带哈希的脚本先读缓存，页面换了新构建就清掉旧脚本。ta serve 没在运行时应用照样打开，提示"ta serve 没有在运行"，启动后自动连上。
+
+## 界面
+
+主框架是 IDE 式布局：最左侧是导航栏（logo 兼作侧栏开关、Web 扩展的页面，底部是齿轮和账号菜单），旁边是侧栏（可拖宽、可收起；顶部一排图标标签在 Web 扩展的侧栏视图和对话列表之间切换，标签右边是当前视图的搜索框和 +）（服务器上所有打开的会话，可新建、在指定目录新建、关闭），中间是当前对话，右侧是可收起的面板，放 Web 扩展的卡片。窄屏时导航栏和对话列表变成抽屉，面板浮在对话上方。
+
+一开始，界面上只有对话。你告诉 Ta 想让这个页面做什么、显示什么，Ta 就把它做成一个 pi 包——对话旁的卡片、单独的页面，或者 Ta 的新命令——做完立刻出现在页面上。
+
+界面上新增的一切都来自包里的 **Web 扩展**，和 pi 的扩展同一套机制、同一套叫法：
+
+- **包**就是 pi 的包。`package.json` 的 `pi` 里，`extensions` 是给 Ta（终端和服务端）的扩展，`web` 是给这个页面的扩展；没有声明时取 `web/` 目录下的模块。包放在 `~/.ta/agent/extensions/<名字>/`（项目的 `.ta/extensions/`）即可生效，也可以用 `ta install` 安装。
+- **Web 扩展**是一个不带 import 的 ES 模块，默认导出一个函数，页面用 `pi` 调用它；返回的函数在卸载时调用。`pi` 的接口照 pi 的 ExtensionAPI 命名：`ui.setWidget`（默认在输入框上方，和 pi 一样；`placement: 'panel'` 放进右侧工作台的卡片标签）、`registerView`（导航栏里的页面，或侧栏顶部的一个标签；`location: 'panel'` 是右侧工作台的工具）、`registerMessageRenderer`（显示 pi 扩展用 `sendMessage` 发出的自定义消息）、`registerTool`（页面打开的对话里由浏览器执行的工具）、`registerOpener`（打开回复里的链接：文件及其行、目录、网页，按注册顺序询问，返回 true 表示已打开）、`on`（当前对话的事件）、`sendUserMessage`（发到当前对话；`/命令` 会执行 pi 扩展的命令）、`switchSession`（把 ta serve 里另一个打开的会话显示为当前对话）、`callHost`（调用本包 `pi.host` 的方法，经 `callPackageHost`）、`reloadExtensions`（扩展自己安装、导入或移除了包之后，像回复结束时一样重新加载 Web 扩展和当前对话的 pi 扩展）、`ui.showView` / `ui.useView`（显示、查看任意扩展的视图）、`ui.Composer` / `ui.Markdown`（和对话一样的输入框与 Markdown）、`ui.Dialog`（盖住整页的弹窗）、`ui.openEditor` 的 `preview`（单击打开的预览标签，标题斜体，下一个预览会替换它，双击或 `ui.pinEditor` 固定）、`ui.setEditorDirty`（标签显示未保存圆点，关闭前确认）、`ui.useActiveEditor`（工作台当前标签）、`ui.DiffEditor`（Monaco 差异编辑器，并排或内联，可编辑右侧）、`ui.confirm` 的 `confirmLabel` / `danger`、视图的 `head`（自己的顶栏）、`ui.input` / `ui.editor`（向用户要一行或多行文字，取消时为 `undefined`）、页面的 `menu`（侧栏列出该页面时悬浮显示的 … 菜单）与 `pages`（侧栏列出的页面，导航栏不再单列）、`ui.notify`（页面右下角的通知）、`ui.confirm`（继续前先确认，返回用户是否同意）、`ui.theme`、`ui.language`，以及页面的 `React` 和 ta serve 的服务：`server`（会话，pi 的 RPC 命令）、`workspace`（目录里的文件与命令）、`terminals`（终端）、`packages`（包）（类型见 `WebExtensionAPI`）。
+- **用自然语言做包**：内置扩展 [@celljs/ta-extensions](../ta-extensions/README.md) 带技能 `ta-package`（终端里的 Ta 也有），并在导航栏加了"扩展"页（一句话做扩展、导出导入），写明了包的格式、Web 扩展接口和验证步骤。当前对话每次回复结束，页面重新读取 Web 扩展：新的加载、改过的重新加载、删掉的卸载；工具有变化时，用同一个会话文件重新打开这段对话（只限本页打开的对话），包有改动时让会话重新加载 pi 扩展。页面重新显示时也会检查一次（包也可能在终端里改）。
+- **稳定**：每个扩展注册的东西归它自己，卸载时一并撤掉；一个扩展加载失败或渲染出错，只在它自己的位置显示错误，不影响页面和其他扩展。
+
+**设置 → 更多 → 扩展**列出安装的扩展（每个是一个带 Web 扩展的包，可移除、重新加载）；**内置扩展**列出随 Ta 提供的包和 Web 扩展，可以在这里开关：
+
+- **我的分身**：一个可以用语音或文字交代事情的分身。主对话是一个普通的 Ta 会话，加了角色说明（`appendSystemPrompt`）和五个客户端工具（`start_task` 等）；每件事作为一个新会话在后台执行，结束后以 `<task_update>` 回报。形象就是 Cell logo 里的恐龙（`DinoAvatar`，与 `assets/logo.svg` 同一路径），只用眼神和小标记表示待命、在听、思考、干活、说话、需要你确认、完成、睡着。
+
+### 对话与输入框
+
+- **对话流**：一轮里连续的思考、工具调用和中途说明折成一行“已执行 N 步”：进行中展开、只显示最近几步，结束后收起（有失败的步骤时保持展开并标出），最后的正文是回复。布局是纯函数 `ProcessUtil`（`util/process.ts`）；每条用稳定的 key 并按条 memo，流式输出时只重绘变化的那条。
+- **输入框**：Enter 发送、Shift+Enter 换行，输入法合成期间的回车不发送；Ta 工作时 Enter 引导、Alt+Enter 排队追加、Esc 停止，发送与停止是同一个按钮。`/` 列出命令，`@` 按文件名查找并插入 `@路径`（服务端 `findFiles`，不支持时菜单里说明）；图片可粘贴、拖入或选择（PNG/JPEG/GIF/WebP，单张 5 MB、每条 8 张以内）；排队的消息显示在输入框上方，可撤回到输入框（`clearQueue`）。逻辑在 `ComposerUtil`（`util/composer.ts`）。
+- **头像**：`TaAvatar` 就是 Cell logo，`mark` 是 1~2 个字符的角标，用来区分智能体（Web 扩展里是 `pi.ui.Avatar`）；每轮回复开头放一个小头像（一轮一次）：工作中用眼神表示思考、执行或输出，最后一轮完成时眯眼带勾，出错时带提醒角标；空对话页是大号头像，会眨眼、不时看向输入框。减少动效时全部静止。
+- **状态与提示**：分四级（info / success / warning / error），每级有固定的图标和颜色，正文始终用正文色。按归属分三种：全局的**连接状态条**（主区顶部的胶囊，断线超过 1 秒才出现，显示原因、倒计时和“立即重试”，恢复后显示“已重新连接”2 秒）；**通知**（`TaNotices`，右下角、手机在顶部，success 3 秒、info 4 秒、warning 6 秒、error 8 秒，有按钮的多留 4 秒，悬停或聚焦时暂停计时，同一条重复出现时合并计数，最多 4 条）；**就地提示**（`Callout`，留在出事的位置，如一轮回复失败、扩展视图出错、token 被拒绝）。操作失败（发送、切换模型、打开对话等）统一用 `notices.error`：服务端带 `hint` 的错误把建议放第二行，断线导致的失败合并成一条“没有完成：ta serve 未连接”。需要用户确认的操作用 `notices.confirm`，不可撤销的操作按钮为红色、默认焦点在“取消”。
+- **链接**：回复里的链接都可以点（`TaLinks`，解析在 `LinkUtil`）。网页链接、正文里的裸 URL 和 `<URL>` 默认在右侧工作台的浏览器里打开，Cmd/Ctrl + 点击（或中键）在系统浏览器里打开；文件路径（`[说明](src/a.ts#L10-L20)`、`src/a.ts:10:5`、`file://` 地址，以及写成行内代码的 `src/a.ts:12`、`package.json`）按对话目录解析，在工作台打开并定位、选中对应行列（写法同 VS Code：`#L10`、`#L10C5-L12C3`、`:10:5`、`:10-20`）；目录（`docs/`）在资源管理器里切到该目录。打开动作由 Web 扩展提供（`registerOpener`，内置的 @celljs/ta-workspace 负责文件、目录和内置浏览器）。安全上照 VS Code 的做法：只认 http(s)、mailto 和路径，`javascript:`、`data:`、`command:` 等其他协议一律当普通文本；渲染结果是 React 元素而不是 HTML；路径先经服务端确认存在，读写仍受执行环境约束；在系统浏览器打开前会弹窗显示完整地址并突出域名（外观相近的域名按浏览器的 punycode 显示），可复制、打开或信任该域名，本机地址（localhost、127.0.0.1、ta serve 所在主机）和 **设置 → 链接 → 受信任的域名**（`github.com`、`*.github.com`、`localhost:3000`、`*`）里的不再询问；新窗口一律 `noopener,noreferrer`。内置浏览器里，与 Ta 页面同源的地址不给 `allow-same-origin`，碰不到页面和 token。
+- **账号菜单**：导航栏底部的圆形头像（`AccountMenu`），右下角的点是连接状态；菜单里是服务器与版本、安装为应用（浏览器支持时）和退出登录。
+
+### 设置
+
+头像上方的齿轮（`ManageMenu`）是两层菜单：设置（⌘/Ctrl+,）、扩展、键盘快捷方式，主题和语言在右侧展开第二层，最后是关于 ta。设置是主区域的一个视图（`SettingsView`，打开时占用对话和工作台的位置，Esc 或 × 关闭），左侧是两层目录（界面 / ta / 更多，下面是各分组，滚动时跟随高亮），右侧是分组卡片，顶部搜索按每一行的名称和说明过滤：
+
+- **界面**：主题、减少动效、界面语言、朗读回复；存在服务器上的用户数据里（`TaSettings`），换浏览器、换设备都一样。
+- **ta**：ta 本身的设置，读写 pi 的 `settings.json`（服务端 `getSettings` / `updateSettings`，可改的键见 ta-protocol 的 `TA_SETTINGS`）：默认模型、思考强度、传输方式、引导与排队消息的送达方式、自动压缩与重试、代码模式、技能命令、Shell 与命令前缀、图片。顶部切换**用户**（agent 目录，对所有项目生效）和**项目**（当前对话目录下的 `.ta/settings.json`，覆盖用户设置）；没设置的项显示继承来的值（"默认（…）"或"沿用用户设置（…）"），在当前层设置过的项左侧有蓝条，悬停出现重置。项目未被信任时只读并说明原因。
+- **更多**：扩展、内置扩展、键盘快捷方式、关于（版本、目录、退出登录）。
+
+## 结构
+
+| | |
+| --- | --- |
+| `TaWorkbench`（`TaWorkbenchImpl`） | 一条连接和服务器上打开的会话；token 取自 URL 片段或 localStorage；连不上时先探测服务器：有回应是 token 不对（回到登录页），没回应是 ta serve 没在运行（保留 token，提示后自动重试） |
+| `TaPwa`（`TaPwaImpl`） | 把页面做成可安装的应用：链接清单和图标、注册 Service Worker、在账号菜单里提供"安装为应用"（浏览器给出安装提示时） |
+| `TaWebExtensions`（`TaWebExtensionsImpl`） | 加载、重新加载、卸载 Web 扩展，汇总它们注册的页面、卡片、消息渲染器和工具 |
+| `BuiltinWebExtension` | 内置 Web 扩展的扩展点：`AssistantWebExtension`（分身） |
+| `TaChat`（`TaChatImpl`） | 当前对话：新建、切换、关闭；打开的会话带上 Web 扩展的工具，回复结束后重新加载扩展；记住上次的会话文件和新对话目录（用户级） |
+| `TaAssistant`（`TaAssistantImpl`） | 分身：主对话、任务与派发任务的客户端工具；会话文件与任务列表是用户级状态，换浏览器还是同一个分身 |
+| `TaState`（`TaStateImpl`） | 界面状态按级别保存，见下文“界面状态” |
+| `TaSettings`（`TaSettingsImpl`） | 主题、语言、朗读、减少动效、打开的内置扩展；语言经 @celljs/widget 的 `LocaleManager` 切换 |
+| `TaNotices`（`TaNoticesImpl`） | 页面的通知与确认框：Ta 自身和 Web 扩展共用 |
+| `TaAppPage` | `@View` 注册的首页（`AppView`） |
+
+服务端（[@celljs/ta-host](../ta-host/README.md)）为此加了 `getSettings` / `updateSettings`（ta 的设置），以及三个方法：`listWebExtensions`、`readWebExtension`、`removeWebExtension`，按 pi 加载包的方式（`packages` 设置与 `extensions/` 目录，项目的只在受信任时）找到 Web 扩展；以及与 pi `/reload` 相同的 `reload`。
+
+## 界面状态
+
+界面上要在刷新后留下来的东西，按“谁应该再看到它”分级，由 `TaState` 统一保存（组件里用 `usePersisted(spec)`，`spec` 写明键、级别、初始值和读回时的校验）：
+
+| 级别 | 存在哪里 | 用于 |
+| --- | --- | --- |
+| `tab` | 本标签页的 sessionStorage | 当前页面、侧栏标签：两个标签页可以各看各的 |
+| `device` | 本浏览器的 localStorage | 各栏宽度与收起、右侧工作台是否打开：跟着屏幕走 |
+| `user` | 服务器上 `@celljs/ta-web` 这个包的数据（`getExtensionData`），浏览器另存一份 | 设置、上次的对话、新对话目录、分身的会话与任务、工作台打开的工具：换浏览器、换设备都一样 |
+
+`user` 级先用浏览器里的副本（首屏不闪），再读服务器，服务器的值不同就更新；改动约 300 ms 后合并写入，页面隐藏或关闭时立即写，断线期间的改动在重连后补写，其他浏览器的改动经 `onExtensionData` 推送过来。读回时本页已改过的值不会被覆盖，浏览器之间以最后写入为准。旧版本只存在浏览器里的值第一次读到时会搬到服务器。
+
+属于某个目录的状态（资源管理器展开的文件夹）由显示它的 Web 扩展用 `pi.storage.directory(cwd)` 保存；服务器按目录（连同执行环境，`ta serve --exec` 时远程机器上的同名目录是另一个）分文件存放。打开的文件由 @celljs/ta-workspace 自己记在 `pi.storage` 里，加载时用 `openEditor(editor, { preserveFocus: true })` 在后台重新打开，不会弹出工作台。
+
+token 是登录凭据，不算界面状态，仍由 `TaWorkbench` 存在 localStorage（安装成应用后在自己的窗口里也能登录）。
+
+要加一个内置 Web 扩展，写一个 `@Component(BuiltinWebExtension)`；要替换整个界面，用 `@View({ index: true, component: MyView }, true)` 重新绑定首页。

package/esm/browser/assistant/assistant-export.d.ts

@@ -0,0 +1,13 @@
+import type { SessionMessage } from '@celljs/ta-client';
+import type { AssistantTask } from './assistant-protocol.js';
+export interface ExportLabels {
+    user: string;
+    /** The name of the double. */
+    ta: string;
+    task: string;
+    status(status: AssistantTask['status']): string;
+}
+export declare namespace AssistantExport {
+    /** The conversation with the double as Markdown: what the user and the double said, and how the tasks ended; undefined when the double has said nothing yet. */
+    function markdown(messages: readonly SessionMessage[], labels: ExportLabels): string | undefined;
+}

package/esm/browser/assistant/assistant-export.js

@@ -0,0 +1,33 @@
+import { MessageUtil } from '../util/message.js';
+/** A message of how a task ended, which the double gets from its tasks (assistant.ts). */
+const TASK_UPDATE = /^<task_update id="[^"]+" title="([^"]*)" status="(\w+)">\n?([\s\S]*?)\n?<\/task_update>$/;
+export var AssistantExport;
+(function (AssistantExport) {
+    /** The conversation with the double as Markdown: what the user and the double said, and how the tasks ended; undefined when the double has said nothing yet. */
+    function markdown(messages, labels) {
+        if (!messages.some(message => message.role === 'assistant')) {
+            return undefined;
+        }
+        const parts = [`# ${labels.ta}`];
+        for (const message of messages) {
+            if (message.role !== 'user' && message.role !== 'assistant') {
+                continue;
+            }
+            const text = MessageUtil.text(MessageUtil.blocks(message)).trim();
+            if (!text) {
+                continue;
+            }
+            const update = message.role === 'user' ? TASK_UPDATE.exec(text) : null;
+            if (update) {
+                const [, title, status, result] = update;
+                parts.push('', `## ${labels.task} · ${title} · ${labels.status(status)}`, '', result.trim());
+            }
+            else {
+                parts.push('', `## ${message.role === 'user' ? labels.user : labels.ta}`, '', text);
+            }
+        }
+        return `${parts.join('\n')}\n`;
+    }
+    AssistantExport.markdown = markdown;
+})(AssistantExport || (AssistantExport = {}));
+//# sourceMappingURL=assistant-export.js.map

package/esm/browser/assistant/assistant-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-export.js","sourceRoot":"","sources":["../../../src/browser/assistant/assistant-export.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,0FAA0F;AAC1F,MAAM,WAAW,GAAG,0FAA0F,CAAC;AAU/G,MAAM,KAAW,eAAe,CAyB/B;AAzBD,WAAiB,eAAe;IAC5B,gKAAgK;IAChK,SAAgB,QAAQ,CAAC,QAAmC,EAAE,MAAoB;QAC9E,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,CAAC;YAC1D,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACjC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC1D,SAAS;YACb,CAAC;YACD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAClE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACR,SAAS;YACb,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACvE,IAAI,MAAM,EAAE,CAAC;gBACT,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,MAAM,CAAC,IAAI,MAAM,KAAK,MAAM,MAAM,CAAC,MAAM,CAAC,MAAiC,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5H,CAAC;iBAAM,CAAC;gBACJ,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;YACxF,CAAC;QACL,CAAC;QACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACnC,CAAC;IAtBe,gBAAA,QAAQ,WAsBvB,CAAA;AACL,CAAC,EAzBgB,eAAe,KAAf,eAAe,QAyB/B"}

package/esm/browser/assistant/assistant-extension.d.ts

@@ -0,0 +1,20 @@
+import type { WebExtensionAPI, WebExtensionFactory, WebMenuItem } from '../extension/web-extension-api.js';
+import { BuiltinWebExtension } from '../extension/web-extension-protocol.js';
+import { TaState } from '../state/state-protocol.js';
+import { TaWorkbench } from '../workbench-protocol.js';
+import { TaAssistant } from './assistant-protocol.js';
+/**
+ * The double, as a built-in web extension: a page of its own, with a … where the side bar lists it.
+ * Its tasks are a tool of the workbench on the right, and each task opens there as a tab.
+ */
+export declare class AssistantWebExtension implements BuiltinWebExtension {
+    readonly name = "assistant";
+    readonly title = "ta.builtin.assistant";
+    readonly description = "ta.builtin.assistantHint";
+    protected readonly assistant: TaAssistant;
+    protected readonly persisted: TaState;
+    protected readonly workbench: TaWorkbench;
+    readonly activate: WebExtensionFactory;
+    /** The … of the page: stop, start over; its name, its system prompt, its directory; the conversation as a file. */
+    protected menu(pi: WebExtensionAPI): WebMenuItem[][];
+}

package/esm/browser/assistant/assistant-extension.js

@@ -0,0 +1,153 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Autowired, Component } from '@celljs/core';
+import { Bot, Copy, Download, ListTodo, Pencil, RotateCcw, ScrollText, Square } from 'lucide-react';
+import * as React from 'react';
+import { BuiltinWebExtension } from '../extension/web-extension-protocol.js';
+import { message } from '../i18n/messages.js';
+import { TaState } from '../state/state-protocol.js';
+import { TaWorkbench } from '../workbench-protocol.js';
+import { AssistantExport } from './assistant-export.js';
+import { TaAssistant } from './assistant-protocol.js';
+import { ASSISTANT_NAME, ASSISTANT_TASKS_VIEW, AssistantPanel, AssistantTasks, AssistantTaskView } from './assistant-view.js';
+function download(name, text) {
+    const url = URL.createObjectURL(new Blob([text], { type: 'text/markdown;charset=utf-8' }));
+    const link = document.createElement('a');
+    link.href = url;
+    link.download = name;
+    link.click();
+    setTimeout(() => URL.revokeObjectURL(url), 1000);
+}
+/**
+ * The double, as a built-in web extension: a page of its own, with a … where the side bar lists it.
+ * Its tasks are a tool of the workbench on the right, and each task opens there as a tab.
+ */
+let AssistantWebExtension = class AssistantWebExtension {
+    constructor() {
+        this.name = ASSISTANT_NAME;
+        this.title = 'ta.builtin.assistant';
+        this.description = 'ta.builtin.assistantHint';
+        this.activate = pi => {
+            const openTask = (task) => pi.ui.openEditor({
+                id: `${ASSISTANT_NAME}:task:${task.id}`,
+                title: task.title,
+                icon: ListTodo,
+                render: () => React.createElement(AssistantTaskView, { taskId: task.id }),
+            });
+            const registerPage = () => pi.registerView('assistant', {
+                title: () => this.assistant.name || message(pi.ui.language, 'ta.builtin.assistant'),
+                icon: Bot,
+                render: () => React.createElement(AssistantPanel, { onTask: openTask }),
+                menu: () => this.menu(pi),
+            });
+            registerPage();
+            pi.registerView(ASSISTANT_TASKS_VIEW, {
+                title: () => message(pi.ui.language, 'ta.assistant.tasksTool'),
+                icon: ListTodo,
+                location: 'panel',
+                render: () => React.createElement(AssistantTasks, { onOpen: openTask }),
+            });
+            // Its title is its name: the lists that show the page read it again when it is registered again.
+            let name = this.assistant.name;
+            return this.persisted.subscribe(() => {
+                if (this.assistant.name !== name) {
+                    name = this.assistant.name;
+                    registerPage();
+                }
+            });
+        };
+    }
+    /** The … of the page: stop, start over; its name, its system prompt, its directory; the conversation as a file. */
+    menu(pi) {
+        var _a;
+        const t = (id) => message(pi.ui.language, id);
+        const store = this.assistant.store();
+        const cwd = (_a = this.workbench.state.server) === null || _a === void 0 ? void 0 : _a.cwd;
+        const title = () => this.assistant.name || t('ta.builtin.assistant');
+        const act = (action) => () => {
+            Promise.resolve()
+                .then(action)
+                .catch(error => pi.ui.notify(error instanceof Error ? error.message : String(error), 'error'));
+        };
+        const stop = act(() => this.assistant.stop());
+        const restart = act(async () => {
+            if (await pi.ui.confirm(t('ta.assistant.restartTitle'), t('ta.assistant.restartHint'))) {
+                await this.assistant.restart();
+            }
+        });
+        const rename = act(async () => {
+            const name = await pi.ui.input(t('ta.assistant.rename'), t('ta.builtin.assistant'), { value: title() });
+            if (name !== undefined) {
+                this.assistant.rename(name.trim() === t('ta.builtin.assistant') ? '' : name);
+            }
+        });
+        const editPrompt = act(async () => {
+            var _a;
+            // The prompt is set when the conversation opens: it opens again, which would cut a run short.
+            if ((_a = this.assistant.store()) === null || _a === void 0 ? void 0 : _a.state.working) {
+                pi.ui.notify(t('ta.assistant.busy'), 'warning');
+                return;
+            }
+            const prompt = await pi.ui.editor(t('ta.assistant.promptTitle'), this.assistant.prompt);
+            if (prompt !== undefined) {
+                await this.assistant.setPrompt(prompt);
+            }
+        });
+        const copyCwd = act(async () => {
+            await navigator.clipboard.writeText(cwd !== null && cwd !== void 0 ? cwd : '');
+            pi.ui.notify(t('ta.assistant.copied').replace('{path}', cwd !== null && cwd !== void 0 ? cwd : ''), 'info');
+        });
+        const exportMarkdown = act(() => {
+            var _a;
+            var _b;
+            const text = AssistantExport.markdown((_b = (_a = this.assistant.store()) === null || _a === void 0 ? void 0 : _a.state.messages) !== null && _b !== void 0 ? _b : [], {
+                user: t('ta.assistant.you'),
+                ta: title(),
+                task: t('ta.assistant.tasks'),
+                status: status => t(`ta.task.${status}`),
+            });
+            if (text) {
+                download(`${title()}.md`, text);
+            }
+            else {
+                pi.ui.notify(t('ta.assistant.nothingToExport'), 'info');
+            }
+        });
+        return [
+            [
+                { key: 'stop', label: t('ta.assistant.stop'), icon: Square, disabled: !(store === null || store === void 0 ? void 0 : store.state.working), run: stop },
+                { key: 'restart', label: t('ta.assistant.restart'), icon: RotateCcw, disabled: !store, run: restart },
+            ],
+            [
+                { key: 'rename', label: t('ta.assistant.rename'), icon: Pencil, run: rename },
+                { key: 'prompt', label: t('ta.assistant.prompt'), icon: ScrollText, run: editPrompt },
+                { key: 'copyCwd', label: t('ta.assistant.copyCwd'), icon: Copy, disabled: !cwd, run: copyCwd },
+            ],
+            [{ key: 'export', label: t('ta.assistant.export'), icon: Download, run: exportMarkdown }],
+        ];
+    }
+};
+__decorate([
+    Autowired(TaAssistant),
+    __metadata("design:type", Object)
+], AssistantWebExtension.prototype, "assistant", void 0);
+__decorate([
+    Autowired(TaState),
+    __metadata("design:type", Object)
+], AssistantWebExtension.prototype, "persisted", void 0);
+__decorate([
+    Autowired(TaWorkbench),
+    __metadata("design:type", Object)
+], AssistantWebExtension.prototype, "workbench", void 0);
+AssistantWebExtension = __decorate([
+    Component(BuiltinWebExtension)
+], AssistantWebExtension);
+export { AssistantWebExtension };
+//# sourceMappingURL=assistant-extension.js.map

package/esm/browser/assistant/assistant-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-extension.js","sourceRoot":"","sources":["../../../src/browser/assistant/assistant-extension.ts"],"names":[],"mappings":"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"}

package/esm/browser/assistant/assistant-hooks.d.ts

@@ -0,0 +1,8 @@
+import type { SessionState } from '@celljs/ta-client';
+import { type AssistantState, type AssistantTask, TaAssistant } from './assistant-protocol.js';
+export declare function useAssistant(): [AssistantState, TaAssistant];
+/** The state of every task's session: tasks come and go, so this follows their stores by hand. */
+export declare function useTaskStates(assistant: TaAssistant, tasks: AssistantTask[]): Map<string, SessionState>;
+export declare function useNow(intervalMs: number): number;
+/** When the user last touched the page: ta dozes off when left alone. */
+export declare function useLastActive(): number;

package/esm/browser/assistant/assistant-hooks.js

@@ -0,0 +1,55 @@
+import { useInject } from '@celljs/react';
+import * as React from 'react';
+import { TaAssistant } from './assistant-protocol.js';
+// The state of the double for its views: the assistant, its tasks, the time.
+export function useAssistant() {
+    const assistant = useInject(TaAssistant);
+    const state = React.useSyncExternalStore(listener => assistant.subscribe(listener), () => assistant.state);
+    return [state, assistant];
+}
+/** The state of every task's session: tasks come and go, so this follows their stores by hand. */
+export function useTaskStates(assistant, tasks) {
+    const [states, setStates] = React.useState(() => new Map());
+    const ids = tasks.map(task => task.id).join(',');
+    // biome-ignore lint/correctness/useExhaustiveDependencies: follows the set of tasks, by id
+    React.useEffect(() => {
+        const stops = tasks.flatMap(task => {
+            const store = assistant.taskStore(task.id);
+            if (!store) {
+                return [];
+            }
+            const set = (state) => setStates(previous => new Map(previous).set(task.id, state));
+            set(store.state);
+            return [store.subscribe(set)];
+        });
+        return () => {
+            for (const stop of stops) {
+                stop();
+            }
+        };
+    }, [assistant, ids]);
+    return states;
+}
+export function useNow(intervalMs) {
+    const [now, setNow] = React.useState(Date.now());
+    React.useEffect(() => {
+        const timer = setInterval(() => setNow(Date.now()), intervalMs);
+        return () => clearInterval(timer);
+    }, [intervalMs]);
+    return now;
+}
+/** When the user last touched the page: ta dozes off when left alone. */
+export function useLastActive() {
+    const [lastActive, setLastActive] = React.useState(Date.now());
+    React.useEffect(() => {
+        const active = () => setLastActive(Date.now());
+        window.addEventListener('pointerdown', active);
+        window.addEventListener('keydown', active);
+        return () => {
+            window.removeEventListener('pointerdown', active);
+            window.removeEventListener('keydown', active);
+        };
+    }, []);
+    return lastActive;
+}
+//# sourceMappingURL=assistant-hooks.js.map

package/esm/browser/assistant/assistant-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-hooks.js","sourceRoot":"","sources":["../../../src/browser/assistant/assistant-hooks.ts"],"names":[],"mappings":"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"}

package/esm/browser/assistant/assistant-protocol.d.ts

@@ -0,0 +1,51 @@
+import type { SessionStore } from '@celljs/ta-client';
+export declare const TaAssistant: unique symbol;
+export interface AssistantTask {
+    /** Short, for the model: `t1`, `t2`, … */
+    id: string;
+    title: string;
+    sessionId: string;
+    sessionFile?: string;
+    cwd: string;
+    status: 'running' | 'done' | 'failed' | 'stopped';
+    startedAt: number;
+    endedAt?: number;
+    /** The last words of the task's agent. */
+    result?: string;
+}
+export interface AssistantState {
+    /** The conversation with ta is open. */
+    ready: boolean;
+    error?: string;
+    tasks: AssistantTask[];
+    /** The time the last task ended, for a little celebration. */
+    lastFinished?: number;
+}
+/**
+ * ta as the user's double: one long conversation with the user, which hands work to tasks, each its own
+ * session of ta serve running in parallel, and tells the user how they ended. Handing out work is a
+ * set of client tools of that conversation, which this service runs: no server feature.
+ */
+export interface TaAssistant {
+    readonly state: AssistantState;
+    subscribe(listener: (state: AssistantState) => void): () => void;
+    /** Opens the conversation again, or for the first time; follows the tasks still running. */
+    start(): Promise<void>;
+    /** The conversation with ta. */
+    store(): SessionStore | undefined;
+    taskStore(taskId: string): SessionStore | undefined;
+    /** Says something to ta: a new message, or, while it works, one it reads at its next step. */
+    say(text: string): Promise<void>;
+    stopTask(taskId: string): Promise<void>;
+    /** What the user calls the double; empty, its default name. */
+    readonly name: string;
+    rename(name: string): void;
+    /** What the user adds to the role of the double, at the end of its system prompt. */
+    readonly prompt: string;
+    /** Opens the conversation again with it: the system prompt of a session is set when it opens. */
+    setPrompt(prompt: string): Promise<void>;
+    /** Stops what the double is doing; its tasks go on. */
+    stop(): Promise<void>;
+    /** A new conversation with the double, as pi's `/new`; the tasks stay. */
+    restart(): Promise<void>;
+}

package/esm/browser/assistant/assistant-protocol.js

@@ -0,0 +1,2 @@
+export const TaAssistant = Symbol('TaAssistant');
+//# sourceMappingURL=assistant-protocol.js.map

package/esm/browser/assistant/assistant-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-protocol.js","sourceRoot":"","sources":["../../../src/browser/assistant/assistant-protocol.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC"}

package/esm/browser/assistant/assistant-tasks.d.ts

@@ -0,0 +1,48 @@
+import type { SessionState } from '@celljs/ta-client';
+import * as React from 'react';
+import { type Translate } from '../i18n/use-t.js';
+import type { AssistantTask } from './assistant-protocol.js';
+export declare const STATUS_ICONS: {
+    done: import("lucide-react").LucideIcon;
+    failed: import("lucide-react").LucideIcon;
+    stopped: import("lucide-react").LucideIcon;
+};
+/** The dot of a task in the conversation: the colors of the steps of a turn. */
+export declare const TASK_DOTS: {
+    readonly running: 'running';
+    readonly done: 'done';
+    readonly failed: 'error';
+    readonly stopped: 'cancelled';
+};
+export declare function elapsed(task: AssistantTask, now: number): string;
+export declare function TaskStatus({ status }: {
+    status: AssistantTask['status'];
+}): React.JSX.Element;
+/** What a task does now, in a few words: the call it runs, else whether it thinks or writes. */
+export declare function activity(task: AssistantTask, state: SessionState | undefined, t: Translate): string;
+/**
+ * The conversation with ta, drawn as in any other session: ta at the head of each turn, the work it did
+ * folded, what it does now on one line; and a line for each task that ended.
+ */
+export declare function RunningTasks({ tasks, taskStates, now, onTask, }: {
+    tasks: AssistantTask[];
+    taskStates: Map<string, SessionState>;
+    now: number;
+    onTask(id: string): void;
+}): React.JSX.Element | null;
+export declare function TaskList({ tasks, taskStates, now, onOpen, }: {
+    tasks: AssistantTask[];
+    taskStates: Map<string, SessionState>;
+    now: number;
+    onOpen(id: string): void;
+}): React.JSX.Element;
+/** The name of the `panel` view of the tasks, in the built-in web extension `assistant`. */
+export declare const ASSISTANT_TASKS_VIEW = "tasks";
+/** The tasks ta handed out, running first: a tool of the workbench beside the conversation. */
+export declare function AssistantTasks({ onOpen }: {
+    onOpen(task: AssistantTask): void;
+}): React.JSX.Element;
+/** One task, its session or its result: a tab of the workbench. */
+export declare function AssistantTaskView({ taskId }: {
+    taskId: string;
+}): React.JSX.Element;