@rien7/agent-center-host 0.0.0-stage → 0.1.1

package/dist/prompt.js

@@ -0,0 +1,82 @@
+/**
+ * What the model is told: the system prompt (once per session) and the prefix of each
+ * user message (time, page context, memory, the context's domain tools).
+ */
+import { contextDomains, localNow } from "./center-tools.js";
+export function systemPrompt(options) {
+    return `你是「${options.name}」，用户在 Agent Center 里的个人助手。${options.role ? `\n你的角色：${options.role}` : ""}
+
+## 怎么回答
+- 用中文，简短、直接，像熟人说话。先给结论，再给必要的细节。
+- 不要把 URI、ID、工具名这些内部标识说给用户；用标题、时间、地点这些人看得懂的说法。
+- 你写入数据后，App 会在回复下面显示那条记录的卡片，不用把所有字段再念一遍。
+- 用户的时区是 ${options.timeZone}。每条消息开头的 [时间] 是现在的本地时间；「明天」「下周一」按它算。
+
+## 用户的数据（Center）
+需要查或改数据时，先确定是哪个域，再：
+1. tools_search({domain}) 列出那个域的全部工具（或 tools_search({query}) 按关键词找）；
+2. tool_describe({name}) 看参数；
+3. tool_call({name, input}) 调用。
+不要猜工具名或参数。today_overview 一次给出某天的日程、提醒和到访地点，问「今天/明天有什么」先用它。消息里 [当前页面的工具] 已经给出了完整参数的工具，可以直接 tool_call。
+
+Center 里的域（域名 标题：内容 — 工具，工具全名是「域名_工具」，如 reminder_item_create）：
+${options.catalog}
+
+## 历史
+想不起来的事（以前聊过什么、让你做过什么）先用 agent_search_query 搜聊天记录，再回答。
+
+## 记忆
+工作目录里 memory/MEMORY.md 是你的长期记忆索引，memory/notes/*.md 是笔记，都用文件工具（读/写/改）直接改。
+- 回答前先看记忆（MEMORY.md 有变化时会附在消息开头的 [记忆] 里）。
+- 对话里出现值得长期记住的事（用户的偏好、约定、身边的人、反复提到的事），在这轮结束前写进 memory/notes/ 下合适的文件，并在 MEMORY.md 里加一行索引。
+- 只改 memory/ 下的文件，不碰别的文件。MEMORY.md 保持简短（几十行以内）。${options.parent
+        ? `
+
+## 你是子 agent
+你是「${options.parent}」开的子 agent，专门做它交给你的事。带 [来源] 的消息是它发来的，不是用户本人；用户也可能在 App 里直接和你聊。
+- 做完一件事，最后一段回复就是你的报告，会原样交给「${options.parent}」：写清楚结果（要点、数字、日期），不要寒暄。
+- 你不能再开子 agent。`
+        : ""}${options.subagents
+        ? `
+
+## 子 agent
+费时、可以独立做完的事（比如整理一段时间的日程和提醒、把一类备忘归纳成总结）可以交给子 agent：agent_spawn 开一个（名字简短，task 写完整），它在后台做，用户在 App 里能看到它。
+- 这一轮就要结果：agent_wait 等它的报告；不等也行，报告到了会作为一条带 [来源] 的消息送回给你，那时用一两句话告诉用户结果。
+- 要补充或追问用 agent_send；用完不再需要的用 agent_close。简单的事自己做，不要开子 agent。`
+        : ""}`;
+}
+/** The text of a turn a host restart cut off, run again. */
+export const interruptedText = (text) => `上一轮被打断，请继续。（host 重启了，你上一轮的回复没说完；用户原来的消息如下）\n\n${text}`;
+const page = {
+    today: "今天",
+    timeline: "时间线",
+};
+/** `[上下文] …` for the app's chat context (the page or record the user is looking at). */
+export function contextLine(context) {
+    const c = context;
+    if (!c?.kind)
+        return null;
+    if (c.kind.type === "page") {
+        const name = page[c.kind.page ?? ""] ?? c.label ?? c.kind.page;
+        return `[上下文] 用户正在看「${name}」页${c.kind.day ? `（${c.kind.day}）` : ""}`;
+    }
+    if (c.kind.type === "entity" && c.kind.uri?.startsWith("agent:conversation/"))
+        return `[来源] ${c.label ?? "另一个 agent"}（不是用户本人发的）`;
+    if (c.kind.type === "entity")
+        return `[上下文] 用户正在看一条记录「${c.label ?? ""}」（${c.kind.uri}，可用 core_entity_get 读取）`;
+    return null;
+}
+export function turnText(text, parts) {
+    const lines = [
+        `[时间] ${localNow(parts.timeZone, parts.now)}（${parts.timeZone}）`,
+    ];
+    const context = contextLine(parts.context);
+    if (context)
+        lines.push(context);
+    if (parts.memory)
+        lines.push(`[记忆] memory/MEMORY.md：\n${parts.memory.trim()}\n[/记忆]`);
+    if (parts.tools)
+        lines.push(`[当前页面的工具]\n${parts.tools}\n[/当前页面的工具]`);
+    return `${lines.join("\n")}\n\n${text}`;
+}
+export { contextDomains };

package/dist/tool-titles.js

@@ -0,0 +1,157 @@
+/**
+ * User-facing Chinese titles for tool calls. Core tools are named `<domain>_<noun>_<verb>`
+ * (op name with dots → underscores). Runtimes prefix MCP tools with the server name
+ * (`mcp__center__tool_call`), and `tool_call` wraps the real tool, so a call is titled
+ * by the inner name: 「新建提醒」, never 「tool_call」.
+ */
+export const domainTitles = {
+    reminder: "提醒",
+    calendar: "日程",
+    memo: "备忘",
+    people: "联系人",
+    location: "地点",
+    ledger: "账本",
+    inbox: "通知",
+    telemetry: "健康",
+    agent: "助手",
+    core: "通用",
+};
+/** Exact titles for the common tools. */
+const exact = {
+    // host-served
+    tools_search: "查找工具",
+    tool_describe: "查看工具说明",
+    today_overview: "查看今天概况",
+    agent_search_query: "搜索聊天记录",
+    agent_spawn: "开子 agent",
+    agent_send: "给子 agent 发消息",
+    agent_wait: "等子 agent 的报告",
+    agent_close: "结束子 agent",
+    // core
+    reminder_item_list: "查询提醒",
+    reminder_item_create: "新建提醒",
+    reminder_item_update: "修改提醒",
+    reminder_item_complete: "完成提醒",
+    reminder_item_uncomplete: "重新打开提醒",
+    reminder_item_delete: "删除提醒",
+    calendar_event_list: "查询日程",
+    calendar_event_create: "新建日程",
+    calendar_event_update: "修改日程",
+    calendar_event_delete: "删除日程",
+    memo_note_list: "查询备忘",
+    memo_note_create: "新建备忘",
+    memo_note_update: "修改备忘",
+    memo_note_delete: "删除备忘",
+    people_person_list: "查询联系人",
+    location_visit_list: "查询到访记录",
+    location_visit_days: "查询到访日期",
+    location_place_search: "查找地点",
+    location_place_nearby: "查找附近地点",
+    location_search_query: "搜索地点",
+    core_timeline_search: "搜索时间线",
+    core_timeline_list: "查询时间线",
+    core_entity_get: "读取记录",
+    core_link_list: "查询关联",
+    core_review_list: "查询待确认事项",
+    agent_message_list: "读取聊天记录",
+    agent_conversation_list: "查询对话",
+    ledger_transaction_list: "查询账单",
+    ledger_report_summary: "查看账本汇总",
+    telemetry_sleep_summary: "查看睡眠",
+    telemetry_steps_metric: "查看步数",
+};
+const verbs = [
+    [/_(create|add)$/, "新建"],
+    [/_(update|set|move)$/, "修改"],
+    [/_(delete|remove|purge)$/, "删除"],
+    [/_complete$/, "完成"],
+    [/_(search|query)$/, "搜索"],
+    [
+        /_(list|get|getMany|summary|metric|series|stats|days|bounds|balance)$/,
+        "查询",
+    ],
+];
+/** Built-in runtime tools (pi: read/edit/write; Claude Code: Read/Edit/Write/…). */
+function builtinTitle(name, input) {
+    const path = String(input?.path ?? input?.file_path ?? input?.filePath ?? "");
+    const memory = /(^|\/)memory\//.test(path) || /MEMORY\.md$/.test(path);
+    switch (name.toLowerCase()) {
+        case "read":
+            return memory ? "读取记忆" : "读取文件";
+        case "write":
+            return memory ? "写入记忆" : "写入文件";
+        case "edit":
+        case "multiedit":
+            return memory ? "更新记忆" : "修改文件";
+        case "ls":
+        case "glob":
+        case "find":
+        case "grep":
+            return "查找文件";
+        case "bash":
+            return "运行命令";
+        case "todowrite":
+            return "整理待办";
+        default:
+            return null;
+    }
+}
+/** Drop a runtime's MCP prefix: `mcp__center__x` → `x`. */
+export const bareToolName = (name) => name.replace(/^mcp__[A-Za-z0-9-]+__/, "");
+/** Fallback for a core tool without an exact title: by verb, then by domain. */
+export function coreToolTitle(name, readOnly) {
+    if (exact[name])
+        return exact[name];
+    const domain = name.split("_")[0] ?? "";
+    const subject = domainTitles[domain] ?? domain;
+    for (const [pattern, verb] of verbs)
+        if (pattern.test(name))
+            return `${verb}${subject}`;
+    return readOnly === false ? `修改${subject}数据` : `读取${subject}数据`;
+}
+export function toolTitle(name, input = null) {
+    const bare = bareToolName(name);
+    if (bare !== name || exact[bare] || bare.includes("_"))
+        return coreToolTitle(bare);
+    return builtinTitle(bare, input) ?? "使用工具";
+}
+const clip = (text, max) => {
+    const chars = Array.from(text.replace(/\s+/g, " ").trim());
+    return chars.length > max
+        ? `${chars.slice(0, max).join("")}…`
+        : chars.join("");
+};
+/** A one-line summary of a call's input for the step detail. */
+export function inputDetail(input, max = 60) {
+    if (input === null || input === undefined)
+        return null;
+    if (typeof input !== "object")
+        return clip(String(input), max);
+    const o = input;
+    for (const key of [
+        "title",
+        "q",
+        "query",
+        "name",
+        "agent",
+        "text",
+        "body",
+        "path",
+        "file_path",
+        "date",
+        "domain",
+    ])
+        if (typeof o[key] === "string" && o[key])
+            return clip(o[key], max);
+    // A time range: 11月4日, or 11月4日–11月6日 (the dates as written, no zone math).
+    const day = (v) => {
+        const m = typeof v === "string" && /^\d{4}-(\d{2})-(\d{2})/.exec(v);
+        return m ? `${Number(m[1])}月${Number(m[2])}日` : null;
+    };
+    const from = day(o.from ?? o.start);
+    const to = day(o.to ?? o.end);
+    if (from || to)
+        return from && to && from !== to ? `${from}–${to}` : (from ?? `到 ${to}`);
+    const json = JSON.stringify(o);
+    return json === "{}" ? null : clip(json, max);
+}

package/dist/wire.js

@@ -0,0 +1,6 @@
+/**
+ * Wire shapes of the agent domain as the host sees them (domains/agent/src/contract.ts).
+ * Kept here as plain types so the host has no dependency on the server packages; the
+ * integration test runs against the real server, so drift shows up there.
+ */
+export {};

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@rien7/agent-center-host",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "license": "MIT",
+  "description": "Agent host for Agent Center: claims queued turns and answers them through a driver (an oar runtime: Claude Code, pi; or echo). Node 24+.",
+  "keywords": [
+    "agent-center",
+    "agent",
+    "claude-code",
+    "oar"
+  ],
+  "homepage": "https://github.com/rien7/agent-center/tree/main/packages/agent-host#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rien7/agent-center.git",
+    "directory": "packages/agent-host"
+  },
+  "bugs": "https://github.com/rien7/agent-center/issues",
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "bin": {
+    "agent-center-host": "dist/cli.js",
+    "agent-host": "dist/cli.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node src/cli.ts",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc -p .",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "@agent-center/agent": "workspace:*",
+    "@agent-center/kit": "workspace:*"
+  },
+  "dependencies": {
+    "@botiverse/oar": "0.86.0"
+  }
+}