@skillfm/local 2.0.9 → 2.1.0

package/dist/mcp-stdio/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/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/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/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"}