mulmoclaude 0.5.2 → 0.6.0

package/src/main.ts

@@ -5,6 +5,13 @@ import { installGuards } from "./router/guards";
 import i18n from "./lib/vue-i18n";
 import { setAuthToken } from "./utils/api";
 import { readAuthTokenFromMeta } from "./utils/dom/authTokenMeta";
+import { loadRuntimePlugins } from "./tools/runtimeLoader";
+import { startDevPluginReloadListener } from "./composables/useDevPluginReload";
+import { installHostContext, type EndpointRegistry } from "./plugins/api";
+import { API_ROUTES } from "./config/apiRoutes";
+import { BUILTIN_ROLE_IDS } from "./config/roles";
+import { PAGE_ROUTES } from "./router";
+import { getAllPluginNames } from "./tools";
 import "./index.css";
 import "material-icons/iconfont/material-icons.css";
 import "material-symbols/outlined.css";
@@ -20,6 +27,84 @@ import.meta.glob(["../node_modules/@gui-chat-plugin/*/dist/style.css", "../node_
 // server isn't running.
 setAuthToken(readAuthTokenFromMeta());
 
+// Plugin DI: wire the host's URL map / role IDs / page-name
+// constants / plugin registry into the plugin-side resolver BEFORE
+// app.mount(). Plugin code reads from this registry via the
+// `pluginEndpoints` / `pluginBuiltinRoleIds` / `pluginPageRoute` /
+// `pluginAllPluginNames` helpers in `./plugins/api`. Plugin source
+// has zero direct dependency on `./config/*` — host wires them in
+// here, which is the only place that knows both ends.
+//
+// The endpoint registry is built explicitly per-plugin so each
+// plugin's scope name is stable regardless of where the host
+// happens to nest the URLs in the apiRoutes tree. Plugin-owned
+// scopes (#1141) match the META's `apiNamespace`; host-shared
+// scopes (`files`, `imageStore`, `mcpTools`, …) carry plain string
+// URLs the host owns directly.
+const pluginEndpointRegistry: EndpointRegistry = {
+  // Plugin-owned top-level groups. Each value is a `Record<string,
+  // ResolvedRoute>` produced by the host aggregator from the
+  // plugin's META `{ apiNamespace, apiRoutes }`.
+  // todos: removed (#1145) — runtime plugin uses
+  // `/api/plugins/runtime/<pkg>/dispatch` directly via
+  // `runtime.dispatch`, so no entry in the endpoint registry.
+  scheduler: API_ROUTES.scheduler,
+  mulmoScript: API_ROUTES.mulmoScript,
+  skills: API_ROUTES.skills,
+  sources: API_ROUTES.sources,
+  html: API_ROUTES.html,
+  chart: API_ROUTES.chart,
+  accounting: API_ROUTES.accounting,
+  canvas: API_ROUTES.canvas,
+  form: API_ROUTES.form,
+  markdown: API_ROUTES.markdown,
+  spreadsheet: API_ROUTES.spreadsheet,
+  // Host-owned groups. `wiki` / `roles` live in `HOST_API_ROUTES`
+  // as plain string URLs; `image` is a host-shared image store
+  // with both a `generate`/`edit` plugin route and an `update`
+  // endpoint shared with canvas. Plugins read these as
+  // `Record<string, string>` via `pluginEndpoints<HostShape>`.
+  wiki: API_ROUTES.wiki,
+  roles: API_ROUTES.roles,
+  image: API_ROUTES.image,
+  // Cross-cutting host-shared services that plugins reach for
+  // (read workspace files, look up MCP tools, save canvas image
+  // back to disk). Exposed as their own scopes so plugins don't
+  // import `API_ROUTES.files` / `image.update` / `mcpTools` directly.
+  files: API_ROUTES.files,
+  imageStore: { update: API_ROUTES.image.update },
+  mcpTools: { list: API_ROUTES.mcpTools.list },
+};
+
+installHostContext({
+  endpoints: pluginEndpointRegistry,
+  builtinRoleIds: BUILTIN_ROLE_IDS,
+  pageRoutes: PAGE_ROUTES,
+  getAllPluginNames,
+});
+
+// Runtime-loaded plugins (#1043 C-2). Fire-and-forget: kick off the
+// list fetch + dynamic imports immediately but do NOT block mount.
+// Static plugins are bundled and ready synchronously; runtime
+// plugins fill in over the next ~100ms while the app is rendering
+// its first paint. By the time the LLM actually calls a runtime
+// tool (which requires at least one user message round-trip), the
+// registry is fully populated.
+//
+// Awaiting here would delay first paint even when there are no
+// runtime plugins installed (every workspace today), and it shifted
+// the timing of `page.goto("/chat")` enough to break the
+// today-journal-button E2E spec, which captured the URL before
+// app mount completed.
+loadRuntimePlugins().catch((err: unknown) => {
+  console.warn("[runtime-plugin] boot loader threw", err);
+});
+
+// PR3 of #1159: when `--dev-plugin` is in use and the watched dist/
+// changes, this listener reloads the page. No-ops in production
+// because the server only publishes when a dev plugin is loaded.
+startDevPluginReloadListener();
+
 installGuards(router);
 
 const app = createApp(App);

package/src/plugins/_extras.ts

@@ -0,0 +1,58 @@
+// Manual extras the codegen can't auto-discover. These are the
+// registrations and server bindings that don't fit the standard
+// shape (one plugin dir → one META with apiNamespace+mcpDispatch).
+//
+// Two reasons something lives here:
+//
+//   1. **Cross-namespace endpoint** — editImages and generateImage
+//      share the host-owned `/api/image/*` routes (so their META
+//      is toolName-only). The codegen omits them from
+//      `_generated/server-bindings.ts`; we wire the bindings here
+//      against the host record directly.
+//   2. **External npm-distributed plugin** — mindmap, quiz, present3d
+//      live in node_modules; they don't have a `src/plugins/<name>/`
+//      directory the codegen can scan, so the registration AND the
+//      binding both come from this file.
+//
+// New built-in plugins shouldn't land here — keep the standard shape
+// (one dir, one META with apiNamespace+mcpDispatch). The extras list
+// is meant to be small and stable.
+
+import type { PluginRegistration } from "../tools/types";
+import type { ServerPluginBinding } from "./server-bindings-types";
+import { TOOL_NAMES } from "../config/toolNames";
+import { API_ROUTES } from "../config/apiRoutes";
+
+import { TOOL_DEFINITION as createMindMapDef } from "@gui-chat-plugin/mindmap";
+import { TOOL_DEFINITION as putQuestionsDef } from "@mulmochat-plugin/quiz";
+import { TOOL_DEFINITION as present3DDef } from "@gui-chat-plugin/present3d";
+
+import generateImageDef from "./generateImage/definition";
+import editImagesDef from "./editImages/definition";
+
+import MindMapPlugin from "@gui-chat-plugin/mindmap/vue";
+import QuizPlugin from "@mulmochat-plugin/quiz/vue";
+import Present3DPlugin from "@gui-chat-plugin/present3d/vue";
+
+/** Externally-distributed plugin registrations. The codegen barrel
+ *  in `_generated/registrations.ts` only knows about plugins with a
+ *  local directory under `src/plugins/`; these npm packages need
+ *  hand-wired entries. */
+export const EXTERNAL_PLUGIN_REGISTRATIONS: readonly PluginRegistration[] = [
+  { toolName: TOOL_NAMES.createMindMap, entry: MindMapPlugin.plugin },
+  { toolName: TOOL_NAMES.putQuestions, entry: QuizPlugin.plugin },
+  { toolName: TOOL_NAMES.present3D, entry: Present3DPlugin.plugin },
+];
+
+/** MCP bindings that don't follow the standard
+ *  `mcpEndpoint(meta)` resolution: image plugins reach into the
+ *  host-owned `/api/image/*` routes; external npm plugins use
+ *  legacy `/api/plugins/{mindmap,quiz,present3d}` paths from
+ *  `HOST_API_ROUTES.plugins`. */
+export const EXTRA_SERVER_BINDINGS: readonly ServerPluginBinding[] = [
+  { def: generateImageDef, endpoint: API_ROUTES.image.generate },
+  { def: editImagesDef, endpoint: API_ROUTES.image.edit },
+  { def: createMindMapDef, endpoint: API_ROUTES.plugins.mindmap },
+  { def: putQuestionsDef, endpoint: API_ROUTES.plugins.quiz },
+  { def: present3DDef, endpoint: API_ROUTES.plugins.present3d },
+];

package/src/plugins/_generated/metas.ts

@@ -0,0 +1,42 @@
+// AUTO-GENERATED by `scripts/codegen-plugin-barrels.ts`. DO NOT EDIT.
+// Run `yarn plugins:codegen` after adding/removing/renaming a plugin.
+
+import type { PluginMeta } from "../meta-types";
+
+import { META as accountingMeta } from "../accounting/meta";
+import { META as canvasMeta } from "../canvas/meta";
+import { META as chartMeta } from "../chart/meta";
+import { META as editImagesMeta } from "../editImages/meta";
+import { META as generateImageMeta } from "../generateImage/meta";
+import { META as manageSkillsMeta } from "../manageSkills/meta";
+import { META as manageSourceMeta } from "../manageSource/meta";
+import { META as markdownMeta } from "../markdown/meta";
+import { META as presentFormMeta } from "../presentForm/meta";
+import { META as presentHtmlMeta } from "../presentHtml/meta";
+import { META as presentMulmoScriptMeta } from "../presentMulmoScript/meta";
+import { META as schedulerAutomationsMeta } from "../scheduler/automationsMeta";
+import { META as schedulerCalendarMeta } from "../scheduler/calendarMeta";
+import { META as spreadsheetMeta } from "../spreadsheet/meta";
+import { META as wikiMeta } from "../wiki/meta";
+
+/** All plugin METAs the codegen discovered under `src/plugins/<name>/{meta,*Meta}.ts`.
+ *  Combined with `_extras` (if any) inside `src/plugins/metas.ts`. */
+export const GENERATED_PLUGIN_METAS = [
+  accountingMeta,
+  canvasMeta,
+  chartMeta,
+  editImagesMeta,
+  generateImageMeta,
+  manageSkillsMeta,
+  manageSourceMeta,
+  markdownMeta,
+  presentFormMeta,
+  presentHtmlMeta,
+  presentMulmoScriptMeta,
+  schedulerAutomationsMeta,
+  schedulerCalendarMeta,
+  spreadsheetMeta,
+  wikiMeta,
+] as const satisfies readonly PluginMeta[];
+
+export type GeneratedPluginMetas = typeof GENERATED_PLUGIN_METAS;

package/src/plugins/_generated/registrations.ts

@@ -0,0 +1,44 @@
+// AUTO-GENERATED by `scripts/codegen-plugin-barrels.ts`. DO NOT EDIT.
+// Run `yarn plugins:codegen` after adding/removing/renaming a plugin.
+
+import type { PluginRegistration } from "../../tools/types";
+
+import { REGISTRATION as accountingRegistration } from "../accounting";
+import { REGISTRATION as canvasRegistration } from "../canvas";
+import { REGISTRATION as chartRegistration } from "../chart";
+import { REGISTRATION as editImagesRegistration } from "../editImages";
+import { REGISTRATION as generateImageRegistration } from "../generateImage";
+import { REGISTRATION as manageSkillsRegistration } from "../manageSkills";
+import { REGISTRATION as manageSourceRegistration } from "../manageSource";
+import { REGISTRATION as markdownRegistration } from "../markdown";
+import { REGISTRATION as presentFormRegistration } from "../presentForm";
+import { REGISTRATION as presentHtmlRegistration } from "../presentHtml";
+import { REGISTRATION as presentMulmoScriptRegistration } from "../presentMulmoScript";
+import { REGISTRATIONS as schedulerRegistrations } from "../scheduler";
+import { REGISTRATION as skillRegistration } from "../skill";
+import { REGISTRATION as spreadsheetRegistration } from "../spreadsheet";
+import { REGISTRATION as textResponseRegistration } from "../textResponse";
+import { REGISTRATION as wikiRegistration } from "../wiki";
+
+/** All plugin registrations the codegen discovered under `src/plugins/<name>/index.ts`.
+ *  Single-entry plugins export `REGISTRATION`; multi-entry plugins (scheduler)
+ *  export `REGISTRATIONS` and are spread. Combined with `_extras` inside
+ *  `src/plugins/index.ts`. */
+export const GENERATED_PLUGIN_REGISTRATIONS: readonly PluginRegistration[] = [
+  accountingRegistration,
+  canvasRegistration,
+  chartRegistration,
+  editImagesRegistration,
+  generateImageRegistration,
+  manageSkillsRegistration,
+  manageSourceRegistration,
+  markdownRegistration,
+  presentFormRegistration,
+  presentHtmlRegistration,
+  presentMulmoScriptRegistration,
+  ...schedulerRegistrations,
+  skillRegistration,
+  spreadsheetRegistration,
+  textResponseRegistration,
+  wikiRegistration,
+];

package/src/plugins/_generated/server-bindings.ts

@@ -0,0 +1,47 @@
+// AUTO-GENERATED by `scripts/codegen-plugin-barrels.ts`. DO NOT EDIT.
+// Run `yarn plugins:codegen` after adding/removing/renaming a plugin.
+
+import type { ServerPluginBinding } from "../server-bindings-types";
+import { mcpEndpoint } from "../server-bindings-types";
+
+import accountingDef from "../accounting/definition";
+import canvasDef from "../canvas/definition";
+import chartDef from "../chart/definition";
+import manageSkillsDef from "../manageSkills/definition";
+import manageSourceDef from "../manageSource/definition";
+import markdownDef from "../markdown/definition";
+import presentFormDef from "../presentForm/definition";
+import presentHtmlDef from "../presentHtml/definition";
+import presentMulmoScriptDef from "../presentMulmoScript/definition";
+import schedulerAutomationsDef from "../scheduler/automationsDefinition";
+import schedulerCalendarDef from "../scheduler/calendarDefinition";
+import spreadsheetDef from "../spreadsheet/definition";
+import { META as accountingMeta } from "../accounting/meta";
+import { META as canvasMeta } from "../canvas/meta";
+import { META as chartMeta } from "../chart/meta";
+import { META as manageSkillsMeta } from "../manageSkills/meta";
+import { META as manageSourceMeta } from "../manageSource/meta";
+import { META as markdownMeta } from "../markdown/meta";
+import { META as presentFormMeta } from "../presentForm/meta";
+import { META as presentHtmlMeta } from "../presentHtml/meta";
+import { META as presentMulmoScriptMeta } from "../presentMulmoScript/meta";
+import { META as schedulerCalendarMeta } from "../scheduler/calendarMeta";
+import { META as spreadsheetMeta } from "../spreadsheet/meta";
+
+/** All plugin MCP bindings the codegen discovered for plugins whose META declares
+ *  both `apiNamespace` and `mcpDispatch`. Plugins without those fields (image plugins,
+ *  external npm plugins) live in `_extras.ts`. Combined inside `src/plugins/server.ts`. */
+export const GENERATED_SERVER_BINDINGS: readonly ServerPluginBinding[] = [
+  { def: accountingDef, endpoint: mcpEndpoint(accountingMeta) },
+  { def: canvasDef, endpoint: mcpEndpoint(canvasMeta) },
+  { def: chartDef, endpoint: mcpEndpoint(chartMeta) },
+  { def: manageSkillsDef, endpoint: mcpEndpoint(manageSkillsMeta) },
+  { def: manageSourceDef, endpoint: mcpEndpoint(manageSourceMeta) },
+  { def: markdownDef, endpoint: mcpEndpoint(markdownMeta) },
+  { def: presentFormDef, endpoint: mcpEndpoint(presentFormMeta) },
+  { def: presentHtmlDef, endpoint: mcpEndpoint(presentHtmlMeta) },
+  { def: presentMulmoScriptDef, endpoint: mcpEndpoint(presentMulmoScriptMeta) },
+  { def: schedulerAutomationsDef, endpoint: mcpEndpoint(schedulerCalendarMeta) },
+  { def: schedulerCalendarDef, endpoint: mcpEndpoint(schedulerCalendarMeta) },
+  { def: spreadsheetDef, endpoint: mcpEndpoint(spreadsheetMeta) },
+];

package/src/plugins/accounting/Preview.vue

@@ -0,0 +1,106 @@
+<template>
+  <!-- Compact inline summary for non-openBook tool results. The
+       openBook envelope routes to View.vue (full app) instead of
+       this component; everything that lands here is a
+       compact-result action (addEntries, getReport, …). -->
+  <div class="text-sm text-gray-700" data-testid="accounting-preview">
+    <span class="material-icons text-base align-middle mr-1">account_balance</span>
+    <span>{{ summary }}</span>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed } from "vue";
+import { useI18n } from "vue-i18n";
+
+const { t } = useI18n();
+
+const props = defineProps<{ data?: unknown; jsonData?: Record<string, unknown> }>();
+
+interface BalanceSheetSection {
+  type: string;
+  total?: number;
+}
+interface BalanceSheetLike {
+  balanceSheet?: { asOf?: string; sections?: BalanceSheetSection[]; imbalance?: number };
+}
+interface ProfitLossLike {
+  profitLoss?: { from?: string; to?: string; netIncome?: number };
+}
+interface EntriesLike {
+  entries?: { id?: string; date?: string }[];
+}
+interface BookLike {
+  book?: { id?: string; name?: string };
+}
+
+function formatAmount(value: number): string {
+  return value.toLocaleString(undefined, { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+}
+
+// Each summarise* helper returns null when its branch doesn't apply,
+// keeping the dispatch in `summary` linear (no nested if-trees).
+
+function summariseError(json: Record<string, unknown>): string | null {
+  const { error } = json as { error?: unknown };
+  if (typeof error !== "string") return null;
+  return t("pluginAccounting.previewError", { error });
+}
+
+function summariseEntry(json: Record<string, unknown>): string | null {
+  // addEntries returns `{ entries: [...] }`. The compact preview
+  // card shows one date — use the first entry's so single-entry
+  // batches (the common case from the manual UI) read naturally
+  // and multi-entry batches still anchor to a meaningful date.
+  const { entries } = json as EntriesLike;
+  if (!Array.isArray(entries) || entries.length === 0) return null;
+  const [first] = entries;
+  if (!first?.id || !first?.date) return null;
+  return t("pluginAccounting.preview.entry", { date: first.date });
+}
+
+function summarisePl(json: Record<string, unknown>): string | null {
+  const { profitLoss } = json as ProfitLossLike;
+  if (!profitLoss || typeof profitLoss.netIncome !== "number") return null;
+  return t("pluginAccounting.preview.pl", {
+    from: profitLoss.from ?? "?",
+    to: profitLoss.to ?? "?",
+    net: formatAmount(profitLoss.netIncome),
+  });
+}
+
+function summariseBs(json: Record<string, unknown>): string | null {
+  const { balanceSheet } = json as BalanceSheetLike;
+  if (!balanceSheet?.asOf || !balanceSheet.sections) return null;
+  const assets = balanceSheet.sections.find((section) => section.type === "asset");
+  return t("pluginAccounting.preview.bs", {
+    date: balanceSheet.asOf,
+    assets: assets ? formatAmount(assets.total ?? 0) : "?",
+  });
+}
+
+function summariseBook(json: Record<string, unknown>): string | null {
+  const { book } = json as BookLike;
+  if (!book?.id || !book?.name) return null;
+  return t("pluginAccounting.preview.bookCreated", { name: book.name, id: book.id });
+}
+
+function summariseFallback(json: Record<string, unknown>): string {
+  const { bookId } = json as { bookId?: unknown };
+  if (typeof bookId === "string") return t("pluginAccounting.previewSummary", { bookId });
+  return t("pluginAccounting.previewGeneric");
+}
+
+function asObject(value: unknown): Record<string, unknown> {
+  // Some renderers pass the structured payload via `data`, others
+  // via `jsonData`. Accept either so a tool-result like
+  // `{ entry: ... }` resolves to the right summariser regardless
+  // of which prop the host harness picks.
+  return value && typeof value === "object" ? (value as Record<string, unknown>) : {};
+}
+
+const summary = computed<string>(() => {
+  const json = { ...asObject(props.data), ...asObject(props.jsonData) };
+  return summariseError(json) ?? summariseEntry(json) ?? summarisePl(json) ?? summariseBs(json) ?? summariseBook(json) ?? summariseFallback(json);
+});
+</script>