import type { AdapterIdentity } from "../adapter-identity.mjs";
import type { CompletionView } from "./completion-channel.mjs";

export interface RuntimeManifestIdentity {
  harness: "codex" | "pi";
  adapter: string;
  adapter_contract: "dirtyloops-harness/1";
  adapter_identity: AdapterIdentity;
  coordinator_id: string;
  capabilities: string[];
  optional_backends?: unknown[];
}

export interface ActivationResult {
  status: "ready" | "probe-required" | "blocked";
  boundary?: string;
  error?: string;
  activation?: Record<string, unknown>;
  launch?: Record<string, unknown>;
  idempotent?: boolean;
}

export const ACTIVATION_PATH: "runtime/activation.json";
export function requireCoordinatorId(value: unknown): string;
export function createActivationRequirement(options: {
  operation: string;
  generation: { generation_id: string; metadata: { target: "codex" | "pi"; adapter_identity: AdapterIdentity } };
  sourceCoordinatorId: string;
}): Record<string, unknown>;
export function runtimeStatusForActivation(value: string | Record<string, unknown>): "activation-ready" | "activation-required" | "activation-failed" | "activation-unsupported";
export function activationIsCurrent(docRoot: string, generation: { generation_id: string; metadata: { target: string } }): boolean;
export function writeActivationRequirement(context: unknown, options: unknown): Record<string, unknown>;
export function beginActivation(options: {
  docRoot: string;
  manifest: RuntimeManifestIdentity;
  nonce?: () => string;
}): ActivationResult;
export function recordActivationFailure(options: {
  docRoot: string;
  boundary: string;
  message: string;
  coordinatorId: string;
}): ActivationResult;
export function completeActivation(options: {
  docRoot: string;
  coordinatorId: string;
  completion: CompletionView & { doc_root?: string; activation_probe?: boolean };
  acknowledgement: { ok: boolean; delivery?: CompletionView };
}): ActivationResult;
export function isActivationProbeDescription(description?: string): boolean;
export function validateRuntimeGeneration(docRoot: string, generation: unknown): { ok: true } | { ok: false; error: string };
export function authorizeActivationLaunch(options: {
  docRoot: string;
  coordinatorId: string;
  params: { kind?: string; backend?: string; mutation?: string; description?: string; mission?: string };
}): { ok: true; probe: boolean; alreadyReady?: boolean } | { ok: false; error: string };
export function authorizeActivationAcknowledgement(options: {
  docRoot: string;
  coordinatorId: string;
  completion: (CompletionView & { doc_root?: string; activation_probe?: boolean }) | undefined;
}): { ok: true; probe: boolean } | { ok: false; error: string };
export function validateActivationLaunch(docRoot: string, params: {
  kind?: string;
  backend?: string;
  mutation?: string;
  description?: string;
  mission?: string;
}): { ok: true } | { ok: false; error: string };