@schilderlabs/pitown-core 0.2.1 → 0.2.6

package/dist/agent-runner.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/agent-runner.mjs

@@ -0,0 +1,122 @@
+import { S as writeAgentState, _ as getLatestAgentSession, c as appendAgentMessage, d as getAgentDir, l as createAgentSessionRecord, o as updateTaskRecordStatus, u as createAgentState, x as readAgentState } from "./tasks-BfQm-7-O.mjs";
+import { createWriteStream, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { finished } from "node:stream/promises";
+
+//#region src/agent-runner.ts
+async function waitForChild(child) {
+	return new Promise((resolve) => {
+		let error = null;
+		child.once("error", (value) => {
+			error = value;
+		});
+		child.once("close", (code) => {
+			resolve({
+				exitCode: code ?? 1,
+				error
+			});
+		});
+	});
+}
+async function runDetachedAgent(payload) {
+	const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+	const agentArtifactsDir = getAgentDir(payload.artifactsDir, payload.agentId);
+	const stdoutPath = `${agentArtifactsDir}/latest-stdout.txt`;
+	const stderrPath = `${agentArtifactsDir}/latest-stderr.txt`;
+	const invocationPath = `${agentArtifactsDir}/latest-invocation.json`;
+	mkdirSync(agentArtifactsDir, { recursive: true });
+	const stdoutStream = createWriteStream(stdoutPath, { encoding: "utf-8" });
+	const stderrStream = createWriteStream(stderrPath, { encoding: "utf-8" });
+	const child = spawn("pi", payload.piArgs, {
+		cwd: payload.repoRoot,
+		env: process.env,
+		stdio: [
+			"ignore",
+			"pipe",
+			"pipe"
+		]
+	});
+	if (child.stdout) child.stdout.pipe(stdoutStream);
+	if (child.stderr) child.stderr.pipe(stderrStream);
+	const currentState = readAgentState(payload.artifactsDir, payload.agentId);
+	if (currentState) writeAgentState(payload.artifactsDir, createAgentState({
+		...currentState,
+		status: "running",
+		lastMessage: payload.task ? `Running ${payload.role} task: ${payload.task}` : `Running ${payload.role} agent`,
+		waitingOn: null,
+		blocked: false,
+		session: createAgentSessionRecord({
+			sessionDir: payload.sessionDir,
+			sessionId: currentState.session.sessionId,
+			sessionPath: currentState.session.sessionPath,
+			processId: child.pid ?? null,
+			lastAttachedAt: currentState.session.lastAttachedAt
+		})
+	}));
+	writeFileSync(invocationPath, `${JSON.stringify({
+		command: "pi",
+		args: payload.piArgs,
+		exitCode: null,
+		sessionDir: payload.sessionDir,
+		sessionPath: null,
+		sessionId: null,
+		processId: child.pid ?? null,
+		startedAt
+	}, null, 2)}\n`, "utf-8");
+	const { exitCode, error } = await waitForChild(child);
+	if (!stdoutStream.writableEnded) stdoutStream.end();
+	if (!stderrStream.writableEnded) stderrStream.end();
+	await Promise.all([finished(stdoutStream), finished(stderrStream)]);
+	const stdout = readFileSync(stdoutPath, "utf-8");
+	const stderr = readFileSync(stderrPath, "utf-8");
+	const latestSession = getLatestAgentSession(payload.artifactsDir, payload.agentId);
+	const completionMessage = stdout.trim() || (error?.message?.trim() ?? "") || (exitCode === 0 ? `${payload.role} run completed` : `${payload.role} run exited with code ${exitCode}`);
+	if (error) writeFileSync(stderrPath, `${stderr}${stderr.endsWith("\n") || stderr.length === 0 ? "" : "\n"}${error.message}\n`, "utf-8");
+	writeFileSync(invocationPath, `${JSON.stringify({
+		command: "pi",
+		args: payload.piArgs,
+		exitCode,
+		sessionDir: latestSession.sessionDir ?? payload.sessionDir,
+		sessionPath: latestSession.sessionPath,
+		sessionId: latestSession.sessionId,
+		processId: child.pid ?? null,
+		startedAt,
+		endedAt: (/* @__PURE__ */ new Date()).toISOString()
+	}, null, 2)}\n`, "utf-8");
+	appendAgentMessage({
+		artifactsDir: payload.artifactsDir,
+		agentId: payload.agentId,
+		box: "outbox",
+		from: payload.agentId,
+		body: completionMessage
+	});
+	if (payload.taskId) updateTaskRecordStatus(payload.artifactsDir, payload.taskId, exitCode === 0 ? "completed" : "blocked");
+	const finalState = readAgentState(payload.artifactsDir, payload.agentId);
+	if (finalState) writeAgentState(payload.artifactsDir, createAgentState({
+		...finalState,
+		status: exitCode === 0 ? "idle" : "blocked",
+		lastMessage: completionMessage,
+		waitingOn: exitCode === 0 ? null : "human-or-follow-up-run",
+		blocked: exitCode !== 0,
+		session: createAgentSessionRecord({
+			sessionDir: latestSession.sessionDir ?? payload.sessionDir,
+			sessionId: latestSession.sessionId,
+			sessionPath: latestSession.sessionPath,
+			processId: null,
+			lastAttachedAt: finalState.session.lastAttachedAt
+		})
+	}));
+}
+async function main() {
+	const [encodedPayload] = process.argv.slice(2);
+	if (!encodedPayload) throw new Error("Missing detached agent payload");
+	await runDetachedAgent(JSON.parse(Buffer.from(encodedPayload, "base64url").toString("utf-8")));
+}
+main().catch((error) => {
+	console.error(error instanceof Error ? error.stack ?? error.message : String(error));
+	process.exitCode = 1;
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=agent-runner.mjs.map

package/dist/agent-runner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.mjs","names":[],"sources":["../src/agent-runner.ts"],"sourcesContent":["import { spawn } from \"node:child_process\"\nimport { createWriteStream, mkdirSync, readFileSync, writeFileSync } from \"node:fs\"\nimport { finished } from \"node:stream/promises\"\nimport {\n\tappendAgentMessage,\n\tcreateAgentSessionRecord,\n\tcreateAgentState,\n\tgetAgentDir,\n\tgetLatestAgentSession,\n\treadAgentState,\n\twriteAgentState,\n} from \"./agents.js\"\nimport { updateTaskRecordStatus } from \"./tasks.js\"\n\ninterface DetachedAgentRunPayload {\n\trepoRoot: string\n\tartifactsDir: string\n\tagentId: string\n\trole: string\n\ttask: string | null\n\ttaskId: string | null\n\tsessionDir: string\n\tpiArgs: string[]\n}\n\ninterface ChildCompletion {\n\texitCode: number\n\terror: Error | null\n}\n\nasync function waitForChild(child: ReturnType<typeof spawn>): Promise<ChildCompletion> {\n\treturn new Promise((resolve) => {\n\t\tlet error: Error | null = null\n\t\tchild.once(\"error\", (value) => {\n\t\t\terror = value\n\t\t})\n\t\tchild.once(\"close\", (code) => {\n\t\t\tresolve({\n\t\t\t\texitCode: code ?? 1,\n\t\t\t\terror,\n\t\t\t})\n\t\t})\n\t})\n}\n\nasync function runDetachedAgent(payload: DetachedAgentRunPayload) {\n\tconst startedAt = new Date().toISOString()\n\tconst agentArtifactsDir = getAgentDir(payload.artifactsDir, payload.agentId)\n\tconst stdoutPath = `${agentArtifactsDir}/latest-stdout.txt`\n\tconst stderrPath = `${agentArtifactsDir}/latest-stderr.txt`\n\tconst invocationPath = `${agentArtifactsDir}/latest-invocation.json`\n\tmkdirSync(agentArtifactsDir, { recursive: true })\n\n\tconst stdoutStream = createWriteStream(stdoutPath, { encoding: \"utf-8\" })\n\tconst stderrStream = createWriteStream(stderrPath, { encoding: \"utf-8\" })\n\tconst child = spawn(\"pi\", payload.piArgs, {\n\t\tcwd: payload.repoRoot,\n\t\tenv: process.env,\n\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t})\n\n\tif (child.stdout) child.stdout.pipe(stdoutStream)\n\tif (child.stderr) child.stderr.pipe(stderrStream)\n\n\tconst currentState = readAgentState(payload.artifactsDir, payload.agentId)\n\tif (currentState) {\n\t\twriteAgentState(\n\t\t\tpayload.artifactsDir,\n\t\t\tcreateAgentState({\n\t\t\t\t...currentState,\n\t\t\t\tstatus: \"running\",\n\t\t\t\tlastMessage: payload.task ? `Running ${payload.role} task: ${payload.task}` : `Running ${payload.role} agent`,\n\t\t\t\twaitingOn: null,\n\t\t\t\tblocked: false,\n\t\t\t\tsession: createAgentSessionRecord({\n\t\t\t\t\tsessionDir: payload.sessionDir,\n\t\t\t\t\tsessionId: currentState.session.sessionId,\n\t\t\t\t\tsessionPath: currentState.session.sessionPath,\n\t\t\t\t\tprocessId: child.pid ?? null,\n\t\t\t\t\tlastAttachedAt: currentState.session.lastAttachedAt,\n\t\t\t\t}),\n\t\t\t}),\n\t\t)\n\t}\n\n\twriteFileSync(\n\t\tinvocationPath,\n\t\t`${JSON.stringify(\n\t\t\t{\n\t\t\t\tcommand: \"pi\",\n\t\t\t\targs: payload.piArgs,\n\t\t\t\texitCode: null,\n\t\t\t\tsessionDir: payload.sessionDir,\n\t\t\t\tsessionPath: null,\n\t\t\t\tsessionId: null,\n\t\t\t\tprocessId: child.pid ?? null,\n\t\t\t\tstartedAt,\n\t\t\t},\n\t\t\tnull,\n\t\t\t2,\n\t\t)}\\n`,\n\t\t\"utf-8\",\n\t)\n\n\tconst { exitCode, error } = await waitForChild(child)\n\tif (!stdoutStream.writableEnded) stdoutStream.end()\n\tif (!stderrStream.writableEnded) stderrStream.end()\n\tawait Promise.all([finished(stdoutStream), finished(stderrStream)])\n\n\tconst stdout = readFileSync(stdoutPath, \"utf-8\")\n\tconst stderr = readFileSync(stderrPath, \"utf-8\")\n\tconst latestSession = getLatestAgentSession(payload.artifactsDir, payload.agentId)\n\tconst completionMessage =\n\t\tstdout.trim() ||\n\t\t(error?.message?.trim() ?? \"\") ||\n\t\t(exitCode === 0 ? `${payload.role} run completed` : `${payload.role} run exited with code ${exitCode}`)\n\n\tif (error) {\n\t\twriteFileSync(stderrPath, `${stderr}${stderr.endsWith(\"\\n\") || stderr.length === 0 ? \"\" : \"\\n\"}${error.message}\\n`, \"utf-8\")\n\t}\n\n\twriteFileSync(\n\t\tinvocationPath,\n\t\t`${JSON.stringify(\n\t\t\t{\n\t\t\t\tcommand: \"pi\",\n\t\t\t\targs: payload.piArgs,\n\t\t\t\texitCode,\n\t\t\t\tsessionDir: latestSession.sessionDir ?? payload.sessionDir,\n\t\t\t\tsessionPath: latestSession.sessionPath,\n\t\t\t\tsessionId: latestSession.sessionId,\n\t\t\t\tprocessId: child.pid ?? null,\n\t\t\t\tstartedAt,\n\t\t\t\tendedAt: new Date().toISOString(),\n\t\t\t},\n\t\t\tnull,\n\t\t\t2,\n\t\t)}\\n`,\n\t\t\"utf-8\",\n\t)\n\n\tappendAgentMessage({\n\t\tartifactsDir: payload.artifactsDir,\n\t\tagentId: payload.agentId,\n\t\tbox: \"outbox\",\n\t\tfrom: payload.agentId,\n\t\tbody: completionMessage,\n\t})\n\n\tif (payload.taskId) {\n\t\tupdateTaskRecordStatus(payload.artifactsDir, payload.taskId, exitCode === 0 ? \"completed\" : \"blocked\")\n\t}\n\n\tconst finalState = readAgentState(payload.artifactsDir, payload.agentId)\n\tif (finalState) {\n\t\twriteAgentState(\n\t\t\tpayload.artifactsDir,\n\t\t\tcreateAgentState({\n\t\t\t\t...finalState,\n\t\t\t\tstatus: exitCode === 0 ? \"idle\" : \"blocked\",\n\t\t\t\tlastMessage: completionMessage,\n\t\t\t\twaitingOn: exitCode === 0 ? null : \"human-or-follow-up-run\",\n\t\t\t\tblocked: exitCode !== 0,\n\t\t\t\tsession: createAgentSessionRecord({\n\t\t\t\t\tsessionDir: latestSession.sessionDir ?? payload.sessionDir,\n\t\t\t\t\tsessionId: latestSession.sessionId,\n\t\t\t\t\tsessionPath: latestSession.sessionPath,\n\t\t\t\t\tprocessId: null,\n\t\t\t\t\tlastAttachedAt: finalState.session.lastAttachedAt,\n\t\t\t\t}),\n\t\t\t}),\n\t\t)\n\t}\n}\n\nasync function main() {\n\tconst [encodedPayload] = process.argv.slice(2)\n\tif (!encodedPayload) {\n\t\tthrow new Error(\"Missing detached agent payload\")\n\t}\n\n\tconst payload = JSON.parse(Buffer.from(encodedPayload, \"base64url\").toString(\"utf-8\")) as DetachedAgentRunPayload\n\tawait runDetachedAgent(payload)\n}\n\nvoid main().catch((error) => {\n\tconsole.error(error instanceof Error ? error.stack ?? error.message : String(error))\n\tprocess.exitCode = 1\n})\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -2,15 +2,16 @@
 type InterruptCategory = "missing-context" | "spec-gap" | "policy-gap" | "validation-gap" | "tooling-failure" | "external-blocker";
 type FixType = "adr" | "docs" | "policy" | "prompt" | "skill" | "tooling" | "validation";
 type RunMode = "single-pi";
-type AgentStatus = "queued" | "starting" | "running" | "idle" | "blocked" | "completed" | "failed";
+type AgentStatus = "queued" | "starting" | "running" | "idle" | "blocked" | "completed" | "failed" | "stopped";
 type AgentMailbox = "inbox" | "outbox";
-type TaskStatus = "queued" | "running" | "blocked" | "completed";
+type TaskStatus = "queued" | "running" | "blocked" | "completed" | "aborted";
 interface AgentSessionRecord {
   runtime: "pi";
   persisted: boolean;
   sessionDir: string | null;
   sessionId: string | null;
   sessionPath: string | null;
+  processId: number | null;
   lastAttachedAt: string | null;
 }
 interface AgentStateSnapshot {
@@ -146,12 +147,13 @@ interface ControllerRunResult {
   summary: RunSummary;
   piInvocation: PiInvocationRecord;
 }
-type LoopStopReason = "all-tasks-completed" | "all-remaining-tasks-blocked" | "leader-blocked" | "max-iterations-reached" | "max-wall-time-reached" | "pi-exit-nonzero" | "high-interrupt-rate";
+type LoopStopReason = "all-tasks-completed" | "all-remaining-tasks-blocked" | "mayor-blocked" | "mayor-idle-no-work" | "max-iterations-reached" | "max-wall-time-reached" | "pi-exit-nonzero" | "high-interrupt-rate";
 interface LoopOptions {
   runOptions: RunOptions;
   maxIterations?: number;
   maxWallTimeMs?: number;
   stopOnPiFailure?: boolean;
+  stopOnMayorIdleNoWork?: boolean;
   interruptRateThreshold?: number | null;
   onIterationComplete?: (iteration: LoopIterationResult) => void;
 }
@@ -167,7 +169,7 @@ interface BoardSnapshot {
   }>;
   allTasksCompleted: boolean;
   allRemainingTasksBlocked: boolean;
-  leaderBlocked: boolean;
+  mayorBlocked: boolean;
   hasQueuedOrRunningWork: boolean;
 }
 interface LoopIterationResult {
@@ -197,7 +199,7 @@ declare function getAgentSessionPath(artifactsDir: string, agentId: string): str
 declare function getAgentMailboxPath(artifactsDir: string, agentId: string, box: AgentMailbox): string;
 declare function getAgentSessionsDir(artifactsDir: string, agentId: string): string;
 declare function getSessionIdFromPath(sessionPath: string | null | undefined): string | null;
-declare function createAgentSessionRecord(input?: Partial<Pick<AgentSessionRecord, "sessionDir" | "sessionId" | "sessionPath" | "lastAttachedAt">>): AgentSessionRecord;
+declare function createAgentSessionRecord(input?: Partial<Pick<AgentSessionRecord, "sessionDir" | "sessionId" | "sessionPath" | "processId" | "lastAttachedAt">>): AgentSessionRecord;
 declare function createAgentState(input: {
   agentId: string;
   role: string;
@@ -259,6 +261,7 @@ declare function evaluateStopCondition(input: {
   maxWallTimeMs: number;
   piExitCode: number;
   stopOnPiFailure: boolean;
+  stopOnMayorIdleNoWork: boolean;
   board: BoardSnapshot;
   metrics: MetricsSnapshot;
   interruptRateThreshold: number | null;
@@ -287,37 +290,31 @@ interface SpawnAgentRunOptions {
   role: string;
   agentId: string;
   task: string | null;
-  appendedSystemPrompt?: string | null;
-  extensionPath?: string | null;
-  taskId?: string | null;
+  appendedSystemPrompt?: string | null | undefined;
+  extensionPath?: string | null | undefined;
+  taskId?: string | null | undefined;
 }
 interface SpawnAgentRunResult {
-  piResult: {
-    stdout: string;
-    stderr: string;
-    exitCode: number;
+  launch: {
+    processId: number;
+    startedAt: string;
   };
   latestSession: AgentSessionRecord;
-  completionMessage: string;
 }
 interface DelegateTaskOptions {
   repoRoot: string;
   artifactsDir: string;
   fromAgentId: string;
   role: string;
-  agentId?: string | null;
-  appendedSystemPrompt?: string | null;
-  extensionPath?: string | null;
+  agentId?: string | null | undefined;
+  appendedSystemPrompt?: string | null | undefined;
+  extensionPath?: string | null | undefined;
   task: string;
 }
 interface DelegateTaskResult {
   task: TaskRecord;
   agentId: string;
-  piResult: {
-    stdout: string;
-    stderr: string;
-    exitCode: number;
-  };
+  launch: SpawnAgentRunResult["launch"];
   latestSession: AgentSessionRecord;
 }
 interface ResolvedAgentSession {
@@ -356,7 +353,7 @@ declare function queueAgentMessage(input: {
 declare function updateAgentStatus(input: {
   artifactsDir: string;
   agentId: string;
-  status: "queued" | "running" | "idle" | "blocked" | "completed" | "failed";
+  status: "queued" | "running" | "idle" | "blocked" | "completed" | "failed" | "stopped";
   lastMessage?: string | null;
   waitingOn?: string | null;
   blocked?: boolean;
@@ -393,6 +390,62 @@ declare function runCommandInteractive(command: string, args: string[], options?
 }): number;
 declare function assertSuccess(result: CommandResult, context: string): void;
 //#endregion
+//#region src/stop.d.ts
+interface LeaseData {
+  runId: string;
+  repoId: string;
+  branch: string;
+  pid: number;
+  hostname: string;
+  startedAt: string;
+}
+interface StopManagedAgentsOptions {
+  artifactsDir: string;
+  agentId?: string | null;
+  excludeAgentIds?: string[];
+  actorId?: string | null;
+  reason?: string | null;
+  force?: boolean;
+  graceMs?: number;
+}
+interface StopAgentResult {
+  agentId: string;
+  previousStatus: AgentStateSnapshot["status"];
+  nextStatus: AgentStateSnapshot["status"];
+  processId: number | null;
+  signal: "SIGTERM" | "SIGKILL" | null;
+  exited: boolean;
+}
+interface StopManagedAgentsResult {
+  results: StopAgentResult[];
+  stoppedAgents: number;
+  signaledProcesses: number;
+}
+interface RepoLeaseRecord extends LeaseData {
+  path: string;
+}
+interface StopRepoLeasesOptions {
+  repoId?: string | null;
+  force?: boolean;
+  graceMs?: number;
+}
+interface StopRepoLeaseResult {
+  path: string;
+  runId: string;
+  repoId: string;
+  branch: string;
+  processId: number;
+  signal: "SIGTERM" | "SIGKILL" | null;
+  exited: boolean;
+}
+interface StopRepoLeasesResult {
+  results: StopRepoLeaseResult[];
+  signaledProcesses: number;
+}
+declare function listRepoLeases(repoId?: string | null): RepoLeaseRecord[];
+declare function stopRepoLeases(options: StopRepoLeasesOptions): StopRepoLeasesResult;
+declare function stopManagedAgents(options: StopManagedAgentsOptions): StopManagedAgentsResult;
+//#endregion
 //#region src/tasks.d.ts
 declare function getTasksDir(artifactsDir: string): string;
 declare function getTaskPath(artifactsDir: string, taskId: string): string;
@@ -409,5 +462,5 @@ declare function updateTaskRecordStatus(artifactsDir: string, taskId: string, st
 declare function readTaskRecord(artifactsDir: string, taskId: string): TaskRecord | null;
 declare function listTaskRecords(artifactsDir: string): TaskRecord[];
 //#endregion
-export { AgentMailbox, AgentMessageRecord, AgentSessionRecord, AgentStateSnapshot, AgentStatus, BoardSnapshot, CommandResult, ControllerRunResult, CreateInterruptInput, DelegateTaskOptions, DelegateTaskResult, FeedbackCycle, FixType, InterruptCategory, InterruptRecord, LoopIterationResult, LoopOptions, LoopRunResult, LoopStopReason, MetricsSnapshot, PiInvocationRecord, ResolvedAgentSession, RunAgentTurnOptions, RunAgentTurnResult, RunManifest, RunMode, RunOptions, RunSummary, SpawnAgentRunOptions, SpawnAgentRunResult, TaskAttempt, TaskRecord, TaskStatus, acquireRepoLease, appendAgentMessage, appendJsonl, assertCommandAvailable, assertSuccess, computeAutonomousCompletionRate, computeContextCoverageScore, computeFeedbackToDemoCycleTime, computeInterruptRate, computeMeanTimeToCorrect, computeMetrics, createAgentSessionRecord, createAgentState, createInterruptRecord, createPiAuthHelpMessage, createRepoSlug, createRolePrompt, createTaskRecord, delegateTask, detectPiAuthFailure, evaluateStopCondition, getAgentDir, getAgentMailboxPath, getAgentSessionPath, getAgentSessionsDir, getAgentStatePath, getAgentsDir, getCurrentBranch, getLatestAgentSession, getRepoIdentity, getRepoRoot, getSessionIdFromPath, getTaskPath, getTasksDir, isGitRepo, listAgentStates, listTaskRecords, queueAgentMessage, readAgentMessages, readAgentState, readJsonl, readTaskRecord, resolveAgentSession, resolveInterrupt, runAgentTurn, runCommandInteractive, runCommandSync, runController, runLoop, snapshotBoard, spawnAgentRun, updateAgentStatus, updateTaskRecordStatus, writeAgentState, writeTaskRecord };
+export { AgentMailbox, AgentMessageRecord, AgentSessionRecord, AgentStateSnapshot, AgentStatus, BoardSnapshot, CommandResult, ControllerRunResult, CreateInterruptInput, DelegateTaskOptions, DelegateTaskResult, FeedbackCycle, FixType, InterruptCategory, InterruptRecord, LoopIterationResult, LoopOptions, LoopRunResult, LoopStopReason, MetricsSnapshot, PiInvocationRecord, RepoLeaseRecord, ResolvedAgentSession, RunAgentTurnOptions, RunAgentTurnResult, RunManifest, RunMode, RunOptions, RunSummary, SpawnAgentRunOptions, SpawnAgentRunResult, StopAgentResult, StopManagedAgentsOptions, StopManagedAgentsResult, StopRepoLeaseResult, StopRepoLeasesOptions, StopRepoLeasesResult, TaskAttempt, TaskRecord, TaskStatus, acquireRepoLease, appendAgentMessage, appendJsonl, assertCommandAvailable, assertSuccess, computeAutonomousCompletionRate, computeContextCoverageScore, computeFeedbackToDemoCycleTime, computeInterruptRate, computeMeanTimeToCorrect, computeMetrics, createAgentSessionRecord, createAgentState, createInterruptRecord, createPiAuthHelpMessage, createRepoSlug, createRolePrompt, createTaskRecord, delegateTask, detectPiAuthFailure, evaluateStopCondition, getAgentDir, getAgentMailboxPath, getAgentSessionPath, getAgentSessionsDir, getAgentStatePath, getAgentsDir, getCurrentBranch, getLatestAgentSession, getRepoIdentity, getRepoRoot, getSessionIdFromPath, getTaskPath, getTasksDir, isGitRepo, listAgentStates, listRepoLeases, listTaskRecords, queueAgentMessage, readAgentMessages, readAgentState, readJsonl, readTaskRecord, resolveAgentSession, resolveInterrupt, runAgentTurn, runCommandInteractive, runCommandSync, runController, runLoop, snapshotBoard, spawnAgentRun, stopManagedAgents, stopRepoLeases, updateAgentStatus, updateTaskRecordStatus, writeAgentState, writeTaskRecord };
 //# sourceMappingURL=index.d.mts.map