import type { ExtensionEvent } from "@earendil-works/pi-coding-agent";
import type { FabricAgentRunner, FabricAgentTransport } from "../config.js";
import type { FabricThinking } from "../thinking.js";
import type { FabricLogLine, AgentRunRecord, AgentUsage } from "../agents/types.js";
import type { FabricCapabilityRequirement } from "../components/types.js";
import type { FabricParticipantResidency } from "../topology/types.js";
export type FabricActorPiHostEvent = Exclude<ExtensionEvent["type"], "project_trust">;
export declare const FABRIC_ACTOR_PI_HOST_EVENTS: readonly ["resources_discover", "session_start", "session_info_changed", "session_before_switch", "session_before_fork", "session_before_compact", "session_compact", "session_compact_failed", "session_shutdown", "session_before_tree", "session_tree", "input", "before_agent_start", "agent_start", "agent_end", "agent_settled", "turn_start", "turn_end", "message_start", "message_update", "message_end", "context", "before_provider_headers", "before_provider_request", "after_provider_response", "tool_execution_start", "tool_call", "tool_execution_update", "tool_result", "tool_execution_end", "model_select", "thinking_level_select", "user_bash"];
export declare const FABRIC_ACTOR_HOST_EVENTS: readonly ["resources_discover", "session_start", "session_info_changed", "session_before_switch", "session_before_fork", "session_before_compact", "session_compact", "session_compact_failed", "session_shutdown", "session_before_tree", "session_tree", "input", "before_agent_start", "agent_start", "agent_end", "agent_settled", "turn_start", "turn_end", "message_start", "message_update", "message_end", "context", "before_provider_headers", "before_provider_request", "after_provider_response", "tool_execution_start", "tool_call", "tool_execution_update", "tool_result", "tool_execution_end", "model_select", "thinking_level_select", "user_bash", "tool_error"];
export type FabricActorHostEvent = (typeof FABRIC_ACTOR_HOST_EVENTS)[number];
export declare const isFabricActorHostEvent: (value: unknown) => value is FabricActorHostEvent;
export type FabricActorDelivery = "mailbox" | "steer" | "followUp" | "nextTurn";
export type FabricActorResponseMode = "text" | "directive";
export type FabricActorStatus = "idle" | "queued" | "running" | "stopped";
export type FabricActorBindingScope = "session" | "project";
export interface FabricActorRunBinding {
    model?: string;
    thinking?: FabricThinking;
}
interface FabricActorBindingView extends FabricActorRunBinding {
    scope: "session";
    sessionId: string;
    updatedAt?: number;
}
interface FabricActorProjectDefaults extends FabricActorRunBinding {
    scope: "project";
}
export interface FabricActorValidWhileSource {
    version: 1;
    source: string;
}
export interface FabricActorValidityDecision {
    valid: boolean;
    reason?: string;
}
export type FabricActorActivation = {
    kind: "hostEvent";
    id: string;
    source: string;
    sequence: number;
    createdAt: number;
    event: FabricActorHostEvent;
    mainRevision: number;
    taskRevision: number;
    signal?: unknown;
} | {
    kind: "direct";
    id: string;
    source: string;
    sequence: number;
    createdAt: number;
} | {
    kind: "mesh";
    id: string;
    source: string;
    sequence: number;
    createdAt: number;
    topic: string;
};
export interface FabricActorValidityFacts {
    activation: FabricActorActivation;
    current: {
        latestActivationSequence: number;
        mainRevision: number;
        taskRevision: number;
        idle: boolean;
        now: number;
    };
}
export interface FabricActorRequest {
    name: string;
    instructions: string;
    /** Asynchronous observations of session-bound Pi events plus synthetic tool_error. */
    events?: FabricActorHostEvent[];
    topics?: string[];
    /** Defaults to mailbox. steer/followUp require an explicit triggerTurn choice. */
    delivery?: FabricActorDelivery;
    responseMode?: FabricActorResponseMode;
    /** Required for steer/followUp; must be false or omitted for mailbox/nextTurn. */
    triggerTurn?: boolean;
    coalesce?: boolean;
    /** session actors stop with their Pi host; durable actors transfer to a resident host. */
    residency?: FabricParticipantResidency;
    runner?: FabricAgentRunner;
    model?: string;
    thinking?: FabricThinking;
    tools?: string[];
    transport?: FabricAgentTransport;
    timeoutMs?: number;
    /**
     * Fabric capability for the actor. Defaults to true (today's behavior: a Pi
     * actor is recursively Fabric-equipped with the host-required fabric_exec
     * tool). Set false to disable Fabric for a Pi actor: the activation runs with
     * extensions:false and recursive:false so fabric_exec is not injected and the
     * actor cannot call agents.* or mesh.*; the host still manages its mailbox
     * and delivery (same model as a Claude actor). This does not restrict the
     * actor's ordinary tool allowlist. Fixed at creation.
     */
    extensions?: boolean;
    /** Exact Fabric actions committed before every actor run. Optional entries do not block a run. */
    requires?: readonly (string | FabricCapabilityRequirement)[];
    /** Serialized guest predicate evaluated before work and before delivery. */
    validWhile?: FabricActorValidWhileSource;
}
export interface FabricActorInfo {
    id: string;
    name: string;
    rootId?: string;
    status: FabricActorStatus;
    runner: FabricAgentRunner;
    events: FabricActorHostEvent[];
    topics: string[];
    delivery: FabricActorDelivery;
    responseMode: FabricActorResponseMode;
    triggerTurn: boolean;
    coalesce: boolean;
    residency?: FabricParticipantResidency;
    /** Effective value for this caller after session bindings overlay project defaults. */
    model?: string;
    /** Effective value for this caller after session bindings overlay project defaults. */
    thinking?: FabricThinking;
    binding?: FabricActorBindingView;
    projectDefaults?: FabricActorProjectDefaults;
    tools?: string[];
    timeoutMs?: number;
    extensions?: boolean;
    requirements?: FabricCapabilityRequirement[];
    capabilityDigest?: string;
    missingCapabilities?: string[];
    validWhile?: FabricActorValidWhileSource;
    queued: number;
    messages: number;
    createdAt: number;
    updatedAt: number;
    lastRunId?: string;
    lastError?: string;
    sessionFile?: string;
    logDir?: string;
}
export interface FabricActorLog {
    actorId: string;
    actorName: string;
    sessionFile: string;
    logDir: string;
    session: FabricLogLine[];
    sessionHasMore: boolean;
    sessionBefore?: number;
    run?: {
        runId: string;
        eventsFile: string;
        status?: AgentRunRecord;
        events: FabricLogLine[];
        hasMore: boolean;
        before?: number;
    };
    retainedRuns: string[];
}
export interface FabricActorMessage {
    id: string;
    actorId: string;
    actorName: string;
    direction: "in" | "out";
    source: string;
    createdAt: number;
    text?: string;
    data?: unknown;
    action?: "silent" | "message" | "stop";
    runId?: string;
    usage?: AgentUsage;
    error?: string;
    stale?: boolean;
    reason?: string;
}
export interface FabricActorDirective {
    action: "silent" | "message" | "stop";
    message?: string;
    data?: unknown;
}
export interface FabricActorDeliveryRequest {
    actor: FabricActorInfo;
    message: FabricActorMessage;
    delivery: Exclude<FabricActorDelivery, "mailbox">;
    triggerTurn: boolean;
}
/**
 * A project-independent actor template stored in the global registry
 * (the user's agent dir, not a project mesh). It carries only the actor
 * definition (the same fields as FabricActorRequest) plus identity and
 * timestamps — never any history (messages, session transcript, or run logs).
 * Global actors are not live: they are stamped into a project via import,
 * which creates a fresh live actor with no inherited history.
 */
export interface GlobalActorDefinition extends FabricActorRequest {
    id: string;
    createdAt: number;
    updatedAt: number;
    events: FabricActorHostEvent[];
    topics: string[];
    delivery: FabricActorDelivery;
    responseMode: FabricActorResponseMode;
    triggerTurn: boolean;
    coalesce: boolean;
    residency?: FabricParticipantResidency;
    runner: FabricAgentRunner;
}
export {};
//# sourceMappingURL=types.d.ts.map