@xopcai/xopc 0.0.116 → 0.0.118

package/README.md

@@ -46,12 +46,22 @@
 
 ## Get started
 
-### Try in 3 minutes
+### Easiest start: PC desktop app
+
+For most users, the **PC desktop app** is the easiest way to start: install the app, finish model setup in the UI, then chat in the built-in console. It starts the local gateway for you.
+
+1. Download from **[GitHub Releases](https://github.com/xopcai/xopc/releases)** — macOS `.dmg`, Windows `.exe`, Linux `.AppImage` / `.deb`.
+2. Open xopc and complete model setup.
+3. Start chatting.
+
+See **[PC Desktop app](https://xopcai.github.io/xopc/desktop-app)** for install notes, build-from-source commands, and reserved screenshot/GIF/video file locations.
+
+### Fastest terminal path
 
 ```bash
 curl -fsSL https://xopc.ai/install.sh | bash
 xopc onboard --quick
-xopc tui --local
+xopc
 ```
 
 This path starts the embedded terminal UI: no gateway, desktop app, or messenger setup required.
@@ -82,12 +92,10 @@ The installer detects your OS, installs **Node.js ≥ 22** when needed, and inst
 
 ```bash
 xopc onboard          # faster: xopc onboard --quick
-xopc tui --local
+xopc                  # same as xopc tui; opens the local TUI
 ```
 
-> **New here?** Start with **`xopc tui --local`** (embedded agent, no gateway). Run **`xopc gateway`** when you want the **web console** or **messengers** (Telegram, WeChat, Feishu).
-
-If the first run works for you, please **[star the repo](https://github.com/xopcai/xopc)** so others can discover it.
+> **New here?** Use the **PC desktop app** for the easiest setup, or run **`xopc`** for the fastest terminal path. Run **`xopc gateway`** when you want the browser console or messengers without the desktop shell.
 
 ### npm (already have Node.js 22+)
 
@@ -143,10 +151,10 @@ Windows git install: `& ([scriptblock]::Create((irm https://xopc.ai/install.ps1)
 
 | Surface | How | Best for |
 | --- | --- | --- |
-| **TUI** | `xopc tui --local` (or `xopc tui --url …`) | Full keyboard, streaming, lowest friction to try |
+| **PC Desktop** | [GitHub Releases](#desktop-app) | Easiest start: native app + embedded gateway console |
+| **TUI** | `xopc` or `xopc tui` (remote: `xopc tui --url …`) | Full keyboard, streaming, fastest terminal path |
 | **CLI** | `xopc agent -i` / `xopc agent -m "…"` | Scripts and minimal TTY |
 | **Web** | `xopc gateway` → open console URL | Chat, settings, logs in the browser |
-| **Desktop** | [GitHub Releases](#desktop-app) or `pnpm run electron:build` | Native app (macOS, Windows, Linux) |
 | **Mobile** | [xopc-app](https://github.com/xopcai/xopc-app) + gateway pairing ([mobile app](https://xopcai.github.io/xopc/mobile-app), [remote access](https://xopcai.github.io/xopc/remote-access)) | Continue your loop on iOS/Android |
 | **Messengers** | `channels.*` + gateway | Telegram, WeChat, Feishu/Lark |
 
@@ -185,14 +193,29 @@ Default: **`~/.xopc/xopc.json`**.
 ```json
 {
   "agents": {
-    "defaults": {
-      "model": "deepseek/deepseek-chat",
-      "max_tokens": 8192
-    }
+    "default": "main",
+    "list": [
+      {
+        "id": "main",
+        "identity": { "name": "Main", "role": "General assistant" },
+        "responsibilities": { "primary": ["Help the user complete tasks"] },
+        "workspace": { "root": "~/.xopc/workspace/main" },
+        "models": {
+          "defaultRole": "deep",
+          "roles": {
+            "deep": { "model": "deepseek/deepseek-v4-flash" }
+          }
+        },
+        "tools": { "builtin": {} },
+        "skills": { "mode": "all" },
+        "memory": { "mode": "confirmWrite", "sources": ["session"] },
+        "workflows": {},
+        "boundaries": { "requiresConfirmation": [], "forbidden": [], "escalation": [] }
+      }
+    ]
   },
   "providers": {
-    "deepseek": "${DEEPSEEK_API_KEY}",
-    "openai": "${OPENAI_API_KEY}"
+    "deepseek": "${DEEPSEEK_API_KEY}"
   }
 }
 ```
@@ -227,7 +250,7 @@ No. xopc runs on your machine. Config, workspace files, credentials, and local s
 No. Bring your own keys for cloud providers, or use local/model-server options such as Ollama, LM Studio, and vLLM.
 
 **What is the fastest way to try it?**  
-Use **`xopc onboard --quick`** and **`xopc tui --local`**. That path avoids gateway, desktop, and messenger setup.
+For most users, install the **PC desktop app** from GitHub Releases and complete model setup in the UI. For terminal users, use **`xopc onboard --quick`** and then run **`xopc`**.
 
 **How is this different from another chat UI?**  
 xopc is organized around goal loops: direction, next action, feedback, and recalibration across multiple surfaces.
@@ -235,20 +258,21 @@ xopc is organized around goal loops: direction, next action, feedback, and recal
 **Can I use it from my phone or messengers?**  
 Yes. Start with local TUI first; when ready, run the gateway and use [xopc-app](https://github.com/xopcai/xopc-app) on iOS/Android, or configure Telegram, WeChat, or Feishu/Lark.
 
-If this answers your concerns, please **[star xopc](https://github.com/xopcai/xopc)** so more developers can find it.
-
----
-
 <a id="desktop-app"></a>
 <a id="electron-desktop"></a>
 
 ## Desktop app
 
+The PC desktop app is the easiest way to start for most users: it launches an embedded local gateway and opens the gateway console in a native window.
+
 1. Download from **[GitHub Releases](https://github.com/xopcai/xopc/releases)** — macOS `.dmg`, Windows `xopc-<version>-x64.exe` or `xopc-<version>-arm64.exe`, Linux `.AppImage` / `.deb`.
-2. Or use **`xopc gateway`** + the npm CLI until a build exists for your OS.
+2. Open the app, complete model setup, and start chatting.
+3. Or use **`xopc gateway`** + the npm CLI until a build exists for your OS.
 
 **Build from source:** `pnpm install && pnpm run electron:build` → `dist/release/`
 
+Docs and media placeholders: **[PC Desktop app](https://xopcai.github.io/xopc/desktop-app)**.
+
 ---
 
 ## Security
@@ -268,14 +292,6 @@ pnpm run build && pnpm test && pnpm run lint
 
 **Issues:** [bug](https://github.com/xopcai/xopc/issues/new?template=bug_report.yml) · [feature](https://github.com/xopcai/xopc/issues/new?template=feature_request.yml) · [Q&A Discussions](https://github.com/xopcai/xopc/discussions/categories/q-a) · [security advisory](https://github.com/xopcai/xopc/security/advisories/new) (not public issues)
 
----
-
-## Star history
-
-[![Star History Chart](https://api.star-history.com/svg?repos=xopcai/xopc&type=Date)](https://star-history.com/#xopcai/xopc&Date)
-
----
-
 ## Credits
 
 - LLM layer: [@earendil-works/pi-ai](https://github.com/earendil-works/pi-mono) · Agent runtime: [@earendil-works/pi-agent-core](https://github.com/earendil-works/pi-mono)

package/README.zh-CN.md

@@ -7,8 +7,8 @@
 
 <p align="center">
   <strong>把目标变成循环。</strong><br />
-  让真正重要的事情，持续向前。<br />
-  XOPC 是一个 Local-first AI 系统，持续记住上下文，协调 AI 推进下一步，让长期目标不断向前。
+  让真正重要的事情持续向前。<br />
+  XOPC 是一个本地优先的 AI 助手系统：记住上下文，协调 AI 推进下一步，让长期目标持续向前。
 </p>
 
 <p align="center">
@@ -35,9 +35,9 @@
 
 ## 适合谁
 
-- **长期项目** —— 把目标变成可持续的循环：上下文、下一步行动、反馈和重新校准始终连在一起。
-- **独立开发者 / One Person Company** —— 同一个助手覆盖 CLI、TUI、网页、桌面、Telegram、微信和飞书/Lark。
-- **本地优先 AI 工作流** —— 自带 API Key，云端/本地模型混用，支持 skills/extensions，数据默认在 **`~/.xopc/`**。
+- **长期项目** —— 把目标拆成可持续推进的循环：上下文、下一步行动、反馈和校准始终连在一起。
+- **独立开发者 / 一人公司** —— 同一个助手覆盖 CLI、TUI、网页、桌面、Telegram、微信和飞书/Lark。
+- **本地优先 AI 工作流** —— 使用你自己的 API Key，云端/本地模型混用，支持技能和扩展，数据默认保存在 **`~/.xopc/`**。
 
 ---
 
@@ -46,15 +46,25 @@
 
 ## 快速开始
 
-### 3 分钟试用
+### 最省心的开始方式：PC 桌面端
+
+对大多数用户来说，**PC 桌面端**是最容易上手的方式：安装应用，在界面里完成模型设置，然后直接在内置控制台聊天。它会自动启动本地 gateway。
+
+1. 从 **[GitHub Releases](https://github.com/xopcai/xopc/releases)** 下载 — macOS `.dmg`，Windows `.exe`，Linux `.AppImage` / `.deb`。
+2. 打开 xopc，完成模型设置。
+3. 开始聊天。
+
+详见 **[PC 桌面端](https://xopcai.github.io/xopc/zh/desktop-app)**：安装说明、源码打包命令，以及后续截图/GIF/视频素材的预留文件位置。
+
+### 最快终端路径
 
 ```bash
 curl -fsSL https://xopc.ai/install.sh | bash
 xopc onboard --quick
-xopc tui --local
+xopc
 ```
 
-这条路径会启动本地嵌入式 TUI，不需要先配置网关、桌面端或 IM。
+这条路径会启动本地嵌入式 TUI，不需要先配置网关、桌面端或即时通讯。
 
 ### 一键安装（推荐）
 
@@ -82,12 +92,10 @@ iex (irm https://xopc.ai/install.ps1)
 
 ```bash
 xopc onboard          # 更快：xopc onboard --quick
-xopc tui --local
+xopc                  # 等同于 xopc tui，打开本地 TUI
 ```
 
-> **第一次用？** 先跑 **`xopc tui --local`**（本地嵌入式对话，不用网关）。需要 **网页控制台** 或 **Telegram / 微信 / 飞书** 时再执行 **`xopc gateway`**。
-
-如果首次运行顺利，欢迎 **[给仓库点个 Star](https://github.com/xopcai/xopc)**，帮助更多人发现这个项目。
+> **第一次用？** 想少碰终端，优先用 **PC 桌面端**；习惯终端则直接运行 **`xopc`**。需要浏览器控制台或即时通讯时，再启动 **`xopc gateway`**。
 
 ### npm（已具备 Node.js 22+）
 
@@ -123,19 +131,19 @@ pnpm exec xopc onboard
 
 Windows 源码安装：`& ([scriptblock]::Create((irm https://xopc.ai/install.ps1))) -InstallMethod git`
 
-**环境：** Node.js **≥ 22**（一键脚本会自动处理）。在本仓库魔改请用 **pnpm**。更多安装方式见 **[xopc.ai](https://xopc.ai)** 与 **[快速开始](https://xopcai.github.io/xopc/zh/getting-started)**。
+**环境：** Node.js **≥ 22**（一键脚本会自动处理）。从源码开发本仓库时请使用 **pnpm**。更多安装方式见 **[xopc.ai](https://xopc.ai)** 与 **[快速开始](https://xopcai.github.io/xopc/zh/getting-started)**。
 
 ---
 
 ## 为什么选 xopc
 
-- 🔁 **循环驱动，而非一次性对话** — XOPC 持续记住上下文，协调 AI 推进下一步，让真正重要的事情不断向前。
+- 🔁 **循环驱动，而不是一次性对话** — XOPC 持续记住上下文，协调 AI 推进下一步，让真正重要的事情不断向前。
 
 - 🏠 **你的机器** — 配置与数据在 **`~/.xopc/`**，无强制云端、无意外账单。
-- 🔑 **自带钥匙** — OpenAI、Anthropic、Google、DeepSeek、Ollama、LM Studio、vLLM 等 **20+** 厂商；云端本地可混用，一行配置切换目录模型。详见 **[模型](https://xopcai.github.io/xopc/zh/models)**。
-- 📱 **一个大脑，处处可用** — 终端、浏览器、桌面、[移动端 app](https://github.com/xopcai/xopc-app)、IM 同一套助手，无需另做同步。
-- 🧩 **随你长大** — **`xopc skills install`** · **`xopc extensions install`** 扩展工具、频道与 UI；多 Agent 按场景隔离。
-- ⏰ **能主动干活** — **Cron** 定时摘要与提醒；**工作流**扇出多子 Agent 任务；**多 Agent** 各自工作区、工具与系统提示词。
+- 🔑 **使用自己的密钥** — OpenAI、Anthropic、Google、DeepSeek、Ollama、LM Studio、vLLM 等 **20+** 厂商；云端和本地模型可混用，一行配置即可切换模型。详见 **[模型](https://xopcai.github.io/xopc/zh/models)**。
+- 📱 **多个入口，同一个助手** — 终端、浏览器、桌面、[移动端 App](https://github.com/xopcai/xopc-app)、即时通讯共用同一套上下文，无需额外同步。
+- 🧩 **可按需扩展** — 通过 **`xopc skills install`** 和 **`xopc extensions install`** 扩展工具、频道与 UI；多 Agent 可按场景隔离。
+- ⏰ **支持主动任务** — 用 **Cron** 做定时摘要与提醒；用 **工作流**扇出多子 Agent 任务；用 **多 Agent** 管理不同工作区、工具与系统提示词。
 
 ---
 
@@ -143,18 +151,18 @@ Windows 源码安装：`& ([scriptblock]::Create((irm https://xopc.ai/install.ps
 
 | 方式 | 怎么用 | 适合 |
 | --- | --- | --- |
-| **TUI** | `xopc tui --local`（或 `xopc tui --url …`） | 全键盘、流式输出，上手最快 |
+| **PC 桌面端** | [GitHub Releases](#desktop-app) | 最省心的开始方式：原生应用 + 内嵌 gateway 控制台 |
+| **TUI** | `xopc` 或 `xopc tui`（远程：`xopc tui --url …`） | 全键盘、流式输出，最快终端路径 |
 | **CLI** | `xopc agent -i` / `xopc agent -m "…"` | 脚本、最小终端环境 |
 | **网页** | `xopc gateway` → 打开控制台地址 | 聊天、设置、日志 |
-| **桌面** | [GitHub Releases](#desktop-app) 或 `pnpm run electron:build` | 原生应用（macOS / Windows / Linux） |
-| **手机** | [xopc-app](https://github.com/xopcai/xopc-app) + 网关配对（[移动端 app](https://xopcai.github.io/xopc/zh/mobile-app)、[远程访问](https://xopcai.github.io/xopc/zh/remote-access)） | 在 iOS/Android 上继续推进循环 |
+| **手机** | [xopc-app](https://github.com/xopcai/xopc-app) + 网关配对（[移动端 App](https://xopcai.github.io/xopc/zh/mobile-app)、[远程访问](https://xopcai.github.io/xopc/zh/remote-access)） | 在 iOS/Android 上继续推进循环 |
 | **即时通讯** | 配置 `channels.*` 并启动网关 | Telegram、微信、飞书/Lark |
 
 ---
 
 ## 内置频道
 
-在 **`~/.xopc/xopc.json`** 里配置 **`channels.*`**。IM 需网关常驻；微信在**跑网关的机器**上扫码登录。
+在 **`~/.xopc/xopc.json`** 里配置 **`channels.*`**。即时通讯需要网关常驻；微信需要在**运行网关的机器**上扫码登录。
 
 | 频道 | 配置项 | 说明 |
 | --- | --- | --- |
@@ -185,19 +193,34 @@ xopc extensions dev ./my-extension
 ```json
 {
   "agents": {
-    "defaults": {
-      "model": "deepseek/deepseek-chat",
-      "max_tokens": 8192
-    }
+    "default": "main",
+    "list": [
+      {
+        "id": "main",
+        "identity": { "name": "Main", "role": "General assistant" },
+        "responsibilities": { "primary": ["Help the user complete tasks"] },
+        "workspace": { "root": "~/.xopc/workspace/main" },
+        "models": {
+          "defaultRole": "deep",
+          "roles": {
+            "deep": { "model": "deepseek/deepseek-v4-flash" }
+          }
+        },
+        "tools": { "builtin": {} },
+        "skills": { "mode": "all" },
+        "memory": { "mode": "confirmWrite", "sources": ["session"] },
+        "workflows": {},
+        "boundaries": { "requiresConfirmation": [], "forbidden": [], "escalation": [] }
+      }
+    ]
   },
   "providers": {
-    "deepseek": "${DEEPSEEK_API_KEY}",
-    "openai": "${OPENAI_API_KEY}"
+    "deepseek": "${DEEPSEEK_API_KEY}"
   }
 }
 ```
 
-需要 IM 时再补 **`channels.telegram`**、**`channels.weixin`**、**`channels.feishu`** —— 见 **[配置](https://xopcai.github.io/xopc/zh/configuration)**。
+需要即时通讯时再补 **`channels.telegram`**、**`channels.weixin`**、**`channels.feishu`** —— 见 **[配置](https://xopcai.github.io/xopc/zh/configuration)**。
 
 可选工具（如浏览器）默认**关闭**，启用后按需安装 Playwright Chromium。
 
@@ -214,7 +237,7 @@ xopc extensions dev ./my-extension
 | [架构](https://xopcai.github.io/xopc/zh/architecture) | 整体结构 |
 | [工作流](https://xopcai.github.io/xopc/zh/workflows) | 扇出子 Agent、看板、脚本 |
 
-更多：[工具](https://xopcai.github.io/xopc/zh/tools) · [移动端 app](https://xopcai.github.io/xopc/zh/mobile-app) · [语音](https://xopcai.github.io/xopc/zh/voice) · [远程访问](https://xopcai.github.io/xopc/zh/remote-access)
+更多：[工具](https://xopcai.github.io/xopc/zh/tools) · [移动端 App](https://xopcai.github.io/xopc/zh/mobile-app) · [语音](https://xopcai.github.io/xopc/zh/voice) · [远程访问](https://xopcai.github.io/xopc/zh/remote-access)
 
 ---
 
@@ -227,16 +250,14 @@ xopc extensions dev ./my-extension
 不必须。你可以自带云厂商 API Key，也可以使用 Ollama、LM Studio、vLLM 等本地/自部署模型服务。
 
 **最快怎么试用？**  
-执行 **`xopc onboard --quick`** 和 **`xopc tui --local`**。这条路径不会先要求你配置网关、桌面端或 IM。
+对大多数用户，优先从 GitHub Releases 安装 **PC 桌面端**，在界面中完成模型设置。习惯终端的用户可以执行 **`xopc onboard --quick`**，然后运行 **`xopc`**。
 
 **它和普通聊天 UI 有什么区别？**  
 xopc 围绕目标循环组织：方向、下一步、反馈、重新校准，并且同一个助手可以跨多个入口继续工作。
 
-**能在手机或 IM 里用吗？**  
+**能在手机或即时通讯里用吗？**
 可以。建议先用本地 TUI 试用；确认方向后，再启动 gateway，用 [xopc-app](https://github.com/xopcai/xopc-app) 连接 iOS/Android，或配置 Telegram、微信、飞书/Lark。
 
-如果这些回答解决了你的顾虑，欢迎 **[给 xopc 点个 Star](https://github.com/xopcai/xopc)**，帮助更多开发者看到它。
-
 ---
 
 <a id="desktop-app"></a>
@@ -244,16 +265,21 @@ xopc 围绕目标循环组织：方向、下一步、反馈、重新校准，并
 
 ## 桌面版
 
+PC 桌面端是大多数用户最省心的开始方式：它会启动内置本地 gateway，并在原生窗口里打开 gateway 控制台。
+
 1. 从 **[GitHub Releases](https://github.com/xopcai/xopc/releases)** 下载 — macOS `.dmg`，Windows `xopc-<版本>-x64.exe` 或 `xopc-<版本>-arm64.exe`，Linux `.AppImage` / `.deb`。
-2. 暂无对应平台安装包时，先用 **`xopc gateway`** + npm 命令行版。
+2. 打开应用，完成模型设置，然后开始聊天。
+3. 暂无对应平台安装包时，先用 **`xopc gateway`** + npm 命令行版。
 
 **从源码打包：** `pnpm install && pnpm run electron:build` → `dist/release/`
 
+文档与素材预留：**[PC 桌面端](https://xopcai.github.io/xopc/zh/desktop-app)**。
+
 ---
 
 ## 安全
 
-来自 IM 的消息视为**不可信输入**。私聊建议 **pairing（配对）** 或 **allowlist（白名单）**。网关监听地址与 token 勿泄露 —— **[频道](https://xopcai.github.io/xopc/zh/channels)**。
+来自即时通讯的消息视为**不可信输入**。私聊建议 **pairing（配对）** 或 **allowlist（白名单）**。请勿泄露网关监听地址与 token —— **[频道](https://xopcai.github.io/xopc/zh/channels)**。
 
 ---
 
@@ -266,15 +292,7 @@ pnpm run build && pnpm test && pnpm run lint
 
 **[AGENTS.md](./AGENTS.md)** · **[CONTRIBUTING.md](./CONTRIBUTING.md)**（英文）
 
-**反馈：** [Bug](https://github.com/xopcai/xopc/issues/new?template=bug_report.yml) · [功能建议](https://github.com/xopcai/xopc/issues/new?template=feature_request.yml) · [Discussions Q&A](https://github.com/xopcai/xopc/discussions/categories/q-a) · [安全 advisory](https://github.com/xopcai/xopc/security/advisories/new)（勿公开贴漏洞）
-
----
-
-## Star 历史
-
-[![Star History Chart](https://api.star-history.com/svg?repos=xopcai/xopc&type=Date)](https://star-history.com/#xopcai/xopc&Date)
-
----
+**反馈：** [Bug 反馈](https://github.com/xopcai/xopc/issues/new?template=bug_report.yml) · [功能建议](https://github.com/xopcai/xopc/issues/new?template=feature_request.yml) · [Q&A 讨论](https://github.com/xopcai/xopc/discussions/categories/q-a) · [安全漏洞反馈](https://github.com/xopcai/xopc/security/advisories/new)（请勿公开发布漏洞细节）
 
 ## 致谢
 

package/dist/browser-ext/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "xopc Browser Bridge",
-  "version": "0.0.116",
+  "version": "0.0.118",
   "description": "Browser automation bridge for xopc — executes commands in Chrome via the local xopc daemon.",
   "permissions": [
     "debugger",

package/dist/extensions/demo-memory/src/index.d.ts

@@ -0,0 +1,6 @@
+import type { MemoryProvider } from '../../../src/agent/memory/provider.js';
+import type { MemoryProviderManifest } from '../../../src/agent/memory/types.js';
+export declare const manifest: MemoryProviderManifest;
+export declare const description = "In-memory provider used to verify extension-backed memory providers.";
+export declare function isAvailable(): boolean;
+export declare function createMemoryProvider(): MemoryProvider;

package/dist/extensions/demo-memory/src/index.js

@@ -0,0 +1,132 @@
+//#region extensions/demo-memory/src/index.ts
+const manifest = {
+	type: "memory-provider",
+	id: "demo-memory",
+	displayName: "Demo Memory Provider",
+	entry: "./src/index.js",
+	capabilities: {
+		search: true,
+		read: true,
+		write: true,
+		update: false,
+		delete: false,
+		keywordSearch: true,
+		citations: true,
+		sync: true
+	}
+};
+const description = "In-memory provider used to verify extension-backed memory providers.";
+function isAvailable() {
+	return process.env.XOPC_DEMO_MEMORY_DISABLED !== "1";
+}
+function createMemoryProvider() {
+	return new DemoMemoryProvider();
+}
+var DemoMemoryProvider = class {
+	id = manifest.id;
+	displayName = manifest.displayName;
+	manifest = manifest;
+	capabilities = {
+		search: true,
+		read: true,
+		write: true,
+		update: false,
+		delete: false,
+		keywordSearch: true,
+		semanticSearch: false,
+		hybridSearch: false,
+		citations: true,
+		sync: true
+	};
+	records = /* @__PURE__ */ new Map();
+	sequence = 0;
+	scope = { agentId: "main" };
+	isAvailable() {
+		return isAvailable();
+	}
+	initialize(_sessionId, options) {
+		const agentId = typeof options?.config?.agentId === "string" ? options.config.agentId : "main";
+		const workspaceId = typeof options?.workspace === "string" ? options.workspace : void 0;
+		this.scope = workspaceId ? {
+			agentId,
+			workspaceId
+		} : { agentId };
+	}
+	async write(request) {
+		const record = this.createRecord(request);
+		return {
+			success: true,
+			record,
+			message: `Demo memory stored ${record.id}`
+		};
+	}
+	async search(request) {
+		const query = request.query.trim().toLocaleLowerCase();
+		const kinds = request.kinds ? new Set(request.kinds) : null;
+		const maxResults = request.maxResults ?? 5;
+		return [...this.records.values()].filter((record) => !kinds || kinds.has(record.kind)).filter((record) => !query || record.content.toLocaleLowerCase().includes(query)).map((record) => ({
+			record,
+			score: scoreRecord(record, query),
+			snippet: record.content,
+			citation: {
+				providerId: this.id,
+				recordId: record.id,
+				title: this.displayName,
+				createdAt: record.createdAt
+			}
+		})).sort((a, b) => b.score - a.score).slice(0, maxResults);
+	}
+	async read(request) {
+		if (!request.id) return null;
+		const record = this.records.get(request.id);
+		return record ? { record } : null;
+	}
+	async get(id) {
+		return this.records.get(id) ?? null;
+	}
+	async list(request) {
+		return [...this.records.values()].filter((record) => !request.kind || record.kind === request.kind);
+	}
+	sync(event) {
+		if (event.type !== "signal" || !event.signal.content) return;
+		this.createRecord({
+			kind: "derived_insight",
+			content: event.signal.content,
+			source: { provider: event.signal.source },
+			tags: ["signal", event.signal.source]
+		});
+	}
+	shutdown() {
+		this.records.clear();
+	}
+	createRecord(request) {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const id = `demo-memory-${++this.sequence}`;
+		const record = {
+			id,
+			kind: request.kind,
+			scope: {
+				...this.scope,
+				...request.scope
+			},
+			content: request.content,
+			source: request.source ?? { provider: this.id },
+			createdAt: now,
+			updatedAt: now,
+			...request.tags ? { tags: request.tags } : {}
+		};
+		this.records.set(id, record);
+		return record;
+	}
+};
+function scoreRecord(record, query) {
+	if (!query) return .5;
+	const text = record.content.toLocaleLowerCase();
+	if (text === query) return 1;
+	if (text.includes(query)) return .8;
+	return .1;
+}
+//#endregion
+export { createMemoryProvider, description, isAvailable, manifest };
+
+//# sourceMappingURL=index.js.map

package/dist/extensions/demo-memory/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../extensions/demo-memory/src/index.ts"],"sourcesContent":["import type { MemoryProvider, MemoryProviderInitOptions } from '../../../src/agent/memory/provider.js';\nimport type {\n  MemoryCapabilities,\n  MemoryListRequest,\n  MemoryProviderManifest,\n  MemoryReadRequest,\n  MemoryReadResult,\n  MemoryRecord,\n  MemoryScope,\n  MemorySearchRequest,\n  MemorySearchResult,\n  MemorySyncEvent,\n  MemoryWriteRequest,\n  MemoryWriteResult,\n} from '../../../src/agent/memory/types.js';\n\nexport const manifest: MemoryProviderManifest = {\n  type: 'memory-provider',\n  id: 'demo-memory',\n  displayName: 'Demo Memory Provider',\n  entry: './src/index.js',\n  capabilities: {\n    search: true,\n    read: true,\n    write: true,\n    update: false,\n    delete: false,\n    keywordSearch: true,\n    citations: true,\n    sync: true,\n  },\n};\n\nexport const description = 'In-memory provider used to verify extension-backed memory providers.';\n\nexport function isAvailable(): boolean {\n  return process.env.XOPC_DEMO_MEMORY_DISABLED !== '1';\n}\n\nexport function createMemoryProvider(): MemoryProvider {\n  return new DemoMemoryProvider();\n}\n\nclass DemoMemoryProvider implements MemoryProvider {\n  readonly id = manifest.id;\n  readonly displayName = manifest.displayName;\n  readonly manifest = manifest;\n  readonly capabilities: MemoryCapabilities = {\n    search: true,\n    read: true,\n    write: true,\n    update: false,\n    delete: false,\n    keywordSearch: true,\n    semanticSearch: false,\n    hybridSearch: false,\n    citations: true,\n    sync: true,\n  };\n\n  private records = new Map<string, MemoryRecord>();\n  private sequence = 0;\n  private scope: MemoryScope = { agentId: 'main' };\n\n  isAvailable(): boolean {\n    return isAvailable();\n  }\n\n  initialize(_sessionId: string, options?: MemoryProviderInitOptions): void {\n    const agentId = typeof options?.config?.agentId === 'string' ? options.config.agentId : 'main';\n    const workspaceId = typeof options?.workspace === 'string' ? options.workspace : undefined;\n    this.scope = workspaceId ? { agentId, workspaceId } : { agentId };\n  }\n\n  async write(request: MemoryWriteRequest): Promise<MemoryWriteResult> {\n    const record = this.createRecord(request);\n    return { success: true, record, message: `Demo memory stored ${record.id}` };\n  }\n\n  async search(request: MemorySearchRequest): Promise<MemorySearchResult[]> {\n    const query = request.query.trim().toLocaleLowerCase();\n    const kinds = request.kinds ? new Set(request.kinds) : null;\n    const maxResults = request.maxResults ?? 5;\n    return [...this.records.values()]\n      .filter((record) => !kinds || kinds.has(record.kind))\n      .filter((record) => !query || record.content.toLocaleLowerCase().includes(query))\n      .map((record) => ({\n        record,\n        score: scoreRecord(record, query),\n        snippet: record.content,\n        citation: {\n          providerId: this.id,\n          recordId: record.id,\n          title: this.displayName,\n          createdAt: record.createdAt,\n        },\n      }))\n      .sort((a, b) => b.score - a.score)\n      .slice(0, maxResults);\n  }\n\n  async read(request: MemoryReadRequest): Promise<MemoryReadResult | null> {\n    if (!request.id) return null;\n    const record = this.records.get(request.id);\n    return record ? { record } : null;\n  }\n\n  async get(id: string): Promise<MemoryRecord | null> {\n    return this.records.get(id) ?? null;\n  }\n\n  async list(request: MemoryListRequest): Promise<MemoryRecord[]> {\n    return [...this.records.values()].filter((record) => !request.kind || record.kind === request.kind);\n  }\n\n  sync(event: MemorySyncEvent): void {\n    if (event.type !== 'signal' || !event.signal.content) return;\n    this.createRecord({\n      kind: 'derived_insight',\n      content: event.signal.content,\n      source: { provider: event.signal.source },\n      tags: ['signal', event.signal.source],\n    });\n  }\n\n  shutdown(): void {\n    this.records.clear();\n  }\n\n  private createRecord(request: MemoryWriteRequest): MemoryRecord {\n    const now = new Date().toISOString();\n    const id = `demo-memory-${++this.sequence}`;\n    const record: MemoryRecord = {\n      id,\n      kind: request.kind,\n      scope: { ...this.scope, ...request.scope },\n      content: request.content,\n      source: request.source ?? { provider: this.id },\n      createdAt: now,\n      updatedAt: now,\n      ...(request.tags ? { tags: request.tags } : {}),\n    };\n    this.records.set(id, record);\n    return record;\n  }\n}\n\nfunction scoreRecord(record: MemoryRecord, query: string): number {\n  if (!query) return 0.5;\n  const text = record.content.toLocaleLowerCase();\n  if (text === query) return 1;\n  if (text.includes(query)) return 0.8;\n  return 0.1;\n}\n"],"mappings":"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"}

package/dist/extensions/demo-memory/xopc.extension.json

@@ -0,0 +1,15 @@
+{
+  "id": "demo-memory",
+  "name": "Demo Memory Provider",
+  "description": "In-memory memory provider used to validate the extension memory provider pipeline.",
+  "version": "1.0.0",
+  "kind": "memory",
+  "main": "src/index.js",
+  "enabledByDefault": true,
+  "contracts": {
+    "memoryProviders": ["demo-memory"]
+  },
+  "engines": {
+    "xopc": ">=0.0.116 <1.0.0"
+  }
+}

package/dist/extensions/feishu/src/outbound/media-load.js

@@ -1,8 +1,8 @@
 import { checkFileSafety } from "../../../../src/agent/prompt/safety.js";
 import { getMimeType } from "../../../../src/channels/media.js";
 import { getWorkspacePath } from "../../../../src/config/workspace-path-helpers.js";
-import { promises } from "node:fs";
 import path from "node:path";
+import { promises } from "node:fs";
 import { Readable } from "node:stream";
 //#region extensions/feishu/src/outbound/media-load.ts
 function isPathUnderRoots(resolved, roots) {

package/dist/extensions/feishu/src/schema/config-schema.d.ts

@@ -18,8 +18,8 @@ export declare const FeishuAccountConfigSchema: z.ZodObject<{
     verificationToken: z.ZodOptional<z.ZodString>;
     encryptKey: z.ZodOptional<z.ZodString>;
     dmPolicy: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
-        pairing: "pairing";
         allowlist: "allowlist";
+        pairing: "pairing";
         open: "open";
         disabled: "disabled";
     }>>>;
@@ -93,8 +93,8 @@ export declare const FeishuConfigSchema: z.ZodObject<{
     verificationToken: z.ZodOptional<z.ZodString>;
     encryptKey: z.ZodOptional<z.ZodString>;
     dmPolicy: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
-        pairing: "pairing";
         allowlist: "allowlist";
+        pairing: "pairing";
         open: "open";
         disabled: "disabled";
     }>>>;
@@ -157,8 +157,8 @@ export declare const FeishuConfigSchema: z.ZodObject<{
         verificationToken: z.ZodOptional<z.ZodString>;
         encryptKey: z.ZodOptional<z.ZodString>;
         dmPolicy: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
-            pairing: "pairing";
             allowlist: "allowlist";
+            pairing: "pairing";
             open: "open";
             disabled: "disabled";
         }>>>;

package/dist/extensions/feishu/src/workflow-progress.js

@@ -1,6 +1,6 @@
+import { init_session_key, parseSessionKey } from "../../../src/routing/session-key.js";
 import { createLogger } from "../../../src/utils/logger/index.js";
 import { init_logger } from "../../../src/utils/logger.js";
-import { init_session_key, parseSessionKey } from "../../../src/routing/session-key.js";
 import { resolveFeishuAccount } from "./state/accounts.js";
 //#region extensions/feishu/src/workflow-progress.ts
 init_session_key();

package/dist/extensions/telegram/src/adapters/streaming-adapter.js

@@ -1,6 +1,6 @@
+import { init_config_schema, resolveTelegramStreamingMode } from "../config-schema.js";
 import { createLogger } from "../../../../src/utils/logger/index.js";
 import { init_logger } from "../../../../src/utils/logger.js";
-import { init_config_schema, resolveTelegramStreamingMode } from "../config-schema.js";
 import { renderTelegramHtmlText } from "../format.js";
 import { telegramReplyTracker } from "../reply-params.js";
 import { createTelegramDraftStream } from "../draft-stream.js";

package/dist/extensions/telegram/src/command-handler.js

@@ -97,9 +97,8 @@ function createTelegramCommandHandler(deps) {
 	const handleProviderSelect = async (ctx, providerId) => {
 		try {
 			const sessionKey = getSessionKeyFromCtx(ctx);
-			const modelConfig = config.agents?.defaults?.models?.chat;
 			const { getDefaultModelSync, getProviderDisplayName } = await import("../../../src/providers/index.js");
-			const defaultModel = modelConfig?.primary || getDefaultModelSync(config);
+			const defaultModel = getDefaultModelSync(config);
 			const currentModel = getSessionModel(sessionKey) || defaultModel;
 			const models = await getModelsForProvider(providerId);
 			if (models.length === 0) {