@downcity/plugins 1.0.4

package/bin/contact/types/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/contact/types/ContactLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContactLink.d.ts","sourceRoot":"","sources":["../../../src/contact/types/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/contact/types/ContactLink.js

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

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

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

package/bin/contact/types/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/contact/types/ContactShare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContactShare.d.ts","sourceRoot":"","sources":["../../../src/contact/types/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/contact/types/ContactShare.js

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

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

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

package/bin/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @downcity/plugins 公开入口。
+ *
+ * 关键点（中文）
+ * - 这个包专门承载 Downcity 内建 plugin 的对外消费入口。
+ * - 本包只导出具体 plugin class 与默认内建集合工厂。
+ * - 注册、目录、HTTP、CLI、action 执行都由 `@downcity/agent` 的通用能力处理。
+ */
+export { BUILTIN_PLUGIN_CLASSES, createBuiltinPlugins, } from "./BuiltinPlugins.js";
+export type { BuiltinPluginClass } from "./BuiltinPlugins.js";
+export { ChatPlugin } from "./chat/ChatPlugin.js";
+export { ChatChannelAccountManager } from "./chat/accounts/ChannelAccountManager.js";
+export { AuthPlugin } from "./auth/Plugin.js";
+export { SkillPlugin } from "./skill/Plugin.js";
+export { WebPlugin } from "./web/Plugin.js";
+export { AsrPlugin } from "./asr/Plugin.js";
+export { TtsPlugin } from "./tts/Plugin.js";
+export { WorkboardPlugin } from "./workboard/Plugin.js";
+export { listChatAuthorizationRoles, readChatAuthorizationConfigSync, setChatAuthorizationUserRole, } from "./auth/runtime/AuthorizationConfig.js";
+export { resolveAuthorizedUserRole } from "./auth/runtime/AuthorizationPolicy.js";
+export { CHAT_AUTHORIZATION_CHANNELS, createDefaultChatAuthorizationRoles, isChatAuthorizationChannel, } from "./auth/types/AuthPlugin.js";
+export type { ChatChannelAccountListItem, } from "./chat/types/ChannelAccount.js";
+export type { ChatPluginFeishuOptions, ChatPluginOptions, ChatPluginQqOptions, ChatPluginTelegramOptions, } from "./chat/ChatPluginTypes.js";
+export type { AuthObservePrincipalPayload, AuthObservePrincipalResult, AuthResolveUserRolePayload, AuthSetUserRolePayload, AuthWriteConfigPayload, ChatAuthorizationCatalog, ChatAuthorizationChannel, ChatAuthorizationConfig, ChatAuthorizationDecision, ChatAuthorizationEvaluateInput, ChatAuthorizationEvaluateResult, ChatAuthorizationObservedChat, ChatAuthorizationObservedUser, ChatAuthorizationPermission, ChatAuthorizationPermissionMeta, ChatAuthorizationRole, ChatAuthorizationSnapshot, ChatAuthorizationStateFile, ChatChannelAuthorizationConfig, } from "./auth/types/AuthPlugin.js";
+//# sourceMappingURL=index.d.ts.map

package/bin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,EACL,2BAA2B,EAC3B,mCAAmC,EACnC,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,EACzB,8BAA8B,EAC9B,+BAA+B,EAC/B,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,+BAA+B,EAC/B,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC"}

package/bin/index.js

@@ -0,0 +1,21 @@
+/**
+ * @downcity/plugins 公开入口。
+ *
+ * 关键点（中文）
+ * - 这个包专门承载 Downcity 内建 plugin 的对外消费入口。
+ * - 本包只导出具体 plugin class 与默认内建集合工厂。
+ * - 注册、目录、HTTP、CLI、action 执行都由 `@downcity/agent` 的通用能力处理。
+ */
+export { BUILTIN_PLUGIN_CLASSES, createBuiltinPlugins, } from "./BuiltinPlugins.js";
+export { ChatPlugin } from "./chat/ChatPlugin.js";
+export { ChatChannelAccountManager } from "./chat/accounts/ChannelAccountManager.js";
+export { AuthPlugin } from "./auth/Plugin.js";
+export { SkillPlugin } from "./skill/Plugin.js";
+export { WebPlugin } from "./web/Plugin.js";
+export { AsrPlugin } from "./asr/Plugin.js";
+export { TtsPlugin } from "./tts/Plugin.js";
+export { WorkboardPlugin } from "./workboard/Plugin.js";
+export { listChatAuthorizationRoles, readChatAuthorizationConfigSync, setChatAuthorizationUserRole, } from "./auth/runtime/AuthorizationConfig.js";
+export { resolveAuthorizedUserRole } from "./auth/runtime/AuthorizationPolicy.js";
+export { CHAT_AUTHORIZATION_CHANNELS, createDefaultChatAuthorizationRoles, isChatAuthorizationChannel, } from "./auth/types/AuthPlugin.js";
+//# sourceMappingURL=index.js.map

package/bin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,EACL,2BAA2B,EAC3B,mCAAmC,EACnC,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC"}

package/bin/memory/Action.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Memory Service Action 逻辑。
+ *
+ * 关键点（中文）
+ * - 只处理业务动作，不包含 CLI/API 参数映射细节。
+ * - 所有动作统一返回结构化结果，失败不抛给上层。
+ */
+import type { PluginActionResult } from "@downcity/agent/internal/plugin/types/Plugin.js";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+import type { MemoryFlushPayload, MemoryGetPayload, MemorySearchPayload, MemoryStorePayload } from "../memory/types/Memory.js";
+import { type MemoryRuntimeState } from "./runtime/Store.js";
+/**
+ * status action。
+ */
+export declare function statusMemoryAction(context: AgentContext, state: MemoryRuntimeState): Promise<PluginActionResult<JsonValue>>;
+/**
+ * search action。
+ */
+export declare function searchMemoryAction(context: AgentContext, state: MemoryRuntimeState, payload: MemorySearchPayload): Promise<PluginActionResult<JsonValue>>;
+/**
+ * get action。
+ */
+export declare function getMemoryAction(context: AgentContext, payload: MemoryGetPayload): Promise<PluginActionResult<JsonValue>>;
+/**
+ * store action。
+ */
+export declare function storeMemoryAction(context: AgentContext, state: MemoryRuntimeState, payload: MemoryStorePayload): Promise<PluginActionResult<JsonValue>>;
+/**
+ * flush action。
+ */
+export declare function flushMemoryAction(context: AgentContext, state: MemoryRuntimeState, payload: MemoryFlushPayload): Promise<PluginActionResult>;
+/**
+ * 把任意 payload 归一化为 search payload。
+ */
+export declare function toSearchPayload(input: Record<string, unknown>): MemorySearchPayload;
+//# sourceMappingURL=Action.d.ts.map

package/bin/memory/Action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../../src/memory/Action.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAC1F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAG5B;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAaxC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAaxC;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAUxC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAUxC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAU7B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB,CAgBnF"}

package/bin/memory/Action.js

@@ -0,0 +1,111 @@
+/**
+ * Memory Service Action 逻辑。
+ *
+ * 关键点（中文）
+ * - 只处理业务动作，不包含 CLI/API 参数映射细节。
+ * - 所有动作统一返回结构化结果，失败不抛给上层。
+ */
+import { flushMemory } from "./runtime/Flush.js";
+import { collectMemoryStatus, searchMemory, } from "./runtime/Search.js";
+import { MEMORY_DEFAULTS, } from "./runtime/Store.js";
+import { getMemory, storeMemory } from "./runtime/Writer.js";
+/**
+ * status action。
+ */
+export async function statusMemoryAction(context, state) {
+    try {
+        const stats = await collectMemoryStatus(context, state);
+        return {
+            success: true,
+            data: stats,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: String(error),
+        };
+    }
+}
+/**
+ * search action。
+ */
+export async function searchMemoryAction(context, state, payload) {
+    try {
+        const response = await searchMemory(context, state, payload);
+        return {
+            success: true,
+            data: response,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: String(error),
+        };
+    }
+}
+/**
+ * get action。
+ */
+export async function getMemoryAction(context, payload) {
+    try {
+        const data = await getMemory(context, payload);
+        return { success: true, data: data };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: String(error),
+        };
+    }
+}
+/**
+ * store action。
+ */
+export async function storeMemoryAction(context, state, payload) {
+    try {
+        const data = await storeMemory(context, state, payload);
+        return { success: true, data: data };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: String(error),
+        };
+    }
+}
+/**
+ * flush action。
+ */
+export async function flushMemoryAction(context, state, payload) {
+    try {
+        const data = await flushMemory(context, state, payload);
+        return { success: true, data: data };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: String(error),
+        };
+    }
+}
+/**
+ * 把任意 payload 归一化为 search payload。
+ */
+export function toSearchPayload(input) {
+    return {
+        query: String(input.query || ""),
+        maxResults: typeof input.maxResults === "number"
+            ? input.maxResults
+            : typeof input.maxResults === "string"
+                ? Number(input.maxResults)
+                : MEMORY_DEFAULTS.maxResults,
+        minScore: typeof input.minScore === "number"
+            ? input.minScore
+            : typeof input.minScore === "string"
+                ? Number(input.minScore)
+                : MEMORY_DEFAULTS.minScore,
+    };
+}
+//# sourceMappingURL=Action.js.map

package/bin/memory/Action.js.map

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

package/bin/memory/Index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Memory Plugin 导出入口。
+ *
+ * 关键点（中文）
+ * - Index 只负责导出类实现。
+ * - 真正运行时的 per-agent 实例由宿主显式创建并传给 Agent。
+ */
+export { MemoryPlugin } from "./MemoryPlugin.js";
+//# sourceMappingURL=Index.d.ts.map

package/bin/memory/Index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Index.d.ts","sourceRoot":"","sources":["../../src/memory/Index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/bin/memory/Index.js

@@ -0,0 +1,9 @@
+/**
+ * Memory Plugin 导出入口。
+ *
+ * 关键点（中文）
+ * - Index 只负责导出类实现。
+ * - 真正运行时的 per-agent 实例由宿主显式创建并传给 Agent。
+ */
+export { MemoryPlugin } from "./MemoryPlugin.js";
+//# sourceMappingURL=Index.js.map

package/bin/memory/Index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Index.js","sourceRoot":"","sources":["../../src/memory/Index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/bin/memory/MemoryPlugin.d.ts

@@ -0,0 +1,45 @@
+/**
+ * MemoryPlugin：memory plugin 的类实现。
+ *
+ * 关键点（中文）
+ * - memory plugin state 现在归属于 plugin 实例。
+ * - agent 持有 MemoryPlugin 实例，从而天然形成 per-agent 状态边界。
+ * - 运行态只在实例内部缓存，不再放到模块级 Map。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { PluginActions } from "@downcity/agent/internal/plugin/types/Plugin.js";
+import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
+import { type MemoryRuntimeState } from "./runtime/Store.js";
+/**
+ * Memory plugin 类实现。
+ */
+export declare class MemoryPlugin extends BasePlugin {
+    /**
+     * plugin 名称。
+     */
+    readonly name = "memory";
+    /**
+     * 当前实例持有的 memory plugin state。
+     */
+    runtimeState: MemoryRuntimeState | null;
+    /**
+     * 当前 plugin 的 system 文本提供器。
+     */
+    system(context: AgentContext): Promise<string>;
+    /**
+     * 当前 plugin 生命周期。
+     */
+    readonly lifecycle: {
+        start: (context: AgentContext) => Promise<void>;
+        stop: () => Promise<void>;
+    };
+    /**
+     * 当前 plugin action 定义表。
+     */
+    readonly actions: PluginActions;
+    /**
+     * 获取或创建当前实例绑定的 memory plugin state。
+     */
+    private getOrCreateRuntimeState;
+}
+//# sourceMappingURL=MemoryPlugin.d.ts.map

package/bin/memory/MemoryPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryPlugin.d.ts","sourceRoot":"","sources":["../../src/memory/MemoryPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAQhF,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAkD5B;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C;;OAEG;IACH,QAAQ,CAAC,IAAI,YAAY;IAEzB;;OAEG;IACI,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAQ;IAEtD;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAIpD;;OAEG;IACH,QAAQ,CAAC,SAAS;yBACO,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC;oBAKnC,OAAO,CAAC,IAAI,CAAC;MAK7B;IAEF;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CA2I7B;IAEF;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAQhC"}