import type { Model, ModelThinkingLevel } from "@earendil-works/pi-ai";
import type {
  AgentRunProviderAuthority,
  AgentSessionInputs,
} from "@mrclrchtr/supi-agent-runtime/api";

/** Maximum effective Profile IDs exposed to a session's model-facing catalogue. */
export const MAX_PROFILE_COUNT = 32;
/** Maximum Profile ID length. */
export const MAX_PROFILE_ID_LENGTH = 64;
/** Maximum profile description length. */
export const MAX_PROFILE_DESCRIPTION_LENGTH = 200;
/** Maximum custom SYSTEM.md length. */
export const MAX_CUSTOM_SYSTEM_PROMPT_CHARS = 32_000;
/** Maximum canonical profile model reference length. */
export const MAX_PROFILE_MODEL_REFERENCE_CHARS = 256;
/** Maximum diagnostic message length. */
export const MAX_PROFILE_DIAGNOSTIC_CHARS = 240;

/** Profile source precedence, from weakest to strongest. */
export type ProfileSource = "package" | "global" | "project";

/** Explicit instruction-file scopes selectable by a profile. */
export type AgentInstructionScope = "global" | "project";

/** Package prompt selectors supported by the profile manifest. */
export type PackagePromptId = "supi:explore" | "supi:general";

/** Complete base-prompt selector from profile.json. */
export type AgentSystemPrompt = "native" | "custom" | PackagePromptId;

/** Fixed child capability names accepted by profile.json. */
export type AgentCapabilityId =
  | "read"
  | "bash"
  | "edit"
  | "write"
  | "code_resolve"
  | "code_inspect"
  | "code_orientation"
  | "code_graph"
  | "code_find"
  | "code_health";

/** Values accepted by PI's model thinking policy. */
export type AgentThinkingLevel = ModelThinkingLevel;

/** Closed profile.json manifest after field-level source resolution. */
export interface AgentProfileManifest {
  /** Task-selection description for callers and the UI, non-empty and capped at 200 characters. */
  readonly description: string;
  /** Fixed child capability IDs; an empty list is valid. */
  readonly tools: readonly AgentCapabilityId[];
  /** One complete native, package-owned, or custom system-prompt source. */
  readonly systemPrompt: AgentSystemPrompt;
  /** Explicit global/project AGENTS.md or CLAUDE.md scopes; no implicit scopes are added. */
  readonly instructionScopes: readonly AgentInstructionScope[];
  /** Optional canonical provider/model-id; omitted values inherit the containing model. */
  readonly model?: string;
  /** Optional PI thinking level; omitted values inherit the containing session level. */
  readonly thinking?: AgentThinkingLevel;
  /** Optional host timeout in minutes, from 1 through 240. */
  readonly timeoutMinutes?: number;
}

/** Every field accepted in a profile.json manifest. */
export const PROFILE_MANIFEST_FIELDS: readonly (keyof AgentProfileManifest)[] = [
  "description",
  "tools",
  "systemPrompt",
  "instructionScopes",
  "model",
  "thinking",
  "timeoutMinutes",
];

/** Partial profile.json manifest stored by one profile source. */
export type PartialAgentProfileManifest = Partial<AgentProfileManifest>;

/** One source entry retained by the Profile Catalogue. */
export interface ProfileSourceEntry {
  readonly id: string;
  readonly source: ProfileSource;
  /** Absolute source directory; human diagnostics may use it, model-facing guidance must not. */
  readonly directory: string;
  /** A partial manifest. Invalid sources omit this field and carry a diagnostic. */
  readonly manifest?: PartialAgentProfileManifest;
  /** Custom prompt content belonging to this source's systemPrompt field. */
  readonly customSystemPrompt?: string;
  readonly diagnostic?: ProfileDiagnostic;
}

/** One Profile ID and all of its source entries. */
export interface ProfileCatalogueEntry {
  readonly id: string;
  /** Task-selection description resolved from the available source fields. */
  readonly description: string;
  /** Source entries in package → global → project order. */
  readonly sources: readonly ProfileSourceEntry[];
  readonly diagnostics: readonly ProfileDiagnostic[];
}

/** Source directories used for discovery and settings persistence. */
export interface ProfileSourceDirectories {
  readonly package: string;
  readonly global: string;
  /** Trusted project destination, including a path that does not exist yet. */
  readonly project?: string;
}

/** Source provenance for each field in one resolved profile manifest. */
export type AgentProfileFieldSources = Readonly<
  Partial<Record<keyof AgentProfileManifest, ProfileSource>>
>;

/** One valid effective Agent Profile after field-level resolution. */
export interface AgentProfile {
  readonly id: string;
  /** Strongest available source contributing to the effective profile. */
  readonly source: ProfileSource;
  /** Absolute source directory for the strongest available source. */
  readonly directory: string;
  readonly manifest: AgentProfileManifest;
  /** Human-facing source provenance for resolved manifest fields. */
  readonly fieldSources?: AgentProfileFieldSources;
  readonly customSystemPrompt?: string;
}

/** Bounded configuration diagnostic for one unavailable profile. */
export interface ProfileDiagnostic {
  readonly profileId: string;
  readonly source: ProfileSource;
  readonly code:
    | "invalid-profile-id"
    | "invalid-manifest"
    | "missing-profile-manifest"
    | "invalid-prompt"
    | "incomplete-manifest"
    | "model-unavailable"
    | "model-unauthenticated"
    | "model-out-of-scope"
    | "catalogue-overflow";
  readonly message: string;
  /** Absolute source directory for human-only diagnostics and settings UI. */
  readonly directory?: string;
}

/** Immutable Profile Catalogue snapshot retained until the next session start/reload. */
export interface ProfileCatalogue {
  /** Discovered Profile IDs with all package/global/project source entries. */
  readonly profiles: readonly ProfileCatalogueEntry[];
  /** Bounded invalid/overflow diagnostics for the visible catalogue snapshot. */
  readonly diagnostics: readonly ProfileDiagnostic[];
  /** Sorted effective IDs exposed to execution, capped at MAX_PROFILE_COUNT. */
  readonly profileIds: readonly string[];
  /** Number of additional effective IDs omitted by the catalogue cap. */
  readonly omittedProfileCount: number;
  /** Source roots used by discovery and field-level settings persistence. */
  readonly sourceDirectories: ProfileSourceDirectories;
}

/** Parent model context needed to resolve a profile's effective execution policy. */
export interface AgentModelContext {
  readonly providerAuthority: AgentRunProviderAuthority;
  // biome-ignore lint/suspicious/noExplicitAny: Model<any> is PI's canonical type
  readonly currentModel: Model<any> | undefined;
  readonly currentThinkingLevel: AgentThinkingLevel | undefined;
  readonly scopedModels: readonly {
    // biome-ignore lint/suspicious/noExplicitAny: Model<any> is PI's canonical type
    readonly model: Model<any>;
    readonly thinkingLevel?: AgentThinkingLevel;
  }[];
  readonly modelRegistry: {
    // biome-ignore lint/suspicious/noExplicitAny: Model<any> is PI's canonical type
    find(provider: string, modelId: string): Model<any> | undefined;
    // biome-ignore lint/suspicious/noExplicitAny: Model<any> is PI's canonical type
    hasConfiguredAuth(model: Model<any>): boolean;
  };
}

/** Effective model and runtime inputs for one selected Agent Profile. */
export interface ResolvedAgentProfile {
  readonly profile: AgentProfile;
  // biome-ignore lint/suspicious/noExplicitAny: Model<any> is PI's canonical type
  readonly model: Model<any>;
  readonly thinkingLevel: AgentThinkingLevel;
  readonly timeoutMs?: number;
  readonly inputs: AgentSessionInputs;
}

/** Options for compiling a profile into in-memory Agent Session Inputs. */
export interface AgentSessionInputOptions {
  readonly cwd: string;
  readonly agentDir: string;
  readonly projectTrusted: boolean;
  readonly providerAuthority: AgentRunProviderAuthority;
  // biome-ignore lint/suspicious/noExplicitAny: Model<any> is PI's canonical type
  readonly model: Model<any>;
  readonly thinkingLevel: AgentThinkingLevel;
  readonly profile: AgentProfile;
}