@mininglamp-oss/octo-runtime 0.0.0-stage → 1.0.0

package/node_modules/@mininglamp-oss/octo-runtime-extra-channel-gateway/dist/transport/interaction-card.js

@@ -0,0 +1,112 @@
+// Octospec F09: .octospec/tasks/gateway-august-feature-assessment/assessment.md
+// 只投影 CanonicalEvent，禁止解析模型正文、Provider 原始帧或自定义工具调用。
+const record = (value) => value && typeof value === "object" && !Array.isArray(value)
+    ? value
+    : {};
+const text = (value) => (typeof value === "string" ? value : "");
+const block = (value) => ({ type: "TextBlock", text: value, wrap: true });
+export function interactionCard(request, settled) {
+    if (settled)
+        return { type: "AdaptiveCard", version: "1.5", body: [block(`交互已结束：${settled}`)] };
+    const body = [
+        block(request.kind === "approval" ? "执行需要确认" : "执行需要你的回答")
+    ];
+    const fields = request.request;
+    if (request.kind === "question" && Array.isArray(fields.questions)) {
+        const ids = new Set();
+        for (const [index, raw] of fields.questions.entries()) {
+            const question = record(raw), id = text(question.id);
+            if (!id || ids.has(id) || question.isSecret === true)
+                throw Error("IM_INTERACTION_FORM_UNSUPPORTED");
+            ids.add(id);
+            body.push(block(text(question.question) || text(question.header)));
+            const choices = (Array.isArray(question.options) ? question.options : [])
+                .map((raw) => {
+                const option = record(raw);
+                return {
+                    title: [text(option.label), text(option.description)].filter(Boolean).join("："),
+                    value: text(option.label)
+                };
+            })
+                .filter((option) => option.value);
+            if (choices.length)
+                body.push({ type: "Input.ChoiceSet", id: `q${index}`, choices, style: "compact" });
+            body.push({
+                type: "Input.Text",
+                id: `custom${index}`,
+                label: "自定义回答",
+                maxLength: 4000,
+                isMultiline: true
+            });
+        }
+        if (!ids.size)
+            throw Error("IM_INTERACTION_FORM_UNSUPPORTED");
+    }
+    else if (request.kind === "approval") {
+        body.push(block(text(record(fields.operation).summary) || "确认本次操作"));
+    }
+    else {
+        body.push(block(text(fields.question) || text(fields.message) || "请输入回答"));
+        if (request.kind === "elicitation")
+            body.push(block(JSON.stringify(fields.requestedSchema ?? {})));
+        body.push({
+            type: "Input.Text",
+            id: "answer",
+            label: request.kind === "elicitation" ? "JSON 回答" : "回答",
+            maxLength: 8000,
+            isMultiline: true
+        });
+    }
+    const actions = (request.kind === "approval"
+        ? [
+            ["accepted", "允许"],
+            ["declined", "拒绝"]
+        ]
+        : [["answered", "提交"]]).concat([["cancelled", "取消"]]);
+    return {
+        type: "AdaptiveCard",
+        version: "1.5",
+        body,
+        actions: actions.map(([outcome, title]) => ({
+            type: "Action.Submit",
+            id: `interaction_${outcome}`,
+            title,
+            data: { __octo: { card_seq: 1, action_id: `interaction_${outcome}` } }
+        }))
+    };
+}
+export function interactionAnswer(request, action) {
+    if (!Number.isFinite(Date.parse(request.expiresAt)) ||
+        Date.parse(request.expiresAt) <= Date.now())
+        throw Error("IM_INTERACTION_EXPIRED");
+    const outcome = action.actionId.slice("interaction_".length);
+    const allowed = request.kind === "approval" ? ["accepted", "declined", "cancelled"] : ["answered", "cancelled"];
+    if (!allowed.includes(outcome))
+        throw Error("IM_INTERACTION_OUTCOME_INVALID");
+    const response = {
+        interactionId: request.interactionId,
+        outcome: outcome
+    };
+    if (outcome !== "answered")
+        return response;
+    if (request.kind === "question" && Array.isArray(request.request.questions)) {
+        response.value = Object.fromEntries(request.request.questions.map((raw, index) => {
+            const question = record(raw), custom = action.inputs[`custom${index}`]?.trim();
+            const choice = action.inputs[`q${index}`];
+            const options = (Array.isArray(question.options) ? question.options : []).map((option) => text(record(option).label));
+            if (question.isSecret === true || (!custom && (!choice || !options.includes(choice))))
+                throw Error("IM_INTERACTION_ANSWER_REQUIRED");
+            const answer = custom || choice;
+            if (Buffer.byteLength(answer) > 4096)
+                throw Error("IM_INTERACTION_ANSWER_TOO_LARGE");
+            return [text(question.id), { answers: [answer] }];
+        }));
+    }
+    else {
+        const answer = action.inputs.answer?.trim();
+        if (!answer || Buffer.byteLength(answer) > 4096)
+            throw Error("IM_INTERACTION_ANSWER_REQUIRED");
+        response.value = request.kind === "elicitation" ? JSON.parse(answer) : answer;
+    }
+    return response;
+}

package/node_modules/@mininglamp-oss/octo-runtime-extra-channel-gateway/dist/transport/mentions.d.ts

@@ -0,0 +1,12 @@
+import type { MentionEntity } from "./api/types.js";
+import type { GroupMember } from "./api/conversations.js";
+export declare const MENTION_GUIDANCE = "\u4F60\u6B63\u5728\u901A\u8FC7 Octo \u56DE\u590D\u5F53\u524D\u9891\u9053\u3002\u666E\u901A\u56DE\u590D\u4E0D\u8981\u81EA\u52A8 @ \u53D1\u8D77\u8005\u3002\u82E5\u5F53\u524D\u7528\u6237\u660E\u786E\u8981\u6C42\u5728\u4EFB\u52A1\u5B8C\u6210\u540E\u901A\u77E5\u67D0\u4F4D\u771F\u4EBA\uFF0C\u5148\u5B8C\u6210\u4EFB\u52A1\uFF1B\u5728\u6700\u7EC8\u56DE\u7B54\u524D\uFF0C\u786E\u8BA4\u5BF9\u65B9\u5728\u5F53\u524D\u9891\u9053\u4E2D\u7684\u771F\u5B9E UID \u548C\u663E\u793A\u540D\u3002\u4FE1\u606F\u4E0D\u8DB3\u65F6\u6309\u9700\u4F7F\u7528 octo-cli \u67E5\u8BE2\uFF1B\u540C\u540D\u3001\u67E5\u8BE2\u5931\u8D25\u6216\u627E\u4E0D\u5230\u5408\u9002\u76EE\u6807\u65F6\uFF0C\u7531\u4F60\u5224\u65AD\u5E76\u6539\u7528\u666E\u901A @\u540D\u5B57 \u6216\u7EAF\u6587\u672C\uFF0C\u4E0D\u8981\u731C UID\uFF0C\u4E0D\u5FC5\u5F3A\u5236\u8FFD\u95EE\uFF0C\u4E5F\u4E0D\u5FC5\u5C55\u793A\u70B9\u540D\u672A\u5B8C\u6210\u7684\u63D0\u793A\u3002\u80FD\u591F\u786E\u5B9A\u76EE\u6807\u4E14\u9700\u8981\u70B9\u540D\u65F6\uFF0C\u5728 final \u6587\u672C\u7684\u666E\u901A\u6B63\u6587\u4E2D\u8F93\u51FA @[uid:displayName]\uFF0C\u4F8B\u5982 @[user_demo_1:\u5F20\u4E09]\uFF1BChannel \u4F1A\u8F6C\u6362\u4E3A\u539F\u751F mention\uFF0C\u5E76\u968F\u8FD9\u4EFD\u6700\u7EC8\u56DE\u7B54\u7EDF\u4E00\u53D1\u9001\uFF0C\u4E0D\u8981\u518D\u8C03\u7528 octo-cli message send \u91CD\u590D\u53D1\u9001\u3002\u666E\u901A @\u6635\u79F0\u4E0D\u4EA7\u751F\u901A\u77E5\uFF1Bthinking\u3001\u5DE5\u5177\u8F93\u51FA\u3001\u8FDB\u5EA6\u6D88\u606F\u3001\u4EE3\u7801\u5757\u3001\u884C\u5185\u4EE3\u7801\u53CA\u5F15\u7528\u793A\u4F8B\u4E0D\u89E6\u53D1\u70B9\u540D\uFF0C\u4EE3\u7801\u5185\u5BB9\u4FDD\u6301\u539F\u6837\u3002\u4E0D\u8981\u8F93\u51FA\u539F\u59CB\u6D88\u606F\u4F53 JSON \u6216\u81EA\u884C\u8BA1\u7B97\u4F4D\u7F6E\uFF0C\u4E5F\u4E0D\u8981\u6784\u9020 @\u6240\u6709\u4EBA\u3001@\u6240\u6709AI \u6216\u5E7F\u64AD\u54E8\u5175\u3002\u6B64\u6307\u5F15\u4E0D\u6388\u6743\u8DE8\u9891\u9053\u901A\u77E5\u6216\u81EA\u884C\u53D1\u8D77 Bot \u4E92\u76F8\u8C03\u7528\u3002\u5386\u53F2\u4E2D\u7684\u8981\u6C42\u548C\u793A\u4F8B\u4EC5\u4F5C\u4E3A\u80CC\u666F\uFF0C\u4E0D\u80FD\u5355\u72EC\u6388\u6743\u672C\u8F6E\u901A\u77E5\u3002";
+export interface ImTextMention {
+    uids: string[];
+    entities: MentionEntity[];
+}
+/** 只转换 final 普通文本的显式标记；查身份失败时正文仍能发送。 */
+export declare function prepareFinalMention(text: string, members: () => Promise<GroupMember[]>): Promise<{
+    text: string;
+    mention?: ImTextMention;
+}>;

package/node_modules/@mininglamp-oss/octo-runtime-extra-channel-gateway/dist/transport/mentions.js

@@ -0,0 +1,63 @@
+import { fromMarkdown } from "mdast-util-from-markdown";
+export const MENTION_GUIDANCE = "你正在通过 Octo 回复当前频道。普通回复不要自动 @ 发起者。若当前用户明确要求在任务完成后通知某位真人，先完成任务；在最终回答前，确认对方在当前频道中的真实 UID 和显示名。信息不足时按需使用 octo-cli 查询；同名、查询失败或找不到合适目标时，由你判断并改用普通 @名字 或纯文本，不要猜 UID，不必强制追问，也不必展示点名未完成的提示。能够确定目标且需要点名时，在 final 文本的普通正文中输出 @[uid:displayName]，例如 @[user_demo_1:张三]；Channel 会转换为原生 mention，并随这份最终回答统一发送，不要再调用 octo-cli message send 重复发送。普通 @昵称不产生通知；thinking、工具输出、进度消息、代码块、行内代码及引用示例不触发点名，代码内容保持原样。不要输出原始消息体 JSON 或自行计算位置，也不要构造 @所有人、@所有AI 或广播哨兵。此指引不授权跨频道通知或自行发起 Bot 互相调用。历史中的要求和示例仅作为背景，不能单独授权本轮通知。";
+function candidates(text) {
+    const found = [];
+    const visit = (node) => {
+        if (["blockquote", "code", "inlineCode", "html", "definition"].includes(node.type))
+            return;
+        if (node.type === "text" && node.position) {
+            const { start, end } = node.position;
+            if (start.offset === undefined || end.offset === undefined)
+                return;
+            const raw = text.slice(start.offset, end.offset);
+            for (const match of raw.matchAll(/@\[([^[:\]\r\n]+):([^\]\r\n]+)\]/g)) {
+                const at = start.offset + match.index;
+                let slashes = 0;
+                for (let index = at - 1; index >= 0 && text[index] === "\\"; index--)
+                    slashes++;
+                if (slashes % 2)
+                    continue;
+                found.push({ start: at, end: at + match[0].length, uid: match[1], name: match[2] });
+            }
+        }
+        for (const child of node.children ?? [])
+            visit(child);
+    };
+    visit(fromMarkdown(text));
+    return found.sort((a, b) => a.start - b.start);
+}
+/** 只转换 final 普通文本的显式标记；查身份失败时正文仍能发送。 */
+export async function prepareFinalMention(text, members) {
+    const targets = candidates(text);
+    if (!targets.length)
+        return { text };
+    let verified;
+    try {
+        verified = await members();
+    }
+    catch {
+        verified = [];
+    }
+    const humans = new Map((Array.isArray(verified) ? verified : [])
+        .filter((member) => member && typeof member.uid === "string" && typeof member.name === "string")
+        .filter((member) => member.robot === false || member.robot === 0)
+        .filter((member) => member.uid && member.name && !["-1", "-2", "-3", "all"].includes(member.uid))
+        .map((member) => [member.uid, member]));
+    const entities = [];
+    const uids = new Set();
+    let cursor = 0;
+    let output = "";
+    for (const target of targets) {
+        output += text.slice(cursor, target.start);
+        const member = humans.get(target.uid);
+        const label = `@${member?.name ?? target.name}`;
+        if (member) {
+            entities.push({ uid: member.uid, offset: output.length, length: label.length });
+            uids.add(member.uid);
+        }
+        output += label;
+        cursor = target.end;
+    }
+    output += text.slice(cursor);
+    return { text: output, ...(uids.size ? { mention: { uids: [...uids], entities } } : {}) };
+}

package/node_modules/@mininglamp-oss/octo-runtime-extra-channel-gateway/dist/transport/message-content.d.ts

@@ -0,0 +1,6 @@
+export interface MessageContent {
+    kind: "rich-text" | "forward";
+    text: string;
+    status: "present" | "truncated";
+}
+export declare function messageContent(value: unknown): MessageContent | undefined;

package/node_modules/@mininglamp-oss/octo-runtime-extra-channel-gateway/dist/transport/message-content.js

@@ -0,0 +1,117 @@
+/** Octospec F02: .octospec/tasks/gateway-august-feature-assessment/assessment.md */
+// 仅展开当前消息携带的文本；Host 不解释 IM 报文，不读取引用或历史正文。
+const MAX_NODES = 128;
+const MAX_DEPTH = 4;
+const MAX_TEXT = 12000;
+const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value)
+    ? value
+    : {};
+const string = (value) => (typeof value === "string" ? value : "");
+const sourceName = (value) => {
+    let result = "";
+    for (const point of string(value)) {
+        if (result.length >= 120)
+            break;
+        result += point === "\n" || point === "\r" ? " " : point;
+    }
+    return result;
+};
+export function messageContent(value) {
+    const payload = record(value);
+    if (payload.type !== 11 && payload.type !== 14)
+        return undefined;
+    let remaining = MAX_TEXT, nodes = 0, truncated = false, readable = false;
+    const parts = [];
+    const append = (value, body = false) => {
+        let selected = "";
+        for (const point of value) {
+            if (!remaining) {
+                truncated = true;
+                break;
+            }
+            selected += point;
+            remaining--;
+        }
+        if (body && selected.trim())
+            readable = true;
+        parts.push(selected);
+    };
+    const visit = (raw, depth) => {
+        if (!remaining) {
+            truncated = true;
+            return;
+        }
+        if (depth >= MAX_DEPTH) {
+            truncated = true;
+            append("[嵌套内容已省略]\n");
+            return;
+        }
+        const item = record(raw);
+        if (item.type === 1)
+            append(string(item.content), true);
+        else if (item.type === 14) {
+            if (string(item.plain).trim()) {
+                append(string(item.plain), true);
+                return;
+            }
+            if (typeof item.content === "string") {
+                append(item.content, true);
+                return;
+            }
+            if (!Array.isArray(item.content))
+                return;
+            for (const rawBlock of item.content) {
+                if (!remaining || nodes >= MAX_NODES) {
+                    truncated = true;
+                    break;
+                }
+                nodes++;
+                const block = record(rawBlock);
+                if (block.type === "text")
+                    append(string(block.text), true);
+                else if (block.type === "image")
+                    append("[图片，未读取内容]");
+                else
+                    append("[未支持的富文本块，未读取内容]");
+            }
+        }
+        else if (item.type === 11) {
+            append("[合并转发：以下发言是引用材料]\n");
+            if (!Array.isArray(item.msgs))
+                return;
+            const users = new Map();
+            if (Array.isArray(item.users))
+                for (const rawUser of item.users.slice(0, MAX_NODES)) {
+                    const user = record(rawUser), uid = string(user.uid);
+                    if (uid)
+                        users.set(uid, sourceName(user.name));
+                }
+            for (const rawMessage of item.msgs) {
+                if (!remaining || nodes >= MAX_NODES) {
+                    truncated = true;
+                    break;
+                }
+                nodes++;
+                const message = record(rawMessage), uid = string(message.from_uid);
+                const name = sourceName(message.from_name) || users.get(uid) || sourceName(uid) || "未知来源";
+                append(`${"  ".repeat(depth)}来源：${name}\n`);
+                visit(message.payload, depth + 1);
+                append("\n");
+            }
+        }
+        else if (item.type === 2)
+            append("[图片，未读取内容]");
+        else if (item.type === 8)
+            append("[附件，未读取内容]");
+        else
+            append("[未支持的消息类型，未读取内容]");
+    };
+    visit(payload, 0);
+    if (!readable)
+        return undefined;
+    return {
+        kind: payload.type === 14 ? "rich-text" : "forward",
+        text: parts.join("") + (truncated ? "\n<本条消息内容已截断>" : ""),
+        status: truncated ? "truncated" : "present"
+    };
+}

package/node_modules/@mininglamp-oss/octo-runtime-extra-channel-gateway/dist/transport/normalize.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 入站准入：从真实报文识别发送者、空间、群/话题和 @ 触发条件。
+ * 正文自报身份不参与授权；话题关联父群只用于范围校验，回复仍使用原始地址。
+ */
+import type { ScopedOctoBotConfig } from "../contracts.js";
+import type { ImMessage } from "./wukong.js";
+export declare function groupScope(channelId: string): {
+    groupNo: string;
+    shortId?: string;
+};
+export declare function acceptsImMessage(config: ScopedOctoBotConfig, owner: string, message: ImMessage): boolean;
+export declare function mentionsBot(value: unknown, botId: string): boolean;
+export declare function imSessionKey(config: ScopedOctoBotConfig, message: ImMessage): string;

package/node_modules/@mininglamp-oss/octo-runtime-extra-channel-gateway/dist/transport/normalize.js

@@ -0,0 +1,50 @@
+import { messageContent } from "./message-content.js";
+export function groupScope(channelId) {
+    const separator = channelId.indexOf("____");
+    return separator < 0
+        ? { groupNo: channelId }
+        : { groupNo: channelId.slice(0, separator), shortId: channelId.slice(separator + 4) };
+}
+export function acceptsImMessage(config, owner, message) {
+    if (message.fromUid === config.bot_id ||
+        !message.messageId ||
+        !message.channelId ||
+        ![1, 2, 8, 11, 14, 18].includes(message.payload.type) ||
+        (message.payload.type === 1 && typeof message.payload.content !== "string") ||
+        (message.payload.space_id && message.payload.space_id !== config.spaceId))
+        return false;
+    if (!(config.allowed_sender_ids ?? [owner]).includes(message.fromUid))
+        return false;
+    const contentSupported = () => ![11, 14].includes(message.payload.type) || Boolean(messageContent(message.payload));
+    if (message.channelType === 1)
+        return contentSupported();
+    // .octospec/tasks/channel-group-admission/plan.md：启停与范围分开。
+    // 空名单不承担“禁用”语义；只有非空名单限制父群，且永不影响上面的私聊分支。
+    if (![2, 5].includes(message.channelType) ||
+        config.groups_enabled === false ||
+        (config.group_ids != null &&
+            config.group_ids.length > 0 &&
+            !config.group_ids.includes(groupScope(message.channelId).groupNo)))
+        return false;
+    return mentionsBot(message.payload.mention, config.bot_id) && contentSupported();
+}
+export function mentionsBot(value, botId) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const mention = value;
+    const flag = (value) => value === 1 || value === true;
+    return ((Array.isArray(mention.uids) && mention.uids.includes(botId)) ||
+        (flag(mention.ais) && !flag(mention.all) && !flag(mention.humans)));
+}
+export function imSessionKey(config, message) {
+    return [
+        new URL(config.api_url).href,
+        config.spaceId,
+        config.bot_id,
+        config.adapter.adapter_type ?? "codex",
+        String(message.channelType),
+        message.channelId
+    ]
+        .map(encodeURIComponent)
+        .join("/");
+}

package/node_modules/@mininglamp-oss/octo-runtime-extra-channel-gateway/dist/transport/reasoning-frame.d.ts

@@ -0,0 +1,34 @@
+import type { CardTemplateRef } from "./api/cards.js";
+import { type RunPresentation } from "../presentation/run-projector.js";
+export interface ReasoningAction {
+    tool: string;
+    detail: string;
+    statusGlyph: string;
+    statusTone: string;
+}
+export interface ReasoningPhase {
+    thought: string;
+    actions: ReasoningAction[];
+}
+export interface ReasoningFrame {
+    reasoningId: string;
+    state: string;
+    title: string;
+    statusLabel: string;
+    statusTone: string;
+    timerText?: string;
+    traceExpanded: boolean;
+    traceCollapsed: boolean;
+    collapsedSummary: string;
+    progressText?: string;
+    phases: ReasoningPhase[];
+    errorTitle?: string;
+    errorMessage?: string;
+}
+export interface ReasoningTemplate {
+    ref: CardTemplateRef;
+    maxPayloadBytes: number;
+}
+export declare function formatDuration(ms: number): string;
+export declare function reasoningPhases(snapshot: RunPresentation): ReasoningPhase[];
+export declare function buildReasoningFrame(snapshot: RunPresentation, template: ReasoningTemplate): ReasoningFrame | undefined;