mulmoclaude 0.5.2 → 0.6.0

package/server/workspace/workspace.ts

@@ -3,12 +3,14 @@ import { copyFileSync, existsSync, mkdirSync, readdirSync } from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
 import { log } from "../system/logger/index.js";
-import { EAGER_WORKSPACE_DIRS, WORKSPACE_FILES, WORKSPACE_PATHS, workspacePath } from "./paths.js";
-import { existsInWorkspace, writeWorkspaceTextSync } from "../utils/files/workspace-io.js";
+import { EAGER_WORKSPACE_DIRS, WORKSPACE_PATHS, workspacePath } from "./paths.js";
+import { readWorkspaceTextSync, writeWorkspaceTextSync } from "../utils/files/workspace-io.js";
 import { loadCustomDirs, ensureCustomDirs } from "./custom-dirs.js";
+import { syncPresetSkills } from "./skills-preset.js";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const TEMPLATES_DIR = path.join(__dirname, "helps");
+const SKILLS_PRESET_SOURCE_DIR = path.join(__dirname, "skills-preset");
 
 // Re-exported so existing callers (`import { workspacePath } from
 // "./workspace.js"`) keep working. See workspace-paths.ts for the
@@ -24,10 +26,14 @@ export function initWorkspace(): string {
     mkdirSync(WORKSPACE_PATHS[key], { recursive: true });
   }
 
-  // Create memory.md if it doesn't exist
-  if (!existsInWorkspace(WORKSPACE_FILES.memory)) {
-    writeWorkspaceTextSync(WORKSPACE_FILES.memory, "# Memory\n\nDistilled facts about you and your work.\n");
-  }
+  // Ensure the typed-memory directory exists (#1029). Individual
+  // entry files are written by the agent or by the legacy-memory
+  // migration; init just guarantees the directory is there so the
+  // reader and migration both have a place to write to. The legacy
+  // `conversations/memory.md` is no longer auto-created — migration
+  // converts it on first start and the new layout becomes the source
+  // of truth thereafter.
+  mkdirSync(WORKSPACE_PATHS.memoryDir, { recursive: true });
 
   // Always sync all files from server/helps/ into workspace/helps/
   mkdirSync(WORKSPACE_PATHS.helps, { recursive: true });
@@ -35,15 +41,23 @@ export function initWorkspace(): string {
     copyFileSync(path.join(TEMPLATES_DIR, file), path.join(WORKSPACE_PATHS.helps, file));
   }
 
+  // Sync preset skills (#1210) from server/workspace/skills-preset/
+  // into <workspaceRoot>/.claude/skills/. Only `mc-*` slugs are
+  // touched — user-authored skills coexist untouched. Retired
+  // presets (no longer in source) are removed from the workspace.
+  syncPresetSkills({
+    sourceDir: SKILLS_PRESET_SOURCE_DIR,
+    destDir: WORKSPACE_PATHS.claudeSkills,
+    onInfo: (message, data) => log.info("skills-preset", message, data),
+    onWarn: (message, data) => log.warn("skills-preset", message, data),
+  });
+
   // Create .gitignore if missing. The workspace is a git repo for
   // version-tracking user data, but cloned dev repos under github/
-  // have their own .git and shouldn't be committed (#256).
-  if (!existsInWorkspace(".gitignore")) {
-    writeWorkspaceTextSync(
-      ".gitignore",
-      ["# Cloned repositories have their own .git — don't nest", "github/", "", "# Auth token (regenerated each startup)", ".session-token", ""].join("\n"),
-    );
-  }
+  // have their own .git and shouldn't be committed (#256). Runtime
+  // files (`.session-token`, `.server-port`) are regenerated on
+  // every startup and should never be committed (#917).
+  ensureWorkspaceGitignore();
 
   // User-defined custom directories (#239)
   const customDirs = loadCustomDirs();
@@ -64,3 +78,51 @@ export function initWorkspace(): string {
   log.info("workspace", "ready", { workspacePath });
   return workspacePath;
 }
+
+export const REQUIRED_GITIGNORE_LINES = [
+  "github/", // cloned repos have their own .git
+  ".session-token", // bearer token regenerated each startup
+  ".server-port", // runtime port published for the LLM wiki-write hook
+] as const;
+
+const FRESH_GITIGNORE = [
+  "# Cloned repositories have their own .git — don't nest",
+  "github/",
+  "",
+  "# Auth token (regenerated each startup)",
+  ".session-token",
+  "",
+  "# Bound port published at startup for the wiki-write hook",
+  ".server-port",
+  "",
+].join("\n");
+
+/** Decide what `.gitignore` should look like given its current
+ *  content. Returns null when no rewrite is needed.
+ *  - `null` existing → fresh template
+ *  - existing missing required lines → existing + missing lines
+ *    appended (preserves user customisation)
+ *  - existing with all required lines → null (no change) */
+export function nextGitignoreContent(existing: string | null): string | null {
+  if (existing === null) return FRESH_GITIGNORE;
+  // Treat the file as line-oriented; ignore comments and blanks for
+  // the comparison so a user's annotated copy still counts as
+  // having the line.
+  const present = new Set(
+    existing
+      .split(/\r?\n/)
+      .map((raw) => raw.trim())
+      .filter((line) => line.length > 0 && !line.startsWith("#")),
+  );
+  const missing = REQUIRED_GITIGNORE_LINES.filter((line) => !present.has(line));
+  if (missing.length === 0) return null;
+  const trailingNewline = existing.endsWith("\n") ? existing : `${existing}\n`;
+  return `${trailingNewline}${missing.join("\n")}\n`;
+}
+
+function ensureWorkspaceGitignore(): void {
+  const existing = readWorkspaceTextSync(".gitignore");
+  const next = nextGitignoreContent(existing);
+  if (next === null) return;
+  writeWorkspaceTextSync(".gitignore", next);
+}

package/src/App.vue

@@ -9,7 +9,6 @@
           :gemini-available="geminiAvailable"
           :title-style="debugTitleStyle"
           @test-query="(q) => sendMessage(q)"
-          @notification-navigate="handleNotificationNavigate"
           @open-settings="showSettings = true"
           @home="handleHomeClick"
         />
@@ -77,6 +76,8 @@
             :roles="roles"
             :error-message="historyError"
             @load-session="handleSessionSelect"
+            @toggle-bookmark="(id, bookmarked) => setBookmark(id, bookmarked)"
+            @delete-session="(id) => deleteSessionFromHistory(id)"
           />
           <SessionHistoryExpandButton :model-value="sidePanelExpanded" @update:model-value="(value: boolean) => (sidePanelExpanded = value)" />
         </div>
@@ -123,7 +124,7 @@
           v-model="userInput"
           v-model:pasted-file="pastedFile"
           :is-running="activeSessionRunning"
-          :queries="sessionRole.queries ?? []"
+          :queries="sessionRoleQueries"
           @send="sendMessage()"
           @suggestion-send="(q) => sendMessage(q)"
         />
@@ -163,16 +164,51 @@
             @update:layout-mode="setLayoutMode"
             @toggle-right-sidebar="toggleRightSidebar"
           />
-          <!-- Distinct pages -->
+          <!-- Distinct pages. Plugin-owned views (Todo / Calendar /
+               Automations / Wiki / Skills) call `useRuntime()` from
+               `gui-chat-protocol/vue` inside their composables — that
+               throws unless mounted under `<PluginScopedRoot>`. The
+               plugin registry's `wrapWithScope` wraps the chat-mounted
+               variants; standalone routes are wrapped here against the
+               same `pkg-name + endpoints` pair so the `useRuntime()`
+               call resolves. -->
           <FilesView v-else-if="currentPage === 'files'" :refresh-token="filesRefreshToken" @load-session="handleSessionSelect" />
-          <TodoExplorer v-else-if="currentPage === 'todos'" />
-          <CalendarView v-else-if="currentPage === 'calendar'" />
-          <AutomationsView v-else-if="currentPage === 'automations'" />
-          <WikiView v-else-if="currentPage === 'wiki'" />
-          <SkillsView v-else-if="currentPage === 'skills'" />
+          <PluginScopedRoot v-else-if="currentPage === 'todos'" pkg-name="@mulmoclaude/todo-plugin">
+            <TodoExplorer />
+          </PluginScopedRoot>
+          <PluginScopedRoot v-else-if="currentPage === 'calendar'" pkg-name="scheduler" :endpoints="API_ROUTES.scheduler">
+            <CalendarView />
+          </PluginScopedRoot>
+          <PluginScopedRoot v-else-if="currentPage === 'automations'" pkg-name="scheduler" :endpoints="API_ROUTES.scheduler">
+            <AutomationsView />
+          </PluginScopedRoot>
+          <PluginScopedRoot v-else-if="currentPage === 'wiki'" pkg-name="wiki" :endpoints="API_ROUTES.wiki">
+            <WikiView />
+          </PluginScopedRoot>
+          <PluginScopedRoot v-else-if="currentPage === 'skills'" pkg-name="skills" :endpoints="API_ROUTES.skills">
+            <SkillsView />
+          </PluginScopedRoot>
           <RolesView v-else-if="currentPage === 'roles'" />
           <SourcesView v-else-if="currentPage === 'sources'" />
           <NewsView v-else-if="currentPage === 'news'" />
+          <!-- Debug page (encore plan PR 1 follow-up). The View ships
+               inside the @mulmoclaude/debug-plugin runtime package; we
+               look it up by tool name and render the registered
+               viewComponent — already wrapped in PluginScopedRoot by
+               the runtime loader, so no extra scope wrapper here.
+
+               Literal English fallback below is intentional: the debug
+               surface is dev-only chrome behind `VITE_DEV_MODE=1`, so
+               we keep its strings out of the 8-locale i18n bundle.
+               Same policy applies to the launcher button (see
+               PluginLauncher.vue's `literalLabel`/`literalTitle`) and
+               to the page itself (debug-plugin/src/View.vue). -->
+          <component :is="debugViewComponent" v-else-if="currentPage === 'debug' && debugViewComponent" />
+          <!-- eslint-disable @intlify/vue-i18n/no-raw-text -- debug page is dev-only chrome behind VITE_DEV_MODE=1; we deliberately keep its strings out of the 8-locale i18n bundle (see policy comment above). -->
+          <div v-else-if="currentPage === 'debug'" class="h-full flex items-center justify-center text-sm text-gray-500">
+            Debug plugin is not loaded. Make sure @mulmoclaude/debug-plugin is built and registered as a preset.
+          </div>
+          <!-- eslint-enable @intlify/vue-i18n/no-raw-text -->
         </div>
 
         <!-- Bottom bar (Stack chat only — plugin views have no
@@ -190,7 +226,7 @@
             v-model="userInput"
             v-model:pasted-file="pastedFile"
             :is-running="activeSessionRunning"
-            :queries="sessionRole.queries ?? []"
+            :queries="sessionRoleQueries"
             @send="sendMessage()"
             @suggestion-send="(q) => sendMessage(q)"
           />
@@ -219,7 +255,6 @@
       @update:open="showSettings = $event"
       @ask-gemini="handleAskGemini"
     />
-    <NotificationToast />
   </div>
 </template>
 
@@ -227,8 +262,6 @@
 import { ref, computed, watch, nextTick, onMounted, reactive } from "vue";
 import { useI18n } from "vue-i18n";
 import { v4 as uuidv4 } from "uuid";
-
-const { t } = useI18n();
 import { getPlugin } from "./tools";
 import type { ToolResultComplete } from "gui-chat-protocol/vue";
 import RightSidebar from "./components/RightSidebar.vue";
@@ -249,24 +282,22 @@ import AutomationsView from "./plugins/scheduler/AutomationsView.vue";
 import WikiView from "./plugins/wiki/View.vue";
 import { buildWikiRouteParams } from "./plugins/wiki/route";
 import SkillsView from "./plugins/manageSkills/View.vue";
-import RolesView from "./plugins/manageRoles/View.vue";
+import RolesView from "./components/RolesView.vue";
 import SourcesView from "./components/SourcesView.vue";
 import NewsView from "./components/NewsView.vue";
+import PluginScopedRoot from "./components/PluginScopedRoot.vue";
 import SettingsModal from "./components/SettingsModal.vue";
-import NotificationToast from "./components/NotificationToast.vue";
-import type { NotificationAction } from "./types/notification";
 import { PAGE_ROUTES, type PageRouteName } from "./router";
 import type { SseEvent } from "./types/sse";
-import { type SessionEntry, type ActiveSession } from "./types/session";
+import type { SessionEntry, ActiveSession } from "./types/session";
 import { EVENT_TYPES } from "./types/events";
-import { extractImageData } from "./utils/tools/result";
 import { buildAgentRequestBody, postAgentRun } from "./utils/agent/request";
+import { resolvePastedAttachment } from "./utils/agent/pastedAttachment";
 import { applyAgentEvent, type AgentEventContext } from "./utils/agent/eventDispatch";
 import { pushErrorMessage, beginUserTurn, updateResult } from "./utils/session/sessionHelpers";
 import { roleName, roleIcon } from "./utils/role/icon";
 import { createEmptySession } from "./utils/session/sessionFactory";
 import { buildLoadedSession, parseSessionEntries } from "./utils/session/sessionEntries";
-import { resolveNotificationTarget } from "./utils/notification/dispatch";
 import { usePendingCalls } from "./composables/usePendingCalls";
 import { useRunElapsed } from "./composables/useRunElapsed";
 import { useKeyNavigation } from "./composables/useKeyNavigation";
@@ -276,6 +307,7 @@ import { useViewLayout } from "./composables/useViewLayout";
 import { useSessionSync } from "./composables/useSessionSync";
 import { useSessionDerived } from "./composables/useSessionDerived";
 import { useFaviconState } from "./composables/useFaviconState";
+import { useGlobalImageErrorRepair } from "./composables/useImageErrorRepair";
 import { useMergedSessions } from "./composables/useMergedSessions";
 import { useLayoutMode } from "./composables/useLayoutMode";
 import { useSidePanelVisible } from "./composables/useSidePanelVisible";
@@ -283,6 +315,7 @@ import { useSelectedResult } from "./composables/useSelectedResult";
 import { useMcpTools } from "./composables/useMcpTools";
 import { useRoles } from "./composables/useRoles";
 import { useCurrentRole } from "./composables/useCurrentRole";
+import { useTranslatedQueries } from "./composables/useTranslatedQueries";
 import { BUILTIN_ROLE_IDS, type Role } from "./config/roles";
 import { usePubSub } from "./composables/usePubSub";
 import { sessionChannel } from "./config/pubsubChannels";
@@ -297,6 +330,8 @@ import { apiGet } from "./utils/api";
 import { API_ROUTES } from "./config/apiRoutes";
 import { classifyWorkspacePath } from "./utils/path/workspaceLinkRouter";
 
+const { t, locale } = useI18n();
+
 // --- Per-session state ---
 // Declared early so that pub/sub callbacks and function declarations
 // below can reference them without forward-reference ambiguity.
@@ -340,17 +375,6 @@ function navigateToSession(sessionId: string, replace = false): void {
   });
 }
 
-function handleNotificationNavigate(action: NotificationAction): void {
-  const target = resolveNotificationTarget(action);
-  if (!target) return;
-  // No special-casing for chat targets: PR #774 moved the role
-  // selector's state into the `useCurrentRole` singleton, so the
-  // role no longer needs to be pinned via `?role=` on every
-  // session-navigate. router.push(target) keeps the user's
-  // current role choice across the navigation automatically.
-  router.push(target).catch(() => {});
-}
-
 // External URL changes (back/forward button, typed URL) → update ref.
 // If the session isn't in memory, load it from the server.
 watch(
@@ -384,11 +408,17 @@ const userInput = ref("");
 const pastedFile = ref<PastedFile | null>(null);
 const activePane = ref<"sidebar" | "main">("sidebar");
 
-const { sessions, historyError, fetchSessions } = useSessionHistory();
+const { sessions, historyError, fetchSessions, setBookmark, deleteSession: deleteSessionFromHistory } = useSessionHistory();
 const { markSessionRead } = useSessionSync({
   sessionMap,
   currentSessionId,
   fetchSessions,
+  // Another tab hard-deleted the chat we're currently viewing. The
+  // sessionMap eviction has already cleared the in-memory state; the
+  // URL still points at the dead id. Mirror the URL→404 fallback on
+  // line ~366 by spinning up a fresh session so the user lands on a
+  // working /chat instead of a blank pane.
+  onCurrentSessionDeleted: () => createNewSession(),
 });
 const { geminiAvailable, sandboxEnabled, cpuLoadRatio, fetchHealth } = useHealth();
 
@@ -429,6 +459,12 @@ const sessionRole = computed<Role>(() => {
   return roles.value[0];
 });
 
+// Translated suggested-query strings for the active session's role.
+// Falls back to the role's English source until /api/translation
+// returns; subsequent role swaps hit the in-memory cache.
+const currentLocale = computed(() => String(locale.value));
+const { queries: sessionRoleQueries } = useTranslatedQueries(sessionRole, currentLocale);
+
 const { mergedSessions, tabSessions } = useMergedSessions({
   sessionMap,
   sessions,
@@ -446,6 +482,11 @@ const { mergedSessions, tabSessions } = useMergedSessions({
 // very same tick as `isRunning` flips, without waiting for the next
 // /api/sessions refetch.
 useFaviconState({ isRunning, sessions: mergedSessions, sessionsUnreadCount: unreadCount, cpuLoadRatio });
+useGlobalImageErrorRepair();
+// Boot-time plugin META aggregator collisions surface as notifier
+// entries from the server side; the notifier engine's persistent
+// `active.json` covers the late-mount case (PR 4 of feat-encore),
+// so no client-side catch-up fetch is required here.
 
 const sessionSidebarRef = ref<{ root: HTMLDivElement | null } | null>(null);
 const canvasRef = ref<HTMLDivElement | null>(null);
@@ -476,7 +517,7 @@ function setSidePanelVisibleAndCollapse(value: boolean): void {
 // full-width views.
 const isChatPage = computed(() => route.name === PAGE_ROUTES.chat);
 const currentPage = computed<PageRouteName | null>(() => {
-  const name = route.name;
+  const { name } = route;
   return typeof name === "string" && isPageRouteName(name) ? name : null;
 });
 
@@ -561,6 +602,12 @@ const { elapsedMs: runElapsedMs, teardown: teardownRunElapsed } = useRunElapsed(
 
 const selectedResult = computed(() => toolResults.value.find((result) => result.uuid === selectedResultUuid.value) ?? null);
 
+// Debug-plugin View component, looked up by tool name. The plugin
+// loader populates this asynchronously at boot — `runtimeRegistry` is
+// reactive, so this computed re-evaluates when the load completes and
+// the /debug branch in the template lights up without a refresh.
+const debugViewComponent = computed(() => getPlugin("manageDebug")?.viewComponent ?? null);
+
 // Centralised session-switch handler: subscribe to the current session's
 // pub/sub channel so we receive real-time events even if the session is
 // idle (another tab may start a run). Unsubscribe from idle sessions
@@ -579,9 +626,11 @@ watch(currentSessionId, (sessionId) => {
   // event, leaving the session's busy indicator stuck on.
   if (previousSessionId && previousSessionId !== sessionId) {
     const prevSession = sessionMap.get(previousSessionId);
-    const prevBusy = !!prevSession && (prevSession.isRunning || Object.keys(prevSession.pendingGenerations ?? {}).length > 0);
-    if (prevSession && !prevBusy) {
-      unsubscribeSession(previousSessionId);
+    if (prevSession !== undefined) {
+      const prevBusy = prevSession.isRunning || Object.keys(prevSession.pendingGenerations ?? {}).length > 0;
+      if (!prevBusy) {
+        unsubscribeSession(previousSessionId);
+      }
     }
   }
   previousSessionId = sessionId;
@@ -647,7 +696,7 @@ function createNewSession(roleId?: string): ActiveSession {
   navigateToSession(session.id, replace);
   chatInputRef.value?.collapseSuggestions();
   nextTick(() => focusChatInput());
-  return sessionMap.get(session.id)!;
+  return session;
 }
 
 function onRoleChange(roleId: string) {
@@ -748,7 +797,8 @@ async function refreshSessionTranscript(sessionId: string): Promise<void> {
   if (!session) return;
   const response = await apiGet<SessionEntry[]>(API_ROUTES.sessions.detail.replace(":id", encodeURIComponent(sessionId)));
   if (!response.ok) return;
-  const serverResults = parseSessionEntries(response.data);
+  const summary = sessions.value.find((entry) => entry.id === sessionId);
+  const serverResults = parseSessionEntries(response.data, summary?.origin);
   // Only patch if the server knows more than we do — avoids
   // replacing a richer in-flight state with a stale snapshot when
   // session_finished races with the last few events.
@@ -775,7 +825,8 @@ function buildAgentEventContext(session: ActiveSession): AgentEventContext {
 
 function hasPendingGenerations(sessionId: string): boolean {
   const live = sessionMap.get(sessionId);
-  return !!live && Object.keys(live.pendingGenerations).length > 0;
+  if (live === undefined) return false;
+  return Object.keys(live.pendingGenerations).length > 0;
 }
 
 function handleSessionFinished(sessionId: string): void {
@@ -826,11 +877,35 @@ async function sendMessage(text?: string) {
   const fileSnapshot = pastedFile.value;
   pastedFile.value = null;
 
+  // Pasted / dropped files are pre-uploaded to a workspace file so
+  // the server (and the LLM downstream) sees a relative path — never
+  // a data: URI. The path then rides on `attachments[]` as a path-only
+  // entry. On upload failure, restore both userInput and pastedFile so
+  // the user can retry without retyping.
+  let attachmentForRequest: string | undefined;
+  if (fileSnapshot) {
+    const resolved = await resolvePastedAttachment(fileSnapshot);
+    if (!resolved.ok) {
+      userInput.value = message;
+      pastedFile.value = fileSnapshot;
+      const recoverySession = sessionMap.get(currentSessionId.value);
+      if (recoverySession) pushErrorMessage(recoverySession, t("chatInput.attachImageFailed", { error: resolved.error }));
+      return;
+    }
+    attachmentForRequest = resolved.value;
+  }
+
   const session = sessionMap.get(currentSessionId.value);
   if (!session) return;
 
-  beginUserTurn(session, message);
-  const selectedRes = session.toolResults.find((result) => result.uuid === session.selectedResultUuid) ?? undefined;
+  // Only files the user explicitly attached this turn (paste / drop /
+  // file-picker) ride on the message. Do NOT auto-attach whatever
+  // image happens to be selected in the sidebar — selection moves to
+  // the latest generated image automatically, which would silently
+  // glue the previous picture onto every follow-up comment.
+  const attachmentPaths = attachmentForRequest ? [attachmentForRequest] : undefined;
+
+  beginUserTurn(session, message, attachmentPaths);
 
   ensureSessionSubscription(session);
 
@@ -839,7 +914,7 @@ async function sendMessage(text?: string) {
       message,
       role: sessionRole.value,
       chatSessionId: session.id,
-      selectedImageData: fileSnapshot?.dataUrl ?? extractImageData(selectedRes),
+      attachmentPaths,
     }),
   );
   if (!result.ok) {

package/src/_runtime/protocol-vue.ts

@@ -0,0 +1,21 @@
+// Re-export `gui-chat-protocol/vue` so a runtime-loaded plugin (#1110)
+// can share the host's `useRuntime()` / `PLUGIN_RUNTIME_KEY` instances
+// via importmap.
+//
+// Why a re-export at all: PLUGIN_RUNTIME_KEY is a `Symbol` created at
+// module load time. If two copies of `gui-chat-protocol/vue` were
+// loaded — one bundled into the host, another inlined in the plugin —
+// they would each create their own Symbol, and `provide(K, runtime)`
+// from the host would land on a different key than the plugin's
+// `inject(K)` — `useRuntime()` would throw "called outside of
+// <PluginScopedRoot>" even though the wrapper IS in the tree.
+//
+// The importmap entry in `index.html` (`gui-chat-protocol/vue` →
+// `/src/_runtime/protocol-vue.ts`) makes the browser resolve the
+// plugin's bare `import { useRuntime } from "gui-chat-protocol/vue"`
+// to this same file the host already loaded — guaranteeing one
+// shared module instance / one Symbol / one working inject path.
+//
+// `export *` mirrors the runtime-vue pattern next door: plugins compile
+// against an evolving surface; we don't want to whitelist names here.
+export * from "gui-chat-protocol/vue";

package/src/_runtime/vue.ts

@@ -0,0 +1,22 @@
+// Re-export Vue's runtime so a runtime-loaded plugin (#1043 C-2) can
+// share the host's Vue instance via importmap. The browser resolves a
+// plugin's bare `import "vue"` (after the importmap declared in
+// `index.html`) to this file. Vite transforms this module's own
+// `from "vue"` to the same Vue chunk the host app uses, so host and
+// runtime-loaded plugin component code end up referencing the same
+// Vue singleton — reactivity flows across the boundary, and there is
+// only one `createApp`, one Composition API, etc.
+//
+// Why `export *` and not a named re-export: plugin bundles compiled
+// against `gui-chat-protocol/vue` import a wide and evolving surface
+// of Vue (defineComponent, h, ref, computed, watch, …). Whitelisting
+// would force this file to track Vue's API. `export *` gives the
+// plugin the full surface it was compiled against.
+//
+// Build emit: registered as a Rollup input (`runtime-vue`) in
+// `vite.config.ts` so it survives tree-shaking even though no
+// static `import` references it. The build-only
+// `runtimeImportmapBuildPlugin` rewrites the dev importmap URL
+// (`/src/_runtime/vue.ts`) to the hashed asset filename in the
+// emitted `index.html`.
+export * from "vue";

package/src/components/ChatInput.vue

@@ -1,6 +1,12 @@
 <template>
   <div class="border-t border-gray-200" @dragover.prevent @drop="onDropFile">
-    <SuggestionsPanel v-model:expanded="suggestionsExpanded" :queries="queries" @send="onSuggestionSend" @edit="onSuggestionEdit" />
+    <SuggestionsPanel
+      v-model:expanded="suggestionsExpanded"
+      :queries="queries"
+      :trigger-ref="suggestionsBtnRef"
+      @send="onSuggestionSend"
+      @edit="onSuggestionEdit"
+    />
     <div class="p-2">
       <div v-if="fileError" class="mb-2 text-xs text-red-600 bg-red-50 border border-red-200 rounded px-3 py-1.5" data-testid="file-error">
         {{ fileError }}
@@ -30,12 +36,12 @@
         />
         <div class="flex flex-col gap-1">
           <button
-            v-if="queries.length > 0"
+            ref="suggestionsBtnRef"
             data-testid="suggestions-btn"
             class="rounded w-8 h-8 flex items-center justify-center"
             :class="suggestionsExpanded ? 'text-blue-600 bg-blue-50' : 'text-gray-400 hover:text-gray-600'"
-            :title="t('suggestionsPanel.suggestions')"
-            :aria-label="t('suggestionsPanel.suggestions')"
+            :title="t('suggestionsPanel.tooltip')"
+            :aria-label="t('suggestionsPanel.tooltip')"
             @click="suggestionsExpanded = !suggestionsExpanded"
           >
             <span class="material-icons text-base leading-none">lightbulb</span>
@@ -77,14 +83,11 @@ import { useI18n } from "vue-i18n";
 import ChatAttachmentPreview from "./ChatAttachmentPreview.vue";
 import SuggestionsPanel from "./SuggestionsPanel.vue";
 import { useImeAwareEnter } from "../composables/useImeAwareEnter";
+import type { PastedFile } from "../types/pastedFile";
 
-const { t } = useI18n();
+export type { PastedFile };
 
-export interface PastedFile {
-  dataUrl: string;
-  name: string;
-  mime: string;
-}
+const { t } = useI18n();
 
 withDefaults(
   defineProps<{
@@ -107,6 +110,7 @@ const textarea = ref<HTMLTextAreaElement | null>(null);
 const fileError = ref<string | null>(null);
 const fileInput = ref<HTMLInputElement | null>(null);
 const suggestionsExpanded = ref(false);
+const suggestionsBtnRef = ref<HTMLButtonElement | null>(null);
 
 const MAX_ATTACH_BYTES = 30 * 1024 * 1024;
 

package/src/components/CopyChatButton.vue

@@ -0,0 +1,76 @@
+<template>
+  <!-- Copies the current chat session to the clipboard as Markdown.
+       Lives in both <SessionSidebar> (single layout) and <StackView>
+       (stack layout) so the affordance is in the same visual slot
+       regardless of which layout the user is in.
+
+       Success feedback is local: the icon swaps to a check for ~1.5s.
+       No global toast composable yet (#TODO once one exists), and a
+       transient icon swap is enough since the user's hand is already
+       on the button. -->
+  <button
+    type="button"
+    class="h-8 w-8 flex items-center justify-center rounded text-gray-400 hover:text-gray-700 hover:bg-gray-100 transition-colors disabled:opacity-40 disabled:cursor-not-allowed"
+    :class="{ '!text-green-600': justCopied }"
+    data-testid="copy-chat-md"
+    :disabled="results.length === 0"
+    :title="justCopied ? t('sidebarHeader.copiedMarkdown') : t('sidebarHeader.copyMarkdown')"
+    :aria-label="justCopied ? t('sidebarHeader.copiedMarkdown') : t('sidebarHeader.copyMarkdown')"
+    @click="onCopy"
+  >
+    <span class="material-icons text-lg" aria-hidden="true">{{ justCopied ? "check" : "content_copy" }}</span>
+  </button>
+</template>
+
+<script setup lang="ts">
+import { ref, onUnmounted } from "vue";
+import { useI18n } from "vue-i18n";
+import type { ToolResultComplete } from "gui-chat-protocol/vue";
+import { exportChatToMarkdown } from "../utils/chat/exportMarkdown";
+import { apiGet } from "../utils/api";
+import { API_ROUTES } from "../config/apiRoutes";
+
+const COPIED_FEEDBACK_MS = 1500;
+
+const { t } = useI18n();
+
+const props = defineProps<{
+  results: ToolResultComplete[];
+  resultTimestamps: Map<string, number>;
+  sessionRoleName?: string;
+}>();
+
+const justCopied = ref(false);
+let resetTimeout: ReturnType<typeof setTimeout> | null = null;
+
+async function readWorkspaceFile(path: string): Promise<string | null> {
+  const result = await apiGet<{ content?: string }>(API_ROUTES.files.content, { path });
+  if (!result.ok) return null;
+  return result.data.content ?? null;
+}
+
+async function onCopy(): Promise<void> {
+  const markdown = await exportChatToMarkdown(props.results, {
+    sessionRoleName: props.sessionRoleName,
+    resultTimestamps: props.resultTimestamps,
+    readFile: readWorkspaceFile,
+  });
+  try {
+    await navigator.clipboard.writeText(markdown);
+    justCopied.value = true;
+    if (resetTimeout !== null) clearTimeout(resetTimeout);
+    resetTimeout = setTimeout(() => {
+      justCopied.value = false;
+      resetTimeout = null;
+    }, COPIED_FEEDBACK_MS);
+  } catch {
+    // Clipboard write can reject when the document isn't focused or
+    // permission is denied. The missing visual confirmation is itself
+    // the user-facing signal; logging would only spam the console.
+  }
+}
+
+onUnmounted(() => {
+  if (resetTimeout !== null) clearTimeout(resetTimeout);
+});
+</script>