@loomweaver/mcp 0.14.2 → 0.14.4

package/README.md

@@ -9,7 +9,9 @@ is not inside this repo (a chat assistant, a remote client) can scaffold and val
 - `list_generators` — the available generators.
 - `scaffold_weaver` · `scaffold_frame_plugin` · `scaffold_distribution` · `scaffold_auth_source` ·
   `scaffold_settings_store` · `scaffold_theme` · `scaffold_layout` — return a **file map**
-  (`path -> content`); the client writes the files into its project.
+  (`path -> content`); the client writes the files into its project. The server cannot read that
+  project, so pass `scaffold_weaver` the selector prefix your application declares as `prefix`;
+  without it the components are named `app-…`.
 - `validate_manifest` · `validate_i18n` · `validate_catalog` · `validate_commands` — return structured `Finding[]`.
 
 ## Consume from npm (product repos)

package/dist/main.mjs

@@ -31154,9 +31154,9 @@ function renderRegions(indent) {
 // ../devkit/src/recipes/angular-weaver/agent-panel.ts
 function panelFile(weaver) {
   return `import { ChangeDetectionStrategy, Component, signal } from '@angular/core';
-import { EventType, type BaseEvent, type Tool, type ToolMessage } from '@ag-ui/core';
-import { ${weaver.propertyName}Agent } from './${weaver.id}-agent';
-import { askAgent } from './${weaver.id}-agent-source';
+import { EventType, type AGUIEvent, type Tool, type ToolMessage } from '@ag-ui/core';
+import { askAgent } from './${weaver.id}-agent';
+import { ${weaver.propertyName}Tools } from './${weaver.id}-connection';
 
 interface Line {
   readonly kind: 'you' | 'agent' | 'call' | 'result' | 'note';
@@ -31186,11 +31186,11 @@ export class ${weaver.className}AgentPanel {
   // The list is read again whenever the panel gains focus, because the weaver's own translations
   // and other plugins' commands may arrive after this component was built.
   protected refreshOffered(): void {
-    this.offered.set(${weaver.propertyName}Agent()?.list() ?? []);
+    this.offered.set(${weaver.propertyName}Tools()?.list() ?? []);
   }
 
   protected async ask(name: string): Promise<void> {
-    const tools = ${weaver.propertyName}Agent();
+    const tools = ${weaver.propertyName}Tools();
     if (!tools || this.busy()) {
       return;
     }
@@ -31233,24 +31233,19 @@ export class ${weaver.className}AgentPanel {
     }
   }
 
-  private draw(event: BaseEvent): void {
-    const raw = event as unknown as Record<string, unknown>;
+  private draw(event: AGUIEvent): void {
     switch (event.type) {
       case EventType.TEXT_MESSAGE_START:
         this.push({ kind: 'agent', text: '' });
         break;
       case EventType.TEXT_MESSAGE_CONTENT:
-        this.grow('text', String(raw['delta'] ?? ''));
+        this.grow('text', event.delta);
         break;
       case EventType.TOOL_CALL_START:
-        this.push({
-          kind: 'call',
-          text: String(raw['toolCallName'] ?? ''),
-          args: '',
-        });
+        this.push({ kind: 'call', text: event.toolCallName, args: '' });
         break;
       case EventType.TOOL_CALL_ARGS:
-        this.grow('args', String(raw['delta'] ?? ''));
+        this.grow('args', event.delta);
         break;
       default:
         break;
@@ -31279,7 +31274,7 @@ function panelTemplateFile(weaver) {
     class="shrink-0 rounded-md border border-border bg-surface-raised px-3 py-2 text-xs text-content-muted"
   >
     This is a stand-in, not an assistant. It speaks the protocol so you can watch the whole path;
-    replace <code class="text-content">${weaver.id}-agent-source.ts</code> with your own transport.
+    replace <code class="text-content">${weaver.id}-agent.ts</code> with your own transport.
   </p>
 
   <div class="min-h-0 flex-1 overflow-auto">
@@ -31347,7 +31342,7 @@ function panelTemplateFile(weaver) {
 
 // ../devkit/src/recipes/angular-weaver/agent-stand-in.ts
 function standInFile(weaver) {
-  return `import { EventType, type BaseEvent, type Tool } from '@ag-ui/core';
+  return `import { EventType, type AGUIEvent, type Tool } from '@ag-ui/core';
 
 // WHAT THIS IS: a stand-in for an agent, and not an agent. It speaks the AG-UI protocol and nothing
 // else \u2014 no model, no network, no judgement \u2014 so that the whole path from the offered tools through
@@ -31367,15 +31362,16 @@ export interface AgentRequest {
 
 export async function* askAgent(
   request: AgentRequest,
-): AsyncGenerator<BaseEvent> {
+): AsyncGenerator<AGUIEvent> {
   const picked = request.tools.find((tool) =>
     request.prompt.includes(tool.name),
   );
 
-  yield event(EventType.RUN_STARTED, {
+  yield {
+    type: EventType.RUN_STARTED,
     threadId: '${weaver.id}-stand-in',
     runId: request.runId,
-  });
+  };
   yield* speak(
     \`\${request.runId}.says\`,
     picked
@@ -31385,37 +31381,35 @@ export async function* askAgent(
 
   if (picked) {
     const toolCallId = \`\${request.runId}.call\`;
-    yield event(EventType.TOOL_CALL_START, {
-      toolCallId,
-      toolCallName: picked.name,
-    });
+    yield { type: EventType.TOOL_CALL_START, toolCallId, toolCallName: picked.name };
     // Arguments arrive in pieces, exactly as they do from a real model. The adapter assembles them;
     // nothing downstream ever sees a half-written call. The values come from the JSON Schema the
     // workbench described in picked.parameters: the first declared choice of the first argument that
     // has choices, and nothing for the rest, so the command applies its own defaults there.
     for (const piece of chunks(JSON.stringify(sampleArguments(picked)), 4)) {
-      yield event(EventType.TOOL_CALL_ARGS, { toolCallId, delta: piece });
+      yield { type: EventType.TOOL_CALL_ARGS, toolCallId, delta: piece };
       await pause();
     }
-    yield event(EventType.TOOL_CALL_END, { toolCallId });
+    yield { type: EventType.TOOL_CALL_END, toolCallId };
   }
 
-  yield event(EventType.RUN_FINISHED, {
+  yield {
+    type: EventType.RUN_FINISHED,
     threadId: '${weaver.id}-stand-in',
     runId: request.runId,
-  });
+  };
 }
 
 async function* speak(
   messageId: string,
   text: string,
-): AsyncGenerator<BaseEvent> {
-  yield event(EventType.TEXT_MESSAGE_START, { messageId, role: 'assistant' });
+): AsyncGenerator<AGUIEvent> {
+  yield { type: EventType.TEXT_MESSAGE_START, messageId, role: 'assistant' };
   for (const piece of chunks(text, 10)) {
-    yield event(EventType.TEXT_MESSAGE_CONTENT, { messageId, delta: piece });
+    yield { type: EventType.TEXT_MESSAGE_CONTENT, messageId, delta: piece };
     await pause();
   }
-  yield event(EventType.TEXT_MESSAGE_END, { messageId });
+  yield { type: EventType.TEXT_MESSAGE_END, messageId };
 }
 
 function sampleArguments(tool: Tool): Record<string, unknown> {
@@ -31438,10 +31432,6 @@ function chunks(text: string, size: number): readonly string[] {
   return pieces;
 }
 
-function event(type: EventType, fields: Record<string, unknown>): BaseEvent {
-  return { type, ...fields } as unknown as BaseEvent;
-}
-
 function pause(): Promise<void> {
   return new Promise((done) => setTimeout(done, PAUSE_MS));
 }
@@ -31460,15 +31450,18 @@ import {
 } from '@loomweaver/ag-ui';
 import type { PluginContext } from '@loomweaver/plugin-sdk';
 
+// The connection is the workbench's half: the commands offered as tools, and each call put to the
+// workbench and answered. The agent is yours and lives beside it, in ${weaver.id}-agent.ts.
+//
 // A factory, not a module-level connection: everything a run needs lives in the closure, so a second
 // one never shares state with the first.
-export function ${weaver.propertyName}Connection(ctx: PluginContext): CommandTools {
+export function connect${weaver.className}(ctx: PluginContext): CommandTools {
   return commandTools(ctx, { before: (call) => decide(ctx, call) });
 }
 
 // The one connection this plugin activates, published for its panel. Set in activate(), cleared in
 // deactivate(), so the panel renders an honest empty state either side of that.
-export const ${weaver.propertyName}Agent = signal<CommandTools | null>(null);
+export const ${weaver.propertyName}Tools = signal<CommandTools | null>(null);
 
 // What an agent's word is enough for is the command's own statement, declared where the command is
 // registered and read off the call here. No list of ids lives beside the commands: a list drifts from
@@ -31503,9 +31496,10 @@ async function decide(
 `;
 }
 function specFile(weaver) {
-  return `import { EventType, type BaseEvent } from '@ag-ui/core';
+  return `import { EventType, type AGUIEvent, type ToolMessage } from '@ag-ui/core';
+import type { CommandTools } from '@loomweaver/ag-ui';
 import type { CommandArguments, PluginContext } from '@loomweaver/plugin-sdk';
-import { ${weaver.propertyName}Connection } from './${weaver.id}-agent';
+import { connect${weaver.className} } from './${weaver.id}-connection';
 
 interface Asked {
   readonly id: string;
@@ -31526,37 +31520,36 @@ function contextThat(confirms: boolean, ran: Asked[]): PluginContext {
   } as unknown as PluginContext;
 }
 
-function event(type: EventType, fields: Record<string, unknown>): BaseEvent {
-  return { type, ...fields } as unknown as BaseEvent;
+function streamedCall(toolCallId: string, ...deltas: string[]): AGUIEvent[] {
+  return [
+    { type: EventType.TOOL_CALL_START, toolCallId, toolCallName: '${weaver.id}.hello' },
+    ...deltas.map((delta): AGUIEvent => ({ type: EventType.TOOL_CALL_ARGS, toolCallId, delta })),
+    { type: EventType.TOOL_CALL_END, toolCallId },
+  ];
+}
+
+async function answersTo(tools: CommandTools, events: AGUIEvent[]): Promise<ToolMessage[]> {
+  const answers: ToolMessage[] = [];
+  for (const event of events) {
+    const answer = await tools.receive(event);
+    if (answer) {
+      answers.push(answer);
+    }
+  }
+  return answers;
 }
 
-describe('${weaver.propertyName}Connection', () => {
+describe('connect${weaver.className}', () => {
   it('offers what the workbench offers', () => {
-    const tools = ${weaver.propertyName}Connection(contextThat(true, []));
+    const tools = connect${weaver.className}(contextThat(true, []));
     expect(tools.list().map((tool) => tool.name)).toEqual(['${weaver.id}.hello']);
   });
 
   it('assembles a call from its events and answers with the outcome', async () => {
     const ran: Asked[] = [];
-    const tools = ${weaver.propertyName}Connection(contextThat(true, ran));
+    const tools = connect${weaver.className}(contextThat(true, ran));
 
-    expect(
-      await tools.receive(
-        event(EventType.TOOL_CALL_START, {
-          toolCallId: 'c1',
-          toolCallName: '${weaver.id}.hello',
-        }),
-      ),
-    ).toBeNull();
-    await tools.receive(
-      event(EventType.TOOL_CALL_ARGS, { toolCallId: 'c1', delta: '{"tone"' }),
-    );
-    await tools.receive(
-      event(EventType.TOOL_CALL_ARGS, { toolCallId: 'c1', delta: ':"success"}' }),
-    );
-    const answer = await tools.receive(
-      event(EventType.TOOL_CALL_END, { toolCallId: 'c1' }),
-    );
+    const [answer] = await answersTo(tools, streamedCall('c1', '{"tone"', ':"success"}'));
 
     expect(ran).toEqual([{ id: '${weaver.id}.hello', args: { tone: 'success' } }]);
     expect(JSON.parse(answer?.content ?? '{}').tone).toBe('success');
@@ -31565,20 +31558,9 @@ describe('${weaver.propertyName}Connection', () => {
 
   it('never reaches the workbench when a consequential call is declined', async () => {
     const ran: Asked[] = [];
-    const tools = ${weaver.propertyName}Connection(contextThat(false, ran));
+    const tools = connect${weaver.className}(contextThat(false, ran));
 
-    await tools.receive(
-      event(EventType.TOOL_CALL_START, {
-        toolCallId: 'c2',
-        toolCallName: '${weaver.id}.hello',
-      }),
-    );
-    await tools.receive(
-      event(EventType.TOOL_CALL_ARGS, { toolCallId: 'c2', delta: '{}' }),
-    );
-    const answer = await tools.receive(
-      event(EventType.TOOL_CALL_END, { toolCallId: 'c2' }),
-    );
+    const [answer] = await answersTo(tools, streamedCall('c2', '{}'));
 
     expect(ran).toEqual([]);
     expect(answer?.error).toContain('did not run');
@@ -31600,13 +31582,13 @@ function agentSurfaceBlock(weaver) {
 }
 function agentFiles(weaver) {
   const files = {
-    [`src/lib/agent/${weaver.id}-agent.ts`]: connectionFile(weaver),
-    [`src/lib/agent/${weaver.id}-agent-source.ts`]: standInFile(weaver),
+    [`src/lib/agent/${weaver.id}-connection.ts`]: connectionFile(weaver),
+    [`src/lib/agent/${weaver.id}-agent.ts`]: standInFile(weaver),
     [`src/lib/agent/${weaver.id}-agent-panel.ts`]: panelFile(weaver),
     [`src/lib/agent/${weaver.id}-agent-panel.html`]: panelTemplateFile(weaver)
   };
   if (weaver.features.spec) {
-    files[`src/lib/agent/${weaver.id}-agent.spec.ts`] = specFile(weaver);
+    files[`src/lib/agent/${weaver.id}-connection.spec.ts`] = specFile(weaver);
   }
   return files;
 }
@@ -31645,6 +31627,45 @@ function i18nFile(weaver) {
   return JSON.stringify(i18nBundle(weaver), null, 2) + "\n";
 }
 
+// ../devkit/src/lib/scaffolds/scaffold-values.ts
+var NEUTRAL_PREFIX = "app";
+function stringValue(values, name) {
+  const value = values[name];
+  return typeof value === "string" ? value : void 0;
+}
+function booleanValue(values, name) {
+  const value = values[name];
+  return typeof value === "boolean" ? value : void 0;
+}
+var PLACEMENT_OPTIONS = [
+  {
+    name: "directory",
+    type: "string",
+    description: "Project root, relative to the workspace root.",
+    workspaceOnly: true
+  },
+  {
+    name: "tags",
+    type: "string",
+    description: "Comma-separated Nx tags for the project.",
+    workspaceOnly: true
+  },
+  {
+    name: "unitTestRunner",
+    type: "string",
+    description: "Test wiring to emit. 'vitest' uses @nx/angular:unit-test; 'none' emits no test target.",
+    choices: ["vitest", "none"],
+    default: "vitest",
+    workspaceOnly: true
+  }
+];
+var APP_OPTION = {
+  name: "app",
+  type: "string",
+  description: "Application to drop into. Inferred when the workspace has exactly one.",
+  workspaceOnly: true
+};
+
 // ../devkit/src/lib/validate/manifest.ts
 var KNOWN_CAPABILITIES = [
   "contributions",
@@ -31804,6 +31825,18 @@ function deriveCapabilities(features) {
   }
   return KNOWN_CAPABILITIES.filter((capability) => set2.has(capability));
 }
+function resolvePrefix(prefix) {
+  const trimmed = prefix?.trim();
+  if (!trimmed) {
+    return NEUTRAL_PREFIX;
+  }
+  if (!isKebabId(trimmed)) {
+    throw new Error(
+      `Selector prefix must be kebab-case (e.g. "acme"); got "${trimmed}".`
+    );
+  }
+  return trimmed;
+}
 function resolveWeaverInput(input) {
   if (!isKebabId(input.id)) {
     throw new Error(
@@ -31819,7 +31852,7 @@ function resolveWeaverInput(input) {
     propertyName: toCamelCase(input.id),
     capabilities,
     features,
-    prefix: input.prefix?.trim() || "lw",
+    prefix: resolvePrefix(input.prefix),
     importPath: input.importPath?.trim() || `@loomweaver/${input.id}-weaver`
   };
 }
@@ -32016,7 +32049,7 @@ function pluginImports(weaver) {
   }
   if (weaver.features.agent) {
     imports.push(
-      `import { ${weaver.propertyName}Agent, ${weaver.propertyName}Connection } from '../agent/${weaver.id}-agent';`,
+      `import { connect${weaver.className}, ${weaver.propertyName}Tools } from '../agent/${weaver.id}-connection';`,
       `import { ${weaver.className}AgentPanel } from '../agent/${weaver.id}-agent-panel';`
     );
   }
@@ -32041,7 +32074,7 @@ function pluginBody(weaver) {
   const body = [`    ctx.contributeIcons({ '${weaver.id}': icon });`];
   if (weaver.features.agent) {
     body.push(
-      `    ${weaver.propertyName}Agent.set(${weaver.propertyName}Connection(ctx));`
+      `    ${weaver.propertyName}Tools.set(connect${weaver.className}(ctx));`
     );
   }
   if (weaver.features.command) body.push(commandBlock(weaver));
@@ -32058,7 +32091,7 @@ function pluginFile(weaver) {
   const body = pluginBody(weaver);
   const deactivate = weaver.features.agent ? `
   deactivate() {
-    ${weaver.propertyName}Agent.set(null);
+    ${weaver.propertyName}Tools.set(null);
   },` : "";
   return `${pluginImports(weaver).join("\n")}
 
@@ -32081,7 +32114,7 @@ function accessLine(weaver) {
 }
 
 // ../devkit/src/recipes/platform-version.ts
-var PLATFORM_VERSION = "0.14.2";
+var PLATFORM_VERSION = "0.14.4";
 
 // ../devkit/src/recipes/readme-notes.ts
 var UNTAGGED_NOTE = [
@@ -32155,11 +32188,11 @@ function agentNotes(weaver) {
     "",
     `\`src/lib/agent/\` holds three files and one of them is meant to be thrown away.`,
     "",
-    `- \`${weaver.id}-agent.ts\` is the connection: the workbench's own commands offered as tools, and a`,
+    `- \`${weaver.id}-connection.ts\` is the connection: the workbench's own commands offered as tools, and a`,
     "  seam where this weaver decides about a call before it runs. Nothing is registered twice \u2014 the",
     "  list comes from the workbench, already narrowed by everything that would refuse the call.",
     `- \`${weaver.id}-agent-panel.ts\` shows what is offered, the call as it streams, and the outcome.`,
-    `- \`${weaver.id}-agent-source.ts\` is a **stand-in**, not an assistant: it produces the protocol's own`,
+    `- \`${weaver.id}-agent.ts\` is a **stand-in** for the agent, not an assistant: it produces the protocol's own`,
     "  events so the whole path runs before you have connected anything. Replace that one file with",
     "  your transport and nothing else changes. No transport, credential or model is generated for",
     "  you, because none of them can be guessed.",
@@ -33524,52 +33557,6 @@ var layout = {
   }
 };
 
-// ../devkit/src/lib/scaffolds/scaffold-values.ts
-function stringValue(values, name) {
-  const value = values[name];
-  return typeof value === "string" ? value : void 0;
-}
-function booleanValue(values, name) {
-  const value = values[name];
-  return typeof value === "boolean" ? value : void 0;
-}
-var PLACEMENT_OPTIONS = [
-  {
-    name: "directory",
-    type: "string",
-    description: "Project root, relative to the workspace root.",
-    workspaceOnly: true
-  },
-  {
-    name: "tags",
-    type: "string",
-    description: "Comma-separated Nx tags for the project.",
-    workspaceOnly: true
-  },
-  {
-    name: "prefix",
-    type: "string",
-    description: "Selector prefix for generated components and directives.",
-    default: "lw",
-    pattern: KEBAB_ID_PATTERN,
-    workspaceOnly: true
-  },
-  {
-    name: "unitTestRunner",
-    type: "string",
-    description: "Test wiring to emit. 'vitest' uses @nx/angular:unit-test; 'none' emits no test target.",
-    choices: ["vitest", "none"],
-    default: "vitest",
-    workspaceOnly: true
-  }
-];
-var APP_OPTION = {
-  name: "app",
-  type: "string",
-  description: "Application to drop into. Inferred when the workspace has exactly one.",
-  workspaceOnly: true
-};
-
 // ../devkit/src/recipes/angular-distribution/scaffold.ts
 function distributionInput(values) {
   return {
@@ -33608,6 +33595,13 @@ var distributionScaffold = {
       description: "Compose into the application already at that path, replacing the bootstrap files this scaffold owns and merging its build targets. Without it an existing project is an error.",
       workspaceOnly: true
     },
+    {
+      name: "prefix",
+      type: "string",
+      description: "Selector prefix the application declares for its components, which a weaver generated into it takes. Defaults to 'app'.",
+      pattern: KEBAB_ID_PATTERN,
+      workspaceOnly: true
+    },
     ...PLACEMENT_OPTIONS
   ],
   build: (values) => generate(angularDistribution, distributionInput(values)),
@@ -33771,6 +33765,12 @@ var weaverScaffold = {
       description: "Import path for the workspace alias. Defaults to the workspace scope plus the project name.",
       workspaceOnly: true
     },
+    {
+      name: "prefix",
+      type: "string",
+      description: "Selector prefix for the generated components: the one the application declares, as the prefix of its project in angular.json or project.json. Read from the workspace where it can be, else 'app'.",
+      pattern: KEBAB_ID_PATTERN
+    },
     APP_OPTION,
     ...PLACEMENT_OPTIONS
   ],
@@ -34570,7 +34570,7 @@ function inputSchema(descriptor) {
 function createMcpServer() {
   const server = new McpServer({
     name: "loomweaver-devkit",
-    version: "0.14.2"
+    version: "0.14.4"
   });
   server.registerTool(
     "list_generators",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loomweaver/mcp",
-  "version": "0.14.2",
+  "version": "0.14.4",
   "description": "LoomWeaver: open-source plugin platform for Angular workbenches. The MCP server: scaffolding and validation as tools, so an AI assistant in any product repo can build weavers without a checkout.",
   "keywords": [
     "loomweaver",