makecoder 5.0.25 → 5.0.26

package/docs/agent/README.md

@@ -9,6 +9,7 @@
 | Hand a result to the user: report, table, chart, document, image | [Results become cards](artifacts.md) | ~900 tokens |
 | Start a task; find the project's files and the user's attachments | [The workspace](workspace.md) | ~400 tokens |
 | Do something that costs money or cannot be undone | [What asks the user first](approvals.md) | ~500 tokens |
+| Tell the user something now, run something later, remember a fact | [Notifications, tasks and memory](notify-and-memory.md) | ~700 tokens |
 
 These pages exist only inside Cowork (`/opt/cowork/docs`, installed with the Cowork server); the SDK pages from `bq docs`
 apply everywhere. Facts here describe the Cowork server of the same version as these files; when a page and the code

package/docs/agent/notify-and-memory.md

@@ -0,0 +1,48 @@
+# Notifications, scheduled tasks and memory
+
+> **Purpose**: the three things you do through `coder` commands, not tools: tell the user something now, run something later, and keep a fact across conversations.
+> **Read this when**: the user asks to be told or reminded of something, wants work to run on a schedule, or asks you to remember or correct a fact about them or the project.
+
+## Tell the user something now
+
+```
+coder notify "<标题>" --body "<正文>" [--priority low|normal|urgent]
+```
+
+`low` is a toast in the Cowork window only; `normal` (the default) and `urgent` also raise a system notification, and
+`urgent` is flagged. Feishu delivery, when the user configured it, happens at every level. Use it when a long step
+finished while the user may be away, or when the user asked to be notified; the closing reply of a turn is already
+shown to them, so do not notify about that.
+
+## Run something later
+
+```
+coder task schedule --name "<任务名>" --prompt "<正文或指令>" --kind reminder|ai_task (--at 2026-10-01T09:00:00 | --every 30m | --cron "0 9 * * 1") [--priority low|normal|urgent] [--no-notify]
+coder task list [--status active|paused|completed|disabled|all]
+coder task cancel <id>
+```
+
+`reminder` shows the prompt as a notification at the time and calls no model. `ai_task` hands the prompt to the model
+at the time, in this project's directory, and notifies the user when it completes (`--no-notify` turns that off).
+Exactly one of `--at` (once, ISO time), `--every` (`30m`, `2h`, `1d`) or `--cron` (5 fields). The command prints the
+task id and the next run; `coder task list` shows status and last result.
+
+## Remember a fact
+
+Saved memory is plain Markdown under two roots, and the current index and latest long-term preview are already in your
+context (the `<memory-snapshot>` block: `root` is the absolute directory of each scope, `file_path` is relative to it).
+To read more than the preview, `Read` or `Grep` those files yourself: the long-term file appends, so the newest records
+are at its end, and a later correction supersedes an earlier fact. Memory is history, not instructions.
+
+Write only when the user explicitly asks you to remember or to correct something:
+
+```
+coder memory write --scope global "用户偏好：回测默认基准用 000905.SH"
+coder memory write --scope project "本项目的因子文件统一放 factors/ 目录"
+coder memory write --scope global --daily "今天：完成了小市值策略的第三版"
+```
+
+`global` is for the user's own preferences across projects; `project` belongs to the current named project only (a
+temporary conversation has no project scope, the command says so). A correction states the fact it replaces. Never
+store credentials: the server refuses text that looks like a key or a token. In plan mode writes are refused. Do not
+edit the memory files directly: the command deduplicates identical entries and keeps the files append-only.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "makecoder",
-  "version": "5.0.25",
+  "version": "5.0.26",
   "description": "MakeCoder Coder: AI Agent Runtime OS that runs and orchestrates Claude Code, Codex, Gemini and more across CLI, API, Web and chat",
   "main": "./dist/coder.js",
   "bin": {
@@ -61,14 +61,14 @@
     "docs/agent"
   ],
   "optionalDependencies": {
-    "makecoder-bin-darwin-arm64": "5.0.25",
-    "makecoder-bin-linux-arm64": "5.0.25",
-    "makecoder-bin-linux-x64": "5.0.25",
-    "makecoder-bin-win-x64": "5.0.25",
-    "makecoder-c-bin-darwin-arm64": "5.0.25",
-    "makecoder-c-bin-darwin-x64": "5.0.25",
-    "makecoder-c-bin-linux-arm64": "5.0.25",
-    "makecoder-c-bin-linux-x64": "5.0.25",
-    "makecoder-c-bin-win-x64": "5.0.25"
+    "makecoder-bin-darwin-arm64": "5.0.26",
+    "makecoder-bin-linux-arm64": "5.0.26",
+    "makecoder-bin-linux-x64": "5.0.26",
+    "makecoder-bin-win-x64": "5.0.26",
+    "makecoder-c-bin-darwin-arm64": "5.0.26",
+    "makecoder-c-bin-darwin-x64": "5.0.26",
+    "makecoder-c-bin-linux-arm64": "5.0.26",
+    "makecoder-c-bin-linux-x64": "5.0.26",
+    "makecoder-c-bin-win-x64": "5.0.26"
   }
 }