@downcity/agent 1.1.8 → 1.1.11

package/bin/types/sandbox/SandboxRuntime.d.ts

@@ -1,318 +0,0 @@
-/**
- * SandboxRuntime 类型定义。
- *
- * 关键点（中文）
- * - 这里放的是 agent 执行层内部使用的最小 sandbox 运行时类型。
- * - 当前只围绕 `SandboxRunner` 设计，不引入复杂 provider / policy / binding 对象。
- * - 目标是让 `ShellService` 可以直接把命令交给 `SandboxRunner` 执行。
- */
-import type { ChildProcessWithoutNullStreams } from "node:child_process";
-import type { SandboxConfig } from "../../shared/types/Sandbox.js";
-import type { SandboxNetworkMode } from "../../shared/types/Sandbox.js";
-/**
- * sandbox 会话状态。
- *
- * 说明（中文）
- * - `shell_exec` 这类 one-shot 命令通常会很快走到终态。
- * - `shell_start` 则会维持一个状态化 sandbox session。
- */
-export type SandboxSessionStatus = "starting" | "running" | "completed" | "failed" | "killed" | "expired";
-/**
- * 单个 sandbox session 快照。
- */
-export interface SandboxSessionSnapshot {
-    /**
-     * sandbox 唯一标识。
-     */
-    sandboxId: string;
-    /**
-     * 原始命令文本。
-     */
-    cmd: string;
-    /**
-     * 当前 sandbox 实际工作目录。
-     */
-    cwd: string;
-    /**
-     * 当前 sandbox 状态。
-     */
-    status: SandboxSessionStatus;
-    /**
-     * 进程 pid。
-     *
-     * 说明（中文）
-     * - 某些 backend 可能拿不到宿主 pid，这时为空。
-     */
-    pid?: number;
-    /**
-     * 创建时间戳（毫秒）。
-     */
-    startedAt: number;
-    /**
-     * 最近更新时间戳（毫秒）。
-     */
-    updatedAt: number;
-    /**
-     * 结束时间戳（毫秒）。
-     */
-    endedAt?: number;
-    /**
-     * 退出码。
-     */
-    exitCode?: number;
-    /**
-     * 最近输出预览。
-     */
-    lastOutputPreview?: string;
-    /**
-     * 累计输出字符数。
-     */
-    outputChars: number;
-    /**
-     * 版本号。
-     *
-     * 说明（中文）
-     * - 任意状态或输出变化都递增，供 wait/read 增量判断使用。
-     */
-    version: number;
-}
-/**
- * sandbox 输出块。
- */
-export interface SandboxOutputChunk {
-    /**
-     * 当前输出块所属 sandbox 标识。
-     */
-    sandboxId: string;
-    /**
-     * 输出文本。
-     */
-    output: string;
-    /**
-     * 起始游标。
-     */
-    startCursor: number;
-    /**
-     * 结束游标。
-     */
-    endCursor: number;
-    /**
-     * 原始输出字符数。
-     */
-    originalChars: number;
-    /**
-     * 是否还有更多输出未读。
-     */
-    hasMoreOutput: boolean;
-}
-/**
- * one-shot 命令执行请求。
- */
-export interface SandboxExecRequest {
-    /**
-     * 最终使用的 sandbox 配置。
-     */
-    config: SandboxConfig;
-    /**
-     * 要执行的命令文本。
-     */
-    cmd: string;
-    /**
-     * 可选工作目录。
-     */
-    cwd?: string;
-    /**
-     * 可选 shell 可执行文件。
-     */
-    shell?: string;
-    /**
-     * 是否以 login shell 语义执行。
-     */
-    login?: boolean;
-}
-/**
- * 状态化 sandbox session 启动请求。
- */
-export interface SandboxStartRequest extends SandboxExecRequest {
-}
-/**
- * sandbox 会话读取请求。
- */
-export interface SandboxReadRequest {
-    /**
-     * 目标 sandbox 标识。
-     */
-    sandboxId: string;
-    /**
-     * 从哪个游标开始增量读取。
-     */
-    fromCursor?: number;
-}
-/**
- * sandbox 会话写入请求。
- */
-export interface SandboxWriteRequest {
-    /**
-     * 目标 sandbox 标识。
-     */
-    sandboxId: string;
-    /**
-     * 要写入 stdin 的原始文本。
-     */
-    chars: string;
-}
-/**
- * sandbox 会话等待请求。
- */
-export interface SandboxWaitRequest {
-    /**
-     * 目标 sandbox 标识。
-     */
-    sandboxId: string;
-    /**
-     * 仅当版本号大于该值时才立即返回。
-     */
-    afterVersion?: number;
-    /**
-     * 最长等待毫秒数。
-     */
-    timeoutMs?: number;
-}
-/**
- * sandbox 会话关闭请求。
- */
-export interface SandboxCloseRequest {
-    /**
-     * 目标 sandbox 标识。
-     */
-    sandboxId: string;
-    /**
-     * 是否强制关闭。
-     */
-    force?: boolean;
-}
-/**
- * `SandboxRunner` 最小接口。
- *
- * 说明（中文）
- * - `exec` 用于 one-shot 命令。
- * - `start/read/write/wait/close` 用于状态化 shell session。
- */
-export interface SandboxRunner {
-    /**
-     * 执行一次 one-shot 命令并等待完成。
-     */
-    exec(request: SandboxExecRequest): Promise<{
-        snapshot: SandboxSessionSnapshot;
-        chunk: SandboxOutputChunk;
-    }>;
-    /**
-     * 启动一个状态化 sandbox session。
-     */
-    start(request: SandboxStartRequest): Promise<{
-        snapshot: SandboxSessionSnapshot;
-        chunk: SandboxOutputChunk;
-    }>;
-    /**
-     * 读取 sandbox 输出。
-     */
-    read(request: SandboxReadRequest): Promise<{
-        snapshot: SandboxSessionSnapshot;
-        chunk: SandboxOutputChunk;
-    }>;
-    /**
-     * 向 sandbox stdin 写入内容。
-     */
-    write(request: SandboxWriteRequest): Promise<{
-        snapshot: SandboxSessionSnapshot;
-    }>;
-    /**
-     * 等待 sandbox 状态变化。
-     */
-    wait(request: SandboxWaitRequest): Promise<{
-        snapshot: SandboxSessionSnapshot;
-        chunk: SandboxOutputChunk;
-    }>;
-    /**
-     * 关闭 sandbox session。
-     */
-    close(request: SandboxCloseRequest): Promise<{
-        snapshot: SandboxSessionSnapshot;
-    }>;
-}
-/**
- * 运行时归一化后的 sandbox 配置。
- *
- * 说明（中文）
- * - 这里的路径都已经解析成绝对路径。
- * - 当前版本强制要求 shell 命令走 sandbox，不再允许回退到宿主机普通子进程执行。
- */
-export interface ResolvedSandboxConfig extends SandboxConfig {
-    /**
-     * 当前运行时选中的 backend。
-     */
-    backend: "macos-seatbelt";
-}
-/**
- * 单次 shell 启动时传给 sandbox backend 的归一化参数。
- */
-export interface SandboxSpawnParams {
-    /**
-     * 当前 shell 会话标识。
-     */
-    shellId: string;
-    /**
-     * shell 会话目录。
-     */
-    shellDir: string;
-    /**
-     * 要执行的原始命令文本。
-     */
-    cmd: string;
-    /**
-     * 最终工作目录。
-     */
-    cwd: string;
-    /**
-     * shell 可执行文件路径。
-     */
-    shellPath: string;
-    /**
-     * 是否使用 login shell 语义。
-     */
-    login: boolean;
-    /**
-     * sandbox 生效前的基础环境变量。
-     */
-    baseEnv: NodeJS.ProcessEnv;
-    /**
-     * 当前请求最终使用的 sandbox 配置。
-     */
-    config: ResolvedSandboxConfig;
-}
-/**
- * sandbox backend 返回的进程启动结果。
- */
-export interface SandboxSpawnResult {
-    /**
-     * 已启动的子进程句柄。
-     */
-    child: ChildProcessWithoutNullStreams;
-    /**
-     * 当前子进程实际使用的工作目录。
-     */
-    cwd: string;
-    /**
-     * 当前进程是否实际运行在 sandbox 中。
-     */
-    sandboxed: boolean;
-    /**
-     * 当前使用的 backend 名称。
-     */
-    backend: "macos-seatbelt";
-    /**
-     * 当前实际采用的网络模式。
-     */
-    networkMode: SandboxNetworkMode;
-}
-//# sourceMappingURL=SandboxRuntime.d.ts.map

package/bin/types/sandbox/SandboxRuntime.d.ts.map

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

package/bin/types/sandbox/SandboxRuntime.js.map

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

package/bin/types/session/SessionExecutor.d.ts

@@ -1,18 +0,0 @@
-/**
- * SessionExecutor 抽象类型。
- *
- * 关键点（中文）
- * - 统一表达“某个 session 的实际执行器”。
- * - 当前只有 api 执行模式。
- */
-import type { SessionRunInput, SessionRunResult } from "../../types/session/SessionRun.js";
-/**
- * 单个 session 执行器接口。
- */
-export interface SessionExecutor {
-    /**
-     * 执行一次 session run。
-     */
-    run(input: SessionRunInput): Promise<SessionRunResult>;
-}
-//# sourceMappingURL=SessionExecutor.d.ts.map

package/bin/types/session/SessionExecutor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionExecutor.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAexD"}

package/bin/types/session/SessionExecutor.js.map

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

package/bin/types/session/SessionHistoryMeta.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionHistoryMeta.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionHistoryMeta.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,iBAAiB;IACjB,CAAC,EAAE,CAAC,CAAC;IACL,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,SAAS,CAAC,EAAE,yBAAyB,CAAC;CACvC,CAAC"}

package/bin/types/session/SessionHistoryMeta.js.map

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

package/bin/types/session/SessionHistoryPaths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionHistoryPaths.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionHistoryPaths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC"}

package/bin/types/session/SessionHistoryPaths.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionHistoryPaths.js","sourceRoot":"","sources":["../../../src/types/session/SessionHistoryPaths.ts"],"names":[],"mappings":""}

package/bin/types/session/SessionLoop.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionLoop.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionLoop.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,qBAAqB,EAAE,OAAO,CAAC;IAE/B;;OAEG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1C;;OAEG;IACH,yBAAyB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,wBAAwB,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EACA,oBAAoB,GACpB,yBAAyB,GACzB,wBAAwB,GACxB,MAAM,CAAC;IAEX;;OAEG;IACH,oBAAoB,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,6BAA6B,EAAE,OAAO,CAAC;CACxC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,sBAAsB,EAAE,MAAM,CAAC;CAChC"}

package/bin/types/session/SessionLoop.js.map

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

package/bin/types/session/SessionMessages.d.ts

@@ -1,83 +0,0 @@
-/**
- * SessionMessage 类型定义。
- *
- * 关键点（中文）
- * - 这里统一描述 session 消息落盘格式与元信息结构。
- * - session 的唯一事实源是 `UIMessage[]`，不会再维护第二套平行消息结构。
- * - 这些类型会被 history Composer、compact、control UI、task runtime 共同复用。
- */
-import type { UIMessage } from "ai";
-import type { JsonObject } from "../../shared/types/Json.js";
-/**
- * Session 消息：以 UIMessage[] 作为唯一事实源。
- *
- * 关键点（中文）
- * - 持久化存储在 `.downcity/session/<encodedSessionId>/messages/messages.jsonl`
- * - 默认只存 `role=user|assistant`
- * - compact 会把更早消息压缩为一条 `assistant` 摘要消息
- */
-export type SessionMessageKind = "normal" | "summary";
-/**
- * Session 消息来源类型。
- *
- * 说明（中文）
- * - `ingress`：外部输入写入的 user 消息。
- * - `egress`：模型或 agent 输出写入的 assistant 消息。
- * - `compact`：由 compact 过程生成的摘要消息。
- */
-export type SessionMessageSource = "ingress" | "egress" | "compact";
-/**
- * 入站消息细分类型。
- *
- * 说明（中文）
- * - 当前仅保留 `exec`，表示这条入站消息可触发一次 session 执行。
- */
-export type SessionIngressKind = "exec";
-/**
- * 摘要消息对应的原始消息范围。
- */
-export type SessionMessageSourceRangeV1 = {
-    /** 起始消息 ID。 */
-    fromId: string;
-    /** 结束消息 ID。 */
-    toId: string;
-    /** 被覆盖的原始消息数量。 */
-    count: number;
-};
-/**
- * Session 消息元信息。
- */
-export type SessionMetadataV1 = {
-    /** 元信息 schema 版本号。 */
-    v: 1;
-    /** 当前消息写入时的毫秒时间戳。 */
-    ts: number;
-    /** 当前消息所属的 session ID。 */
-    sessionId: string;
-    /** 当前消息是普通消息还是摘要消息。 */
-    kind?: SessionMessageKind;
-    /** 当前消息来自入站、出站还是 compact。 */
-    source?: SessionMessageSource;
-    /** compact 摘要所覆盖的原始消息范围。 */
-    sourceRange?: SessionMessageSourceRangeV1;
-    /**
-     * 扩展元信息。
-     *
-     * 约定（中文）
-     * - 对 `source=ingress` 的 user 消息，可选写入 `extra.ingressKind`：
-     *   - `exec`：可触发 Session 执行的输入
-     */
-    extra?: JsonObject;
-};
-/**
- * Session UI 消息结构。
- */
-export type SessionMessageV1 = UIMessage<SessionMetadataV1>;
-/**
- * user 角色的 Session 消息结构。
- */
-export type SessionUserMessageV1 = SessionMessageV1 & {
-    /** 消息角色固定为 `user`。 */
-    role: "user";
-};
-//# sourceMappingURL=SessionMessages.d.ts.map

package/bin/types/session/SessionMessages.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionMessages.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionMessages.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,sBAAsB;IACtB,CAAC,EAAE,CAAC,CAAC;IACL,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,6BAA6B;IAC7B,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,4BAA4B;IAC5B,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAC1C;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IACpD,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}

package/bin/types/session/SessionMessages.js.map

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

package/bin/types/session/SessionPrompts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionPrompts.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionPrompts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC"}

package/bin/types/session/SessionPrompts.js.map

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

package/bin/types/session/SessionRun.d.ts

@@ -1,112 +0,0 @@
-/**
- * Session 运行结果与输入类型。
- *
- * 关键点（中文）
- * - `SessionRunInput` 表示上层会话入口输入（例如 context query）。
- * - `SessionExecuteInput` 表示 LocalSessionCore 通过 Composer 装配后的中间运行态。
- * - 输出仅暴露 assistantMessage（UIMessage）。
- */
-import type { Tool, UIMessageChunk } from "ai";
-import type { SessionMessageV1 } from "../../types/session/SessionMessages.js";
-import type { SessionSystemMessage } from "../../types/session/SessionPrompts.js";
-/**
- * Assistant step 可见性。
- *
- * 说明（中文）
- * - `visible`：ACP `agent_message_chunk` 或普通模型文本，属于用户可见回复。
- * - `internal`：ACP `agent_thought_chunk` 等内部过程，应作为 reasoning 保留，但不能混入普通 text。
- */
-export type SessionAssistantStepVisibility = "visible" | "internal";
-/**
- * Assistant step 回调入参。
- */
-export interface SessionAssistantStepCallbackInput {
-    /**
-     * 当前 step 生成的文本。
-     */
-    text: string;
-    /**
-     * 当前 step 序号（从 1 开始）。
-     */
-    stepIndex: number;
-    /**
-     * 当前 step 的可见性。
-     *
-     * 关键点（中文）
-     * - 未声明时按 `visible` 处理，兼容本地模型与旧调用方。
-     * - `internal` 会落盘为 reasoning part，外部渠道不应当成普通回复文本发送。
-     */
-    visibility?: SessionAssistantStepVisibility;
-    /**
-     * 当前 step 的原始结果对象。
-     *
-     * 关键点（中文）
-     * - 由运行时直接透传，供持久化层提取 tool call / tool result 顺序事件。
-     * - 外部调用方不应依赖其稳定结构，只能做 best-effort 读取。
-     */
-    stepResult?: unknown;
-}
-/**
- * Assistant step 完成回调。
- */
-export type SessionAssistantStepCallback = (input: SessionAssistantStepCallbackInput) => Promise<void>;
-/**
- * UI stream chunk 回调入参。
- *
- * 关键点（中文）
- * - 这里直接复用 AI SDK 的 `UIMessageChunk` 结构，避免在 session 内核层再复制一套协议。
- * - SDK / HTTP / RPC 若需要自己的事件模型，应在更上层做映射。
- */
-export type SessionUiMessageChunk = UIMessageChunk;
-/**
- * UI stream chunk 回调。
- */
-export type SessionUiMessageChunkCallback = (chunk: SessionUiMessageChunk) => Promise<void>;
-/**
- * Session 执行结果。
- */
-export interface SessionRunResult {
-    /**
-     * 本轮执行是否成功。
-     */
-    success: boolean;
-    /**
-     * 失败时的错误信息（成功时为空）。
-     */
-    error?: string;
-    /**
-     * 最终 assistant 消息。
-     */
-    assistantMessage: SessionMessageV1;
-}
-/**
- * Session 运行入口输入。
- */
-export interface SessionRunInput {
-    /**
-     * 本轮用户输入查询文本。
-     */
-    query: string;
-}
-/**
- * LocalSessionCore 通过 Composer 装配后的中间运行态。
- */
-export interface SessionExecuteInput {
-    /**
-     * 当前轮用户查询文本。
-     */
-    query: string;
-    /**
-     * 当前轮 system messages。
-     */
-    system: SessionSystemMessage[];
-    /**
-     * 当前轮 context 语义消息历史。
-     */
-    messages: SessionMessageV1[];
-    /**
-     * 当前轮可用工具集合。
-     */
-    tools: Record<string, Tool>;
-}
-//# sourceMappingURL=SessionRun.d.ts.map

package/bin/types/session/SessionRun.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionRun.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionRun.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,MAAM,8BAA8B,GAAG,SAAS,GAAG,UAAU,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,8BAA8B,CAAC;IAE5C;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,CACzC,KAAK,EAAE,iCAAiC,KACrC,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,CAC1C,KAAK,EAAE,qBAAqB,KACzB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAE/B;;OAEG;IACH,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAE7B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAC7B"}

package/bin/types/session/SessionRun.js.map

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

package/scripts/copy-prompt-assets.mjs

@@ -1,72 +0,0 @@
-import fs from "fs-extra";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-/**
- * Copy txt assets required by runtime.
- *
- * 关键点（中文）
- * - `tsc` 不会复制 txt 资源文件，运行时又依赖这些文件，必须在 build 后补复制。
- * - 统一规则：复制 `src/` 下所有 `.txt` 文件到 `bin/` 对应相对路径。
- */
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-const packageRoot = path.resolve(__dirname, "..");
-
-/**
- * 递归收集匹配文件。
- */
-async function collectFiles(params) {
-  const { rootDir, matcher } = params;
-  const out = [];
-  if (!(await fs.pathExists(rootDir))) return out;
-
-  const walk = async (dir) => {
-    const entries = await fs.readdir(dir, { withFileTypes: true });
-    for (const entry of entries) {
-      const absPath = path.join(dir, entry.name);
-      if (entry.isDirectory()) {
-        await walk(absPath);
-        continue;
-      }
-      if (entry.isFile() && matcher(absPath)) {
-        out.push(absPath);
-      }
-    }
-  };
-
-  await walk(rootDir);
-  return out;
-}
-
-const srcRoot = path.join(packageRoot, "src");
-const txtFiles = await collectFiles({
-  rootDir: srcRoot,
-  matcher: (filePath) => filePath.endsWith(".txt"),
-});
-const copyJobs = txtFiles.map((srcPath) => {
-  const relPath = path.relative(srcRoot, srcPath);
-  return {
-    srcPath,
-    dstPath: path.join(packageRoot, "bin", relPath),
-  };
-});
-
-if (copyJobs.length === 0) {
-  console.log("[copy-prompt-assets] skip: no txt assets found under src/");
-  process.exit(0);
-}
-
-for (const job of copyJobs) {
-  await fs.ensureDir(path.dirname(job.dstPath));
-  await fs.copy(job.srcPath, job.dstPath, {
-    overwrite: true,
-    dereference: true,
-  });
-}
-
-console.log(
-  "[copy-prompt-assets] copied " + String(copyJobs.length) + " file(s) to bin",
-);