@schilderlabs/pitown-core 0.1.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,6 +2,48 @@
 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" | "stopped";
+type AgentMailbox = "inbox" | "outbox";
+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 {
+  agentId: string;
+  role: string;
+  status: AgentStatus;
+  taskId: string | null;
+  task: string | null;
+  branch: string | null;
+  updatedAt: string;
+  lastMessage: string | null;
+  waitingOn: string | null;
+  blocked: boolean;
+  runId: string | null;
+  session: AgentSessionRecord;
+}
+interface AgentMessageRecord {
+  box: AgentMailbox;
+  from: string;
+  body: string;
+  createdAt: string;
+}
+interface TaskRecord {
+  taskId: string;
+  title: string;
+  status: TaskStatus;
+  role: string;
+  assignedAgentId: string;
+  createdBy: string;
+  createdAt: string;
+  updatedAt: string;
+}
 interface InterruptRecord {
   id: string;
   runId: string;
@@ -47,6 +89,8 @@ interface RunOptions {
   mode?: RunMode;
   planPath?: string | null;
   recommendedPlanDir?: string | null;
+  appendedSystemPrompt?: string | null;
+  extensionPath?: string | null;
   piCommand?: string;
 }
 interface RunManifest {
@@ -75,6 +119,9 @@ interface PiInvocationRecord {
   repoRoot: string;
   planPath: string | null;
   goal: string | null;
+  sessionDir: string | null;
+  sessionId: string | null;
+  sessionPath: string | null;
   startedAt: string;
   endedAt: string;
   exitCode: number;
@@ -100,6 +147,84 @@ interface ControllerRunResult {
   summary: RunSummary;
   piInvocation: PiInvocationRecord;
 }
+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;
+}
+interface BoardSnapshot {
+  tasks: Array<{
+    taskId: string;
+    status: TaskStatus;
+  }>;
+  agents: Array<{
+    agentId: string;
+    status: AgentStatus;
+    blocked: boolean;
+  }>;
+  allTasksCompleted: boolean;
+  allRemainingTasksBlocked: boolean;
+  mayorBlocked: boolean;
+  hasQueuedOrRunningWork: boolean;
+}
+interface LoopIterationResult {
+  iteration: number;
+  controllerResult: ControllerRunResult;
+  boardSnapshot: BoardSnapshot;
+  metrics: MetricsSnapshot;
+  elapsedMs: number;
+  continueReason: string | null;
+  stopReason: LoopStopReason | null;
+}
+interface LoopRunResult {
+  loopId: string;
+  iterations: LoopIterationResult[];
+  stopReason: LoopStopReason;
+  totalIterations: number;
+  totalElapsedMs: number;
+  finalBoardSnapshot: BoardSnapshot;
+  aggregateMetrics: MetricsSnapshot;
+}
+//#endregion
+//#region src/agents.d.ts
+declare function getAgentsDir(artifactsDir: string): string;
+declare function getAgentDir(artifactsDir: string, agentId: string): string;
+declare function getAgentStatePath(artifactsDir: string, agentId: string): string;
+declare function getAgentSessionPath(artifactsDir: string, agentId: string): string;
+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" | "processId" | "lastAttachedAt">>): AgentSessionRecord;
+declare function createAgentState(input: {
+  agentId: string;
+  role: string;
+  status: AgentStatus;
+  taskId?: string | null;
+  task?: string | null;
+  branch?: string | null;
+  lastMessage?: string | null;
+  waitingOn?: string | null;
+  blocked?: boolean;
+  runId?: string | null;
+  session?: AgentSessionRecord;
+}): AgentStateSnapshot;
+declare function writeAgentState(artifactsDir: string, state: AgentStateSnapshot): void;
+declare function readAgentState(artifactsDir: string, agentId: string): AgentStateSnapshot | null;
+declare function listAgentStates(artifactsDir: string): AgentStateSnapshot[];
+declare function appendAgentMessage(input: {
+  artifactsDir: string;
+  agentId: string;
+  box: AgentMailbox;
+  from: string;
+  body: string;
+}): AgentMessageRecord;
+declare function readAgentMessages(artifactsDir: string, agentId: string, box: AgentMailbox): AgentMessageRecord[];
+declare function getLatestAgentSession(artifactsDir: string, agentId: string): AgentSessionRecord;
 //#endregion
 //#region src/controller.d.ts
 declare function runController(options: RunOptions): ControllerRunResult;
@@ -127,6 +252,25 @@ declare function acquireRepoLease(runId: string, repoId: string, branch: string)
   release: () => void;
 };
 //#endregion
+//#region src/loop.d.ts
+declare function snapshotBoard(artifactsDir: string): BoardSnapshot;
+declare function evaluateStopCondition(input: {
+  iteration: number;
+  maxIterations: number;
+  elapsedMs: number;
+  maxWallTimeMs: number;
+  piExitCode: number;
+  stopOnPiFailure: boolean;
+  stopOnMayorIdleNoWork: boolean;
+  board: BoardSnapshot;
+  metrics: MetricsSnapshot;
+  interruptRateThreshold: number | null;
+}): {
+  stopReason: LoopStopReason | null;
+  continueReason: string | null;
+};
+declare function runLoop(options: LoopOptions): LoopRunResult;
+//#endregion
 //#region src/metrics.d.ts
 declare function computeInterruptRate(interrupts: InterruptRecord[], taskAttempts: TaskAttempt[]): number;
 declare function computeAutonomousCompletionRate(taskAttempts: TaskAttempt[]): number;
@@ -139,6 +283,89 @@ declare function computeMetrics(input: {
   feedbackCycles?: FeedbackCycle[];
 }): MetricsSnapshot;
 //#endregion
+//#region src/orchestration.d.ts
+interface SpawnAgentRunOptions {
+  repoRoot: string;
+  artifactsDir: string;
+  role: string;
+  agentId: string;
+  task: string | null;
+  appendedSystemPrompt?: string | null | undefined;
+  extensionPath?: string | null | undefined;
+  taskId?: string | null | undefined;
+}
+interface SpawnAgentRunResult {
+  launch: {
+    processId: number;
+    startedAt: string;
+  };
+  latestSession: AgentSessionRecord;
+}
+interface DelegateTaskOptions {
+  repoRoot: string;
+  artifactsDir: string;
+  fromAgentId: string;
+  role: string;
+  agentId?: string | null | undefined;
+  appendedSystemPrompt?: string | null | undefined;
+  extensionPath?: string | null | undefined;
+  task: string;
+}
+interface DelegateTaskResult {
+  task: TaskRecord;
+  agentId: string;
+  launch: SpawnAgentRunResult["launch"];
+  latestSession: AgentSessionRecord;
+}
+interface ResolvedAgentSession {
+  state: AgentStateSnapshot;
+  session: AgentSessionRecord;
+}
+interface RunAgentTurnOptions {
+  repoRoot: string;
+  artifactsDir: string;
+  agentId: string;
+  message: string;
+  from?: string;
+  runtimeArgs?: string[] | null;
+}
+interface RunAgentTurnResult {
+  piResult: {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+  };
+  latestSession: AgentSessionRecord;
+  completionMessage: string;
+}
+declare function createRolePrompt(input: {
+  role: string;
+  task: string | null;
+  repoRoot: string;
+}): string;
+declare function resolveAgentSession(agentId: string, artifactsDir: string): ResolvedAgentSession;
+declare function queueAgentMessage(input: {
+  artifactsDir: string;
+  agentId: string;
+  from: string;
+  body: string;
+}): void;
+declare function updateAgentStatus(input: {
+  artifactsDir: string;
+  agentId: string;
+  status: "queued" | "running" | "idle" | "blocked" | "completed" | "failed" | "stopped";
+  lastMessage?: string | null;
+  waitingOn?: string | null;
+  blocked?: boolean;
+}): void;
+declare function spawnAgentRun(options: SpawnAgentRunOptions): SpawnAgentRunResult;
+declare function runAgentTurn(options: RunAgentTurnOptions): RunAgentTurnResult;
+declare function delegateTask(options: DelegateTaskOptions): DelegateTaskResult;
+//#endregion
+//#region src/pi.d.ts
+declare function detectPiAuthFailure(stderr: string, stdout: string): boolean;
+declare function createPiAuthHelpMessage(): string;
+//#endregion
 //#region src/repo.d.ts
 declare function isGitRepo(cwd: string): boolean;
 declare function getRepoRoot(cwd: string): string;
@@ -157,7 +384,83 @@ declare function runCommandSync(command: string, args: string[], options?: {
   env?: NodeJS.ProcessEnv;
 }): CommandResult;
 declare function assertCommandAvailable(command: string): void;
+declare function runCommandInteractive(command: string, args: string[], options?: {
+  cwd?: string;
+  env?: NodeJS.ProcessEnv;
+}): number;
 declare function assertSuccess(result: CommandResult, context: string): void;
 //#endregion
-export { CommandResult, ControllerRunResult, CreateInterruptInput, FeedbackCycle, FixType, InterruptCategory, InterruptRecord, MetricsSnapshot, PiInvocationRecord, RunManifest, RunMode, RunOptions, RunSummary, TaskAttempt, acquireRepoLease, appendJsonl, assertCommandAvailable, assertSuccess, computeAutonomousCompletionRate, computeContextCoverageScore, computeFeedbackToDemoCycleTime, computeInterruptRate, computeMeanTimeToCorrect, computeMetrics, createInterruptRecord, createRepoSlug, getCurrentBranch, getRepoIdentity, getRepoRoot, isGitRepo, readJsonl, resolveInterrupt, runCommandSync, runController };
+//#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;
+declare function createTaskRecord(input: {
+  taskId: string;
+  title: string;
+  status: TaskStatus;
+  role: string;
+  assignedAgentId: string;
+  createdBy: string;
+}): TaskRecord;
+declare function writeTaskRecord(artifactsDir: string, task: TaskRecord): void;
+declare function updateTaskRecordStatus(artifactsDir: string, taskId: string, status: TaskStatus): TaskRecord | null;
+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, 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