@lmcl/ailo-mcp-sdk 0.0.1

package/README.md

@@ -0,0 +1,187 @@
+# @lmcl/ailo-mcp-sdk
+
+AILO 通道与工具开发 SDK。
+
+```bash
+npm install @lmcl/ailo-mcp-sdk
+```
+
+**MCP → AILO 方向**：MCP 的 name 就是通道名，将来收到消息时用的就是这个名字。
+
+---
+
+## 场景1：纯工具（AILO → MCP 客户端）
+
+AILO 调用你的工具，你返回结果。
+
+```typescript
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { runMcp } from "@lmcl/ailo-mcp-sdk";
+
+const server = new McpServer({ name: "my-tools", version: "1.0.0" });
+
+server.registerTool("get_weather", { description: "查询天气", inputSchema: { city: z.string() } }, async ({ city }) => {
+  return { content: [{ type: "text", text: `北京: 晴 25°C` }] };
+});
+
+runMcp(server);
+```
+
+---
+
+## 场景2：纯接收（MCP 客户端 → AILO）
+
+平台有事件时，你推送给 AILO。无工具。
+
+### 1. 实现 BridgeHandler
+
+```typescript
+import type { BridgeHandler, BridgeMessage } from "@lmcl/ailo-mcp-sdk";
+
+class MyHandler implements BridgeHandler {
+  private onMessage?: (msg: BridgeMessage) => void;
+
+  setOnMessage(fn: (msg: BridgeMessage) => void) {
+    this.onMessage = fn;
+  }
+
+  async start() {
+    // 启动平台连接（WebSocket / long polling 等）
+    // 收到平台消息时调用：this.onMessage?.({ chatId, chatType: "群聊"|"私聊", text, senderId, senderName, chatName?, isPrivate?, ... })
+  }
+
+  stop?() {
+    // 断开平台连接
+  }
+}
+```
+
+### 2. 启动（mcpServer 可空或只注册 status）
+
+```typescript
+import { runMcpChannel } from "@lmcl/ailo-mcp-sdk";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+const handler = new MyHandler();
+const server = new McpServer({ name: "my-channel", version: "1.0.0" });
+// 纯接收无需注册工具，或注册 status 供 AILO 查看健康
+
+runMcpChannel({
+  handler,
+  mcpServer: server,
+  buildChannelPrompt: () => "本通道规则说明",
+});
+```
+
+---
+
+## 场景3：双向收发（AILO ↔ MCP 客户端）
+
+AILO → MCP + MCP → AILO 组合。既推送事件给 AILO，也注册工具供 AILO 调用。
+
+### 1. 实现 BridgeHandler（同纯接收）
+
+### 2. 创建 MCP Server 并注册工具
+
+```typescript
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+
+const server = new McpServer({ name: "my-channel", version: "1.0.0" });
+
+server.registerTool("send_message", {
+  description: "发送消息到平台",
+  inputSchema: { chat_id: z.string(), text: z.string() },
+}, async ({ chat_id, text }) => {
+  // 调用 handler 或平台 API 发消息
+  return { content: [{ type: "text", text: "已发送" }] };
+});
+```
+
+### 3. 启动
+
+```typescript
+import { runMcpChannel } from "@lmcl/ailo-mcp-sdk";
+
+const handler = new MyHandler();
+
+runMcpChannel({
+  handler,
+  mcpServer: server,
+  buildChannelPrompt: () => "本通道的规则说明，如 @提及格式、ID 格式等",
+});
+```
+
+### 4. 需要存点数据时（可选）
+
+数据存在 AILO 本体，所以只有 MCP → AILO 方向（有 WebSocket 连接）才有。SDK 连接后注入一个带 get/set/delete 的对象，直接用即可，自动持久化。更复杂的需求自行实现（不通过我们）。
+
+```typescript
+class MyHandler implements BridgeHandler {
+  private kv: { getData: (k: string) => Promise<string | null>; setData: (k: string, v: string) => Promise<void>; deleteData: (k: string) => Promise<void> } | null = null;
+
+  setDataProvider?(s) {
+    this.kv = s;
+  }
+
+  // 直接用：await this.kv?.getData("key")
+  //        await this.kv?.setData("key", "value")
+  //        await this.kv?.deleteData("key")
+}
+```
+
+---
+
+## 配置项（runMcpChannel）
+
+### AILO → MCP 方向（AILO 调用你的工具）
+
+
+| 字段          | 必填  | 说明              |
+| ----------- | --- | --------------- |
+| `mcpServer` | 是   | 需注册工具，AILO 才能调用 |
+
+
+### MCP → AILO 方向（你推送事件给 AILO）
+
+
+| 字段                   | 必填  | 说明                           |
+| -------------------- | --- | ---------------------------- |
+| `handler`            | 是   | BridgeHandler 实例             |
+| `buildChannelPrompt` | 否   | 通道规则提示词                      |
+| `ailoWsUrl`          | 否   | stdio 时从 env 读取；**HTTP 时必须传**（通道与网关不同网络） |
+
+---
+
+## 环境变量（MCP → AILO 方向）
+
+| 变量              | stdio 注入方式           | HTTP 注入方式           |
+| --------------- | ---------------------- | ---------------------- |
+| `AIDO_WS_URL`   | env 注入，主程序自动       | 主程序以 header `ailo-mcp-ws-url` 传给远程 MCP。**通道与网关不同网络时，你必须在 MCP 配置的 env 中填 `ailo-mcp-ws-url` 或 `AIDO_WS_URL`**，主程序会读取后放入 header |
+| `AIDO_TOKEN`    | env 注入，主程序自动       | 主程序以 header `ailo-mcp-token` 传给远程 MCP，不可配置 |
+| `AIDO_MCP_NAME` | env 注入，主程序自动       | 主程序以 header `ailo-mcp-name` 传给远程 MCP，严格按 MCP 的 name，不可配置 |
+
+
+*无需了解*：通道回连时，服务端会校验 MCP 身份与凭证，双向链路均有认证保护，你只需写业务逻辑即可。
+
+---
+
+## 时空场格式
+
+WebSocket（MCP → AILO）场景下，推送事件时用。
+
+- **格式**：KV 数组。每项 `{ key, desc, value }`，`key` 框架用，`desc` 给 LLM 看，`value` 标签值。
+- **顺序**：敏感，顺序决定语义。
+- **coreForSenseContext**：与数组一一对应，`true` 表示该项参与时空场键。最左匹配，遇 `false` 即停。私聊全 `true`；群聊 `chat_type`/`chat_id`/`chat_name` 为 `true`，`sender_name` 起为 `false`。
+
+---
+
+## 类型速查
+
+
+| 类型              | 说明 |
+| --------------- | ---- |
+| `BridgeHandler`、`BridgeMessage` | WebSocket（MCP → AILO）场景才用，推送给 AILO 的接口与时空场格式 |
+
+

package/dist/ailo-client.d.ts

@@ -0,0 +1,31 @@
+import type { ChannelAcceptParams } from "./types.js";
+/**
+ * 反向 WebSocket 信号客户端。
+ *
+ * 连接 Ailo 网关，connect 时一并传入 channel 与 prompt，一步完成注册。
+ * 负责 channel.accept（入站信号投递）。
+ *
+ * 出站（AI → 平台）由 MCP stdio 工具处理，不经过此客户端。
+ */
+export declare class AiloClient {
+    private ws;
+    private url;
+    private token;
+    private channel;
+    private channelPrompt;
+    private reconnectTimer;
+    private reqId;
+    constructor(url: string, token: string, channel: string, channelPrompt?: string);
+    private request;
+    connect(): Promise<void>;
+    private scheduleReconnect;
+    sendMessage(params: ChannelAcceptParams): Promise<{
+        text?: string;
+    }>;
+    /** 简单 KV，数据存 AILO 本体，自动持久化 */
+    getData(key: string): Promise<string | null>;
+    setData(key: string, value: string): Promise<void>;
+    deleteData(key: string): Promise<void>;
+    close(): void;
+}
+//# sourceMappingURL=ailo-client.d.ts.map

package/dist/ailo-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ailo-client.d.ts","sourceRoot":"","sources":["../src/ailo-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AActD;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,KAAK,CAAK;gBAEN,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,SAAK;IAO3E,OAAO,CAAC,OAAO;IAuBf,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwDxB,OAAO,CAAC,iBAAiB;IAUzB,WAAW,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAapE,8BAA8B;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQ5C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,KAAK,IAAI,IAAI;CAUd"}

package/dist/ailo-client.js

@@ -0,0 +1,140 @@
+import WebSocket from "ws";
+/**
+ * 反向 WebSocket 信号客户端。
+ *
+ * 连接 Ailo 网关，connect 时一并传入 channel 与 prompt，一步完成注册。
+ * 负责 channel.accept（入站信号投递）。
+ *
+ * 出站（AI → 平台）由 MCP stdio 工具处理，不经过此客户端。
+ */
+export class AiloClient {
+    ws = null;
+    url;
+    token;
+    channel;
+    channelPrompt;
+    reconnectTimer = null;
+    reqId = 0;
+    constructor(url, token, channel, channelPrompt = "") {
+        this.url = url;
+        this.token = token;
+        this.channel = channel;
+        this.channelPrompt = channelPrompt;
+    }
+    request(method, params) {
+        return new Promise((resolve, reject) => {
+            if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+                reject(new Error("Ailo WebSocket not connected"));
+                return;
+            }
+            const id = `${method}-${++this.reqId}`;
+            const handler = (raw) => {
+                const frame = JSON.parse(raw.toString());
+                if (frame.type === "res" && frame.id === id) {
+                    this.ws?.off("message", handler);
+                    if (frame.ok) {
+                        resolve(frame.payload ?? {});
+                    }
+                    else {
+                        reject(new Error(frame.error?.message ?? `${method} failed`));
+                    }
+                }
+            };
+            this.ws.on("message", handler);
+            this.ws.send(JSON.stringify({ type: "req", id, method, params }));
+        });
+    }
+    connect() {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(this.url);
+            this.ws = ws;
+            ws.on("open", async () => {
+                try {
+                    const id = `connect-${++this.reqId}`;
+                    ws.send(JSON.stringify({
+                        type: "req",
+                        id,
+                        method: "connect",
+                        params: {
+                            role: "channel",
+                            token: this.token,
+                            channel: this.channel,
+                            prompt: this.channelPrompt,
+                            capabilities: ["text", "media"],
+                            direction: "bidirectional",
+                        },
+                    }));
+                    await new Promise((res, rej) => {
+                        const onMsg = (raw) => {
+                            const frame = JSON.parse(raw.toString());
+                            if (frame.type === "res" && frame.id === id) {
+                                ws.off("message", onMsg);
+                                if (frame.ok) {
+                                    res();
+                                }
+                                else {
+                                    rej(new Error(frame.error?.message ?? "connect failed"));
+                                }
+                            }
+                        };
+                        ws.on("message", onMsg);
+                    });
+                    resolve();
+                }
+                catch (err) {
+                    reject(err);
+                }
+            });
+            ws.on("close", () => {
+                this.ws = null;
+                this.scheduleReconnect(resolve);
+            });
+            ws.on("error", (err) => {
+                reject(err);
+            });
+        });
+    }
+    scheduleReconnect(onReconnect) {
+        if (this.reconnectTimer)
+            return;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect()
+                .then(() => onReconnect?.())
+                .catch(() => this.scheduleReconnect(onReconnect));
+        }, 3000);
+    }
+    sendMessage(params) {
+        const payload = {
+            chatId: params.chatId,
+            text: params.text,
+            contextTags: params.contextTags,
+            attachments: params.attachments ?? [],
+        };
+        if (params.coreForSenseContext != null && params.coreForSenseContext.length > 0) {
+            payload.coreForSenseContext = params.coreForSenseContext;
+        }
+        return this.request("channel.accept", payload);
+    }
+    /** 简单 KV，数据存 AILO 本体，自动持久化 */
+    async getData(key) {
+        const res = await this.request("channel.data.get", { key });
+        return res.found ? (res.value ?? null) : null;
+    }
+    async setData(key, value) {
+        await this.request("channel.data.set", { key, value });
+    }
+    async deleteData(key) {
+        await this.request("channel.data.delete", { key });
+    }
+    close() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+}

package/dist/bootstrap.d.ts

@@ -0,0 +1,35 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { BridgeHandler } from "./types.js";
+/**
+ * MCP 通道启动配置
+ *
+ * AIDO_WS_URL、AIDO_TOKEN、AIDO_MCP_NAME 由主程序在拉起 MCP 时注入，SDK 自动读取。
+ * 通道开发者只需提供 handler、mcpServer、buildChannelPrompt 等业务配置。
+ */
+export interface McpChannelConfig {
+    /** MCP 名称（如 channel:feishu），connect 时与 token 一起发送供服务端校验。不传则从 AIDO_MCP_NAME / AILO_MCP_NAME 读取 */
+    channelName?: string;
+    /** 平台 Handler 实例（需实现 BridgeHandler 接口） */
+    handler: BridgeHandler;
+    /** Ailo WebSocket 网关地址。不传则从 AIDO_WS_URL / AILO_WS_URL 读取 */
+    ailoWsUrl?: string;
+    /** Ailo 网关认证 Token。不传则从 AIDO_TOKEN / AILO_TOKEN 读取 */
+    ailoToken?: string;
+    /**
+     * 构建通道静态提示词（connect 时注册）。
+     * 连接时调用一次，注册该通道的特殊规则。
+     */
+    buildChannelPrompt?: () => string;
+    /** 预配置的 MCP Server 实例（已注册好工具） */
+    mcpServer: McpServer;
+}
+export declare function defaultBuildChannelPrompt(): string;
+/**
+ * 启动 MCP Server（纯工具 / 单向发通道用）
+ *
+ * 本 SDK 作为脚手架：只需创建 MCP Server、注册工具，调用此函数即可启动。
+ * stdout 被 MCP stdio 占用，日志自动重定向到 stderr。
+ */
+export declare function runMcp(mcpServer: McpServer): void;
+export declare function runMcpChannel(config: McpChannelConfig): void;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iGAAiG;IACjG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,OAAO,EAAE,aAAa,CAAC;IACvB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,MAAM,CAAC;IAClC,iCAAiC;IACjC,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CASjD;AAiBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAwI5D"}

package/dist/bootstrap.js

@@ -0,0 +1,148 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { AiloClient } from "./ailo-client.js";
+export function defaultBuildChannelPrompt() {
+    return `用户 @你 时会在消息中标注。`;
+}
+/**
+ * 启动 MCP Server（纯工具 / 单向发通道用）
+ *
+ * 本 SDK 作为脚手架：只需创建 MCP Server、注册工具，调用此函数即可启动。
+ * stdout 被 MCP stdio 占用，日志自动重定向到 stderr。
+ */
+export function runMcp(mcpServer) {
+    console.log = (...args) => console.error(...args);
+    const transport = new StdioServerTransport();
+    mcpServer.connect(transport).then(() => {
+        console.log("[mcp] MCP stdio server started");
+    }).catch((err) => {
+        console.error("[mcp] MCP start failed:", err);
+        process.exit(1);
+    });
+}
+/**
+ * 启动 MCP 通道
+ *
+ * 通用流程：
+ *   1. 重定向 console.log 到 stderr（stdout 被 MCP stdio 占用）
+ *   2. 启动 MCP stdio server（暴露出站工具）
+ *   3. 建立反向 WebSocket 连接（connect 时传入 channel + prompt，一步完成注册）
+ *   4. 接线入站：handler.setOnMessage → 组装 contextTags → channel.accept
+ *   5. 启动平台 Handler
+ *   6. 注册 SIGINT / SIGTERM 优雅退出
+ */
+function envOr(name, fallback) {
+    return process.env[name] ?? process.env[fallback] ?? "";
+}
+export function runMcpChannel(config) {
+    const { handler, mcpServer } = config;
+    const channelName = config.channelName ?? envOr("AIDO_MCP_NAME", "AILO_MCP_NAME");
+    const ailoWsUrl = config.ailoWsUrl ?? envOr("AIDO_WS_URL", "AILO_WS_URL");
+    const ailoToken = config.ailoToken ?? envOr("AIDO_TOKEN", "AILO_TOKEN");
+    if (!ailoWsUrl || !ailoToken || !channelName) {
+        console.error("Missing AIDO_WS_URL/AILO_WS_URL, AIDO_TOKEN/AILO_TOKEN or AIDO_MCP_NAME/AILO_MCP_NAME. Channel must be started by Ailo MCP.");
+        process.exit(1);
+    }
+    // stdout 被 MCP stdio 占用，日志全部走 stderr
+    const _origLog = console.log;
+    console.log = (...args) => console.error(...args);
+    const tag = `[${channelName}]`;
+    const channelPrompt = config.buildChannelPrompt
+        ? config.buildChannelPrompt()
+        : defaultBuildChannelPrompt();
+    const client = new AiloClient(ailoWsUrl, ailoToken, channelName, channelPrompt);
+    // 入站：平台 → Ailo（channel.accept）
+    handler.setOnMessage(async (msg) => {
+        const hasContent = (msg.text ?? "").trim() !== "" || (msg.attachments?.length ?? 0) > 0;
+        if (!hasContent) {
+            console.log(`${tag} skipped ${msg.chatType} ${msg.chatId} (no text or attachments)`);
+            return;
+        }
+        console.log(`${tag} ${msg.chatType} ${msg.chatId} from ${msg.senderName ? msg.senderName + "(" + (msg.senderId ?? "") + ")" : msg.senderId ?? "unknown"}: ${(msg.text ?? "").slice(0, 80)}`);
+        try {
+            const isPrivate = msg.isPrivate ?? false;
+            const groupLabel = !isPrivate &&
+                (msg.chatName || (msg.chatId ? `群${msg.chatId.slice(-8)}` : ""));
+            const contextTags = [
+                { key: "chat_type", desc: "类型", value: msg.chatType },
+                { key: "chat_id", desc: "会话", value: msg.chatId },
+            ];
+            if (groupLabel) {
+                contextTags.push({ key: "chat_name", desc: "群名", value: groupLabel });
+            }
+            contextTags.push({ key: "sender_name", desc: "昵称", value: msg.senderName ?? "" }, { key: "sender_id", desc: "用户ID", value: msg.senderId ?? "" });
+            if (msg.mentionsSelf) {
+                contextTags.push({ key: "mentions_self", desc: "提及自己", value: "true" });
+            }
+            if (msg.timestamp != null) {
+                let tsMs;
+                if (typeof msg.timestamp === "number") {
+                    tsMs = msg.timestamp;
+                }
+                else {
+                    tsMs = parseInt(msg.timestamp, 10);
+                }
+                if (!isNaN(tsMs) && tsMs > 0) {
+                    const d = new Date(tsMs);
+                    const pad = (n) => String(n).padStart(2, "0");
+                    const formatted = `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
+                    contextTags.push({ key: "sent_at", desc: "发送时间", value: formatted });
+                }
+            }
+            const coreForSenseContext = [];
+            coreForSenseContext.push(true, true);
+            if (groupLabel) {
+                coreForSenseContext.push(true);
+            }
+            for (let i = coreForSenseContext.length; i < contextTags.length; i++) {
+                coreForSenseContext.push(isPrivate);
+            }
+            await client.sendMessage({
+                chatId: msg.chatId,
+                text: msg.text ?? "",
+                contextTags,
+                coreForSenseContext,
+                attachments: msg.attachments ?? [],
+            });
+        }
+        catch (err) {
+            console.error(`${tag} send to Ailo failed:`, err);
+        }
+    });
+    // 优雅退出
+    const shutdown = () => {
+        console.log(`${tag} shutting down...`);
+        handler.stop?.();
+        client.close();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    (async () => {
+        // 1. 启动 MCP stdio server
+        const transport = new StdioServerTransport();
+        await mcpServer.connect(transport);
+        console.log(`${tag} MCP stdio server started`);
+        // 2. 建立反向 WebSocket 连接
+        try {
+            await client.connect();
+            console.log(`${tag} reverse WebSocket connected`);
+        }
+        catch (err) {
+            console.error(`${tag} reverse WebSocket connect failed:`, err);
+            process.exit(1);
+        }
+        // 3. 启动平台 Handler
+        console.log(`${tag} starting handler...`);
+        const startResult = handler.start();
+        if (startResult && typeof startResult.then === "function") {
+            try {
+                await startResult;
+                console.log(`${tag} handler started successfully`);
+            }
+            catch (err) {
+                console.error(`${tag} handler start failed:`, err);
+                process.exit(1);
+            }
+        }
+    })();
+}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { AiloClient } from "./ailo-client.js";
+export { runMcp, runMcpChannel, defaultBuildChannelPrompt } from "./bootstrap.js";
+export type { McpChannelConfig } from "./bootstrap.js";
+export type { Attachment, BridgeHandler, BridgeMessage, ChannelAcceptParams, ContextTag, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAClF,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { AiloClient } from "./ailo-client.js";
+export { runMcp, runMcpChannel, defaultBuildChannelPrompt } from "./bootstrap.js";

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 附件类型（图片/音频/视频/文件等）
+ * 入站图片：path/url/base64 三选一，直接使用 LLM 多模态。其他类型：path/url/ref+channel/base64。
+ * 出站：file_path 或 base64 或 url。
+ */
+export type Attachment = {
+    type: string;
+    url?: string;
+    path?: string;
+    ref?: string;
+    channel?: string;
+    base64?: string;
+    mime?: string;
+    name?: string;
+    file_path?: string;
+};
+/**
+ * 桥接器入站消息（平台 → Ailo）
+ *
+ * 所有平台 Handler 的 onMessage 回调统一使用此类型。
+ */
+export type BridgeMessage = {
+    chatId: string;
+    chatType: string;
+    text?: string;
+    senderId?: string;
+    senderName?: string;
+    chatName?: string;
+    isPrivate?: boolean;
+    mentionsSelf?: boolean;
+    attachments?: Attachment[];
+    timestamp?: number | string;
+    messageId?: string;
+};
+/** setDataProvider 接收的对象，SDK 注入，直接用 get/set/delete 即可 */
+type ChannelStorage = {
+    getData(key: string): Promise<string | null>;
+    setData(key: string, value: string): Promise<void>;
+    deleteData(key: string): Promise<void>;
+};
+/**
+ * 通道 Handler 统一接口
+ */
+export interface BridgeHandler {
+    setOnMessage(handler: (msg: BridgeMessage) => void | Promise<void>): void;
+    start(): void | Promise<void>;
+    stop?(): void;
+    /** 可选，SDK 连接后注入带 get/set/delete 的对象，直接用 */
+    setDataProvider?(storage: ChannelStorage): void;
+}
+/**
+ * channel.accept 的 contextTags 项
+ *
+ * key:  框架内部路由用（英文标识）
+ * desc: 给 LLM 看的人类可读标签（中文）
+ * value: 标签值
+ */
+export type ContextTag = {
+    key: string;
+    desc: string;
+    value: string;
+};
+/**
+ * channel.accept 的消息参数
+ *
+ * coreForSenseContext: 与 contextTags 一一对应，true 表示该标签参与时空场键生成。
+ * 最左匹配：遇 false 即停。私聊全 true；群聊 chat_type/chat_id/chat_name 为 true，sender_name 起为 false。
+ * 未传时框架回退 Channel+ChatID。
+ */
+export type ChannelAcceptParams = {
+    chatId: string;
+    text: string;
+    contextTags: ContextTag[];
+    coreForSenseContext?: boolean[];
+    attachments?: Attachment[];
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,yDAAyD;AACzD,KAAK,cAAc,GAAG;IACpB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1E,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,IAAI,CAAC;IACd,2CAA2C;IAC3C,eAAe,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;CACjD;AAED;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B,CAAC"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@lmcl/ailo-mcp-sdk",
+  "version": "0.0.1",
+  "description": "Ailo MCP SDK - 通道通过 MCP 注册发送消息能力，用于开发感知通道",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lmcl/ailo-mcp-sdk.git"
+  },
+  "keywords": [
+    "ailo",
+    "mcp",
+    "sdk",
+    "channel",
+    "bridge"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@types/ws": "^8.5.13",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}