Skip to content

The open-source app everyone uses to manage agents at work

1.8 KB
Raw Blame
import { AGENT_ADAPTER_TYPES } from "@paperclipai/shared";
import { isAdapterExecutionPhase } from "@paperclipai/adapter-utils/execution-phase";
import { MAX_EXECUTION_PHASE_ELAPSED_MS } from "./adapter-execution-phase.js";

export interface AdapterStopContext {
  runId?: string;
  adapterType?: string;
  runtimeMode?: string;
  abortRequested?: boolean;
  phase?: string;
  phaseElapsedMs?: number;
}

/** Diagnostic identity only. This error never acknowledges termination. */
export class AdapterStopTimeoutError extends Error {
  readonly diagnostics: Readonly<Record<string, string | number | boolean | null>>;

  constructor(timeoutMs: number, context?: AdapterStopContext) {
    super("Execution is still stopping; termination has not been verified.");
    // Keep the existing Error name and timer stack for default error grouping.
    Error.captureStackTrace?.(this, AdapterStopTimeoutError);
    this.diagnostics = Object.freeze({
      timeoutMs: Number.isSafeInteger(timeoutMs) && timeoutMs >= 0 ? timeoutMs : null,
      runId: typeof context?.runId === "string" && /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i.test(context.runId)
        ? context.runId : null,
      adapterType: AGENT_ADAPTER_TYPES.some((type) => type === context?.adapterType) ? context!.adapterType! : "unknown",
      runtimeMode: context?.runtimeMode === "native" || context?.runtimeMode === "legacy" ? context.runtimeMode : "unknown",
      abortRequested: typeof context?.abortRequested === "boolean" ? context.abortRequested : null,
      phase: isAdapterExecutionPhase(context?.phase) ? context.phase : "unknown",
      phaseElapsedMs: isAdapterExecutionPhase(context?.phase) && Number.isSafeInteger(context?.phaseElapsedMs)
        && context!.phaseElapsedMs! >= 0 && context!.phaseElapsedMs! <= MAX_EXECUTION_PHASE_ELAPSED_MS
        ? context!.phaseElapsedMs! : null,
    });
  }
}