openlearn-next 0.4.0 → 0.4.2

package/dist/index.html

@@ -7,7 +7,7 @@
     <meta name="description" content="An AI-powered Learning Management System featuring interactive classrooms, stage management, real-time student response systems, lesson editor, auto-grading, and an extensible third-party plugin ecosystem." />
     <meta property="og:title" content="OpenLearn Next" />
     <meta property="og:description" content="An AI-powered Learning Management System featuring interactive classrooms, stage management, real-time student response systems, lesson editor, auto-grading, and an extensible third-party plugin ecosystem." />
-    <script type="module" crossorigin src="/assets/index-C70OJPV_.js"></script>
+    <script type="module" crossorigin src="/assets/index-BKBCBKvy.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/vendor-utils-m0Urvtws.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-react-B0t7H3hh.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-icons-BRmhY6fg.js">

package/dist/server.cjs

@@ -686,8 +686,27 @@ var init_ai_service = __esm({
     AIService = class {
       constructor(db2) {
         this.db = db2;
+        /**
+         * 注册插件 AI 上下文切片提供者（P2: ai.context.provider）。
+         * fn 为服务端闭包（Inline 插件直接传函数），Agent 对话时按 lessonId 调用。
+         * 注册表真源在 server/ai-context-registry.ts，kernel AIService 委托写入。
+         */
+        this._contextDelegates = {};
         this.gateway = new AIProviderGateway(new AIEventBus());
       }
+      /** 由 server 启动时接线（server/ai-context-registry.ts 的注册表为真源） */
+      bindContextRegistry(delegates) {
+        this._contextDelegates = delegates;
+      }
+      registerAIContextProvider(id, fn) {
+        if (!this._contextDelegates.register) {
+          throw new Error("[AIService] AI context registry not bound (server boot required)");
+        }
+        this._contextDelegates.register(id, fn);
+      }
+      unregisterAIContextProvider(id) {
+        this._contextDelegates.unregister?.(id);
+      }
       async generateText(prompt, options) {
         const provider = this.db.prepare(
           "SELECT id, name, api_url, api_key, model_name FROM ai_providers WHERE api_key IS NOT NULL AND api_key != '' LIMIT 1"
@@ -1499,16 +1518,16 @@ function wrapCapability(capabilityService) {
     })
   };
 }
-function wrapPointsDimensionRegistry(registry) {
+function wrapPointsDimensionRegistry(registry2) {
   return {
     registerDimension: createSafeFunction((spec) => {
-      return registry.registerDimension(spec);
+      return registry2.registerDimension(spec);
     }),
     getDimension: createSafeFunction((id) => {
-      return registry.getDimension(id);
+      return registry2.getDimension(id);
     }),
     listDimensions: createSafeFunction(() => {
-      return registry.listDimensions();
+      return registry2.listDimensions();
     })
   };
 }
@@ -1579,7 +1598,14 @@ function wrapAI(aiService) {
           throw e;
         }
       }
-    )
+    ),
+    // P2: ai.context.provider —— 插件注册 AI 上下文切片（可选方法）
+    registerAIContextProvider: createSafeFunction((id, fn) => {
+      return aiService.registerAIContextProvider?.(id, fn);
+    }),
+    unregisterAIContextProvider: createSafeFunction((id) => {
+      return aiService.unregisterAIContextProvider?.(id);
+    })
   };
 }
 async function buildContext(serviceRegistry, tracker, pluginId, manifest, db2, skipTokens, contributionRegistry) {
@@ -18779,9 +18805,9 @@ var AnalyticsCapabilityProviderHandler = class {
 
 // packages/core/capability/invocation/invocation-engine.ts
 var InvocationEngine = class {
-  constructor(registry, pipeline, eventBus) {
+  constructor(registry2, pipeline, eventBus) {
     this.cancelledInvocations = /* @__PURE__ */ new Set();
-    this.registry = registry;
+    this.registry = registry2;
     this.pipeline = pipeline;
     this.eventBus = eventBus;
   }
@@ -18821,8 +18847,8 @@ var InvocationEngine = class {
 
 // packages/core/capability/sdk/capability-sdk.ts
 var CapabilitySDK = class {
-  constructor(registry, engine, eventBus) {
-    this.registry = registry;
+  constructor(registry2, engine, eventBus) {
+    this.registry = registry2;
     this.engine = engine;
     this.eventBus = eventBus;
   }
@@ -20855,6 +20881,43 @@ function attachClassroomFeedService(feedService, eventBus) {
   };
 }
 
+// server/ai-context-registry.ts
+var registry = {
+  providers: /* @__PURE__ */ new Map()
+};
+function registerAIContextProvider(id, fn, registeredBy) {
+  if (!id?.trim() || typeof fn !== "function") {
+    throw new Error("[AIContextRegistry] id and provider function are required");
+  }
+  registry.providers.set(id.trim(), { fn, registeredBy });
+}
+function unregisterAIContextProvider(id, registeredBy) {
+  const entry = registry.providers.get(id.trim());
+  if (entry && registeredBy && entry.registeredBy && entry.registeredBy !== registeredBy) return;
+  registry.providers.delete(id.trim());
+}
+function collectAIContextSlices(lessonId) {
+  const slices = [];
+  for (const [id, entry] of registry.providers) {
+    try {
+      const slice = entry.fn(lessonId);
+      if (typeof slice === "string" && slice.trim()) {
+        slices.push(`[Plugin Context \xB7 ${id}]
+${slice.trim()}`);
+      }
+    } catch (err) {
+      console.error(`[AIContextRegistry] provider "${id}" failed:`, err);
+    }
+  }
+  return slices;
+}
+function bindAIContextRegistry(kernelAIService) {
+  kernelAIService.bindContextRegistry({
+    register: (id, fn) => registerAIContextProvider(id, fn),
+    unregister: (id) => unregisterAIContextProvider(id)
+  });
+}
+
 // server.ts
 var import_helmet = __toESM(require("helmet"), 1);
 var import_express_rate_limit = __toESM(require("express-rate-limit"), 1);
@@ -21588,7 +21651,7 @@ function simpleChecksum(text) {
 
 // server/ai-agent.ts
 var import_crypto4 = __toESM(require("crypto"), 1);
-var buildAgentSystemInstruction = (lang, currentLessonId) => {
+var buildAgentSystemInstruction = (lang, currentLessonId, pluginSlices) => {
   let systemInstruction = lang === "zh" ? "\u4F60\u662F\u4E00\u4E2A\u6559\u80B2\u7CFB\u7EDF\u5E95\u5C42\u7684 OS Agent\u3002\u4F60\u9700\u8981\u7406\u89E3\u8001\u5E08\u7684\u6307\u4EE4\uFF0C\u5E76\u8C03\u7528\u53EF\u7528\u7684\u5DE5\u5177\uFF08\u547D\u4EE4\uFF09\u53BB\u6267\u884C\u8FD9\u4E9B\u64CD\u4F5C\u3002\u5982\u679C\u8001\u5E08\u8BA9\u4F60\u521B\u5EFA\u4E00\u8282\u8BFE\uFF0C\u8BF7\u52A1\u5FC5\u5229\u7528\u5DE5\u5177\u751F\u6210\u8BE6\u7EC6\u7684\u521D\u59CB\u8BFE\u7A0B\u5185\u5BB9\u3002\u5982\u679C\u8001\u5E08\u8981\u6C42\u7BA1\u7406\u8FDB\u7A0B/\u4EFB\u52A1\uFF0C\u8BF7\u4F7F\u7528 process.spawn, process.kill, process.list\u3002\u5982\u679C\u9700\u5B58\u50A8\u6587\u4EF6\u3001\u7D20\u6750\u6216\u521B\u5EFA\u76EE\u5F55\uFF0C\u8BF7\u4F7F\u7528 vfs.* \u5E76\u5728\u9700\u8981\u65F6\u7BA1\u7406\u73ED\u7EA7\u548C\u5B66\u751F\u3002\u4F60\u652F\u6301\u901A\u8FC7 class_create \u521B\u5EFA\u73ED\u7EA7, student_create \u521B\u5EFA\u5B66\u751F, class_add_student \u5C06\u5B66\u751F\u52A0\u5165\u73ED\u7EA7\u3002\u5F53\u8001\u5E08\u8981\u6C42\u4ECE\u63D0\u4F9B\u7684\u6570\u636E\uFF08\u5982CSV\u3001JSON\u3001Markdown\u6216\u5BF9\u8BDD\u4E2D\uFF09\u521B\u5EFA\u73ED\u7EA7\u6216\u5B66\u751F\u65F6\uFF0C\u8BF7\u4F9D\u6B21\u53D1\u51FA\u8FD9\u4E9B\u6307\u4EE4\u3002\u5982\u679C\u4E0A\u4E00\u9636\u6BB5\u8FD4\u56DE\u4E86\u521B\u5EFA\u6210\u529F\u7684\u73ED\u7EA7ID\u6216\u5B66\u751FID\uFF0C\u4F60\u9700\u8981\u5728\u540E\u7EED\uFFFD? functionCall \u4E2D\u5F15\u7528\u8FD9\u4E9BID\uFF08\u4F8B\u5982\uFF1A\u628A\u521A\u521B\u5EFA\u7684\u5B66\u751FID\u52A0\u5165\u5230\u521A\u521B\u5EFA\u7684\u73ED\u7EA7ID\u4E2D\uFF09\u3002\u901A\u8FC7\u5F80\u590D\u7684\u5DE5\u5177\u8C03\u7528\uFF0C\u4F60\u53EF\u4EE5\u81EA\u52A8\u5B8C\u6210\u5B8C\u6574\u7684\u6D41\u7A0B\uFFFD?" : "You are an educational OS kernel agent. You interpret teacher instructions and use your available tools (commands) to execute them. If the teacher asks to create a lesson, always generate some detailed initial content for it. If the teacher asks to spawn or kill processes, use process tools. Use vfs tools to store assets, and manage classes/students as necessary. You support class_create, student_create, class_add_student. Always use tool chaining if you need to create a class and enroll students: first call class_create/student_create, receive their returned IDs, and then call class_add_student in the next turn. Always answer with a helpful summary.";
   if (currentLessonId) {
     systemInstruction += `
@@ -21596,6 +21659,9 @@ var buildAgentSystemInstruction = (lang, currentLessonId) => {
 
 Available tools (functions) can be used multiple times in sequence if needed.`;
   }
+  if (pluginSlices?.length) {
+    systemInstruction += "\n\n" + pluginSlices.join("\n\n");
+  }
   return systemInstruction;
 };
 var buildAgentFinalMessage = (message, attachments) => {
@@ -21728,7 +21794,11 @@ var runGeminiAgentChat = async (request) => {
 };
 var runOpenAIAgentChat = async (provider, request) => {
   const { message, lang = "zh", currentLessonId, attachments, callerRole, history } = request;
-  const systemInstruction = buildAgentSystemInstruction(lang, currentLessonId);
+  const systemInstruction = buildAgentSystemInstruction(
+    lang,
+    currentLessonId,
+    collectAIContextSlices(currentLessonId ?? null)
+  );
   const finalMessage = buildAgentFinalMessage(message, attachments);
   const tools = buildOpenAITools();
   const chatUrl = buildOpenAIChatUrl(provider.api_url);
@@ -22389,13 +22459,13 @@ var OFFICIAL_ACTIVITY_DEFINITIONS = [
     commandType: "assignment.create"
   }
 ];
-function registerOfficialActivities(registry, actionRegistry) {
+function registerOfficialActivities(registry2, actionRegistry) {
   for (const def of OFFICIAL_ACTIVITY_DEFINITIONS) {
     const descriptor = {
       ...def,
       aiAction: aiActionFor(def)
     };
-    registry.registerProvider(new BaseActivityProvider({ descriptor }));
+    registry2.registerProvider(new BaseActivityProvider({ descriptor }));
     if (actionRegistry && descriptor.aiAction) {
       actionRegistry.register(descriptor.aiAction);
     }
@@ -23237,9 +23307,9 @@ var BLOCKED_EXTENSIONS = [".exe", ".sh", ".bat", ".cmd", ".dll", ".so", ".dylib"
 function collectCoursewareRuntimeScripts(cwInfo) {
   const empty = { head: "", bodyEnd: "" };
   try {
-    const registry = kernelContainer?.serviceRegistry?.resolve?.(ICoursewareRuntimeScriptRegistryToken);
-    if (!registry || typeof registry.list !== "function") return empty;
-    const scripts = registry.list({ id: cwInfo.id, uuid: cwInfo.uuid }) || [];
+    const registry2 = kernelContainer?.serviceRegistry?.resolve?.(ICoursewareRuntimeScriptRegistryToken);
+    if (!registry2 || typeof registry2.list !== "function") return empty;
+    const scripts = registry2.list({ id: cwInfo.id, uuid: cwInfo.uuid }) || [];
     if (!scripts.length) return empty;
     let head = "";
     let bodyEnd = "";
@@ -33366,6 +33436,7 @@ async function startServer() {
   registerClassroomExtrasRoutes(ctx.app);
   registerClassroomPeerReviewRoutes(ctx.app);
   setupRealtimeBridge({ eventBus: kernelContainer.eventBus, io, db: kernelContainer.db });
+  bindAIContextRegistry(kernelContainer.aiService);
   setupPresence({
     io,
     eventBus: kernelContainer.eventBus,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openlearn-next",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "private": false,
   "description": "A plugin-driven Educational OS / LMS platform with AI agent teaching assistant",
   "keywords": [