mulmoclaude 0.5.2 → 0.6.0

package/src/plugins/generateImage/View.vue

@@ -1,5 +1,7 @@
 <template>
-  <ImageView v-if="imageResult" :selected-result="imageResult" />
+  <div data-testid="generate-image-view" class="w-full h-full">
+    <ImageView v-if="imageResult" :selected-result="imageResult" />
+  </div>
 </template>
 
 <script setup lang="ts">

package/src/plugins/generateImage/definition.ts

@@ -1,6 +1,8 @@
 import type { ToolDefinition } from "gui-chat-protocol";
 
 export const TOOL_NAME = "generateImage";
+// Endpoint contract is shared with editImages (see
+// `editImages/definition.ts#ImageEndpoints`).
 
 export interface ImageToolData {
   imageData: string;

package/src/plugins/generateImage/index.ts

@@ -1,11 +1,13 @@
 import type { ToolResult } from "gui-chat-protocol";
-import type { ToolPlugin } from "../../tools/types";
+import type { PluginRegistration, ToolPlugin } from "../../tools/types";
 import toolDefinition, { TOOL_NAME } from "./definition";
 import type { ImageToolData } from "./definition";
+import { pluginEndpoints } from "../api";
+import { wrapWithScope } from "../scope";
+import type { ImageEndpoints } from "../editImages/definition";
 import View from "./View.vue";
 import Preview from "./Preview.vue";
 import { apiPost } from "../../utils/api";
-import { API_ROUTES } from "../../config/apiRoutes";
 import { makeUuid } from "../../utils/id";
 
 function createUploadedImageResult(imageData: string, fileName: string, prompt: string): ToolResult<ImageToolData, never> {
@@ -21,7 +23,8 @@ const generateImagePlugin: ToolPlugin<ImageToolData> = {
   toolDefinition,
 
   async execute(_context, args) {
-    const result = await apiPost<ToolResult<ImageToolData>>(API_ROUTES.image.generate, args);
+    const endpoints = pluginEndpoints<ImageEndpoints>("image");
+    const result = await apiPost<ToolResult<ImageToolData>>(endpoints.generate, args);
     if (!result.ok) {
       return {
         toolName: TOOL_NAME,
@@ -49,9 +52,14 @@ const generateImagePlugin: ToolPlugin<ImageToolData> = {
       handleInput: (imageData: string) => createUploadedImageResult(imageData, "clipboard-image.png", ""),
     },
   ],
-  viewComponent: View,
-  previewComponent: Preview,
+  viewComponent: wrapWithScope("image", View),
+  previewComponent: wrapWithScope("image", Preview),
 };
 
 export default generateImagePlugin;
 export { TOOL_NAME };
+
+export const REGISTRATION: PluginRegistration = {
+  toolName: TOOL_NAME,
+  entry: generateImagePlugin,
+};

package/src/plugins/generateImage/meta.ts

@@ -0,0 +1,5 @@
+import { definePluginMeta } from "../meta-types";
+
+export const META = definePluginMeta({
+  toolName: "generateImage",
+});

package/src/plugins/index.ts

@@ -0,0 +1,35 @@
+// Built-in plugin registry — single source of truth for "which
+// in-tree plugins ship in the bundle".
+//
+// Each plugin co-locates its TOOL_NAMES key with its Vue entry by
+// exporting a `REGISTRATION` (singular) or `REGISTRATIONS` (array,
+// for multi-entry plugins like scheduler). The codegen barrel below
+// (`_generated/registrations.ts`) discovers them by scanning
+// `src/plugins/<name>/index.ts`. External-package plugins (mindmap /
+// quiz / present3d) live in `_extras.ts` because they aren't
+// co-located in this source tree.
+//
+// **Auto-generated**. To add a built-in plugin: drop a new
+// `src/plugins/<name>/` directory with an `index.ts` exporting
+// `REGISTRATION` (or `REGISTRATIONS`); `yarn plugins:codegen` (run
+// automatically via `predev` / `prebuild`) picks it up. This file
+// stays unchanged.
+//
+// Runtime-installed plugins (#1043 C-2) live in a separate registry
+// and are merged at lookup time in `src/tools/index.ts:getPlugin`;
+// the array below is build-time-bundled only.
+
+import type { PluginRegistration } from "../tools/types";
+import { GENERATED_PLUGIN_REGISTRATIONS } from "./_generated/registrations";
+import { EXTERNAL_PLUGIN_REGISTRATIONS } from "./_extras";
+
+// `@gui-chat-plugin/weather` is now installed via the user's
+// workspace ledger (`~/mulmoclaude/plugins/plugins.json`) rather
+// than as a build-time bundle. The View loads via the runtime-plugin
+// dynamic-import path; no static import here. (Briefly registered as
+// a preset in `server/plugins/preset-list.ts` — that wedged because
+// users who'd already installed it via the ledger then saw a
+// "name collides" warning on every boot. Until that double-source
+// case is handled cleanly, no presets ship by default.)
+
+export const BUILT_IN_PLUGINS: readonly PluginRegistration[] = [...GENERATED_PLUGIN_REGISTRATIONS, ...EXTERNAL_PLUGIN_REGISTRATIONS];

package/src/plugins/manageRoles/Preview.vue

@@ -15,17 +15,20 @@
 import { ref, watch } from "vue";
 import { useI18n } from "vue-i18n";
 import type { ToolResultComplete } from "gui-chat-protocol/vue";
-
-const { t } = useI18n();
 import type { ManageRolesData, CustomRole } from "./index";
 import { useFreshPluginData } from "../../composables/useFreshPluginData";
-import { API_ROUTES } from "../../config/apiRoutes";
+import { pluginEndpoints } from "../api";
+import type { RolesEndpoints } from "./definition";
+
+const { t } = useI18n();
 
 const props = defineProps<{ result: ToolResultComplete<ManageRolesData> }>();
 const customRoles = ref<CustomRole[]>(props.result.data?.customRoles ?? []);
 
+const endpoints = pluginEndpoints<RolesEndpoints>("roles");
+
 const { refresh } = useFreshPluginData<CustomRole[]>({
-  endpoint: () => API_ROUTES.roles.list,
+  endpoint: () => endpoints.list,
   extract: (json) => (Array.isArray(json) ? (json as CustomRole[]) : null),
   apply: (data) => {
     customRoles.value = data;

package/src/plugins/manageRoles/View.vue

@@ -283,9 +283,9 @@ import { useFreshPluginData } from "../../composables/useFreshPluginData";
 import { useAppApi } from "../../composables/useAppApi";
 import type { ToolResultComplete } from "gui-chat-protocol/vue";
 import type { CustomRole, ManageRolesData } from "./index";
-import { getAllPluginNames } from "../../tools/index";
 import { apiGet, apiPost } from "../../utils/api";
-import { API_ROUTES } from "../../config/apiRoutes";
+import { pluginEndpoints, pluginAllPluginNames } from "../api";
+import type { RolesEndpoints } from "./definition";
 
 const { t } = useI18n();
 
@@ -296,15 +296,17 @@ interface PluginEntry {
 }
 
 // Plugins the user can assign — exclude internal/auto-managed ones
-const EXCLUDED = new Set(["text-response", "switchRole"]);
-const guiPlugins: PluginEntry[] = getAllPluginNames()
+const EXCLUDED = new Set(["text-response"]);
+const guiPlugins: PluginEntry[] = pluginAllPluginNames()
   .filter((name) => !EXCLUDED.has(name))
   .map((name) => ({ name, enabled: true, requiredEnv: [] }));
 
 const availablePlugins = ref<PluginEntry[]>(guiPlugins);
 
+const mcpEndpoints = pluginEndpoints<{ list: string }>("mcpTools");
+
 onMounted(async () => {
-  const result = await apiGet<PluginEntry[]>(API_ROUTES.mcpTools.list);
+  const result = await apiGet<PluginEntry[]>(mcpEndpoints.list);
   if (result.ok) {
     availablePlugins.value = [...guiPlugins, ...result.data];
   }
@@ -321,8 +323,10 @@ const appApi = useAppApi();
 
 const customRoles = ref<CustomRole[]>(props.selectedResult?.data?.customRoles ?? []);
 
+const rolesEndpoints = pluginEndpoints<RolesEndpoints>("roles");
+
 const { refresh: refreshCustomRoles } = useFreshPluginData<CustomRole[]>({
-  endpoint: () => API_ROUTES.roles.list,
+  endpoint: () => rolesEndpoints.list,
   extract: (json) => (Array.isArray(json) ? (json as CustomRole[]) : null),
   apply: (data) => {
     customRoles.value = data;
@@ -403,7 +407,7 @@ function selectRole(role: CustomRole) {
     name: role.name,
     icon: role.icon,
     prompt: role.prompt,
-    selectedPlugins: role.availablePlugins.filter((plugin) => plugin !== "switchRole"),
+    selectedPlugins: [...role.availablePlugins],
     queriesText: (role.queries ?? []).join("\n"),
   };
 }
@@ -417,7 +421,7 @@ interface ManageResult {
 }
 
 async function callManage(body: Record<string, unknown>): Promise<ManageResult> {
-  const result = await apiPost<ManageResult>(API_ROUTES.roles.manage, body);
+  const result = await apiPost<ManageResult>(rolesEndpoints.manage, body);
   if (!result.ok) {
     // Prefer the backend's error message (e.g. validation failure
     // details). Fall back to a status code only when the server didn't

package/src/plugins/manageRoles/definition.ts

@@ -2,6 +2,12 @@ import type { ToolDefinition } from "gui-chat-protocol";
 
 export const TOOL_NAME = "manageRoles";
 
+export interface RolesEndpoints {
+  [key: string]: string;
+  list: string;
+  manage: string;
+}
+
 const toolDefinition: ToolDefinition = {
   type: "function",
   name: TOOL_NAME,

package/src/plugins/manageRoles/index.ts

@@ -1,11 +1,11 @@
 import type { ToolPlugin } from "../../tools/types";
 import type { ToolResult } from "gui-chat-protocol";
-import toolDefinition from "./definition";
-import { TOOL_NAME } from "./definition";
+import toolDefinition, { TOOL_NAME, type RolesEndpoints } from "./definition";
+import { pluginEndpoints } from "../api";
+import { wrapWithScope } from "../scope";
 import View from "./View.vue";
 import Preview from "./Preview.vue";
 import { apiPost } from "../../utils/api";
-import { API_ROUTES } from "../../config/apiRoutes";
 import { makeUuid } from "../../utils/id";
 
 export interface CustomRole {
@@ -24,7 +24,8 @@ export interface ManageRolesData {
 const manageRolesPlugin: ToolPlugin = {
   toolDefinition,
   async execute(_context, args) {
-    const result = await apiPost<ToolResult<ManageRolesData>>(API_ROUTES.roles.manage, args);
+    const endpoints = pluginEndpoints<RolesEndpoints>("roles");
+    const result = await apiPost<ToolResult<ManageRolesData>>(endpoints.manage, args);
     if (!result.ok) {
       return {
         toolName: TOOL_NAME,
@@ -40,8 +41,8 @@ const manageRolesPlugin: ToolPlugin = {
   },
   isEnabled: () => true,
   generatingMessage: "Managing roles…",
-  viewComponent: View,
-  previewComponent: Preview,
+  viewComponent: wrapWithScope("roles", View),
+  previewComponent: wrapWithScope("roles", Preview),
 };
 
 export default manageRolesPlugin;

package/src/plugins/manageSkills/View.vue

@@ -147,7 +147,9 @@ import type { ToolResultComplete } from "gui-chat-protocol/vue";
 import type { ManageSkillsData, SkillSummary } from "./index";
 import { useAppApi } from "../../composables/useAppApi";
 import { apiGet, apiPut, apiDelete } from "../../utils/api";
-import { API_ROUTES } from "../../config/apiRoutes";
+import { pluginEndpoints } from "../api";
+import { buildRouteUrl } from "../meta-types";
+import type { SkillsEndpoints } from "./definition";
 
 const { t } = useI18n();
 
@@ -197,11 +199,13 @@ watch(
 
 const listError = ref<string | null>(null);
 
+const endpoints = pluginEndpoints<SkillsEndpoints>("skills");
+
 // Standalone mode: if no selectedResult was passed, fetch the skill
 // list from the API on mount so the view is populated.
 onMounted(async () => {
   if (props.selectedResult || skills.value.length > 0) return;
-  const response = await apiGet<{ skills: SkillSummary[] }>(API_ROUTES.skills.list);
+  const response = await apiGet<{ skills: SkillSummary[] }>(endpoints.list.url);
   if (!response.ok) {
     listError.value = t("pluginManageSkills.errListFailed", { error: response.error });
     return;
@@ -229,7 +233,7 @@ watch(
     editing.value = false;
     detailLoading.value = true;
     detailError.value = null;
-    const response = await apiGet<{ skill: SkillDetail }>(API_ROUTES.skills.detail.replace(":name", encodeURIComponent(name)));
+    const response = await apiGet<{ skill: SkillDetail }>(buildRouteUrl(endpoints.detail, { name }));
     if (selectedName.value !== name) {
       // Selection changed while this request was in flight — drop it.
       return;
@@ -258,10 +262,10 @@ function cancelEdit(): void {
 
 async function saveEdit(): Promise<void> {
   if (!detail.value) return;
-  const name = detail.value.name;
+  const { name } = detail.value;
   saving.value = true;
   detailError.value = null;
-  const result = await apiPut<{ updated: boolean; path: string }>(API_ROUTES.skills.update.replace(":name", encodeURIComponent(name)), {
+  const result = await apiPut<{ updated: boolean; path: string }>(buildRouteUrl(endpoints.update, { name }), {
     description: editDescription.value,
     body: editBody.value,
   });
@@ -304,12 +308,12 @@ function runSkill(): void {
 // since the action is reversible by re-saving via the conversation.
 async function deleteSkill(): Promise<void> {
   if (!detail.value || detail.value.source !== "project") return;
-  const name = detail.value.name;
+  const { name } = detail.value;
   if (!window.confirm(t("pluginManageSkills.confirmDelete", { name }))) {
     return;
   }
   deleting.value = true;
-  const result = await apiDelete<unknown>(API_ROUTES.skills.remove.replace(":name", encodeURIComponent(name)));
+  const result = await apiDelete<unknown>(buildRouteUrl(endpoints.remove, { name }));
   deleting.value = false;
   if (!result.ok) {
     detailError.value = result.error || t("pluginManageSkills.errDeleteFailed");

package/src/plugins/manageSkills/definition.ts

@@ -1,6 +1,9 @@
 import type { ToolDefinition } from "gui-chat-protocol";
+import { META } from "./meta";
+import type { ResolvedRoute } from "../meta-types";
 
-export const TOOL_NAME = "manageSkills";
+export const TOOL_NAME = META.toolName;
+export type SkillsEndpoints = { readonly [K in keyof typeof META.apiRoutes]: ResolvedRoute };
 
 const toolDefinition: ToolDefinition = {
   type: "function",

package/src/plugins/manageSkills/index.ts

@@ -1,9 +1,10 @@
-import type { ToolPlugin } from "../../tools/types";
-import toolDefinition, { TOOL_NAME } from "./definition";
+import type { PluginRegistration, ToolPlugin } from "../../tools/types";
+import toolDefinition, { TOOL_NAME, type SkillsEndpoints } from "./definition";
+import { pluginEndpoints } from "../api";
+import { wrapWithScope } from "../scope";
 import View from "./View.vue";
 import Preview from "./Preview.vue";
 import { apiGet } from "../../utils/api";
-import { API_ROUTES } from "../../config/apiRoutes";
 import { makeUuid } from "../../utils/id";
 
 export interface SkillSummary {
@@ -22,7 +23,8 @@ const manageSkillsPlugin: ToolPlugin<ManageSkillsData> = {
     // Claude invokes this tool to show the user their skills list.
     // The server exposes GET /api/skills (discovery + merge); we just
     // shape it for the View component.
-    const result = await apiGet<{ skills: SkillSummary[] }>(API_ROUTES.skills.list);
+    const endpoints = pluginEndpoints<SkillsEndpoints>("skills");
+    const result = await apiGet<{ skills: SkillSummary[] }>(endpoints.list.url);
     if (!result.ok) {
       return {
         toolName: TOOL_NAME,
@@ -31,7 +33,7 @@ const manageSkillsPlugin: ToolPlugin<ManageSkillsData> = {
         error: `Failed to load skills: ${result.error}`,
       };
     }
-    const skills = result.data.skills;
+    const { skills } = result.data;
     return {
       toolName: TOOL_NAME,
       uuid: makeUuid(),
@@ -42,9 +44,14 @@ const manageSkillsPlugin: ToolPlugin<ManageSkillsData> = {
   },
   isEnabled: () => true,
   generatingMessage: "Loading skills…",
-  viewComponent: View,
-  previewComponent: Preview,
+  viewComponent: wrapWithScope("skills", View),
+  previewComponent: wrapWithScope("skills", Preview),
 };
 
 export default manageSkillsPlugin;
 export { TOOL_NAME };
+
+export const REGISTRATION: PluginRegistration = {
+  toolName: TOOL_NAME,
+  entry: manageSkillsPlugin,
+};

package/src/plugins/manageSkills/meta.ts

@@ -0,0 +1,21 @@
+import { definePluginMeta } from "../meta-types";
+
+export const META = definePluginMeta({
+  toolName: "manageSkills",
+  apiNamespace: "skills",
+  apiRoutes: {
+    /** GET /api/skills — list every available skill (user + project). */
+    list: { method: "GET", path: "" },
+    /** GET /api/skills/:name — read one skill's body + frontmatter. */
+    detail: { method: "GET", path: "/:name" },
+    /** POST /api/skills — create a new project-scope skill. The MCP
+     *  bridge posts here. */
+    create: { method: "POST", path: "" },
+    /** PUT /api/skills/:name — overwrite an existing project-scope
+     *  skill. */
+    update: { method: "PUT", path: "/:name" },
+    /** DELETE /api/skills/:name — delete a project-scope skill. */
+    remove: { method: "DELETE", path: "/:name" },
+  },
+  mcpDispatch: "create",
+});

package/src/plugins/manageSource/definition.ts

@@ -1,6 +1,9 @@
 import type { ToolDefinition } from "gui-chat-protocol";
+import { META } from "./meta";
+import type { ResolvedRoute } from "../meta-types";
 
-export const TOOL_NAME = "manageSource";
+export const TOOL_NAME = META.toolName;
+export type SourcesEndpoints = { readonly [K in keyof typeof META.apiRoutes]: ResolvedRoute };
 
 const toolDefinition: ToolDefinition = {
   type: "function",

package/src/plugins/manageSource/index.ts

@@ -1,10 +1,11 @@
-import type { ToolPlugin } from "../../tools/types";
+import type { PluginRegistration, ToolPlugin } from "../../tools/types";
 import type { ToolResult } from "gui-chat-protocol";
-import toolDefinition, { TOOL_NAME } from "./definition";
+import toolDefinition, { TOOL_NAME, type SourcesEndpoints } from "./definition";
+import { pluginEndpoints } from "../api";
+import { wrapWithScope } from "../scope";
 import View from "./View.vue";
 import Preview from "./Preview.vue";
-import { apiPost } from "../../utils/api";
-import { API_ROUTES } from "../../config/apiRoutes";
+import { apiCall } from "../../utils/api";
 import { makeUuid } from "../../utils/id";
 
 // Mirrors server/sources/types.ts#Source. Re-declared here so the
@@ -43,7 +44,9 @@ export interface ManageSourceData {
 const manageSourcePlugin: ToolPlugin<ManageSourceData> = {
   toolDefinition,
   async execute(_context, args) {
-    const result = await apiPost<ToolResult<ManageSourceData>>(API_ROUTES.sources.manage, args);
+    const endpoints = pluginEndpoints<SourcesEndpoints>("sources");
+    const { method, url } = endpoints.manage;
+    const result = await apiCall<ToolResult<ManageSourceData>>(url, { method, body: args });
     if (!result.ok) {
       return {
         toolName: TOOL_NAME,
@@ -59,9 +62,14 @@ const manageSourcePlugin: ToolPlugin<ManageSourceData> = {
   },
   isEnabled: () => true,
   generatingMessage: "Managing sources…",
-  viewComponent: View,
-  previewComponent: Preview,
+  viewComponent: wrapWithScope("sources", View),
+  previewComponent: wrapWithScope("sources", Preview),
 };
 
 export default manageSourcePlugin;
 export { TOOL_NAME };
+
+export const REGISTRATION: PluginRegistration = {
+  toolName: TOOL_NAME,
+  entry: manageSourcePlugin,
+};

package/src/plugins/manageSource/meta.ts

@@ -0,0 +1,21 @@
+import { definePluginMeta } from "../meta-types";
+
+export const META = definePluginMeta({
+  toolName: "manageSource",
+  apiNamespace: "sources",
+  apiRoutes: {
+    /** GET /api/sources — list every registered source. */
+    list: { method: "GET", path: "" },
+    /** POST /api/sources — register a new source. */
+    create: { method: "POST", path: "" },
+    /** DELETE /api/sources/:slug — remove a registered source. */
+    remove: { method: "DELETE", path: "/:slug" },
+    /** POST /api/sources/rebuild — re-run every fetcher, refresh
+     *  archives. */
+    rebuild: { method: "POST", path: "/rebuild" },
+    /** POST /api/sources/manage — single-action dispatch route used
+     *  by the MCP bridge. */
+    manage: { method: "POST", path: "/manage" },
+  },
+  mcpDispatch: "manage",
+});

package/src/plugins/markdown/Preview.vue

@@ -15,7 +15,9 @@ import type { ToolResult } from "gui-chat-protocol";
 import { isFilePath, type MarkdownToolData } from "./definition";
 import { extractFirstH1 } from "../../utils/markdown/extractFirstH1";
 import { apiGet } from "../../utils/api";
-import { API_ROUTES } from "../../config/apiRoutes";
+import { pluginEndpoints } from "../api";
+
+const filesEndpoints = pluginEndpoints<{ content: string }>("files");
 
 const props = defineProps<{
   result: ToolResult<MarkdownToolData>;
@@ -29,7 +31,7 @@ async function fetchContent(): Promise<void> {
     fetchedContent.value = "";
     return;
   }
-  const result = await apiGet<{ content?: string }>(API_ROUTES.files.content, {
+  const result = await apiGet<{ content?: string }>(filesEndpoints.content, {
     path: raw,
   });
   if (!result.ok) {
@@ -42,6 +44,12 @@ async function fetchContent(): Promise<void> {
 fetchContent();
 watch(() => props.result.data?.markdown, fetchContent);
 
+const resolvedMarkdown = computed(() => {
+  const raw = props.result.data?.markdown;
+  if (!raw) return "";
+  return isFilePath(raw) ? fetchedContent.value : raw;
+});
+
 const displayTitle = computed(() => {
   if (props.result.title) {
     return props.result.title;
@@ -54,12 +62,6 @@ const displayTitle = computed(() => {
   return "Markdown Document";
 });
 
-const resolvedMarkdown = computed(() => {
-  const raw = props.result.data?.markdown;
-  if (!raw) return "";
-  return isFilePath(raw) ? fetchedContent.value : raw;
-});
-
 function extractPreview(markdown: string): string {
   const lines = markdown
     .split("\n")