import { log } from "../logger.js";

/** Structured fields emitted whenever embedded run failover chooses an action. */

export type FailoverDecisionLoggerInput = {

type FailoverDecisionLoggerInput = {

stage: "prompt" | "assistant";

decision: "rotate_profile" | "fallback_model" | "surface_error";

runId?: string;

};

/** Stable context captured before a concrete failover decision is known. */

export type FailoverDecisionLoggerBase = Omit<FailoverDecisionLoggerInput, "decision" | "status">;

type FailoverDecisionLoggerBase = Omit<FailoverDecisionLoggerInput, "decision" | "status">;

/**

* Derives timeout failure reasons for logs that were built from timeout state

status?: number;

};

export type ExecutionTrace = {

type ExecutionTrace = {

winnerProvider?: string;

winnerModel?: string;

attempts?: TraceAttempt[];

fallbackUsed?: boolean;

runner?: "embedded" | "cli";

};

export type RequestShapingTrace = {

type RequestShapingTrace = {

authMode?: string;

thinking?: string;

reasoning?: string;

blockStreaming?: string;

};

export type PromptSegmentTrace = {

type PromptSegmentTrace = {

key: string;

chars: number;

};

totalToolTimeMs?: number;

};

export type CompletionTrace = {

type CompletionTrace = {

finishReason?: string;

stopReason?: string;

refusal?: boolean;

};

export type ContextManagementTrace = {

type ContextManagementTrace = {

sessionCompactions?: number;

lastTurnCompactions?: number;

preflightCompactionApplied?: boolean;

}

/** Normalized before-finalize hook decision consumed by harness loops. */

export type AgentHarnessBeforeAgentFinalizeOutcome =

type AgentHarnessBeforeAgentFinalizeOutcome =

| { action: "continue" }

| { action: "revise"; reason: string }

| { action: "finalize"; reason?: string };

const log = createSubsystemLogger("agents/harness");

/** Prompt/developer-instruction pair after harness prompt-build hooks run. */

export type AgentHarnessPromptBuildResult = {

type AgentHarnessPromptBuildResult = {

prompt: string;

developerInstructions: string;

};

sourceVisibleReplies?: "automatic" | "message_tool";

};

export type AgentHarnessRunCapability = {

type AgentHarnessRunCapability = {

id: string;

label: string;

pluginId?: string;

runAttempt(params: AgentHarnessAttemptParams): Promise<AgentHarnessAttemptResult>;

};

export type AgentHarnessSideQuestionCapability = {

type AgentHarnessSideQuestionCapability = {

runSideQuestion?(params: AgentHarnessSideQuestionParams): Promise<AgentHarnessSideQuestionResult>;

};

export type AgentHarnessClassificationCapability = {

type AgentHarnessClassificationCapability = {

classify?(

result: AgentHarnessAttemptResult,

ctx: AgentHarnessAttemptParams,

): AgentHarnessResultClassification | undefined;

};

export type AgentHarnessCompactionCapability = {

type AgentHarnessCompactionCapability = {

compact?(params: AgentHarnessCompactParams): Promise<AgentHarnessCompactResult | undefined>;

};

export type AgentHarnessSessionLifecycleCapability = {

type AgentHarnessSessionLifecycleCapability = {

reset?(params: AgentHarnessResetParams): Promise<void> | void;

dispose?(): Promise<void> | void;

};