@pantheon.ai/agents 0.0.9 → 0.0.11

package/README.md

@@ -1,16 +1,43 @@
 # `@pantheon.ai/agents`
 
-This package contains:
+This package provides the `pantheon-agents` CLI for managing agent configs and tasks backed by a TiDB/MySQL task list.
+
+It includes:
 
 - A **runner loop** (`pantheon-agents run <agent>`) that executes queued tasks via Pantheon and persists status/output to TiDB.
 - A **client-facing server** (`pantheon-agents server`) that exposes the same task operations over **HTTP REST** and **MCP (HTTP+SSE)**.
 
-## Prerequisites
+## Build
+
+```bash
+npm run -w @pantheon.ai/agents build
+```
+
+## Environment variables
+
+- `DATABASE_URL` (required): MySQL/TiDB connection string for the task list database.
+- `PANTHEON_API_KEY` (required for some commands): Used to query/execute Pantheon branches.
+- `PANTHEON_AGENTS_API_TOKEN` (optional): Bearer token for API auth when running `pantheon-agents server` (defaults for `--token`).
+
+Command requirements:
+
+- `pantheon-agents add-task|delete-task|show-config|show-tasks`: requires `DATABASE_URL`
+- `pantheon-agents run`: requires `DATABASE_URL` + `PANTHEON_API_KEY`
+- `pantheon-agents config`: requires `DATABASE_URL`, and requires `PANTHEON_API_KEY` when `--bootstrap` is enabled (default) or when `--root-branch-id` is not provided
+- `pantheon-agents reconfig`: requires `DATABASE_URL` + `PANTHEON_API_KEY`
+- `pantheon-agents server`: requires `DATABASE_URL`; auth uses `--token` or env `PANTHEON_AGENTS_API_TOKEN` (unless `--no-auth`)
 
-- `DATABASE_URL` (TiDB/MySQL connection string) must be set for all commands that touch the DB.
-- `PANTHEON_API_KEY` is required for the runner loop (`pantheon-agents run`) and bootstrap config flows.
+Notes:
 
-### DB schema / migrations
+- `PANTHEON_API_KEY` is also required for config-related server endpoints/tools that read Pantheon branch output or re-bootstrap configs.
+
+## Show tasks output modes
+
+- Default: concise one-line entries.
+- Table output: use `--no-concise`.
+- JSON output: use `--json`.
+
+## DB schema / migrations
 
 The schema lives in `packages/agents/src/db/schema/tidb.sql`.
 
@@ -59,6 +86,15 @@ curl -sS -H "Authorization: Bearer $TOKEN" \\
 
 curl -sS -H "Authorization: Bearer $TOKEN" \\
   -X DELETE http://127.0.0.1:8000/api/v1/agents/<agent>/tasks/<task_id>
+
+# Get agent config (includes bootstrap branch output)
+curl -sS -H "Authorization: Bearer $TOKEN" \\
+  http://127.0.0.1:8000/api/v1/agents/<agent>/configs/<project_id>
+
+# Re-bootstrap agent config (like `pantheon-agents reconfig`)
+curl -sS -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \\
+  -X POST http://127.0.0.1:8000/api/v1/agents/<agent>/configs/<project_id>/reconfig \\
+  -d '{ "role": "reviewer", "skills": ["style-reviewer"] }'
 ```
 
 ### MCP (HTTP+SSE)
@@ -73,4 +109,5 @@ Tools:
 - `tasks.create`
 - `tasks.cancel`
 - `tasks.delete`
-
+- `configs.get`
+- `configs.reconfig`

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
-import * as process$1 from "node:process";
-import { createCommand } from "commander";
+import { Command, createCommand } from "commander";
+import process$1 from "node:process";
 import * as fs from "node:fs";
 import path from "node:path";
 import { multistream, pino, transport } from "pino";
@@ -420,7 +420,7 @@ var require_cli_options = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 
 //#endregion
 //#region package.json
-var version$1 = "0.0.9";
+var version$1 = "0.0.11";
 
 //#endregion
 //#region src/schemas/task-list.ts
@@ -611,6 +611,13 @@ var TaskListTidbProvider = class extends TaskListProvider {
 			...config
 		}).execute();
 	}
+	async updateAgentConfig({ skills, ...config }) {
+		const result = await this.db.updateTable("agent_project_config").set({
+			skills: JSON.stringify(skills),
+			...config
+		}).where("agent", "=", this.agentName).where("project_id", "=", config.project_id).executeTakeFirst();
+		if (Number(result.numUpdatedRows ?? 0) === 0) throw new Error(`No config found to update for agent ${this.agentName} and project ${config.project_id}.`);
+	}
 	async getTask(taskId) {
 		const taskItem = await this.selectTask().where("id", "=", taskId).executeTakeFirst();
 		if (taskItem == null) return null;
@@ -9701,6 +9708,69 @@ async function startPendingTask(provider, task, logger) {
 
 //#endregion
 //#region src/core/index.ts
+function normalizeSkills(value) {
+	if (Array.isArray(value)) return value.filter((item) => typeof item === "string");
+	if (typeof value === "string") {
+		try {
+			const parsed = JSON.parse(value);
+			if (Array.isArray(parsed)) return parsed.filter((item) => typeof item === "string");
+		} catch {}
+		return value.split(",").map((item) => item.trim()).filter((item) => item !== "");
+	}
+	return [];
+}
+function buildRebootstrapDiffPrompt(options) {
+	return `You must follow these instructions":
+1. Clone the main branch from ${options.prototypeUrl} to a temporary directory (<pantheon-agents> in follow instructions references to this directory).
+2. Copy the <pantheon-agents>/agents/${options.role}/AGENTS.md to \`<workspace>/AGENTS.md\`.
+3. Copy the <pantheon-agents>/agents/${options.role}/skills directory to \`<workspace>/.codex/skills\` if the source directory exists.
+${options.skills.length > 0 ? `4. Copy the pantheon-agents/skills/\{${options.skills.join(",")}} directory to \`<workspace>/.codex/skills/\`` : ""}
+
+Validate <workspace>: check if files and directorys exists:
+- AGENTS.md
+- .codex/skills
+
+**You MUST NOT generate AGENTS.md and skills by yourself if clone failed.**
+
+Finally, output a DIFF-oriented summary (not raw file contents) between:
+- BEFORE: the workspace state before applying the steps above (previous base branch id: ${options.previousBaseBranchId})
+- AFTER: the workspace state after applying the steps above
+
+The summary MUST include:
+- \`AGENTS.md\` changes (diff/stat only; do NOT print full file content)
+- \`.codex/skills\` added/removed/modified entries (filenames only; do NOT print file contents)
+- A concise summary with: changed files list + add/remove/modify counts
+`;
+}
+async function defaultSleep(ms) {
+	await new Promise((resolve) => {
+		setTimeout(resolve, ms);
+	});
+}
+async function waitForPantheonBranchOutput(options) {
+	let retried = 0;
+	let i = 0;
+	while (true) {
+		await options.sleep(options.pollIntervalMs);
+		const result = await options.getPantheonBranchFn({
+			branchId: options.branchId,
+			projectId: options.projectId,
+			getOutputIfFinished: true
+		}).then((result) => {
+			retried = 0;
+			return result;
+		}).catch((reason) => {
+			if (retried < options.maxRetries) {
+				retried++;
+				return { state: "others" };
+			}
+			throw new Error(`Failed to get bootstrap branch status. Retry ${retried} times. Last error: ${getErrorMessage(reason)}`);
+		});
+		if (result.state === "failed") throw new Error(`Bootstrap failed: ${result.error}`);
+		if (result.state === "succeed") return result.output ?? "";
+		console.log(`Bootstrap in progress... [${++i}]`);
+	}
+}
 async function runAgent(name, options, logger) {
 	const agentDir = path.join(options.dataDir, "agents", name);
 	const pidFile = path.join(agentDir, "pid");
@@ -9710,38 +9780,37 @@ async function runAgent(name, options, logger) {
 }
 async function configAgent(name, options) {
 	const provider = new TaskListTidbProvider(name, pino());
-	const previousConfig = await provider.getAgentConfig(options.projectId);
-	if (previousConfig) if (previousConfig.role === options.role) {
-		console.log(`Agent ${name} already configured as ${options.role} for project ${options.projectId}.`);
-		console.log(`Base branch id: ${previousConfig.base_branch_id}`);
-		await provider.close();
-		return;
-	} else {
-		console.error(`Agent ${name} already configured as ${previousConfig.role} for project ${options.projectId}.`);
-		console.error(`Base branch id: ${previousConfig.base_branch_id}`);
-		console.error(`Cannot change role to ${options.role}`);
-		await provider.close();
-		process.exitCode = 1;
-		return;
-	}
-	console.log(`Configuring agent ${name} as ${options.role} for project ${options.projectId}.`);
-	if (!options.rootBranchId) {
-		console.log("No root branch id specified, using project root branch.");
-		const project = await getPantheonProjectInfo({ projectId: options.projectId });
-		if (!project.root_branch_id) {
-			console.error(`Project ${options.projectId} has no root branch. Project status is ${project.status}`);
-			await provider.close();
+	try {
+		const previousConfig = await provider.getAgentConfig(options.projectId);
+		if (previousConfig) {
+			if (previousConfig.role === options.role) {
+				console.log(`Agent ${name} already configured as ${options.role} for project ${options.projectId}.`);
+				console.log(`Base branch id: ${previousConfig.base_branch_id}`);
+				return;
+			}
+			console.error(`Agent ${name} already configured as ${previousConfig.role} for project ${options.projectId}.`);
+			console.error(`Base branch id: ${previousConfig.base_branch_id}`);
+			console.error(`Cannot change role to ${options.role}`);
 			process.exitCode = 1;
 			return;
 		}
-		options.rootBranchId = project.root_branch_id;
-	}
-	if (options.bootstrap) {
-		const branchId = await executeOnPantheon({
-			projectId: options.projectId,
-			branchId: options.rootBranchId,
-			agent: "codex",
-			prompt: `You must follow these instructions":
+		console.log(`Configuring agent ${name} as ${options.role} for project ${options.projectId}.`);
+		if (!options.rootBranchId) {
+			console.log("No root branch id specified, using project root branch.");
+			const project = await getPantheonProjectInfo({ projectId: options.projectId });
+			if (!project.root_branch_id) {
+				console.error(`Project ${options.projectId} has no root branch. Project status is ${project.status}`);
+				process.exitCode = 1;
+				return;
+			}
+			options.rootBranchId = project.root_branch_id;
+		}
+		if (options.bootstrap) {
+			const branchId = await executeOnPantheon({
+				projectId: options.projectId,
+				branchId: options.rootBranchId,
+				agent: "codex",
+				prompt: `You must follow these instructions":
 1. Clone the main branch from ${options.prototypeUrl} to a temporary directory (<pantheon-agents> in follow instructions references to this directory).
 2. Copy the <pantheon-agents>/agents/${options.role}/AGENTS.md to \`<workspace>/AGENTS.md\`.
 3. Copy the <pantheon-agents>/agents/${options.role}/skills directory to \`<workspace>/.codex/skills\` if the source directory exists.
@@ -9755,70 +9824,135 @@ Validate <workspace>: check if files and directorys exists:
 
 Finally, outputs the first 5 lines of <workspace>/AGENTS.md and the skills list in <workspace>/.codex/skills
 `
-		});
-		let retried = 0;
-		const maxRetries = 3;
-		let i = 0;
-		console.log(`Bootstrap branch created: ${branchId}. Waiting for ready... [poll interval = 10s]`);
-		while (true) {
-			await new Promise((resolve) => {
-				setTimeout(resolve, 1e4);
 			});
-			const result = await getPantheonBranch({
-				branchId,
-				projectId: options.projectId,
-				getOutputIfFinished: true
-			}).then((result) => {
-				retried = 0;
-				return result;
-			}).catch((reason) => {
-				if (retried < maxRetries) {
-					retried++;
-					return { state: "others" };
-				} else throw new Error(`Failed to get bootstrap branch status. Retry ${retried} times. Last error: ${getErrorMessage(reason)}`);
+			let retried = 0;
+			const maxRetries = 3;
+			let i = 0;
+			console.log(`Bootstrap branch created: ${branchId}. Waiting for ready... [poll interval = 10s]`);
+			while (true) {
+				await new Promise((resolve) => {
+					setTimeout(resolve, 1e4);
+				});
+				const result = await getPantheonBranch({
+					branchId,
+					projectId: options.projectId,
+					getOutputIfFinished: true
+				}).then((result) => {
+					retried = 0;
+					return result;
+				}).catch((reason) => {
+					if (retried < maxRetries) {
+						retried++;
+						return { state: "others" };
+					}
+					throw new Error(`Failed to get bootstrap branch status. Retry ${retried} times. Last error: ${getErrorMessage(reason)}`);
+				});
+				if (result.state === "failed") {
+					console.error("Bootstrap failed: " + result.error);
+					process.exitCode = 1;
+					return;
+				}
+				if (result.state === "succeed") {
+					console.log("Bootstrap succeeded. Output is:");
+					console.log(result.output);
+					break;
+				}
+				console.log(`Bootstrap in progress... [${++i}]`);
+			}
+			await provider.setAgentConfig({
+				project_id: options.projectId,
+				base_branch_id: branchId,
+				execute_agent: options.executeAgent,
+				role: options.role,
+				skills: options.skills,
+				prototype_url: options.prototypeUrl
 			});
-			if (result.state === "failed") {
-				console.error("Bootstrap failed: " + result.error);
-				await provider.close();
-				process.exit(1);
-			}
-			if (result.state === "succeed") {
-				console.log("Bootstrap succeeded. Output is:");
-				console.log(result.output);
-				break;
-			}
-			console.log(`Bootstrap in progress... [${++i}]`);
-		}
-		await provider.setAgentConfig({
+		} else await provider.setAgentConfig({
 			project_id: options.projectId,
-			base_branch_id: branchId,
+			base_branch_id: options.rootBranchId,
 			execute_agent: options.executeAgent,
 			role: options.role,
 			skills: options.skills,
 			prototype_url: options.prototypeUrl
 		});
-	} else await provider.setAgentConfig({
+		console.log(`Agent ${name} configured successfully.`);
+	} finally {
+		await provider.close();
+	}
+}
+async function reconfigAgentWithDeps(name, options, deps) {
+	const previousConfig = await deps.provider.getAgentConfig(options.projectId);
+	if (!previousConfig) throw new Error(`No config found for agent ${name} and project ${options.projectId}.`);
+	const resolvedRole = options.role?.trim() || previousConfig.role;
+	if (options.role != null && !options.role.trim()) throw new Error("--role must be non-empty.");
+	const resolvedSkills = options.skills ?? normalizeSkills(previousConfig.skills);
+	const nextBaseBranchId = await deps.executeOnPantheonFn({
+		projectId: options.projectId,
+		branchId: previousConfig.base_branch_id,
+		agent: "codex",
+		prompt: buildRebootstrapDiffPrompt({
+			prototypeUrl: previousConfig.prototype_url,
+			role: resolvedRole,
+			skills: resolvedSkills,
+			previousBaseBranchId: previousConfig.base_branch_id
+		})
+	});
+	console.log(`Bootstrap branch created: ${nextBaseBranchId}. Waiting for ready... [poll interval = ${Math.floor((deps.pollIntervalMs ?? 1e4) / 1e3)}s]`);
+	const bootstrapOutput = await waitForPantheonBranchOutput({
+		projectId: options.projectId,
+		branchId: nextBaseBranchId,
+		pollIntervalMs: deps.pollIntervalMs ?? 1e4,
+		maxRetries: deps.maxRetries ?? 3,
+		getPantheonBranchFn: deps.getPantheonBranchFn,
+		sleep: deps.sleep ?? defaultSleep
+	});
+	await deps.provider.updateAgentConfig({
 		project_id: options.projectId,
-		base_branch_id: options.rootBranchId,
-		execute_agent: options.executeAgent,
-		role: options.role,
-		skills: options.skills,
-		prototype_url: options.prototypeUrl
+		base_branch_id: nextBaseBranchId,
+		execute_agent: previousConfig.execute_agent,
+		role: resolvedRole,
+		skills: resolvedSkills,
+		prototype_url: previousConfig.prototype_url
 	});
-	console.log(`Agent ${name} configured successfully.`);
-	await provider.close();
+	return {
+		previousConfig,
+		resolvedRole,
+		resolvedSkills,
+		nextBaseBranchId,
+		bootstrapOutput
+	};
+}
+async function reconfigAgent(name, options) {
+	const provider = new TaskListTidbProvider(name, pino());
+	try {
+		console.log(`Reconfiguring agent ${name} for project ${options.projectId}.`);
+		const result = await reconfigAgentWithDeps(name, options, {
+			provider,
+			executeOnPantheonFn: executeOnPantheon,
+			getPantheonBranchFn: getPantheonBranch
+		});
+		console.log("Re-bootstrap succeeded. Output is:");
+		console.log(result.bootstrapOutput);
+		console.log(`New base branch id: ${result.nextBaseBranchId}`);
+		console.log(`Agent ${name} reconfigured successfully.`);
+	} finally {
+		await provider.close();
+	}
 }
 async function addTask(name, options) {
 	const provider = new TaskListTidbProvider(name, pino());
-	const config = await provider.getAgentConfig(options.projectId);
-	if (!config) throw new Error(`Agent ${name} not configured for project ${options.projectId}`);
-	const task = await provider.createTask({
-		task: options.prompt,
-		project_id: options.projectId,
-		base_branch_id: config.base_branch_id
-	});
-	console.log(`Task ${task.task} queued successfully.`);
-	await provider.close();
+	try {
+		const config = await provider.getAgentConfig(options.projectId);
+		if (!config) throw new Error(`Agent ${name} not configured for project ${options.projectId}`);
+		const task = await provider.createTask({
+			task: options.prompt,
+			project_id: options.projectId,
+			base_branch_id: config.base_branch_id
+		});
+		console.log(`Queued task ${task.id} successfully.`);
+	} finally {
+		await provider.close();
+	}
 }
 async function deleteTask(agentName, taskId) {
 	const provider = new TaskListTidbProvider(agentName, pino());
@@ -9973,11 +10107,22 @@ async function assertsSingleton(logger, pidFile) {
 	}
 }
 
+//#endregion
+//#region src/cli/utils/env.ts
+function ensureEnv(keys) {
+	const missing = keys.filter((key) => !process.env[key]);
+	if (missing.length === 0) return true;
+	for (const key of missing) console.error(`${key} environment variable is not set.`);
+	process.exitCode = 1;
+	return false;
+}
+
 //#endregion
 //#region src/cli/commands/add-task.ts
 function createAddTaskCommand(version) {
-	return createCommand("pantheon-agents add-task").version(version).description("Add a task to an agent").argument("<name>", "The name of the agent.").argument("<project-id>", "The project id of the agent.").argument("<task-prompt>", "The prompt of the task.").action(async function() {
+	return createCommand("add-task").version(version).description("Add a task to an agent").argument("<name>", "The name of the agent.").argument("<project-id>", "The project id of the agent.").argument("<task-prompt>", "The prompt of the task.").action(async function() {
 		const [name, projectId, taskPrompt] = this.args;
+		if (!ensureEnv(["DATABASE_URL"])) return;
 		await addTask(name, {
 			projectId,
 			prompt: taskPrompt
@@ -9988,12 +10133,16 @@ function createAddTaskCommand(version) {
 //#endregion
 //#region src/cli/commands/config.ts
 function createConfigAgentCommand(version) {
-	return createCommand("pantheon-agents config").version(version).description("Configure agent for pantheon project").argument("<name>", "The name of the agent.").argument("<role>", "The role of the agent.").argument("<project-id>", "The project id of the agent.").option("--skills <skills>", "The skills of the agent. Multiple values are separated by comma.", (val) => val.split(",").map((s) => s.trim()).filter((s) => s !== ""), []).option("--execute-agent <agent>", "The execute agent of the agent.", "codex").option("--root-branch-id <branchId>", "The root branch id of the agent. Default to project root branch id.").option("--prototype-url <url>", "Role and skill definitions repo.", "https://github.com/pingcap-inc/pantheon-agents").option("--no-bootstrap", "Prevent bootstrap base branch for agent. Use the root branch as base branch.").action(async function() {
+	return createCommand("config").version(version).description("Configure agent for pantheon project").argument("<name>", "The name of the agent.").argument("<role>", "The role of the agent.").argument("<project-id>", "The project id of the agent.").option("--skills <skills>", "The skills of the agent. Multiple values are separated by comma.", (val) => val.split(",").map((s) => s.trim()).filter((s) => s !== ""), []).option("--execute-agent <agent>", "The execute agent of the agent.", "codex").option("--root-branch-id <branchId>", "The root branch id of the agent. Default to project root branch id.").option("--prototype-url <url>", "Role and skill definitions repo.", "https://github.com/pingcap-inc/pantheon-agents").option("--no-bootstrap", "Prevent bootstrap base branch for agent. Use the root branch as base branch.").action(async function() {
 		const [name, role, projectId] = this.args;
+		const options = this.opts();
+		const requiredEnvVars = ["DATABASE_URL"];
+		if (options.bootstrap || !options.rootBranchId) requiredEnvVars.push("PANTHEON_API_KEY");
+		if (!ensureEnv(requiredEnvVars)) return;
 		await configAgent(name, {
 			role,
 			projectId,
-			...this.opts()
+			...options
 		});
 	});
 }
@@ -10001,8 +10150,9 @@ function createConfigAgentCommand(version) {
 //#endregion
 //#region src/cli/commands/delete-task.ts
 function createDeleteTaskCommand(version) {
-	return createCommand("pantheon-agents delete-task").version(version).description("Delete a task for an agent").argument("<name>", "The name of the agent.").argument("<task-id>", "The id of the task.").action(async function() {
+	return createCommand("delete-task").version(version).description("Delete a task for an agent").argument("<name>", "The name of the agent.").argument("<task-id>", "The id of the task.").action(async function() {
 		const [name, taskId] = this.args;
+		if (!ensureEnv(["DATABASE_URL"])) return;
 		const rl = readline.createInterface({
 			input: process$1.stdin,
 			output: process$1.stdout
@@ -10010,16 +10160,19 @@ function createDeleteTaskCommand(version) {
 		try {
 			if ((await rl.question(`Type the task id (${taskId}) to confirm deletion: `)).trim() !== taskId) {
 				console.error("Confirmation failed. Task id did not match.");
-				process$1.exit(1);
+				process$1.exitCode = 1;
+				return;
 			}
 			if ((await rl.question("Type DELETE to permanently remove this task: ")).trim() !== "DELETE") {
 				console.error("Confirmation failed. Aborting deletion.");
-				process$1.exit(1);
+				process$1.exitCode = 1;
+				return;
 			}
 			const deletedTask = await deleteTask(name, taskId);
 			if (!deletedTask) {
 				console.error(`Task ${taskId} not found for agent ${name}.`);
-				process$1.exit(1);
+				process$1.exitCode = 1;
+				return;
 			}
 			console.log(`Deleted task ${taskId} for agent ${name}. Status was ${deletedTask.status}.`);
 		} finally {
@@ -10028,12 +10181,51 @@ function createDeleteTaskCommand(version) {
 	});
 }
 
+//#endregion
+//#region src/cli/utils/parse.ts
+function parseCommaList(value) {
+	return value.split(",").map((item) => item.trim()).filter((item) => item !== "");
+}
+function parseUniqueCommaList(value) {
+	const items = parseCommaList(value);
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const item of items) {
+		if (seen.has(item)) continue;
+		seen.add(item);
+		result.push(item);
+	}
+	return result;
+}
+
+//#endregion
+//#region src/cli/commands/reconfig.ts
+function createReconfigAgentCommand(version) {
+	return createCommand("reconfig").version(version).description("Re-bootstrap an existing agent configuration for a project").argument("<name>", "The name of the agent.").argument("<project-id>", "The project id of the agent.").option("--role <role>", "Override role for the agent.").option("--skills <skills>", "Override skills for the agent (comma-separated, replaces existing list).", parseUniqueCommaList).action(async function() {
+		const [name, projectId] = this.args;
+		const options = this.opts();
+		if (!ensureEnv(["DATABASE_URL", "PANTHEON_API_KEY"])) return;
+		const resolvedRole = options.role?.trim();
+		if (options.role != null && !resolvedRole) {
+			console.error("--role must be non-empty.");
+			process$1.exitCode = 1;
+			return;
+		}
+		await reconfigAgent(name, {
+			projectId,
+			role: resolvedRole,
+			skills: options.skills
+		});
+	});
+}
+
 //#endregion
 //#region src/cli/commands/run.ts
 function createRunAgentCommand(version) {
-	return createCommand("pantheon-agents run").version(version).description("Start a pantheon agents").argument("<name>", "The name of the agent.").option("--data-dir [dir]", "Data directory.", expandTilde("~/.pantheon-agents")).option("--mcp-port", "The port of the MCP server. Defaults to a random port.").option("--loop-interval <seconds>", "The interval of the loop in seconds. Defaults to 5.", (val) => parseInt(val, 10), 5).action(async function() {
+	return createCommand("run").version(version).description("Start a pantheon agent").argument("<name>", "The name of the agent.").option("--data-dir [dir]", "Data directory.", expandTilde("~/.pantheon-agents")).option("--loop-interval <seconds>", "The interval of the loop in seconds. Defaults to 5.", (val) => parseInt(val, 10), 5).action(async function() {
 		const [name] = this.args;
 		const options = this.opts();
+		if (!ensureEnv(["DATABASE_URL", "PANTHEON_API_KEY"])) return;
 		const logFileTransport = transport({
 			target: "pino-roll",
 			options: {
@@ -21623,6 +21815,141 @@ function taskToDTO(agent, task) {
 		error: task.status === "failed" ? task.error : null
 	};
 }
+function agentConfigToDTO(config) {
+	return {
+		agent: config.agent,
+		project_id: config.project_id,
+		base_branch_id: config.base_branch_id,
+		role: config.role,
+		skills: config.skills,
+		prototype_url: config.prototype_url,
+		execute_agent: config.execute_agent
+	};
+}
+
+//#endregion
+//#region src/server/agent-config.ts
+function assertPantheonApiKeyConfigured() {
+	if (!process.env.PANTHEON_API_KEY?.trim()) throw new ApiError({
+		status: 503,
+		code: "pantheon_api_key_missing",
+		message: "Missing PANTHEON_API_KEY. This endpoint requires Pantheon API access."
+	});
+}
+async function getBranchOutputOrThrow(options) {
+	let state;
+	try {
+		state = await options.getPantheonBranchFn({
+			projectId: options.projectId,
+			branchId: options.branchId,
+			getOutputIfFinished: true,
+			manifestingAsSucceed: true
+		});
+	} catch (error) {
+		throw new ApiError({
+			status: 502,
+			code: "pantheon_api_error",
+			message: `Failed to fetch Pantheon branch output for ${options.branchId}.`,
+			details: {
+				project_id: options.projectId,
+				branch_id: options.branchId,
+				error: getErrorMessage(error)
+			}
+		});
+	}
+	if (state.state === "succeed") return state.output ?? "";
+	if (state.state === "failed") throw new ApiError({
+		status: 502,
+		code: "pantheon_branch_failed",
+		message: `Pantheon branch ${options.branchId} failed.`,
+		details: {
+			project_id: options.projectId,
+			branch_id: options.branchId,
+			error: state.error
+		}
+	});
+	throw new ApiError({
+		status: 502,
+		code: "pantheon_branch_not_ready",
+		message: `Pantheon branch ${options.branchId} is not finished yet.`,
+		details: {
+			project_id: options.projectId,
+			branch_id: options.branchId
+		}
+	});
+}
+async function getAgentConfigWithBootstrapOutput(options) {
+	assertPantheonApiKeyConfigured();
+	const config = await options.provider.getAgentConfig(options.projectId);
+	if (!config) throw new ApiError({
+		status: 404,
+		code: "config_not_found",
+		message: `No config found for agent ${options.agent} and project ${options.projectId}.`
+	});
+	const bootstrapOutput = await getBranchOutputOrThrow({
+		projectId: config.project_id,
+		branchId: config.base_branch_id,
+		getPantheonBranchFn: options.getPantheonBranchFn ?? getPantheonBranch
+	});
+	return {
+		config: agentConfigToDTO(config),
+		bootstrap_output: bootstrapOutput
+	};
+}
+async function reconfigAgentConfigWithBootstrapOutput(options) {
+	assertPantheonApiKeyConfigured();
+	const getPantheonBranchFn = options.getPantheonBranchFn ?? getPantheonBranch;
+	const wrappedGetPantheonBranch = (args) => getPantheonBranchFn({
+		...args,
+		manifestingAsSucceed: true
+	});
+	let result;
+	try {
+		result = await reconfigAgentWithDeps(options.agent, options.reconfig, {
+			provider: options.provider,
+			executeOnPantheonFn: options.executeOnPantheonFn ?? executeOnPantheon,
+			getPantheonBranchFn: wrappedGetPantheonBranch,
+			sleep: options.sleep,
+			pollIntervalMs: options.pollIntervalMs,
+			maxRetries: options.maxRetries
+		});
+	} catch (error) {
+		if (error instanceof ApiError) throw error;
+		const message = getErrorMessage(error);
+		if (message.startsWith("No config found for agent ")) throw new ApiError({
+			status: 404,
+			code: "config_not_found",
+			message
+		});
+		if (message === "--role must be non-empty.") throw new ApiError({
+			status: 400,
+			code: "validation_error",
+			message
+		});
+		if (message.startsWith("Bootstrap failed:")) throw new ApiError({
+			status: 502,
+			code: "bootstrap_failed",
+			message
+		});
+		throw new ApiError({
+			status: 502,
+			code: "reconfig_failed",
+			message,
+			details: { error: message }
+		});
+	}
+	const updated = await options.provider.getAgentConfig(result.previousConfig.project_id);
+	if (!updated) throw new ApiError({
+		status: 500,
+		code: "config_update_lost",
+		message: "Config disappeared after reconfig update."
+	});
+	return {
+		previous_config: agentConfigToDTO(result.previousConfig),
+		config: agentConfigToDTO(updated),
+		bootstrap_output: result.bootstrapOutput
+	};
+}
 
 //#endregion
 //#region src/server/api.ts
@@ -21661,6 +21988,10 @@ const createTaskBodySchema = z$1.object({
 	project_id: z$1.string().min(1),
 	task: z$1.string().min(1)
 });
+const reconfigBodySchema = z$1.object({
+	role: z$1.string().trim().min(1).optional(),
+	skills: z$1.array(z$1.string().trim().min(1)).optional()
+});
 function getAgentParam(value) {
 	if (typeof value !== "string" || value.trim().length === 0) throw new ApiError({
 		status: 400,
@@ -21669,6 +22000,14 @@ function getAgentParam(value) {
 	});
 	return value;
 }
+function getProjectIdParam(value) {
+	if (typeof value !== "string" || value.trim().length === 0) throw new ApiError({
+		status: 400,
+		code: "validation_error",
+		message: "Invalid project_id parameter."
+	});
+	return value;
+}
 function getTaskIdParam(value) {
 	if (typeof value !== "string" || value.trim().length === 0) throw new ApiError({
 		status: 400,
@@ -21684,6 +22023,31 @@ function createApiRouter(options) {
 		const agents = await new TaskListTidbProvider("server", logger, { db }).listAgentNames();
 		res.json({ agents });
 	}));
+	router.get("/agents/:agent/configs/:project_id", asyncHandler(async (req, res) => {
+		const agent = getAgentParam(req.params.agent);
+		const result = await getAgentConfigWithBootstrapOutput({
+			agent,
+			projectId: getProjectIdParam(req.params.project_id),
+			provider: new TaskListTidbProvider(agent, logger, { db })
+		});
+		res.json(result);
+	}));
+	router.post("/agents/:agent/configs/:project_id/reconfig", asyncHandler(async (req, res) => {
+		const agent = getAgentParam(req.params.agent);
+		const projectId = getProjectIdParam(req.params.project_id);
+		const body = reconfigBodySchema.parse(req.body);
+		const provider = new TaskListTidbProvider(agent, logger, { db });
+		const result = await reconfigAgentConfigWithBootstrapOutput({
+			agent,
+			reconfig: {
+				projectId,
+				role: body.role,
+				skills: body.skills
+			},
+			provider
+		});
+		res.json(result);
+	}));
 	router.get("/agents/:agent/tasks", asyncHandler(async (req, res) => {
 		const agent = getAgentParam(req.params.agent);
 		const query = listTasksQuerySchema.parse(req.query);
@@ -31551,6 +31915,51 @@ function createAgentsMcpServer(options) {
 			structuredContent: { deleted: true }
 		};
 	});
+	server.registerTool("configs.get", {
+		description: "Get an agent's config for a project, including the bootstrap branch output.",
+		inputSchema: {
+			agent: z$1.string().min(1),
+			project_id: z$1.string().min(1)
+		}
+	}, async ({ agent, project_id }) => {
+		return {
+			content: [{
+				type: "text",
+				text: "OK"
+			}],
+			structuredContent: await getAgentConfigWithBootstrapOutput({
+				agent,
+				projectId: project_id,
+				provider: new TaskListTidbProvider(agent, options.logger, { db: options.db })
+			})
+		};
+	});
+	server.registerTool("configs.reconfig", {
+		description: "Re-bootstrap an existing agent configuration for a project (like `pantheon-agents reconfig`).",
+		inputSchema: {
+			agent: z$1.string().min(1),
+			project_id: z$1.string().min(1),
+			role: z$1.string().trim().min(1).optional(),
+			skills: z$1.array(z$1.string().trim().min(1)).optional()
+		}
+	}, async ({ agent, project_id, role, skills }) => {
+		const provider = new TaskListTidbProvider(agent, options.logger, { db: options.db });
+		return {
+			content: [{
+				type: "text",
+				text: "OK"
+			}],
+			structuredContent: await reconfigAgentConfigWithBootstrapOutput({
+				agent,
+				reconfig: {
+					projectId: project_id,
+					role,
+					skills
+				},
+				provider
+			})
+		};
+	});
 	return server;
 }
 
@@ -31661,11 +32070,13 @@ async function startAgentsServer(options, logger, overrides = {}) {
 //#endregion
 //#region src/cli/commands/server.ts
 function createServerCommand(version) {
-	return createCommand("pantheon-agents server").version(version).description("Start the task HTTP API + MCP server").option("--host <host>", "Bind host. Defaults to 127.0.0.1.", "127.0.0.1").option("--port <port>", "Bind port. Defaults to 8000.", (v) => parseInt(v, 10), 8e3).option("--base-path <path>", "Mount base path prefix. Defaults to /.", "/").option("--token <token>", "Bearer token for API auth. Defaults to env PANTHEON_AGENTS_API_TOKEN.").option("--no-auth", "Disable auth (NOT recommended).").action(async function() {
+	return createCommand("server").version(version).description("Start the task HTTP API + MCP server").option("--host <host>", "Bind host. Defaults to 127.0.0.1.", "127.0.0.1").option("--port <port>", "Bind port. Defaults to 8000.", (v) => parseInt(v, 10), 8e3).option("--base-path <path>", "Mount base path prefix. Defaults to /.", "/").option("--token <token>", "Bearer token for API auth. Defaults to env PANTHEON_AGENTS_API_TOKEN.").option("--no-auth", "Disable auth (NOT recommended).").action(async function() {
 		const options = this.opts();
+		if (!ensureEnv(["DATABASE_URL"])) return;
 		if (!Number.isInteger(options.port) || options.port <= 0) {
 			console.error("Invalid --port value. Must be a positive integer.");
-			process$1.exit(1);
+			process$1.exitCode = 1;
+			return;
 		}
 		const logger = pino({
 			timestamp: pino.stdTimeFunctions.isoTime,
@@ -31688,14 +32099,16 @@ function createServerCommand(version) {
 //#endregion
 //#region src/cli/commands/show-config.ts
 function createShowConfigCommand(version) {
-	return createCommand("pantheon-agents show-config").version(version).description("Show agent config for a project").argument("<name>", "The name of the agent.").argument("[project-id]", "The project id.").option("--json", "Output config as JSON.").action(async function() {
+	return createCommand("show-config").version(version).description("Show agent config for a project").argument("<name>", "The name of the agent.").argument("[project-id]", "The project id.").option("--json", "Output config as JSON.").action(async function() {
 		const [name, projectId] = this.args;
 		const options = this.opts();
+		if (!ensureEnv(["DATABASE_URL"])) return;
 		if (projectId) {
 			const config = await showAgentConfig(name, projectId);
 			if (!config) {
 				console.error(`No config found for agent ${name} and project ${projectId}.`);
-				process$1.exit(1);
+				process$1.exitCode = 1;
+				return;
 			}
 			if (options.json) {
 				console.log(JSON.stringify(config, null, 2));
@@ -31715,7 +32128,8 @@ function createShowConfigCommand(version) {
 		const configs = await showAgentConfigs(name);
 		if (!configs.length) {
 			console.error(`No configs found for agent ${name}.`);
-			process$1.exit(1);
+			process$1.exitCode = 1;
+			return;
 		}
 		if (options.json) {
 			console.log(JSON.stringify(configs, null, 2));
@@ -31749,55 +32163,53 @@ const orderByFields = [
 ];
 const orderDirections = ["asc", "desc"];
 
-//#endregion
-//#region src/cli/utils/parse.ts
-function parseCommaList(value) {
-	return value.split(",").map((item) => item.trim()).filter((item) => item !== "");
-}
-
 //#endregion
 //#region src/cli/commands/show-tasks.ts
 function createShowTasksCommand(version) {
-	return createCommand("pantheon-agents show-tasks").version(version).description("Show tasks for an agent").argument("[name]", "The name of the agent.").option("--agents <names>", "Comma-separated agent names to query in one call.", parseCommaList, []).option("--all", "Show tasks for all agents.").option("--status <status>", "Filter tasks by status. Multiple values are separated by comma.", parseCommaList, []).option("--order-by <field>", "Order by queued_at, started_at, or ended_at.", "queued_at").option("--order-direction <direction>", "Order direction: asc or desc.", "desc").option("--limit <number>", "Limit the number of tasks shown.", (val) => parseInt(val, 10)).option("--max-task-length <number>", "Maximum task length for table output.", (val) => parseInt(val, 10), 120).option("--full-task", "Do not truncate task text in output.").option("--concise", "Output concise one-line entries.", true).option("--no-color", "Disable colored output.").option("--json", "Output tasks as JSON.").action(async function() {
+	return createCommand("show-tasks").version(version).description("Show tasks for an agent").argument("[name]", "The name of the agent.").option("--agents <names>", "Comma-separated agent names to query in one call.", parseCommaList, []).option("--all", "Show tasks for all agents.").option("--status <status>", "Filter tasks by status. Multiple values are separated by comma.", parseCommaList, []).option("--order-by <field>", "Order by queued_at, started_at, or ended_at.", "queued_at").option("--order-direction <direction>", "Order direction: asc or desc.", "desc").option("--limit <number>", "Limit the number of tasks shown.", (val) => parseInt(val, 10)).option("--max-task-length <number>", "Maximum task length for table output.", (val) => parseInt(val, 10), 120).option("--full-task", "Do not truncate task text in output.").option("--no-concise", "Disable concise one-line entries.").option("--no-color", "Disable colored output.").option("--json", "Output tasks as JSON.").action(async function() {
 		const [name] = this.args;
 		const options = this.opts();
+		if (!ensureEnv(["DATABASE_URL"])) return;
 		const agentNames = /* @__PURE__ */ new Set();
 		if (name) agentNames.add(name);
 		options.agents.forEach((agent) => agentNames.add(agent));
 		if (options.all && agentNames.size > 0) {
 			console.error("Use either a specific agent name or --all, not both.");
-			process$1.exit(1);
+			process$1.exitCode = 1;
+			return;
 		}
 		if (!options.all && agentNames.size === 0) {
 			console.error("Provide an agent name, --agents, or --all.");
-			process$1.exit(1);
+			process$1.exitCode = 1;
+			return;
 		}
 		const invalidStatuses = options.status.filter((status) => !taskStatuses.includes(status));
 		if (invalidStatuses.length > 0) {
 			console.error(`Invalid status values: ${invalidStatuses.join(", ")}. Allowed: ${taskStatuses.join(", ")}.`);
-			process$1.exit(1);
+			process$1.exitCode = 1;
+			return;
 		}
 		if (!orderByFields.includes(options.orderBy)) {
 			console.error(`Invalid order-by value: ${options.orderBy}. Allowed: ${orderByFields.join(", ")}.`);
-			process$1.exit(1);
+			process$1.exitCode = 1;
+			return;
 		}
 		if (!orderDirections.includes(options.orderDirection)) {
 			console.error(`Invalid order-direction value: ${options.orderDirection}. Allowed: ${orderDirections.join(", ")}.`);
-			process$1.exit(1);
+			process$1.exitCode = 1;
+			return;
 		}
 		if (options.limit != null && Number.isNaN(options.limit)) {
 			console.error("Invalid limit value. Must be a number.");
-			process$1.exit(1);
+			process$1.exitCode = 1;
+			return;
 		}
 		if (Number.isNaN(options.maxTaskLength) || options.maxTaskLength <= 0) {
 			console.error("Invalid max-task-length value. Must be a positive number.");
-			process$1.exit(1);
+			process$1.exitCode = 1;
+			return;
 		}
 		if (options.fullTask && options.maxTaskLength) options.maxTaskLength = Number.POSITIVE_INFINITY;
-		if (options.json && options.concise) {
-			console.error("Use either --json or --concise, not both.");
-			process$1.exit(1);
-		}
 		const limitedTasks = await showTasksForAgents({
 			agents: Array.from(agentNames),
 			allAgents: options.all,
@@ -31833,36 +32245,22 @@ function createShowTasksCommand(version) {
 	});
 }
 
-//#endregion
-//#region src/cli/utils/env.ts
-function warnIfMissingEnv(keys) {
-	for (const key of keys) if (!process.env[key]) console.error(`${key} environment variable is not set.`);
-}
-
 //#endregion
 //#region src/cli/index.ts
-warnIfMissingEnv(["PANTHEON_API_KEY", "DATABASE_URL"]);
-const commands = {
-	"add-task": createAddTaskCommand(version$1),
-	config: createConfigAgentCommand(version$1),
-	"delete-task": createDeleteTaskCommand(version$1),
-	run: createRunAgentCommand(version$1),
-	server: createServerCommand(version$1),
-	"show-config": createShowConfigCommand(version$1),
-	"show-tasks": createShowTasksCommand(version$1)
-};
-function printCommandHelpAndExit(command) {
-	console.error(`Invalid command: ${command}. Supported commands: ${Object.keys(commands).join(", ")}.`);
-	console.error("  Run pantheon-agents help <command> for more information.");
-	process$1.exit(1);
-}
-if (process$1.argv[2] === "help") {
-	const command = process$1.argv[3];
-	if (command in commands) commands[command].help({ error: false });
-	else printCommandHelpAndExit(command);
-}
-if (!commands[process$1.argv[2]]) printCommandHelpAndExit(process$1.argv[2]);
-commands[process$1.argv[2]].parse(process$1.argv.slice(3), { from: "user" });
+const program = new Command().name("pantheon-agents").description("Pantheon agents CLI").version(version$1).showHelpAfterError().showSuggestionAfterError().addHelpCommand().addCommand(createAddTaskCommand(version$1)).addCommand(createConfigAgentCommand(version$1)).addCommand(createDeleteTaskCommand(version$1)).addCommand(createReconfigAgentCommand(version$1)).addCommand(createRunAgentCommand(version$1)).addCommand(createServerCommand(version$1)).addCommand(createShowConfigCommand(version$1)).addCommand(createShowTasksCommand(version$1));
+async function main() {
+	if (process$1.argv.length <= 2) {
+		program.outputHelp();
+		return;
+	}
+	await program.parseAsync(process$1.argv);
+}
+try {
+	await main();
+} catch (error) {
+	console.error(getErrorMessage(error));
+	process$1.exitCode = 1;
+}
 
 //#endregion
 export {  };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pantheon.ai/agents",
   "type": "module",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "bin": {
     "pantheon-agents": "dist/index.js"
   },
@@ -13,6 +13,7 @@
   },
   "scripts": {
     "build": "rolldown -c rolldown.config.ts && chmod +x dist/index.js",
+    "test": "bun test",
     "dev:db:start": "tiup playground --without-monitor --tag pantheon-agents",
     "dev:db:gen": "kysely-codegen "
   },