@downcity/agent 1.1.1

package/bin/services/contact/runtime/Paths.js.map

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

package/bin/services/contact/runtime/RemoteClient.d.ts

@@ -0,0 +1,46 @@
+/**
+ * contact 远端 HTTP 客户端。
+ *
+ * 关键点（中文）
+ * - contact 的 agent-to-agent 调用走独立轻量路由，不依赖用户 CLI auth。
+ * - 已建联后的敏感调用必须携带 contact token。
+ */
+import type { JsonValue } from "../../../shared/types/Json.js";
+/**
+ * 调用远端 ping。
+ */
+export declare function callContactPing<T>(params: {
+    endpoint: string;
+    token?: string;
+}): Promise<T>;
+/**
+ * 调用远端 approve。
+ */
+export declare function callContactApprove<T>(params: {
+    endpoint: string;
+    body: JsonValue;
+}): Promise<T>;
+/**
+ * 调用远端 confirm。
+ */
+export declare function callContactConfirm<T>(params: {
+    endpoint: string;
+    body: JsonValue;
+}): Promise<T>;
+/**
+ * 调用远端 chat。
+ */
+export declare function callContactChat<T>(params: {
+    endpoint: string;
+    token: string;
+    body: JsonValue;
+}): Promise<T>;
+/**
+ * 调用远端 share。
+ */
+export declare function callContactShare<T>(params: {
+    endpoint: string;
+    token: string;
+    body: JsonValue;
+}): Promise<T>;
+//# sourceMappingURL=RemoteClient.d.ts.map

package/bin/services/contact/runtime/RemoteClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteClient.d.ts","sourceRoot":"","sources":["../../../../src/services/contact/runtime/RemoteClient.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAwDxD;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,CAAC,CAAC,CAMb;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;CACjB,GAAG,OAAO,CAAC,CAAC,CAAC,CAMb;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;CACjB,GAAG,OAAO,CAAC,CAAC,CAAC,CAMb;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;CACjB,GAAG,OAAO,CAAC,CAAC,CAAC,CAOb;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;CACjB,GAAG,OAAO,CAAC,CAAC,CAAC,CAOb"}

package/bin/services/contact/runtime/RemoteClient.js

@@ -0,0 +1,102 @@
+/**
+ * contact 远端 HTTP 客户端。
+ *
+ * 关键点（中文）
+ * - contact 的 agent-to-agent 调用走独立轻量路由，不依赖用户 CLI auth。
+ * - 已建联后的敏感调用必须携带 contact token。
+ */
+function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function normalizeEndpoint(endpoint) {
+    const raw = String(endpoint || "").trim();
+    if (!raw)
+        throw new Error("endpoint is required");
+    const withProtocol = /^https?:\/\//i.test(raw) ? raw : `http://${raw}`;
+    const url = new URL(withProtocol);
+    url.pathname = "";
+    url.search = "";
+    url.hash = "";
+    return url.toString().replace(/\/$/, "");
+}
+function unwrapServiceActionEnvelope(value) {
+    if (!isRecord(value))
+        return value;
+    const inner = value.data;
+    if (typeof value.success === "boolean" && isRecord(inner)) {
+        // 关键点（中文）：远端 contact API 挂在统一 service action route 下，HTTP 返回会包一层 { success, data }。
+        return inner;
+    }
+    return value;
+}
+async function postJson(params) {
+    const url = new URL(params.path, normalizeEndpoint(params.endpoint)).toString();
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (params.token)
+        headers["X-Downcity-Contact-Token"] = params.token;
+    const response = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(params.body ?? {}),
+    });
+    const data = (await response.json().catch(() => null));
+    if (!response.ok) {
+        throw new Error(data?.error || data?.message || `HTTP ${response.status}`);
+    }
+    return unwrapServiceActionEnvelope(data);
+}
+/**
+ * 调用远端 ping。
+ */
+export async function callContactPing(params) {
+    return await postJson({
+        endpoint: params.endpoint,
+        path: "/api/contact/ping",
+        token: params.token,
+    });
+}
+/**
+ * 调用远端 approve。
+ */
+export async function callContactApprove(params) {
+    return await postJson({
+        endpoint: params.endpoint,
+        path: "/api/contact/approve",
+        body: params.body,
+    });
+}
+/**
+ * 调用远端 confirm。
+ */
+export async function callContactConfirm(params) {
+    return await postJson({
+        endpoint: params.endpoint,
+        path: "/api/contact/confirm",
+        body: params.body,
+    });
+}
+/**
+ * 调用远端 chat。
+ */
+export async function callContactChat(params) {
+    return await postJson({
+        endpoint: params.endpoint,
+        path: "/api/contact/chat",
+        token: params.token,
+        body: params.body,
+    });
+}
+/**
+ * 调用远端 share。
+ */
+export async function callContactShare(params) {
+    return await postJson({
+        endpoint: params.endpoint,
+        path: "/api/contact/share",
+        token: params.token,
+        body: params.body,
+    });
+}
+//# sourceMappingURL=RemoteClient.js.map

package/bin/services/contact/runtime/RemoteClient.js.map

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

package/bin/services/contact/runtime/ShareBundle.d.ts

@@ -0,0 +1,65 @@
+/**
+ * contact 通用 share 打包与接收。
+ *
+ * 关键点（中文）
+ * - share 不理解 skill，只处理文本、链接、文件和目录。
+ * - receive 不自动安装或执行内容，只把 share 标记为已接收并复制到 received 区。
+ */
+import type { AgentContext } from "../../../types/agent/AgentContext.js";
+import type { ContactReceiveShareRequest, SaveContactInboxShareInput } from "../../../types/contact/ContactShare.js";
+/**
+ * 创建通用 share。
+ */
+export declare function createShareInput(params: {
+    /**
+     * 当前 agent context。
+     */
+    context: AgentContext;
+    /**
+     * 发送方 contact id。
+     */
+    fromContactId: string;
+    /**
+     * 发送方 agent 名称。
+     */
+    fromAgentName: string;
+    /**
+     * 分享文本。
+     */
+    text?: string;
+    /**
+     * 分享链接。
+     */
+    links?: string[];
+    /**
+     * 分享文件或目录路径。
+     */
+    paths?: string[];
+}): Promise<SaveContactInboxShareInput>;
+/**
+ * 接收通用 share。
+ */
+export declare function receiveShare(params: {
+    /**
+     * 项目根目录。
+     */
+    projectRoot: string;
+    /**
+     * share id。
+     */
+    shareId: string;
+}): Promise<{
+    /**
+     * 接收后的 item 数量。
+     */
+    itemCount: number;
+    /**
+     * received 目录。
+     */
+    receivedPath: string;
+}>;
+/**
+ * 构造远端 receive share 请求。
+ */
+export declare function createReceiveShareRequest(input: SaveContactInboxShareInput, senderContactId: string): ContactReceiveShareRequest;
+//# sourceMappingURL=ShareBundle.d.ts.map

package/bin/services/contact/runtime/ShareBundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShareBundle.d.ts","sourceRoot":"","sources":["../../../../src/services/contact/runtime/ShareBundle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAGV,0BAA0B,EAI1B,0BAA0B,EAC3B,MAAM,iCAAiC,CAAC;AAsGzC;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IACtB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CA8EtC;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IACV;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAqBD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,0BAA0B,EACjC,eAAe,EAAE,MAAM,GACtB,0BAA0B,CAK5B"}

package/bin/services/contact/runtime/ShareBundle.js

@@ -0,0 +1,185 @@
+/**
+ * contact 通用 share 打包与接收。
+ *
+ * 关键点（中文）
+ * - share 不理解 skill，只处理文本、链接、文件和目录。
+ * - receive 不自动安装或执行内容，只把 share 标记为已接收并复制到 received 区。
+ */
+import crypto from "node:crypto";
+import fs from "fs-extra";
+import path from "node:path";
+import { createContactId } from "./Token.js";
+import { getInboxShareFilesRoot, markContactInboxShareReceived, readContactInboxSharePayload, } from "./InboxStore.js";
+import { getContactReceivedSharePath } from "./Paths.js";
+function hashContent(content) {
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+function assertSafeRelativePath(relativePath) {
+    const value = String(relativePath || "").trim();
+    if (!value)
+        throw new Error("relativePath is required");
+    if (path.isAbsolute(value))
+        throw new Error(`Absolute path is not allowed: ${value}`);
+    const normalized = path.normalize(value);
+    if (normalized.startsWith("..") || normalized.includes(`${path.sep}..${path.sep}`)) {
+        throw new Error(`Unsafe relative path: ${value}`);
+    }
+    return normalized;
+}
+function createItemRoot(itemPath) {
+    const base = path.basename(itemPath).replace(/[^a-zA-Z0-9._-]+/g, "_") || "item";
+    return `${createContactId("item")}_${base}`;
+}
+async function collectPathFiles(params) {
+    const stat = await fs.stat(params.sourcePath);
+    const files = [];
+    const manifest = [];
+    const pushFile = async (absPath, relativePath) => {
+        const safeRelative = assertSafeRelativePath(relativePath);
+        const content = await fs.readFile(absPath);
+        files.push({
+            relativePath: path.join(params.itemRoot, safeRelative),
+            content: content.toString("base64"),
+            encoding: "base64",
+        });
+        manifest.push({
+            path: safeRelative,
+            sha256: hashContent(content),
+        });
+    };
+    if (stat.isFile()) {
+        await pushFile(params.sourcePath, path.basename(params.sourcePath));
+        return { files, manifest, itemType: "file" };
+    }
+    if (!stat.isDirectory()) {
+        throw new Error(`Only files and directories can be shared: ${params.sourcePath}`);
+    }
+    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())
+                continue;
+            await pushFile(absPath, path.relative(params.sourcePath, absPath));
+        }
+    };
+    await walk(params.sourcePath);
+    return { files, manifest, itemType: "directory" };
+}
+function normalizeLinks(input) {
+    const values = Array.isArray(input) ? input : [];
+    return values
+        .map((item) => String(item || "").trim())
+        .filter(Boolean);
+}
+/**
+ * 创建通用 share。
+ */
+export async function createShareInput(params) {
+    const items = [];
+    const files = [];
+    const text = String(params.text || "").trim();
+    if (text) {
+        items.push({
+            id: createContactId("item"),
+            type: "text",
+            title: "Text",
+            text,
+        });
+    }
+    for (const link of normalizeLinks(params.links)) {
+        items.push({
+            id: createContactId("item"),
+            type: "link",
+            title: link,
+            url: link,
+        });
+    }
+    for (const rawPath of Array.isArray(params.paths) ? params.paths : []) {
+        const sourcePath = path.resolve(params.context.rootPath, String(rawPath || "").trim());
+        const itemRoot = createItemRoot(sourcePath);
+        const collected = await collectPathFiles({
+            sourcePath,
+            itemRoot,
+        });
+        files.push(...collected.files);
+        items.push({
+            id: createContactId("item"),
+            type: collected.itemType,
+            title: path.basename(sourcePath),
+            root: itemRoot,
+            files: collected.manifest,
+        });
+    }
+    if (items.length === 0) {
+        throw new Error("Share requires at least one text, link, file, or directory item");
+    }
+    const sizeBytes = files.reduce((sum, file) => {
+        if (file.encoding === "base64")
+            return sum + Buffer.byteLength(file.content, "base64");
+        return sum + Buffer.byteLength(file.content, "utf-8");
+    }, 0) +
+        Buffer.byteLength(text, "utf-8") +
+        normalizeLinks(params.links).reduce((sum, link) => sum + Buffer.byteLength(link, "utf-8"), 0);
+    const title = items
+        .slice(0, 3)
+        .map((item) => item.title)
+        .join(", ");
+    const meta = {
+        id: createContactId("share"),
+        fromContactId: params.fromContactId,
+        fromAgentName: params.fromAgentName,
+        title: title || "Share",
+        status: "pending",
+        receivedAt: Date.now(),
+        sizeBytes,
+        itemCount: items.length,
+    };
+    const payload = {
+        kind: "share",
+        items,
+    };
+    return {
+        meta,
+        payload,
+        files,
+    };
+}
+/**
+ * 接收通用 share。
+ */
+export async function receiveShare(params) {
+    const payload = await readContactInboxSharePayload(params.projectRoot, params.shareId);
+    if (!payload)
+        throw new Error(`Share payload not found: ${params.shareId}`);
+    if (payload.kind !== "share")
+        throw new Error(`Unsupported share payload: ${payload.kind}`);
+    const receivedPath = getContactReceivedSharePath(params.projectRoot, params.shareId);
+    await fs.ensureDir(receivedPath);
+    await fs.writeJson(path.join(receivedPath, "payload.json"), payload, { spaces: 2 });
+    const filesRoot = getInboxShareFilesRoot(params.projectRoot, params.shareId);
+    if (await fs.pathExists(filesRoot)) {
+        await fs.copy(filesRoot, path.join(receivedPath, "files"), {
+            overwrite: true,
+        });
+    }
+    await markContactInboxShareReceived(params.projectRoot, params.shareId);
+    return {
+        itemCount: payload.items.length,
+        receivedPath,
+    };
+}
+/**
+ * 构造远端 receive share 请求。
+ */
+export function createReceiveShareRequest(input, senderContactId) {
+    return {
+        ...input,
+        senderContactId,
+    };
+}
+//# sourceMappingURL=ShareBundle.js.map

package/bin/services/contact/runtime/ShareBundle.js.map

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

package/bin/services/contact/runtime/SystemProvider.d.ts

@@ -0,0 +1,12 @@
+/**
+ * contact service system prompt 提供器。
+ *
+ * 关键点（中文）
+ * - session system composer 通过静态 provider 清单读取 service system。
+ * - contact prompt 在这里统一读取，避免 service 实例和 system 域产生耦合。
+ */
+/**
+ * 构建 contact service system 文本。
+ */
+export declare function buildContactServiceSystemText(): string;
+//# sourceMappingURL=SystemProvider.d.ts.map

package/bin/services/contact/runtime/SystemProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemProvider.d.ts","sourceRoot":"","sources":["../../../../src/services/contact/runtime/SystemProvider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CAMtD"}

package/bin/services/contact/runtime/SystemProvider.js

@@ -0,0 +1,21 @@
+/**
+ * contact service system prompt 提供器。
+ *
+ * 关键点（中文）
+ * - session system composer 通过静态 provider 清单读取 service system。
+ * - contact prompt 在这里统一读取，避免 service 实例和 system 域产生耦合。
+ */
+import { readFileSync } from "node:fs";
+const CONTACT_PROMPT_FILE_URL = new URL("../PROMPT.txt", import.meta.url);
+/**
+ * 构建 contact service system 文本。
+ */
+export function buildContactServiceSystemText() {
+    try {
+        return readFileSync(CONTACT_PROMPT_FILE_URL, "utf-8").trim();
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=SystemProvider.js.map

package/bin/services/contact/runtime/SystemProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemProvider.js","sourceRoot":"","sources":["../../../../src/services/contact/runtime/SystemProvider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,UAAU,6BAA6B;IAC3C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/bin/services/contact/runtime/Token.d.ts

@@ -0,0 +1,24 @@
+/**
+ * contact token 工具。
+ *
+ * 关键点（中文）
+ * - contact 之间的远端调用使用随机 token。
+ * - 本地只保存入站 token hash，避免明文泄漏后可被直接冒用。
+ */
+/**
+ * 生成随机 token。
+ */
+export declare function createContactToken(): string;
+/**
+ * 计算 token hash。
+ */
+export declare function hashContactToken(token: string): string;
+/**
+ * 生成短 id。
+ */
+export declare function createContactId(prefix: string): string;
+/**
+ * 稳定 slug。
+ */
+export declare function toContactSlug(input: string): string;
+//# sourceMappingURL=Token.d.ts.map

package/bin/services/contact/runtime/Token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Token.d.ts","sourceRoot":"","sources":["../../../../src/services/contact/runtime/Token.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD"}

package/bin/services/contact/runtime/Token.js

@@ -0,0 +1,36 @@
+/**
+ * contact token 工具。
+ *
+ * 关键点（中文）
+ * - contact 之间的远端调用使用随机 token。
+ * - 本地只保存入站 token hash，避免明文泄漏后可被直接冒用。
+ */
+import crypto from "node:crypto";
+/**
+ * 生成随机 token。
+ */
+export function createContactToken() {
+    return crypto.randomBytes(32).toString("base64url");
+}
+/**
+ * 计算 token hash。
+ */
+export function hashContactToken(token) {
+    return crypto.createHash("sha256").update(String(token || ""), "utf-8").digest("hex");
+}
+/**
+ * 生成短 id。
+ */
+export function createContactId(prefix) {
+    const cleanPrefix = String(prefix || "id").trim().replace(/[^a-zA-Z0-9_-]/g, "_");
+    return `${cleanPrefix}_${crypto.randomBytes(5).toString("hex")}`;
+}
+/**
+ * 稳定 slug。
+ */
+export function toContactSlug(input) {
+    const raw = String(input || "").trim().toLowerCase();
+    const slug = raw.replace(/[^a-z0-9._-]+/g, "_").replace(/^_+|_+$/g, "");
+    return slug || createContactId("contact");
+}
+//# sourceMappingURL=Token.js.map

package/bin/services/contact/runtime/Token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Token.js","sourceRoot":"","sources":["../../../../src/services/contact/runtime/Token.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IAClF,OAAO,GAAG,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACxE,OAAO,IAAI,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../../../src/services/memory/Action.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAG5B;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CA0BzC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAoBzC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAazC;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAUzC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAUzC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAU9B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB,CAgBnF"}