@ai-devkit/agent-manager 0.31.0 → 0.33.0

package/src/durable/process.ts

@@ -1,28 +1,29 @@
-import fs from 'fs';
-import { execFileSync } from 'child_process';
-import type { ProcessIdentity } from './DurableAgent.js';
+import fs from "fs";
+import { execFileSync } from "child_process";
+import type { ProcessIdentity } from "./DurableAgent.js";
 
 export interface ProcessInspector {
-    getIdentity(pid: number): ProcessIdentity | null;
+  getIdentity(pid: number): ProcessIdentity | null;
 }
 
 export class LocalProcessInspector implements ProcessInspector {
-    getIdentity(pid: number): ProcessIdentity | null {
-        if (!Number.isInteger(pid) || pid <= 0) return null;
-        try {
-            if (process.platform === 'linux') {
-                const stat = fs.readFileSync(`/proc/${pid}/stat`, 'utf8');
-                const close = stat.lastIndexOf(')');
-                const fields = stat.slice(close + 2).split(' ');
-                const startTicks = fields[19];
-                return startTicks ? { pid, startedAt: `linux:${startTicks}` } : null;
-            }
-            const startedAt = execFileSync('ps', ['-o', 'lstart=', '-p', String(pid)], {
-                encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'],
-            }).trim();
-            return startedAt ? { pid, startedAt } : null;
-        } catch {
-            return null;
-        }
+  getIdentity(pid: number): ProcessIdentity | null {
+    if (!Number.isInteger(pid) || pid <= 0) return null;
+    try {
+      if (process.platform === "linux") {
+        const stat = fs.readFileSync(`/proc/${pid}/stat`, "utf8");
+        const close = stat.lastIndexOf(")");
+        const fields = stat.slice(close + 2).split(" ");
+        const startTicks = fields[19];
+        return startTicks ? { pid, startedAt: `linux:${startTicks}` } : null;
+      }
+      const startedAt = execFileSync("ps", ["-o", "lstart=", "-p", String(pid)], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+      }).trim();
+      return startedAt ? { pid, startedAt } : null;
+    } catch {
+      return null;
     }
+  }
 }

package/src/durable/run.ts

@@ -1,74 +1,84 @@
-import type { DurableAgent, DurableProvider } from './DurableAgent.js';
-import { DurableAgentNotFoundError } from './DurableAgent.js';
-import type { DurableRunCompletion } from './DurableAgentRepository.js';
-import { sanitizeText } from './utils.js';
+import type { DurableAgent, DurableProvider } from "./DurableAgent.js";
+import { DurableAgentNotFoundError } from "./DurableAgent.js";
+import type { DurableRunCompletion } from "./DurableAgentRepository.js";
+import { sanitizeText } from "./utils.js";
 
 const MAX_RESULT_SUMMARY_LENGTH = 4096;
 
 export interface DurableRunRepository {
-    resolve(reference: string): Promise<DurableAgent | DurableAgent[] | null>;
-    acquireRun(id: string): Promise<{ agent: DurableAgent; token: string }>;
-    completeRun(id: string, token: string, result: DurableRunCompletion): Promise<DurableAgent>;
+  resolve(reference: string): Promise<DurableAgent | DurableAgent[] | null>;
+  acquireRun(id: string): Promise<{ agent: DurableAgent; token: string }>;
+  completeRun(id: string, token: string, result: DurableRunCompletion): Promise<DurableAgent>;
 }
 
-type ProviderAgent<Provider extends DurableProvider> = Extract<DurableAgent, { provider: Provider }>;
+type ProviderAgent<Provider extends DurableProvider> = Extract<
+  DurableAgent,
+  { provider: Provider }
+>;
 
 interface DurableRunResult {
-    result: string;
-    exitCode: number;
+  result: string;
+  exitCode: number;
 }
 
 interface DurableRunOptions<Provider extends DurableProvider, Result extends DurableRunResult> {
-    reference: string;
-    provider: Provider;
-    repository: DurableRunRepository;
-    ambiguousError(): Error;
-    providerError(): Error;
-    execute(agent: ProviderAgent<Provider>, token: string): Promise<Result>;
-    isSessionMismatch(error: unknown): boolean;
+  reference: string;
+  provider: Provider;
+  repository: DurableRunRepository;
+  ambiguousError(): Error;
+  providerError(): Error;
+  execute(agent: ProviderAgent<Provider>, token: string): Promise<Result>;
+  isSessionMismatch(error: unknown): boolean;
 }
 
-export async function runDurableAgent<Provider extends DurableProvider, Result extends DurableRunResult>(
-    options: DurableRunOptions<Provider, Result>,
+export async function runDurableAgent<
+  Provider extends DurableProvider,
+  Result extends DurableRunResult,
+>(
+  options: DurableRunOptions<Provider, Result>,
 ): Promise<{ agent: ProviderAgent<Provider>; result: Result }> {
-    const resolved = await options.repository.resolve(options.reference);
-    if (!resolved) throw new DurableAgentNotFoundError(options.reference);
-    if (Array.isArray(resolved)) throw options.ambiguousError();
-    if (resolved.provider !== options.provider) throw options.providerError();
+  const resolved = await options.repository.resolve(options.reference);
+  if (!resolved) throw new DurableAgentNotFoundError(options.reference);
+  if (Array.isArray(resolved)) throw options.ambiguousError();
+  if (resolved.provider !== options.provider) throw options.providerError();
 
-    const target = resolved as ProviderAgent<Provider>;
-    const acquired = await options.repository.acquireRun(target.id);
-    let result: Result;
-    try {
-        result = await options.execute(acquired.agent as ProviderAgent<Provider>, acquired.token);
-    } catch (error) {
-        await options.repository.completeRun(
-            target.id,
-            acquired.token,
-            createFailedCompletion(error, options.isSessionMismatch(error)),
-        );
-        throw error;
-    }
+  const target = resolved as ProviderAgent<Provider>;
+  const acquired = await options.repository.acquireRun(target.id);
+  let result: Result;
+  try {
+    result = await options.execute(acquired.agent as ProviderAgent<Provider>, acquired.token);
+  } catch (error) {
+    await options.repository.completeRun(
+      target.id,
+      acquired.token,
+      createFailedCompletion(error, options.isSessionMismatch(error)),
+    );
+    throw error;
+  }
 
-    await options.repository.completeRun(target.id, acquired.token, createSucceededCompletion(result));
-    return { agent: target, result };
+  await options.repository.completeRun(
+    target.id,
+    acquired.token,
+    createSucceededCompletion(result),
+  );
+  return { agent: target, result };
 }
 
 function createSucceededCompletion(result: DurableRunResult): DurableRunCompletion {
-    return {
-        status: 'succeeded',
-        exitCode: result.exitCode,
-        summary: sanitizeText(result.result, MAX_RESULT_SUMMARY_LENGTH, { preserveFormatting: true }),
-        sessionHealth: 'healthy',
-    };
+  return {
+    status: "succeeded",
+    exitCode: result.exitCode,
+    summary: sanitizeText(result.result, MAX_RESULT_SUMMARY_LENGTH, { preserveFormatting: true }),
+    sessionHealth: "healthy",
+  };
 }
 
 function createFailedCompletion(error: unknown, sessionMismatch: boolean): DurableRunCompletion {
-    const message = error instanceof Error ? error.message : String(error);
-    return {
-        status: 'failed',
-        exitCode: null,
-        summary: sanitizeText(message, MAX_RESULT_SUMMARY_LENGTH, { preserveFormatting: true }),
-        sessionHealth: sessionMismatch ? 'mismatch' : 'unknown',
-    };
+  const message = error instanceof Error ? error.message : String(error);
+  return {
+    status: "failed",
+    exitCode: null,
+    summary: sanitizeText(message, MAX_RESULT_SUMMARY_LENGTH, { preserveFormatting: true }),
+    sessionHealth: sessionMismatch ? "mismatch" : "unknown",
+  };
 }

package/src/durable/utils.ts

@@ -1,61 +1,66 @@
-import type { ChildProcessWithoutNullStreams } from 'child_process';
+import type { ChildProcessWithoutNullStreams } from "child_process";
 
 export interface ChildCloseResult {
-    code: number | null;
-    signal: NodeJS.Signals | null;
+  code: number | null;
+  signal: NodeJS.Signals | null;
 }
 
-export function waitForChildClose(child: ChildProcessWithoutNullStreams): Promise<ChildCloseResult> {
-    return new Promise((resolve, reject) => {
-        child.once('error', reject);
-        child.once('close', (code, signal) => resolve({ code, signal }));
-    });
+export function waitForChildClose(
+  child: ChildProcessWithoutNullStreams,
+): Promise<ChildCloseResult> {
+  return new Promise((resolve, reject) => {
+    child.once("error", reject);
+    child.once("close", (code, signal) => resolve({ code, signal }));
+  });
 }
 
 export function sanitizeText(
-    value: string,
-    max: number,
-    options: { preserveFormatting?: boolean } = {},
+  value: string,
+  max: number,
+  options: { preserveFormatting?: boolean } = {},
 ): string {
-    return Array.from(value, (character) => {
-        const code = character.charCodeAt(0);
-        if (options.preserveFormatting && (code === 9 || code === 10 || code === 13)) return character;
-        return code <= 31 || code === 127 ? ' ' : character;
-    }).join('').trim().slice(0, max);
+  return Array.from(value, (character) => {
+    const code = character.charCodeAt(0);
+    if (options.preserveFormatting && (code === 9 || code === 10 || code === 13)) return character;
+    return code <= 31 || code === 127 ? " " : character;
+  })
+    .join("")
+    .trim()
+    .slice(0, max);
 }
 
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 
 export function isUuid(value: string): boolean {
-    return UUID_PATTERN.test(value);
+  return UUID_PATTERN.test(value);
 }
 
 export class LineBuffer {
-    private buffer = Buffer.alloc(0);
-
-    constructor(
-        private readonly maxLineBytes: number,
-        private readonly createOversizedLineError: () => Error,
-    ) {}
-
-    accept(chunk: Buffer | string): Buffer[] {
-        this.buffer = Buffer.concat([this.buffer, Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)]);
-        if (this.buffer.length > this.maxLineBytes && this.buffer.indexOf(0x0a) < 0) {
-            throw this.createOversizedLineError();
-        }
-
-        const lines: Buffer[] = [];
-        let newline: number;
-        while ((newline = this.buffer.indexOf(0x0a)) >= 0) {
-            const line = this.buffer.subarray(0, newline);
-            this.buffer = this.buffer.subarray(newline + 1);
-            if (line.length > this.maxLineBytes) throw this.createOversizedLineError();
-            lines.push(line);
-        }
-        return lines;
+  private buffer = Buffer.alloc(0);
+
+  constructor(
+    private readonly maxLineBytes: number,
+    private readonly createOversizedLineError: () => Error,
+  ) {}
+
+  accept(chunk: Buffer | string): Buffer[] {
+    this.buffer = Buffer.concat([this.buffer, Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)]);
+    if (this.buffer.length > this.maxLineBytes && this.buffer.indexOf(0x0a) < 0) {
+      throw this.createOversizedLineError();
     }
 
-    assertComplete(createIncompleteLineError: () => Error): void {
-        if (this.buffer.length > 0) throw createIncompleteLineError();
+    const lines: Buffer[] = [];
+    let newline: number;
+    while ((newline = this.buffer.indexOf(0x0a)) >= 0) {
+      const line = this.buffer.subarray(0, newline);
+      this.buffer = this.buffer.subarray(newline + 1);
+      if (line.length > this.maxLineBytes) throw this.createOversizedLineError();
+      lines.push(line);
     }
+    return lines;
+  }
+
+  assertComplete(createIncompleteLineError: () => Error): void {
+    if (this.buffer.length > 0) throw createIncompleteLineError();
+  }
 }

package/src/index.ts

@@ -1,100 +1,159 @@
-export { AgentManager, AgentNotRunningError } from './AgentManager.js';
-export { getCodexCapacityReport } from './capacity/index.js';
+export { AgentManager, AgentNotRunningError } from "./AgentManager.js";
+export { getCodexCapacityReport } from "./capacity/index.js";
+export type { CapacityProbeOptions, CapacityReport, CapacityWindow } from "./capacity/index.js";
+export {
+  getAgentReadinessReport,
+  getAgentReadinessReports,
+  worstReadinessStatus,
+} from "./readiness/AgentReadiness.js";
 export type {
-    CapacityProbeOptions,
-    CapacityReport,
-    CapacityWindow,
-} from './capacity/index.js';
+  AgentReadinessOptions,
+  AgentReadinessReport,
+  AuthReadinessCheck,
+  BuiltInSkillsReadinessCheck,
+  DirectoryReadinessCheck,
+  ExecutableReadinessCheck,
+  IntegrationReadinessCheck,
+  ReadinessAgentType,
+  ReadinessAuthState,
+  ReadinessCheck,
+  ReadinessStatus,
+} from "./readiness/AgentReadiness.js";
 
-export { ClaudeCodeAdapter } from './providers/claude/ClaudeCodeAdapter.js';
-export { CodexAdapter } from './adapters/CodexAdapter.js';
-export { CopilotAdapter } from './adapters/CopilotAdapter.js';
-export { GeminiCliAdapter } from './adapters/GeminiCliAdapter.js';
-export { GrokCliAdapter } from './adapters/GrokCliAdapter.js';
-export { OpenCodeAdapter } from './adapters/OpenCodeAdapter.js';
-export { PiAdapter } from './adapters/PiAdapter.js';
-export { AgentStatus } from './adapters/AgentAdapter.js';
+export { ClaudeCodeAdapter } from "./providers/claude/ClaudeCodeAdapter.js";
+export { CodexAdapter } from "./providers/codex/CodexAdapter.js";
+export { CopilotAdapter } from "./adapters/CopilotAdapter.js";
+export { GeminiCliAdapter } from "./adapters/GeminiCliAdapter.js";
+export { GrokCliAdapter } from "./adapters/GrokCliAdapter.js";
+export { OpenCodeAdapter } from "./adapters/OpenCodeAdapter.js";
+export { PiAdapter } from "./providers/pi/PiAdapter.js";
+export { AgentStatus } from "./adapters/AgentAdapter.js";
 export type {
-    AgentAdapter,
-    AgentType,
-    AgentInfo,
-    ProcessInfo,
-    ConversationMessage,
-    SessionSummary,
-    ListSessionsOptions,
-    AgentDetectionContext,
-} from './adapters/AgentAdapter.js';
+  AgentAdapter,
+  AgentType,
+  AgentInfo,
+  ProcessInfo,
+  ConversationMessage,
+  SessionSummary,
+  ListSessionsOptions,
+  AgentDetectionContext,
+} from "./adapters/AgentAdapter.js";
 
-export { TerminalFocusManager, TerminalType } from './terminal/TerminalFocusManager.js';
-export type { TerminalLocation } from './terminal/TerminalFocusManager.js';
-export { TtyWriter } from './terminal/TtyWriter.js';
+export { TerminalFocusManager, TerminalType } from "./terminal/TerminalFocusManager.js";
+export type { TerminalLocation } from "./terminal/TerminalFocusManager.js";
+export { TtyWriter } from "./terminal/TtyWriter.js";
 
-export type { ListAgentsOptions } from './AgentManager.js';
+export type { ListAgentsOptions } from "./AgentManager.js";
 
-export { AgentRegistry, RenameNotFoundError, RenameConflictError } from './utils/AgentRegistry.js';
-export type { AgentRegistryOptions, RegistryEntry } from './utils/AgentRegistry.js';
-export { TmuxManager } from './terminal/TmuxManager.js';
-export { AGENTS } from './utils/agents.js';
-export type { AgentConfig, StartableAgentType } from './utils/agents.js';
+export {
+  AgentRegistry,
+  RenameNotFoundError,
+  RenameConflictError,
+  AGENT_RUNTIME_PROVIDERS,
+  parseTmuxRuntimeRef,
+} from "./utils/AgentRegistry.js";
+export type {
+  AgentRegistryOptions,
+  RegistryEntry,
+  AgentRuntimeProvider,
+  TmuxRuntimeRef,
+} from "./utils/AgentRegistry.js";
+export { TmuxManager } from "./terminal/TmuxManager.js";
+export type { AgentRuntimeAvailability, InteractiveAgentRuntime } from "./runtime/types.js";
+export {
+  startAgent,
+  stopAgent,
+  focusAgent,
+  sendAgentPrompt,
+  TmuxUnavailableError,
+  AgentNameInUseError,
+  AgentPidPollTimeoutError,
+  AgentRuntimeUnavailableError,
+  AgentTerminalNotFoundError,
+  DEFAULT_PID_POLL_INTERVAL_MS,
+  DEFAULT_PID_POLL_TIMEOUT_MS,
+} from "./runtime/ManagedAgentRuntime.js";
+export type {
+  FocusAgentDeps,
+  StartAgentDeps,
+  StartAgentOptions,
+  StopAgentDeps,
+  StopAgentResult,
+  FocusAgentResult,
+  SendAgentPromptDeps,
+} from "./runtime/ManagedAgentRuntime.js";
+export { AGENTS } from "./utils/agents.js";
+export type { AgentConfig, StartableAgentType } from "./utils/agents.js";
 
-export type { AgentRequest } from './utils/agent-requests.js';
-export { getAgentRequestPath, readLatestAgentRequest, writeAgentRequest } from './utils/agent-requests.js';
+export type { AgentRequest } from "./utils/agent-requests.js";
+export {
+  getAgentRequestPath,
+  readLatestAgentRequest,
+  writeAgentRequest,
+} from "./utils/agent-requests.js";
 
 export {
-    AGENT_MODES,
-    DurableAgentError,
-    DurableAgentBusyError,
-    DurableAgentNotFoundError,
-    DurableAgentRepositoryError,
-    DurableAgentNameConflictError,
-    ClaudePrintError,
-    CodexPrintError,
-    PiPrintError,
-} from './durable/DurableAgent.js';
+  AGENT_MODES,
+  DurableAgentError,
+  DurableAgentBusyError,
+  DurableAgentNotFoundError,
+  DurableAgentRepositoryError,
+  DurableAgentNameConflictError,
+  ClaudePrintError,
+  CodexPrintError,
+  PiPrintError,
+} from "./durable/DurableAgent.js";
+export type {
+  DurableAgent,
+  DurableAgentBase,
+  ClaudeDurableAgent,
+  CodexDurableAgent,
+  PiDurableAgent,
+  DurableProvider,
+  CodexPrintErrorCode,
+  DurableAgentState,
+  DurableSessionHealth,
+  DurableRunStatus,
+  DurableActiveRun,
+  DurableLastResult,
+  PiPrintErrorCode,
+  ProcessIdentity,
+} from "./durable/DurableAgent.js";
+export { DurableAgentRepository } from "./durable/DurableAgentRepository.js";
+export type {
+  CreateDurableAgentInput,
+  DurableAgentRepositoryOptions,
+  ProcessInspector,
+  DurableRunCompletion,
+} from "./durable/DurableAgentRepository.js";
+export { ClaudePrintAgentService } from "./providers/claude/durable/ClaudePrintAgentService.js";
 export type {
-    DurableAgent,
-    DurableAgentBase,
-    ClaudeDurableAgent,
-    CodexDurableAgent,
-    PiDurableAgent,
-    DurableProvider,
-    CodexPrintErrorCode,
-    DurableAgentState,
-    DurableSessionHealth,
-    DurableRunStatus,
-    DurableActiveRun,
-    DurableLastResult,
-    PiPrintErrorCode,
-    ProcessIdentity,
-} from './durable/DurableAgent.js';
-export { DurableAgentRepository } from './durable/DurableAgentRepository.js';
+  ClaudePrintAgentServiceOptions,
+  ClaudePrintSendResult,
+} from "./providers/claude/durable/ClaudePrintAgentService.js";
+export { CodexCliProbe } from "./providers/codex/durable/CodexCliProbe.js";
+export type { CodexCliProbeOptions } from "./providers/codex/durable/CodexCliProbe.js";
+export { CodexPrintRunner } from "./providers/codex/durable/CodexPrintRunner.js";
 export type {
-    CreateDurableAgentInput,
-    DurableAgentRepositoryOptions,
-    ProcessInspector,
-    DurableRunCompletion,
-} from './durable/DurableAgentRepository.js';
-export { ClaudePrintAgentService } from './providers/claude/durable/ClaudePrintAgentService.js';
+  CodexPrintRunnerOptions,
+  CodexPrintRunRequest,
+  CodexPrintRunResult,
+} from "./providers/codex/durable/CodexPrintRunner.js";
+export { CodexPrintAgentService } from "./providers/codex/durable/CodexPrintAgentService.js";
 export type {
-    ClaudePrintAgentServiceOptions,
-    ClaudePrintSendResult,
-} from './providers/claude/durable/ClaudePrintAgentService.js';
-export { CodexCliProbe } from './providers/codex/durable/CodexCliProbe.js';
-export type { CodexCliProbeOptions } from './providers/codex/durable/CodexCliProbe.js';
-export { CodexPrintRunner } from './providers/codex/durable/CodexPrintRunner.js';
+  CodexPrintAgentServiceOptions,
+  CodexPrintSendResult,
+} from "./providers/codex/durable/CodexPrintAgentService.js";
+export { PiCliProbe } from "./providers/pi/durable/PiCliProbe.js";
+export type { PiCliProbeOptions } from "./providers/pi/durable/PiCliProbe.js";
+export { PiPrintRunner } from "./providers/pi/durable/PiPrintRunner.js";
 export type {
-    CodexPrintRunnerOptions,
-    CodexPrintRunRequest,
-    CodexPrintRunResult,
-} from './providers/codex/durable/CodexPrintRunner.js';
-export { CodexPrintAgentService } from './providers/codex/durable/CodexPrintAgentService.js';
+  PiPrintRunnerOptions,
+  PiPrintRunRequest,
+  PiPrintRunResult,
+} from "./providers/pi/durable/PiPrintRunner.js";
+export { PiPrintAgentService } from "./providers/pi/durable/PiPrintAgentService.js";
 export type {
-    CodexPrintAgentServiceOptions,
-    CodexPrintSendResult,
-} from './providers/codex/durable/CodexPrintAgentService.js';
-export { PiCliProbe } from './providers/pi/durable/PiCliProbe.js';
-export type { PiCliProbeOptions } from './providers/pi/durable/PiCliProbe.js';
-export { PiPrintRunner } from './providers/pi/durable/PiPrintRunner.js';
-export type { PiPrintRunnerOptions, PiPrintRunRequest, PiPrintRunResult } from './providers/pi/durable/PiPrintRunner.js';
-export { PiPrintAgentService } from './providers/pi/durable/PiPrintAgentService.js';
-export type { PiPrintAgentServiceOptions, PiPrintSendResult } from './providers/pi/durable/PiPrintAgentService.js';
+  PiPrintAgentServiceOptions,
+  PiPrintSendResult,
+} from "./providers/pi/durable/PiPrintAgentService.js";