@usepipr/sdk 0.4.3 → 0.6.0

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as AutoResolveUserRepliesOptions, A as Task, At as reviewResultSchema, B as AgentExtension, Bt as SchemaParseResult, C as PriorReview, Ct as ReviewFinding, D as ReviewRecipeOptions, Dt as parseReviewResult, E as ReviewEntrypoints, Et as parseReviewFinding, F as ToolRunOptions, Ft as JsonSchema, G as JsonPromptOptions, H as AgentTool, I as defaultReviewActions, It as JsonSchemaDefinition, J as PromptText, K as Markdown, L as defaultReviewEntrypoints, Lt as JsonValue, M as TaskContext, Mt as reviewSummarySchema, N as TaskDefinition, Nt as JsonObject, O as Reviewer, Ot as parseReviewSummary, P as TaskHandler, Pt as JsonPrimitive, Q as AutoResolveOptions, R as Agent, Rt as Schema, S as PriorInlineFinding, St as RuntimeLimits, T as ReviewCommentContext, Tt as ReviewSummary, U as BuiltinSchemaCatalog, V as AgentPromptContext, Vt as ZodSchema, W as BuiltinToolCatalog, X as AggregateCheckOptions, Y as PromptValue, Z as AutoResolveAllowedActors, _ as PiRunner, _t as DiffManifestOptions, a as md, at as PiprConfigOptions, b as PlatformInfo, bt as RangeKind, c as ChangeRequestContext, ct as SecretOptions, d as CheckHandle, et as ChangeRequestAction, f as CommandContext, ft as CommentableRange, g as DefaultReviewInput, gt as DiffManifestLimits, h as CommentValue, ht as DiffManifestFile, i as schemas, it as ModelProfile, j as TaskCheckOptions, jt as reviewSchemaExample, k as ReviewerOptions, kt as reviewFindingSchema, l as ChangeRequestInfo, lt as SecretRef, m as CommandRegistrationOptions, mt as DiffManifest, n as jsonSchema, nt as DurationInput, o as definePipr, ot as PublicationOptions, p as CommandOptions, pt as DiffHunk, q as PromptSource, r as schema, rt as ModelOptions, s as definePlugin, st as RepositoryPermission, t as z, tt as ChecksOptions, u as ChangeRequestRegistrationOptions, v as PiprBuilder, vt as FileStatus, w as RepositoryInfo, wt as ReviewResult, x as PluginToolDefinition, xt as ReviewSide, y as PiprPlugin, yt as PathFilter, z as AgentDefinition, zt as SchemaDefinition } from "./index-D_XmBHeL.mjs";
-export { type Agent, type AgentDefinition, type AgentExtension, type AgentPromptContext, type AgentTool, type AggregateCheckOptions, type AutoResolveAllowedActors, type AutoResolveOptions, type AutoResolveUserRepliesOptions, type BuiltinSchemaCatalog, type BuiltinToolCatalog, type ChangeRequestAction, type ChangeRequestContext, type ChangeRequestInfo, type ChangeRequestRegistrationOptions, type CheckHandle, type ChecksOptions, type CommandContext, type CommandOptions, type CommandRegistrationOptions, type CommentValue, type CommentableRange, type DefaultReviewInput, type DiffHunk, type DiffManifest, type DiffManifestFile, type DiffManifestLimits, type DiffManifestOptions, type DurationInput, type FileStatus, type JsonObject, type JsonPrimitive, type JsonPromptOptions, type JsonSchema, type JsonSchemaDefinition, type JsonValue, type Markdown, type ModelOptions, type ModelProfile, type PathFilter, type PiRunner, type PiprBuilder, type PiprConfigOptions, type PiprPlugin, type PlatformInfo, type PluginToolDefinition, type PriorInlineFinding, type PriorReview, type PromptSource, type PromptText, type PromptValue, type PublicationOptions, type RangeKind, type RepositoryInfo, type RepositoryPermission, type ReviewCommentContext, type ReviewEntrypoints, type ReviewFinding, type ReviewRecipeOptions, type ReviewResult, type ReviewSide, type ReviewSummary, type Reviewer, type ReviewerOptions, type RuntimeLimits, type Schema, type SchemaDefinition, type SchemaParseResult, type SecretOptions, type SecretRef, type Task, type TaskCheckOptions, type TaskContext, type TaskDefinition, type TaskHandler, type ToolRunOptions, type ZodSchema, defaultReviewActions, defaultReviewEntrypoints, definePipr, definePlugin, jsonSchema, md, parseReviewFinding, parseReviewResult, parseReviewSummary, reviewFindingSchema, reviewResultSchema, reviewSchemaExample, reviewSummarySchema, schema, schemas, z };
+import { $ as AutoResolveOptions, $t as SchemaParseResult, A as ReviewRecipeOptions, At as PiprRunTrigger, B as AgentDefinition, Bt as parseReviewSummary, C as PluginToolDefinition, Ct as PathFilter, D as ReviewCommentContext, Dt as PiprResult, E as RepositoryInfo, Et as RuntimeLimits, F as TaskHandler, Ft as ReviewResult, G as BuiltinToolCatalog, Gt as reviewSummarySchema, H as AgentPromptContext, Ht as reviewFindingsResultSchema, I as ToolRunOptions, It as ReviewSummary, J as PromptSource, Jt as JsonSchema, K as JsonPromptOptions, Kt as JsonObject, L as defaultReviewActions, Lt as parseReviewFinding, M as TaskCheckOptions, Mt as piprResultSchema, N as TaskContext, Nt as ReviewFinding, O as ReviewEntrypoints, Ot as PiprRunContext, P as TaskDefinition, Pt as ReviewFindingsResult, Q as AutoResolveAllowedActors, Qt as SchemaDefinition, R as defaultReviewEntrypoints, Rt as parseReviewFindingsResult, S as PlatformInfo, St as FileStatus, T as PriorReview, Tt as ReviewSide, U as AgentTool, Ut as reviewResultSchema, V as AgentExtension, Vt as reviewFindingSchema, W as BuiltinSchemaCatalog, Wt as reviewSchemaExample, X as PromptValue, Xt as JsonValue, Y as PromptText, Yt as JsonSchemaDefinition, Z as AggregateCheckOptions, Zt as Schema, _ as DefaultReviewSummaryInput, _t as DiffHunk, a as md, at as ModelProfile, b as PiprBuilder, bt as DiffManifestLimits, c as ChangeRequestContext, ct as PublicationOptions, d as CheckHandle, dt as SecretRef, en as ZodSchema, et as AutoResolveUserRepliesOptions, f as CommandContext, g as DefaultReviewInput, gt as CommentableRange, h as CommentValue, ht as ChangedFile, i as schemas, it as ModelOptions, j as Task, jt as parsePiprResult, k as ReviewInstructions, kt as PiprRunSummary, l as ChangeRequestInfo, lt as RepositoryPermission, m as CommandRegistrationOptions, mt as modelThinkingLevels, n as jsonSchema, nt as ChecksOptions, o as definePipr, ot as ModelThinkingLevel, p as CommandOptions, q as Markdown, qt as JsonPrimitive, r as schema, rt as DurationInput, s as definePlugin, st as PiprConfigOptions, t as z, tt as ChangeRequestAction, u as ChangeRequestRegistrationOptions, ut as SecretOptions, v as DefaultReviewSummaryManifest, vt as DiffManifest, w as PriorInlineFinding, wt as RangeKind, x as PiprPlugin, xt as DiffManifestOptions, y as PiRunner, yt as DiffManifestFile, z as Agent, zt as parseReviewResult } from "./index-Bdey1nho.mjs";
+export { type Agent, type AgentDefinition, type AgentExtension, type AgentPromptContext, type AgentTool, type AggregateCheckOptions, type AutoResolveAllowedActors, type AutoResolveOptions, type AutoResolveUserRepliesOptions, type BuiltinSchemaCatalog, type BuiltinToolCatalog, type ChangeRequestAction, type ChangeRequestContext, type ChangeRequestInfo, type ChangeRequestRegistrationOptions, type ChangedFile, type CheckHandle, type ChecksOptions, type CommandContext, type CommandOptions, type CommandRegistrationOptions, type CommentValue, type CommentableRange, type DefaultReviewInput, type DefaultReviewSummaryInput, type DefaultReviewSummaryManifest, type DiffHunk, type DiffManifest, type DiffManifestFile, type DiffManifestLimits, type DiffManifestOptions, type DurationInput, type FileStatus, type JsonObject, type JsonPrimitive, type JsonPromptOptions, type JsonSchema, type JsonSchemaDefinition, type JsonValue, type Markdown, type ModelOptions, type ModelProfile, type ModelThinkingLevel, type PathFilter, type PiRunner, type PiprBuilder, type PiprConfigOptions, type PiprPlugin, type PiprResult, type PiprRunContext, type PiprRunSummary, type PiprRunTrigger, type PlatformInfo, type PluginToolDefinition, type PriorInlineFinding, type PriorReview, type PromptSource, type PromptText, type PromptValue, type PublicationOptions, type RangeKind, type RepositoryInfo, type RepositoryPermission, type ReviewCommentContext, type ReviewEntrypoints, type ReviewFinding, type ReviewFindingsResult, type ReviewInstructions, type ReviewRecipeOptions, type ReviewResult, type ReviewSide, type ReviewSummary, type RuntimeLimits, type Schema, type SchemaDefinition, type SchemaParseResult, type SecretOptions, type SecretRef, type Task, type TaskCheckOptions, type TaskContext, type TaskDefinition, type TaskHandler, type ToolRunOptions, type ZodSchema, defaultReviewActions, defaultReviewEntrypoints, definePipr, definePlugin, jsonSchema, md, modelThinkingLevels, parsePiprResult, parseReviewFinding, parseReviewFindingsResult, parseReviewResult, parseReviewSummary, piprResultSchema, reviewFindingSchema, reviewFindingsResultSchema, reviewResultSchema, reviewSchemaExample, reviewSummarySchema, schema, schemas, z };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as configFactoryBrand, i as builtinReadOnlyToolBrand, o as assertSupportedCommandRestCapture, r as renderPromptValue } from "./config-Ct0Qfa_b.mjs";
+import { a as serializePromptJson, i as renderPromptValue, o as configFactoryBrand, r as modelThinkingLevels, s as assertSupportedCommandRestCapture } from "./config-CpCLnuAf.mjs";
 import { z, z as z$1 } from "zod";
 //#region src/prompt.ts
 /** Creates trimmed Markdown from a template literal with common indentation removed. */
@@ -18,6 +18,110 @@ function stripCommonIndent(value) {
 	return lines.map((line) => line.slice(indent)).join("\n");
 }
 //#endregion
+//#region src/runtime-handles.ts
+const taskRecords = /* @__PURE__ */ new WeakMap();
+const agentRecords = /* @__PURE__ */ new WeakMap();
+const toolRecords = /* @__PURE__ */ new WeakMap();
+function createTaskHandle(definition) {
+	const handle = {
+		kind: "pipr.task",
+		name: definition.name
+	};
+	const record = {
+		name: definition.name,
+		check: definition.check,
+		...definition.local === false ? { local: false } : {},
+		handler: definition.run
+	};
+	taskRecords.set(handle, record);
+	return {
+		handle,
+		record
+	};
+}
+function runtimeTaskForHandle(task) {
+	const record = taskRecords.get(task);
+	if (!record) throw new Error("Expected a task handle created by pipr.task");
+	return record;
+}
+function createAgentHandle(definition) {
+	const handle = {
+		kind: "pipr.agent",
+		name: definition.name,
+		extend(patch) {
+			return createAgentHandle({
+				...definition,
+				...patch,
+				instructions: patch.instructions === void 0 ? definition.instructions : {
+					kind: "pipr.prompt",
+					value: `${renderPromptValue(definition.instructions)}\n\n${renderPromptValue(patch.instructions)}`.trim()
+				}
+			}).handle;
+		}
+	};
+	const record = {
+		name: definition.name,
+		definition: runtimeAgentDefinition(definition)
+	};
+	agentRecords.set(handle, record);
+	return {
+		handle,
+		record
+	};
+}
+function runtimeAgentForHandle(agent) {
+	const record = agentRecords.get(agent);
+	if (!record) throw new Error("Expected an agent handle created by pipr.agent");
+	return record;
+}
+function createToolHandle(definition) {
+	const handle = {
+		kind: "pipr.tool",
+		name: definition.name
+	};
+	const record = {
+		name: definition.name,
+		description: definition.description,
+		input: definition.input,
+		output: definition.output,
+		run: definition.run,
+		toModelOutput: definition.toModelOutput
+	};
+	toolRecords.set(handle, record);
+	return {
+		handle,
+		record
+	};
+}
+function createBuiltinReadOnlyToolHandle() {
+	const handle = {
+		kind: "pipr.tool",
+		name: "readOnly"
+	};
+	const record = {
+		name: "readOnly",
+		builtinReadOnly: true
+	};
+	toolRecords.set(handle, record);
+	return {
+		handle,
+		record
+	};
+}
+function runtimeToolForHandle(tool) {
+	const record = toolRecords.get(tool);
+	if (!record) throw new Error("Expected a tool handle created by pipr.tool");
+	return record;
+}
+function runtimeAgentDefinition(definition) {
+	return {
+		...definition,
+		prompt: definition.prompt,
+		output: definition.output,
+		tools: definition.tools?.map(runtimeToolForHandle)
+	};
+}
+//#endregion
 //#region src/review-contract.ts
 const nonEmptyStringSchema = z$1.string().min(1);
 const positiveIntegerSchema = z$1.number().int().positive();
@@ -36,6 +140,8 @@ const reviewFindingSchema = z$1.strictObject({
 	endLine: positiveIntegerSchema,
 	suggestedFix: nonEmptyStringSchema.optional()
 });
+/** Zod schema for Pipr's core inline-finding result. */
+const reviewFindingsResultSchema = z$1.strictObject({ inlineFindings: z$1.array(reviewFindingSchema) });
 /** Zod schema for Pipr's core change request review result. */
 const reviewResultSchema = z$1.strictObject({
 	summary: reviewSummarySchema,
@@ -45,6 +151,10 @@ const reviewResultSchema = z$1.strictObject({
 function parseReviewResult(value) {
 	return reviewResultSchema.parse(value);
 }
+/** Parses model output for Pipr's inline-finding schema. */
+function parseReviewFindingsResult(value) {
+	return reviewFindingsResultSchema.parse(value);
+}
 /** Parses a review summary value. */
 function parseReviewSummary(value) {
 	return reviewSummarySchema.parse(value);
@@ -89,6 +199,7 @@ function jsonSchema(definition) {
 }
 /** Built-in schemas available as reusable agent output contracts. */
 const schemas = {
+	inlineFindings: createZodSchema("core/inline-findings", reviewFindingsResultSchema),
 	review: createZodSchema(coreReviewOutputSchemaId, reviewResultSchema),
 	summary: createZodSchema("core/summary", reviewSummarySchema)
 };
@@ -173,20 +284,17 @@ function createBuilder() {
 	const commands = [];
 	const tools = [];
 	const publication = {};
+	const readOnlyTool = createBuiltinReadOnlyToolHandle();
 	let checks;
 	let limits;
 	const api = {
-		tools: { readOnly: [{
-			kind: "pipr.tool",
-			name: "readOnly",
-			[builtinReadOnlyToolBrand]: true
-		}] },
+		tools: { readOnly: [readOnlyTool.handle] },
 		schemas,
 		on: { changeRequest(options) {
 			if (!Array.isArray(options.actions) || !options.task) throw new Error("pipr.on.changeRequest requires { actions, task }");
 			changeRequestTriggers.push({
 				actions: [...options.actions],
-				task: options.task
+				task: runtimeTaskForHandle(options.task)
 			});
 		} },
 		secret(options) {
@@ -200,39 +308,32 @@ function createBuilder() {
 		model(options) {
 			if (!options || typeof options.provider !== "string" || typeof options.model !== "string") throw new Error("pipr.model requires { provider, model }");
 			if (!options.provider || !options.model) throw new Error("pipr.model requires provider and model");
+			if (options.thinking !== void 0 && !modelThinkingLevels.includes(options.thinking)) throw new Error(`pipr.model received unsupported thinking level '${options.thinking}'`);
 			const profile = {
 				kind: "pipr.model",
 				id: options.id ?? `${options.provider}/${options.model}`,
 				provider: options.provider,
 				model: options.model,
 				apiKey: options.apiKey,
-				options: options.options
+				thinking: options.thinking
 			};
 			models.push(profile);
 			return profile;
 		},
 		agent(definition) {
-			const agent = createAgent(definition);
-			agents.push(agent);
-			return agent;
+			const agent = createAgentHandle(definition);
+			agents.push(agent.record);
+			return agent.handle;
 		},
 		task(definition) {
 			if (!definition.name || typeof definition.run !== "function") throw new Error("pipr.task requires { name, run }");
-			const task = {
-				kind: "pipr.task",
-				name: definition.name,
-				check: definition.check,
-				...definition.local === false ? { local: false } : {},
-				handler: definition.run
-			};
-			tasks.push(task);
-			return task;
-		},
-		reviewer(options) {
-			return createReviewer(api, options);
+			const task = createTaskHandle(definition);
+			tasks.push(task.record);
+			return task.handle;
 		},
 		review(options) {
 			assertKnownReviewRecipeOptions(options);
+			if (!options.model || !models.includes(options.model)) throw new Error("pipr.review requires a registered model.");
 			registerReviewRecipe(api, options);
 		},
 		config(options) {
@@ -253,7 +354,7 @@ function createBuilder() {
 				permission: options.permission ?? "write",
 				description: options.description,
 				parse: options.parse,
-				task: options.task
+				task: runtimeTaskForHandle(options.task)
 			});
 		},
 		use(plugin) {
@@ -263,13 +364,12 @@ function createBuilder() {
 			if (definition.name === "readOnly") throw new Error("Tool name 'readOnly' is reserved for pipr built-in tools");
 			const run = definition.run;
 			if (!run) throw new Error(`Tool '${definition.name}' must define run`);
-			const tool = {
-				kind: "pipr.tool",
+			const tool = createToolHandle({
 				...definition,
 				run
-			};
-			tools.push(tool);
-			return tool;
+			});
+			tools.push(tool.record);
+			return tool.handle;
 		},
 		schema,
 		jsonSchema,
@@ -291,7 +391,7 @@ function createBuilder() {
 			};
 		},
 		json(value, options) {
-			const text = JSON.stringify(value, null, options?.pretty === false ? 0 : 2);
+			const text = serializePromptJson(value, options?.pretty !== false);
 			if (options?.maxCharacters !== void 0 && text.length > options.maxCharacters) throw new Error(`JSON prompt value exceeded ${options.maxCharacters} characters`);
 			return {
 				kind: "pipr.prompt",
@@ -306,6 +406,7 @@ function createBuilder() {
 			assertUnique(commands.map((command) => command.pattern), "command");
 			assertModelIdentity(models);
 			return {
+				resolveAgent: runtimeAgentForHandle,
 				models,
 				agents,
 				tasks,
@@ -321,7 +422,7 @@ function createBuilder() {
 }
 function registerReviewRecipe(api, options) {
 	const id = options.id;
-	registerReviewRecipeEntrypoints(api, createReviewRecipeTask(api, id, options.reviewer ?? createReviewer(api, reviewRecipeReviewerOptions(options, id)), options), options);
+	registerReviewRecipeEntrypoints(api, createReviewRecipeTask(api, id, createReviewFindingsAgent(api, options), createReviewSummaryAgent(api, options), options), options);
 }
 const reviewRecipeOptionKeys = /* @__PURE__ */ new Set([
 	"id",
@@ -330,12 +431,9 @@ const reviewRecipeOptionKeys = /* @__PURE__ */ new Set([
 	"check",
 	"timeout",
 	"paths",
-	"reviewer",
-	"name",
 	"model",
 	"fallbacks",
 	"instructions",
-	"prompt",
 	"tools"
 ]);
 const reviewRecipeEntrypointKeys = /* @__PURE__ */ new Set(["changeRequest", "command"]);
@@ -370,6 +468,7 @@ const aggregateCheckOptionsSchema = z$1.union([z$1.literal(false), z$1.strictObj
 })]);
 const checksOptionsSchema = z$1.strictObject({ aggregate: aggregateCheckOptionsSchema.optional() });
 const diffManifestLimitsSchema = z$1.strictObject({
+	maxShards: z$1.number().int().positive().optional(),
 	fullMaxBytes: z$1.number().int().positive().optional(),
 	fullMaxEstimatedTokens: z$1.number().int().positive().optional(),
 	condensedMaxBytes: z$1.number().int().positive().optional(),
@@ -378,6 +477,7 @@ const diffManifestLimitsSchema = z$1.strictObject({
 });
 const runtimeLimitsSchema = z$1.strictObject({
 	timeoutSeconds: z$1.number().int().positive().max(3600).optional(),
+	maxAgentRuns: z$1.number().int().positive().optional(),
 	diffManifest: diffManifestLimitsSchema.optional()
 });
 const piprConfigOptionsSchema = z$1.strictObject({
@@ -388,12 +488,17 @@ const piprConfigOptionsSchema = z$1.strictObject({
 function assertKnownReviewRecipeOptions(options) {
 	const unknownKeys = Object.keys(options).filter((key) => !reviewRecipeOptionKeys.has(key));
 	if (unknownKeys.length > 0) throw new Error(`pipr.review received unsupported option fields: ${unknownKeys.join(", ")}.`);
+	const instructions = options.instructions;
+	if (!instructions || typeof instructions !== "object" || !isPromptSource(instructions.findings) || !isPromptSource(instructions.summary)) throw new Error("pipr.review instructions require both findings and summary.");
 	const entrypoints = options.entrypoints;
 	if (entrypoints && typeof entrypoints === "object") {
 		const unknownEntrypointKeys = Object.keys(entrypoints).filter((key) => !reviewRecipeEntrypointKeys.has(key));
 		if (unknownEntrypointKeys.length > 0) throw new Error(`pipr.review entrypoints received unsupported fields: ${unknownEntrypointKeys.join(", ")}.`);
 	}
 }
+function isPromptSource(value) {
+	return typeof value === "string" && value.length > 0 || typeof value === "object" && value !== null;
+}
 function assertKnownPiprConfigOptions(options) {
 	const parsed = piprConfigOptionsSchema.safeParse(options);
 	if (!parsed.success) throw new Error(formatPiprConfigOptionsError(parsed.error));
@@ -420,33 +525,37 @@ function piprConfigLabel(pathSegments) {
 	const path = pathSegments.join(".");
 	return path ? `pipr.config ${path}` : "pipr.config";
 }
-function reviewRecipeReviewerOptions(options, name) {
-	if (!options.model || !options.instructions) throw new Error("pipr.review requires model and instructions when reviewer is not provided");
-	return {
-		name,
+function createReviewFindingsAgent(api, options) {
+	return api.agent({
+		name: `${options.id}-findings`,
 		model: options.model,
 		fallbacks: options.fallbacks,
-		instructions: options.instructions,
-		prompt: options.prompt,
-		tools: options.tools,
-		timeout: options.timeout
-	};
+		instructions: options.instructions.findings,
+		tools: options.tools ?? api.tools.readOnly,
+		output: api.schemas.inlineFindings,
+		timeout: options.timeout,
+		prompt: () => api.prompt`Review this change for actionable inline findings.`
+	});
 }
-function createReviewer(api, options) {
+function createReviewSummaryAgent(api, options) {
 	return api.agent({
-		name: options.name ?? "reviewer",
+		name: `${options.id}-summary`,
 		model: options.model,
 		fallbacks: options.fallbacks,
-		instructions: options.instructions,
+		instructions: options.instructions.summary,
 		tools: options.tools ?? api.tools.readOnly,
-		output: api.schemas.review,
+		output: api.schemas.summary,
 		timeout: options.timeout,
-		prompt: options.prompt ?? (() => api.prompt`
-          Review this change.
-        `)
+		prompt: ({ inlineFindings, manifestSummary }) => api.prompt`
+        Summarize this change using the merged inline findings as evidence.
+
+        ${api.section("Scoped compressed manifest", api.json(manifestSummary, { maxCharacters: 6e4 }))}
+
+        ${api.section("Merged inline findings", api.json(inlineFindings, { maxCharacters: 6e4 }))}
+      `
 	});
 }
-function createReviewRecipeTask(api, id, agent, options) {
+function createReviewRecipeTask(api, id, findingsAgent, summaryAgent, options) {
 	return api.task({
 		name: id,
 		check: options.check,
@@ -460,15 +569,27 @@ function createReviewRecipeTask(api, id, agent, options) {
 				await context.comment({ main: "No changed files matched this review's path scope." });
 				return;
 			}
-			const result = await context.pi.run(agent, {
+			const findings = await context.pi.run(findingsAgent, {
 				manifest,
 				change: context.change
 			}, {
 				timeout: options.timeout,
 				paths: options.paths
 			});
+			const result = {
+				summary: await context.pi.run(summaryAgent, {
+					manifestSummary: defaultReviewSummaryManifest(manifest),
+					change: context.change,
+					inlineFindings: findings.inlineFindings
+				}, {
+					timeout: options.timeout,
+					paths: options.paths
+				}),
+				inlineFindings: findings.inlineFindings
+			};
 			const source = typeof options.comment === "function" ? await options.comment(result, {
 				review: { id },
+				run: context.run,
 				repository: context.repository,
 				change: context.change,
 				platform: context.platform
@@ -477,6 +598,35 @@ function createReviewRecipeTask(api, id, agent, options) {
 		}
 	});
 }
+function defaultReviewSummaryManifest(manifest) {
+	const maxSerializedFileCharacters = 4e4;
+	const files = [];
+	let serializedFileCharacters = 0;
+	for (const file of manifest.files) {
+		const projected = {
+			path: file.path.slice(0, 1e3),
+			...file.previousPath ? { previousPath: file.previousPath.slice(0, 1e3) } : {},
+			status: file.status,
+			...file.language ? { language: file.language.slice(0, 100) } : {},
+			additions: file.additions,
+			deletions: file.deletions,
+			...file.changedSymbols?.length ? { changedSymbols: file.changedSymbols.slice(0, 20).map((symbol) => symbol.slice(0, 200)) } : {},
+			...file.excludedReason ? { excludedReason: file.excludedReason.slice(0, 500) } : {}
+		};
+		const projectedCharacters = JSON.stringify(projected).length;
+		if (serializedFileCharacters + projectedCharacters > maxSerializedFileCharacters) continue;
+		files.push(projected);
+		serializedFileCharacters += projectedCharacters;
+	}
+	return {
+		baseSha: manifest.baseSha,
+		headSha: manifest.headSha,
+		mergeBaseSha: manifest.mergeBaseSha,
+		fileCount: manifest.files.length,
+		omittedFileCount: manifest.files.length - files.length,
+		files
+	};
+}
 function defaultReviewComment(result) {
 	return {
 		main: defaultReviewMarkdown(result),
@@ -558,23 +708,6 @@ function assertDiffManifestLimitConflicts(current, next) {
 		for (const [key, value] of Object.entries(next.diffManifest)) if (value !== void 0 && current.diffManifest[key] !== void 0 && current.diffManifest[key] !== value) throw new Error(`pipr.config limits.diffManifest.${key} conflicts with existing value`);
 	}
 }
-function createAgent(definition) {
-	return {
-		kind: "pipr.agent",
-		name: definition.name,
-		definition,
-		extend(patch) {
-			return createAgent({
-				...definition,
-				...patch,
-				instructions: patch.instructions === void 0 ? definition.instructions : {
-					kind: "pipr.prompt",
-					value: `${renderPromptValue(definition.instructions)}\n\n${renderPromptValue(patch.instructions)}`.trim()
-				}
-			});
-		}
-	};
-}
 function assertUnique(values, label) {
 	const seen = /* @__PURE__ */ new Set();
 	for (const value of values) {
@@ -594,7 +727,7 @@ function assertNoDuplicateModelConfigs(models) {
 			provider: model.provider,
 			model: model.model,
 			apiKeyEnv: model.apiKey?.name,
-			options: model.options
+			thinking: model.thinking
 		});
 		const existingConfigId = effectiveConfigs.get(effectiveConfig);
 		if (existingConfigId) throw new Error(`Duplicate model config for '${model.id}'. Reuse model '${existingConfigId}' instead.`);
@@ -629,6 +762,128 @@ function stableJsonValue(value) {
 	return value;
 }
 //#endregion
-export { defaultReviewActions, defaultReviewEntrypoints, definePipr, definePlugin, jsonSchema, md, parseReviewFinding, parseReviewResult, parseReviewSummary, reviewFindingSchema, reviewResultSchema, reviewSchemaExample, reviewSummarySchema, schema, schemas, z };
+//#region src/result.ts
+const piprRunTriggers = [
+	"change-request",
+	"command",
+	"verifier",
+	"local"
+];
+const text = z$1.string().min(1);
+const count = z$1.number().int().nonnegative();
+const header = { formatVersion: z$1.literal(2) };
+const runSummarySchema = z$1.strictObject({
+	id: text.max(200),
+	trigger: z$1.enum(piprRunTriggers),
+	baseSha: text.max(200),
+	headSha: text.max(200),
+	tasks: z$1.array(text.max(200)).max(200),
+	durationMs: count,
+	models: z$1.array(text.max(200)).max(20),
+	agentRuns: count,
+	inputTokens: count,
+	outputTokens: count,
+	costUsd: z$1.number().nonnegative().finite(),
+	usageStatus: z$1.enum([
+		"complete",
+		"partial",
+		"unavailable"
+	])
+});
+const inlineCountsSchema = z$1.strictObject({
+	posted: count,
+	skipped: count,
+	failed: count
+});
+const publicationCountsSchema = z$1.strictObject({
+	inlineComments: inlineCountsSchema,
+	inlinePublicationErrorCount: count,
+	inlineResolutionErrorCount: count
+});
+const reviewPublicationSchema = z$1.discriminatedUnion("state", [z$1.strictObject({ state: z$1.literal("disabled") }), z$1.strictObject({
+	state: z$1.literal("completed"),
+	mainComment: z$1.strictObject({ action: z$1.enum(["created", "updated"]) }),
+	...publicationCountsSchema.shape
+})]);
+const schemas$1 = [
+	z$1.strictObject({
+		...header,
+		kind: z$1.literal("review"),
+		run: runSummarySchema,
+		mainComment: z$1.string(),
+		inlineFindings: z$1.array(reviewFindingSchema),
+		droppedFindings: z$1.array(z$1.strictObject({
+			finding: reviewFindingSchema,
+			reason: text
+		})),
+		taskChecks: z$1.array(z$1.strictObject({
+			taskName: text,
+			conclusion: z$1.enum([
+				"success",
+				"failure",
+				"neutral"
+			]),
+			summary: text.optional()
+		})),
+		repairAttempted: z$1.boolean(),
+		publication: reviewPublicationSchema
+	}),
+	z$1.strictObject({
+		...header,
+		kind: z$1.literal("skipped"),
+		reason: text
+	}),
+	z$1.strictObject({
+		...header,
+		kind: z$1.literal("ignored"),
+		reason: text
+	}),
+	z$1.strictObject({
+		...header,
+		kind: z$1.literal("dry-run")
+	}),
+	z$1.strictObject({
+		...header,
+		kind: z$1.literal("command-help"),
+		reason: text,
+		mainComment: z$1.string()
+	}),
+	z$1.strictObject({
+		...header,
+		kind: z$1.literal("command-response"),
+		run: runSummarySchema,
+		mainComment: z$1.string(),
+		publication: z$1.strictObject({
+			state: z$1.literal("completed"),
+			action: z$1.enum(["created", "updated"])
+		})
+	}),
+	z$1.strictObject({
+		...header,
+		kind: z$1.literal("verifier"),
+		run: runSummarySchema,
+		publication: z$1.strictObject({
+			state: z$1.literal("completed"),
+			inlineResolutionErrorCount: count
+		})
+	}),
+	z$1.strictObject({
+		...header,
+		kind: z$1.literal("publication-error"),
+		message: text,
+		publication: publicationCountsSchema.optional()
+	}),
+	z$1.strictObject({
+		...header,
+		kind: z$1.literal("error"),
+		message: text
+	})
+];
+const piprResultSchema = z$1.discriminatedUnion("kind", schemas$1);
+function parsePiprResult(value) {
+	return piprResultSchema.parse(value);
+}
+//#endregion
+export { defaultReviewActions, defaultReviewEntrypoints, definePipr, definePlugin, jsonSchema, md, modelThinkingLevels, parsePiprResult, parseReviewFinding, parseReviewFindingsResult, parseReviewResult, parseReviewSummary, piprResultSchema, reviewFindingSchema, reviewFindingsResultSchema, reviewResultSchema, reviewSchemaExample, reviewSummarySchema, schema, schemas, z };
 
 //# sourceMappingURL=index.mjs.map