@downcity/plugins 1.0.145 → 1.0.148

package/src/contact/Action.ts

@@ -97,21 +97,21 @@ export type ContactActionHandlers = {
 export function createContactActions(handlers: ContactActionHandlers): PluginActions {
   return {
     link: createAction({
-      description: "生成一次性 contact link code，供其他 agent approve。",
+      description: "Create a one-time contact link code for another agent to approve.",
       input_schema: {
         zod: z.object({ ttlSeconds: z.number().optional() }),
         json_schema: {
           type: "object",
           properties: {
-            ttlSeconds: { type: "number", description: "link 过期秒数，默认 600" },
+            ttlSeconds: { type: "number", description: "Link expiration in seconds, defaulting to 600." },
           },
         },
       },
-      examples: [{ title: "生成默认 link", payload: {} }],
+      examples: [{ title: "Create default link", payload: {} }],
       command: {
-        description: "生成一次性 contact link code，交给另一个 agent approve",
+        description: "Create a one-time contact link code for another agent to approve.",
         configure(command) {
-          command.option("--ttl-seconds <seconds>", "link 过期秒数，默认 600", Number);
+          command.option("--ttl-seconds <seconds>", "Link expiration in seconds, defaulting to 600.", Number);
         },
         mapInput({ opts }) {
           const payload: JsonObject = {};
@@ -128,7 +128,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     approve: createAction({
-      description: "使用 contact link code 建立点对点联系。",
+      description: "Use a contact link code to establish a peer-to-peer contact.",
       input_schema: {
         zod: z.object({
           code: z.string(),
@@ -139,7 +139,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
           required: ["code"],
           properties: {
             code: { type: "string", description: "link code" },
-            name: { type: "string", description: "本地 contact 别名" },
+            name: { type: "string", description: "Local contact alias." },
           },
         },
       },
@@ -147,11 +147,11 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         { title: "approve link", payload: { code: "abc123", name: "alice" } },
       ],
       command: {
-        description: "使用 contact link code 建立点对点联系",
+        description: "Use a contact link code to establish a peer-to-peer contact.",
         configure(command) {
           command
             .argument("<code>")
-            .option("--name <alias>", "本地 contact 别名");
+            .option("--name <alias>", "Local contact alias.");
         },
         mapInput({ args, opts }) {
           const code = String(args[0] || "").trim();
@@ -170,14 +170,14 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     list: createAction({
-      description: "列出已建立的 contact。",
+      description: "List established contacts.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {} },
       },
-      examples: [{ title: "列出 contact", payload: {} }],
+      examples: [{ title: "List contacts", payload: {} }],
       command: {
-        description: "列出已建立的 contact",
+        description: "List established contacts.",
         mapInput() {
           return {};
         },
@@ -190,7 +190,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     check: createAction({
-      description: "检查 contact 或 endpoint 当前是否在线可用。",
+      description: "Check whether a contact or endpoint is currently online and reachable.",
       input_schema: {
         zod: z.object({
           target: z.string().optional(),
@@ -199,21 +199,21 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         json_schema: {
           type: "object",
           properties: {
-            target: { type: "string", description: "已保存的 contact 名" },
-            endpoint: { type: "string", description: "直接检查的 endpoint" },
+            target: { type: "string", description: "Saved contact name." },
+            endpoint: { type: "string", description: "Endpoint to check directly." },
           },
         },
       },
       examples: [
-        { title: "检查 contact", payload: { target: "alice" } },
-        { title: "检查 endpoint", payload: { endpoint: "https://example.com" } },
+        { title: "Check contact", payload: { target: "alice" } },
+        { title: "Check endpoint", payload: { endpoint: "https://example.com" } },
       ],
       command: {
-        description: "检查 contact 或 endpoint 当前是否在线可用",
+        description: "Check whether a contact or endpoint is currently online and reachable.",
         configure(command) {
           command
             .argument("[target]")
-            .option("--to <endpoint>", "直接检查未保存的 endpoint");
+            .option("--to <endpoint>", "Directly check an unsaved endpoint.");
         },
         mapInput({ args, opts }) {
           const payload: JsonObject = {};
@@ -232,7 +232,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     chat: createAction({
-      description: "和某个 contact 的长期对话线聊天，或读取对话历史。",
+      description: "Chat with a contact in its long-lived conversation thread, or read conversation history.",
       input_schema: {
         zod: z.object({
           to: z.string(),
@@ -242,19 +242,19 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
           type: "object",
           required: ["to"],
           properties: {
-            to: { type: "string", description: "目标 contact" },
-            message: { type: "string", description: "要发送的消息" },
+            to: { type: "string", description: "Target contact." },
+            message: { type: "string", description: "Message to send." },
           },
         },
       },
       examples: [
-        { title: "发送消息", payload: { to: "alice", message: "hello" } },
-        { title: "读取历史", payload: { to: "alice" } },
+        { title: "Send message", payload: { to: "alice", message: "hello" } },
+        { title: "Read history", payload: { to: "alice" } },
       ],
       command: {
-        description: "和某个 contact 的长期对话线聊天",
+        description: "Chat with a contact in its long-lived conversation thread.",
         configure(command) {
-          command.requiredOption("--to <contact>", "目标 contact").argument("[message...]");
+          command.requiredOption("--to <contact>", "Target contact.").argument("[message...]");
         },
         mapInput({ args, opts }) {
           const payload: JsonObject = {
@@ -274,7 +274,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     share: createAction({
-      description: "向 contact 分享文本、链接、文件或目录。",
+      description: "Share text, links, files, or directories with a contact.",
       input_schema: {
         zod: z.object({
           to: z.string(),
@@ -286,26 +286,26 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
           type: "object",
           required: ["to"],
           properties: {
-            to: { type: "string", description: "目标 contact" },
-            text: { type: "string", description: "分享文本" },
-            links: { type: "array", items: { type: "string" }, description: "分享链接" },
-            paths: { type: "array", items: { type: "string" }, description: "分享文件/目录路径" },
+            to: { type: "string", description: "Target contact." },
+            text: { type: "string", description: "Text to share." },
+            links: { type: "array", items: { type: "string" }, description: "Links to share." },
+            paths: { type: "array", items: { type: "string" }, description: "File or directory paths to share." },
           },
         },
       },
       examples: [
         {
-          title: "分享一段文本",
+          title: "Share text",
           payload: { to: "alice", text: "看看这个" },
         },
       ],
       command: {
-        description: "向 contact 分享文本、链接、文件或目录",
+        description: "Share text, links, files, or directories with a contact.",
         configure(command) {
           command
-            .requiredOption("--to <contact>", "目标 contact")
-            .option("--text <text>", "分享文本")
-            .option("--link <url...>", "分享链接")
+            .requiredOption("--to <contact>", "Target contact.")
+            .option("--text <text>", "Text to share.")
+            .option("--link <url...>", "Links to share.")
             .argument("[paths...]");
         },
         mapInput({ args, opts }) {
@@ -331,14 +331,14 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     inbox: createAction({
-      description: "查看 contact inbox。",
+      description: "View the contact inbox.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {} },
       },
-      examples: [{ title: "查看 inbox", payload: {} }],
+      examples: [{ title: "View inbox", payload: {} }],
       command: {
-        description: "查看 contact inbox",
+        description: "View the contact inbox.",
         mapInput() {
           return {};
         },
@@ -351,20 +351,20 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     receive: createAction({
-      description: "接收 inbox 中的 share。",
+      description: "Receive a share from the inbox.",
       input_schema: {
         zod: z.object({ shareId: z.string() }),
         json_schema: {
           type: "object",
           required: ["shareId"],
           properties: {
-            shareId: { type: "string", description: "inbox 中的 shareId" },
+            shareId: { type: "string", description: "Share ID from the inbox." },
           },
         },
       },
-      examples: [{ title: "接收 share", payload: { shareId: "share_1" } }],
+      examples: [{ title: "Receive share", payload: { shareId: "share_1" } }],
       command: {
-        description: "接收 inbox 中的 share",
+        description: "Receive a share from the inbox.",
         configure(command) {
           command.argument("<shareId>");
         },
@@ -383,7 +383,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     remoteping: createAction({
-      description: "处理远端 ping 请求（内部 endpoint）。",
+      description: "Handle a remote ping request (internal endpoint).",
       execute: async (params) => ({
         success: true,
         data: (await handlers.remotePing(
@@ -393,7 +393,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     remoteapprove: createAction({
-      description: "处理远端 approve 请求（内部 endpoint）。",
+      description: "Handle a remote approve request (internal endpoint).",
       execute: async (params) => ({
         success: true,
         data: (await handlers.remoteApprove(
@@ -403,7 +403,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     remoteconfirm: createAction({
-      description: "处理远端 confirm 请求（内部 endpoint）。",
+      description: "Handle a remote confirm request (internal endpoint).",
       execute: async (params) => ({
         success: true,
         data: (await handlers.remoteConfirm(
@@ -413,7 +413,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     remotechat: createAction({
-      description: "处理远端 chat 请求（内部 endpoint）。",
+      description: "Handle a remote chat request (internal endpoint).",
       execute: async (params) => {
         const payload = readContactObject(params.input);
         const body = readContactObject(payload.body);
@@ -428,7 +428,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       },
     }),
     remoteshare: createAction({
-      description: "处理远端 share 请求（内部 endpoint）。",
+      description: "Handle a remote share request (internal endpoint).",
       execute: async (params) => ({
         success: true,
         data: (await handlers.remoteShare(params.context, params.input)) as unknown as JsonValue,

package/src/contact/PROMPT.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/contact/PROMPT.ts.txt
-const TEXT_MODULE_CONTENT = "Contact plugin\n\ncontact plugin 用来管理和其他 agent 的联系方式。一个 contact 代表一个已建立联系的远端 agent，并固定拥有一条长期对话历史。contact 可以是单向的：只要本 agent 能访问对方，就可以 check、chat、share。\n\n可用 action：\n- `link`：生成一次性联系码，交给另一个 agent。\n- `approve`：使用对方给的联系码建立 contact。\n- `list`：查看已保存的 agent 联系方式。\n- `check`：检查对方是否在线可用。\n- `chat`：和某个 agent 对话。\n- `share`：分享文本、链接、文件或目录。\n- `inbox`：查看收到的分享。\n- `receive`：接收某条分享。\n\n边界：\n- chat 用于对话，share 用于资料交接。\n- `link` action 返回中的 notes 会说明联系码适合本机、局域网还是公网 agent 使用；本地 localhost 联系码不能交给 server agent approve。\n- public-looking endpoint 仍可能被防火墙/NAT 阻断；以返回的 notes 为准，不要承诺公网一定可达。\n- Agent runtime 会在可用时写入 `DOWNCITY_PUBLIC_HOST` 供 contact link 使用；这不是要求用户手动配置的 token 或 endpoint。\n- `approve` action 会先建立单向关系，再由对方主动 ping 回本 agent，ping 成功才升级为 bidirectional。\n- local/private agent 连接 public agent 时通常只能 outbound-only，不要说成双向。\n- contact token 由 link/approve 自动交换；不要要求用户手动配置 token 环境变量。\n- `Contact link not found` 表示请求打到的 agent runtime 没有这条 link 记录，优先检查 endpoint/端口/agent 是否一致；过期会明确返回 `Contact link expired`。\n- receive 只接收内容，不自动执行、不安装 skill、不修改项目业务文件。\n- 不自动 approve 或 receive，除非用户明确要求。\n";
+const TEXT_MODULE_CONTENT = "# Contact Plugin\n\nThe contact plugin manages ways to reach other agents. A contact represents an established remote-agent relationship and owns one long-lived conversation history. A contact may be one-way: as long as this agent can reach the other agent, it can `check`, `chat`, and `share`.\n\nAvailable actions:\n- `link`: create a one-time contact code for another agent.\n- `approve`: use a contact code from another agent to establish a contact.\n- `list`: view saved agent contacts.\n- `check`: check whether the other agent is online and reachable.\n- `chat`: talk with a contact.\n- `share`: share text, links, files, or directories.\n- `inbox`: view received shares.\n- `receive`: receive a share.\n\nBoundaries:\n- Use `chat` for conversation and `share` for handing over materials.\n- The notes returned by the `link` action explain whether a contact code is suitable for local-machine, LAN, or public agents. A localhost contact code must not be given to a server agent for `approve`.\n- A public-looking endpoint may still be blocked by firewall or NAT. Trust the returned notes, and do not promise that public access is guaranteed.\n- The Agent runtime writes `DOWNCITY_PUBLIC_HOST` when available for contact links. This is not a token or endpoint that the user must configure manually.\n- The `approve` action first establishes a one-way relationship. The other agent then pings back to this agent, and only a successful ping upgrades the relationship to bidirectional.\n- When a local/private agent connects to a public agent, the connection is usually outbound-only. Do not describe it as bidirectional.\n- Contact tokens are exchanged automatically by `link` and `approve`. Do not ask the user to manually configure token environment variables.\n- `Contact link not found` means the request reached an agent runtime that does not have this link record. First check whether the endpoint, port, and agent match. Expiration is reported explicitly as `Contact link expired`.\n- `receive` only receives content. It does not execute anything, install skills, or modify project business files automatically.\n- Do not automatically approve or receive unless the user explicitly asks.\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/contact/PROMPT.ts.txt

@@ -1,25 +1,25 @@
-Contact plugin
+# Contact Plugin
 
-contact plugin 用来管理和其他 agent 的联系方式。一个 contact 代表一个已建立联系的远端 agent，并固定拥有一条长期对话历史。contact 可以是单向的：只要本 agent 能访问对方，就可以 check、chat、share。
+The contact plugin manages ways to reach other agents. A contact represents an established remote-agent relationship and owns one long-lived conversation history. A contact may be one-way: as long as this agent can reach the other agent, it can `check`, `chat`, and `share`.
 
-可用 action：
-- `link`：生成一次性联系码，交给另一个 agent。
-- `approve`：使用对方给的联系码建立 contact。
-- `list`：查看已保存的 agent 联系方式。
-- `check`：检查对方是否在线可用。
-- `chat`：和某个 agent 对话。
-- `share`：分享文本、链接、文件或目录。
-- `inbox`：查看收到的分享。
-- `receive`：接收某条分享。
+Available actions:
+- `link`: create a one-time contact code for another agent.
+- `approve`: use a contact code from another agent to establish a contact.
+- `list`: view saved agent contacts.
+- `check`: check whether the other agent is online and reachable.
+- `chat`: talk with a contact.
+- `share`: share text, links, files, or directories.
+- `inbox`: view received shares.
+- `receive`: receive a share.
 
-边界：
-- chat 用于对话，share 用于资料交接。
-- `link` action 返回中的 notes 会说明联系码适合本机、局域网还是公网 agent 使用；本地 localhost 联系码不能交给 server agent approve。
-- public-looking endpoint 仍可能被防火墙/NAT 阻断；以返回的 notes 为准，不要承诺公网一定可达。
-- Agent runtime 会在可用时写入 `DOWNCITY_PUBLIC_HOST` 供 contact link 使用；这不是要求用户手动配置的 token 或 endpoint。
-- `approve` action 会先建立单向关系，再由对方主动 ping 回本 agent，ping 成功才升级为 bidirectional。
-- local/private agent 连接 public agent 时通常只能 outbound-only，不要说成双向。
-- contact token 由 link/approve 自动交换；不要要求用户手动配置 token 环境变量。
-- `Contact link not found` 表示请求打到的 agent runtime 没有这条 link 记录，优先检查 endpoint/端口/agent 是否一致；过期会明确返回 `Contact link expired`。
-- receive 只接收内容，不自动执行、不安装 skill、不修改项目业务文件。
-- 不自动 approve 或 receive，除非用户明确要求。
+Boundaries:
+- Use `chat` for conversation and `share` for handing over materials.
+- The notes returned by the `link` action explain whether a contact code is suitable for local-machine, LAN, or public agents. A localhost contact code must not be given to a server agent for `approve`.
+- A public-looking endpoint may still be blocked by firewall or NAT. Trust the returned notes, and do not promise that public access is guaranteed.
+- The Agent runtime writes `DOWNCITY_PUBLIC_HOST` when available for contact links. This is not a token or endpoint that the user must configure manually.
+- The `approve` action first establishes a one-way relationship. The other agent then pings back to this agent, and only a successful ping upgrades the relationship to bidirectional.
+- When a local/private agent connects to a public agent, the connection is usually outbound-only. Do not describe it as bidirectional.
+- Contact tokens are exchanged automatically by `link` and `approve`. Do not ask the user to manually configure token environment variables.
+- `Contact link not found` means the request reached an agent runtime that does not have this link record. First check whether the endpoint, port, and agent match. Expiration is reported explicitly as `Contact link expired`.
+- `receive` only receives content. It does not execute anything, install skills, or modify project business files automatically.
+- Do not automatically approve or receive unless the user explicitly asks.

package/src/contact/runtime/ChatRuntime.ts

@@ -8,13 +8,13 @@
 
 import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
 import type { ContactChatResponse } from "@/contact/types/ContactChat.js";
-import type { SessionMessageV1 } from "@downcity/agent/internal/executor/types/SessionMessages.js";
+import type { SessionRecordV1 } from "@downcity/agent/internal/executor/types/SessionRecords.js";
 import {
   appendContactMessage,
   findContactByInboundToken,
 } from "./ContactStore.js";
 
-function extractMessageText(message: SessionMessageV1 | null | undefined): string {
+function extractMessageText(message: SessionRecordV1 | null | undefined): string {
   const parts = Array.isArray((message as { parts?: unknown } | null)?.parts)
     ? ((message as { parts: unknown[] }).parts)
     : [];

package/src/image/ImagePlugin.ts

@@ -535,31 +535,31 @@ export class ImagePlugin extends BasePlugin {
       "",
       "## Actions",
       "",
-      "- `models`：列出当前可用的图片模型，返回 `{ models }`。",
-      "  当你不知道应该使用哪个模型，且插件没有默认图片模型时先调用，并让用户或当前任务上下文明确模型 ID。",
-      "- `image_create`：在用户明确确认后创建一个异步图片任务，返回 `{ job_id, status }`。",
-      "  - 纯文本生成：填 `prompt`（字符串）。",
-      "  - 编辑 / 参考图：填 `content`，格式：",
-      "    `[{ type: \"text\", text }, { type: \"image\", url }]`。可以多段文本和多张图任意顺序混排。",
-      "  - 同时给了 `content` 和 `prompt` 时，`content` 生效，`prompt` 被忽略。",
-      "  - `url` 支持三种写法：在线 URL、绝对本地路径、相对 Agent 项目根目录的相对路径。",
-      "    不要传 base64 / data URL，也不要再用旧的 `messages` 字段。",
-      "  - `model` 可选；未传时使用插件配置的默认图片模型。可选参数：`aspect_ratio`（如 `16:9`）、`size`（如 `1024x1024`）、`quality`、`seed`。",
-      "- `image_result`：用 `job_id` 读取任务状态。",
-      "  - 默认读取一次。`queued` / `running` 时保存好 `job_id`，下一轮再查，不要在同一轮里反复轮询。",
-      "  - 想直接等到出图，可以传 `until_done: true`，可选 `max_wait_ms`（默认 60000，最长 600000）与 `poll_interval_ms`（默认 1500）。超时仍未完成会返回最后一次的中间状态。",
-      "  - `succeeded`：返回的图片 file part 会自动落盘并附加到下一条 assistant 消息，无需自己再拼图。",
-      "  - 回复用户时，可以在消息中使用 Markdown 图片语法 `![](url)` 渲染图片。",
-      "  - `failed`：把 `error` 信息如实回报给用户，不要编造图片结果。",
+      "- `models`: list currently available image models and return `{ models }`.",
+      "  Call this first when you do not know which model to use and the plugin has no default image model. Let the user or current task context specify the model ID.",
+      "- `image_create`: create an async image job after explicit user confirmation, returning `{ job_id, status }`.",
+      "  - Text-only generation: pass `prompt` as a string.",
+      "  - Edits or reference images: pass `content` in this shape:",
+      "    `[{ type: \"text\", text }, { type: \"image\", url }]`. Multiple text parts and images may appear in any order.",
+      "  - If both `content` and `prompt` are provided, `content` takes effect and `prompt` is ignored.",
+      "  - `url` supports three forms: online URL, absolute local path, or a relative path from the Agent project root.",
+      "    Do not pass base64/data URLs, and do not use the legacy `messages` field.",
+      "  - `model` is optional. If omitted, the plugin-configured default image model is used. Optional parameters include `aspect_ratio` such as `16:9`, `size` such as `1024x1024`, `quality`, and `seed`.",
+      "- `image_result`: read job status by `job_id`.",
+      "  - By default, read once. If the status is `queued` or `running`, save the `job_id` and check again in a later turn; do not repeatedly poll in the same turn.",
+      "  - To wait for the image directly, pass `until_done: true` with optional `max_wait_ms` (default 60000, max 600000) and `poll_interval_ms` (default 1500). If the wait times out, the latest intermediate status is returned.",
+      "  - `succeeded`: returned image file parts are automatically written to disk and attached to the next assistant message. You do not need to assemble the image manually.",
+      "  - When replying to the user, you can render images with Markdown image syntax: `![](url)`.",
+      "  - `failed`: report the `error` truthfully to the user. Do not invent image results.",
       "",
       "## Flow",
       "",
-      "1. 如果插件没有默认图片模型，先确认模型 ID；需要选模型时调用 `models`。",
-      "2. 向用户说明将消耗图片生成额度，并等待用户明确确认。",
-      "3. 用户确认后调用 `image_create` 拿到 `job_id`。",
-      "4. `image_result` 查询；短任务可加 `until_done: true` 一次拿结果，长任务保存 `job_id` 下一轮再查。",
+      "1. If the plugin has no default image model, confirm the model ID first; call `models` when model selection is needed.",
+      "2. Explain to the user that image generation will consume image quota, and wait for explicit confirmation.",
+      "3. After the user confirms, call `image_create` to get a `job_id`.",
+      "4. Query with `image_result`; short jobs may use `until_done: true` to get the result in one call, while long jobs should save the `job_id` and check again in a later turn.",
       "",
-      "如有疑问可用 `plugin_read { plugin: \"image\", action: \"...\" }` 查看每个 action 完整的输入 schema 与示例。",
+      "When unsure, use `plugin_read { plugin: \"image\", action: \"...\" }` to inspect each action's complete input schema and examples.",
     ].join("\n");
   }
 

package/src/memory/Action.ts

@@ -268,9 +268,9 @@ export async function digestMemoryAction(
       ? Math.max(1, Math.floor(payload.maxMessages as number))
       : 30;
     const historyStore = context.session.get(sessionId).getHistoryStore();
-    const total = await historyStore.size();
+    const total = await historyStore.record_count();
     const start = Math.max(0, total - maxMessages);
-    const messages = await historyStore.slice(start, total);
+    const messages = await historyStore.slice_records(start, total);
     const lines = messages
       .map((msg) => extractReadableLine(msg))
       .filter((line) => line.length > 0);