@possumtech/rummy 0.2.6 → 0.2.8

package/src/plugins/progress/progress.js

@@ -33,6 +33,12 @@ export default class Progress {
 		const status = [tokenInfo, unknownInfo].filter(Boolean).join(" · ");
 		if (status) parts.push(status);
 
+		if (ctx.demoted?.length > 0) {
+			parts.push(
+				`⚠ ${ctx.demoted.length} entries demoted to summary to fit context budget. Use <get/> to restore.`,
+			);
+		}
+
 		if (hasCurrent) {
 			parts.push(
 				"The above actions were performed in response to the following prompt:",

package/src/plugins/prompt/prompt.js

@@ -8,21 +8,20 @@ export default class Prompt {
 	}
 
 	async onTurnStarted({ rummy, mode, prompt, isContinuation }) {
-		const { entries: store, sequence: turn, runId } = rummy;
+		const { entries: store, sequence: turn, runId, loopId } = rummy;
 
 		if (!isContinuation && prompt) {
-			await store.upsert(runId, turn, `prompt://${turn}`, "", "info", {
+			await store.upsert(runId, turn, `prompt://${turn}`, "", 200, {
 				attributes: { mode },
+				loopId,
+			});
+			await store.upsert(runId, turn, `${mode}://${turn}`, prompt, 200, {
+				loopId,
 			});
-			await store.upsert(runId, turn, `${mode}://${turn}`, prompt, "info");
 		} else {
-			await store.upsert(
-				runId,
-				turn,
-				`progress://${turn}`,
-				prompt || "",
-				"info",
-			);
+			await store.upsert(runId, turn, `progress://${turn}`, prompt || "", 200, {
+				loopId,
+			});
 		}
 	}
 

package/src/plugins/rm/docs.md

@@ -1,4 +1,6 @@
 ## <rm path="[path/to/file]"/> - Remove a file or entry
 Example: <rm path="src/config.js"/>
-Example: <rm path="unknown://42"/>
+Example: <rm path="known://donald-rumsfeld-was-born-in-1932"/>
+Example: <rm path="known://temp_*" preview/> (preview before deleting)
 * <rm/> removes the file or entry from context and deletes it PERMANENTLY
+* Paths accept globs — use `preview` to check matches before deleting

package/src/plugins/rm/rm.js

@@ -1,13 +1,12 @@
 import { readFileSync } from "node:fs";
+import KnownStore from "../../agent/KnownStore.js";
 
 export default class Rm {
 	#core;
 
 	constructor(core) {
 		this.#core = core;
-		core.registerScheme({
-			validStates: ["full", "proposed", "pass", "rejected", "error", "pattern"],
-		});
+		core.registerScheme();
 		core.on("handler", this.handler.bind(this));
 		core.on("full", this.full.bind(this));
 		core.on("summary", this.summary.bind(this));
@@ -18,24 +17,42 @@ export default class Rm {
 	}
 
 	async handler(entry, rummy) {
-		const { entries: store, sequence: turn, runId } = rummy;
+		const { entries: store, sequence: turn, runId, loopId } = rummy;
 		const target = entry.attributes.path;
+		if (!target) {
+			await store.upsert(runId, turn, entry.resultPath, "", 400, {
+				attributes: { error: "path is required" },
+				loopId,
+			});
+			return;
+		}
+		const normalized = KnownStore.normalizePath(target);
 		const matches = await store.getEntriesByPattern(
 			runId,
-			target,
+			normalized,
 			entry.attributes.body,
 		);
 
+		if (matches.length === 0) {
+			await store.upsert(runId, turn, entry.resultPath, "", 404, {
+				attributes: { path: target, error: `${target} not found` },
+				loopId,
+			});
+			return;
+		}
+
 		for (const match of matches) {
 			const resultPath = `rm://${match.path}`;
 			if (match.scheme === null) {
-				await store.upsert(runId, turn, resultPath, match.path, "proposed", {
+				await store.upsert(runId, turn, resultPath, match.path, 202, {
 					attributes: { path: match.path },
+					loopId,
 				});
 			} else {
 				await store.remove(runId, match.path);
-				await store.upsert(runId, turn, resultPath, match.path, "pass", {
+				await store.upsert(runId, turn, resultPath, match.path, 200, {
 					attributes: { path: match.path },
+					loopId,
 				});
 			}
 		}

package/src/plugins/rpc/rpc.js

@@ -67,7 +67,7 @@ export default class Rpc {
 				const row = await ctx.db.upsert_model.get({
 					alias: params.alias,
 					actual: params.actual,
-					context_length: params.contextLength || null,
+					context_length: params.contextLength ?? null,
 				});
 				return { id: row.id, alias: params.alias };
 			},
@@ -90,7 +90,7 @@ export default class Rpc {
 
 		// --- Entry operations (same dispatch as model) ---
 
-		r.register("read", {
+		r.register("get", {
 			handler: async (params, ctx) => {
 				if (!params.path) throw new Error("path is required");
 
@@ -159,7 +159,7 @@ export default class Rpc {
 			requiresInit: true,
 		});
 
-		r.register("write", {
+		r.register("set", {
 			handler: async (params, ctx) => {
 				if (!params.path) throw new Error("path is required");
 				if (!params.run) throw new Error("run is required");
@@ -169,19 +169,15 @@ export default class Rpc {
 				if (scheme) {
 					await rummy.set({
 						path: params.path,
-						body: params.body || "",
-						state: params.state || "full",
+						body: params.body,
+						status: params.status || 200,
 						attributes: params.attributes,
 					});
 				} else {
-					await dispatchTool(
-						hooks,
-						rummy,
-						"set",
-						params.path,
-						params.body || "",
-						{ path: params.path, ...params.attributes },
-					);
+					await dispatchTool(hooks, rummy, "set", params.path, params.body, {
+						path: params.path,
+						...params.attributes,
+					});
 				}
 				return { status: "ok" };
 			},
@@ -190,13 +186,13 @@ export default class Rpc {
 				run: "string — run alias",
 				path: "string — entry path",
 				body: "string? — entry content",
-				state: "string? — entry state (default: full)",
+				status: "number? — HTTP status code (default: 200)",
 				attributes: "object? — JSON attributes",
 			},
 			requiresInit: true,
 		});
 
-		r.register("delete", {
+		r.register("rm", {
 			handler: async (params, ctx) => {
 				if (!params.path) throw new Error("path is required");
 				if (!params.run) throw new Error("run is required");
@@ -225,14 +221,15 @@ export default class Rpc {
 				if (!run) return [];
 				const entries = await ctx.projectAgent.entries.getEntriesByPattern(
 					run.id,
-					params.pattern || "*",
-					params.body || null,
-					{ limit: params.limit, offset: params.offset },
+					params.pattern ?? "*",
+					params.body ?? null,
+					{ limit: params.limit ?? null, offset: params.offset ?? null },
 				);
 				return entries.map((e) => ({
 					path: e.path,
 					scheme: e.scheme,
-					state: e.state,
+					status: e.status,
+					fidelity: e.fidelity,
 					tokens: e.tokens_full,
 				}));
 			},
@@ -256,7 +253,7 @@ export default class Rpc {
 				const runRow = await ctx.db.create_run.get({
 					project_id: ctx.projectId,
 					parent_run_id: null,
-					model: params.model,
+					model: params.model ?? null,
 					alias,
 					temperature: params.temperature ?? null,
 					persona: params.persona ?? null,
@@ -283,8 +280,8 @@ export default class Rpc {
 					params.prompt,
 					params.run,
 					{
-						temperature: params.temperature,
-						persona: params.persona,
+						temperature: params.temperature ?? null,
+						persona: params.persona ?? null,
 						contextLimit: params.contextLimit,
 						noContext: params.noContext,
 						fork: params.fork,
@@ -315,8 +312,8 @@ export default class Rpc {
 					params.prompt,
 					params.run,
 					{
-						temperature: params.temperature,
-						persona: params.persona,
+						temperature: params.temperature ?? null,
+						persona: params.persona ?? null,
 						contextLimit: params.contextLimit,
 						noContext: params.noContext,
 						fork: params.fork,
@@ -358,7 +355,7 @@ export default class Rpc {
 				ctx.projectAgent.abortRun(runRow.id);
 				await ctx.db.update_run_status.run({
 					id: runRow.id,
-					status: "aborted",
+					status: 499,
 				});
 				return { status: "ok" };
 			},
@@ -447,7 +444,7 @@ export default class Rpc {
 					run: row.alias,
 					status: row.status,
 					turn: row.turn,
-					summary: row.summary || "",
+					summary: row.summary,
 					created: row.created_at,
 				}));
 			},
@@ -512,8 +509,8 @@ export default class Rpc {
 							};
 						}),
 					},
-					last_user_prompt: promptRow?.body || "",
-					last_summary: summaryRow?.body || "",
+					last_user_prompt: promptRow?.body,
+					last_summary: summaryRow?.body,
 				};
 			},
 			description: "Full run detail.",
@@ -558,25 +555,19 @@ async function buildRunContext(hooks, ctx, runAlias) {
 
 async function dispatchTool(hooks, rummy, scheme, path, body, attributes) {
 	const store = rummy.entries;
-	const resultPath = await store.dedup(rummy.runId, scheme, path || "");
+	const resultPath = await store.dedup(rummy.runId, scheme, path);
 
-	await store.upsert(
-		rummy.runId,
-		rummy.sequence,
-		resultPath,
-		body || "",
-		"full",
-		{
-			attributes: attributes || null,
-		},
-	);
+	await store.upsert(rummy.runId, rummy.sequence, resultPath, body, 200, {
+		attributes: attributes,
+		loopId: rummy.loopId,
+	});
 
 	const entry = {
 		scheme,
 		path: resultPath,
-		body: body || "",
-		attributes: attributes || {},
-		state: "full",
+		body: body,
+		attributes: attributes,
+		status: 200,
 		resultPath,
 	};
 

package/src/plugins/set/docs.md

@@ -1,4 +1,6 @@
 ## <set path="[path/to/file]">[edit]</set> - Edit a file or entry
 Example: <set path="src/config.js">s/base_url = http:\/\/localhost/base_url = http:\/\/0.0.0.0/g s/port = 3000/port = 8080/g</set>
-* All editing syntaxes supported: s/old/new/, {"search":"old","replace":"new"}, SEARCH/REPLACE blocks
+* All editing syntaxes supported: s/old/new/, {"search":"old","replace":"new"}, literal SEARCH/REPLACE blocks
+* Chain multiple replacements: `s/old/new/ s/foo/bar/`
+* Regex patterns use /slashes/: `s/console\.log.*/\/\/ removed/g`
 * Do not use <sh/> or <env/> to read, create, update, or delete files or entries

package/src/plugins/set/set.js

@@ -9,9 +9,7 @@ export default class Set {
 
 	constructor(core) {
 		this.#core = core;
-		core.registerScheme({
-			validStates: ["full", "proposed", "pass", "rejected", "error", "pattern"],
-		});
+		core.registerScheme();
 		core.on("handler", this.handler.bind(this));
 		core.on("full", this.full.bind(this));
 		core.on("summary", this.summary.bind(this));
@@ -23,7 +21,7 @@ export default class Set {
 	}
 
 	async handler(entry, rummy) {
-		const { entries: store, sequence: turn, runId } = rummy;
+		const { entries: store, sequence: turn, runId, loopId } = rummy;
 		const attrs = entry.attributes;
 
 		if (attrs.blocks || attrs.search != null) {
@@ -45,7 +43,7 @@ export default class Set {
 				attrs.path,
 				attrs.body,
 				matches,
-				true,
+				{ preview: true, loopId },
 			);
 			return;
 		}
@@ -57,8 +55,9 @@ export default class Set {
 		if (scheme === null) {
 			const udiff = generatePatch(target, "", entry.body || "");
 			const merge = `<<<<<<< SEARCH\n=======\n${entry.body || ""}\n>>>>>>> REPLACE`;
-			await store.upsert(runId, turn, entry.resultPath, "", "proposed", {
+			await store.upsert(runId, turn, entry.resultPath, "", 202, {
 				attributes: { file: target, patch: udiff, merge },
+				loopId,
 			});
 		} else if (attrs.filter || target.includes("*")) {
 			const matches = await store.getEntriesByPattern(
@@ -80,9 +79,10 @@ export default class Set {
 				target,
 				attrs.filter,
 				matches,
+				{ loopId },
 			);
 		} else {
-			await store.upsert(runId, turn, target, entry.body, "full");
+			await store.upsert(runId, turn, target, entry.body, 200, { loopId });
 		}
 	}
 
@@ -103,13 +103,14 @@ export default class Set {
 	}
 
 	async #processEdit(rummy, entry, attrs) {
-		const { entries: store, sequence: turn, runId } = rummy;
+		const { entries: store, sequence: turn, runId, loopId } = rummy;
 		const target = attrs.path;
 		const matches = await store.getEntriesByPattern(runId, target, attrs.body);
 
 		if (matches.length === 0) {
-			await store.upsert(runId, turn, entry.resultPath, "", "error", {
+			await store.upsert(runId, turn, entry.resultPath, "", 404, {
 				attributes: { file: target, error: `${target} not found in context` },
+				loopId,
 			});
 			return;
 		}
@@ -121,8 +122,9 @@ export default class Set {
 				const existingAttrs = await rummy.getAttributes(canonicalPath);
 				const revisions = existingAttrs?.revisions || [];
 				revisions.push(revision);
-				await store.upsert(runId, turn, canonicalPath, "", "full", {
+				await store.upsert(runId, turn, canonicalPath, "", 200, {
 					attributes: { file: match.path, revisions },
+					loopId,
 				});
 				if (KnownStore.normalizePath(entry.resultPath) !== canonicalPath) {
 					await store.remove(runId, entry.resultPath);
@@ -133,7 +135,7 @@ export default class Set {
 			const { patch, searchText, replaceText, warning, error } =
 				Set.#applyRevision(match.body, attrs);
 
-			const state = error ? "error" : "pass";
+			const status = error ? 409 : 200;
 			const resultPath = `set://${match.path}`;
 			const udiff = patch ? generatePatch(match.path, match.body, patch) : null;
 			const merge =
@@ -143,7 +145,7 @@ export default class Set {
 			const beforeTokens = match.tokens_full || 0;
 			const afterTokens = patch ? (patch.length / 4) | 0 : beforeTokens;
 
-			await store.upsert(runId, turn, resultPath, match.body, state, {
+			await store.upsert(runId, turn, resultPath, match.body, status, {
 				attributes: {
 					file: match.path,
 					patch: udiff,
@@ -153,16 +155,19 @@ export default class Set {
 					warning,
 					error,
 				},
+				loopId,
 			});
 
-			if (state === "pass" && patch) {
-				await store.upsert(runId, turn, match.path, patch, match.state);
+			if (status === 200 && patch) {
+				await store.upsert(runId, turn, match.path, patch, match.status, {
+					loopId,
+				});
 			}
 		}
 	}
 
 	async #materializeRevisions({ rummy }) {
-		const { entries: store, sequence: turn, runId } = rummy;
+		const { entries: store, sequence: turn, runId, loopId } = rummy;
 		const setEntries = await store.getEntriesByPattern(runId, "set://*");
 
 		for (const entry of setEntries) {
@@ -198,7 +203,7 @@ export default class Set {
 				}
 			}
 
-			const state = lastError ? "error" : "proposed";
+			const state = lastError ? 409 : 202;
 			const udiff =
 				current !== original
 					? generatePatch(filePath, original, current)
@@ -217,6 +222,7 @@ export default class Set {
 					warning: lastWarning,
 					error: lastError,
 				},
+				loopId,
 			});
 		}
 	}

package/src/plugins/sh/sh.js

@@ -16,9 +16,10 @@ export default class Sh {
 	}
 
 	async handler(entry, rummy) {
-		const { entries: store, sequence: turn, runId } = rummy;
-		await store.upsert(runId, turn, entry.resultPath, entry.body, "proposed", {
+		const { entries: store, sequence: turn, runId, loopId } = rummy;
+		await store.upsert(runId, turn, entry.resultPath, entry.body, 202, {
 			attributes: entry.attributes,
+			loopId,
 		});
 	}
 

package/src/plugins/skills/skills.js

@@ -8,7 +8,6 @@ export default class Skills {
 		this.#core = core;
 		core.registerScheme({
 			name: "skill",
-			validStates: ["full", "stored"],
 			category: "knowledge",
 		});
 		const r = core.hooks.rpc.registry;
@@ -28,7 +27,7 @@ export default class Skills {
 					runRow.next_turn,
 					`skill://${params.name}`,
 					body,
-					"full",
+					200,
 					{
 						attributes: {
 							name: params.name,
@@ -84,10 +83,10 @@ export default class Skills {
 				);
 				return entries.map((e) => ({
 					name: e.path.replace("skill://", ""),
-					state: e.state,
+					status: e.status,
 				}));
 			},
-			description: "List skills active on a run. Returns [{ name, state }].",
+			description: "List skills active on a run. Returns [{ name, status }].",
 			params: { run: "string — run alias" },
 			requiresInit: true,
 		});

package/src/plugins/store/docs.md

@@ -1,5 +1,6 @@
 ## <store path="[path/to/file]"/> - Store a file or entry
 Example: <store path="src/config.js"/>
-Example: <store path="unknown://42"/>
+Example: <store path="src/**/*.test.js"/> (store all test files at once)
 * <store/> removes the file or entry from context, but does not delete it
 * A stored file or entry can be restored with <get/>
+* Paths accept globs for bulk operations

package/src/plugins/store/store.js

@@ -6,7 +6,7 @@ export default class Store {
 
 	constructor(core) {
 		this.#core = core;
-		core.registerScheme({ validStates: ["full", "stored", "pattern"] });
+		core.registerScheme();
 		core.on("handler", this.handler.bind(this));
 		core.on("full", this.full.bind(this));
 		core.on("summary", this.summary.bind(this));
@@ -17,8 +17,15 @@ export default class Store {
 	}
 
 	async handler(entry, rummy) {
-		const { entries: store, sequence: turn, runId } = rummy;
+		const { entries: store, sequence: turn, runId, loopId } = rummy;
 		const target = entry.attributes.path;
+		if (!target) {
+			await store.upsert(runId, turn, entry.resultPath, "", 400, {
+				attributes: { error: "path is required" },
+				loopId,
+			});
+			return;
+		}
 		const bodyFilter = entry.attributes.body || null;
 		const isPattern = bodyFilter || target.includes("*");
 		const matches = await store.getEntriesByPattern(runId, target, bodyFilter);
@@ -33,12 +40,16 @@ export default class Store {
 				target,
 				bodyFilter,
 				matches,
+				{ loopId },
 			);
 		} else {
 			const paths = matches.map((m) => m.path).join(", ");
 			const body =
 				matches.length > 0 ? `${paths} stored` : `${target} not found`;
-			await store.upsert(runId, turn, entry.resultPath, body, "stored");
+			await store.upsert(runId, turn, entry.resultPath, body, 200, {
+				fidelity: "stored",
+				loopId,
+			});
 		}
 	}
 

package/src/plugins/summarize/summarize.js

@@ -5,7 +5,7 @@ export default class Summarize {
 
 	constructor(core) {
 		this.#core = core;
-		core.registerScheme({ validStates: ["summary"], category: "structural" });
+		core.registerScheme({ category: "structural" });
 		core.on("full", this.full.bind(this));
 		core.on("summary", this.summary.bind(this));
 		const docs = readFileSync(new URL("./docs.md", import.meta.url), "utf8");

package/src/plugins/telemetry/telemetry.js

@@ -80,17 +80,23 @@ export default class Telemetry {
 		systemMsg,
 		userMsg,
 	}) {
-		const { entries: store, runId } = rummy;
+		const { entries: store, runId, loopId } = rummy;
 
 		// assistant://N — the model's raw response
-		await store.upsert(runId, turn, `assistant://${turn}`, content, "info");
+		await store.upsert(runId, turn, `assistant://${turn}`, content, 200, {
+			loopId,
+		});
 
 		// system://N, user://N — assembled messages as audit
 		if (systemMsg) {
-			await store.upsert(runId, turn, `system://${turn}`, systemMsg, "info");
+			await store.upsert(runId, turn, `system://${turn}`, systemMsg, 200, {
+				loopId,
+			});
 		}
 		if (userMsg) {
-			await store.upsert(runId, turn, `user://${turn}`, userMsg, "info");
+			await store.upsert(runId, turn, `user://${turn}`, userMsg, 200, {
+				loopId,
+			});
 		}
 
 		// model://N — raw API response diagnostics
@@ -105,7 +111,8 @@ export default class Telemetry {
 				usage: result.usage || null,
 				model: result.model || null,
 			}),
-			"info",
+			200,
+			{ loopId },
 		);
 
 		// reasoning://N
@@ -115,13 +122,16 @@ export default class Telemetry {
 				turn,
 				`reasoning://${turn}`,
 				responseMessage.reasoning_content,
-				"info",
+				200,
+				{ loopId },
 			);
 		}
 
 		// content://N — unparsed text
 		if (unparsed) {
-			await store.upsert(runId, turn, `content://${turn}`, unparsed, "info");
+			await store.upsert(runId, turn, `content://${turn}`, unparsed, 200, {
+				loopId,
+			});
 		}
 
 		// Commit usage stats

package/src/plugins/unknown/unknown.js

@@ -6,7 +6,6 @@ export default class Unknown {
 	constructor(core) {
 		this.#core = core;
 		core.registerScheme({
-			validStates: ["full", "stored"],
 			category: "knowledge",
 		});
 		core.on("full", this.full.bind(this));
@@ -25,7 +24,9 @@ export default class Unknown {
 		const entries = ctx.rows.filter((r) => r.category === "unknown");
 		if (entries.length === 0) return content;
 
-		const lines = entries.map((u) => `<unknown>${u.body}</unknown>`);
+		const lines = entries.map(
+			(u) => `<unknown path="${u.path}">${u.body}</unknown>`,
+		);
 		return `${content}\n\n<unknowns>\n${lines.join("\n")}\n</unknowns>`;
 	}
 }

package/src/plugins/update/update.js

@@ -5,7 +5,7 @@ export default class Update {
 
 	constructor(core) {
 		this.#core = core;
-		core.registerScheme({ validStates: ["info"], category: "structural" });
+		core.registerScheme({ category: "structural" });
 		core.on("full", this.full.bind(this));
 		core.on("summary", this.summary.bind(this));
 		const docs = readFileSync(new URL("./docs.md", import.meta.url), "utf8");

package/src/server/ClientConnection.js

@@ -110,7 +110,7 @@ export default class ClientConnection {
 
 			try {
 				const logRow = await this.#db.log_rpc_call.get({
-					project_id: this.#context.projectId || null,
+					project_id: this.#context.projectId ?? null,
 					method,
 					rpc_id: id,
 					params: params ? JSON.stringify(params) : null,
@@ -184,10 +184,8 @@ export default class ClientConnection {
 				} catch {}
 			}
 		} catch (error) {
-			if (debug) {
-				console.error(`[SOCKET] ERR: ${error.message}`);
-				console.error(`[DEBUG] Stack: ${error.stack}`);
-			}
+			console.error(`[RUMMY] RPC Error: ${error.message}`);
+			console.error(`[RUMMY] Stack: ${error.stack}`);
 			this.#send({
 				jsonrpc: "2.0",
 				error: { code: -32603, message: error.message },