@downcity/agent 1.1.7 → 1.1.10

package/src/service/builtins/chat/types/ChatService.ts

@@ -0,0 +1,165 @@
+/**
+ * ChatService 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里集中声明 chat service action 的输入 payload。
+ * - 这些类型属于跨模块共享契约，因此统一放到 `types/` 下。
+ * - 字段命名保持与 CLI/API 参数一致，降低映射心智负担。
+ */
+
+import type { JsonValue } from "@/utils/types/Json.js";
+import type {
+  ChatDeleteRequest,
+  ChatHistoryRequest,
+  ChatInfoRequest,
+  ChatListRequest,
+  ChatReactRequest,
+} from "@/service/builtins/chat/types/ChatCommand.js";
+import type { ChatChannelName } from "@/service/builtins/chat/types/ChannelStatus.js";
+
+/**
+ * `chat.send` action 的输入载荷。
+ */
+export type ChatSendActionPayload = {
+  /**
+   * 要发送的正文文本。
+   */
+  text: string;
+  /**
+   * 目标 chatKey；未显式传入时可由执行上下文补全。
+   */
+  chatKey?: string;
+  /**
+   * 延迟发送毫秒数；与 `sendAtMs` 互斥。
+   */
+  delayMs?: number;
+  /**
+   * 绝对发送时间戳（毫秒）；与 `delayMs` 互斥。
+   */
+  sendAtMs?: number;
+  /**
+   * 是否使用 reply_to_message 语义回复目标消息。
+   */
+  replyToMessage?: boolean;
+  /**
+   * 显式指定目标消息 ID；通常用于 reply/react 等场景。
+   */
+  messageId?: string;
+};
+
+/**
+ * 读取会话上下文类 action 的输入载荷。
+ */
+export type ChatSessionActionPayload = {
+  /**
+   * 目标 chatKey；与 sessionId 二选一即可。
+   */
+  chatKey?: string;
+  /**
+   * 目标 sessionId；优先级高于 chatKey。
+   */
+  sessionId?: string;
+};
+
+/**
+ * `chat.history` action 的输入载荷。
+ */
+export type ChatHistoryActionPayload = ChatHistoryRequest;
+
+/**
+ * `chat.react` action 的输入载荷。
+ */
+export type ChatReactActionPayload = ChatReactRequest;
+
+/**
+ * `chat.delete` action 的输入载荷。
+ */
+export type ChatDeleteActionPayload = ChatDeleteRequest;
+
+/**
+ * `chat.list` action 的输入载荷。
+ */
+export type ChatListActionPayload = ChatListRequest;
+
+/**
+ * `chat.info` action 的输入载荷。
+ */
+export type ChatInfoActionPayload = ChatInfoRequest;
+
+/**
+ * `chat.status` action 的输入载荷。
+ */
+export type ChatStatusActionPayload = {
+  /**
+   * 指定目标渠道；省略时表示全部渠道。
+   */
+  channel?: ChatChannelName;
+};
+
+/**
+ * `chat.test` action 的输入载荷。
+ */
+export type ChatTestActionPayload = {
+  /**
+   * 指定目标渠道；省略时表示全部渠道。
+   */
+  channel?: ChatChannelName;
+};
+
+/**
+ * `chat.reconnect` action 的输入载荷。
+ */
+export type ChatReconnectActionPayload = {
+  /**
+   * 指定目标渠道；省略时表示全部渠道。
+   */
+  channel?: ChatChannelName;
+};
+
+/**
+ * `chat.open` action 的输入载荷。
+ */
+export type ChatOpenActionPayload = {
+  /**
+   * 指定目标渠道；省略时表示全部渠道。
+   */
+  channel?: ChatChannelName;
+};
+
+/**
+ * `chat.close` action 的输入载荷。
+ */
+export type ChatCloseActionPayload = {
+  /**
+   * 指定目标渠道；省略时表示全部渠道。
+   */
+  channel?: ChatChannelName;
+};
+
+/**
+ * `chat.configuration` action 的输入载荷。
+ */
+export type ChatConfigurationActionPayload = {
+  /**
+   * 指定目标渠道；省略时表示全部渠道。
+   */
+  channel?: ChatChannelName;
+};
+
+/**
+ * `chat.configure` action 的输入载荷。
+ */
+export type ChatConfigureActionPayload = {
+  /**
+   * 要更新的目标渠道。
+   */
+  channel: ChatChannelName;
+  /**
+   * 渠道配置 patch；值类型遵循 channel configuration 元信息。
+   */
+  config: Record<string, JsonValue>;
+  /**
+   * 配置完成后是否立即重启目标渠道；默认由上层解释为 true。
+   */
+  restart?: boolean;
+};

package/src/service/builtins/contact/ContactService.ts

@@ -10,8 +10,8 @@
 import type { Command } from "commander";
 import type { AgentRuntime } from "@/agent/AgentRuntimeTypes.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { JsonObject, JsonValue } from "@/shared/types/Json.js";
-import type { ServiceActions } from "@/shared/types/Service.js";
+import type { JsonObject, JsonValue } from "@/utils/types/Json.js";
+import type { ServiceActions } from "@/service/types/Service.js";
 import { BaseService } from "@/service/builtins/BaseService.js";
 import type {
   ContactApproveCommandPayload,

package/src/service/builtins/contact/PROMPT.ts

@@ -0,0 +1,9 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+
+// Source: src/service/builtins/contact/PROMPT.ts.txt
+const TEXT_MODULE_CONTENT = "Contact service\n\ncontact service 用来管理和其他 agent 的联系方式。一个 contact 代表一个已建立联系的远端 agent，并固定拥有一条长期对话历史。contact 可以是单向的：只要本 agent 能访问对方，就可以 check、chat、share。\n\n可用命令：\n- `city contact link`：生成一次性联系码，交给另一个 agent。\n- `city contact approve <code>`：使用对方给的联系码建立 contact。\n- `city contact list`：查看已保存的 agent 联系方式。\n- `city contact check <contact>` / `city contact check --to <ip:port>`：检查对方是否在线可用。\n- `city contact chat --to <contact> \"<message>\"`：和某个 agent 对话。\n- `city contact share --to <contact> --text ... | --link ... | <path...>`：分享文本、链接、文件或目录。\n- `city contact inbox`：查看收到的分享。\n- `city contact receive <share_id>`：接收某条分享。\n\n边界：\n- chat 用于对话，share 用于资料交接。\n- `city contact link` 返回中的 notes 会说明联系码适合本机、局域网还是公网 agent 使用；本地 localhost 联系码不能交给 server agent approve。\n- public-looking endpoint 仍可能被防火墙/NAT 阻断；以返回的 notes 为准，不要承诺公网一定可达。\n- `city start` 会自动写入 `DOWNCITY_PUBLIC_HOST` 供 contact link 使用；这不是要求用户手动配置的 token 或 endpoint。\n- `city contact approve` 会先建立单向关系，再由对方主动 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";
+
+export default TEXT_MODULE_CONTENT;

package/src/service/builtins/contact/runtime/ChatRuntime.ts

@@ -8,7 +8,7 @@
 
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
 import type { ContactChatResponse } from "@/service/builtins/contact/types/ContactChat.js";
-import type { SessionMessageV1 } from "@/types/session/SessionMessages.js";
+import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
 import {
   appendContactMessage,
   findContactByInboundToken,

package/src/service/builtins/contact/runtime/ContactPromptAssets.ts

@@ -0,0 +1,14 @@
+/**
+ * ContactPromptAssets：contact service 静态提示词资产。
+ *
+ * 关键点（中文）
+ * - contact prompt 文本真实来源是 `PROMPT.ts.txt`。
+ * - 这里统一做 `trim()`，避免运行时行为漂移。
+ */
+
+import contactPromptText from "@/service/builtins/contact/PROMPT.js";
+
+/**
+ * contact service system prompt。
+ */
+export const CONTACT_SERVICE_PROMPT = contactPromptText.trim();

package/src/service/builtins/contact/runtime/RemoteClient.ts

@@ -6,7 +6,7 @@
  * - 已建联后的敏感调用必须携带 contact token。
  */
 
-import type { JsonValue } from "@/shared/types/Json.js";
+import type { JsonValue } from "@/utils/types/Json.js";
 
 type JsonRecord = Record<string, unknown>;
 

package/src/service/builtins/contact/runtime/SystemProvider.ts

@@ -3,20 +3,13 @@
  *
  * 关键点（中文）
  * - session system composer 通过静态 provider 清单读取 service system。
- * - contact prompt 在这里统一读取，避免 service 实例和 system 域产生耦合。
+ * - contact prompt 在这里统一暴露，避免 service 实例和 system 域产生耦合。
  */
-
-import { readFileSync } from "node:fs";
-
-const CONTACT_PROMPT_FILE_URL = new URL("../PROMPT.txt", import.meta.url);
+import { CONTACT_SERVICE_PROMPT } from "@/service/builtins/contact/runtime/ContactPromptAssets.js";
 
 /**
  * 构建 contact service system 文本。
  */
 export function buildContactServiceSystemText(): string {
-  try {
-    return readFileSync(CONTACT_PROMPT_FILE_URL, "utf-8").trim();
-  } catch {
-    return "";
-  }
+  return CONTACT_SERVICE_PROMPT;
 }

package/src/service/builtins/memory/Action.ts

@@ -6,21 +6,22 @@
  * - 所有动作统一返回结构化结果，失败不抛给上层。
  */
 
-import type { ServiceActionResult } from "@/shared/types/Service.js";
+import type { ServiceActionResult } from "@/service/types/Service.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { JsonValue } from "@/shared/types/Json.js";
+import type { JsonValue } from "@/utils/types/Json.js";
 import type {
   MemoryFlushPayload,
   MemoryGetPayload,
-  MemoryIndexPayload,
   MemorySearchPayload,
   MemoryStorePayload,
 } from "@/service/builtins/memory/types/Memory.js";
 import { flushMemory } from "./runtime/Flush.js";
-import { searchMemory } from "./runtime/Search.js";
+import {
+  collectMemoryStatus,
+  searchMemory,
+} from "./runtime/Search.js";
 import {
   MEMORY_DEFAULTS,
-  ensureMemoryIndexed,
   type MemoryRuntimeState,
 } from "./runtime/Store.js";
 import { getMemory, storeMemory } from "./runtime/Writer.js";
@@ -33,23 +34,10 @@ export async function statusMemoryAction(
   state: MemoryRuntimeState,
 ): Promise<ServiceActionResult<JsonValue>> {
   try {
-    const stats = state.indexer.status();
+    const stats = await collectMemoryStatus(context, state);
     return {
       success: true,
-      data: {
-        enabled: state.enabled,
-        backend: "builtin",
-        mode: "fts",
-        dbPath: state.indexer.getRelativeDbPath(),
-        dirty: state.dirty,
-        files: stats.files,
-        chunks: stats.chunks,
-        sourceCounts: stats.sourceCounts,
-        ...(typeof state.lastSyncAt === "number"
-          ? { lastSyncAt: state.lastSyncAt }
-          : {}),
-        ...(state.lastError ? { lastError: state.lastError } : {}),
-      } as unknown as JsonValue,
+      data: stats as unknown as JsonValue,
     };
   } catch (error) {
     return {
@@ -59,35 +47,6 @@ export async function statusMemoryAction(
   }
 }
 
-/**
- * index action。
- */
-export async function indexMemoryAction(
-  context: AgentContext,
-  state: MemoryRuntimeState,
-  payload: MemoryIndexPayload,
-): Promise<ServiceActionResult<JsonValue>> {
-  try {
-    const result = await ensureMemoryIndexed(context, state, {
-      force: payload.force === true,
-      reason: payload.force ? "manual-force" : "manual",
-    });
-    const status = state.indexer.status();
-    const data = {
-      totalFiles: result?.totalFiles ?? status.files,
-      reindexedFiles: result?.reindexedFiles ?? 0,
-      removedFiles: result?.removedFiles ?? 0,
-      totalChunks: result?.totalChunks ?? 0,
-    };
-    return { success: true, data: data as unknown as JsonValue };
-  } catch (error) {
-    return {
-      success: false,
-      error: String(error),
-    };
-  }
-}
-
 /**
  * search action。
  */

package/src/service/builtins/memory/MemoryService.ts

@@ -8,14 +8,13 @@
  */
 
 import type { Command } from "commander";
-import type { JsonObject, JsonValue } from "@/shared/types/Json.js";
+import type { JsonObject, JsonValue } from "@/utils/types/Json.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { ServiceActions } from "@/shared/types/Service.js";
+import type { ServiceActions } from "@/service/types/Service.js";
 import { BaseService } from "@/service/builtins/BaseService.js";
 import {
   flushMemoryAction,
   getMemoryAction,
-  indexMemoryAction,
   searchMemoryAction,
   statusMemoryAction,
   storeMemoryAction,
@@ -76,11 +75,6 @@ function readOptionalNumber(body: JsonObject, key: string): number | undefined {
   return typeof value === "number" ? value : undefined;
 }
 
-function readOptionalBoolean(body: JsonObject, key: string): boolean | undefined {
-  const value = body[key];
-  return typeof value === "boolean" ? value : undefined;
-}
-
 /**
  * Memory service 类实现。
  */
@@ -124,7 +118,7 @@ export class MemoryService extends BaseService {
   readonly actions: ServiceActions = {
     status: {
       command: {
-        description: "查看 memory 状态（backend/files/chunks/dirty）",
+        description: "查看 memory 状态（backend/files/chunks）",
         mapInput() {
           return {};
         },
@@ -137,32 +131,6 @@ export class MemoryService extends BaseService {
         return await statusMemoryAction(params.context, state);
       },
     },
-    index: {
-      command: {
-        description: "重建 memory 索引",
-        configure(command: Command) {
-          command.option("--force", "强制全量重建", false);
-        },
-        mapInput({ opts }) {
-          return {
-            force: opts.force === true,
-          };
-        },
-      },
-      api: {
-        method: "POST",
-        mapInput(ctx) {
-          return ctx.req.json();
-        },
-      },
-      execute: async (params) => {
-        const body = readBodyObject(params.payload);
-        const state = this.getOrCreateRuntimeState(params.context);
-        return await indexMemoryAction(params.context, state, {
-          force: readOptionalBoolean(body, "force"),
-        });
-      },
-    },
     search: {
       command: {
         description: "检索记忆片段",