@downcity/city 1.1.4 → 1.1.6

package/src/types/contact/ContactCommand.ts

@@ -1,98 +0,0 @@
-/**
- * contact service command 类型。
- *
- * 关键点（中文）
- * - 这里只描述 action payload/response，不承载运行时存储逻辑。
- */
-
-/**
- * contact link command 输入。
- */
-export interface ContactLinkCommandPayload {
-  /**
-   * 内部解析出的本 agent 对外可访问 endpoint；CLI 不暴露该字段。
-   */
-  endpoint?: string;
-  /**
-   * link 过期秒数。
-   */
-  ttlSeconds?: number;
-}
-
-/**
- * contact approve command 输入。
- */
-export interface ContactApproveCommandPayload {
-  /**
-   * 人工转交的 link code。
-   */
-  code: string;
-  /**
-   * 本地保存 contact 时使用的别名。
-   */
-  name?: string;
-  /**
-   * 内部解析出的本 agent 对外可访问 endpoint；CLI 不暴露该字段，省略时 approve 方只建立主动访问对方的单向 contact。
-   */
-  endpoint?: string;
-}
-
-/**
- * contact check command 输入。
- */
-export interface ContactCheckCommandPayload {
-  /**
-   * 已保存 contact 名称。
-   */
-  target?: string;
-  /**
-   * 未保存 agent endpoint。
-   */
-  endpoint?: string;
-}
-
-/**
- * contact chat command 输入。
- */
-export interface ContactChatCommandPayload {
-  /**
-   * 已保存 contact 名称。
-   */
-  to: string;
-  /**
-   * 本轮消息正文。
-   */
-  message?: string;
-}
-
-/**
- * contact share command 输入。
- */
-export interface ContactShareCommandPayload {
-  /**
-   * 已保存 contact 名称。
-   */
-  to: string;
-  /**
-   * 分享的文本内容。
-   */
-  text?: string;
-  /**
-   * 分享的链接列表。
-   */
-  links?: string[];
-  /**
-   * 分享的文件或目录路径列表。
-   */
-  paths?: string[];
-}
-
-/**
- * contact receive command 输入。
- */
-export interface ContactReceiveCommandPayload {
-  /**
-   * inbox share id。
-   */
-  shareId: string;
-}

package/src/types/contact/ContactEndpoint.ts

@@ -1,16 +0,0 @@
-/**
- * contact endpoint 提示类型。
- *
- * 关键点（中文）
- * - endpoint 可达性只用于给 agent / 用户解释当前联系码适合谁使用。
- * - 它不参与鉴权，鉴权仍由 link secret 与 contact token 完成。
- */
-
-/**
- * contact endpoint 的粗粒度可达范围。
- */
-export type ContactEndpointReachability =
-  | "loopback"
-  | "private"
-  | "public"
-  | "unknown";

package/src/types/contact/ContactLink.ts

@@ -1,169 +0,0 @@
-/**
- * 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;
-}

package/src/types/contact/ContactShare.ts

@@ -1,172 +0,0 @@
-/**
- * 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;
-}