@downcity/agent 1.1.338 → 1.1.400

package/bin/types/store/AgentStore.js

@@ -1,9 +0,0 @@
-/**
- * Agent Store 类型。
- *
- * 关键点（中文）
- * - AgentSessions 只通过该接口管理 Session 生命周期和索引。
- * - 接口不暴露物理目录，避免 Session 领域重新依赖路径约定。
- */
-export {};
-//# sourceMappingURL=AgentStore.js.map

package/bin/types/store/AgentStore.js.map

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

package/bin/types/workspace/FileSystem.d.ts

@@ -1,55 +0,0 @@
-/**
- * Workspace 文件系统类型。
- *
- * 关键点（中文）
- * - 文件与搜索共享同一个已解析项目根目录。
- * - WorkspaceTools 与 AgentStore 共用这一文件能力，不建立额外存储根目录。
- */
-import type { FileToolActionRequest, FileToolActionResult } from "../../types/workspace/FileTool.js";
-import type { SearchToolActionRequest, SearchToolActionResult } from "../../types/workspace/SearchTool.js";
-/** Workspace 目录中的稳定条目摘要。 */
-export interface WorkspaceDirectoryEntry {
-    /** 当前条目的原始文件名。 */
-    name: string;
-    /** 当前条目是否为普通目录。 */
-    is_directory: boolean;
-    /** 当前条目是否为普通文件。 */
-    is_file: boolean;
-}
-/** Workspace 内统一的文件与搜索能力。 */
-export interface FileSystem {
-    /** 已解析且不可变的项目根目录。 */
-    readonly root_path: string;
-    /** 将 Workspace 内的相对路径片段解析为本地绝对路径。 */
-    resolve_path(...segments: string[]): string;
-    /** 判断 Workspace 内的文件或目录是否存在。 */
-    path_exists(file_path: string): Promise<boolean>;
-    /** 读取 Workspace 内文件的完整字节内容。 */
-    read_file(file_path: string): Promise<Buffer>;
-    /** 读取 Workspace 内普通文件的字节大小。 */
-    file_size(file_path: string): Promise<number>;
-    /** 创建 Workspace 内目录及缺失的父目录。 */
-    ensure_directory(directory_path: string): Promise<void>;
-    /** 删除 Workspace 内文件或目录；目标不存在时视为成功。 */
-    remove_path(target_path: string): Promise<void>;
-    /** 原子移动 Workspace 内的文件或目录，不覆盖已有目标。 */
-    move_path(source_path: string, target_path: string): Promise<void>;
-    /** 读取 Workspace 内目录的直接子条目。 */
-    read_directory(directory_path: string): Promise<WorkspaceDirectoryEntry[]>;
-    /** 原子创建或覆盖 Workspace 内的完整文件内容。 */
-    write_file_atomically(file_path: string, content: string | Buffer): Promise<void>;
-    /** 向 Workspace 文件末尾追加完整字节内容。 */
-    append_file(file_path: string, content: string | Buffer): Promise<void>;
-    /**
-     * 使用 Workspace 内的独占锁串行执行文件事务。
-     *
-     * @param lock_path 锁文件路径；调用完成后由 FileSystem 自动释放。
-     * @param action 获得锁后执行的事务；异常会原样向调用方抛出。
-     */
-    with_file_lock<T>(lock_path: string, action: () => Promise<T>): Promise<T>;
-    /** 执行一次受项目根目录限制的结构化文件操作。 */
-    run_file_action(request: FileToolActionRequest): Promise<FileToolActionResult>;
-    /** 执行一次受项目根目录限制的结构化搜索操作。 */
-    run_search_action(request: SearchToolActionRequest): Promise<SearchToolActionResult>;
-}
-//# sourceMappingURL=FileSystem.d.ts.map

package/bin/types/workspace/FileSystem.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../../../src/types/workspace/FileSystem.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,iCAAiC,CAAC;AAEzC,4BAA4B;AAC5B,MAAM,WAAW,uBAAuB;IACtC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,mBAAmB;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,6BAA6B;AAC7B,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,qCAAqC;IACrC,YAAY,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE5C,gCAAgC;IAChC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD,+BAA+B;IAC/B,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9C,+BAA+B;IAC/B,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9C,+BAA+B;IAC/B,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD,sCAAsC;IACtC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,sCAAsC;IACtC,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE,8BAA8B;IAC9B,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAE3E,kCAAkC;IAClC,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElF,gCAAgC;IAChC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE;;;;;OAKG;IACH,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE3E,4BAA4B;IAC5B,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAE/E,4BAA4B;IAC5B,iBAAiB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACtF"}

package/bin/types/workspace/FileSystem.js

@@ -1,9 +0,0 @@
-/**
- * Workspace 文件系统类型。
- *
- * 关键点（中文）
- * - 文件与搜索共享同一个已解析项目根目录。
- * - WorkspaceTools 与 AgentStore 共用这一文件能力，不建立额外存储根目录。
- */
-export {};
-//# sourceMappingURL=FileSystem.js.map

package/bin/types/workspace/FileSystem.js.map

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

package/bin/types/workspace/FileTool.d.ts

@@ -1,181 +0,0 @@
-/**
- * 文件工具公开类型。
- *
- * 关键点（中文）
- * - 文件工具由 Workspace 持有，与 Shell/PTY action 分离。
- * - 所有模型可见字段统一使用 snake_case。
- * - 成功与失败均返回结构化结果，避免依赖异常文本判断执行状态。
- */
-import type { Tool } from "ai";
-/** 文件工具支持的结构化错误码。 */
-export type FileToolErrorCode = "invalid_path" | "sandbox_denied" | "file_not_found" | "not_a_file" | "permission_denied" | "file_exists" | "file_too_large" | "content_too_large" | "line_too_large" | "encoding_error" | "binary_file" | "no_edits" | "too_many_edits" | "duplicate_match" | "not_found" | "overlapping_edits" | "edit_too_large" | "file_changed" | "internal_error";
-/** 文件读取工具输入。 */
-export interface ReadFileToolInput {
-    /** 要读取的项目内相对路径或绝对路径。 */
-    file_path: string;
-    /** 从第几行开始读取，使用 0-based 行号。 */
-    offset?: number;
-    /** 本次最多返回的行数。 */
-    limit?: number;
-}
-/** 文件写入工具输入。 */
-export interface WriteFileToolInput {
-    /** 要创建或覆盖的项目内相对路径或绝对路径。 */
-    file_path: string;
-    /** 要写入的 UTF-8 文本内容。 */
-    content: string;
-    /** 文件存在时是否允许覆盖，默认不允许。 */
-    overwrite?: boolean;
-}
-/** 单项精确文本编辑。 */
-export interface FileEditOperation {
-    /** 必须在原文件中唯一匹配的原始文本。 */
-    old_text: string;
-    /** 用于替换唯一匹配区域的新文本。 */
-    new_text: string;
-}
-/** 文件编辑工具输入。 */
-export interface EditFileToolInput {
-    /** 要编辑的项目内相对路径或绝对路径。 */
-    file_path: string;
-    /** 一次原子应用的精确文本编辑列表。 */
-    edits: FileEditOperation[];
-    /** 可选的读取时 SHA-256；文件变化后拒绝编辑。 */
-    expected_sha256?: string;
-}
-/** 文件工具统一失败结果。 */
-export interface FileToolFailure {
-    /** 表示本次文件操作失败。 */
-    success: false;
-    /** 供模型和调用方稳定解析的错误码。 */
-    error_code: FileToolErrorCode;
-    /** 面向模型和日志的人类可读错误信息。 */
-    message: string;
-    /** 已完成解析时的目标绝对路径。 */
-    file_path?: string;
-    /** 编辑失败时每项匹配的详细结果。 */
-    details?: FileEditDetail[];
-}
-/** 文件读取成功结果。 */
-export interface ReadFileToolSuccess {
-    /** 表示本次文件读取成功。 */
-    success: true;
-    /** 解析并校验后的目标绝对路径。 */
-    file_path: string;
-    /** 原始文件总字节数。 */
-    total_bytes: number;
-    /** 文本文件总行数；图片和其他二进制文件固定为 0。 */
-    total_lines: number;
-    /** 本次返回内容的 0-based 起始行。 */
-    start_line: number;
-    /** 本次返回内容的 0-based 结束行；没有返回行时小于 start_line。 */
-    end_line: number;
-    /** 返回给模型的文本内容；图片和其他二进制文件为空字符串。 */
-    content: string;
-    /** 是否还有后续文本行未返回。 */
-    truncated: boolean;
-    /** 有后续文本时建议下一次使用的 offset。 */
-    next_offset?: number;
-    /** 当前文件被识别为文本、图片还是其他二进制文件。 */
-    type: "text" | "image" | "binary";
-    /** 当前文件的 MIME 类型。 */
-    mime_type?: string;
-    /** 文本文件实际采用的解码格式。 */
-    encoding?: "utf-8" | "utf-16le" | "utf-16be";
-    /** 原始文件内容的 SHA-256，可传给 edit 防止并发覆盖。 */
-    sha256: string;
-}
-/** 文件写入成功结果。 */
-export interface WriteFileToolSuccess {
-    /** 表示本次文件写入成功。 */
-    success: true;
-    /** 解析并校验后的目标绝对路径。 */
-    file_path: string;
-    /** 实际写入的 UTF-8 字节数。 */
-    bytes_written: number;
-    /** 实际写入的文本行数。 */
-    lines_written: number;
-    /** 本次操作是否覆盖了已有文件。 */
-    overwritten: boolean;
-    /** 写入完成后的 ISO 时间戳。 */
-    timestamp: string;
-    /** 写入后文件内容的 SHA-256。 */
-    sha256: string;
-}
-/** 单项编辑匹配详情。 */
-export interface FileEditDetail {
-    /** 当前编辑项的原始索引。 */
-    index: number;
-    /** 当前编辑项的匹配与应用状态。 */
-    status: "applied" | "not_found" | "duplicate";
-    /** 当前 old_text 在原文件中的匹配次数。 */
-    match_count: number;
-    /** 唯一匹配成功时的 0-based 起始行。 */
-    line_start?: number;
-}
-/** 文件编辑成功结果。 */
-export interface EditFileToolSuccess {
-    /** 表示全部编辑已原子应用。 */
-    success: true;
-    /** 解析并校验后的目标绝对路径。 */
-    file_path: string;
-    /** 成功应用的编辑数量。 */
-    applied: number;
-    /** 每项编辑的匹配与应用详情。 */
-    details: FileEditDetail[];
-    /** 编辑后文件的总行数。 */
-    new_total_lines: number;
-    /** 编辑前文件内容的 SHA-256。 */
-    previous_sha256: string;
-    /** 编辑后文件内容的 SHA-256。 */
-    sha256: string;
-}
-/** 文件读取工具结果。 */
-export type ReadFileToolResult = ReadFileToolSuccess | FileToolFailure;
-/** 文件写入工具结果。 */
-export type WriteFileToolResult = WriteFileToolSuccess | FileToolFailure;
-/** 文件编辑工具结果。 */
-export type EditFileToolResult = EditFileToolSuccess | FileToolFailure;
-/** 文件工具内部 action 名称。 */
-export type FileToolAction = "read" | "write" | "edit";
-/** 文件 action 的判别式请求。 */
-export type FileToolActionRequest = {
-    /** 指定执行文件读取。 */
-    action: "read";
-    /** 文件读取输入。 */
-    input: ReadFileToolInput;
-} | {
-    /** 指定执行文件写入。 */
-    action: "write";
-    /** 文件写入输入。 */
-    input: WriteFileToolInput;
-} | {
-    /** 指定执行文件编辑。 */
-    action: "edit";
-    /** 文件编辑输入。 */
-    input: EditFileToolInput;
-};
-/** 文件 action 的统一结果。 */
-export type FileToolActionResult = ReadFileToolResult | WriteFileToolResult | EditFileToolResult;
-/** 文件工具运行器协议。 */
-export interface FileToolRunner {
-    /** 执行一个独立文件 action。 */
-    run_file_action(request: FileToolActionRequest): Promise<FileToolActionResult>;
-}
-/** `@downcity/shell` 对模型暴露的文件工具集合。 */
-export interface FileToolSet {
-    /** 分页读取文本并识别二进制文件。 */
-    read: Tool;
-    /** 创建或显式覆盖 UTF-8 文本文件。 */
-    write: Tool;
-    /** 通过唯一文本匹配原子编辑单个文件。 */
-    edit: Tool;
-}
-/** 已通过项目根目录约束的文件工具路径。 */
-export interface ResolvedFileToolPath {
-    /** 解析后的目标绝对路径。 */
-    file_path: string;
-    /** 解析后的项目根目录绝对路径。 */
-    root_path: string;
-}
-//# sourceMappingURL=FileTool.d.ts.map

package/bin/types/workspace/FileTool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FileTool.d.ts","sourceRoot":"","sources":["../../../src/types/workspace/FileTool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE/B,qBAAqB;AACrB,MAAM,MAAM,iBAAiB,GACzB,cAAc,GACd,gBAAgB,GAChB,gBAAgB,GAChB,YAAY,GACZ,mBAAmB,GACnB,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,gBAAgB,GAChB,gBAAgB,GAChB,aAAa,GACb,UAAU,GACV,gBAAgB,GAChB,iBAAiB,GACjB,WAAW,GACX,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,GACd,gBAAgB,CAAC;AAErB,gBAAgB;AAChB,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gBAAgB;AAChB,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,gBAAgB;AAChB,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,gBAAgB;AAChB,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,gCAAgC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,kBAAkB;AAClB,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,OAAO,EAAE,KAAK,CAAC;IACf,uBAAuB;IACvB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,kBAAkB;IAClB,OAAO,EAAE,IAAI,CAAC;IACd,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClC,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IAC7C,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gBAAgB;AAChB,MAAM,WAAW,oBAAoB;IACnC,kBAAkB;IAClB,OAAO,EAAE,IAAI,CAAC;IACd,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gBAAgB;AAChB,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;IAC9C,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,mBAAmB;IACnB,OAAO,EAAE,IAAI,CAAC;IACd,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,iBAAiB;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gBAAgB;AAChB,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG,eAAe,CAAC;AAEvE,gBAAgB;AAChB,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG,eAAe,CAAC;AAEzE,gBAAgB;AAChB,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG,eAAe,CAAC;AAEvE,wBAAwB;AACxB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEvD,wBAAwB;AACxB,MAAM,MAAM,qBAAqB,GAC7B;IACE,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,KAAK,EAAE,iBAAiB,CAAC;CAC1B,GACD;IACE,gBAAgB;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc;IACd,KAAK,EAAE,kBAAkB,CAAC;CAC3B,GACD;IACE,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,KAAK,EAAE,iBAAiB,CAAC;CAC1B,CAAC;AAEN,uBAAuB;AACvB,MAAM,MAAM,oBAAoB,GAC5B,kBAAkB,GAClB,mBAAmB,GACnB,kBAAkB,CAAC;AAEvB,iBAAiB;AACjB,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAChF;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,0BAA0B;IAC1B,KAAK,EAAE,IAAI,CAAC;IACZ,wBAAwB;IACxB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,yBAAyB;AACzB,MAAM,WAAW,oBAAoB;IACnC,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/bin/types/workspace/FileTool.js

@@ -1,10 +0,0 @@
-/**
- * 文件工具公开类型。
- *
- * 关键点（中文）
- * - 文件工具由 Workspace 持有，与 Shell/PTY action 分离。
- * - 所有模型可见字段统一使用 snake_case。
- * - 成功与失败均返回结构化结果，避免依赖异常文本判断执行状态。
- */
-export {};
-//# sourceMappingURL=FileTool.js.map

package/bin/types/workspace/FileTool.js.map

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

package/bin/types/workspace/SearchTool.d.ts

@@ -1,131 +0,0 @@
-/**
- * 项目搜索工具公开类型。
- *
- * 关键点（中文）
- * - `grep` 通过 ripgrep 搜索文件内容，`find` 通过 glob 发现文件。
- * - 模型可见字段统一使用 snake_case，并返回稳定的结构化结果。
- * - 两个工具都受 Shell 项目根目录约束，不允许搜索根目录之外的路径。
- */
-import type { Tool } from "ai";
-/** 搜索工具支持的结构化错误码。 */
-export type SearchToolErrorCode = "invalid_path" | "sandbox_denied" | "path_not_found" | "not_a_directory" | "invalid_pattern" | "rg_unavailable" | "search_failed" | "aborted" | "internal_error";
-/** grep 工具输入。 */
-export interface GrepToolInput {
-    /** 要搜索的文本或正则表达式。 */
-    query: string;
-    /** 搜索范围的项目内相对路径或绝对路径，默认为项目根目录。 */
-    path?: string;
-    /** 用于限制候选文件的 ripgrep glob 模式列表。 */
-    glob?: string[];
-    /** 是否区分大小写，默认不区分。 */
-    case_sensitive?: boolean;
-    /** 是否按字面量搜索；设为 false 时把 query 作为 ripgrep 正则表达式。 */
-    literal?: boolean;
-    /** 本次最多返回的匹配数量，默认 200，最大 2000。 */
-    max_results?: number;
-}
-/** find 工具输入。 */
-export interface FindToolInput {
-    /** 用于发现文件的 POSIX glob 模式。 */
-    pattern: string;
-    /** 开始匹配的项目内目录，默认为项目根目录。 */
-    path?: string;
-    /** 本次最多返回的文件数量，默认 200，最大 2000。 */
-    max_results?: number;
-}
-/** grep 返回的单项内容匹配。 */
-export interface GrepToolMatch {
-    /** 匹配文件相对于项目根目录的 POSIX 路径。 */
-    file_path: string;
-    /** 匹配所在的 1-based 行号。 */
-    line_number: number;
-    /** 匹配起始位置的 1-based UTF-8 字节列号。 */
-    column: number;
-    /** 匹配所在行的文本预览，不包含行尾换行符。 */
-    text: string;
-    /** 当前子匹配命中的原始文本。 */
-    match_text: string;
-    /** 行文本是否因为输出限制而被截断。 */
-    line_truncated: boolean;
-}
-/** 搜索工具统一失败结果。 */
-export interface SearchToolFailure {
-    /** 表示本次搜索失败。 */
-    success: false;
-    /** 供模型和调用方稳定解析的错误码。 */
-    error_code: SearchToolErrorCode;
-    /** 面向模型和日志的人类可读错误信息。 */
-    message: string;
-    /** 已完成解析时的搜索绝对路径。 */
-    search_path?: string;
-}
-/** grep 工具成功结果。 */
-export interface GrepToolSuccess {
-    /** 表示本次内容搜索成功。 */
-    success: true;
-    /** Shell 当前约束的项目根目录绝对路径。 */
-    root_path: string;
-    /** 实际执行搜索的绝对路径。 */
-    search_path: string;
-    /** 本次传给 ripgrep 的查询文本。 */
-    query: string;
-    /** 按 ripgrep 输出顺序返回的内容匹配。 */
-    matches: GrepToolMatch[];
-    /** ripgrep 实际开始搜索的文件数量。 */
-    files_searched: number;
-    /** 本次结果中返回的匹配数量。 */
-    match_count: number;
-    /** 是否因为 max_results 限制而省略了后续匹配。 */
-    truncated: boolean;
-}
-/** find 工具成功结果。 */
-export interface FindToolSuccess {
-    /** 表示本次文件发现成功。 */
-    success: true;
-    /** Shell 当前约束的项目根目录绝对路径。 */
-    root_path: string;
-    /** 实际开始 glob 匹配的绝对目录。 */
-    search_path: string;
-    /** 本次执行的 glob 模式。 */
-    pattern: string;
-    /** 排序后返回的项目相对 POSIX 文件路径。 */
-    files: string[];
-    /** 本次结果中返回的文件数量。 */
-    match_count: number;
-    /** 是否因为 max_results 限制而省略了后续文件。 */
-    truncated: boolean;
-}
-/** grep 工具结果。 */
-export type GrepToolResult = GrepToolSuccess | SearchToolFailure;
-/** find 工具结果。 */
-export type FindToolResult = FindToolSuccess | SearchToolFailure;
-/** 搜索 action 的判别式请求。 */
-export type SearchToolActionRequest = ({
-    /** 指定执行内容搜索。 */
-    action: "grep";
-    /** grep 工具输入。 */
-    input: GrepToolInput;
-} | {
-    /** 指定执行文件发现。 */
-    action: "find";
-    /** find 工具输入。 */
-    input: FindToolInput;
-}) & {
-    /** AI SDK 传入的单次工具调用中止信号。 */
-    abort_signal?: AbortSignal;
-};
-/** 搜索 action 的统一结果。 */
-export type SearchToolActionResult = GrepToolResult | FindToolResult;
-/** 搜索工具运行器协议。 */
-export interface SearchToolRunner {
-    /** 执行一个独立的搜索 action。 */
-    run_search_action(request: SearchToolActionRequest): Promise<SearchToolActionResult>;
-}
-/** `@downcity/shell` 对模型暴露的项目搜索工具集合。 */
-export interface SearchToolSet {
-    /** 通过 ripgrep 搜索项目文件内容。 */
-    grep: Tool;
-    /** 通过 glob 模式发现项目文件。 */
-    find: Tool;
-}
-//# sourceMappingURL=SearchTool.d.ts.map

package/bin/types/workspace/SearchTool.d.ts.map

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

package/bin/types/workspace/SearchTool.js

@@ -1,10 +0,0 @@
-/**
- * 项目搜索工具公开类型。
- *
- * 关键点（中文）
- * - `grep` 通过 ripgrep 搜索文件内容，`find` 通过 glob 发现文件。
- * - 模型可见字段统一使用 snake_case，并返回稳定的结构化结果。
- * - 两个工具都受 Shell 项目根目录约束，不允许搜索根目录之外的路径。
- */
-export {};
-//# sourceMappingURL=SearchTool.js.map

package/bin/types/workspace/SearchTool.js.map

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

package/bin/types/workspace/Workspace.d.ts

@@ -1,24 +0,0 @@
-/**
- * Workspace 公共类型。
- *
- * 关键点（中文）
- * - Workspace 是统一资源容器，同时提供 Store、Tool 与可选 Shell。
- * - 所有平台共用同一类型，平台差异由可选 Shell 的 Sandbox Adapter 处理。
- */
-import type { Shell } from "@downcity/shell";
-/** Workspace 构造参数。 */
-export interface WorkspaceOptions {
-    /** Workspace 绑定的本地项目目录；构造时会解析为真实绝对路径。 */
-    path: string;
-    /** Workspace 内可选的受控命令执行能力。 */
-    shell?: Shell;
-    /**
-     * Workspace 的显式环境变量覆盖项。
-     *
-     * 关键点（中文）
-     * - 显式值覆盖 Workspace 根目录 `.env` 中的同名字段。
-     * - 最终环境变量由 Workspace 持有，不会写回 `process.env` 或 `.env`。
-     */
-    env?: Record<string, string | undefined>;
-}
-//# sourceMappingURL=Workspace.d.ts.map

package/bin/types/workspace/Workspace.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Workspace.d.ts","sourceRoot":"","sources":["../../../src/types/workspace/Workspace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,sBAAsB;AACtB,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IAEb,8BAA8B;IAC9B,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C"}

package/bin/types/workspace/Workspace.js

@@ -1,9 +0,0 @@
-/**
- * Workspace 公共类型。
- *
- * 关键点（中文）
- * - Workspace 是统一资源容器，同时提供 Store、Tool 与可选 Shell。
- * - 所有平台共用同一类型，平台差异由可选 Shell 的 Sandbox Adapter 处理。
- */
-export {};
-//# sourceMappingURL=Workspace.js.map

package/bin/types/workspace/Workspace.js.map

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

package/bin/types/workspace/WorkspaceEnv.d.ts

@@ -1,16 +0,0 @@
-/**
- * Workspace 环境变量公共类型。
- *
- * 关键点（中文）
- * - Env 属于项目执行环境，由 Workspace 持有。
- * - Agent 只订阅 Env 变化并在 Session Step 检查点同步。
- */
-/** Workspace 环境变量的运行时修改输入。 */
-export type WorkspaceEnvPatch = Record<string, string | null | undefined>;
-/** Workspace 环境变量变化订阅器。 */
-export type WorkspaceEnvSubscriber = (
-/** 本次修改完成后的完整环境变量快照。 */
-env: Readonly<Record<string, string>>) => void;
-/** 取消 Workspace 环境变量订阅的函数。 */
-export type WorkspaceEnvUnsubscribe = () => void;
-//# sourceMappingURL=WorkspaceEnv.d.ts.map

package/bin/types/workspace/WorkspaceEnv.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WorkspaceEnv.d.ts","sourceRoot":"","sources":["../../../src/types/workspace/WorkspaceEnv.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8BAA8B;AAC9B,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAE1E,2BAA2B;AAC3B,MAAM,MAAM,sBAAsB,GAAG;AACnC,wBAAwB;AACxB,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAClC,IAAI,CAAC;AAEV,8BAA8B;AAC9B,MAAM,MAAM,uBAAuB,GAAG,MAAM,IAAI,CAAC"}

package/bin/types/workspace/WorkspaceEnv.js

@@ -1,9 +0,0 @@
-/**
- * Workspace 环境变量公共类型。
- *
- * 关键点（中文）
- * - Env 属于项目执行环境，由 Workspace 持有。
- * - Agent 只订阅 Env 变化并在 Session Step 检查点同步。
- */
-export {};
-//# sourceMappingURL=WorkspaceEnv.js.map

package/bin/types/workspace/WorkspaceEnv.js.map

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

package/bin/types/workspace/WorkspaceTools.d.ts

@@ -1,20 +0,0 @@
-/**
- * Workspace 工具集合类型。
- *
- * 关键点（中文）
- * - 只包含对当前 Workspace 文件、搜索和可选 Shell 的操作。
- * - Plugin Tool 与调用方自定义 Tool 不属于本类型，由 Agent 统一注册。
- */
-import type { Tool } from "ai";
-import type { FileSystem } from "../../types/workspace/FileSystem.js";
-import type { Shell } from "@downcity/shell";
-/** 当前 Workspace 向 Agent 提供的模型工具集合。 */
-export type WorkspaceTools = Record<string, Tool>;
-/** Workspace Tools 构造参数。 */
-export interface CreateWorkspaceToolsOptions {
-    /** 当前 Workspace 唯一的 rooted 文件能力。 */
-    files: FileSystem;
-    /** 当前 Workspace 可选的命令与进程能力。 */
-    shell?: Shell;
-}
-//# sourceMappingURL=WorkspaceTools.d.ts.map

package/bin/types/workspace/WorkspaceTools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WorkspaceTools.d.ts","sourceRoot":"","sources":["../../../src/types/workspace/WorkspaceTools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,sCAAsC;AACtC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAElD,4BAA4B;AAC5B,MAAM,WAAW,2BAA2B;IAC1C,oCAAoC;IACpC,KAAK,EAAE,UAAU,CAAC;IAElB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC;CACf"}

package/bin/types/workspace/WorkspaceTools.js

@@ -1,9 +0,0 @@
-/**
- * Workspace 工具集合类型。
- *
- * 关键点（中文）
- * - 只包含对当前 Workspace 文件、搜索和可选 Shell 的操作。
- * - Plugin Tool 与调用方自定义 Tool 不属于本类型，由 Agent 统一注册。
- */
-export {};
-//# sourceMappingURL=WorkspaceTools.js.map

package/bin/types/workspace/WorkspaceTools.js.map

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

package/bin/utils/cli/CliOutput.d.ts

@@ -1,14 +0,0 @@
-/**
- * 标准化输出结果。
- *
- * 输出策略（中文）
- * - 默认 JSON（便于脚本解析）。
- * - `asJson=false` 时输出可读文本。
- */
-export declare function print_result(params: {
-    asJson?: boolean;
-    success: boolean;
-    title: string;
-    payload: Record<string, unknown>;
-}): void;
-//# sourceMappingURL=CliOutput.d.ts.map

package/bin/utils/cli/CliOutput.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CliOutput.d.ts","sourceRoot":"","sources":["../../../src/utils/cli/CliOutput.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG,IAAI,CAsBP"}