@skillfm/local 2.1.0 → 2.1.1

package/dist/mcp-stdio 2/render-flow.js

@@ -0,0 +1,70 @@
+// Render envelope.dialogue_flow + EnhancedError 成 Agent 可读文本
+//
+// PRD Book 3 §3.2: MCP 工具不翻译业务话术, 只把服务端 envelope 完整呈现给 Agent。
+// Agent 自己根据 dialogue_flow.this_turn / next_turn_hints / gentle_exit 决定怎么说。
+//
+// 核心约束: 不在 MCP 这层注入额外文案, 只做"忠实搬运 + 结构化展示"。
+function pickText(loc) {
+    return loc?.zh || loc?.en || '';
+}
+/**
+ * 把一份 dialogue_flow 渲染成对 Agent 友好的 markdown 块。
+ *
+ * 目标读者: Agent (Claude Code / Cursor 等), 不是终端用户。
+ * 因此用 [Guide / 引导剧本] 开头, 让 Agent 知道这是元信息而非用户话语。
+ */
+export function renderDialogueFlow(flow) {
+    const lines = [];
+    lines.push(`[引导剧本 · ${flow.flow_id} · turn ${flow.current_turn}/${flow.total_turns}]`);
+    lines.push('');
+    lines.push(`本轮目标: ${flow.this_turn.semantic_goal}`);
+    if (flow.this_turn.talk_points?.length) {
+        lines.push('可以用的话题点:');
+        for (const p of flow.this_turn.talk_points)
+            lines.push(`  - ${p}`);
+    }
+    lines.push(`本轮收尾方式: ${flow.this_turn.end_with}`);
+    lines.push('');
+    lines.push('下一轮根据 ta 的反应分支:');
+    lines.push(`  · ta 接茬: ${flow.next_turn_hints.if_user_engages}`);
+    lines.push(`  · ta 犹豫: ${flow.next_turn_hints.if_user_hesitates}`);
+    lines.push(`  · ta 拒绝: ${flow.next_turn_hints.if_user_declines}`);
+    lines.push('');
+    lines.push(`温柔退路 (gentle_exit): ${flow.gentle_exit.semantic_goal}`);
+    if (flow.gentle_exit.talk_points?.length) {
+        for (const p of flow.gentle_exit.talk_points)
+            lines.push(`  - ${p}`);
+    }
+    lines.push('');
+    lines.push(`本轮成功判定: ${flow.success_criterion}`);
+    return lines.join('\n');
+}
+/**
+ * 渲染整个 envelope 的"软错误 + dialogue_flow"区段。
+ * 用在 MCP 工具的 catch 路径里。
+ */
+export function renderEnvelopeError(envelope) {
+    if (!envelope || !envelope.error)
+        return null;
+    const err = envelope.error;
+    const blocks = [];
+    const userMsg = pickText(err.user_message);
+    if (userMsg)
+        blocks.push(userMsg);
+    const directive = pickText(err.agent_directive);
+    if (directive)
+        blocks.push(`[agent 心法] ${directive}`);
+    const flow = envelope.dialogue_flow || err.dialogue_flow;
+    if (flow)
+        blocks.push(renderDialogueFlow(flow));
+    if (envelope.conversation_hints?.length) {
+        blocks.push('—');
+        for (const h of envelope.conversation_hints) {
+            const t = pickText(h.text);
+            if (t)
+                blocks.push(`[hint] ${t}`);
+        }
+    }
+    return blocks.join('\n\n');
+}
+//# sourceMappingURL=render-flow.js.map

package/dist/mcp-stdio 2/render-flow.js.map

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

package/dist/mcp-stdio 2/request-context.d.ts

@@ -0,0 +1,30 @@
+export interface RequestContext {
+    apiBaseUrl: string;
+    brainKey: string;
+    jwtToken: string;
+    /** 同一个 brainKey 下的 conversation-state 读写器（HTTP 模式下从 store 借用，stdio 下可以是全局单例） */
+    convState: ConvStateHandle;
+}
+export interface ConvStateHandle {
+    get(): string | null;
+    set(v: string | null): void;
+    getFeedback(): string | null;
+    consumeFeedback(): string | null;
+    pushFeedback(v: unknown): void;
+}
+export declare class ConvStateStore {
+    private map;
+    getHandle(brainKey: string): ConvStateHandle;
+    private getEntry;
+    private touch;
+    private evictIfNeeded;
+    /** 测试辅助 */
+    _clear(): void;
+    _size(): number;
+}
+/**
+ * 全局单例 store — stdio 模式/tests 也会用到，HTTP 模式的 app 实例也直接用它。
+ * 不同 brainKey 天然隔离。
+ */
+export declare const globalConvStore: ConvStateStore;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/mcp-stdio 2/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/mcp-stdio/request-context.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,IAAI,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5B,WAAW,IAAI,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAChC;AASD,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAgC;IAE3C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe;IAwB5C,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,aAAa;IAWrB,WAAW;IACX,MAAM,IAAI,IAAI;IAId,KAAK,IAAI,MAAM;CAGhB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,gBAAuB,CAAC"}

package/dist/mcp-stdio 2/request-context.js

@@ -0,0 +1,78 @@
+// RequestContext — 每请求独立的客户端上下文，HTTP Streamable 模式下使用。
+//
+// 为什么需要这个？
+//   stdio 模式是单租户进程，全局 config + 全局 conv-state 没问题。
+//   HTTP 模式是多租户（多个 agent 带各自的 Bearer 打到同一个 process），
+//   必须按 brainKey 隔离出站状态，避免 conv-state bleed across agents。
+//
+// 设计:
+//   - RequestContext 不可变 (per-request frozen)
+//   - ConvStateStore 是 brainKey → {state, feedback} 的 Map
+//   - LRU-ish cap（512 条）防止内存无界增长；真出问题再换 Redis
+//
+// BYOK 红线 (Principle 24): 这里永不读/存任何 LLM key, 只存平台自己的 brainKey + JWT。
+const MAX_ENTRIES = 512;
+export class ConvStateStore {
+    map = new Map();
+    getHandle(brainKey) {
+        const store = this;
+        return {
+            get: () => store.getEntry(brainKey).state,
+            set: (v) => {
+                const e = store.getEntry(brainKey);
+                e.state = v;
+                store.touch(brainKey, e);
+            },
+            getFeedback: () => store.getEntry(brainKey).feedback,
+            consumeFeedback: () => {
+                const e = store.getEntry(brainKey);
+                const f = e.feedback;
+                e.feedback = null;
+                return f;
+            },
+            pushFeedback: (v) => {
+                const e = store.getEntry(brainKey);
+                e.feedback = v === null ? null : JSON.stringify(v);
+                store.touch(brainKey, e);
+            },
+        };
+    }
+    getEntry(brainKey) {
+        let e = this.map.get(brainKey);
+        if (!e) {
+            e = { state: null, feedback: null };
+            this.map.set(brainKey, e);
+            this.evictIfNeeded();
+        }
+        return e;
+    }
+    touch(brainKey, e) {
+        // LRU: delete + re-set 让它移到 Map 末尾
+        this.map.delete(brainKey);
+        this.map.set(brainKey, e);
+    }
+    evictIfNeeded() {
+        while (this.map.size > MAX_ENTRIES) {
+            const oldest = this.map.keys().next().value;
+            if (oldest !== undefined) {
+                this.map.delete(oldest);
+            }
+            else {
+                break;
+            }
+        }
+    }
+    /** 测试辅助 */
+    _clear() {
+        this.map.clear();
+    }
+    _size() {
+        return this.map.size;
+    }
+}
+/**
+ * 全局单例 store — stdio 模式/tests 也会用到，HTTP 模式的 app 实例也直接用它。
+ * 不同 brainKey 天然隔离。
+ */
+export const globalConvStore = new ConvStateStore();
+//# sourceMappingURL=request-context.js.map

package/dist/mcp-stdio 2/request-context.js.map

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

package/dist/mcp-stdio 2/server.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type RequestContext } from './request-context.js';
+type ToolContextProvider = (extra: {
+    authInfo?: {
+        token?: string;
+    };
+} | undefined) => RequestContext;
+/**
+ * 构造一个注册了所有工具的 McpServer。
+ * 工具回调在运行时调用 getCtx(extra) 拿到 per-request RequestContext。
+ */
+declare function buildMcpServer(getCtx: ToolContextProvider): McpServer;
+export { buildMcpServer };
+export { globalConvStore } from './request-context.js';
+export type { RequestContext } from './request-context.js';
+export type { ToolContextProvider };
+export declare function main(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp-stdio 2/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-stdio/server.ts"],"names":[],"mappings":";AAoBA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAOtF,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQ5E,KAAK,mBAAmB,GAAG,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,SAAS,KAAK,cAAc,CAAC;AAEpG;;;GAGG;AACH,iBAAS,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAqkB9D;AA4BD,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAU1C"}