@sideboard-ai/core 0.1.19 → 0.1.23

package/dist/{agents-2XMZO3CY.js → agents-LJJRPW4Y.js}

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

package/dist/{chunk-SNHWAARD.js → chunk-BMB7WCGF.js}

@@ -1,6 +1,6 @@
 import {
   resolveGithubRepoSlug
-} from "./chunk-LXHSRNJJ.js";
+} from "./chunk-UFWEANLU.js";
 import {
   globalAgentCwd,
   sideboardReposDir
@@ -31,7 +31,7 @@ function coordinatorGreenfieldPlaybook(reposDir) {
     "- Examples:",
     `  - Clone: \`git clone <url> ${reposDir}/<name>\``,
     `  - New GitHub repo: \`gh repo create <owner>/<name> --private --clone -- ${reposDir}/<name>\` (or mkdir + git init + gh repo create + remote add + push)`,
-    "- Then: add_workspace with that absolute path \u2192 create_thread (repoPath + parentThreadId) \u2192 send_to_thread (build) \u2192 wait_for_turn \u2192 send_to_thread (`gh pr create --draft -R <origin-owner/name>`) or create_draft_pr.",
+    "- Then: add_workspace with that absolute path \u2192 create_thread (repoPath + parentThreadId) \u2192 send_to_thread (build) \u2192 wait_for_turn \u2192 send_to_thread (`gh pr create --draft -R <origin-owner/name>`).",
     "- Always target the child worktree's **origin** (`github:` slug from list_workspaces / `git remote get-url origin` in that worktree). Never open PRs against `upstream`.",
     "- Do coding work in the child worktree thread, not by editing files in this home cwd."
   ].join("\n");
@@ -56,10 +56,8 @@ var COORDINATOR_TOOL_PLAYBOOK = [
   "- list_run_scripts / run_dev_script / stop_dev_script \u2014 start/stop named run scripts",
   "Inspect / PRs:",
   "- get_diff \u2014 compact diff summary",
-  "- preview_land \u2014 preview push+PR (does not push)",
-  "- Prefer asking the worktree agent via send_to_thread to open a draft PR with `gh pr create --draft -R <origin-owner/name>` (use the workspace `github:` slug / that worktree's origin \u2014 never upstream) so it owns title/body from the diff.",
-  "- create_draft_pr \u2014 fallback: commit (if dirty), push to origin, open/update a DRAFT PR from the orchestrator (always against origin)",
-  "Human-only (do not attempt): ready-for-review confirm_land, purge_thread.",
+  "- Ask the worktree agent via send_to_thread to open a draft PR with `gh pr create --draft -R <origin-owner/name>` (workspace `github:` slug / that worktree's origin \u2014 never upstream). Do not open PRs from the orchestrator yourself.",
+  "Human-only (do not attempt): merge, ready-for-review land, purge_thread.",
   "Thread links in replies: when mentioning a chat/thread for the user, include a markdown link `[Title](sideboard://thread/<id>)` using the full id (or the link field from create_thread / list_threads). Sideboard renders these as clickable opens.",
   "Bash / Read / etc: allowed for (1) inspecting target worktrees / registered repo paths from MCP, and (2) greenfield setup under ~/sideboard/repos (git clone, gh repo create, git init+remote). Never git init/clone *inside* this synthetic home cwd \u2014 emptiness here is expected, not a bug."
 ].join("\n");
@@ -98,8 +96,8 @@ function ensureGlobalCoordinatorCwd() {
     "",
     "When creating threads, pass `repoPath` from `list_workspaces` (or the path you just registered) and `parentThreadId` for children.",
     "Typical flow (existing): list_workspaces \u2192 list_branches|list_prs|list_issues \u2192 create_thread \u2192 send_to_thread \u2192 wait_for_turn.",
-    "Typical flow (new app): Bash create/clone under repos dir \u2192 add_workspace \u2192 create_thread \u2192 send_to_thread (implement) \u2192 wait_for_turn \u2192 draft PR.",
-    "Prefer asking worktree agents to open draft PRs; use create_draft_pr as fallback."
+    "Typical flow (new app): Bash create/clone under repos dir \u2192 add_workspace \u2192 create_thread \u2192 send_to_thread (implement) \u2192 wait_for_turn \u2192 draft PR via worktree agent.",
+    "Always ask worktree agents to open draft PRs (`send_to_thread` + `gh pr create --draft -R <origin>`); never open PRs from the orchestrator."
   ].join("\n");
   writeFileSync(join(dir, "CLAUDE.md"), `${body}
 `, "utf8");
@@ -124,8 +122,8 @@ function coordinatorSystemPrompt(opts) {
     COORDINATOR_TOOL_PLAYBOOK,
     coordinatorGreenfieldPlaybook(reposDir),
     "When creating threads, pass the correct repoPath for the target workspace and parentThreadId for children.",
-    "Typical flow (existing): list_workspaces \u2192 list_branches|list_prs|list_issues \u2192 create_thread \u2192 send_to_thread (implement) \u2192 wait_for_turn \u2192 send_to_thread (ask for `gh pr create --draft -R <origin-owner/name>` using the workspace github slug) \u2192 wait_for_turn. Use create_draft_pr only if the child cannot open the PR. Never target upstream.",
-    "Typical flow (new app): Bash under repos dir (clone or gh repo create) \u2192 add_workspace \u2192 create_thread \u2192 send_to_thread \u2192 wait_for_turn \u2192 draft PR.",
+    "Typical flow (existing): list_workspaces \u2192 list_branches|list_prs|list_issues \u2192 create_thread \u2192 send_to_thread (implement) \u2192 wait_for_turn \u2192 send_to_thread (ask for `gh pr create --draft -R <origin-owner/name>` using the workspace github slug) \u2192 wait_for_turn. Never target upstream. Never open PRs from the orchestrator.",
+    "Typical flow (new app): Bash under repos dir (clone or gh repo create) \u2192 add_workspace \u2192 create_thread \u2192 send_to_thread \u2192 wait_for_turn \u2192 draft PR via worktree agent.",
     `Goal: ${opts.goal}`,
     `Parent thread id (pass as parentThreadId when creating children): ${opts.parentId}`,
     "Registered workspaces:",

package/dist/{chunk-WWBC56EL.js → chunk-JNMLRJ3D.js}

@@ -3,7 +3,7 @@ import {
   ensureWorkspace,
   removeWorkspace,
   syncWorkspacesFromThreads
-} from "./chunk-LIUV5ONW.js";
+} from "./chunk-PER4N6LS.js";
 import {
   GLOBAL_WORKSPACE_ID,
   createGlobalChat,
@@ -13,19 +13,19 @@ import {
   isGlobalThread,
   isOrchestratorThread,
   orchestratorSessionPoisonedByBuiltins
-} from "./chunk-5263JXQY.js";
+} from "./chunk-Y2EWQ4TL.js";
 import {
   coordinatorSystemPrompt,
   coordinatorTurnReminder,
   enrichWorkspacesWithGithub,
   ensureGlobalCoordinatorCwd
-} from "./chunk-SNHWAARD.js";
+} from "./chunk-BMB7WCGF.js";
 import {
   PLAN_MODE_INSTRUCTION,
   allAdapters,
   getAdapter,
   parseBrightsyCliLine
-} from "./chunk-JQJZTL2Q.js";
+} from "./chunk-WK6AK7NK.js";
 import {
   childEnvWithAppSettings,
   getLinearApiKey,
@@ -64,7 +64,7 @@ import {
   takenSlugsFromThread,
   threadDisplayLabel,
   worktreeNameFromPath
-} from "./chunk-LXHSRNJJ.js";
+} from "./chunk-UFWEANLU.js";
 import {
   appendMessage,
   createEmptyThread,
@@ -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);
@@ -432,9 +444,9 @@ async function spawnAgentTurn(thread, input, onEvent) {
       `Cannot spawn ${thread.agent}: thread ${thread.id} has no worktreePath`
     );
   }
-  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-IV6LIDTO.js");
+  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-LM4AA4RO.js");
   if (isGlobalThread2(thread)) {
-    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-QPTX6YCW.js");
+    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-QH35ES7Y.js");
     ensureGlobalCoordinatorCwd2();
   }
   const adapter = getAdapter(thread.agent);
@@ -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-2XMZO3CY.js");
+  const { getAdapter: getAdapter2 } = await import("./agents-LJJRPW4Y.js");
   await requireAgent(agent, { requireLinear: true });
   const adapter = getAdapter2(agent);
   if (!adapter.listLinearIssues) {
@@ -2489,7 +2542,7 @@ async function adoptThread(input) {
     messages: input.messages ?? []
   });
   writeThread(thread);
-  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-JBWIRU55.js");
+  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-23GHLR7I.js");
   await ensureWorkspace2(repoPath);
   return thread;
 }
@@ -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("/")) {
@@ -3859,7 +3930,7 @@ var Orchestrator = class {
       return setStatus(thread.id, "idle");
     }
     if (!existsSync10(thread.worktreePath)) {
-      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-TYI2SANE.js");
+      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-RYTBDHHP.js");
       const { execa: execa6 } = await import("execa");
       const slug = thread.worktreePath.split("/").pop();
       const dest = thread.worktreePath;
@@ -3936,7 +4007,7 @@ async function startOrchestration(opts) {
     sourceRef: "default",
     ...createOpts
   }).catch(async () => {
-    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-TYI2SANE.js");
+    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-RYTBDHHP.js");
     const repo = await resolveRepoRoot2(repoPath);
     const def = await resolveDefaultBranch2(repo);
     return createThread({
@@ -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.",
@@ -4379,45 +4526,6 @@ async function startMcpServer() {
       };
     }
   );
-  server.tool(
-    "preview_land",
-    "Preview push+PR land (does NOT push). Use before create_draft_pr.",
-    { ref: z.string() },
-    async ({ ref }) => {
-      const preview = await orch.previewLand(ref);
-      return { content: [{ type: "text", text: JSON.stringify(preview, null, 2) }] };
-    }
-  );
-  server.tool(
-    "create_draft_pr",
-    "Commit dirty changes if needed, push the thread branch to origin, and create/update a DRAFT GitHub PR against that worktree's origin (never upstream). Ready-for-review / non-draft land stays human-only (CLI/app confirm_land). Prefer this when the orchestrator should open a PR itself; alternatively send_to_thread asking the worktree agent to run `gh pr create --draft -R <origin-owner/name>`.",
-    { ref: z.string() },
-    async ({ ref }) => {
-      try {
-        const result = await orch.confirmLand(ref, { draft: true });
-        return {
-          content: [
-            {
-              type: "text",
-              text: JSON.stringify(
-                {
-                  prUrl: result.prUrl,
-                  pushed: result.pushed,
-                  committed: result.committed,
-                  draft: true
-                },
-                null,
-                2
-              )
-            }
-          ]
-        };
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { content: [{ type: "text", text: message }], isError: true };
-      }
-    }
-  );
   server.tool(
     "list_branches",
     "List git branches in a registered workspace. Pass repoPath from list_workspaces (unmerged into the default branch by default \u2014 for create_thread sourceType=branch).",
@@ -4504,6 +4612,7 @@ export {
   spawnAgentTurn,
   formatRenameBranchDirective,
   formatWorktreeDirective,
+  formatArtifactDirective,
   loadAgentInstructions,
   formatAgentInstructions,
   withAgentInstructions,
@@ -4531,6 +4640,7 @@ export {
   listBranchCommits,
   getDiff,
   listWorktreeFiles,
+  readWorktreeFileForUpload,
   readWorktreeFile,
   writeWorktreeFile,
   getDiffSummary,

package/dist/{chunk-LIUV5ONW.js → chunk-PER4N6LS.js}

@@ -1,10 +1,10 @@
 import {
   isGlobalRepoPath
-} from "./chunk-5263JXQY.js";
+} from "./chunk-Y2EWQ4TL.js";
 import {
   ensureGhPreferOrigin,
   resolveRepoRoot
-} from "./chunk-LXHSRNJJ.js";
+} from "./chunk-UFWEANLU.js";
 import {
   appDataDir
 } from "./chunk-M37RITA6.js";