The open-source app everyone uses to manage agents at work
TypeScript acpxagent-orchestrationagent-skillsagentic-aiai-agentsai-engineeringai-governanceai-toolsautonomous-agentsclaudeclaude-codeclaude-skillscodexhermesllmmcpmulti-agentopenclawproject-managementworkflow-automation
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,
});
}
}