@downcity/agent 1.1.1

package/bin/types/contact/ContactLink.d.ts

@@ -0,0 +1,160 @@
+/**
+ * contact link 类型。
+ *
+ * 关键点（中文）
+ * - link code 是人工转交的一次性点对点建联凭证。
+ * - approve 成功后 link 立即失效。
+ */
+/**
+ * link code 内部载荷。
+ */
+export interface ContactLinkCodePayload {
+    /**
+     * link code 协议版本。
+     */
+    version: 1;
+    /**
+     * link 稳定标识。
+     */
+    linkId: string;
+    /**
+     * 发起方 agent 名称。
+     */
+    agentName: string;
+    /**
+     * 发起方 HTTP endpoint。
+     */
+    endpoint: string;
+    /**
+     * 一次性明文 secret。
+     */
+    secret: string;
+    /**
+     * link 创建时间戳。
+     */
+    createdAt: number;
+    /**
+     * link 过期时间戳。
+     */
+    expiresAt: number;
+}
+/**
+ * 本地保存的 link 记录。
+ */
+export interface ContactLinkRecord {
+    /**
+     * link 稳定标识。
+     */
+    id: string;
+    /**
+     * 发起方 agent 名称。
+     */
+    agentName: string;
+    /**
+     * 发起方 HTTP endpoint。
+     */
+    endpoint: string;
+    /**
+     * 一次性 secret hash。
+     */
+    secretHash: string;
+    /**
+     * link 创建时间戳。
+     */
+    createdAt: number;
+    /**
+     * link 过期时间戳。
+     */
+    expiresAt: number;
+    /**
+     * link 被使用的时间戳。
+     */
+    usedAt?: number | null;
+    /**
+     * 已使用该 link 的 approve 方 agent 名称；用于同一 agent 在网络中断或本地保存失败后做幂等重试。
+     */
+    approvedAgentName?: string | null;
+    /**
+     * approve 方在建联时提供的 HTTP endpoint；没有公开 endpoint 时为空。
+     */
+    approvedEndpoint?: string | null;
+    /**
+     * 发起方发给 approve 方的明文 contact token；只保存在本地 link 记录中，用于同一 link 在有效期内重试恢复。
+     */
+    tokenForOwner?: string | null;
+    /**
+     * approve 方发给发起方的明文 contact token；仅作为 confirm 阶段的本地恢复元数据。
+     */
+    tokenForRequester?: string | null;
+    /**
+     * approve 方推导回连候选的原因；用于 confirm 失败后的诊断。
+     */
+    callbackReason?: ContactApproveCallbackReason | null;
+    /**
+     * 发起方成功 confirm 并升级为 bidirectional 的时间戳。
+     */
+    confirmedAt?: number | null;
+}
+/**
+ * approve 方声明自己可被回连的推导原因。
+ */
+export type ContactApproveCallbackReason = "missing-requester-endpoint" | "requester-public" | "same-loopback-host" | "same-private-network" | "requester-not-routable-from-target";
+/**
+ * 远端 approve link 请求。
+ */
+export interface ContactApproveLinkRequest {
+    /**
+     * link 稳定标识。
+     */
+    linkId: string;
+    /**
+     * 一次性明文 secret。
+     */
+    secret: string;
+    /**
+     * approve 方 agent 名称。
+     */
+    agentName: string;
+    /**
+     * approve 方 HTTP endpoint；缺省时只建立发起方可接收请求的单向 contact。
+     */
+    endpoint?: string;
+    /**
+     * 发起方后续调用 approve 方时使用的 token；只有 approve 方提供 endpoint 时才需要。
+     */
+    tokenForRequester?: string;
+    /**
+     * approve 方是否提供了一个回连候选；这不是双向确认结果，发起方必须再执行 confirm 主动检查。
+     */
+    callbackOffered?: boolean;
+    /**
+     * approve 方推导 `callbackOffered` 的原因，方便接收方和用户诊断网络关系。
+     */
+    callbackReason?: ContactApproveCallbackReason;
+}
+/**
+ * 远端 approve link 响应。
+ */
+export interface ContactApproveLinkResponse {
+    /**
+     * approve 是否成功。
+     */
+    success: boolean;
+    /**
+     * 发起方 agent 名称。
+     */
+    agentName: string;
+    /**
+     * 发起方 HTTP endpoint。
+     */
+    endpoint: string;
+    /**
+     * approve 方后续调用发起方时使用的 token。
+     */
+    tokenForOwner: string;
+    /**
+     * 失败原因。
+     */
+    error?: string;
+}
+//# sourceMappingURL=ContactLink.d.ts.map

package/bin/types/contact/ContactLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContactLink.d.ts","sourceRoot":"","sources":["../../../src/types/contact/ContactLink.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC;IACX;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;OAEG;IACH,cAAc,CAAC,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACrD;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,4BAA4B,GACpC,4BAA4B,GAC5B,kBAAkB,GAClB,oBAAoB,GACpB,sBAAsB,GACtB,oCAAoC,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,cAAc,CAAC,EAAE,4BAA4B,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/bin/types/contact/ContactLink.js

@@ -0,0 +1,9 @@
+/**
+ * contact link 类型。
+ *
+ * 关键点（中文）
+ * - link code 是人工转交的一次性点对点建联凭证。
+ * - approve 成功后 link 立即失效。
+ */
+export {};
+//# sourceMappingURL=ContactLink.js.map

package/bin/types/contact/ContactLink.js.map

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

package/bin/types/contact/ContactShare.d.ts

@@ -0,0 +1,163 @@
+/**
+ * contact share 类型。
+ *
+ * 关键点（中文）
+ * - share 是通用内容分享，不绑定 skill 概念。
+ * - 文本、链接、文件、目录都进入 inbox，由接收方显式 receive。
+ */
+/**
+ * share item 类型。
+ */
+export type ContactShareItemType = "text" | "link" | "file" | "directory";
+/**
+ * inbox share 状态。
+ */
+export type ContactInboxShareStatus = "pending" | "received";
+/**
+ * inbox share 轻量元信息。
+ */
+export interface ContactInboxShareMeta {
+    /**
+     * share 稳定标识。
+     */
+    id: string;
+    /**
+     * 发送方 contact id。
+     */
+    fromContactId: string;
+    /**
+     * 发送方 agent 名称。
+     */
+    fromAgentName: string;
+    /**
+     * 面向用户展示的标题。
+     */
+    title: string;
+    /**
+     * 当前接收状态。
+     */
+    status: ContactInboxShareStatus;
+    /**
+     * 接收时间戳。
+     */
+    receivedAt: number;
+    /**
+     * 内容总大小。
+     */
+    sizeBytes: number;
+    /**
+     * 内容条目数量。
+     */
+    itemCount: number;
+}
+/**
+ * share item 中的单个文件 manifest。
+ */
+export interface ContactShareFileManifest {
+    /**
+     * item 根目录内相对路径。
+     */
+    path: string;
+    /**
+     * 文件 sha256。
+     */
+    sha256: string;
+}
+/**
+ * share payload 中的单个 item。
+ */
+export interface ContactShareItem {
+    /**
+     * item 稳定标识。
+     */
+    id: string;
+    /**
+     * item 类型。
+     */
+    type: ContactShareItemType;
+    /**
+     * item 展示标题。
+     */
+    title: string;
+    /**
+     * 文本内容。
+     */
+    text?: string;
+    /**
+     * 链接 URL。
+     */
+    url?: string;
+    /**
+     * share files 下的根目录名。
+     */
+    root?: string;
+    /**
+     * 文件 manifest 列表。
+     */
+    files?: ContactShareFileManifest[];
+}
+/**
+ * 通用 share payload。
+ */
+export interface ContactSharePayload {
+    /**
+     * payload 类型。
+     */
+    kind: "share";
+    /**
+     * share item 列表。
+     */
+    items: ContactShareItem[];
+}
+/**
+ * inbox share payload。
+ */
+export type ContactInboxSharePayload = ContactSharePayload;
+/**
+ * inbox share 文件内容。
+ */
+export interface ContactInboxShareFileInput {
+    /**
+     * share files 目录下的相对路径。
+     */
+    relativePath: string;
+    /**
+     * 文件内容。
+     */
+    content: string;
+    /**
+     * 内容编码。
+     *
+     * 说明（中文）
+     * - 省略时按 `utf8` 处理，兼容测试和手写 payload。
+     * - 文件/目录分享默认使用 `base64`，避免二进制文件损坏。
+     */
+    encoding?: "utf8" | "base64";
+}
+/**
+ * 保存 inbox share 的输入。
+ */
+export interface SaveContactInboxShareInput {
+    /**
+     * share 轻量元信息。
+     */
+    meta: ContactInboxShareMeta;
+    /**
+     * share payload。
+     */
+    payload: ContactInboxSharePayload;
+    /**
+     * share 附带文件。
+     */
+    files: ContactInboxShareFileInput[];
+}
+/**
+ * 远端 receive share 请求。
+ */
+export interface ContactReceiveShareRequest extends SaveContactInboxShareInput {
+    /**
+     * 发送方 contact id。
+     */
+    senderContactId: string;
+}
+//# sourceMappingURL=ContactShare.d.ts.map

package/bin/types/contact/ContactShare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContactShare.d.ts","sourceRoot":"","sources":["../../../src/types/contact/ContactShare.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,UAAU,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,uBAAuB,CAAC;IAChC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,IAAI,EAAE,oBAAoB,CAAC;IAC3B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,qBAAqB,CAAC;IAC5B;;OAEG;IACH,OAAO,EAAE,wBAAwB,CAAC;IAClC;;OAEG;IACH,KAAK,EAAE,0BAA0B,EAAE,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,0BAA0B;IAC5E;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/bin/types/contact/ContactShare.js

@@ -0,0 +1,9 @@
+/**
+ * contact share 类型。
+ *
+ * 关键点（中文）
+ * - share 是通用内容分享，不绑定 skill 概念。
+ * - 文本、链接、文件、目录都进入 inbox，由接收方显式 receive。
+ */
+export {};
+//# sourceMappingURL=ContactShare.js.map

package/bin/types/contact/ContactShare.js.map

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

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

@@ -0,0 +1,318 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,10 @@
+/**
+ * SandboxRuntime 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里放的是 agent 执行层内部使用的最小 sandbox 运行时类型。
+ * - 当前只围绕 `SandboxRunner` 设计，不引入复杂 provider / policy / binding 对象。
+ * - 目标是让 `ShellService` 可以直接把命令交给 `SandboxRunner` 执行。
+ */
+export {};
+//# sourceMappingURL=SandboxRuntime.js.map

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

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