openclaw/scripts/release-tooling-identity.d.mts

export type ReleaseToolingIdentity = {
  fullRef: string;
  ref: string;
  route: "main" | "prevalidated-branch" | "protected-tag";
  sha: string;
};

export type ReleaseToolingIdentityInput = {
  allowPrevalidatedRef?: boolean;
  workflowFullRef: string;
  workflowRef: string;
  workflowSha: string;
};

export function resolveReleaseToolingIdentity(
  input: {
    requestedIdentityJson?: string;
    workflowContract: string;
  } & Pick<ReleaseToolingIdentityInput, "workflowFullRef" | "workflowRef" | "workflowSha">,
): Pick<ReleaseToolingIdentity, "fullRef" | "ref" | "sha">;

export function validateReleaseToolingIdentity(
  input: ReleaseToolingIdentityInput & {
    mainComparisonStatus?: unknown;
    branchRef?: unknown;
    tagRef?: unknown;
  },
): ReleaseToolingIdentity;

export function runReleaseToolingGh(args: string[]): string;

export function verifyReleaseWorkflowRun(input: {
  repository: string;
  workflowFullRef: string;
  workflowRef: string;
  workflowSha: string;
  runId: string;
  runAttempt: string;
  workflowPath: string;
  workflowEvent: string;
  runStatePolicy: "active" | "success";
  runGh?: (args: string[]) => string;
}): Record<string, unknown>;

export function verifyReleaseToolingIdentity(
  input: ReleaseToolingIdentityInput & {
    repository: string;
    releasePublishFullRef?: string;
    releasePublishParentStatePolicy?:
      | "active"
      | "active-or-failure"
      | "active-or-success"
      | "manual-recovery";
    releasePublishRef?: string;
    releasePublishRunAttempt?: string;
    releasePublishRunId?: string;
    runGh?: (args: string[]) => string;
  },
): ReleaseToolingIdentity;

export function validateReleasePublishParentRun(input: {
  identity: Pick<ReleaseToolingIdentity, "fullRef" | "ref" | "sha">;
  releasePublishFullRef: string;
  releasePublishParentStatePolicy:
    | "active"
    | "active-or-failure"
    | "active-or-success"
    | "manual-recovery";
  releasePublishRef: string;
  releasePublishRunAttempt: string;
  releasePublishRunId: string;
  repository: string;
  run: unknown;
}): void;