@downcity/agent 1.1.35 → 1.1.51

package/bin/types/agent/AgentTypes.d.ts

@@ -0,0 +1,607 @@
+/**
+ * Agent 对外类型定义。
+ *
+ * 关键点（中文）
+ * - 这里集中声明 `Agent` / `RemoteAgent` / `Session` 面向外部调用方的稳定接口。
+ * - 宿主通过显式 `tools` / `plugins` 装配能力，不直接依赖内部 runtime 单例。
+ * - 本地/远程 session 运行与基础落盘能力仍是 Agent 对外主路径。
+ */
+import type { LanguageModel, Tool } from "ai";
+import type { BasePlugin } from "../../plugin/core/BasePlugin.js";
+import type { RpcServerInstance } from "../../rpc/Server.js";
+import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
+import type { AgentSessionSubscriber, AgentSessionUnsubscribe } from "../../types/sdk/AgentSessionEvent.js";
+import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
+import type { AgentSessionTurnHandle } from "../../types/sdk/AgentSessionTurn.js";
+/**
+ * 本地 Agent 构造参数。
+ */
+export interface AgentOptions {
+    /**
+     * 当前 agent 的稳定标识。
+     *
+     * 关键点（中文）
+     * - 用于 `.downcity/agents/<agentId>/...` 目录分区。
+     * - 应保持稳定、可 URL 编码、尽量不要依赖展示名称。
+     */
+    id: string;
+    /**
+     * 当前 agent 绑定的项目根目录。
+     */
+    path: string;
+    /**
+     * 当前 agent 默认可用的工具集合。
+     *
+     * 关键点（中文）
+     * - tools 归属于 agent 级，而不是 session 级。
+     * - session 运行时会直接复用这份工具集合。
+     */
+    tools?: Record<string, Tool>;
+    /**
+     * 调用方显式传入的静态基础指令。
+     *
+     * 关键点（中文）
+     * - `instruction` 是稳定、缓存友好的 system 前缀，不做动态变量替换。
+     * - SDK 不主动读取 `PROFILE.md` / `SOUL.md`；这类项目文件应由 city 或调用方读取后传入。
+     * - 未传入时，SDK 会使用包内最小 core instruction 作为 fallback。
+     */
+    instruction?: string | string[];
+    /**
+     * 当前 agent 为新建 session 提供的默认模型实例。
+     *
+     * 关键点（中文）
+     * - SDK 仍不负责“选择哪个模型”，这里只接收宿主已经创建好的 `LanguageModel`。
+     * - 该模型会作为 session 首次执行前的默认注入值。
+     */
+    model?: LanguageModel;
+    /**
+     * 当前 agent 显式持有的插件实例集合。
+     *
+     * 关键点（中文）
+     * - 这里接收已经实例化好的 `BasePlugin` 对象，而不是 plugin class。
+     * - `Agent` 会在构造阶段按名称注册这些实例，并自动绑定到当前 runtime。
+     * - 同名 plugin 会直接报错，避免 action / hook / resolve 行为被静默覆盖。
+     * - SDK 不再自动注入任何 built-in plugin；需要的能力都应由宿主显式传入。
+     */
+    plugins?: BasePlugin[];
+    /**
+     * 当前 agent 的显式环境变量覆盖项。
+     *
+     * 关键点（中文）
+     * - 这里表示宿主显式注入给 agent 的基础 env。
+     * - `Agent` 会在这份基础 env 之上继续叠加项目 `.env`。
+     * - 覆盖后的最终 env 会参与配置解析与运行时上下文装配，但不会回写到宿主环境。
+     */
+    env?: Record<string, string>;
+}
+/**
+ * Agent 启动参数。
+ */
+export interface AgentStartOptions {
+    /**
+     * 是否启动本机 RPC 服务。
+     *
+     * 关键点（中文）
+     * - `false` 表示不启动。
+     * - 传对象时会按给定 host/port 启动。
+     * - 省略时默认不启动，避免 SDK 本地嵌入场景误开端口。
+     */
+    rpc?: false | AgentRpcStartOptions;
+    /**
+     * 是否启动当前 agent 的 plugins。
+     *
+     * 关键点（中文）
+     * - 默认 `true`。
+     * - `false` 适合只需要 session 能力、不希望启动后台能力的嵌入场景。
+     */
+    plugins?: boolean;
+}
+/**
+ * Agent 停止结果快照。
+ */
+export interface AgentStopResult {
+    /**
+     * 本次是否实际停止了本机 RPC 服务。
+     */
+    rpcStopped: boolean;
+    /**
+     * 本次是否实际停止了 plugins。
+     */
+    pluginsStopped: boolean;
+}
+/**
+ * Agent 启动后的状态快照。
+ */
+export interface AgentStartResult {
+    /**
+     * 当前 agent 是否已启动本机 RPC 服务。
+     */
+    rpc?: AgentRpcBinding;
+    /**
+     * 当前 agent 是否已启动 plugins。
+     */
+    pluginsStarted: boolean;
+}
+/**
+ * Agent RPC 启动参数。
+ */
+export interface AgentRpcStartOptions {
+    /**
+     * RPC 监听主机。
+     */
+    host?: string;
+    /**
+     * RPC 监听端口。
+     */
+    port?: number;
+}
+/**
+ * Agent RPC 绑定信息。
+ */
+export interface AgentRpcBinding {
+    /**
+     * 远程访问地址。
+     */
+    url: string;
+    /**
+     * 当前 host。
+     */
+    host: string;
+    /**
+     * 当前 port。
+     */
+    port: number;
+    /**
+     * RPC server 句柄。
+     */
+    server: RpcServerInstance;
+}
+/**
+ * 远程 Agent 构造参数。
+ */
+export interface RemoteAgentOptions {
+    /**
+     * 远程 agent 访问地址。
+     *
+     * 例如：`https://city.example.com`、`http://127.0.0.1:15314`
+     * 或 `rpc://127.0.0.1:5314`
+     */
+    url: string;
+}
+/**
+ * 新建 session 的输入参数。
+ */
+export interface AgentCreateSessionInput {
+    /**
+     * 可选显式 sessionId。
+     *
+     * 关键点（中文）
+     * - 传入时表达“创建意图”。
+     * - 若该 session 已存在，SDK 应直接报错，而不是静默复用。
+     * - 省略时由 SDK 自动生成稳定且不可推导的 sessionId。
+     */
+    sessionId?: string;
+}
+/**
+ * Session 列表查询输入。
+ */
+export interface AgentListSessionsInput {
+    /**
+     * 当前页返回上限。
+     *
+     * 说明（中文）
+     * - 省略时由 SDK 使用默认值。
+     * - 建议宿主 UI 明确传入，避免在大量 session 下拉取过多数据。
+     */
+    limit?: number;
+    /**
+     * 分页游标。
+     *
+     * 说明（中文）
+     * - 当前使用 SDK 自身生成的透明字符串游标。
+     * - 调用方只负责透传，不应自行解析其内部格式。
+     */
+    cursor?: string;
+    /**
+     * 关键词过滤。
+     *
+     * 说明（中文）
+     * - 推荐用于匹配 `sessionId`、标题与预览文本。
+     * - 属于轻量包含匹配，不承诺复杂搜索语义。
+     */
+    query?: string;
+}
+/**
+ * Session 可变配置。
+ */
+export interface AgentSessionSetInput {
+    /**
+     * 当前 session 默认模型实例。
+     *
+     * 关键点（中文）
+     * - 这里接受运行中的模型实例，而不是模型 ID。
+     * - 由于模型实例通常不可序列化，落盘只保留轻量可读标签用于展示。
+     */
+    model?: LanguageModel;
+}
+/**
+ * Session 当前配置快照。
+ */
+export interface AgentSessionConfigSnapshot {
+    /**
+     * 当前 session 绑定的默认模型实例。
+     */
+    model?: LanguageModel;
+    /**
+     * 当前模型的轻量可读标签。
+     */
+    modelLabel?: string;
+}
+/**
+ * Session 历史视图类型。
+ */
+export type AgentSessionHistoryView = "message" | "timeline";
+/**
+ * Session 时间线事件。
+ */
+export interface AgentSessionTimelineEvent {
+    /**
+     * 当前事件唯一标识。
+     */
+    id: string;
+    /**
+     * 当前事件角色。
+     *
+     * 说明（中文）
+     * - `tool-call` / `tool-result` 用于把 assistant 内部工具过程平铺给 UI。
+     */
+    role: "user" | "assistant" | "tool-call" | "tool-result";
+    /**
+     * 事件时间戳（毫秒）。
+     */
+    ts?: number;
+    /**
+     * 事件所属消息种类。
+     */
+    kind?: string;
+    /**
+     * 事件来源。
+     */
+    source?: string;
+    /**
+     * 当前事件展示文本。
+     */
+    text: string;
+    /**
+     * 当前事件对应工具名称。
+     *
+     * 说明（中文）
+     * - 仅 `tool-call` / `tool-result` 这类事件通常会携带该字段。
+     */
+    toolName?: string;
+}
+/**
+ * Session system block 来源类型。
+ */
+export type AgentSessionSystemBlockSource = "core" | "instruction" | "plugin" | "session";
+/**
+ * Session system prompt 的单个组成块。
+ */
+export interface AgentSessionSystemBlock {
+    /**
+     * 当前 block 的来源层级。
+     */
+    source: AgentSessionSystemBlockSource;
+    /**
+     * 当前 block 在来源层级内的名称。
+     *
+     * 说明（中文）
+     * - `instruction` 通常使用 `agent`。
+     * - `plugin` 使用对应 plugin 名称。
+     * - `core` 使用 `default`。
+     * - `session` 使用当前 session 上下文名称。
+     */
+    name: string;
+    /**
+     * 已归一化后的 system 文本内容。
+     *
+     * 关键点（中文）
+     * - SDK 不对 instruction 做动态变量替换。
+     * - 动态上下文应由调用方放入 user message。
+     */
+    content: string;
+}
+/**
+ * 当前 session 的稳定上下文信息。
+ */
+export interface AgentSessionSystemSessionInfo {
+    /**
+     * 当前 session 所属 agentId。
+     */
+    agentId: string;
+    /**
+     * 当前 session 唯一标识。
+     */
+    sessionId: string;
+    /**
+     * 当前 agent 绑定的项目根目录。
+     */
+    projectRoot: string;
+    /**
+     * 当前 session 首次创建时间。
+     *
+     * 关键点（中文）
+     * - 这是 session 初始化时落盘的稳定参考时间，按 Date/ISO 字符串对外展示。
+     * - 它不是每轮运行的当前时间，不会随着后续 turn 执行而改变。
+     */
+    createdAt: string;
+    /**
+     * 当前 session 初始化时解析到的系统时区。
+     *
+     * 关键点（中文）
+     * - 这是 session 级参考时区，随创建信息一起固定。
+     * - 它不是每轮运行重新解析的动态时区。
+     */
+    timezone: string;
+}
+/**
+ * 当前 session 生效的完整 system prompt 快照。
+ */
+export interface AgentSessionSystemSnapshot {
+    /**
+     * 当前 sessionId。
+     */
+    sessionId: string;
+    /**
+     * 当前 session 的稳定上下文信息。
+     *
+     * 关键点（中文）
+     * - 这里包含 session 创建时间这类稳定参考信息。
+     * - 这里不包含当前时间、轮次、用户输入等每轮变化的数据。
+     * - 每轮动态信息应由调用方放入 user message，避免破坏 instruction 缓存命中。
+     */
+    session: AgentSessionSystemSessionInfo;
+    /**
+     * 当前生效的 system blocks，按进入模型的顺序排列。
+     */
+    blocks: AgentSessionSystemBlock[];
+}
+/**
+ * Session 摘要。
+ */
+export interface AgentSessionSummary {
+    /**
+     * 当前 session 所属 agentId。
+     */
+    agentId: string;
+    /**
+     * 当前 session 唯一标识。
+     */
+    sessionId: string;
+    /**
+     * 当前 session 可读标题。
+     *
+     * 说明（中文）
+     * - 当前 SDK 不要求标题一定存在。
+     * - 若调用方需要展示列表标题，可优先使用这里；为空时再回退到 `sessionId`。
+     */
+    title?: string;
+    /**
+     * 当前 session 的最近预览文本。
+     *
+     * 说明（中文）
+     * - 通常来自最后一条用户可见消息的裁剪文本。
+     * - 适合用于侧边栏、列表卡片或 session picker。
+     */
+    previewText?: string;
+    /**
+     * 当前 session 首次创建时间（ms）。
+     */
+    createdAt?: number;
+    /**
+     * 当前 session 最近一次更新时间（ms）。
+     */
+    updatedAt?: number;
+    /**
+     * 当前 session 已落盘消息数。
+     */
+    messageCount: number;
+    /**
+     * 当前 session 绑定模型的可读标签。
+     */
+    modelLabel?: string;
+    /**
+     * 当前 session 是否处于执行中。
+     */
+    executing?: boolean;
+}
+/**
+ * Session 详情。
+ */
+export interface AgentSessionInfo extends AgentSessionSummary {
+    /**
+     * 当前 session 初始化时记录的时区。
+     */
+    timezone?: string;
+}
+/**
+ * Session 摘要分页结果。
+ */
+export interface AgentSessionSummaryPage {
+    /**
+     * 当前页 session 摘要列表。
+     */
+    items: AgentSessionSummary[];
+    /**
+     * 当前页所对应的总条数。
+     *
+     * 说明（中文）
+     * - 这里表示过滤后的总数，不是仅当前页数量。
+     * - 对分页 UI、结果统计和空态判断更友好。
+     */
+    total: number;
+    /**
+     * 下一页游标。
+     */
+    nextCursor?: string;
+    /**
+     * 是否仍有更多结果。
+     */
+    hasMore: boolean;
+}
+/**
+ * Session 历史读取输入。
+ */
+export interface AgentSessionHistoryInput {
+    /**
+     * 当前页返回上限。
+     */
+    limit?: number;
+    /**
+     * 分页游标。
+     */
+    cursor?: string;
+    /**
+     * 返回顺序。
+     *
+     * 说明（中文）
+     * - `asc`：从旧到新
+     * - `desc`：从新到旧
+     */
+    order?: "asc" | "desc";
+    /**
+     * 返回视图类型。
+     *
+     * 说明（中文）
+     * - `message`：原始 session 消息
+     * - `timeline`：适合直接渲染 UI 的平铺事件
+     */
+    view?: AgentSessionHistoryView;
+}
+/**
+ * Session 历史分页结果。
+ */
+export interface AgentSessionHistoryPage {
+    /**
+     * 当前读取所对应的 session 信息。
+     */
+    session: AgentSessionInfo;
+    /**
+     * 当前页实际返回视图。
+     */
+    view: AgentSessionHistoryView;
+    /**
+     * 当前页数据列表。
+     *
+     * 说明（中文）
+     * - `view=message` 时返回 `SessionMessageV1[]`
+     * - `view=timeline` 时返回 `AgentSessionTimelineEvent[]`
+     */
+    items: SessionMessageV1[] | AgentSessionTimelineEvent[];
+    /**
+     * 过滤前后的总条数。
+     *
+     * 说明（中文）
+     * - 对 `view=message` 表示消息条数。
+     * - 对 `view=timeline` 表示时间线事件条数。
+     */
+    total: number;
+    /**
+     * 下一页游标。
+     */
+    nextCursor?: string;
+    /**
+     * 是否仍有更多数据。
+     */
+    hasMore: boolean;
+}
+/**
+ * Session fork 输入。
+ */
+export interface AgentSessionForkInput {
+    /**
+     * 可选分叉锚点消息 ID。
+     *
+     * 关键点（中文）
+     * - 省略时复制当前 session 的完整消息历史。
+     * - 传入时复制到该消息为止（包含该消息）。
+     */
+    messageId?: string;
+}
+/**
+ * SDK Session 集合绑定。
+ */
+export interface AgentSessionCollection {
+    /**
+     * 新建一个 session。
+     */
+    createSession(input?: AgentCreateSessionInput): Promise<AgentSession>;
+    /**
+     * 获取一个已存在的 session。
+     */
+    getSession(sessionId: string): Promise<AgentSession>;
+    /**
+     * 列出当前 agent 的 session 摘要页。
+     */
+    listSessions(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
+}
+/**
+ * Session actor 公共能力。
+ */
+export interface AgentSessionActor {
+    /**
+     * 当前 session 稳定标识。
+     */
+    readonly id: string;
+    /**
+     * 读取当前 session 详情。
+     */
+    getInfo(): Promise<AgentSessionInfo>;
+    /**
+     * 追加一条新的 prompt。
+     */
+    prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
+    /**
+     * 订阅当前 session 的未来事件。
+     */
+    subscribe(subscriber: AgentSessionSubscriber): AgentSessionUnsubscribe;
+    /**
+     * 读取当前 session 历史分页。
+     */
+    history(input?: AgentSessionHistoryInput): Promise<AgentSessionHistoryPage>;
+    /**
+     * 读取当前 session 生效的 system 快照。
+     */
+    system(): Promise<AgentSessionSystemSnapshot>;
+}
+/**
+ * 本地 Agent 返回的公开 session 接口。
+ */
+export interface AgentSession extends AgentSessionActor {
+    /**
+     * 当前 session 所属 agentId。
+     */
+    readonly agentId: string;
+    /**
+     * 当前 session 配置快照。
+     */
+    readonly config: AgentSessionConfigSnapshot;
+    /**
+     * 写入当前 session 默认配置。
+     */
+    set(input: AgentSessionSetInput): Promise<void>;
+    /**
+     * 从当前 session 创建一个分叉会话。
+     */
+    fork(input?: AgentSessionForkInput | string): Promise<AgentSession>;
+}
+/**
+ * 远程 Agent 返回的公开 session 接口。
+ */
+export interface RemoteAgentSession extends AgentSessionActor {
+    /**
+     * 从当前远程 session 创建一个分叉会话。
+     */
+    fork(input?: AgentSessionForkInput | string): Promise<RemoteAgentSession>;
+}
+//# sourceMappingURL=AgentTypes.d.ts.map

package/bin/types/agent/AgentTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentTypes.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentTypes.ts"],"names":[],"mappings":"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"}

package/bin/types/agent/AgentTypes.js

@@ -0,0 +1,10 @@
+/**
+ * Agent 对外类型定义。
+ *
+ * 关键点（中文）
+ * - 这里集中声明 `Agent` / `RemoteAgent` / `Session` 面向外部调用方的稳定接口。
+ * - 宿主通过显式 `tools` / `plugins` 装配能力，不直接依赖内部 runtime 单例。
+ * - 本地/远程 session 运行与基础落盘能力仍是 Agent 对外主路径。
+ */
+export {};
+//# sourceMappingURL=AgentTypes.js.map

package/bin/types/agent/AgentTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentTypes.js","sourceRoot":"","sources":["../../../src/types/agent/AgentTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/types/common/EnvFile.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Env 文件工具相关类型定义。
+ *
+ * 职责说明（中文）
+ * - 统一描述 `.env` / `.env.example` 写入工具使用的最小数据结构。
+ * - 避免工具模块直接内联匿名对象，便于后续在其他初始化流程中复用。
+ * - 这里只描述“文件写入条目”，不承载运行时环境变量快照语义。
+ */
+/**
+ * Env 文件中的单条键值项。
+ */
+export interface EnvFileEntry {
+    /**
+     * 环境变量键名。
+     *
+     * 关键点（中文）
+     * - 调用方应传入已规范化的变量名。
+     * - 工具层不会自动把任意字符串修正成合法变量名。
+     */
+    key: string;
+    /**
+     * 环境变量值。
+     *
+     * 关键点（中文）
+     * - 会按字面量写入目标文件。
+     * - 当前工具不额外做引号包裹或 shell 转义。
+     */
+    value: string;
+}
+//# sourceMappingURL=EnvFile.d.ts.map

package/bin/types/common/EnvFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvFile.d.ts","sourceRoot":"","sources":["../../../src/types/common/EnvFile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,CAAC;CACf"}

package/bin/types/common/EnvFile.js

@@ -0,0 +1,10 @@
+/**
+ * Env 文件工具相关类型定义。
+ *
+ * 职责说明（中文）
+ * - 统一描述 `.env` / `.env.example` 写入工具使用的最小数据结构。
+ * - 避免工具模块直接内联匿名对象，便于后续在其他初始化流程中复用。
+ * - 这里只描述“文件写入条目”，不承载运行时环境变量快照语义。
+ */
+export {};
+//# sourceMappingURL=EnvFile.js.map

package/bin/types/common/EnvFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvFile.js","sourceRoot":"","sources":["../../../src/types/common/EnvFile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}