import { SupplyChainAuditActor } from "./audit-emitter.js";
import { SkillInstallationStatus, SkillTrustLevel, SupplyChainPolicy } from "./types.js";
import { SkillTrustRoot } from "./signature.js";

//#region src/supply-chain/installer.d.ts

/**
 * Options accepted by {@link installSkillFromNpm}.
 *
 * @stable
 */
interface InstallSkillFromNpmOptions {
  readonly packageName: string;
  readonly version?: string;
  readonly trustLevel?: SkillTrustLevel;
  readonly policy?: SupplyChainPolicy;
  /**
   * Operator trust root threaded into signature
   * verification: a valid signature from a key not in the root is
   * rejected. See {@link SkillTrustRoot}.
   */
  readonly trustRoot?: SkillTrustRoot;
  /** Where to install the package. Defaults to a fresh temp dir. */
  readonly cwd?: string;
  /** Forwarded to the package-manager runner. */
  readonly env?: NodeJS.ProcessEnv;
  /** Cancellation. */
  readonly signal?: AbortSignal;
  /** Skip the actual install; runs the policy + audit pipeline only. */
  readonly dryRun?: boolean;
  /** Optional pre-fetched SKILL.md content for offline verification. */
  readonly skillMd?: string;
  /** Override actor recorded in the audit event. */
  readonly actor?: SupplyChainAuditActor;
}
/**
 * Install a skill from the npm registry.
 *
 * @stable
 */
declare function installSkillFromNpm(options: InstallSkillFromNpmOptions): Promise<SkillInstallationStatus>;
/**
 * Options accepted by {@link installSkillFromGit}.
 *
 * @stable
 */
interface InstallSkillFromGitOptions {
  /** Operator trust root. See {@link SkillTrustRoot}. */
  readonly trustRoot?: SkillTrustRoot;
  readonly repoUrl: string;
  readonly ref?: string;
  readonly trustLevel?: SkillTrustLevel;
  readonly policy?: SupplyChainPolicy;
  /** Cancellation. */
  readonly signal?: AbortSignal;
  /** Skip the clone; runs the policy + audit pipeline only. */
  readonly dryRun?: boolean;
  /** Optional pre-fetched SKILL.md content for offline verification. */
  readonly skillMd?: string;
  readonly actor?: SupplyChainAuditActor;
}
/**
 * Install a skill from a git repository (shallow clone). The
 * resulting clone lives in the OS temp directory; consumers are
 * responsible for cleanup.
 *
 * @stable
 */
declare function installSkillFromGit(options: InstallSkillFromGitOptions): Promise<SkillInstallationStatus>;
//#endregion
export { InstallSkillFromGitOptions, InstallSkillFromNpmOptions, installSkillFromGit, installSkillFromNpm };
//# sourceMappingURL=installer.d.ts.map