skyloom 1.22.0 → 1.24.0

package/dist/gateway/qr.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Terminal QR rendering — a thin, dependency-isolated wrapper over
+ * qrcode-terminal (single file, zero transitive deps). Returns the QR as a
+ * string so callers control where it's written (and so it's testable).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderQR = renderQR;
+// qrcode-terminal ships no types; declare the tiny surface we use.
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const qrcode = require('qrcode-terminal');
+/** Render `text` as a scannable QR code (compact) into a string. */
+function renderQR(text) {
+    let out = '';
+    try {
+        qrcode.generate(text, { small: true }, (s) => { out = s; });
+    }
+    catch {
+        return '';
+    }
+    return out;
+}
+//# sourceMappingURL=qr.js.map

package/dist/gateway/qr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr.js","sourceRoot":"","sources":["../../src/gateway/qr.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAQH,4BAQC;AAdD,mEAAmE;AACnE,iEAAiE;AACjE,MAAM,MAAM,GACV,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE7B,oEAAoE;AACpE,SAAgB,QAAQ,CAAC,IAAY;IACnC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC;QACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAS,EAAE,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/gateway/setup.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Channel setup metadata + persistence — the data behind the `sky channels`
+ * wizard. Each channel declares the credential fields it needs, where to create
+ * the bot (a platform console URL we render as a QR for quick mobile access),
+ * and a short how-to. Kept pure/testable; the interactive prompts live in the
+ * CLI, and QR rendering is a thin wrapper over qrcode-terminal.
+ *
+ * Note: Feishu / WeCom / QQ are all official-bot APIs — credentials are created
+ * in each platform's developer console, there is no "scan to log in" the way
+ * personal WeChat works. So the QR here is a convenience link to the console
+ * (scan on your phone → open the console → create the bot → copy the keys), plus
+ * a QR of the gateway callback URL to paste back into the console.
+ */
+export interface ChannelField {
+    /** Config key under channels.<id>. */
+    key: string;
+    /** Human label shown in the wizard. */
+    label: string;
+    /** Whether the wizard must collect it (some are optional). */
+    required: boolean;
+    /** Treat as a secret (mask input / store as env-ref suggestion). */
+    secret?: boolean;
+    /** Env var that also supplies this value. */
+    env?: string;
+    /** One-line hint on where to find it. */
+    hint?: string;
+}
+export interface ChannelSetupSpec {
+    id: string;
+    name: string;
+    /** Platform console where the bot/app is created (rendered as a QR). */
+    consoleUrl: string;
+    /** Docs link for the full setup walkthrough. */
+    docsUrl?: string;
+    /** Webhook path the platform must call back. */
+    webhookPath: string;
+    /** Ordered credential fields to collect. */
+    fields: ChannelField[];
+    /** Short, numbered how-to shown before collecting fields. */
+    steps: string[];
+}
+export declare const CHANNEL_SETUP: Record<string, ChannelSetupSpec>;
+export declare const SETUP_CHANNEL_IDS: string[];
+/** Build the full webhook callback URL for a channel from a public base. */
+export declare function callbackUrl(base: string, channelId: string): string;
+/**
+ * Persist a channel's collected values into ~/.skyloom/config.yaml under
+ * channels.<id>, merging with any existing block. Secret-looking values are
+ * stored as-is (the file is chmod 0600); callers may instead keep secrets in
+ * env and store an { source: env, id } ref. Returns the config path written.
+ */
+export declare function saveChannelConfig(channelId: string, values: Record<string, string>, opts?: {
+    configPath?: string;
+}): string;
+/** Which required fields are still missing from a values map. */
+export declare function missingRequired(channelId: string, values: Record<string, string>): string[];
+//# sourceMappingURL=setup.d.ts.map

package/dist/gateway/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/gateway/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAyD1D,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAA6B,CAAC;AAE5D,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,MAAM,CAcR;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAI3F"}

package/dist/gateway/setup.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Channel setup metadata + persistence — the data behind the `sky channels`
+ * wizard. Each channel declares the credential fields it needs, where to create
+ * the bot (a platform console URL we render as a QR for quick mobile access),
+ * and a short how-to. Kept pure/testable; the interactive prompts live in the
+ * CLI, and QR rendering is a thin wrapper over qrcode-terminal.
+ *
+ * Note: Feishu / WeCom / QQ are all official-bot APIs — credentials are created
+ * in each platform's developer console, there is no "scan to log in" the way
+ * personal WeChat works. So the QR here is a convenience link to the console
+ * (scan on your phone → open the console → create the bot → copy the keys), plus
+ * a QR of the gateway callback URL to paste back into the console.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SETUP_CHANNEL_IDS = exports.CHANNEL_SETUP = void 0;
+exports.callbackUrl = callbackUrl;
+exports.saveChannelConfig = saveChannelConfig;
+exports.missingRequired = missingRequired;
+exports.CHANNEL_SETUP = {
+    feishu: {
+        id: 'feishu',
+        name: '飞书 / Lark',
+        consoleUrl: 'https://open.feishu.cn/app',
+        docsUrl: 'https://open.feishu.cn/document/home/index',
+        webhookPath: '/webhook/feishu',
+        fields: [
+            { key: 'appId', label: 'App ID', required: true, env: 'FEISHU_APP_ID', hint: '开发者后台 → 凭证与基础信息 → App ID' },
+            { key: 'appSecret', label: 'App Secret', required: true, secret: true, env: 'FEISHU_APP_SECRET', hint: '同页 App Secret' },
+            { key: 'verificationToken', label: 'Verification Token', required: false, secret: true, env: 'FEISHU_VERIFICATION_TOKEN', hint: '事件订阅 → Verification Token(可选)' },
+            { key: 'encryptKey', label: 'Encrypt Key', required: false, secret: true, env: 'FEISHU_ENCRYPT_KEY', hint: '事件订阅 → Encrypt Key(开启加密时填)' },
+        ],
+        steps: [
+            '扫码或打开 https://open.feishu.cn/app 创建「企业自建应用」',
+            '在「凭证与基础信息」复制 App ID / App Secret',
+            '开启「机器人」能力,在「权限管理」添加 im:message 等权限',
+            '「事件订阅」填入下方回调 URL,订阅 im.message.receive_v1',
+        ],
+    },
+    wecom: {
+        id: 'wecom',
+        name: '企业微信 WeCom',
+        consoleUrl: 'https://work.weixin.qq.com/wework_admin/frame',
+        docsUrl: 'https://developer.work.weixin.qq.com/document/path/90664',
+        webhookPath: '/webhook/wecom',
+        fields: [
+            { key: 'corpId', label: 'CorpID（企业ID）', required: true, env: 'WECOM_CORP_ID', hint: '管理后台 → 我的企业 → 企业ID' },
+            { key: 'corpSecret', label: 'Secret（应用Secret）', required: true, secret: true, env: 'WECOM_CORP_SECRET', hint: '应用管理 → 自建应用 → Secret' },
+            { key: 'agentId', label: 'AgentId', required: true, env: 'WECOM_AGENT_ID', hint: '同应用页 AgentId' },
+            { key: 'token', label: 'Token', required: true, secret: true, env: 'WECOM_TOKEN', hint: '应用 → 接收消息 → API 接收 → Token' },
+            { key: 'encodingAesKey', label: 'EncodingAESKey', required: true, secret: true, env: 'WECOM_AES_KEY', hint: '同页 EncodingAESKey(43 位)' },
+        ],
+        steps: [
+            '扫码或打开企业微信管理后台,进入「应用管理 → 自建 → 创建应用」',
+            '复制企业ID、应用 Secret、AgentId',
+            '「接收消息」选 API 接收,设置 Token 与 EncodingAESKey',
+            '把下方回调 URL 填入「URL」,保存时企业微信会回调验证',
+        ],
+    },
+    qq: {
+        id: 'qq',
+        name: 'QQ 机器人',
+        consoleUrl: 'https://q.qq.com/#/app/bot',
+        docsUrl: 'https://bot.q.qq.com/wiki/',
+        webhookPath: '/webhook/qq',
+        fields: [
+            { key: 'appId', label: 'AppID（机器人ID）', required: true, env: 'QQ_BOT_APPID', hint: 'QQ 开放平台 → 机器人 → 开发设置 → AppID' },
+            { key: 'secret', label: 'AppSecret', required: true, secret: true, env: 'QQ_BOT_SECRET', hint: '同页 AppSecret' },
+        ],
+        steps: [
+            '扫码或打开 https://q.qq.com 创建机器人,完成开发者认证',
+            '在「开发设置」复制 AppID 与 AppSecret',
+            '「回调配置」选择 Webhook,填入下方回调 URL',
+            '在沙箱里把机器人加为好友 / 拉进群进行测试',
+        ],
+    },
+};
+exports.SETUP_CHANNEL_IDS = Object.keys(exports.CHANNEL_SETUP);
+/** Build the full webhook callback URL for a channel from a public base. */
+function callbackUrl(base, channelId) {
+    const spec = exports.CHANNEL_SETUP[channelId];
+    if (!spec)
+        return '';
+    const trimmed = base.replace(/\/+$/, '');
+    return `${trimmed}${spec.webhookPath}`;
+}
+/**
+ * Persist a channel's collected values into ~/.skyloom/config.yaml under
+ * channels.<id>, merging with any existing block. Secret-looking values are
+ * stored as-is (the file is chmod 0600); callers may instead keep secrets in
+ * env and store an { source: env, id } ref. Returns the config path written.
+ */
+function saveChannelConfig(channelId, values, opts) {
+    const path = require('path');
+    const fs = require('fs');
+    const yaml = require('yaml');
+    const cfgPath = opts?.configPath || path.join(require('os').homedir(), '.skyloom', 'config.yaml');
+    const dir = path.dirname(cfgPath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    let cfg = {};
+    if (fs.existsSync(cfgPath)) {
+        try {
+            cfg = yaml.parse(fs.readFileSync(cfgPath, 'utf-8')) || {};
+        }
+        catch {
+            cfg = {};
+        }
+    }
+    if (!cfg.channels)
+        cfg.channels = {};
+    cfg.channels[channelId] = { ...(cfg.channels[channelId] || {}), ...values, enabled: true };
+    fs.writeFileSync(cfgPath, yaml.stringify(cfg), { encoding: 'utf-8', mode: 0o600 });
+    try {
+        fs.chmodSync(cfgPath, 0o600);
+    }
+    catch { /* best-effort on Windows */ }
+    return cfgPath;
+}
+/** Which required fields are still missing from a values map. */
+function missingRequired(channelId, values) {
+    const spec = exports.CHANNEL_SETUP[channelId];
+    if (!spec)
+        return [];
+    return spec.fields.filter((f) => f.required && !values[f.key]?.trim()).map((f) => f.key);
+}
+//# sourceMappingURL=setup.js.map

package/dist/gateway/setup.js.map

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

package/dist/gateway/types.d.ts

@@ -39,6 +39,29 @@ export interface MediaAttachment {
     /** Direct URL, when the platform provides one. */
     url?: string;
 }
+/** An outbound media item the agent wants to send (parsed from its reply). */
+export interface OutboundMedia {
+    kind: 'image' | 'file';
+    /** Local filesystem path or http(s) URL to the binary. */
+    src: string;
+    /** Optional caption / alt text. */
+    alt?: string;
+}
+/** The result of splitting an agent reply into plain text + outbound media. */
+export interface ParsedReply {
+    text: string;
+    media: OutboundMedia[];
+}
+/**
+ * Parse media directives out of an agent's reply so channels can upload+send
+ * them. Recognized forms (stripped from the returned text):
+ *   - Markdown image:  ![alt](src)
+ *   - Explicit image:  [[image:src]]  or  [[image:src|alt]]
+ *   - Explicit file:   [[file:src]]   or  [[file:src|alt]]
+ * `src` is a local path or http(s) URL. Only http(s) and existing local files
+ * are treated as media; anything else is left in the text untouched.
+ */
+export declare function parseReply(reply: string): ParsedReply;
 /** Render a media list into a compact, model-readable description line. */
 export declare function describeMedia(media: MediaAttachment[] | undefined): string;
 /** Opaque, channel-specific destination for an outbound reply. */
@@ -98,6 +121,22 @@ export interface ChannelAdapter {
      * should throttle their own updates and tolerate an empty/aborted stream.
      */
     sendStreaming?(target: ReplyTarget, chunks: AsyncIterable<string>): Promise<void>;
+    /**
+     * Optional: upload and send an image or file. When an adapter implements this,
+     * the gateway extracts media directives from the agent's reply (parseReply)
+     * and delivers them after the text. Adapters without it simply keep the
+     * media reference in the text.
+     */
+    sendMedia?(target: ReplyTarget, item: OutboundMedia): Promise<void>;
+    /**
+     * Optional: download an inbound media attachment's bytes so the gateway can
+     * run vision over an image. `att` is one entry from InboundMessage.media.
+     * Returns the binary or null if it can't be fetched.
+     */
+    fetchMedia?(att: MediaAttachment, msg: InboundMessage): Promise<{
+        data: Buffer;
+        contentType?: string;
+    } | null>;
 }
 /** Factory signature: build an adapter from its config block (or null if disabled/misconfigured). */
 export type ChannelFactory = (cfg: any, env: NodeJS.ProcessEnv) => ChannelAdapter | null;

package/dist/gateway/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/gateway/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAEhD,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,EAAE,WAAW,CAAC;IACrB,oEAAoE;IACpE,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;IAC1B,wEAAwE;IACxE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACjE,oFAAoF;IACpF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,SAAS,GAAG,MAAM,CAQ1E;AAED,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,mBAAmB,CAAC;IAC7B,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,sEAAsE;IACtE,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,6CAA6C;IAC7C,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAExD,6CAA6C;IAC7C,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD;;;;;OAKG;IACH,aAAa,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF;AAED,qGAAqG;AACrG,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,cAAc,GAAG,IAAI,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/gateway/types.ts"],"names":[],"mappings":"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"}

package/dist/gateway/types.js

@@ -11,7 +11,32 @@
  * stays platform-neutral.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseReply = parseReply;
 exports.describeMedia = describeMedia;
+/**
+ * Parse media directives out of an agent's reply so channels can upload+send
+ * them. Recognized forms (stripped from the returned text):
+ *   - Markdown image:  ![alt](src)
+ *   - Explicit image:  [[image:src]]  or  [[image:src|alt]]
+ *   - Explicit file:   [[file:src]]   or  [[file:src|alt]]
+ * `src` is a local path or http(s) URL. Only http(s) and existing local files
+ * are treated as media; anything else is left in the text untouched.
+ */
+function parseReply(reply) {
+    const media = [];
+    let text = reply;
+    // [[image:src|alt]] / [[file:src|alt]]
+    text = text.replace(/\[\[(image|file):([^\]|]+)(?:\|([^\]]*))?\]\]/gi, (_m, kind, src, alt) => {
+        media.push({ kind: kind.toLowerCase(), src: String(src).trim(), alt: alt ? String(alt).trim() : undefined });
+        return '';
+    });
+    // Markdown images: ![alt](src)
+    text = text.replace(/!\[([^\]]*)\]\(([^)\s]+)(?:\s+"[^"]*")?\)/g, (_m, alt, src) => {
+        media.push({ kind: 'image', src: String(src).trim(), alt: alt ? String(alt).trim() : undefined });
+        return '';
+    });
+    return { text: text.replace(/\n{3,}/g, '\n\n').trim(), media };
+}
 /** Render a media list into a compact, model-readable description line. */
 function describeMedia(media) {
     if (!media || media.length === 0)

package/dist/gateway/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/gateway/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAoCH,sCAQC;AATD,2EAA2E;AAC3E,SAAgB,aAAa,CAAC,KAAoC;IAChE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,OAAO,IAAI,GAAG,GAAG,CAAC;IACpB,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/gateway/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AA2DH,gCAiBC;AAGD,sCAQC;AArCD;;;;;;;;GAQG;AACH,SAAgB,UAAU,CAAC,KAAa;IACtC,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,IAAI,IAAI,GAAG,KAAK,CAAC;IAEjB,uCAAuC;IACvC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,iDAAiD,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAC5F,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAsB,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QACjI,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,+BAA+B;IAC/B,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,4CAA4C,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACjF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QAClG,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC;AACjE,CAAC;AAED,2EAA2E;AAC3E,SAAgB,aAAa,CAAC,KAAoC;IAChE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,OAAO,IAAI,GAAG,GAAG,CAAC;IACpB,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/gateway/vision.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Vision describe — turn an inbound image into a text description so the agent
+ * can "see" what the user sent, without rewiring the core text-only LLM loop.
+ *
+ * Self-contained on purpose: a single OpenAI-compatible chat/completions call
+ * with an image_url (base64 data URL) content block. The model + key are
+ * resolved from config.channels.<id>.visionModel / config.llm.vision_model
+ * (default gpt-4o-mini), falling back to env keys the same way the rest of
+ * Skyloom does. If no key/model is available, vision is skipped silently and the
+ * gateway just uses the media description line.
+ */
+import type { LoadedMedia } from './helpers';
+export interface VisionOptions {
+    model?: string;
+    env?: NodeJS.ProcessEnv;
+    prompt?: string;
+}
+/**
+ * Describe one or more images. Returns a description string, or null if vision
+ * is unavailable (no key/model) or fails — callers fall back to the media line.
+ */
+export declare function describeImages(images: LoadedMedia[], opts?: VisionOptions): Promise<string | null>;
+//# sourceMappingURL=vision.d.ts.map

package/dist/gateway/vision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.d.ts","sourceRoot":"","sources":["../../src/gateway/vision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAyB7C,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4B5G"}

package/dist/gateway/vision.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Vision describe — turn an inbound image into a text description so the agent
+ * can "see" what the user sent, without rewiring the core text-only LLM loop.
+ *
+ * Self-contained on purpose: a single OpenAI-compatible chat/completions call
+ * with an image_url (base64 data URL) content block. The model + key are
+ * resolved from config.channels.<id>.visionModel / config.llm.vision_model
+ * (default gpt-4o-mini), falling back to env keys the same way the rest of
+ * Skyloom does. If no key/model is available, vision is skipped silently and the
+ * gateway just uses the media description line.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeImages = describeImages;
+const axios_1 = __importDefault(require("axios"));
+const logger_1 = require("../core/logger");
+const log = (0, logger_1.getLogger)('gateway-vision');
+/** OpenAI-compatible base URL for a provider inferred from the model id. */
+function baseUrlFor(model) {
+    const l = model.toLowerCase();
+    if (l.includes('claude'))
+        return 'https://api.anthropic.com/v1'; // not OpenAI-shaped; skipped below
+    if (l.includes('gemini'))
+        return 'https://generativelanguage.googleapis.com/v1beta/openai';
+    if (l.includes('grok') || l.includes('xai'))
+        return 'https://api.x.ai/v1';
+    if (l.includes('qwen') || l.includes('dashscope'))
+        return 'https://dashscope.aliyuncs.com/compatible-mode/v1';
+    return 'https://api.openai.com/v1';
+}
+/** Resolve an API key for the vision model from env (best-effort). */
+function keyFor(model, env) {
+    const l = model.toLowerCase();
+    const candidates = l.includes('gemini') ? ['GEMINI_API_KEY', 'GOOGLE_API_KEY']
+        : l.includes('grok') || l.includes('xai') ? ['XAI_API_KEY']
+            : l.includes('qwen') || l.includes('dashscope') ? ['DASHSCOPE_API_KEY', 'QWEN_API_KEY']
+                : ['OPENAI_API_KEY'];
+    for (const c of candidates)
+        if (env[c])
+            return env[c];
+    return undefined;
+}
+/**
+ * Describe one or more images. Returns a description string, or null if vision
+ * is unavailable (no key/model) or fails — callers fall back to the media line.
+ */
+async function describeImages(images, opts = {}) {
+    if (!images.length)
+        return null;
+    const env = opts.env || process.env;
+    const model = opts.model || 'gpt-4o-mini';
+    // Anthropic isn't OpenAI-chat-shaped here; skip to keep this helper simple.
+    if (model.toLowerCase().includes('claude'))
+        return null;
+    const key = keyFor(model, env);
+    if (!key)
+        return null;
+    const prompt = opts.prompt || '请用中文简洁描述这些图片的内容(关键物体、文字、场景);如果含可读文字请转写出来。';
+    const content = [{ type: 'text', text: prompt }];
+    for (const img of images.slice(0, 4)) {
+        const mime = img.contentType || 'image/png';
+        content.push({ type: 'image_url', image_url: { url: `data:${mime};base64,${img.data.toString('base64')}` } });
+    }
+    try {
+        const res = await axios_1.default.post(`${baseUrlFor(model)}/chat/completions`, { model, messages: [{ role: 'user', content }], max_tokens: 500, temperature: 0.2 }, { headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${key}` }, timeout: 30000, validateStatus: (s) => s >= 200 && s < 300 });
+        const text = res.data?.choices?.[0]?.message?.content;
+        return typeof text === 'string' && text.trim() ? text.trim() : null;
+    }
+    catch (e) {
+        log.warn('vision_describe_failed', { model, error: String(e).slice(0, 160) });
+        return null;
+    }
+}
+//# sourceMappingURL=vision.js.map

package/dist/gateway/vision.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skyloom",
-  "version": "1.22.0",
+  "version": "1.24.0",
   "description": "天空织机 Skyloom — 6 weather-themed AI agents: Fog, Rain, Frost, Snow, Dew, Fair",
   "preferGlobal": true,
   "type": "commonjs",
@@ -46,6 +46,7 @@
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "glob": "^11.0.0",
+    "qrcode-terminal": "^0.12.0",
     "sql.js": "^1.14.1",
     "yaml": "^2.4.1"
   },

package/src/cli/main.ts

@@ -38,6 +38,8 @@ program.command("mcp").action(() => { import("../core/mcp_server").then(m => m.s
 program.command("gateway").description("Run the channel gateway (Feishu / WeCom / QQ)")
   .option("-p,--port <p>", "port", "8848")
   .action((o: { port?: string }) => { import("../gateway/gateway").then(m => m.startGateway({ port: parseInt(o.port || "8848") })); });
+program.command("channels").description("Configure a chat channel (Feishu / WeCom / QQ) with QR shortcuts")
+  .action(async () => { await channelsWizard(); });
 program.command("config").action(() => { const c = loadConfig(); process.stdout.write(chalk.cyan("\nConfig: ") + USER_CONFIG_DIR + "\n"); for (const [n, a] of Object.entries(c.agents || {})) process.stdout.write(`  ${chalk.bold(n)}: ${(a as any).model || "default"}\n`); });
 program.command("init").action(() => { if (!fs.existsSync(USER_CONFIG_DIR)) fs.mkdirSync(USER_CONFIG_DIR, { recursive: true }); process.stdout.write(chalk.green("✓ ") + USER_CONFIG_DIR + "\n"); });
 program.command("apikey").description("Manage API keys (persisted to ~/.skyloom/config.yaml)")
@@ -275,6 +277,65 @@ async function setupWizard(): Promise<{ provider: string; key: string; model: st
   return { provider: prov.id, key: key.trim(), model };
 }
 
+/* ═══════════════════════════════════════
+   Channel setup wizard (sky channels)
+   ═══════════════════════════════════════ */
+async function channelsWizard(): Promise<void> {
+  const { CHANNEL_SETUP, SETUP_CHANNEL_IDS, callbackUrl, saveChannelConfig, missingRequired } = require("../gateway/setup");
+  const { renderQR } = require("../gateway/qr");
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const ask = (q: string): Promise<string> => new Promise(r => rl.question(q, r));
+
+  try {
+    process.stdout.write("\n" + chalk.cyan("  ✦ 渠道接入向导 · sky channels ✦\n\n"));
+    process.stdout.write(chalk.dim("  选择要配置的聊天软件:\n\n"));
+    SETUP_CHANNEL_IDS.forEach((id: string, i: number) => {
+      process.stdout.write(chalk.dim(`  ${i + 1}. ${CHANNEL_SETUP[id].name}\n`));
+    });
+    const choice = await ask(chalk.cyan(`\n  编号 (1-${SETUP_CHANNEL_IDS.length}, q 退出): `));
+    if (choice.trim().toLowerCase() === "q") return;
+    const idx = parseInt(choice) - 1;
+    if (isNaN(idx) || idx < 0 || idx >= SETUP_CHANNEL_IDS.length) { process.stdout.write(chalk.dim("  已取消\n")); return; }
+    const spec = CHANNEL_SETUP[SETUP_CHANNEL_IDS[idx]];
+
+    // Steps + QR to the platform console.
+    process.stdout.write("\n" + chalk.bold(`  配置 ${spec.name}\n\n`));
+    spec.steps.forEach((s: string, i: number) => process.stdout.write(chalk.dim(`  ${i + 1}. ${s}\n`)));
+    process.stdout.write(chalk.dim(`\n  📱 扫码打开管理后台:  `) + chalk.cyan(spec.consoleUrl) + "\n");
+    const consoleQR = renderQR(spec.consoleUrl);
+    if (consoleQR) process.stdout.write("\n" + consoleQR.split("\n").map((l: string) => "    " + l).join("\n") + "\n");
+    if (spec.docsUrl) process.stdout.write(chalk.dim(`  📖 文档: ${spec.docsUrl}\n`));
+
+    // Collect credential fields.
+    process.stdout.write("\n" + chalk.dim("  逐项填入凭据(回车跳过可选项):\n\n"));
+    const values: Record<string, string> = {};
+    for (const f of spec.fields) {
+      const req = f.required ? chalk.red("*") : chalk.dim("(可选)");
+      if (f.hint) process.stdout.write(chalk.dim(`    ↳ ${f.hint}\n`));
+      const v = await ask(chalk.cyan(`  ${f.label} ${req}: `));
+      if (v.trim()) values[f.key] = v.trim();
+    }
+    const missing = missingRequired(spec.id, values);
+    if (missing.length) {
+      process.stdout.write(chalk.yellow(`\n  ⚠ 缺少必填项: ${missing.join(", ")} — 已保存现有项,可再次运行补全。\n`));
+    }
+
+    const cfgPath = saveChannelConfig(spec.id, values);
+    process.stdout.write(chalk.green(`\n  ✓ 已保存到 ${cfgPath} 的 channels.${spec.id}\n`));
+
+    // Callback URL + QR to paste into the platform console.
+    const base = (await ask(chalk.cyan("\n  你的网关公网地址(如 https://bot.example.com,回车用 http://localhost:8848): "))).trim()
+      || "http://localhost:8848";
+    const cb = callbackUrl(base, spec.id);
+    process.stdout.write(chalk.dim("\n  把下面的回调 URL 填入平台后台的事件/接收配置:\n  ") + chalk.cyan(cb) + "\n");
+    const cbQR = renderQR(cb);
+    if (cbQR) process.stdout.write("\n" + cbQR.split("\n").map((l: string) => "    " + l).join("\n") + "\n");
+    process.stdout.write(chalk.dim(`\n  完成后运行  sky gateway  启动网关。\n\n`));
+  } finally {
+    rl.close();
+  }
+}
+
 async function chat(agentName: string, modelOverride?: string, classic?: boolean): Promise<void> {
   const haveKey = checkApiKeys();
   if (!haveKey) {
@@ -508,6 +569,7 @@ async function chat(agentName: string, modelOverride?: string, classic?: boolean
     }
     if (cmdL.startsWith("/task ")) { const g = inp.slice(6); process.stdout.write(chalk.cyan("\n  ✦ " + g + "\n\n")); await runTask(g); continue; }
     if (cmdL === "/setup") { const r = await setupWizard(); if (r) process.stdout.write(chalk.green(`  ${r.provider} · ${r.model} — Ready!\n`)); continue; }
+    if (cmdL === "/channels") { await channelsWizard(); continue; }
     if (cmdL === "/model" || cmdL.startsWith("/model ")) {
       const { setAgentModel, setUnifiedModel, clearAgentModel, setAgentApiKey, describeAgentLLM } = require("../core/model_config");
       const cfg = (ctx as any).config;

package/src/core/commands.ts

@@ -482,6 +482,16 @@ export const BUILTIN_COMMANDS: CommandInfo[] = [
     takesArgs: false,
     source: 'builtin',
   },
+  {
+    name: 'channels',
+    aliases: [],
+    description: 'Configure a chat channel (Feishu / WeCom / QQ) with QR shortcuts',
+    label: '渠道接入向导（飞书/企业微信/QQ · 含二维码）',
+    category: 'config',
+    hints: [],
+    takesArgs: false,
+    source: 'builtin',
+  },
   {
     name: 'apikey',
     aliases: [],

package/src/gateway/channels/feishu.ts

@@ -14,9 +14,10 @@
  */
 
 import * as crypto from 'crypto';
+import axios from 'axios';
 import { getLogger } from '../../core/logger';
-import { resolveSecret, postJson, TokenCache } from '../helpers';
-import type { ChannelAdapter, MediaAttachment, RawRequest, ReplyTarget, WebhookOutcome } from '../types';
+import { resolveSecret, postJson, postMultipart, loadMedia, TokenCache } from '../helpers';
+import type { ChannelAdapter, InboundMessage, MediaAttachment, OutboundMedia, RawRequest, ReplyTarget, WebhookOutcome } from '../types';
 
 const log = getLogger('channel-feishu');
 
@@ -238,5 +239,51 @@ export function createFeishuAdapter(cfg: any, env: NodeJS.ProcessEnv): ChannelAd
       // Final flush so the last tokens always land.
       if (dirty || acc) await patchCard(messageId, acc.trim() || '(无回复)');
     },
+
+    async sendMedia(target: ReplyTarget, item: OutboundMedia): Promise<void> {
+      const chatId = target.chatId as string;
+      if (!chatId) return;
+      const loaded = await loadMedia(item.src);
+      const headers = await authHeader();
+
+      if (item.kind === 'image') {
+        const up = await postMultipart(`${base}/open-apis/im/v1/images`, {
+          image_type: 'message',
+          image: { data: loaded.data, filename: loaded.filename || 'image', contentType: loaded.contentType || 'image/png' },
+        }, { headers });
+        if (up.code !== 0) { onTokenError(up.code); throw new Error(`feishu image upload ${up.code}: ${up.msg}`); }
+        const imageKey = up.data?.image_key;
+        const send = await postJson(`${base}/open-apis/im/v1/messages?receive_id_type=chat_id`,
+          { receive_id: chatId, msg_type: 'image', content: JSON.stringify({ image_key: imageKey }) },
+          { headers });
+        if (send.code !== 0) { onTokenError(send.code); throw new Error(`feishu image send ${send.code}: ${send.msg}`); }
+        return;
+      }
+
+      // file: upload to im/v1/files then send a file message
+      const up = await postMultipart(`${base}/open-apis/im/v1/files`, {
+        file_type: 'stream',
+        file_name: loaded.filename || 'file',
+        file: { data: loaded.data, filename: loaded.filename || 'file', contentType: loaded.contentType || 'application/octet-stream' },
+      }, { headers });
+      if (up.code !== 0) { onTokenError(up.code); throw new Error(`feishu file upload ${up.code}: ${up.msg}`); }
+      const fileKey = up.data?.file_key;
+      const send = await postJson(`${base}/open-apis/im/v1/messages?receive_id_type=chat_id`,
+        { receive_id: chatId, msg_type: 'file', content: JSON.stringify({ file_key: fileKey }) },
+        { headers });
+      if (send.code !== 0) { onTokenError(send.code); throw new Error(`feishu file send ${send.code}: ${send.msg}`); }
+    },
+
+    async fetchMedia(att: MediaAttachment, msg: InboundMessage): Promise<{ data: Buffer; contentType?: string } | null> {
+      const messageId = (msg.raw as any)?.event?.message?.message_id;
+      if (!messageId || !att.ref) return null;
+      const token = await tokenCache.get();
+      const res = await axios.get(
+        `${base}/open-apis/im/v1/messages/${messageId}/resources/${att.ref}?type=${att.kind === 'image' ? 'image' : 'file'}`,
+        { headers: { Authorization: `Bearer ${token}` }, responseType: 'arraybuffer', timeout: 30000, validateStatus: (s) => s >= 200 && s < 300 },
+      );
+      const ct = res.headers['content-type'];
+      return { data: Buffer.from(res.data), contentType: typeof ct === 'string' ? ct : undefined };
+    },
   };
 }