Merge branch 'main' into feature/agent-clarification-questions

Author: Klabundo

README.md

@@ -25,7 +25,7 @@ Search surfaces your notes, the graph groups them into the topics your vault is
 
 - **[Search](https://smartsecondbrain.dev/search/)** that combines keyword matching with meaning, so you find the note you were thinking of rather than the one you typed ([how it works](https://smartsecondbrain.dev/search/how-it-works/))
 - **[Smart Graph](https://smartsecondbrain.dev/graph/)** that works out what your vault is about: notes grouped into topics from your links, your tags, and what you wrote, with nothing to maintain ([how it works](https://smartsecondbrain.dev/graph/how-it-works/))
-- **[Agents](https://smartsecondbrain.dev/agents/)** that read and write your notes, with skills, memory, MCP, and integrations with your other plugins
+- **[Agents](https://smartsecondbrain.dev/agents/)** that read and write your notes, draw charts and dashboards live from them as [widgets](https://smartsecondbrain.dev/agents/widgets/), with skills, memory, MCP, and integrations with your other plugins
 
 ## Install
 

bun.lock

@@ -4,7 +4,7 @@
   "description": "Search, explore, and chat with your notes using hybrid semantic search, an interactive knowledge graph, and an AI assistant powered by local or cloud providers like Ollama, OpenAI, and Anthropic.",
   "author": "Leo310, nicobrauchtgit",
   "authorUrl": "https://smartsecondbrain.dev",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "minAppVersion": "1.11.4",
   "isDesktopOnly": false
 }

manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "smart-second-brain",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "main": "main.js",
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
@@ -17,6 +17,7 @@
     "fake-indexeddb": "^6.2.5",
     "jsdom": "^27.4.0",
     "obsidian": "^1.13.1",
+    "plotly.js-gl3d-dist-min": "^4.1.1",
     "postcss": "^8.5.28",
     "svelte": "^5.57.0",
     "svelte-check": "^4.7.6",

package.json

@@ -83,6 +83,8 @@ import {
 	type PluginIntegration,
 	pluginExposesApi,
 	isCommunityPluginEnabled,
+	communityPluginDisplayName,
+	communityPluginStatus,
 	isInternalPluginEnabled,
 	getPluginIcon,
 	skillIcon,
@@ -966,6 +968,10 @@ export class AgentManager {
 							if (toolId.startsWith("exec_")) return boundExecTools.has(toolId);
 							return true;
 						},
+						pluginStatus: (pluginId) => ({
+							status: communityPluginStatus(this.plugin.app, pluginId),
+							displayName: communityPluginDisplayName(pluginId),
+						}),
 					}),
 				);
 			}

src/agent/AgentManager.ts

@@ -70,6 +70,26 @@ export function isCommunityPluginEnabled(app: App, pluginId: string): boolean {
 	return Boolean(app.plugins?.enabledPlugins?.has(pluginId));
 }
 
+export type CommunityPluginStatus = "enabled" | "disabled" | "missing";
+
+/**
+ * Installed-and-enabled / installed-but-disabled / not installed, for a community
+ * plugin id. "Installed" is read from the manifests Obsidian loaded from the plugins
+ * folder, so a plugin the user turned off still reads as installed.
+ */
+export function communityPluginStatus(app: App, pluginId: string): CommunityPluginStatus {
+	if (isCommunityPluginEnabled(app, pluginId)) return "enabled";
+	// @ts-ignore - Obsidian plugin API (not in official types)
+	return app.plugins?.manifests?.[pluginId] ? "disabled" : "missing";
+}
+
+/** Human-friendly name for a community plugin id, from the curated table; the id otherwise. */
+export function communityPluginDisplayName(pluginId: string): string {
+	return (
+		CURATED_PLUGIN_INTEGRATIONS.find((integration) => integration.pluginId === pluginId)?.displayName ?? pluginId
+	);
+}
+
 /**
  * Whether an Obsidian core (internal) plugin is enabled (e.g. "canvas", "bases").
  * Uses undocumented internal API — may need updates with Obsidian changes.
@@ -179,14 +199,15 @@ const BUNDLED_CORE_SKILL_ICONS: Record<string, string> = {
 	"manage-notes": "file-pen",
 	web: "globe",
 	"manage-skills": "wand-2",
+	widgets: "component", // = DEFAULT_WIDGET_ICON in widget/widgetIcon.ts
 };
 
 /**
  * Fixed display order for the S2B built-in core skills (the 4 former capabilities). Used by
  * both the agent editor's Core Skills list and the agents-summary icon strip so the two never
  * drift. Core-plugin skills (Canvas, Bases, …) are ranked after all of these.
  */
-const S2B_CORE_SKILL_ORDER = ["explore-vault", "manage-notes", "web", "manage-skills"];
+const S2B_CORE_SKILL_ORDER = ["explore-vault", "manage-notes", "web", "manage-skills", "widgets"];
 
 /**
  * Sort rank for a core-category skill: listed S2B built-ins first in `S2B_CORE_SKILL_ORDER`,

src/agent/integrations/pluginIntegrations.ts

@@ -1,6 +1,26 @@
 import { tool } from "@langchain/core/tools";
 import { z } from "zod";
 import type { SkillsService } from "../../skills/SkillsService";
+import type { CommunityPluginStatus } from "../integrations/pluginIntegrations";
+
+/** Frontmatter key (under `metadata:`) listing community plugin ids a skill can make use of. */
+export const OPTIONAL_PLUGINS_METADATA_KEY = "optionalPlugins";
+
+const STATUS_TEXT: Record<CommunityPluginStatus, string> = {
+	enabled: "enabled",
+	disabled: "installed but disabled — the user can enable it under Settings → Community plugins",
+	missing: "not installed — the user can install it from Settings → Community plugins → Browse",
+};
+
+/** Split a space- or comma-separated id list from frontmatter. */
+export function parseOptionalPlugins(metadata: Record<string, string> | undefined): string[] {
+	const raw = metadata?.[OPTIONAL_PLUGINS_METADATA_KEY];
+	if (!raw) return [];
+	return raw
+		.split(/[\s,]+/)
+		.map((id) => id.trim())
+		.filter(Boolean);
+}
 
 export interface LoadSkillToolOptions {
 	/**
@@ -17,6 +37,13 @@ export interface LoadSkillToolOptions {
 	 * and without the note the model would call a tool that doesn't exist.
 	 */
 	isToolAvailable?: (toolId: string) => boolean;
+	/**
+	 * Live status of a community plugin a skill lists under `metadata.optionalPlugins`.
+	 * Appended to the loaded body so a skill whose *best* path depends on another
+	 * plugin (the widgets skill's Dataview queries) can tell the model up front whether
+	 * that path exists, instead of letting it find out from a failed result.
+	 */
+	pluginStatus?: (pluginId: string) => { status: CommunityPluginStatus; displayName: string };
 }
 
 /**
@@ -28,7 +55,7 @@ export interface LoadSkillToolOptions {
  * @returns A LangChain tool for loading skill content
  */
 export function createLoadSkillTool(skillsService: SkillsService, options: LoadSkillToolOptions) {
-	const { skillNames, isToolAvailable } = options;
+	const { skillNames, isToolAvailable, pluginStatus } = options;
 
 	// If no skills available, return a tool that explains this
 	if (skillNames.length === 0) {
@@ -77,6 +104,20 @@ export function createLoadSkillTool(skillsService: SkillsService, options: LoadS
 				}
 			}
 
+			const optionalPlugins = pluginStatus ? parseOptionalPlugins(skill.frontmatter.metadata) : [];
+			if (optionalPlugins.length > 0) {
+				lines.push("");
+				lines.push("## Plugin availability");
+				lines.push("");
+				for (const pluginId of optionalPlugins) {
+					const { status, displayName } = pluginStatus?.(pluginId) ?? {
+						status: "missing",
+						displayName: pluginId,
+					};
+					lines.push(`- ${displayName} (\`${pluginId}\`): ${STATUS_TEXT[status]}`);
+				}
+			}
+
 			lines.push("");
 			lines.push("## Instructions");
 			lines.push("");

src/agent/tools/loadSkill.ts

@@ -30,12 +30,20 @@ const editSchema = z.object({
 		.describe("Replace all occurrences instead of requiring a single unique match. Default false."),
 });
 
+/** What the agent may create, edit, move and delete: notes, and standalone widgets (`.widget`, see views/widget). */
+const AGENT_WRITABLE_EXTENSIONS = [".md", ".widget"];
+const isAgentWritablePath = (path: string): boolean => AGENT_WRITABLE_EXTENSIONS.some((ext) => path.endsWith(ext));
+
 const createOperationSchema = z.object({
 	type: z.literal("create"),
 	path: z
 		.string()
-		.describe("Vault-relative path for the new markdown note. Must end in .md. Example: Notes/my-note.md"),
-	content: z.string().describe("Full markdown content for the new note"),
+		.describe(
+			"Vault-relative path for the new file. Must end in .md (a note) or .widget (a standalone widget: frontmatter, then HTML). Example: Notes/my-note.md",
+		),
+	content: z
+		.string()
+		.describe("Full content for the new file (markdown for a note; a widget fence's body for a .widget)"),
 });
 
 const REPLACE_PENDING_DESCRIPTION =
@@ -65,7 +73,9 @@ const deleteOperationSchema = z.object({
 const moveOperationSchema = z.object({
 	type: z.literal("move"),
 	path: z.string().describe("Current file path or wiki link reference to move"),
-	newPath: z.string().describe("Destination vault-relative path for the markdown note. Must end in .md."),
+	newPath: z
+		.string()
+		.describe("Destination vault-relative path. Must end in .md (a note) or .widget (a standalone widget)."),
 });
 
 const replaceOperationSchema = z.object({
@@ -147,9 +157,9 @@ function validateExistingMarkdownFile(
 	}
 
 	const file = result.file;
-	if (!file.path.endsWith(".md")) {
+	if (!isAgentWritablePath(file.path)) {
 		return {
-			error: `Error in operation ${operationNumber}: Only markdown files (.md) can be ${action}d. "${file.path}" is not a markdown file.`,
+			error: `Error in operation ${operationNumber}: Only notes (.md) and widgets (.widget) can be ${action}d. "${file.path}" is neither.`,
 		};
 	}
 
@@ -510,8 +520,8 @@ async function stageNoteOperations(
 			const duplicateError = ensureUniqueTarget(seenPaths, normalizedPath, operationNumber);
 			if (duplicateError) return duplicateError;
 
-			if (!normalizedPath.endsWith(".md")) {
-				return `Error in operation ${operationNumber}: Only markdown files (.md) can be created. Got: "${normalizedPath}"`;
+			if (!isAgentWritablePath(normalizedPath)) {
+				return `Error in operation ${operationNumber}: Only notes (.md) and widgets (.widget) can be created. Got: "${normalizedPath}"`;
 			}
 
 			if (!store.isPathAllowed(normalizedPath)) {
@@ -617,8 +627,8 @@ async function stageNoteOperations(
 			if (sourceDuplicateError) return sourceDuplicateError;
 
 			const normalizedNewPath = normalizePath(operation.newPath);
-			if (!normalizedNewPath.endsWith(".md")) {
-				return `Error in operation ${operationNumber}: Only markdown files (.md) can be moved. Got destination "${normalizedNewPath}"`;
+			if (!isAgentWritablePath(normalizedNewPath)) {
+				return `Error in operation ${operationNumber}: Only notes (.md) and widgets (.widget) can be moved. Got destination "${normalizedNewPath}"`;
 			}
 
 			const destinationDuplicateError = ensureUniqueTarget(seenPaths, normalizedNewPath, operationNumber);