/**
 * module: activity-registry —— 本模块要外界提供的能力(编码规范 §10.1 / §5.3)。
 */
import type { ActivityManifest } from '@contracts';
import type { AssetKind, AssetVersion, IncrementState, PackageVersion, ReplayVerdict } from './internal/domain/versioning.ts';

export type Clock = { now(): Date };
export type IdGenerator = { next(): string };

export type RegistryStore = {
  /** 返回是否新增了这一包版本(同版重复安装返回 false) */
  savePackage(manifest: ActivityManifest, artifact: string): Promise<boolean>;
  listPackages(activityId?: string): Promise<PackageVersion[]>;
  manifest(activityId: string, packageVersion?: string): Promise<ActivityManifest | undefined>;
  artifact(activityId: string, packageVersion: string): Promise<string | undefined>;
  setEnabled(activityId: string, enabled: boolean): Promise<void>;
  setState(activityId: string, version: string, state: PackageVersion['state']): Promise<void>;
  enabledOf(activityId: string): Promise<boolean>;

  listAssets(activityId: string): Promise<AssetVersion[]>;
  saveAsset(asset: AssetVersion, body: string): Promise<void>;
  setAssetEffective(activityId: string, kind: AssetKind, version: number): Promise<void>;

  saveIncrement(input: {
    id: string;
    activityId: string;
    kind: AssetKind;
    diff: string;
    evidenceEntryIds: readonly string[];
    state: IncrementState;
    createdAt: Date;
  }): Promise<void>;
  getIncrement(id: string): Promise<
    | {
        id: string;
        activityId: string;
        kind: AssetKind;
        diff: string;
        state: IncrementState;
      }
    | undefined
  >;
  setIncrementState(id: string, state: IncrementState, report?: ReplayVerdict, by?: string): Promise<void>;
};

/** 工具契约核对 —— app 注入 `toolbox`(L2):装不齐不上架 */
export type ToolContractProbe = {
  assertContractsAvailable(names: readonly string[]): Promise<{ ok: boolean; missing: string[] }>;
};

/** 模型名核对 —— app 注入 `llm`(L1) */
export type ModelBindingProbe = {
  assertNamesBound(names: readonly string[]): Promise<{ ok: boolean; missing: string[] }>;
};

/** 台账声明合并 —— app 注入 `ledger`(L1):安装时依声明自生长 */
export type LedgerDeclarationApplier = {
  applyDeclarations(
    declarations: ActivityManifest['declarations']['ledger'],
  ): Promise<Array<{ applied: boolean; conflicts: ReadonlyArray<{ field: string; message: string }> }>>;
};

/** 模版净化门 —— app 注入 `interaction`(L3) */
export type TemplateGuard = { isSafe(html: string): boolean };