@bivy/bivy 0.10.1-staging.301 → 0.10.1-staging.302

package/bin/bivy.mjs

@@ -2232,16 +2232,18 @@ async function cmdSend(args = []) {
   process.exit(code);
 }
 
-// `bivy attach <file> [--caption "…"] [--session <id>]` — surface a file the
-// agent produced into the chat as an image/file attachment (the reverse of the
-// composer paperclip). The universal path: any agent that can run a shell command
-// can call this. The session id defaults to $BIVY_SESSION_ID, which every
+// `bivy attach <file> [--caption "…"] [--artifact] [--session <id>]` — surface a
+// file the agent produced into the chat as an image/file attachment (the reverse
+// of the composer paperclip). The universal path: any agent that can run a shell
+// command can call this. The session id defaults to $BIVY_SESSION_ID, which every
 // runtime adapter injects into the agent's subprocess env (see
 // src/runtime/session-env.ts) — except pi, whose SDK exposes its own
 // $PI_SESSION_ID instead (same id, different var name; see
 // resolveAttachSessionId). The file is resolved to an absolute path here (the
 // CLI's cwd is the agent's workdir) and confined to the session workspace
-// server-side.
+// server-side. `--artifact` marks it as a named artifact (a durable output worth
+// surfacing in the session's Artifacts list) rather than an incidental inline
+// image — see packages/core/src/artifacts.ts.
 async function cmdAttach(args = []) {
   const flag = (name) => {
     const i = args.indexOf(name);
@@ -2251,6 +2253,7 @@ async function cmdAttach(args = []) {
   const caption = flag("--caption");
   const name = flag("--name");
   const mimeType = flag("--mime") || flag("--mimeType");
+  const artifact = args.includes("--artifact");
   const flagsWithValue = new Set(["--session", "--caption", "--name", "--mime", "--mimeType"]);
   // First positional that isn't a flag or a flag's value.
   let file;
@@ -2261,7 +2264,7 @@ async function cmdAttach(args = []) {
     file = a;
     break;
   }
-  if (!file) { console.error(c.red('Usage: bivy attach <file> [--caption "…"] [--session <id>]')); process.exit(1); return; }
+  if (!file) { console.error(c.red('Usage: bivy attach <file> [--caption "…"] [--artifact] [--session <id>]')); process.exit(1); return; }
   if (!sessionId) { console.error(c.red("No session id. Set --session <id> or run inside an agent session ($BIVY_SESSION_ID).")); process.exit(1); return; }
   const absPath = path.resolve(process.cwd(), file);
   if (!fs.existsSync(absPath)) { console.error(c.red(`File not found: ${file}`)); process.exit(1); return; }
@@ -2279,7 +2282,7 @@ async function cmdAttach(args = []) {
     res = await fetch(`${url(config)}/api/session/${encodeURIComponent(sessionId)}/attach`, {
       method: "POST",
       headers,
-      body: JSON.stringify({ path: absPath, caption, name, mimeType }),
+      body: JSON.stringify({ path: absPath, caption, name, mimeType, artifact }),
     });
   } catch (error) {
     console.error(c.red(`Could not reach the Bivy node: ${error?.message || String(error)}`));

package/dist/agents/claude-code/runtime.js

@@ -126,8 +126,13 @@ function buildAttachMcpServer(sdk, sessionId, attachToChat) {
         "cannot see files you only write to disk. The path must be inside the session workspace.", {
         filePath: z.string().describe("Path to the file, absolute or relative to the session workspace."),
         caption: z.string().optional().describe("Short caption shown next to the attachment in the chat."),
+        artifact: z
+            .boolean()
+            .optional()
+            .describe("Mark this as a named artifact — a durable output worth surfacing in the session's Artifacts list " +
+            "(a report, benchmark result, coverage output, or build archive) — rather than an incidental inline image."),
     }, async (args) => {
-        const result = attachToChat(sessionId, { filePath: args.filePath, caption: args.caption });
+        const result = attachToChat(sessionId, { filePath: args.filePath, caption: args.caption, ...(args.artifact ? { artifact: true } : {}) });
         if ("error" in result)
             return { content: [{ type: "text", text: result.error }], isError: true };
         return {

package/dist/harness/mcp-serve-cli.js

@@ -39,6 +39,11 @@ export const BIVY_MCP_TOOLS = [
             properties: {
                 path: { type: "string", description: "Path to the file to send, inside the session workspace (absolute, or relative to it)." },
                 caption: { type: "string", description: "Optional short note shown with the attachment." },
+                artifact: {
+                    type: "boolean",
+                    description: "Mark this as a named artifact — a durable output worth surfacing in the session's Artifacts list " +
+                        "(a report, benchmark result, coverage output, or build archive) — rather than an incidental inline image.",
+                },
             },
             required: ["path"],
             additionalProperties: false,
@@ -73,6 +78,7 @@ export async function runAttachToChat(endpoint, sessionId, args, fetchImpl, toke
     if (!filePath)
         return { isError: true, text: "Provide a `path` to a file inside the session workspace." };
     const caption = typeof args.caption === "string" ? args.caption : undefined;
+    const artifact = args.artifact === true;
     const base = endpoint.replace(/\/+$/, "");
     const headers = { "content-type": "application/json" };
     if (token)
@@ -82,7 +88,7 @@ export async function runAttachToChat(endpoint, sessionId, args, fetchImpl, toke
         res = await fetchImpl(`${base}/api/session/${encodeURIComponent(sessionId)}/attach`, {
             method: "POST",
             headers,
-            body: JSON.stringify({ path: filePath, caption }),
+            body: JSON.stringify({ path: filePath, caption, ...(artifact ? { artifact } : {}) }),
         });
     }
     catch (error) {

package/dist/integrations/manager.js

@@ -309,7 +309,8 @@ export class IntegrationManager {
                 if (!filePath)
                     return { content: [{ type: "text", text: "filePath is required" }], details: {}, isError: true };
                 const caption = typeof p.caption === "string" ? p.caption : undefined;
-                const result = attachToChat(sessionId, { filePath, caption });
+                const artifact = p.artifact === true;
+                const result = attachToChat(sessionId, { filePath, caption, ...(artifact ? { artifact } : {}) });
                 if ("error" in result)
                     return { content: [{ type: "text", text: result.error }], details: {}, isError: true };
                 return { content: [{ type: "text", text: `Attached ${result.ref.name} (${result.ref.kind}, ${result.ref.mimeType}) to the chat.` }], details: { ref: result.ref } };

package/dist/integrations/registry.js

@@ -37,6 +37,11 @@ export const ATTACH_TO_CHAT_TOOL = {
     parameters: Type.Object({
         filePath: Type.String({ description: "Path to the file, absolute or relative to the session workspace." }),
         caption: Type.Optional(Type.String({ description: "Short caption shown next to the attachment in the chat." })),
+        artifact: Type.Optional(Type.Boolean({
+            description: "Mark this as a named artifact — a durable output worth surfacing in the session's Artifacts list " +
+                "(a report, benchmark result, coverage output, or build archive) — rather than an incidental inline " +
+                "image. Leave unset for an ordinary screenshot or chart.",
+        })),
     }),
 };
 export const BUILT_IN_INTEGRATIONS = [

package/dist/server.js

@@ -1138,11 +1138,12 @@ function recordAttachment(record, bytes, opts) {
     (record.seenAttachmentHashes ??= new Set()).add(ref.hash);
     const entryId = `att-${randomBytes(8).toString("hex")}`;
     const caption = opts.caption ? String(opts.caption).slice(0, 2000) : undefined;
+    const artifact = Boolean(opts.artifact);
     // Anchor at the current base length so history replay interleaves the
     // attachment where it was emitted (see event-log outbound projection).
     const afterMessageCount = record.session.getMessages().length;
-    eventLog.appendOutboundAttachment(record.id, { afterMessageCount, id: entryId, ref, caption });
-    broadcast(stampSessionEvent({ type: "session.event", sessionId: record.id, event: { type: "attachment", id: entryId, ref, caption } }));
+    eventLog.appendOutboundAttachment(record.id, { afterMessageCount, id: entryId, ref, caption, artifact });
+    broadcast(stampSessionEvent({ type: "session.event", sessionId: record.id, event: { type: "attachment", id: entryId, ref, caption, ...(artifact ? { artifact } : {}) } }));
     return { ref };
 }
 /**
@@ -1161,7 +1162,7 @@ function attachToChat(record, opts) {
     });
     if (isAttachPlanError(plan))
         return { error: plan.error };
-    return recordAttachment(record, plan.bytes, { name: plan.name, mimeType: plan.mimeType, kind: plan.kind, caption: opts.caption });
+    return recordAttachment(record, plan.bytes, { name: plan.name, mimeType: plan.mimeType, kind: plan.kind, caption: opts.caption, artifact: opts.artifact });
 }
 /** Extension guess for a passively-surfaced tool image, from its mime type. */
 function extFromImageMime(mimeType) {
@@ -10472,6 +10473,7 @@ app.post("/api/session/:id/attach", (req, res) => {
         caption: typeof req.body?.caption === "string" ? req.body.caption : undefined,
         mimeType: typeof req.body?.mimeType === "string" ? req.body.mimeType : undefined,
         name: typeof req.body?.name === "string" ? req.body.name : undefined,
+        artifact: req.body?.artifact === true,
     });
     if ("error" in result)
         return res.status(400).json({ error: result.error });

package/dist/session/event-log.js

@@ -221,7 +221,7 @@ export function replayOutboundAttachments(entries) {
     }
     return [...byId.values()].map((entry) => ({
         role: "assistant",
-        content: [{ type: AGENT_ATTACHMENT_BLOCK, ref: entry.ref, caption: entry.caption }],
+        content: [{ type: AGENT_ATTACHMENT_BLOCK, ref: entry.ref, caption: entry.caption, ...(entry.artifact ? { artifact: true } : {}) }],
         afterMessageCount: entry.afterMessageCount,
         createdAt: entry.createdAt,
         id: entry.id,
@@ -451,6 +451,7 @@ export class EventLog {
             id: entry.id,
             ref: { ...entry.ref },
             ...(entry.caption ? { caption: entry.caption } : {}),
+            ...(entry.artifact ? { artifact: true } : {}),
         };
         this.enqueue(id, `oa:${entry.id}`, record);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bivy/bivy",
-  "version": "0.10.1-staging.301",
+  "version": "0.10.1-staging.302",
   "type": "module",
   "license": "AGPL-3.0-only",
   "description": "Run coding agents on machines you own. Open-source, self-hostable agent workspace.",