@prometheus-ai/agent 0.5.3 → 0.5.8

package/src/cli/gallery-fixtures/edit.ts

@@ -0,0 +1,194 @@
+/** Gallery fixtures for the edit tools (edit, apply_patch, ast_edit). */
+import type { GalleryFixture } from "./types";
+
+export const editFixtures: Record<string, GalleryFixture> = {
+	edit: {
+		label: "Edit",
+		editMode: "replace",
+		// `previewDiff` is surfaced verbatim by the renderer's call preview, and the
+		// harness diff strategy skips `{ file_path, previewDiff }` (no `path`/`edits`),
+		// so the canned diff survives the streaming and progress states.
+		streamingArgs: {
+			file_path: "packages/coding-agent/src/tools/read.ts",
+			previewDiff: [
+				"@@ -88,3 +88,4 @@",
+				" 	const offset = args.offset ?? 1;",
+				"-	const limit = args.limit ?? 2000;",
+				"+	const limit = args.limit ?? 4000;",
+			].join("\n"),
+		},
+		args: {
+			file_path: "packages/coding-agent/src/tools/read.ts",
+			previewDiff: [
+				"@@ -88,5 +88,6 @@",
+				" 	const offset = args.offset ?? 1;",
+				"-	const limit = args.limit ?? 2000;",
+				"+	const limit = args.limit ?? 4000;",
+				" 	const raw = await Bun.file(path).text();",
+				"-	return raw.slice(offset, offset + limit);",
+				'+	return raw.split("\\n").slice(offset - 1, offset - 1 + limit).join("\\n");',
+			].join("\n"),
+		},
+		result: {
+			content: [{ type: "text", text: "Edited packages/coding-agent/src/tools/read.ts (1 hunk, +3 -2)" }],
+			details: {
+				path: "packages/coding-agent/src/tools/read.ts",
+				firstChangedLine: 89,
+				diff: [
+					"@@ -88,5 +88,6 @@",
+					" 	const offset = args.offset ?? 1;",
+					"-	const limit = args.limit ?? 2000;",
+					"+	const limit = args.limit ?? 4000;",
+					" 	const raw = await Bun.file(path).text();",
+					"-	return raw.slice(offset, offset + limit);",
+					'+	return raw.split("\\n").slice(offset - 1, offset - 1 + limit).join("\\n");',
+				].join("\n"),
+			},
+		},
+		errorResult: {
+			content: [
+				{
+					type: "text",
+					text: "Edit failed: the search text was not found in packages/coding-agent/src/tools/read.ts",
+				},
+			],
+			isError: true,
+			details: {
+				path: "packages/coding-agent/src/tools/read.ts",
+				diff: "",
+				errorText:
+					"No match for the search text. Expected `const limit = args.limit ?? 2000;` near line 89, but the file has `const limit = args.limit ?? 1000;`. Re-read the file and retry with the current contents.",
+			},
+		},
+	},
+
+	apply_patch: {
+		label: "Apply Patch",
+		editMode: "apply_patch",
+		streamingArgs: {
+			file_path: "packages/coding-agent/src/edit/renderer.ts",
+			previewDiff: [
+				"@@ -464,2 +464,2 @@",
+				"-		fileCount = countEditFiles(editArgs.edits);",
+				"+		fileCount = countDistinctFiles(editArgs.edits);",
+			].join("\n"),
+		},
+		args: {
+			file_path: "packages/coding-agent/src/edit/renderer.ts",
+			previewDiff: [
+				"@@ -177,4 +177,4 @@",
+				" /** Count distinct file paths in an edits array. */",
+				"-function countEditFiles(edits: EditRenderEntry[]): number {",
+				"+function countDistinctFiles(edits: EditRenderEntry[]): number {",
+				" 	return new Set(edits.map(edit => filePathFromEditEntry(edit.path)).filter(Boolean)).size;",
+				" }",
+				"@@ -467,2 +467,2 @@",
+				"-		fileCount = countEditFiles(editArgs.edits);",
+				"+		fileCount = countDistinctFiles(editArgs.edits);",
+			].join("\n"),
+		},
+		result: {
+			content: [
+				{ type: "text", text: "Applied patch to packages/coding-agent/src/edit/renderer.ts (2 hunks, +2 -2)" },
+			],
+			details: {
+				op: "update",
+				path: "packages/coding-agent/src/edit/renderer.ts",
+				firstChangedLine: 178,
+				diff: [
+					"@@ -177,4 +177,4 @@",
+					" /** Count distinct file paths in an edits array. */",
+					"-function countEditFiles(edits: EditRenderEntry[]): number {",
+					"+function countDistinctFiles(edits: EditRenderEntry[]): number {",
+					" 	return new Set(edits.map(edit => filePathFromEditEntry(edit.path)).filter(Boolean)).size;",
+					" }",
+					"@@ -467,2 +467,2 @@",
+					"-		fileCount = countEditFiles(editArgs.edits);",
+					"+		fileCount = countDistinctFiles(editArgs.edits);",
+				].join("\n"),
+			},
+		},
+		errorResult: {
+			content: [
+				{
+					type: "text",
+					text: "Apply patch failed: context does not match at line 177 of packages/coding-agent/src/edit/renderer.ts",
+				},
+			],
+			isError: true,
+			details: {
+				op: "update",
+				path: "packages/coding-agent/src/edit/renderer.ts",
+				diff: "",
+				errorText:
+					"Hunk @@ -177,4 +177,4 @@ failed to apply: the context line `function countEditFiles(edits: EditRenderEntry[]): number {` does not match the file. The file may have changed since it was read.",
+			},
+		},
+	},
+
+	ast_edit: {
+		label: "AST Edit",
+		streamingArgs: {
+			ops: [{ pat: "countEditFiles($$$ARGS)" }],
+			paths: ["packages/coding-agent/src/**/*.ts"],
+		},
+		args: {
+			ops: [{ pat: "countEditFiles($$$ARGS)", out: "countDistinctFiles($$$ARGS)" }],
+			paths: ["packages/coding-agent/src/**/*.ts"],
+		},
+		result: {
+			content: [
+				{
+					type: "text",
+					text: [
+						"# edit/renderer.ts (2 replacements)",
+						"-468:		fileCount = countEditFiles(editArgs.edits);",
+						"+468:		fileCount = countDistinctFiles(editArgs.edits);",
+						"-488:		const totalFiles = args?.edits ? countEditFiles(args.edits) : 0;",
+						"+488:		const totalFiles = args?.edits ? countDistinctFiles(args.edits) : 0;",
+						"",
+						"# tools/tool-result.ts (1 replacement)",
+						"-42:	return countEditFiles(files);",
+						"+42:	return countDistinctFiles(files);",
+					].join("\n"),
+				},
+			],
+			details: {
+				totalReplacements: 3,
+				filesTouched: 2,
+				filesSearched: 214,
+				applied: false,
+				limitReached: false,
+				scopePath: "packages/coding-agent/src",
+				searchPath: "/Users/dev/Projects/pi/packages/coding-agent/src",
+				files: ["edit/renderer.ts", "tools/tool-result.ts"],
+				fileReplacements: [
+					{ path: "edit/renderer.ts", count: 2 },
+					{ path: "tools/tool-result.ts", count: 1 },
+				],
+				displayContent: [
+					"# edit/",
+					"## renderer.ts (2 replacements)",
+					"-468│		fileCount = countEditFiles(editArgs.edits);",
+					"+468│		fileCount = countDistinctFiles(editArgs.edits);",
+					"-488│		const totalFiles = args?.edits ? countEditFiles(args.edits) : 0;",
+					"+488│		const totalFiles = args?.edits ? countDistinctFiles(args.edits) : 0;",
+					"",
+					"# tools/",
+					"## tool-result.ts (1 replacement)",
+					"-42│	return countEditFiles(files);",
+					"+42│	return countDistinctFiles(files);",
+				].join("\n"),
+			},
+		},
+		errorResult: {
+			content: [
+				{
+					type: "text",
+					text: "Pattern parse error in ops[0].pat: unbalanced parenthesis in `countEditFiles($$$ARGS`",
+				},
+			],
+			isError: true,
+		},
+	},
+};

package/src/cli/gallery-fixtures/fs.ts

@@ -0,0 +1,220 @@
+// biome-ignore-all lint/suspicious/noTemplateCurlyInString: sample source-code strings (read fixtures) intentionally contain literal ${...}.
+// Gallery fixtures for the filesystem tools (read, write, find).
+import { ReadToolGroupComponent } from "../../modes/components/read-tool-group";
+import type { GalleryFixture, GalleryFixtureState, GalleryResult } from "./types";
+
+const readSnippet = [
+	"export const findToolRenderer = {",
+	"\tinline: true,",
+	"\trenderCall(args: FindRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component {",
+	"\t\tconst meta: string[] = [];",
+	"\t\tif (args.limit !== undefined) meta.push(`limit:${args.limit}`);",
+	"",
+	"\t\tconst text = renderStatusLine(",
+	'\t\t\t{ icon: "pending", title: "Find", description: formatFindRenderPaths(args.paths) || "*", meta },',
+	"\t\t\tuiTheme,",
+	"\t\t);",
+	"\t\treturn new Text(text, 0, 0);",
+	"\t},",
+].join("\n");
+
+const writtenContent = [
+	'import { describe, expect, it } from "bun:test";',
+	'import { parseSel } from "../src/tools/read";',
+	"",
+	'describe("parseSel", () => {',
+	'\tit("parses a single line range", () => {',
+	'\t\texpect(parseSel("42-58")).toEqual({',
+	'\t\t\tkind: "lines",',
+	"\t\t\tranges: [{ startLine: 42, endLine: 58 }],",
+	"\t\t});",
+	"\t});",
+	"",
+	'\tit("treats raw as a verbatim selector", () => {',
+	'\t\texpect(parseSel("raw")).toEqual({ kind: "raw" });',
+	"\t});",
+	"});",
+	"",
+].join("\n");
+
+const groupedReadTargets = [
+	"packages/coding-agent/test/streaming-preview-height.test.ts:301-409",
+	"packages/coding-agent/test/tool-live-region-scrollback.test.ts:143-310",
+	"packages/tui/test/streaming-scrollback-defer.test.ts:89-464",
+];
+
+const groupedReadDelimitedPath = groupedReadTargets.join(",");
+const groupedReadRepeatedFile = "packages/coding-agent/src/task/render.ts";
+const groupedReadRepeatedRanges = `${groupedReadRepeatedFile}:507-605,1070-1194,1210-1240,1270-1274`;
+
+function textResult(text: string, details?: unknown, isError?: boolean): GalleryResult {
+	return { content: [{ type: "text", text }], details, isError };
+}
+
+function addGroupedReadArgs(component: ReadToolGroupComponent): void {
+	component.updateArgs({ path: groupedReadDelimitedPath }, "read-delimited");
+	component.updateArgs({ path: groupedReadRepeatedRanges }, "read-ranges");
+}
+
+function renderReadGroupFixtureState(state: GalleryFixtureState, width: number, expanded: boolean): readonly string[] {
+	const component = new ReadToolGroupComponent();
+	component.setExpanded(expanded);
+
+	if (state === "streaming") {
+		component.updateArgs(
+			{
+				path: [
+					"packages/coding-agent/test/streaming-preview-height.test.ts:301-409",
+					"packages/coding-agent/test/tool-live-region-scrollback.test.ts:143-",
+				].join(","),
+			},
+			"read-delimited",
+		);
+		return component.render(width);
+	}
+
+	addGroupedReadArgs(component);
+	if (state === "progress") return component.render(width);
+
+	component.updateResult(
+		textResult("Read three focused test ranges.", { displayReadTargets: groupedReadTargets }),
+		false,
+		"read-delimited",
+	);
+
+	if (state === "error") {
+		component.updateResult(
+			textResult("Error: selector 1270-1274 is outside the file", undefined, true),
+			false,
+			"read-ranges",
+		);
+		return component.render(width);
+	}
+
+	component.updateResult(textResult("Read four render.ts ranges."), false, "read-ranges");
+	return component.render(width);
+}
+
+export const fsFixtures: Record<string, GalleryFixture> = {
+	read: {
+		label: "Read",
+		// Streaming: path still being typed, selector not yet appended.
+		streamingArgs: { path: "packages/coding-agent/src/tools/find" },
+		args: { path: "packages/coding-agent/src/tools/find.ts:437-448" },
+		result: {
+			content: [
+				{
+					type: "text",
+					text: [
+						"[packages/coding-agent/src/tools/find.ts#E48E]",
+						"437:export const findToolRenderer = {",
+						"438:\tinline: true,",
+						"439:\trenderCall(args: FindRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component {",
+						"440:\t\tconst meta: string[] = [];",
+						"441:\t\tif (args.limit !== undefined) meta.push(`limit:${args.limit}`);",
+						"442:",
+						"443:\t\tconst text = renderStatusLine(",
+						'444:\t\t\t{ icon: "pending", title: "Find", description: formatFindRenderPaths(args.paths) || "*", meta },',
+						"445:\t\t\tuiTheme,",
+						"446:\t\t);",
+						"447:\t\treturn new Text(text, 0, 0);",
+						"448:\t},",
+					].join("\n"),
+				},
+			],
+			details: {
+				kind: "file",
+				resolvedPath: "/Users/dev/Projects/pi/packages/coding-agent/src/tools/find.ts",
+				contentType: "text/typescript",
+				displayContent: { text: readSnippet, startLine: 437 },
+			},
+		},
+		errorResult: {
+			isError: true,
+			content: [
+				{
+					type: "text",
+					text: "Error: ENOENT: no such file or directory, open 'packages/coding-agent/src/tools/find.ts'",
+				},
+			],
+		},
+	},
+
+	read_group: {
+		label: "Read Groups",
+		args: {},
+		result: textResult("Rendered grouped read calls."),
+		errorResult: textResult("Rendered grouped read errors.", undefined, true),
+		renderState: renderReadGroupFixtureState,
+	},
+
+	write: {
+		label: "Write",
+		// Streaming: path known, content still arriving (only the imports so far).
+		streamingArgs: {
+			path: "packages/coding-agent/test/parse-sel.test.ts",
+			content: 'import { describe, expect, it } from "bun:test";\nimport { parseSel } from "../src/tools/read";\n',
+		},
+		args: {
+			path: "packages/coding-agent/test/parse-sel.test.ts",
+			content: writtenContent,
+		},
+		result: {
+			content: [
+				{
+					type: "text",
+					text: "Created packages/coding-agent/test/parse-sel.test.ts (17 lines, 412 bytes).",
+				},
+			],
+			details: {},
+		},
+		errorResult: {
+			isError: true,
+			content: [
+				{
+					type: "text",
+					text: "Error: EACCES: permission denied, open 'packages/coding-agent/test/parse-sel.test.ts'",
+				},
+			],
+		},
+	},
+
+	find: {
+		label: "Find",
+		// Streaming: glob half-typed, no limit yet.
+		streamingArgs: { paths: ["packages/coding-agent/src/tools/*-render"] },
+		args: { paths: ["packages/coding-agent/src/**/*.test.ts"], limit: 50 },
+		result: {
+			content: [
+				{
+					type: "text",
+					text: [
+						"packages/coding-agent/src/tools/read.test.ts",
+						"packages/coding-agent/src/tools/write.test.ts",
+						"packages/coding-agent/src/tools/find.test.ts",
+						"packages/coding-agent/src/cli/gallery-cli.test.ts",
+						"packages/coding-agent/src/edit/edit.test.ts",
+					].join("\n"),
+				},
+			],
+			details: {
+				scopePath: "packages/coding-agent/src",
+				cwd: "/Users/dev/Projects/pi",
+				fileCount: 5,
+				truncated: false,
+				files: [
+					"packages/coding-agent/src/cli/gallery-cli.test.ts",
+					"packages/coding-agent/src/edit/edit.test.ts",
+					"packages/coding-agent/src/tools/find.test.ts",
+					"packages/coding-agent/src/tools/read.test.ts",
+					"packages/coding-agent/src/tools/write.test.ts",
+				],
+			},
+		},
+		errorResult: {
+			isError: true,
+			content: [{ type: "text", text: "Find failed: invalid glob pattern '[unclosed'." }],
+			details: { error: "invalid glob pattern '[unclosed'" },
+		},
+	},
+};

package/src/cli/gallery-fixtures/index.ts

@@ -0,0 +1,40 @@
+/**
+ * Aggregated sample data for the `prometheus gallery` command.
+ *
+ * Each fixture drives one tool's renderer through the four lifecycle states the
+ * gallery showcases: arguments streaming in, arguments complete but awaiting a
+ * result, a successful result, and a failed result. The data is intentionally
+ * hand-written (rather than schema-derived) so the gallery reflects what a real
+ * tool call looks like — the whole point is visual QA of the renderers.
+ *
+ * Fixtures are grouped by subsystem into sibling modules and merged here.
+ * Adding a tool to one of those groups is enough for the gallery to render it.
+ * Tools present in the renderer registry but missing here fall back to a
+ * generic fixture (see `gallery-cli.ts`), so the gallery never crashes on a
+ * newly added tool — it just looks plain until a fixture is supplied.
+ */
+import { agenticFixtures } from "./agentic";
+import { codeintelFixtures } from "./codeintel";
+import { editFixtures } from "./edit";
+import { fsFixtures } from "./fs";
+import { interactionFixtures } from "./interaction";
+import { memoryFixtures } from "./memory";
+import { miscFixtures } from "./misc";
+import { searchFixtures } from "./search";
+import { shellFixtures } from "./shell";
+import { webFixtures } from "./web";
+
+export * from "./types";
+
+export const galleryFixtures = {
+	...interactionFixtures,
+	...shellFixtures,
+	...fsFixtures,
+	...searchFixtures,
+	...editFixtures,
+	...agenticFixtures,
+	...memoryFixtures,
+	...webFixtures,
+	...codeintelFixtures,
+	...miscFixtures,
+};

package/src/cli/gallery-fixtures/interaction.ts

@@ -0,0 +1,49 @@
+/** Gallery fixtures for the todo / ask / resolve interaction tools. */
+import type { GalleryFixture } from "./types";
+
+export const interactionFixtures: Record<string, GalleryFixture> = {
+	todo: {
+		label: "Todo",
+		streamingArgs: {
+			ops: [{ op: "init", list: [{ phase: "Foundation", items: ["Scaffold crate"] }] }],
+		},
+		args: {
+			ops: [
+				{
+					op: "init",
+					list: [
+						{ phase: "Foundation", items: ["Scaffold crate", "Wire workspace"] },
+						{ phase: "Auth", items: ["Port credential store", "Wire OAuth providers"] },
+					],
+				},
+			],
+		},
+		result: {
+			content: [{ type: "text", text: "Initialized 4 tasks across 2 phases" }],
+			details: {
+				storage: "session",
+				phases: [
+					{
+						name: "Foundation",
+						tasks: [
+							{ content: "Scaffold crate", status: "done" },
+							{ content: "Wire workspace", status: "in_progress" },
+						],
+					},
+					{
+						name: "Auth",
+						tasks: [
+							{ content: "Port credential store", status: "pending" },
+							{ content: "Wire OAuth providers", status: "pending" },
+						],
+					},
+				],
+				completedTasks: [{ phase: "Foundation", content: "Scaffold crate" }],
+			},
+		},
+		errorResult: {
+			content: [{ type: "text", text: "Unknown phase 'Auth' — initialize the list first" }],
+			isError: true,
+		},
+	},
+};

package/src/cli/gallery-fixtures/memory.ts

@@ -0,0 +1,81 @@
+// Gallery fixtures for the long-term memory tools (retain, recall, reflect).
+import type { GalleryFixture } from "./types";
+
+export const memoryFixtures: Record<string, GalleryFixture> = {
+	retain: {
+		label: "Retain",
+		// Streaming: first item complete, second still arriving without a context.
+		streamingArgs: {
+			items: [{ content: "User prefers Bun over Node for all new scripts in this repo." }],
+		},
+		args: {
+			items: [
+				{
+					content: "User prefers Bun over Node for all new scripts in this repo.",
+					context: "Established while wiring up the gallery command tooling.",
+				},
+				{
+					content: "The TUI renderers live in packages/coding-agent/src/tools/*-render.ts.",
+					context: "Discovered during the gallery-fixtures task.",
+				},
+			],
+		},
+		result: {
+			content: [{ type: "text", text: "2 memories stored." }],
+			details: { count: 2 },
+		},
+		errorResult: {
+			isError: true,
+			content: [{ type: "text", text: "Retain failed: memory store is not initialized." }],
+		},
+	},
+
+	recall: {
+		label: "Recall",
+		// Streaming: query partially typed.
+		streamingArgs: { query: "bun vs node" },
+		args: { query: "Which runtime does the user prefer for scripts?" },
+		result: {
+			content: [
+				{
+					type: "text",
+					text: [
+						"Found 2 relevant memories:",
+						"",
+						"1. [0.92] User prefers Bun over Node for all new scripts in this repo.",
+						"   (Established while wiring up the gallery command tooling.)",
+						"2. [0.78] The TUI renderers live in packages/coding-agent/src/tools/*-render.ts.",
+						"   (Discovered during the gallery-fixtures task.)",
+					].join("\n"),
+				},
+			],
+		},
+		errorResult: {
+			isError: true,
+			content: [{ type: "text", text: "Recall failed: vector index unavailable." }],
+		},
+	},
+
+	reflect: {
+		label: "Reflect",
+		streamingArgs: { query: "what have we learned about the user's" },
+		args: { query: "What have we learned about the user's tooling preferences?" },
+		result: {
+			content: [
+				{
+					type: "text",
+					text: [
+						"The user consistently favors Bun as the runtime for scripts in this",
+						"repository, avoiding Node where possible. They also track the location",
+						"of TUI renderers under packages/coding-agent/src/tools, suggesting an",
+						"interest in keeping rendering logic discoverable and well-organized.",
+					].join("\n"),
+				},
+			],
+		},
+		errorResult: {
+			isError: true,
+			content: [{ type: "text", text: "Reflect failed: no memories matched the query." }],
+		},
+	},
+};