import { Type } from "@earendil-works/pi-ai";
import type { ExtensionContext, ToolDefinition } from "@earendil-works/pi-coding-agent";
import type { AgentActivity, AgentAccounting, AgentAttemptSummary, AgentExecutionOptions, AgentExecutionResult, AgentExecutionRoot, AgentProgress, AgentToolCallProgress, AgentTransport, LiveSessionHandoff, PreparedAgentSession, WorkflowAgentSession, WorkflowAgentSessionReference } from "../../src/index.js";
import type { Static } from "typebox";
import type { SubagentWorktreeAdapter } from "./worktree.js";
export declare const SUBAGENTS_TOOL_NAMES: readonly ["subagents_run", "subagents_inspect", "subagents_steer", "subagents_stop", "subagents_retry"];
export declare const SUBAGENT_ATTEMPT_DETAILS_LIMIT = 1;
export declare const SUBAGENT_MAX_RETRIES = 255;
export declare const SUBAGENT_SYSTEM_PROMPT_LIMIT: number;
export declare const SUBAGENTS_RUN_PARAMETERS: Type.TObject<{
    prompt: Type.TString;
    mode: Type.TOptional<Type.TUnion<[Type.TLiteral<"background">, Type.TLiteral<"foreground">]>>;
    label: Type.TOptional<Type.TString>;
    model: Type.TOptional<Type.TString>;
    tools: Type.TOptional<Type.TArray<Type.TString>>;
    skills: Type.TOptional<Type.TArray<Type.TString>>;
    extensions: Type.TOptional<Type.TArray<Type.TString>>;
    contextFiles: Type.TOptional<Type.TArray<Type.TString>>;
    role: Type.TOptional<Type.TString>;
    worktree: Type.TOptional<Type.TString>;
    outputSchema: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
    retries: Type.TOptional<Type.TInteger>;
    timeoutMs: Type.TOptional<Type.TUnion<[Type.TInteger, Type.TNull]>>;
}>;
export declare const SUBAGENTS_INSPECT_PARAMETERS: Type.TObject<{
    id: Type.TOptional<Type.TString>;
}>;
export declare const SUBAGENTS_ID_PARAMETERS: Type.TObject<{
    id: Type.TString;
}>;
export declare const SUBAGENTS_STEER_PARAMETERS: Type.TObject<{
    id: Type.TString;
    message: Type.TString;
}>;
export declare const SUBAGENTS_STOP_PARAMETERS: Type.TObject<{
    id: Type.TString;
}>;
export declare const SUBAGENTS_RETRY_PARAMETERS: Type.TObject<{
    id: Type.TString;
}>;
export declare const SUBAGENTS_TOOL_SCHEMAS: {
    readonly subagents_run: Type.TObject<{
        prompt: Type.TString;
        mode: Type.TOptional<Type.TUnion<[Type.TLiteral<"background">, Type.TLiteral<"foreground">]>>;
        label: Type.TOptional<Type.TString>;
        model: Type.TOptional<Type.TString>;
        tools: Type.TOptional<Type.TArray<Type.TString>>;
        skills: Type.TOptional<Type.TArray<Type.TString>>;
        extensions: Type.TOptional<Type.TArray<Type.TString>>;
        contextFiles: Type.TOptional<Type.TArray<Type.TString>>;
        role: Type.TOptional<Type.TString>;
        worktree: Type.TOptional<Type.TString>;
        outputSchema: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
        retries: Type.TOptional<Type.TInteger>;
        timeoutMs: Type.TOptional<Type.TUnion<[Type.TInteger, Type.TNull]>>;
    }>;
    readonly subagents_inspect: Type.TObject<{
        id: Type.TOptional<Type.TString>;
    }>;
    readonly subagents_steer: Type.TObject<{
        id: Type.TString;
        message: Type.TString;
    }>;
    readonly subagents_stop: Type.TObject<{
        id: Type.TString;
    }>;
    readonly subagents_retry: Type.TObject<{
        id: Type.TString;
    }>;
};
export type SubagentRunRequest = Static<typeof SUBAGENTS_RUN_PARAMETERS>;
export declare function normalizeSubagentRunRequest(value: unknown): SubagentRunRequest;
export type SubagentInspectRequest = Static<typeof SUBAGENTS_INSPECT_PARAMETERS>;
export type SubagentIdRequest = Static<typeof SUBAGENTS_ID_PARAMETERS>;
export type SubagentSteerRequest = Static<typeof SUBAGENTS_STEER_PARAMETERS>;
export type SubagentProgress = {
    readonly accounting: AgentAccounting;
    readonly toolCalls: readonly AgentToolCallProgress[];
    readonly state?: Omit<NonNullable<AgentProgress["state"]>, "systemPrompt">;
    readonly activity?: AgentActivity;
    readonly lastEventAt?: number;
};
export interface SubagentStatus {
    readonly id: string;
    readonly sessionId?: string;
    readonly state: "running" | "completed" | "failed" | "stopped";
    readonly startedAt?: number;
    readonly finishedAt?: number;
    readonly worktree?: {
        readonly path: string;
        readonly branch: string;
    };
    readonly error?: {
        readonly code: string;
        readonly message: string;
    };
    readonly progress?: SubagentProgress;
    readonly attempts?: number;
    readonly attemptDetails?: readonly AgentAttemptSummary[];
}
export interface SubagentNotification {
    readonly id: string;
    readonly label?: string;
    readonly role?: string;
    readonly state: "completed" | "failed";
    readonly error?: {
        readonly code: string;
        readonly message: string;
    };
}
export interface SubagentManagerContext {
    readonly toolCallId: string;
    readonly signal: AbortSignal | undefined;
    readonly onUpdate: ((value: unknown) => void) | undefined;
    readonly extensionContext: ExtensionContext;
    readonly waitForForeground?: boolean;
    readonly includeAttemptMetadata?: boolean;
}
export interface SubagentAttemptActionData {
    readonly attempt: AgentAttemptSummary;
    readonly session?: WorkflowAgentSessionReference;
    readonly liveSession?: WorkflowAgentSession;
    readonly prepared?: Readonly<PreparedAgentSession>;
    readonly handoff?: LiveSessionHandoff;
    readonly signal: AbortSignal;
}
export interface SubagentOwnerMarker {
    readonly pid: number;
    readonly processStart: number;
    readonly sessionId: string;
    readonly token: string;
    readonly acquiredAt: number;
}
export interface SubagentLiveness {
    readonly pid?: number;
    readonly processStart?: number;
    readonly sessionId?: string;
    readonly token?: string;
    readonly isLive?: (owner: Readonly<SubagentOwnerMarker>) => boolean | Promise<boolean>;
}
export interface SubagentExecutor {
    execute(task: string, options: AgentExecutionOptions, signal?: AbortSignal, setSteer?: (handler: (message: string) => void | Promise<void>) => void): Promise<AgentExecutionResult>;
}
export interface SubagentManagerDependencies {
    readonly getActiveTools?: () => readonly string[];
    readonly agentDir?: string;
    readonly storageDir?: string;
    readonly transport?: AgentTransport;
    readonly createExecutor?: (root: AgentExecutionRoot, transport: AgentTransport) => SubagentExecutor;
    readonly worktreeAdapter?: SubagentWorktreeAdapter;
    readonly liveness?: SubagentLiveness;
    readonly notify?: (notification: Readonly<SubagentNotification>) => void | Promise<void>;
    readonly onStatus?: (status: Readonly<SubagentStatus>, request: Readonly<SubagentRunRequest>) => void;
    readonly onResourceWarning?: (message: string) => void;
}
export interface SubagentManager {
    run(request: Readonly<SubagentRunRequest>, context: Readonly<SubagentManagerContext>): Promise<unknown>;
    inspect(request: Readonly<SubagentInspectRequest>, context: Readonly<SubagentManagerContext>): Promise<unknown>;
    steer(request: Readonly<SubagentSteerRequest>, context: Readonly<SubagentManagerContext>): Promise<unknown>;
    stop(request: Readonly<SubagentIdRequest>, context: Readonly<SubagentManagerContext>): Promise<unknown>;
    retry(request: Readonly<SubagentIdRequest>, context: Readonly<SubagentManagerContext>): Promise<unknown>;
    getAttemptActionData?(id: string): Readonly<SubagentAttemptActionData> | undefined;
    dispose?(): Promise<void>;
}
export interface SubagentsExtensionOptions {
    readonly manager?: SubagentManager;
    readonly clipboard?: (value: string) => Promise<void>;
    readonly managerDependencies?: SubagentManagerDependencies;
}
export interface SubagentsExtension {
    readonly manager: SubagentManager;
    readonly tools: readonly ToolDefinition[];
}