npm - @sideboard-ai/core - Versions diffs - 0.1.22 → 0.1.23 - Mend

@sideboard-ai/core 0.1.22 → 0.1.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/dist/{agents-RYOW25YJ.js → agents-LJJRPW4Y.js} +1 -1
package/dist/{chunk-ULFES3M5.js → chunk-JNMLRJ3D.js} +151 -2
package/dist/{chunk-V54GKKCI.js → chunk-WK6AK7NK.js} +11 -5
package/dist/index.cjs +163 -6
package/dist/index.d.cts +48 -2
package/dist/index.d.ts +48 -2
package/dist/index.js +6 -2
package/dist/mcp/run-stdio.cjs +159 -6
package/dist/mcp/run-stdio.js +2 -2
package/package.json +1 -1

package/dist/{agents-RYOW25YJ.js → agents-LJJRPW4Y.js} RENAMED Viewed

@@ -11,7 +11,7 @@ import {
   listBrightsyChatTargets,
   opencodeAdapter,
   permissionMode
-} from "./chunk-V54GKKCI.js";
+} from "./chunk-WK6AK7NK.js";
 import "./chunk-ILQK4P5R.js";
 import {
   cursorSdkMessageToEvents,

package/dist/{chunk-ULFES3M5.js → chunk-JNMLRJ3D.js} RENAMED Viewed

@@ -25,7 +25,7 @@ import {
   allAdapters,
   getAdapter,
   parseBrightsyCliLine
-} from "./chunk-V54GKKCI.js";
+} from "./chunk-WK6AK7NK.js";
 import {
   childEnvWithAppSettings,
   getLinearApiKey,
@@ -248,6 +248,18 @@ function toolDescription(name, input) {
   if (/connectedAgentRequest/i.test(name)) {
     return str(input?.agent_id) ? `Ask connected agent` : "Ask connected agent";
   }
+  if (/present_artifact$/i.test(name)) {
+    return str(input?.title) ? `Present ${str(input?.title)}` : "Present artifact";
+  }
+  if (/present_schema$/i.test(name)) {
+    return str(input?.title) ? `Schema ${str(input?.title)}` : "Present schema";
+  }
+  if (/present_files$/i.test(name)) {
+    return str(input?.title) ? `Files ${str(input?.title)}` : "Present files";
+  }
+  if (/^(create|update)_artifact$/i.test(name.replace(/^mcp__[^_]+__/, ""))) {
+    return str(input?.title) ? `Artifact ${str(input?.title)}` : "Artifact";
+  }
   if (!input) return n;
   if (/bash|shell|terminal/i.test(name) && str(input.command)) {
     const cmd = str(input.command);
@@ -606,6 +618,26 @@ function formatWorktreeDirective(thread, opts) {
   }
   return lines.join("\n");
 }
+function formatArtifactDirective() {
+  return [
+    "Sideboard side column (desktop UI):",
+    "claude.ai\u2019s \u201CArtifact\u201D tool does NOT exist in Claude Code. That is expected.",
+    "Documents (HTML/SVG/markdown):",
+    "1) Emit a fenced code block tagged `html` (preferred), `svg`, or `markdown` with the FULL document \u2014 Sideboard opens a side column. Example:",
+    "```html",
+    "<!DOCTYPE html><html><head><title>Demo</title></head><body><h1>Hi</h1></body></html>",
+    "```",
+    "2) Or call Sideboard MCP `present_artifact` with title, type (html|svg|markdown), and content.",
+    "CMS / JSON Schema forms & tables (Brightsy or any schema+schemaUi source):",
+    "3) Call Sideboard MCP `present_schema` with title, mode (table|form), and either:",
+    "   - datasource=brightsy + resource_id (record type UUID) after fetching types via Brightsy MCP, or",
+    "   - datasource=inline + resource: { id, title, schema, schemaUi } and optional records/record.",
+    "Files / media browser (CMS file manager column):",
+    "4) Call Sideboard MCP `present_files` with optional title, path, and datasource (brightsy|memory).",
+    "   Opens the Files column for browse/upload/pick. Do NOT say a file manager UI is missing.",
+    "Never say artifacts, CMS UI, or the Files column are unavailable. Prefer present_schema for list/edit/publish; present_files for storage UI; html fences for standalone pages."
+  ].join("\n");
+}
 var FILES_BY_AGENT = {
   claude: [
     "CLAUDE.md",
@@ -1473,6 +1505,27 @@ function isImageRelativePath(relativePath) {
   const ext = base.includes(".") ? base.split(".").pop() || "" : "";
   return IMAGE_EXTENSIONS.has(ext);
 }
+var DEFAULT_UPLOAD_MAX_BYTES = 5e7;
+function readWorktreeFileForUpload(worktreePath, relativePath, opts) {
+  assertSafeRelativePath(relativePath);
+  const maxBytes = opts?.maxBytes ?? DEFAULT_UPLOAD_MAX_BYTES;
+  const abs = join4(worktreePath, relativePath);
+  const st = statSync2(abs);
+  if (!st.isFile()) {
+    throw new Error(`Not a file: ${relativePath}`);
+  }
+  if (st.size > maxBytes) {
+    throw new Error(
+      `File too large to upload (${st.size} bytes; max ${maxBytes})`
+    );
+  }
+  const buf = readFileSync4(abs);
+  return {
+    path: relativePath,
+    contentBase64: buf.toString("base64"),
+    size: buf.length
+  };
+}
 function readWorktreeFile(worktreePath, relativePath, opts) {
   assertSafeRelativePath(relativePath);
   const maxBytes = opts?.maxBytes ?? 2e5;
@@ -2273,7 +2326,7 @@ async function createThread(input, onSetupLine) {
   return readThread(thread.id) ?? thread;
 }
 async function listLinearIssues(agent, repoPath) {
-  const { getAdapter: getAdapter2 } = await import("./agents-RYOW25YJ.js");
+  const { getAdapter: getAdapter2 } = await import("./agents-LJJRPW4Y.js");
   await requireAgent(agent, { requireLinear: true });
   const adapter = getAdapter2(agent);
   if (!adapter.listLinearIssues) {
@@ -3189,9 +3242,18 @@ var Orchestrator = class {
       parentId: threadId,
       goal: thread.sourceRef || thread.title
     }) : null;
+    const artifactReminder = thread.agent !== "brightsy" ? [
+      "Sideboard side column (important):",
+      "There is no claude.ai Artifact tool here \u2014 that is normal.",
+      "HTML/SVG/markdown: ```html fence or MCP present_artifact.",
+      "CMS forms/tables: MCP present_schema (Brightsy resource_id or inline schema+schemaUi).",
+      "Files column: MCP present_files (brightsy account storage or memory).",
+      "Do not say artifacts/CMS UI are unavailable."
+    ].join(" ") : null;
     const agentPrompt = [
       thread.planMode ? PLAN_MODE_INSTRUCTION : null,
       orchestrationReminder,
+      artifactReminder,
       expandedPrompt
     ].filter(Boolean).join("\n\n");
     const instructionFiles = loadAgentInstructions(thread.worktreePath, thread.agent);
@@ -3216,6 +3278,7 @@ var Orchestrator = class {
         () => null
       )
     });
+    const artifactDirective = isBrightsy ? null : formatArtifactDirective();
     const settings = loadWorkspaceSettings(fresh.worktreePath, fresh.repoPath);
     const { autoRenameBranchEnabled } = await import("./app-settings-BDMLWCWI.js");
     const renameBranchDirective = !isBrightsy && !isOrchestration && autoRenameBranchEnabled() ? formatRenameBranchDirective(fresh, {
@@ -3243,6 +3306,7 @@ var Orchestrator = class {
     const cachedPrefix = [
       coordinatorDirective,
       worktreeDirective,
+      artifactDirective,
       renameBranchDirective,
       ...fresh.agent === "claude" && fresh.sessionId ? [] : [instructions, seed]
     ].filter(Boolean).join("\n\n---\n\n");
@@ -3663,6 +3727,13 @@ var Orchestrator = class {
     }
     return readWorktreeFile(thread.worktreePath, relativePath);
   }
+  async readFileForUpload(threadRef, relativePath) {
+    const thread = this.requireThread(threadRef);
+    if (relativePath.includes("..") || relativePath.startsWith("/")) {
+      throw new Error("Invalid path");
+    }
+    return readWorktreeFileForUpload(thread.worktreePath, relativePath);
+  }
   async writeFile(threadRef, relativePath, content) {
     const thread = this.requireThread(threadRef);
     if (relativePath.includes("..") || relativePath.startsWith("/")) {
@@ -4038,6 +4109,82 @@ async function startMcpServer() {
       return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
     }
   );
+  server.tool(
+    "present_artifact",
+    "Show an HTML, SVG, or markdown document in Sideboard\u2019s Claude-style side column (desktop). Use instead of claude.ai\u2019s artifact tool \u2014 pass the full document content. Prefer type=html for interactive pages.",
+    {
+      title: z.string().describe("Short title shown in the artifact pane header"),
+      type: z.enum(["html", "svg", "markdown"]).describe("Artifact kind \u2014 html opens an iframe preview"),
+      content: z.string().describe("Full document body (complete HTML page, SVG markup, or markdown)"),
+      artifact_id: z.string().optional().describe("Stable id when updating the same artifact across turns")
+    },
+    async ({ title, type, content, artifact_id }) => {
+      const id = artifact_id?.trim() || `artifact_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+      const payload = {
+        ok: true,
+        artifact_id: id,
+        title,
+        type,
+        content,
+        message: "Artifact accepted. Sideboard desktop opens it in the side column beside chat."
+      };
+      return { content: [{ type: "text", text: JSON.stringify(payload) }] };
+    }
+  );
+  server.tool(
+    "present_schema",
+    "Open Sideboard\u2019s schema-driven CMS side column (filterable table and/or form). Pass JSON Schema + schemaUi (Brightsy extensions supported). Use datasource=brightsy with resource_id (record type UUID) when logged into Brightsy; use datasource=inline with embedded resource/records for any other source.",
+    {
+      title: z.string().describe("Pane title"),
+      mode: z.enum(["table", "form"]).optional().describe("table = list/filter records; form = edit one record"),
+      datasource: z.enum(["brightsy", "inline"]).optional().describe("brightsy resolves via login; inline uses embedded resource/records"),
+      resource_id: z.string().optional().describe("Brightsy record type UUID (or generic resource id)"),
+      record_id: z.string().optional().describe("Record id when opening form mode"),
+      resource: z.record(z.unknown()).optional().describe("Inline { id, title, schema, schemaUi?, slug? }"),
+      record: z.record(z.unknown()).optional().describe("Inline record { id, data, published_at? }"),
+      records: z.array(z.record(z.unknown())).optional().describe("Inline records for table mode"),
+      pane_id: z.string().optional().describe("Stable pane id across updates")
+    },
+    async (args) => {
+      const id = args.pane_id?.trim() || `schema_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+      const payload = {
+        ok: true,
+        pane_id: id,
+        title: args.title,
+        mode: args.mode ?? (args.record_id || args.record ? "form" : "table"),
+        datasource: args.datasource ?? (args.resource ? "inline" : "brightsy"),
+        resource_id: args.resource_id,
+        record_id: args.record_id,
+        resource: args.resource,
+        record: args.record,
+        records: args.records,
+        message: "Schema pane accepted. Sideboard desktop opens the CMS column beside chat."
+      };
+      return { content: [{ type: "text", text: JSON.stringify(payload) }] };
+    }
+  );
+  server.tool(
+    "present_files",
+    "Open Sideboard\u2019s Files column (CMS-style file manager: browse, upload, pick). Use datasource=brightsy when the user is logged into Brightsy account storage; datasource=memory for a session-local demo store. Prefer this over claiming a file manager UI is unavailable. Pair with present_schema when editing records that need media.",
+    {
+      title: z.string().optional().describe("Pane title (default: Files)"),
+      datasource: z.enum(["brightsy", "memory"]).optional().describe("brightsy = account storage via login; memory = session demo store"),
+      path: z.string().optional().describe("Initial folder path (e.g. public)"),
+      pane_id: z.string().optional().describe("Stable pane id across updates")
+    },
+    async (args) => {
+      const id = args.pane_id?.trim() || `files_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+      const payload = {
+        ok: true,
+        pane_id: id,
+        title: args.title?.trim() || "Files",
+        datasource: args.datasource ?? "brightsy",
+        path: args.path,
+        message: "Files pane accepted. Sideboard desktop opens the Files column beside chat."
+      };
+      return { content: [{ type: "text", text: JSON.stringify(payload) }] };
+    }
+  );
   server.tool(
     "create_thread",
     "Create a new worktree thread (chat) from branch, pr, or ticket. Pass repoPath from list_workspaces and parentThreadId when spawning from an orchestrator. Then use send_to_thread to chat.",
@@ -4465,6 +4612,7 @@ export {
   spawnAgentTurn,
   formatRenameBranchDirective,
   formatWorktreeDirective,
+  formatArtifactDirective,
   loadAgentInstructions,
   formatAgentInstructions,
   withAgentInstructions,
@@ -4492,6 +4640,7 @@ export {
   listBranchCommits,
   getDiff,
   listWorktreeFiles,
+  readWorktreeFileForUpload,
   readWorktreeFile,
   writeWorktreeFile,
   getDiffSummary,

package/dist/{chunk-V54GKKCI.js → chunk-WK6AK7NK.js} RENAMED Viewed

@@ -428,6 +428,11 @@ var SIDEBOARD_MCP_ALLOWED_TOOLS = [
   "mcp__sideboard",
   "mcp__sideboard__*"
 ];
+var SIDEBOARD_ARTIFACT_MCP_ALLOWED_TOOLS = [
+  "mcp__sideboard__present_artifact",
+  "mcp__sideboard__present_schema",
+  "mcp__sideboard__present_files"
+];
 var BRIGHTSY_MCP_ALLOWED_TOOLS = [
   "mcp__brightsy",
   "mcp__brightsy__*"
@@ -518,10 +523,6 @@ function findSideboardMcpJsEntry() {
   return null;
 }
 async function resolveSideboardMcpServer() {
-  const which = await run("which", ["sideboard"], { reject: false });
-  if (which.exitCode === 0 && which.stdout.trim()) {
-    return { name: "sideboard", command: which.stdout.trim(), args: ["mcp"] };
-  }
   const entry = findSideboardMcpJsEntry();
   if (entry) {
     const isCli = /[/\\]cli[/\\]dist[/\\]index\.js$/.test(entry);
@@ -532,6 +533,10 @@ async function resolveSideboardMcpServer() {
       args: isCli ? [entry, "mcp"] : [entry]
     };
   }
+  const which = await run("which", ["sideboard"], { reject: false });
+  if (which.exitCode === 0 && which.stdout.trim()) {
+    return { name: "sideboard", command: which.stdout.trim(), args: ["mcp"] };
+  }
   return { name: "sideboard", command: "sideboard", args: ["mcp"] };
 }
 async function buildInjectedMcpServers(opts) {
@@ -736,7 +741,7 @@ var claudeAdapter = {
     const { isOrchestratorThread } = await import("./global-workspace-LM4AA4RO.js");
     const isOrchestrator = isOrchestratorThread(thread);
     const injectedServers = await buildInjectedMcpServers({
-      includeSideboard: isOrchestrator,
+      includeSideboard: true,
       includeBrightsy: isBrightsyConnected()
     });
     const injectedBrightsyNames = injectedServers.filter((s) => s.name === "brightsy" || s.name.startsWith("brightsy_")).map((s) => s.name);
@@ -753,6 +758,7 @@ var claudeAdapter = {
       allowedTools = [
         ...BASE_ALLOWED_TOOLS,
         ...mcpAllowTools(servers),
+        ...SIDEBOARD_ARTIFACT_MCP_ALLOWED_TOOLS,
         ...brightsyMcpAllowedTools(injectedBrightsyNames)
       ];
     }

package/dist/index.cjs CHANGED Viewed

@@ -4084,10 +4084,6 @@ function findSideboardMcpJsEntry() {
   return null;
 }
 async function resolveSideboardMcpServer() {
-  const which = await run("which", ["sideboard"], { reject: false });
-  if (which.exitCode === 0 && which.stdout.trim()) {
-    return { name: "sideboard", command: which.stdout.trim(), args: ["mcp"] };
-  }
   const entry = findSideboardMcpJsEntry();
   if (entry) {
     const isCli = /[/\\]cli[/\\]dist[/\\]index\.js$/.test(entry);
@@ -4098,6 +4094,10 @@ async function resolveSideboardMcpServer() {
       args: isCli ? [entry, "mcp"] : [entry]
     };
   }
+  const which = await run("which", ["sideboard"], { reject: false });
+  if (which.exitCode === 0 && which.stdout.trim()) {
+    return { name: "sideboard", command: which.stdout.trim(), args: ["mcp"] };
+  }
   return { name: "sideboard", command: "sideboard", args: ["mcp"] };
 }
 async function buildInjectedMcpServers(opts) {
@@ -4140,7 +4140,7 @@ function writeMcpServersConfig(servers) {
 async function writeInjectedMcpConfig(opts) {
   return writeMcpServersConfig(await buildInjectedMcpServers(opts));
 }
-var import_node_fs10, import_node_module, import_node_os6, import_node_path11, import_node_url, import_meta, SIDEBOARD_MCP_ALLOWED_TOOLS, BRIGHTSY_MCP_ALLOWED_TOOLS, brightsyMcpCommandCache;
+var import_node_fs10, import_node_module, import_node_os6, import_node_path11, import_node_url, import_meta, SIDEBOARD_MCP_ALLOWED_TOOLS, SIDEBOARD_ARTIFACT_MCP_ALLOWED_TOOLS, BRIGHTSY_MCP_ALLOWED_TOOLS, brightsyMcpCommandCache;
 var init_injected_mcp = __esm({
   "src/agents/injected-mcp.ts"() {
     "use strict";
@@ -4157,6 +4157,11 @@ var init_injected_mcp = __esm({
       "mcp__sideboard",
       "mcp__sideboard__*"
     ];
+    SIDEBOARD_ARTIFACT_MCP_ALLOWED_TOOLS = [
+      "mcp__sideboard__present_artifact",
+      "mcp__sideboard__present_schema",
+      "mcp__sideboard__present_files"
+    ];
     BRIGHTSY_MCP_ALLOWED_TOOLS = [
       "mcp__brightsy",
       "mcp__brightsy__*"
@@ -4368,7 +4373,7 @@ var init_claude = __esm({
         const { isOrchestratorThread: isOrchestratorThread2 } = await Promise.resolve().then(() => (init_global_workspace(), global_workspace_exports));
         const isOrchestrator = isOrchestratorThread2(thread);
         const injectedServers = await buildInjectedMcpServers({
-          includeSideboard: isOrchestrator,
+          includeSideboard: true,
           includeBrightsy: isBrightsyConnected()
         });
         const injectedBrightsyNames = injectedServers.filter((s) => s.name === "brightsy" || s.name.startsWith("brightsy_")).map((s) => s.name);
@@ -4385,6 +4390,7 @@ var init_claude = __esm({
           allowedTools = [
             ...BASE_ALLOWED_TOOLS,
             ...mcpAllowTools(servers),
+            ...SIDEBOARD_ARTIFACT_MCP_ALLOWED_TOOLS,
             ...brightsyMcpAllowedTools(injectedBrightsyNames)
           ];
         }
@@ -5309,6 +5315,7 @@ __export(index_exports, {
   forkMessageSlice: () => forkMessageSlice,
   forkThreadWorktree: () => forkThreadWorktree,
   formatAgentInstructions: () => formatAgentInstructions,
+  formatArtifactDirective: () => formatArtifactDirective,
   formatBrightsyFetchError: () => formatBrightsyFetchError,
   formatGhLandError: () => formatGhLandError,
   formatIpcInvokeError: () => formatIpcInvokeError,
@@ -5409,6 +5416,7 @@ __export(index_exports, {
   readSkillBody: () => readSkillBody,
   readThread: () => readThread,
   readWorktreeFile: () => readWorktreeFile,
+  readWorktreeFileForUpload: () => readWorktreeFileForUpload,
   readWorktreeInclude: () => readWorktreeInclude,
   refreshGitHubAuth: () => refreshGitHubAuth,
   removeWorkspace: () => removeWorkspace,
@@ -5712,6 +5720,18 @@ function toolDescription(name, input) {
   if (/connectedAgentRequest/i.test(name)) {
     return str(input?.agent_id) ? `Ask connected agent` : "Ask connected agent";
   }
+  if (/present_artifact$/i.test(name)) {
+    return str(input?.title) ? `Present ${str(input?.title)}` : "Present artifact";
+  }
+  if (/present_schema$/i.test(name)) {
+    return str(input?.title) ? `Schema ${str(input?.title)}` : "Present schema";
+  }
+  if (/present_files$/i.test(name)) {
+    return str(input?.title) ? `Files ${str(input?.title)}` : "Present files";
+  }
+  if (/^(create|update)_artifact$/i.test(name.replace(/^mcp__[^_]+__/, ""))) {
+    return str(input?.title) ? `Artifact ${str(input?.title)}` : "Artifact";
+  }
   if (!input) return n;
   if (/bash|shell|terminal/i.test(name) && str(input.command)) {
     const cmd = str(input.command);
@@ -6075,6 +6095,26 @@ function formatWorktreeDirective(thread, opts) {
   }
   return lines.join("\n");
 }
+function formatArtifactDirective() {
+  return [
+    "Sideboard side column (desktop UI):",
+    "claude.ai\u2019s \u201CArtifact\u201D tool does NOT exist in Claude Code. That is expected.",
+    "Documents (HTML/SVG/markdown):",
+    "1) Emit a fenced code block tagged `html` (preferred), `svg`, or `markdown` with the FULL document \u2014 Sideboard opens a side column. Example:",
+    "```html",
+    "<!DOCTYPE html><html><head><title>Demo</title></head><body><h1>Hi</h1></body></html>",
+    "```",
+    "2) Or call Sideboard MCP `present_artifact` with title, type (html|svg|markdown), and content.",
+    "CMS / JSON Schema forms & tables (Brightsy or any schema+schemaUi source):",
+    "3) Call Sideboard MCP `present_schema` with title, mode (table|form), and either:",
+    "   - datasource=brightsy + resource_id (record type UUID) after fetching types via Brightsy MCP, or",
+    "   - datasource=inline + resource: { id, title, schema, schemaUi } and optional records/record.",
+    "Files / media browser (CMS file manager column):",
+    "4) Call Sideboard MCP `present_files` with optional title, path, and datasource (brightsy|memory).",
+    "   Opens the Files column for browse/upload/pick. Do NOT say a file manager UI is missing.",
+    "Never say artifacts, CMS UI, or the Files column are unavailable. Prefer present_schema for list/edit/publish; present_files for storage UI; html fences for standalone pages."
+  ].join("\n");
+}
 var FILES_BY_AGENT = {
   claude: [
     "CLAUDE.md",
@@ -6946,6 +6986,27 @@ function isImageRelativePath(relativePath) {
   const ext = base.includes(".") ? base.split(".").pop() || "" : "";
   return IMAGE_EXTENSIONS.has(ext);
 }
+var DEFAULT_UPLOAD_MAX_BYTES = 5e7;
+function readWorktreeFileForUpload(worktreePath, relativePath, opts) {
+  assertSafeRelativePath(relativePath);
+  const maxBytes = opts?.maxBytes ?? DEFAULT_UPLOAD_MAX_BYTES;
+  const abs = (0, import_node_path17.join)(worktreePath, relativePath);
+  const st = (0, import_node_fs17.statSync)(abs);
+  if (!st.isFile()) {
+    throw new Error(`Not a file: ${relativePath}`);
+  }
+  if (st.size > maxBytes) {
+    throw new Error(
+      `File too large to upload (${st.size} bytes; max ${maxBytes})`
+    );
+  }
+  const buf = (0, import_node_fs17.readFileSync)(abs);
+  return {
+    path: relativePath,
+    contentBase64: buf.toString("base64"),
+    size: buf.length
+  };
+}
 function readWorktreeFile(worktreePath, relativePath, opts) {
   assertSafeRelativePath(relativePath);
   const maxBytes = opts?.maxBytes ?? 2e5;
@@ -8741,9 +8802,18 @@ var Orchestrator = class {
       parentId: threadId,
       goal: thread.sourceRef || thread.title
     }) : null;
+    const artifactReminder = thread.agent !== "brightsy" ? [
+      "Sideboard side column (important):",
+      "There is no claude.ai Artifact tool here \u2014 that is normal.",
+      "HTML/SVG/markdown: ```html fence or MCP present_artifact.",
+      "CMS forms/tables: MCP present_schema (Brightsy resource_id or inline schema+schemaUi).",
+      "Files column: MCP present_files (brightsy account storage or memory).",
+      "Do not say artifacts/CMS UI are unavailable."
+    ].join(" ") : null;
     const agentPrompt = [
       thread.planMode ? PLAN_MODE_INSTRUCTION : null,
       orchestrationReminder,
+      artifactReminder,
       expandedPrompt
     ].filter(Boolean).join("\n\n");
     const instructionFiles = loadAgentInstructions(thread.worktreePath, thread.agent);
@@ -8768,6 +8838,7 @@ var Orchestrator = class {
         () => null
       )
     });
+    const artifactDirective = isBrightsy ? null : formatArtifactDirective();
     const settings = loadWorkspaceSettings(fresh.worktreePath, fresh.repoPath);
     const { autoRenameBranchEnabled: autoRenameBranchEnabled2 } = await Promise.resolve().then(() => (init_app_settings(), app_settings_exports));
     const renameBranchDirective = !isBrightsy && !isOrchestration && autoRenameBranchEnabled2() ? formatRenameBranchDirective(fresh, {
@@ -8795,6 +8866,7 @@ var Orchestrator = class {
     const cachedPrefix = [
       coordinatorDirective,
       worktreeDirective,
+      artifactDirective,
       renameBranchDirective,
       ...fresh.agent === "claude" && fresh.sessionId ? [] : [instructions, seed]
     ].filter(Boolean).join("\n\n---\n\n");
@@ -9215,6 +9287,13 @@ var Orchestrator = class {
     }
     return readWorktreeFile(thread.worktreePath, relativePath);
   }
+  async readFileForUpload(threadRef, relativePath) {
+    const thread = this.requireThread(threadRef);
+    if (relativePath.includes("..") || relativePath.startsWith("/")) {
+      throw new Error("Invalid path");
+    }
+    return readWorktreeFileForUpload(thread.worktreePath, relativePath);
+  }
   async writeFile(threadRef, relativePath, content) {
     const thread = this.requireThread(threadRef);
     if (relativePath.includes("..") || relativePath.startsWith("/")) {
@@ -9596,6 +9675,82 @@ async function startMcpServer() {
       return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
     }
   );
+  server.tool(
+    "present_artifact",
+    "Show an HTML, SVG, or markdown document in Sideboard\u2019s Claude-style side column (desktop). Use instead of claude.ai\u2019s artifact tool \u2014 pass the full document content. Prefer type=html for interactive pages.",
+    {
+      title: import_zod.z.string().describe("Short title shown in the artifact pane header"),
+      type: import_zod.z.enum(["html", "svg", "markdown"]).describe("Artifact kind \u2014 html opens an iframe preview"),
+      content: import_zod.z.string().describe("Full document body (complete HTML page, SVG markup, or markdown)"),
+      artifact_id: import_zod.z.string().optional().describe("Stable id when updating the same artifact across turns")
+    },
+    async ({ title, type, content, artifact_id }) => {
+      const id = artifact_id?.trim() || `artifact_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+      const payload = {
+        ok: true,
+        artifact_id: id,
+        title,
+        type,
+        content,
+        message: "Artifact accepted. Sideboard desktop opens it in the side column beside chat."
+      };
+      return { content: [{ type: "text", text: JSON.stringify(payload) }] };
+    }
+  );
+  server.tool(
+    "present_schema",
+    "Open Sideboard\u2019s schema-driven CMS side column (filterable table and/or form). Pass JSON Schema + schemaUi (Brightsy extensions supported). Use datasource=brightsy with resource_id (record type UUID) when logged into Brightsy; use datasource=inline with embedded resource/records for any other source.",
+    {
+      title: import_zod.z.string().describe("Pane title"),
+      mode: import_zod.z.enum(["table", "form"]).optional().describe("table = list/filter records; form = edit one record"),
+      datasource: import_zod.z.enum(["brightsy", "inline"]).optional().describe("brightsy resolves via login; inline uses embedded resource/records"),
+      resource_id: import_zod.z.string().optional().describe("Brightsy record type UUID (or generic resource id)"),
+      record_id: import_zod.z.string().optional().describe("Record id when opening form mode"),
+      resource: import_zod.z.record(import_zod.z.unknown()).optional().describe("Inline { id, title, schema, schemaUi?, slug? }"),
+      record: import_zod.z.record(import_zod.z.unknown()).optional().describe("Inline record { id, data, published_at? }"),
+      records: import_zod.z.array(import_zod.z.record(import_zod.z.unknown())).optional().describe("Inline records for table mode"),
+      pane_id: import_zod.z.string().optional().describe("Stable pane id across updates")
+    },
+    async (args) => {
+      const id = args.pane_id?.trim() || `schema_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+      const payload = {
+        ok: true,
+        pane_id: id,
+        title: args.title,
+        mode: args.mode ?? (args.record_id || args.record ? "form" : "table"),
+        datasource: args.datasource ?? (args.resource ? "inline" : "brightsy"),
+        resource_id: args.resource_id,
+        record_id: args.record_id,
+        resource: args.resource,
+        record: args.record,
+        records: args.records,
+        message: "Schema pane accepted. Sideboard desktop opens the CMS column beside chat."
+      };
+      return { content: [{ type: "text", text: JSON.stringify(payload) }] };
+    }
+  );
+  server.tool(
+    "present_files",
+    "Open Sideboard\u2019s Files column (CMS-style file manager: browse, upload, pick). Use datasource=brightsy when the user is logged into Brightsy account storage; datasource=memory for a session-local demo store. Prefer this over claiming a file manager UI is unavailable. Pair with present_schema when editing records that need media.",
+    {
+      title: import_zod.z.string().optional().describe("Pane title (default: Files)"),
+      datasource: import_zod.z.enum(["brightsy", "memory"]).optional().describe("brightsy = account storage via login; memory = session demo store"),
+      path: import_zod.z.string().optional().describe("Initial folder path (e.g. public)"),
+      pane_id: import_zod.z.string().optional().describe("Stable pane id across updates")
+    },
+    async (args) => {
+      const id = args.pane_id?.trim() || `files_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+      const payload = {
+        ok: true,
+        pane_id: id,
+        title: args.title?.trim() || "Files",
+        datasource: args.datasource ?? "brightsy",
+        path: args.path,
+        message: "Files pane accepted. Sideboard desktop opens the Files column beside chat."
+      };
+      return { content: [{ type: "text", text: JSON.stringify(payload) }] };
+    }
+  );
   server.tool(
     "create_thread",
     "Create a new worktree thread (chat) from branch, pr, or ticket. Pass repoPath from list_workspaces and parentThreadId when spawning from an orchestrator. Then use send_to_thread to chat.",
@@ -10454,6 +10609,7 @@ init_injected_mcp();
   forkMessageSlice,
   forkThreadWorktree,
   formatAgentInstructions,
+  formatArtifactDirective,
   formatBrightsyFetchError,
   formatGhLandError,
   formatIpcInvokeError,
@@ -10554,6 +10710,7 @@ init_injected_mcp();
   readSkillBody,
   readThread,
   readWorktreeFile,
+  readWorktreeFileForUpload,
   readWorktreeInclude,
   refreshGitHubAuth,
   removeWorkspace,

package/dist/index.d.cts CHANGED Viewed

@@ -1212,6 +1212,11 @@ declare function formatRenameBranchDirective(thread: Pick<Thread, 'worktreePath'
 declare function formatWorktreeDirective(thread: Pick<Thread, 'worktreePath' | 'repoPath' | 'branchName'> & Partial<Pick<Thread, 'title' | 'prUrl'>>, opts?: {
     githubSlug?: string | null;
 }): string;
+/**
+ * Tell agents how Sideboard renders Claude-style artifacts (side column).
+ * Claude Code has no claude.ai `artifact` tool — fences / present_artifact instead.
+ */
+declare function formatArtifactDirective(): string;
 interface AgentInstructionFile {
     relativePath: string;
     content: string;
@@ -1417,6 +1422,17 @@ declare function getDiff(worktreePath: string, repoPath: string, opts?: GetDiffO
 declare function listWorktreeFiles(worktreePath: string, opts?: {
     maxFiles?: number;
 }): Promise<string[]>;
+/**
+ * Read a worktree file as base64 for upload (any type, not the editor stub).
+ * Rejects files larger than maxBytes.
+ */
+declare function readWorktreeFileForUpload(worktreePath: string, relativePath: string, opts?: {
+    maxBytes?: number;
+}): {
+    path: string;
+    contentBase64: string;
+    size: number;
+};
 /** Read a text (or image) file from the worktree (capped). */
 declare function readWorktreeFile(worktreePath: string, relativePath: string, opts?: {
     maxBytes?: number;
@@ -1772,6 +1788,11 @@ declare class Orchestrator {
         binary: boolean;
         encoding: 'utf8' | 'base64';
     }>;
+    readFileForUpload(threadRef: string, relativePath: string): Promise<{
+        path: string;
+        contentBase64: string;
+        size: number;
+    }>;
     writeFile(threadRef: string, relativePath: string, content: string): Promise<{
         path: string;
     }>;
@@ -1958,6 +1979,17 @@ interface IpcApi {
     listBrightsyChatTargets(): Promise<BrightsyChatTargets>;
     /** Brightsy login + connected teams (shared by CLI, Brightsy agent, and Claude MCP). */
     getBrightsySession(): Promise<BrightsySession>;
+    /**
+     * Auth for schema CMS pane (`@brightsy/client` in the renderer).
+     * Returns null fields + reason when not logged in.
+     */
+    getBrightsyCmsAuth(): Promise<{
+        endpoint: string;
+        accessToken: string | null;
+        accountId: string | null;
+        accountSlug: string | null;
+        reason?: string;
+    }>;
     /** Connect/activate a team for CLI + MCP (same as connectBrightsyTeam). */
     switchBrightsyAccount(accountIdOrSlug: string): Promise<BrightsySession>;
     /** Connect a team for CLI + MCP; activates it as the CLI session. */
@@ -2056,6 +2088,12 @@ interface IpcApi {
         binary: boolean;
         encoding: 'utf8' | 'base64';
     }>;
+    /** Full file bytes (base64) for CMS / file-manager upload from worktree paths. */
+    readFileForUpload(threadRef: string, relativePath: string): Promise<{
+        path: string;
+        contentBase64: string;
+        size: number;
+    }>;
     writeFile(threadRef: string, relativePath: string, content: string): Promise<{
         path: string;
     }>;
@@ -2191,6 +2229,14 @@ interface IpcApi {
         exitCode: number | null;
     }>;
     openExternal(url: string): Promise<void>;
+    /**
+     * Publish HTML for the artifact side-column iframe (custom protocol bypasses
+     * renderer CSP so inline scripts can run).
+     */
+    publishArtifactPreview(id: string, html: string): Promise<{
+        url: string;
+    }>;
+    clearArtifactPreview(id: string): Promise<void>;
     /**
      * In-app URL preview via BrowserView (top-level navigation — works for
      * sites that block iframes, e.g. GitHub).
@@ -2370,7 +2416,7 @@ declare function disconnectBrightsyTeam(accountIdOrSlug: string): Promise<Connec
 /** Sanitize slug for Claude MCP server / tool name segments. */
 declare function brightsyMcpServerName(slug: string): string;
-/** Claude --allowedTools entries for Sideboard MCP. */
+/** Claude --allowedTools entries for Sideboard MCP (full fleet). */
 declare const SIDEBOARD_MCP_ALLOWED_TOOLS: readonly ["mcp__sideboard", "mcp__sideboard__*"];
 /** Legacy single-server allow list (CLI ~/.brightsy fallback). */
 declare const BRIGHTSY_MCP_ALLOWED_TOOLS: readonly ["mcp__brightsy", "mcp__brightsy__*"];
@@ -2387,4 +2433,4 @@ declare function writeInjectedMcpConfig(opts: {
     includeBrightsy?: boolean;
 }): Promise<string | null>;
-export { type ActiveRun, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateThreadInput, type CreateWorktreeResult, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DevServerHandle, type DiffCommentInput, type DiffCommentLine, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, Orchestrator, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type RepoSettings, type RepoSetupInfo, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, type TeamName, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createGlobalChat, createOrUpdatePr, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getBrightsySession, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initializeGitRepository, inspectGitWorktree, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isLinearConnected, isOrchestratorThread, isPlaceholderBranch, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listConductorWorkspaces, listConnectedBrightsyTeams, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergeUsage, normalizeParseResult, normalizeThread, normalizeTurnInput, normalizeWorktreePath, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, permissionMode, previewLand, pushBranch, readSkillBody, readThread, readWorktreeFile, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldCompactContext, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };
+export { type ActiveRun, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateThreadInput, type CreateWorktreeResult, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DevServerHandle, type DiffCommentInput, type DiffCommentLine, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, Orchestrator, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type RepoSettings, type RepoSetupInfo, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, type TeamName, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createGlobalChat, createOrUpdatePr, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getBrightsySession, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initializeGitRepository, inspectGitWorktree, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isLinearConnected, isOrchestratorThread, isPlaceholderBranch, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listConductorWorkspaces, listConnectedBrightsyTeams, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergeUsage, normalizeParseResult, normalizeThread, normalizeTurnInput, normalizeWorktreePath, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, permissionMode, previewLand, pushBranch, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldCompactContext, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };

package/dist/index.d.ts CHANGED Viewed

@@ -1212,6 +1212,11 @@ declare function formatRenameBranchDirective(thread: Pick<Thread, 'worktreePath'
 declare function formatWorktreeDirective(thread: Pick<Thread, 'worktreePath' | 'repoPath' | 'branchName'> & Partial<Pick<Thread, 'title' | 'prUrl'>>, opts?: {
     githubSlug?: string | null;
 }): string;
+/**
+ * Tell agents how Sideboard renders Claude-style artifacts (side column).
+ * Claude Code has no claude.ai `artifact` tool — fences / present_artifact instead.
+ */
+declare function formatArtifactDirective(): string;
 interface AgentInstructionFile {
     relativePath: string;
     content: string;
@@ -1417,6 +1422,17 @@ declare function getDiff(worktreePath: string, repoPath: string, opts?: GetDiffO
 declare function listWorktreeFiles(worktreePath: string, opts?: {
     maxFiles?: number;
 }): Promise<string[]>;
+/**
+ * Read a worktree file as base64 for upload (any type, not the editor stub).
+ * Rejects files larger than maxBytes.
+ */
+declare function readWorktreeFileForUpload(worktreePath: string, relativePath: string, opts?: {
+    maxBytes?: number;
+}): {
+    path: string;
+    contentBase64: string;
+    size: number;
+};
 /** Read a text (or image) file from the worktree (capped). */
 declare function readWorktreeFile(worktreePath: string, relativePath: string, opts?: {
     maxBytes?: number;
@@ -1772,6 +1788,11 @@ declare class Orchestrator {
         binary: boolean;
         encoding: 'utf8' | 'base64';
     }>;
+    readFileForUpload(threadRef: string, relativePath: string): Promise<{
+        path: string;
+        contentBase64: string;
+        size: number;
+    }>;
     writeFile(threadRef: string, relativePath: string, content: string): Promise<{
         path: string;
     }>;
@@ -1958,6 +1979,17 @@ interface IpcApi {
     listBrightsyChatTargets(): Promise<BrightsyChatTargets>;
     /** Brightsy login + connected teams (shared by CLI, Brightsy agent, and Claude MCP). */
     getBrightsySession(): Promise<BrightsySession>;
+    /**
+     * Auth for schema CMS pane (`@brightsy/client` in the renderer).
+     * Returns null fields + reason when not logged in.
+     */
+    getBrightsyCmsAuth(): Promise<{
+        endpoint: string;
+        accessToken: string | null;
+        accountId: string | null;
+        accountSlug: string | null;
+        reason?: string;
+    }>;
     /** Connect/activate a team for CLI + MCP (same as connectBrightsyTeam). */
     switchBrightsyAccount(accountIdOrSlug: string): Promise<BrightsySession>;
     /** Connect a team for CLI + MCP; activates it as the CLI session. */
@@ -2056,6 +2088,12 @@ interface IpcApi {
         binary: boolean;
         encoding: 'utf8' | 'base64';
     }>;
+    /** Full file bytes (base64) for CMS / file-manager upload from worktree paths. */
+    readFileForUpload(threadRef: string, relativePath: string): Promise<{
+        path: string;
+        contentBase64: string;
+        size: number;
+    }>;
     writeFile(threadRef: string, relativePath: string, content: string): Promise<{
         path: string;
     }>;
@@ -2191,6 +2229,14 @@ interface IpcApi {
         exitCode: number | null;
     }>;
     openExternal(url: string): Promise<void>;
+    /**
+     * Publish HTML for the artifact side-column iframe (custom protocol bypasses
+     * renderer CSP so inline scripts can run).
+     */
+    publishArtifactPreview(id: string, html: string): Promise<{
+        url: string;
+    }>;
+    clearArtifactPreview(id: string): Promise<void>;
     /**
      * In-app URL preview via BrowserView (top-level navigation — works for
      * sites that block iframes, e.g. GitHub).
@@ -2370,7 +2416,7 @@ declare function disconnectBrightsyTeam(accountIdOrSlug: string): Promise<Connec
 /** Sanitize slug for Claude MCP server / tool name segments. */
 declare function brightsyMcpServerName(slug: string): string;
-/** Claude --allowedTools entries for Sideboard MCP. */
+/** Claude --allowedTools entries for Sideboard MCP (full fleet). */
 declare const SIDEBOARD_MCP_ALLOWED_TOOLS: readonly ["mcp__sideboard", "mcp__sideboard__*"];
 /** Legacy single-server allow list (CLI ~/.brightsy fallback). */
 declare const BRIGHTSY_MCP_ALLOWED_TOOLS: readonly ["mcp__brightsy", "mcp__brightsy__*"];
@@ -2387,4 +2433,4 @@ declare function writeInjectedMcpConfig(opts: {
     includeBrightsy?: boolean;
 }): Promise<string | null>;
-export { type ActiveRun, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateThreadInput, type CreateWorktreeResult, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DevServerHandle, type DiffCommentInput, type DiffCommentLine, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, Orchestrator, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type RepoSettings, type RepoSetupInfo, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, type TeamName, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createGlobalChat, createOrUpdatePr, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getBrightsySession, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initializeGitRepository, inspectGitWorktree, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isLinearConnected, isOrchestratorThread, isPlaceholderBranch, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listConductorWorkspaces, listConnectedBrightsyTeams, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergeUsage, normalizeParseResult, normalizeThread, normalizeTurnInput, normalizeWorktreePath, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, permissionMode, previewLand, pushBranch, readSkillBody, readThread, readWorktreeFile, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldCompactContext, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };
+export { type ActiveRun, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateThreadInput, type CreateWorktreeResult, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DevServerHandle, type DiffCommentInput, type DiffCommentLine, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, Orchestrator, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type RepoSettings, type RepoSetupInfo, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, type TeamName, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createGlobalChat, createOrUpdatePr, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getBrightsySession, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initializeGitRepository, inspectGitWorktree, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isLinearConnected, isOrchestratorThread, isPlaceholderBranch, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listConductorWorkspaces, listConnectedBrightsyTeams, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergeUsage, normalizeParseResult, normalizeThread, normalizeTurnInput, normalizeWorktreePath, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, permissionMode, previewLand, pushBranch, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldCompactContext, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };

package/dist/index.js CHANGED Viewed

@@ -34,6 +34,7 @@ import {
   forkMessageSlice,
   forkThreadWorktree,
   formatAgentInstructions,
+  formatArtifactDirective,
   formatMessagesAsTranscript,
   formatRenameBranchDirective,
   formatTranscriptMarkdown,
@@ -66,6 +67,7 @@ import {
   previewLand,
   readSkillBody,
   readWorktreeFile,
+  readWorktreeFileForUpload,
   readWorktreeInclude,
   requireAgent,
   resolveConductorCursorAgentId,
@@ -93,7 +95,7 @@ import {
   withAgentInstructions,
   worktreeCleanupSettings,
   writeWorktreeFile
-} from "./chunk-ULFES3M5.js";
+} from "./chunk-JNMLRJ3D.js";
 import {
   addWorkspace,
   ensureWorkspace,
@@ -158,7 +160,7 @@ import {
   permissionMode,
   sanitizeMcpServerName,
   writeInjectedMcpConfig
-} from "./chunk-V54GKKCI.js";
+} from "./chunk-WK6AK7NK.js";
 import {
   brightsyConfigPath,
   brightsyMcpServerName,
@@ -824,6 +826,7 @@ export {
   forkMessageSlice,
   forkThreadWorktree,
   formatAgentInstructions,
+  formatArtifactDirective,
   formatBrightsyFetchError,
   formatGhLandError,
   formatIpcInvokeError,
@@ -924,6 +927,7 @@ export {
   readSkillBody,
   readThread,
   readWorktreeFile,
+  readWorktreeFileForUpload,
   readWorktreeInclude,
   refreshGitHubAuth,
   removeWorkspace,

package/dist/mcp/run-stdio.cjs CHANGED Viewed

@@ -3730,10 +3730,6 @@ function findSideboardMcpJsEntry() {
   return null;
 }
 async function resolveSideboardMcpServer() {
-  const which = await run("which", ["sideboard"], { reject: false });
-  if (which.exitCode === 0 && which.stdout.trim()) {
-    return { name: "sideboard", command: which.stdout.trim(), args: ["mcp"] };
-  }
   const entry = findSideboardMcpJsEntry();
   if (entry) {
     const isCli = /[/\\]cli[/\\]dist[/\\]index\.js$/.test(entry);
@@ -3744,6 +3740,10 @@ async function resolveSideboardMcpServer() {
       args: isCli ? [entry, "mcp"] : [entry]
     };
   }
+  const which = await run("which", ["sideboard"], { reject: false });
+  if (which.exitCode === 0 && which.stdout.trim()) {
+    return { name: "sideboard", command: which.stdout.trim(), args: ["mcp"] };
+  }
   return { name: "sideboard", command: "sideboard", args: ["mcp"] };
 }
 async function buildInjectedMcpServers(opts) {
@@ -3783,7 +3783,7 @@ function writeMcpServersConfig(servers) {
   (0, import_node_fs9.writeFileSync)(cfgPath, JSON.stringify({ mcpServers }, null, 2));
   return cfgPath;
 }
-var import_node_fs9, import_node_module, import_node_os6, import_node_path10, import_node_url, import_meta, SIDEBOARD_MCP_ALLOWED_TOOLS, brightsyMcpCommandCache;
+var import_node_fs9, import_node_module, import_node_os6, import_node_path10, import_node_url, import_meta, SIDEBOARD_MCP_ALLOWED_TOOLS, SIDEBOARD_ARTIFACT_MCP_ALLOWED_TOOLS, brightsyMcpCommandCache;
 var init_injected_mcp = __esm({
   "src/agents/injected-mcp.ts"() {
     "use strict";
@@ -3800,6 +3800,11 @@ var init_injected_mcp = __esm({
       "mcp__sideboard",
       "mcp__sideboard__*"
     ];
+    SIDEBOARD_ARTIFACT_MCP_ALLOWED_TOOLS = [
+      "mcp__sideboard__present_artifact",
+      "mcp__sideboard__present_schema",
+      "mcp__sideboard__present_files"
+    ];
     brightsyMcpCommandCache = null;
   }
 });
@@ -4007,7 +4012,7 @@ var init_claude = __esm({
         const { isOrchestratorThread: isOrchestratorThread2 } = await Promise.resolve().then(() => (init_global_workspace(), global_workspace_exports));
         const isOrchestrator = isOrchestratorThread2(thread);
         const injectedServers = await buildInjectedMcpServers({
-          includeSideboard: isOrchestrator,
+          includeSideboard: true,
           includeBrightsy: isBrightsyConnected()
         });
         const injectedBrightsyNames = injectedServers.filter((s) => s.name === "brightsy" || s.name.startsWith("brightsy_")).map((s) => s.name);
@@ -4024,6 +4029,7 @@ var init_claude = __esm({
           allowedTools = [
             ...BASE_ALLOWED_TOOLS,
             ...mcpAllowTools(servers),
+            ...SIDEBOARD_ARTIFACT_MCP_ALLOWED_TOOLS,
             ...brightsyMcpAllowedTools(injectedBrightsyNames)
           ];
         }
@@ -4978,6 +4984,18 @@ function toolDescription(name, input) {
   if (/connectedAgentRequest/i.test(name)) {
     return str(input?.agent_id) ? `Ask connected agent` : "Ask connected agent";
   }
+  if (/present_artifact$/i.test(name)) {
+    return str(input?.title) ? `Present ${str(input?.title)}` : "Present artifact";
+  }
+  if (/present_schema$/i.test(name)) {
+    return str(input?.title) ? `Schema ${str(input?.title)}` : "Present schema";
+  }
+  if (/present_files$/i.test(name)) {
+    return str(input?.title) ? `Files ${str(input?.title)}` : "Present files";
+  }
+  if (/^(create|update)_artifact$/i.test(name.replace(/^mcp__[^_]+__/, ""))) {
+    return str(input?.title) ? `Artifact ${str(input?.title)}` : "Artifact";
+  }
   if (!input) return n;
   if (/bash|shell|terminal/i.test(name) && str(input.command)) {
     const cmd = str(input.command);
@@ -7064,6 +7082,27 @@ function isImageRelativePath(relativePath) {
   const ext = base.includes(".") ? base.split(".").pop() || "" : "";
   return IMAGE_EXTENSIONS.has(ext);
 }
+var DEFAULT_UPLOAD_MAX_BYTES = 5e7;
+function readWorktreeFileForUpload(worktreePath, relativePath, opts) {
+  assertSafeRelativePath(relativePath);
+  const maxBytes = opts?.maxBytes ?? DEFAULT_UPLOAD_MAX_BYTES;
+  const abs = (0, import_node_path19.join)(worktreePath, relativePath);
+  const st = (0, import_node_fs20.statSync)(abs);
+  if (!st.isFile()) {
+    throw new Error(`Not a file: ${relativePath}`);
+  }
+  if (st.size > maxBytes) {
+    throw new Error(
+      `File too large to upload (${st.size} bytes; max ${maxBytes})`
+    );
+  }
+  const buf = (0, import_node_fs20.readFileSync)(abs);
+  return {
+    path: relativePath,
+    contentBase64: buf.toString("base64"),
+    size: buf.length
+  };
+}
 function readWorktreeFile(worktreePath, relativePath, opts) {
   assertSafeRelativePath(relativePath);
   const maxBytes = opts?.maxBytes ?? 2e5;
@@ -7592,6 +7631,26 @@ function formatWorktreeDirective(thread, opts) {
   }
   return lines.join("\n");
 }
+function formatArtifactDirective() {
+  return [
+    "Sideboard side column (desktop UI):",
+    "claude.ai\u2019s \u201CArtifact\u201D tool does NOT exist in Claude Code. That is expected.",
+    "Documents (HTML/SVG/markdown):",
+    "1) Emit a fenced code block tagged `html` (preferred), `svg`, or `markdown` with the FULL document \u2014 Sideboard opens a side column. Example:",
+    "```html",
+    "<!DOCTYPE html><html><head><title>Demo</title></head><body><h1>Hi</h1></body></html>",
+    "```",
+    "2) Or call Sideboard MCP `present_artifact` with title, type (html|svg|markdown), and content.",
+    "CMS / JSON Schema forms & tables (Brightsy or any schema+schemaUi source):",
+    "3) Call Sideboard MCP `present_schema` with title, mode (table|form), and either:",
+    "   - datasource=brightsy + resource_id (record type UUID) after fetching types via Brightsy MCP, or",
+    "   - datasource=inline + resource: { id, title, schema, schemaUi } and optional records/record.",
+    "Files / media browser (CMS file manager column):",
+    "4) Call Sideboard MCP `present_files` with optional title, path, and datasource (brightsy|memory).",
+    "   Opens the Files column for browse/upload/pick. Do NOT say a file manager UI is missing.",
+    "Never say artifacts, CMS UI, or the Files column are unavailable. Prefer present_schema for list/edit/publish; present_files for storage UI; html fences for standalone pages."
+  ].join("\n");
+}
 var FILES_BY_AGENT = {
   claude: [
     "CLAUDE.md",
@@ -7926,9 +7985,18 @@ var Orchestrator = class {
       parentId: threadId,
       goal: thread.sourceRef || thread.title
     }) : null;
+    const artifactReminder = thread.agent !== "brightsy" ? [
+      "Sideboard side column (important):",
+      "There is no claude.ai Artifact tool here \u2014 that is normal.",
+      "HTML/SVG/markdown: ```html fence or MCP present_artifact.",
+      "CMS forms/tables: MCP present_schema (Brightsy resource_id or inline schema+schemaUi).",
+      "Files column: MCP present_files (brightsy account storage or memory).",
+      "Do not say artifacts/CMS UI are unavailable."
+    ].join(" ") : null;
     const agentPrompt = [
       thread.planMode ? PLAN_MODE_INSTRUCTION : null,
       orchestrationReminder,
+      artifactReminder,
       expandedPrompt
     ].filter(Boolean).join("\n\n");
     const instructionFiles = loadAgentInstructions(thread.worktreePath, thread.agent);
@@ -7953,6 +8021,7 @@ var Orchestrator = class {
         () => null
       )
     });
+    const artifactDirective = isBrightsy ? null : formatArtifactDirective();
     const settings = loadWorkspaceSettings(fresh.worktreePath, fresh.repoPath);
     const { autoRenameBranchEnabled: autoRenameBranchEnabled2 } = await Promise.resolve().then(() => (init_app_settings(), app_settings_exports));
     const renameBranchDirective = !isBrightsy && !isOrchestration && autoRenameBranchEnabled2() ? formatRenameBranchDirective(fresh, {
@@ -7980,6 +8049,7 @@ var Orchestrator = class {
     const cachedPrefix = [
       coordinatorDirective,
       worktreeDirective,
+      artifactDirective,
       renameBranchDirective,
       ...fresh.agent === "claude" && fresh.sessionId ? [] : [instructions, seed]
     ].filter(Boolean).join("\n\n---\n\n");
@@ -8400,6 +8470,13 @@ var Orchestrator = class {
     }
     return readWorktreeFile(thread.worktreePath, relativePath);
   }
+  async readFileForUpload(threadRef, relativePath) {
+    const thread = this.requireThread(threadRef);
+    if (relativePath.includes("..") || relativePath.startsWith("/")) {
+      throw new Error("Invalid path");
+    }
+    return readWorktreeFileForUpload(thread.worktreePath, relativePath);
+  }
   async writeFile(threadRef, relativePath, content) {
     const thread = this.requireThread(threadRef);
     if (relativePath.includes("..") || relativePath.startsWith("/")) {
@@ -8849,6 +8926,82 @@ async function startMcpServer() {
       return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
     }
   );
+  server.tool(
+    "present_artifact",
+    "Show an HTML, SVG, or markdown document in Sideboard\u2019s Claude-style side column (desktop). Use instead of claude.ai\u2019s artifact tool \u2014 pass the full document content. Prefer type=html for interactive pages.",
+    {
+      title: import_zod.z.string().describe("Short title shown in the artifact pane header"),
+      type: import_zod.z.enum(["html", "svg", "markdown"]).describe("Artifact kind \u2014 html opens an iframe preview"),
+      content: import_zod.z.string().describe("Full document body (complete HTML page, SVG markup, or markdown)"),
+      artifact_id: import_zod.z.string().optional().describe("Stable id when updating the same artifact across turns")
+    },
+    async ({ title, type, content, artifact_id }) => {
+      const id = artifact_id?.trim() || `artifact_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+      const payload = {
+        ok: true,
+        artifact_id: id,
+        title,
+        type,
+        content,
+        message: "Artifact accepted. Sideboard desktop opens it in the side column beside chat."
+      };
+      return { content: [{ type: "text", text: JSON.stringify(payload) }] };
+    }
+  );
+  server.tool(
+    "present_schema",
+    "Open Sideboard\u2019s schema-driven CMS side column (filterable table and/or form). Pass JSON Schema + schemaUi (Brightsy extensions supported). Use datasource=brightsy with resource_id (record type UUID) when logged into Brightsy; use datasource=inline with embedded resource/records for any other source.",
+    {
+      title: import_zod.z.string().describe("Pane title"),
+      mode: import_zod.z.enum(["table", "form"]).optional().describe("table = list/filter records; form = edit one record"),
+      datasource: import_zod.z.enum(["brightsy", "inline"]).optional().describe("brightsy resolves via login; inline uses embedded resource/records"),
+      resource_id: import_zod.z.string().optional().describe("Brightsy record type UUID (or generic resource id)"),
+      record_id: import_zod.z.string().optional().describe("Record id when opening form mode"),
+      resource: import_zod.z.record(import_zod.z.unknown()).optional().describe("Inline { id, title, schema, schemaUi?, slug? }"),
+      record: import_zod.z.record(import_zod.z.unknown()).optional().describe("Inline record { id, data, published_at? }"),
+      records: import_zod.z.array(import_zod.z.record(import_zod.z.unknown())).optional().describe("Inline records for table mode"),
+      pane_id: import_zod.z.string().optional().describe("Stable pane id across updates")
+    },
+    async (args) => {
+      const id = args.pane_id?.trim() || `schema_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+      const payload = {
+        ok: true,
+        pane_id: id,
+        title: args.title,
+        mode: args.mode ?? (args.record_id || args.record ? "form" : "table"),
+        datasource: args.datasource ?? (args.resource ? "inline" : "brightsy"),
+        resource_id: args.resource_id,
+        record_id: args.record_id,
+        resource: args.resource,
+        record: args.record,
+        records: args.records,
+        message: "Schema pane accepted. Sideboard desktop opens the CMS column beside chat."
+      };
+      return { content: [{ type: "text", text: JSON.stringify(payload) }] };
+    }
+  );
+  server.tool(
+    "present_files",
+    "Open Sideboard\u2019s Files column (CMS-style file manager: browse, upload, pick). Use datasource=brightsy when the user is logged into Brightsy account storage; datasource=memory for a session-local demo store. Prefer this over claiming a file manager UI is unavailable. Pair with present_schema when editing records that need media.",
+    {
+      title: import_zod.z.string().optional().describe("Pane title (default: Files)"),
+      datasource: import_zod.z.enum(["brightsy", "memory"]).optional().describe("brightsy = account storage via login; memory = session demo store"),
+      path: import_zod.z.string().optional().describe("Initial folder path (e.g. public)"),
+      pane_id: import_zod.z.string().optional().describe("Stable pane id across updates")
+    },
+    async (args) => {
+      const id = args.pane_id?.trim() || `files_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+      const payload = {
+        ok: true,
+        pane_id: id,
+        title: args.title?.trim() || "Files",
+        datasource: args.datasource ?? "brightsy",
+        path: args.path,
+        message: "Files pane accepted. Sideboard desktop opens the Files column beside chat."
+      };
+      return { content: [{ type: "text", text: JSON.stringify(payload) }] };
+    }
+  );
   server.tool(
     "create_thread",
     "Create a new worktree thread (chat) from branch, pr, or ticket. Pass repoPath from list_workspaces and parentThreadId when spawning from an orchestrator. Then use send_to_thread to chat.",

package/dist/mcp/run-stdio.js CHANGED Viewed

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   startMcpServer
-} from "../chunk-ULFES3M5.js";
+} from "../chunk-JNMLRJ3D.js";
 import "../chunk-PER4N6LS.js";
 import "../chunk-Y2EWQ4TL.js";
 import "../chunk-BMB7WCGF.js";
-import "../chunk-V54GKKCI.js";
+import "../chunk-WK6AK7NK.js";
 import "../chunk-ILQK4P5R.js";
 import "../chunk-3DKGI32Q.js";
 import "../chunk-3WF3X46L.js";

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@sideboard-ai/core",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "description": "Sideboard core — orchestration, agents, git worktrees, MCP server",
   "license": "Apache-2.0",
   "type": "module",