@matatbread/matbot-core 0.2.5 → 0.2.6

package/package.json

@@ -4,7 +4,7 @@
     "node",
     "browser"
   ],
-  "version": "0.2.5",
+  "version": "0.2.6",
   "engines": {
     "node": ">=24.0.0"
   },
@@ -35,7 +35,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@matatbread/matbot-plugin-api": "^0.2.5"
+    "@matatbread/matbot-plugin-api": "^0.2.6"
   },
   "devDependencies": {
     "typescript": "^5.8.0"

package/src/knowledge/lookup-knowledge-index.ts

@@ -114,6 +114,15 @@ export class LookupKnowledgeIndex implements KnowledgeIndex {
     this.docs.add(entry);
   }
 
+  async remove(id: string): Promise<void> {
+    for (const existing of this.docs) {
+      if (existing.id === id) {
+        this.docs.delete(existing);
+        return;
+      }
+    }
+  }
+
   async search(
     terms:   Array<{ term: string; context?: string }>,
     _signal: AbortSignal,

package/src/loader.ts

@@ -118,7 +118,7 @@ export async function loadPlugins(
     ),
   );
 
-  const toLoad: { spec: string; importSpec: string; name?: string; runtimes?: readonly Runtime[] }[] = [];
+  const toLoad: { spec: string; importSpec: string; resolvedUrl: string; name?: string; runtimes?: readonly Runtime[] }[] = [];
   for (let i = 0; i < reqs.length; i++) {
     const { spec, importSpec, name } = reqs[i]!;
     const runtimes = declared[i];
@@ -132,6 +132,10 @@ export async function loadPlugins(
     toLoad.push({
       spec,
       importSpec: freshImportSpec(spec, importSpec, bustCache),
+      // The resolved location WITHOUT the reload cache-bust stamp — a stable `file:`/bare URL a
+      // consumer can map back to source (e.g. skills_compiler building a types program over the
+      // live plugin set). Falls back to the bare spec when the host pre-resolved nothing.
+      resolvedUrl: importSpec ?? spec,
       ...(name     !== undefined ? { name }     : {}),
       ...(runtimes !== undefined ? { runtimes } : {}),
     });
@@ -211,7 +215,8 @@ export async function loadPlugins(
     const plugin: MatbotPlugin = {
       ...spec_obj,
       name,
-      specifier: spec,
+      specifier:   spec,
+      resolvedUrl: toLoad[i]!.resolvedUrl,
       ...(source   !== undefined ? { source }                 : {}),
       ...(runtimes !== undefined ? { matbotRuntime: runtimes } : {}),
     };

package/src/single-turn.ts

@@ -1,4 +1,10 @@
-import type { Tool, ToolExecutor, ToolContext, ToolEvent, MatbotMachine } from '@matatbread/matbot-plugin-api';
+import type { Tool, ToolExecutor, ToolResultOf, ToolContext, MatbotMachine } from '@matatbread/matbot-plugin-api';
+
+declare module '@matatbread/matbot-plugin-api' {
+  interface ToolResults {
+    single_turn: { text: string };  // the consulted provider's reply text
+  }
+}
 
 /**
  * Exposes {@link MatbotMachine.singleTurn} to the model: a one-shot completion against a configured
@@ -12,9 +18,9 @@ import type { Tool, ToolExecutor, ToolContext, ToolEvent, MatbotMachine } from '
  * a core service (`singleTurn`); core is also the one cross-runtime home both the node app and the
  * browser bundle register it from — the tool-plugin barrel (where `plugin`/`provider` live) is node-only.
  */
-export function createSingleTurnTool(services: MatbotMachine): Tool {
-  const executor: ToolExecutor = {
-    async *execute(input: unknown, ctx: ToolContext): AsyncIterable<ToolEvent> {
+export function createSingleTurnTool(services: MatbotMachine): Tool<ToolResultOf<'single_turn'>> {
+  const executor: ToolExecutor<ToolResultOf<'single_turn'>> = {
+    async *execute(input: unknown, ctx: ToolContext) {
       const args = input as { provider?: string; prompt?: string; system?: string };
       if (typeof args.prompt !== 'string') { yield { type: 'error', message: 'single_turn requires a string "prompt".' }; return; }
       const provider = args.provider ?? ctx.provider;