pi-roundtable-drawing 0.9.2 → 0.9.5

package/CHANGELOG.md

@@ -5,6 +5,18 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.9.5] - 2026-10-10
+
+0.9.4 was tagged but never published (its release checks failed on the recorded prompt texts); everything listed under it is released in 0.9.5.
+
+### Added
+
+- Every image tool also saves its picture as `<scratchDir>/drawings/<tool>-<timestamp>.png`, or under the workspace without a scratch dir, and names the path in its result, so the model can send it on with `attach_file` or a `discord_send_message` file `path`. It still attaches the picture to the reply, and a session with neither root (with pi-roundtable before 0.9.5, any session) only attaches it.
+
+## [0.9.3] - 2026-10-10
+
+- Release in lockstep with pi-roundtable 0.9.3; no package-specific behavior changes.
+
 ## [0.9.2] - 2026-10-10
 
 - Release in lockstep with pi-roundtable 0.9.2; no package-specific behavior changes.

package/README.md

@@ -106,6 +106,8 @@ Each tool draws one PNG and attaches it to the agent's reply with `turn.attachFi
 The model reads a short text back (the file name, and for card draws the cards), and a request it can fix comes back as a refusal with a plain message, such as `An edge references the unknown node "Ghost". Add it to nodes or fix the edge.`
 Nothing is attached for a refused call.
 
+In a session with a workspace (an agent's), the tool also saves the picture as `<scratchDir>/drawings/<tool>-<timestamp>.png`, or under the workspace when there is no scratch dir, and its result names that path, so the model can send the picture elsewhere with `attach_file` or a `discord_send_message` file `path` (pi-roundtable 0.9.5 or later). The picture's bytes never return to the model. A session with neither, such as a sandbox or an owner conversation, only attaches it.
+
 The tool does not send a message of its own: the host delivers the picture with the reply of the turn, after the agent's text, under the same name and avatar as the text.
 On Discord each picture goes out as one file in its own message.
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-roundtable-drawing",
-	"version": "0.9.2",
+	"version": "0.9.5",
 	"description": "Relationship maps, magic circles, sigils, sacred geometry, and card spreads drawn locally for pi-roundtable",
 	"type": "module",
 	"license": "MIT",
@@ -48,7 +48,7 @@
 	"devDependencies": {
 		"@biomejs/biome": "2.5.15",
 		"@types/bun": "1.4.2",
-		"pi-roundtable": "0.9.2",
+		"pi-roundtable": "0.9.5",
 		"typescript": "7.0.2"
 	}
 }

package/src/tools/image-tool.ts

@@ -1,3 +1,5 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
 import {
 	defineTool,
 	REPLY_FILE_LIMITS,
@@ -63,7 +65,31 @@ function checkArguments<Schema extends TObject>(
 }
 
 /**
- * A tool that draws one image and attaches it to the agent's reply as a file. A request the renderer
+ * Saves a picture under the session's scratch dir, or its workspace without one, so the model can
+ * send it on by path; says where, or why not. A session with neither saves nothing.
+ */
+async function saveDrawing(
+	tool: string,
+	image: Uint8Array,
+	turn: ToolTurn,
+): Promise<string | undefined> {
+	const root = turn.workspace?.scratchDir ?? turn.workspace?.workspace;
+	if (root === undefined) return undefined;
+	const dir = join(root, "drawings");
+	const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+	const path = join(dir, `${tool}-${stamp}.png`);
+	try {
+		await mkdir(dir, { recursive: true });
+		await writeFile(path, image, { flag: "wx" });
+	} catch (error) {
+		return `It was not saved to a file (${error instanceof Error ? error.message : String(error)}).`;
+	}
+	return `It is also saved at ${path}; to send it elsewhere, give this path to discord_send_message or attach_file rather than reading it.`;
+}
+
+/**
+ * A tool that draws one image, attaches it to the agent's reply as a file, and saves it in the
+ * session's scratch dir or workspace when it has one. A request the renderer
  * cannot honour comes back to the model as a refusal it can correct.
  */
 export function imageTool<Schema extends TObject>(
@@ -91,7 +117,9 @@ export function imageTool<Schema extends TObject>(
 					`The picture is ${(drawn.image.byteLength / 2 ** 20).toFixed(1)} MiB, over the ${REPLY_FILE_LIMITS.maxFileBytes / 2 ** 20} MiB a reply may carry. Ask for a smaller picture, such as fewer cards or a smaller size.`,
 				);
 			turn.attachFile({ name, data: drawn.image });
-			return drawn.text.replace("{file}", name);
+			const text = drawn.text.replace("{file}", name);
+			const saved = await saveDrawing(spec.name, drawn.image, turn);
+			return saved ? `${text}\n\n${saved}` : text;
 		},
 	});
 }